@blxzer/cursor-trellis 0.1.0

package/dist/utils/project-capabilities.js

@@ -0,0 +1,515 @@
+import fs from "node:fs";
+import path from "node:path";
+import { getConfigTemplate as getCodexConfigTemplate } from "../templates/codex/index.js";
+import { ensureDir, writeFile } from "./file-writer.js";
+export const PROJECT_CAPABILITY_IDS = [
+    "codebase-retrieval",
+    "github-mcp",
+    "playwright-mcp",
+];
+const CAPABILITIES_JSON_PATH = ".trellis/capabilities.json";
+const CAPABILITIES_MD_PATH = ".trellis/capabilities.md";
+const CODEX_CAPABILITIES_START = "# TRELLIS:PROJECT-CAPABILITIES:START";
+const CODEX_CAPABILITIES_END = "# TRELLIS:PROJECT-CAPABILITIES:END";
+export const PROJECT_CAPABILITIES = [
+    {
+        id: "codebase-retrieval",
+        aliases: [
+            "fast-context-mcp",
+            "fast-context",
+            "fast_context",
+            "codegraph",
+            "colbymchenry/codegraph",
+            "colbymchenry-codegraph",
+        ],
+        title: "Codebase retrieval",
+        description: "Role-based local code retrieval through exact search, AST/structure, LSP expansion, semantic recall, and verification.",
+        routing: "Use for codebase questions by retrieval role: extract exact identifiers, path hints, and policy phrases, run rg first, apply intent-gated policy/document-first routing for architecture, boundary, and storage-policy questions, apply other intent-gated branches (caller-chain, trap demotion, extension disambiguation, env/config literals) only when the question matches that class, expand structural candidates with CodeGraph when available and fresh enough, use LSP for navigation after candidate symbols/files exist, use fast-context for semantic recall last on policy/env-heavy queries, then promote only source/Git/test-backed findings to final claims.",
+        readiness: "Required exact search (`rg`) is available. Optional CodeGraph, LSP, and fast-context adapters are reported as available, unavailable, or unverified without startup side effects.",
+        fallback: [
+            "Install or expose `rg` on PATH before claiming codebase retrieval readiness.",
+            "Ensure `npx -y fast-context-mcp` and `npx -y @colbymchenry/codegraph serve --mcp` can launch before generated MCP adapter entries are claimed as usable.",
+            "If CodeGraph, LSP, or fast-context adapters are unavailable, skipped, stale, or uninvoked, label that adapter evidence as unverified and continue with exact search plus direct file reads.",
+            "Record exploratory retrieval chains in task `research/*.md`; record final source/Git/test proof and unresolved adapter gaps in `verify.md`.",
+            "Run indexing, host MCP smoke checks, or language-server startup only after explicit user approval.",
+        ],
+        adapters: {
+            exact: {
+                provider: "rg",
+                required: true,
+                purpose: "Find identifiers, literals, paths, protocol constants, error codes, config keys, policy phrases, env prefixes, extension ids, and test names.",
+                readiness: "`rg` is available on PATH.",
+                evidenceStatus: "Corroborated candidate evidence when current file/range matches are captured; still not final proof without source/Git/test confirmation.",
+            },
+            ast: {
+                provider: "codegraph",
+                required: false,
+                purpose: "Resolve symbols, definitions, imports, callers, callees, impact, affected files, and structural relationships.",
+                readiness: "`npx -y @colbymchenry/codegraph serve --mcp` is available and index freshness is confirmed through status/query smoke or source/Git checks.",
+                evidenceStatus: "Structural candidate and impact guidance only; stale or unverified graph output must be confirmed with current source, Git, or tests.",
+                mcpServer: "codegraph",
+            },
+            lsp: {
+                provider: "language-server",
+                required: false,
+                purpose: "Expand high-confidence candidates through definitions, references, implementations, hover, and workspace symbols.",
+                readiness: "A project-appropriate language server is configured by the host; Trellis does not start it during init/update.",
+                evidenceStatus: "Navigation candidate until exact file/range evidence is verified by source reads.",
+            },
+            semantic: {
+                provider: "fast-context-mcp",
+                required: false,
+                purpose: "Recall conceptual or poorly named code areas and return candidate files, ranges, and follow-up grep terms.",
+                readiness: "`npx -y fast-context-mcp` is available to the host and a project-scoped smoke search is confirmed outside ordinary init/update.",
+                evidenceStatus: "Semantic recall candidate only; convert returned files/ranges/keywords into exact search and source reads before relying on it.",
+                mcpServer: "fast-context",
+            },
+            verification: {
+                provider: "source-git-tests",
+                required: true,
+                purpose: "Prove final claims with direct source reads, exact search confirmation, Git evidence, and focused validation.",
+                readiness: "Repository files are readable and task-appropriate validation commands are available or blockers are recorded.",
+                evidenceStatus: "Required proof layer for final technical claims and verification evidence.",
+            },
+        },
+        cliAutomationGuidance: [
+            {
+                command: "rg <pattern> <path>",
+                use: "Start with exact identifiers, literals, path hints, policy phrases, errors, config keys, and test names before broader semantic recall.",
+            },
+            {
+                command: 'rg -i "storage default|sidecar|sqlite only" AGENTS.md "**/AGENTS.md" README.md CONTRIBUTING.md .trellis/spec',
+                use: "For architecture, boundary, or storage/persistence policy questions (OpenClaw benchmark C-class, especially storage-policy queries), search project instruction and policy docs before implementation modules such as SQLite or state DB files.",
+            },
+            {
+                command: "Get-Content <file> | Select-Object -First <n>",
+                use: "Read current source around candidate file ranges before turning retrieval output into a claim.",
+            },
+            {
+                command: "git diff -- <path>",
+                use: "Check current worktree changes before claiming behavior, impact, or test scope.",
+            },
+            {
+                command: "codegraph status <path> --json",
+                use: "Check initialization, graph size, languages, backend, and pending changes before relying on graph output.",
+            },
+            {
+                command: "codegraph query <symbol-or-search> --path <path> --json",
+                use: "Resolve candidate symbols, kinds, files, and line ranges before running impact or relationship commands.",
+            },
+            {
+                command: "codegraph callers <symbol> --path <path> --json",
+                use: "Find upstream callers; raise result limits or paginate with rg when the question asks which modules/files invoke a facade, loader, or helper (do not stop at the helper definition file).",
+            },
+            {
+                command: "rg <env-prefix> scripts test e2e bench",
+                use: "For env/config literal questions, search scripts, e2e, benchmark, and test trees before auth or runtime implementation modules under src/.",
+            },
+            {
+                command: "rg <symbol> extensions/",
+                use: "For shared extension exports, list every extension hit, then disambiguate by extension id in the query and non-empty export bodies before global semantic explore.",
+            },
+            {
+                command: "codegraph callees <symbol> --path <path> --json",
+                use: "Find downstream calls and dependencies that constrain a safe change.",
+            },
+            {
+                command: "codegraph impact <symbol> --path <path> --depth <n> --json",
+                use: "Estimate blast radius for a resolved symbol before editing or reviewing a refactor.",
+            },
+            {
+                command: "codegraph affected <changed-files...> --path <path> --json",
+                use: "Map changed source files to affected tests when preparing validation scope.",
+            },
+        ],
+        mcpServers: [
+            {
+                name: "fast-context",
+                command: "npx",
+                args: ["-y", "fast-context-mcp"],
+            },
+            {
+                name: "codegraph",
+                command: "npx",
+                args: ["-y", "@colbymchenry/codegraph", "serve", "--mcp"],
+                startupTimeoutSec: 120,
+            },
+        ],
+    },
+    {
+        id: "github-mcp",
+        aliases: ["github"],
+        title: "GitHub MCP",
+        description: "GitHub repository, issue, pull request, and review operations.",
+        routing: "Use for explicit GitHub remote work; distinguish read-only inspection from write-capable issue, PR, branch, review, or merge actions.",
+        readiness: "Configured GitHub API MCP package is visible and `GITHUB_TOKEN` or `GITHUB_PERSONAL_ACCESS_TOKEN` is present in the agent host environment before remote actions are claimed.",
+        fallback: [
+            "Expose `GITHUB_TOKEN` or `GITHUB_PERSONAL_ACCESS_TOKEN` to the MCP server environment or configure the agent host explicitly.",
+            "Ensure `npx -y @modelcontextprotocol/server-github` can launch before selecting this capability.",
+            "Without a verified credential posture, use local Git only and do not claim GitHub remote actions.",
+        ],
+        mcpServers: [
+            {
+                name: "github",
+                command: "npx",
+                args: ["-y", "@modelcontextprotocol/server-github"],
+            },
+        ],
+    },
+    {
+        id: "playwright-mcp",
+        aliases: ["playwright"],
+        title: "Playwright MCP",
+        description: "Browser automation, frontend behavior checks, screenshots, and UI smoke verification.",
+        routing: "Use for browser/UI verification when the task requires rendered behavior evidence; keep browser/session startup explicit.",
+        readiness: "Configured server and browser runtime are available without silently starting unrelated browsing sessions.",
+        fallback: [
+            "Verify the Playwright MCP package and browser runtime in the selected host before claiming rendered UI evidence.",
+            "If browser automation is unavailable, record the missing runtime and fall back to static checks or manual user verification.",
+        ],
+        mcpServers: [
+            {
+                name: "playwright",
+                command: "npx",
+                args: ["-y", "@playwright/mcp@latest"],
+                startupTimeoutSec: 120,
+            },
+        ],
+    },
+];
+const CAPABILITY_BY_TOKEN = new Map();
+for (const capability of PROJECT_CAPABILITIES) {
+    CAPABILITY_BY_TOKEN.set(capability.id, capability.id);
+    for (const alias of capability.aliases) {
+        CAPABILITY_BY_TOKEN.set(alias, capability.id);
+    }
+}
+function selectedSet(selected) {
+    return new Set(selected);
+}
+function tokenizeProjectCapabilityValues(values) {
+    return (values ?? [])
+        .flatMap((value) => value.split(","))
+        .map((value) => value.trim().toLowerCase())
+        .filter(Boolean);
+}
+function capabilityById(id) {
+    const capability = PROJECT_CAPABILITIES.find((item) => item.id === id);
+    if (!capability) {
+        throw new Error(`Unknown project capability: ${id}`);
+    }
+    return capability;
+}
+function uniqueInRegistryOrder(values) {
+    const requested = new Set(values);
+    return PROJECT_CAPABILITY_IDS.filter((id) => requested.has(id));
+}
+function uniqueMcpServers(selected) {
+    const servers = new Map();
+    for (const id of uniqueInRegistryOrder(selected)) {
+        for (const server of capabilityById(id).mcpServers) {
+            if (!servers.has(server.name)) {
+                servers.set(server.name, server);
+            }
+        }
+    }
+    return [...servers.values()];
+}
+function renderCapabilityAdapters(adapters) {
+    if (!adapters) {
+        return undefined;
+    }
+    return Object.fromEntries(Object.entries(adapters).map(([role, adapter]) => [
+        role,
+        {
+            provider: adapter.provider,
+            required: adapter.required,
+            purpose: adapter.purpose,
+            readiness: adapter.readiness,
+            evidence_status: adapter.evidenceStatus,
+            ...(adapter.mcpServer ? { mcp_server: adapter.mcpServer } : {}),
+        },
+    ]));
+}
+function parseStoredProjectCapabilities(values) {
+    const selected = new Set();
+    for (const token of tokenizeProjectCapabilityValues(values)) {
+        if (token === "none") {
+            continue;
+        }
+        if (token === "all") {
+            for (const id of PROJECT_CAPABILITY_IDS) {
+                selected.add(id);
+            }
+            continue;
+        }
+        const id = CAPABILITY_BY_TOKEN.get(token);
+        if (id) {
+            selected.add(id);
+        }
+    }
+    return uniqueInRegistryOrder(selected);
+}
+export function parseProjectCapabilities(values) {
+    const selected = new Set();
+    for (const token of tokenizeProjectCapabilityValues(values)) {
+        if (token === "none") {
+            continue;
+        }
+        if (token === "all") {
+            for (const id of PROJECT_CAPABILITY_IDS) {
+                selected.add(id);
+            }
+            continue;
+        }
+        const id = CAPABILITY_BY_TOKEN.get(token);
+        if (!id) {
+            throw new Error(`Unknown project capability "${token}". Known values: ${[
+                ...PROJECT_CAPABILITY_IDS,
+                "all",
+                "none",
+            ].join(", ")}`);
+        }
+        selected.add(id);
+    }
+    return uniqueInRegistryOrder(selected);
+}
+export function getProjectCapabilityChoices() {
+    return PROJECT_CAPABILITIES.map((capability) => ({
+        id: capability.id,
+        name: `${capability.title} - ${capability.description}`,
+    }));
+}
+export function renderCapabilitiesJson(selected) {
+    const selectedIds = uniqueInRegistryOrder(selected);
+    const selectedLookup = selectedSet(selectedIds);
+    const capabilities = Object.fromEntries(PROJECT_CAPABILITIES.map((capability) => {
+        const adapters = renderCapabilityAdapters(capability.adapters);
+        return [
+            capability.id,
+            {
+                selected: selectedLookup.has(capability.id),
+                mcp_servers: capability.mcpServers.map((server) => ({
+                    name: server.name,
+                    command: server.command,
+                    args: server.args,
+                    ...(server.startupTimeoutSec
+                        ? { startup_timeout_sec: server.startupTimeoutSec }
+                        : {}),
+                })),
+                routing: capability.routing,
+                readiness: capability.readiness,
+                fallback: capability.fallback,
+                ...(adapters ? { adapters } : {}),
+                ...(capability.cliAutomationGuidance
+                    ? { cli_automation_guidance: capability.cliAutomationGuidance }
+                    : {}),
+                ...(capability.mcpQueryGuidance
+                    ? { mcp_query_guidance: capability.mcpQueryGuidance }
+                    : {}),
+            },
+        ];
+    }));
+    return `${JSON.stringify({
+        schema_version: 2,
+        note: "Trellis-managed project capability selection. Credentials and global MCP/client config stay outside repository templates.",
+        selected: selectedIds,
+        capabilities,
+    }, null, 2)}\n`;
+}
+export function getProjectCapability(id) {
+    return capabilityById(id);
+}
+function appendPolicyDocumentRetrievalRouting(lines) {
+    lines.push("## Policy and Document-First Routing (intent-gated)", "", "Apply this branch when the question is about architecture, responsibility, ownership, boundaries, project or package policy, storage or persistence policy, conventions, or where behavior is allowed, forbidden, or defined in instructions—not when the question names an exact symbol, protocol constant, schema path, platform file, or version literal (those stay symbol/path-first for strong A/G/F/J routes).", "", "Trigger signals include: 规定 / 边界 / 为什么不能 / storage policy / persistence / sidecar / import boundaries / transport-only / project instructions / AGENTS conventions.", "", "Evidence order for policy/document queries:", "", "1. Root and nested `AGENTS.md`, then `.trellis/spec/**`, `README.md`, `CONTRIBUTING.md`, architecture or design docs, and package-level policy or contract instruction files.", "2. Exact `rg` on policy phrases and boundary terms scoped to those paths (for example `Storage default: SQLite only`, `sidecar`, `SQLite only`, transport-only, import boundary).", "3. Read matched policy sections with direct source reads before ranking implementation files as Top-1.", "4. Use AST/CodeGraph or semantic recall only to corroborate policy claims or locate related implementation; do not let SQLite/state/cache modules outrank root policy docs when the question asks what is allowed or forbidden.", "5. Verify with source reads before final claims; optional adapters remain optional.", "", "### Storage and persistence policy (benchmark C03 pattern)", "", "When the question asks how storage is chosen, why sidecar files for cache or queue are forbidden, or SQLite vs JSON/JSONL policy: inspect root `AGENTS.md` (and nested `**/AGENTS.md`) before `src/state/*`, Kysely, or other storage implementation modules. Target Top-1 policy evidence such as `Storage default: SQLite only`, `state/openclaw.sqlite`, and `Kysely` cited from instruction docs, not from implementation adjacency alone. OpenClaw audit acceptance target for this query class: `>= 4/6` when agents follow this route.", "");
+}
+function appendCodebaseRetrievalIntentBranches(lines) {
+    lines.push("## Query Intent Branches (intent-gated)", "", "Apply these branches only when the question matches the intent class. Do not reorder the global workflow for F/G protocol queries, platform file paths, or questions with a single named symbol or constant—keep exact `rg` and symbol-scoped CodeGraph first.", "", "### Caller and assembly chain (B-class)", "", "- Use when the question asks who calls, which modules invoke, where behavior is wired, or which facade modules delegate work.", "- Do not treat facade-runtime, loader, barrel, plugin-registry-snapshot, or a single deliver/helper file as sufficient Top-1 evidence when the rubric expects many concrete call sites.", "- After exact hits on the helper or symbol, run `codegraph callers` with a raised limit (or repeat with `rg` references/imports) until concrete callee modules appear; follow assembly nodes (`*-runtime`, `server-runtime-services`, registry entry vs snapshot) with `codegraph callees` or targeted `rg`.", "- Rank concrete call-site files above the file that only defines or loads the helper.", "", "### Trap demotion and package boundary (E-class)", "", "- Use when similarly named files exist in a different package or layer (for example `src/agents/*` vs `packages/*-core`).", "- Parse path and package hints in the query; demote trap candidates until an export, protocol type, or corroborating call site matches the asked layer.", "- Prefer `packages/<name>/` evidence when the question names a core library; demote spawn/runtime overlay traps that share a prefix but live in agent glue code.", "- Do not promote a trap file to Top-1 without reading exports and at least one confirming reference.", "", "### Extension and shared-symbol disambiguation (A-class)", "", "- Use when one symbol (for example `legacyConfigRules`) appears across many `extensions/` trees.", "- Run exact `rg` across `extensions/` first; filter by extension id or directory named in the question.", "- Prefer the first non-empty export with a real implementation over stub or empty `doctor-contract-api` paths; demote traps listed in eval/query context when present.", "- Run CodeGraph explore only after the extension candidate set is narrowed—not as an unscoped global symbol search.", "", "### Environment and config literals (D-class)", "", "- Use when the question names env vars, `OPENCLAW_*` prefixes, benchmark startup, or e2e script configuration.", "- Run exact `rg` on `scripts/`, `test/`, `e2e/`, and `bench/` (or project equivalents) before `src/` auth, token, or runtime conflict modules.", "- Prefer files that assign or read the literal in scripts over implementation files that only mention the prefix in error handling.", "- Use CodeGraph after literal hits exist; do not let auth/runtime implementation outrank script evidence for env-inventory questions.", "", "### Preserve strong routes (F / G / exact symbol)", "", "- Platform paths (`apps/ios`, `apps/android`, Swift/Kotlin trees), `packages/gateway-protocol`, contract/schema globs, and named constants: exact `rg` plus symbol-scoped `codegraph_search` stay primary.", "- Do not run policy-first, trap demotion, or env-before-`src/` passes ahead of exact symbol discovery for those queries.", "");
+}
+function appendCodebaseRetrievalWorkflow(lines) {
+    lines.push("## Codebase Retrieval Workflow", "", "1. Extract exact identifiers, literals, path hints, policy phrases, command names, error text, config keys, env prefixes, extension ids, routes, event names, task names, and test names from the question.", "2. Run exact `rg` search first when exact signals exist and keep file/range candidates tied to source evidence.", "3. Classify intent (policy/document, caller-chain, trap/package, extension spread, env literal, protocol/platform) and apply **Policy and Document-First Routing** or the matching branch from **Query Intent Branches** when it fits; skip branches that do not match.", "4. Use AST/CodeGraph when available and fresh enough to resolve symbols, imports, callers, callees, impact, and affected files.", "5. Use LSP navigation only after candidate files or symbols exist; do not use it as the broad first-pass search.", "6. Use semantic recall for conceptual, poorly named, or cross-cutting areas, then turn returned files/ranges/keywords into exact follow-up checks; deprioritize semantic Top-1 for policy/storage-policy, env-literal, and extension-disambiguation questions until policy docs or `rg` narrow candidates.", "7. Fuse candidates by source proximity, tests, current Git state, and adapter freshness.", "8. Read files, inspect relevant Git evidence, and run task-appropriate validation before making final behavior, impact, or test-coverage claims.", "", "## Codebase Evidence Levels", "", "- Candidate: filenames, semantic recall, initial graph/LSP output, or incomplete exact search. Candidate evidence cannot support final claims.", "- Corroborated candidate: current source reads or exact `rg` hits confirm the candidate exists in this checkout. Use it to plan deeper reads or tests.", "- Verified claim: current source lines plus Git evidence or focused validation support the statement. Use this level for final answers and `verify.md`.", "- Unverified / unavailable: adapter output is stale, skipped, unavailable, hidden from the host, or not invoked. Report it explicitly instead of claiming it.", "", "## Evidence Persistence", "", "- Record exploratory retrieval chains, adapter availability, freshness checks, and competing hypotheses in task `research/*.md`.", "- Record final source/Git/test proof, validation commands, and unresolved adapter gaps in `verify.md`.", "- Prefer reusable research frontmatter when the artifact should be rediscovered later: `doc_type`, `status`, `confidence`, `scope`, and `related_files`.", "", "## Fallback Sequence", "", "- If `rg` is missing, codebase retrieval readiness fails; install or expose `rg` before claiming readiness.", "- If CodeGraph, LSP, or fast-context are unavailable or unverified, continue with exact search, direct source reads, Git evidence, and focused tests.", "- Do not start MCP servers, initialize indexes, start language servers, or install tools without explicit user approval.", "", "## Adapter Roles", "");
+    const adapters = capabilityById("codebase-retrieval").adapters ?? {};
+    for (const [role, adapter] of Object.entries(adapters)) {
+        lines.push(`### ${role}`, "", `- Provider: ${adapter.provider}`, `- Required: ${adapter.required ? "yes" : "no"}`, `- Purpose: ${adapter.purpose}`, `- Readiness: ${adapter.readiness}`, `- Evidence status: ${adapter.evidenceStatus}`, "");
+    }
+    appendCodebaseRetrievalIntentBranches(lines);
+}
+export function renderCapabilitiesMarkdown(selected) {
+    const selectedIds = uniqueInRegistryOrder(selected);
+    const lines = [
+        "# Trellis Project Capabilities",
+        "",
+        "This file records selected project capabilities for the Trellis workflow. It does not store credentials and does not prove readiness by itself.",
+        "",
+        "## Selected",
+        "",
+    ];
+    if (selectedIds.length === 0) {
+        lines.push("- none");
+    }
+    else {
+        for (const id of selectedIds) {
+            const capability = capabilityById(id);
+            lines.push(`- ${capability.id}: ${capability.description}`);
+        }
+    }
+    lines.push("", "## Routing Rules", "", "- Unselected, unavailable, skipped, or uninvoked capabilities must not be reported as used.", "- Capability output that affects task decisions must be recorded in task research or verify evidence.", "- `codebase-retrieval` routes by retrieval role, not by tool brand: exact search, intent-gated policy/document-first routing for C-class questions, other intent-gated branches when the question class matches, AST/structure, LSP navigation, semantic recall, then verification.", "- Policy, architecture, boundary, and storage-policy questions must inspect `AGENTS.md`, `.trellis/spec/**`, and README/contributing/architecture docs before semantic implementation search.", "- Intent-gated branches (policy/document, caller-chain, trap demotion, extension disambiguation, env/config literals) must not override exact-symbol or F/G protocol routes.", "- Exact `rg` search and direct source reads are the baseline for current-code claims.", "- CodeGraph output is structural guidance until index freshness and current source/Git evidence are confirmed.", "- fast-context output is semantic recall only and must be converted into exact source checks before final claims.", "- GitHub MCP uses the GitHub API server package; remote writes require explicit user intent and the host's credential/tool posture must be clear.", "- Playwright MCP should be used for rendered UI evidence only when browser verification is part of the task.", "");
+    if (selectedIds.includes("codebase-retrieval")) {
+        appendPolicyDocumentRetrievalRouting(lines);
+        appendCodebaseRetrievalWorkflow(lines);
+    }
+    const selectedWithCliAutomation = selectedIds
+        .map(capabilityById)
+        .filter((capability) => (capability.cliAutomationGuidance?.length ?? 0) > 0);
+    if (selectedWithCliAutomation.length > 0) {
+        lines.push("## CLI Automation Guidance", "");
+        for (const capability of selectedWithCliAutomation) {
+            lines.push(`### ${capability.id}`, "", "- Run these commands only after the capability is selected and readiness/freshness has been verified or explicitly reported as unverified.", "- Treat adapter output as planning guidance until current source, Git, or tests confirm the claim.");
+            for (const hint of capability.cliAutomationGuidance ?? []) {
+                lines.push(`- \`${hint.command}\`: ${hint.use}`);
+            }
+            lines.push("");
+        }
+    }
+    const selectedWithQueryGuidance = selectedIds
+        .map(capabilityById)
+        .filter((capability) => (capability.mcpQueryGuidance?.length ?? 0) > 0);
+    if (selectedWithQueryGuidance.length > 0) {
+        lines.push("## MCP Query Guidance", "");
+        for (const capability of selectedWithQueryGuidance) {
+            lines.push(`### ${capability.id}`, "", "- Use these MCP query tools only after the capability is selected and the user explicitly approves any MCP runtime startup.", "- Treat tool output as orientation unless freshness is confirmed; source reads, Git, and tests remain the proof layer for current-code claims.");
+            for (const hint of capability.mcpQueryGuidance ?? []) {
+                lines.push(`- \`${hint.tool}\`: ${hint.use}`);
+            }
+            lines.push("");
+        }
+    }
+    lines.push("## Readiness Expectations", "");
+    for (const capability of PROJECT_CAPABILITIES) {
+        lines.push(`- ${capability.id}: ${capability.readiness}`);
+    }
+    lines.push("", "## Fallback Guidance", "");
+    if (selectedIds.length === 0) {
+        lines.push("- none");
+    }
+    else {
+        for (const id of selectedIds) {
+            const capability = capabilityById(id);
+            lines.push(`### ${capability.id}`, "");
+            for (const fallback of capability.fallback) {
+                lines.push(`- ${fallback}`);
+            }
+            lines.push("");
+        }
+    }
+    return `${lines.join("\n")}\n`;
+}
+function tomlString(value) {
+    return JSON.stringify(value);
+}
+function tomlArray(values) {
+    return `[${values.map(tomlString).join(", ")}]`;
+}
+function renderCodexCapabilityBlock(selected) {
+    const selectedIds = uniqueInRegistryOrder(selected);
+    if (selectedIds.length === 0) {
+        return "";
+    }
+    const lines = [
+        CODEX_CAPABILITIES_START,
+        "# Project-local MCP servers selected through Trellis.",
+        "# Credentials stay in the agent host environment or user-level config.",
+    ];
+    for (const server of uniqueMcpServers(selectedIds)) {
+        lines.push("", `[mcp_servers.${server.name}]`, `command = ${tomlString(server.command)}`, `args = ${tomlArray(server.args)}`);
+        if (server.startupTimeoutSec) {
+            lines.push(`startup_timeout_sec = ${server.startupTimeoutSec}`);
+        }
+    }
+    lines.push(CODEX_CAPABILITIES_END);
+    return lines.join("\n");
+}
+export function applyCodexCapabilityConfig(baseContent, selected) {
+    const escapedStart = CODEX_CAPABILITIES_START.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const escapedEnd = CODEX_CAPABILITIES_END.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const withoutExistingBlock = baseContent
+        .replace(new RegExp(`\\n*${escapedStart}[\\s\\S]*?${escapedEnd}\\n*`), "\n")
+        .trimEnd();
+    const block = renderCodexCapabilityBlock(selected);
+    if (!block) {
+        return `${withoutExistingBlock}\n`;
+    }
+    return `${withoutExistingBlock}\n\n${block}\n`;
+}
+export function renderMcpJson(selected) {
+    const servers = Object.fromEntries(uniqueMcpServers(selected).map((server) => [
+        server.name,
+        {
+            command: server.command,
+            args: server.args,
+        },
+    ]));
+    return `${JSON.stringify({ mcpServers: servers }, null, 2)}\n`;
+}
+export function buildProjectCapabilityTemplates(selected, platforms) {
+    const selectedIds = uniqueInRegistryOrder(selected);
+    const files = new Map();
+    if (selectedIds.length === 0) {
+        return files;
+    }
+    files.set(CAPABILITIES_JSON_PATH, renderCapabilitiesJson(selectedIds));
+    files.set(CAPABILITIES_MD_PATH, renderCapabilitiesMarkdown(selectedIds));
+    const platformSet = new Set(platforms);
+    if (platformSet.has("codex")) {
+        const config = getCodexConfigTemplate();
+        files.set(`.codex/${config.targetPath}`, applyCodexCapabilityConfig(config.content, selectedIds));
+    }
+    if (platformSet.has("claude-code")) {
+        files.set(".mcp.json", renderMcpJson(selectedIds));
+    }
+    if (platformSet.has("cursor")) {
+        files.set(".cursor/mcp.json", renderMcpJson(selectedIds));
+    }
+    return files;
+}
+export async function writeProjectCapabilityFiles(cwd, selected, platforms) {
+    const files = buildProjectCapabilityTemplates(selected, platforms);
+    if (files.size === 0) {
+        return;
+    }
+    for (const [relativePath, content] of files) {
+        const targetPath = path.join(cwd, ...relativePath.split("/"));
+        ensureDir(path.dirname(targetPath));
+        if (relativePath === ".codex/config.toml" &&
+            fs.existsSync(targetPath) &&
+            normalizeLineEndings(fs.readFileSync(targetPath, "utf-8")) ===
+                normalizeLineEndings(getCodexConfigTemplate().content)) {
+            fs.writeFileSync(targetPath, content);
+            continue;
+        }
+        await writeFile(targetPath, content);
+    }
+}
+function normalizeLineEndings(content) {
+    return content.replace(/\r\n/g, "\n");
+}
+export function loadProjectCapabilities(cwd) {
+    const filePath = path.join(cwd, ...CAPABILITIES_JSON_PATH.split("/"));
+    if (!fs.existsSync(filePath)) {
+        return [];
+    }
+    try {
+        const parsed = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+        if (!Array.isArray(parsed.selected)) {
+            return [];
+        }
+        return parseStoredProjectCapabilities(parsed.selected.filter((item) => typeof item === "string"));
+    }
+    catch {
+        return [];
+    }
+}
+export function collectProjectCapabilityTemplates(cwd, platforms) {
+    return buildProjectCapabilityTemplates(loadProjectCapabilities(cwd), platforms);
+}
+//# sourceMappingURL=project-capabilities.js.map

package/dist/utils/project-capabilities.js.map

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

package/dist/utils/project-detector.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Project type detected by analyzing project files
+ */
+export type ProjectType = "frontend" | "backend" | "fullstack" | "unknown";
+/**
+ * Detect project type by analyzing project files
+ *
+ * @param cwd - Current working directory to analyze
+ * @returns Detected project type
+ */
+export declare function detectProjectType(cwd: string): ProjectType;
+/**
+ * Get human-readable description of project type
+ */
+export declare function getProjectTypeDescription(type: ProjectType): string;
+/**
+ * Detected package in a monorepo workspace
+ */
+export interface DetectedPackage {
+    /** Package name (from package.json, Cargo.toml, go.mod, etc.) */
+    name: string;
+    /** Relative path from cwd, normalized (no ./ prefix or trailing /) */
+    path: string;
+    /** Project type detected via detectProjectType() */
+    type: ProjectType;
+    /** Whether this package is a git submodule */
+    isSubmodule: boolean;
+    /** Whether this package has its own .git (independent repo, e.g. polyrepo sibling) */
+    isGitRepo: boolean;
+}
+/**
+ * Sanitize a package name for use as a directory name.
+ * Strips npm scope prefix (@scope/) so "@zhubao/desktop" becomes "desktop".
+ */
+export declare function sanitizePkgName(name: string): string;
+/**
+ * Detect monorepo workspace configuration and enumerate packages.
+ *
+ * Checks workspace managers in priority order (pnpm → npm/yarn/bun → Cargo → Go → uv),
+ * merges results, and marks git submodules. Returns null if no monorepo detected.
+ *
+ * @param cwd - Repository root to analyze
+ * @returns Array of detected packages, null if not a monorepo, empty array if config exists but no packages found
+ */
+export declare function detectMonorepo(cwd: string): DetectedPackage[] | null;
+//# sourceMappingURL=project-detector.d.ts.map

package/dist/utils/project-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-detector.d.ts","sourceRoot":"","sources":["../../src/utils/project-detector.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;AAiK3E;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAqB1D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAWnE;AAMD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,IAAI,EAAE,WAAW,CAAC;IAClB,8CAA8C;IAC9C,WAAW,EAAE,OAAO,CAAC;IACrB,sFAAsF;IACtF,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAsYD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,EAAE,GAAG,IAAI,CAyHpE"}