sneakoscope 7.3.0 → 7.6.0

package/dist/core/commands/align-command.js

@@ -0,0 +1,220 @@
+import path from 'node:path';
+import { projectRoot } from '../fsx.js';
+import { missionDir } from '../mission.js';
+import { prepareRoute } from '../pipeline-internals/runtime-core.js';
+import { maybeFinalizeRoute } from '../proof/auto-finalize.js';
+import { sksPrefixedDollarCommand } from '../routes/dollar-prefix.js';
+import { ALIGN_GATE_ARTIFACT, ALIGN_LEDGER_ARTIFACT, ALIGN_PLAN_ARTIFACT, alignNextActionText, refreshAlignGate } from '../align/align-route.js';
+import { flag, promptOf, resolveMissionId } from './command-utils.js';
+import { printJson } from '../../cli/output.js';
+const ACTIONS = new Set(['prepare', 'run', 'status', 'proof', 'fixture', 'help', '--help', '-h']);
+export async function alignCommand(sub = 'prepare', args = []) {
+    const action = String(sub || 'prepare').toLowerCase();
+    if (action === 'help' || action === '--help' || action === '-h')
+        return printHelp();
+    if (action === 'prepare' || action === 'run')
+        return alignPrepare(args, action);
+    if (action === 'status')
+        return alignStatus(args);
+    if (action === 'proof')
+        return alignProof(args);
+    if (action === 'fixture')
+        return alignFixture(args);
+    if (!ACTIONS.has(action) && !String(sub || '').startsWith('-')) {
+        return alignPrepare([String(sub), ...args], 'prepare');
+    }
+    console.error('Usage: sks align prepare|run|status|proof [task|mission] [--json]');
+    process.exitCode = 1;
+}
+async function alignPrepare(args, action) {
+    const root = await projectRoot();
+    const task = promptOf(args) || 'Align SKS prompts, settings, and skills to the latest GPT-5.6 official guides';
+    const prepared = await prepareRoute(root, `$sks-align ${task}`, {});
+    const missionId = String(prepared?.mission_id || '').trim();
+    const result = {
+        schema: 'sks.align-command.v1',
+        ok: Boolean(missionId),
+        action,
+        mission_id: missionId || null,
+        route: prepared?.route?.command
+            ? sksPrefixedDollarCommand(prepared.route.command)
+            : '$sks-align',
+        stop_gate: prepared?.route?.stopGate || ALIGN_GATE_ARTIFACT,
+        artifacts: missionId
+            ? {
+                plan: `.sneakoscope/missions/${missionId}/${ALIGN_PLAN_ARTIFACT}`,
+                ledger: `.sneakoscope/missions/${missionId}/${ALIGN_LEDGER_ARTIFACT}`,
+                gate: `.sneakoscope/missions/${missionId}/${ALIGN_GATE_ARTIFACT}`
+            }
+            : null,
+        next_action: missionId ? alignNextActionText(missionId) : 'prepare_failed',
+        additional_context: prepared?.additionalContext || null
+    };
+    if (!result.ok)
+        process.exitCode = 1;
+    if (flag(args, '--json')) {
+        printJson(result);
+        return result;
+    }
+    console.log(`SKS align ${action}: ${result.ok ? 'prepared' : 'blocked'}${missionId ? ` ${missionId}` : ''}`);
+    if (missionId) {
+        console.log(`Plan: ${result.artifacts?.plan}`);
+        console.log(`Next: ${result.next_action}`);
+    }
+    return result;
+}
+async function alignStatus(args) {
+    const root = await projectRoot();
+    const missionId = await resolveMissionId(root, positionalMission(args) || 'latest');
+    if (!missionId)
+        return missing(args);
+    const dir = missionDir(root, missionId);
+    const refreshed = await refreshAlignGate(dir, missionId);
+    const result = {
+        schema: 'sks.align-status.v1',
+        ok: true,
+        mission_id: missionId,
+        gate: refreshed.gate,
+        plan: refreshed.plan,
+        ledger: refreshed.ledger
+    };
+    if (flag(args, '--json')) {
+        printJson(result);
+        return result;
+    }
+    console.log(`Align status: ${refreshed.gate.status} ${missionId}`);
+    for (const blocker of refreshed.gate.blockers || [])
+        console.log(`- ${blocker}`);
+    return result;
+}
+async function alignProof(args) {
+    const root = await projectRoot();
+    const missionId = await resolveMissionId(root, positionalMission(args) || 'latest');
+    if (!missionId)
+        return missing(args);
+    const dir = missionDir(root, missionId);
+    const refreshed = await refreshAlignGate(dir, missionId);
+    const gate = refreshed.gate;
+    const proof = await finalizeAlignRoute(root, missionId, gate);
+    const result = {
+        schema: 'sks.align-proof.v1',
+        ok: gate.passed === true,
+        mission_id: missionId,
+        gate,
+        plan_path: path.join(dir, ALIGN_PLAN_ARTIFACT),
+        ledger_path: path.join(dir, ALIGN_LEDGER_ARTIFACT),
+        gate_path: path.join(dir, ALIGN_GATE_ARTIFACT),
+        completion_proof_path: path.join(dir, 'completion-proof.json'),
+        proof: proof.validation || proof
+    };
+    if (!result.ok)
+        process.exitCode = 1;
+    if (flag(args, '--json')) {
+        printJson(result);
+        return result;
+    }
+    console.log(`Align proof: ${result.ok ? 'pass' : 'blocked'} ${missionId}`);
+    return result;
+}
+async function alignFixture(args) {
+    const root = await projectRoot();
+    const prepared = await prepareRoute(root, '$sks-align fixture modernization contract', {});
+    const missionId = String(prepared?.mission_id || '').trim();
+    if (!missionId)
+        return missing(args);
+    const dir = missionDir(root, missionId);
+    const refreshed = await refreshAlignGate(dir, missionId);
+    const proof = await finalizeAlignRoute(root, missionId, refreshed.gate, {
+        command: 'sks align fixture --json'
+    });
+    const result = {
+        schema: 'sks.align-fixture.v1',
+        ok: false,
+        status: 'blocked',
+        execution_class: 'contract_fixture',
+        mission_id: missionId,
+        gate: refreshed.gate,
+        proof: proof.validation || proof,
+        artifacts: [
+            ALIGN_PLAN_ARTIFACT,
+            ALIGN_LEDGER_ARTIFACT,
+            ALIGN_GATE_ARTIFACT,
+            'completion-proof.json'
+        ],
+        blockers: refreshed.gate.blockers
+    };
+    process.exitCode = 1;
+    if (flag(args, '--json')) {
+        printJson(result);
+        return result;
+    }
+    console.log(`Align fixture: blocked ${missionId}`);
+    return result;
+}
+async function finalizeAlignRoute(root, missionId, gate, opts = {}) {
+    return maybeFinalizeRoute(root, {
+        missionId,
+        route: '$Align',
+        gateFile: ALIGN_GATE_ARTIFACT,
+        gate,
+        artifacts: [
+            ALIGN_PLAN_ARTIFACT,
+            ALIGN_LEDGER_ARTIFACT,
+            ALIGN_GATE_ARTIFACT,
+            'completion-proof.json'
+        ],
+        claims: [{
+                id: 'align-modernization-workstreams',
+                status: gate.passed === true ? 'supported' : 'blocked',
+                evidence: ALIGN_LEDGER_ARTIFACT
+            }],
+        blockers: gate.blockers || [],
+        statusHint: gate.passed === true ? 'verified' : 'blocked',
+        command: {
+            cmd: opts.command || `sks align proof ${missionId}`,
+            status: gate.passed === true ? 0 : 1
+        },
+        lightweightEvidence: true
+    });
+}
+function positionalMission(args) {
+    return args.find((item) => !String(item).startsWith('-')) || '';
+}
+async function missing(args) {
+    const result = {
+        schema: 'sks.align-status.v1',
+        ok: false,
+        mission_id: null,
+        error: 'align_mission_missing',
+        hint: 'Run sks align prepare first'
+    };
+    process.exitCode = 1;
+    if (flag(args, '--json')) {
+        printJson(result);
+        return result;
+    }
+    console.error('No align mission found. Run: sks align prepare');
+    return result;
+}
+function printHelp() {
+    console.log(`SKS Align — latest GPT-5.6 / openai/skills modernization route
+
+Usage:
+  sks align prepare ["scope"] [--json]
+  sks align run ["scope"] [--json]
+  sks align status [mission|latest] [--json]
+  sks align proof [mission|latest] [--json]
+  sks align fixture [--json]
+
+Dollar route: $sks-align
+Immutable skill: sks-align (mutable_by_doctor/update/setup=false)
+
+prepare/run creates a skill-first mission with align-plan.json, align-ledger.json,
+and align-gate.json, then returns the agent briefing for the modernization job.
+proof always writes completion-proof.json; fixture writes an honestly blocked
+hermetic contract proof without claiming that modernization work ran.
+`);
+}
+export function usage() {
+    return 'Usage: sks align prepare|run|status|proof|fixture [task|mission] [--json]';
+}