sneakoscope 1.20.4 → 1.20.5

package/README.md

@@ -16,6 +16,8 @@ Set up this agent project with Sneakoscope Codex. Use [[mandarange/Sneakoscope-C
 
 ## Current Release
 
+SKS **1.20.5** makes `sks --mad` actually open the Zellij session. 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.20.5"
 dependencies = [
  "serde_json",
 ]

package/crates/sks-core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "sks-core"
-version = "1.20.4"
+version = "1.20.5"
 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.20.5"),
         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.20.5",
+  "source_digest": "4ba5f14a828460ed0146c7109f59e53e148d6b1ffb42e8c01b00e64086da827e",
   "source_file_count": 1750,
-  "built_at_source_time": 1780281006481
+  "built_at_source_time": 1780287464818
 }

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.20.5';
 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.20.5",
+  "package_version": "1.20.5",
   "typescript": true,
   "mjs_runtime_files": 0,
   "compiled_file_count": 1020,
   "compiled_js_count": 510,
   "compiled_dts_count": 510,
-  "source_digest": "491c4c03f8a989f3ea78aa47b16a937edbd54e653b71ef79b5ce767916df7395",
+  "source_digest": "4ba5f14a828460ed0146c7109f59e53e148d6b1ffb42e8c01b00e64086da827e",
   "source_file_count": 1750,
   "source_files_hash": "de93b15a72352d00481b958333ed964bf083563809e3beddfe4e64046720df75",
   "source_list_hash": "de93b15a72352d00481b958333ed964bf083563809e3beddfe4e64046720df75",

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/fsx.d.ts

@@ -1,4 +1,4 @@
-export declare const PACKAGE_VERSION = "1.20.4";
+export declare const PACKAGE_VERSION = "1.20.5";
 export declare const DEFAULT_PROCESS_TAIL_BYTES: number;
 export declare const DEFAULT_PROCESS_TIMEOUT_MS: number;
 export interface RunProcessOptions {

package/dist/core/fsx.js

@@ -5,7 +5,7 @@ import os from 'node:os';
 import crypto from 'node:crypto';
 import { spawn } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
-export const PACKAGE_VERSION = '1.20.4';
+export const PACKAGE_VERSION = '1.20.5';
 export const DEFAULT_PROCESS_TAIL_BYTES = 256 * 1024;
 export const DEFAULT_PROCESS_TIMEOUT_MS = 30 * 60 * 1000;
 export function nowIso() {

package/dist/core/version.d.ts

@@ -1,2 +1,2 @@
-export declare const PACKAGE_VERSION = "1.20.4";
+export declare const PACKAGE_VERSION = "1.20.5";
 //# sourceMappingURL=version.d.ts.map

package/dist/core/version.js

@@ -1,2 +1,2 @@
-export const PACKAGE_VERSION = '1.20.4';
+export const PACKAGE_VERSION = '1.20.5';
 //# sourceMappingURL=version.js.map

package/dist/core/zellij/zellij-launcher.d.ts

@@ -165,5 +165,25 @@ export declare function launchTeamZellijView(opts?: ZellijLaunchOptions): Promis
     blockers: any[];
     warnings: string[];
 }>;
+export interface ZellijAttachResult {
+    ok: boolean;
+    status: number | null;
+    signal: NodeJS.Signals | null;
+    error?: string;
+}
+/**
+ * Attach the current terminal to an existing Zellij session in the foreground.
+ *
+ * `launchZellijLayout` only ever *creates* a detached background session, which
+ * is correct for proof/automation but means an interactive launch (e.g.
+ * `sks --mad`) never actually opens anything. This helper performs the
+ * follow-up foreground attach, inheriting stdio so the session takes over the
+ * user's terminal until they detach. It is a no-op-style failure (never throws)
+ * when Zellij is missing or attach fails, so callers can fall back to printing a
+ * manual attach hint.
+ */
+export declare function attachZellijSessionInteractive(sessionName: string, opts?: {
+    cwd?: string;
+}): ZellijAttachResult;
 export declare function sanitizeZellijSessionName(value: unknown): string;
 //# sourceMappingURL=zellij-launcher.d.ts.map

package/dist/core/zellij/zellij-launcher.js

@@ -1,4 +1,5 @@
 import path from 'node:path';
+import { spawnSync } from 'node:child_process';
 import { appendJsonl, nowIso, sha256, writeJsonAtomic } from '../fsx.js';
 import { checkZellijCapability } from './zellij-capability.js';
 import { formatZellijCommand, resolveZellijProcessEnvMeta, runZellij } from './zellij-command.js';
@@ -116,6 +117,38 @@ export async function launchTeamZellijView(opts = {}) {
         slotCount: opts.slotCount || 5
     });
 }
+/**
+ * Attach the current terminal to an existing Zellij session in the foreground.
+ *
+ * `launchZellijLayout` only ever *creates* a detached background session, which
+ * is correct for proof/automation but means an interactive launch (e.g.
+ * `sks --mad`) never actually opens anything. This helper performs the
+ * follow-up foreground attach, inheriting stdio so the session takes over the
+ * user's terminal until they detach. It is a no-op-style failure (never throws)
+ * when Zellij is missing or attach fails, so callers can fall back to printing a
+ * manual attach hint.
+ */
+export function attachZellijSessionInteractive(sessionName, opts = {}) {
+    if (!sessionName)
+        return { ok: false, status: null, signal: null, error: 'missing_session_name' };
+    const meta = resolveZellijProcessEnvMeta();
+    const env = { ...process.env };
+    if (meta.zellij_socket_dir && !env.ZELLIJ_SOCKET_DIR)
+        env.ZELLIJ_SOCKET_DIR = meta.zellij_socket_dir;
+    try {
+        const result = spawnSync('zellij', ['attach', sessionName], {
+            cwd: opts.cwd || process.cwd(),
+            env,
+            stdio: 'inherit'
+        });
+        if (result.error)
+            return { ok: false, status: null, signal: null, error: result.error.message };
+        return { ok: result.status === 0, status: result.status ?? null, signal: result.signal ?? null };
+    }
+    catch (err) {
+        return { ok: false, status: null, signal: null, error: err?.message || String(err) };
+    }
+}
 export function sanitizeZellijSessionName(value) {
     const cleaned = String(value || 'sks-session').replace(/[^A-Za-z0-9_.:-]+/g, '-').replace(/^-+|-+$/g, '');
     if (!cleaned)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sneakoscope",
   "displayName": "ㅅㅋㅅ",
-  "version": "1.20.4",
+  "version": "1.20.5",
   "description": "Sneakoscope Codex: fast proof-first Codex trust layer with image-based Voxel TriWiki.",
   "type": "module",
   "homepage": "https://github.com/mandarange/Sneakoscope-Codex#readme",