sneakoscope 1.20.4 → 1.21.0

package/README.md

@@ -16,6 +16,8 @@ Set up this agent project with Sneakoscope Codex. Use [[mandarange/Sneakoscope-C
 
 ## Current Release
 
+SKS **1.21.0** carries forward the `sks --mad` Zellij auto-attach fix and aligns the release metadata gates with explicit version bumps. Previous releases only *created* a detached background session and printed an `Attach with: ...` hint, so nothing opened in the operator's terminal. SKS now performs the follow-up foreground attach automatically when launched in an interactive TTY (using the same `ZELLIJ_SOCKET_DIR` namespace as the background session), and falls back to printing the manual attach command if attach fails. Auto-attach is skipped for `--json`, non-TTY/piped launches, when already inside a Zellij session, or with `--no-attach` / `SKS_NO_ZELLIJ_ATTACH=1`; `--attach` forces it.
+
 SKS **1.20.4** is a targeted `sks --mad` / codex-lb Zellij usability patch: when a background MAD Zellij session launches successfully, SKS now prints the exact `Attach with: ZELLIJ_SOCKET_DIR=... zellij attach ...` command so operators can enter the fresh session without manually reconstructing the socket namespace.
 
 SKS **1.20.3** added the macOS Zellij launch fallback and project-local Fast mode control. SKS supplies a short per-user `ZELLIJ_SOCKET_DIR` by default, caps generated session names safely, records `*_command_with_env` attach commands, and classifies `IPC socket path is too long` as `zellij_socket_path_too_long` instead of a generic launch failure. It also adds `sks fast-mode on|off|status|clear`, `$Fast-On`, `$Fast-Off`, and `$Fast-Mode`; saved project preferences are used only when no explicit `--fast`, `--no-fast`, or `--service-tier` flag is present.

package/crates/sks-core/Cargo.lock

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

package/crates/sks-core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "sks-core"
-version = "1.20.4"
+version = "1.21.0"
 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.20.4"),
+        Some("--version") => println!("sks-rs 1.21.0"),
         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.20.4",
-  "source_digest": "491c4c03f8a989f3ea78aa47b16a937edbd54e653b71ef79b5ce767916df7395",
+  "package_version": "1.21.0",
+  "source_digest": "666db83626c95b8a8eae20389e647a2db96c4e22802cdf18ce0f7c142c9dbcaa",
   "source_file_count": 1750,
-  "built_at_source_time": 1780281006481
+  "built_at_source_time": 1780297266324
 }

package/dist/bin/sks.js

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

package/dist/build-manifest.json

@@ -1,13 +1,13 @@
 {
   "schema": "sks.dist-build.v2",
-  "version": "1.20.4",
-  "package_version": "1.20.4",
+  "version": "1.21.0",
+  "package_version": "1.21.0",
   "typescript": true,
   "mjs_runtime_files": 0,
   "compiled_file_count": 1020,
   "compiled_js_count": 510,
   "compiled_dts_count": 510,
-  "source_digest": "491c4c03f8a989f3ea78aa47b16a937edbd54e653b71ef79b5ce767916df7395",
+  "source_digest": "666db83626c95b8a8eae20389e647a2db96c4e22802cdf18ce0f7c142c9dbcaa",
   "source_file_count": 1750,
   "source_files_hash": "de93b15a72352d00481b958333ed964bf083563809e3beddfe4e64046720df75",
   "source_list_hash": "de93b15a72352d00481b958333ed964bf083563809e3beddfe4e64046720df75",

package/dist/commands/mad-sks.d.ts

@@ -2,7 +2,7 @@ export declare function run(_command: any, args?: any): Promise<void | {
     schema: string;
     generated_at: string;
     ok: boolean;
-    kind: "agent" | "team" | "mad";
+    kind: "agent" | "team" | "mad" | "naruto";
     mission_id: string;
     session_name: string;
     root: string;
@@ -10,6 +10,13 @@ export declare function run(_command: any, args?: any): Promise<void | {
     ledger_root: string;
     layout_path: string;
     layout_artifact: string;
+    main_pane_kind: "codex_interactive" | "status_shell";
+    codex_pane: {
+        enabled: boolean;
+        args: string[];
+        launch_env_keys: string[];
+        bin: string;
+    };
     command: string[];
     launch_command: string[];
     launch_command_with_env: string;
@@ -17,6 +24,7 @@ export declare function run(_command: any, args?: any): Promise<void | {
     background_command_with_env: string;
     attach_command: string;
     attach_command_with_env: string;
+    attach_requested: boolean;
     zellij_socket_dir: string | null;
     zellij_socket_dir_source: import("../core/zellij/zellij-command.js").ZellijSocketDirSource;
     pane_proof_path: string;
@@ -32,6 +40,8 @@ export declare function run(_command: any, args?: any): Promise<void | {
         main_pane: any;
         lane_panes: any[];
         expected_lane_count: number;
+        expected_main_command_includes: string | null;
+        main_command_ok: boolean;
         lane_count_ok: boolean;
         geometry_distinct: boolean | null;
         panes: any[];

package/dist/core/agents/agent-codex-cockpit.d.ts

@@ -5,7 +5,7 @@ export declare const AGENT_LIVE_SUMMARY_JSON = "agent-live-summary.json";
 export declare const AGENT_PROGRESS_TIMELINE_MD = "agent-progress-timeline.md";
 export declare const AGENT_CODEX_COCKPIT_EVENTS = "agent-codex-cockpit-events.jsonl";
 export type CodexCockpitHookPayload = {
-    hook_event_name: 'SubagentStart' | 'SubagentStop';
+    hook_event_name: 'NativeSessionStart' | 'NativeSessionStop' | 'SubagentStart' | 'SubagentStop';
     agent_id?: string;
     agent_type?: string;
     session_id?: string;

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

@@ -19,7 +19,7 @@ export declare function parseAgentCommandArgs(command: string, args?: string[]):
     dryRunPatches: boolean;
     maxWriteAgents: number;
     fastMode: boolean | undefined;
-    serviceTier: string | undefined;
+    serviceTier: import("./fast-mode-policy.js").AgentServiceTier | undefined;
     noFast: boolean;
     apply: boolean;
     dryRun: boolean;

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

@@ -1,4 +1,5 @@
 import { DEFAULT_AGENT_COUNT } from './agent-schema.js';
+import { normalizeServiceTier } from './fast-mode-policy.js';
 export function parseAgentCommandArgs(command, args = []) {
     const first = args[0] && !String(args[0]).startsWith('--') ? String(args[0]) : '';
     const actions = new Set(['run', 'worker', 'status', 'plan', 'spawn', 'watch', 'dashboard', 'cockpit', 'lane', 'board', 'ledger', 'collect', 'consensus', 'close', 'cleanup', 'proof', 'explain', 'rollback-patches']);
@@ -22,7 +23,7 @@ export function parseAgentCommandArgs(command, args = []) {
     const dryRunPatches = hasFlag(args, '--dry-run-patches') || hasFlag(args, '--dryrun-patches');
     const maxWriteAgents = Number(readOption(args, '--max-write-agents', Math.max(1, Math.min(concurrency, agents))));
     const explicitServiceTier = String(readOption(args, '--service-tier', '') || '');
-    const serviceTier = explicitServiceTier === 'standard' || explicitServiceTier === 'fast' ? explicitServiceTier : undefined;
+    const serviceTier = normalizeServiceTier(explicitServiceTier, null) || undefined;
     const fastMode = hasFlag(args, '--no-fast') || serviceTier === 'standard' ? false : hasFlag(args, '--fast') ? true : undefined;
     const noFast = hasFlag(args, '--no-fast');
     const apply = hasFlag(args, '--apply');

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

@@ -264,7 +264,7 @@ export async function runNativeAgentOrchestrator(opts = {}) {
             await openAgentSession(ledgerRoot, agent);
             await heartbeatAgentSession(ledgerRoot, agent);
             await appendAgentCodexCockpitHookEvent(dir, {
-                hook_event_name: 'SubagentStart',
+                hook_event_name: 'NativeSessionStart',
                 agent_id: agent.id,
                 agent_type: agent.role || agent.persona_id || 'agent',
                 session_id: agent.session_id,
@@ -310,7 +310,7 @@ export async function runNativeAgentOrchestrator(opts = {}) {
                 await completeAgentSession(ledgerRoot, agent);
             await closeAgentSession(ledgerRoot, agent, result.status === 'done' ? 'closed' : result.status);
             await appendAgentCodexCockpitHookEvent(dir, {
-                hook_event_name: 'SubagentStop',
+                hook_event_name: 'NativeSessionStop',
                 agent_id: agent.id,
                 agent_type: agent.role || agent.persona_id || 'agent',
                 session_id: agent.session_id,

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

@@ -11,7 +11,7 @@ export declare function agentPipelineStage(policy?: any): {
     id: string;
     goal: string;
     agent_count: number;
-    max_parallel_subagents: number;
+    max_parallel_native_sessions: number;
     backend: string;
     read_only: boolean;
     write_policy: string;

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

@@ -33,7 +33,7 @@ export function agentPipelineStage(policy = {}) {
         id: AGENT_INTAKE_STAGE_ID,
         goal: 'Run native multi-session agent intake with non-overlapping leases and proof evidence.',
         agent_count: required ? Number(policy.agent_count || DEFAULT_AGENT_COUNT) : 0,
-        max_parallel_subagents: Number(policy.agent_count || DEFAULT_AGENT_COUNT),
+        max_parallel_native_sessions: Number(policy.agent_count || DEFAULT_AGENT_COUNT),
         backend: 'native-agent-kernel',
         read_only: true,
         write_policy: 'read-only analysis; parent-owned integration',

package/dist/core/agents/fast-mode-policy.d.ts

@@ -2,12 +2,14 @@ export declare const FAST_MODE_POLICY_SCHEMA = "sks.fast-mode-policy.v1";
 export declare const FAST_MODE_PROPAGATION_PROOF_SCHEMA = "sks.fast-mode-propagation-proof.v1";
 export declare const FAST_MODE_PREFERENCE_SCHEMA = "sks.fast-mode-preference.v1";
 export type AgentServiceTier = 'fast' | 'standard';
+export type CodexDesktopServiceTier = 'priority' | 'default';
 export type FastModePreferenceMode = AgentServiceTier;
 export interface FastModePolicy {
     schema: typeof FAST_MODE_POLICY_SCHEMA;
     generated_at: string;
     fast_mode: boolean;
     service_tier: AgentServiceTier;
+    codex_desktop_service_tier: CodexDesktopServiceTier;
     default_fast_mode: true;
     disabled_by: 'none' | 'no-fast' | 'service-tier-standard' | 'preference-standard';
     explicit_fast: boolean;
@@ -23,6 +25,7 @@ export interface FastModePreference {
     mode: FastModePreferenceMode;
     fast_mode: boolean;
     service_tier: AgentServiceTier;
+    codex_desktop_service_tier: CodexDesktopServiceTier;
     source: string;
 }
 export declare function resolveFastModePolicy(input?: any): FastModePolicy;
@@ -65,4 +68,6 @@ export declare function writeFastModePropagationProof(root: string, input?: {
     artifacts: string[];
     blockers: string[];
 }>;
+export declare function normalizeServiceTier(value: unknown, fallback?: AgentServiceTier | null): AgentServiceTier | null;
+export declare function codexDesktopServiceTier(tier: AgentServiceTier): CodexDesktopServiceTier;
 //# sourceMappingURL=fast-mode-policy.d.ts.map

package/dist/core/agents/fast-mode-policy.js

@@ -24,6 +24,7 @@ export function resolveFastModePolicy(input = {}) {
         generated_at: nowIso(),
         fast_mode: serviceTier === 'fast',
         service_tier: serviceTier,
+        codex_desktop_service_tier: codexDesktopServiceTier(serviceTier),
         default_fast_mode: true,
         disabled_by: explicitNoFast ? 'no-fast' : explicitTier === 'standard' ? 'service-tier-standard' : preference?.mode === 'standard' ? 'preference-standard' : 'none',
         explicit_fast: explicitFast,
@@ -69,6 +70,7 @@ export async function writeFastModePreference(root = process.cwd(), mode, source
         mode: normalized,
         fast_mode: normalized === 'fast',
         service_tier: normalized,
+        codex_desktop_service_tier: codexDesktopServiceTier(normalized),
         source
     };
     await writeJsonAtomic(file, preference);
@@ -84,6 +86,7 @@ export function fastModeEnv(policy) {
     return {
         SKS_FAST_MODE: policy.fast_mode ? '1' : '0',
         SKS_SERVICE_TIER: policy.service_tier,
+        SKS_CODEX_DESKTOP_SERVICE_TIER: policy.codex_desktop_service_tier,
         SKS_REASONING_PROFILE_SUFFIX: policy.fast_mode ? 'fast' : 'standard'
     };
 }
@@ -164,12 +167,19 @@ export async function writeFastModePropagationProof(root, input = { policy: reso
     await writeJsonAtomic(path.join(root, 'fast-mode-propagation-proof.json'), report);
     return report;
 }
-function normalizeServiceTier(value, fallback = 'fast') {
+export function normalizeServiceTier(value, fallback = 'fast') {
     const text = String(value || '').toLowerCase();
     if (text === 'fast' || text === 'standard')
         return text;
+    if (text === 'priority')
+        return 'fast';
+    if (text === 'default')
+        return 'standard';
     return fallback;
 }
+export function codexDesktopServiceTier(tier) {
+    return tier === 'fast' ? 'priority' : 'default';
+}
 function normalizeFastModePreference(parsed, file) {
     const mode = normalizeServiceTier(parsed?.mode ?? parsed?.service_tier, 'fast') || 'fast';
     return {
@@ -178,6 +188,7 @@ function normalizeFastModePreference(parsed, file) {
         mode,
         fast_mode: mode === 'fast',
         service_tier: mode,
+        codex_desktop_service_tier: codexDesktopServiceTier(mode),
         source: typeof parsed?.source === 'string' ? parsed.source : 'unknown',
         path: file
     };

package/dist/core/codex/codex-cli-syntax-builder.d.ts

@@ -1,5 +1,5 @@
 export type CodexSandboxMode = 'read-only' | 'workspace-write' | 'danger-full-access';
-export type CodexServiceTier = 'fast' | 'standard' | 'default' | 'flex' | 'auto';
+export type CodexServiceTier = 'fast' | 'standard';
 export type BuildCodexExecArgsOptions = {
     json?: boolean;
     outputSchema?: string | null;

package/dist/core/codex/codex-cli-syntax-builder.js

@@ -34,9 +34,18 @@ export function buildCodexExecArgs(opts) {
         args.push('--dangerously-bypass-approvals-and-sandbox');
     else if (opts.sandbox)
         args.push('--sandbox', opts.sandbox);
-    if (opts.serviceTier)
-        args.push('-c', `service_tier=${opts.serviceTier}`);
+    const serviceTier = normalizeCodexServiceTier(opts.serviceTier);
+    if (serviceTier)
+        args.push('-c', `service_tier=${serviceTier}`);
     args.push(opts.prompt);
     return args;
 }
+function normalizeCodexServiceTier(value) {
+    const text = String(value || '').toLowerCase();
+    if (text === 'fast' || text === 'priority')
+        return 'fast';
+    if (text === 'standard' || text === 'default')
+        return 'standard';
+    return null;
+}
 //# sourceMappingURL=codex-cli-syntax-builder.js.map

package/dist/core/commands/fast-mode-command.js

@@ -57,17 +57,17 @@ export async function fastModeCommand(args = []) {
     else if (action === 'clear')
         console.log(`Cleared: ${removed ? 'yes' : 'already default'}`);
     else if (!preference)
-        console.log('Preference: default fast');
+        console.log('Preference: implicit fast');
     console.log('Dollar: $Fast-On | $Fast-Off | $Fast-Mode');
     return result;
 }
 function normalizeFastModeAction(value) {
     const text = String(value || 'status').toLowerCase();
-    if (['on', 'enable', 'enabled', 'fast'].includes(text))
+    if (['on', 'enable', 'enabled', 'fast', 'priority'].includes(text))
         return 'on';
-    if (['off', 'disable', 'disabled', 'standard', 'slow'].includes(text))
+    if (['off', 'disable', 'disabled', 'standard', 'slow', 'default'].includes(text))
         return 'off';
-    if (['clear', 'default', 'reset'].includes(text))
+    if (['clear', 'reset'].includes(text))
         return 'clear';
     return 'status';
 }

package/dist/core/commands/mad-sks-command.d.ts

@@ -2,7 +2,7 @@ export declare function madHighCommand(args?: any, deps?: any): Promise<void | {
     schema: string;
     generated_at: string;
     ok: boolean;
-    kind: "agent" | "team" | "mad";
+    kind: "agent" | "team" | "mad" | "naruto";
     mission_id: string;
     session_name: string;
     root: string;
@@ -10,6 +10,13 @@ export declare function madHighCommand(args?: any, deps?: any): Promise<void | {
     ledger_root: string;
     layout_path: string;
     layout_artifact: string;
+    main_pane_kind: "codex_interactive" | "status_shell";
+    codex_pane: {
+        enabled: boolean;
+        args: string[];
+        launch_env_keys: string[];
+        bin: string;
+    };
     command: string[];
     launch_command: string[];
     launch_command_with_env: string;
@@ -17,6 +24,7 @@ export declare function madHighCommand(args?: any, deps?: any): Promise<void | {
     background_command_with_env: string;
     attach_command: string;
     attach_command_with_env: string;
+    attach_requested: boolean;
     zellij_socket_dir: string | null;
     zellij_socket_dir_source: import("../zellij/zellij-command.js").ZellijSocketDirSource;
     pane_proof_path: string;
@@ -32,6 +40,8 @@ export declare function madHighCommand(args?: any, deps?: any): Promise<void | {
         main_pane: any;
         lane_panes: any[];
         expected_lane_count: number;
+        expected_main_command_includes: string | null;
+        main_command_ok: boolean;
         lane_count_ok: boolean;
         geometry_distinct: boolean | null;
         panes: any[];

package/dist/core/commands/mad-sks-command.js

@@ -4,7 +4,7 @@ import { initProject } from '../init.js';
 import { createMission, setCurrent } from '../mission.js';
 import { enableMadHighProfile, madHighProfileName } from '../auto-review.js';
 import { permissionGateSummary } from '../permission-gates.js';
-import { launchMadZellijUi, sanitizeZellijSessionName } from '../zellij/zellij-launcher.js';
+import { attachZellijSessionInteractive, launchMadZellijUi, sanitizeZellijSessionName } from '../zellij/zellij-launcher.js';
 import { createMadSksAuthorizationManifest, validateMadSksAuthorizationManifest } from '../mad-sks/authorization-manifest.js';
 import { createMadSksAuditLedger, madSksAuditAction, writeMadSksAuditLedger } from '../mad-sks/audit-ledger.js';
 import { compareProtectedCoreSnapshots, evaluateMadSksWrite, resolveProtectedCore, snapshotProtectedCore } from '../mad-sks/immutable-harness-guard.js';
@@ -79,12 +79,48 @@ export async function madHighCommand(args = [], deps = {}) {
     const launchOpts = codexLbImmediateLaunchOpts(cleanArgs, launchLb, { codexArgs: profile.launch_args, conciseBlockers: true, madSksEnv, launchEnv: madSksEnv });
     const workspace = readOption(cleanArgs, '--workspace', readOption(cleanArgs, '--session', launchOpts.session || `sks-mad-${sanitizeZellijSessionName(process.cwd())}`));
     const launch = await launchMadZellijUi([...cleanArgs, '--workspace', workspace], { ...launchOpts, missionId: madLaunch.mission_id, root: madLaunch.root, cwd: process.cwd(), ledgerRoot: path.join(madLaunch.dir, 'agents'), requireZellij: process.env.SKS_REQUIRE_ZELLIJ === '1' });
-    if (!launch.ok)
+    if (!launch.ok) {
         console.log(`MAD Zellij action: ${formatMadZellijAction(launch)}`);
-    else if (launch.attach_command_with_env)
+        return launch;
+    }
+    // The launcher only creates a detached background session. In an interactive
+    // terminal, immediately attach so the session actually opens for the user
+    // instead of leaving them to copy/paste the attach command by hand.
+    if (shouldAutoAttachZellij(args)) {
+        console.log(`Opening Zellij session: ${launch.session_name} (detach with Ctrl+q, re-attach later with: ${launch.attach_command_with_env})`);
+        const attached = attachZellijSessionInteractive(launch.session_name, { cwd: process.cwd() });
+        if (!attached.ok) {
+            console.log(`Could not open the Zellij session automatically${attached.error ? ` (${attached.error})` : ''}.`);
+            if (launch.attach_command_with_env)
+                console.log(`Attach with: ${launch.attach_command_with_env}`);
+        }
+        return launch;
+    }
+    if (launch.attach_command_with_env)
         console.log(`Attach with: ${launch.attach_command_with_env}`);
     return launch;
 }
+// Decide whether to take over the current terminal with a foreground Zellij
+// attach. We only do this for genuinely interactive launches; piped, JSON,
+// non-TTY, or already-inside-Zellij invocations keep the previous behaviour of
+// printing a manual "Attach with:" hint. Use --no-attach (or
+// SKS_NO_ZELLIJ_ATTACH=1) to force the background-only behaviour, and --attach
+// to force attaching even without a detected TTY.
+function shouldAutoAttachZellij(args) {
+    const list = (args || []).map((arg) => String(arg));
+    if (list.includes('--no-attach'))
+        return false;
+    if (list.includes('--json'))
+        return false;
+    if (process.env.SKS_NO_ZELLIJ_ATTACH === '1')
+        return false;
+    // Nested attach is rejected by Zellij when already inside a session.
+    if (process.env.ZELLIJ)
+        return false;
+    if (list.includes('--attach'))
+        return true;
+    return Boolean(process.stdout.isTTY && process.stdin.isTTY);
+}
 function formatMadZellijAction(launch) {
     const blockers = launch.blockers?.join(', ') || launch.warnings?.join(', ') || 'check Zellij installation';
     const details = [
@@ -189,6 +225,8 @@ function madLaunchOnlyFlags() {
         '--MAD',
         '--mad-sks',
         '--high',
+        '--attach',
+        '--no-attach',
         '--no-auto-install-zellij',
         '--allow-system',
         '--allow-db-write',

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

@@ -4,6 +4,7 @@ import { readJson, sksRoot } from '../fsx.js';
 import { runNativeAgentOrchestrator } from '../agents/agent-orchestrator.js';
 import { buildNarutoCloneRoster, systemSafeNarutoConcurrency } from '../agents/agent-roster.js';
 import { DEFAULT_NARUTO_CLONES, MAX_NARUTO_AGENT_COUNT } from '../agents/agent-schema.js';
+import { attachZellijSessionInteractive, launchZellijLayout } from '../zellij/zellij-launcher.js';
 const NARUTO_RESULT_SCHEMA = 'sks.naruto-command-result.v1';
 const NARUTO_ROUTE = '$Naruto';
 // $Naruto — Shadow Clone Swarm (影分身 / Kage Bunshin no Jutsu).
@@ -21,6 +22,7 @@ export async function narutoCommand(commandOrArgs = 'naruto', maybeArgs = []) {
     return narutoRun(parsed);
 }
 async function narutoRun(parsed) {
+    const root = await sksRoot();
     const roster = buildNarutoCloneRoster({
         clones: parsed.clones,
         prompt: parsed.prompt,
@@ -70,14 +72,35 @@ async function narutoRun(parsed) {
         concurrency_capped: clones > (result.target_active_slots ?? activeSlots),
         system: { cores: safe.cores, free_gb: safe.free_gb, safe_concurrency: safe.cap, heavy_backend: safe.heavy },
         proof: result.proof?.status || 'missing',
-        run: result
+        run: result,
+        zellij: null
     };
+    if (!parsed.json && !parsed.mock && !parsed.noOpenZellij) {
+        const ledgerRoot = result.ledger_root
+            ? path.join(root, result.ledger_root)
+            : path.join(root, '.sneakoscope', 'missions', result.mission_id, 'agents');
+        summary.zellij = await launchZellijLayout({
+            root,
+            missionId: result.mission_id,
+            ledgerRoot,
+            kind: 'naruto',
+            slotCount: summary.target_active_slots,
+            dryRun: false,
+            attach: false
+        });
+        if (summary.zellij?.ok && summary.zellij.capability?.status === 'ok' && parsed.attach)
+            attachZellijSessionInteractive(summary.zellij.session_name, { cwd: process.cwd() });
+    }
     return emit(parsed, summary, () => {
         console.log('🍥 Shadow Clone Jutsu — Kage Bunshin no Jutsu');
         console.log('Mission: ' + result.mission_id);
         console.log('Clones: ' + summary.clones + ' / max ' + MAX_NARUTO_AGENT_COUNT + ', running ' + summary.target_active_slots + ' at a time' + (summary.concurrency_capped ? ` (throttled to host capacity: ${safe.cores} cores, ${safe.free_gb} GB free)` : ''));
         console.log('Backend: ' + result.backend);
         console.log('Proof: ' + summary.proof);
+        if (summary.zellij?.ok && summary.zellij.capability?.status === 'ok')
+            console.log('Zellij: prepared ' + summary.target_active_slots + ' native session lane(s) in ' + summary.zellij.session_name);
+        else if (summary.zellij?.ok)
+            console.log('Zellij: optional live panes unavailable (' + ((summary.zellij.warnings || []).join('; ') || summary.zellij.capability?.status || 'unknown') + ')');
     });
 }
 async function narutoStatus(parsed) {
@@ -141,9 +164,11 @@ function parseNarutoArgs(args = []) {
     const writeModeRaw = String(readOption(args, '--write-mode', hasFlag(args, '--parallel-write') ? 'parallel' : '') || '');
     const writeMode = (['proof-safe', 'parallel', 'serial', 'off'].includes(writeModeRaw) ? writeModeRaw : null);
     const missionId = String(readOption(args, '--mission', readOption(args, '--mission-id', 'latest')));
+    const noOpenZellij = hasFlag(args, '--no-open-zellij') || hasFlag(args, '--no-zellij');
+    const attach = hasFlag(args, '--attach');
     const valueFlags = new Set(['--clones', '--agents', '--work-items', '--backend', '--write-mode', '--mission', '--mission-id']);
     const prompt = positionalArgs(rest, valueFlags).join(' ').trim() || 'Naruto shadow clone swarm run';
-    return { action, prompt, clones, workItems, backend, mock, real, readonly, writeMode, json, missionId };
+    return { action, prompt, clones, workItems, backend, mock, real, readonly, writeMode, json, missionId, noOpenZellij, attach };
 }
 function clampClones(value) {
     if (!Number.isFinite(value) || value < 1)

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

@@ -53,7 +53,8 @@ async function researchPrepare(args) {
         task: prompt,
         required_skills: route.requiredSkills,
         context7_required: context7Required,
-        subagents_required: routeRequiresSubagents(route, prompt),
+        subagents_required: false,
+        native_sessions_required: routeRequiresSubagents(route, prompt),
         reflection_required: reflectionRequiredForRoute(route),
         original_stop_gate: route.stopGate,
         stop_gate: route.stopGate,
@@ -72,8 +73,10 @@ async function researchPrepare(args) {
         implementation_allowed: false,
         context7_required: context7Required,
         context7_verified: false,
-        subagents_required: routeRequiresSubagents(route, prompt),
-        subagents_verified: false,
+        subagents_required: false,
+        subagents_verified: true,
+        native_sessions_required: routeRequiresSubagents(route, prompt),
+        native_sessions_verified: false,
         reflection_required: reflectionRequiredForRoute(route),
         visible_progress_required: true,
         context_tracking: 'triwiki',

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

@@ -364,11 +364,11 @@ function fastModeActionFromPrompt(prompt = '') {
         .trimStart()
         .toLowerCase();
     const token = afterRoute.match(/^[^\s?!.,;:()"'`]+/)?.[0] || '';
-    if (['off', 'disable', 'disabled', 'standard', 'slow', '끄기', '꺼', '꺼줘'].includes(token) || token.startsWith('끄') || token.startsWith('꺼'))
+    if (['off', 'disable', 'disabled', 'standard', 'default', 'slow', '끄기', '꺼', '꺼줘'].includes(token) || token.startsWith('끄') || token.startsWith('꺼'))
         return 'off';
-    if (['on', 'enable', 'enabled', 'fast', '켜기', '켜', '켜줘'].includes(token) || token.startsWith('켜'))
+    if (['on', 'enable', 'enabled', 'fast', 'priority', '켜기', '켜', '켜줘'].includes(token) || token.startsWith('켜'))
         return 'on';
-    if (['clear', 'reset', 'default', '초기화', '기본'].includes(token) || token.startsWith('초기화'))
+    if (['clear', 'reset', '초기화', '기본'].includes(token) || token.startsWith('초기화'))
         return 'clear';
     return 'status';
 }

package/dist/core/commands/team-command.d.ts

@@ -20,6 +20,7 @@ export declare function buildTeamPlan(id: any, prompt: any, opts?: any): {
     prompt: any;
     agent_session_count: number;
     default_agent_session_count: number;
+    target_active_slots: any;
     role_counts: Record<string, number>;
     session_policy: string;
     review_policy: {
@@ -119,7 +120,7 @@ export declare function buildTeamPlan(id: any, prompt: any, opts?: any): {
         goal: string;
         agents: string[];
         output: string;
-        max_parallel_subagents?: never;
+        max_parallel_native_sessions?: never;
         write_policy?: never;
         commands?: never;
         min_reviewer_lanes?: never;
@@ -127,7 +128,7 @@ export declare function buildTeamPlan(id: any, prompt: any, opts?: any): {
         id: string;
         goal: string;
         agents: any[];
-        max_parallel_subagents: number;
+        max_parallel_native_sessions: any;
         write_policy: string;
         output: string;
         commands?: never;
@@ -138,14 +139,14 @@ export declare function buildTeamPlan(id: any, prompt: any, opts?: any): {
         agents: string[];
         commands: string[];
         output: string;
-        max_parallel_subagents?: never;
+        max_parallel_native_sessions?: never;
         write_policy?: never;
         min_reviewer_lanes?: never;
     } | {
         id: string;
         goal: string;
         agents: any[];
-        max_parallel_subagents: number;
+        max_parallel_native_sessions: any;
         write_policy: string;
         output?: never;
         commands?: never;
@@ -155,7 +156,7 @@ export declare function buildTeamPlan(id: any, prompt: any, opts?: any): {
         goal: string;
         agents: string[];
         output?: never;
-        max_parallel_subagents?: never;
+        max_parallel_native_sessions?: never;
         write_policy?: never;
         commands?: never;
         min_reviewer_lanes?: never;
@@ -165,7 +166,7 @@ export declare function buildTeamPlan(id: any, prompt: any, opts?: any): {
         agents: any[];
         min_reviewer_lanes: number;
         output?: never;
-        max_parallel_subagents?: never;
+        max_parallel_native_sessions?: never;
         write_policy?: never;
         commands?: never;
     })[];