@cjhyy/code-shell 0.2.0 → 0.5.0-rc.1

package/CHANGELOG.md

@@ -8,6 +8,189 @@ breaking.
 
 ## [Unreleased]
 
+### Added
+
+#### Reusable sub-agent roles (`.code-shell/agents`)
+
+- The `Agent` tool now accepts an optional `agent_type` parameter. When set, it
+  loads a reusable role definition from `<cwd>/.code-shell/agents/<name>.md`
+  (YAML frontmatter + body), supplying the sub-agent's model, tool allowlist,
+  turn cap, and system prompt. Omitting `agent_type` preserves the existing
+  ephemeral behavior — fully backward compatible.
+- Per-role **model routing** via `ModelPool` keys (unknown key → soft fallback
+  to the parent model), per-role **tool allowlists**, and per-role **turn caps**.
+- Background sub-agents are now capped at `MAX_BACKGROUND_AGENTS` (default 6);
+  synchronous sub-agents have a wall-clock timeout (default 5 minutes).
+- Sub-agent spawns emit `subagent_start` / `subagent_finish` / `subagent_error`
+  lifecycle events through the existing `notification` hook.
+- Ships sample roles under `examples/agents/`: `researcher` and `explorer`
+  (read-only), `planner` (read-only planning), and `general-purpose` (full
+  tools). Their `model` is left unset so they reuse the parent model — set
+  `model:` in the frontmatter to route a role to a specific pool key.
+
+## [0.5.0-rc.0] - 2026-05-23
+
+> ⚠️ Breaking. The repo is now a monorepo with three published packages.
+> The single-package install path still works (`@cjhyy/code-shell` re-exports
+> everything from core), but direct deep imports into `src/...` are gone.
+> Migrate to the public package APIs before upgrading.
+
+### Changed
+
+#### Monorepo split — three packages
+
+The codebase was split into a Bun workspace with three publishable packages
+plus one private Electron POC:
+
+- **`@cjhyy/code-shell-core`** — the engine. Engine, AgentServer, hooks,
+  tool system, LLM clients, session, protocol types, presets. Zero UI
+  dependencies. Headless and embeddable in any host (TUI, Electron main,
+  server). No React, no Ink, no chalk.
+- **`@cjhyy/code-shell-tui`** — the terminal client. Owns the React/Ink
+  render layer, the `code-shell` CLI bin, themes, key bindings, all
+  terminal-only utilities. Imports core; nothing else imports it.
+- **`@cjhyy/code-shell`** (meta) — thin re-export shim. `import { Engine }
+  from "@cjhyy/code-shell"` still works for SDK users; the `code-shell`
+  bin loads the TUI CLI. Ships three files total: `index.js`, `index.d.ts`,
+  `cli.js`.
+- **`@cjhyy/code-shell-desktop`** (private) — Electron POC. Currently a
+  build-pipeline skeleton (main + preload + renderer + esbuild/vite
+  orchestration). Not published.
+
+Existing users on `@cjhyy/code-shell` see no API change; deep-import users
+(`@cjhyy/code-shell/src/...`) must migrate to the public surface.
+
+#### Core decoupled from chalk
+
+`@cjhyy/code-shell-core` no longer depends on `chalk`. ~70 chalk call sites
+across cost-tracker, arena render, theme, and CLI-shared modules were
+replaced with an injected `Colorizer` interface. Hosts pass a colorizer
+implementation (TUI uses chalk; Electron / headless use `NOOP_COLORIZER`).
+This removes core's last terminal-formatting dependency and lets non-TTY
+hosts render the same data structures with their own styling.
+
+### Added
+
+- ESLint architectural guards: renderer cannot import core directly;
+  no-engine-bypass check enforced.
+- `scripts/build-meta.ts` — produces the meta package's three-file dist.
+- `packages/desktop/scripts/{dev,build}.ts` — three-process orchestrator
+  (vite renderer + esbuild main + esbuild preload).
+
+### Removed
+
+- `chalk` dependency from `@cjhyy/code-shell-core`.
+- All deep-import paths under `src/...`. Use `@cjhyy/code-shell-core`'s
+  public surface (`@cjhyy/code-shell` for SDK users).
+
+## [0.3.0] - 2026-05-20
+
+### Added
+
+#### Hook system — Claude Code parity
+
+The HookRegistry skeleton that landed earlier now has actual emit points,
+result consumption, and two new ways for users to register handlers.
+After this release, every event Claude Code exposes has a codeshell
+equivalent that is actually emitted, handler return values are fully
+consumed, and users can wire shell-command hooks via `settings.json` or
+plugin `hooks.json` files.
+
+- **New lifecycle emits.** `on_session_start`, `on_session_end`,
+  `user_prompt_submit`, `post_compact`, `on_permission_check`,
+  `notification`. The first three carry `messages`, `decision`, and
+  the new mutation fields into the conversation as a single
+  `<system-reminder>` block.
+- **Decision semantics complete.** `pre_tool_use` handlers can now
+  return `decision: "allow"` to skip the PermissionClassifier entirely,
+  or `decision: "ask"` to route through ApprovalBackend with the
+  handler's messages threaded into the prompt description.
+- **HookResult mutations.** New fields `updatedInput` (rewrite tool
+  args, re-validated against the schema), `additionalContext` (append
+  text to a successful tool's output), and `updatedPrompt` (replace the
+  user's prompt text on `user_prompt_submit`). Registry aggregation is
+  last-write-wins for input/prompt, newline-joined for additionalContext.
+- **`settings.json` shell hooks.** New `hooks: [{event, command,
+  matcher?, timeout_ms?, cwd?}]` schema. Engine spawns the command per
+  emit with the CC wire protocol — stdin is the HookContext JSON,
+  stdout is a HookResult JSON, exit 2 = deny with stderr surfaced to
+  the model. `CODESHELL_HOOK_EVENT` / `CODESHELL_HOOK_CWD` env vars
+  are passed to the child; default 60s timeout with SIGTERM → SIGKILL
+  cleanup.
+- **CC plugin `hooks.json` auto-load.** `loadPluginHooks` scans every
+  installed plugin's `hooks/hooks.json` and registers the
+  command-type entries. PascalCase event names (SessionStart,
+  UserPromptSubmit, PreToolUse, …) are mapped to codeshell's
+  snake_case. SubagentStop is dropped (codeshell doesn't surface that
+  event). `pluginCommandHook` normalizes the three known plugin
+  stdout shapes (`hookSpecificOutput.additionalContext`,
+  `additional_context`, `additionalContext`) into HookResult.messages.
+- **`varRewrite` at install time.** Plugin trees materialized through
+  `installPlugin` get `${CLAUDE_PLUGIN_ROOT}` rewritten to
+  `${CODESHELL_PLUGIN_ROOT}` across every text file, so CC-authored
+  plugin scripts that branch on host detection pick the codeshell
+  path. `InstallResult.varRewrite` reports counts and `/plugin
+  install` prints a `rewrote: N file(s)` line so the modification is
+  visible.
+- **`ToolContext.hooks`.** Tools that need to emit lifecycle events
+  (currently `notification` on background sub-agent terminal states)
+  reach the registry without going through Engine.
+- **User guide.** `docs/hooks.md` documents the full event surface,
+  HookResult fields, shell protocol, priority chain, and CC migration
+  notes.
+
+#### Arena
+
+- `/arena-status` now reads `settings.arena.participants` and uses it
+  when present, mirroring how the actual Arena execution path already
+  resolves participants. Fixes a divergence where the diagnostic
+  preview showed the auto-derived pool while real runs used the
+  curated list.
+
+### Changed
+
+- **`isSubAgent` auto-merged into hook ctx.data.** All Engine-side
+  emits go through `Engine.emitHook` / `TurnLoop.emitHook`, which
+  injects `isSubAgent` (and `sessionId` for turn-loop) into
+  `ctx.data` so handlers can skip noisy injections for spawned
+  children with one consistent check.
+- **`PermissionClassifier.handleAsk(toolName, args, reason?)`.** Third
+  arg is appended to the approval description so users see why a hook
+  asked for confirmation.
+- **`hooks/events.ts` comment block** rewritten to reflect the
+  actual emit surface and the reserved-vs-emitted split.
+- **`pluginCommandHook` child env strips `CLAUDE_PLUGIN_ROOT`.** A
+  CC-authored script that branches on `[ -n "$CLAUDE_PLUGIN_ROOT" ]`
+  now reliably picks the codeshell branch, regardless of whether the
+  parent shell happened to have that var set.
+
+### Removed
+
+- **In-tree superpowers injector** (`src/hooks/builtin/`). The CC
+  plugin `hooks.json` path is now authoritative: the superpowers
+  plugin's own `hooks/hooks.json` drives `SessionStart` injection of
+  the `using-superpowers` SKILL.md body. `preset.strictSkills` and the
+  `CODESHELL_STRICT_SKILLS` env switch are gone — toggle by uninstalling
+  the plugin or editing its `hooks.json`.
+
+### Fixed
+
+- **`agent-dock` test alignment.** The "blank-line between rows"
+  assertion was failing since the marginTop=1 was removed in favor of
+  a compact list; surviving invariants (both rows render, startedAt
+  order preserved) are kept.
+- **Intentional unicode regex literals.** `INVISIBLE_CHARS` and
+  `FULLWIDTH_SPACE` in `api-key-sanitize.ts` deliberately contain
+  zero-width / CJK characters; ESLint flagged them as
+  `no-irregular-whitespace` errors. Annotated with inline disables.
+
+## [0.2.0] - 2026-05-15
+
+Capability layer + per-(provider, model) request-shape adapter. No
+public API changes; meaningful enough architectural increment to
+warrant a minor bump. (CHANGELOG was not maintained for this release;
+see git log between v0.1.6 and v0.2.0 for the detailed change set.)
+
 ## [0.1.6] - 2026-05-13
 
 ### Added

package/README.md

@@ -108,6 +108,31 @@ Supported `agent` settings:
 - `customSystemPrompt`
 - `appendSystemPrompt`
 
+### Fullscreen Mode
+
+Codeshell defaults to **fullscreen** (alt-screen + ScrollBox). This is the
+mode where window resize repaints cleanly — flow mode can show duplicate
+content in the terminal's scrollback after a resize because the terminal
+pushes the old viewport up before codeshell can erase it.
+
+Opt out of fullscreen at startup with `CODESHELL_FULLSCREEN=0|false|off`,
+or toggle at runtime with `/fullscreen off`. Flow mode lets the transcript
+flow into the terminal's native scrollback (useful if you prefer keeping
+shell history above codeshell visible).
+
+### Stream Idle Watchdog (opt-in)
+
+When `CODESHELL_ENABLE_STREAM_WATCHDOG=1`, the openai provider aborts any LLM
+stream that has gone `CODESHELL_STREAM_IDLE_TIMEOUT_MS` ms (default `90000`)
+without receiving a chunk. The engine then retries via the existing
+`withRetry` policy, capped by `CODESHELL_STREAM_WATCHDOG_RETRIES` (default
+`2`) attempts with exponential backoff.
+
+This bounds upstream hangs at ~90 s instead of indefinitely. User-initiated
+aborts (Esc / Ctrl+C) are never retried.
+
+Disabled by default — set the flag explicitly to opt in.
+
 ## Built-in presets
 
 | Preset | Purpose | Extra tools |
@@ -148,21 +173,29 @@ Design principles:
 
 ## Further Reading
 
+- [CodeShell architecture documentation set](docs/architecture/README.md)
+- [CodeShell architecture diagrams](docs/architecture/10-architecture-diagrams.md)
+- [TUI Render 能力规划](docs/architecture/11-render-tui-capability-plan.md)
+- [mac 端可视化客户端调研](docs/architecture/12-mac-visual-client-research.md)
 - [CodeShell 当前架构与定位说明](docs/codeshell-repo-architecture.md)
 
 ## Project structure
 
 ```text
 src/
-├── cli/              # CLI entrypoints and terminal UI
+├── cli/              # CLI entrypoints, commands, onboarding, and output modes
 ├── context/          # Context compaction and window management
 ├── engine/           # Turn loop orchestration
 ├── hooks/            # Hook chain
 ├── llm/              # Model providers
 ├── preset/           # Built-in agent presets
 ├── prompt/           # Prompt composition
+├── protocol/         # Agent client/server protocol
+├── render/           # Custom Ink-like terminal renderer
+├── run/              # Managed run lifecycle
 ├── session/          # Session persistence and memory
-├── tool/             # Tool registry, execution, permissions, MCP
+├── tool-system/      # Tool registry, execution, permissions, MCP
+├── ui/               # Terminal UI components
 └── index.ts          # Public API exports
 ```
 

package/dist/cli.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "@cjhyy/code-shell-tui/cli";

package/dist/index.d.ts

@@ -1,67 +1 @@
-/**
- * code-shell — general-purpose agent orchestration framework
- *
- * Public API exports.
- */
-export declare const VERSION = "0.2.0";
-export type { Message, ContentBlock, ToolDefinition, ToolCall, ToolResult, RegisteredTool, TranscriptEvent, TranscriptEventType, SessionState, TokenUsage, CompiledInput, PermissionDecision, PermissionMode, PermissionRule, TurnPhase, TurnResult, TerminalReason, StreamEvent, StreamCallback, LLMConfig, LLMResponse, Settings, MCPServerConfig, } from "./types.js";
-export { FrameworkError, LLMError, LLMRateLimitError, ContextLimitError, ToolError, ToolNotFoundError, ToolExecutionError, ToolTimeoutError, PermissionDeniedError, SessionError, TranscriptError, ConfigError, } from "./exceptions.js";
-export { Engine } from "./engine/engine.js";
-export type { EngineConfig, EngineHookConfig, EngineResult } from "./engine/engine.js";
-export type { CostStateStore, CostStateSnapshot } from "./engine/cost-store.js";
-export { LLMClientBase } from "./llm/client-base.js";
-export { createLLMClient, registerProvider } from "./llm/client-factory.js";
-export { AnthropicClient } from "./llm/providers/anthropic.js";
-export { OpenAIClient } from "./llm/providers/openai.js";
-export { ModelPool, type ModelEntry } from "./llm/model-pool.js";
-export { ToolRegistry } from "./tool-system/registry.js";
-export { ToolExecutor } from "./tool-system/executor.js";
-export { PermissionClassifier, HeadlessApprovalBackend, AutoApprovalBackend } from "./tool-system/permission.js";
-export type { ApprovalBackend } from "./tool-system/permission.js";
-export { BUILTIN_TOOLS } from "./tool-system/builtin/index.js";
-export { MCPManager } from "./tool-system/mcp-manager.js";
-export type { AskUserFn } from "./tool-system/builtin/ask-user.js";
-export { taskManager } from "./tool-system/builtin/task.js";
-export type { Task, TaskStatus } from "./tool-system/builtin/task.js";
-export { HookRegistry } from "./hooks/registry.js";
-export type { HookEventName, HookContext, HookResult } from "./hooks/events.js";
-export { Transcript } from "./session/transcript.js";
-export { SessionManager } from "./session/session-manager.js";
-export { FileHistory } from "./session/file-history.js";
-export { MemoryManager } from "./session/memory.js";
-export type { MemoryEntry } from "./session/memory.js";
-export type { FileSnapshot } from "./session/file-history.js";
-export { PromptComposer } from "./prompt/composer.js";
-export { SectionCache } from "./prompt/section-cache.js";
-export { scanInstructions, combineInstructions } from "./prompt/instruction-scanner.js";
-export { BUILTIN_AGENT_PRESETS, DEFAULT_AGENT_PRESET, DEFAULT_CLI_PRESET, resolveAgentPreset, resolveBuiltinToolNames, buildPresetSystemPrompt, registerPreset, listPresetNames, } from "./preset/index.js";
-export type { AgentPreset, AgentPresetName } from "./preset/index.js";
-export { loadSection, loadSections, availableSections, registerSection } from "./prompt/section-loader.js";
-export { ContextManager } from "./context/manager.js";
-export { estimateTokens, microcompact, windowCompact, truncateToolResult, buildSummarizationPrompt, applySummaryCompaction, COMPACTABLE_TOOL_NAMES, } from "./context/compaction.js";
-export type { MicrocompactOptions } from "./context/compaction.js";
-export type { SummarizeFn, CompactStrategy, OnCompactFn, ContextManagerConfig, } from "./context/manager.js";
-export { applyToolResultPersistence, createContentReplacementState, reconstructContentReplacementState, resolveToolResultsDir, isPersistedReplacement, DEFAULT_PERSIST_THRESHOLD, PER_MESSAGE_AGGREGATE_CAP, PREVIEW_SIZE, } from "./context/tool-result-storage.js";
-export type { ContentReplacementState } from "./context/tool-result-storage.js";
-export { scanSkills, matchSkillsByInput, matchSkillsByTool, buildSkillListing } from "./skills/index.js";
-export type { SkillDefinition, MatchResult } from "./skills/index.js";
-export { Arena } from "./arena/arena.js";
-export { MODEL_PRESETS, getMaxOutputTokens } from "./arena/model-presets.js";
-export type { ModelPreset } from "./arena/model-presets.js";
-export { detectArenaMode } from "./arena/detect-mode.js";
-export { getStrategy, getStrategyForPlan, ReviewStrategy, DiscussionStrategy, PlanningStrategy } from "./arena/strategies/index.js";
-export { planArena } from "./arena/planner.js";
-export { collectEvidence } from "./arena/providers/index.js";
-export { selectTools, hasTools } from "./arena/tools/selector.js";
-export { ArenaLedger } from "./arena/ledger.js";
-export { registerClaims, selectClaimsForReview } from "./arena/phases/claim-registry.js";
-export { buildDigest, formatDigest } from "./arena/digest-builder.js";
-export { transitionClaim, resolveClaimStatus, markUnderReview, applyReviewResult, markUnresolved, isTerminal, validTransitions } from "./arena/transitions.js";
-export type { ArenaConfig, ArenaMode, ArenaResultV2, ArenaStrategy, ArenaParticipant, ArenaBaseContext, ArenaFinding, FindingReview, ParticipantReport, ArenaConsensus, ArenaConsensusItem, ArenaRoadmapPhase, ArenaProgressEvent, ArenaPlan, ArenaLens, ArenaLensName, ArenaSourceKind, ArenaArtifact, ArenaQuickFact, FindingKind, PeerVerdict, ToolTrace, EvidencePacket, FindingEvidenceLink, ResearchDossier, ClaimStatus, ClaimRecord, ClaimChallenge, ClaimAdjudication, RequestedCheck, DebateRound, DebateTurn, TargetedCheckTask, SharedResearchLedger, RoundResearchDigest, ArenaExecutionLimits, } from "./arena/types.js";
-export { IterativeArena, defaultIterateConvergence, iterateDiffRatio, iterateCodeFormat, iterateDocumentFormat, getIterateFormat, } from "./arena/index.js";
-export type { IterateConfig, IterateResult, IterateSubject, IterateFormat, IterateProgressEvent, IterateFormatPack, Draft, DraftCandidate, Critique, CritiqueCategory, CritiqueEvidence, CritiqueSeverity, ConvergenceSignal, Round, AuthorRotation, StoppedReason, CheckpointFn, CheckpointContext, CheckpointAction, } from "./arena/index.js";
-export { RunManager, type RunManagerConfig, type RunStore, FileRunStore, RunQueue, EngineRunner, type EngineRunnerConfig, type RunExecutionHandle, type RunExecutor, type CustomToolEntry, RunApprovalBackend, createRunAskUserFn, type RunLifecycleHooks, CheckpointWriter, ArtifactTracker, RunLock, Heartbeat, NoopEvaluator, CompositeEvaluator, type Evaluator, type EvaluatorResult, type EvaluatorContext, type RunStatus, type RunSnapshot, type RunEvent, type RunCheckpoint, type RunApproval, type RunArtifactRef, type SubmitRunInput, type ResumeRunInput, type ListRunsQuery, type RunStreamEvent, type RunStreamCallback, type DetachFn, VALID_TRANSITIONS, createRunManager, type CreateRunManagerOptions, } from "./run/index.js";
-export { defineProduct, type ProductDefinition, type ProductPreset, type ProductAdapter, type ProductContract, type CustomTool, type ProductRuntimeOptions, type ProductInstance, } from "./product/index.js";
-export { logger } from "./logging/logger.js";
-export { SettingsManager } from "./settings/manager.js";
-export { SettingsSchema, validateSettings } from "./settings/schema.js";
+export * from "@cjhyy/code-shell-core";

package/dist/index.js

@@ -1 +1 @@
-export{a as defineProduct}from'./chunk-Q3RSX66I.js';export{a as createRunManager}from'./chunk-EU3J7TBP.js';export{$ as ArtifactTracker,j as AutoApprovalBackend,J as BUILTIN_AGENT_PRESETS,e as BUILTIN_TOOLS,_ as CheckpointWriter,da as CompositeEvaluator,x as ContextManager,K as DEFAULT_AGENT_PRESET,L as DEFAULT_CLI_PRESET,p as DEFAULT_PERSIST_THRESHOLD,U as Engine,ea as EngineRunner,W as FileRunStore,i as HeadlessApprovalBackend,ba as Heartbeat,o as HookRegistry,ca as NoopEvaluator,q as PER_MESSAGE_AGGREGATE_CAP,r as PREVIEW_SIZE,n as PermissionClassifier,R as PromptComposer,Y as RunApprovalBackend,aa as RunLock,fa as RunManager,X as RunQueue,y as SectionCache,h as ToolExecutor,f as ToolRegistry,V as VALID_TRANSITIONS,v as applyToolResultPersistence,I as availableSections,P as buildPresetSystemPrompt,E as buildSkillListing,A as combineInstructions,s as createContentReplacementState,Z as createRunAskUserFn,w as isPersistedReplacement,N as listPresetNames,G as loadSection,H as loadSections,C as matchSkillsByInput,D as matchSkillsByTool,t as reconstructContentReplacementState,M as registerPreset,F as registerSection,O as resolveAgentPreset,Q as resolveBuiltinToolNames,u as resolveToolResultsDir,z as scanInstructions,B as scanSkills,c as taskManager}from'./chunk-MGP35GKD.js';export{a as ModelPool}from'./chunk-MLCTC53I.js';export{a as FileHistory}from'./chunk-WI6FSWGU.js';import'./chunk-P6JSTIFM.js';import'./chunk-SNFAPSLA.js';export{a as MCPManager}from'./chunk-L7B2ORID.js';import {p}from'./chunk-M7VU4YVY.js';export{e as COMPACTABLE_TOOL_NAMES,k as applySummaryCompaction,i as buildSummarizationPrompt,a as estimateTokens,f as microcompact,h as truncateToolResult,d as windowCompact}from'./chunk-M7VU4YVY.js';export{b as MemoryManager}from'./chunk-T222K6IV.js';export{b as SessionManager,a as Transcript}from'./chunk-QTWU7UNA.js';export{c as SettingsManager,a as SettingsSchema,b as validateSettings}from'./chunk-DTPABBSV.js';export{j as IterativeArena,f as defaultIterateConvergence,i as getIterateFormat,g as iterateCodeFormat,e as iterateDiffRatio,h as iterateDocumentFormat}from'./chunk-RERBX75D.js';export{J as Arena,I as ArenaLedger,e as DiscussionStrategy,Q as MODEL_PRESETS,f as PlanningStrategy,d as ReviewStrategy,z as applyReviewResult,u as buildDigest,n as collectEvidence,b as createLLMClient,v as formatDigest,R as getMaxOutputTokens,k as getStrategy,l as getStrategyForPlan,p as hasTools,B as isTerminal,y as markUnderReview,A as markUnresolved,m as planArena,s as registerClaims,a as registerProvider,x as resolveClaimStatus,t as selectClaimsForReview,o as selectTools,w as transitionClaim,C as validTransitions}from'./chunk-2GJ7H5NC.js';import'./chunk-A4M2Y42L.js';export{a as AnthropicClient}from'./chunk-DEYFK6FP.js';export{a as OpenAIClient}from'./chunk-VKKU4LOM.js';import'./chunk-O5HFCH2U.js';export{a as LLMClientBase}from'./chunk-2EUIMKJA.js';export{l as ConfigError,d as ContextLimitError,a as FrameworkError,b as LLMError,c as LLMRateLimitError,i as PermissionDeniedError,j as SessionError,e as ToolError,g as ToolExecutionError,f as ToolNotFoundError,h as ToolTimeoutError,k as TranscriptError}from'./chunk-FU7AHZNN.js';export{b as logger}from'./chunk-ZSAONDT6.js';import {h,a}from'./chunk-3QP5BQ3L.js';h();p();h();var vt={review:[{patterns:[/\breview\b/i,/\baudit\b/i,/\binspect\b/i,/\bcheck\b/i],weight:2},{patterns:[/\bcode\s*quality\b/i,/\bbug\b/i,/\bvulnerab/i,/\bsecur/i]},{patterns:[/\bpr\b/i,/\bpull\s*request\b/i,/\bdiff\b/i,/\bchanges?\b/i]},{patterns:[/\brefactor/i,/\bclean\s*up\b/i,/\bimprove\b/i]}],discussion:[{patterns:[/\bdiscuss\b/i,/\bdebate\b/i,/\bcompare\b/i],weight:2},{patterns:[/\bpros?\s*(and|&|\/)\s*cons?\b/i,/\btrade\s*-?\s*offs?\b/i]},{patterns:[/\bshould\s+we\b/i,/\bwhich\s+(is|approach|way)\b/i,/\bvs\.?\b/i]},{patterns:[/\bopinion\b/i,/\bthoughts?\b/i,/\badvice\b/i]}],planning:[{patterns:[/\bplan\b/i,/\bplanning\b/i,/\broadmap\b/i,/\bstrategy\b/i],weight:2},{patterns:[/\barchitect/i,/\bdesign\b/i,/\bproposal\b/i]},{patterns:[/\bimplement(ation)?\s+(plan|strategy|approach)\b/i],weight:2},{patterns:[/\bphase\b/i,/\bmilestone\b/i,/\btimeline\b/i,/\bprioritiz/i]},{patterns:[/\bbuild\b/i,/\bcreate\b/i,/\bsetup\b/i,/\bbootstrap\b/i]}]},kt=3,Mt=2;function Pt(m){let a={review:0,discussion:0,planning:0};for(let[n,i]of Object.entries(vt))for(let p of i){let u=p.weight??1;for(let d of p.patterns)d.test(m)&&(a[n]+=u);}let s=Object.entries(a).sort((n,i)=>i[1]-n[1]),[t,e]=s[0],[,l]=s[1],r=e-l;return e>=kt&&r>=Mt?{mode:t,confidence:"high",reason:`Topic strongly matches "${t}" (score: ${e}, lead: +${r})`}:e>0&&r>0?{mode:t,confidence:"low",reason:`Topic weakly matches "${t}" (score: ${e}, lead: +${r})`}:{mode:"review",confidence:"low",reason:"No strong mode signal detected, defaulting to review"}}a(Pt,"detectArenaMode");var wt="0.2.0";export{wt as VERSION,Pt as detectArenaMode};
+export * from "@cjhyy/code-shell-core";

package/package.json

@@ -1,33 +1,39 @@
 {
   "name": "@cjhyy/code-shell",
-  "version": "0.2.0",
-  "description": "Code Shell — general-purpose agent orchestration framework with a terminal coding preset",
+  "version": "0.5.0-rc.1",
+  "description": "Code Shell — meta package. Installs @cjhyy/code-shell-core and @cjhyy/code-shell-tui.",
   "type": "module",
   "main": "./dist/index.js",
-  "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
-    },
-    "./run": {
-      "types": "./dist/run/index.d.ts",
-      "import": "./dist/run/index.js"
-    },
-    "./arena": {
-      "types": "./dist/arena/index.d.ts",
-      "import": "./dist/arena/index.js"
-    },
-    "./product": {
-      "types": "./dist/product/index.d.ts",
-      "import": "./dist/product/index.js"
-    },
-    "./package.json": "./package.json"
+    }
   },
   "bin": {
-    "code-shell": "dist/cli/main.js"
+    "code-shell": "./dist/cli.js"
   },
+  "scripts": {
+    "preinstall": "node scripts/check-node.cjs",
+    "build": "bun run --filter '@cjhyy/code-shell-core' build && bun run --filter '@cjhyy/code-shell-tui' build && bun run scripts/build-meta.ts",
+    "dev": "CODE_SHELL_DEV=1 CODESHELL_UI_PERF=1 bun run packages/tui/src/cli/main.ts",
+    "dev:bigtranscript": "bun run scripts/render-bigtranscript-dev.ts",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "bench:render": "bun run bench/render-tail.bench.ts && bun run bench/render-streaming.bench.ts && bun run bench/render-spinner.bench.ts && bun run bench/render-wheel.bench.ts",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint packages/",
+    "lint:engine-bypass": "bash scripts/check-no-engine-bypass.sh",
+    "format": "prettier --write 'packages/**/*.ts'"
+  },
+  "dependencies": {
+    "@cjhyy/code-shell-core": "0.5.0-rc.1",
+    "@cjhyy/code-shell-tui": "0.5.0-rc.1"
+  },
+  "workspaces": [
+    "packages/*"
+  ],
   "repository": {
     "type": "git",
     "url": "git+https://github.com/cjhyy/codeshell.git"
@@ -39,26 +45,12 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "preinstall": "node scripts/check-node.cjs",
-    "build": "bun run sync-models && bun run tsup && bun run build:dts",
-    "build:dts": "tsc --emitDeclarationOnly --declaration --outDir dist || true",
-    "sync-models": "bun run scripts/sync-models.ts",
-    "dev": "CODE_SHELL_DEV=1 bun run src/cli/main.ts",
-    "test": "bun test",
-    "test:watch": "bun test --watch",
-    "lint": "eslint src/",
-    "format": "prettier --write 'src/**/*.ts'",
-    "typecheck": "bun run tsc --noEmit",
-    "prepublishOnly": "bun run build"
-  },
   "engines": {
     "node": ">=20.10"
   },
   "files": [
     "dist",
     "scripts/check-node.cjs",
-    "skills-builtin",
     "README.md",
     "LICENSE",
     "CHANGELOG.md"
@@ -75,45 +67,6 @@
   ],
   "author": "maki maki",
   "license": "MIT",
-  "dependencies": {
-    "@alcalzone/ansi-tokenize": "^0.3.0",
-    "@anthropic-ai/sdk": "^0.39.0",
-    "@modelcontextprotocol/sdk": "^1.12.1",
-    "asciichart": "^1.5.25",
-    "auto-bind": "^5.0.1",
-    "bidi-js": "^1.0.3",
-    "chalk": "^5.4.1",
-    "cli-boxes": "^4.0.1",
-    "cli-highlight": "^2.1.11",
-    "code-excerpt": "^4.0.0",
-    "commander": "^13.1.0",
-    "diff": "^8.0.4",
-    "emoji-regex": "^10.6.0",
-    "get-east-asian-width": "^1.5.0",
-    "glob": "^11.0.0",
-    "gpt-tokenizer": "^3.4.0",
-    "indent-string": "^5.0.0",
-    "lodash-es": "^4.17.23",
-    "marked": "^17.0.5",
-    "marked-terminal": "^7.3.0",
-    "nanoid": "^5.1.2",
-    "openai": "^4.82.0",
-    "ora": "^9.3.0",
-    "proper-lockfile": "^4.1.2",
-    "react": "^19.2.4",
-    "react-reconciler": "^0.33.0",
-    "semver": "^7.7.4",
-    "signal-exit": "^4.1.0",
-    "stack-utils": "^2.0.6",
-    "strip-ansi": "^7.2.0",
-    "supports-hyperlinks": "^4.4.0",
-    "type-fest": "^5.5.0",
-    "usehooks-ts": "^3.1.1",
-    "wrap-ansi": "^10.0.0",
-    "yaml": "^2.7.0",
-    "yoga-layout": "^3.2.1",
-    "zod": "^3.24.2"
-  },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
     "@types/lodash": "^4.17.24",
@@ -121,6 +74,7 @@
     "@types/node": "^22.12.0",
     "@types/react": "^19.2.14",
     "@types/semver": "^7.7.1",
+    "bun-types": "^1.3.14",
     "eslint": "^9.19.0",
     "prettier": "^3.4.2",
     "tsup": "^8.3.6",

package/dist/agent/coordinator.d.ts

@@ -1,49 +0,0 @@
-/**
- * Agent coordinator — agent registry + message bus for multi-agent communication.
- */
-/** A registered named agent. */
-export interface AgentInfo {
-    id: string;
-    name: string;
-    status: "running" | "completed" | "failed";
-    description: string;
-    startedAt: number;
-    completedAt?: number;
-    result?: string;
-}
-/** A message between agents. */
-export interface AgentMessage {
-    from: string;
-    to: string;
-    content: string;
-    timestamp: number;
-}
-/**
- * Singleton agent registry and message bus.
- */
-declare class AgentCoordinator {
-    private agents;
-    private inbox;
-    /** Register a named agent. */
-    register(id: string, name: string, description: string): void;
-    /** Mark an agent as completed. */
-    complete(name: string, result?: string): void;
-    /** Mark an agent as failed. */
-    fail(name: string): void;
-    /** Get agent info by name. */
-    get(name: string): AgentInfo | undefined;
-    /** List all agents. */
-    list(): AgentInfo[];
-    /** List active (running) agents. */
-    listActive(): AgentInfo[];
-    /** Send a message to a named agent. */
-    send(from: string, to: string, content: string): boolean;
-    /** Read messages for a named agent (drains the inbox). */
-    receive(name: string): AgentMessage[];
-    /** Peek at messages without draining. */
-    peek(name: string): AgentMessage[];
-    /** Reset all state. */
-    reset(): void;
-}
-export declare const agentCoordinator: AgentCoordinator;
-export {};

package/dist/anthropic-OVRWAZRD.js

@@ -1 +0,0 @@
-export{a as AnthropicClient}from'./chunk-DEYFK6FP.js';import'./chunk-O5HFCH2U.js';import'./chunk-2EUIMKJA.js';import'./chunk-FU7AHZNN.js';import'./chunk-ZSAONDT6.js';import'./chunk-3QP5BQ3L.js';

package/dist/arena/arena.d.ts

@@ -1,43 +0,0 @@
-/**
- * Arena — multi-model collaborative analysis engine.
- *
- * Evidence-Driven Pipeline:
- *   0. Planner            → understand what the user wants (mode, lenses, sources)
- *   1. EvidenceProviders   → collect artifacts from selected sources
- *   2. Strategy + Lens     → compose prompts (mode flow + perspective)
- *   3. ToolSelector        → determine which tools participants can use
- *   4. ParticipantResearch  → each model investigates independently (parallel)
- *   4b. ClaimRegistry      → register findings as claims, populate ledger
- *   5. VerificationReview   → claim-aware cross-review with evidence digests
- *   7. DebateRounds         → contested claims enter structured debate
- *   8. Adjudication         → moderator rules on contested claims
- *   6. ConsensusBuilder     → claim-aware structured consensus
- */
-import type { ArenaConfig, ArenaResultV2 } from "./types.js";
-import type { PlannerFlags } from "./planner.js";
-export declare class Arena {
-    private config;
-    private strategy;
-    private limits;
-    constructor(config: ArenaConfig);
-    /**
-     * Run a full arena session.
-     *
-     * @param topic  - User's topic/request (natural language)
-     * @param flags  - Optional explicit overrides (mode, base, head)
-     */
-    run(topic: string, flags?: PlannerFlags): Promise<ArenaResultV2>;
-    /**
-     * Planning path: merge-oriented review → roadmap consensus → detail expansion.
-     *
-     * Planning mode does NOT enter heavy debate/adjudication. Contested findings
-     * are converted to open questions or dependency risks in the roadmap.
-     */
-    private runPlanningPath;
-    /**
-     * Review/Discussion path: verification review → debate → adjudication → consensus.
-     *
-     * This is the heavy trust loop for claim verification.
-     */
-    private runReviewDiscussionPath;
-}

package/dist/arena/context/context-tools.d.ts

@@ -1,16 +0,0 @@
-/**
- * Context tools — read-only tools that arena participants can use
- * to fetch additional source context during research.
- *
- * Security: All shell commands use execFileSync with argument arrays
- * to prevent command injection. File paths are validated against the
- * repository boundary to prevent path traversal.
- */
-import type { ToolDefinition, ToolCall } from "../../types.js";
-export declare const MAX_TOOL_RESULT = 15000;
-export declare const MAX_TOOL_ROUNDS = 3;
-export declare const CONTEXT_TOOLS: ToolDefinition[];
-/**
- * Execute a context tool call and return the result string.
- */
-export declare function executeContextTool(tc: ToolCall): string;

package/dist/arena/detect-mode.d.ts

@@ -1,20 +0,0 @@
-/**
- * Arena mode auto-detection — infer review/discussion/planning from topic text.
- *
- * Heuristic-based: uses keyword matching with weighted scoring.
- * Falls back to "review" (safest default) when confidence is low.
- */
-import type { ArenaMode } from "./types.js";
-/** Result of heuristic mode detection */
-export interface ArenaModeDetection {
-    mode: ArenaMode;
-    confidence: "high" | "low";
-    reason: string;
-}
-/**
- * Auto-detect arena mode from the topic string.
- *
- * Returns the detected mode, confidence level, and a human-readable reason.
- * When confidence is low, falls back to "review" (the safest default).
- */
-export declare function detectArenaMode(topic: string): ArenaModeDetection;

package/dist/arena/digest-builder.d.ts

@@ -1,25 +0,0 @@
-/**
- * DigestBuilder — constructs RoundResearchDigest from the shared ledger.
- *
- * The digest is a filtered view injected into prompts to avoid
- * token explosion from the full ledger. Program-built, not model-built.
- */
-import type { ArenaLedger } from "./ledger.js";
-import type { RoundResearchDigest } from "./types.js";
-interface DigestOptions {
-    /** Current round number */
-    round: number;
-    /** Claim IDs relevant to this round (e.g. contested claims in debate) */
-    relevantClaimIds: string[];
-}
-/**
- * Build a digest from the shared ledger for a specific round.
- * Only includes data relevant to the specified claims.
- */
-export declare function buildDigest(ledger: ArenaLedger, options: DigestOptions): RoundResearchDigest;
-/**
- * Format a digest into a text block suitable for prompt injection.
- * All LLM-originated text is sanitized before inclusion.
- */
-export declare function formatDigest(digest: RoundResearchDigest): string;
-export {};