@pleri/olam-cli 0.1.159 → 0.1.160

package/dist/agent-stream/agent-sdk-to-chunks.js

@@ -213,6 +213,7 @@ function blockToChunkDraft(block, ctx) {
             seq: ctx.seq,
             role: 'assistant',
             kind: 'text',
+            chunk_type: 'text',
             chunk: text,
             created_at: ctx.createdAt,
         };
@@ -226,6 +227,7 @@ function blockToChunkDraft(block, ctx) {
             seq: ctx.seq,
             role: 'tool',
             kind: 'tool-call',
+            chunk_type: 'tool_use',
             chunk: JSON.stringify({
                 tool_use_id: tool.id,
                 name: tool.name,
@@ -244,6 +246,7 @@ function blockToChunkDraft(block, ctx) {
         seq: ctx.seq,
         role: 'assistant',
         kind: 'text',
+        chunk_type: 'text',
         chunk: JSON.stringify(block),
         created_at: ctx.createdAt,
     };

package/dist/agent-stream/driver-runner.js

@@ -83,6 +83,10 @@ export const DEFAULT_SYSTEM_PROMPT_APPEND = `You are the driver agent inside an
  */
 export function buildSdkOptions(input) {
     const driverToolsEnabled = process.env.AGENT_DRIVER_TOOLS_ENABLED === '1';
+    const baseAllowedTools = [];
+    const allowedTools = input.extraAllowedTools
+        ? [...baseAllowedTools, ...input.extraAllowedTools]
+        : baseAllowedTools;
     return {
         systemPrompt: {
             type: 'preset',
@@ -90,7 +94,7 @@ export function buildSdkOptions(input) {
             ...(input.systemPromptAppend ? { append: input.systemPromptAppend } : {}),
         },
         // Empty allowlist = strict coordinator (no tools); undefined = full preset tools.
-        ...(driverToolsEnabled ? {} : { allowedTools: [] }),
+        ...(driverToolsEnabled ? {} : { allowedTools }),
         effort: 'low',
         thinking: { type: 'disabled' },
         model: 'claude-sonnet-4-6',
@@ -110,7 +114,7 @@ export function buildSdkOptions(input) {
  *  - The `prompt` is passed through unchanged.
  */
 export function createSdkQuery(query) {
-    return ({ prompt, abortSignal, systemPromptAppend }) => {
+    return ({ prompt, abortSignal, systemPromptAppend, extraAllowedTools }) => {
         // eslint-disable-next-line no-console
         console.error(`[driver] sdkQuery fired (prompt: ${typeof prompt === 'string' ? `${prompt.length} chars` : 'AsyncIterable<SdkUserMessage>'})`);
         // Forward the runDriver-owned abortSignal to a fresh AbortController
@@ -126,7 +130,7 @@ export function createSdkQuery(query) {
                 });
         }
         const options = {
-            ...buildSdkOptions({ systemPromptAppend }),
+            ...buildSdkOptions({ systemPromptAppend, extraAllowedTools }),
             abortController: sdkAbortController,
         };
         return query({ prompt, options });
@@ -139,7 +143,7 @@ export function createSdkQuery(query) {
  * (SIGTERM via the supervisor → the abortSignal here).
  */
 export function runDriver(opts) {
-    const { hostCpUrl, bearer, worldId, sessionId, systemPromptAppend = DEFAULT_SYSTEM_PROMPT_APPEND, sdkQuery, abortSignal: externalSignal, subscribeImpl = subscribeToChunks, postChunkImpl = (url, b) => makeHostCpChunkPoster({ sidecarUrl: url, bearer: b }), } = opts;
+    const { hostCpUrl, bearer, worldId, sessionId, systemPromptAppend = DEFAULT_SYSTEM_PROMPT_APPEND, extraAllowedTools, sdkQuery, abortSignal: externalSignal, subscribeImpl = subscribeToChunks, postChunkImpl = (url, b) => makeHostCpChunkPoster({ sidecarUrl: url, bearer: b }), } = opts;
     const controller = new AbortController();
     if (externalSignal) {
         if (externalSignal.aborted)
@@ -241,6 +245,7 @@ export function runDriver(opts) {
                 prompt: userMessageStream(),
                 abortSignal: signal,
                 systemPromptAppend,
+                extraAllowedTools,
             });
             await streamMultiTurnSdkToChunks({
                 messages,

package/dist/agent-stream/host-driver-launch.js

@@ -0,0 +1,48 @@
+/**
+ * host-driver-launch.ts — Phase J J4 thin host-side launcher for the
+ * planning-driver.
+ *
+ * HOST_DRIVER_CONTRACT: this module ONLY overrides the launch path —
+ * every agent logic decision delegates to `runDriver()` in
+ * driver-runner.ts. Adding a new options field or behavioural branch
+ * here is a code-smell; extend `DriverRunnerOptions` instead so the
+ * world-side path inherits.
+ *
+ * Why a separate launcher: `runDriver`'s `main()` entry reads
+ * `WORLD_ID` / `SESSION_ID` / `HOST_CP_URL` / `HOST_CP_BEARER` from
+ * env and `await import('@anthropic-ai/claude-agent-sdk')`. That shape
+ * suits the supervisor-fork-into-devbox path; on the host process
+ * we already have those values in JS scope (no env injection across
+ * a container boundary), so we bypass `main()` and call `runDriver()`
+ * directly with the planning-agent system-prompt-append default.
+ */
+import { PLANNING_SYSTEM_PROMPT } from '../prompts/planning-agent.js';
+import { runDriver, } from './driver-runner.js';
+/**
+ * Launch a planning-driver in the host process. Delegates everything
+ * substantive to `runDriver`; this function only translates the
+ * host-side options shape into `DriverRunnerOptions` (defaulting
+ * `systemPromptAppend` to the planning prompt) and bypasses `main()`'s
+ * env-var fork.
+ */
+/**
+ * Phase I I0 — planning-side widened tool allowlist.
+ * The in-world supervisor path never sets extraAllowedTools (stays `[]` per
+ * Decision D10). The planning-side driver defaults to including mcp__linear__*
+ * so operators with a local Linear MCP server can ingest tickets without
+ * configuring anything extra beyond the standard Linear MCP setup.
+ */
+export const PLANNING_DRIVER_EXTRA_ALLOWED_TOOLS = ['mcp__linear__*'];
+export function launchHostDriver(opts) {
+    return runDriver({
+        worldId: opts.worldId,
+        sessionId: opts.sessionId,
+        hostCpUrl: opts.hostCpUrl,
+        bearer: opts.bearer,
+        sdkQuery: opts.sdkQuery,
+        systemPromptAppend: opts.systemPromptAppend ?? PLANNING_SYSTEM_PROMPT,
+        extraAllowedTools: opts.extraAllowedTools ?? PLANNING_DRIVER_EXTRA_ALLOWED_TOOLS,
+        abortSignal: opts.abortSignal,
+    });
+}
+//# sourceMappingURL=host-driver-launch.js.map

package/dist/commands/flywheel/check-persona-skeleton.d.ts

@@ -1,7 +1,35 @@
 /**
- * `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 type { Command } from 'commander';
+interface CheckResult {
+    passed: boolean;
+    failures: string[];
+    tokens: number;
+    mergedSkipped: boolean;
+}
+export declare function checkFile(filepath: string): CheckResult;
 export declare function registerFlywheelCheckPersonaSkeleton(parent: Command): void;
+export {};
 //# sourceMappingURL=check-persona-skeleton.d.ts.map

package/dist/commands/flywheel/check-persona-skeleton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"check-persona-skeleton.d.ts","sourceRoot":"","sources":["../../../src/commands/flywheel/check-persona-skeleton.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,wBAAgB,oCAAoC,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAU1E"}
+{"version":3,"file":"check-persona-skeleton.d.ts","sourceRoot":"","sources":["../../../src/commands/flywheel/check-persona-skeleton.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuDzC,UAAU,WAAW;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAoDvD;AAED,wBAAgB,oCAAoC,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CA4B1E"}

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