cawdex 1.35.75 → 1.35.76

package/dist/search-first.js

@@ -176,45 +176,45 @@ export function buildSearchFirstPrompt(task, cwd) {
         research += 'Found these related patterns in the codebase:\n';
         research += relatedGreps.map((g) => `\`\`\`\n${g}\n\`\`\``).join('\n');
     }
-    return `# Research-First Implementation
-
-## Task
-${task}
-
-## Before Writing Code: Research Phase
-
-Please follow this approach:
-
-1. **Analyze existing patterns** in the codebase
-   - Look at similar functions and modules
-   - Understand how the project structures code
-   - Check for established patterns we should follow
-
-2. **Review documentation and comments**
-   - Check relevant files for JSDoc and inline comments
-   - Look for design patterns in existing implementations
-   - Understand architectural decisions
-
-3. **Identify applicable patterns**
-   - What patterns from existing code apply here?
-   - Are there similar functions we should model after?
-   - What conventions does this project follow?
-
-4. **Reference existing code in your proposal**
-   - When proposing a solution, reference the existing code that informed it
-   - Explain how your implementation follows established patterns
-   - Point out if you're introducing a new pattern and why
-
-## Current Codebase Research
-${research || '(Run research to populate this section)'}
-
-## Implementation Guidelines
-- Follow the style and patterns of existing code
-- Use the same import structure and module organization
-- Match the error handling approach used elsewhere
-- Maintain consistency with project conventions
-- Reference specific files and functions that informed the design
-
+    return `# Research-First Implementation
+
+## Task
+${task}
+
+## Before Writing Code: Research Phase
+
+Please follow this approach:
+
+1. **Analyze existing patterns** in the codebase
+   - Look at similar functions and modules
+   - Understand how the project structures code
+   - Check for established patterns we should follow
+
+2. **Review documentation and comments**
+   - Check relevant files for JSDoc and inline comments
+   - Look for design patterns in existing implementations
+   - Understand architectural decisions
+
+3. **Identify applicable patterns**
+   - What patterns from existing code apply here?
+   - Are there similar functions we should model after?
+   - What conventions does this project follow?
+
+4. **Reference existing code in your proposal**
+   - When proposing a solution, reference the existing code that informed it
+   - Explain how your implementation follows established patterns
+   - Point out if you're introducing a new pattern and why
+
+## Current Codebase Research
+${research || '(Run research to populate this section)'}
+
+## Implementation Guidelines
+- Follow the style and patterns of existing code
+- Use the same import structure and module organization
+- Match the error handling approach used elsewhere
+- Maintain consistency with project conventions
+- Reference specific files and functions that informed the design
+
 Now, please implement the task, but start by analyzing the codebase and then proposing your solution.`;
 }
 /**
@@ -252,68 +252,68 @@ export function buildDocsLookupPrompt(query, cwd) {
             }
         }
     }
-    return `# Documentation Lookup
-
-## Query
-${query}
-
-## Research Results
-
-### Step 1: Local Documentation
-- Searched docs/ directory
-- Searched README files
-- Searched for configuration files
-
-### Step 2: Code Comments & JSDoc
-- Extracted JSDoc from relevant files
-- Found inline documentation
-- Checked for examples in tests
-
-${docsContent || '(No documentation found - searching code patterns instead)'}
-
-### Step 3: Code Patterns
+    return `# Documentation Lookup
+
+## Query
+${query}
+
+## Research Results
+
+### Step 1: Local Documentation
+- Searched docs/ directory
+- Searched README files
+- Searched for configuration files
+
+### Step 2: Code Comments & JSDoc
+- Extracted JSDoc from relevant files
+- Found inline documentation
+- Checked for examples in tests
+
+${docsContent || '(No documentation found - searching code patterns instead)'}
+
+### Step 3: Code Patterns
 ${grepResults.length > 0
         ? 'Found these implementations:\n' +
             grepResults.slice(0, 10).map((g) => `- ${g}`).join('\n')
-        : 'No specific patterns found'}
-
-## Summary
-Based on the documentation and code patterns found, here are the key findings:
-
-1. **Documentation**: ${docFiles.length > 0 ? `Found ${docFiles.length} documentation files` : 'Limited documentation'}
-2. **Code Examples**: ${grepResults.length > 0 ? `Found ${grepResults.length} related code snippets` : 'No examples'}
-3. **Related Files**: ${findRelevantFiles(query, cwd).length} relevant source files
-
+        : 'No specific patterns found'}
+
+## Summary
+Based on the documentation and code patterns found, here are the key findings:
+
+1. **Documentation**: ${docFiles.length > 0 ? `Found ${docFiles.length} documentation files` : 'Limited documentation'}
+2. **Code Examples**: ${grepResults.length > 0 ? `Found ${grepResults.length} related code snippets` : 'No examples'}
+3. **Related Files**: ${findRelevantFiles(query, cwd).length} relevant source files
+
 Please use these findings to answer the query.`;
 }
 /**
  * Build a prompt for source-grounded external research before implementation.
  */
 export function buildSourceResearchPrompt(topic) {
-    return `# Source-Grounded Research Brief
-
-## Topic
-${topic}
-
-Use the \`research_sources\` tool before answering. Query at least:
-- \`source:"arxiv"\`, \`recent_days:90\`, \`format:"json"\` for recent papers and methods
-- \`source:"github"\`, \`github_kind:"all"\`, \`recent_days:90\`, \`format:"json"\` for repos, issues, PRs, and code patterns
-- \`source:"huggingface"\`, \`kind:"all"\`, \`recent_days:90\`, \`format:"json"\` for papers, models, and datasets
-- \`source:"kaggle"\`, \`kaggle_kind:"both"\`, \`format:"json"\` for datasets and competitions
-
-After the GitHub pass, call \`github_repo_digest\` on one or two directly relevant public GitHub repos when the topic is about agent/harness implementation, benchmark strategy, or source-code patterns. Use the digest's manifests, likely commands, and component surface signals as evidence; do not infer implementation details from repo popularity alone.
-For Terminal-Bench public-agent comparisons, call \`benchmark_repo_catalog\` first so known public leaderboard repos are not missed.
-
-Then synthesize a brief with:
-1. The strongest current ideas or artifacts relevant to the topic.
-2. What is directly applicable to this codebase.
-3. Compatibility or operational risks.
-4. A concrete implementation plan with verification steps.
-
-Rules:
-- Cite URLs returned by the tool.
-- Prefer recent and maintained sources over stale popularity.
-- Do not invent papers, repos, datasets, or benchmark claims.
+    return `# Source-Grounded Research Brief
+
+## Topic
+${topic}
+
+Use the \`research_sources\` tool before answering. Query at least:
+- \`source:"arxiv"\`, \`recent_days:90\`, \`format:"json"\` for recent papers and methods
+- \`source:"github"\`, \`github_kind:"all"\`, \`recent_days:90\`, \`format:"json"\` for repos, issues, PRs, and code patterns
+- \`source:"huggingface"\`, \`kind:"all"\`, \`recent_days:90\`, \`format:"json"\` for papers, models, and datasets
+- \`source:"kaggle"\`, \`kaggle_kind:"both"\`, \`format:"json"\` for datasets and competitions
+
+After the GitHub pass, call \`github_repo_digest\` on one or two directly relevant public GitHub repos when the topic is about agent/harness implementation, benchmark strategy, or source-code patterns. Use the digest's manifests, likely commands, and component surface signals as evidence; do not infer implementation details from repo popularity alone.
+For Terminal-Bench public-agent comparisons, call \`benchmark_repo_catalog\` first so known public leaderboard repos are not missed.
+
+Then synthesize a brief with:
+1. The strongest current ideas or artifacts relevant to the topic.
+2. What is directly applicable to this codebase.
+3. Compatibility or operational risks.
+4. A concrete implementation plan with verification steps.
+
+Rules:
+- Cite URLs returned by the tool.
+- Prefer recent and maintained sources over stale popularity.
+- Do not invent papers, repos, datasets, or benchmark claims.
 - If a source fails, say which one failed and continue with the others.`;
 }
 /**

package/dist/skill-create.js

@@ -203,23 +203,23 @@ export function analyzeGitPatterns(cwd, limit = 50) {
 export function buildSkillCreatePrompt(cwd, pattern) {
     const patterns = analyzeGitPatterns(cwd);
     if (patterns.length === 0) {
-        return `# Skill Creation from Git History
-
-The repository has no clear git history patterns to extract skills from.
-
-Please help generate reusable skill templates for common development workflows in this project.
-
-Consider:
-1. What repetitive tasks appear in the commit history?
-2. What are the standard steps for common operations?
-3. What conventions does the team follow?
-4. What could be automated with skills/workflows?
-
-For each skill, provide:
-- **Name**: Concise skill identifier
-- **Description**: What it does
-- **Steps**: Numbered workflow steps with {{placeholders}}
-- **Commands**: Specific tool calls or scripts
+        return `# Skill Creation from Git History
+
+The repository has no clear git history patterns to extract skills from.
+
+Please help generate reusable skill templates for common development workflows in this project.
+
+Consider:
+1. What repetitive tasks appear in the commit history?
+2. What are the standard steps for common operations?
+3. What conventions does the team follow?
+4. What could be automated with skills/workflows?
+
+For each skill, provide:
+- **Name**: Concise skill identifier
+- **Description**: What it does
+- **Steps**: Numbered workflow steps with {{placeholders}}
+- **Commands**: Specific tool calls or scripts
 - **Validation**: How to verify success`;
     }
     // Filter patterns if requested
@@ -235,56 +235,56 @@ For each skill, provide:
             patternsSummary += `  Files: ${p.files.slice(0, 3).join(', ')}\n`;
         }
     }
-    return `# Skill Creation from Git History
-
-## Discovered Patterns
-
-Based on analyzing the last 50 commits, these patterns emerged:
-${patternsSummary}
-
-## Workflow
-
-1. **Analyze Patterns** — I've identified ${patterns.length} patterns from git history
-2. **Extract Skills** — Convert recurring patterns into reusable skills
-3. **Create Templates** — Generate skill templates with {{placeholders}}
-4. **Validate** — Ensure each skill solves a real workflow
-
-## Skill Template Format
-
-For each skill, create a file with:
-\`\`\`
-# {{SKILL_NAME}}
-
-## Description
-{{What this skill does}}
-
-## Trigger Pattern
-{{When to use this skill}}
-
-## Steps
-1. {{Step 1 with {{placeholders}}}}
-2. {{Step 2}}
-...
-
-## Validation
-{{How to verify success}}
-
-## Example Usage
-\`\`\`bash
-{{Example command}}
-\`\`\`
-\`\`\`
-
-## Task
-
-Based on the patterns above, please:
-
-1. **Identify** the top 3 most valuable skills to create
-2. **Design** skill workflows with clear steps and placeholders
-3. **Include** validation checks for each skill
-4. **Provide** example invocations
-5. **Export** as reusable templates
-
+    return `# Skill Creation from Git History
+
+## Discovered Patterns
+
+Based on analyzing the last 50 commits, these patterns emerged:
+${patternsSummary}
+
+## Workflow
+
+1. **Analyze Patterns** — I've identified ${patterns.length} patterns from git history
+2. **Extract Skills** — Convert recurring patterns into reusable skills
+3. **Create Templates** — Generate skill templates with {{placeholders}}
+4. **Validate** — Ensure each skill solves a real workflow
+
+## Skill Template Format
+
+For each skill, create a file with:
+\`\`\`
+# {{SKILL_NAME}}
+
+## Description
+{{What this skill does}}
+
+## Trigger Pattern
+{{When to use this skill}}
+
+## Steps
+1. {{Step 1 with {{placeholders}}}}
+2. {{Step 2}}
+...
+
+## Validation
+{{How to verify success}}
+
+## Example Usage
+\`\`\`bash
+{{Example command}}
+\`\`\`
+\`\`\`
+
+## Task
+
+Based on the patterns above, please:
+
+1. **Identify** the top 3 most valuable skills to create
+2. **Design** skill workflows with clear steps and placeholders
+3. **Include** validation checks for each skill
+4. **Provide** example invocations
+5. **Export** as reusable templates
+
 Focus on the most frequent patterns ({{${filteredPatterns[0]?.pattern || 'feature development'}}})`;
 }
 /**
@@ -321,39 +321,39 @@ export function exportPatternsToJSON(patterns, outputPath) {
  */
 export function generateSkillFromPattern(pattern, cwd) {
     const skillName = pattern.pattern.replace(/[^a-z0-9-]/gi, '-').toLowerCase();
-    const content = `# ${pattern.pattern}
-
-${pattern.description}
-
-Frequency in recent history: ${pattern.frequency} occurrences
-
-## When to Use
-
-This pattern appears in commits that:
-- Modify: ${pattern.files.slice(0, 3).join(', ') || 'multiple files'}
-- Pattern: ${pattern.pattern}
-
-## Workflow Steps
-
-1. {{TODO: Define workflow step 1}}
-2. {{TODO: Define workflow step 2}}
-3. {{TODO: Define validation}}
-
-## Files Involved
-
-${pattern.files.map((f) => `- \`${f}\``).join('\n')}
-
-## Example
-
-\`\`\`bash
-# {{Example command}}
-\`\`\`
-
-## Notes
-
-- Generated from git history analysis
-- ${pattern.frequency} instances found in recent commits
-- Suggested for automation/skill creation
+    const content = `# ${pattern.pattern}
+
+${pattern.description}
+
+Frequency in recent history: ${pattern.frequency} occurrences
+
+## When to Use
+
+This pattern appears in commits that:
+- Modify: ${pattern.files.slice(0, 3).join(', ') || 'multiple files'}
+- Pattern: ${pattern.pattern}
+
+## Workflow Steps
+
+1. {{TODO: Define workflow step 1}}
+2. {{TODO: Define workflow step 2}}
+3. {{TODO: Define validation}}
+
+## Files Involved
+
+${pattern.files.map((f) => `- \`${f}\``).join('\n')}
+
+## Example
+
+\`\`\`bash
+# {{Example command}}
+\`\`\`
+
+## Notes
+
+- Generated from git history analysis
+- ${pattern.frequency} instances found in recent commits
+- Suggested for automation/skill creation
 `;
     return { name: skillName, content };
 }

package/dist/stitch.js

@@ -163,7 +163,7 @@ export function buildStitchPrompt(query) {
     const safeQuery = query.replace(/`/g, '\\`');
     return `# Stitch Intelligent Interface
 
-You are the Stitch interface inside Cawdex. Stitch is Google's AI
+You are the Stitch interface inside Cawdex. Stitch is Google's AI
 UI/UX design and code generation tool (https://stitch.withgoogle.com/).
 Connect via the \`stitch\` tool, which wraps the Stitch MCP server at
 https://stitch.googleapis.com/mcp.

package/dist/system-prompt.d.ts

@@ -1,3 +1,4 @@
 import type { CawdexConfig } from './types.js';
 import { type Mode } from './modes.js';
-export declare function buildSystemPrompt(config: CawdexConfig, cwd: string, mode?: Mode, userQuery?: string): string;
+import type { Tool } from './tools/types.js';
+export declare function buildSystemPrompt(config: CawdexConfig, cwd: string, mode?: Mode, userQuery?: string, tools?: Tool[]): string;

package/dist/system-prompt.js

@@ -8,8 +8,9 @@ import { findEccSkillsForQuery } from './ecc.js';
 import { ALL_TOOLS } from './tools/index.js';
 import { buildUserContext } from './users.js';
 import * as mempalace from './mempalace/index.js';
-function buildToolList() {
-    const lines = ALL_TOOLS.map((t) => {
+import { buildAgentsInstructionsPrompt } from './agents-md.js';
+function buildToolList(tools = ALL_TOOLS) {
+    const lines = tools.map((t) => {
         const oneLine = t.description.split('\n')[0];
         return `  - ${t.name}: ${oneLine}`;
     });
@@ -30,7 +31,7 @@ function buildDesignHint(mode) {
         return '';
     return `\n# UI work hint\nWhen the user asks for UI / visual / layout / design work in this mode, you can either (a) write HTML/CSS directly, or (b) suggest switching to design mode (\`/mode design\` or \`/design <task>\`) which uses Google Stitch to generate real UI screens that you then integrate into the codebase. Choose (b) for anything more involved than a single static page.`;
 }
-export function buildSystemPrompt(config, cwd, mode = 'dev', userQuery) {
+export function buildSystemPrompt(config, cwd, mode = 'dev', userQuery, tools = ALL_TOOLS) {
     const os = `${platform()} ${release()}`;
     // The shell label here MUST match what the bash tool actually runs.
     // The bash tool picks cmd.exe on Windows by default (was a major source
@@ -56,6 +57,10 @@ export function buildSystemPrompt(config, cwd, mode = 'dev', userQuery) {
     catch { }
     // Mode-specific prompt addition
     const modeAddition = getModePromptAddition(mode);
+    // Repo-local AGENTS.md instructions. Global sections and matching
+    // model-scoped sections are injected here; matching tool-scoped sections
+    // are attached to tool descriptions before the provider call.
+    const agentsAddition = buildAgentsInstructionsPrompt(cwd, config.model);
     // Language-specific rules. Pass userQuery so the detector can scope
     // injection to languages mentioned in the message or changed in git
     // — narrower than the old "every language found anywhere in cwd"
@@ -163,7 +168,7 @@ You help with software engineering tasks: writing code, fixing bugs, refactoring
 ${fileList ? `- Files in cwd: ${fileList}` : ''}
 
 # Available Tools (these and ONLY these — do not invent tool names)
-${buildToolList()}
+${buildToolList(tools)}
 
 ${config.memory?.enabled !== false ? `# Memory (MemPalace) — when to use the memory_* tools
 
@@ -236,7 +241,7 @@ IMPORTANT — tool-call rules:
 - Use markdown formatting in your responses.
 - For git operations: prefer new commits over amending, never force-push without asking.
 - Respond in the same language the user writes in.
-${modeAddition}${buildDesignHint(mode)}${rulesAddition}${instinctAddition}${eccSkillAddition}${recalledMemoryAddition}${userAddition}
+${modeAddition}${buildDesignHint(mode)}${agentsAddition}${rulesAddition}${instinctAddition}${eccSkillAddition}${recalledMemoryAddition}${userAddition}
 `;
 }
 //# sourceMappingURL=system-prompt.js.map

package/dist/system-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../src/system-prompt.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../src/system-prompt.ts"],"names":[],"mappings":"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"}

package/dist/tools/github-repo-digest.d.ts

@@ -20,7 +20,7 @@ export declare function parseGitHubRepo(value: string): ParsedRepo | null;
 declare function summarizeLanguages(paths: string[]): string[];
 declare function summarizeHarnessSurfaces(paths: string[]): string[];
 declare function summarizeCommands(files: KeyFile[]): string[];
-declare function selectKeyFiles(paths: string[], maxTextFiles: number): string[];
+declare function selectKeyFiles(paths: string[], maxTextFiles: number, docsOnly?: boolean): string[];
 declare function selectAnalysisPaths(paths: string[], maxFiles: number): string[];
 declare function redactSecrets(value: string): string;
 export declare const _internal: {

package/dist/tools/github-repo-digest.js

@@ -52,6 +52,25 @@ const KEY_FILE_CANDIDATES = [
     'src/agent.py',
     'agent.py',
 ];
+const DOCS_ONLY_KEY_FILE_CANDIDATES = [
+    'README.md',
+    'README.rst',
+    'README.txt',
+    'docs/README.md',
+    'docs/index.md',
+    'docs/quickstart.md',
+    'docs/getting-started.md',
+    'docs/usage.md',
+    'docs/architecture.md',
+    'docs/design.md',
+    'package.json',
+    'pyproject.toml',
+    'Cargo.toml',
+    'go.mod',
+    'requirements.txt',
+    'Dockerfile',
+    'Makefile',
+];
 const SURFACE_PATTERNS = [
     { id: 'prompts', label: 'prompts', re: /(^|\/)(prompts?|system[-_ ]?prompt|instructions?|rules?)(\/|\.|-|_|$)/i },
     { id: 'tools', label: 'tools', re: /(^|\/)(tools?|commands?|actions?|functions?)(\/|\.|-|_|$)/i },
@@ -118,6 +137,10 @@ export const GitHubRepoDigestTool = {
                 type: 'number',
                 description: 'Maximum characters to keep per key file excerpt. Default 1200, max 4000.',
             },
+            docs_only: {
+                type: 'boolean',
+                description: 'If true, fetch only docs and manifest excerpts, skipping source-code key files.',
+            },
         },
         required: ['repo'],
         additionalProperties: false,
@@ -140,6 +163,7 @@ export async function buildGitHubRepoDigest(input) {
     const maxFiles = clampNumber(input.max_files, 300, 20, 2000);
     const maxTextFiles = clampNumber(input.max_text_files, 5, 0, 12);
     const maxExcerptChars = clampNumber(input.max_excerpt_chars, 1200, 200, 4000);
+    const docsOnly = input.docs_only === true;
     try {
         const meta = await fetchJson(`${GITHUB_API}/repos/${parsed.owner}/${parsed.repo}`);
         const ref = String(input.ref || meta.default_branch || 'main').trim();
@@ -149,7 +173,7 @@ export async function buildGitHubRepoDigest(input) {
             .map((item) => normalizePath(item.path))
             .sort((a, b) => a.localeCompare(b));
         const paths = selectAnalysisPaths(allPaths, maxFiles);
-        const selectedKeyFiles = selectKeyFiles(allPaths, maxTextFiles);
+        const selectedKeyFiles = selectKeyFiles(allPaths, maxTextFiles, docsOnly);
         const keyFiles = await fetchKeyFiles(parsed, ref, selectedKeyFiles, maxExcerptChars);
         return {
             output: formatRepoDigest({
@@ -161,6 +185,7 @@ export async function buildGitHubRepoDigest(input) {
                 treeTruncated: tree.truncated === true || allPaths.length > paths.length,
                 keyFiles,
                 keyFileErrors: selectedKeyFiles.filter((path) => !keyFiles.some((file) => file.path === path)),
+                docsOnly,
             }),
             isError: false,
         };
@@ -276,6 +301,7 @@ function formatRepoDigest(input) {
         '## Source Digest',
         `- files_indexed: ${input.paths.length}${input.totalPaths > input.paths.length ? ` of ${input.totalPaths}` : ''}`,
         `- tree_truncated: ${input.treeTruncated ? 'yes' : 'no'}`,
+        `- docs_only: ${input.docsOnly ? 'yes' : 'no'}`,
         `- manifests: ${manifests.length ? manifests.join(' | ') : 'none'}`,
         `- ci_files: ${ciFiles.length ? ciFiles.join(' | ') : 'none'}`,
         '',
@@ -307,7 +333,9 @@ function formatRepoDigest(input) {
         }
         lines.push('');
     }
-    lines.push('## AHE Fit', '- component_observability: use the surface counts above to target prompts, tools, middleware, memory, providers, and benchmark/eval files separately.', '- experience_observability: prefer repos with visible benchmarks/evals/tests and CI files when mining reusable agent lessons.', '- decision_observability: treat this digest as orientation only; verify claims by reading the exact files before porting a pattern.');
+    lines.push('## AHE Fit', '- component_observability: use the surface counts above to target prompts, tools, middleware, memory, providers, and benchmark/eval files separately.', '- experience_observability: prefer repos with visible benchmarks/evals/tests and CI files when mining reusable agent lessons.', input.docsOnly
+        ? '- source_code_guard: this digest intentionally skipped source-code excerpts; use docs/manifests for design lessons unless source reading is explicitly approved.'
+        : '- decision_observability: treat this digest as orientation only; verify claims by reading the exact files before porting a pattern.');
     return lines.join('\n').trim();
 }
 function summarizeLanguages(paths) {
@@ -371,7 +399,7 @@ function summarizeCommands(files) {
     }
     return Array.from(commands).slice(0, 20).map((command) => `- ${command}`);
 }
-function selectKeyFiles(paths, maxTextFiles) {
+function selectKeyFiles(paths, maxTextFiles, docsOnly = false) {
     if (maxTextFiles <= 0)
         return [];
     const pathSet = new Set(paths);
@@ -382,14 +410,18 @@ function selectKeyFiles(paths, maxTextFiles) {
         if (pathSet.has(path) && !selected.includes(path))
             selected.push(path);
     };
-    for (const candidate of KEY_FILE_CANDIDATES)
+    const candidates = docsOnly ? DOCS_ONLY_KEY_FILE_CANDIDATES : KEY_FILE_CANDIDATES;
+    for (const candidate of candidates)
         add(candidate);
     if (selected.length < maxTextFiles) {
         for (const path of paths) {
             if (selected.length >= maxTextFiles)
                 break;
-            if (/readme|quickstart|getting[-_ ]?started|usage|agent|harness|benchmark|eval/i.test(path) &&
-                /\.(md|rst|txt|json|toml|ya?ml|py|ts|js)$/i.test(path)) {
+            const docOrManifest = /readme|quickstart|getting[-_ ]?started|usage|architecture|design|agent|harness|benchmark|eval|package\.json|pyproject\.toml|cargo\.toml|go\.mod|requirements\.txt|dockerfile|makefile/i.test(path);
+            const allowedExt = docsOnly
+                ? /\.(md|rst|txt|json|toml|ya?ml)$/i.test(path) || /(^|\/)(go\.mod|requirements.*\.txt|dockerfile|makefile)$/i.test(path)
+                : /\.(md|rst|txt|json|toml|ya?ml|py|ts|js)$/i.test(path);
+            if (docOrManifest && allowedExt) {
                 add(path);
             }
         }