kyro-ai 3.2.0

package/contexts/init.md

@@ -0,0 +1,64 @@
+---
+name: init
+description: Read-only analysis context for project exploration and roadmap generation. No code changes allowed.
+mode: analysis
+agent: orchestrator
+model: opus
+---
+
+# Context: INIT — Analysis Mode
+
+Activated during project initialization and analysis phases. This context puts Kyro in **read-only exploration mode** where the goal is understanding, not action.
+
+## When Active
+
+- `/kyro:forge` Phase 1 (Analyze)
+- Explicit user request to analyze or audit a project
+- First contact with a new codebase
+
+## Behavior
+
+### What This Context Does
+
+- **Explores architecture** — module structure, boundaries, dependency graph
+- **Identifies patterns** — coding conventions, framework usage, configuration approach
+- **Surfaces risks** — fragile areas, missing tests, complex modules, security concerns
+- **Maps dependencies** — external packages, version health, upgrade paths
+- **Discovers debt** — TODOs, FIXMEs, deprecated APIs, workarounds, dead code
+
+### What This Context Does NOT Do
+
+- No file creation or modification
+- No code generation or scaffolding
+- No dependency installation
+- No git operations (commits, branches, merges)
+- No running commands that modify state
+
+## Delegation
+
+All exploration work is handled by the **orchestrator** using its analysis protocol, which self-constrains to:
+
+- Tools: `Read`, `Glob`, `Grep`, `Bash` (read-only commands only)
+- Isolation: worktree (when available)
+- Memory: project-scoped
+
+## Output
+
+The context produces an **Analysis Report** containing:
+
+1. Work type classification
+2. Architecture overview
+3. Risk inventory (with severity ratings)
+4. Dependency health summary
+5. Visible debt catalog
+6. Numbered recommendations for the roadmap
+
+## Gate
+
+This context concludes with **Gate 1**: the analysis findings are presented to the user for approval before transitioning to sprint planning.
+
+## Rules in Effect
+
+- All rules from `rules/sprint-discipline.md` (sprint sequencing)
+- All rules from `rules/learning-rules.md` (apply existing learned rules during analysis)
+- `rules/context-persistence.md` R-CP-01 (update re-entry prompts after INIT)

package/contexts/review.md

@@ -0,0 +1,89 @@
+---
+name: review
+description: Assessment context for sprint status reporting and retrospectives. Read-only — no code changes.
+mode: assessment
+agent: orchestrator
+model: opus
+---
+
+# Context: REVIEW — Assessment Mode
+
+Activated during status checks and retrospectives. This context puts Kyro in **analysis-only mode** focused on measuring, reflecting, and planning improvements.
+
+## When Active
+
+- `/kyro:status` — project progress and debt summary
+- `/kyro:forge` Phase 4 (Review & Close)
+
+## Behavior
+
+### Status Assessment (`/kyro:status`)
+
+1. Read the current sprint file and extract task statuses.
+2. Summarize progress:
+   - Tasks completed / total tasks
+   - Story points completed / total story points
+   - Estimation accuracy (actual vs estimated per task)
+3. Produce a debt summary showing:
+   - Open debt items
+   - Age of each item (sprints since creation)
+   - Items flagged as `[AGED]` (open > 3 sprints)
+
+### Retrospective (forge Phase 4)
+
+1. Read the completed sprint file.
+2. Evaluate each task:
+   - Was it completed within estimate?
+   - Were there blockers or emergent work?
+   - What quality issues were found?
+3. Generate the retro document:
+   - **What went well** — tasks completed smoothly, good estimates
+   - **What went wrong** — blockers, underestimates, regressions
+   - **Recommendations** — numbered list of improvements for Sprint N+1
+   - **Estimation corrections** — adjusted buffers for task types
+   - **New learned rules** — proposed additions to `.agents/kyro/scopes/rules.md`
+4. Update the debt table with any new items or status changes.
+
+### Progress Analysis
+
+The metrics helper provides:
+
+- Sprint completion status
+- Estimate variance noted in sprint retros
+- Debt movement (new items vs resolved)
+- Most common BLOCKER categories
+- Task type distribution
+
+### Feed Forward
+
+Review outputs feed directly into next sprint planning:
+
+- Recommendations become the disposition table in Sprint N+1.
+- Estimation corrections update buffer percentages.
+- New rules are proposed for `.agents/kyro/scopes/rules.md`.
+- Unresolved debt items carry forward with updated age.
+
+## Constraints
+
+- **No code changes.** This context is analysis only.
+- **No file creation** except sprint retro documents and metrics reports in the output directory.
+- **No git operations** that modify history.
+
+## Delegation
+
+- **Primary agent**: orchestrator (using review checklist protocol)
+- Tools: `Read`, `Glob`, `Grep`, `Bash` (read-only commands only)
+- Helpers: `metrics`, `reviewer` (in `skills/sprint-forge/assets/helpers/`)
+
+## Output
+
+- Status report with progress and debt summary
+- Retro document with recommendations and estimation corrections
+- Proposed learned rules
+
+## Rules in Effect
+
+- All rules from `rules/sprint-discipline.md` (retro is mandatory, debt inheritance)
+- All rules from `rules/estimation.md` (flag >30% errors, track trends)
+- All rules from `rules/learning-rules.md` (propose and validate new rules)
+- All rules from `rules/context-persistence.md` (update re-entry prompts after retro)

package/contexts/sprint.md

@@ -0,0 +1,90 @@
+---
+name: sprint
+description: Execution context for task-by-task sprint implementation with quality gates, review validation, and emergent phase handling.
+mode: execution
+agent: orchestrator
+model: opus
+---
+
+# Context: SPRINT — Execution Mode
+
+Activated during sprint implementation. This context puts Kyro in **active execution mode** where tasks are implemented one by one with quality validation at each step.
+
+## When Active
+
+- `/kyro:forge` Phase 3 (Implement)
+- Resuming a sprint from a checkpoint
+
+## Behavior
+
+### Task Execution Loop
+
+For each task in the sprint plan:
+
+1. **Execute** — Implement the task according to its description and acceptance criteria.
+2. **Checkpoint** — Save the sprint file after the task completes.
+3. **Review** — Run the **review checklist** for quality validation.
+4. **Resolve** — If the review finds BLOCKERs, run the **debug protocol**.
+5. **Record** — Log actual time, notes, and any discovered work.
+
+### Quality Gates
+
+Quality gates run after every task (not just at the end):
+
+- Typecheck: `npm run typecheck` (or project-configured command)
+- Build: `npm run build` (or project-configured command)
+- Tests/lint: run only when the target project defines those commands
+
+A task is not closed until all gates pass or WARNINGs are explicitly justified.
+
+### Emergent Phases
+
+When implementation reveals work not in the original plan:
+
+1. Document the discovery in the sprint file under "Emergent Work."
+2. Assess impact on remaining tasks and timeline.
+3. If the emergent work is a prerequisite for planned tasks, insert a new phase.
+4. If it is independent, add it to the backlog or current sprint (with user approval).
+
+### Review Validation
+
+The **review checklist** runs after each task:
+
+- Does the change match the task description?
+- Are there regressions?
+- Are quality gates passing?
+- Is there new debt to track?
+- Any SUGGESTION-level improvements?
+
+### Debug on Failure
+
+When a task fails (tests break, type errors, runtime errors):
+
+1. Automatically run the **debug protocol**.
+2. The orchestrator performs root cause analysis.
+3. Fix is applied and the task re-enters the review cycle.
+4. If the debug protocol cannot resolve, escalate to the user.
+
+## Delegation
+
+- **Primary agent**: orchestrator (coordinates the full flow)
+- **Review checklist**: run after each task
+- **Debug protocol**: run on failure
+- Tools: all tools available (Read, Write, Edit, Glob, Grep, Bash)
+
+## Output
+
+The context produces:
+
+- Updated sprint file with task statuses, actuals, and notes
+- Checkpoints after each phase
+- Emergent work documentation
+- Quality gate results per task
+
+## Rules in Effect
+
+- All rules from `rules/quality-gates.md` (mandatory)
+- All rules from `rules/sprint-discipline.md` (checkpoints, debt inheritance)
+- All rules from `rules/estimation.md` (track actuals vs estimates)
+- All rules from `rules/context-persistence.md` (checkpoints, handoffs)
+- All rules from `rules/learning-rules.md` (capture corrections in real time)

package/dist/cli/adapters/codex.d.ts

@@ -0,0 +1,3 @@
+import type { AdapterDefinition } from './registry-types';
+export declare const codexAdapter: AdapterDefinition;
+//# sourceMappingURL=codex.d.ts.map

package/dist/cli/adapters/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../../src/cli/adapters/codex.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAK1D,eAAO,MAAM,YAAY,EAAE,iBAwC1B,CAAC"}

package/dist/cli/adapters/codex.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.codexAdapter = void 0;
+const constants_1 = require("../constants");
+const fs_1 = require("../fs");
+const command_skills_1 = require("./command-skills");
+const opencode_1 = require("./opencode");
+const AGENTS_PATH = 'AGENTS.md';
+const KYRO_AGENTS_BLOCK = 'agents-md';
+exports.codexAdapter = {
+    agent: constants_1.AGENT.CODEX,
+    displayName: 'Codex',
+    status: 'implemented',
+    buildProjection(plan) {
+        (0, command_skills_1.addCommandSkillProjection)(plan);
+        plan.push({
+            action: 'upsert-block',
+            path: AGENTS_PATH,
+            blockName: KYRO_AGENTS_BLOCK,
+            content: buildAgentsBlock(),
+        });
+    },
+    buildManagedFiles() {
+        return (0, command_skills_1.buildCommandSkillManagedFiles)();
+    },
+    buildManagedBlocks() {
+        return [`${AGENTS_PATH}#${KYRO_AGENTS_BLOCK}`];
+    },
+    buildInstalledAdapter(scope, installedAt) {
+        return {
+            agent: constants_1.AGENT.CODEX,
+            scope,
+            installedAt,
+            corePath: constants_1.KYRO_ROOT,
+            commandsPath: constants_1.AGENT_SKILLS_ROOT,
+            skillsPath: constants_1.AGENT_SKILLS_ROOT,
+        };
+    },
+    doctor(manifest) {
+        if (!manifest?.adapters.some((adapter) => adapter.agent === constants_1.AGENT.CODEX)) {
+            return { status: 'warn', name: 'Codex adapter', detail: 'not installed in this workspace' };
+        }
+        const commandCheck = (0, opencode_1.checkCommandProjection)('Codex adapter');
+        if (commandCheck.status !== 'pass')
+            return commandCheck;
+        if (!(0, fs_1.hasManagedBlock)(AGENTS_PATH, KYRO_AGENTS_BLOCK)) {
+            return { status: 'fail', name: 'Codex adapter', detail: `missing Kyro block in ${AGENTS_PATH}`, remedy: 'Run kyro sync --agent codex.' };
+        }
+        return { status: 'pass', name: 'Codex adapter', detail: 'projected Kyro command skills and root AGENTS.md block present' };
+    },
+};
+function buildAgentsBlock() {
+    return `## Kyro AI\n\nKyro is installed in this workspace.\n\n### Rules\n\n- Prefer installed Kyro command skills from \`${constants_1.AGENT_SKILLS_ROOT}/\` when invoking Kyro workflows.\n- Read command definitions from \`${constants_1.KYRO_COMMANDS_ROOT}/\` only when a Kyro command skill asks for them.\n- Persist workflow artifacts under \`${constants_1.ARTIFACT_ROOT}/{scope}/\`.\n- Do not ask users to describe Kyro workflows in natural language when an installed command or skill exists.\n- Preserve all non-Kyro content in this AGENTS.md file. Kyro owns only this marked block.\n\n### Core\n\nThe managed Kyro core lives in \`${constants_1.KYRO_ROOT}/\`.\n`;
+}
+//# sourceMappingURL=codex.js.map

package/dist/cli/adapters/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../../src/cli/adapters/codex.ts"],"names":[],"mappings":";;;AAAA,4CAAsG;AACtG,8BAAwC;AACxC,qDAA4F;AAC5F,yCAAoD;AAGpD,MAAM,WAAW,GAAG,WAAW,CAAC;AAChC,MAAM,iBAAiB,GAAG,WAAW,CAAC;AAEzB,QAAA,YAAY,GAAsB;IAC7C,KAAK,EAAE,iBAAK,CAAC,KAAK;IAClB,WAAW,EAAE,OAAO;IACpB,MAAM,EAAE,aAAa;IACrB,eAAe,CAAC,IAAI;QAClB,IAAA,0CAAyB,EAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC;YACR,MAAM,EAAE,cAAc;YACtB,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE,iBAAiB;YAC5B,OAAO,EAAE,gBAAgB,EAAE;SAC5B,CAAC,CAAC;IACL,CAAC;IACD,iBAAiB;QACf,OAAO,IAAA,8CAA6B,GAAE,CAAC;IACzC,CAAC;IACD,kBAAkB;QAChB,OAAO,CAAC,GAAG,WAAW,IAAI,iBAAiB,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,qBAAqB,CAAC,KAAK,EAAE,WAAW;QACtC,OAAO;YACL,KAAK,EAAE,iBAAK,CAAC,KAAK;YAClB,KAAK;YACL,WAAW;YACX,QAAQ,EAAE,qBAAS;YACnB,YAAY,EAAE,6BAAiB;YAC/B,UAAU,EAAE,6BAAiB;SAC9B,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,QAAQ;QACb,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,KAAK,iBAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACzE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,iCAAiC,EAAE,CAAC;QAC9F,CAAC;QACD,MAAM,YAAY,GAAG,IAAA,iCAAsB,EAAC,eAAe,CAAC,CAAC;QAC7D,IAAI,YAAY,CAAC,MAAM,KAAK,MAAM;YAAE,OAAO,YAAY,CAAC;QACxD,IAAI,CAAC,IAAA,oBAAe,EAAC,WAAW,EAAE,iBAAiB,CAAC,EAAE,CAAC;YACrD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,yBAAyB,WAAW,EAAE,EAAE,MAAM,EAAE,8BAA8B,EAAE,CAAC;QAC3I,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,gEAAgE,EAAE,CAAC;IAC7H,CAAC;CACF,CAAC;AAEF,SAAS,gBAAgB;IACvB,OAAO,oHAAoH,6BAAiB,wEAAwE,8BAAkB,2FAA2F,yBAAa,yQAAyQ,qBAAS,QAAQ,CAAC;AAC3mB,CAAC"}

package/dist/cli/adapters/command-skills.d.ts

@@ -0,0 +1,5 @@
+import type { KyroCommandName, OperationPlan } from '../types';
+export declare function addCommandSkillProjection(plan: OperationPlan[]): void;
+export declare function buildCommandSkillManagedFiles(): string[];
+export declare function getCommandSkillPath(command: KyroCommandName): string;
+//# sourceMappingURL=command-skills.d.ts.map

package/dist/cli/adapters/command-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-skills.d.ts","sourceRoot":"","sources":["../../../src/cli/adapters/command-skills.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE/D,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,IAAI,CAYrE;AAED,wBAAgB,6BAA6B,IAAI,MAAM,EAAE,CAExD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAEpE"}

package/dist/cli/adapters/command-skills.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addCommandSkillProjection = addCommandSkillProjection;
+exports.buildCommandSkillManagedFiles = buildCommandSkillManagedFiles;
+exports.getCommandSkillPath = getCommandSkillPath;
+const constants_1 = require("../constants");
+function addCommandSkillProjection(plan) {
+    for (const command of constants_1.COMMAND_NAMES) {
+        const path = getCommandSkillPath(command);
+        if (plan.some((operation) => operation.action === 'write' && operation.path === path)) {
+            continue;
+        }
+        plan.push({
+            action: 'write',
+            path,
+            content: buildCommandSkill(command),
+        });
+    }
+}
+function buildCommandSkillManagedFiles() {
+    return constants_1.COMMAND_NAMES.map((command) => getCommandSkillPath(command));
+}
+function getCommandSkillPath(command) {
+    return `${constants_1.AGENT_SKILLS_ROOT}/kyro-${command}/SKILL.md`;
+}
+function buildCommandSkill(command) {
+    const title = command === 'wrap-up' ? 'Kyro Wrap-Up' : `Kyro ${capitalize(command)}`;
+    const description = getCommandDescription(command);
+    return `---\nname: kyro-${command}\ndescription: ${description}\nlicense: Apache-2.0\nmetadata:\n  author: synapsync\n  version: "1.0"\n  scope: [root]\n---\n\n# ${title}\n\nUse this skill when the user invokes the Kyro ${command} workflow.\n\n## Execution\n\n1. Read \`${constants_1.KYRO_COMMANDS_ROOT}/${command}.md\`.\n2. Read required core assets from \`${constants_1.KYRO_ROOT}/\` only when the command asks for them.\n3. Persist Kyro workflow artifacts under \`${constants_1.ARTIFACT_ROOT}/{scope}/\`.\n4. Do not ask the user to describe this command in natural language; this skill is the command projection for agents that discover \`.agents/skills/\`.\n\n## Source of Truth\n\nThe managed Kyro core lives in \`${constants_1.KYRO_ROOT}/\`. Do not duplicate lifecycle logic in this projected skill.\n`;
+}
+function getCommandDescription(command) {
+    if (command === 'forge')
+        return 'Run the Kyro forge workflow through the installed workspace harness';
+    if (command === 'status')
+        return 'Show Kyro project status through the installed workspace harness';
+    return 'Close the Kyro session through the installed workspace harness';
+}
+function capitalize(value) {
+    return `${value.slice(0, 1).toUpperCase()}${value.slice(1)}`;
+}
+//# sourceMappingURL=command-skills.js.map

package/dist/cli/adapters/command-skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-skills.js","sourceRoot":"","sources":["../../../src/cli/adapters/command-skills.ts"],"names":[],"mappings":";;AAGA,8DAYC;AAED,sEAEC;AAED,kDAEC;AAvBD,4CAA8G;AAG9G,SAAgB,yBAAyB,CAAC,IAAqB;IAC7D,KAAK,MAAM,OAAO,IAAI,yBAAa,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,KAAK,OAAO,IAAI,SAAS,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACtF,SAAS;QACX,CAAC;QACD,IAAI,CAAC,IAAI,CAAC;YACR,MAAM,EAAE,OAAO;YACf,IAAI;YACJ,OAAO,EAAE,iBAAiB,CAAC,OAAO,CAAC;SACpC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,SAAgB,6BAA6B;IAC3C,OAAO,yBAAa,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,SAAgB,mBAAmB,CAAC,OAAwB;IAC1D,OAAO,GAAG,6BAAiB,SAAS,OAAO,WAAW,CAAC;AACzD,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAwB;IACjD,MAAM,KAAK,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;IACrF,MAAM,WAAW,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACnD,OAAO,mBAAmB,OAAO,kBAAkB,WAAW,sGAAsG,KAAK,qDAAqD,OAAO,2CAA2C,8BAAkB,IAAI,OAAO,+CAA+C,qBAAS,wFAAwF,yBAAa,mOAAmO,qBAAS,kEAAkE,CAAC;AAC3vB,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAwB;IACrD,IAAI,OAAO,KAAK,OAAO;QAAE,OAAO,qEAAqE,CAAC;IACtG,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,kEAAkE,CAAC;IACpG,OAAO,gEAAgE,CAAC;AAC1E,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/D,CAAC"}

package/dist/cli/adapters/opencode.d.ts

@@ -0,0 +1,5 @@
+import type { AdapterDefinition } from './registry-types';
+import type { CheckResult } from '../types';
+export declare const openCodeAdapter: AdapterDefinition;
+export declare function checkCommandProjection(name: string): CheckResult;
+//# sourceMappingURL=opencode.d.ts.map

package/dist/cli/adapters/opencode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.d.ts","sourceRoot":"","sources":["../../../src/cli/adapters/opencode.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,eAAO,MAAM,eAAe,EAAE,iBAyB7B,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAMhE"}

package/dist/cli/adapters/opencode.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openCodeAdapter = void 0;
+exports.checkCommandProjection = checkCommandProjection;
+const constants_1 = require("../constants");
+const fs_1 = require("../fs");
+const command_skills_1 = require("./command-skills");
+exports.openCodeAdapter = {
+    agent: constants_1.AGENT.OPENCODE,
+    displayName: 'OpenCode',
+    status: 'implemented',
+    buildProjection: command_skills_1.addCommandSkillProjection,
+    buildManagedFiles: command_skills_1.buildCommandSkillManagedFiles,
+    buildManagedBlocks() {
+        return [];
+    },
+    buildInstalledAdapter(scope, installedAt) {
+        return {
+            agent: constants_1.AGENT.OPENCODE,
+            scope,
+            installedAt,
+            corePath: constants_1.KYRO_ROOT,
+            commandsPath: constants_1.AGENT_SKILLS_ROOT,
+            skillsPath: constants_1.AGENT_SKILLS_ROOT,
+        };
+    },
+    doctor(manifest) {
+        if (!manifest?.adapters.some((adapter) => adapter.agent === constants_1.AGENT.OPENCODE)) {
+            return { status: 'warn', name: 'OpenCode adapter', detail: 'not installed in this workspace' };
+        }
+        return checkCommandProjection('OpenCode adapter');
+    },
+};
+function checkCommandProjection(name) {
+    const missing = (0, command_skills_1.buildCommandSkillManagedFiles)().filter((file) => !(0, fs_1.workspaceFileExists)(file));
+    if (missing.length > 0) {
+        return { status: 'fail', name, detail: `missing ${missing.join(', ')}`, remedy: 'Run kyro sync.' };
+    }
+    return { status: 'pass', name, detail: 'projected Kyro command skills present' };
+}
+//# sourceMappingURL=opencode.js.map

package/dist/cli/adapters/opencode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.js","sourceRoot":"","sources":["../../../src/cli/adapters/opencode.ts"],"names":[],"mappings":";;;AAiCA,wDAMC;AAvCD,4CAAmE;AACnE,8BAA4C;AAG5C,qDAA4F;AAE/E,QAAA,eAAe,GAAsB;IAChD,KAAK,EAAE,iBAAK,CAAC,QAAQ;IACrB,WAAW,EAAE,UAAU;IACvB,MAAM,EAAE,aAAa;IACrB,eAAe,EAAE,0CAAyB;IAC1C,iBAAiB,EAAE,8CAA6B;IAChD,kBAAkB;QAChB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,qBAAqB,CAAC,KAAK,EAAE,WAAW;QACtC,OAAO;YACL,KAAK,EAAE,iBAAK,CAAC,QAAQ;YACrB,KAAK;YACL,WAAW;YACX,QAAQ,EAAE,qBAAS;YACnB,YAAY,EAAE,6BAAiB;YAC/B,UAAU,EAAE,6BAAiB;SAC9B,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,QAAQ;QACb,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,KAAK,iBAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5E,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,iCAAiC,EAAE,CAAC;QACjG,CAAC;QACD,OAAO,sBAAsB,CAAC,kBAAkB,CAAC,CAAC;IACpD,CAAC;CACF,CAAC;AAEF,SAAgB,sBAAsB,CAAC,IAAY;IACjD,MAAM,OAAO,GAAG,IAAA,8CAA6B,GAAE,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAA,wBAAmB,EAAC,IAAI,CAAC,CAAC,CAAC;IAC7F,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IACrG,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,uCAAuC,EAAE,CAAC;AACnF,CAAC"}

package/dist/cli/adapters/registry-types.d.ts

@@ -0,0 +1,13 @@
+import type { Agent, CheckResult, InstallScope, KyroInstalledAdapter, KyroManifest, OperationPlan } from '../types';
+export type AdapterStatus = 'implemented' | 'planned';
+export interface AdapterDefinition {
+    agent: Agent;
+    displayName: string;
+    status: AdapterStatus;
+    buildProjection(plan: OperationPlan[]): void;
+    buildManagedFiles(): string[];
+    buildManagedBlocks(): string[];
+    buildInstalledAdapter(scope: InstallScope, installedAt: string): KyroInstalledAdapter;
+    doctor(manifest: KyroManifest | null): CheckResult;
+}
+//# sourceMappingURL=registry-types.d.ts.map

package/dist/cli/adapters/registry-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-types.d.ts","sourceRoot":"","sources":["../../../src/cli/adapters/registry-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEpH,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,SAAS,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,KAAK,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,eAAe,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;IAC7C,iBAAiB,IAAI,MAAM,EAAE,CAAC;IAC9B,kBAAkB,IAAI,MAAM,EAAE,CAAC;IAC/B,qBAAqB,CAAC,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,GAAG,oBAAoB,CAAC;IACtF,MAAM,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,GAAG,WAAW,CAAC;CACpD"}

package/dist/cli/adapters/registry-types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=registry-types.js.map

package/dist/cli/adapters/registry-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-types.js","sourceRoot":"","sources":["../../../src/cli/adapters/registry-types.ts"],"names":[],"mappings":""}

package/dist/cli/adapters/registry.d.ts

@@ -0,0 +1,7 @@
+import type { Agent } from '../types';
+import type { AdapterDefinition } from './registry-types';
+export declare const ADAPTERS: AdapterDefinition[];
+export declare function getAdapterDefinition(agent: Agent): AdapterDefinition;
+export declare function getInstallableAdapters(): AdapterDefinition[];
+export declare function getInstalledAdapterDefinitions(agents: Agent[]): AdapterDefinition[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/cli/adapters/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/cli/adapters/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAGtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAqB1D,eAAO,MAAM,QAAQ,EAAE,iBAAiB,EAKvC,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,KAAK,GAAG,iBAAiB,CAIpE;AAED,wBAAgB,sBAAsB,IAAI,iBAAiB,EAAE,CAE5D;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,iBAAiB,EAAE,CAEnF"}

package/dist/cli/adapters/registry.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ADAPTERS = void 0;
+exports.getAdapterDefinition = getAdapterDefinition;
+exports.getInstallableAdapters = getInstallableAdapters;
+exports.getInstalledAdapterDefinitions = getInstalledAdapterDefinitions;
+const constants_1 = require("../constants");
+const codex_1 = require("./codex");
+const opencode_1 = require("./opencode");
+const plannedAdapter = (agent, displayName) => ({
+    agent,
+    displayName,
+    status: 'planned',
+    buildProjection() { },
+    buildManagedFiles() {
+        return [];
+    },
+    buildManagedBlocks() {
+        return [];
+    },
+    buildInstalledAdapter(scope, installedAt) {
+        return { agent, scope, installedAt, corePath: '.agents/kyro/internal' };
+    },
+    doctor() {
+        return { status: 'warn', name: `${displayName} adapter`, detail: 'planned but not implemented yet' };
+    },
+});
+exports.ADAPTERS = [
+    opencode_1.openCodeAdapter,
+    codex_1.codexAdapter,
+    plannedAdapter(constants_1.AGENT.CLAUDE, 'Claude plugin'),
+    plannedAdapter(constants_1.AGENT.CURSOR, 'Cursor'),
+];
+function getAdapterDefinition(agent) {
+    const definition = exports.ADAPTERS.find((adapter) => adapter.agent === agent);
+    if (!definition)
+        throw new Error(`Unknown adapter: ${agent}`);
+    return definition;
+}
+function getInstallableAdapters() {
+    return exports.ADAPTERS.filter((adapter) => adapter.status === 'implemented');
+}
+function getInstalledAdapterDefinitions(agents) {
+    return agents.map((agent) => getAdapterDefinition(agent));
+}
+//# sourceMappingURL=registry.js.map

package/dist/cli/adapters/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/cli/adapters/registry.ts"],"names":[],"mappings":";;;AAgCA,oDAIC;AAED,wDAEC;AAED,wEAEC;AA5CD,4CAAqC;AAErC,mCAAuC;AACvC,yCAA6C;AAG7C,MAAM,cAAc,GAAG,CAAC,KAAY,EAAE,WAAmB,EAAqB,EAAE,CAAC,CAAC;IAChF,KAAK;IACL,WAAW;IACX,MAAM,EAAE,SAAS;IACjB,eAAe,KAAI,CAAC;IACpB,iBAAiB;QACf,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,kBAAkB;QAChB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,qBAAqB,CAAC,KAAK,EAAE,WAAW;QACtC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,uBAAuB,EAAE,CAAC;IAC1E,CAAC;IACD,MAAM;QACJ,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,WAAW,UAAU,EAAE,MAAM,EAAE,iCAAiC,EAAE,CAAC;IACvG,CAAC;CACF,CAAC,CAAC;AAEU,QAAA,QAAQ,GAAwB;IAC3C,0BAAe;IACf,oBAAY;IACZ,cAAc,CAAC,iBAAK,CAAC,MAAM,EAAE,eAAe,CAAC;IAC7C,cAAc,CAAC,iBAAK,CAAC,MAAM,EAAE,QAAQ,CAAC;CACvC,CAAC;AAEF,SAAgB,oBAAoB,CAAC,KAAY;IAC/C,MAAM,UAAU,GAAG,gBAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IACvE,IAAI,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,KAAK,EAAE,CAAC,CAAC;IAC9D,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAgB,sBAAsB;IACpC,OAAO,gBAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC;AACxE,CAAC;AAED,SAAgB,8BAA8B,CAAC,MAAe;IAC5D,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC;AAC5D,CAAC"}

package/dist/cli/app.d.ts

@@ -0,0 +1,2 @@
+export declare function runCli(): Promise<void>;
+//# sourceMappingURL=app.d.ts.map

package/dist/cli/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/cli/app.ts"],"names":[],"mappings":"AAOA,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAyC5C"}

package/dist/cli/app.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCli = runCli;
+const doctor_1 = require("./commands/doctor");
+const install_1 = require("./commands/install");
+const tui_1 = require("./commands/tui");
+const uninstall_1 = require("./commands/uninstall");
+const help_1 = require("./help");
+const options_1 = require("./options");
+async function runCli() {
+    const [command = '', ...args] = process.argv.slice(2);
+    if (command === '' || command === 'tui') {
+        await (0, tui_1.runTui)();
+        return;
+    }
+    if (command === '--help' || command === '-h' || command === 'help') {
+        (0, help_1.printHelp)();
+        return;
+    }
+    if (command === '--version' || command === '-v' || command === 'version') {
+        console.log((0, help_1.readPackageVersion)());
+        return;
+    }
+    const options = (0, options_1.parseOptions)(args);
+    if (options.help) {
+        (0, help_1.printCommandHelp)(command);
+        return;
+    }
+    switch (command) {
+        case 'install':
+            (0, install_1.install)(options);
+            break;
+        case 'doctor':
+            (0, doctor_1.doctor)();
+            break;
+        case 'sync':
+            (0, install_1.sync)(options);
+            break;
+        case 'uninstall':
+            (0, uninstall_1.uninstall)(options);
+            break;
+        default:
+            throw new Error(`Unknown command: ${command}. Run kyro --help.`);
+    }
+}
+//# sourceMappingURL=app.js.map

package/dist/cli/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/cli/app.ts"],"names":[],"mappings":";;AAOA,wBAyCC;AAhDD,8CAA2C;AAC3C,gDAAmD;AACnD,wCAAwC;AACxC,oDAAiD;AACjD,iCAAyE;AACzE,uCAAyC;AAElC,KAAK,UAAU,MAAM;IAC1B,MAAM,CAAC,OAAO,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEtD,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;QACxC,MAAM,IAAA,YAAM,GAAE,CAAC;QACf,OAAO;IACT,CAAC;IAED,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACnE,IAAA,gBAAS,GAAE,CAAC;QACZ,OAAO;IACT,CAAC;IAED,IAAI,OAAO,KAAK,WAAW,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACzE,OAAO,CAAC,GAAG,CAAC,IAAA,yBAAkB,GAAE,CAAC,CAAC;QAClC,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,IAAA,sBAAY,EAAC,IAAI,CAAC,CAAC;IAEnC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,IAAA,uBAAgB,EAAC,OAAO,CAAC,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,SAAS;YACZ,IAAA,iBAAO,EAAC,OAAO,CAAC,CAAC;YACjB,MAAM;QACR,KAAK,QAAQ;YACX,IAAA,eAAM,GAAE,CAAC;YACT,MAAM;QACR,KAAK,MAAM;YACT,IAAA,cAAI,EAAC,OAAO,CAAC,CAAC;YACd,MAAM;QACR,KAAK,WAAW;YACd,IAAA,qBAAS,EAAC,OAAO,CAAC,CAAC;YACnB,MAAM;QACR;YACE,MAAM,IAAI,KAAK,CAAC,oBAAoB,OAAO,oBAAoB,CAAC,CAAC;IACrE,CAAC;AACH,CAAC"}

package/dist/cli/commands/doctor.d.ts

@@ -0,0 +1,2 @@
+export declare function doctor(): void;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/cli/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAUA,wBAAgB,MAAM,IAAI,IAAI,CAY7B"}