sneakoscope 3.1.8 → 3.1.10

package/README.md

@@ -35,14 +35,15 @@ Set up this agent project with Sneakoscope Codex. Use [[mandarange/Sneakoscope-C
 
 ## 🚀 Current Release
 
-SKS **3.1.8** hardens update/setup/doctor safety around four operator-facing failure modes: immutable core skills, duplicate project skills, real native capability repair status, and Supabase/secret preservation.
+SKS **3.1.10** is a release-ready hardening pass for release wiring parity, immutable core skills, duplicate skill prevention, native capability postchecks, and protected secret rollback.
 
-What changed in 3.1.8:
+What changed in 3.1.10:
 
 - **Core SKS skills are content-addressed and immutable.** The eight built-in route skills now have a manifest and no-drift gates; setup/update/doctor may install missing managed copies or restore corrupted managed copies, but they do not overwrite user-authored collisions.
-- **Duplicate skills are detected and repaired safely.** Canonical skill names collapse variants such as `Loop`, `loop`, and `loop/SKILL.md`; SKS-managed duplicates can be quarantined automatically, while user-authored duplicates require explicit confirmation.
-- **`sks doctor --fix` reports native capability truthfully.** Image generation, image follow-up edit paths, Computer Use, Chrome/web review, app screenshots, app handoff, and image path exposure now run through a repair matrix and postcheck instead of capability assumptions.
-- **Supabase keys survive setup/update/doctor.** Protected secret surfaces are fingerprinted before and after guarded operations; reports store only redacted previews and hashes, never raw values.
+- **Release wiring is self-checking.** `release:gate-script-parity`, `release:wiring-3110-blackbox`, and `sks:3110-all-feature-regression` prove required ids, package scripts, release gates, source scripts, and built dist targets stay aligned.
+- **Duplicate skills are detected and repaired safely.** Canonical skill names collapse variants such as `Loop`, `loop`, and `loop/SKILL.md`; SKS-managed duplicates can be quarantined automatically, while user-authored duplicates require explicit confirmation and produce active-name proof.
+- **`sks doctor --fix` reports native capability truthfully.** Image generation, image follow-up edit paths, Computer Use, Chrome/web review, app screenshots, app handoff, and image path exposure now run capability-specific postchecks; manual-only and fallback surfaces do not become `verified`.
+- **Supabase keys survive setup/update/doctor.** Protected secret surfaces are fingerprinted before and after guarded operations; missing or changed values are restored from backup or hard-fail without writing raw values to reports.
 
 SKS 3.0.0 was the parallel-runtime stabilization release. The whole live-swarm experience — what you actually *see* while 5, 20, or 100 workers run — was rebuilt and proven end-to-end.
 

package/crates/sks-core/Cargo.lock

@@ -76,7 +76,7 @@ dependencies = [
 
 [[package]]
 name = "sks-core"
-version = "3.1.8"
+version = "3.1.10"
 dependencies = [
  "serde_json",
 ]

package/crates/sks-core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "sks-core"
-version = "3.1.8"
+version = "3.1.10"
 edition = "2021"
 
 [dependencies]

package/crates/sks-core/src/main.rs

@@ -4,7 +4,7 @@ use std::io::{self, Read, Seek, SeekFrom};
 fn main() {
     let mut args = std::env::args().skip(1);
     match args.next().as_deref() {
-        Some("--version") => println!("sks-rs 3.1.8"),
+        Some("--version") => println!("sks-rs 3.1.10"),
         Some("compact-info") => {
             let mut input = String::new();
             let _ = io::stdin().read_to_string(&mut input);

package/dist/.sks-build-stamp.json

@@ -1,8 +1,8 @@
 {
   "schema": "sks.dist-build-stamp.v1",
   "package_name": "sneakoscope",
-  "package_version": "3.1.8",
-  "source_digest": "94742dc3eb63f280df98aa286ac2a94a14fd140f27c89db85880e4f92c630454",
-  "source_file_count": 2602,
-  "built_at_source_time": 1781513577024
+  "package_version": "3.1.10",
+  "source_digest": "57a7f5ee1f3ac797f46e3dfd59365b1e147e4637a8ddd18fde2cbee802fec0ac",
+  "source_file_count": 2609,
+  "built_at_source_time": 1781550268084
 }

package/dist/bin/sks.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-const FAST_PACKAGE_VERSION = '3.1.8';
+const FAST_PACKAGE_VERSION = '3.1.10';
 const args = process.argv.slice(2);
 try {
     if (args[0] === '--agent' && args[1] === 'worker') {

package/dist/cli/args.js

@@ -28,6 +28,23 @@ export function positionalArgs(args = []) {
         '--command',
         '--project-ref',
         '--agent',
+        '--agents',
+        '--target-active-slots',
+        '--work-items',
+        '--minimum-work-items',
+        '--max-queue-expansion',
+        '--concurrency',
+        '--backend',
+        '--route',
+        '--mission',
+        '--mission-id',
+        '--profile',
+        '--write-mode',
+        '--max-write-agents',
+        '--service-tier',
+        '--zellij-session-name',
+        '--worker-placement',
+        '--zellij-visible-pane-cap',
         '--phase',
         '--message',
         '--role',

package/dist/cli/command-registry.js

@@ -99,21 +99,16 @@ export const COMMANDS = {
     'codex-app': entry('beta', 'Check Codex App readiness', 'dist/commands/codex-app.js', directCommand(() => import('../commands/codex-app.js'), 'dist/commands/codex-app.js')),
     'codex-native': entry('beta', 'Inspect Codex Native broker and routing readiness', 'dist/commands/codex-native.js', directCommand(() => import('../commands/codex-native.js'), 'dist/commands/codex-native.js')),
     'codex-lb': entry('beta', 'Inspect codex-lb status and circuit health', 'dist/commands/codex-lb.js', directCommand(() => import('../commands/codex-lb.js'), 'dist/commands/codex-lb.js')),
-    auth: entry('beta', 'Alias for codex-lb auth commands', 'dist/commands/codex-lb.js', directCommand(() => import('../commands/codex-lb.js'), 'dist/commands/codex-lb.js')),
     hooks: entry('beta', 'Explain and inspect Codex hooks', 'dist/commands/hooks.js', directCommand(() => import('../commands/hooks.js'), 'dist/commands/hooks.js')),
     tmux: entry('beta', 'Show removed-runtime migration notice', 'dist/commands/tmux.js', directCommand(() => import('../commands/tmux.js'), 'dist/commands/tmux.js')),
     'zellij-lane': entry('beta', 'Render a Zellij lane frame for SKS sessions', 'dist/commands/zellij-lane.js', directCommand(() => import('../commands/zellij-lane.js'), 'dist/commands/zellij-lane.js')),
     'zellij-slot-pane': entry('beta', 'Render a compact Zellij worker slot pane', 'dist/commands/zellij-slot-pane.js', directCommand(() => import('../commands/zellij-slot-pane.js'), 'dist/commands/zellij-slot-pane.js')),
     'zellij-slot-column-anchor': entry('beta', 'Render the compact SLOTS anchor pane for first-slot-down Zellij stacks', 'dist/commands/zellij-slot-column-anchor.js', directCommand(() => import('../commands/zellij-slot-column-anchor.js'), 'dist/commands/zellij-slot-column-anchor.js')),
     zellij: entry('beta', 'Inspect Zellij runtime status and explain repair (no auto-install)', 'dist/commands/zellij.js', directCommand(() => import('../commands/zellij.js'), 'dist/commands/zellij.js')),
-    mad: entry('beta', 'MAD-SKS Zellij permission launcher', 'dist/commands/mad-sks.js', directCommand(() => import('../commands/mad-sks.js'), 'dist/commands/mad-sks.js')),
     'mad-sks': entry('beta', 'MAD-SKS scoped permission modifier', 'dist/commands/mad-sks.js', directCommand(() => import('../commands/mad-sks.js'), 'dist/commands/mad-sks.js')),
     'mad-db': entry('beta', 'Create or inspect one-cycle Mad-DB break-glass capability tokens', 'dist/commands/mad-db.js', directCommand(() => import('../commands/mad-db.js'), 'dist/commands/mad-db.js')),
     'auto-review': entry('beta', 'Manage auto-review profile', 'dist/commands/auto-review.js', directCommand(() => import('../commands/auto-review.js'), 'dist/commands/auto-review.js')),
-    autoreview: entry('beta', 'Alias for auto-review', 'dist/commands/auto-review.js', directCommand(() => import('../commands/auto-review.js'), 'dist/commands/auto-review.js')),
     'dollar-commands': entry('stable', 'List Codex App dollar commands', 'dist/core/commands/basic-cli.js', basicArgs('dollarCommandsCommand')),
-    dollars: entry('stable', 'Alias for dollar-commands', 'dist/core/commands/basic-cli.js', basicArgs('dollarCommandsCommand')),
-    '$': entry('stable', 'Alias for dollar-commands', 'dist/core/commands/basic-cli.js', basicArgs('dollarCommandsCommand')),
     'fast-mode': entry('stable', 'Toggle SKS Fast mode default for dollar-command routes', 'dist/core/commands/fast-mode-command.js', argsCommand(() => import('../core/commands/fast-mode-command.js'), 'fastModeCommand', 'dist/core/commands/fast-mode-command.js')),
     commit: entry('stable', 'Create a simple git commit', 'dist/commands/commit.js', directCommand(() => import('../commands/commit.js'), 'dist/commands/commit.js')),
     'commit-and-push': entry('stable', 'Create a simple git commit and push', 'dist/commands/commit-and-push.js', directCommand(() => import('../commands/commit-and-push.js'), 'dist/commands/commit-and-push.js')),
@@ -128,14 +123,9 @@ export const COMMANDS = {
     autoresearch: entry('labs', 'Alias for research/autoresearch route', 'dist/core/commands/autoresearch-command.js', subcommand(() => import('../core/commands/autoresearch-command.js'), 'autoresearchCommand', 'dist/core/commands/autoresearch-command.js', 'status')),
     ppt: entry('labs', 'Inspect/build PPT artifacts', 'dist/core/commands/ppt-command.js', commandArgsCommand(() => import('../core/commands/ppt-command.js'), 'pptCommand', 'dist/core/commands/ppt-command.js')),
     'image-ux-review': entry('labs', 'Inspect image UX artifacts', 'dist/core/commands/image-ux-review-command.js', commandArgsCommand(() => import('../core/commands/image-ux-review-command.js'), 'imageUxReviewCommand', 'dist/core/commands/image-ux-review-command.js')),
-    'ux-review': entry('labs', 'Alias for image UX review', 'dist/core/commands/image-ux-review-command.js', commandArgsCommand(() => import('../core/commands/image-ux-review-command.js'), 'imageUxReviewCommand', 'dist/core/commands/image-ux-review-command.js')),
-    'visual-review': entry('labs', 'Alias for image UX review', 'dist/core/commands/image-ux-review-command.js', commandArgsCommand(() => import('../core/commands/image-ux-review-command.js'), 'imageUxReviewCommand', 'dist/core/commands/image-ux-review-command.js')),
-    'ui-ux-review': entry('labs', 'Alias for image UX review', 'dist/core/commands/image-ux-review-command.js', commandArgsCommand(() => import('../core/commands/image-ux-review-command.js'), 'imageUxReviewCommand', 'dist/core/commands/image-ux-review-command.js')),
     'computer-use': entry('beta', 'Record native Mac/non-web Computer Use visual evidence', 'dist/core/commands/computer-use-command.js', commandArgsCommand(() => import('../core/commands/computer-use-command.js'), 'computerUseCommand', 'dist/core/commands/computer-use-command.js')),
-    cu: entry('beta', 'Alias for native Computer Use', 'dist/core/commands/computer-use-command.js', commandArgsCommand(() => import('../core/commands/computer-use-command.js'), 'computerUseCommand', 'dist/core/commands/computer-use-command.js')),
     context7: entry('beta', 'Context7 checks and docs', 'dist/cli/context7-command.js', subcommand(() => import('./context7-command.js'), 'context7Command', 'dist/cli/context7-command.js', 'check')),
     xai: entry('beta', 'Set up and check xAI/Grok search MCP integration', 'dist/cli/xai-command.js', subcommand(() => import('./xai-command.js'), 'xaiCommand', 'dist/cli/xai-command.js', 'check')),
-    grok: entry('beta', 'Alias for xAI/Grok search setup', 'dist/cli/xai-command.js', subcommand(() => import('./xai-command.js'), 'xaiCommand', 'dist/cli/xai-command.js', 'check')),
     recallpulse: entry('labs', 'RecallPulse evidence route', 'dist/commands/recallpulse.js', directCommand(() => import('../commands/recallpulse.js'), 'dist/commands/recallpulse.js')),
     pipeline: entry('beta', 'Inspect pipeline missions', 'dist/commands/pipeline.js', directCommand(() => import('../commands/pipeline.js'), 'dist/commands/pipeline.js')),
     guard: entry('beta', 'Check harness guard', 'dist/commands/guard.js', directCommand(() => import('../commands/guard.js'), 'dist/commands/guard.js')),
@@ -156,7 +146,6 @@ export const COMMANDS = {
     'skill-dream': entry('labs', 'Track skill dream counters', 'dist/core/commands/skill-dream-command.js', subcommand(() => import('../core/commands/skill-dream-command.js'), 'skillDreamCommand', 'dist/core/commands/skill-dream-command.js', 'status')),
     'code-structure': entry('labs', 'Scan source structure', 'dist/core/commands/code-structure-command.js', subcommand(() => import('../core/commands/code-structure-command.js'), 'codeStructureCommand', 'dist/core/commands/code-structure-command.js', 'scan')),
     rust: entry('beta', 'Inspect optional Rust accelerator status and smoke parity', 'dist/commands/rust.js', directCommand(() => import('../commands/rust.js'), 'dist/commands/rust.js')),
-    memory: entry('labs', 'Run retention checks', 'dist/core/commands/gc-command.js', subcommand(() => import('../core/commands/gc-command.js'), 'memoryCommand', 'dist/core/commands/gc-command.js')),
     gx: entry('labs', 'Render/validate GX cartridges', 'dist/core/commands/gx-command.js', subcommand(() => import('../core/commands/gx-command.js'), 'gxCommand', 'dist/core/commands/gx-command.js', 'validate')),
     db: entry('beta', 'Inspect DB safety policy', 'dist/core/commands/db-command.js', subcommand(() => import('../core/commands/db-command.js'), 'dbCommand', 'dist/core/commands/db-command.js', 'policy')),
     eval: entry('labs', 'Run eval reports', 'dist/core/commands/eval-command.js', subcommand(() => import('../core/commands/eval-command.js'), 'evalCommand', 'dist/core/commands/eval-command.js', 'run')),
@@ -170,13 +159,27 @@ export const COMMANDS = {
     bench: entry('beta', 'Run core trust-kernel benchmark budgets', 'dist/core/commands/bench-command.js', argsCommand(() => import('../core/commands/bench-command.js'), 'benchCommand', 'dist/core/commands/bench-command.js'))
 };
 export const TYPED_COMMANDS = COMMANDS;
+export const LEGACY_COMMAND_ALIASES = {
+    auth: 'codex-lb',
+    mad: 'mad-sks',
+    autoreview: 'auto-review',
+    dollars: 'dollar-commands',
+    '$': 'dollar-commands',
+    'ux-review': 'image-ux-review',
+    'visual-review': 'image-ux-review',
+    'ui-ux-review': 'image-ux-review',
+    cu: 'computer-use',
+    grok: 'xai',
+    memory: 'gc'
+};
 export const COMMAND_ALIASES = {
+    ...LEGACY_COMMAND_ALIASES,
     '--help': 'help',
     '-h': 'help',
     '--version': 'version',
     '-v': 'version',
-    '--mad': 'mad',
-    '--MAD': 'mad',
+    '--mad': 'mad-sks',
+    '--MAD': 'mad-sks',
     '--mad-sks': 'mad-sks',
     '--agent': 'agent',
     '--naruto': 'naruto'

package/dist/cli/router.js

@@ -5,17 +5,20 @@ export function isCommandName(value) {
 export function normalizeCommand(args = []) {
     const cmd = args[0];
     if (!cmd)
-        return { command: null, args: [...args] };
-    let mapped = cmd in COMMAND_ALIASES ? COMMAND_ALIASES[cmd] : cmd;
+        return { command: null, rawCommand: null, aliasTarget: null, args: [...args] };
+    const mapped = cmd in COMMAND_ALIASES ? COMMAND_ALIASES[cmd] : cmd;
     const rest = args.slice(1);
+    const command = isCommandName(mapped) ? mapped : null;
     return {
-        command: isCommandName(mapped) ? mapped : null,
+        command,
+        rawCommand: cmd,
+        aliasTarget: command && mapped !== cmd ? command : null,
         args: rest,
     };
 }
 export async function dispatch(args) {
     const argv = args ?? process.argv.slice(2);
-    const { command, args: rest } = normalizeCommand(argv);
+    const { command, rawCommand, args: rest } = normalizeCommand(argv);
     if (!command) {
         if (!argv.length) {
             const mod = await import('../commands/doctor.js');
@@ -36,6 +39,6 @@ export async function dispatch(args) {
     const mod = await entry.lazy();
     if (typeof mod.run !== 'function')
         throw new Error(`Command ${command} must export run(command, args)`);
-    return mod.run(command, rest);
+    return mod.run(rawCommand || command, rest);
 }
 //# sourceMappingURL=router.js.map

package/dist/commands/doctor.js

@@ -28,8 +28,16 @@ import { buildCodexAppHarnessMatrix } from '../core/codex-app/codex-app-harness-
 import { buildCodexNativeFeatureMatrix } from '../core/codex-native/codex-native-feature-broker.js';
 import { repairCodexNativeManagedAssets } from '../core/codex-native/codex-native-repair-transaction.js';
 import { runDoctorNativeCapabilityRepair } from '../core/doctor/doctor-native-capability-repair.js';
+import { runDoctorCommandAliasCleanup } from '../core/doctor/command-alias-cleanup.js';
+import { withSecretPreservationGuard } from '../core/config/config-migration-journal.js';
 export async function run(_command, args = []) {
+    const root = await projectRoot();
     const doctorFix = flag(args, '--fix');
+    if (doctorFix)
+        return withSecretPreservationGuard(root, 'doctor-fix', () => runDoctor(args, root, doctorFix));
+    return runDoctor(args, root, doctorFix);
+}
+async function runDoctor(args = [], root, doctorFix) {
     let setupRepair = null;
     const sksUpdate = doctorFix
         ? {
@@ -69,7 +77,23 @@ export async function run(_command, args = []) {
                 : await ensureGlobalCodexFastModeDuringInstall().catch((err) => ({ status: 'failed', error: err?.message || String(err) }))
         };
     }
-    const root = await projectRoot();
+    const commandAliasCleanup = await runDoctorCommandAliasCleanup({
+        root,
+        fix: doctorFix
+    }).catch((err) => ({
+        schema: 'sks.command-alias-cleanup.v1',
+        ok: false,
+        status: 'blocked',
+        root,
+        fix: doctorFix,
+        report_path: `${root}/.sneakoscope/reports/command-alias-cleanup.json`,
+        canonical_command_count: 0,
+        legacy_alias_count: 0,
+        aliases: [],
+        detected: { registered_alias_commands: [], catalog_alias_rows: [], missing_canonical_targets: [] },
+        actions: [],
+        blockers: [err?.message || String(err)]
+    }));
     const doctorNativeCapabilityRepair = await runDoctorNativeCapabilityRepair({
         root,
         fix: doctorFix || flag(args, '--repair-native-capabilities'),
@@ -287,7 +311,7 @@ export async function run(_command, args = []) {
     const runtimeReadiness = buildRuntimeReadiness(zellijReadiness, codexNativeFeatureMatrix);
     const result = {
         schema: 'sks.doctor-status.v1',
-        ok: ready.ready && (!sksUpdate || sksUpdate.ok !== false),
+        ok: ready.ready && (!sksUpdate || sksUpdate.ok !== false) && commandAliasCleanup.ok !== false,
         root,
         node: { ok: Number(process.versions.node.split('.')[0]) >= 20, version: process.version },
         codex,
@@ -305,6 +329,7 @@ export async function run(_command, args = []) {
         agent_role_config: agentRoleConfigRepair,
         zellij_readiness: zellijReadiness,
         codex_permission_profiles: permissionProfiles,
+        command_aliases: commandAliasCleanup,
         imagegen: {
             ok: imagegen.auth_readiness?.available_paths?.length > 0,
             auth_readiness: imagegen.auth_readiness || null,
@@ -323,7 +348,7 @@ export async function run(_command, args = []) {
         ready,
         sneakoscope: { ok: await exists(`${root}/.sneakoscope`) },
         package: { bytes: pkgBytes, human: formatBytes(pkgBytes) },
-        repair: { sks_update: sksUpdate, setup: setupRepair, codex_config: configRepair, migration_journal: migrationJournal, global_sks_installs: globalSksInstallCleanup, agent_role_config: agentRoleConfigRepair, zellij: zellijRepair, codex_native: codexNativeRepair, doctor_native_capability: doctorNativeCapabilityRepair }
+        repair: { sks_update: sksUpdate, setup: setupRepair, codex_config: configRepair, migration_journal: migrationJournal, global_sks_installs: globalSksInstallCleanup, agent_role_config: agentRoleConfigRepair, zellij: zellijRepair, codex_native: codexNativeRepair, doctor_native_capability: doctorNativeCapabilityRepair, command_aliases: commandAliasCleanup }
     };
     if (flag(args, '--json')) {
         printJson(result);
@@ -378,12 +403,24 @@ export async function run(_command, args = []) {
     console.log(`  app screenshot: ${nativeCapabilityStatus(nativeCapabilityRows, 'codex_app_screenshot', 'degraded')}`);
     console.log(`  app handoff: ${nativeCapabilityStatus(nativeCapabilityRows, 'app_handoff', 'unavailable')}`);
     console.log(`  image path exposure: ${nativeCapabilityStatus(nativeCapabilityRows, 'image_path_exposure', 'fallback')}`);
+    const nativeManualActions = uniqueNativeManualActions(nativeCapabilityRows);
+    if (nativeManualActions.length) {
+        console.log('  manual next actions:');
+        for (const action of nativeManualActions)
+            console.log(`    - ${action}`);
+    }
     console.log('SKS Skills:');
     console.log(`  core skills: ${doctorSkillStatus(doctorNativeCapabilityRepair?.core_skills)}`);
     console.log(`  duplicate project skills: ${doctorDedupeStatus(doctorNativeCapabilityRepair?.skill_dedupe)}`);
+    console.log('SKS Command Aliases:');
+    console.log(`  status: ${commandAliasCleanup.status || (commandAliasCleanup.ok ? 'clean' : 'blocked')}`);
+    console.log(`  canonical commands: ${commandAliasCleanup.canonical_command_count ?? 0}`);
+    console.log(`  compatibility aliases: ${commandAliasCleanup.legacy_alias_count ?? 0}`);
+    if (commandAliasCleanup.report_path)
+        console.log(`  report: ${commandAliasCleanup.report_path}`);
     console.log('Secret preservation:');
     console.log(`  Supabase keys: ${doctorNativeCapabilityRepair?.ok === false && String((doctorNativeCapabilityRepair?.blockers || []).join(' ')).includes('secret_preservation_failed') ? 'blocked' : 'preserved'}`);
-    console.log('  secret values: redacted');
+    console.log('  raw secret values: never recorded');
     console.log(`  migration journal: ${doctorNativeCapabilityRepair?.secret_preservation_guard || '.sneakoscope/reports/secret-preservation-guard.json'}`);
     console.log('Codex App Harness:');
     console.log(`  plugins: ${codexAppHarnessMatrix.app_features?.plugin_json ? 'ok' : 'degraded'}`);
@@ -515,6 +552,13 @@ function nativeCapabilityStatus(rows, id, fallback) {
         return fallback;
     if (row.after === 'verified' || row.before === 'verified')
         return 'verified';
+    if (id === 'image_path_exposure') {
+        if (row.before === 'degraded' || row.after === 'degraded' || row.repairability === 'doctor-fix')
+            return 'fallback';
+        return fallback;
+    }
+    if (id === 'app_handoff')
+        return 'unavailable';
     if (row.repairability === 'manual-required')
         return 'manual_required';
     if (row.before === 'degraded' || row.after === 'degraded')
@@ -525,6 +569,12 @@ function nativeCapabilityStatus(rows, id, fallback) {
         return 'unavailable';
     return fallback;
 }
+function uniqueNativeManualActions(rows) {
+    return [...new Set(rows
+            .filter((row) => row?.repairability === 'manual-required' && row?.after !== 'verified')
+            .flatMap((row) => Array.isArray(row.repair_actions) ? row.repair_actions : [])
+            .filter((action) => typeof action === 'string' && action.trim()))];
+}
 function doctorSkillStatus(coreSkills) {
     if (!coreSkills)
         return 'drift_detected';

package/dist/core/codex-app/codex-skill-sync.js

@@ -1,11 +1,12 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import os from 'node:os';
-import { ensureDir, nowIso, writeJsonAtomic } from '../fsx.js';
+import { ensureDir, nowIso, readJson, writeJsonAtomic } from '../fsx.js';
 import { buildSksCoreSkillManifest } from '../codex-native/core-skill-manifest.js';
 import { syncCoreSkillsIntegrity } from '../codex-native/core-skill-integrity.js';
 import { dedupeProjectSkills } from '../codex-native/project-skill-dedupe.js';
 const EXTERNAL_ROUTE_RESERVED = new Set(['ulw-loop', 'ulw-plan', 'start-work']);
+const SKILL_SYNC_LOCK_STALE_AFTER_MS = 30000;
 export async function syncCodexSksSkills(input) {
     const root = path.resolve(input.root);
     const skillsRoot = input.skillsRoot || path.join(process.env.CODEX_HOME || path.join(os.homedir(), '.codex'), 'skills');
@@ -71,6 +72,8 @@ export async function withSkillSyncLock(root, fn) {
             const code = err && typeof err === 'object' && 'code' in err ? String(err.code) : '';
             if (code !== 'EEXIST')
                 throw err;
+            if (await recoverStaleSkillSyncLock(lockPath))
+                continue;
             if (Date.now() - started > 30000)
                 throw new Error(`Timed out waiting for skill sync lock: ${lockPath}`);
             await new Promise((resolve) => setTimeout(resolve, 25));
@@ -80,7 +83,8 @@ export async function withSkillSyncLock(root, fn) {
         await writeJsonAtomic(path.join(lockPath, 'owner.json'), {
             schema: 'sks.skill-sync-lock.v1',
             pid: process.pid,
-            acquired_at: nowIso()
+            acquired_at: nowIso(),
+            stale_after_ms: SKILL_SYNC_LOCK_STALE_AFTER_MS
         }).catch(() => undefined);
         return await fn();
     }
@@ -88,6 +92,37 @@ export async function withSkillSyncLock(root, fn) {
         await fs.rm(lockPath, { recursive: true, force: true }).catch(() => undefined);
     }
 }
+async function recoverStaleSkillSyncLock(lockPath) {
+    const ownerPath = path.join(lockPath, 'owner.json');
+    const stat = await fs.stat(lockPath).catch(() => null);
+    const owner = await readJson(ownerPath, null).catch(() => null);
+    const staleAfterMs = Number(owner?.stale_after_ms || SKILL_SYNC_LOCK_STALE_AFTER_MS);
+    const acquiredAt = owner?.acquired_at ? Date.parse(owner.acquired_at) : NaN;
+    const ageMs = Number.isFinite(acquiredAt) ? Date.now() - acquiredAt : stat ? Date.now() - stat.mtimeMs : 0;
+    if (owner?.schema === 'sks.skill-sync-lock.v1' && Number.isFinite(owner.pid)) {
+        if (ageMs <= staleAfterMs || pidAlive(Number(owner.pid)))
+            return false;
+        await fs.rm(lockPath, { recursive: true, force: true }).catch(() => undefined);
+        return true;
+    }
+    if (stat && Date.now() - stat.mtimeMs > staleAfterMs) {
+        await fs.rm(lockPath, { recursive: true, force: true }).catch(() => undefined);
+        return true;
+    }
+    return false;
+}
+function pidAlive(pid) {
+    if (!Number.isFinite(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        const code = err && typeof err === 'object' && 'code' in err ? String(err.code) : '';
+        return code === 'EPERM';
+    }
+}
 async function listSkillNames(root) {
     const rows = await fs.readdir(root, { withFileTypes: true }).catch(() => []);
     return rows.filter((row) => row.isDirectory()).map((row) => row.name).sort();

package/dist/core/codex-native/core-skill-integrity.js

@@ -1,7 +1,7 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import { ensureDir, nowIso, readText, sha256, writeJsonAtomic, writeTextAtomic } from '../fsx.js';
-import { buildSksCoreSkillManifest, isSksManagedCoreSkillContent, renderCoreSkillTemplate } from './core-skill-manifest.js';
+import { CORE_SKILL_TEMPLATE_VERSION, buildSksCoreSkillManifest, isSksManagedCoreSkillContent, renderCoreSkillTemplate } from './core-skill-manifest.js';
 import { canonicalSkillName } from './skill-name-canonicalizer.js';
 export async function syncCoreSkillsIntegrity(input) {
     const root = path.resolve(input.root);
@@ -69,7 +69,12 @@ export async function syncCoreSkillsIntegrity(input) {
         root,
         apply,
         skills_root: skillsRoot,
+        template_version: CORE_SKILL_TEMPLATE_VERSION,
         manifest_sha256: sha256(JSON.stringify(manifest.skills.map((skill) => [skill.canonical_name, skill.content_sha256]))),
+        drift_detected_count: rows.filter((row) => row.action === 'restore-corrupted-managed-copy' || row.action === 'skip-user-authored').length,
+        restored_count: restored.length,
+        installed_count: installed.length,
+        user_collision_count: skippedUserAuthored.length,
         rows,
         installed,
         restored,

package/dist/core/codex-native/core-skill-manifest.js

@@ -1,6 +1,6 @@
 import { PACKAGE_VERSION, nowIso, sha256 } from '../fsx.js';
 import { canonicalSkillName } from './skill-name-canonicalizer.js';
-export const CORE_SKILL_TEMPLATE_VERSION = '3.1.8-core-skill-template.v1';
+export const CORE_SKILL_TEMPLATE_VERSION = 'sks-core-skill-template.v1';
 export const CORE_SKILL_MANAGED_BEGIN = '<!-- BEGIN SKS IMMUTABLE CORE SKILL -->';
 export const CORE_SKILL_MANAGED_END = '<!-- END SKS IMMUTABLE CORE SKILL -->';
 const CORE_SKILL_DEFINITIONS = [

package/dist/core/codex-native/native-capability-postcheck.js

@@ -1,22 +1,13 @@
+import fs from 'node:fs/promises';
 import path from 'node:path';
-import { writeJsonAtomic } from '../fsx.js';
+import { ensureDir, readJson, writeJsonAtomic } from '../fsx.js';
 import { buildNativeCapabilityRepairMatrix } from './native-capability-repair-matrix.js';
 export async function postcheckNativeCapabilities(input) {
     const root = path.resolve(input.root);
-    const matrix = input.matrix || await buildNativeCapabilityRepairMatrix({ root, fixture: input.fixture || false, reportPath: null });
-    const capabilities = matrix.capabilities.map((state) => {
-        const verifiedAfterRepair = state.repairability === 'auto' || state.repairability === 'doctor-fix';
-        if (state.id === 'computer_use' && process.env.SKS_COMPUTER_USE_CAPABILITY !== 'verified') {
-            return { ...state, after: 'unknown', blockers: ['computer_use_os_permission_or_capability_unknown'] };
-        }
-        if (state.id === 'chrome_web_review' && process.env.SKS_CHROME_EXTENSION_READY !== '1' && input.fixture !== 'all-repairable') {
-            return { ...state, after: 'unknown', blockers: ['codex_chrome_extension_readiness_not_verified'] };
-        }
-        if (state.blockers.length === 0 || verifiedAfterRepair)
-            return { ...state, after: state.repairability === 'manual-required' ? 'unknown' : 'verified', blockers: state.repairability === 'manual-required' ? state.blockers : [] };
-        return { ...state, after: 'blocked' };
-    });
-    const blockers = capabilities.flatMap((state) => state.after === 'verified' ? [] : state.blockers);
+    const fixture = input.fixture || false;
+    const matrix = input.matrix || await buildNativeCapabilityRepairMatrix({ root, fixture, reportPath: null });
+    const capabilities = await Promise.all(matrix.capabilities.map((state) => postcheckCapability(root, state, fixture)));
+    const blockers = capabilities.flatMap((state) => state.after === 'verified' || state.after === 'degraded' ? [] : state.blockers);
     const checked = {
         ...matrix,
         generated_at: new Date().toISOString(),
@@ -32,4 +23,141 @@ export async function postcheckNativeCapabilities(input) {
         await writeJsonAtomic(reportPath, checked).catch(() => undefined);
     return checked;
 }
+async function postcheckCapability(root, state, fixture) {
+    if (state.id === 'image_generation')
+        return postcheckImageGeneration(state, fixture);
+    if (state.id === 'image_followup_edit')
+        return postcheckImageFollowupEdit(root, state);
+    if (state.id === 'computer_use')
+        return postcheckComputerUse(state, fixture);
+    if (state.id === 'chrome_web_review')
+        return postcheckChromeWebReview(state, fixture);
+    if (state.id === 'codex_app_screenshot')
+        return postcheckAppScreenshot(root, state);
+    if (state.id === 'app_handoff')
+        return postcheckAppHandoff(state, fixture);
+    if (state.id === 'image_path_exposure')
+        return postcheckImagePathExposure(root, state, fixture);
+    if (state.id === 'saved_artifact_path_contract')
+        return postcheckSavedArtifactPathContract(root, state);
+    return { ...state, after: 'blocked', blockers: [...state.blockers, `unknown_capability:${state.id}`] };
+}
+function postcheckImageGeneration(state, fixture) {
+    if (fixture === 'all-repairable' || state.before === 'verified')
+        return verified(state);
+    return {
+        ...state,
+        after: 'unknown',
+        blockers: ['imagegen_auth_or_codex_app_builtin_missing'],
+        warnings: [...new Set([...state.warnings, 'image_generation_not_verified_without_real_capability'])]
+    };
+}
+async function postcheckImageFollowupEdit(root, state) {
+    const contract = await validateSavedArtifactPathContract(root);
+    if (!contract.ok)
+        return { ...state, after: 'blocked', blockers: contract.blockers };
+    const sample = path.join(contract.imageArtifacts, 'postcheck-followup-sample.txt');
+    if (!(await writeReadSample(sample)))
+        return { ...state, after: 'blocked', blockers: ['image_followup_sample_artifact_unwritable'] };
+    return verified(state);
+}
+function postcheckComputerUse(state, _fixture) {
+    if (process.env.SKS_COMPUTER_USE_CAPABILITY === 'verified')
+        return verified(state);
+    return {
+        ...state,
+        after: 'unknown',
+        blockers: ['computer_use_os_permission_or_capability_unknown'],
+        warnings: [...new Set([...state.warnings, 'manual_os_permission_required'])]
+    };
+}
+function postcheckChromeWebReview(state, fixture) {
+    if (fixture === 'all-repairable' || process.env.SKS_CHROME_EXTENSION_READY === '1')
+        return verified(state);
+    return {
+        ...state,
+        after: 'unknown',
+        blockers: ['codex_chrome_extension_readiness_not_verified'],
+        warnings: [...new Set([...state.warnings, 'manual_chrome_extension_setup_required'])]
+    };
+}
+async function postcheckAppScreenshot(root, state) {
+    const dir = path.join(root, '.sneakoscope', 'app-screenshots');
+    const registry = path.join(dir, 'screenshot-registry.json');
+    if (!(await writeReadSample(path.join(dir, 'postcheck-screenshot-sample.txt')))) {
+        return { ...state, after: 'blocked', blockers: ['app_screenshot_directory_unwritable'] };
+    }
+    await writeJsonAtomic(registry, { schema: 'sks.app-screenshot-registry.v1', generated_at: new Date().toISOString(), screenshots: [] }).catch(() => undefined);
+    const json = await readJson(registry, {}).catch(() => ({}));
+    if (json.schema !== 'sks.app-screenshot-registry.v1')
+        return { ...state, after: 'blocked', blockers: ['app_screenshot_registry_invalid'] };
+    return verified(state);
+}
+function postcheckAppHandoff(state, fixture) {
+    if (fixture === 'all-repairable' || state.before === 'verified')
+        return verified(state);
+    return {
+        ...state,
+        after: 'unknown',
+        blockers: ['codex_app_handoff_not_verified'],
+        warnings: [...new Set([...state.warnings, 'manual_app_handoff_approval_required'])]
+    };
+}
+async function postcheckImagePathExposure(root, state, fixture) {
+    if (fixture === 'all-repairable' || state.before === 'verified')
+        return verified(state);
+    const contract = await validateSavedArtifactPathContract(root);
+    if (contract.ok) {
+        return {
+            ...state,
+            after: 'degraded',
+            blockers: [],
+            warnings: [...new Set([...state.warnings, 'using_saved_artifact_path_contract_fallback'])]
+        };
+    }
+    return { ...state, after: 'blocked', blockers: ['image_path_exposure_missing_without_fallback_contract', ...contract.blockers] };
+}
+async function postcheckSavedArtifactPathContract(root, state) {
+    const contract = await validateSavedArtifactPathContract(root);
+    if (!contract.ok)
+        return { ...state, after: 'blocked', blockers: contract.blockers };
+    if (!(await writeReadSample(path.join(contract.imageArtifacts, 'postcheck-contract-image.txt'))))
+        return { ...state, after: 'blocked', blockers: ['image_artifacts_directory_unwritable'] };
+    if (!(await writeReadSample(path.join(contract.appScreenshots, 'postcheck-contract-screenshot.txt'))))
+        return { ...state, after: 'blocked', blockers: ['app_screenshots_directory_unwritable'] };
+    return verified(state);
+}
+function verified(state) {
+    return { ...state, after: 'verified', blockers: [] };
+}
+async function validateSavedArtifactPathContract(root) {
+    const contractPath = path.join(root, '.sneakoscope', 'reports', 'saved-artifact-path-contract.json');
+    const contract = await readJson(contractPath, null).catch(() => null);
+    const imageArtifacts = String(contract?.image_artifacts || path.join(root, '.sneakoscope', 'image-artifacts'));
+    const appScreenshots = String(contract?.app_screenshots || path.join(root, '.sneakoscope', 'app-screenshots'));
+    const blockers = [];
+    if (contract?.schema !== 'sks.saved-artifact-path-contract.v1')
+        blockers.push('saved_artifact_path_contract_schema_invalid');
+    for (const dir of [imageArtifacts, appScreenshots]) {
+        try {
+            await ensureDir(dir);
+            await fs.access(dir);
+        }
+        catch {
+            blockers.push(`directory_unwritable:${path.basename(dir)}`);
+        }
+    }
+    return { ok: blockers.length === 0, imageArtifacts, appScreenshots, blockers };
+}
+async function writeReadSample(file) {
+    try {
+        await ensureDir(path.dirname(file));
+        await fs.writeFile(file, 'sks-native-capability-postcheck\n', 'utf8');
+        const text = await fs.readFile(file, 'utf8');
+        return text === 'sks-native-capability-postcheck\n';
+    }
+    catch {
+        return false;
+    }
+}
 //# sourceMappingURL=native-capability-postcheck.js.map

package/dist/core/codex-native/native-capability-repair-matrix.js

@@ -109,7 +109,7 @@ async function stateForCapability(root, id, imageCapability, nativeFeatureMatrix
             warnings: envVerified ? [] : ['manual_os_permission_required']
         };
     }
-    const chromeReady = process.env.SKS_CHROME_EXTENSION_READY === '1' || featureOk(nativeFeatureMatrix, 'plugin_json');
+    const chromeReady = process.env.SKS_CHROME_EXTENSION_READY === '1';
     return {
         id,
         before: chromeReady ? 'verified' : 'unknown',