sneakoscope 1.18.1 → 1.18.3

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.1** adds Dynamic Agent Pool replenishment: `agents=5` now means keep up to five active worker slots running until the work queue drains, with immutable session generations, generation-aware terminal close reports, real/fake-tmux pane launch evidence, and Source Intelligence / Goal mode refs propagated to every generation.
+SKS **1.18.3** closes the route-truth 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 blackboxes now execute the actual route commands while proving task graph, work queue, scheduler, terminal, Source Intelligence, Goal, and tmux supervisor evidence.
 
 ```bash
 sks mad-sks plan --target-root <path> --json
@@ -19,10 +19,12 @@ sks mad-sks proof --json
 sks mad-sks rollback-apply --rollback-plan <path> --yes --json
 sks features complete --json
 sks agent status latest --json
-sks agent run "release review" --agents 8 --concurrency 4 --mock --json
+sks agent run "release review" --agents 8 --work-items 16 --concurrency 4 --mock --json
 npm run source-intelligence:all-modes
 npm run agent:background-terminals
-npm run agent:tmux-right-lanes
+npm run agent:tmux-lane-no-flicker
+npm run agent:backfill-route-blackbox
+npm run team:actual-route-backfill
 npm run release:readiness
 ```
 
@@ -612,7 +614,7 @@ npm run release:check
 npm run publish:dry
 ```
 
-`release:check` runs the 1.18.1 dynamic agent pool 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 dynamic pool, backfill replenishment, scheduler proof, session generation, terminal generation, tmux real right-lane, 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.1"
+version = "1.18.3"
 dependencies = [
  "serde_json",
 ]

package/crates/sks-core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "sks-core"
-version = "1.18.1"
+version = "1.18.3"
 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.1"),
+        Some("--version") => println!("sks-rs 1.18.3"),
         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.1",
-  "source_digest": "6df40e82722a56a4df2efafa956011204d7a96fd218b43d19aa10672bbd0842c",
-  "source_file_count": 1312,
-  "built_at_source_time": 1779722031788
+  "package_version": "1.18.3",
+  "source_digest": "5aefcff7c0119b0c22dc3ca2d50edd2dbd5f069ea1a9838cee14700f0ede28de",
+  "source_file_count": 1370,
+  "built_at_source_time": 1779767703495
 }

package/dist/bin/sks.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-const FAST_PACKAGE_VERSION = '1.18.1';
+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.1",
-  "package_version": "1.18.1",
+  "version": "1.18.3",
+  "package_version": "1.18.3",
   "typescript": true,
   "mjs_runtime_files": 0,
-  "compiled_file_count": 858,
-  "compiled_js_count": 429,
-  "compiled_dts_count": 429,
-  "source_digest": "6df40e82722a56a4df2efafa956011204d7a96fd218b43d19aa10672bbd0842c",
-  "source_file_count": 1312,
-  "source_files_hash": "fbe2aa994acefbdab214a17074d539960fa99369b928c3679442019ace20e7c6",
-  "source_list_hash": "fbe2aa994acefbdab214a17074d539960fa99369b928c3679442019ace20e7c6",
+  "compiled_file_count": 864,
+  "compiled_js_count": 432,
+  "compiled_dts_count": 432,
+  "source_digest": "5aefcff7c0119b0c22dc3ca2d50edd2dbd5f069ea1a9838cee14700f0ede28de",
+  "source_file_count": 1370,
+  "source_files_hash": "1807c675876cb62160e1f8e2fb69a846610ba2a34fa01154263805337a98c149",
+  "source_list_hash": "1807c675876cb62160e1f8e2fb69a846610ba2a34fa01154263805337a98c149",
   "src_mjs_runtime_files": 0,
   "dist_stamp_schema": "sks.dist-build-stamp.v1",
   "files": [
@@ -198,6 +198,8 @@
     "core/agents/agent-consensus.js",
     "core/agents/agent-effort-policy.d.ts",
     "core/agents/agent-effort-policy.js",
+    "core/agents/agent-follow-up-work-items.d.ts",
+    "core/agents/agent-follow-up-work-items.js",
     "core/agents/agent-gate.d.ts",
     "core/agents/agent-gate.js",
     "core/agents/agent-heartbeat.d.ts",
@@ -242,6 +244,8 @@
     "core/agents/agent-session-generation.js",
     "core/agents/agent-session-rows.d.ts",
     "core/agents/agent-session-rows.js",
+    "core/agents/agent-task-graph.d.ts",
+    "core/agents/agent-task-graph.js",
     "core/agents/agent-task-slicer.d.ts",
     "core/agents/agent-task-slicer.js",
     "core/agents/agent-terminal-session.d.ts",
@@ -262,6 +266,8 @@
     "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-right-lane-cockpit.d.ts",
     "core/agents/tmux-right-lane-cockpit.js",
     "core/agents/work-partition/conflict-detector.d.ts",

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,6 +438,16 @@ 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;
+            };
+            requested_work_items: number;
+            actual_total_work_items: number;
+            target_active_slots: number;
+            minimum_work_items: number;
             scheduler: {
                 schema: string;
                 ok: boolean;
@@ -549,12 +561,24 @@ export declare function run(command: any, args?: any): Promise<void | {
                     terminal_sessions_closed: any;
                     terminal_close_report: string;
                     target_active_slots: any;
+                    total_work_items: any;
+                    pending_count: any;
+                    active_slot_count: any;
+                    completed_count: any;
                     max_observed_active_slots: any;
                     backfill_count: any;
+                    expected_backfill_count: any;
                     pending_queue_drained: any;
                     generation_count: any;
                     tmux_attach_command: string | null;
                     tmux_lane_manifest: string;
+                    tmux_lane_persistence: {
+                        supervisor: string;
+                        no_flicker_verified: boolean;
+                        pane_survival_checked: boolean;
+                        unexpected_close_count: number;
+                        lane_count: number;
+                    };
                     output_schema_ok: boolean;
                     output_tail_report: string;
                     output_tail_records: number;
@@ -569,7 +593,7 @@ export declare function run(command: any, args?: any): Promise<void | {
                 generated_at: string;
                 records: {
                     schema: string;
-                    kind: "xai_available_not_used" | "context7_missing" | "codex_web_search_missing" | "recursion_attempt" | "lease_conflict" | "session_not_closed" | "terminal_missing" | "terminal_not_closed" | "scheduler_starvation" | "session_generation_missing" | "schema_invalid_output" | "stale_heartbeat" | "legacy_multiagent_runtime_usage_attempt";
+                    kind: "xai_available_not_used" | "context7_missing" | "codex_web_search_missing" | "recursion_attempt" | "lease_conflict" | "session_not_closed" | "terminal_missing" | "terminal_not_closed" | "scheduler_starvation" | "tmux_lane_flicker" | "missing_follow_up_schema" | "session_generation_missing" | "schema_invalid_output" | "stale_heartbeat" | "legacy_multiagent_runtime_usage_attempt";
                     blocker: string;
                     created_at: string;
                     status: string;
@@ -582,6 +606,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;
@@ -597,21 +625,42 @@ 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;
+                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,6 +290,16 @@ 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;
+            };
+            requested_work_items: number;
+            actual_total_work_items: number;
+            target_active_slots: number;
+            minimum_work_items: number;
             scheduler: {
                 schema: string;
                 ok: boolean;
@@ -401,12 +413,24 @@ export declare function run(command: any, args?: any): Promise<void | {
                     terminal_sessions_closed: any;
                     terminal_close_report: string;
                     target_active_slots: any;
+                    total_work_items: any;
+                    pending_count: any;
+                    active_slot_count: any;
+                    completed_count: any;
                     max_observed_active_slots: any;
                     backfill_count: any;
+                    expected_backfill_count: any;
                     pending_queue_drained: any;
                     generation_count: any;
                     tmux_attach_command: string | null;
                     tmux_lane_manifest: string;
+                    tmux_lane_persistence: {
+                        supervisor: string;
+                        no_flicker_verified: boolean;
+                        pane_survival_checked: boolean;
+                        unexpected_close_count: number;
+                        lane_count: number;
+                    };
                     output_schema_ok: boolean;
                     output_tail_report: string;
                     output_tail_records: number;
@@ -421,7 +445,7 @@ export declare function run(command: any, args?: any): Promise<void | {
                 generated_at: string;
                 records: {
                     schema: string;
-                    kind: "xai_available_not_used" | "context7_missing" | "codex_web_search_missing" | "recursion_attempt" | "lease_conflict" | "session_not_closed" | "terminal_missing" | "terminal_not_closed" | "scheduler_starvation" | "session_generation_missing" | "schema_invalid_output" | "stale_heartbeat" | "legacy_multiagent_runtime_usage_attempt";
+                    kind: "xai_available_not_used" | "context7_missing" | "codex_web_search_missing" | "recursion_attempt" | "lease_conflict" | "session_not_closed" | "terminal_missing" | "terminal_not_closed" | "scheduler_starvation" | "tmux_lane_flicker" | "missing_follow_up_schema" | "session_generation_missing" | "schema_invalid_output" | "stale_heartbeat" | "legacy_multiagent_runtime_usage_attempt";
                     blocker: string;
                     created_at: string;
                     status: string;
@@ -434,6 +458,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;
@@ -449,21 +477,42 @@ 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;
+                terminal_reports_match_generations: boolean;
                 ledger_hash_chain_ok: boolean;
                 no_overlap_ok: boolean;
                 consensus_ok: boolean;

package/dist/core/agents/agent-command-surface.d.ts

@@ -4,6 +4,10 @@ export declare function parseAgentCommandArgs(command: string, args?: string[]):
     prompt: string;
     route: string;
     agents: number;
+    targetActiveSlots: number;
+    desiredWorkItemCount: number;
+    minimumWorkItems: number;
+    maxQueueExpansion: number;
     concurrency: number;
     backend: string;
     mock: boolean;

package/dist/core/agents/agent-command-surface.js

@@ -6,6 +6,10 @@ export function parseAgentCommandArgs(command, args = []) {
     const rest = action === first ? args.slice(1) : args;
     const json = hasFlag(args, '--json');
     const agents = Number(readOption(args, '--agents', DEFAULT_AGENT_COUNT));
+    const targetActiveSlots = Number(readOption(args, '--target-active-slots', agents));
+    const desiredWorkItemCount = Number(readOption(args, '--work-items', targetActiveSlots));
+    const minimumWorkItems = Number(readOption(args, '--minimum-work-items', targetActiveSlots));
+    const maxQueueExpansion = Number(readOption(args, '--max-queue-expansion', 10));
     const concurrency = Number(readOption(args, '--concurrency', Math.min(agents, 5)));
     const backend = String(readOption(args, '--backend', hasFlag(args, '--mock') ? 'fake' : 'codex-exec'));
     const route = String(readOption(args, '--route', '$Agent'));
@@ -13,14 +17,14 @@ export function parseAgentCommandArgs(command, args = []) {
     const real = hasFlag(args, '--real');
     const readonly = hasFlag(args, '--readonly') || hasFlag(args, '--read-only');
     const codexApp = hasFlag(args, '--codex-app');
-    const positionals = positionalArgs(rest, new Set(['--agents', '--concurrency', '--backend', '--route', '--mission', '--mission-id', '--agent', '--lane']));
+    const positionals = positionalArgs(rest, new Set(['--agents', '--target-active-slots', '--work-items', '--minimum-work-items', '--max-queue-expansion', '--concurrency', '--backend', '--route', '--mission', '--mission-id', '--agent', '--lane']));
     const missionDefault = action === 'run' || action === 'spawn' || action === 'plan' ? '' : 'latest';
     const positionalMission = action === 'run' || action === 'spawn' || action === 'plan' ? '' : (positionals[0] || '');
     const missionId = String(readOption(args, '--mission', readOption(args, '--mission-id', positionalMission || missionDefault)));
     const lane = String(readOption(args, '--agent', readOption(args, '--lane', '')));
     const promptPositionals = positionalMission ? positionals.slice(1) : positionals;
     const prompt = promptPositionals.join(' ').trim() || 'Native agent run';
-    return { command, action, prompt, route, agents, concurrency, backend, mock, real, readonly, json, missionId, lane, codexApp };
+    return { command, action, prompt, route, agents, targetActiveSlots, desiredWorkItemCount, minimumWorkItems, maxQueueExpansion, concurrency, backend, mock, real, readonly, json, missionId, lane, codexApp };
 }
 function hasFlag(args, flag) {
     return args.includes(flag);

package/dist/core/agents/agent-follow-up-work-items.d.ts

@@ -0,0 +1,20 @@
+export interface AgentFollowUpWorkItem {
+    id: string;
+    title: string;
+    description: string;
+    required_persona_category: string;
+    priority: number;
+    dependencies: string[];
+    lease_requirements: unknown[];
+    max_attempts: number;
+    reason: string;
+    source_agent_session_id?: string;
+}
+export interface AgentFollowUpValidationResult {
+    accepted: AgentFollowUpWorkItem[];
+    blockers: string[];
+}
+export declare function normalizeAgentFollowUpWorkItems(rawItems: unknown, input?: {
+    originSessionId?: string | null;
+}): AgentFollowUpValidationResult;
+//# sourceMappingURL=agent-follow-up-work-items.d.ts.map

package/dist/core/agents/agent-follow-up-work-items.js

@@ -0,0 +1,115 @@
+import { scanAgentTextForRecursion } from './agent-recursion-guard.js';
+const FOLLOW_UP_KEYS = new Set([
+    'id',
+    'title',
+    'description',
+    'required_persona_category',
+    'priority',
+    'dependencies',
+    'lease_requirements',
+    'max_attempts',
+    'reason',
+    'source_agent_session_id'
+]);
+const PROTECTED_WRITE_PATH_RE = /^(?:\.codex|\.agents|AGENTS\.md|node_modules\/sneakoscope|\.sneakoscope\/.*policy.*\.json)(?:\/|$)/;
+const MAIN_ROUTE_RECURSION_RE = /(?:\bsks\s+(?:team|agent|research|qa-loop|goal)\b|\$(?:Team|Goal|Research|QA-LOOP|Agent)\b|main\s+route\s+recursion)/i;
+const GLOBAL_SCOUT_LEDGER_RE = /global\s+scout\s+ledger/i;
+export function normalizeAgentFollowUpWorkItems(rawItems, input = {}) {
+    if (rawItems === undefined || rawItems === null)
+        return { accepted: [], blockers: [] };
+    if (!Array.isArray(rawItems))
+        return { accepted: [], blockers: ['follow_up_work_items_not_array'] };
+    const accepted = [];
+    const blockers = [];
+    rawItems.forEach((raw, index) => {
+        const result = normalizeAgentFollowUpWorkItem(raw, index, input.originSessionId || null);
+        if (result.item)
+            accepted.push(result.item);
+        blockers.push(...result.blockers);
+    });
+    return { accepted, blockers };
+}
+function normalizeAgentFollowUpWorkItem(raw, index, originSessionId) {
+    const blockers = [];
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        return { item: null, blockers: [`follow_up_work_item_${index + 1}_not_object`] };
+    }
+    const row = raw;
+    for (const key of Object.keys(row)) {
+        if (!FOLLOW_UP_KEYS.has(key))
+            blockers.push(`follow_up_work_item_${index + 1}_additional_property:${key}`);
+    }
+    const id = requiredString(row.id, 'id', index, blockers);
+    const title = requiredString(row.title, 'title', index, blockers);
+    const description = requiredString(row.description, 'description', index, blockers);
+    const requiredPersonaCategory = requiredString(row.required_persona_category, 'required_persona_category', index, blockers);
+    const reason = requiredString(row.reason, 'reason', index, blockers);
+    const priority = requiredInteger(row.priority, 'priority', index, blockers, 0);
+    const maxAttempts = requiredInteger(row.max_attempts, 'max_attempts', index, blockers, 1);
+    const dependencies = requiredStringArray(row.dependencies, 'dependencies', index, blockers);
+    const leaseRequirements = requiredArray(row.lease_requirements, 'lease_requirements', index, blockers);
+    const sourceAgentSessionId = typeof row.source_agent_session_id === 'string' && row.source_agent_session_id.trim()
+        ? row.source_agent_session_id.trim()
+        : originSessionId || undefined;
+    const serialized = JSON.stringify(row);
+    const recursion = scanAgentTextForRecursion(serialized);
+    if (!recursion.ok || MAIN_ROUTE_RECURSION_RE.test(serialized))
+        blockers.push(`follow_up_work_item_${index + 1}_main_route_recursion_blocked`);
+    if (GLOBAL_SCOUT_LEDGER_RE.test(serialized))
+        blockers.push(`follow_up_work_item_${index + 1}_global_scout_ledger_blocked`);
+    for (const lease of leaseRequirements) {
+        const path = leasePath(lease);
+        if (path && PROTECTED_WRITE_PATH_RE.test(path))
+            blockers.push(`follow_up_work_item_${index + 1}_protected_core_target:${path}`);
+    }
+    if (blockers.length)
+        return { item: null, blockers };
+    return {
+        item: {
+            id,
+            title,
+            description,
+            required_persona_category: requiredPersonaCategory,
+            priority,
+            dependencies,
+            lease_requirements: leaseRequirements,
+            max_attempts: maxAttempts,
+            reason,
+            ...(sourceAgentSessionId ? { source_agent_session_id: sourceAgentSessionId } : {})
+        },
+        blockers: []
+    };
+}
+function requiredString(value, field, index, blockers) {
+    const text = typeof value === 'string' ? value.trim() : '';
+    if (!text)
+        blockers.push(`follow_up_work_item_${index + 1}_missing_${field}`);
+    return text;
+}
+function requiredInteger(value, field, index, blockers, min) {
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed) || Math.floor(parsed) !== parsed || parsed < min)
+        blockers.push(`follow_up_work_item_${index + 1}_invalid_${field}`);
+    return Math.max(min, Number.isFinite(parsed) ? Math.floor(parsed) : min);
+}
+function requiredArray(value, field, index, blockers) {
+    if (!Array.isArray(value)) {
+        blockers.push(`follow_up_work_item_${index + 1}_missing_${field}`);
+        return [];
+    }
+    return value;
+}
+function requiredStringArray(value, field, index, blockers) {
+    const rows = requiredArray(value, field, index, blockers);
+    const out = rows.map((entry) => String(entry || '')).filter(Boolean);
+    if (out.length !== rows.length)
+        blockers.push(`follow_up_work_item_${index + 1}_invalid_${field}`);
+    return out;
+}
+function leasePath(lease) {
+    if (!lease || typeof lease !== 'object')
+        return '';
+    const row = lease;
+    return String(row.path || row.file || row.target_path || '').replace(/\\/g, '/').replace(/^\.?\//, '');
+}
+//# sourceMappingURL=agent-follow-up-work-items.js.map

package/dist/core/agents/agent-janitor.d.ts

@@ -8,6 +8,9 @@ export interface AgentJanitorReport {
     zombie_process_sessions: string[];
     stale_tmux_sessions: string[];
     active_generation_sessions: string[];
+    active_generation_count: number;
+    cleaned_generation_count: number;
+    skipped_active_generations: string[];
     orphan_generation_dirs: string[];
     slot_generation_cleanup: string[];
     orphan_temp_dirs: string[];

package/dist/core/agents/agent-janitor.js

@@ -34,7 +34,10 @@ export async function runAgentJanitor(input) {
             statusBySession.set(String(row.session_id), status);
     }
     const zombieProcesses = await detectZombieProcessSessions(agentRoot, statusByAgent, statusBySession);
-    const staleTmuxSessions = await detectStaleTmuxSessions(agentRoot, staleMs);
+    const rawStaleTmuxSessions = await detectStaleTmuxSessions(agentRoot, staleMs);
+    const activeGenerationSet = new Set(activeGenerationSessions);
+    const staleTmuxSessions = rawStaleTmuxSessions.filter((id) => !activeGenerationSet.has(id));
+    const skippedActiveGenerations = rawStaleTmuxSessions.filter((id) => activeGenerationSet.has(id));
     const orphanGenerationDirs = await detectOrphanGenerationDirs(agentRoot, new Set(generationRows.map((row) => String(row.artifact_dir || ''))));
     const orphanTempDirs = await scopedExistingPaths(Array.isArray(namespace?.orphan_temp_dirs) ? namespace.orphan_temp_dirs : [], projectHash);
     const staleLocks = await scopedStaleLockPaths(namespace?.lock_dir ? [namespace.lock_dir] : [], projectHash, staleMs);
@@ -65,6 +68,9 @@ export async function runAgentJanitor(input) {
         zombie_process_sessions: zombieProcesses,
         stale_tmux_sessions: staleTmuxSessions,
         active_generation_sessions: activeGenerationSessions,
+        active_generation_count: activeGenerationSessions.length,
+        cleaned_generation_count: cleaned.filter((entry) => entry.includes(`${path.sep}sessions${path.sep}`)).length,
+        skipped_active_generations: skippedActiveGenerations,
         orphan_generation_dirs: orphanGenerationDirs,
         slot_generation_cleanup: cleaned.filter((entry) => entry.includes(`${path.sep}sessions${path.sep}`)),
         orphan_temp_dirs: orphanTempDirs,