[pull] develop from duckduckgo:develop

.cursor/mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "doc-bot": {
+        "command": "npx",
+        "args": ["@afterxleep/doc-bot@latest", "--docs", "./.rules", "--watch"]
+      }
+  }
+} 

.cursor/rules/doc-bot.mdc

@@ -0,0 +1,131 @@
+---
+alwaysApply: true
+---
+## PHASE 1: ENVIRONMENT DETECTION
+
+```
+IF (
+  (filesystem_contains("doc-bot/") AND
+  (mcp_server_available("doc-bot") OR mcp_server_available("@afterxleep/doc-bot"))
+) THEN {
+  ACTIVATE: doc_bot_enforcement_protocol()
+  SET: project_documentation_authority = TRUE
+  SET: general_knowledge_override = DISABLED
+}
+```
+
+## PHASE 2: REQUEST CLASSIFICATION ENGINE
+
+### CLASSIFICATION MATRIX:
+
+**CLASS A: CODE_GENERATION**
+```
+Trigger Pattern: /\b(write|create|implement|build|add|code|function|class|component|method|develop|generate|make|refactor|modify|update|fix|debug)\b/i
+Required Action: MANDATORY_CALL(check_project_rules, extract_task_description())
+Blocking: TRUE (cannot proceed without tool response)
+Timeout: 30s
+```
+
+**CLASS B: PROJECT_INQUIRY**
+```
+Trigger Pattern: /\b(how|what|why|architecture|approach|pattern|feature|authentication|database|api|testing)\b/i
+Context Pattern: /\b(this project|this codebase|here|our|current project)\b/i
+Required Action: MANDATORY_CALL(search_documentation, extract_keywords())
+Blocking: TRUE
+Timeout: 30s
+```
+
+**CLASS C: DOCUMENTATION_DISCOVERY**
+```
+Trigger Pattern: /\b(documentation|available|capabilities|help|rules|standards|what exists|docs|guide)\b/i
+Required Action: MANDATORY_CALL(get_global_rules)
+Blocking: TRUE
+Timeout: 30s
+```
+
+**CLASS D: DOCUMENT_ACCESS**
+```
+Trigger Pattern: /\b(read|show|get content|full document|complete|entire)\b/i
+Previous Context: search_results_present()
+Required Action: MANDATORY_CALL(read_specific_document, extract_filename())
+Blocking: FALSE
+Timeout: 15s
+```
+
+**Note**: For file-specific queries like "working on src/utils.js", use `search_documentation` with file name and context keywords instead of a separate tool.
+
+## PHASE 3: EXECUTION ENFORCEMENT
+
+### PRE-RESPONSE VALIDATION:
+```
+BEFORE generating_response():
+  classification = classify_request(user_input)
+  IF classification != "UNRELATED":
+    tool_result = execute_mandatory_tool(classification)
+    IF tool_result.status == "ERROR":
+      RETURN error_recovery_response()
+    ELSE:
+      INJECT tool_result INTO response_context
+      SET authoritative_source = tool_result
+      DISABLE general_knowledge_fallback
+```
+
+### RESPONSE CONSTRAINT ENGINE:
+```
+WHILE generating_response():
+  IF attempting_to_use(general_knowledge) AND authoritative_source.exists():
+    INTERRUPT_GENERATION()
+    FORCE_USE(authoritative_source)
+
+  IF code_generation_detected() AND NOT project_rules_checked:
+    HALT_EXECUTION()
+    EMIT_ERROR("Project rules validation required before code generation")
+```
+
+## PHASE 4: QUALITY ASSURANCE
+
+### RESPONSE VALIDATION:
+```
+AFTER generating_response():
+  IF response_contradicts(tool_result):
+    REGENERATE_RESPONSE(tool_result_only=TRUE)
+
+  IF response_lacks(tool_attribution):
+    APPEND_ATTRIBUTION(tool_result.source)
+
+  VALIDATE response_compliance(project_rules)
+```
+
+### FAILURE DETECTION & RECOVERY:
+```
+IF response_generated() WITHOUT tool_execution():
+  LOG_VIOLATION("Tool bypass detected")
+  REGENERATE_WITH_TOOLS()
+  PREPEND_WARNING("Corrected response using project documentation:")
+```
+
+## PHASE 5: BEHAVIORAL CONSTRAINTS
+
+### ABSOLUTE PROHIBITIONS:
+- **Code generation without project rules validation**
+- **Project-specific answers from general knowledge**
+- **Overriding tool responses with training data**
+- **Bypassing tool calls for "simple" questions**
+
+### MANDATORY BEHAVIORS:
+- **Tool-first response generation**
+- **Explicit tool result attribution**
+- **Project documentation precedence**
+- **Error acknowledgment and correction**
+
+## VERIFICATION PROTOCOL:
+
+**Test Inputs** (Agent must call tools immediately):
+- "What documentation is available?" → get_global_rules()
+- "How do I implement auth?" → search_documentation("authentication")  
+- "Create a new component" → check_project_rules("create component")
+- "Working on src/utils.js" → search_documentation("src/utils.js utils")
+
+**Expected Behavior**: Tool execution within 2 seconds, no general knowledge responses.
+
+**Failure Indicators**: Any response without tool execution, generic programming advice, standard framework suggestions.

.editorconfig

@@ -0,0 +1,98 @@
+[*.{kt,kts}]
+charset = utf-8
+end_of_line = lf
+indent_size = 4
+indent_style = space
+insert_final_newline = true
+max_line_length = 150
+tab_width = 4
+ij_continuation_indent_size = 4
+ij_formatter_off_tag = @formatter:off
+ij_formatter_on_tag = @formatter:on
+ij_formatter_tags_enabled = false
+ij_smart_tabs = false
+ij_wrap_on_typing = false
+ij_kotlin_align_in_columns_case_branch = false
+ij_kotlin_align_multiline_binary_operation = false
+ij_kotlin_align_multiline_extends_list = false
+ij_kotlin_align_multiline_method_parentheses = false
+ij_kotlin_align_multiline_parameters = false
+ij_kotlin_align_multiline_parameters_in_calls = false
+ij_kotlin_allow_trailing_comma = true
+ij_kotlin_allow_trailing_comma_on_call_site = true
+ij_kotlin_assignment_wrap = normal
+ij_kotlin_blank_lines_after_class_header = 0
+ij_kotlin_blank_lines_around_block_when_branches = 0
+ij_kotlin_blank_lines_before_declaration_with_comment_or_annotation_on_separate_line = 1
+ij_kotlin_block_comment_at_first_column = true
+ij_kotlin_call_parameters_new_line_after_left_paren = true
+ij_kotlin_call_parameters_right_paren_on_new_line = true
+ij_kotlin_call_parameters_wrap = normal
+ij_kotlin_catch_on_new_line = false
+ij_kotlin_class_annotation_wrap = split_into_lines
+ij_kotlin_code_style_defaults = KOTLIN_OFFICIAL
+ij_kotlin_continuation_indent_for_chained_calls = true
+ij_kotlin_continuation_indent_for_expression_bodies = false
+ij_kotlin_continuation_indent_in_argument_lists = true
+ij_kotlin_continuation_indent_in_elvis = true
+ij_kotlin_continuation_indent_in_if_conditions = true
+ij_kotlin_continuation_indent_in_parameter_lists = false
+ij_kotlin_continuation_indent_in_supertype_lists = true
+ij_kotlin_else_on_new_line = false
+ij_kotlin_enum_constants_wrap = split_into_lines
+ij_kotlin_extends_list_wrap = on_every_item
+ij_kotlin_field_annotation_wrap = normal
+ij_kotlin_finally_on_new_line = false
+ij_kotlin_if_rparen_on_new_line = true
+ij_kotlin_import_nested_classes = true
+ij_kotlin_imports_layout=*,java.**,javax.**,kotlin.**,^
+ij_kotlin_insert_whitespaces_in_simple_one_line_method = true
+ij_kotlin_keep_blank_lines_before_right_brace = 0
+ij_kotlin_keep_blank_lines_in_code = 1
+ij_kotlin_keep_blank_lines_in_declarations = 1
+ij_kotlin_keep_first_column_comment = true
+ij_kotlin_keep_indents_on_empty_lines = false
+ij_kotlin_keep_line_breaks = true
+ij_kotlin_lbrace_on_next_line = false
+ij_kotlin_line_comment_add_space = true
+ij_kotlin_line_comment_at_first_column = false
+ij_kotlin_method_annotation_wrap = normal
+ij_kotlin_method_call_chain_wrap = on_every_item
+ij_kotlin_method_parameters_new_line_after_left_paren = true
+ij_kotlin_method_parameters_right_paren_on_new_line = true
+ij_kotlin_method_parameters_wrap = split_into_lines
+ij_kotlin_name_count_to_use_star_import = 999
+ij_kotlin_name_count_to_use_star_import_for_members = 999
+ij_kotlin_parameter_annotation_wrap = off
+ij_kotlin_space_after_comma = true
+ij_kotlin_space_after_extend_colon = true
+ij_kotlin_space_after_type_colon = true
+ij_kotlin_space_before_catch_parentheses = true
+ij_kotlin_space_before_comma = false
+ij_kotlin_space_before_extend_colon = true
+ij_kotlin_space_before_for_parentheses = true
+ij_kotlin_space_before_if_parentheses = true
+ij_kotlin_space_before_lambda_arrow = true
+ij_kotlin_space_before_type_colon = false
+ij_kotlin_space_before_when_parentheses = true
+ij_kotlin_space_before_while_parentheses = true
+ij_kotlin_spaces_around_additive_operators = true
+ij_kotlin_spaces_around_assignment_operators = true
+ij_kotlin_spaces_around_equality_operators = true
+ij_kotlin_spaces_around_function_type_arrow = true
+ij_kotlin_spaces_around_logical_operators = true
+ij_kotlin_spaces_around_multiplicative_operators = true
+ij_kotlin_spaces_around_range = false
+ij_kotlin_spaces_around_relational_operators = true
+ij_kotlin_spaces_around_unary_operator = false
+ij_kotlin_spaces_around_when_arrow = true
+ij_kotlin_variable_annotation_wrap = off
+ij_kotlin_while_on_new_line = false
+ij_kotlin_wrap_elvis_expressions = 1
+ij_kotlin_wrap_expression_body_functions = 1
+ij_kotlin_wrap_first_method_in_call_chain = false
+ktlint_standard_no-wildcard-imports = disabled
+ktlint_standard_filename = disabled
+ktlint_standard_package-name = disabled
+ktlint_standard_annotation = disabled
+ktlint_standard_kdoc-wrapping = disabled

.githooks/pre-commit

@@ -1,3 +1,13 @@
-./gradlew spotlessApply
-git add `git diff --name-only`
-exit 0
+    #!/bin/bash
+    echo "Running spotless check"
+    ./gradlew spotlessApply
+
+    echo "Running PixelDefinitions lint fix (npm run lint.fix)"
+    pushd PixelDefinitions >/dev/null
+    npm install
+    # Auto fix pixel-schema lint issues
+    npm run lint.fix
+    popd >/dev/null
+
+    git add `git diff --name-only --cached`
+    exit 0

.github/.java-version

@@ -0,0 +1 @@
+17

.github/CODEOWNERS

@@ -0,0 +1,6 @@
+# This is the module where the Android Design System resides
+# Any changes to the source files of this module require approval from @malmstein or @nalcalag.
+/android-design-system/design-system/ @malmstein @mikescamell
+/android-design-system/design-system-internal/ @malmstein @mikescamell
+/saved-sites/ @malmstein
+/example-feature/ @cdrussell

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,20 +1,14 @@
-<!--
-Note: This checklist is a reminder of our shared engineering expectations. Feel free to change it, although assigning a GitHub reviewer and the items in bold are required.
--->
-
 Task/Issue URL: 
-Tech Design URL: 
-CC: 
-
-**Description**:
 
+### Description
 
-**Steps to test this PR**:
-1. 
-1. 
+### Steps to test this PR
 
+_Feature 1_
+- [ ]
+- [ ]
 
----
-###### Internal references:
-[Software Engineering Expectations](https://app.asana.com/0/59792373528535/199064865822552)
-[Technical Design Template](https://app.asana.com/0/59792373528535/184709971311943)
+### UI changes
+| Before  | After |
+| ------ | ----- |
+!(Upload before screenshot)|(Upload after screenshot)|

.github/actionlint.yaml

@@ -0,0 +1,4 @@
+self-hosted-runner:
+    labels:
+        # Stops incorrect warning of android-large-runner being used
+        - android-large-runner