sneakoscope 1.18.2 → 1.18.4

package/README.md

@@ -10,7 +10,7 @@ SKS does not try to clone every other harness. It focuses on one thing: making C
 
 ## Current Release
 
-SKS **1.18.2** completes the Dynamic Worker Pool runtime: `agents=5` means five target active worker slots, while `--work-items N` controls the route work queue. Pending work backfills empty slots immediately, tmux lanes persist as worker-slot UI until scheduler drain, follow-up work items are schema-bound, and Agent/Team/Research/QA route blackboxes prove replenishment with generation, terminal, Source Intelligence, and Goal evidence.
+SKS **1.18.4** closes the runtime-truth gap left after the route-truth Dynamic Worker Pool work: real tmux mode now requires physical pane evidence from `tmux list-panes`, `tmux capture-pane`, pane-id reconciliation, and drain-close checks; real Codex dynamic smoke is opt-in through `SKS_TEST_REAL_DYNAMIC_AGENTS=1`; `sks agent close/cleanup` now writes executor proof for stale process, tmux, temp, and lock cleanup; and the task graph carries an intelligent work graph score, test ownership, critical path, and integration bottleneck artifacts. Fake fixture evidence remains useful for hermetic release gates, but it is explicitly separated from real runtime proof.
 
 ```bash
 sks mad-sks plan --target-root <path> --json
@@ -23,7 +23,13 @@ sks agent run "release review" --agents 8 --work-items 16 --concurrency 4 --mock
 npm run source-intelligence:all-modes
 npm run agent:background-terminals
 npm run agent:tmux-lane-no-flicker
+npm run agent:cleanup-executor
+npm run agent:intelligent-work-graph
+npm run proof:fake-vs-real-policy
+npm run route:blackbox-realism
+npm run release:real-check
 npm run agent:backfill-route-blackbox
+npm run team:actual-route-backfill
 npm run release:readiness
 ```
 
@@ -57,6 +63,12 @@ Detailed release history lives in [CHANGELOG.md](CHANGELOG.md). Current release
 - Main no-Scout / worker Scout policy: [docs/main-no-scout-worker-scout-policy.md](docs/main-no-scout-worker-scout-policy.md)
 - Agent terminal lanes: [docs/agent-terminal-lanes.md](docs/agent-terminal-lanes.md)
 - tmux right-lane cockpit: [docs/tmux-right-lane-cockpit.md](docs/tmux-right-lane-cockpit.md)
+- Real tmux pane proof: [docs/real-tmux-pane-proof.md](docs/real-tmux-pane-proof.md)
+- Real Codex dynamic smoke: [docs/real-codex-dynamic-smoke.md](docs/real-codex-dynamic-smoke.md)
+- Agent cleanup executor: [docs/agent-cleanup-executor.md](docs/agent-cleanup-executor.md)
+- Intelligent work graph: [docs/intelligent-work-graph.md](docs/intelligent-work-graph.md)
+- Fake vs real proof policy: [docs/fake-vs-real-proof-policy.md](docs/fake-vs-real-proof-policy.md)
+- Migration 1.18.3 to 1.18.4: [docs/migration-1.18.3-to-1.18.4.md](docs/migration-1.18.3-to-1.18.4.md)
 - Codex official Goal mode: [docs/codex-official-goal-mode.md](docs/codex-official-goal-mode.md)
 - Release parallel full coverage: [docs/release-parallel-full-coverage.md](docs/release-parallel-full-coverage.md)
 - Priority closure P0-P4: [docs/priority-closure-p0-p4.md](docs/priority-closure-p0-p4.md)
@@ -613,7 +625,7 @@ npm run release:check
 npm run publish:dry
 ```
 
-`release:check` runs the 1.18.2 dynamic scheduler closure DAG, writes a source digest stamp under `.sneakoscope/reports/`, then refreshes release readiness so publish commands can verify the same stamp. The DAG preserves the 1.18 baseline gates and adds task graph expansion, schema-bound follow-up work, Agent/Team/Research/QA route backfill blackboxes, scheduler proof hardening, persistent tmux lane persistence, no-flicker lane proof, session generation, terminal generation, dynamic cockpit, Source Intelligence propagation, and Goal mode propagation checks. Broader live or historical gates remain explicit scripts such as `release:real-check`. Generate the human-readable registry with `sks features inventory --write-docs`. Plain `npm publish` uses the `latest` dist-tag. npm's `prepublishOnly` verifies the fresh release stamp instead of rerunning the full gate, and `prepack` only rebuilds `dist`; publish no longer repeats the expensive release suite during packaging. `npm run publish:dry` remains the explicit dry-run helper.
+`release:check` runs the 1.18.3 route-truth dynamic scheduler closure DAG, writes a source digest stamp under `.sneakoscope/reports/`, then refreshes release readiness so publish commands can verify the same stamp. The DAG preserves the 1.18 baseline gates and adds task graph expansion, schema-bound follow-up work, actual Agent/Team/Research/QA route backfill blackboxes, scheduler proof hardening, persistent tmux lane supervisor integration, no-flicker lane proof, session generation, terminal generation, dynamic cockpit, Source Intelligence propagation, and Goal mode propagation checks. Broader live or historical gates remain explicit scripts such as `release:real-check`. Generate the human-readable registry with `sks features inventory --write-docs`. Plain `npm publish` uses the `latest` dist-tag. npm's `prepublishOnly` verifies the fresh release stamp instead of rerunning the full gate, and `prepack` only rebuilds `dist`; publish no longer repeats the expensive release suite during packaging. `npm run publish:dry` remains the explicit dry-run helper.
 
 Version bumps are manual. Run `sks versioning bump` only when preparing release metadata; SKS will not create `.git/hooks/pre-commit` or auto-bump during ordinary commits.
 

package/crates/sks-core/Cargo.lock

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

package/crates/sks-core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "sks-core"
-version = "1.18.2"
+version = "1.18.4"
 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 1.18.2"),
+        Some("--version") => println!("sks-rs 1.18.4"),
         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": "1.18.2",
-  "source_digest": "83db107971a9e8bec6aaca8f43bf8b49d936e5fc778ebd62121dea9b7fc228f5",
-  "source_file_count": 1349,
-  "built_at_source_time": 1779732183819
+  "package_version": "1.18.4",
+  "source_digest": "33109bbaf2af23979db84be40e35c9d47e2b35618270ab31547bfda9b59f590f",
+  "source_file_count": 1405,
+  "built_at_source_time": 1779777408842
 }

package/dist/bin/sks.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-const FAST_PACKAGE_VERSION = '1.18.2';
+const FAST_PACKAGE_VERSION = '1.18.3';
 const args = process.argv.slice(2);
 try {
     if (args[0] === '--version' || args[0] === '-v' || args[0] === 'version') {

package/dist/build-manifest.json

@@ -1,16 +1,16 @@
 {
   "schema": "sks.dist-build.v2",
-  "version": "1.18.2",
-  "package_version": "1.18.2",
+  "version": "1.18.4",
+  "package_version": "1.18.4",
   "typescript": true,
   "mjs_runtime_files": 0,
-  "compiled_file_count": 864,
-  "compiled_js_count": 432,
-  "compiled_dts_count": 432,
-  "source_digest": "83db107971a9e8bec6aaca8f43bf8b49d936e5fc778ebd62121dea9b7fc228f5",
-  "source_file_count": 1349,
-  "source_files_hash": "fb0fc5d3cacbb13d3231fcf9d0566e1bad998e7bc8aeea7c7e4f10049e433c11",
-  "source_list_hash": "fb0fc5d3cacbb13d3231fcf9d0566e1bad998e7bc8aeea7c7e4f10049e433c11",
+  "compiled_file_count": 872,
+  "compiled_js_count": 436,
+  "compiled_dts_count": 436,
+  "source_digest": "33109bbaf2af23979db84be40e35c9d47e2b35618270ab31547bfda9b59f590f",
+  "source_file_count": 1405,
+  "source_files_hash": "eef20a281a31010636ae8b25a6e03acd3ac4564fb9870beed34653150250e3fe",
+  "source_list_hash": "eef20a281a31010636ae8b25a6e03acd3ac4564fb9870beed34653150250e3fe",
   "src_mjs_runtime_files": 0,
   "dist_stamp_schema": "sks.dist-build-stamp.v1",
   "files": [
@@ -186,6 +186,8 @@
     "commands/wiki.js",
     "core/agents/agent-central-ledger.d.ts",
     "core/agents/agent-central-ledger.js",
+    "core/agents/agent-cleanup-executor.d.ts",
+    "core/agents/agent-cleanup-executor.js",
     "core/agents/agent-cleanup.d.ts",
     "core/agents/agent-cleanup.js",
     "core/agents/agent-codex-cockpit.d.ts",
@@ -262,12 +264,16 @@
     "core/agents/agent-worker-slot.js",
     "core/agents/agent-wrongness.d.ts",
     "core/agents/agent-wrongness.js",
+    "core/agents/intelligent-work-graph.d.ts",
+    "core/agents/intelligent-work-graph.js",
     "core/agents/route-collaboration-ledger.d.ts",
     "core/agents/route-collaboration-ledger.js",
     "core/agents/scout-policy.d.ts",
     "core/agents/scout-policy.js",
     "core/agents/tmux-lane-supervisor.d.ts",
     "core/agents/tmux-lane-supervisor.js",
+    "core/agents/tmux-physical-proof.d.ts",
+    "core/agents/tmux-physical-proof.js",
     "core/agents/tmux-right-lane-cockpit.d.ts",
     "core/agents/tmux-right-lane-cockpit.js",
     "core/agents/work-partition/conflict-detector.d.ts",
@@ -713,6 +719,8 @@
     "core/proof/command-ledger.js",
     "core/proof/evidence-collector.d.ts",
     "core/proof/evidence-collector.js",
+    "core/proof/fake-real-proof-policy.d.ts",
+    "core/proof/fake-real-proof-policy.js",
     "core/proof/file-change-ledger.d.ts",
     "core/proof/file-change-ledger.js",
     "core/proof/proof-reader.d.ts",

package/dist/cli/feature-commands.js

@@ -171,18 +171,29 @@ export async function hooksCommand(sub = 'explain', args = []) {
                 return;
             }
         }
-        const report = await installManagedCodexHooks(root);
+        const projectReport = await installManagedCodexHooks(root);
+        const userReport = await installManagedCodexHooks(root, {
+            requirementsPath: path.join(os.homedir(), '.codex', 'requirements.toml'),
+            managedDir: path.join(os.homedir(), '.codex', 'managed-hooks')
+        });
+        const actual = await codexHookTrustDoctor(root, { actual: true });
         const result = {
-            ...report,
             schema: 'sks.codex-hooks-repair.v1',
+            ok: Boolean(projectReport.ok && userReport.ok && actual.ok),
             mode: 'managed',
+            root,
+            project_install: projectReport,
+            user_install: userReport,
+            actual_trust: actual.trust,
+            managed_dirs: actual.managed_dirs || [],
+            blockers: actual.blockers || [],
             next_command: 'sks hooks trust-doctor --actual --json',
-            actions: ['requirements_toml_managed_install_default']
+            actions: ['project_requirements_toml_managed_install', 'user_requirements_toml_managed_install']
         };
         if (flag(args, '--json'))
             return console.log(JSON.stringify(result, null, 2));
-        console.log(`Hooks managed repair: ${report.ok ? 'ok' : 'blocked'}`);
-        if (!report.ok)
+        console.log(`Hooks managed repair: ${result.ok ? 'ok' : 'blocked'}`);
+        if (!result.ok)
             process.exitCode = 1;
         return;
     }

package/dist/commands/image-ux-review.d.ts

@@ -385,6 +385,8 @@ export declare function run(command: any, args?: any): Promise<void | {
             ok: boolean;
             mission_id: any;
             route: string;
+            route_command: string;
+            route_blackbox_kind: string;
             backend: "tmux" | "fake" | "process" | "codex-exec";
             ledger_root: string;
             roster: {
@@ -436,12 +438,11 @@ export declare function run(command: any, args?: any): Promise<void | {
                 lease_count: number;
                 blockers: string[];
             };
-            task_graph: {
-                target_active_slots: number;
-                total_work_items: number;
-                generated_from_route: string;
-                work_items_exceed_active_slots: boolean;
-            };
+            task_graph: any;
+            requested_work_items: number;
+            actual_total_work_items: any;
+            target_active_slots: number;
+            minimum_work_items: number;
             scheduler: {
                 schema: string;
                 ok: boolean;
@@ -572,6 +573,26 @@ export declare function run(command: any, args?: any): Promise<void | {
                         pane_survival_checked: boolean;
                         unexpected_close_count: number;
                         lane_count: number;
+                        physical_tmux_verified: boolean;
+                        physical_proof_status: any;
+                        list_panes_artifact: any;
+                        capture_pane_artifacts: any;
+                    };
+                    cleanup_executor: {
+                        status: string;
+                        proof: string | null;
+                        stale_processes_killed: any;
+                        stale_tmux_panes_closed: any;
+                        orphan_temp_dirs_removed: any;
+                        stale_locks_removed: any;
+                        skipped_active_sessions: any;
+                    };
+                    intelligent_work_graph: {
+                        status: string;
+                        score: any;
+                        test_ownership: string;
+                        critical_path: string;
+                        integration_bottlenecks: string;
                     };
                     output_schema_ok: boolean;
                     output_tail_report: string;
@@ -600,6 +621,10 @@ export declare function run(command: any, args?: any): Promise<void | {
                 generated_at: string;
                 mission_id: string;
                 backend: string;
+                route: string;
+                route_command: string;
+                route_blackbox_kind: string;
+                real_route_command_used: boolean;
                 real_parallel_claim: boolean;
                 fake_backend_disclaimer: string | null;
                 agent_count: any;
@@ -615,26 +640,61 @@ export declare function run(command: any, args?: any): Promise<void | {
                 session_generation_count: number;
                 all_generations_closed: boolean;
                 scheduler_state: string;
-                target_active_slots: any;
+                target_active_slots: number;
+                requested_work_items: number;
+                actual_total_work_items: number;
+                minimum_work_items: number;
+                task_graph_total_work_items: number;
+                work_queue_total_work_items: number;
+                scheduler_total_work_items: number;
+                task_graph_matches_cli_options: boolean;
+                work_queue_matches_task_graph: boolean;
+                scheduler_matches_work_queue: boolean;
                 max_observed_active_slots: any;
                 pending_queue_drained: boolean;
                 backfill_count: any;
                 expected_backfill_count: any;
+                backfill_expected_for_route: boolean;
                 slot_count: any;
                 generation_count: number;
                 all_slots_closed_after_drain: boolean;
                 generated_work_item_count: any;
                 source_intelligence_generation_refs_ok: boolean;
                 goal_mode_generation_refs_ok: boolean;
+                task_graph_source_refs_ok: any;
+                task_graph_goal_refs_ok: any;
+                work_queue_source_refs_ok: any;
+                work_queue_goal_refs_ok: any;
                 tmux_lane_manifest: string;
                 tmux_lane_manifest_ok: boolean;
                 tmux_lane_supervisor: string;
+                lane_supervisor_integrated: boolean;
                 tmux_lane_no_flicker_verified: boolean;
                 tmux_lane_survival_checked: boolean;
                 tmux_lane_unexpected_close_count: number;
                 tmux_lane_auto_reopen_count: number;
                 tmux_pane_launch_ledger: string;
                 tmux_pane_launch_count: number;
+                physical_tmux_verified: boolean;
+                tmux_physical_proof: string;
+                tmux_list_panes_artifact: any;
+                tmux_capture_pane_artifacts: any;
+                tmux_pane_id_reconciled: boolean;
+                real_truth_summary: {
+                    fake_backend: boolean;
+                    physical_tmux_verified: boolean;
+                    real_tmux_status: any;
+                    cleanup_executor_status: string;
+                    work_graph_quality_score: number;
+                    fake_vs_real_policy: string;
+                };
+                intelligent_work_graph: string;
+                test_ownership_map: string;
+                critical_path: string;
+                integration_bottlenecks: string;
+                work_graph_quality_score: number;
+                work_graph_quality_partial: boolean;
+                terminal_reports_match_generations: boolean;
                 ledger_hash_chain_ok: boolean;
                 no_overlap_ok: boolean;
                 consensus_ok: boolean;

package/dist/commands/ppt.d.ts

@@ -237,6 +237,8 @@ export declare function run(command: any, args?: any): Promise<void | {
             ok: boolean;
             mission_id: any;
             route: string;
+            route_command: string;
+            route_blackbox_kind: string;
             backend: "tmux" | "fake" | "process" | "codex-exec";
             ledger_root: string;
             roster: {
@@ -288,12 +290,11 @@ export declare function run(command: any, args?: any): Promise<void | {
                 lease_count: number;
                 blockers: string[];
             };
-            task_graph: {
-                target_active_slots: number;
-                total_work_items: number;
-                generated_from_route: string;
-                work_items_exceed_active_slots: boolean;
-            };
+            task_graph: any;
+            requested_work_items: number;
+            actual_total_work_items: any;
+            target_active_slots: number;
+            minimum_work_items: number;
             scheduler: {
                 schema: string;
                 ok: boolean;
@@ -424,6 +425,26 @@ export declare function run(command: any, args?: any): Promise<void | {
                         pane_survival_checked: boolean;
                         unexpected_close_count: number;
                         lane_count: number;
+                        physical_tmux_verified: boolean;
+                        physical_proof_status: any;
+                        list_panes_artifact: any;
+                        capture_pane_artifacts: any;
+                    };
+                    cleanup_executor: {
+                        status: string;
+                        proof: string | null;
+                        stale_processes_killed: any;
+                        stale_tmux_panes_closed: any;
+                        orphan_temp_dirs_removed: any;
+                        stale_locks_removed: any;
+                        skipped_active_sessions: any;
+                    };
+                    intelligent_work_graph: {
+                        status: string;
+                        score: any;
+                        test_ownership: string;
+                        critical_path: string;
+                        integration_bottlenecks: string;
                     };
                     output_schema_ok: boolean;
                     output_tail_report: string;
@@ -452,6 +473,10 @@ export declare function run(command: any, args?: any): Promise<void | {
                 generated_at: string;
                 mission_id: string;
                 backend: string;
+                route: string;
+                route_command: string;
+                route_blackbox_kind: string;
+                real_route_command_used: boolean;
                 real_parallel_claim: boolean;
                 fake_backend_disclaimer: string | null;
                 agent_count: any;
@@ -467,26 +492,61 @@ export declare function run(command: any, args?: any): Promise<void | {
                 session_generation_count: number;
                 all_generations_closed: boolean;
                 scheduler_state: string;
-                target_active_slots: any;
+                target_active_slots: number;
+                requested_work_items: number;
+                actual_total_work_items: number;
+                minimum_work_items: number;
+                task_graph_total_work_items: number;
+                work_queue_total_work_items: number;
+                scheduler_total_work_items: number;
+                task_graph_matches_cli_options: boolean;
+                work_queue_matches_task_graph: boolean;
+                scheduler_matches_work_queue: boolean;
                 max_observed_active_slots: any;
                 pending_queue_drained: boolean;
                 backfill_count: any;
                 expected_backfill_count: any;
+                backfill_expected_for_route: boolean;
                 slot_count: any;
                 generation_count: number;
                 all_slots_closed_after_drain: boolean;
                 generated_work_item_count: any;
                 source_intelligence_generation_refs_ok: boolean;
                 goal_mode_generation_refs_ok: boolean;
+                task_graph_source_refs_ok: any;
+                task_graph_goal_refs_ok: any;
+                work_queue_source_refs_ok: any;
+                work_queue_goal_refs_ok: any;
                 tmux_lane_manifest: string;
                 tmux_lane_manifest_ok: boolean;
                 tmux_lane_supervisor: string;
+                lane_supervisor_integrated: boolean;
                 tmux_lane_no_flicker_verified: boolean;
                 tmux_lane_survival_checked: boolean;
                 tmux_lane_unexpected_close_count: number;
                 tmux_lane_auto_reopen_count: number;
                 tmux_pane_launch_ledger: string;
                 tmux_pane_launch_count: number;
+                physical_tmux_verified: boolean;
+                tmux_physical_proof: string;
+                tmux_list_panes_artifact: any;
+                tmux_capture_pane_artifacts: any;
+                tmux_pane_id_reconciled: boolean;
+                real_truth_summary: {
+                    fake_backend: boolean;
+                    physical_tmux_verified: boolean;
+                    real_tmux_status: any;
+                    cleanup_executor_status: string;
+                    work_graph_quality_score: number;
+                    fake_vs_real_policy: string;
+                };
+                intelligent_work_graph: string;
+                test_ownership_map: string;
+                critical_path: string;
+                integration_bottlenecks: string;
+                work_graph_quality_score: number;
+                work_graph_quality_partial: boolean;
+                terminal_reports_match_generations: boolean;
                 ledger_hash_chain_ok: boolean;
                 no_overlap_ok: boolean;
                 consensus_ok: boolean;

package/dist/core/agents/agent-cleanup-executor.d.ts

@@ -0,0 +1,47 @@
+export declare const AGENT_CLEANUP_PROOF_SCHEMA = "sks.agent-cleanup-proof.v1";
+export declare const AGENT_CLEANUP_ACTION_LEDGER_SCHEMA = "sks.agent-cleanup-action-ledger.v1";
+export interface AgentCleanupExecutorOptions {
+    missionDir: string;
+    missionId?: string | null;
+    action?: 'cleanup' | 'close';
+    apply?: boolean;
+    dryRun?: boolean;
+    drain?: boolean;
+    staleMs?: number;
+}
+type CleanupActionKind = 'terminate_process' | 'close_tmux_pane' | 'remove_temp_dir' | 'remove_lock' | 'skip_active_session' | 'skip_foreign_namespace' | 'archive_transcript_keep';
+interface CleanupAction {
+    kind: CleanupActionKind;
+    target: string;
+    status: 'planned' | 'applied' | 'skipped' | 'failed';
+    reason: string;
+    error?: string;
+}
+export declare function runAgentCleanupExecutor(opts: AgentCleanupExecutorOptions): Promise<{
+    schema: string;
+    generated_at: string;
+    ok: boolean;
+    mission_id: string | null;
+    project_namespace: string | null;
+    action: string;
+    dry_run: boolean;
+    apply: boolean;
+    stale_processes_found: string[];
+    stale_processes_killed: string[];
+    stale_tmux_panes_found: string[];
+    stale_tmux_panes_closed: string[];
+    orphan_temp_dirs_found: string[];
+    orphan_temp_dirs_removed: string[];
+    stale_locks_found: string[];
+    stale_locks_removed: string[];
+    skipped_active_sessions: string[];
+    skipped_foreign_namespace: string[];
+    terminal_transcripts_preserved: string[];
+    action_count: number;
+    applied_count: number;
+    failed_count: number;
+    actions: CleanupAction[];
+    blockers: string[];
+}>;
+export {};
+//# sourceMappingURL=agent-cleanup-executor.d.ts.map