peaks-loop 4.0.0-beta → 4.0.0-beta.11

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

@@ -1,220 +0,0 @@
-import { executeMigration, planMigration } from '../../services/config/config-migration.js';
-import { getConfig, getMiniMaxProviderConfig, getMiniMaxProviderStatus, isSensitiveConfigPath, redactConfigSecrets, setConfig, setMiniMaxProviderConfig } from '../../services/config/config-service.js';
-import { listAvailableFields, restoreField } from '../../services/config/config-restore.js';
-import { executeRollback, planRollback } from '../../services/config/config-rollback.js';
-import { testMiniMaxProvider } from '../../services/providers/minimax-provider-service.js';
-import { fail, ok } from '../../shared/result.js';
-import { addJsonOption, getErrorMessage, isMiniMaxHttpsUrl, parseConfigLayer, printInvalidConfigLayer, printResult, redactSensitiveErrorMessage, summarizeMiniMaxSmokeResult } from '../cli-helpers.js';
-export function registerConfigCommands(program, io) {
-    const config = program.command('config').description('Manage Peaks configuration');
-    registerConfigGetSetCommands(config, io);
-    registerConfigMigrationCommands(config, io);
-    registerMiniMaxProviderCommands(config, io);
-}
-function registerConfigGetSetCommands(config, io) {
-    addJsonOption(config.command('get').description('Get current config or a specific key').option('--key <path>', 'dot-notation key path').option('--layer <layer>', 'user or project')).action((options) => {
-        const layer = parseConfigLayer(options.layer);
-        if (layer === null) {
-            printInvalidConfigLayer(io, 'config.get', options.json);
-            return;
-        }
-        const getOpts = { ...(layer !== undefined ? { layer } : {}), ...(options.key !== undefined ? { key: options.key } : {}) };
-        const value = getConfig(getOpts);
-        const isSensitiveKey = options.key !== undefined && isSensitiveConfigPath(options.key);
-        printResult(io, ok('config.get', isSensitiveKey ? '***' : redactConfigSecrets(value, options.key ?? '')), options.json);
-    });
-    addJsonOption(config.command('set').description('Set a config value').requiredOption('--key <path>', 'dot-notation key path').requiredOption('--value <json>', 'JSON value').option('--layer <layer>', 'user or project')).action((options) => {
-        const parsedLayer = parseConfigLayer(options.layer);
-        if (parsedLayer === null) {
-            printInvalidConfigLayer(io, 'config.set', options.json);
-            return;
-        }
-        let parsed;
-        try {
-            parsed = JSON.parse(options.value);
-        }
-        catch {
-            printResult(io, fail('config.set', 'INVALID_JSON', 'Could not parse value as JSON', {}, ['Use valid JSON: --value \'{"key":"value"}\'']), options.json);
-            process.exitCode = 1;
-            return;
-        }
-        try {
-            setConfig({ key: options.key, value: parsed, layer: parsedLayer ?? 'user' });
-            const value = isSensitiveConfigPath(options.key) ? '***' : redactConfigSecrets(parsed);
-            printResult(io, ok('config.set', { key: options.key, value }), options.json);
-        }
-        catch (error) {
-            printConfigSetError(io, error, options.json);
-        }
-    });
-}
-function registerConfigMigrationCommands(config, io) {
-    // Slice 0.5 Task 14 — peaks config {migrate,rollback,restore} subcommands.
-    // Wires up the config-migration / config-rollback / config-restore services
-    // from Tasks 10-12. The default mode is dry-run; --apply writes.
-    config
-        .command('migrate')
-        .description('Migrate global config from 1.x to 2.0 (YAGNI slim + per-project fields)')
-        .option('--project <path>', 'current project root (for migrating per-project fields)', process.cwd())
-        .option('--apply', 'actually write changes (default is dry-run)')
-        .option('--dry-run', 'plan only, do not write (default)')
-        .option('--json', 'JSON envelope output')
-        .action((options) => {
-        try {
-            const apply = options.apply === true;
-            if (apply) {
-                const result = executeMigration({ currentProjectRoot: options.project, apply: true });
-                printResult(io, ok('config.migrate', result), options.json);
-                return;
-            }
-            const plan = planMigration({ currentProjectRoot: options.project });
-            printResult(io, ok('config.migrate', { ...plan, applied: false }), options.json);
-        }
-        catch (error) {
-            printResult(io, fail('config.migrate', 'CONFIG_MIGRATE_FAILED', getErrorMessage(error), {}, ['Inspect ~/.peaks/config.json and re-run with --apply']), options.json);
-            process.exitCode = 1;
-        }
-    });
-    config
-        .command('rollback')
-        .description('Rollback global config to 1.x from .bak')
-        .option('--apply', 'actually write changes (default is dry-run)')
-        .option('--dry-run', 'plan only, do not write (default)')
-        .option('--json', 'JSON envelope output')
-        .action((options) => {
-        try {
-            const apply = options.apply === true;
-            if (apply) {
-                const result = executeRollback({ apply: true });
-                printResult(io, ok('config.rollback', result), options.json);
-                return;
-            }
-            const plan = planRollback();
-            printResult(io, ok('config.rollback', { ...plan, applied: false }), options.json);
-        }
-        catch (error) {
-            const message = getErrorMessage(error);
-            const code = message.startsWith('NO_BACKUP') ? 'NO_BACKUP' : 'CONFIG_ROLLBACK_FAILED';
-            io.stderr(`${code}: ${message}`);
-            printResult(io, fail('config.rollback', code, message, {}, ['Re-run peaks config migrate --apply to recreate the .bak']), options.json);
-            process.exitCode = 1;
-        }
-    });
-    config
-        .command('restore')
-        .description('Restore a single archived field from .bak to a sidecar file')
-        .option('--field <name>', 'field name to restore (e.g. language, currentWorkspace)')
-        .option('--list', 'list all fields available in .bak')
-        .option('--apply', 'actually write sidecar (default is dry-run)')
-        .option('--dry-run', 'plan only, do not write (default)')
-        .option('--json', 'JSON envelope output')
-        .action((options) => {
-        try {
-            if (options.list === true || !options.field) {
-                const fields = listAvailableFields();
-                printResult(io, ok('config.restore', { fields, applied: false }), options.json);
-                return;
-            }
-            const apply = options.apply === true;
-            const result = restoreField({ field: options.field, apply });
-            printResult(io, ok('config.restore', result), options.json);
-        }
-        catch (error) {
-            const message = getErrorMessage(error);
-            let code = 'CONFIG_RESTORE_FAILED';
-            if (message.startsWith('NO_BACKUP'))
-                code = 'NO_BACKUP';
-            else if (message.startsWith('RESTORE_GUARDED'))
-                code = 'RESTORE_GUARDED';
-            else if (message.startsWith('FIELD_NOT_FOUND'))
-                code = 'FIELD_NOT_FOUND';
-            io.stderr(`${code}: ${message}`);
-            printResult(io, fail('config.restore', code, message, {}, ['Use --list to see available fields']), options.json);
-            process.exitCode = 1;
-        }
-    });
-}
-function printConfigSetError(io, error, asJson) {
-    const message = getErrorMessage(error);
-    if (message === 'Sensitive config keys must be stored in the user config layer') {
-        printResult(io, fail('config.set', 'SECRET_CONFIG_REQUIRES_USER_LAYER', message, {}, ['Use --layer user or peaks config provider minimax set']), asJson);
-        process.exitCode = 1;
-        return;
-    }
-    if (message === 'Project config not found') {
-        printResult(io, fail('config.set', 'PROJECT_CONFIG_NOT_FOUND', message, {}, ['Create a safe .peaks/config.json in the project or use --layer user']), asJson);
-        process.exitCode = 1;
-        return;
-    }
-    if (message === 'MiniMax base URL must be the MiniMax HTTPS endpoint without embedded credentials') {
-        printResult(io, fail('config.set', 'INVALID_MINIMAX_BASE_URL', message, {}, ['Use a MiniMax Anthropic-compatible HTTPS endpoint']), asJson);
-        process.exitCode = 1;
-        return;
-    }
-    printResult(io, fail('config.set', 'CONFIG_SET_FAILED', message, {}, ['Check the config key and layer, then retry']), asJson);
-    process.exitCode = 1;
-}
-function registerMiniMaxProviderCommands(config, io) {
-    const minimaxProvider = config.command('provider').description('Manage model provider settings').command('minimax').description('Manage MiniMax provider settings');
-    addJsonOption(minimaxProvider.command('set').description('Set MiniMax provider settings in user config').option('--base-url <url>', 'MiniMax Anthropic-compatible base URL')).action((options) => {
-        const baseUrl = options.baseUrl?.trim();
-        const apiKey = process.env.MINIMAX_API_KEY?.trim();
-        if (!baseUrl && !apiKey) {
-            printResult(io, fail('config.provider.minimax.set', 'MINIMAX_PROVIDER_NO_VALUES', 'Provide --base-url and set MINIMAX_API_KEY', {}, ['Export MINIMAX_API_KEY and rerun peaks config provider minimax set --base-url <url>']), options.json);
-            process.exitCode = 1;
-            return;
-        }
-        if (baseUrl && !isMiniMaxHttpsUrl(baseUrl)) {
-            printResult(io, fail('config.provider.minimax.set', 'INVALID_MINIMAX_BASE_URL', 'MiniMax base URL must be the MiniMax HTTPS endpoint without embedded credentials', {}, ['Use a MiniMax Anthropic-compatible HTTPS endpoint']), options.json);
-            process.exitCode = 1;
-            return;
-        }
-        try {
-            const input = {};
-            if (baseUrl)
-                input.baseUrl = baseUrl;
-            if (apiKey)
-                input.apiKey = apiKey;
-            const status = setMiniMaxProviderConfig(input);
-            printResult(io, ok('config.provider.minimax.set', status), options.json);
-        }
-        catch (error) {
-            printMiniMaxProviderSetError(io, error, options.json);
-        }
-    });
-    addJsonOption(minimaxProvider.command('get').description('Show redacted MiniMax provider settings')).action((options) => {
-        const configValue = getMiniMaxProviderConfig();
-        const status = getMiniMaxProviderStatus();
-        printResult(io, ok('config.provider.minimax.get', { ...redactConfigSecrets(configValue, 'providers.minimax'), ...status }), options.json);
-    });
-    addJsonOption(minimaxProvider.command('status').description('Show MiniMax provider configuration status')).action((options) => {
-        printResult(io, ok('config.provider.minimax.status', getMiniMaxProviderStatus()), options.json);
-    });
-    addJsonOption(minimaxProvider.command('test').description('Run a redacted MiniMax provider smoke test').option('--model <model>', 'model name for the smoke test', 'MiniMax-M2.7')).action(async (options) => {
-        try {
-            const result = await testMiniMaxProvider(getMiniMaxProviderConfig(), { model: options.model });
-            const safeResult = summarizeMiniMaxSmokeResult(result);
-            if (!result.configured) {
-                printResult(io, fail('config.provider.minimax.test', 'MINIMAX_PROVIDER_NOT_CONFIGURED', 'MiniMax provider requires baseUrl and apiKey in user config', safeResult, ['Export MINIMAX_API_KEY or set MINIMAX_API_KEY']), options.json);
-                process.exitCode = 1;
-                return;
-            }
-            printResult(io, result.ok ? ok('config.provider.minimax.test', safeResult) : fail('config.provider.minimax.test', 'MINIMAX_PROVIDER_TEST_FAILED', 'MiniMax provider smoke test failed', safeResult, ['Check the MiniMax base URL, API key, and model name']), options.json);
-            if (!result.ok)
-                process.exitCode = 1;
-        }
-        catch (error) {
-            printResult(io, fail('config.provider.minimax.test', 'MINIMAX_PROVIDER_TEST_FAILED', redactSensitiveErrorMessage(getErrorMessage(error)), {}, ['Check network connectivity and MiniMax provider settings']), options.json);
-            process.exitCode = 1;
-        }
-    });
-}
-function printMiniMaxProviderSetError(io, error, asJson) {
-    if (getErrorMessage(error) === 'MiniMax base URL must be the MiniMax HTTPS endpoint without embedded credentials') {
-        printResult(io, fail('config.provider.minimax.set', 'INVALID_MINIMAX_BASE_URL', 'MiniMax base URL must be the MiniMax HTTPS endpoint without embedded credentials', {}, ['Use a MiniMax Anthropic-compatible HTTPS endpoint']), asJson);
-        process.exitCode = 1;
-        return;
-    }
-    printResult(io, fail('config.provider.minimax.set', 'MINIMAX_PROVIDER_SET_FAILED', getErrorMessage(error), {}, ['Check MiniMax provider settings and retry']), asJson);
-    process.exitCode = 1;
-}

package/dist/src/cli/commands/core/skill-command.js

@@ -1,275 +0,0 @@
-import { runDoctor } from '../../../services/doctor/doctor-service.js';
-import { listSkills } from '../../../services/skills/skill-registry.js';
-import { runSkillSync, SYNC_PLATFORMS } from '../../../services/skills/sync-service.js';
-import { inspectSkillRunbook } from '../../../services/skills/skill-runbook-service.js';
-import { setSkillPresence, clearSkillPresence, getSkillPresence, isSkillPresenceMode, touchSkillHeartbeat, checkStalePresence } from '../../../services/skills/skill-presence-service.js';
-import { detectPresenceMarker } from '../../../services/hooks/presence-marker-detector.js';
-import { findProjectRoot } from '../../../services/config/config-safety.js';
-import { generateProjectContext } from '../../../services/memory/project-context-service.js';
-import { getSessionId, setSessionMeta } from '../../../services/session/session-manager.js';
-import { fail, ok } from '../../../shared/result.js';
-import { addJsonOption, getErrorMessage, printResult } from '../../cli-helpers.js';
-export function registerSkillCommand(program, io) {
-    const skill = program.command('skill').description('Manage Peaks skills');
-    addJsonOption(skill.command('list').description('List skills derived from skills/*/SKILL.md')).action(async (options) => {
-        const skills = await listSkills();
-        if (options.json === true) {
-            printResult(io, ok('skill.list', { skills }), true);
-        }
-        else {
-            const sorted = [...skills].sort((a, b) => {
-                if (a.name === 'peaks-sop')
-                    return -1;
-                if (b.name === 'peaks-sop')
-                    return 1;
-                if (a.name === 'peaks-code')
-                    return -1;
-                if (b.name === 'peaks-code')
-                    return 1;
-                return a.name.localeCompare(b.name);
-            });
-            for (const skill of sorted) {
-                io.stdout(`  ${skill.name.padEnd(14)}${skill.description}`);
-            }
-            io.stdout(`\n  Invoke any skill by typing its name in conversation (e.g. \`peaks-sop\`).`);
-        }
-    });
-    addJsonOption(skill.command('doctor').description('Run skill-related doctor checks')).action(async (options) => {
-        const report = await runDoctor();
-        const skillChecks = report.checks.filter((check) => check.id.startsWith('skill'));
-        const failed = skillChecks.filter((check) => !check.ok).length;
-        if (options.json === true) {
-            printResult(io, ok('skill.doctor', { checks: skillChecks, ok: failed === 0 }), true);
-        }
-        else {
-            for (const check of skillChecks) {
-                const icon = check.ok ? '+' : '×';
-                io.stdout(`  ${icon}  ${check.message}`);
-            }
-            io.stdout(`\n  ${skillChecks.length - failed} passed, ${failed} failed`);
-            if (failed > 0) {
-                io.stderr('\nOne or more skill checks failed.');
-            }
-        }
-        if (failed > 0) {
-            process.exitCode = 1;
-        }
-    });
-    // Slice #12 final piece (per spec §9 line 1105):
-    // `peaks skills sync 8 平台分发`. Idempotent: re-running is a
-    // no-op when the symlinks are already correct.
-    addJsonOption(skill
-        .command('sync')
-        .description(`Sync the peaks-* skill family to one or all of the 8 supported LLM-CLI platforms (${SYNC_PLATFORMS.join(', ')}). Idempotent.`)
-        .option('--platform <id>', `sync only one platform (default: --all). Valid: ${SYNC_PLATFORMS.join(', ')}`)
-        .option('--all', 'sync all 8 platforms (default if --platform is omitted)')
-        .option('--dry-run', 'do not write; emit the same shape with applied=false')
-        .option('--project <path>', 'project root (default: cwd)')).action(async (options) => {
-        try {
-            const projectRoot = options.project ?? process.cwd();
-            const platforms = options.platform !== undefined ? [options.platform] : undefined;
-            const result = await runSkillSync({
-                projectRoot,
-                ...(platforms !== undefined ? { platforms } : {}),
-                ...(options.dryRun === true ? { dryRun: true } : {}),
-            });
-            const envelope = ok('skill.sync', result, [], [
-                `syncedCount: ${result.syncedCount}/${result.perPlatform.length} platforms`,
-                `totalInstalled: ${result.totalInstalled} skill symlinks`,
-                result.failedCount > 0
-                    ? `failedCount: ${result.failedCount} (run \`peaks skill status\` for details)`
-                    : 'no failures',
-            ]);
-            printResult(io, envelope, options.json);
-            if (result.failedCount > 0) {
-                process.exitCode = 1;
-            }
-        }
-        catch (error) {
-            const message = getErrorMessage(error);
-            printResult(io, fail('skill.sync', 'SKILL_SYNC_FAILED', message, { applied: false }, [message]), options.json);
-            process.exitCode = 1;
-        }
-    });
-    addJsonOption(skill
-        .command('runbook <name>')
-        .description('Inspect a skill Default runbook section and its --apply authorization-note status')).action(async (name, options) => {
-        try {
-            const inspection = await inspectSkillRunbook(name);
-            const result = inspection.ok
-                ? ok('skill.runbook', inspection)
-                : fail('skill.runbook', inspection.hasRunbook ? 'SKILL_RUNBOOK_APPLY_UNGATED' : 'SKILL_RUNBOOK_MISSING', inspection.hasRunbook
-                    ? `Skill ${inspection.name} has ${inspection.destructiveApplyLines.length} destructive --apply command(s) without an authorization/dry-run note`
-                    : `Skill ${inspection.name} is missing a ## Default runbook section`, inspection, inspection.hasRunbook
-                    ? ['Add an authorization or --dry-run note next to destructive --apply lines in the runbook section']
-                    : ['Add a `## Default runbook` section to the skill SKILL.md']);
-            printResult(io, result, options.json);
-            if (!inspection.ok) {
-                process.exitCode = 1;
-            }
-        }
-        catch (error) {
-            printResult(io, fail('skill.runbook', 'SKILL_NOT_FOUND', getErrorMessage(error), { name }), options.json);
-            process.exitCode = 1;
-        }
-    });
-    addJsonOption(skill
-        .command('presence')
-        .description('Show the currently active Peaks skill (alias: presence:get)')
-        .option('--check-stale', 'slice 002 (v2.15.0): also report whether the recorded outer session id still matches the current one. Default false (back-compat).')
-        .option('--project <path>', 'project root (default: cwd)')).action((options) => {
-        const presence = getSkillPresence(options.project);
-        if (presence === null) {
-            printResult(io, ok('skill.presence', { active: false }), options.json);
-            return;
-        }
-        if (options.checkStale === true) {
-            // Slice 002 (v2.15.0) AC-1: pair the read with a staleness
-            // check so callers (peaks-code Step 1, statusline) get both
-            // pieces of info from a single CLI invocation. The presence
-            // is returned UNCHANGED — `--check-stale` is a read-only flag,
-            // not a clear.
-            const staleness = checkStalePresence({ projectRootOverride: options.project });
-            printResult(io, ok('skill.presence', {
-                active: true,
-                ...presence,
-                stale: staleness.stale,
-                staleReason: staleness.reason,
-                currentOuterSessionId: staleness.currentOuterSessionId,
-                recordedOuterSessionId: staleness.recordedOuterSessionId
-            }), options.json);
-            return;
-        }
-        printResult(io, ok('skill.presence', { active: true, ...presence }), options.json);
-    });
-    addJsonOption(skill
-        .command('presence:set <name>')
-        .description('Set the currently active Peaks skill for session-wide visibility')
-        .option('--mode <mode>', 'execution mode')
-        .option('--gate <gate>', 'current gate')
-        .option('--project <path>', 'project root path (auto-detected from cwd when omitted)')).action((name, options) => {
-        const projectRoot = options.project ?? findProjectRoot(process.cwd()) ?? process.cwd();
-        if (options.mode !== undefined && !isSkillPresenceMode(options.mode)) {
-            printResult(io, fail('skill.presence:set', 'INVALID_MODE', `Invalid mode: ${options.mode} (expected one of: full-auto, assisted, swarm, strict)`, { name, mode: options.mode }, ['Use a valid mode: full-auto, assisted, swarm, or strict']), options.json);
-            process.exitCode = 1;
-            return;
-        }
-        const presence = setSkillPresence(name, options.mode, options.gate, options.project);
-        // As of slice 003-2026-06-06-session-layout-canonicalize we do NOT
-        // call `ensureSession` here. The CLI wrapper previously spawned a
-        // new session on every presence call, which made the canonical
-        // session binding drift (the LLM saw the session id change every
-        // turn). The presence now reuses the session bound at
-        // `.peaks/_runtime/session.json` (or the legacy `.peaks/.session.json`
-        // during the back-compat window). If no session is bound, the
-        // presence still writes the active-skill marker — downstream code
-        // can `peaks workspace init` separately to create the session.
-        //
-        // Session metadata is updated when a session is bound (read-only
-        // path: `getSessionId`). We do not auto-spawn a session.
-        const boundSessionId = getSessionId(projectRoot);
-        if (boundSessionId !== null) {
-            setSessionMeta(projectRoot, boundSessionId, {
-                skill: name,
-                ...(options.mode ? { mode: options.mode } : {}),
-                ...(options.gate ? { gate: options.gate } : {})
-            });
-        }
-        printResult(io, ok('skill.presence:set', { active: true, ...presence }), options.json);
-    });
-    addJsonOption(skill
-        .command('presence:clear')
-        .description('Clear the active Peaks skill presence indicator and update project context')
-        .option('--project <path>', 'project root path (auto-detected from cwd when omitted)')).action((options) => {
-        const projectRoot = options.project ?? findProjectRoot(process.cwd()) ?? process.cwd();
-        const removed = clearSkillPresence(options.project);
-        // Auto-update project context so future sessions have up-to-date history
-        try {
-            generateProjectContext(projectRoot);
-        }
-        catch { // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
-            // non-fatal: context update failure should not block presence clear
-        }
-        printResult(io, ok('skill.presence:clear', { active: false, removed, projectContextUpdated: true }), options.json);
-    });
-    // Slice 002 (v2.15.0) — AC-1: presence staleness detector.
-    // peaks-code Step 1 (and `peaks solo should-pause --step
-    // step-1-mode-select`) calls this to decide whether the recorded
-    // `mode` field can be trusted or whether the LLM must AskUserQuestion.
-    addJsonOption(skill
-        .command('presence:check-stale')
-        .description('Slice 002 (v2.15.0) AC-1: report whether the recorded presence outer session id still matches the current outer session id. ' +
-        'Returns { stale: boolean, reason: "outer-session-mismatch" | "no-presence" | null }. ' +
-        'Pure read-only — does NOT clear the presence (use `peaks skill presence:clear` for that).')
-        .option('--project <path>', 'project root (default: cwd)')
-        .option('--current-outer <id>', 'override the current outer session id (test seam; default: read from PEAKS_OUTER_SESSION_ID / CLAUDE_CODE_SESSION_ID)')).action((options) => {
-        // v2.15.0 slice 002 repair: do NOT pass `currentOuter: undefined`
-        // when the user omits the flag. The service-layer branch
-        // `'currentOuter' in opts` returns true for an explicit
-        // `undefined` (the key exists on the spread object literal),
-        // which would skip the env-var fallback and pin `current =
-        // undefined` — always reading the presence as stale. Build a
-        // sparse opts object so the service can fall back to
-        // `getCurrentOuterSessionId()` (reads PEAKS_OUTER_SESSION_ID /
-        // CLAUDE_CODE_SESSION_ID).
-        const checkOpts = options.project !== undefined ? { projectRootOverride: options.project } : {};
-        if (options.currentOuter !== undefined) {
-            checkOpts.currentOuter = options.currentOuter;
-        }
-        const result = checkStalePresence(checkOpts);
-        // Always emit `currentOuterSessionId` in the JSON envelope (even
-        // when undefined → ''), per slice 002 AC-1 contract: downstream
-        // tooling (statusline, sub-agent dispatch) reads the field by
-        // name, never by `data.currentOuterSessionId ?? ''`. JSON.stringify
-        // drops `undefined` properties, so we coerce to '' before
-        // wrapping in the envelope.
-        const data = {
-            stale: result.stale,
-            reason: result.reason,
-            presence: result.presence,
-            currentOuterSessionId: result.currentOuterSessionId ?? '',
-            recordedOuterSessionId: result.recordedOuterSessionId ?? ''
-        };
-        printResult(io, ok('skill.presence:check-stale', data), options.json);
-    });
-    addJsonOption(skill
-        .command('heartbeat')
-        .description('Show the heartbeat status of the active Peaks skill')).action((options) => {
-        const presence = getSkillPresence();
-        if (presence === null) {
-            printResult(io, ok('skill.heartbeat', { active: false, heartbeat: 'none' }), options.json);
-            return;
-        }
-        printResult(io, ok('skill.heartbeat', {
-            active: true,
-            skill: presence.skill,
-            gate: presence.gate ?? null,
-            lastHeartbeat: presence.lastHeartbeat ?? presence.setAt,
-            setAt: presence.setAt
-        }), options.json);
-    });
-    addJsonOption(skill
-        .command('heartbeat:touch')
-        .description('Update the heartbeat timestamp (called by the LLM each turn to confirm peaks skill context is alive)')).action((options) => {
-        const updated = touchSkillHeartbeat();
-        if (updated === null) {
-            printResult(io, ok('skill.heartbeat:touch', { active: false, heartbeat: 'none' }), options.json);
-            return;
-        }
-        printResult(io, ok('skill.heartbeat:touch', {
-            active: true,
-            skill: updated.skill,
-            lastHeartbeat: updated.lastHeartbeat
-        }), options.json);
-    });
-    addJsonOption(skill
-        .command('detect-marker-loss')
-        .description('Detect whether the latest assistant message lost the Peaks-Loop status header while a peaks skill is still active (slice 028 detection primitive).')
-        .option('--project <path>', 'project root path (auto-detected from cwd when omitted)')
-        .option('--message <text>', 'latest assistant message text to scan (defaults to reading the most recent LLM response from the stdin pipe, or empty string when no pipe is attached)')).action((options) => {
-        const projectRoot = options.project ?? findProjectRoot(process.cwd()) ?? process.cwd();
-        const message = options.message ?? '';
-        const result = detectPresenceMarker({ project: projectRoot, latestAssistantMessage: message });
-        printResult(io, ok('skill.detect-marker-loss', result), options.json);
-    });
-}