@pleri/olam-cli 0.1.158 → 0.1.160

package/dist/commands/flywheel/check-persona-skeleton.js

@@ -1,14 +1,151 @@
 /**
- * `olam flywheel check-persona-skeleton` — stub registered in task A1.
- * Implementation lands in task A7 (port from `shared/engineering/scripts/check-persona-skeleton.py`).
+ * `olam flywheel check-persona-skeleton` — D12 skeleton conformance checker.
+ *
+ * Port of `shared/engineering/scripts/check-persona-skeleton.py`. Validates
+ * persona-file conformance:
+ *   1. Frontmatter has `name`, `description`, `allowed-tools`.
+ *   2-5. Body has `## Role`, `## Cognitive patterns`, `## Scoring rubric`,
+ *      `## Output format`.
+ *   6. `## Cognitive patterns` has ≥5 named patterns (### headings or bullets).
+ *   7. Token count (chars/4 approx) ≤ K10 cap (6000).
+ *
+ * Note on merged-result measurement: the Python predecessor imports
+ * apply-overlays.py's `merge_markdown` to measure overlay+upstream merged
+ * results. This TypeScript port currently measures STANDALONE only — overlay
+ * files needing merged-result measurement emit a warning + are checked
+ * against their standalone content. The merge-aware measurement lands when
+ * Phase A step 9 (apply-overlays port) ships; see follow-up task A7-merge.
+ *
+ * CLI:
+ *   olam flywheel check-persona-skeleton <file> [<file> ...]
+ *   Exit 0 = all PASS; Exit 1 = any FAIL.
+ *
+ * Plan reference: docs/plans/olam-flywheel-cli-namespace/phase-a-tasks.md § A7
  */
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { basename, join } from 'node:path';
+import { parse as parseYAML } from 'yaml';
+const CHARS_PER_TOKEN = 4;
+const K10_TOKEN_CAP = 6000;
+const AGENTS_DIR = join(homedir(), '.claude', 'agents');
+const REQUIRED_FRONTMATTER_KEYS = ['name', 'description', 'allowed-tools'];
+const REQUIRED_SECTIONS = [
+    '## Role',
+    '## Cognitive patterns',
+    '## Scoring rubric',
+    '## Output format',
+];
+function parseFile(text) {
+    const cleaned = text.replace(/^/, '');
+    if (!cleaned.startsWith('---'))
+        return { fm: {}, body: cleaned };
+    const closeIdx = cleaned.indexOf('\n---', 3);
+    if (closeIdx === -1)
+        return { fm: {}, body: cleaned };
+    const fmRaw = cleaned.slice(4, closeIdx);
+    const body = cleaned.slice(closeIdx + 4).replace(/^\n/, '');
+    try {
+        const fm = parseYAML(fmRaw) ?? {};
+        return { fm, body };
+    }
+    catch {
+        return { fm: {}, body };
+    }
+}
+function countH2(body, heading) {
+    const escaped = heading.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const pattern = new RegExp(`^${escaped}\\s*$`, 'gm');
+    return (body.match(pattern) ?? []).length;
+}
+function sectionBody(body, heading) {
+    const escaped = heading.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const pattern = new RegExp(`^${escaped}\\s*\\n([\\s\\S]*?)(?=^## |$(?![\\r\\n]))`, 'm');
+    const match = body.match(pattern);
+    return match?.[1] ?? '';
+}
+function countNamedPatterns(sectionText) {
+    const h3Count = (sectionText.match(/^###\s+\S/gm) ?? []).length;
+    if (h3Count >= 5)
+        return h3Count;
+    const bulletCount = (sectionText.match(/^\s*[-*]\s+\S/gm) ?? []).length;
+    return Math.max(h3Count, bulletCount);
+}
+export function checkFile(filepath) {
+    if (!existsSync(filepath) || !statSync(filepath).isFile()) {
+        return { passed: false, failures: [`file not found: ${filepath}`], tokens: 0, mergedSkipped: false };
+    }
+    const text = readFileSync(filepath, 'utf8');
+    const { fm, body } = parseFile(text);
+    const failures = [];
+    // 1. Frontmatter required keys.
+    for (const key of REQUIRED_FRONTMATTER_KEYS) {
+        const val = fm[key];
+        if (val === undefined || val === null || val === '') {
+            failures.push(`frontmatter missing \`${key}:\``);
+        }
+    }
+    // Determine whether to attempt merged measurement.
+    const isNewAgent = fm['overlay-intent'] === 'new-agent';
+    const agentName = typeof fm.name === 'string' ? fm.name : '';
+    let mergedSkipped = false;
+    if (!isNewAgent && agentName !== '') {
+        const upstreamPath = join(AGENTS_DIR, `${agentName}.md`);
+        if (existsSync(upstreamPath)) {
+            // Merged-result measurement requires A9 apply-overlays port.
+            // For now: warn + fall back to standalone measurement.
+            mergedSkipped = true;
+        }
+    }
+    // 2-5. Required sections.
+    for (const heading of REQUIRED_SECTIONS) {
+        if (countH2(body, heading) === 0) {
+            failures.push(`missing section: '${heading}'`);
+        }
+    }
+    // 6. ≥5 named patterns.
+    const cogBody = sectionBody(body, '## Cognitive patterns');
+    if (cogBody !== '') {
+        const patternCount = countNamedPatterns(cogBody);
+        if (patternCount < 5) {
+            failures.push(`'## Cognitive patterns' has ${patternCount} named pattern(s); need >= 5`);
+        }
+    }
+    // 7. Token cap.
+    const tokens = Math.floor(text.length / CHARS_PER_TOKEN);
+    if (tokens > K10_TOKEN_CAP) {
+        failures.push(`K10 cap exceeded: ${tokens} > ${K10_TOKEN_CAP} tokens`);
+    }
+    return { passed: failures.length === 0, failures, tokens, mergedSkipped };
+}
 export function registerFlywheelCheckPersonaSkeleton(parent) {
     parent
         .command('check-persona-skeleton')
-        .description('Validate persona agent file structure (stub — implemented in task A7)')
-        .action(() => {
-        console.error('olam flywheel check-persona-skeleton: not yet implemented (task A7). See docs/plans/olam-flywheel-cli-namespace/phase-a-tasks.md');
-        process.exit(2);
+        .description('Validate D12 skeleton conformance of persona files (frontmatter + required sections + cognitive patterns + K10 cap)')
+        .argument('<file...>', 'one or more persona files to check')
+        .action((files) => {
+        let passCount = 0;
+        let failCount = 0;
+        for (const filepath of files) {
+            const result = checkFile(filepath);
+            const label = basename(filepath);
+            if (result.passed) {
+                process.stdout.write(`PASS: ${label} -- D12 skeleton valid; tokens=${result.tokens}/${K10_TOKEN_CAP}`);
+                if (result.mergedSkipped) {
+                    process.stdout.write(' (merged measurement deferred to A9 apply-overlays port)');
+                }
+                process.stdout.write('\n');
+                passCount += 1;
+            }
+            else {
+                for (const detail of result.failures) {
+                    process.stdout.write(`FAIL: ${label} -- ${detail}\n`);
+                }
+                failCount += 1;
+            }
+        }
+        process.stdout.write(`\nResults: ${passCount} passed, ${failCount} failed\n`);
+        process.exit(failCount > 0 ? 1 : 0);
     });
 }
 //# sourceMappingURL=check-persona-skeleton.js.map

package/dist/commands/flywheel/check-persona-skeleton.js.map

@@ -1 +1 @@
-{"version":3,"file":"check-persona-skeleton.js","sourceRoot":"","sources":["../../../src/commands/flywheel/check-persona-skeleton.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,UAAU,oCAAoC,CAAC,MAAe;IAClE,MAAM;SACH,OAAO,CAAC,wBAAwB,CAAC;SACjC,WAAW,CAAC,uEAAuE,CAAC;SACpF,MAAM,CAAC,GAAG,EAAE;QACX,OAAO,CAAC,KAAK,CACX,kIAAkI,CACnI,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"check-persona-skeleton.js","sourceRoot":"","sources":["../../../src/commands/flywheel/check-persona-skeleton.ts"],"names":[],"mappings":"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"}

package/dist/commands/flywheel/diversity-check.d.ts

@@ -1,6 +1,16 @@
 /**
- * `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 type { Command } from 'commander';
 export declare function registerFlywheelDiversityCheck(parent: Command): void;

package/dist/commands/flywheel/diversity-check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diversity-check.d.ts","sourceRoot":"","sources":["../../../src/commands/flywheel/diversity-check.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAUpE"}
+{"version":3,"file":"diversity-check.d.ts","sourceRoot":"","sources":["../../../src/commands/flywheel/diversity-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAazC,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAkDpE"}

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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"}