@pleri/olam-cli 0.1.153 → 0.1.158

package/dist/commands/flywheel/emit-breadcrumb.js

@@ -0,0 +1,137 @@
+/**
+ * `olam flywheel emit-breadcrumb` — K7 breadcrumb emitter (D24/D27/D28 compliant).
+ *
+ * Port of `shared/engineering/scripts/emit-breadcrumb.py`. Matches the same record
+ * schema, exit codes, and stdout message format. Adds `fcntl.flock`-equivalent
+ * cross-process locking via `withFileLock` from `@olam/core/lib/file-lock` —
+ * closes K1 adversarial finding #1 (the parallel K7 write corruption scenario
+ * where two concurrent personas writing >4KB payloads interleave bytes).
+ *
+ * Lock semantics: per-target-directory advisory lock. Lock file is
+ * `<breadcrumb-dir>/.flywheel-emit.lock` (distinct filename from skill-sync's
+ * `.olam-sync.lock` so the two domains don't collide if their lock-dirs ever
+ * overlap).
+ *
+ * Plan reference: docs/plans/olam-flywheel-cli-namespace/phase-a-tasks.md § A3
+ * Closes: K1 pass-1 adversarial finding FS-1 (P1/likely/risk-3.0).
+ */
+import { mkdirSync, appendFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { withFileLock } from '@olam/core/src/lib/file-lock.js';
+const VALID_SEVERITIES = new Set(['critical', 'high', 'medium', 'low', 'info', 'warn']);
+const PROMPT_FEEDING_FIELDS = ['extracted_pattern', 'severity', 'affected_persona', 'proposed_edit'];
+const BREADCRUMBS_BASE = join(homedir(), '.local', 'share', 'claude', 'breadcrumbs');
+const LOCK_FILENAME = '.flywheel-emit.lock';
+function buildRecord(opts) {
+    const rec = {
+        breadcrumb_id: randomUUID().replace(/-/g, ''),
+        emitted_at: new Date().toISOString(),
+        emitted_by_skill: opts.skill,
+        pass_number: opts.pass !== undefined ? Number.parseInt(opts.pass, 10) : 0,
+        plan_slug: opts.plan,
+        project_slug: opts.project ?? 'claude-skills',
+        extracted_pattern: opts.pattern,
+        severity: opts.severity,
+        affected_persona: opts.persona,
+        proposed_edit: opts.edit,
+        notes: opts.notes ?? '',
+        raw_body: opts.rawBody ?? '',
+        attribution: opts.attribution ?? '',
+        schema_version: '1',
+    };
+    // K5 fields: present-only-when-supplied. Use key absence to distinguish "not scored"
+    // from "scored zero" (K4 readers depend on this).
+    if (opts.k5ScoresJson !== undefined) {
+        try {
+            rec.k5_scores = JSON.parse(opts.k5ScoresJson);
+        }
+        catch (err) {
+            process.stderr.write(`[K7-reject] --k5-scores-json is not valid JSON: ${err instanceof Error ? err.message : 'unknown'}\n`);
+            process.exit(2);
+        }
+    }
+    if (opts.k5Boost !== undefined)
+        rec.k5_boost = Number.parseFloat(opts.k5Boost);
+    if (opts.k5Composite !== undefined)
+        rec.k5_composite = Number.parseInt(opts.k5Composite, 10);
+    if (opts.k5ScoredAt !== undefined)
+        rec.k5_scored_at = opts.k5ScoredAt;
+    return rec;
+}
+function validatePromptFeeding(rec) {
+    const missing = [];
+    for (const field of PROMPT_FEEDING_FIELDS) {
+        const val = rec[field];
+        if (val === undefined || val === null || (typeof val === 'string' && val.trim() === '')) {
+            missing.push(field);
+        }
+    }
+    return missing;
+}
+function destPath(projectSlug) {
+    const today = new Date().toISOString().slice(0, 10); // UTC YYYY-MM-DD
+    return join(BREADCRUMBS_BASE, projectSlug, `${today}.jsonl`);
+}
+async function emitBreadcrumb(opts) {
+    if (!VALID_SEVERITIES.has(opts.severity)) {
+        process.stderr.write(`[K7-reject] invalid severity '${opts.severity}'; expected one of: ${Array.from(VALID_SEVERITIES).sort().join(', ')}\n`);
+        process.exit(2);
+    }
+    const rec = buildRecord(opts);
+    const missing = validatePromptFeeding(rec);
+    if (missing.length > 0) {
+        process.stderr.write(`[K7-reject] missing or empty prompt-feeding fields: ${JSON.stringify(missing.sort())}\n`);
+        process.exit(2);
+    }
+    const path = destPath(rec.project_slug);
+    const lockDir = dirname(path);
+    mkdirSync(lockDir, { recursive: true });
+    // withFileLock serializes concurrent emitters writing to the same project/date
+    // file. POSIX O_APPEND is only atomic for payloads ≤PIPE_BUF (~4KB); large
+    // raw_body fields would interleave without this. K1 epic dispatch (11 parallel
+    // personas) is exactly the case the original Python script's comment flagged
+    // as "add fcntl.flock if parallel emitters exist".
+    const line = JSON.stringify(rec) + '\n';
+    await withFileLock(lockDir, () => {
+        appendFileSync(path, line, 'utf8');
+    }, {
+        lockFilename: LOCK_FILENAME,
+        reason: `flywheel emit-breadcrumb skill=${opts.skill} plan=${opts.plan}`,
+        // Tight timeout — breadcrumb writes are <100ms; long backoff is a sign
+        // of pathology, not contention. 5s gives 200 retries at 25ms each.
+        acquireTimeoutMs: 5_000,
+    });
+    process.stdout.write(`[K7-emit] ${path}: ${rec.extracted_pattern} (${rec.severity})\n`);
+}
+export function registerFlywheelEmitBreadcrumb(parent) {
+    parent
+        .command('emit-breadcrumb')
+        .description('Append a K7 breadcrumb JSONL row (parallel-safe via withFileLock)')
+        .requiredOption('--skill <slug>', 'Chain skill slug (e.g. plan-hard)')
+        .requiredOption('--plan <slug>', 'Plan slug (e.g. olam-flywheel-cli-namespace)')
+        .requiredOption('--pattern <name>', 'Pattern name (concise slug-like label)')
+        .requiredOption('--severity <level>', 'Severity: critical | high | medium | low | info | warn')
+        .requiredOption('--persona <slug>', "Affected persona slug or 'chain'")
+        .requiredOption('--edit <text>', 'Structured patch description')
+        .option('--notes <text>', 'Free-form operator notes (display-only)')
+        .option('--pass <int>', 'Pass number (display-only)')
+        .option('--project <slug>', 'Project slug', 'claude-skills')
+        .option('--raw-body <text>', 'Free-form markdown context (display-only)')
+        .option('--attribution <text>', 'Source attribution (display-only)')
+        .option('--k5-scores-json <json>', 'K5 sub-scores as JSON (display-only; omitted if not supplied)')
+        .option('--k5-boost <float>', 'K5 boost multiplier (display-only; omitted if not supplied)')
+        .option('--k5-composite <int>', 'K5 composite score (display-only; omitted if not supplied)')
+        .option('--k5-scored-at <date>', 'ISO date of most recent K5 scoring pass')
+        .action(async (opts) => {
+        try {
+            await emitBreadcrumb(opts);
+        }
+        catch (err) {
+            process.stderr.write(`[K7-error] emit-breadcrumb failed: ${err instanceof Error ? err.message : 'unknown error'}\n`);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=emit-breadcrumb.js.map

package/dist/commands/flywheel/emit-breadcrumb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-breadcrumb.js","sourceRoot":"","sources":["../../../src/commands/flywheel/emit-breadcrumb.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,27 @@
+/**
+ * olam flywheel — chain-runtime helpers.
+ *
+ * Migrates atlas-toolbox's `shared/engineering/scripts/` chain-runtime scripts
+ * (breadcrumb emission, K5/K10 scoring, persona sanitization, skeleton
+ * validation, diversity aggregation, shim installation) into olam under a
+ * nested CLI namespace.
+ *
+ * Follows the existing nested-namespace convention established by
+ * `olam kg`, `olam memory`, `olam mcp`, `olam worldspec`.
+ *
+ * Subcommands:
+ *   emit-breadcrumb           — write K7 breadcrumb (with flock for parallel-safe writes)
+ *   k5-score                  — compute K5 composite + boost from sub-scores
+ *   k5-validate               — schema-check a plan's frontmatter k5_scores block
+ *   k10-measure               — compute K1 budget ratio from plan + persona output
+ *   sanitize-persona-output   — stdin→stdout pipe; reject header-injection / slug-mismatch
+ *   check-persona-skeleton    — validate persona agent file structure
+ *   diversity-check           — cross-plan breadcrumb diversity aggregator
+ *   ping                      — no-op cold-start telemetry surface
+ *   install-shims             — write delegating shims to ~/.claude/scripts/<name>
+ *
+ * Plan reference: docs/plans/olam-flywheel-cli-namespace/README.md
+ */
+import type { Command } from 'commander';
+export declare function registerFlywheel(program: Command): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/commands/flywheel/index.js

@@ -0,0 +1,48 @@
+/**
+ * olam flywheel — chain-runtime helpers.
+ *
+ * Migrates atlas-toolbox's `shared/engineering/scripts/` chain-runtime scripts
+ * (breadcrumb emission, K5/K10 scoring, persona sanitization, skeleton
+ * validation, diversity aggregation, shim installation) into olam under a
+ * nested CLI namespace.
+ *
+ * Follows the existing nested-namespace convention established by
+ * `olam kg`, `olam memory`, `olam mcp`, `olam worldspec`.
+ *
+ * Subcommands:
+ *   emit-breadcrumb           — write K7 breadcrumb (with flock for parallel-safe writes)
+ *   k5-score                  — compute K5 composite + boost from sub-scores
+ *   k5-validate               — schema-check a plan's frontmatter k5_scores block
+ *   k10-measure               — compute K1 budget ratio from plan + persona output
+ *   sanitize-persona-output   — stdin→stdout pipe; reject header-injection / slug-mismatch
+ *   check-persona-skeleton    — validate persona agent file structure
+ *   diversity-check           — cross-plan breadcrumb diversity aggregator
+ *   ping                      — no-op cold-start telemetry surface
+ *   install-shims             — write delegating shims to ~/.claude/scripts/<name>
+ *
+ * Plan reference: docs/plans/olam-flywheel-cli-namespace/README.md
+ */
+import { registerFlywheelEmitBreadcrumb } from './emit-breadcrumb.js';
+import { registerFlywheelK5Score } from './k5-score.js';
+import { registerFlywheelK5Validate } from './k5-validate.js';
+import { registerFlywheelK10Measure } from './k10-measure.js';
+import { registerFlywheelSanitizePersonaOutput } from './sanitize-persona-output.js';
+import { registerFlywheelCheckPersonaSkeleton } from './check-persona-skeleton.js';
+import { registerFlywheelDiversityCheck } from './diversity-check.js';
+import { registerFlywheelPing } from './ping.js';
+import { registerFlywheelInstallShims } from './install-shims.js';
+export function registerFlywheel(program) {
+    const flywheel = program
+        .command('flywheel')
+        .description('Chain-runtime helpers: breadcrumbs, K5/K10 scoring, persona ops, shims (emit-breadcrumb, k5-score, k5-validate, k10-measure, sanitize-persona-output, check-persona-skeleton, diversity-check, ping, install-shims)');
+    registerFlywheelEmitBreadcrumb(flywheel);
+    registerFlywheelK5Score(flywheel);
+    registerFlywheelK5Validate(flywheel);
+    registerFlywheelK10Measure(flywheel);
+    registerFlywheelSanitizePersonaOutput(flywheel);
+    registerFlywheelCheckPersonaSkeleton(flywheel);
+    registerFlywheelDiversityCheck(flywheel);
+    registerFlywheelPing(flywheel);
+    registerFlywheelInstallShims(flywheel);
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,8 @@
+/**
+ * `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`).
+ */
+import type { Command } from 'commander';
+export declare function registerFlywheelInstallShims(parent: Command): void;
+//# sourceMappingURL=install-shims.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,15 @@
+/**
+ * `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`).
+ */
+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);
+    });
+}
+//# sourceMappingURL=install-shims.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,7 @@
+/**
+ * `olam flywheel k10-measure` — stub registered in task A1.
+ * Implementation lands in task A5 (port from `shared/engineering/scripts/k10_budget.py`).
+ */
+import type { Command } from 'commander';
+export declare function registerFlywheelK10Measure(parent: Command): void;
+//# sourceMappingURL=k10-measure.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,14 @@
+/**
+ * `olam flywheel k10-measure` — stub registered in task A1.
+ * Implementation lands in task A5 (port from `shared/engineering/scripts/k10_budget.py`).
+ */
+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);
+    });
+}
+//# sourceMappingURL=k10-measure.js.map

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

@@ -0,0 +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"}

package/dist/commands/flywheel/k5-score.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `olam flywheel k5-score` — compute K5 composite + boost from sub-scores.
+ *
+ * Per `references/k5-rubric-schema.md` from the /10x: planning chain:
+ *   k5_boost = min(2.0, cited_ratio * 4.0)
+ *   k5_composite = min(100, min(k5_scores.values()) * k5_boost)
+ *
+ * Output: JSON object on stdout.
+ *
+ * Plan reference: docs/plans/olam-flywheel-cli-namespace/phase-a-tasks.md § A4
+ */
+import type { Command } from 'commander';
+export declare function registerFlywheelK5Score(parent: Command): void;
+//# sourceMappingURL=k5-score.d.ts.map

package/dist/commands/flywheel/k5-score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"k5-score.d.ts","sourceRoot":"","sources":["../../../src/commands/flywheel/k5-score.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuDzC,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAsB7D"}

package/dist/commands/flywheel/k5-score.js

@@ -0,0 +1,59 @@
+/**
+ * `olam flywheel k5-score` — compute K5 composite + boost from sub-scores.
+ *
+ * Per `references/k5-rubric-schema.md` from the /10x: planning chain:
+ *   k5_boost = min(2.0, cited_ratio * 4.0)
+ *   k5_composite = min(100, min(k5_scores.values()) * k5_boost)
+ *
+ * Output: JSON object on stdout.
+ *
+ * Plan reference: docs/plans/olam-flywheel-cli-namespace/phase-a-tasks.md § A4
+ */
+function parseScore(raw, name) {
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n) || n < 0 || n > 100) {
+        process.stderr.write(`[k5-score-reject] --${name} must be integer 0-100, got: ${JSON.stringify(raw)}\n`);
+        process.exit(2);
+    }
+    return n;
+}
+function parseCitedRatio(raw) {
+    if (raw === undefined)
+        return 0.0;
+    const n = Number.parseFloat(raw);
+    if (!Number.isFinite(n) || n < 0.0 || n > 1.0) {
+        process.stderr.write(`[k5-score-reject] --cited-ratio must be 0.0-1.0, got: ${JSON.stringify(raw)}\n`);
+        process.exit(2);
+    }
+    return n;
+}
+function computeK5(scores, citedRatio) {
+    const boost = Math.min(2.0, citedRatio * 4.0);
+    const minScore = Math.min(scores.direction, scores.approach, scores.open_questions, scores.constraints, scores.reuse);
+    const composite = Math.min(100, Math.round(minScore * boost));
+    return { k5_scores: scores, k5_boost: boost, k5_composite: composite };
+}
+export function registerFlywheelK5Score(parent) {
+    parent
+        .command('k5-score')
+        .description('Compute K5 composite + boost from sub-scores (min-of-5 × boost, capped at 100)')
+        .requiredOption('--direction <0-100>', 'Direction sub-score')
+        .requiredOption('--approach <0-100>', 'Approach sub-score')
+        .requiredOption('--open-questions <0-100>', 'Open questions sub-score')
+        .requiredOption('--constraints <0-100>', 'Constraints sub-score')
+        .requiredOption('--reuse <0-100>', 'Reuse sub-score')
+        .option('--cited-ratio <0.0-1.0>', 'Cited fact ratio (default 0.0 → boost = 0)')
+        .action((opts) => {
+        const scores = {
+            direction: parseScore(opts.direction, 'direction'),
+            approach: parseScore(opts.approach, 'approach'),
+            open_questions: parseScore(opts.openQuestions, 'open-questions'),
+            constraints: parseScore(opts.constraints, 'constraints'),
+            reuse: parseScore(opts.reuse, 'reuse'),
+        };
+        const citedRatio = parseCitedRatio(opts.citedRatio);
+        const result = computeK5(scores, citedRatio);
+        process.stdout.write(JSON.stringify(result) + '\n');
+    });
+}
+//# sourceMappingURL=k5-score.js.map

package/dist/commands/flywheel/k5-score.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"k5-score.js","sourceRoot":"","sources":["../../../src/commands/flywheel/k5-score.ts"],"names":[],"mappings":"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"}

package/dist/commands/flywheel/k5-validate.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `olam flywheel k5-validate` — port of `shared/engineering/scripts/k5-rubric-helper.py`
+ * validate mode. Schema-checks a plan's frontmatter `k5_scores` / `k5_boost` /
+ * `k5_composite` / `k5_scored_at` block.
+ *
+ * Exit codes mirror the Python script:
+ *   0 = valid (or all k5 fields absent — absence is acceptable for legacy plans)
+ *   1 = malformed (one or more present k5 fields fail validation)
+ *   2 = unexpected error (cannot stat / read / oversize file)
+ *
+ * Plan reference: docs/plans/olam-flywheel-cli-namespace/phase-a-tasks.md § A4
+ */
+import type { Command } from 'commander';
+export declare function registerFlywheelK5Validate(parent: Command): void;
+//# sourceMappingURL=k5-validate.d.ts.map

package/dist/commands/flywheel/k5-validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"k5-validate.d.ts","sourceRoot":"","sources":["../../../src/commands/flywheel/k5-validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkKzC,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAoBhE"}

package/dist/commands/flywheel/k5-validate.js

@@ -0,0 +1,185 @@
+/**
+ * `olam flywheel k5-validate` — port of `shared/engineering/scripts/k5-rubric-helper.py`
+ * validate mode. Schema-checks a plan's frontmatter `k5_scores` / `k5_boost` /
+ * `k5_composite` / `k5_scored_at` block.
+ *
+ * Exit codes mirror the Python script:
+ *   0 = valid (or all k5 fields absent — absence is acceptable for legacy plans)
+ *   1 = malformed (one or more present k5 fields fail validation)
+ *   2 = unexpected error (cannot stat / read / oversize file)
+ *
+ * Plan reference: docs/plans/olam-flywheel-cli-namespace/phase-a-tasks.md § A4
+ */
+import { readFileSync, statSync } from 'node:fs';
+import { parse as parseYAML } from 'yaml';
+const K5_DIMS = ['direction', 'approach', 'open_questions', 'constraints', 'reuse'];
+const MAX_PLAN_BYTES = 1_048_576;
+function extractFrontmatter(text) {
+    // BOM strip
+    const cleaned = text.replace(/^/, '');
+    if (!cleaned.startsWith('---'))
+        return null;
+    const closeIdx = cleaned.indexOf('\n---', 3);
+    if (closeIdx === -1)
+        return null;
+    const fmRaw = cleaned.slice(4, closeIdx);
+    try {
+        const parsed = parseYAML(fmRaw);
+        return parsed ?? {};
+    }
+    catch {
+        return null;
+    }
+}
+function validateK5Scores(scores) {
+    if (typeof scores !== 'object' || scores === null) {
+        return `k5_scores must be a mapping with keys ${K5_DIMS.join(', ')}`;
+    }
+    const obj = scores;
+    for (const dim of K5_DIMS) {
+        if (!(dim in obj))
+            return `k5_scores missing key '${dim}' (required: ${K5_DIMS.join(', ')})`;
+        const val = obj[dim];
+        const n = typeof val === 'number' ? val : Number.parseInt(String(val), 10);
+        if (!Number.isFinite(n) || !Number.isInteger(n)) {
+            return `k5_scores.${dim} must be an integer 0-100, got: ${JSON.stringify(val)}`;
+        }
+        if (n < 0 || n > 100) {
+            return `k5_scores.${dim} out of range 0-100: ${n}`;
+        }
+    }
+    return null;
+}
+function validateK5Boost(boost) {
+    const n = typeof boost === 'number' ? boost : Number.parseFloat(String(boost));
+    if (!Number.isFinite(n))
+        return `k5_boost must be a float 0.0-2.0, got: ${JSON.stringify(boost)}`;
+    if (n < 0.0 || n > 2.0)
+        return `k5_boost out of range 0.0-2.0: ${n}`;
+    return null;
+}
+function validateK5Composite(composite) {
+    const n = typeof composite === 'number' ? composite : Number.parseInt(String(composite), 10);
+    if (!Number.isFinite(n) || !Number.isInteger(n)) {
+        return `k5_composite must be an integer 0-100, got: ${JSON.stringify(composite)}`;
+    }
+    if (n < 0 || n > 100)
+        return `k5_composite out of range 0-100: ${n}`;
+    return null;
+}
+function validateK5ScoredAt(scoredAt) {
+    if (typeof scoredAt !== 'string') {
+        return `k5_scored_at must be a string date YYYY-MM-DD, got: ${JSON.stringify(scoredAt)}`;
+    }
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(scoredAt.trim())) {
+        return `k5_scored_at must be ISO date YYYY-MM-DD, got: ${JSON.stringify(scoredAt)}`;
+    }
+    return null;
+}
+function validatePlan(path) {
+    let stat;
+    try {
+        stat = statSync(path);
+    }
+    catch (err) {
+        return { ok: false, message: `FAIL cannot stat ${path}: ${err instanceof Error ? err.message : 'unknown'}` };
+    }
+    if (stat.size > MAX_PLAN_BYTES) {
+        return { ok: false, message: `FAIL ${path}: plan file exceeds 1MB (${stat.size} bytes); refusing to parse` };
+    }
+    let text;
+    try {
+        text = readFileSync(path, 'utf8');
+    }
+    catch (err) {
+        return { ok: false, message: `FAIL cannot read ${path}: ${err instanceof Error ? err.message : 'unknown'}` };
+    }
+    if (!text.replace(/^/, '').startsWith('---')) {
+        return { ok: false, message: `FAIL ${path}: no YAML frontmatter (missing opening --- marker)` };
+    }
+    if (!text.includes('\n---', 3)) {
+        return { ok: false, message: `FAIL ${path}: frontmatter block never closed (missing closing --- marker)` };
+    }
+    const fm = extractFrontmatter(text);
+    if (fm === null) {
+        return { ok: false, message: `FAIL ${path}: frontmatter could not be parsed as YAML` };
+    }
+    const hasScores = 'k5_scores' in fm;
+    const hasBoost = 'k5_boost' in fm;
+    const hasComposite = 'k5_composite' in fm;
+    const hasScoredAt = 'k5_scored_at' in fm;
+    if (!hasScores && !hasBoost && !hasComposite && !hasScoredAt) {
+        return { ok: true, message: `PASS ${path}: k5_scores absent (acceptable — legacy plan)` };
+    }
+    const errors = [];
+    if (hasScores) {
+        const err = validateK5Scores(fm.k5_scores);
+        if (err !== null)
+            errors.push(err);
+    }
+    if (hasBoost) {
+        const err = validateK5Boost(fm.k5_boost);
+        if (err !== null)
+            errors.push(err);
+    }
+    if (hasComposite) {
+        const err = validateK5Composite(fm.k5_composite);
+        if (err !== null)
+            errors.push(err);
+    }
+    if (hasScoredAt) {
+        const err = validateK5ScoredAt(fm.k5_scored_at);
+        if (err !== null)
+            errors.push(err);
+    }
+    if (errors.length > 0) {
+        return { ok: false, message: `FAIL ${path}: ${errors.join('; ')}` };
+    }
+    const lines = [`PASS ${path}: k5_scores valid`];
+    if (hasScores && typeof fm.k5_scores === 'object' && fm.k5_scores !== null) {
+        const scoresObj = fm.k5_scores;
+        const vals = [];
+        for (const dim of K5_DIMS) {
+            const raw = scoresObj[dim];
+            const n = typeof raw === 'number' ? raw : Number.parseInt(String(raw), 10);
+            vals.push(n);
+            lines.push(`  ${dim}: ${n}`);
+        }
+        lines.push(`  min(k5_scores): ${Math.min(...vals)}`);
+    }
+    if (hasBoost) {
+        const n = typeof fm.k5_boost === 'number' ? fm.k5_boost : Number.parseFloat(String(fm.k5_boost));
+        lines.push(`  k5_boost: ${n.toFixed(2)}`);
+    }
+    if (hasComposite)
+        lines.push(`  k5_composite: ${String(fm.k5_composite)}`);
+    if (hasScoredAt)
+        lines.push(`  k5_scored_at: ${String(fm.k5_scored_at)}`);
+    if ('confidence' in fm)
+        lines.push(`  confidence (existing): ${String(fm.confidence)}`);
+    return { ok: true, message: lines.join('\n') };
+}
+export function registerFlywheelK5Validate(parent) {
+    parent
+        .command('k5-validate')
+        .description("Schema-check a plan's frontmatter k5_scores / k5_boost / k5_composite / k5_scored_at")
+        .argument('<plan-path>', 'path to the plan markdown file')
+        .action((planPath) => {
+        try {
+            const result = validatePlan(planPath);
+            if (result.ok) {
+                process.stdout.write(result.message + '\n');
+                process.exit(0);
+            }
+            else {
+                process.stderr.write(result.message + '\n');
+                process.exit(1);
+            }
+        }
+        catch (err) {
+            process.stderr.write(`FAIL ${planPath}: unexpected error: ${err instanceof Error ? err.message : 'unknown'}\n`);
+            process.exit(2);
+        }
+    });
+}
+//# sourceMappingURL=k5-validate.js.map

package/dist/commands/flywheel/k5-validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"k5-validate.js","sourceRoot":"","sources":["../../../src/commands/flywheel/k5-validate.ts"],"names":[],"mappings":"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"}

package/dist/commands/flywheel/ping.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `olam flywheel ping` — no-op subcommand for cold-start telemetry.
+ *
+ * Establishes the measurement baseline OQ12 references: before porting any
+ * subcommand from atlas-toolbox to olam, we need to know what cold-start
+ * overhead the shim → olam binary path adds vs the current bash-invoked
+ * scripts. Operators run `time olam flywheel ping` on a representative
+ * machine + record the result.
+ *
+ * Branch decision (per plan A2):
+ *   ≤200ms total invocation  → full-port for A3+ subcommands (drop hybrid hedge S2)
+ *   200-500ms                → full-port with follow-up perf-investigation tagged
+ *   >500ms                   → escalate to hybrid model (heavy helpers ported;
+ *                              emit-breadcrumb stays as native script delegating)
+ *
+ * Telemetry baseline written to ~/.local/share/olam/flywheel-baseline.json.
+ * Permanent telemetry surface for `olam doctor` (promoted in task A13).
+ */
+import type { Command } from 'commander';
+export declare function registerFlywheelPing(parent: Command): void;
+//# sourceMappingURL=ping.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ping.d.ts","sourceRoot":"","sources":["../../../src/commands/flywheel/ping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwCzC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAqC1D"}