kyro-ai 3.2.3 → 3.3.0

package/fixtures/artifact-integrity/stale-summary/.agents/kyro/scopes/demo/DEBT.summary.json

@@ -0,0 +1,12 @@
+{
+  "schemaVersion": 1,
+  "scope": "demo",
+  "open": 1,
+  "inProgress": 0,
+  "resolved": 0,
+  "deferred": 0,
+  "critical": 1,
+  "oldestOpenItem": "| D1 | Demo debt | open | critical |",
+  "sourceMarkdown": ".agents/kyro/scopes/demo/phases/SPRINT-001-demo.md",
+  "lastUpdated": "2026-06-14T00:00:00.000Z"
+}

package/fixtures/artifact-integrity/stale-summary/.agents/kyro/scopes/demo/RE-ENTRY-PROMPTS.md

@@ -0,0 +1 @@
+# Re-entry

package/fixtures/artifact-integrity/stale-summary/.agents/kyro/scopes/demo/ROADMAP.md

@@ -0,0 +1,4 @@
+# Demo roadmap
+
+## Sprint 1
+- Focus: demo

package/fixtures/artifact-integrity/stale-summary/.agents/kyro/scopes/demo/ROADMAP.summary.json

@@ -0,0 +1,15 @@
+{
+  "schemaVersion": 1,
+  "scope": "demo",
+  "status": "planned",
+  "summary": "Demo roadmap",
+  "plannedSprintCount": 1,
+  "completedSprintCount": 0,
+  "adaptationCount": 0,
+  "nextRecommendedAction": "execute_task",
+  "openDecisions": [],
+  "relevantArtifactPaths": [
+    ".agents/kyro/scopes/demo/ROADMAP.md"
+  ],
+  "lastUpdated": "2026-06-14T00:00:00.000Z"
+}

package/fixtures/artifact-integrity/stale-summary/.agents/kyro/scopes/demo/index.json

@@ -0,0 +1,15 @@
+{
+  "schemaVersion": 1,
+  "scope": "demo",
+  "roadmapSummary": "Demo roadmap",
+  "activeSprintSummary": ".agents/kyro/scopes/demo/phases/SPRINT-001-demo.summary.json",
+  "openDebtCount": 1,
+  "nextTask": "T1.2",
+  "relevantArtifactPaths": {
+    "roadmap": ".agents/kyro/scopes/demo/ROADMAP.md",
+    "roadmapSummary": ".agents/kyro/scopes/demo/ROADMAP.summary.json",
+    "sprints": ".agents/kyro/scopes/demo/phases",
+    "reentry": ".agents/kyro/scopes/demo/RE-ENTRY-PROMPTS.md"
+  },
+  "lastUpdated": "2026-06-14T00:00:00.000Z"
+}

package/fixtures/artifact-integrity/stale-summary/.agents/kyro/scopes/demo/phases/SPRINT-001-demo.md

@@ -0,0 +1,8 @@
+# Sprint 1 Demo
+
+- [x] T1.1 Completed task
+- [ ] T1.2 Pending task
+
+## Debt
+| ID | Item | Status | Priority |
+| D1 | Demo debt | open | critical |

package/fixtures/artifact-integrity/stale-summary/.agents/kyro/scopes/demo/phases/SPRINT-001-demo.summary.json

@@ -0,0 +1,16 @@
+{
+  "schemaVersion": 1,
+  "scope": "demo",
+  "sprint": "SPRINT-001-demo",
+  "status": "active",
+  "completedTasks": 1,
+  "blockedTasks": 0,
+  "carryOverTasks": 0,
+  "nextRecommendedAction": "execute_task",
+  "nextTask": "T1.2",
+  "openDecisions": [],
+  "filesTouched": [],
+  "debtDeltas": [],
+  "sourceMarkdown": ".agents/kyro/scopes/demo/phases/SPRINT-001-demo.md",
+  "lastUpdated": "2026-06-14T00:00:00.000Z"
+}

package/fixtures/artifact-integrity/stale-summary/.agents/kyro/scopes/demo/state.json

@@ -0,0 +1,11 @@
+{
+  "schemaVersion": 1,
+  "scope": "demo",
+  "status": "active",
+  "activeSprint": "SPRINT-001-demo",
+  "currentPhase": "sprint",
+  "nextAction": "execute_task",
+  "roadmapPath": ".agents/kyro/scopes/demo/ROADMAP.md",
+  "sprintsPath": ".agents/kyro/scopes/demo/phases",
+  "lastUpdated": "2026-06-14T00:00:00.000Z"
+}

package/fixtures/artifact-integrity/valid/.agents/kyro/kyro.json

@@ -0,0 +1,11 @@
+{
+  "schemaVersion": 1,
+  "artifactRoot": ".agents/kyro/scopes",
+  "scopes": [
+    "demo"
+  ],
+  "activeScope": "demo",
+  "runtimeVersion": "3.2.3",
+  "runtimePath": "~/.agents/kyro/current",
+  "installedAdapters": []
+}

package/fixtures/artifact-integrity/valid/.agents/kyro/scopes/demo/DEBT.summary.json

@@ -0,0 +1,12 @@
+{
+  "schemaVersion": 1,
+  "scope": "demo",
+  "open": 1,
+  "inProgress": 0,
+  "resolved": 0,
+  "deferred": 0,
+  "critical": 1,
+  "oldestOpenItem": "| D1 | Demo debt | open | critical |",
+  "sourceMarkdown": ".agents/kyro/scopes/demo/phases/SPRINT-001-demo.md",
+  "lastUpdated": "2026-06-14T00:00:00.000Z"
+}

package/fixtures/artifact-integrity/valid/.agents/kyro/scopes/demo/RE-ENTRY-PROMPTS.md

@@ -0,0 +1 @@
+# Re-entry

package/fixtures/artifact-integrity/valid/.agents/kyro/scopes/demo/ROADMAP.md

@@ -0,0 +1,4 @@
+# Demo roadmap
+
+## Sprint 1
+- Focus: demo

package/fixtures/artifact-integrity/valid/.agents/kyro/scopes/demo/ROADMAP.summary.json

@@ -0,0 +1,15 @@
+{
+  "schemaVersion": 1,
+  "scope": "demo",
+  "status": "planned",
+  "summary": "Demo roadmap",
+  "plannedSprintCount": 1,
+  "completedSprintCount": 0,
+  "adaptationCount": 0,
+  "nextRecommendedAction": "execute_task",
+  "openDecisions": [],
+  "relevantArtifactPaths": [
+    ".agents/kyro/scopes/demo/ROADMAP.md"
+  ],
+  "lastUpdated": "2026-06-14T00:00:00.000Z"
+}

package/fixtures/artifact-integrity/valid/.agents/kyro/scopes/demo/index.json

@@ -0,0 +1,15 @@
+{
+  "schemaVersion": 1,
+  "scope": "demo",
+  "roadmapSummary": "Demo roadmap",
+  "activeSprintSummary": ".agents/kyro/scopes/demo/phases/SPRINT-001-demo.summary.json",
+  "openDebtCount": 1,
+  "nextTask": "T1.2",
+  "relevantArtifactPaths": {
+    "roadmap": ".agents/kyro/scopes/demo/ROADMAP.md",
+    "roadmapSummary": ".agents/kyro/scopes/demo/ROADMAP.summary.json",
+    "sprints": ".agents/kyro/scopes/demo/phases",
+    "reentry": ".agents/kyro/scopes/demo/RE-ENTRY-PROMPTS.md"
+  },
+  "lastUpdated": "2026-06-14T00:00:00.000Z"
+}

package/fixtures/artifact-integrity/valid/.agents/kyro/scopes/demo/phases/SPRINT-001-demo.md

@@ -0,0 +1,8 @@
+# Sprint 1 Demo
+
+- [x] T1.1 Completed task
+- [ ] T1.2 Pending task
+
+## Debt
+| ID | Item | Status | Priority |
+| D1 | Demo debt | open | critical |

package/fixtures/artifact-integrity/valid/.agents/kyro/scopes/demo/phases/SPRINT-001-demo.summary.json

@@ -0,0 +1,16 @@
+{
+  "schemaVersion": 1,
+  "scope": "demo",
+  "sprint": "SPRINT-001-demo",
+  "status": "active",
+  "completedTasks": 1,
+  "blockedTasks": 0,
+  "carryOverTasks": 0,
+  "nextRecommendedAction": "execute_task",
+  "nextTask": "T1.2",
+  "openDecisions": [],
+  "filesTouched": [],
+  "debtDeltas": [],
+  "sourceMarkdown": ".agents/kyro/scopes/demo/phases/SPRINT-001-demo.md",
+  "lastUpdated": "2026-06-14T00:00:00.000Z"
+}

package/fixtures/artifact-integrity/valid/.agents/kyro/scopes/demo/state.json

@@ -0,0 +1,11 @@
+{
+  "schemaVersion": 1,
+  "scope": "demo",
+  "status": "active",
+  "activeSprint": "SPRINT-001-demo",
+  "currentPhase": "sprint",
+  "nextAction": "execute_task",
+  "roadmapPath": ".agents/kyro/scopes/demo/ROADMAP.md",
+  "sprintsPath": ".agents/kyro/scopes/demo/phases",
+  "lastUpdated": "2026-06-14T00:00:00.000Z"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kyro-ai",
-  "version": "3.2.3",
+  "version": "3.3.0",
   "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",
@@ -12,7 +12,10 @@
     "check:versions": "node scripts/check-versions.mjs",
     "check": "npm run typecheck && npm run check:versions && npm run check:links",
     "prepublishOnly": "npm run build",
-    "build:chmod": "node scripts/make-cli-executable.mjs"
+    "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"
   },
   "keywords": [
     "ai-agents",
@@ -61,6 +64,7 @@
     "agents",
     "skills",
     "scripts",
+    "fixtures",
     "docs",
     "rules",
     "contexts",

package/scripts/check-artifact-fixtures.mjs

@@ -0,0 +1,56 @@
+import { cpSync, mkdtempSync, rmSync, utimesSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { spawnSync } from 'node:child_process';
+
+const repo = resolve(new URL('..', import.meta.url).pathname);
+const cli = join(repo, 'dist/cli.js');
+const fixtures = join(repo, 'fixtures/artifact-integrity');
+
+function run(cwd, args) {
+  return spawnSync(process.execPath, [cli, ...args], {
+    cwd,
+    env: { ...process.env, HOME: join(cwd, '.home') },
+    encoding: 'utf-8',
+  });
+}
+
+function assert(condition, message) {
+  if (!condition) throw new Error(message);
+}
+
+function assertDoctor(name, expectedStatus, expectedText) {
+  const result = run(join(fixtures, name), ['doctor', '--artifacts', '--kyro-scope', 'demo']);
+  const output = `${result.stdout}\n${result.stderr}`;
+  assert(result.status === expectedStatus, `${name}: expected exit ${expectedStatus}, got ${result.status}\n${output}`);
+  assert(output.includes(expectedText), `${name}: expected output to include ${expectedText}\n${output}`);
+}
+
+assertDoctor('valid', 0, '[PASS] artifact state.json');
+assertDoctor('missing-summary', 0, '[WARN] artifact ROADMAP.summary.json');
+assertDoctor('invalid-state', 1, '[FAIL] artifact state.json');
+assertDoctor('active-sprint-missing', 1, 'activeSprint not found');
+
+const staleDir = mkdtempSync(join(tmpdir(), 'kyro-stale-'));
+cpSync(join(fixtures, 'stale-summary'), staleDir, { recursive: true });
+const roadmap = join(staleDir, '.agents/kyro/scopes/demo/ROADMAP.md');
+const future = new Date(Date.now() + 5000);
+utimesSync(roadmap, future, future);
+const stale = run(staleDir, ['doctor', '--artifacts', '--kyro-scope', 'demo']);
+const staleOutput = `${stale.stdout}\n${stale.stderr}`;
+assert(stale.status === 0, `stale-summary: expected exit 0\n${staleOutput}`);
+assert(staleOutput.includes('older than ROADMAP.md'), `stale-summary: expected stale warning\n${staleOutput}`);
+rmSync(staleDir, { recursive: true, force: true });
+
+const repairDir = mkdtempSync(join(tmpdir(), 'kyro-repair-'));
+cpSync(join(fixtures, 'missing-summary'), repairDir, { recursive: true });
+const repair = run(repairDir, ['repair', '--kyro-scope', 'demo', '--yes']);
+const repairOutput = `${repair.stdout}\n${repair.stderr}`;
+assert(repair.status === 0, `repair: expected exit 0\n${repairOutput}`);
+const repaired = run(repairDir, ['doctor', '--artifacts', '--kyro-scope', 'demo']);
+const repairedOutput = `${repaired.stdout}\n${repaired.stderr}`;
+assert(repaired.status === 0, `repaired doctor: expected exit 0\n${repairedOutput}`);
+assert(!repairedOutput.includes('missing'), `repaired doctor: expected missing warnings to be gone\n${repairedOutput}`);
+rmSync(repairDir, { recursive: true, force: true });
+
+console.log('Artifact integrity fixtures passed');