peaks-loop 4.0.0-beta.7 → 4.0.0-beta.8

package/dist/src/cli/commands/share-commands.js

@@ -1,296 +0,0 @@
-import { fail, getErrorMessage, ok } from '../../shared/result.js';
-import { addJsonOption, printResult } from '../cli-helpers.js';
-import { readSharedChannel, writeSharedEntry, SHARED_CHANNEL_SOFT_VALUE_WARN } from '../../services/context/shared-channel.js';
-import { writeLogEntry } from '../../services/log/logger.js';
-import { getCurrentSessionId } from '../../services/skills/skill-presence-service.js';
-import { summarizeBatchResults } from './sub-agent-shared.js';
-export function registerShareCommand(parent, io) {
-    addJsonOption(parent
-        .command('share')
-        .description('G8.4: write a shared entry to the cross sub-agent shared channel. ' +
-        'Dispatcher-mediated indirect signal: sub-agent A writes, dispatcher ' +
-        'stores, sub-agent B (still in flight) reads via `peaks sub-agent ' +
-        'shared-read`. Not peer-to-peer; pseudo-swarm property 3 preserved.')
-        .requiredOption('--batch <batchId>', 'batchId (from `peaks sub-agent dispatch` envelope)')
-        .requiredOption('--key <k>', 'entry key (convention: "<role>.<event>")')
-        .requiredOption('--value <json>', 'JSON object value (≤ 1KB soft warn, ≥ 64KB rejected)')
-        .option('--from <role>', 'sub-agent role string; defaults to dispatch record role if available')
-        .option('--request-id <rid>', 'request id (default: "unknown-rid")')
-        .option('--session-id <sid>', 'session id (default: resolve from .peaks/_runtime/session.json; falls back to PEAKS_SESSION_ID env var; final fallback "unknown-sid")')
-        .option('--project <path>', 'target project root (defaults to cwd)')).action((options) => {
-        const asJson = options.json === true;
-        if (!options.batch || !options.key || !options.value) {
-            printResult(io, fail('sub-agent.share', 'MISSING_ARG', '--batch, --key, and --value are required', { ok: false }, [
-                'Re-run with --batch <batchId> --key <key> --value <jsonObject>.'
-            ]), asJson);
-            process.exitCode = 1;
-            return;
-        }
-        let parsedValue;
-        try {
-            const parsed = JSON.parse(options.value);
-            if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
-                throw new Error('value must be a JSON object');
-            }
-            parsedValue = parsed;
-        }
-        catch (err) {
-            printResult(io, fail('sub-agent.share', 'INVALID_VALUE', `value must be a JSON object: ${getErrorMessage(err)}`, { ok: false }, [
-                'Pass --value as a JSON object literal, e.g. --value \'{"reason":"x"}\'.'
-            ]), asJson);
-            process.exitCode = 1;
-            return;
-        }
-        try {
-            const projectRoot = options.project ?? process.cwd();
-            // Slice 2026-06-26-unknown-sid-fallback-fix: see dispatch-commands.ts.
-            const sid = options.sessionId
-                ?? process.env.PEAKS_SESSION_ID
-                ?? getCurrentSessionId(projectRoot)
-                ?? 'unknown-sid';
-            const rid = options.requestId ?? 'unknown-rid';
-            const from = options.from ?? 'unknown-role';
-            const result = writeSharedEntry({
-                projectRoot,
-                sid,
-                rid,
-                batchId: options.batch,
-                key: options.key,
-                from,
-                value: parsedValue
-            });
-            if (!result.ok) {
-                const code = result.code;
-                printResult(io, fail('sub-agent.share', code, result.message, { ok: false, batchId: options.batch }, [
-                    code === 'VALUE_TOO_LARGE'
-                        ? 'Reduce value size; 1KB is a soft warning, 64KB is a hard reject.'
-                        : 'See error message; check --batch, --key, --value arguments.'
-                ]), asJson);
-                process.exitCode = 1;
-                return;
-            }
-            const warnings = [];
-            if (result.lastWriteWins) {
-                warnings.push('LAST_WRITE_WINS');
-            }
-            if (result.softWarning) {
-                warnings.push(`VALUE_SIZE_SOFT_WARN: ${result.entry.valueSize} > ${SHARED_CHANNEL_SOFT_VALUE_WARN} bytes`);
-            }
-            printResult(io, ok('sub-agent.share', {
-                // Slice 2026-06-23-audit-4th #E1: envelopeVersion marker
-                envelopeVersion: '2.1.0',
-                ok: true,
-                batchId: options.batch,
-                entryKey: options.key,
-                writtenAt: result.entry.at,
-                channelSize: result.channelSize,
-                lastWriteWins: result.lastWriteWins,
-                valueSize: result.entry.valueSize
-            }, warnings, [
-                'Sub-agents in the same batch can read this entry via `peaks sub-agent shared-read --batch ' + options.batch + '`.'
-            ]), asJson);
-            // Slice 2026-06-23-audit-4th #B1: structured log on success.
-            try {
-                writeLogEntry({
-                    ts: new Date().toISOString(),
-                    level: 'info',
-                    command: 'sub-agent.share',
-                    msg: 'shared',
-                    sessionId: sid,
-                    batchId: options.batch,
-                    data: {
-                        batchId: options.batch,
-                        key: options.key,
-                        valueSize: result.entry.valueSize,
-                        lastWriteWins: result.lastWriteWins
-                    }
-                });
-            }
-            catch { // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
-                /* best-effort */
-            }
-        }
-        catch (error) {
-            const code = error.code ?? 'SHARE_ERROR';
-            printResult(io, fail('sub-agent.share', code, getErrorMessage(error), { ok: false, batchId: options.batch }, [
-                shareErrorNextActions(code)
-            ]), asJson);
-            process.exitCode = 1;
-        }
-    });
-}
-/**
- * Slice 2026-06-23-audit-3rd #9: branch on `error.code` so the LLM-side
- * runner gets an actionable hint instead of a generic "see error
- * message" fallback. Each branch names the most likely next step.
- */
-function shareErrorNextActions(code) {
-    if (code === 'LOCK_TIMEOUT') {
-        return 'A concurrent `peaks sub-agent share` is holding the channel lock for >5s; retry, or check for a crashed holder (the .lock file is reaped after 30s).';
-    }
-    if (code === 'RECORD_NOT_FOUND' || code === 'INVALID_RECORD_PATH') {
-        return 'The dispatch record path is missing or outside .peaks/_sub_agents/. Re-run `peaks sub-agent dispatch <role>` to get a fresh record path, then use that here.';
-    }
-    return 'See error message; check that --batch matches the dispatch envelope and the value is a JSON object ≤ 64KB.';
-}
-export function registerSharedReadCommand(parent, io) {
-    addJsonOption(parent
-        .command('shared-read')
-        .description('G8.4: read entries from the cross sub-agent shared channel. ' +
-        'Returns sibling sub-agent status. Supports --since (ISO8601) ' +
-        'and --key (glob pattern with * wildcard).')
-        .requiredOption('--batch <batchId>', 'batchId (from `peaks sub-agent dispatch` envelope)')
-        .option('--since <iso>', 'only return entries written after this ISO8601 timestamp')
-        .option('--key <pattern>', 'glob pattern, e.g. "rd.*" or "*.completed"')
-        .option('--request-id <rid>', 'request id (default: "unknown-rid")')
-        .option('--session-id <sid>', 'session id (default: resolve from .peaks/_runtime/session.json; falls back to PEAKS_SESSION_ID env var; final fallback "unknown-sid")')
-        .option('--project <path>', 'target project root (defaults to cwd)')).action((options) => {
-        const asJson = options.json === true;
-        if (!options.batch) {
-            printResult(io, fail('sub-agent.shared-read', 'MISSING_BATCH', '--batch is required', { ok: false }, [
-                'Re-run with --batch <batchId>.'
-            ]), asJson);
-            process.exitCode = 1;
-            return;
-        }
-        try {
-            const projectRoot = options.project ?? process.cwd();
-            // Slice 2026-06-26-unknown-sid-fallback-fix: see dispatch-commands.ts.
-            const sid = options.sessionId
-                ?? process.env.PEAKS_SESSION_ID
-                ?? getCurrentSessionId(projectRoot)
-                ?? 'unknown-sid';
-            const rid = options.requestId ?? 'unknown-rid';
-            const channel = readSharedChannel({
-                projectRoot,
-                sid,
-                rid,
-                batchId: options.batch,
-                ...(options.since !== undefined ? { since: options.since } : {}),
-                ...(options.key !== undefined ? { keyPattern: options.key } : {})
-            });
-            printResult(io, ok('sub-agent.shared-read', {
-                // Slice 2026-06-23-audit-4th #E1: envelopeVersion marker
-                envelopeVersion: '2.1.0',
-                ok: true,
-                batchId: options.batch,
-                entries: channel.entries,
-                totalEntries: Object.keys(channel.entries).length,
-                channelSize: JSON.stringify(channel).length,
-                updatedAt: channel.updatedAt
-            }, [], [
-                'Shared channel is dispatcher-mediated; do not attempt to read sibling dispatch records directly.'
-            ]), asJson);
-        }
-        catch (error) {
-            const code = error.code ?? 'SHARED_READ_ERROR';
-            printResult(io, fail('sub-agent.shared-read', code, getErrorMessage(error), { ok: false, batchId: options.batch }, [
-                sharedReadErrorNextActions(code)
-            ]), asJson);
-            process.exitCode = 1;
-        }
-    });
-}
-function sharedReadErrorNextActions(code) {
-    if (code === 'INVALID_BATCH_ID' || code === 'MISSING_BATCH') {
-        return 'Pass --batch <batchId> exactly as returned by the `peaks sub-agent dispatch` envelope.';
-    }
-    return 'See error message; check that --batch matches the dispatch envelope (typo / wrong batch will return an empty channel, not an error).';
-}
-export function registerAwaitCommand(parent, io) {
-    addJsonOption(parent
-        .command('await')
-        .description('2.7.0 slice-dag-dispatcher MVP: wait for a batch of dispatched sub-agents ' +
-        'to finish (or hit --timeout). Returns one BatchResult per dispatch. ' +
-        'For non-claude-code IDEs, the wait is delegated to the LLM (slice 1.3 will ' +
-        'land real per-IDE joins).')
-        .requiredOption('--batch <batchId>', 'batchId from a dispatch envelope')
-        .option('--timeout <ms>', 'optional cap on how long the join waits (ms; default 60000, max 120000)')
-        .option('--project <path>', 'target project root (defaults to cwd)')
-        .option('--session-id <sid>', 'override active session id (default: resolve from .peaks/_runtime/session.json; falls back to PEAKS_SESSION_ID env var; final fallback "unknown-sid")')).action(async (options) => {
-        const asJson = options.json === true;
-        if (!options.batch) {
-            printResult(io, fail('sub-agent.await', 'MISSING_BATCH', '--batch is required', { ok: false }, [
-                'Re-run with --batch <batchId> from a dispatch envelope.'
-            ]), asJson);
-            process.exitCode = 1;
-            return;
-        }
-        let timeoutMs;
-        if (typeof options.timeout === 'string' && options.timeout.length > 0) {
-            const n = Number.parseInt(options.timeout, 10);
-            if (!Number.isInteger(n) || n <= 0) {
-                printResult(io, fail('sub-agent.await', 'INVALID_TIMEOUT', `--timeout must be a positive integer ms (got ${options.timeout})`, { ok: false }, [
-                    'Pass an integer like --timeout 60000.'
-                ]), asJson);
-                process.exitCode = 1;
-                return;
-            }
-            timeoutMs = n;
-        }
-        const projectRoot = options.project ?? process.cwd();
-        // Slice 2026-06-26-unknown-sid-fallback-fix: see dispatch-commands.ts.
-        const sid = options.sessionId
-            ?? process.env.PEAKS_SESSION_ID
-            ?? getCurrentSessionId(projectRoot)
-            ?? 'unknown-sid';
-        // Lazy-import IDE modules so `peaks sub-agent share` and
-        // `peaks sub-agent shared-read` (the high-frequency G8.4 path) do not
-        // pay for adapter resolution at module-load time. Slice
-        // 2026-06-23-audit-p0-cleanup.
-        const { detectInstalledIde } = await import('../../services/ide/ide-detector.js');
-        const { getAdapter } = await import('../../services/ide/ide-registry.js');
-        const ide = detectInstalledIde(projectRoot) ?? 'claude-code';
-        const adapter = getAdapter(ide);
-        const dispatcher = adapter.subAgentDispatcher;
-        if (typeof dispatcher.awaitBatch !== 'function') {
-            printResult(io, fail('sub-agent.await', 'IDE_NOT_SUPPORTED', `IDE ${ide} does not support awaitBatch (1.2 MVP only ships claude-code)`, { ok: false }, [
-                'Switch to claude-code, or rely on LLM-side await for non-claude-code IDEs in slice 1.3.'
-            ]), asJson);
-            process.exitCode = 1;
-            return;
-        }
-        // 1.2 MVP: we don't keep a separate record path index for DAG-dispatched
-        // batches yet; the caller is expected to have a single shared record
-        // directory. We pass the empty list — the MVP runner tracks outcomes
-        // through its own contract-store writes; the dispatcher just signals
-        // "ready to await" through the awaitBatch LRU queue (slice 1.3
-        // upgrades to cross-process heartbeat polling).
-        const input = {
-            batchId: options.batch,
-            dispatchCount: 1,
-            recordPaths: [],
-            ...(timeoutMs !== undefined ? { timeoutMs } : {})
-        };
-        try {
-            const results = await dispatcher.awaitBatch(input);
-            const summary = summarizeBatchResults(results);
-            printResult(io, ok('sub-agent.await', {
-                // Slice 2026-06-23-audit-4th #E1: envelopeVersion marker
-                envelopeVersion: '2.1.0',
-                batchId: options.batch,
-                ide: dispatcher.label,
-                results,
-                summary
-            }, [], [
-                'For trae / trae-cn / codex / cursor, results will report status=timeout with note=`awaitByLlm: <ide> 1.2 fallback`. The calling LLM holds the real await.'
-            ]), asJson);
-        }
-        catch (error) {
-            const code = error.code ?? 'AWAIT_ERROR';
-            printResult(io, fail('sub-agent.await', code, getErrorMessage(error), { ok: false }, [
-                awaitErrorNextActions(code)
-            ]), asJson);
-            process.exitCode = 1;
-        }
-    });
-}
-function awaitErrorNextActions(code) {
-    if (code === 'INVALID_TIMEOUT') {
-        return 'Pass --timeout as a positive integer ms (e.g. --timeout 60000). 0 and non-numeric values are rejected.';
-    }
-    if (code === 'IDE_NOT_SUPPORTED') {
-        return 'Switch to claude-code, or rely on LLM-side await for non-claude-code IDEs in slice 1.3.';
-    }
-    return 'See error message; check that --batch matches the dispatch envelope and --timeout is a positive integer ms.';
-}

package/dist/src/cli/commands/skill-conformance-commands.d.ts

@@ -1,9 +0,0 @@
-/**
- * peaks skills audit-conformance CLI (Slice #12) — runs the
- * skill-conformance-service against all 12 peaks-* SKILL.md files and
- * reports the 5 standard checks (frontmatter, CLI-back, loadStrategy,
- * 800-line cap, outputStyle).
- */
-import { Command } from 'commander';
-import { type ProgramIO } from '../cli-helpers.js';
-export declare function registerSkillConformanceCommands(program: Command, io: ProgramIO): void;

package/dist/src/cli/commands/skill-conformance-commands.js

@@ -1,39 +0,0 @@
-/**
- * peaks skills audit-conformance CLI (Slice #12) — runs the
- * skill-conformance-service against all 12 peaks-* SKILL.md files and
- * reports the 5 standard checks (frontmatter, CLI-back, loadStrategy,
- * 800-line cap, outputStyle).
- */
-import { auditSkillConformance } from '../../services/skills/skill-conformance-service.js';
-import { getErrorMessage, printResult } from '../cli-helpers.js';
-import { fail, ok } from '../../shared/result.js';
-export function registerSkillConformanceCommands(program, io) {
-    program
-        .command('skills:audit-conformance')
-        .description('Slice #12: audit all 12 peaks-* SKILL.md against the 5 alignment standards')
-        .requiredOption('--project <path>', 'target project root')
-        .option('--json', 'print machine-readable JSON envelope')
-        .action(async (options) => {
-        try {
-            const report = auditSkillConformance({ projectRoot: options.project });
-            const nextActions = [];
-            if (report.failed > 0) {
-                nextActions.push(`${report.failed} hard failure(s); fix before shipping.`);
-                for (const c of report.checks.filter((c) => c.level === 'fail')) {
-                    nextActions.push(`  - ${c.skill}: ${c.id} — ${c.message}`);
-                }
-            }
-            if (report.warned > 0) {
-                nextActions.push(`${report.warned} advisory warning(s); see envelope.checks for details.`);
-            }
-            if (report.failed === 0 && report.warned === 0) {
-                nextActions.push('All 13 skills pass the 5 alignment standards.');
-            }
-            printResult(io, ok('skills.audit-conformance', report, [], nextActions), options.json);
-        }
-        catch (error) {
-            printResult(io, fail('skills.audit-conformance', 'AUDIT_CONFORMANCE_FAILED', getErrorMessage(error), { projectRoot: options.project }, ['Verify the project path']), options.json);
-            process.exitCode = 1;
-        }
-    });
-}

package/dist/src/cli/commands/skill-loop-engineering-readiness-commands.d.ts

@@ -1,67 +0,0 @@
-/**
- * `peaks skill lint --category loop-engineering-readiness` — M6 / spec §7.5 + §8.4
- *
- * Loop Engineering readiness gate for any new peaks-* skill that
- * participates in Loop Engineering (crystallization or evolution).
- *
- * Usage:
- *   peaks skill lint --category loop-engineering-readiness --path <skill-dir>
- *   peaks skill lint --category loop-engineering-readiness --path <skill-dir> --json
- *
- * The command:
- *   1. Resolves <skill-dir>/SKILL.md (default if the path is a file).
- *   2. Calls lintSkillLoopEngineeringReadiness() with the file contents.
- *   3. Prints a structured JSON envelope via printResult (or a
- *      human-readable summary when --json is omitted).
- *   4. Sets process.exitCode = 1 on a non-ok result, so the LLM
- *      gate can short-circuit a future peaks-* skill that fails the
- *      lint.
- *
- * The lint asserts three structural properties:
- *   1. the SKILL.md references
- *      `.peaks/standards/loop-engineering-guidelines.md`;
- *   2. the SKILL.md does not introduce a CLI verb the user is meant
- *      to type (only LLM-coordinated verbs from the sediment /
- *      asset / evolution surface are allowed; RL-1);
- *   3. the SKILL.md does not introduce a JSON / manifest
- *      hand-authoring surface (RL-1).
- *
- * The user never types `peaks skill lint …` — the LLM runs it on
- * the user's behalf. This command is also reachable as
- * `peaks skill ready --category loop-engineering-readiness
- *   --path <skill-dir>`
- * via a small alias added at the bottom of this file.
- */
-import type { Command } from 'commander';
-import { type ProgramIO } from '../cli-helpers.js';
-export declare const LOOP_ENGINEERING_READINESS_CATEGORY = "loop-engineering-readiness";
-/**
- * Resolve the SKILL.md file path from a `--path <skill-dir>` value.
- *
- * Accepts either:
- *   - a directory containing a SKILL.md (the common case for a
- *     peaks-* skill: `src/skills/<id>/`, `skills/<id>/`, etc.);
- *   - a direct file path to a SKILL.md.
- *
- * Returns the absolute path to the SKILL.md, or null if no SKILL.md
- * is found.
- */
-export declare function resolveSkillMdPath(rawPath: string): string | null;
-/**
- * Pure helper: run the readiness lint against the SKILL.md text and
- * return a CLI-shaped envelope. Kept separate from the Commander
- * action so unit + integration tests can drive it without spawning
- * a child process.
- */
-export declare function runReadinessLint(rawPath: string): {
-    ok: boolean;
-    code: string;
-    message: string;
-    data: {
-        path: string;
-        category: string;
-        findings: string[];
-    };
-    nextActions: string[];
-};
-export declare function registerSkillLoopEngineeringReadinessCommands(program: Command, io: ProgramIO): void;

package/dist/src/cli/commands/skill-loop-engineering-readiness-commands.js

@@ -1,173 +0,0 @@
-/**
- * `peaks skill lint --category loop-engineering-readiness` — M6 / spec §7.5 + §8.4
- *
- * Loop Engineering readiness gate for any new peaks-* skill that
- * participates in Loop Engineering (crystallization or evolution).
- *
- * Usage:
- *   peaks skill lint --category loop-engineering-readiness --path <skill-dir>
- *   peaks skill lint --category loop-engineering-readiness --path <skill-dir> --json
- *
- * The command:
- *   1. Resolves <skill-dir>/SKILL.md (default if the path is a file).
- *   2. Calls lintSkillLoopEngineeringReadiness() with the file contents.
- *   3. Prints a structured JSON envelope via printResult (or a
- *      human-readable summary when --json is omitted).
- *   4. Sets process.exitCode = 1 on a non-ok result, so the LLM
- *      gate can short-circuit a future peaks-* skill that fails the
- *      lint.
- *
- * The lint asserts three structural properties:
- *   1. the SKILL.md references
- *      `.peaks/standards/loop-engineering-guidelines.md`;
- *   2. the SKILL.md does not introduce a CLI verb the user is meant
- *      to type (only LLM-coordinated verbs from the sediment /
- *      asset / evolution surface are allowed; RL-1);
- *   3. the SKILL.md does not introduce a JSON / manifest
- *      hand-authoring surface (RL-1).
- *
- * The user never types `peaks skill lint …` — the LLM runs it on
- * the user's behalf. This command is also reachable as
- * `peaks skill ready --category loop-engineering-readiness
- *   --path <skill-dir>`
- * via a small alias added at the bottom of this file.
- */
-import { readFileSync, existsSync, statSync } from 'node:fs';
-import { join, resolve } from 'node:path';
-import { lintSkillLoopEngineeringReadiness, } from '../../services/standards/loop-engineering-readiness-lint.js';
-import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
-import { fail, ok } from '../../shared/result.js';
-export const LOOP_ENGINEERING_READINESS_CATEGORY = 'loop-engineering-readiness';
-/**
- * Resolve the SKILL.md file path from a `--path <skill-dir>` value.
- *
- * Accepts either:
- *   - a directory containing a SKILL.md (the common case for a
- *     peaks-* skill: `src/skills/<id>/`, `skills/<id>/`, etc.);
- *   - a direct file path to a SKILL.md.
- *
- * Returns the absolute path to the SKILL.md, or null if no SKILL.md
- * is found.
- */
-export function resolveSkillMdPath(rawPath) {
-    const abs = resolve(rawPath);
-    if (!existsSync(abs))
-        return null;
-    const st = statSync(abs);
-    if (st.isFile()) {
-        return abs.toLowerCase().endsWith('skill.md') ? abs : null;
-    }
-    if (st.isDirectory()) {
-        const candidate = join(abs, 'SKILL.md');
-        return existsSync(candidate) ? candidate : null;
-    }
-    return null;
-}
-/**
- * Pure helper: run the readiness lint against the SKILL.md text and
- * return a CLI-shaped envelope. Kept separate from the Commander
- * action so unit + integration tests can drive it without spawning
- * a child process.
- */
-export function runReadinessLint(rawPath) {
-    const skillMdPath = resolveSkillMdPath(rawPath);
-    if (!skillMdPath) {
-        return {
-            ok: false,
-            code: 'SKILL_FILE_NOT_FOUND',
-            message: `could not resolve SKILL.md from --path ${rawPath}`,
-            data: { path: rawPath, category: LOOP_ENGINEERING_READINESS_CATEGORY, findings: [] },
-            nextActions: [
-                'Pass a directory containing SKILL.md or a direct path to a SKILL.md file.',
-            ],
-        };
-    }
-    const text = readFileSync(skillMdPath, 'utf-8');
-    const result = lintSkillLoopEngineeringReadiness(text);
-    if (result.ok) {
-        return {
-            ok: true,
-            code: 'SKILL_READINESS_OK',
-            message: 'SKILL.md passes the Loop Engineering readiness lint',
-            data: {
-                path: skillMdPath,
-                category: LOOP_ENGINEERING_READINESS_CATEGORY,
-                findings: [],
-            },
-            nextActions: [
-                'The skill is allowed to participate in Loop Engineering (crystallization / evolution).',
-            ],
-        };
-    }
-    return {
-        ok: false,
-        code: 'SKILL_READINESS_FAILED',
-        message: `SKILL.md failed the Loop Engineering readiness lint (${result.findings.length} finding(s))`,
-        data: {
-            path: skillMdPath,
-            category: LOOP_ENGINEERING_READINESS_CATEGORY,
-            findings: result.findings,
-        },
-        nextActions: [
-            'Address every finding listed in data.findings, then re-run the lint.',
-            'See src/services/standards/loop-engineering-readiness-lint.ts for the rule definitions.',
-            'See .peaks/standards/loop-engineering-guidelines.md for the red lines the lint enforces.',
-        ],
-    };
-}
-function lintAction(options, io) {
-    if (options.category !== LOOP_ENGINEERING_READINESS_CATEGORY) {
-        printResult(io, fail('skill.lint', 'UNKNOWN_LINT_CATEGORY', `only --category ${LOOP_ENGINEERING_READINESS_CATEGORY} is implemented in M6`, { category: options.category ?? null }, [
-            `Pass --category ${LOOP_ENGINEERING_READINESS_CATEGORY}.`,
-        ]), options.json);
-        process.exitCode = 1;
-        return;
-    }
-    if (!options.path) {
-        printResult(io, fail('skill.lint', 'MISSING_PATH', '--path <skill-dir> is required', { category: options.category }, ['Pass --path pointing at a peaks-* skill directory containing SKILL.md.']), options.json);
-        process.exitCode = 1;
-        return;
-    }
-    try {
-        const envelope = runReadinessLint(options.path);
-        if (envelope.ok) {
-            printResult(io, ok('skill.lint', envelope.data, [], envelope.nextActions), options.json);
-            return;
-        }
-        printResult(io, fail('skill.lint', envelope.code, envelope.message, envelope.data, envelope.nextActions), options.json);
-        process.exitCode = 1;
-    }
-    catch (error) {
-        printResult(io, fail('skill.lint', 'SKILL_READINESS_ERROR', getErrorMessage(error), { path: options.path }, ['Verify the path is readable.']), options.json);
-        process.exitCode = 1;
-    }
-}
-export function registerSkillLoopEngineeringReadinessCommands(program, io) {
-    // `peaks skill lint --category loop-engineering-readiness --path <skill-dir>`
-    // — primary surface, named to match the spec §7.5 / §8.4 wording.
-    // We reuse the existing `skill` parent if one is registered; per
-    // the add-a-new-subcommand-check-for-existing-top-level-first rule,
-    // we never re-create `skill` when it's already there.
-    const existingSkill = program.commands.find((c) => c.name() === 'skill');
-    const skill = existingSkill ?? program
-        .command('skill')
-        .description('skill operations (M6: lint --category loop-engineering-readiness)');
-    addJsonOption(skill
-        .command('lint')
-        .description(`M6: lint a peaks-* SKILL.md against a category. Currently supports --category ${LOOP_ENGINEERING_READINESS_CATEGORY} (spec §7.5 / §8.4 / RL-8).`)
-        .option('--category <name>', `lint category; the M6 implementation only supports ${LOOP_ENGINEERING_READINESS_CATEGORY}`, LOOP_ENGINEERING_READINESS_CATEGORY)
-        .requiredOption('--path <skill-dir>', 'path to a peaks-* skill directory (containing SKILL.md) or directly to a SKILL.md file')).action((options) => lintAction(options, io));
-    // `peaks skill ready --category loop-engineering-readiness --path <skill-dir>`
-    // — alias verb chosen by M6 for human-facing callouts. It points at
-    // the same handler; both verbs are first-class so users (LLM
-    // proxies) can pick whichever phrasing fits the conversation.
-    // Per the spec, the user never types either verb; the LLM runs the
-    // CLI on the user's behalf.
-    skill
-        .command('ready')
-        .description(`M6 alias for \`peaks skill lint --category ${LOOP_ENGINEERING_READINESS_CATEGORY}\`; same flags, same exit codes.`)
-        .option('--category <name>', `lint category; the M6 implementation only supports ${LOOP_ENGINEERING_READINESS_CATEGORY}`, LOOP_ENGINEERING_READINESS_CATEGORY)
-        .requiredOption('--path <skill-dir>', 'path to a peaks-* skill directory or SKILL.md file')
-        .option('--json', 'print machine-readable JSON envelope')
-        .action((options) => lintAction(options, io));
-}

package/dist/src/cli/commands/skill-search-commands.d.ts

@@ -1,25 +0,0 @@
-/**
- * peaks skill search — CLI primitive for S0 of the 4.0.0-beta.5
- * peaks-solo dispatcher release.
- *
- * Spec: docs/superpowers/specs/2026-07-08-peaks-solo-dispatcher-design.md §3.2
- * Plan: docs/superpowers/plans/2026-07-08-peaks-solo-dispatcher/s0-skill-search-cli.md
- *
- * Wired into the existing `peaks skill` group by
- * `src/cli/commands/core/skill-command.ts` (one import + one call).
- * The command ALWAYS emits a JSON array on stdout, even on the
- * no-match case (which exits 0 with `[]` per plan §"Match rules (v1)").
- *
- * Exit codes (locked in plan §"API Contract"):
- *   0 — success (may be empty array)
- *   1 — invalid args (Zod validation failure)
- *   2 — unexpected error (skill pool read fail, etc.)
- */
-import type { Command } from 'commander';
-import type { ProgramIO } from '../cli-helpers.js';
-/**
- * Validate the raw CLI flags, call the service, and emit a JSON
- * envelope on stdout. Errors flow through stderr + non-zero exit
- * codes per the plan §"API Contract" table.
- */
-export declare function registerSkillSearchCommand(program: Command, io: ProgramIO): void;