kyro-ai 3.3.0 → 3.3.2

package/dist/cli/pipeline/operation-steps.js.map

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

package/dist/cli/pipeline/orchestrator.d.ts

@@ -0,0 +1,12 @@
+import type { FailurePolicy, PipelineResult, ProgressCallback, StagePlan } from './types';
+export declare class PipelineOrchestrator {
+    private readonly policy;
+    private readonly onProgress?;
+    constructor(policy?: FailurePolicy, onProgress?: ProgressCallback | undefined);
+    execute(plan: StagePlan): PipelineResult;
+    private runStage;
+    private rollback;
+    private validatePlan;
+    private emit;
+}
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/cli/pipeline/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../src/cli/pipeline/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAS,SAAS,EAAiC,MAAM,SAAS,CAAC;AAEhI,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;gBADX,MAAM,GAAE,aAA+B,EACvC,UAAU,CAAC,EAAE,gBAAgB,YAAA;IAGhD,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,cAAc;IAqBxC,OAAO,CAAC,QAAQ;IA6BhB,OAAO,CAAC,QAAQ;IAwBhB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,IAAI;CAGb"}

package/dist/cli/pipeline/orchestrator.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PipelineOrchestrator = void 0;
+class PipelineOrchestrator {
+    policy;
+    onProgress;
+    constructor(policy = 'stop-on-error', onProgress) {
+        this.policy = policy;
+        this.onProgress = onProgress;
+    }
+    execute(plan) {
+        this.validatePlan(plan);
+        const stepById = new Map();
+        for (const step of [...plan.prepare, ...plan.apply])
+            stepById.set(step.id, step);
+        const prepare = this.runStage('prepare', plan.prepare);
+        if (!prepare.success)
+            return { prepare, apply: emptyStage('apply'), error: prepare.error };
+        const apply = this.runStage('apply', plan.apply);
+        const result = { prepare, apply };
+        if (apply.success)
+            return result;
+        result.error = apply.error;
+        const rollback = this.rollback(apply.steps, stepById);
+        result.rollback = rollback;
+        if (!rollback.success) {
+            result.error = new Error(`Apply failed: ${apply.error?.message}. Rollback also failed: ${rollback.error?.message}`);
+        }
+        return result;
+    }
+    runStage(stage, steps) {
+        const results = [];
+        const errors = [];
+        for (const step of steps) {
+            this.emit(stage, step.id, 'running');
+            const startedAt = new Date();
+            try {
+                step.run();
+                const result = { stepId: step.id, status: 'succeeded', startedAt, finishedAt: new Date() };
+                results.push(result);
+                this.emit(stage, step.id, 'succeeded');
+            }
+            catch (error) {
+                const err = asError(error);
+                const result = { stepId: step.id, status: 'failed', startedAt, finishedAt: new Date(), error: err };
+                results.push(result);
+                errors.push(err);
+                this.emit(stage, step.id, 'failed', err);
+                if (this.policy === 'stop-on-error')
+                    return { stage, success: false, steps: results, error: err };
+            }
+        }
+        return {
+            stage,
+            success: errors.length === 0,
+            steps: results,
+            error: joinErrors(errors),
+        };
+    }
+    rollback(applyResults, stepById) {
+        const steps = [];
+        for (let index = applyResults.length - 1; index >= 0; index -= 1) {
+            const applied = applyResults[index];
+            if (applied.status !== 'succeeded')
+                continue;
+            const step = stepById.get(applied.stepId);
+            if (!step?.rollback)
+                continue;
+            this.emit('rollback', step.id, 'running');
+            const startedAt = new Date();
+            try {
+                step.rollback();
+                steps.push({ stepId: step.id, status: 'rolled-back', startedAt, finishedAt: new Date() });
+                this.emit('rollback', step.id, 'rolled-back');
+            }
+            catch (error) {
+                const err = asError(error);
+                steps.push({ stepId: step.id, status: 'failed', startedAt, finishedAt: new Date(), error: err });
+                this.emit('rollback', step.id, 'failed', err);
+                return { stage: 'rollback', success: false, steps, error: err };
+            }
+        }
+        return { stage: 'rollback', success: true, steps };
+    }
+    validatePlan(plan) {
+        const seen = new Set();
+        for (const step of [...plan.prepare, ...plan.apply]) {
+            if (seen.has(step.id))
+                throw new Error(`Duplicate pipeline step id: ${step.id}`);
+            seen.add(step.id);
+        }
+    }
+    emit(stage, stepId, status, error) {
+        this.onProgress?.({ stage, stepId, status, error });
+    }
+}
+exports.PipelineOrchestrator = PipelineOrchestrator;
+function emptyStage(stage) {
+    return { stage, success: true, steps: [] };
+}
+function asError(error) {
+    return error instanceof Error ? error : new Error(String(error));
+}
+function joinErrors(errors) {
+    if (errors.length === 0)
+        return undefined;
+    if (errors.length === 1)
+        return errors[0];
+    return new Error(errors.map((error) => error.message).join('\n'));
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/cli/pipeline/orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../../src/cli/pipeline/orchestrator.ts"],"names":[],"mappings":";;;AAEA,MAAa,oBAAoB;IAEZ;IACA;IAFnB,YACmB,SAAwB,eAAe,EACvC,UAA6B;QAD7B,WAAM,GAAN,MAAM,CAAiC;QACvC,eAAU,GAAV,UAAU,CAAmB;IAC7C,CAAC;IAEJ,OAAO,CAAC,IAAe;QACrB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACxB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAgB,CAAC;QACzC,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;YAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAEjF,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACvD,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QAE3F,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACjD,MAAM,MAAM,GAAmB,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAClD,IAAI,KAAK,CAAC,OAAO;YAAE,OAAO,MAAM,CAAC;QAEjC,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACtD,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC3B,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtB,MAAM,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,iBAAiB,KAAK,CAAC,KAAK,EAAE,OAAO,2BAA2B,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QACtH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,QAAQ,CAAC,KAAY,EAAE,KAAa;QAC1C,MAAM,OAAO,GAAiB,EAAE,CAAC;QACjC,MAAM,MAAM,GAAY,EAAE,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;YACrC,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,IAAI,CAAC,GAAG,EAAE,CAAC;gBACX,MAAM,MAAM,GAAe,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC;gBACvG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACrB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;YACzC,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC3B,MAAM,MAAM,GAAe,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;gBAChH,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACrB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACjB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;gBACzC,IAAI,IAAI,CAAC,MAAM,KAAK,eAAe;oBAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;YACpG,CAAC;QACH,CAAC;QAED,OAAO;YACL,KAAK;YACL,OAAO,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC5B,KAAK,EAAE,OAAO;YACd,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC;SAC1B,CAAC;IACJ,CAAC;IAEO,QAAQ,CAAC,YAA0B,EAAE,QAA2B;QACtE,MAAM,KAAK,GAAiB,EAAE,CAAC;QAC/B,KAAK,IAAI,KAAK,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YACjE,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;YACpC,IAAI,OAAO,CAAC,MAAM,KAAK,WAAW;gBAAE,SAAS;YAC7C,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC1C,IAAI,CAAC,IAAI,EAAE,QAAQ;gBAAE,SAAS;YAE9B,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;YAC1C,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAChB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC1F,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;YAChD,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;gBACjG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;gBAC9C,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;YAClE,CAAC;QACH,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACrD,CAAC;IAEO,YAAY,CAAC,IAAe;QAClC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACpD,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;YACjF,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAEO,IAAI,CAAC,KAAY,EAAE,MAAc,EAAE,MAA4B,EAAE,KAAa;QACpF,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;CACF;AA3FD,oDA2FC;AAED,SAAS,UAAU,CAAC,KAAY;IAC9B,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAC7C,CAAC;AAED,SAAS,OAAO,CAAC,KAAc;IAC7B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,UAAU,CAAC,MAAe;IACjC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1C,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACpE,CAAC"}

package/dist/cli/pipeline/types.d.ts

@@ -0,0 +1,40 @@
+export type Stage = 'prepare' | 'apply' | 'rollback';
+export type StepStatus = 'pending' | 'running' | 'succeeded' | 'failed' | 'rolled-back';
+export type FailurePolicy = 'stop-on-error' | 'continue-on-error';
+export interface ProgressEvent {
+    stage: Stage;
+    stepId: string;
+    status: StepStatus;
+    error?: Error;
+}
+export type ProgressCallback = (event: ProgressEvent) => void;
+export interface Step {
+    readonly id: string;
+    readonly description: string;
+    run(): void;
+    rollback?(): void;
+}
+export interface StagePlan {
+    prepare: Step[];
+    apply: Step[];
+}
+export interface StepResult {
+    stepId: string;
+    status: StepStatus;
+    startedAt: Date;
+    finishedAt?: Date;
+    error?: Error;
+}
+export interface StageResult {
+    stage: Stage;
+    success: boolean;
+    steps: StepResult[];
+    error?: Error;
+}
+export interface PipelineResult {
+    prepare: StageResult;
+    apply: StageResult;
+    rollback?: StageResult;
+    error?: Error;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cli/pipeline/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/pipeline/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AACrD,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,aAAa,CAAC;AACxF,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG,mBAAmB,CAAC;AAElE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;AAE9D,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,GAAG,IAAI,IAAI,CAAC;IACZ,QAAQ,CAAC,IAAI,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,IAAI,EAAE,CAAC;IAChB,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,UAAU,CAAC,EAAE,IAAI,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,WAAW,CAAC;IACrB,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf"}

package/dist/cli/pipeline/types.js

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

package/dist/cli/pipeline/types.js.map

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

package/dist/cli/types.d.ts

@@ -37,14 +37,19 @@ export interface CliOptions {
     help: boolean;
     tokens: boolean;
     artifacts: boolean;
+    adapters: boolean;
     kyroScope: string | null;
+    json: boolean;
+    purgeAdapterAssets: boolean;
+    prune: boolean;
 }
 export interface OperationPlan {
-    action: 'write' | 'copy' | 'mkdir' | 'remove' | 'upsert-block' | 'remove-block' | 'symlink';
+    action: 'write' | 'copy' | 'mkdir' | 'remove' | 'rmdir-if-empty' | 'upsert-block' | 'remove-block' | 'symlink' | 'merge-json' | 'remove-json-key';
     path: string;
     source?: string;
     content?: string;
     blockName?: string;
+    jsonPath?: string;
 }
 export interface CheckResult {
     status: 'pass' | 'warn' | 'fail';

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAE/D,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,OAAO,KAAK,CAAC,CAAC;AACvD,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,OAAO,KAAK,CAAC,CAAC;AAC9D,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,CAAC,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,oBAAoB,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,CAAC,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,EAAE,oBAAoB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,cAAc,GAAG,cAAc,GAAG,SAAS,CAAC;IAC5F,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAE/D,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,OAAO,KAAK,CAAC,CAAC;AACvD,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,OAAO,KAAK,CAAC,CAAC;AAC9D,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,CAAC,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,oBAAoB,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,CAAC,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,EAAE,oBAAoB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,kBAAkB,EAAE,OAAO,CAAC;IAC5B,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,gBAAgB,GAAG,cAAc,GAAG,cAAc,GAAG,SAAS,GAAG,YAAY,GAAG,iBAAiB,CAAC;IAClJ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/docs/HOW-TO-USE-OPENCODE.md

@@ -1,6 +1,6 @@
 # OpenCode Adapter Guide
 
-OpenCode should discover Kyro through global command skills. Do not copy Kyro core into each project.
+OpenCode should discover Kyro through native OpenCode skills and slash commands. Do not copy Kyro core into each project.
 
 ## Setup
 
@@ -11,19 +11,23 @@ npx kyro-ai install --agent opencode --scope workspace --yes
 This installs:
 
 - global runtime: `~/.agents/kyro/current/`
-- global command skills: `~/.agents/skills/kyro-*`
+- native OpenCode skills: `~/.config/opencode/skills/kyro-*`
+- native OpenCode commands: `~/.config/opencode/commands/kyro/*.md`
+- OpenCode agent overlay: `~/.config/opencode/opencode.json` key `agent.kyro-orchestrator`
 - project state: `.agents/kyro/kyro.json`
 
 ## Usage
 
-Use the installed command-like skills:
+Use the installed commands or command-like skills:
 
-- `kyro-forge` — route analyze/plan/execute/review/close
-- `kyro-status` — summary-first progress and debt report
-- `kyro-wrap-up` — close session and refresh handoff context
+- `/kyro/forge` or `kyro-forge` — route analyze/plan/execute/review/close
+- `/kyro/status` or `kyro-status` — summary-first progress and debt report
+- `/kyro/wrap-up` or `kyro-wrap-up` — close session and refresh handoff context
 
 Each skill is intentionally tiny. It loads the command router first, then only the mode/helper/template needed for the current step.
 
+Kyro owns only the `agent.kyro-orchestrator` entry in `opencode.json`. Existing models, agents, MCP servers, providers, and other OpenCode settings are preserved.
+
 ## Artifacts
 
 Save workflow artifacts under:

package/docs/agent-adapters.md

@@ -1,6 +1,6 @@
 # Agent Adapters
 
-Kyro's adapter contract is: global runtime, global command skills, local project state. Agents should invoke Kyro through command-like skills or slash commands, not by loading the full workflow manually.
+Kyro's adapter contract is: global runtime, adapter command entrypoints, and local project state. Agents should invoke Kyro through command-like skills or slash commands, not by loading the full workflow manually.
 
 ## Stable interface
 
@@ -8,7 +8,10 @@ Kyro's adapter contract is: global runtime, global command skills, local project
 |-----------|---------|
 | `~/.agents/kyro/current/commands/*.md` | Thin command routers |
 | `~/.agents/kyro/current/skills/sprint-forge/` | Lazy-loaded workflow modes, helpers, templates |
-| `~/.agents/skills/kyro-*` | Global command skills discovered by compatible agents |
+| `~/.agents/skills/kyro-*` | Standard global command skills discovered by compatible agents |
+| `~/.config/opencode/skills/kyro-*` | Native OpenCode command skills |
+| `~/.config/opencode/commands/kyro/*.md` | Native OpenCode slash commands |
+| `~/.config/opencode/opencode.json` `agent.kyro-orchestrator` | Kyro-owned OpenCode agent overlay |
 | `.agents/kyro/kyro.json` | Project-level Kyro state |
 | `.agents/kyro/scopes/{scope}/` | Scope artifacts, state, summaries, roadmap, sprints |
 | root `AGENTS.md` | Small Codex/cross-agent bootstrap when the Codex adapter is installed |
@@ -26,7 +29,7 @@ Implemented adapters:
 | Adapter | Behavior |
 |---------|----------|
 | `standard` | Installs global `kyro-*` command skills for compatible agents. |
-| `opencode` | Uses the same global command skill projection. |
+| `opencode` | Installs native OpenCode skills, `/kyro/*` command markdown, and a Kyro-owned `agent.kyro-orchestrator` overlay. |
 | `codex` | Adds global command skills plus a small Kyro block in root `AGENTS.md`. |
 
 There is intentionally no generic adapter. Root `AGENTS.md` is the standard cross-agent bootstrap.
@@ -59,7 +62,9 @@ Use:
 npx kyro-ai install --agent opencode --scope workspace --yes
 ```
 
-OpenCode should invoke `kyro-forge`, `kyro-status`, and `kyro-wrap-up` from global skills. It should not copy Kyro core into the project.
+OpenCode should invoke the native `/kyro/forge`, `/kyro/status`, and `/kyro/wrap-up` commands, or the installed `kyro-*` skills under `~/.config/opencode/skills/`. It should not copy Kyro core into the project.
+
+Kyro preserves existing `opencode.json` content and owns only `agent.kyro-orchestrator`. MCP merge is not enabled until there is a concrete Kyro MCP server contract.
 
 ## Claude
 

package/docs/cli.md

@@ -65,7 +65,7 @@ Implemented workspace adapters:
 | Adapter | Purpose |
 | --- | --- |
 | `standard` | Base `~/.agents/skills/kyro-*` command skill projection for compatible agents |
-| `opencode` | OpenCode adapter using the same projected Kyro command skills |
+| `opencode` | Native OpenCode skills, commands under `~/.config/opencode/commands/kyro/`, and `agent.kyro-orchestrator` in `opencode.json` |
 | `codex` | Codex adapter with projected Kyro command skills plus a managed root `AGENTS.md` block |
 
 Default install uses `standard`:
@@ -83,7 +83,7 @@ kyro install --agent codex --scope workspace --yes
 kyro install --agent standard,opencode,codex --scope workspace --yes
 ```
 
-The adapters project Kyro workflows into `~/.agents/skills/` so compatible agents can discover command-like skills without asking the user to invoke Kyro through prose.
+The adapters project Kyro workflows into concrete agent entrypoints so compatible agents can discover command-like skills without asking the user to invoke Kyro through prose. `standard` and `codex` use `~/.agents/skills/`; OpenCode uses its native config tree and preserves non-Kyro `opencode.json` keys.
 
 Projected skills:
 
@@ -93,6 +93,24 @@ Projected skills:
 
 Each projected skill references the managed Kyro runtime in `~/.agents/kyro/current/` instead of duplicating long workflow instructions.
 
+## Uninstall
+
+Default uninstall removes project bootstraps and adapter overlays, but preserves adapter entrypoint files:
+
+```bash
+kyro uninstall --yes
+```
+
+To remove adapter-owned entrypoint files as well:
+
+```bash
+kyro uninstall --purge-adapter-assets --yes
+```
+
+Purge removes only files declared by the installed adapter, then removes Kyro-owned directories if they are empty. Shared config files such as `~/.config/opencode/opencode.json` are preserved; Kyro removes only its owned overlay key.
+
+The uninstall output includes a summary with overlay, purged file, and empty-directory counts.
+
 ## State Model
 
 `kyro install` creates only root project state:
@@ -175,6 +193,34 @@ kyro sync --agent standard --dry-run
 kyro sync --agent codex --dry-run
 ```
 
+### Drift And Prune
+
+`kyro sync` reports drift when old manifests point to stale runtime versions or obsolete Kyro-owned adapter entrypoint files.
+
+Use prune to clean drift during sync:
+
+```bash
+kyro sync --prune
+```
+
+`--prune` may remove:
+
+- stale runtime version directories under `~/.agents/kyro/versions/`, except the current package version.
+- obsolete Kyro-owned adapter entrypoint files previously declared by old manifests:
+  - `~/.agents/skills/kyro-*`
+  - `~/.config/opencode/skills/kyro-*`
+  - `~/.config/opencode/commands/kyro/*`
+
+`--prune` preserves:
+
+- current runtime files declared by the new manifest.
+- project state, scopes, roadmap files, sprint files, and summaries under `.agents/kyro/scopes/`.
+- shared agent config files such as `~/.config/opencode/opencode.json`.
+
+If an old manifest lists shared config, sync reports it under `Shared config preserved` instead of pruning it.
+
+`--prune` is different from `kyro uninstall --purge-adapter-assets`. Prune cleans sync drift by comparing old manifests against the current install plan. Purge removes adapter entrypoint files during uninstall for adapters recorded in the installed project state. Neither mode removes shared user config.
+
 ## Claude Plugin Support
 
 The Claude plugin adapter remains first-class through `.claude-plugin/`. The CLI does not replace it; it complements Kyro's adapter story for agents that need workspace-installed commands, skills, root `AGENTS.md` managed blocks, and core assets.

package/docs/getting-started.md

@@ -46,6 +46,14 @@ Global command skills:
 └── kyro-wrap-up/SKILL.md
 ```
 
+OpenCode installs equivalent native entrypoints:
+
+```text
+~/.config/opencode/
+├── commands/kyro/
+└── skills/kyro-*/
+```
+
 Project state:
 
 ```text

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kyro-ai",
-  "version": "3.3.0",
+  "version": "3.3.2",
   "description": "Portable sprint workflow kit for AI coding agents, with markdown artifacts, adapter guides, and formal debt tracking",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -15,7 +15,8 @@
     "build:chmod": "node scripts/make-cli-executable.mjs",
     "check:tokens": "node dist/cli.js doctor --tokens",
     "check:artifacts": "node dist/cli.js doctor --artifacts",
-    "check:artifact-fixtures": "node scripts/check-artifact-fixtures.mjs"
+    "check:artifact-fixtures": "node scripts/check-artifact-fixtures.mjs",
+    "check:adapters": "node scripts/check-adapter-fixtures.mjs"
   },
   "keywords": [
     "ai-agents",