sneakoscope 0.6.66 → 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:
@@ -89,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
 
@@ -185,11 +189,12 @@ Answer `y` to install `sneakoscope@latest`, then rerun `sks --mad`. Answer `n` t
 ```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
 
@@ -374,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.66",
+  "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",

package/src/cli/main.mjs

@@ -3,7 +3,7 @@ import os from 'node:os';
 import fsp from 'node:fs/promises';
 import readline from 'node:readline/promises';
 import { stdin as input, stdout as output } from 'node:process';
-import { projectRoot, readJson, writeJsonAtomic, writeTextAtomic, appendJsonlBounded, nowIso, exists, ensureDir, tmpdir, packageRoot, dirSize, formatBytes, which, runProcess, PACKAGE_VERSION } from '../core/fsx.mjs';
+import { projectRoot, readJson, writeJsonAtomic, writeTextAtomic, appendJsonlBounded, nowIso, exists, ensureDir, tmpdir, packageRoot, dirSize, formatBytes, which, runProcess, PACKAGE_VERSION, sksRoot, globalSksRoot, findProjectRoot } from '../core/fsx.mjs';
 import { initProject, installSkills, normalizeInstallScope, sksCommandPrefix } from '../core/init.mjs';
 import { getCodexInfo, runCodexExec } from '../core/codex-adapter.mjs';
 import { createMission, loadMission, findLatestMission, missionDir, setCurrent, stateFile } from '../core/mission.mjs';
@@ -28,7 +28,7 @@ import { rgbaKey, rgbaToWikiCoord, validateWikiCoordinateIndex } from '../core/w
 import { COMMAND_CATALOG, DOLLAR_COMMAND_ALIASES, DOLLAR_COMMANDS, DOLLAR_SKILL_NAMES, FROM_CHAT_IMG_CHECKLIST_ARTIFACT, FROM_CHAT_IMG_COVERAGE_ARTIFACT, FROM_CHAT_IMG_QA_LOOP_ARTIFACT, FROM_CHAT_IMG_TEMP_TRIWIKI_ARTIFACT, FROM_CHAT_IMG_TEMP_TRIWIKI_SESSIONS, RECOMMENDED_SKILLS, ROUTES, USAGE_TOPICS, context7ConfigToml, hasContext7ConfigText, hasFromChatImgSignal, looksLikeAnswerOnlyRequest, reflectionRequiredForRoute, reasoningInstruction, routePrompt, routeReasoning, routeRequiresSubagents, stackCurrentDocsPolicy, triwikiContextTracking } from '../core/routes.mjs';
 import { context7Evidence, evaluateStop, recordContext7Evidence, recordSubagentEvidence } from '../core/pipeline.mjs';
 import { TEAM_DECOMPOSITION_ARTIFACT, TEAM_GRAPH_ARTIFACT, TEAM_INBOX_DIR, TEAM_RUNTIME_TASKS_ARTIFACT, teamRuntimePlanMetadata, teamRuntimeRequiredArtifacts, validateTeamRuntimeArtifacts, writeTeamRuntimeArtifacts } from '../core/team-dag.mjs';
-import { appendTeamEvent, formatRoleCounts, initTeamLive, normalizeTeamSpec, parseTeamSpecArgs, parseTeamSpecText, readTeamDashboard, readTeamLive, readTeamTranscriptTail } from '../core/team-live.mjs';
+import { appendTeamEvent, formatRoleCounts, initTeamLive, normalizeTeamSpec, parseTeamSpecArgs, parseTeamSpecText, readTeamDashboard, readTeamLive, readTeamTranscriptTail, renderTeamAgentLane } from '../core/team-live.mjs';
 import { CODEX_APP_DOCS_URL, codexAppIntegrationStatus, formatCodexAppStatus } from '../core/codex-app.mjs';
 import { CMUX_BREW_COMMAND, CMUX_BREW_UPGRADE_COMMAND, buildCmuxLaunchPlan, defaultCmuxWorkspaceName, ensureCmuxInstalled, formatCmuxBanner, launchCmuxTeamView, launchCmuxUi, platformCmuxInstallHint, runCmuxStatus, sanitizeCmuxWorkspaceName, cmuxAvailable } from '../core/cmux-ui.mjs';
 import { autoReviewProfileName, autoReviewStatus, autoReviewSummary, enableAutoReview, disableAutoReview, enableMadHighProfile, madHighProfileName } from '../core/auto-review.mjs';
@@ -63,6 +63,7 @@ export async function main(args) {
   if (cmd === 'help') return help(tail);
   if (cmd === 'commands') return commands(tail);
   if (cmd === 'usage') return usage(tail);
+  if (cmd === 'root') return rootCommand(tail);
   if (cmd === 'quickstart') return quickstart();
   if (cmd === 'codex-app') return codexAppHelp(tail);
   if (cmd === 'bootstrap') return bootstrap(tail);
@@ -112,6 +113,7 @@ Usage:
   sks wizard
   sks commands [--json]
   sks usage [${USAGE_TOPICS}]
+  sks root [--json]
   sks quickstart
   sks bootstrap [--install-scope global|project] [--local-only] [--json]
   sks deps check|install [cmux|codex|context7|all] [--yes] [--json]
@@ -145,7 +147,7 @@ Usage:
   sks ralph run <mission-id|latest> [--mock] [--max-cycles N]
   sks ralph status <mission-id|latest>
   sks team "task" [executor:5 reviewer:2 user:1] [--json]
-  sks team log|tail|watch|status [mission-id|latest]
+  sks team log|tail|watch|lane|status [mission-id|latest]
   sks team event [mission-id|latest] --agent <name> --phase <phase> --message "..."
   sks research prepare "topic" [--depth frontier]
   sks research run <mission-id|latest> [--mock] [--max-cycles N]
@@ -504,6 +506,27 @@ function commands(args = []) {
   console.log(`\nCanonical Codex App picker skills: ${DOLLAR_COMMAND_ALIASES.map((x) => x.app_skill).join(', ')}`);
 }
 
+async function rootCommand(args = []) {
+  const project = await findProjectRoot();
+  const global = globalSksRoot();
+  const active = await sksRoot();
+  const result = {
+    cwd: process.cwd(),
+    mode: project ? 'project' : 'global',
+    active_root: active,
+    project_root: project,
+    global_root: global,
+    using_global_root: !project
+  };
+  if (flag(args, '--json')) return console.log(JSON.stringify(result, null, 2));
+  console.log('SKS Root\n');
+  console.log(`Mode:        ${result.mode}`);
+  console.log(`Active root: ${active}`);
+  console.log(`Project:     ${project || 'none'}`);
+  console.log(`Global root: ${global}`);
+  if (!project) console.log('\nNo project marker was found here, so SKS will use the per-user global runtime root. Run `sks bootstrap` to initialize the current directory as a project.');
+}
+
 function dollarCommands(args = []) {
   if (flag(args, '--json')) return console.log(JSON.stringify({ dollar_commands: DOLLAR_COMMANDS, app_skill_aliases: DOLLAR_COMMAND_ALIASES }, null, 2));
   console.log('ㅅㅋㅅ $ Commands\n');
@@ -549,8 +572,9 @@ Rules:
 }
 
 async function context7(sub = 'check', args = []) {
-  const root = await projectRoot();
   const action = sub || 'check';
+  const setupScope = action === 'setup' ? readOption(args, '--scope', flag(args, '--global') ? 'global' : 'project') : null;
+  const root = action === 'setup' && setupScope === 'project' ? await projectRoot() : await sksRoot();
   if (action === 'check') {
     const result = await checkContext7(root);
     if (flag(args, '--json')) return console.log(JSON.stringify(result, null, 2));
@@ -636,7 +660,7 @@ async function context7(sub = 'check', args = []) {
     return;
   }
   if (action === 'setup') {
-    const scope = readOption(args, '--scope', flag(args, '--global') ? 'global' : 'project');
+    const scope = setupScope;
     const transport = readOption(args, '--transport', flag(args, '--remote') ? 'remote' : 'local');
     if (!['project', 'global'].includes(scope)) throw new Error('Invalid Context7 scope. Use project or global.');
     if (!['local', 'remote'].includes(transport)) throw new Error('Invalid Context7 transport. Use local or remote.');
@@ -673,7 +697,7 @@ function printContext7DocsResult(result, opts = {}) {
 }
 
 async function pipeline(sub = 'status', args = []) {
-  const root = await projectRoot();
+  const root = await sksRoot();
   const action = sub || 'status';
   if (action === 'answer') return pipelineAnswer(root, args);
   const state = await readJson(stateFile(root), {});
@@ -1022,7 +1046,7 @@ async function cmuxCommand(sub = 'start', args = []) {
     return;
   }
   if (action === 'check') {
-    const root = await projectRoot();
+    const root = await sksRoot();
     const plan = await buildCmuxLaunchPlan({ root, session: readOption(args, '--session', null) });
     if (flag(args, '--json')) return console.log(JSON.stringify(plan, null, 2));
     console.log(formatCmuxBanner(plan.app));
@@ -1111,14 +1135,14 @@ async function ensureMadLaunchDependencies(args = []) {
     const cmux = await cmuxAvailable().catch(() => ({ ok: false }));
     if (!cmux.ok && !cmux.bin) actions.push(await installCmuxDependency(args));
   }
-  const status = await depsStatus(await projectRoot());
+  const status = await depsStatus(await sksRoot());
   return { ready: Boolean(status.codex_cli.ok && (status.cmux.ok || status.cmux.bin)), actions, status };
 }
 
 async function deps(sub = 'check', args = []) {
   const action = sub || 'check';
   if (action === 'check' || action === 'status') {
-    const root = await projectRoot();
+    const root = await sksRoot();
     const status = await depsStatus(root);
     if (flag(args, '--json')) return console.log(JSON.stringify(status, null, 2));
     printDepsStatus(status);
@@ -1131,7 +1155,7 @@ async function deps(sub = 'check', args = []) {
 }
 
 async function depsStatus(root = null, opts = {}) {
-  root ||= await projectRoot();
+  root ||= await sksRoot();
   const npmBin = await which('npm').catch(() => null);
   const codex = opts.codex || await getCodexInfo().catch(() => ({}));
   const app = opts.codexApp || await codexAppIntegrationStatus({ codex });
@@ -1195,7 +1219,7 @@ function printDepsStatus(status) {
 }
 
 async function depsInstall(args = []) {
-  const root = await projectRoot();
+  const root = await sksRoot();
   const target = positionalArgs(args)[0] || 'all';
   const wants = target === 'all' ? ['codex', 'context7', 'cmux'] : [target];
   const actions = [];
@@ -1308,9 +1332,15 @@ function quickstart() {
 
 First install and bootstrap this project:
   npm i -g sneakoscope
+  sks root
   sks bootstrap
   sks
 
+Use outside a project:
+  sks root
+  sks deps check
+  sks team "global mission"
+
 If cmux is missing:
   sks deps install cmux
 
@@ -1411,12 +1441,13 @@ Examples:
 function usage(args = []) {
   const topic = String(args[0] || 'overview').toLowerCase();
   const blocks = {
-    overview: ['ㅅㅋㅅ Usage', '', 'Discover:', '  sks commands', '  sks quickstart', '  sks bootstrap', '  sks deps check', '  sks codex-app check', '  sks cmux check', '  sks dollar-commands', '', `Topics: ${USAGE_TOPICS}`],
-    install: ['Install', '', '  npm i -g sneakoscope', '  sks bootstrap', '  sks', '', 'Fallback:', '  npx -y -p sneakoscope sks bootstrap', '', 'Project:', '  npm i -D sneakoscope', '  npx sks setup --install-scope project'],
+    overview: ['ㅅㅋㅅ Usage', '', 'Discover:', '  sks commands', '  sks quickstart', '  sks root', '  sks bootstrap', '  sks deps check', '  sks codex-app check', '  sks cmux check', '  sks dollar-commands', '', `Topics: ${USAGE_TOPICS}`],
+    install: ['Install', '', '  npm i -g sneakoscope', '  sks root', '  sks', '', 'Project bootstrap:', '  sks bootstrap', '', 'Fallback:', '  npx -y -p sneakoscope sks root', '', 'Project:', '  npm i -D sneakoscope', '  npx sks setup --install-scope project'],
     bootstrap: ['Bootstrap', '', '  sks bootstrap', '  sks setup --bootstrap', '', 'Creates project SKS files, Codex App skills/hooks/config, state/guard files, then checks Codex App, Context7, and cmux.'],
+    root: ['Root', '', '  sks root [--json]', '', 'Inside a project, SKS uses that project root. Outside any project marker, runtime commands use the per-user global SKS root instead of writing .sneakoscope into the current random folder.'],
     deps: ['Dependencies', '', '  sks deps check [--json]', '  sks deps install [cmux|codex|context7|all] [--yes]', '', 'cmux on macOS uses Homebrew only after approval.'],
     cmux: ['cmux', '', '  sks', '  sks cmux check', '  sks cmux status --once', '  sks deps install cmux'],
-    team: ['Team', '', '  sks team "task" executor:5 reviewer:2 user:1', '  sks team watch latest', '', '$Team runs questions -> contract -> scouts -> TriWiki attention -> debate -> runtime graph/inbox -> fresh executors -> review -> cleanup -> reflection -> Honest.'],
+    team: ['Team', '', '  sks team "task" executor:5 reviewer:2 user:1', '  sks team watch latest', '  sks team lane latest --agent analysis_scout_1 --follow', '', '$Team runs questions -> contract -> scouts -> TriWiki attention -> debate -> runtime graph/inbox -> fresh executors -> review -> cleanup -> reflection -> Honest.'],
     'qa-loop': ['QA-LOOP', '', '  sks qa-loop prepare "QA this app"', '  sks qa-loop answer <MISSION_ID> answers.json', '  sks qa-loop run <MISSION_ID> --max-cycles 8', '', 'Report: YYYY-MM-DD-v<version>-qa-report.md'],
     ralph: ['Ralph', '', '  sks ralph prepare "task"', '  sks ralph answer <MISSION_ID> answers.json', '  sks ralph run <MISSION_ID> --max-cycles 8'],
     'codex-app': ['Codex App', '', '  sks bootstrap', '  sks codex-app check', '  sks dollar-commands', '  cat .codex/SNEAKOSCOPE.md'],
@@ -1608,7 +1639,7 @@ async function fixPath(args) {
 }
 
 async function doctor(args) {
-  const root = await projectRoot();
+  const root = await sksRoot();
   const requestedScope = args.includes('--install-scope') || flag(args, '--project') || flag(args, '--global')
     ? installScopeFromArgs(args)
     : null;
@@ -1731,7 +1762,7 @@ async function checkRequiredSkills(root, skillRoot = path.join(root, '.agents',
 }
 
 async function codexAppSkillReadiness(root = null) {
-  root ||= await projectRoot();
+  root ||= await sksRoot();
   const project = await checkRequiredSkills(root);
   const global = await checkRequiredSkills(null, globalCodexSkillsRoot());
   return { ok: project.ok || global.ok, project, global };
@@ -1892,7 +1923,7 @@ function qaRoute() {
 }
 
 async function qaLoopPrepare(args) {
-  const root = await projectRoot();
+  const root = await sksRoot();
   if (!(await exists(path.join(root, '.sneakoscope')))) await initProject(root, {});
   const prompt = promptOf(args);
   if (!prompt) throw new Error('Missing QA target prompt.');
@@ -1912,7 +1943,7 @@ async function qaLoopPrepare(args) {
 }
 
 async function qaLoopAnswer(args) {
-  const root = await projectRoot();
+  const root = await sksRoot();
   const [missionArg, answerFile] = args;
   const id = await resolveMissionId(root, missionArg);
   if (!id || !answerFile) throw new Error('Usage: sks qa-loop answer <mission-id|latest> <answers.json>');
@@ -1937,7 +1968,7 @@ async function qaLoopAnswer(args) {
 }
 
 async function qaLoopRun(args) {
-  const root = await projectRoot();
+  const root = await sksRoot();
   const id = await resolveMissionId(root, args[0]);
   if (!id) throw new Error('Usage: sks qa-loop run <mission-id|latest> [--mock] [--max-cycles N]');
   const { dir, mission } = await loadMission(root, id);
@@ -2002,7 +2033,7 @@ async function qaLoopRun(args) {
 }
 
 async function qaLoopStatus(args) {
-  const root = await projectRoot();
+  const root = await sksRoot();
   const id = await resolveMissionId(root, args[0]);
   if (!id) throw new Error('Usage: sks qa-loop status <mission-id|latest>');
   const { dir, mission } = await loadMission(root, id);
@@ -2019,7 +2050,7 @@ async function qaLoopStatus(args) {
 }
 
 async function researchPrepare(args) {
-  const root = await projectRoot();
+  const root = await sksRoot();
   if (!(await exists(path.join(root, '.sneakoscope')))) await initProject(root, {});
   const prompt = positionalArgs(args).join(' ').trim();
   if (!prompt) throw new Error('Missing research topic.');
@@ -2033,7 +2064,7 @@ async function researchPrepare(args) {
 }
 
 async function researchRun(args) {
-  const root = await projectRoot();
+  const root = await sksRoot();
   const id = await resolveMissionId(root, args[0]);
   if (!id) throw new Error('Usage: sks research run <mission-id|latest> [--mock] [--max-cycles N]');
   const { dir, mission } = await loadMission(root, id);
@@ -2095,7 +2126,7 @@ async function researchRun(args) {
 }
 
 async function researchStatus(args) {
-  const root = await projectRoot();
+  const root = await sksRoot();
   const id = await resolveMissionId(root, args[0]);
   if (!id) throw new Error('Usage: sks research status <mission-id|latest>');
   const { dir, mission } = await loadMission(root, id);
@@ -2106,7 +2137,7 @@ async function researchStatus(args) {
 }
 
 async function ralphPrepare(args) {
-  const root = await projectRoot();
+  const root = await sksRoot();
   if (!(await exists(path.join(root, '.sneakoscope')))) await initProject(root, {});
   const prompt = promptOf(args);
   if (!prompt) throw new Error('Missing task prompt.');
@@ -2124,7 +2155,7 @@ async function ralphPrepare(args) {
 }
 
 async function ralphAnswer(args) {
-  const root = await projectRoot();
+  const root = await sksRoot();
   const [missionArg, answerFile] = args;
   const id = await resolveMissionId(root, missionArg);
   if (!id || !answerFile) throw new Error('Usage: sks ralph answer <mission-id|latest> <answers.json>');
@@ -2145,7 +2176,7 @@ async function ralphAnswer(args) {
 }
 
 async function ralphRun(args) {
-  const root = await projectRoot();
+  const root = await sksRoot();
   const id = await resolveMissionId(root, args[0]);
   if (!id) throw new Error('Usage: sks ralph run <mission-id|latest> [--mock]');
   const { dir, mission } = await loadMission(root, id);
@@ -2229,7 +2260,7 @@ async function ralphRunMock(root, id, dir) {
 }
 
 async function ralphStatus(args) {
-  const root = await projectRoot();
+  const root = await sksRoot();
   const id = await resolveMissionId(root, args[0]);
   if (!id) throw new Error('Usage: sks ralph status <mission-id|latest>');
   const { dir, mission } = await loadMission(root, id);
@@ -2321,6 +2352,18 @@ async function selftest() {
   const depsCheck = await runProcess(process.execPath, [path.join(packageRoot(), 'bin', 'sks.mjs'), 'deps', 'check', '--json'], { cwd: bootstrapJsonTmp, env: { HOME: path.join(bootstrapJsonTmp, 'home') }, timeoutMs: 20000, maxOutputBytes: 256 * 1024 });
   const depsResult = JSON.parse(depsCheck.stdout);
   if (!depsResult.node?.ok || !('cmux' in depsResult) || !('homebrew' in depsResult)) throw new Error('selftest failed: deps check json missing expected fields');
+  const globalCwd = tmpdir();
+  const globalRuntimeRoot = path.join(tmpdir(), 'sks-global-root');
+  const globalRootProbe = await runProcess(process.execPath, [path.join(packageRoot(), 'bin', 'sks.mjs'), 'root', '--json'], { cwd: globalCwd, env: { SKS_GLOBAL_ROOT: globalRuntimeRoot }, timeoutMs: 15000, maxOutputBytes: 64 * 1024 });
+  const globalRootResult = JSON.parse(globalRootProbe.stdout);
+  if (globalRootResult.mode !== 'global' || globalRootResult.active_root !== globalRuntimeRoot || globalRootResult.project_root !== null) throw new Error('selftest failed: global root probe did not use SKS_GLOBAL_ROOT outside a project');
+  const globalPipeline = await runProcess(process.execPath, [path.join(packageRoot(), 'bin', 'sks.mjs'), 'pipeline', 'status', '--json'], { cwd: globalCwd, env: { SKS_GLOBAL_ROOT: globalRuntimeRoot }, timeoutMs: 15000, maxOutputBytes: 64 * 1024 });
+  const globalPipelineResult = JSON.parse(globalPipeline.stdout);
+  if (globalPipelineResult.root !== globalRuntimeRoot) throw new Error('selftest failed: pipeline status did not use global runtime root outside a project');
+  const globalTeam = await runProcess(process.execPath, [path.join(packageRoot(), 'bin', 'sks.mjs'), 'team', 'global path smoke', '--json'], { cwd: globalCwd, env: { SKS_GLOBAL_ROOT: globalRuntimeRoot }, timeoutMs: 30000, maxOutputBytes: 256 * 1024 });
+  const globalTeamResult = JSON.parse(globalTeam.stdout);
+  if (!String(globalTeamResult.mission_dir || '').startsWith(path.join(globalRuntimeRoot, '.sneakoscope', 'missions')) || !(await exists(path.join(globalRuntimeRoot, '.sneakoscope', 'manifest.json')))) throw new Error('selftest failed: team mission did not materialize under global runtime root');
+  if (await exists(path.join(globalCwd, '.sneakoscope'))) throw new Error('selftest failed: global runtime command polluted the caller cwd with .sneakoscope');
   const madProfilePath = path.join(tmp, 'mad-codex-config.toml');
   const madProfile = await enableMadHighProfile({ configPath: madProfilePath });
   const madProfileText = await safeReadText(madProfilePath);
@@ -2464,6 +2507,8 @@ async function selftest() {
   if (!promptPipelineText.includes('From-Chat-IMG') || !promptPipelineText.includes('Do not assume ordinary image prompts are chat captures')) throw new Error('selftest failed: prompt pipeline missing explicit From-Chat-IMG gating');
   const fromChatImgSkillText = await safeReadText(path.join(tmp, '.agents', 'skills', 'from-chat-img', 'SKILL.md'));
   if (!fromChatImgSkillText.includes('normal Team pipeline') || !fromChatImgSkillText.includes('Computer Use/browser visual inspection') || !fromChatImgSkillText.includes(FROM_CHAT_IMG_CHECKLIST_ARTIFACT) || !fromChatImgSkillText.includes(FROM_CHAT_IMG_TEMP_TRIWIKI_ARTIFACT) || !fromChatImgSkillText.includes(FROM_CHAT_IMG_QA_LOOP_ARTIFACT)) throw new Error('selftest failed: from-chat-img skill missing Team/browser inspection checklist guidance');
+  const fromChatImgSkillMeta = await safeReadText(path.join(tmp, '.agents', 'skills', 'from-chat-img', 'agents', 'openai.yaml'));
+  if (!fromChatImgSkillMeta.includes('model_reasoning_effort: xhigh')) throw new Error('selftest failed: from-chat-img skill metadata is not xhigh');
   for (const supportSkill of ['reasoning-router', 'pipeline-runner', 'context7-docs', 'seo-geo-optimizer', 'reflection', 'design-system-builder', 'design-ui-editor', 'imagegen']) {
     if (!(await exists(path.join(tmp, '.agents', 'skills', supportSkill, 'SKILL.md')))) throw new Error(`selftest failed: ${supportSkill} skill not installed`);
   }
@@ -2498,7 +2543,7 @@ async function selftest() {
   if (!DOLLAR_DEFAULT_PIPELINE_TEXT.includes('$Team')) throw new Error('selftest failed: dollar-commands missing Team default routing guidance');
   if (!DOLLAR_DEFAULT_PIPELINE_TEXT.includes('$From-Chat-IMG')) throw new Error('selftest failed: dollar-commands missing From-Chat-IMG guidance');
   if (!DOLLAR_DEFAULT_PIPELINE_TEXT.includes('$MAD-SKS')) throw new Error('selftest failed: dollar-commands missing MAD-SKS scoped override guidance');
-  if (!COMMAND_CATALOG.some((c) => c.name === 'context7') || !COMMAND_CATALOG.some((c) => c.name === 'pipeline') || !COMMAND_CATALOG.some((c) => c.name === 'qa-loop')) throw new Error('selftest failed: context7/pipeline/qa-loop commands missing from catalog');
+  if (!COMMAND_CATALOG.some((c) => c.name === 'context7') || !COMMAND_CATALOG.some((c) => c.name === 'pipeline') || !COMMAND_CATALOG.some((c) => c.name === 'qa-loop') || !COMMAND_CATALOG.some((c) => c.name === 'root')) throw new Error('selftest failed: context7/pipeline/qa-loop/root commands missing from catalog');
   const registryDollarCommands = DOLLAR_COMMANDS.map((c) => c.command);
   const manifest = await readJson(path.join(tmp, '.sneakoscope', 'manifest.json'));
   const policy = await readJson(path.join(tmp, '.sneakoscope', 'policy.json'));
@@ -2967,8 +3012,9 @@ async function selftest() {
   if (roleTeamPlan.roster.development_team.filter((agent) => agent.role === 'executor').length !== 5) throw new Error('selftest failed: executor role count not reflected in development team');
   if (!roleTeamPlan.roster.debate_team.some((agent) => /inconvenience/.test(agent.persona))) throw new Error('selftest failed: user friction persona missing from debate team');
   const cmuxTeam = await launchCmuxTeamView({ root: tmp, missionId: teamId, plan: roleTeamPlan, json: true });
-  if (!cmuxTeam.agents?.length || !cmuxTeam.agents.some((entry) => entry.agent === 'analysis_scout_1') || !cmuxTeam.agents.every((entry) => String(entry.command || '').includes('team watch'))) throw new Error('selftest failed: Team cmux view did not expose agent live lanes');
+  if (!cmuxTeam.agents?.length || !cmuxTeam.agents.some((entry) => entry.agent === 'analysis_scout_1') || !cmuxTeam.agents.every((entry) => String(entry.command || '').includes('team lane') && String(entry.command || '').includes('--agent'))) throw new Error('selftest failed: Team cmux view did not expose agent live lanes');
   if (routeReasoning(routePrompt('$Research frontier idea'), '$Research frontier idea').effort !== 'xhigh') throw new Error('selftest failed: research reasoning not xhigh');
+  if (routeReasoning(routePrompt('$From-Chat-IMG 채팅 이미지 작업'), '$From-Chat-IMG 채팅 이미지 작업').effort !== 'xhigh') throw new Error('selftest failed: From-Chat-IMG reasoning not xhigh');
   if (routeReasoning(routePrompt('$DB migration'), '$DB migration').effort !== 'high') throw new Error('selftest failed: logical reasoning not high');
   if (routeReasoning(routePrompt('$DFix button label'), '$DFix button label').effort !== 'medium') throw new Error('selftest failed: simple reasoning not medium');
   if (routePrompt('이 파이프라인은 왜 이렇게 동작해?')?.id !== 'Answer') throw new Error('selftest failed: question prompt did not route to Answer');
@@ -3004,6 +3050,10 @@ async function selftest() {
   if (!teamLive.includes('selftest mapped options')) throw new Error('selftest failed: team live transcript missing event');
   if (!teamLive.includes('Context tracking SSOT: TriWiki')) throw new Error('selftest failed: team live transcript missing TriWiki context tracking');
   if (!(await readTeamTranscriptTail(teamDir, 1)).join('\n').includes('selftest mapped options')) throw new Error('selftest failed: team transcript tail missing event');
+  const teamLane = await renderTeamAgentLane(teamDir, { missionId: teamId, agent: 'analysis_scout_1', lines: 4 });
+  if (!teamLane.includes('SKS Team Agent Lane') || !teamLane.includes('analysis_scout_1') || !teamLane.includes('selftest mapped repo slice')) throw new Error('selftest failed: team agent lane missing agent event context');
+  const teamLaneCli = await runProcess(process.execPath, [hookBin, 'team', 'lane', teamId, '--agent', 'analysis_scout_1', '--lines', '4'], { cwd: tmp, env: { SKS_DISABLE_UPDATE_CHECK: '1' }, timeoutMs: 15000, maxOutputBytes: 64 * 1024 });
+  if (teamLaneCli.code !== 0 || !String(teamLaneCli.stdout || '').includes('SKS Team Agent Lane') || !String(teamLaneCli.stdout || '').includes('analysis_scout_1')) throw new Error('selftest failed: sks team lane CLI did not render an agent lane');
   await writeTextAtomic(path.join(teamDir, 'team-analysis.md'), '- claim: analysis scout mapped route registry | source: src/core/routes.mjs | risk: high | confidence: supported\n');
   const installUxSchema = buildQuestionSchema('SKS first install/bootstrap UX and Context7 MCP setup improvement');
   const installUxSlotIds = installUxSchema.slots.map((s) => s.id);
@@ -3118,7 +3168,7 @@ async function selftest() {
 }
 
 async function profile(sub, args) {
-  const root = await projectRoot();
+  const root = await sksRoot();
   if (sub === 'show') return console.log(JSON.stringify(await readJson(path.join(root, '.sneakoscope', 'model', 'current.json'), { model: 'gpt-5.5' }), null, 2));
   if (sub === 'set') { await writeJsonAtomic(path.join(root, '.sneakoscope', 'model', 'current.json'), { model: args[0] || 'gpt-5.5', set_at: nowIso() }); return console.log(`Model profile set: ${args[0] || 'gpt-5.5'}`); }
   console.error('Usage: sks profile show|set <model>');
@@ -3126,7 +3176,7 @@ async function profile(sub, args) {
 
 async function hproof(sub, args) {
   if (sub !== 'check') return console.error('Usage: sks hproof check [mission-id]');
-  const root = await projectRoot();
+  const root = await sksRoot();
   const id = await resolveMissionId(root, args[0]);
   if (!id) throw new Error('No mission found.');
   console.log(JSON.stringify(await evaluateDoneGate(root, id), null, 2));
@@ -3138,7 +3188,7 @@ async function evalCommand(sub, args) {
     return;
   }
   if (sub === 'thresholds') return console.log(JSON.stringify(DEFAULT_EVAL_THRESHOLDS, null, 2));
-  const root = await projectRoot();
+  const root = await sksRoot();
   if (sub === 'run') {
     const iterations = Number(readFlagValue(args, '--iterations', 200));
     const report = runEvaluationBenchmark({ iterations });
@@ -3176,14 +3226,14 @@ async function wiki(sub, args = []) {
     return;
   }
   if (sub === 'pack') {
-    const root = await projectRoot();
+    const root = await sksRoot();
     const { pack, file } = await writeWikiContextPack(root, args);
     if (flag(args, '--json')) return console.log(JSON.stringify({ ...pack, path: file }, null, 2));
     printWikiPackSummary(root, file, pack);
     return;
   }
   if (sub === 'refresh') {
-    const root = await projectRoot();
+    const root = await sksRoot();
     const dryRun = flag(args, '--dry-run');
     const { pack, file } = await writeWikiContextPack(root, args, { dryRun });
     const validation = wikiValidationResult(pack);
@@ -3220,7 +3270,7 @@ async function wiki(sub, args = []) {
     return;
   }
   if (sub === 'prune') {
-    const root = await projectRoot();
+    const root = await sksRoot();
     const pruneResult = await pruneWikiArtifacts(root, { dryRun: flag(args, '--dry-run') });
     if (flag(args, '--json')) {
       return console.log(JSON.stringify({
@@ -3237,7 +3287,7 @@ async function wiki(sub, args = []) {
     return;
   }
   if (sub === 'validate') {
-    const root = await projectRoot();
+    const root = await sksRoot();
     const target = positionalArgs(args)[0] || path.join(root, '.sneakoscope', 'wiki', 'context-pack.json');
     const pack = await readJson(path.resolve(target));
     const { result, trustAnchors } = wikiValidationResult(pack);
@@ -3721,7 +3771,7 @@ function printEvalCompare(report, saved) {
 async function memory(sub, args) { return gc(args || []); }
 
 async function gc(args) {
-  const root = await projectRoot();
+  const root = await sksRoot();
   const res = await enforceRetention(root, { dryRun: flag(args, '--dry-run') });
   if (flag(args, '--json')) return console.log(JSON.stringify(res, null, 2));
   console.log(flag(args, '--dry-run') ? 'ㅅㅋㅅ GC dry run' : 'ㅅㅋㅅ GC completed');
@@ -3731,7 +3781,7 @@ async function gc(args) {
 }
 
 async function stats(args) {
-  const root = await projectRoot();
+  const root = await sksRoot();
   const report = await storageReport(root);
   const pkgBytes = await dirSize(packageRoot()).catch(() => 0);
   const out = { package: { bytes: pkgBytes, human: formatBytes(pkgBytes) }, storage: report };
@@ -3744,7 +3794,7 @@ async function stats(args) {
 
 function positionalArgs(args = []) {
   const out = [];
-  const valueFlags = new Set(['--format', '--iterations', '--out', '--baseline', '--candidate', '--install-scope', '--max-cycles', '--depth', '--scope', '--transport', '--query', '--topic', '--tokens', '--timeout-ms', '--sql', '--command', '--project-ref', '--agent', '--phase', '--message', '--role', '--max-anchors']);
+  const valueFlags = new Set(['--format', '--iterations', '--out', '--baseline', '--candidate', '--install-scope', '--max-cycles', '--depth', '--scope', '--transport', '--query', '--topic', '--tokens', '--timeout-ms', '--sql', '--command', '--project-ref', '--agent', '--phase', '--message', '--role', '--max-anchors', '--lines']);
   for (let i = 0; i < args.length; i++) {
     const arg = String(args[i]);
     if (valueFlags.has(arg)) {
@@ -3806,7 +3856,7 @@ function defaultBeta(name) {
 }
 
 async function gx(sub, args) {
-  const root = await projectRoot();
+  const root = await sksRoot();
   const name = cartridgeName(args);
   const dir = cartridgeDir(root, name);
   if (sub === 'init') {
@@ -3854,18 +3904,19 @@ async function gx(sub, args) {
 }
 
 async function team(args) {
-  const teamSubcommands = new Set(['log', 'tail', 'watch', 'status', 'event']);
+  const teamSubcommands = new Set(['log', 'tail', 'watch', 'lane', 'status', 'event']);
   if (teamSubcommands.has(args[0])) return teamCommand(args[0], args.slice(1));
   const opts = parseTeamCreateArgs(args);
   const { prompt, agentSessions, roleCounts, roster } = opts;
   if (!prompt) {
     console.error('Usage: sks team "task" [executor:5 reviewer:2 user:1] [--agents N] [--json]');
-    console.error('       sks team log|tail|watch|status [mission-id|latest]');
+    console.error('       sks team log|tail|watch|lane|status [mission-id|latest]');
     console.error('       sks team event [mission-id|latest] --agent <name> --phase <phase> --message "..."');
     process.exitCode = 1;
     return;
   }
-  const root = await projectRoot();
+  const root = await sksRoot();
+  if (!(await exists(path.join(root, '.sneakoscope')))) await initProject(root, {});
   const { id, dir } = await createMission(root, { mode: 'team', prompt });
   const schema = buildQuestionSchema(prompt);
   await writeQuestions(dir, schema);
@@ -4061,6 +4112,7 @@ function buildTeamPlan(id, prompt, opts = {}) {
         'sks team log <mission-id>',
         'sks team tail <mission-id>',
         'sks team watch <mission-id>',
+        'sks team lane <mission-id> --agent <name> --follow',
         'sks team event <mission-id> --agent <name> --phase <phase> --message "..."'
       ]
     },
@@ -4135,7 +4187,7 @@ ${plan.roster.validation_team.map((agent) => `- ${agent.id}: ${agent.persona}`).
 - Keep team-live.md readable for the user inside Codex App.
 - Mirror every useful subagent status, debate result, handoff, review finding, and integration decision to team-transcript.jsonl.
 - Use \`sks team event ${plan.mission_id} --agent <name> --phase <phase> --message "..."\` when recording a live event from the parent thread.
-- The user can inspect the flow with \`sks team log ${plan.mission_id}\`, \`sks team tail ${plan.mission_id}\`, or \`sks team watch ${plan.mission_id}\`.
+- The user can inspect the flow with \`sks team log ${plan.mission_id}\`, \`sks team tail ${plan.mission_id}\`, \`sks team watch ${plan.mission_id}\`, or \`sks team lane ${plan.mission_id} --agent analysis_scout_1 --follow\`.
 
 ## Phases
 
@@ -4148,7 +4200,7 @@ ${plan.invariants.map((x) => `- ${x}`).join('\n')}
 }
 
 async function teamCommand(sub, args) {
-  const root = await projectRoot();
+  const root = await sksRoot();
   const missionArg = args[0] && !String(args[0]).startsWith('--') ? args[0] : 'latest';
   const id = await resolveMissionId(root, missionArg);
   if (!id) {
@@ -4191,6 +4243,35 @@ async function teamCommand(sub, args) {
     return;
   }
   if (sub === 'log') return console.log(await readTeamLive(dir));
+  if (sub === 'lane') {
+    const agent = readFlagValue(args, '--agent', 'parent_orchestrator');
+    const phase = readFlagValue(args, '--phase', '');
+    const lines = Number(readFlagValue(args, '--lines', '12'));
+    const printLane = async () => {
+      const text = await renderTeamAgentLane(dir, { missionId: id, agent, phase, lines });
+      if (flag(args, '--json')) {
+        console.log(JSON.stringify({ mission_id: id, agent, phase, lane: text }, null, 2));
+      } else {
+        if (flag(args, '--follow') && process.stdout.isTTY) console.clear();
+        console.log(text);
+      }
+      return text;
+    };
+    let last = await printLane();
+    if (flag(args, '--follow')) {
+      for (;;) {
+        await new Promise((resolve) => setTimeout(resolve, 2000));
+        const next = await renderTeamAgentLane(dir, { missionId: id, agent, phase, lines });
+        if (next !== last) {
+          if (process.stdout.isTTY) console.clear();
+          else console.log('\n--- team lane update ---\n');
+          console.log(next);
+          last = next;
+        }
+      }
+    }
+    return;
+  }
   if (sub === 'tail' || sub === 'watch') {
     const lines = readFlagValue(args, '--lines', '20');
     const printTail = async () => {
@@ -4213,7 +4294,7 @@ async function teamCommand(sub, args) {
 }
 
 async function db(sub, args) {
-  const root = await projectRoot();
+  const root = await sksRoot();
   if (sub === 'policy') {
     console.log(JSON.stringify(await loadDbSafetyPolicy(root), null, 2));
     return;

package/src/core/cmux-ui.mjs

@@ -1,7 +1,7 @@
 import path from 'node:path';
 import fsp from 'node:fs/promises';
 import { spawnSync } from 'node:child_process';
-import { exists, packageRoot, projectRoot, runProcess, sha256, which } from './fsx.mjs';
+import { exists, packageRoot, runProcess, sha256, sksRoot, which } from './fsx.mjs';
 import { getCodexInfo } from './codex-adapter.mjs';
 import { codexAppIntegrationStatus, formatCodexAppStatus } from './codex-app.mjs';
 
@@ -137,12 +137,12 @@ export function teamAgentCommand(root, missionId, agentId, phase) {
   return [
     `printf '%s\\n' ${shellEscape(`${SKS_CMUX_LOGO}\n\nTeam mission: ${missionId}\nAgent: ${agentId}\nPhase: ${phase}\n`)}`,
     `cd ${shellEscape(root)}`,
-    `node ${shellEscape(path.join(packageRoot(), 'bin', 'sks.mjs'))} team watch ${shellEscape(missionId)} --follow --lines 12`
+    `node ${shellEscape(path.join(packageRoot(), 'bin', 'sks.mjs'))} team lane ${shellEscape(missionId)} --agent ${shellEscape(agentId)} --phase ${shellEscape(phase)} --follow --lines 12`
   ].join('; ');
 }
 
 export async function buildCmuxLaunchPlan(opts = {}) {
-  const root = path.resolve(opts.root || await projectRoot());
+  const root = path.resolve(opts.root || await sksRoot());
   const workspace = sanitizeCmuxWorkspaceName(opts.workspace || opts.session || defaultCmuxWorkspaceName(root));
   const sksBin = opts.sksBin || path.join(packageRoot(), 'bin', 'sks.mjs');
   const codex = opts.codex || await getCodexInfo().catch(() => ({}));

package/src/core/fsx.mjs

@@ -5,7 +5,7 @@ import os from 'node:os';
 import crypto from 'node:crypto';
 import { spawn } from 'node:child_process';
 
-export const PACKAGE_VERSION = '0.6.66';
+export const PACKAGE_VERSION = '0.6.69';
 export const DEFAULT_PROCESS_TAIL_BYTES = 256 * 1024;
 export const DEFAULT_PROCESS_TIMEOUT_MS = 30 * 60 * 1000;
 
@@ -145,7 +145,7 @@ export async function findUp(start, names) {
   }
 }
 
-export async function projectRoot(start = process.cwd()) {
+export async function findProjectRoot(start = process.cwd()) {
   const resolved = path.resolve(start);
   const sine = await findUp(resolved, ['.sneakoscope', '.dcodex']);
   if (sine) {
@@ -157,6 +157,22 @@ export async function projectRoot(start = process.cwd()) {
     const root = path.dirname(git);
     if (root !== path.parse(root).root) return root;
   }
+  return null;
+}
+
+export function globalSksRoot() {
+  if (process.env.SKS_GLOBAL_ROOT) return path.resolve(process.env.SKS_GLOBAL_ROOT);
+  return path.join(process.env.HOME || os.homedir(), '.sneakoscope-global');
+}
+
+export async function sksRoot(start = process.cwd()) {
+  return await findProjectRoot(start) || globalSksRoot();
+}
+
+export async function projectRoot(start = process.cwd()) {
+  const resolved = path.resolve(start);
+  const root = await findProjectRoot(resolved);
+  if (root) return root;
   return resolved;
 }
 

package/src/core/init.mjs

@@ -474,8 +474,10 @@ function codexAppQuickReference(scope, commandPrefix) {
     `Picker skills: ${DOLLAR_COMMAND_ALIASES.map((x) => x.app_skill).join(', ')}.`,
     'Routing: Answer direct, DFix ultralight, execution routes ask only scope/safety/behavior/acceptance-changing questions before sealing answers.',
     `Full routes write reflection.md, record lessons to ${REFLECTION_MEMORY_PATH}, refresh/pack TriWiki, validate, then final-answer with a user-visible completion summary plus Honest Mode.`,
+    `Runtime root: ${commandPrefix} root shows whether SKS is using the nearest project root or the per-user global SKS runtime root; outside any project marker, runtime commands use the global root instead of writing .sneakoscope into the current random directory.`,
     `Context Tracking: TriWiki SSOT. Before each route phase read only the latest coordinate+voxel overlay pack at .sneakoscope/wiki/context-pack.json; coordinate-only legacy packs are invalid. Use attention.use_first for compact high-trust recall and hydrate attention.hydrate_first from source before risky/lower-trust decisions. During every stage hydrate low-trust claims from source/hash/RGBA anchors; after changes run ${commandPrefix} wiki refresh or pack; before handoff/final run ${commandPrefix} wiki validate .sneakoscope/wiki/context-pack.json.`,
     stackCurrentDocsPolicyText(commandPrefix),
+    `Team lanes: ${commandPrefix} team lane latest --agent analysis_scout_1 --follow shows one agent's status, assigned runtime tasks, recent agent events, and fallback global tail.`,
     `Runtime: open Codex App once, then run ${commandPrefix} bootstrap, ${commandPrefix} deps check, or ${commandPrefix} deps install cmux.`,
     `Guard: generated harness files are immutable outside the engine source repo; check ${commandPrefix} guard check; conflicts use ${commandPrefix} conflicts prompt with human approval.`
   ].join('\n') + '\n';
@@ -498,7 +500,7 @@ export async function installSkills(root) {
     'gx': `---\nname: gx\ndescription: Dollar-command route for $GX or $gx deterministic GX visual context cartridges.\n---\n\nUse when the user invokes $GX/$gx or asks for architecture/context visualization through SKS. Prefer sks gx init, render, validate, drift, and snapshot. vgraph.json remains the source of truth.\n`,
     'help': `---\nname: help\ndescription: Dollar-command route for $Help or $help explaining installed SKS commands and workflows.\n---\n\nUse when the user invokes $Help/$help or asks what commands exist. Prefer concise output from sks commands, sks usage <topic>, sks quickstart, sks aliases, and sks codex-app.\n`,
     'prompt-pipeline': `---\nname: prompt-pipeline\ndescription: Default SKS prompt optimization pipeline for execution prompts; Answer and DFix bypass it.\n---\n\nClassify intent: Answer only for real questions; question-shaped implicit instructions, complaints, and mandatory-policy statements route to Team. DFix handles tiny design/content; code defaults to Team unless safety/research/GX route fits. Infer goal, target, constraints, acceptance, risk, and smallest safe route. Ask only scope/safety/behavior/acceptance-changing questions; otherwise seal inferred answers. Code work surfaces route/guard/scopes, materializes team-roster.json from default or explicit counts before implementation, compiles concrete Team runtime graph/inbox artifacts after consensus, and parent owns integration/tests/Context7/Honest Mode.\n\n${chatCaptureIntakeText()}\n\nDesign: read design.md; if missing use design-system-builder; use imagegen for image/logo/raster. TriWiki context-tracking SSOT: .sneakoscope/wiki/context-pack.json; read only the latest coordinate+voxel overlay pack before every route stage, run sks wiki refresh/pack after changes, validate before handoffs/final.\n`,
-    'reasoning-router': `---\nname: reasoning-router\ndescription: Temporary SKS reasoning-effort routing for every command and pipeline route.\n---\n\nmedium: simple copy/color/discovery/setup/mechanical edits. high: logic, safety, architecture, DB, orchestration, refactor, multi-file work. xhigh: research, AutoResearch, falsification, benchmarks, SEO/GEO, open-ended discovery. Routing is temporary; return to default after the gate. Inspect with sks reasoning and sks pipeline status.\n`,
+    'reasoning-router': `---\nname: reasoning-router\ndescription: Temporary SKS reasoning-effort routing for every command and pipeline route.\n---\n\nmedium: simple copy/color/discovery/setup/mechanical edits. high: logic, safety, architecture, DB, orchestration, refactor, multi-file work. xhigh: research, AutoResearch, falsification, benchmarks, SEO/GEO, open-ended discovery, and From-Chat-IMG image work-order analysis. Routing is temporary; return to default after the gate. Inspect with sks reasoning and sks pipeline status.\n`,
     'pipeline-runner': `---\nname: pipeline-runner\ndescription: Execute SKS dollar-command routes as stateful pipelines with mission artifacts, route gates, Context7 evidence, temporary reasoning routing, reflection, and Honest Mode.\n---\n\nEvery $ command is a route. Use current.json and mission artifacts, temporary reasoning, TriWiki before stages, source hydration, Context7 when required, Team cleanup before reflection, reflection for full routes, and completion summary plus Honest Mode before final. Surface guard/scopes, record evidence, refresh/pack/validate TriWiki, and check sks pipeline status/resume.\n`,
     'context7-docs': `---\nname: context7-docs\ndescription: Enforce Context7 MCP documentation evidence for SKS routes that depend on external libraries, frameworks, APIs, MCPs, package managers, DB SDKs, or generated docs.\n---\n\nWhen required, resolve-library-id, then query-docs for the resolved id. Legacy get-library-docs evidence is accepted. Prefer sks context7 tools/resolve/docs/evidence and finish only after both evidence stages exist. Check setup with sks context7 check.\n`,
     'seo-geo-optimizer': `---\nname: seo-geo-optimizer\ndescription: SEO/GEO support for README, npm, GitHub, keywords, snippets, schema, and AI-search visibility.\n---\n\nUse for SEO/GEO, package metadata, README ranking, snippets, schema, and AI search. Optimize README, package.json, docs, badges, topics, quickstart, examples, command discovery, exact names, keywords, and AI Answer Snapshot. Do not invent metrics; use $AutoResearch unless it is a tiny copy edit.\n`,
@@ -552,7 +554,7 @@ Context tracking:
 }
 
 async function writeSkillMetadata(dir, name) {
-  const effort = ['research', 'autoresearch', 'research-discovery', 'autoresearch-loop'].includes(name)
+  const effort = ['research', 'autoresearch', 'research-discovery', 'autoresearch-loop', 'from-chat-img'].includes(name)
     ? 'xhigh'
     : (['dfix', 'sks', 'help'].includes(name) ? 'medium' : 'high');
   await ensureDir(path.join(dir, 'agents'));

package/src/core/pipeline.mjs

@@ -305,14 +305,14 @@ async function prepareTeam(root, route, task, required) {
       transcript: 'team-transcript.jsonl',
       dashboard: 'team-dashboard.json',
       cmux: 'CLI Team entrypoints open cmux live lanes for the visible Team agent budget when cmux is available.',
-      commands: ['sks team status latest', 'sks team log latest', 'sks team tail latest', 'sks team watch latest', 'sks team event latest --agent <name> --phase <phase> --message "..."']
+      commands: ['sks team status latest', 'sks team log latest', 'sks team tail latest', 'sks team watch latest', 'sks team lane latest --agent <name> --follow', 'sks team event latest --agent <name> --phase <phase> --message "..."']
     },
     required_artifacts: ['team-roster.json', 'team-analysis.md', ...(fromChatImgRequired ? [FROM_CHAT_IMG_COVERAGE_ARTIFACT, FROM_CHAT_IMG_CHECKLIST_ARTIFACT, FROM_CHAT_IMG_TEMP_TRIWIKI_ARTIFACT, FROM_CHAT_IMG_QA_LOOP_ARTIFACT] : []), 'team-consensus.md', ...teamRuntimeRequiredArtifacts(), 'team-review.md', 'team-gate.json', TEAM_SESSION_CLEANUP_ARTIFACT, 'reflection.md', 'reflection-gate.json', 'team-live.md', 'team-transcript.jsonl', 'team-dashboard.json', '.sneakoscope/wiki/context-pack.json', 'context7-evidence.jsonl']
   };
   await writeJsonAtomic(path.join(dir, 'team-plan.json'), plan);
   await writeJsonAtomic(path.join(dir, 'team-roster.json'), { schema_version: 1, mission_id: id, role_counts: roleCounts, agent_sessions: agentSessions, bundle_size: roster.bundle_size, roster, confirmed: true, source: 'default_or_prompt_team_spec' });
   const contextTracking = triwikiContextTracking();
-  await writeTextAtomic(path.join(dir, 'team-workflow.md'), `# SKS Team Workflow\n\nTask: ${cleanTask}\n\nAgent session budget: ${agentSessions}\nBundle size: ${roster.bundle_size}\nRole counts: ${formatRoleCounts(roleCounts)}\nReasoning: high for team logic, temporary for this route only.\nContext tracking: ${contextTracking.ssot} SSOT, ${contextTracking.default_pack}; use relevant TriWiki context before every work stage, refresh/validate after findings, and preserve hydratable source anchors.\n\n1. Run exactly ${roster.bundle_size} read-only analysis_scout_N agents and write team-analysis.md.\n2. Refresh/validate TriWiki before debate.\n3. Run exactly ${roster.bundle_size} debate participants, then write consensus and implementation slices.\n4. Compile ${TEAM_GRAPH_ARTIFACT}, ${TEAM_RUNTIME_TASKS_ARTIFACT}, ${TEAM_DECOMPOSITION_ARTIFACT}, and ${TEAM_INBOX_DIR} so worker handoff uses concrete runtime task ids.\n5. Close debate agents before starting a fresh ${roster.bundle_size}-person executor team.\n6. Review, integrate, verify, and record evidence.\n7. Close/clean remaining Team sessions, finalize live transcript state, and write ${TEAM_SESSION_CLEANUP_ARTIFACT} before reflection/final.\n\nLive visibility:\n- sks team log ${id}\n- sks team tail ${id}\n- sks team watch ${id}\n- sks team event ${id} --agent <name> --phase <phase> --message \"...\"\n`);
+  await writeTextAtomic(path.join(dir, 'team-workflow.md'), `# SKS Team Workflow\n\nTask: ${cleanTask}\n\nAgent session budget: ${agentSessions}\nBundle size: ${roster.bundle_size}\nRole counts: ${formatRoleCounts(roleCounts)}\nReasoning: high for team logic, temporary for this route only.\nContext tracking: ${contextTracking.ssot} SSOT, ${contextTracking.default_pack}; use relevant TriWiki context before every work stage, refresh/validate after findings, and preserve hydratable source anchors.\n\n1. Run exactly ${roster.bundle_size} read-only analysis_scout_N agents and write team-analysis.md.\n2. Refresh/validate TriWiki before debate.\n3. Run exactly ${roster.bundle_size} debate participants, then write consensus and implementation slices.\n4. Compile ${TEAM_GRAPH_ARTIFACT}, ${TEAM_RUNTIME_TASKS_ARTIFACT}, ${TEAM_DECOMPOSITION_ARTIFACT}, and ${TEAM_INBOX_DIR} so worker handoff uses concrete runtime task ids.\n5. Close debate agents before starting a fresh ${roster.bundle_size}-person executor team.\n6. Review, integrate, verify, and record evidence.\n7. Close/clean remaining Team sessions, finalize live transcript state, and write ${TEAM_SESSION_CLEANUP_ARTIFACT} before reflection/final.\n\nLive visibility:\n- sks team log ${id}\n- sks team tail ${id}\n- sks team watch ${id}\n- sks team lane ${id} --agent analysis_scout_1 --follow\n- sks team event ${id} --agent <name> --phase <phase> --message \"...\"\n`);
   await initTeamLive(id, dir, cleanTask, { agentSessions, roleCounts, roster });
   const runtime = await writeTeamRuntimeArtifacts(dir, plan, {});
   await writeJsonAtomic(path.join(dir, 'team-gate.json'), { passed: false, team_roster_confirmed: true, analysis_artifact: false, triwiki_refreshed: false, triwiki_validated: false, consensus_artifact: false, ...runtime.gate_fields, implementation_team_fresh: false, review_artifact: false, integration_evidence: false, session_cleanup: false, context7_evidence: false, ...(fromChatImgRequired ? { from_chat_img_required: true, from_chat_img_request_coverage: false } : {}) });

package/src/core/routes.mjs

@@ -4,7 +4,7 @@ export const FROM_CHAT_IMG_CHECKLIST_ARTIFACT = 'from-chat-img-checklist.md';
 export const FROM_CHAT_IMG_TEMP_TRIWIKI_ARTIFACT = 'from-chat-img-temp-triwiki.json';
 export const FROM_CHAT_IMG_QA_LOOP_ARTIFACT = 'from-chat-img-qa-loop.json';
 export const FROM_CHAT_IMG_TEMP_TRIWIKI_SESSIONS = 5;
-export const USAGE_TOPICS = 'install|setup|bootstrap|deps|cmux|auto-review|team|qa-loop|ralph|research|db|codex-app|dfix|design|imagegen|dollar|context7|pipeline|reasoning|guard|conflicts|versioning|eval|hproof|gx|wiki';
+export const USAGE_TOPICS = 'install|setup|bootstrap|root|deps|cmux|auto-review|team|qa-loop|ralph|research|db|codex-app|dfix|design|imagegen|dollar|context7|pipeline|reasoning|guard|conflicts|versioning|eval|hproof|gx|wiki';
 
 export const RECOMMENDED_MCP_SERVERS = [
   {
@@ -331,6 +331,7 @@ export const COMMAND_CATALOG = [
   { name: 'usage', usage: `sks usage [${USAGE_TOPICS}]`, description: 'Print copy-ready workflows for common tasks.' },
   { name: 'quickstart', usage: 'sks quickstart', description: 'Show the shortest safe setup and verification flow.' },
   { name: 'bootstrap', usage: 'sks bootstrap [--install-scope global|project] [--local-only] [--json]', description: 'Initialize the current project, install SKS Codex App files/skills, check Context7/Codex App/cmux, and print ready true/false.' },
+  { name: 'root', usage: 'sks root [--json]', description: 'Show whether SKS is using a project root or the per-user global SKS runtime root.' },
   { name: 'deps', usage: 'sks deps check|install [cmux|codex|context7|all] [--yes]', description: 'Check or guided-install Node/npm PATH, Codex CLI/App, Context7, Browser Use, Computer Use, cmux, and Homebrew on macOS.' },
   { name: 'codex-app', usage: 'sks codex-app [check|open]', description: 'Check Codex App install and first-party MCP/plugin readiness, then show app setup files and examples.' },
   { name: 'cmux', usage: 'sks cmux [check|status] [--workspace name]', description: 'Open the SKS cmux runtime with the ㅅㅋㅅ ASCII status pane and Codex CLI.' },
@@ -356,7 +357,7 @@ export const COMMAND_CATALOG = [
   { name: 'eval', usage: 'sks eval run|compare|thresholds ...', description: 'Run deterministic context-quality and performance evidence checks.' },
   { name: 'wiki', usage: 'sks wiki coords|pack|refresh|prune|validate ...', description: 'Build, refresh, prune, and validate RGBA/trig LLM Wiki context packs with attention.use_first and attention.hydrate_first for compact recall plus source hydration.' },
   { name: 'hproof', usage: 'sks hproof check [mission-id|latest]', description: 'Evaluate the H-Proof done gate for a mission.' },
-  { name: 'team', usage: 'sks team "task" [executor:5 reviewer:2 user:1]|log|tail|watch|status|event ...', description: 'Create and observe a scout-first Team mission: parallel analysis, TriWiki attention, role debate, runtime graph/inbox handoff, then executor parallel development.' },
+  { name: 'team', usage: 'sks team "task" [executor:5 reviewer:2 user:1]|log|tail|watch|lane|status|event ...', description: 'Create and observe a scout-first Team mission: parallel analysis, TriWiki attention, role debate, runtime graph/inbox handoff, then executor parallel development.' },
   { name: 'reasoning', usage: 'sks reasoning ["prompt"] [--json]', description: 'Show SKS temporary reasoning-effort routing: medium for simple tasks, high for logic, xhigh for research.' },
   { name: 'gx', usage: 'sks gx init|render|validate|drift|snapshot [name]', description: 'Create and verify deterministic SVG/HTML visual context cartridges.' },
   { name: 'profile', usage: 'sks profile show|set <model>', description: 'Inspect or set the current SKS model profile metadata.' },
@@ -527,6 +528,7 @@ export function subagentExecutionPolicyText(route, prompt = '') {
 export function routeReasoning(route, prompt = '') {
   const text = String(prompt || '');
   const base = route?.reasoningPolicy || 'medium';
+  if (hasFromChatImgSignal(text)) return reasoning('xhigh', 'from_chat_img_image_work_order_analysis');
   if (route?.id === 'Research' || route?.id === 'AutoResearch') return reasoning('xhigh', 'research_or_experiment_route');
   if (/\b(research|autoresearch|hypothesis|falsify|novelty|frontier|benchmark|experiment|SEO|GEO|ranking|연구|실험|가설|검증)\b/i.test(text)) return reasoning('xhigh', 'research_level_prompt');
   if (base === 'high' || /\b(architecture|design|migration|database|security|parallel|orchestrat|refactor|algorithm|logic|tradeoff|검토|설계|마이그레이션|보안|병렬|팀|논리)\b/i.test(text)) return reasoning('high', 'logical_or_safety_work');

package/src/core/team-live.mjs

@@ -3,6 +3,7 @@ import { appendJsonlBounded, nowIso, readJson, readText, writeJsonAtomic, writeT
 import { triwikiContextTracking, triwikiContextTrackingText } from './routes.mjs';
 
 const MAX_LIVE_BYTES = 192 * 1024;
+const TEAM_RUNTIME_TASKS_ARTIFACT = 'team-runtime-tasks.json';
 const DEFAULT_AGENTS = ['parent_orchestrator', 'analysis_scout', 'team_consensus', 'implementation_worker', 'db_safety_reviewer', 'qa_reviewer'];
 export const DEFAULT_TEAM_ROLE_COUNTS = { user: 1, planner: 1, reviewer: 1, executor: 3 };
 export const DEFAULT_MAX_TEAM_AGENT_SESSIONS = 6;
@@ -67,6 +68,7 @@ export function defaultTeamDashboard(id, prompt, opts = {}) {
       log: `sks team log ${id}`,
       tail: `sks team tail ${id}`,
       watch: `sks team watch ${id}`,
+      lane: `sks team lane ${id} --agent <agent> --follow`,
       event: `sks team event ${id} --agent <agent> --phase <phase> --message "..."`
     },
     agents: Object.fromEntries([...new Set([...DEFAULT_AGENTS, ...spec.roster.all_agents.map((agent) => agent.id)])].map((name) => [name, { status: 'pending', phase: null, last_seen: null }])),
@@ -115,6 +117,7 @@ sks team status ${id}
 sks team log ${id}
 sks team tail ${id}
 sks team watch ${id}
+sks team lane ${id} --agent analysis_scout_1 --follow
 sks team event ${id} --agent analysis_scout_1 --phase parallel_analysis_scouting --message "mapped repo slice"
 \`\`\`
 
@@ -337,6 +340,42 @@ export async function readTeamTranscriptTail(dir, count = 20) {
   return text.split(/\n/).filter(Boolean).slice(-Math.max(1, Number(count) || 20));
 }
 
+export async function renderTeamAgentLane(dir, opts = {}) {
+  const agent = String(opts.agent || opts.agentId || 'parent_orchestrator');
+  const phase = opts.phase ? String(opts.phase) : null;
+  const lines = Math.max(1, Number(opts.lines) || 12);
+  const dashboard = await readTeamDashboard(dir);
+  const runtime = await readJson(path.join(dir, TEAM_RUNTIME_TASKS_ARTIFACT), null);
+  const missionId = opts.missionId || dashboard?.mission_id || runtime?.mission_id || path.basename(dir);
+  const status = dashboard?.agents?.[agent] || {};
+  const runtimeTasks = Array.isArray(runtime?.tasks) ? runtime.tasks : Array.isArray(runtime) ? runtime : [];
+  const assignedTasks = runtimeTasks.filter((task) => task?.worker === agent || task?.agent_hint === agent);
+  const eventWindow = await readTeamTranscriptTail(dir, Math.max(lines * 8, 80));
+  const agentEvents = eventWindow.map(parseTranscriptLine).filter((event) => event?.agent === agent).slice(-lines);
+  const globalTail = (await readTeamTranscriptTail(dir, lines)).map(parseTranscriptLine).filter(Boolean);
+  return [
+    `# SKS Team Agent Lane`,
+    '',
+    `Mission: ${missionId}`,
+    `Agent: ${agent}`,
+    `Requested phase: ${phase || 'any'}`,
+    '',
+    `## Agent Status`,
+    `- status: ${status.status || 'pending'}`,
+    `- phase: ${status.phase || 'unknown'}`,
+    `- last_seen: ${status.last_seen || 'never'}`,
+    '',
+    `## Assigned Runtime Tasks`,
+    ...(runtime ? formatRuntimeTasks(assignedTasks) : ['- team-runtime-tasks.json not available yet.']),
+    '',
+    `## Recent Agent Events`,
+    ...(agentEvents.length ? agentEvents.map(formatTranscriptEvent) : ['- No recent agent-specific events in the bounded tail.']),
+    '',
+    `## Fallback Global Tail`,
+    ...(globalTail.length ? globalTail.map(formatTranscriptEvent) : ['- No transcript events yet.'])
+  ].join('\n');
+}
+
 function normalizeEvent(event = {}) {
   return {
     ts: event.ts || nowIso(),
@@ -348,6 +387,39 @@ function normalizeEvent(event = {}) {
   };
 }
 
+function parseTranscriptLine(line) {
+  try {
+    return JSON.parse(line);
+  } catch {
+    return { raw: String(line || '').slice(0, 1000) };
+  }
+}
+
+function formatTranscriptEvent(event = {}) {
+  if (event.raw) return `- ${event.raw}`;
+  const parts = [
+    event.ts || 'no-ts',
+    `[${event.phase || 'general'}]`,
+    event.agent || 'unknown',
+    event.type ? `(${event.type})` : null
+  ].filter(Boolean);
+  const suffix = event.artifact ? ` (${event.artifact})` : '';
+  return `- ${parts.join(' ')}: ${String(event.message || '').slice(0, 500)}${suffix}`;
+}
+
+function formatRuntimeTasks(tasks = []) {
+  if (!tasks.length) return ['- No assigned runtime tasks found.'];
+  return tasks.slice(0, 12).map((task) => {
+    const details = [
+      task.status || 'pending',
+      task.phase || task.role || 'team',
+      task.depends_on?.length ? `deps:${task.depends_on.join(',')}` : null,
+      task.file_paths?.length ? `files:${task.file_paths.slice(0, 3).join(',')}` : null
+    ].filter(Boolean).join(' | ');
+    return `- ${task.task_id || 'task'} ${task.subject || task.symbolic_id || 'untitled'} (${details})`;
+  });
+}
+
 function trimLiveMarkdown(text) {
   if (Buffer.byteLength(text) <= MAX_LIVE_BYTES) return text.endsWith('\n') ? text : `${text}\n`;
   const marker = '## Live Events\n';