sneakoscope 0.7.74 → 0.7.78

package/src/cli/maintenance-commands.mjs

@@ -17,7 +17,7 @@ import { contextCapsule } from '../core/triwiki-attention.mjs';
 import { rgbaKey, rgbaToWikiCoord, validateWikiCoordinateIndex } from '../core/wiki-coordinate.mjs';
 import { ALLOWED_REASONING_EFFORTS, CODEX_COMPUTER_USE_ONLY_POLICY, DOLLAR_SKILL_NAMES, FROM_CHAT_IMG_CHECKLIST_ARTIFACT, FROM_CHAT_IMG_COVERAGE_ARTIFACT, FROM_CHAT_IMG_QA_LOOP_ARTIFACT, FROM_CHAT_IMG_SOURCE_INVENTORY_ARTIFACT, FROM_CHAT_IMG_TEMP_TRIWIKI_ARTIFACT, FROM_CHAT_IMG_TEMP_TRIWIKI_SESSIONS, FROM_CHAT_IMG_VISUAL_MAP_ARTIFACT, FROM_CHAT_IMG_WORK_ORDER_ARTIFACT, RECOMMENDED_SKILLS, ROUTES, hasFromChatImgSignal, reflectionRequiredForRoute, routeNeedsContext7, routePrompt, routeReasoning, routeRequiresSubagents, stackCurrentDocsPolicy, stripVisibleDecisionAnswerBlocks, triwikiContextTracking } from '../core/routes.mjs';
 import { TEAM_DECOMPOSITION_ARTIFACT, TEAM_GRAPH_ARTIFACT, TEAM_INBOX_DIR, TEAM_RUNTIME_TASKS_ARTIFACT, teamRuntimePlanMetadata, teamRuntimeRequiredArtifacts, writeTeamRuntimeArtifacts } from '../core/team-dag.mjs';
-import { appendTeamEvent, formatAgentReasoning, formatRoleCounts, initTeamLive, normalizeTeamSpec, parseTeamSpecArgs, readTeamControl, readTeamDashboard, readTeamLive, readTeamTranscriptTail, renderTeamAgentLane, renderTeamCleanupSummary, renderTeamWatch, requestTeamSessionCleanup, teamCleanupRequested, teamReasoningPolicy } from '../core/team-live.mjs';
+import { appendTeamEvent, formatAgentReasoning, formatRoleCounts, initTeamLive, isTerminalTeamAgentStatus, normalizeTeamSpec, parseTeamSpecArgs, readTeamControl, readTeamDashboard, readTeamLive, readTeamTranscriptTail, renderTeamAgentLane, renderTeamCleanupSummary, renderTeamWatch, requestTeamSessionCleanup, teamCleanupRequested, teamReasoningPolicy } from '../core/team-live.mjs';
 import { evaluateTeamReviewPolicyGate, MIN_TEAM_REVIEWER_LANES, MIN_TEAM_REVIEW_POLICY_TEXT, teamReviewPolicy } from '../core/team-review-policy.mjs';
 import { ARTIFACT_FILES, writeValidationReport } from '../core/artifact-schemas.mjs';
 import { writeEffortDecision } from '../core/effort-orchestrator.mjs';
@@ -66,13 +66,20 @@ function readOption(args, name, fallback) {
 }
 
 function codexLbImmediateLaunchOpts(args = [], lb = {}, opts = {}) {
-  if (!lb?.ok || lb.status !== 'configured') return opts;
-  if (readOption(args, '--session', null) || readOption(args, '--workspace', null)) return opts;
   const root = readOption(args, '--root', process.cwd());
+  const explicitSession = readOption(args, '--session', null) || readOption(args, '--workspace', null);
+  if (lb?.bypass_codex_lb) {
+    const session = explicitSession || sanitizeTmuxSessionName(`sks-openai-fallback-${Date.now().toString(36)}-${defaultTmuxSessionName(root)}`);
+    console.log(`codex-lb bypass active for this launch: ${lb.chain_health?.status || lb.status}`);
+    console.log(`Using fresh OpenAI fallback tmux session: ${session}`);
+    return { ...opts, session, codexArgs: [...(opts.codexArgs || []), '-c', 'model_provider="openai"'], codexLbBypassed: true };
+  }
+  if (!lb?.ok) return opts;
+  if (explicitSession) return opts;
   const session = sanitizeTmuxSessionName(`sks-codex-lb-${Date.now().toString(36)}-${defaultTmuxSessionName(root)}`);
-  console.log(`codex-lb key loaded for this launch: ${lb.env_path}`);
+  console.log(`codex-lb active for this launch: ${lb.env_path || lb.base_url || 'configured'}`);
   console.log(`Using fresh tmux session: ${session}`);
-  return { ...opts, session };
+  return { ...opts, session, codexLbFreshSession: true };
 }
 
 export async function madHighCommand(args = [], deps = {}) {
@@ -761,15 +768,32 @@ export async function validateArtifactsCommand(args = []) {
   const root = await sksRoot();
   const missionArg = args[0] && !String(args[0]).startsWith('--') ? args[0] : 'latest';
   const id = await resolveMissionId(root, missionArg);
-  const targetDir = id ? (await loadMission(root, id)).dir : root;
+  const loaded = id ? await loadMission(root, id) : null;
+  const targetDir = loaded ? loaded.dir : root;
   const requiredRaw = readFlagValue(args, '--required', '');
   const required = requiredRaw === 'all'
     ? Object.keys(ARTIFACT_FILES)
     : String(requiredRaw || '').split(',').map((x) => x.trim()).filter(Boolean);
   const report = await writeValidationReport(targetDir, { required });
+  const missionMode = String(loaded?.mission?.mode || '').toLowerCase();
+  if (missionMode === 'research' || await exists(path.join(targetDir, 'research-gate.json'))) {
+    const researchGate = await evaluateResearchGate(targetDir);
+    report.route_gate = {
+      route: 'Research',
+      ok: researchGate.passed === true,
+      gate_file: 'research-gate.evaluated.json',
+      reasons: researchGate.reasons || []
+    };
+    if (!report.route_gate.ok) {
+      report.ok = false;
+      report.errors = [...(report.errors || []), ...report.route_gate.reasons.map((reason) => `research-gate:${reason}`)];
+    }
+    await writeJsonAtomic(path.join(targetDir, 'artifact-validation.json'), report);
+  }
   if (flag(args, '--json')) return console.log(JSON.stringify(report, null, 2));
   console.log(`Artifact validation: ${report.ok ? 'pass' : 'fail'}`);
   console.log(`Target: ${path.relative(root, targetDir) || '.'}`);
+  if (report.route_gate) console.log(`Route gate: ${report.route_gate.route} ${report.route_gate.ok ? 'pass' : `fail (${report.route_gate.reasons.join(', ')})`}`);
   if (report.missing.length) console.log(`Missing: ${report.missing.join(', ')}`);
   for (const [schema, result] of Object.entries(report.results)) console.log(`${schema}: ${result.ok ? 'pass' : `fail (${result.errors.join(', ')})`}`);
   if (!report.ok) process.exitCode = 2;
@@ -1827,6 +1851,7 @@ export async function team(args) {
   if (result.tmux.ready) {
     const tmuxState = result.tmux.created ? 'opened' : 'not opened';
     console.log(`tmux: ${tmuxState} ${result.tmux.opened_lane_count || result.tmux.agents.length} agent lane(s) in ${result.tmux.session || result.tmux.workspace}`);
+    if (result.tmux.preflight_cleanup?.closed_lane_count) console.log(`tmux cleanup preflight: closed ${result.tmux.preflight_cleanup.closed_lane_count} stale Team pane(s)`);
     if (result.tmux.split_ui?.mode) console.log(`tmux UI: ${result.tmux.split_ui.mode} (${result.tmux.split_ui.layout})`);
   }
   else console.log(`tmux: blocked (${Array.from(new Set(result.tmux.blockers || [])).join('; ')})`);
@@ -2121,6 +2146,7 @@ async function teamCommand(sub, args) {
       return;
     }
     console.log(`tmux: opened ${tmux.opened_lane_count || tmux.lanes?.length || 0} Team lane(s) in ${tmux.session}`);
+    if (tmux.preflight_cleanup?.closed_lane_count) console.log(`tmux cleanup preflight: closed ${tmux.preflight_cleanup.closed_lane_count} stale Team pane(s)`);
     if (tmux.split_ui?.mode) console.log(`tmux UI: ${tmux.split_ui.mode} (${tmux.split_ui.layout})`);
     if (tmux.split_ui?.current_session) console.log('tmux cockpit: reconciled inside the current SKS tmux window');
     console.log(`Attach: ${tmux.attach_command}`);
@@ -2215,6 +2241,7 @@ async function teamCommand(sub, args) {
     }
     if (cleanup.killed_session) console.log(`tmux cleanup: killed session ${cleanup.session}`);
     else console.log(`tmux cleanup: marked complete (${cleanup.reason || 'record updated'})`);
+    if (cleanup.sweep_cleanup?.closed_lane_count) console.log(`tmux sweep: closed ${cleanup.sweep_cleanup.closed_lane_count} stale recorded Team pane(s)`);
     console.log(renderTeamCleanupSummary(control));
     return;
   }
@@ -2245,6 +2272,11 @@ async function teamCommand(sub, args) {
     const agent = readFlagValue(args, '--agent', 'parent_orchestrator');
     const phase = readFlagValue(args, '--phase', '');
     const lines = Number(readFlagValue(args, '--lines', '12'));
+    const shouldStopLaneFollow = async () => {
+      if (teamCleanupRequested(await readTeamControl(dir))) return true;
+      const dashboard = await readTeamDashboard(dir).catch(() => null);
+      return isTerminalTeamAgentStatus(dashboard?.agents?.[agent]?.status || '');
+    };
     const printLane = async () => {
       const text = await renderTeamAgentLane(dir, { missionId: id, agent, phase, lines });
       if (flag(args, '--json')) {
@@ -2256,7 +2288,7 @@ async function teamCommand(sub, args) {
       return text;
     };
     let last = await printLane();
-    if (flag(args, '--follow') && !teamCleanupRequested(await readTeamControl(dir))) {
+    if (flag(args, '--follow') && !(await shouldStopLaneFollow())) {
       for (;;) {
         await new Promise((resolve) => setTimeout(resolve, 2000));
         const next = await renderTeamAgentLane(dir, { missionId: id, agent, phase, lines });
@@ -2266,7 +2298,7 @@ async function teamCommand(sub, args) {
           console.log(next);
           last = next;
         }
-        if (teamCleanupRequested(await readTeamControl(dir))) return;
+        if (await shouldStopLaneFollow()) return;
       }
     }
     return;

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.7.74';
+export const PACKAGE_VERSION = '0.7.78';
 export const DEFAULT_PROCESS_TAIL_BYTES = 256 * 1024;
 export const DEFAULT_PROCESS_TIMEOUT_MS = 30 * 60 * 1000;
 

package/src/core/hooks-runtime.mjs

@@ -140,11 +140,11 @@ function clientModelCandidates(value, depth = 0) {
 }
 
 async function hookUserPrompt(root, state, payload, noQuestion) {
-  if (looksLikeCodexGitCommitMessageGeneration(payload)) {
+  if (looksLikeCodexGitAction(payload)) {
     await armCodexGitActionStopBypass(root, payload).catch(() => null);
     return {
       continue: true,
-      systemMessage: 'SKS: Codex App git commit message generation bypassed route gates.'
+      systemMessage: 'SKS: Codex App git action bypassed route gates.'
     };
   }
   if (!noQuestion) {
@@ -355,7 +355,7 @@ async function hookStop(root, state, payload, noQuestion) {
   if (await consumeCodexGitActionStopBypass(root, payload)) {
     return {
       continue: true,
-      systemMessage: 'SKS: Codex App git commit message generation accepted without route finalization gates.'
+      systemMessage: 'SKS: Codex App git action accepted without route finalization gates.'
     };
   }
   if (!noQuestion && (hasDfixLightCompletion(last) || await consumeLightRouteStop(root, payload))) {
@@ -432,7 +432,7 @@ function explicitConversationId(payload = {}) {
   return payload.conversation_id || payload.thread_id || payload.session_id || payload.chat_id || null;
 }
 
-function looksLikeCodexGitCommitMessageGeneration(payload = {}) {
+function looksLikeCodexGitAction(payload = {}) {
   const prompt = stripVisibleDecisionAnswerBlocks(extractUserPrompt(payload));
   const haystack = [
     payload.action,
@@ -460,7 +460,11 @@ function looksLikeCodexGitCommitMessageGeneration(payload = {}) {
     payload.metadata?.feature,
     payload.metadata?.source
   ].filter(Boolean).join(' ');
-  const appSignal = /\b(?:codex[_\s-]*(?:app[_\s-]*)?)?(?:git[_\s-]*)?(?:commit[_\s-]*message|git[_\s-]*commit|codex_git_commit)\b/i.test(haystack)
+  const codexAppGitSignal = /\bcodex[_\s-]*app\b[\s\S]{0,80}\bgit\b[\s\S]{0,80}\b(?:action|actions|commit|push|pr)\b/i.test(haystack);
+  const gitActionSignal = /\bgit[_\s-]*actions?\b[\s\S]{0,80}\b(?:commit|push|commit[\s_-]*(?:and|&)?[\s_-]*push)\b/i.test(haystack);
+  const appSignal = codexAppGitSignal
+    || gitActionSignal
+    || /\b(?:codex[_\s-]*(?:app[_\s-]*)?)?(?:git[_\s-]*)?(?:commit[_\s-]*message|git[_\s-]*commit|codex_git_commit)\b/i.test(haystack)
     || /커밋\s*메시지\s*생성/i.test(haystack);
   const promptSignal = /\bgenerate(?:\s+a)?(?:\s+git)?\s+commit\s+message\b/i.test(prompt)
     || /\bcommit\s+message\b[\s\S]{0,80}\b(?:staged|diff|changes?|git)\b/i.test(prompt)
@@ -478,7 +482,7 @@ async function armCodexGitActionStopBypass(root, payload = {}) {
   const nowMs = Date.now();
   const record = {
     schema_version: 1,
-    route: 'codex_git_commit',
+    route: 'codex_git_action',
     pending_stop_bypass: true,
     conversation_id: conversationId(payload),
     created_at: nowIso(),
@@ -492,7 +496,7 @@ async function consumeCodexGitActionStopBypass(root, payload = {}) {
   const file = path.join(root, '.sneakoscope', 'state', CODEX_GIT_ACTION_STOP_ARTIFACT);
   const record = await readJson(file, null).catch(() => null);
   if (!record?.pending_stop_bypass) return false;
-  if (record.route !== 'codex_git_commit') return false;
+  if (!['codex_git_action', 'codex_git_commit'].includes(record.route)) return false;
   const expiresMs = Date.parse(record.expires_at || '');
   if (!Number.isFinite(expiresMs) || expiresMs < Date.now()) return false;
   const currentConversation = conversationId(payload);
@@ -911,14 +915,26 @@ export async function selftestCodexCommitHooks() {
   const hook = await runHook('user-prompt-submit', { conversation_id: id, action: 'codex_git_commit', prompt: 'Generate a git commit message for the staged diff.' });
   if (hook.code !== 0) throw new Error(`selftest failed: commit hook ${hook.code}: ${hook.stderr}`);
   const hookJson = JSON.parse(hook.stdout);
-  if (hookJson.decision === 'block' || hookJson.hookSpecificOutput?.additionalContext || !String(hookJson.systemMessage || '').includes('git commit message generation')) throw new Error('selftest failed: commit route bypass');
+  if (hookJson.decision === 'block' || hookJson.hookSpecificOutput?.additionalContext || !String(hookJson.systemMessage || '').includes('git action')) throw new Error('selftest failed: commit route bypass');
   const stop = await runHook('stop', { conversation_id: id, last_assistant_message: 'Fix Codex App commit message hook bypass' });
   if (stop.code !== 0) throw new Error(`selftest failed: commit stop ${stop.code}: ${stop.stderr}`);
   const stopJson = JSON.parse(stop.stdout);
   if (stopJson.decision === 'block' || !String(stopJson.systemMessage || '').includes('accepted without route finalization')) throw new Error('selftest failed: commit stop bypass');
+  const commitPushId = 'commit-push-selftest';
+  const appCommitPushHook = await runHook('user-prompt-submit', { conversation_id: commitPushId, action: 'Codex App Git Actions Commit and Push', prompt: 'Commit and push changes.' });
+  if (appCommitPushHook.code !== 0) throw new Error(`selftest failed: app commit-push hook ${appCommitPushHook.code}: ${appCommitPushHook.stderr}`);
+  const appCommitPushJson = JSON.parse(appCommitPushHook.stdout);
+  if (appCommitPushJson.decision === 'block' || appCommitPushJson.hookSpecificOutput?.additionalContext || !String(appCommitPushJson.systemMessage || '').includes('git action')) throw new Error('selftest failed: app commit-push route bypass');
+  const appCommitPushStop = await runHook('stop', { conversation_id: commitPushId, last_assistant_message: 'Commit and push complete.' });
+  if (appCommitPushStop.code !== 0) throw new Error(`selftest failed: app commit-push stop ${appCommitPushStop.code}: ${appCommitPushStop.stderr}`);
+  if (JSON.parse(appCommitPushStop.stdout).decision === 'block') throw new Error('selftest failed: app commit-push stop bypass');
   const userHook = await runHook('user-prompt-submit', { prompt: '[커밋 메시지를 생성하지 못했습니다.] 코덱스 앱에서 이 버그 수정해줘' });
   if (userHook.code !== 0) throw new Error(`selftest failed: user commit hook ${userHook.code}: ${userHook.stderr}`);
   if (!JSON.parse(userHook.stdout).hookSpecificOutput?.additionalContext?.includes('$Team route prepared')) throw new Error('selftest failed: user prompt route');
+  const userCommitPushHook = await runHook('user-prompt-submit', { prompt: '배포하게 커밋하고 푸쉬해줘' });
+  if (userCommitPushHook.code !== 0) throw new Error(`selftest failed: user commit-push hook ${userCommitPushHook.code}: ${userCommitPushHook.stderr}`);
+  const userCommitPushJson = JSON.parse(userCommitPushHook.stdout);
+  if (String(userCommitPushJson.systemMessage || '').includes('git action') || !userCommitPushJson.hookSpecificOutput?.additionalContext) throw new Error('selftest failed: user commit-push prompt should stay on normal route');
 }
 
 function normalizeHookResult(name, result = {}) {

package/src/core/init.mjs

@@ -5,7 +5,7 @@ import { DEFAULT_RETENTION_POLICY } from './retention.mjs';
 import { DEFAULT_DB_SAFETY_POLICY } from './db-safety.mjs';
 import { isHarnessSourceProject, writeHarnessGuardPolicy } from './harness-guard.mjs';
 import { repairSksGeneratedArtifacts } from './harness-conflicts.mjs';
-import { installVersionGitHook } from './version-manager.mjs';
+import { disableVersionGitHook } from './version-manager.mjs';
 import { MIN_TEAM_REVIEWER_LANES, MIN_TEAM_REVIEW_POLICY_TEXT } from './team-review-policy.mjs';
 import { AWESOME_DESIGN_MD_REFERENCE, CODEX_APP_IMAGE_GENERATION_DOC_URL, CODEX_COMPUTER_USE_ONLY_POLICY, CODEX_IMAGEGEN_REQUIRED_POLICY, DESIGN_SYSTEM_SSOT, DOLLAR_COMMANDS, DOLLAR_COMMAND_ALIASES, 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, GETDESIGN_REFERENCE, PPT_CONDITIONAL_SKILL_ALLOWLIST, PPT_PIPELINE_MCP_ALLOWLIST, PPT_PIPELINE_SKILL_ALLOWLIST, RECOMMENDED_DESIGN_REFERENCES, RECOMMENDED_MCP_SERVERS, RECOMMENDED_SKILLS, RESERVED_CODEX_PLUGIN_SKILL_NAMES, SOLUTION_SCOUT_SKILL_NAME, chatCaptureIntakeText, context7ConfigToml, getdesignReferencePolicyText, imageUxReviewPipelinePolicyText, outcomeRubricPolicyText, pptPipelineAllowlistPolicyText, solutionScoutPolicyText, speedLanePolicyText, stackCurrentDocsPolicyText, triwikiContextTracking, triwikiContextTrackingText, triwikiStagePolicyText } from './routes.mjs';
 import { SKILL_DREAM_POLICY, skillDreamPolicyText } from './skill-forge.mjs';
@@ -142,7 +142,7 @@ function isSksManagedHook(hook) {
   return hook.type === 'command' && /\bhook\s+(?:user-prompt-submit|pre-tool|post-tool|permission-request|stop)\b/.test(command) && /\b(?:sks|sneakoscope|sks\.mjs)\b/.test(command);
 }
 
-const AGENTS_BLOCK = "\n# Sneakoscope Codex Managed Rules\n\nThis repository uses Sneakoscope Codex.\n\n## Core Rules\n\n- Codex native `/goal` workflows are the persisted continuation surface; Ralph is removed from the user-facing SKS surface.\n- Keep runtime state bounded: raw logs go to files, prompts get tails/summaries, and `sks gc` may prune stale artifacts.\n- Before substantive work, SKS checks npm for a newer package. If newer, ask update-now vs skip-for-this-conversation.\n- Versioning is managed by the SKS pre-commit hook; check `sks versioning status`. Bypass only with `SKS_DISABLE_VERSIONING=1`.\n- Installed harness files are immutable to LLM edits: `.codex/*`, `.agents/skills/`, `.codex/agents/`, `.sneakoscope/*policy*.json`, `AGENTS.md`, and `node_modules/sneakoscope`. The Sneakoscope engine source repo is the only automatic exception.\n- OMX/DCodex conflicts block setup/doctor. Show `sks conflicts prompt`; cleanup requires explicit human approval.\n- Do not stop at a plan when implementation was requested. Finish, verify, or report the hard blocker.\n- Do not create unrequested fallback implementation code. If the requested path is impossible, block with evidence instead of inventing substitute behavior.\n\n## Routes\n\n- General execution/code-changing prompts default to `$Team`: analysis scouts, TriWiki refresh/validate, read-only debate, consensus, concrete runtime task graph/inboxes, fresh executor team, minimum five-lane Team review, integration, Honest Mode.\n- `$Computer-Use` / `$CU` is the maximum-speed Codex Computer Use lane for UI/browser/visual tasks: skip Team debate and upfront TriWiki loops, use Codex Computer Use directly, then refresh/validate TriWiki and run Honest Mode at final closeout.\n- `$Goal` is a fast bridge/overlay for Codex native `/goal` create/pause/resume/clear persistence controls; implementation continues through the selected SKS execution route.\n- TriWiki recall must stay bounded. Use `sks wiki sweep` to record demote, soft-forget, archive, delete, promote-to-skill, and promote-to-rule candidates instead of injecting every old claim.\n- Team missions must keep schema-backed evidence current: `work-order-ledger.json`, `effort-decision.json`, `team-dashboard-state.json`, and route-specific visual/dogfood artifacts where applicable. Team completion requires at least five independent reviewer/QA validation lanes before integration or final, even when a prompt requests fewer reviewers. Use `sks validate-artifacts latest` before claiming those artifacts pass.\n- `$DFix` is Direct Fix: only tiny copy/config/docs/labels/spacing/translation/simple mechanical edits, bypassing the main pipeline, Team, TriWiki/TriFix/reflection recording, and persistent route state; it still uses a one-line DFix-specific Honest check before final. Broad implementation stays on `$Team`, while UI design specifics follow the relevant design/UI route rules. `$PPT` is the restrained, information-first HTML/PDF presentation route and must seal delivery context, audience profile, STP, decision context, and 3+ pain-point/solution/aha mappings before design/render work. It must avoid over-designed visuals, carry detail through hierarchy, spacing, alignment, thin rules, source clarity, and subtle accents, preserve editable source HTML under `source-html/`, record `ppt-parallel-report.json`, and clean PPT-only temporary build files before completion. `$Answer`, `$Help`, and `$Wiki` stay lightweight.\n- For code work, surface route/guard/write scopes first, split independent worker scopes when available, and keep parent-owned integration and verification.\n- Design work reads `design.md` as the only design decision SSOT. If missing, create it through `design-system-builder` from `docs/Design-Sys-Prompt.md`; getdesign.md, getdesign-reference, and curated DESIGN.md examples from https://github.com/VoltAgent/awesome-design-md are source inputs to fuse into that SSOT or route-local style tokens, not parallel design authorities. Image/logo/raster assets use `imagegen`, which must prefer official Codex App built-in image generation via `$imagegen` / `gpt-image-2` before API generation and must not be replaced by placeholder SVG/HTML/CSS, prose-only reviews, or fabricated files when generated raster evidence is required.\n- Research, AutoResearch, performance, token, accuracy, SEO/GEO, or workflow-improvement claims need experiment/eval evidence. Do not claim live model accuracy without a scored dataset.\n- Treat handwritten files above 3000 lines as split-review risks. Run `sks code-structure scan` and prefer extraction before adding substantial logic.\n- Skill dreaming stays lightweight: route use records JSON counters in `.sneakoscope/skills/dream-state.json`, and full skill inventory/recommendation runs only after the configured 10-route-event threshold and cooldown. Reports are recommendation-only; deleting or merging skills needs explicit user approval.\n\n## Evidence And Context\n\n- Context7 is required for external libraries, APIs, MCPs, package managers, SDKs, and generated docs: resolve-library-id then query-docs.\n- When tech stack, framework, package, runtime, or deployment-platform versions change, use Context7 or official vendor web docs, record current syntax/security/limit guidance as high-priority TriWiki claims, then refresh and validate before coding.\n- TriWiki is the context-tracking SSOT for long-running missions, Team handoffs, and context-pressure recovery. Read `.sneakoscope/wiki/context-pack.json` before each stage, use `attention.use_first` for compact high-trust recall, hydrate `attention.hydrate_first` from source before risky or lower-trust decisions, refresh after findings or artifact changes, and validate before handoffs/final claims.\n- Source priority: current code/tests/config, decision contract, vgraph, beta, GX render/snapshot metadata, LLM Wiki coordinate index, then model knowledge only if allowed.\n- Final response before stop: summarize what was done, what changed for the user/repo, what was verified, and what remains unverified or blocked; then run Honest Mode. Say what passed and what was not verified.\n- `$From-Chat-IMG` uses forensic visual effort, not ordinary Team effort. Completion is blocked until source inventory, visual mapping, work-order coverage, scoped dogfood/QA, and post-fix verification artifacts are present and valid.\n\n## Safety\n\n- Database access is high risk. Use read-only inspection by default; live data mutation is out of scope unless a sealed contract allows local or branch-only migration files.\n- MAD and MAD-SKS widen only explicit scoped permissions; they still do not authorize unrequested fallback implementation code.\n- Task completion requires relevant tests or justification, zero unsupported critical claims, accepted visual/wiki drift, and final evidence.\n\n## Codex App\n\nUse `.codex/SNEAKOSCOPE.md`, generated `.agents/skills`, `.codex/hooks.json`, and SKS dollar commands (`$sks`, `$team`, `$computer-use`, `$cu`, `$ppt`, `$goal`, `$dfix`, `$qa-loop`, etc.) as the app control surface.\n";
+const AGENTS_BLOCK = "\n# Sneakoscope Codex Managed Rules\n\nThis repository uses Sneakoscope Codex.\n\n## Core Rules\n\n- Codex native `/goal` workflows are the persisted continuation surface; Ralph is removed from the user-facing SKS surface.\n- Keep runtime state bounded: raw logs go to files, prompts get tails/summaries, and `sks gc` may prune stale artifacts.\n- Before substantive work, SKS checks npm for a newer package. If newer, ask update-now vs skip-for-this-conversation.\n- Versioning is explicit: use `sks versioning bump` when preparing release metadata. SKS must not install Git pre-commit hooks.\n- Installed harness files are immutable to LLM edits: `.codex/*`, `.agents/skills/`, `.codex/agents/`, `.sneakoscope/*policy*.json`, `AGENTS.md`, and `node_modules/sneakoscope`. The Sneakoscope engine source repo is the only automatic exception.\n- OMX/DCodex conflicts block setup/doctor. Show `sks conflicts prompt`; cleanup requires explicit human approval.\n- Do not stop at a plan when implementation was requested. Finish, verify, or report the hard blocker.\n- Do not create unrequested fallback implementation code. If the requested path is impossible, block with evidence instead of inventing substitute behavior.\n\n## Routes\n\n- General execution/code-changing prompts default to `$Team`: analysis scouts, TriWiki refresh/validate, read-only debate, consensus, concrete runtime task graph/inboxes, fresh executor team, minimum five-lane Team review, integration, Honest Mode.\n- `$Computer-Use` / `$CU` is the maximum-speed Codex Computer Use lane for UI/browser/visual tasks: skip Team debate and upfront TriWiki loops, use Codex Computer Use directly, then refresh/validate TriWiki and run Honest Mode at final closeout.\n- `$Goal` is a fast bridge/overlay for Codex native `/goal` create/pause/resume/clear persistence controls; implementation continues through the selected SKS execution route.\n- TriWiki recall must stay bounded. Use `sks wiki sweep` to record demote, soft-forget, archive, delete, promote-to-skill, and promote-to-rule candidates instead of injecting every old claim.\n- Team missions must keep schema-backed evidence current: `work-order-ledger.json`, `effort-decision.json`, `team-dashboard-state.json`, and route-specific visual/dogfood artifacts where applicable. Team completion requires at least five independent reviewer/QA validation lanes before integration or final, even when a prompt requests fewer reviewers. Use `sks validate-artifacts latest` before claiming those artifacts pass.\n- `$DFix` is Direct Fix: only tiny copy/config/docs/labels/spacing/translation/simple mechanical edits, bypassing the main pipeline, Team, TriWiki/TriFix/reflection recording, and persistent route state; it still uses a one-line DFix-specific Honest check before final. Broad implementation stays on `$Team`, while UI design specifics follow the relevant design/UI route rules. `$PPT` is the restrained, information-first HTML/PDF presentation route and must seal delivery context, audience profile, STP, decision context, and 3+ pain-point/solution/aha mappings before design/render work. It must avoid over-designed visuals, carry detail through hierarchy, spacing, alignment, thin rules, source clarity, and subtle accents, preserve editable source HTML under `source-html/`, record `ppt-parallel-report.json`, and clean PPT-only temporary build files before completion. `$Answer`, `$Help`, and `$Wiki` stay lightweight.\n- For code work, surface route/guard/write scopes first, split independent worker scopes when available, and keep parent-owned integration and verification.\n- Design work reads `design.md` as the only design decision SSOT. If missing, create it through `design-system-builder` from `docs/Design-Sys-Prompt.md`; getdesign.md, getdesign-reference, and curated DESIGN.md examples from https://github.com/VoltAgent/awesome-design-md are source inputs to fuse into that SSOT or route-local style tokens, not parallel design authorities. Image/logo/raster assets use `imagegen`, which must prefer official Codex App built-in image generation via `$imagegen` / `gpt-image-2` before API generation and must not be replaced by placeholder SVG/HTML/CSS, prose-only reviews, or fabricated files when generated raster evidence is required.\n- Research, AutoResearch, performance, token, accuracy, SEO/GEO, or workflow-improvement claims need experiment/eval evidence. Do not claim live model accuracy without a scored dataset.\n- Treat handwritten files above 3000 lines as split-review risks. Run `sks code-structure scan` and prefer extraction before adding substantial logic.\n- Skill dreaming stays lightweight: route use records JSON counters in `.sneakoscope/skills/dream-state.json`, and full skill inventory/recommendation runs only after the configured 10-route-event threshold and cooldown. Reports are recommendation-only; deleting or merging skills needs explicit user approval.\n\n## Evidence And Context\n\n- Context7 is required for external libraries, APIs, MCPs, package managers, SDKs, and generated docs: resolve-library-id then query-docs.\n- When tech stack, framework, package, runtime, or deployment-platform versions change, use Context7 or official vendor web docs, record current syntax/security/limit guidance as high-priority TriWiki claims, then refresh and validate before coding.\n- TriWiki is the context-tracking SSOT for long-running missions, Team handoffs, and context-pressure recovery. Read `.sneakoscope/wiki/context-pack.json` before each stage, use `attention.use_first` for compact high-trust recall, hydrate `attention.hydrate_first` from source before risky or lower-trust decisions, refresh after findings or artifact changes, and validate before handoffs/final claims.\n- Source priority: current code/tests/config, decision contract, vgraph, beta, GX render/snapshot metadata, LLM Wiki coordinate index, then model knowledge only if allowed.\n- Final response before stop: summarize what was done, what changed for the user/repo, what was verified, and what remains unverified or blocked; then run Honest Mode. Say what passed and what was not verified.\n- `$From-Chat-IMG` uses forensic visual effort, not ordinary Team effort. Completion is blocked until source inventory, visual mapping, work-order coverage, scoped dogfood/QA, and post-fix verification artifacts are present and valid.\n\n## Safety\n\n- Database access is high risk. Use read-only inspection by default; live data mutation is out of scope unless a sealed contract allows local or branch-only migration files.\n- MAD and MAD-SKS widen only explicit scoped permissions; they still do not authorize unrequested fallback implementation code.\n- Task completion requires relevant tests or justification, zero unsupported critical claims, accepted visual/wiki drift, and final evidence.\n\n## Codex App\n\nUse `.codex/SNEAKOSCOPE.md`, generated `.agents/skills`, `.codex/hooks.json`, and SKS dollar commands (`$sks`, `$team`, `$computer-use`, `$cu`, `$ppt`, `$goal`, `$dfix`, `$qa-loop`, etc.) as the app control surface.\n";
 
 function agentsBlockText() {
   return AGENTS_BLOCK
@@ -249,8 +249,7 @@ export async function initProject(root, opts = {}) {
       exclude_path: localExclude?.path ? path.relative(root, localExclude.path) : null,
       excluded_patterns: localExclude?.patterns || [],
       versioning: {
-        enabled: true,
-        hook: 'pre-commit',
+        enabled: false,
         bump: 'patch',
         lock: 'git-common-dir/sks-version.lock',
         state: 'git-common-dir/sks-version-state.json'
@@ -286,8 +285,7 @@ export async function initProject(root, opts = {}) {
         excluded_patterns: localExclude?.patterns || policy.git?.excluded_patterns || [],
         versioning: {
           ...(policy.git?.versioning || {}),
-          enabled: true,
-          hook: 'pre-commit',
+          enabled: false,
           bump: policy.git?.versioning?.bump || 'patch',
           lock: 'git-common-dir/sks-version.lock',
           state: 'git-common-dir/sks-version-state.json'
@@ -295,9 +293,9 @@ export async function initProject(root, opts = {}) {
       },
       versioning: {
         ...(policy.versioning || {}),
-        enabled: true,
+        enabled: false,
         bump: policy.versioning?.bump || 'patch',
-        trigger: 'git-pre-commit',
+        trigger: 'manual',
         lock_scope: 'git-common-dir',
         managed_files: ['package.json', 'package-lock.json', 'npm-shrinkwrap.json']
       },
@@ -361,8 +359,7 @@ export async function initProject(root, opts = {}) {
         exclude_path: localExclude?.path ? path.relative(root, localExclude.path) : null,
         excluded_patterns: localExclude?.patterns || [],
         versioning: {
-          enabled: true,
-          hook: 'pre-commit',
+          enabled: false,
           bump: 'patch',
           lock: 'git-common-dir/sks-version.lock',
           state: 'git-common-dir/sks-version-state.json'
@@ -376,12 +373,12 @@ export async function initProject(root, opts = {}) {
         skip_scope: 'conversation_only'
       },
       versioning: {
-        enabled: true,
+        enabled: false,
         bump: 'patch',
-        trigger: 'git-pre-commit',
+        trigger: 'manual',
         lock_scope: 'git-common-dir',
         managed_files: ['package.json', 'package-lock.json', 'npm-shrinkwrap.json'],
-        collision_policy: 'lock_then_bump_above_last_seen_version'
+        collision_policy: 'explicit_bump_only'
       },
       honest_mode: {
         required_before_final: true,
@@ -778,10 +775,8 @@ function upsertTomlTable(text, table, block) {
   await writeJsonAtomic(manifestPath, manifest);
   await writeHarnessGuardPolicy(root);
   created.push('.sneakoscope/harness-guard.json');
-  const versionHookCommand = sourceProject ? 'node ./bin/sks.mjs' : hookCommandPrefix;
-  const versionHook = await installVersionGitHook(root, versionHookCommand);
-  if (versionHook.installed) created.push('.git/hooks/pre-commit SKS version guard');
-  else created.push(`version guard skipped (${versionHook.reason})`);
+  const versionHookCleanup = await disableVersionGitHook(root);
+  created.push(versionHookCleanup.hook_removed ? '.git/hooks/pre-commit SKS version guard removed' : `version guard disabled (${versionHookCleanup.reason || 'policy updated'})`);
   return { created, generated_cleanup: generatedCleanup, skill_install: skillInstall };
 }
 

package/src/core/pipeline.mjs

@@ -12,7 +12,7 @@ import { writeMemorySweepReport } from './memory-governor.mjs';
 import { writeMistakeMemoryReport } from './mistake-memory.mjs';
 import { MISTAKE_RECALL_ARTIFACT, mistakeRecallGateStatus } from './mistake-recall.mjs';
 import { recordSkillDreamEvent, skillDreamPolicyText, writeSkillForgeReport } from './skill-forge.mjs';
-import { writeResearchPlan } from './research.mjs';
+import { evaluateResearchGate, writeResearchPlan } from './research.mjs';
 import { PPT_REQUIRED_GATE_FIELDS, writePptRouteArtifacts } from './ppt.mjs';
 import { writeQaLoopArtifacts } from './qa-loop.mjs';
 import { IMAGE_UX_REVIEW_GATE_ARTIFACT, IMAGE_UX_REVIEW_POLICY_ARTIFACT, IMAGE_UX_REVIEW_SCREEN_INVENTORY_ARTIFACT, IMAGE_UX_REVIEW_GENERATED_REVIEW_LEDGER_ARTIFACT, IMAGE_UX_REVIEW_ISSUE_LEDGER_ARTIFACT, IMAGE_UX_REVIEW_ITERATION_REPORT_ARTIFACT, IMAGE_UX_REVIEW_REQUIRED_GATE_FIELDS, writeImageUxReviewRouteArtifacts } from './image-ux-review.mjs';
@@ -1456,6 +1456,11 @@ function missingRequiredGateFields(file, state, gate = {}) {
 
 async function missingRequiredGateArtifacts(root, file, state, gate = {}) {
   const mode = String(state?.mode || '').toUpperCase();
+  if (file === 'research-gate.json' || mode === 'RESEARCH') {
+    const evaluated = await evaluateResearchGate(missionDir(root, state.mission_id));
+    if (evaluated.passed === true) return [];
+    return (evaluated.reasons || ['research_gate_blocked']).map((reason) => `research-gate:${reason}`);
+  }
   if (file === IMAGE_UX_REVIEW_GATE_ARTIFACT || mode === 'IMAGE_UX_REVIEW') return missingImageUxReviewArtifacts(root, state, gate);
   if (file !== 'team-gate.json' && mode !== 'TEAM') return [];
   const missing = [];

package/src/core/routes.mjs

@@ -523,8 +523,8 @@ export const COMMAND_CATALOG = [
   { 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 [tmux|codex|context7|all] [--yes]', description: 'Check or guided-install Node/npm PATH, Codex CLI/App, Context7, Browser Use, Computer Use, tmux, and Homebrew on macOS.' },
   { name: 'codex-app', usage: 'sks codex-app [check|open|remote-control]', description: 'Check Codex App install and first-party MCP/plugin readiness, then show app setup files, examples, and Codex CLI 0.130.0+ remote-control availability.' },
-  { name: 'codex-lb', usage: 'sks codex-lb status|repair|setup --host <domain> --api-key <key>', description: 'Configure or repair codex-lb Codex CLI auth by writing ~/.codex/config.toml, syncing auth.json, and loading the CODEX_LB_API_KEY env file.' },
-  { name: 'auth', usage: 'sks auth status|repair|setup --host <domain> --api-key <key>', description: 'Shortcut for codex-lb auth status, repair, and setup commands.' },
+  { name: 'codex-lb', usage: 'sks codex-lb status|health|repair|setup --host <domain> --api-key <key>', description: 'Configure, health-check, or repair codex-lb Codex CLI auth by writing ~/.codex/config.toml, syncing auth.json, and loading the CODEX_LB_API_KEY env file.' },
+  { name: 'auth', usage: 'sks auth status|health|repair|setup --host <domain> --api-key <key>', description: 'Shortcut for codex-lb auth status, health, repair, and setup commands.' },
   { name: 'openclaw', usage: 'sks openclaw install|path|print [--dir path] [--force] [--json]', description: 'Generate an OpenClaw skill package so OpenClaw agents can discover and use local SKS workflows.' },
   { name: 'tmux', usage: 'sks | sks tmux open|check|status [--workspace name]', description: 'Open the default SKS tmux runtime with bare sks, or use tmux subcommands for explicit launch/check/status.' },
   { name: 'mad', usage: 'sks --mad [--high]', description: 'Open a one-shot tmux Codex CLI workspace with the SKS MAD full-access auto-review profile.' },
@@ -538,7 +538,7 @@ export const COMMAND_CATALOG = [
   { name: 'pipeline', usage: 'sks pipeline status|resume|plan|answer ...', description: 'Inspect the active skill-first route, materialized execution plan, ambiguity gates, and completion gates.' },
   { name: 'guard', usage: 'sks guard check [--json]', description: 'Check SKS harness self-protection lock, fingerprints, and source-repo exception state.' },
   { name: 'conflicts', usage: 'sks conflicts check|prompt [--json]', description: 'Detect other Codex harnesses such as OMX/DCodex and print the GPT-5.5 high cleanup prompt.' },
-  { name: 'versioning', usage: 'sks versioning status|bump|pre-commit [--json]', description: 'Manage automatic project version bumps on every commit with a shared Git lock.' },
+  { name: 'versioning', usage: 'sks versioning status|bump|disable [--json]', description: 'Manage explicit project version syncs; SKS does not install Git pre-commit hooks.' },
   { name: 'aliases', usage: 'sks aliases', description: 'Show command aliases and npm binary names.' },
   { name: 'setup', usage: 'sks setup [--bootstrap] [--install-scope global|project] [--local-only] [--force] [--json]', description: 'Initialize SKS state, Codex App files, hooks, skills, and rules.' },
   { name: 'fix-path', usage: 'sks fix-path [--install-scope global|project] [--json]', description: 'Refresh hook commands with the resolved SKS binary path.' },

package/src/core/team-live.mjs

@@ -8,6 +8,32 @@ const MAX_LIVE_BYTES = 192 * 1024;
 const TEAM_RUNTIME_TASKS_ARTIFACT = 'team-runtime-tasks.json';
 const TEAM_SESSION_CLEANUP_ARTIFACT = 'team-session-cleanup.json';
 const DEFAULT_AGENTS = ['parent_orchestrator', 'analysis_scout', 'team_consensus', 'implementation_worker', 'db_safety_reviewer', 'qa_reviewer'];
+const TERMINAL_TEAM_AGENT_STATUSES = new Set([
+  'agent_closed',
+  'agent_done',
+  'cancelled',
+  'canceled',
+  'cleanup',
+  'cleanup_requested',
+  'closed',
+  'complete',
+  'completed',
+  'done',
+  'ended',
+  'failed',
+  'stopped',
+  'terminal',
+  'tmux_lane_closed'
+]);
+const CHAT_COLOR_CODES = {
+  blue: '34',
+  cyan: '36',
+  yellow: '33',
+  magenta: '35',
+  red: '31',
+  green: '32',
+  gray: '90'
+};
 export const DEFAULT_TEAM_ROLE_COUNTS = { user: 1, planner: 1, reviewer: MIN_TEAM_REVIEWER_LANES, executor: 3 };
 export const DEFAULT_MAX_TEAM_AGENT_SESSIONS = 6;
 const ROLE_ALIASES = {
@@ -440,11 +466,13 @@ export async function appendTeamEvent(dir, event) {
     dashboard.updated_at = record.ts;
     dashboard.latest_messages = [...(dashboard.latest_messages || []), record].slice(-20);
     const agent = record.agent || 'unknown';
+    const terminalStatus = terminalTeamAgentStatusFromEvent(record);
     dashboard.agents ||= {};
     dashboard.agents[agent] ||= {};
-    dashboard.agents[agent].status = record.type || 'active';
+    dashboard.agents[agent].status = terminalStatus || record.type || 'active';
     dashboard.agents[agent].phase = record.phase || null;
     dashboard.agents[agent].last_seen = record.ts;
+    if (terminalStatus) dashboard.agents[agent].closed_at = record.ts;
     await writeJsonAtomic(files.dashboard, dashboard);
   }
   await reconcileTeamTmuxFromEvent(dir, record).catch(() => null);
@@ -508,6 +536,22 @@ export function teamCleanupRequested(control = {}) {
   return Boolean(control?.cleanup_requested || control?.status === 'cleanup_requested' || control?.status === 'ended');
 }
 
+export function isTerminalTeamAgentStatus(status = '') {
+  const normalized = String(status || '').trim().toLowerCase();
+  return TERMINAL_TEAM_AGENT_STATUSES.has(normalized) || /(?:^|_)(?:done|complete|completed|closed|cleanup|cancelled|canceled|failed|ended|stopped)(?:_|$)/.test(normalized);
+}
+
+export function terminalTeamAgentStatusFromEvent(event = {}) {
+  const type = String(event.type || '').trim().toLowerCase();
+  if (isTerminalTeamAgentStatus(type)) return type;
+  const phase = String(event.phase || '').trim().toLowerCase();
+  if (isTerminalTeamAgentStatus(phase)) return phase;
+  const message = String(event.message || '').trim();
+  if (/^(?:done|complete|completed|finished|final|closed|agent_done|agent_closed)\b/i.test(message)) return 'completed';
+  if (/(?:작업|분석|구현|검토|리뷰|qa|lane|agent|에이전트).{0,40}(?:완료|종료|끝)/i.test(message)) return 'completed';
+  return '';
+}
+
 export function renderTeamCleanupSummary(control = {}) {
   if (!teamCleanupRequested(control)) return '';
   return [
@@ -558,6 +602,7 @@ export async function renderTeamAgentLane(dir, opts = {}) {
     .sort((a, b) => String(a.ts || '').localeCompare(String(b.ts || '')))
     .slice(-lines);
   const laneStyle = teamLaneTextStyle(agent);
+  const colorChat = terminalChatColorEnabled(opts);
   return [
     `# SKS Team Agent Lane`,
     '',
@@ -577,7 +622,7 @@ export async function renderTeamAgentLane(dir, opts = {}) {
     ...(runtime ? formatRuntimeTasks(assignedTasks) : ['- team-runtime-tasks.json not available yet.']),
     '',
     `## Codex Chat`,
-    ...(chatEvents.length ? chatEvents.map((event) => formatChatTranscriptEvent(event, aliases[0])) : ['- waiting for live agent messages...']),
+    ...(chatEvents.length ? chatEvents.map((event) => formatChatTranscriptEvent(event, aliases[0], { color: colorChat })) : ['- waiting for live agent messages...']),
     opts.includeGlobalTail ? '' : null,
     opts.includeGlobalTail ? `## Global Tail` : null,
     ...(opts.includeGlobalTail
@@ -709,25 +754,49 @@ function uniqueTranscriptEvents(events = []) {
   return out;
 }
 
-function formatChatTranscriptEvent(event = {}, laneAgent = '') {
-  if (event.raw) return codexChatBlock({ speaker: 'system', message: event.raw });
+function formatChatTranscriptEvent(event = {}, laneAgent = '', opts = {}) {
+  if (event.raw) return codexChatBlock({ speaker: 'system', kind: 'raw', style: teamLaneTextStyle('overview'), color: opts.color, message: event.raw });
   const from = event.agent || 'unknown';
-  const to = event.to ? ` -> ${event.to}` : '';
-  const kind = event.type && event.type !== 'message' ? ` [${event.type}]` : '';
   const ts = event.ts ? `${event.ts} ` : '';
   const artifact = event.artifact ? ` (${event.artifact})` : '';
-  const marker = String(from) === String(laneAgent) ? 'me' : from;
+  const isLaneAgent = String(from) === String(laneAgent);
   return codexChatBlock({
-    speaker: `${marker}${to}${kind}`,
+    speaker: isLaneAgent ? `me (${from})` : from,
+    to: event.to || '',
+    kind: event.type || 'message',
     meta: ts.trim(),
+    style: teamLaneTextStyle(from),
+    color: opts.color,
     message: `${String(event.message || '').slice(0, 500)}${artifact}`
   });
 }
 
-function codexChatBlock({ speaker = 'agent', meta = '', message = '' } = {}) {
-  const header = [speaker, meta].filter(Boolean).join(' | ');
-  const body = String(message || '').split(/\r?\n/).map((line) => `| ${line}`).join('\n');
-  return [`+-- ${header}`, body || '|', '+--'].join('\n');
+function codexChatBlock({ speaker = 'agent', to = '', kind = '', meta = '', style = {}, color = false, message = '' } = {}) {
+  const role = style?.role || 'agent';
+  const roleKind = [kind, role].filter(Boolean).join('/');
+  const target = to ? ` -> ${to}` : '';
+  const header = [
+    colorizeChatText(`${speaker}${target}`, style, color, { bold: true }),
+    roleKind ? colorizeChatText(`[${roleKind}]`, style, color) : null,
+    meta ? colorizeChatText(`| ${meta}`, { color_name: 'Gray' }, color) : null
+  ].filter(Boolean).join(' ');
+  const border = (text) => colorizeChatText(text, style, color);
+  const body = String(message || '').split(/\r?\n/).map((line) => `${border('│')} ${colorizeChatText(line || ' ', style, color)}`).join('\n');
+  return [`${border('╭─')} ${header}`, body || `${border('│')} `, border('╰─')].join('\n');
+}
+
+function terminalChatColorEnabled(opts = {}) {
+  if (Object.prototype.hasOwnProperty.call(opts, 'color')) return Boolean(opts.color);
+  if (process.env.NO_COLOR) return false;
+  return Boolean(process.stdout?.isTTY);
+}
+
+function colorizeChatText(text, style = {}, enabled = false, opts = {}) {
+  if (!enabled) return text;
+  const colorName = String(style?.color_name || 'gray').toLowerCase();
+  const colorCode = CHAT_COLOR_CODES[colorName] || CHAT_COLOR_CODES.gray;
+  const code = opts.bold ? `1;${colorCode}` : colorCode;
+  return `\x1b[${code}m${text}\x1b[0m`;
 }
 
 function eventAddressedTo(event = {}, agent = '') {