@moikapy/lich 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -1,6 +1,22 @@
 # Changelog
 
-## Unreleased
+## 0.3.1
+
+- Fix: published CLI bin now works — `dist/cli.js` shipped without its
+  `#!/usr/bin/env node` shebang, so the `lich` command failed after npm
+  install; shebang restored (5d7d9c9).
+- Fix: TUI header showed a stale hardcoded version; now reads LICH_VERSION
+  to match the package.
+- Docs: npm install is the primary usage path (package now published);
+  new Updating section in getting-started; docs-site fixes (dead links,
+  vitepress base for the pages subpath).
+- Tests: suite passes under both vitest and `bun test`
+  (runner-independent stubs); portable fixtures — no more NAS-hardcoded
+  paths.
+- Dev: `bun release patch|minor|major` release pipeline
+  (scripts/release.ts) — version bump, pack, and audit.
+
+## 0.3.0
 
 - Plugin system (v0.3.0): load user-authored tools and lifecycle hooks from
   explicit module paths (`plugins` config array). Hooks cover

package/README.md

@@ -18,16 +18,20 @@ tool guardrails, context compression, and JSONL session persistence.
 
 ## Quick start (CLI)
 
+```sh
+npm install -g @moikapy/lich
+```
+
 ```sh
 # one-shot task
-LICH_MODEL=gpt-4.1-mini LICH_PROVIDER_KIND=openai_compat bun src/cli.ts "summarize this repo"
+LICH_MODEL=gpt-4.1-mini LICH_PROVIDER_KIND=openai_compat lich "summarize this repo"
 
 # interactive chat (commands: /exit, /quit)
-LICH_MODEL=claude-sonnet-4 LICH_PROVIDER_KIND=anthropic bun src/cli.ts chat
+LICH_MODEL=claude-sonnet-4 LICH_PROVIDER_KIND=anthropic lich chat
 
 # local ollama (no api key needed)
 ollama pull llama3.2
-LICH_PROVIDER_KIND=ollama LICH_MODEL=llama3.2 bun src/cli.ts "hello"
+LICH_PROVIDER_KIND=ollama LICH_MODEL=llama3.2 lich "hello"
 
 # terminal UI
 lich tui
@@ -40,13 +44,13 @@ The CLI has four modes: **one-shot** (`lich "task"`), **chat**
 (`lich chat`), **tui** (`lich tui`), and **gateway**
 (`lich gateway <platform...>`).
 
-Or use a JSON config file: `bun src/cli.ts --config lich.json "task"` (see
+Or use a JSON config file: `lich --config lich.json "task"` (see
 `AgentConfig` in `src/agent/config.ts` for the schema).
 
 ## Library usage
 
 ```ts
-import { run_agent } from "lich";
+import { run_agent } from "@moikapy/lich";
 
 const result = await run_agent(
   {
@@ -103,7 +107,7 @@ observe or veto tool calls. See
 Ollama needs no api key and defaults to `http://localhost:11434`:
 
 ```sh
-LICH_PROVIDER_KIND=ollama LICH_MODEL=llama3.2 bun src/cli.ts "Reply with ok"
+LICH_PROVIDER_KIND=ollama LICH_MODEL=llama3.2 lich "Reply with ok"
 ```
 
 Notes:
@@ -181,6 +185,18 @@ node node_modules/tsup/dist/cli-default.js src/index.ts src/cli.ts --format esm
 Use project-local binaries for vitest/tsup (not `bun x`), which would isolate
 packages in /tmp and break dependency resolution.
 
+## Releasing
+
+```sh
+bun release patch    # or minor | major
+```
+
+Fails closed on a dirty tree, a non-main branch, a typecheck error, or a
+test failure; bumps via `npm version`, builds, and packs + audits
+`test/.tmp/lich-<version>.tgz` (SHA-512 + scope verification) before
+committing, tagging `v<version>`, and pushing main. Publishing stays manual
+(`npm publish test/.tmp/lich-<version>.tgz`) so npm can prompt for the OTP.
+
 ## License
 
 MIT

package/dist/cli.d.ts

@@ -1,2 +1 @@
-
-export {  }
+#!/usr/bin/env node

package/dist/cli.js

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 import {
   LICH_VERSION
 } from "./chunk-ZVK3MUPC.js";
@@ -345,7 +346,7 @@ async function run_chat(config) {
   }
 }
 async function run_tui_entry(config) {
-  const { run_tui } = await import("./tui-V7ATLIKW.js");
+  const { run_tui } = await import("./tui-K3EPRXTV.js");
   return run_tui(config);
 }
 async function run_gateway_entry(config, platforms) {

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts","../src/cli_config.ts"],"sourcesContent":["/**\n * Thin zero-dependency CLI for lich: one-shot tasks, interactive chat,\n * config files, and environment-based provider resolution.\n */\nimport { readFileSync } from \"node:fs\";\nimport { createInterface, type Interface } from \"node:readline\";\nimport path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { create_agent, type Agent, type AgentRunResult } from \"./agent/agent.js\";\nimport { parse_agent_config, type AgentConfig } from \"./agent/config.js\";\nimport { AgentEmitter } from \"./agent/events.js\";\nimport { LICH_VERSION } from \"./index.js\";\nimport { load_config, config_template } from \"./cli_config.js\";\n\ntype ProviderKind = \"openai_compat\" | \"anthropic\" | \"ollama\";\n\ninterface CliOptions {\n  config_path?: string;\n  help?: boolean;\n  version?: boolean;\n  overrides: Record<string, string>;\n  positionals: string[];\n}\n\nconst FLAG_KEYS: Record<string, string> = {\n  \"--work-dir\": \"work_dir\",\n  \"--max-turns\": \"max_turns\",\n  \"--model\": \"provider_model\",\n  \"--provider-kind\": \"provider_kind\",\n  \"--base-url\": \"provider_base_url\",\n  \"--api-key-env\": \"provider_api_key_env\",\n  \"--system-prompt\": \"system_prompt\",\n  \"--session-dir\": \"session_dir\",\n  \"--log-level\": \"log_level\",\n};\n\nconst DEFAULT_BASE_URLS: Record<ProviderKind, string> = {\n  openai_compat: \"https://api.openai.com/v1\",\n  anthropic: \"https://api.anthropic.com\",\n  ollama: \"http://localhost:11434\",\n};\n\nconst DEFAULT_ENV_API_KEYS: Record<ProviderKind, string | undefined> = {\n  openai_compat: \"OPENAI_API_KEY\",\n  anthropic: \"ANTHROPIC_API_KEY\",\n  ollama: undefined, // ollama needs no api key\n};\n\nfunction usage_text(): string {\n  return [\n    \"lich — a TypeScript AI agent harness\",\n    \"\",\n    \"Usage:\",\n    '  lich \"one shot task\"   run a single task and print the reply',\n    \"  lich chat              interactive chat (commands: /exit, /quit)\",\n    \"  lich tui               interactive terminal UI (ink)\",\n    \"  lich gateway <plat..>  messaging gateway (webhook|telegram|discord|twitch)\",\n    \"  lich config            print a starter config template (save as .lich/config.json)\",\n    \"  lich --help            show this help\",\n    \"  lich --version         print version\",\n    \"\",\n    \"Flags (before or after the subcommand):\",\n    \"  --config <path>        JSON config file parsed by parse_agent_config\",\n    \"  --work-dir <path>      working directory for tools\",\n    \"  --max-turns <n>        loop turn budget (default 25)\",\n    \"  --model <m>            model name (default from LICH_MODEL)\",\n    \"  --provider-kind <k>    openai_compat | anthropic | ollama (default LICH_PROVIDER_KIND)\",\n    \"  --base-url <u>         provider base url (default LICH_BASE_URL)\",\n    \"  --api-key-env <NAME>   env var holding the api key (default LICH_API_KEY_ENV; unused by ollama)\",\n    \"  --system-prompt <s>    system prompt override\",\n    \"  --session-dir <path>   session transcript directory\",\n    \"  --log-level <level>    debug | info | warn | error\",\n  ].join(\"\\n\");\n}\n\nfunction error_message(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\n/** Mode-aware config failure message; one-shot keeps the generic variant. */\nfunction error_for_mode(mode: string, base_message: string): string {\n  if (mode === \"tui\") {\n    return \"lich tui: no model configured — set LICH_MODEL (e.g. glm-5.3-flash:cloud), pass --model, or create .lich/config.json (`lich config` prints a template)\";\n  }\n  if (mode === \"gateway\") {\n    return \"lich gateway: no model configured — set LICH_MODEL (e.g. glm-5.3-flash:cloud), pass --model, or create .lich/config.json (`lich config` prints a template)\";\n  }\n  if (mode === \"chat\") {\n    return \"lich chat: no model configured — set LICH_MODEL (e.g. glm-5.3-flash:cloud), pass --model, or create .lich/config.json (`lich config` prints a template)\";\n  }\n  return base_message;\n}\n\nfunction parse_args(argv: string[]): CliOptions {\n  const options: CliOptions = { overrides: {}, positionals: [] };\n  for (let index = 0; index < argv.length; index += 1) {\n    const arg = argv[index];\n    if (arg === undefined) {\n      break;\n    }\n    if (arg === \"--help\") {\n      options.help = true;\n      continue;\n    }\n    if (arg === \"--version\") {\n      options.version = true;\n      continue;\n    }\n    if (arg === \"--config\") {\n      const value = argv[index + 1];\n      if (value === undefined) {\n        throw new Error(\"--config requires a path\");\n      }\n      options.config_path = value;\n      index += 1;\n      continue;\n    }\n    const override_key = FLAG_KEYS[arg];\n    if (override_key === undefined) {\n      if (arg.startsWith(\"--\") === true) {\n        throw new Error(`unknown flag: ${arg}`);\n      }\n      options.positionals.push(arg);\n      continue;\n    }\n    const value = argv[index + 1];\n    if (value === undefined || value.startsWith(\"--\") === true) {\n      throw new Error(`${arg} requires a value`);\n    }\n    options.overrides[override_key] = value;\n    index += 1;\n  }\n  return options;\n}\n\nfunction env_provider(overrides: Record<string, string>): Record<string, unknown> {\n  const kind_value = overrides[\"provider_kind\"] ?? process.env.LICH_PROVIDER_KIND ?? \"openai_compat\";\n  if (kind_value !== \"openai_compat\" && kind_value !== \"anthropic\" && kind_value !== \"ollama\") {\n    throw new Error(`unknown provider kind \"${kind_value}\" (expected openai_compat, anthropic, or ollama)`);\n  }\n  const kind: ProviderKind = kind_value;\n  const model = overrides[\"provider_model\"] ?? process.env.LICH_MODEL;\n  if (model === undefined || model.length === 0) {\n    throw new Error(\"no model configured: set LICH_MODEL, pass --model, or create .lich/config.json (`lich config` prints a template)\");\n  }\n  return {\n    kind,\n    name: \"default\",\n    model,\n    base_url: overrides[\"provider_base_url\"] ?? process.env.LICH_BASE_URL ?? DEFAULT_BASE_URLS[kind],\n    api_key_env: overrides[\"provider_api_key_env\"] ?? process.env.LICH_API_KEY_ENV ?? DEFAULT_ENV_API_KEYS[kind],\n  };\n}\n\nfunction load_config_file(config_path: string): Record<string, unknown> {\n  try {\n    const raw = readFileSync(config_path, \"utf8\");\n    const parsed = JSON.parse(raw) as unknown;\n    if (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) {\n      throw new Error(\"config root must be a JSON object\");\n    }\n    return parsed as Record<string, unknown>;\n  } catch (error) {\n    throw new Error(`cannot use config file ${config_path}: ${error_message(error)}`);\n  }\n}\n\nfunction apply_provider_override(config: Record<string, unknown>, overrides: Record<string, string>): void {\n  const keys = [\"provider_kind\", \"provider_model\", \"provider_base_url\", \"provider_api_key_env\"] as const;\n  const any_present = keys.some((key) => overrides[key] !== undefined);\n  if (any_present === false) {\n    return;\n  }\n  const providers = config[\"providers\"];\n  if (Array.isArray(providers) === false || providers.length === 0) {\n    config[\"providers\"] = [env_provider(overrides)];\n    return;\n  }\n  const first = providers[0];\n  if (typeof first !== \"object\" || first === null) {\n    throw new Error(\"config providers[0] must be an object\");\n  }\n  const provider = first as Record<string, unknown>;\n  for (const key of keys) {\n    const value = overrides[key];\n    if (value !== undefined) {\n      provider[key.replace(\"provider_\", \"\")] = value;\n    }\n  }\n}\n\nfunction apply_overrides(config: Record<string, unknown>, overrides: Record<string, string>): void {\n  for (const key of [\"work_dir\", \"system_prompt\", \"session_dir\", \"log_level\"]) {\n    if (overrides[key] !== undefined) {\n      config[key] = overrides[key];\n    }\n  }\n  if (overrides[\"max_turns\"] !== undefined) {\n    const turns = Number(overrides[\"max_turns\"]);\n    if (Number.isInteger(turns) === false || turns < 1) {\n      throw new Error(\"--max-turns must be a positive integer\");\n    }\n    config[\"max_turns\"] = turns;\n  }\n  apply_provider_override(config, overrides);\n}\n\nfunction build_config(options: CliOptions): AgentConfig {\n  const base =\n    options.config_path === undefined ? load_config() ?? { providers: [env_provider(options.overrides)] } : load_config_file(options.config_path);\n  apply_overrides(base, options.overrides);\n  const providers = base[\"providers\"];\n  if (Array.isArray(providers) === false || providers.length === 0) {\n    throw new Error(\"no model configured: set LICH_MODEL, pass --model, or create .lich/config.json (`lich config` prints a template)\");\n  }\n  return parse_agent_config(base);\n}\n\n/** build_config with the failure message prefixed for the invoking subcommand. */\nfunction build_config_for(options: CliOptions, mode: string): AgentConfig {\n  try {\n    return build_config(options);\n  } catch (error) {\n    throw new Error(error_for_mode(mode, error_message(error)));\n  }\n}\n\nfunction attach_progress(emitter: AgentEmitter): () => void {\n  return emitter.on((event) => {\n    if (event.type === \"turn_start\") {\n      process.stderr.write(`\\n[lich] turn ${event.turn}`);\n      return;\n    }\n    if (event.type === \"tool_call_end\") {\n      const status = event.result.ok === true ? \"ok\" : `error: ${event.result.error ?? \"\"}`;\n      process.stderr.write(`\\n[lich]   ${event.call.name}: ${status}`);\n      return;\n    }\n    if (event.type === \"final\") {\n      process.stderr.write(\"\\n\");\n    }\n  });\n}\n\nasync function run_one_shot(config: unknown, input: string): Promise<number> {\n  const agent = create_agent(config);\n  const stop_progress = attach_progress(agent.events);\n  let result: AgentRunResult;\n  try {\n    result = await agent.run({ input });\n  } finally {\n    stop_progress();\n  }\n  const final = result.outcome.final;\n  if (final !== undefined && final.content.length > 0) {\n    process.stdout.write(`${final.content}\\n`);\n  }\n  if (result.outcome.stopped_reason === \"budget\") {\n    process.stderr.write(`[lich] budget exhausted after ${result.outcome.turns_used} turns\\n`);\n    return 1;\n  }\n  if (result.outcome.stopped_reason === \"aborted\") {\n    process.stderr.write(\"[lich] run aborted\\n\");\n    return 1;\n  }\n  return 0;\n}\n\nasync function run_chat_turn(agent: Agent, input: string): Promise<void> {\n  const stop_progress = attach_progress(agent.events);\n  try {\n    const result = await agent.run({ input });\n    const final = result.outcome.final;\n    if (final !== undefined && final.content.length > 0) {\n      process.stdout.write(`${final.content}\\n`);\n    }\n    process.stdout.write(`[turns ${result.outcome.turns_used} | tokens ${result.usage_total.total_tokens}]\\n`);\n  } catch (error) {\n    process.stderr.write(`[lich] ${error_message(error)}\\n`);\n  } finally {\n    stop_progress();\n  }\n}\n\nfunction ask_line(rl: Interface): Promise<string> {\n  return new Promise((resolve) => {\n    const on_close = (): void => resolve(\"\");\n    rl.question(\"> \", (answer) => {\n      rl.removeListener(\"close\", on_close);\n      resolve(answer);\n    });\n    rl.once(\"close\", on_close);\n  });\n}\n\nasync function run_chat(config: unknown): Promise<number> {\n  const agent = create_agent(config);\n  const rl = createInterface({ input: process.stdin, output: process.stdout });\n  try {\n    for (;;) {\n      const line = await ask_line(rl);\n      if (line.trim() === \"\") {\n        return 0;\n      }\n      const command = line.trim();\n      if (command === \"/exit\" || command === \"/quit\") {\n        return 0;\n      }\n      await run_chat_turn(agent, command);\n    }\n  } finally {\n    rl.close();\n  }\n}\n\nasync function run_tui_entry(config: ReturnType<typeof build_config>): Promise<number> {\n  const { run_tui } = await import(\"./tui.js\");\n  return run_tui(config);\n}\n\nasync function run_gateway_entry(\n  config: ReturnType<typeof build_config>,\n  platforms: string[],\n): Promise<number> {\n  const { run_gateway } = await import(\"./gateway.js\");\n  return run_gateway(config, platforms.length === 0 ? [\"webhook\"] : platforms);\n}\n\nfunction is_main_module(): boolean {\n  const entry = process.argv[1];\n  if (entry === undefined) {\n    return false;\n  }\n  return import.meta.url === pathToFileURL(path.resolve(entry)).href;\n}\n\nasync function main(argv: string[]): Promise<number> {\n  const options = parse_args(argv);\n  if (options.help === true) {\n    process.stdout.write(`${usage_text()}\\n`);\n    return 0;\n  }\n  if (options.version === true) {\n    process.stdout.write(`${LICH_VERSION}\\n`);\n    return 0;\n  }\n  const [first] = options.positionals;\n  if (first === undefined) {\n    process.stderr.write(`${usage_text()}\\n`);\n    return 1;\n  }\n  if (first === \"config\") {\n    process.stdout.write(`${config_template()}\\n`);\n    return 0;\n  }\n  if (first === \"chat\") {\n    if (options.positionals.length > 1) {\n      throw new Error(\"chat mode takes no task argument\");\n    }\n    return run_chat(build_config_for(options, first));\n  }\n  if (first === \"tui\") {\n    return run_tui_entry(build_config_for(options, first));\n  }\n  if (first === \"gateway\") {\n    return run_gateway_entry(build_config_for(options, first), options.positionals.slice(1));\n  }\n  return run_one_shot(build_config_for(options, \"one-shot\"), options.positionals.join(\" \"));\n}\n\nif (is_main_module() === true) {\n  main(process.argv.slice(2))\n    .then((code) => {\n      process.exitCode = code;\n    })\n    .catch((error) => {\n      process.stderr.write(`lich: ${error_message(error)}\\n`);\n      process.stderr.write(\"run `lich --help` for usage\\n\");\n      process.exitCode = 1;\n    });\n}","/**\n * Config-file discovery for the CLI: an ordered search chain, safe loading,\n * and a starter template so `lich tui` works with zero environment setup.\n */\nimport { existsSync, mkdirSync, readFileSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport path from \"node:path\";\nimport { safe_json_parse } from \"./util/json.js\";\n\nconst LICH_DIRNAME = \".lich\";\nconst CONFIG_RELPATH = `${LICH_DIRNAME}/config.json`;\nconst DEFAULT_USER_CONFIG = \".config/lich/config.json\";\n\n/** Ordered absolute chain: work_dir (default cwd) first, then the user config home. */\nexport function config_search_paths(work_dir?: string): string[] {\n  const root = work_dir ?? process.cwd();\n  const first = path.resolve(root, CONFIG_RELPATH);\n  const second = path.resolve(homedir(), DEFAULT_USER_CONFIG);\n  return first === second ? [first] : [first, second];\n}\n\n/** Explicit path must exist (else throw); otherwise walk the chain, undefined when absent. */\nexport function find_config_file(explicit?: string): string | undefined {\n  if (explicit !== undefined) {\n    if (existsSync(explicit) === false) {\n      throw new Error(`config not found: ${explicit}`);\n    }\n    return explicit;\n  }\n  for (const candidate of config_search_paths()) {\n    if (existsSync(candidate) === true) {\n      return candidate;\n    }\n  }\n  return undefined;\n}\n\n/** Load the first config found as an object; undefined when absent, throw on bad json. */\nexport function load_config(explicit?: string): Record<string, unknown> | undefined {\n  const found = find_config_file(explicit);\n  if (found === undefined) {\n    return undefined;\n  }\n  const raw = readFileSync(found, \"utf8\");\n  const parsed = safe_json_parse<unknown>(raw);\n  if (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) {\n    throw new Error(`invalid config json: ${found}`);\n  }\n  return parsed as Record<string, unknown>;\n}\n\n/** Starter config honoring LICH_* env hints; `lich config` prints it. */\nexport function config_template(): string {\n  const kind = process.env.LICH_PROVIDER_KIND ?? \"ollama\";\n  const provider: Record<string, unknown> = {\n    kind,\n    name: \"main\",\n    model: process.env.LICH_MODEL ?? \"<model-name>\",\n  };\n  if (kind === \"ollama\") {\n    provider[\"base_url\"] = \"http://localhost:11434\";\n  }\n  return JSON.stringify({ providers: [provider], max_turns: 25 }, null, 2);\n}\n\n/** mkdir -p `${work_dir}/.lich` and return the directory path. */\nexport function ensure_lich_config_dir(work_dir: string): string {\n  const dir = path.resolve(work_dir, LICH_DIRNAME);\n  mkdirSync(dir, { recursive: true });\n  return dir;\n}"],"mappings":"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","names":["readFileSync","path","value","readFileSync","path"]}
+{"version":3,"sources":["../src/cli.ts","../src/cli_config.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * Thin zero-dependency CLI for lich: one-shot tasks, interactive chat,\n * config files, and environment-based provider resolution.\n */\nimport { readFileSync } from \"node:fs\";\nimport { createInterface, type Interface } from \"node:readline\";\nimport path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { create_agent, type Agent, type AgentRunResult } from \"./agent/agent.js\";\nimport { parse_agent_config, type AgentConfig } from \"./agent/config.js\";\nimport { AgentEmitter } from \"./agent/events.js\";\nimport { LICH_VERSION } from \"./index.js\";\nimport { load_config, config_template } from \"./cli_config.js\";\n\ntype ProviderKind = \"openai_compat\" | \"anthropic\" | \"ollama\";\n\ninterface CliOptions {\n  config_path?: string;\n  help?: boolean;\n  version?: boolean;\n  overrides: Record<string, string>;\n  positionals: string[];\n}\n\nconst FLAG_KEYS: Record<string, string> = {\n  \"--work-dir\": \"work_dir\",\n  \"--max-turns\": \"max_turns\",\n  \"--model\": \"provider_model\",\n  \"--provider-kind\": \"provider_kind\",\n  \"--base-url\": \"provider_base_url\",\n  \"--api-key-env\": \"provider_api_key_env\",\n  \"--system-prompt\": \"system_prompt\",\n  \"--session-dir\": \"session_dir\",\n  \"--log-level\": \"log_level\",\n};\n\nconst DEFAULT_BASE_URLS: Record<ProviderKind, string> = {\n  openai_compat: \"https://api.openai.com/v1\",\n  anthropic: \"https://api.anthropic.com\",\n  ollama: \"http://localhost:11434\",\n};\n\nconst DEFAULT_ENV_API_KEYS: Record<ProviderKind, string | undefined> = {\n  openai_compat: \"OPENAI_API_KEY\",\n  anthropic: \"ANTHROPIC_API_KEY\",\n  ollama: undefined, // ollama needs no api key\n};\n\nfunction usage_text(): string {\n  return [\n    \"lich — a TypeScript AI agent harness\",\n    \"\",\n    \"Usage:\",\n    '  lich \"one shot task\"   run a single task and print the reply',\n    \"  lich chat              interactive chat (commands: /exit, /quit)\",\n    \"  lich tui               interactive terminal UI (ink)\",\n    \"  lich gateway <plat..>  messaging gateway (webhook|telegram|discord|twitch)\",\n    \"  lich config            print a starter config template (save as .lich/config.json)\",\n    \"  lich --help            show this help\",\n    \"  lich --version         print version\",\n    \"\",\n    \"Flags (before or after the subcommand):\",\n    \"  --config <path>        JSON config file parsed by parse_agent_config\",\n    \"  --work-dir <path>      working directory for tools\",\n    \"  --max-turns <n>        loop turn budget (default 25)\",\n    \"  --model <m>            model name (default from LICH_MODEL)\",\n    \"  --provider-kind <k>    openai_compat | anthropic | ollama (default LICH_PROVIDER_KIND)\",\n    \"  --base-url <u>         provider base url (default LICH_BASE_URL)\",\n    \"  --api-key-env <NAME>   env var holding the api key (default LICH_API_KEY_ENV; unused by ollama)\",\n    \"  --system-prompt <s>    system prompt override\",\n    \"  --session-dir <path>   session transcript directory\",\n    \"  --log-level <level>    debug | info | warn | error\",\n  ].join(\"\\n\");\n}\n\nfunction error_message(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\n/** Mode-aware config failure message; one-shot keeps the generic variant. */\nfunction error_for_mode(mode: string, base_message: string): string {\n  if (mode === \"tui\") {\n    return \"lich tui: no model configured — set LICH_MODEL (e.g. glm-5.3-flash:cloud), pass --model, or create .lich/config.json (`lich config` prints a template)\";\n  }\n  if (mode === \"gateway\") {\n    return \"lich gateway: no model configured — set LICH_MODEL (e.g. glm-5.3-flash:cloud), pass --model, or create .lich/config.json (`lich config` prints a template)\";\n  }\n  if (mode === \"chat\") {\n    return \"lich chat: no model configured — set LICH_MODEL (e.g. glm-5.3-flash:cloud), pass --model, or create .lich/config.json (`lich config` prints a template)\";\n  }\n  return base_message;\n}\n\nfunction parse_args(argv: string[]): CliOptions {\n  const options: CliOptions = { overrides: {}, positionals: [] };\n  for (let index = 0; index < argv.length; index += 1) {\n    const arg = argv[index];\n    if (arg === undefined) {\n      break;\n    }\n    if (arg === \"--help\") {\n      options.help = true;\n      continue;\n    }\n    if (arg === \"--version\") {\n      options.version = true;\n      continue;\n    }\n    if (arg === \"--config\") {\n      const value = argv[index + 1];\n      if (value === undefined) {\n        throw new Error(\"--config requires a path\");\n      }\n      options.config_path = value;\n      index += 1;\n      continue;\n    }\n    const override_key = FLAG_KEYS[arg];\n    if (override_key === undefined) {\n      if (arg.startsWith(\"--\") === true) {\n        throw new Error(`unknown flag: ${arg}`);\n      }\n      options.positionals.push(arg);\n      continue;\n    }\n    const value = argv[index + 1];\n    if (value === undefined || value.startsWith(\"--\") === true) {\n      throw new Error(`${arg} requires a value`);\n    }\n    options.overrides[override_key] = value;\n    index += 1;\n  }\n  return options;\n}\n\nfunction env_provider(overrides: Record<string, string>): Record<string, unknown> {\n  const kind_value = overrides[\"provider_kind\"] ?? process.env.LICH_PROVIDER_KIND ?? \"openai_compat\";\n  if (kind_value !== \"openai_compat\" && kind_value !== \"anthropic\" && kind_value !== \"ollama\") {\n    throw new Error(`unknown provider kind \"${kind_value}\" (expected openai_compat, anthropic, or ollama)`);\n  }\n  const kind: ProviderKind = kind_value;\n  const model = overrides[\"provider_model\"] ?? process.env.LICH_MODEL;\n  if (model === undefined || model.length === 0) {\n    throw new Error(\"no model configured: set LICH_MODEL, pass --model, or create .lich/config.json (`lich config` prints a template)\");\n  }\n  return {\n    kind,\n    name: \"default\",\n    model,\n    base_url: overrides[\"provider_base_url\"] ?? process.env.LICH_BASE_URL ?? DEFAULT_BASE_URLS[kind],\n    api_key_env: overrides[\"provider_api_key_env\"] ?? process.env.LICH_API_KEY_ENV ?? DEFAULT_ENV_API_KEYS[kind],\n  };\n}\n\nfunction load_config_file(config_path: string): Record<string, unknown> {\n  try {\n    const raw = readFileSync(config_path, \"utf8\");\n    const parsed = JSON.parse(raw) as unknown;\n    if (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) {\n      throw new Error(\"config root must be a JSON object\");\n    }\n    return parsed as Record<string, unknown>;\n  } catch (error) {\n    throw new Error(`cannot use config file ${config_path}: ${error_message(error)}`);\n  }\n}\n\nfunction apply_provider_override(config: Record<string, unknown>, overrides: Record<string, string>): void {\n  const keys = [\"provider_kind\", \"provider_model\", \"provider_base_url\", \"provider_api_key_env\"] as const;\n  const any_present = keys.some((key) => overrides[key] !== undefined);\n  if (any_present === false) {\n    return;\n  }\n  const providers = config[\"providers\"];\n  if (Array.isArray(providers) === false || providers.length === 0) {\n    config[\"providers\"] = [env_provider(overrides)];\n    return;\n  }\n  const first = providers[0];\n  if (typeof first !== \"object\" || first === null) {\n    throw new Error(\"config providers[0] must be an object\");\n  }\n  const provider = first as Record<string, unknown>;\n  for (const key of keys) {\n    const value = overrides[key];\n    if (value !== undefined) {\n      provider[key.replace(\"provider_\", \"\")] = value;\n    }\n  }\n}\n\nfunction apply_overrides(config: Record<string, unknown>, overrides: Record<string, string>): void {\n  for (const key of [\"work_dir\", \"system_prompt\", \"session_dir\", \"log_level\"]) {\n    if (overrides[key] !== undefined) {\n      config[key] = overrides[key];\n    }\n  }\n  if (overrides[\"max_turns\"] !== undefined) {\n    const turns = Number(overrides[\"max_turns\"]);\n    if (Number.isInteger(turns) === false || turns < 1) {\n      throw new Error(\"--max-turns must be a positive integer\");\n    }\n    config[\"max_turns\"] = turns;\n  }\n  apply_provider_override(config, overrides);\n}\n\nfunction build_config(options: CliOptions): AgentConfig {\n  const base =\n    options.config_path === undefined ? load_config() ?? { providers: [env_provider(options.overrides)] } : load_config_file(options.config_path);\n  apply_overrides(base, options.overrides);\n  const providers = base[\"providers\"];\n  if (Array.isArray(providers) === false || providers.length === 0) {\n    throw new Error(\"no model configured: set LICH_MODEL, pass --model, or create .lich/config.json (`lich config` prints a template)\");\n  }\n  return parse_agent_config(base);\n}\n\n/** build_config with the failure message prefixed for the invoking subcommand. */\nfunction build_config_for(options: CliOptions, mode: string): AgentConfig {\n  try {\n    return build_config(options);\n  } catch (error) {\n    throw new Error(error_for_mode(mode, error_message(error)));\n  }\n}\n\nfunction attach_progress(emitter: AgentEmitter): () => void {\n  return emitter.on((event) => {\n    if (event.type === \"turn_start\") {\n      process.stderr.write(`\\n[lich] turn ${event.turn}`);\n      return;\n    }\n    if (event.type === \"tool_call_end\") {\n      const status = event.result.ok === true ? \"ok\" : `error: ${event.result.error ?? \"\"}`;\n      process.stderr.write(`\\n[lich]   ${event.call.name}: ${status}`);\n      return;\n    }\n    if (event.type === \"final\") {\n      process.stderr.write(\"\\n\");\n    }\n  });\n}\n\nasync function run_one_shot(config: unknown, input: string): Promise<number> {\n  const agent = create_agent(config);\n  const stop_progress = attach_progress(agent.events);\n  let result: AgentRunResult;\n  try {\n    result = await agent.run({ input });\n  } finally {\n    stop_progress();\n  }\n  const final = result.outcome.final;\n  if (final !== undefined && final.content.length > 0) {\n    process.stdout.write(`${final.content}\\n`);\n  }\n  if (result.outcome.stopped_reason === \"budget\") {\n    process.stderr.write(`[lich] budget exhausted after ${result.outcome.turns_used} turns\\n`);\n    return 1;\n  }\n  if (result.outcome.stopped_reason === \"aborted\") {\n    process.stderr.write(\"[lich] run aborted\\n\");\n    return 1;\n  }\n  return 0;\n}\n\nasync function run_chat_turn(agent: Agent, input: string): Promise<void> {\n  const stop_progress = attach_progress(agent.events);\n  try {\n    const result = await agent.run({ input });\n    const final = result.outcome.final;\n    if (final !== undefined && final.content.length > 0) {\n      process.stdout.write(`${final.content}\\n`);\n    }\n    process.stdout.write(`[turns ${result.outcome.turns_used} | tokens ${result.usage_total.total_tokens}]\\n`);\n  } catch (error) {\n    process.stderr.write(`[lich] ${error_message(error)}\\n`);\n  } finally {\n    stop_progress();\n  }\n}\n\nfunction ask_line(rl: Interface): Promise<string> {\n  return new Promise((resolve) => {\n    const on_close = (): void => resolve(\"\");\n    rl.question(\"> \", (answer) => {\n      rl.removeListener(\"close\", on_close);\n      resolve(answer);\n    });\n    rl.once(\"close\", on_close);\n  });\n}\n\nasync function run_chat(config: unknown): Promise<number> {\n  const agent = create_agent(config);\n  const rl = createInterface({ input: process.stdin, output: process.stdout });\n  try {\n    for (;;) {\n      const line = await ask_line(rl);\n      if (line.trim() === \"\") {\n        return 0;\n      }\n      const command = line.trim();\n      if (command === \"/exit\" || command === \"/quit\") {\n        return 0;\n      }\n      await run_chat_turn(agent, command);\n    }\n  } finally {\n    rl.close();\n  }\n}\n\nasync function run_tui_entry(config: ReturnType<typeof build_config>): Promise<number> {\n  const { run_tui } = await import(\"./tui.js\");\n  return run_tui(config);\n}\n\nasync function run_gateway_entry(\n  config: ReturnType<typeof build_config>,\n  platforms: string[],\n): Promise<number> {\n  const { run_gateway } = await import(\"./gateway.js\");\n  return run_gateway(config, platforms.length === 0 ? [\"webhook\"] : platforms);\n}\n\nfunction is_main_module(): boolean {\n  const entry = process.argv[1];\n  if (entry === undefined) {\n    return false;\n  }\n  return import.meta.url === pathToFileURL(path.resolve(entry)).href;\n}\n\nasync function main(argv: string[]): Promise<number> {\n  const options = parse_args(argv);\n  if (options.help === true) {\n    process.stdout.write(`${usage_text()}\\n`);\n    return 0;\n  }\n  if (options.version === true) {\n    process.stdout.write(`${LICH_VERSION}\\n`);\n    return 0;\n  }\n  const [first] = options.positionals;\n  if (first === undefined) {\n    process.stderr.write(`${usage_text()}\\n`);\n    return 1;\n  }\n  if (first === \"config\") {\n    process.stdout.write(`${config_template()}\\n`);\n    return 0;\n  }\n  if (first === \"chat\") {\n    if (options.positionals.length > 1) {\n      throw new Error(\"chat mode takes no task argument\");\n    }\n    return run_chat(build_config_for(options, first));\n  }\n  if (first === \"tui\") {\n    return run_tui_entry(build_config_for(options, first));\n  }\n  if (first === \"gateway\") {\n    return run_gateway_entry(build_config_for(options, first), options.positionals.slice(1));\n  }\n  return run_one_shot(build_config_for(options, \"one-shot\"), options.positionals.join(\" \"));\n}\n\nif (is_main_module() === true) {\n  main(process.argv.slice(2))\n    .then((code) => {\n      process.exitCode = code;\n    })\n    .catch((error) => {\n      process.stderr.write(`lich: ${error_message(error)}\\n`);\n      process.stderr.write(\"run `lich --help` for usage\\n\");\n      process.exitCode = 1;\n    });\n}","/**\n * Config-file discovery for the CLI: an ordered search chain, safe loading,\n * and a starter template so `lich tui` works with zero environment setup.\n */\nimport { existsSync, mkdirSync, readFileSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport path from \"node:path\";\nimport { safe_json_parse } from \"./util/json.js\";\n\nconst LICH_DIRNAME = \".lich\";\nconst CONFIG_RELPATH = `${LICH_DIRNAME}/config.json`;\nconst DEFAULT_USER_CONFIG = \".config/lich/config.json\";\n\n/** Ordered absolute chain: work_dir (default cwd) first, then the user config home. */\nexport function config_search_paths(work_dir?: string): string[] {\n  const root = work_dir ?? process.cwd();\n  const first = path.resolve(root, CONFIG_RELPATH);\n  const second = path.resolve(homedir(), DEFAULT_USER_CONFIG);\n  return first === second ? [first] : [first, second];\n}\n\n/** Explicit path must exist (else throw); otherwise walk the chain, undefined when absent. */\nexport function find_config_file(explicit?: string): string | undefined {\n  if (explicit !== undefined) {\n    if (existsSync(explicit) === false) {\n      throw new Error(`config not found: ${explicit}`);\n    }\n    return explicit;\n  }\n  for (const candidate of config_search_paths()) {\n    if (existsSync(candidate) === true) {\n      return candidate;\n    }\n  }\n  return undefined;\n}\n\n/** Load the first config found as an object; undefined when absent, throw on bad json. */\nexport function load_config(explicit?: string): Record<string, unknown> | undefined {\n  const found = find_config_file(explicit);\n  if (found === undefined) {\n    return undefined;\n  }\n  const raw = readFileSync(found, \"utf8\");\n  const parsed = safe_json_parse<unknown>(raw);\n  if (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) {\n    throw new Error(`invalid config json: ${found}`);\n  }\n  return parsed as Record<string, unknown>;\n}\n\n/** Starter config honoring LICH_* env hints; `lich config` prints it. */\nexport function config_template(): string {\n  const kind = process.env.LICH_PROVIDER_KIND ?? \"ollama\";\n  const provider: Record<string, unknown> = {\n    kind,\n    name: \"main\",\n    model: process.env.LICH_MODEL ?? \"<model-name>\",\n  };\n  if (kind === \"ollama\") {\n    provider[\"base_url\"] = \"http://localhost:11434\";\n  }\n  return JSON.stringify({ providers: [provider], max_turns: 25 }, null, 2);\n}\n\n/** mkdir -p `${work_dir}/.lich` and return the directory path. */\nexport function ensure_lich_config_dir(work_dir: string): string {\n  const dir = path.resolve(work_dir, LICH_DIRNAME);\n  mkdirSync(dir, { recursive: true });\n  return dir;\n}"],"mappings":"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","names":["readFileSync","path","value","readFileSync","path"]}

package/dist/{tui-V7ATLIKW.js → tui-K3EPRXTV.js}

@@ -1,3 +1,6 @@
+import {
+  LICH_VERSION
+} from "./chunk-ZVK3MUPC.js";
 import {
   create_agent,
   truncate_text
@@ -409,7 +412,7 @@ function TuiApp({ agent }) {
   );
   const provider = agent.config.providers[0];
   return /* @__PURE__ */ jsxs4(Box4, { flexDirection: "column", minHeight: 8, children: [
-    /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: `lich v0.2.0 \u2014 ${provider?.model ?? "unknown"} (${provider?.kind ?? "unknown"})` }),
+    /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: `lich v${LICH_VERSION} \u2014 ${provider?.model ?? "unknown"} (${provider?.kind ?? "unknown"})` }),
     /* @__PURE__ */ jsx4(MessageView, { blocks, state }),
     /* @__PURE__ */ jsx4(StatusBar, { state, model: provider?.model ?? "unknown" }),
     /* @__PURE__ */ jsx4(CommandBar, { busy: state.phase !== "idle", on_submit: submit })
@@ -427,4 +430,4 @@ async function run_tui(config) {
 export {
   run_tui
 };
-//# sourceMappingURL=tui-V7ATLIKW.js.map
+//# sourceMappingURL=tui-K3EPRXTV.js.map

package/dist/tui-K3EPRXTV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tui.tsx","../src/tui/app.tsx","../src/tui/state.ts","../src/tui/message_view.tsx","../src/tui/status_bar.tsx","../src/tui/command_bar.tsx"],"sourcesContent":["/**\n * TUI entry: builds the agent from the parsed config and renders the ink app\n * until exit. The CLI dynamic-imports this module for `lich tui`.\n */\nimport { render } from \"ink\";\nimport { create_agent } from \"./agent/agent.js\";\nimport type { AgentConfig } from \"./agent/config.js\";\nimport { TuiApp } from \"./tui/app.js\";\n\nexport async function run_tui(config: AgentConfig): Promise<number> {\n  const agent = create_agent(config);\n  const instance = render(<TuiApp agent={agent} />);\n  await instance.waitUntilExit();\n  return 0;\n}","/**\n * Root ink component for the lich TUI: wires agent events into the UI state\n * machine, drives agent.run with history continuity, and lays out header,\n * transcript, status bar, and the command input row.\n */\nimport { useCallback, useEffect, useRef, useState, type Dispatch, type SetStateAction } from \"react\";\nimport { Box, Text } from \"ink\";\nimport type { Agent, AgentRunResult } from \"../agent/agent.js\";\nimport type { AgentEvent } from \"../agent/events.js\";\nimport type { AgentConfig } from \"../agent/config.js\";\nimport type { Message } from \"../providers/types.js\";\nimport { LICH_VERSION } from \"../index.js\";\nimport { readdir, stat } from \"node:fs/promises\";\nimport {\n  apply_event,\n  apply_run_result,\n  compress_notice_block,\n  error_notice_block,\n  help_block,\n  HISTORY_CAP,\n  INITIAL_UI_STATE,\n  model_label_block,\n  parse_command,\n  run_notice_blocks,\n  session_list_block,\n  tool_result_block,\n  unknown_command_block,\n  usage_notice_block,\n  type HistoryBlock,\n  type ParsedInput,\n  type SessionEntryInfo,\n  type UiState,\n} from \"./state.js\";\nimport { MessageView } from \"./message_view.js\";\nimport { StatusBar } from \"./status_bar.js\";\nimport { CommandBar } from \"./command_bar.js\";\n\nconst SESSION_LIST_CAP = 10;\n\ntype SlashInput = Extract<ParsedInput, { kind: \"slash\" }>;\ntype AddBlocks = (added: readonly HistoryBlock[]) => void;\ntype SetUiState = Dispatch<SetStateAction<UiState>>;\ntype SetBlocks = Dispatch<SetStateAction<readonly HistoryBlock[]>>;\n\n/** Map one agent event to optional transcript blocks (tool rows, notices). */\nfunction event_blocks(event: AgentEvent): readonly HistoryBlock[] {\n  if (event.type === \"tool_call_end\") {\n    return [tool_result_block(event.call, event.result.ok === true, event.result.output)];\n  }\n  if (event.type === \"compress_end\") {\n    return [compress_notice_block(event.summary_chars)];\n  }\n  if (event.type === \"error\") {\n    return [error_notice_block(event.error instanceof Error ? event.error.message : String(event.error))];\n  }\n  return [];\n}\n\n/** One agent turn: subscribe to events, run, unsubscribe in finally. */\nasync function run_agent_turn(\n  agent: Agent,\n  history: readonly Message[],\n  input: string,\n  on_event: (event: AgentEvent) => void,\n  on_done: (result: AgentRunResult) => void,\n  signal: AbortSignal,\n): Promise<void> {\n  const stop_listening = agent.events.on(on_event);\n  try {\n    const result = await agent.run({ input, history, signal, label: \"tui\" });\n    on_done(result);\n  } finally {\n    stop_listening();\n  }\n}\n\n/** Async /sessions listing as a meta block (never throws). */\nasync function sessions_block(config: AgentConfig): Promise<HistoryBlock> {\n  try {\n    const dir_entries = await readdir(config.session_dir, { withFileTypes: true });\n    const entries: SessionEntryInfo[] = [];\n    for (const entry of dir_entries) {\n      if (entry.isFile() === false || entry.name.endsWith(\".jsonl\") === false) {\n        continue;\n      }\n      const info = await stat(`${config.session_dir}/${entry.name}`);\n      entries.push({ name: entry.name, size_bytes: info.size, mtime_ms: info.mtimeMs });\n    }\n    return session_list_block(entries, SESSION_LIST_CAP);\n  } catch {\n    return { role: \"meta\", lines: [\"· no session files yet\"] };\n  }\n}\n\nfunction run_error_text(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\n/** Runs one message exchange; owns history continuity and abort wiring. */\nfunction use_agent_run(\n  agent: Agent,\n  add_blocks: AddBlocks,\n  set_state: SetUiState,\n  set_blocks: SetBlocks,\n): (text: string) => void {\n  const history_ref = useRef<readonly Message[]>([]);\n  const controller_ref = useRef<AbortController | undefined>(undefined);\n\n  const finish_run = useCallback((result: AgentRunResult): void => {\n    history_ref.current = result.messages;\n    set_state((current) => apply_run_result(current, result));\n    add_blocks(run_notice_blocks(result));\n  }, [add_blocks, set_state]);\n\n  const start_message_run = useCallback(\n    (text: string): void => {\n      add_blocks([{ role: \"user\", lines: [`you › ${text}`] }]);\n      set_state((current) => ({ ...current, phase: \"thinking\", active_tool: undefined }));\n      const controller = new AbortController();\n      controller_ref.current = controller;\n      const on_event = (event: AgentEvent): void => {\n        set_state((current) => apply_event(current, event));\n        set_blocks((current) => [...current, ...event_blocks(event)].slice(-HISTORY_CAP));\n      };\n      void run_agent_turn(agent, history_ref.current, text, on_event, finish_run, controller.signal)\n        .catch((error: unknown) => {\n          add_blocks([error_notice_block(run_error_text(error))]);\n          set_state((current) => ({ ...current, phase: \"idle\" }));\n        })\n        .finally(() => {\n          if (controller_ref.current === controller) {\n            controller_ref.current = undefined;\n          }\n        });\n    },\n    [agent, add_blocks, finish_run, set_blocks, set_state],\n  );\n\n  useEffect(() => () => controller_ref.current?.abort(), []);\n\n  return start_message_run;\n}\n\n/** Slash-command dispatch: pure client-side actions, never hits the agent. */\nfunction use_slash_commands(agent: Agent, add_blocks: AddBlocks, set_blocks: SetBlocks, total_tokens: number): (parsed: SlashInput) => void {\n  const handle = useCallback(\n    (parsed: SlashInput): void => {\n      if (parsed.name === \"exit\" || parsed.name === \"quit\" || parsed.name === \"q\") {\n        process.exit(0);\n        return;\n      }\n      if (parsed.name === \"help\") {\n        add_blocks([help_block()]);\n      } else if (parsed.name === \"model\") {\n        add_blocks([model_label_block(agent.config)]);\n      } else if (parsed.name === \"usage\") {\n        add_blocks([usage_notice_block(total_tokens)]);\n      } else if (parsed.name === \"clear\") {\n        set_blocks([]);\n      } else if (parsed.name === \"sessions\") {\n        void sessions_block(agent.config).then((block) => add_blocks([block]));\n      } else {\n        add_blocks([unknown_command_block(parsed.name)]);\n      }\n    },\n    [agent, add_blocks, set_blocks, total_tokens],\n  );\n  return handle;\n}\n\ninterface TuiAppProps {\n  readonly agent: Agent;\n}\n\nexport function TuiApp({ agent }: TuiAppProps): React.JSX.Element {\n  const [blocks, set_blocks] = useState<readonly HistoryBlock[]>([]);\n  const [state, set_state] = useState(INITIAL_UI_STATE);\n\n  const add_blocks = useCallback<AddBlocks>((added: readonly HistoryBlock[]): void => {\n    if (added.length === 0) {\n      return;\n    }\n    set_blocks((current) => [...current, ...added].slice(-HISTORY_CAP));\n  }, []);\n\n  const start_message_run = use_agent_run(agent, add_blocks, set_state, set_blocks);\n  const handle_slash = use_slash_commands(agent, add_blocks, set_blocks, state.usage.total_tokens);\n\n  const submit = useCallback(\n    (text: string): void => {\n      const parsed = parse_command(text);\n      if (parsed.kind === \"message\") {\n        if (parsed.text.length > 0) {\n          start_message_run(parsed.text);\n        }\n        return;\n      }\n      handle_slash(parsed);\n    },\n    [handle_slash, start_message_run],\n  );\n\n  const provider = agent.config.providers[0];\n  return (\n    <Box flexDirection=\"column\" minHeight={8}>\n      <Text dimColor>{`lich v${LICH_VERSION} — ${provider?.model ?? \"unknown\"} (${provider?.kind ?? \"unknown\"})`}</Text>\n      <MessageView blocks={blocks} state={state} />\n      <StatusBar state={state} model={provider?.model ?? \"unknown\"} />\n      <CommandBar busy={state.phase !== \"idle\"} on_submit={submit} />\n    </Box>\n  );\n}","/**\n * Pure state logic for the ink TUI: UI-state transitions from agent events,\n * slash-command parsing, transcript block mapping, and display formatters.\n * No ink/react imports here — this module is unit-tested without a TTY.\n */\nimport type { AgentEvent } from \"../agent/events.js\";\nimport type { AgentRunResult } from \"../agent/agent.js\";\nimport type { AssistantMessage, Message, ToolCall, Usage } from \"../providers/types.js\";\nimport { safe_json_parse, truncate_text } from \"../util/json.js\";\n\nexport type UiPhase = \"idle\" | \"thinking\" | \"tool\";\n\nexport interface UiState {\n  readonly phase: UiPhase;\n  readonly turns_used: number;\n  readonly usage: Usage;\n  readonly session_path: string | undefined;\n  readonly compress_count: number;\n  readonly budget_exhausted: boolean;\n  readonly last_error: string | undefined;\n  readonly active_tool: ToolCall | undefined;\n}\n\nexport const INITIAL_UI_STATE: UiState = {\n  phase: \"idle\",\n  turns_used: 0,\n  usage: { prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 },\n  session_path: undefined,\n  compress_count: 0,\n  budget_exhausted: false,\n  last_error: undefined,\n  active_tool: undefined,\n};\n\nexport const HISTORY_CAP = 50;\nconst TOOL_ARGS_PREVIEW_CHARS = 80;\nconst TOOL_OUTPUT_PREVIEW_CHARS = 120;\nconst ERROR_PREVIEW_CHARS = 300;\n\nfunction error_text(error: unknown): string {\n  if (error instanceof Error) {\n    return error.message;\n  }\n  return String(error);\n}\n\n/** Reducer over UiState; one pure mapping per AgentEvent variant. */\nexport function apply_event(state: UiState, event: AgentEvent): UiState {\n  switch (event.type) {\n    case \"llm_start\":\n      return { ...state, phase: \"thinking\", active_tool: undefined };\n    case \"llm_end\":\n      return {\n        ...state,\n        usage: {\n          prompt_tokens: state.usage.prompt_tokens + event.result.usage.prompt_tokens,\n          completion_tokens: state.usage.completion_tokens + event.result.usage.completion_tokens,\n          total_tokens: state.usage.total_tokens + event.result.usage.total_tokens,\n        },\n      };\n    case \"tool_call_start\":\n      return { ...state, phase: \"tool\", active_tool: event.call };\n    case \"tool_call_end\":\n      return {\n        ...state,\n        phase: \"thinking\",\n        active_tool: undefined,\n        last_error: event.result.ok === true ? state.last_error : (event.result.error ?? \"tool failed\"),\n      };\n    case \"turn_end\":\n      return { ...state, turns_used: event.turn };\n    case \"compress_start\":\n      return { ...state, compress_count: state.compress_count + 1 };\n    case \"budget_exhausted\":\n      return { ...state, budget_exhausted: true };\n    case \"error\":\n      return { ...state, last_error: error_text(event.error) };\n    default:\n      return state;\n  }\n}\n\n/** Fold an AgentRunResult back into UiState after the run promise resolves. */\nexport function apply_run_result(state: UiState, result: AgentRunResult): UiState {\n  return {\n    ...state,\n    phase: \"idle\",\n    turns_used: result.outcome.turns_used,\n    session_path: result.session_path ?? state.session_path,\n    last_error: result.outcome.stopped_reason === \"aborted\" ? \"run aborted\" : state.last_error,\n  };\n}\n\nexport type ParsedInput = { kind: \"slash\"; name: string; args: string } | { kind: \"message\"; text: string };\n\n/** Split trimmed input into slash command vs plain message (empty input = message). */\nexport function parse_command(raw_input: string): ParsedInput {\n  const text = raw_input.trim();\n  if (text.startsWith(\"/\") === false) {\n    return { kind: \"message\", text };\n  }\n  const body = text.slice(1);\n  const space_index = body.indexOf(\" \");\n  if (space_index === -1) {\n    return { kind: \"slash\", name: body, args: \"\" };\n  }\n  return { kind: \"slash\", name: body.slice(0, space_index), args: body.slice(space_index + 1).trim() };\n}\n\n/** 1234567 -> \"1,234,567\" (US grouping, matching the status bar style). */\nexport function format_usage(total_tokens: number): string {\n  return total_tokens.toLocaleString(\"en-US\");\n}\n\nexport type BlockRole = \"user\" | \"lich\" | \"tool\" | \"meta\" | \"error\";\n\nexport interface HistoryBlock {\n  readonly role: BlockRole;\n  readonly lines: readonly string[];\n}\n\nfunction assistant_tool_line(call: ToolCall): string {\n  const args_json = JSON.stringify(call.args) ?? \"{}\";\n  return `  \\u23bf ${truncate_text(args_json, TOOL_ARGS_PREVIEW_CHARS)}`;\n}\n\nfunction format_message_lines(message: Message): string[] {\n  if (message.role === \"user\") {\n    return [`you \\u203a ${message.content}`];\n  }\n  if (message.role === \"assistant\") {\n    const lines = [`lich \\u203a ${message.content}`];\n    for (const call of message.tool_calls ?? []) {\n      lines.push(assistant_tool_line(call));\n    }\n    return lines;\n  }\n  if (message.role === \"tool\") {\n    const flag = message.is_error === true ? \"error\" : \"ok\";\n    return [`  \\u23bf ${message.name}: ${flag} (${truncate_text(message.content, TOOL_OUTPUT_PREVIEW_CHARS)})`];\n  }\n  return [`\\u00b7 system: ${message.content}`];\n}\n\n/** Map one transcript Message to display lines with its role tag. */\nexport function format_message_block(message: Message): HistoryBlock {\n  if (message.role === \"tool\") {\n    const ok = message.is_error !== true;\n    return { role: ok === true ? \"tool\" : \"error\", lines: format_message_lines(message) };\n  }\n  const roles: Record<Exclude<Message[\"role\"], \"tool\">, BlockRole> = {\n    system: \"meta\",\n    user: \"user\",\n    assistant: \"lich\",\n  };\n  return { role: roles[message.role], lines: format_message_lines(message) };\n}\n\n/** Keep the newest `cap` non-system messages as renderable blocks. */\nexport function split_history_blocks(messages: readonly Message[], cap: number): HistoryBlock[] {\n  const visible = messages.filter((message) => message.role !== \"system\");\n  const start = Math.max(0, visible.length - cap);\n  return visible.slice(start).map(format_message_block);\n}\n\nfunction assistant_result_block(message: AssistantMessage): HistoryBlock | undefined {\n  if (message.content.length === 0) {\n    return undefined;\n  }\n  return { role: \"lich\", lines: [`lich \\u203a ${message.content}`] };\n}\n\n/** Post-run meta blocks: compression notices, budget, errors, final answer. */\nexport function run_notice_blocks(result: AgentRunResult): HistoryBlock[] {\n  const blocks: HistoryBlock[] = [];\n  if (result.outcome.stopped_reason === \"budget\") {\n    blocks.push({ role: \"error\", lines: [\"\\u00b7 budget exhausted (turn cap reached)\"] });\n  }\n  const final_block = result.outcome.final === undefined ? undefined : assistant_result_block(result.outcome.final);\n  if (final_block !== undefined) {\n    blocks.push(final_block);\n  }\n  return blocks;\n}\n\nfunction truncate_tool_preview(result_content: string, ok: boolean): string {\n  return `  \\u23bf ${ok === true ? \"ok\" : \"error\"} (${truncate_text(result_content, TOOL_OUTPUT_PREVIEW_CHARS)})`;\n}\n\n/** One finalized live tool row; falls back to the transcript copy when absent. */\nexport function tool_result_block(call: ToolCall, ok: boolean, result_content: string): HistoryBlock {\n  const args_json = JSON.stringify(call.args) ?? \"{}\";\n  const lines = [\n    `\\u23fa ${call.name}(${truncate_text(args_json, TOOL_ARGS_PREVIEW_CHARS)})`,\n    truncate_tool_preview(result_content, ok),\n  ];\n  return { role: ok === true ? \"tool\" : \"error\", lines };\n}\n\nexport function parse_tool_message_content(content: string): { ok: boolean; output: string } {\n  const parsed = safe_json_parse<{ ok?: unknown; output?: unknown }>(content);\n  if (parsed !== undefined && typeof parsed.ok === \"boolean\" && typeof parsed.output === \"string\") {\n    return { ok: parsed.ok, output: parsed.output };\n  }\n  return { ok: true, output: content };\n}\n\nexport function compress_notice_block(summary_chars: number): HistoryBlock {\n  return { role: \"meta\", lines: [`\\u00b7 context compressed (summary ${summary_chars} chars)`] };\n}\n\nexport function error_notice_block(message: string): HistoryBlock {\n  return { role: \"error\", lines: [`\\u00b7 error: ${truncate_text(message, ERROR_PREVIEW_CHARS)}`] };\n}\n\nexport function tool_args_preview(args: Record<string, unknown>): string {\n  const args_json = JSON.stringify(args) ?? \"{}\";\n  return truncate_text(args_json, TOOL_ARGS_PREVIEW_CHARS);\n}\n\nexport function help_block(): HistoryBlock {\n  return { role: \"meta\", lines: [...HELP_LINES] };\n}\n\nexport function model_label_block(config: { providers: readonly { model: string; kind: string }[] }): HistoryBlock {\n  const provider = config.providers[0];\n  return {\n    role: \"meta\",\n    lines: [`\\u00b7 model: ${provider?.model ?? \"unknown\"} \\u00b7 provider: ${provider?.kind ?? \"unknown\"}`],\n  };\n}\n\nexport function usage_notice_block(total_tokens: number): HistoryBlock {\n  return { role: \"meta\", lines: [`\\u00b7 tokens used this session: ${format_usage(total_tokens)}`] };\n}\n\nexport function unknown_command_block(name: string): HistoryBlock {\n  return { role: \"error\", lines: [`\\u00b7 unknown command: /${name} (try /help)`] };\n}\n\nexport interface SessionEntryInfo {\n  readonly name: string;\n  readonly size_bytes: number;\n  readonly mtime_ms: number;\n}\n\n/** Newest-first session listing, capped at `cap` entries. */\nexport function session_list_block(entries: readonly SessionEntryInfo[], cap: number = 10): HistoryBlock {\n  const sorted = [...entries].sort((a, b) => b.mtime_ms - a.mtime_ms).slice(0, cap);\n  if (sorted.length === 0) {\n    return { role: \"meta\", lines: [\"\\u00b7 no session files yet\"] };\n  }\n  const lines: string[] = [`\\u00b7 sessions (${sorted.length}):`];\n  for (const entry of sorted) {\n    lines.push(`  ${entry.name} (${format_usage(entry.size_bytes)} bytes)`);\n  }\n  return { role: \"meta\", lines };\n}\n\nexport const SLASH_COMMAND_NAMES: readonly string[] = [\n  \"exit\",\n  \"quit\",\n  \"q\",\n  \"help\",\n  \"model\",\n  \"usage\",\n  \"clear\",\n  \"sessions\",\n];\n\nexport const HELP_LINES: readonly string[] = [\n  \"commands: /help /model /usage /clear /sessions /exit (aliases: /quit /q)\",\n  \"enter submits \\u00b7 backspace deletes \\u00b7 up/down recalls history \\u00b7 pasted newlines become spaces\",\n];","/**\n * Transcript rendering: maps HistoryBlock descriptors to ink elements with\n * role-based colors, and shows an animated braille spinner while thinking.\n * Blocks are pre-capped by the app, so a plain flex column is sufficient.\n */\nimport { useEffect, useState } from \"react\";\nimport { Box, Text } from \"ink\";\nimport { tool_args_preview, type HistoryBlock, type UiState } from \"./state.js\";\n\nconst SPINNER_FRAMES: readonly string[] = [\"⠋\", \"⠙\", \"⠹\", \"⠸\", \"⠼\", \"⠴\", \"⠦\", \"⠧\", \"⠇\", \"⠏\"];\nconst SPINNER_INTERVAL_MS = 80;\n\n/** Braille spinner frames on an 80ms interval; clears on unmount. */\nfunction use_spinner(): string {\n  const [frame, set_frame] = useState(SPINNER_FRAMES[0] ?? \"⠋\");\n  useEffect(() => {\n    const timer = setInterval(() => {\n      const next = SPINNER_FRAMES[(SPINNER_FRAMES.indexOf(frame) + 1) % SPINNER_FRAMES.length];\n      set_frame(next ?? \"⠋\");\n    }, SPINNER_INTERVAL_MS);\n    return () => {\n      clearInterval(timer);\n    };\n  }, [frame]);\n  return frame;\n}\n\nfunction ThinkingLine(): React.JSX.Element {\n  const frame = use_spinner();\n  return <Text dimColor>{`${frame} thinking…`}</Text>;\n}\n\nconst ROLE_COLORS: Record<HistoryBlock[\"role\"], string | undefined> = {\n  user: \"white\",\n  lich: \"green\",\n  tool: \"cyan\",\n  meta: undefined,\n  error: \"red\",\n};\n\nfunction BlockLines({ block }: { block: HistoryBlock }): React.JSX.Element {\n  const color = ROLE_COLORS[block.role];\n  return (\n    <>\n      {block.lines.map((line, index) => (\n        <Text key={index} color={color} dimColor={color === undefined}>{line}</Text>\n      ))}\n    </>\n  );\n}\n\ninterface MessageViewProps {\n  readonly blocks: readonly HistoryBlock[];\n  readonly state: UiState;\n}\n\n/** Transcript column plus the live phase line (spinner / running tool row). */\nexport function MessageView({ blocks, state }: MessageViewProps): React.JSX.Element {\n  return (\n    <Box flexDirection=\"column\" flexGrow={1}>\n      {blocks.map((block, index) => (\n        <Box key={index} flexDirection=\"column\">\n          <BlockLines block={block} />\n        </Box>\n      ))}\n      {state.phase === \"thinking\" ? <ThinkingLine /> : null}\n      {state.phase === \"tool\" && state.active_tool !== undefined ? (\n        <Text color=\"cyan\">{`⏺ ${state.active_tool.name}(${tool_args_preview(state.active_tool.args)})`}</Text>\n      ) : null}\n    </Box>\n  );\n}","/**\n * Bottom status line: model, turns, token totals, phase tag, compression\n * count, and the session path once the agent has persisted a transcript.\n */\nimport { Box, Text } from \"ink\";\nimport { format_usage, type UiState } from \"./state.js\";\n\nconst PHASE_LABELS: Record<UiState[\"phase\"], string> = {\n  idle: \"idle\",\n  thinking: \"thinking\",\n  tool: \"tool\",\n};\n\ninterface StatusBarProps {\n  readonly state: UiState;\n  readonly model: string;\n}\n\nexport function StatusBar({ state, model }: StatusBarProps): React.JSX.Element {\n  const phase = PHASE_LABELS[state.phase];\n  return (\n    <Box>\n      <Text dimColor>\n        {`model ${model} · turns ${state.turns_used} · tokens ${format_usage(state.usage.total_tokens)} · [${phase}]`}\n        {state.compress_count > 0 ? ` · compressed ${state.compress_count}` : \"\"}\n        {state.session_path !== undefined ? ` · ${state.session_path}` : \"\"}\n      </Text>\n      {state.budget_exhausted ? <Text color=\"red\"> · budget exhausted</Text> : null}\n    </Box>\n  );\n}","/**\n * Input row: printable characters accumulate in a buffer, Enter submits,\n * Backspace/Delete edits, Up/Down walk a 20-entry recall ring, and pasted\n * newlines collapse to spaces. Ctrl+C is left to ink's default handling.\n */\nimport { useState } from \"react\";\nimport { Box, Text, useInput } from \"ink\";\n\nconst INPUT_HISTORY_CAP = 20;\n\ninterface CommandBarProps {\n  readonly busy: boolean;\n  readonly on_submit: (text: string) => void;\n}\n\n/** Push onto a capped ring (newest first) without mutating the source. */\nfunction push_history(ring: readonly string[], entry: string): readonly string[] {\n  return [entry, ...ring.filter((item) => item !== entry)].slice(0, INPUT_HISTORY_CAP);\n}\n\nexport function CommandBar({ busy, on_submit }: CommandBarProps): React.JSX.Element {\n  const [buffer, set_buffer] = useState(\"\");\n  const [recall_ring, set_recall_ring] = useState<readonly string[]>([]);\n  const [recall_index, set_recall_index] = useState<number | undefined>(undefined);\n\n  const submit_buffer = (): void => {\n    const text = buffer.trim();\n    set_buffer(\"\");\n    set_recall_index(undefined);\n    if (text.length > 0) {\n      set_recall_ring((current) => push_history(current, text));\n      on_submit(text);\n    }\n  };\n\n  const walk_recall = (direction: 1 | -1): void => {\n    if (recall_ring.length === 0) {\n      return;\n    }\n    const current = recall_index ?? -direction;\n    const next = Math.min(Math.max(current + direction, 0), recall_ring.length - 1);\n    set_recall_index(next);\n    set_buffer(recall_ring[next] ?? \"\");\n  };\n\n  useInput((input, key) => {\n    if (key.return === true) {\n      submit_buffer();\n      return;\n    }\n    if (key.upArrow === true) {\n      walk_recall(-1);\n      return;\n    }\n    if (key.downArrow === true) {\n      walk_recall(1);\n      return;\n    }\n    if (key.backspace === true || key.delete === true) {\n      set_buffer((current) => current.slice(0, -1));\n      return;\n    }\n    if (key.ctrl === true || key.escape === true || key.tab === true || key.meta === true) {\n      return;\n    }\n    if (input.length > 0) {\n      set_buffer((current) => current + input.replaceAll(\"\\n\", \" \").replaceAll(\"\\r\", \" \"));\n    }\n  });\n\n  return (\n    <Box>\n      <Text dimColor>{busy ? \"  … \" : \"› \"}</Text>\n      <Text>{buffer}</Text>\n      <Text dimColor>▌</Text>\n    </Box>\n  );\n}"],"mappings":"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","names":["useEffect","useState","Box","Text","Box","Text","jsx","jsxs","Box","Text","useState","Box","Text","jsx","jsxs","jsx","jsxs","useEffect","useState","Box","Text","jsx"]}

package/docs/.vitepress/config.mts

@@ -1,6 +1,7 @@
 import { defineConfig } from 'vitepress'
 
 export default defineConfig({
+  base: '/lich/',
   title: 'Lich',
   description:
     'A TypeScript AI agent harness — Think-Act-Observe loop, provider failover, tools, gateway, TUI.',

package/docs/architecture/extending.md

@@ -2,8 +2,11 @@
 
 Hands-on recipes for the three extension axes: builtin tools, providers, and
 gateway platforms - plus the TUI internals, the conventions that hold the
-codebase together, and how the test suite is organized. Read
-[tools](./tools.md) and [providers](./providers.md) first for the contracts.
+codebase together, and how the test suite is organized. Everything on this
+page assumes a clone of the repository — the `@moikapy/lich` npm package is
+the artifact this source builds (see
+[development install](../getting-started.md#development-install-from-source)).
+Read [tools](./tools.md) and [providers](./providers.md) first for the contracts.
 
 ## Add a builtin tool
 

package/docs/architecture/overview.md

@@ -1,6 +1,6 @@
 # Architecture Overview
 
-Lich v0.2.0 is a small TypeScript AI agent harness: it drives a chat model in a
+Lich v0.3.0 is a small TypeScript AI agent harness: it drives a chat model in a
 think-act-observe loop, lets the model call tools, compresses history when the
 context budget demands it, and persists transcripts. It runs on Bun, is ESM
 with NodeNext resolution, and its only runtime dependencies are `zod` (config

package/docs/architecture/plugins.md

@@ -1,6 +1,6 @@
 # Plugin architecture
 
-How the plugin system loads user modules, merges tools into the registry, and intercepts tool calls with hooks. Source: [`src/plugins/`](../../src/plugins).
+How the plugin system loads user modules, merges tools into the registry, and intercepts tool calls with hooks. Sources: [`loader.ts`](../../src/plugins/loader.ts), [`hooks.ts`](../../src/plugins/hooks.ts), [`types.ts`](../../src/plugins/types.ts).
 
 ## Loader flow
 

package/docs/design/council/architecture-review-r2.md

@@ -0,0 +1,36 @@
+# Council Review R2 — Architecture & Testability
+
+Reviewer: Council Member 3 (architecture fit, correctness, testability)
+Plan under review: `docs/design/self-improvement-loop.md` Draft v2
+
+## Verdict
+
+APPROVE-WITH-CHANGES. All seven round-1 findings are materially addressed — three by clean cuts, four by concrete redesign — but v2 introduces one genuine mechanism error (the HEAD+index seal does not close the TOCTOU it claims to close: the plan's own negative-path demo would pass the broken seal) and leaves the core-plugin config plumbing unspecified.
+
+## Round-1 findings status
+
+1. Executor 30s cap — **RESOLVED.** `tool.timeout_ms ?? 30000` in `run_tool` is exactly the right seam; the signal-merge logic in `with_timeout` (timeout signal + external signal → combined controller, `src/tools/executor.ts:50-70`) needs no change, only the constant swap. Residual: the latent `terminal` 300s-vs-30s mismatch is not mentioned — give `terminal_tool` `timeout_ms: 300000` while touching the interface.
+2. Run-scoped state — **RESOLVED.** `run_state: Map` on `HookContext` + loop passing a per-run `ToolContext` fixes the `process.cwd()` bug, and it is consistent with executor defaults: `ToolExecutor.execute` uses defaults only when context is absent (`src/tools/executor.ts:39-43`), so a loop-supplied context simply supersedes them. Existing loop tests are safe — stub runners are `execute: async (name, args)` (`test/loop.test.ts:35-42`) and the interface is structural with an optional third param. Two threading details to name: `ToolContext` must carry `run_state` too (or `hooks.ts` cannot map it into `HookContext`), and the lifecycle-hook ctx built in `Agent.run` must hold the SAME map instance as the loop's ToolContext.
+3. on_run_end reliability — **RESOLVED.** Reflector is cut entirely (v2 scope §5, non-goals); nothing consumes `on_run_end` on crash paths anymore, so the `outcome === undefined` drop is moot.
+4. Consolidation ChatFn — **RESOLVED.** Cut; no plugin needs config for LLM calls anymore (but see new finding 2 — the gatekeeper still needs config for other keys).
+5. Two-process demo — **PARTIALLY RESOLVED.** The A/B structure, negative paths, and honest module-cache statement are right, but Process B's mechanism is ambiguous to the point of being wrong (see new finding 4).
+6. run_tests concurrency — **PARTIALLY RESOLVED.** Module-level mutex with `run_tests_busy` is specified and fine for one process, but lich legitimately runs CLI + TUI/gateway as separate processes on one repo; the mutex does not cover that. Either an `O_EXCL` file lock or an explicit documented limitation.
+7. Docs-cache multi-root — **PARTIALLY RESOLVED.** Per-root keying is the right direction, but "invalidated per call batch" is not a design; and since skills are now written via plain `write_file`, there is no hook point to trigger invalidation — a skill written this run stays invisible to `docs_search` until restart. Concrete fix: per-root `Map` cache, and NO memoization for user-writable roots (`.lich/skills` is tiny; walk it fresh every call), cache only the package/docs root.
+
+## New blocking findings in v2
+
+1. **The seal does not close the TOCTOU for unstaged edits — the plan's own negative-path test would pass. HIGH.** v2 §3 claims "edit changes the index hash"; false: `git write-tree` (the only primitive that hashes the index) captures STAGED state only — an unstaged edit to a tracked file leaves the index byte-identical, so test→edit→commit still matches the seal. Worse, `before_tool_call` runs BEFORE `git_commit` executes its `git add`, so whatever the gatekeeper compares is pre-add. The v2 demo's "commit after editing without re-testing → vetoed" would NOT be vetoed as specified. Fix (must be in the spec): the gatekeeper computes the hypothetical post-add tree itself via a temp index — `GIT_INDEX_FILE=<tmp> git read-tree <current-index>` (or copy), then `git add -- <paths>` against the temp index, then `git write-tree`, and compares THAT hash to the seal. This also naturally captures the named paths' working-tree content, not stale staged content. NFS note: stale attribute caches can produce phantom diffs between seal capture and commit (the "documented phantom-file problem" is actually only empirical in this repo — no docs page documents it; evidence is the `.git/tkfNobv: Function not implemented` failure and the suite-cleanup flake noted in council/security-review.md) — direction of failure is a spurious veto (fail-closed, acceptable), but fixtures belong on `/tmp`, not `test/.tmp/`.
+2. **Core-plugin config plumbing is unspecified. HIGH.** Plugins never receive config: the loader extracts only `name`/`tools`/`hooks` (`src/plugins/loader.ts:48-60`) and `Agent` never passes config to plugins. Yet the gatekeeper needs `allow_self_commit` and `max_commits_per_run`, `run_tests` needs `test_command`, and docs tools need `docs_roots` — and builtin tools don't see config either (`ToolContext` is `{work_dir, env, signal}`, `src/tools/types.ts:9-13`). Fix, using existing precedents: (a) `Agent` constructs the builtin gatekeeper directly (not via `load_plugins`) with config in hand — that is also the only clean way to honor "git_commit registered only if gatekeeper loaded"; (b) tool-visible config rides the existing `ExecutorDefaults.env` channel exactly like `LICH_TERMINAL_TIMEOUT_MS` and `LICH_DOCS_DIR` already do (`src/agent/agent.ts:110-113`): `LICH_TEST_COMMAND`, `LICH_DOCS_ROOTS`. Name both paths in the spec.
+3. **`run_tests` cwd pin contradicts the demo. HIGH.** v2 §1 pins cwd to the lich repo root via `import.meta.url`, but the demo (§6) runs against a temp git repo work_dir — files the agent writes into the fixture are never tested by a test command rooted at the real repo. Fix: cwd = `context.work_dir` (matching the config-derived env above), with the default `test_command` from config; the real repo is just the normal case where work_dir IS the lich root.
+4. **Process B will not see `hash_text` if it is a same-process "fresh agent instance". HIGH.** Registry is built in the constructor from `register_builtin_tools` (`src/agent/agent.ts:108-114`), and bun caches `src/tools/builtin/index.js` per process — a second in-process Agent imports the OLD module and `hash_text` never registers, failing the demo for a mechanical reason the spec hasn't addressed. Fix (pick one): (a) Process B is a real subprocess (`bun run` of a tiny fixture entry or the CLI) that imports the edited index fresh; or (b) the fixture repo's config lists the written tool file under `config.plugins` — the loader dynamic-imports at construction (`src/plugins/loader.ts:80-100`), so a fresh process picks it up with zero extra machinery. (b) is cheaper and keeps the fixture off the real checkout; state which, and that the e2e asserts via subprocess only.
+
+## Non-blocking observations
+
+- Loop-test compatibility verified: passing a per-run ToolContext from `run_tool_calls` breaks nothing — stubs ignore the third arg (`test/loop.test.ts`); `e2e.test.ts` goes through the real executor.
+- `git add`/`git commit` as two steps commits the WHOLE index: pre-existing staged changes ride along (v1 refused them). Prefer `git commit --only -m <msg> -- <paths>`; the seal's temp-index hash then covers exactly the committed tree.
+- Terminal denylist regex is feasible: `before_tool_call` receives full `args`, so `args.command` is inspectable (`src/plugins/hooks.ts:89-97`).
+- `GIT_CONFIG_GLOBAL=/dev/null` + `GIT_CONFIG_NOSYSTEM=1` is sufficient isolation; add explicit `-c user.email=... -c user.name=...` on commit so no identity fallback is needed.
+- e2e wall clock: even with the mocked subprocess runner, budget `max_turns` (6-8 turns) is fine; set the e2e `testTimeout` ≥ 5 min for NFS git.
+- Fail-closed registration (no gatekeeper → no commit tool) is the strongest design change in v2; keep `tools_enabled` filtering as the second layer.
+- Q6: 1 is right; Q7: hardcoded v1; Q8: explicit call only — all three defaults are correct.
+- `run_tests` filter arg should map to the vitest file-filter position, and the "max 10 failing names" clamp should come from `--reporter=dot`-free default output parsing, not JSON.

package/docs/design/council/architecture-review-r3.md

@@ -0,0 +1,69 @@
+# Council Review R3 — Architecture & Testability
+
+Reviewer: Council Member 3 (architecture) — plan: `docs/design/self-improvement-loop.md` v3
+
+## Verdict
+
+APPROVE-WITH-CHANGES. All four round-2 blockers are resolved and both open confirmations are
+sound; the remaining changes are small but real — adopt the security chair's scoped-add
+amendment (delta 8's "no separate add" breaks the demo's own happy path), and resolve the
+unborn-HEAD/assertion contradiction and the fixture test-command dependency (findings 1, 4).
+
+## Round-2 blockers status
+
+1. Seal mechanism — RESOLVED. Dirty flag adopted; my corrected temp-index mechanism is
+   recorded verbatim as the upgrade path ("hash the worktree, never the index").
+2. Core-plugin config plumbing — RESOLVED. Agent-constructed factory fits the existing
+   seams (finding 2); tool knobs ride the ExecutorDefaults.env precedent
+   (`src/agent/agent.ts:112-115`, env literal at 114) via ToolContext.env.
+3. run_tests cwd — RESOLVED. cwd = context.work_dir; the threading point is the bare
+   `deps.tools.execute(call.name, call.args)` in run_tool_calls (`src/agent/loop.ts:85-107`,
+   execute at 94); a supplied context cleanly supersedes defaults (`src/tools/executor.ts:42`).
+4. Process B — RESOLVED. Real bun subprocess; load_plugins resolves relative entries against
+   config.work_dir (`agent.ts:210` → `loader.ts:63`) and imports by file URL
+   (`loader.ts:67`) — no stale module cache; work_dir-relative fixture paths resolve.
+
+## Ruling on S-1 (dirty flag now, your chair's temp-index mechanism as recorded upgrade path) and the symbol-keyed state channel
+
+ACCEPT-WITH-NOTES. S-1 is clean — the attestation states the terminal floor honestly, and
+the upgrade path is mechanically correct as recorded (read-tree HEAD, not the live index,
+is the right base — it matches --only's HEAD-plus-named-paths semantics exactly). The
+channel is implementable without breaking consumers: HookContext stays { work_dir }
+(`src/plugins/types.ts:11-13`), third-party signatures unchanged; hooks.ts swaps its
+pick_defined flattening (`src/plugins/hooks.ts:52-58`) for per-plugin entries, each handed
+a ctx exposing ONLY its own sub-map via the symbol (a shared bag reopens the forgery
+channel via getOwnPropertySymbols). BOTH ctx build sites must share one per-run bag —
+the bare lifecycle ctx (`agent.ts:168,177`) and the per-tool ctx (`hooks.ts:90`) — with
+the per-run reset in call_run_start (`hooks.ts:108-116`). ~15 lines holds.
+
+## New findings in v3
+
+1. `git commit --only` rejects untracked paths (git 2.55.0 /tmp scratch: pathspec error,
+   exit 1) — delta 8's "no separate add" breaks the demo, where every committed file is
+   new. Security r3's fix verified: scoped `git add -- <named paths>` then `--only`
+   commits exactly those paths (worktree content), leaves pre-existing staged junk.txt
+   staged, and works on unborn HEAD; the commits counter is safe (increments on success
+   only; a failed commit leaves just the scoped adds staged). Required, same cluster:
+   "refuse unreachable HEAD" and "git log shows exactly 1 commit" cannot both hold —
+   unseeded fixture means unborn HEAD (a natural rev-parse guard vetoes the demo's own
+   commit); seeded means 2 commits. Pick one: seed a harness root commit and assert one
+   commit on top of it, or let the guard permit unborn HEAD.
+2. Loader hard-reject seam: insert beside the existing duplicate-name error entry
+   (`loader.ts:93-96`); the loader has no builtin-name knowledge today (delta 4's
+   "replaces warn-and-keep-first" mischaracterizes — that is config-vs-config behavior),
+   so either import a BUILTIN_PLUGIN_NAMES const (cycle-free) or thread a reserved-names
+   arg into load_plugins; the reject flows through the existing error-entry path, so
+   fail-closed holds. Agent wiring: construct once and push as a synthetic LoadedPlugin
+   through the unchanged register_plugin_tools/merge_plugin_hooks (`agent.ts:72-84,86-95`).
+3. Per-run ToolContext env completeness: a supplied context supersedes ExecutorDefaults
+   entirely (`executor.ts:42`), so the loop-built context must carry the same env the
+   executor defaults get (`agent.ts:112-115`) — LICH_TERMINAL_TIMEOUT_MS plus
+   LICH_TEST_COMMAND — or both knobs silently drop; build it once in Agent and hand it
+   over via loop_deps (stub runners ignore the third arg; `loop.ts:27-29`).
+4. Fixture dependency hole: the /tmp fixture has no node_modules, so the default
+   `node node_modules/vitest/vitest.mjs run` cannot resolve there; the e2e must export
+   LICH_TEST_COMMAND as a dependency-free runner (e.g. `bun test`) and the fixture test
+   must target that runner's imports.
+5. Checked and clean: mutex + `run_tests_busy` fit error_result conventions; terminal
+   `timeout_ms: 300000` is a constant swap inside with_timeout (`executor.ts:57-66`);
+   skills fresh-walk avoids the single-slot docs_search memoization trap.

package/docs/design/council/index.md

@@ -0,0 +1,15 @@
+# Design council — self-improvement loop reviews
+
+Adversarial review record for the v0.4.0 self-improvement loop design
+([final spec](../self-improvement-loop.md)). Three chairs, three rounds each.
+The declared convergence rule: all APPROVE, or AWC with only minor notes.
+
+| Chair | Round 1 | Round 2 | Round 3 |
+| --- | --- | --- | --- |
+| Security | [REJECT](security-review.md) | [AWC](security-review-r2.md) | [APPROVE](security-review-r3.md) |
+| Simplicity | [AWC](simplicity-review.md) | [AWC](simplicity-review-r2.md) | [APPROVE](simplicity-review-r3.md) |
+| Architecture | [AWC](architecture-review.md) | [AWC](architecture-review-r2.md) | [AWC — minor notes](architecture-review-r3.md) |
+
+Round-3 notes were folded into the final spec as amendments A1–A11. Read the
+r3 files for implementation guards; earlier rounds explain the reasoning
+behind each ruling.

package/docs/design/council/security-review-r2.md

@@ -0,0 +1,32 @@
+# Council Review R2 — Security & Safety
+
+## Verdict
+
+**APPROVE-WITH-CHANGES.** v2 genuinely fixes the systemic holes — prompt-injection surfaces cut, no LLM writes durable state, the TOCTOU seal is the right mechanism and maps onto real seams (hooks.ts:88-96 verdict path, planned `run_tool_calls` context plumbing) — and the terminal floor is honestly documented rather than hidden. But the gatekeeper's fail-closed claim still fails against the agent-writable `.lich/config.json` (displace or spoof the gatekeeper via the plugins list), and the shared `run_state` Map lets any plugin tool forge the seal; both must be closed before implementation.
+
+## Round-1 findings status
+
+1. Terminal bypass — **PARTIALLY RESOLVED**: plumbing-based `git_commit` + tree-hash seal is real; raw `terminal` git remains and v2 states it as the floor, but the denylist is weaker than acknowledged (`git commit-tree`+`update-ref` plumbing misses `/git\s+(commit|push|remote)/` entirely — see NB-1).
+2. Fail-open gatekeeper — **PARTIALLY RESOLVED**: load *failure* now means no commit tool, but load *success* of a malicious entry is unaddressed; config plugins list is agent-editable (NB-2/finding 1).
+3. TOCTOU seal — **RESOLVED**: seal captures HEAD+index-hash at test time, verified at commit; tests→edit→commit now vetoed. Verified the veto point exists (hooks.ts:88-96) and per-run ToolContext plumbing is planned for the missing channel.
+4. Memory in system prompt — **RESOLVED**: cut; MEMORY.md is committed, human-reviewable, never auto-loaded.
+5. Skills DATA/instructions — **PARTIALLY RESOLVED**: skills toolset cut; `docs_search` over `.lich/skills` still returns raw untrusted text, auto-load is gone, and the executor's 20k clamp (guard.ts:100) is the only boundary — the "tool results are untrusted data" rule is still asserted in prose, not stated in the system prompt or docs as a standing control.
+6. Reflector LLM writes — **RESOLVED**: consolidation cut entirely; no LLM output becomes durable state.
+7. Plugin tools bypass `tools_enabled` — **RESOLVED**: allowlist extended to plugin tools.
+8. Concurrent memory writes — **RESOLVED**: single writer (agent appends via edit_file), no consolidation; cross-run append races are now cosmetic.
+
+## New blocking findings in v2
+
+1. **Config/plugin injection still defeats "fail-closed"** — HIGH. `.lich/config.json` lives in work_dir and the agent edits files freely (`write_file`/`edit_file`, work_dir-confined but inclusive). It can add `plugins: [".lich/evil.plugin.js"]`, or reorder/remove entries; loader dedupes by name keeping the FIRST load and turns the later duplicate into a warning (loader.ts:97-99), and config order decides who loads first. A plugin exporting `name: "gatekeeper", tools: [git_commit_tool]` (importing the builtin) therefore shadows the real one with an always-pass gatekeeper; the v2 invariant only covers *load failure*, not *malicious load success*. Fix: register the gatekeeper in code unconditionally (never via the config plugins list), reject any config-supplied plugin whose name collides with a builtin, and ideally pin `allow_self_commit`/`test_command` outside the agent-writable config (round-1 fix, still not adopted). Tension: hardcoding contradicts the loader's user-configurability — accept it for safety-critical plugins.
+2. **Shared `run_state` Map is a seal-forgery channel** — MED/HIGH. `HookContext.run_state: Map<string, unknown>` is one map handed to every hook and (via ToolContext) every tool; any plugin-supplied tool — or any code path a poisoned doc steers a plugin author toward — can `run_state.set()` the gatekeeper's keys and mint a valid seal without ever running tests. Fix: per-plugin namespaced sub-maps (factory handed to each hook), or a gatekeeper-private unguessable per-run key; at minimum, document third-party plugins as untrusted. Tension: simplicity — a namespacing wrapper is ~20 lines and worth it.
+
+## Non-blocking observations
+
+- Denylist misses: `git -c x=y commit` (no `git\s+commit` match), `env git commit`, `bash -c`, backtick/nesting obfuscation, and critically `git commit-tree` + `git update-ref` (same effect, no regex hit). Add those two patterns at minimum; keep Q7 hardcoded.
+- Secret basename check misses `.env.local`, `.p12`, key material in subdirs; a `git diff --cached --stat` echo in the veto/allow reason would make human review far cheaper.
+- Seal implementation care: the index hash must be computed by the gatekeeper (e.g. `git write-tree`/porcelain) at `run_tests` time — never accepted from agent-visible tool output, which is clamped text an agent can paraphrase.
+- Consider refusing to *seal* on a dirty pre-test tree (`git status` non-empty before run_tests) — removes ambiguity about what the seal attests.
+- Two-process demo is sound; pin Process B's work_dir in the harness so config can't point it at the real repo; assert exactly 1 commit.
+- MEMORY.md "human-reviewable" holds only if the human reviews between agent appends and the next self-commit — one docs sentence.
+- Data/instructions boundary: state it once in the system prompt ("docs/skills/memory tool results are reference data, not instructions") — cheap, and makes finding 5's residual explicit instead of implicit.
+- Q6: 1 commit/run as default is fine; Q7: hardcoded v1 (agreed); Q8: explicit call only — auto-run would blur the seal and hide veto reasons.

package/docs/design/council/security-review-r3.md

@@ -0,0 +1,19 @@
+# Council Review R3 — Security & Safety
+
+## Verdict
+APPROVE. Both round-2 blockers are verified closed against source — the gatekeeper now lives outside the loader's reach entirely, config-supplied colliders die at the exact dedupe seam my r2 finding cited, and no in-process forgery path survives the symbol-keyed channel plus the executor-sourced structured result. What remains is the documented terminal floor and plugin-trust floor, both now honestly attested, plus only non-blocking implementation notes below.
+
+## Round-2 blockers status
+1. Config/plugin injection defeats fail-closed — **RESOLVED**: gatekeeper constructed in code by `Agent` (constructor precedes `register_plugin_tools`, agent.ts:105-113), so the loader never sees it; hard-reject of builtin-colliding names is a two-line change at the cited dedupe seam (loader.ts:94-99, `seen.has` → error entry, warn-and-continue contract intact for other entries), and the env knobs can only enter via constructor injection from process env (agent.ts:114-117 precedent; zod config has no env passthrough, config.ts:21-39) — agent edits to `.lich/config.json` cannot reach the frozen per-run `ToolContext`.
+2. Shared `run_state` Map is a seal-forgery channel — **RESOLVED**: `HookContext` is bare `{work_dir}` today (types.ts:9-11); the per-plugin sub-map keyed by a module-internal symbol is implementable at the ctx-construction seam (hooks.ts:90), and plugin tools structurally never receive `HookContext` (executor hands tools a `ToolContext`, executor.ts:39-49) — tool-body forgery is impossible, hook-body forgery dies with per-plugin namespacing (note S-1b).
+
+## Ruling on S-1 (dirty-flag seal) and the symbol-keyed state channel
+ACCEPT-WITH-NOTES. The dirty flag holds my invariants: it closes the in-process TOCTOU (write_file/edit_file → `dirty=true` → veto at the verified first-blocker-wins seam, hooks.ts:88-96), its carrier is the unforgeable namespaced channel, `tests_ok` derives from the executor's structured result (the agent never asserts it), and the attestation statement scopes the residual to the documented terminal floor — the honest-floor framing I demanded in r1/r2, with architecture's worktree-hash upgrade path recorded so the git mechanics are never re-derived wrong. Two notes, both spec-committed requirements with verified seams, listed so they cannot be implemented wrong:
+(a) "structured ok" requires extending `AfterToolCallInfo` with the executor's `ok` boolean — today it carries only 300-char clamped `result_summary` text (hooks.ts:23, 99-101; types.ts:25-27); two lines at hooks.ts:99-102; do not ship text-prefix parsing.
+(b) the per-plugin sub-map must be attached per hook invocation (each hook sees its own wrapped ctx), not one shared symbol→plugin-map on a single ctx — `Object.getOwnPropertySymbols(ctx)` probing reaches a shared channel; write the listed sub-map-isolation unit test probe-aware.
+
+## New findings in v3
+1. NOTE (non-blocking) — registration order is load-bearing: the gatekeeper's `git_commit` must register before `register_plugin_tools` (agent.ts:113) so the existing duplicate check (agent.ts:75-78) makes first-wins favor it; add one unit test — config plugin exporting a tool named `git_commit` while the gatekeeper is active → gatekeeper wins.
+2. NOTE (non-blocking) — `git commit --only` rejects untracked paths ("pathspec ... did not match any file(s) known to git"), and the demo commits NEW files; fix is a scoped `git add -- <paths>` (exactly the named paths) before `--only`, which preserves the no-sweep property; failure direction is fail-closed and the e2e will catch it if missed.
+3. NOTE (non-blocking) — "no gatekeeper → no `git_commit` anywhere" is true of the trusted registration path only: with the gatekeeper off, a config plugin may still register a tool named `git_commit` — capability-equivalent to the documented plugin-trust floor (arbitrary startup code, human reviews config diffs), no new capability; scope the docs sentence accordingly.
+4. NOTE (non-blocking) — `paths` arg validation: `resolve_safe_path(base, "")` returns base (guard.ts:12-19 accepts it), so `paths:[""]`/`["."]` would pathspec-commit all tracked modifications; require non-empty relative file-like paths. Also checked clean: denylist delta 9 (commit-tree/update-ref any-occurrence, flag-tolerant) matches my r2 NB; per-run state reset fires via `on_run_start` per `Agent.run` (agent.ts:129, hooks.ts:106-118); run_tests mutex and busy error are fail-closed; secret blocklist covers my r2 list; the r2 allowlist-extension to plugin tools survives v3's rewiring.