@pleri/olam-cli 0.1.159 → 0.1.161

package/dist/commands/flywheel/diversity-check.js

@@ -1,14 +1,64 @@
 /**
- * `olam flywheel diversity-check` — stub registered in task A1.
- * Implementation lands in task A8 (port from `shared/engineering/scripts/diversity_check.py`).
+ * `olam flywheel diversity-check` — cross-persona Jaccard similarity CLI.
+ *
+ * Reads persona-prompt files from a glob; computes pairwise Jaccard; reports
+ * pairs exceeding the threshold (default 0.7). Used by /10x:learn write-path
+ * to detect silent convergence collapse across K1 personas.
+ *
+ * Exit codes:
+ *   0 = no convergence (all pairs below threshold)
+ *   1 = convergence detected (one or more pairs above threshold)
+ *   2 = unexpected error (no matching files / read failure)
+ *
+ * Plan reference: docs/plans/olam-flywheel-cli-namespace/phase-a-tasks.md § A8
  */
+import { readFileSync } from 'node:fs';
+import { basename } from 'node:path';
+import { globSync } from 'node:fs';
+import { crossPersonaCheck, formatRedivergencePrompt, DIVERSITY_THRESHOLD, } from '@olam/core/src/lib/diversity-check.js';
 export function registerFlywheelDiversityCheck(parent) {
     parent
         .command('diversity-check')
-        .description('Cross-plan breadcrumb diversity aggregator (stub — implemented in task A8)')
-        .action(() => {
-        console.error('olam flywheel diversity-check: not yet implemented (task A8). See docs/plans/olam-flywheel-cli-namespace/phase-a-tasks.md');
-        process.exit(2);
+        .description('Cross-persona Jaccard similarity guard — flag persona pairs above threshold')
+        .requiredOption('--glob <pattern>', 'glob pattern matching persona-prompt files')
+        .option('--threshold <0.0-1.0>', 'Jaccard threshold (default 0.7)')
+        .option('--json', 'emit findings as JSON instead of human-readable')
+        .action((opts) => {
+        const threshold = opts.threshold !== undefined ? Number.parseFloat(opts.threshold) : DIVERSITY_THRESHOLD;
+        if (!Number.isFinite(threshold) || threshold < 0 || threshold > 1) {
+            process.stderr.write(`[diversity-check-reject] --threshold must be 0.0-1.0; got ${JSON.stringify(opts.threshold)}\n`);
+            process.exit(2);
+        }
+        // Use Node 22+'s native glob (no extra dep).
+        const files = globSync(opts.glob);
+        if (files.length === 0) {
+            process.stderr.write(`[diversity-check-reject] no files matched glob: ${opts.glob}\n`);
+            process.exit(2);
+        }
+        const personas = new Map();
+        for (const filepath of files) {
+            try {
+                const body = readFileSync(filepath, 'utf8');
+                if (body.trim().length > 0) {
+                    personas.set(basename(filepath, '.md'), body);
+                }
+            }
+            catch (err) {
+                process.stderr.write(`[diversity-check-error] cannot read ${filepath}: ${err instanceof Error ? err.message : 'unknown'}\n`);
+                process.exit(2);
+            }
+        }
+        const flagged = crossPersonaCheck(personas, threshold);
+        if (opts.json) {
+            process.stdout.write(JSON.stringify({ threshold, persona_count: personas.size, flagged }) + '\n');
+        }
+        else {
+            process.stdout.write(`[diversity-check] ${personas.size} personas; threshold ${threshold}; ${flagged.length} pair(s) over threshold\n`);
+            for (const { persona_a, persona_b, score } of flagged) {
+                process.stdout.write(`\n${formatRedivergencePrompt(persona_a, persona_b, score, undefined, undefined, threshold)}\n`);
+            }
+        }
+        process.exit(flagged.length > 0 ? 1 : 0);
     });
 }
 //# sourceMappingURL=diversity-check.js.map

package/dist/commands/flywheel/diversity-check.js.map

@@ -1 +1 @@
-{"version":3,"file":"diversity-check.js","sourceRoot":"","sources":["../../../src/commands/flywheel/diversity-check.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,UAAU,8BAA8B,CAAC,MAAe;IAC5D,MAAM;SACH,OAAO,CAAC,iBAAiB,CAAC;SAC1B,WAAW,CAAC,4EAA4E,CAAC;SACzF,MAAM,CAAC,GAAG,EAAE;QACX,OAAO,CAAC,KAAK,CACX,2HAA2H,CAC5H,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"diversity-check.js","sourceRoot":"","sources":["../../../src/commands/flywheel/diversity-check.ts"],"names":[],"mappings":"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"}

package/dist/commands/flywheel/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/flywheel/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWzC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgBvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/flywheel/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYzC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiBvD"}

package/dist/commands/flywheel/index.js

@@ -31,6 +31,7 @@ import { registerFlywheelCheckPersonaSkeleton } from './check-persona-skeleton.j
 import { registerFlywheelDiversityCheck } from './diversity-check.js';
 import { registerFlywheelPing } from './ping.js';
 import { registerFlywheelInstallShims } from './install-shims.js';
+import { registerFlywheelMigrateOverlays } from './migrate-overlays.js';
 export function registerFlywheel(program) {
     const flywheel = program
         .command('flywheel')
@@ -44,5 +45,6 @@ export function registerFlywheel(program) {
     registerFlywheelDiversityCheck(flywheel);
     registerFlywheelPing(flywheel);
     registerFlywheelInstallShims(flywheel);
+    registerFlywheelMigrateOverlays(flywheel);
 }
 //# sourceMappingURL=index.js.map

package/dist/commands/flywheel/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/flywheel/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,qCAAqC,EAAE,MAAM,8BAA8B,CAAC;AACrF,OAAO,EAAE,oCAAoC,EAAE,MAAM,6BAA6B,CAAC;AACnF,OAAO,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAElE,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,MAAM,QAAQ,GAAG,OAAO;SACrB,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CACV,qNAAqN,CACtN,CAAC;IAEJ,8BAA8B,CAAC,QAAQ,CAAC,CAAC;IACzC,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAClC,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IACrC,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IACrC,qCAAqC,CAAC,QAAQ,CAAC,CAAC;IAChD,oCAAoC,CAAC,QAAQ,CAAC,CAAC;IAC/C,8BAA8B,CAAC,QAAQ,CAAC,CAAC;IACzC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC/B,4BAA4B,CAAC,QAAQ,CAAC,CAAC;AACzC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/flywheel/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,qCAAqC,EAAE,MAAM,8BAA8B,CAAC;AACrF,OAAO,EAAE,oCAAoC,EAAE,MAAM,6BAA6B,CAAC;AACnF,OAAO,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,+BAA+B,EAAE,MAAM,uBAAuB,CAAC;AAExE,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,MAAM,QAAQ,GAAG,OAAO;SACrB,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CACV,qNAAqN,CACtN,CAAC;IAEJ,8BAA8B,CAAC,QAAQ,CAAC,CAAC;IACzC,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAClC,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IACrC,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IACrC,qCAAqC,CAAC,QAAQ,CAAC,CAAC;IAChD,oCAAoC,CAAC,QAAQ,CAAC,CAAC;IAC/C,8BAA8B,CAAC,QAAQ,CAAC,CAAC;IACzC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC/B,4BAA4B,CAAC,QAAQ,CAAC,CAAC;IACvC,+BAA+B,CAAC,QAAQ,CAAC,CAAC;AAC5C,CAAC"}

package/dist/commands/flywheel/install-shims.d.ts

@@ -1,8 +1,41 @@
 /**
- * `olam flywheel install-shims` — stub registered in task A1.
- * Implementation lands in task A14 (writes delegating shims to ~/.claude/scripts/<name>;
- * detects existing non-shim files; auto-invoked as post-step in `olam skills source pull`).
+ * `olam flywheel install-shims` — write backwards-compat shims to ~/.claude/scripts/.
+ *
+ * Generates a bash shim per spec in SHIM_SPECS and writes it to
+ * ~/.claude/scripts/<basename>. Detects existing non-shim files (operator's
+ * own scripts or atlas-toolbox-shipped originals) and prompts/backs-up
+ * before overwriting. Idempotent — re-runs produce no diff when content
+ * matches.
+ *
+ * Replaces the A1 stub.
+ *
+ * Plan reference: docs/plans/olam-flywheel-cli-namespace/phase-a-tasks.md § A14
+ * Closes part of K1 OQ20 (correct hook-point for shim installation).
  */
 import type { Command } from 'commander';
+export interface InstallShimsOptions {
+    force?: boolean;
+    dryRun?: boolean;
+    targetDir?: string;
+}
+export interface ShimInstallStatus {
+    basename: string;
+    action: 'written' | 'overwritten' | 'unchanged' | 'preserved-existing';
+    targetPath: string;
+    backupPath?: string;
+}
+export interface RefreshShimsResult {
+    results: ShimInstallStatus[];
+    written: number;
+    overwritten: number;
+    unchanged: number;
+    preserved: number;
+}
+/**
+ * Programmatic API for refreshing all shims. Used by:
+ *   - `olam flywheel install-shims` CLI action (this file).
+ *   - `olam skills source pull` post-step (B2 hook point).
+ */
+export declare function refreshShims(opts?: InstallShimsOptions): RefreshShimsResult;
 export declare function registerFlywheelInstallShims(parent: Command): void;
 //# sourceMappingURL=install-shims.d.ts.map

package/dist/commands/flywheel/install-shims.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install-shims.d.ts","sourceRoot":"","sources":["../../../src/commands/flywheel/install-shims.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAUlE"}
+{"version":3,"file":"install-shims.d.ts","sourceRoot":"","sources":["../../../src/commands/flywheel/install-shims.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,oBAAoB,CAAC;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,GAAE,mBAAwB,GAAG,kBAAkB,CAkB/E;AA8CD,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAoClE"}

package/dist/commands/flywheel/install-shims.js

@@ -1,15 +1,126 @@
 /**
- * `olam flywheel install-shims` — stub registered in task A1.
- * Implementation lands in task A14 (writes delegating shims to ~/.claude/scripts/<name>;
- * detects existing non-shim files; auto-invoked as post-step in `olam skills source pull`).
+ * `olam flywheel install-shims` — write backwards-compat shims to ~/.claude/scripts/.
+ *
+ * Generates a bash shim per spec in SHIM_SPECS and writes it to
+ * ~/.claude/scripts/<basename>. Detects existing non-shim files (operator's
+ * own scripts or atlas-toolbox-shipped originals) and prompts/backs-up
+ * before overwriting. Idempotent — re-runs produce no diff when content
+ * matches.
+ *
+ * Replaces the A1 stub.
+ *
+ * Plan reference: docs/plans/olam-flywheel-cli-namespace/phase-a-tasks.md § A14
+ * Closes part of K1 OQ20 (correct hook-point for shim installation).
  */
+import { copyFileSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { SHIM_SPECS, generateShim } from '../../lib/shim-generator.js';
+const SHIM_HEADER_MARKER = '# AUTO-GENERATED by `olam flywheel install-shims`';
+/**
+ * Programmatic API for refreshing all shims. Used by:
+ *   - `olam flywheel install-shims` CLI action (this file).
+ *   - `olam skills source pull` post-step (B2 hook point).
+ */
+export function refreshShims(opts = {}) {
+    const targetDir = opts.targetDir ?? join(homedir(), '.claude', 'scripts');
+    const results = [];
+    let written = 0;
+    let overwritten = 0;
+    let unchanged = 0;
+    let preserved = 0;
+    for (const spec of SHIM_SPECS) {
+        const result = installOne(spec, targetDir, opts);
+        results.push(result);
+        switch (result.action) {
+            case 'written':
+                written += 1;
+                break;
+            case 'overwritten':
+                overwritten += 1;
+                break;
+            case 'unchanged':
+                unchanged += 1;
+                break;
+            case 'preserved-existing':
+                preserved += 1;
+                break;
+        }
+    }
+    return { results, written, overwritten, unchanged, preserved };
+}
+function isOlamGeneratedShim(text) {
+    return text.includes(SHIM_HEADER_MARKER);
+}
+function installOne(spec, targetDir, opts) {
+    const targetPath = join(targetDir, spec.basename);
+    const newContent = generateShim(spec);
+    if (!existsSync(targetPath)) {
+        if (opts.dryRun !== true) {
+            mkdirSync(dirname(targetPath), { recursive: true });
+            writeFileSync(targetPath, newContent, { mode: 0o755 });
+        }
+        return { basename: spec.basename, action: 'written', targetPath };
+    }
+    const existing = readFileSync(targetPath, 'utf8');
+    if (existing === newContent) {
+        return { basename: spec.basename, action: 'unchanged', targetPath };
+    }
+    // Existing file with different content. If it's our generated shim (older
+    // version), overwrite freely. Otherwise it's operator/atlas-toolbox content
+    // — back up unless --force.
+    if (isOlamGeneratedShim(existing)) {
+        if (opts.dryRun !== true) {
+            writeFileSync(targetPath, newContent, { mode: 0o755 });
+        }
+        return { basename: spec.basename, action: 'overwritten', targetPath };
+    }
+    if (opts.force === true) {
+        const backupPath = `${targetPath}.shim-backup-${Math.floor(Date.now() / 1000)}`;
+        if (opts.dryRun !== true) {
+            copyFileSync(targetPath, backupPath);
+            writeFileSync(targetPath, newContent, { mode: 0o755 });
+        }
+        return { basename: spec.basename, action: 'overwritten', targetPath, backupPath };
+    }
+    // Without --force, preserve existing.
+    return { basename: spec.basename, action: 'preserved-existing', targetPath };
+}
 export function registerFlywheelInstallShims(parent) {
     parent
         .command('install-shims')
-        .description('Write delegating shims to ~/.claude/scripts/<name> (stub — implemented in task A14)')
-        .action(() => {
-        console.error('olam flywheel install-shims: not yet implemented (task A14). See docs/plans/olam-flywheel-cli-namespace/phase-a-tasks.md');
-        process.exit(2);
+        .description('Install backwards-compat bash shims under ~/.claude/scripts/ that delegate to olam flywheel <subcmd>')
+        .option('--force', 'overwrite existing non-shim files (backs them up to .shim-backup-<ts>)')
+        .option('--dry-run', 'preview which shims would be written without modifying disk')
+        .option('--target-dir <path>', 'override target directory (default: ~/.claude/scripts/); for tests')
+        .action((opts) => {
+        const targetDir = opts.targetDir ?? join(homedir(), '.claude', 'scripts');
+        const summary = refreshShims(opts);
+        const lines = [];
+        const dryRunSuffix = opts.dryRun === true ? ' (dry-run)' : '';
+        for (const result of summary.results) {
+            switch (result.action) {
+                case 'written':
+                    lines.push(`  WRITTEN     ${result.targetPath}${dryRunSuffix}`);
+                    break;
+                case 'overwritten':
+                    lines.push(`  OVERWRITTEN ${result.targetPath}${dryRunSuffix}${result.backupPath !== undefined ? ` (backup: ${result.backupPath})` : ''}`);
+                    break;
+                case 'unchanged':
+                    lines.push(`  UNCHANGED   ${result.targetPath}`);
+                    break;
+                case 'preserved-existing':
+                    lines.push(`  PRESERVED   ${result.targetPath} (existing non-shim file; use --force to overwrite + backup)`);
+                    break;
+            }
+        }
+        process.stdout.write(`olam flywheel install-shims → ${targetDir}\n`);
+        for (const line of lines)
+            process.stdout.write(line + '\n');
+        process.stdout.write(`\nwritten: ${summary.written}, overwritten: ${summary.overwritten}, unchanged: ${summary.unchanged}, preserved: ${summary.preserved}\n`);
+        // Preserved files indicate operator action needed; exit 1 to surface.
+        if (summary.preserved > 0)
+            process.exit(1);
     });
 }
 //# sourceMappingURL=install-shims.js.map

package/dist/commands/flywheel/install-shims.js.map

@@ -1 +1 @@
-{"version":3,"file":"install-shims.js","sourceRoot":"","sources":["../../../src/commands/flywheel/install-shims.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,UAAU,4BAA4B,CAAC,MAAe;IAC1D,MAAM;SACH,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,qFAAqF,CAAC;SAClG,MAAM,CAAC,GAAG,EAAE;QACX,OAAO,CAAC,KAAK,CACX,0HAA0H,CAC3H,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"install-shims.js","sourceRoot":"","sources":["../../../src/commands/flywheel/install-shims.ts"],"names":[],"mappings":"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"}

package/dist/commands/flywheel/k10-measure.d.ts

@@ -1,6 +1,16 @@
 /**
- * `olam flywheel k10-measure` — stub registered in task A1.
- * Implementation lands in task A5 (port from `shared/engineering/scripts/k10_budget.py`).
+ * `olam flywheel k10-measure` — K10 token-budget measurement CLI.
+ *
+ * Reads `--upstream <path>` + optional `--overlay <path>`; counts tokens via
+ * the len/CHARS_PER_TOKEN heuristic; emits PASS/REJECT verdict matching the
+ * Python predecessor's compute_budget contract.
+ *
+ * Exit codes:
+ *   0 = PASS (within budget OR no overlay)
+ *   1 = REJECT (over budget)
+ *   2 = unexpected error (cannot read upstream file)
+ *
+ * Plan reference: docs/plans/olam-flywheel-cli-namespace/phase-a-tasks.md § A5
  */
 import type { Command } from 'commander';
 export declare function registerFlywheelK10Measure(parent: Command): void;

package/dist/commands/flywheel/k10-measure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"k10-measure.d.ts","sourceRoot":"","sources":["../../../src/commands/flywheel/k10-measure.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAUhE"}
+{"version":3,"file":"k10-measure.d.ts","sourceRoot":"","sources":["../../../src/commands/flywheel/k10-measure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASzC,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAgDhE"}

package/dist/commands/flywheel/k10-measure.js

@@ -1,14 +1,63 @@
 /**
- * `olam flywheel k10-measure` — stub registered in task A1.
- * Implementation lands in task A5 (port from `shared/engineering/scripts/k10_budget.py`).
+ * `olam flywheel k10-measure` — K10 token-budget measurement CLI.
+ *
+ * Reads `--upstream <path>` + optional `--overlay <path>`; counts tokens via
+ * the len/CHARS_PER_TOKEN heuristic; emits PASS/REJECT verdict matching the
+ * Python predecessor's compute_budget contract.
+ *
+ * Exit codes:
+ *   0 = PASS (within budget OR no overlay)
+ *   1 = REJECT (over budget)
+ *   2 = unexpected error (cannot read upstream file)
+ *
+ * Plan reference: docs/plans/olam-flywheel-cli-namespace/phase-a-tasks.md § A5
  */
+import { readFileSync } from 'node:fs';
+import { computeBudget, tokensFromText } from '@olam/core/src/lib/k10-budget.js';
 export function registerFlywheelK10Measure(parent) {
     parent
         .command('k10-measure')
-        .description('Compute K1 budget ratio from plan + persona output (stub — implemented in task A5)')
-        .action(() => {
-        console.error('olam flywheel k10-measure: not yet implemented (task A5). See docs/plans/olam-flywheel-cli-namespace/phase-a-tasks.md');
-        process.exit(2);
+        .description('Measure K10 token budget for upstream + optional overlay; emit PASS/REJECT verdict')
+        .requiredOption('--upstream <path>', 'path to upstream file (e.g. persona prompt)')
+        .option('--overlay <path>', 'path to overlay file (omit if none — PASS without enforcement)')
+        .option('--json', 'emit verdict as JSON instead of human-readable')
+        .action((opts) => {
+        let upstreamText;
+        try {
+            upstreamText = readFileSync(opts.upstream, 'utf8');
+        }
+        catch (err) {
+            process.stderr.write(`[k10-measure-error] cannot read upstream ${opts.upstream}: ${err instanceof Error ? err.message : 'unknown'}\n`);
+            process.exit(2);
+        }
+        const upstreamTokens = tokensFromText(upstreamText);
+        let overlayTokens = null;
+        if (opts.overlay !== undefined) {
+            try {
+                const overlayText = readFileSync(opts.overlay, 'utf8');
+                overlayTokens = tokensFromText(overlayText);
+            }
+            catch (err) {
+                process.stderr.write(`[k10-measure-error] cannot read overlay ${opts.overlay}: ${err instanceof Error ? err.message : 'unknown'}\n`);
+                process.exit(2);
+            }
+        }
+        const result = computeBudget(upstreamTokens, overlayTokens);
+        if (opts.json) {
+            process.stdout.write(JSON.stringify(result) + '\n');
+        }
+        else {
+            process.stdout.write(`${result.verdict}: ${result.message}\n`);
+            process.stdout.write(`  upstream_tokens: ${result.upstream_tokens}\n`);
+            if (result.overlay_tokens !== null) {
+                process.stdout.write(`  overlay_tokens: ${result.overlay_tokens}\n`);
+            }
+            if (result.merged !== null) {
+                process.stdout.write(`  merged: ${result.merged}\n`);
+            }
+            process.stdout.write(`  remaining: ${result.remaining} of ${5500} cap\n`);
+        }
+        process.exit(result.verdict === 'PASS' ? 0 : 1);
     });
 }
 //# sourceMappingURL=k10-measure.js.map

package/dist/commands/flywheel/k10-measure.js.map

@@ -1 +1 @@
-{"version":3,"file":"k10-measure.js","sourceRoot":"","sources":["../../../src/commands/flywheel/k10-measure.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,UAAU,0BAA0B,CAAC,MAAe;IACxD,MAAM;SACH,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,oFAAoF,CAAC;SACjG,MAAM,CAAC,GAAG,EAAE;QACX,OAAO,CAAC,KAAK,CACX,uHAAuH,CACxH,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"k10-measure.js","sourceRoot":"","sources":["../../../src/commands/flywheel/k10-measure.ts"],"names":[],"mappings":"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"}

package/dist/commands/flywheel/migrate-overlays.d.ts

@@ -0,0 +1,115 @@
+/**
+ * `olam flywheel migrate-overlays` — operator-local overlay-layer migration.
+ *
+ * Scans `~/.claude/{skills,agents}.overrides/` recursively for hardcoded
+ * `~/.claude/scripts/<name>` references matching the SHIM_TARGETS registry;
+ * sed-replaces each match with the corresponding `olam flywheel <subcmd>`
+ * invocation. Each operator runs this once to migrate THEIR layer 3
+ * (per-user overlay files) from the legacy script-path contract to the new
+ * flywheel CLI surface.
+ *
+ * Closes K1 OQ23 (pass-3 resolution): the migration helper that scales
+ * the namespace migration beyond just this operator's overlays. Each
+ * operator with their own `.overrides/` tree runs this command once.
+ *
+ * Replaces:
+ *   `bash ~/.claude/scripts/emit-breadcrumb.sh ...` → `olam flywheel emit-breadcrumb ...`
+ *   `python3 ~/.claude/scripts/sanitize-persona-output.py ...` → `olam flywheel sanitize-persona-output ...`
+ *   `~/.claude/scripts/k5-rubric-helper.py` → `olam flywheel k5-validate`
+ *   etc. (full set per SHIM_TARGETS registry at @olam/core/lib/shim-targets)
+ *
+ * Flags:
+ *   --dry-run             — preview changes without writing
+ *   --target-dir <path>   — override the search root (default: ~/.claude/); for tests
+ *   --json                — emit summary as JSON for tooling
+ *
+ *   --push                — PUSH mode: copy overlays into atlas-toolbox clone
+ *   --target <name>       — required with --push; name of a registered skill source
+ *
+ * Idempotent: re-runs against already-migrated overlays produce no diff.
+ *
+ * Plan reference: docs/plans/olam-flywheel-cli-namespace/phase-c-tasks.md § C7
+ * Phase B: docs/plans/member-overlays-sync/phase-b-tasks.md
+ */
+import type { Command } from 'commander';
+interface MigrateOverlaysOptions {
+    dryRun?: boolean;
+    targetDir?: string;
+    json?: boolean;
+    push?: boolean;
+    target?: string;
+    forceCurrentBranch?: boolean;
+    initMember?: string;
+    /** For tests: inject clone path directly instead of reading from registry. */
+    _testClonePath?: string;
+    /** For tests: inject atlas-user directly instead of reading ~/.claude/.atlas-user. */
+    _testAtlasUser?: string;
+    /** For tests: override OLAM_CLAUDE_DIR for resolveAtlasUser. */
+    _testClaudeDir?: string;
+    /** For tests: inject git URLs by source name. */
+    _testSkillSources?: Array<{
+        id: string;
+        name: string;
+        gitUrl: string;
+        branch: string;
+        addedAt: number;
+    }>;
+}
+interface FileMigrationResult {
+    path: string;
+    replacements: Array<{
+        basename: string;
+        count: number;
+        replacedBy: string;
+    }>;
+    totalReplacements: number;
+}
+interface MigrationSummary {
+    scanned: number;
+    modified: number;
+    unchanged: number;
+    totalReplacements: number;
+    perFile: FileMigrationResult[];
+}
+export interface PushSummary {
+    filesCopied: number;
+    filesUnchanged: number;
+    filesCreated: number;
+    branchName: string;
+    nextStepGhCommand: string;
+    /** Full copy-paste block for stdout in human mode; populated only on real (non-dry-run) run. */
+    _copyPasteBlock?: string;
+}
+export interface InitMemberSummary {
+    memberName: string;
+    branchName: string;
+    nextStepGhCommand: string;
+    /** Paths created or would-create in dry-run. */
+    createdPaths: string[];
+    /** Full copy-paste block for stdout in human mode; absent in dry-run. */
+    _copyPasteBlock?: string;
+}
+/**
+ * Error thrown by push-mode operations. Carries an exit code so callers
+ * can distinguish between different failure scenarios.
+ */
+export declare class PushError extends Error {
+    readonly exitCode: number;
+    constructor(exitCode: number, message: string);
+}
+/**
+ * Core push-overlays implementation (Phase B).
+ * Returns PushSummary. Throws PushError on validation/pre-flight failures
+ * (lets callers handle process.exit vs test assertions cleanly).
+ */
+export declare function pushOverlays(opts: MigrateOverlaysOptions): PushSummary;
+/**
+ * Scaffold members/<name>/{skills,agents}.overrides/.gitkeep + README.md
+ * in the atlas-toolbox clone. Leaves the working tree dirty.
+ * Throws PushError on validation / pre-flight / idempotency failures.
+ */
+export declare function initMember(opts: MigrateOverlaysOptions): InitMemberSummary;
+export declare function migrateOverlays(opts?: MigrateOverlaysOptions): MigrationSummary;
+export declare function registerFlywheelMigrateOverlays(parent: Command): void;
+export {};
+//# sourceMappingURL=migrate-overlays.d.ts.map

package/dist/commands/flywheel/migrate-overlays.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-overlays.d.ts","sourceRoot":"","sources":["../../../src/commands/flywheel/migrate-overlays.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAcH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWzC,UAAU,sBAAsB;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sFAAsF;IACtF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,iBAAiB,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1G;AAED,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7E,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,UAAU,gBAAgB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,mBAAmB,EAAE,CAAC;CAChC;AAGD,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gGAAgG;IAChG,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAGD,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gDAAgD;IAChD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAsED;;;GAGG;AACH,qBAAa,SAAU,SAAQ,KAAK;aAEhB,QAAQ,EAAE,MAAM;gBAAhB,QAAQ,EAAE,MAAM,EAChC,OAAO,EAAE,MAAM;CAKlB;AA6MD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,sBAAsB,GAAG,WAAW,CAqLtE;AAMD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,sBAAsB,GAAG,iBAAiB,CAuK1E;AAMD,wBAAgB,eAAe,CAAC,IAAI,GAAE,sBAA2B,GAAG,gBAAgB,CA4CnF;AAMD,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAwHrE"}