sneakoscope 0.6.64 → 0.6.69

package/README.md

@@ -6,18 +6,21 @@ Sneakoscope Codex (`sks`, displayed as `ㅅㅋㅅ`) is a Codex CLI/App harness f
 
 ## Quick Start
 
-Install globally, initialize the current project, then open the cmux runtime:
+Install globally, then run `sks` from either a project or any global shell location:
 
 ```sh
 npm i -g sneakoscope
+sks root
 sks bootstrap
 sks
 ```
 
+`sks root` tells you whether SKS found a project root or is using the per-user global runtime root. Outside a repo/project marker, runtime commands such as `sks`, `sks deps check`, `sks pipeline status`, and `sks team ...` use that global root instead of writing `.sneakoscope` into the random current directory.
+
 If you only want a one-shot run without keeping `sks` installed globally:
 
 ```sh
-npx -y -p sneakoscope sks bootstrap
+npx -y -p sneakoscope sks root
 ```
 
 For a repo-local install:
@@ -40,7 +43,7 @@ sks selftest --mock
 
 | Area | What it does |
 | --- | --- |
-| CLI runtime | `sks`, `sks cmux`, and `sks --mad --high` open Codex CLI in a cmux workspace. |
+| CLI runtime | `sks`, `sks cmux`, and `sks --mad` open Codex CLI in a cmux workspace. |
 | Codex App commands | Installs generated skills so `$Team`, `$DFix`, `$QA-LOOP`, `$Ralph`, `$DB`, `$Wiki`, `$Help`, and related routes are visible in prompt workflows. |
 | Team orchestration | Runs substantial work through ambiguity handling, scouts, TriWiki refresh, debate, runtime task graphs, worker inboxes, implementation, review, cleanup, reflection, and Honest Mode. |
 | QA loop | Dogfoods UI/API behavior with safety gates, Browser/Computer evidence, safe fixes, and rechecks. |
@@ -59,7 +62,7 @@ sks selftest --mock
 - cmux for the CLI-first runtime
 - Context7 MCP for current-docs-gated routes
 
-On macOS, `sks --mad --high` can install cmux through Homebrew when cmux is missing. You can also install it manually:
+On macOS, `sks --mad` can install cmux through Homebrew when cmux is missing. You can also install it manually:
 
 ```sh
 brew tap manaflow-ai/cmux
@@ -70,8 +73,17 @@ If the CLI is not on `PATH`, SKS also checks the app bundle path:
 
 ```sh
 /Applications/cmux.app/Contents/Resources/bin/cmux
+/Applications/cmux.app/Contents/MacOS/cmux
 ```
 
+`sks --mad` is stricter than the normal runtime path:
+
+- Checks npm for a newer `sneakoscope` before launch and asks whether to update when the terminal can answer y/n.
+- Installs the latest Codex CLI with `npm i -g @openai/codex@latest` when it is missing and you approve or pass `--yes`.
+- Installs or upgrades the latest cmux cask through Homebrew when cmux is missing or not launchable.
+- Re-probes the real cmux binary after install instead of trusting Homebrew's success text alone.
+- Wakes cmux and retries the socket probe; if the socket is broken, SKS attempts a cmux app restart during that explicit launch.
+
 ## Installation
 
 ### Global Install
@@ -80,10 +92,11 @@ Use this when you want `sks` available from any repo:
 
 ```sh
 npm i -g sneakoscope
+sks root
 sks bootstrap
 ```
 
-`sks bootstrap` initializes the current project, installs Codex App skills/hooks/config, checks Context7/Codex App/cmux readiness, and prints a ready status.
+`sks` commands work even when no project root is present. Project-aware commands use the nearest `.sneakoscope`, `.dcodex`, or `.git` root; if none exists, SKS uses a per-user global runtime root. `sks bootstrap` still initializes the current project when you want project-local hooks, skills, and TriWiki state.
 
 ### One-Shot Install
 
@@ -154,24 +167,34 @@ sks cmux status --once
 
 `sks` opens a cmux workspace for Codex CLI when running in an interactive terminal. `sks cmux check` is diagnostic and prints readiness without starting a workspace.
 
-### MAD High cmux Workspace
+### MAD cmux Workspace
 
 ```sh
-sks --mad --high
+sks --mad
+sks --mad --yes
+```
+
+This creates/uses the `sks-mad-high` Codex profile for a one-shot full-access, high-reasoning cmux workspace with `approval_policy = "on-request"` and `approvals_reviewer = "auto_review"`. It is scoped to that explicit command and does not change normal SKS/DB safety defaults.
+
+Before launching, SKS checks whether a newer `sneakoscope` exists on npm. In an interactive terminal it prompts:
+
+```text
+SKS 0.x.y -> 0.x.z update before MAD launch? [Y/n]
 ```
 
-This creates/uses the `sks-mad-high` Codex profile for a one-shot full-access, high-reasoning cmux workspace. It is scoped to that explicit command and does not change normal SKS/DB safety defaults.
+Answer `y` to install `sneakoscope@latest`, then rerun `sks --mad`. Answer `n` to continue with the current version. Use `--yes` to approve missing dependency installs automatically.
 
 ### Team Missions
 
 ```sh
 sks team "implement this feature" executor:3 reviewer:1
 sks team watch latest
+sks team lane latest --agent analysis_scout_1 --follow
 sks team status latest
 sks team log latest
 ```
 
-Team mode prepares the mission, records live events, compiles runtime tasks and worker inboxes, and opens cmux live lanes when cmux is available.
+Team mode prepares the mission, records live events, compiles runtime tasks and worker inboxes, and opens cmux live lanes when cmux is available. `sks team lane` renders one agent's status, assigned runtime tasks, recent events, and a fallback global tail for multi-pane monitoring.
 
 ### QA, Ralph, Research, DB, Wiki, GX
 
@@ -191,7 +214,7 @@ sks gx render homepage --format html
 
 Sneakoscope has two surfaces:
 
-- Terminal commands such as `sks deps check`, `sks team "task"`, and `sks --mad --high`
+- Terminal commands such as `sks deps check`, `sks team "task"`, and `sks --mad`
 - Codex App prompt commands such as `$Team`, `$DFix`, `$QA-LOOP`, and `$Wiki`
 
 After installing, run:
@@ -269,7 +292,7 @@ sks
 For the high-reasoning full-access profile:
 
 ```sh
-sks --mad --high
+sks --mad
 ```
 
 ### Use Codex App `$Team`
@@ -331,7 +354,7 @@ sks deps install cmux
 sks cmux check
 ```
 
-`sks --mad --high` also attempts Homebrew installation automatically on macOS when cmux is missing.
+`sks --mad` also attempts Homebrew installation or upgrade automatically on macOS when cmux is missing. If Homebrew reports the cask installed but the CLI still is not reachable, SKS checks the cmux app bundle paths directly, wakes the app, and retries the socket before reporting a remaining cmux app/socket issue.
 
 ### Codex App tools are missing
 
@@ -356,6 +379,7 @@ OMX/DCodex conflicts intentionally block setup/doctor until the user approves cl
 ```sh
 sks pipeline status --json
 sks team watch latest
+sks team lane latest --agent parent_orchestrator --follow
 sks wiki validate .sneakoscope/wiki/context-pack.json
 ```
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sneakoscope",
   "displayName": "ㅅㅋㅅ",
-  "version": "0.6.64",
+  "version": "0.6.69",
   "description": "Sneakoscope Codex: database-safe Codex CLI/App harness with Team, Ralph, AutoResearch, TriWiki, and Honest Mode.",
   "type": "module",
   "homepage": "https://github.com/mandarange/Sneakoscope-Codex#readme",