@inharness-ai/claude4spec 1.0.20 → 1.0.22

package/.claude/skills/c4s-brief-implementer/SKILL.md

@@ -10,10 +10,10 @@ This skill describes how to implement a release brief in **your code repository*
 `.claude4spec/briefs/` that captures everything you need to ship the change:
 entity snapshots, section diffs, narrative, acceptance criteria.
 
-**This skill does NOT assume the `c4s` CLI is installed.** Briefs are designed
-to be self-contained — you do not need to read the main specification or query
-the entity database. If the brief references something you cannot find in its
-body, treat that as drift and file a patch (step 4 below).
+Briefs are self-contained, so you do **not** need the `c4s` CLI installed, and
+you do **not** read the main specification or query the entity database. If a
+brief references something you cannot find in its body, treat that as drift and
+file a patch (step 6).
 
 ## Workflow
 
@@ -25,9 +25,9 @@ cat .claude4spec/briefs/<slug>.md
 ```
 
 If `.claude4spec/` is not in your current directory, walk up the directory tree
-until you find it (similar to how git finds `.git/`).
+until you find it (like git finds `.git/`).
 
-### 2. Read the brief as self-contained input
+### 2. Read the brief
 
 Every brief has YAML frontmatter:
 
@@ -41,61 +41,105 @@ implemented: false
 ---
 ```
 
-The body contains everything you need — entity snapshots, section diffs, the
-narrative of what changes, and acceptance criteria. **Do not read the main
-specification.**
+The body has everything you need — entity snapshots, section diffs, narrative,
+and acceptance criteria.
 
-If the brief is unclear — a missing detail, an ambiguous wording, a decision
-you'd otherwise have to guess — you have two paths:
+If the brief is unclear (missing detail, ambiguous wording, a decision you'd
+otherwise guess), you have two paths:
 
-**Synchronous (preferred when available).** Ask the specification agent in the
-same terminal and continue once you have an answer:
+**Synchronous (preferred when available).** Ask the spec agent and continue once
+you have an answer. The CLAUDE 4 SPEC spec lives at `.claude/skills/specyfikacja`
+(a symlink), not at the repo root — always point to it with `--project`; do
+**not** `cd` into it, or `c4s` reports `PROJECT_NOT_FOUND`.
 
 ```bash
-c4s ask "Brief nie precyzuje X — czy chodzi o A czy B?" --ct brief --brief <brief-slug>.md
+c4s ask "Brief doesn't specify X — is it A or B?" --ct brief --brief <brief-slug>.md --project .claude/skills/specyfikacja
 ```
 
 Continue the same thread with `c4s ask "..." --thread <threadId>` (the
-`threadId` is printed with the answer). This path requires `c4s` installed
-*and* a running `npx claude4spec` server. When either is unavailable, skip it.
+`threadId` is printed with the answer). This requires `c4s` installed *and* a
+running `npx claude4spec` server; skip it when either is unavailable.
 
-If `c4s ask` returns `PROJECT_NOT_FOUND` despite a running server, your cwd is
-probably reached through a **symlink** (common for `.claude/skills/<name>`
-projects): `c4s` resolves `process.cwd()` to the real path, which is NOT the one
-registered in `~/.claude4spec/workspaces.json`. Pass the registered (symlink) path
-explicitly — `--project` is run through `path.resolve`, which does NOT canonicalize
-symlinks, so it matches the registry:
+**Asynchronous (always available).** If you cannot ask synchronously, proceed
+with your best judgement and file a patch afterwards (step 6) so the spec-author
+can fold the clarification into the next brief.
+
+### 3. Isolate work (worktree + fresh branch)
+
+Never implement a brief on top of your current checkout. Branch from a **fresh
+`main`** and work in a dedicated git worktree under **`./.worktrees/<brief-slug>`**
+(that directory is git-ignored, so the nested checkout never shows up in the
+main repo's `git status`):
 
 ```bash
-c4s ask "Brief nie precyzuje X — ..." --ct brief --brief <brief-slug>.md --project /abs/path/to/registered/skill-dir
+git fetch origin
+git worktree add .worktrees/<brief-slug> -b brief/<brief-slug> origin/main
+cd .worktrees/<brief-slug>
 ```
 
-**Asynchronous (always available).** If you cannot ask synchronously, proceed
-with your best judgement and file a patch afterwards (step 4) so the
-spec-author can fold the clarification into the next brief.
+- Branch name `brief/<brief-slug>` mirrors the repo's `feat/…` convention.
+- If `origin` is not configured, branch from local `main`: `git checkout main &&
+  git pull`, then `git worktree add .worktrees/<brief-slug> -b brief/<brief-slug> main`.
 
-### 3. Implement
+**Copy the spec into the worktree.** The smoke test (step 5) runs the dev server
+against the CLAUDE 4 SPEC spec, but `.claude/skills/specyfikacja` is a **symlink**
+to a *separate* repo and is git-ignored — a fresh worktree checkout doesn't contain
+it at all. Pointing the dev server at the real symlinked dir also risks **mutating
+the canonical docs/db**. So make a disposable copy inside the worktree, dereferencing
+the symlink:
 
-Standard code flow in your target repository: read existing code, plan, edit,
-test. Stay focused on what the brief specifies.
+```bash
+# -L follows the symlink so the worktree gets REAL files, not a dangling relative
+# link (a verbatim copy would point outside the worktree and break). The dest path
+# is git-ignored, so the copy stays out of `git status` and `git worktree remove`
+# discards it together with the worktree.
+mkdir -p .claude/skills
+cp -RL ../../.claude/skills/specyfikacja .claude/skills/specyfikacja
+```
 
-### 4. Feedback loop (patches)
+- `../../` from the worktree root (`.worktrees/<brief-slug>`) reaches the main repo
+  root, where the live symlink lives.
+- If the source symlink is absent (no private spec repo checked out locally), skip
+  this copy and the synchronous smoke test, and rely on unit tests — same as the
+  "skip when unavailable" rule for `c4s ask` in step 2.
 
-When you discover that the brief diverges from reality — a missing detail, an
-incorrect assumption, an edge case not covered, or anything else the
-spec-author should know — write a patch file:
+### 4. Implement
 
-```sh
-mkdir -p .claude4spec/patches
+Standard code flow: read existing code, plan, edit, test. Stay focused on what
+the brief specifies. Commit your work on the `brief/<brief-slug>` branch.
+
+### 5. Smoke-test locally
+
+Before opening the PR, launch the app and exercise the change — don't hand off on
+green unit tests alone.
+
+```bash
+# Run the CLI via `npx tsx` (NOT `npm run dev:sandbox`, which uses `tsx watch`).
+# In a worktree whose node_modules symlinks OUTSIDE the worktree, `tsx watch`
+# follows the symlink, sees Vite's .vite-temp/*.timestamp churn, and restarts in
+# an infinite loop. Plain `npx tsx` (no watch) avoids it.
+npx tsx src/bin/claude4spec.ts --mode dev --cwd .claude/skills/specyfikacja --pages . --port 5555
 ```
 
-Create `.claude4spec/patches/<brief-slug>-<short-desc>.md` with this format:
+- `--cwd .claude/skills/specyfikacja` points at the **worktree's local copy** made
+  in step 3 — *not* the symlinked source. So a crash or db write during the smoke
+  test can never damage the real specification.
+- **Port 5555 is our test convention.** If it's taken (`EADDRINUSE`), increment —
+  `--port 5556`, `5557`, … — until one is free.
+- Open the printed URL, verify the brief's behaviour, then stop the server
+  (Ctrl-C). If the smoke test reveals drift, file a patch (step 6).
+
+### 6. Feedback loop (patches)
+
+When the brief diverges from reality — a missing detail, an incorrect assumption,
+an edge case not covered, or anything else the spec-author should know — write a
+patch file `.claude4spec/patches/<brief-slug>-<short-desc>.md`:
 
 ```markdown
 ---
 type: patch
 brief: v0-1-16-to-v0-1-17.md      # path relative to briefs/
-patch_kind: drift                  # drift | missing | incorrect | clarification
+patch_kind: drift
 created_at: 2026-05-11T17:32:00Z
 created_by: claude-code            # or "cursor", "aider", ...
 ---
@@ -111,40 +155,56 @@ created_by: claude-code            # or "cursor", "aider", ...
 …what the spec-author should consider in a follow-up brief or entity edits…
 ```
 
-Patch-kind values:
+`patch_kind` values:
 
 - `drift` — the brief described behavior X, but the codebase already does Y.
 - `missing` — the brief is silent on a detail you had to decide yourself.
 - `incorrect` — the brief is factually wrong about existing code.
 - `clarification` — the brief is ambiguous; you guessed but it should be made
-  explicit for next time.
+  explicit next time.
 
-The `.claude4spec/patches/` directory is created **lazily** — only when you
-file your first patch. The claude4spec server does NOT create it.
+Create `.claude4spec/patches/` lazily — only when you file your first patch
+(`mkdir -p .claude4spec/patches`). The claude4spec server does NOT create it.
 
-### 5. Mark brief as implemented
+### 7. Open a draft PR and STOP
 
-When the implementation is genuinely finished — code committed, tests green,
-merged to main / accepted by the user — flip the brief's frontmatter to
-`implemented: true`:
+Push the branch and open a **draft** PR against `main`, then hand off:
 
 ```bash
-# Option A — Edit tool: change the line `implemented: false` → `implemented: true`.
-# Option B — yq (idempotent; adds the field to legacy briefs that never had it):
-yq -i '.implemented = true' .claude4spec/briefs/<brief-slug>.md
+git push -u origin brief/<brief-slug>
+gh pr create --draft --base main \
+  --title "<brief-slug>: <short title>" \
+  --body "Implements brief .claude4spec/briefs/<brief-slug>.md
+
+<one-paragraph summary of what changed + how it was tested>"
 ```
 
-`implemented: true` is a **declaration**, not a computed fact derived from git.
-A revert on main does NOT roll the flag back. Set it ONLY when implementation
-is realistically done — never proactively or "just in case".
+**Do NOT run `gh pr merge`.** Review and merge are the human's call. Stop here and
+report the PR URL.
+
+### 8. Mark brief as implemented
+
+`implemented: true` is a **declaration**, set ONLY after the draft PR is reviewed
+and merged to main (or otherwise accepted) — never at PR-open time, never
+proactively, and a later revert on main does NOT roll it back. When implementation
+is genuinely done (code merged, tests green), flip the frontmatter:
+
+```bash
+# Option A — Edit tool: change `implemented: false` → `implemented: true`.
+# Option B — yq (idempotent; adds the field to legacy briefs that lack it):
+yq -i '.implemented = true' .claude4spec/briefs/<brief-slug>.md
+```
 
-### 6. Hand-off
+### 9. Hand-off
 
-The spec-author reads patches manually (`ls .claude4spec/patches/`, `cat`)
-and folds them into the next brief or entity edits. There is no UI listing in
-this release — patches are raw markdown.
+The spec-author reads patches manually (`ls .claude4spec/patches/`, `cat`) and
+folds them into the next brief or entity edits. There is no UI listing in this
+release — patches are raw markdown.
 
 ## Notes
 
-This file is **fully managed** by claude4spec — it is overwritten on every
-server start when its rendered content changes. Do not edit it by hand.
+This is a **base skill** generated by claude4spec, customized for this project.
+The base copy covers reading briefs and asking the c4s agent questions; this copy
+under `.claude/skills/` additionally pins our git/PR flow (worktree → fresh branch
+→ draft PR → stop). It is **yours to edit** — nothing overwrites it. (The
+`.claude4spec/skills/` copy *is* refreshed on server start; this one is not.)

package/CHANGELOG.md

@@ -5,6 +5,29 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.22] - 2026-06-27
+
+### Added
+- **Published Host API types.** The CLI package now ships TypeScript declarations under type-only subpaths `@inharness-ai/claude4spec/plugin-runtime` and `@inharness-ai/claude4spec/plugin-runtime/ui`, plus an ambient binding (`@inharness-ai/claude4spec/plugin-runtime/ambient`) so a single reference types both the `@c4s/plugin-runtime` value specifier and all type names. Plugin authors reference the host's published types directly instead of vendoring a `c4s-runtime.d.ts` copy. `hostApiVersion` is unchanged — this is additive DX infrastructure. (brief 0.1.85→0.1.86)
+- **Host UI Kit** (`@c4s/plugin-runtime/ui`, M34/L12) — a presentational component catalog delivered to plugins through the import-map shim: four `stable` core components (`EntityListHeader`, `DetailPanelShell`, `FieldRow`, `FieldGrid`) whose prop contracts are part of the versioned surface, plus experimental list/action/form components and a token bridge.
+- **M33 plugin system (phase 3)** — the database-table entity now ships as the preinstalled `@inharness-ai/c4s-plugin-simple-database-tables` plugin; workspace-tier plugin frontend serving behind a trust gate; a plugin page-routing contract; per-plugin Settings and editor-command hot-reload.
+
+### Fixed
+- The preinstalled database-table plugin was referenced under a non-existent unscoped name; corrected to the published scoped `@inharness-ai/c4s-plugin-simple-database-tables` so a registry install resolves.
+- Workspace plugin frontend was dropped when the install name differed from the package's `package.json` name.
+
+## [1.0.21] - 2026-06-22
+
+### Added
+- Transagents — agents can now delegate work to nested child threads. A new `TransagentDispatcher` and `transagent-tools` MCP server manage parent→child thread relationships (migration `041`), and the client renders child activity in a dedicated `TransagentPanel` inside `ChatOverlay`, with `useChat` tracking child-thread start/complete state.
+- Pagination and summary options for the `release-tools` MCP server — `release_list` and `release_show` accept `limit`/`offset`, and `release_diff` gains a `summaryOnly` mode that returns a light delta map (identifiers + operation types only, no full snapshots).
+
+### Changed
+- `c4s-brief-implementer` skill now documents pointing `c4s ask` at the symlinked spec dir via `--project .claude/skills/specyfikacja` (and warns against `cd`-ing into it, which resolves to the real path → `PROJECT_NOT_FOUND`).
+
+### Fixed
+- Chat thread-list over-fetch and frontend refetch storm. Server-side, `listThreads`/`forBrief`/`forPatch` drop the `LEFT JOIN chat_message + GROUP BY` (which aggregated `COUNT` over the full message table before `LIMIT`) for a correlated indexed `COUNT` subquery and a shared column list that omits the large `initial_system_prompt` blob — ~1962ms → ~10ms on a 506-thread/37k-message DB. `entity-indexer.indexAll` now rebuilds inside one transaction (~2s → ~117ms). Frontend uses a single shared `ThreadListProvider` with an in-flight guard, pagination, and a light `/entities/counts` aggregate replacing five full entity-list fetches.
+
 ## [1.0.20] - 2026-06-19
 
 ### Added
@@ -214,6 +237,7 @@ Initial public release.
 - Acceptance Criteria entity and tooling.
 - Briefs and patches workflow for spec-driven implementation.
 
+[1.0.21]: https://github.com/InHarness/claude4spec/compare/v1.0.20...v1.0.21
 [1.0.20]: https://github.com/InHarness/claude4spec/compare/v1.0.19...v1.0.20
 [1.0.19]: https://github.com/InHarness/claude4spec/compare/v1.0.18...v1.0.19
 [1.0.18]: https://github.com/InHarness/claude4spec/compare/v1.0.17...v1.0.18
@@ -233,3 +257,5 @@ Initial public release.
 [1.0.4]: https://github.com/InHarness/claude4spec/compare/v1.0.3...v1.0.4
 [1.0.3]: https://github.com/InHarness/claude4spec/compare/v1.0.2...v1.0.3
 [1.0.2]: https://github.com/InHarness/claude4spec/compare/v1.0.1...v1.0.2
+
+[1.0.22]: https://github.com/InHarness/claude4spec/compare/v1.0.21...v1.0.22

package/dist/bin/c4s/commands/agent.d.ts

@@ -0,0 +1,18 @@
+import type { ParsedArgs } from '../args.js';
+/**
+ * `c4s agent` — generic synchronous agent turn over any thread context (M11).
+ *
+ * The verbose, developer-facing surface: defaults to `output: 'full'`, so it
+ * prints every message of the turn (assistant text + reasoning + tool rows)
+ * before the final answer. Cienki wrapper nad `runAgent(...)`; warstwa CLI to
+ * parsowanie flag, mapowanie kodow bledow na `CliError`, formatowanie outputu.
+ *
+ *   c4s agent "<msg>" --ct chat
+ *   c4s agent "<msg>" --ct ask                 # read-only peer consult
+ *   c4s agent "<msg>" --ct brief --brief <path>
+ *   c4s agent "<msg>" --thread <id>            # continue (—ct not needed)
+ *
+ * The terse peer-consult shorthand lives in `ask.ts` (hardcodes --ct=ask,
+ * output: 'final').
+ */
+export declare function runAgentCmd(args: ParsedArgs): Promise<void>;

package/dist/bin/c4s/commands/agent.js

@@ -0,0 +1,102 @@
+import { optionalString } from '../args.js';
+import { CliError } from '../errors.js';
+import { AgentError, runAgent, } from '../../../core/agent/run-agent.js';
+/**
+ * `c4s agent` — generic synchronous agent turn over any thread context (M11).
+ *
+ * The verbose, developer-facing surface: defaults to `output: 'full'`, so it
+ * prints every message of the turn (assistant text + reasoning + tool rows)
+ * before the final answer. Cienki wrapper nad `runAgent(...)`; warstwa CLI to
+ * parsowanie flag, mapowanie kodow bledow na `CliError`, formatowanie outputu.
+ *
+ *   c4s agent "<msg>" --ct chat
+ *   c4s agent "<msg>" --ct ask                 # read-only peer consult
+ *   c4s agent "<msg>" --ct brief --brief <path>
+ *   c4s agent "<msg>" --thread <id>            # continue (—ct not needed)
+ *
+ * The terse peer-consult shorthand lives in `ask.ts` (hardcodes --ct=ask,
+ * output: 'final').
+ */
+export async function runAgentCmd(args) {
+    const message = args.positional[0];
+    if (!message || !message.trim()) {
+        throw new CliError('INVALID_ARGS', 'message is required: c4s agent "<msg>" --ct chat');
+    }
+    const threadId = optionalString(args, 'thread');
+    const ct = optionalString(args, 'ct');
+    const briefPath = optionalString(args, 'brief');
+    const server = optionalString(args, 'server');
+    const project = args.project;
+    const workspace = args.workspace;
+    if (project && server) {
+        process.stderr.write('warning: both --project and --server given; --server wins, --project ignored\n');
+    }
+    if (!threadId) {
+        // Early CLI-level validation (livelier hints); runAgent re-validates at the
+        // library layer.
+        if (ct !== 'chat' && ct !== 'brief' && ct !== 'patch' && ct !== 'ask') {
+            throw new CliError('INVALID_ARGS', '--ct must be chat|brief|patch|ask (or pass --thread <id> to continue a thread)');
+        }
+        if (ct === 'patch') {
+            throw new CliError('INVALID_ARGS', 'c4s agent cannot create a patch thread; pass --thread <id> to continue one');
+        }
+        if (ct === 'brief' && !briefPath) {
+            throw new CliError('INVALID_ARGS', '--ct brief requires --brief <path>');
+        }
+    }
+    let result;
+    try {
+        result = await runAgent({
+            message,
+            project,
+            workspace,
+            server,
+            contextType: ct,
+            threadId,
+            briefPath,
+            output: 'full',
+        });
+    }
+    catch (err) {
+        if (err instanceof AgentError) {
+            throw new CliError(err.code, err.message, err.hint);
+        }
+        throw err;
+    }
+    // --- output --------------------------------------------------------------
+    if (args.format === 'text') {
+        // Verbose: every message of the turn (text + reasoning + tool rows), then
+        // the final answer; threadId hint on stderr.
+        for (const m of result.messages ?? []) {
+            process.stdout.write(formatMessage(m) + '\n');
+        }
+        process.stdout.write('\n' + result.answer + '\n');
+        process.stderr.write(`thread: ${result.threadId} (continue: c4s agent "..." --thread ${result.threadId})\n`);
+    }
+    else {
+        process.stdout.write(JSON.stringify({ threadId: result.threadId, answer: result.answer, messages: result.messages ?? [] }, null, 2) + '\n');
+    }
+}
+/** Render one turn message for the verbose text output. */
+function formatMessage(m) {
+    const label = m.toolName ? `${m.role}/${m.toolName}` : m.role;
+    const prefix = m.subagentTaskId ? `[${label} · sub]` : `[${label}]`;
+    return `${prefix} ${extractText(m.content)}`;
+}
+/**
+ * Reasoning + some tool rows persist `content` as `JSON.stringify({ text, ... })`.
+ * Unwrap the `text` field for display; fall back to the raw string otherwise.
+ */
+function extractText(content) {
+    try {
+        const parsed = JSON.parse(content);
+        if (parsed && typeof parsed === 'object' && typeof parsed.text === 'string') {
+            return parsed.thinking ? `(reasoning) ${parsed.text}` : parsed.text;
+        }
+    }
+    catch {
+        /* not JSON — raw content below */
+    }
+    return content;
+}
+//# sourceMappingURL=agent.js.map

package/dist/bin/c4s/commands/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../../src/bin/c4s/commands/agent.ts"],"names":[],"mappings":"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"}

package/dist/bin/c4s/commands/ask.d.ts

@@ -1,15 +1,16 @@
 import type { ParsedArgs } from '../args.js';
 /**
- * `c4s ask` — synchroniczny kanal Q&A z agentem specyfikacji (M11).
+ * `c4s ask` — read-only peer-consult shorthand (M11 / 0.1.79).
  *
- * Cienki wrapper nad `runAsk(...)` z `core/ask/run-ask.ts`. Wspolne ciezary
- * (resolve project, health-check, create-thread, run-turn) zyja w core'rze;
- * tutaj zostala tylko warstwa CLI: parsowanie flag, mapowanie kodow bledow
- * na `CliError`, formatowanie outputu (stdout/stderr split, --format json|text).
+ * Narrowed alias of `c4s agent`: hardcodes `contextType='ask'` and
+ * `output: 'final'` (terse `{ threadId, answer }`). It is the canonical
+ * peer-consult shorthand and the CLI twin of the MCP `ask` tool — the peer
+ * answers read-only, never mutating its own spec. `--ct` / `--brief` are
+ * rejected (use `c4s agent` for other contexts).
  *
- *   c4s ask "<msg>" --ct chat
- *   c4s ask "<msg>" --ct brief --brief <path>
- *   c4s ask "<msg>" --thread <id>
+ *   c4s ask "<msg>"                 # consult the peer for the cwd's project
+ *   c4s ask "<msg>" --project <p>   # consult a specific peer
+ *   c4s ask "<msg>" --thread <id>   # continue an existing ask thread
  */
 export declare function runAsk_cli(args: ParsedArgs): Promise<void>;
 export { runAsk_cli as runAsk };

package/dist/bin/c4s/commands/ask.js

@@ -1,61 +1,53 @@
 import { optionalString } from '../args.js';
 import { CliError } from '../errors.js';
-import { AskError, runAsk } from '../../../core/ask/run-ask.js';
+import { AgentError, runAgent } from '../../../core/agent/run-agent.js';
 /**
- * `c4s ask` — synchroniczny kanal Q&A z agentem specyfikacji (M11).
+ * `c4s ask` — read-only peer-consult shorthand (M11 / 0.1.79).
  *
- * Cienki wrapper nad `runAsk(...)` z `core/ask/run-ask.ts`. Wspolne ciezary
- * (resolve project, health-check, create-thread, run-turn) zyja w core'rze;
- * tutaj zostala tylko warstwa CLI: parsowanie flag, mapowanie kodow bledow
- * na `CliError`, formatowanie outputu (stdout/stderr split, --format json|text).
+ * Narrowed alias of `c4s agent`: hardcodes `contextType='ask'` and
+ * `output: 'final'` (terse `{ threadId, answer }`). It is the canonical
+ * peer-consult shorthand and the CLI twin of the MCP `ask` tool — the peer
+ * answers read-only, never mutating its own spec. `--ct` / `--brief` are
+ * rejected (use `c4s agent` for other contexts).
  *
- *   c4s ask "<msg>" --ct chat
- *   c4s ask "<msg>" --ct brief --brief <path>
- *   c4s ask "<msg>" --thread <id>
+ *   c4s ask "<msg>"                 # consult the peer for the cwd's project
+ *   c4s ask "<msg>" --project <p>   # consult a specific peer
+ *   c4s ask "<msg>" --thread <id>   # continue an existing ask thread
  */
 export async function runAsk_cli(args) {
     const message = args.positional[0];
     if (!message || !message.trim()) {
-        throw new CliError('INVALID_ARGS', 'message is required: c4s ask "<msg>" --ct chat');
+        throw new CliError('INVALID_ARGS', 'message is required: c4s ask "<msg>"');
+    }
+    // `ask` is locked to the read-only ask context — these flags belong to
+    // `c4s agent`, not the shorthand.
+    if (optionalString(args, 'ct') !== undefined) {
+        throw new CliError('INVALID_ARGS', '`c4s ask` is always --ct=ask; use `c4s agent` to pick a context');
+    }
+    if (optionalString(args, 'brief') !== undefined) {
+        throw new CliError('INVALID_ARGS', '`c4s ask` does not take --brief; use `c4s agent --ct brief`');
     }
     const threadId = optionalString(args, 'thread');
-    const ct = optionalString(args, 'ct');
-    const briefPath = optionalString(args, 'brief');
     const server = optionalString(args, 'server');
     const project = args.project;
     const workspace = args.workspace;
     if (project && server) {
-        // Mutex `project` vs `server` — gdy oba podane, `server` wygrywa; CLI
-        // dopisuje warning na stderr (dla MCP analogicznie, ale przez tool_result).
         process.stderr.write('warning: both --project and --server given; --server wins, --project ignored\n');
     }
-    if (!threadId) {
-        // Wczesna walidacja flag CLI (drobne komunikaty user-facing); runAsk
-        // robi to samo na poziomie biblioteki, ale tutaj dajemy zywsze hinty.
-        if (ct !== 'chat' && ct !== 'brief' && ct !== 'patch') {
-            throw new CliError('INVALID_ARGS', '--ct must be chat|brief|patch (or pass --thread <id> to continue a thread)');
-        }
-        if (ct === 'patch') {
-            throw new CliError('INVALID_ARGS', 'c4s ask cannot create a patch thread; pass --thread <id> to continue one');
-        }
-        if (ct === 'brief' && !briefPath) {
-            throw new CliError('INVALID_ARGS', '--ct brief requires --brief <path>');
-        }
-    }
     let result;
     try {
-        result = await runAsk({
+        result = await runAgent({
             message,
             project,
             workspace,
             server,
-            contextType: ct,
+            contextType: 'ask',
             threadId,
-            briefPath,
+            output: 'final',
         });
     }
     catch (err) {
-        if (err instanceof AskError) {
+        if (err instanceof AgentError) {
             throw new CliError(err.code, err.message, err.hint);
         }
         throw err;

package/dist/bin/c4s/commands/ask.js.map

@@ -1 +1 @@
-{"version":3,"file":"ask.js","sourceRoot":"","sources":["../../../../src/bin/c4s/commands/ask.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ask.js","sourceRoot":"","sources":["../../../../src/bin/c4s/commands/ask.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAqB,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAExE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAgB;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QAChC,MAAM,IAAI,QAAQ,CAAC,cAAc,EAAE,sCAAsC,CAAC,CAAC;IAC7E,CAAC;IAED,uEAAuE;IACvE,kCAAkC;IAClC,IAAI,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;QAC7C,MAAM,IAAI,QAAQ,CAAC,cAAc,EAAE,iEAAiE,CAAC,CAAC;IACxG,CAAC;IACD,IAAI,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,SAAS,EAAE,CAAC;QAChD,MAAM,IAAI,QAAQ,CAAC,cAAc,EAAE,6DAA6D,CAAC,CAAC;IACpG,CAAC;IAED,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IAEjC,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;QACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gFAAgF,CAAC,CAAC;IACzG,CAAC;IAED,IAAI,MAA4C,CAAC;IACjD,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,QAAQ,CAAC;YACtB,OAAO;YACP,OAAO;YACP,SAAS;YACT,MAAM;YACN,WAAW,EAAE,KAAK;YAClB,QAAQ;YACR,MAAM,EAAE,OAAO;SAChB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,UAAU,EAAE,CAAC;YAC9B,MAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAoB,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QACtE,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,4EAA4E;IAC5E,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QAC3C,kDAAkD;QAClD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,MAAM,CAAC,QAAQ,sCAAsC,MAAM,CAAC,QAAQ,KAAK,CAAC,CAAC;IAC7G,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC7G,CAAC;AACH,CAAC;AAED,uEAAuE;AACvE,OAAO,EAAE,UAAU,IAAI,MAAM,EAAE,CAAC"}

package/dist/bin/c4s/commands/catalog.d.ts

@@ -1,2 +1,2 @@
 import type { ParsedArgs } from '../args.js';
-export declare function runCatalog(args: ParsedArgs): void;
+export declare function runCatalog(args: ParsedArgs): Promise<void>;

package/dist/bin/c4s/commands/catalog.js

@@ -3,8 +3,8 @@ import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { createContext } from '../context.js';
 import { writeOutput } from '../output.js';
-export function runCatalog(args) {
-    const ctx = createContext(args);
+export async function runCatalog(args) {
+    const ctx = await createContext(args);
     try {
         const catalog = ctx.registry.catalog(ctx.reader);
         writeOutput({ ...catalog, claude4spec: readPackageVersion() }, args);

package/dist/bin/c4s/commands/catalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../../src/bin/c4s/commands/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,UAAU,UAAU,CAAC,IAAgB;IACzC,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjD,WAAW,CAAC,EAAE,GAAG,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IACvE,CAAC;YAAS,CAAC;QACT,GAAG,CAAC,KAAK,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB;IACzB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1D,6EAA6E;QAC7E,MAAM,KAAK,GAAG;YACZ,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;YAC1C,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;SACrC,CAAC;QACF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;YAChD,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAyB,CAAC;gBACjF,IAAI,GAAG,CAAC,OAAO;oBAAE,OAAO,GAAG,CAAC,OAAO,CAAC;YACtC,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,YAAY;IACd,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../../src/bin/c4s/commands/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAgB;IAC/C,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjD,WAAW,CAAC,EAAE,GAAG,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IACvE,CAAC;YAAS,CAAC;QACT,GAAG,CAAC,KAAK,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB;IACzB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1D,6EAA6E;QAC7E,MAAM,KAAK,GAAG;YACZ,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;YAC1C,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;SACrC,CAAC;QACF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;YAChD,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAyB,CAAC;gBACjF,IAAI,GAAG,CAAC,OAAO;oBAAE,OAAO,GAAG,CAAC,OAAO,CAAC;YACtC,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,YAAY;IACd,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/bin/c4s/commands/describe.d.ts

@@ -1,2 +1,2 @@
 import { type ParsedArgs } from '../args.js';
-export declare function runDescribe(args: ParsedArgs): void;
+export declare function runDescribe(args: ParsedArgs): Promise<void>;

package/dist/bin/c4s/commands/describe.js

@@ -3,11 +3,11 @@ import { createContext } from '../context.js';
 import { CliError } from '../errors.js';
 import { writeOutput } from '../output.js';
 import { normalizeEntityType, normalizeViewKind } from '../type-validation.js';
-export function runDescribe(args) {
+export async function runDescribe(args) {
     const type = normalizeEntityType(requireString(args, 'type'));
     const viewFlag = optionalString(args, 'view');
     const view = viewFlag ? normalizeViewKind(viewFlag) : undefined;
-    const ctx = createContext(args);
+    const ctx = await createContext(args);
     try {
         const result = ctx.registry.describe(type, view, ctx.db);
         if (!result) {

package/dist/bin/c4s/commands/describe.js.map

@@ -1 +1 @@
-{"version":3,"file":"describe.js","sourceRoot":"","sources":["../../../../src/bin/c4s/commands/describe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAmB,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,UAAU,WAAW,CAAC,IAAgB;IAC1C,MAAM,IAAI,GAAG,mBAAmB,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9D,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAChE,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,QAAQ,CAChB,cAAc,EACd,gBAAgB,IAAI,iBAAiB,EACrC,gDAAgD,CACjD,CAAC;QACJ,CAAC;QACD,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC;YAAS,CAAC;QACT,GAAG,CAAC,KAAK,EAAE,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"describe.js","sourceRoot":"","sources":["../../../../src/bin/c4s/commands/describe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAmB,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAgB;IAChD,MAAM,IAAI,GAAG,mBAAmB,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9D,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAChE,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,QAAQ,CAChB,cAAc,EACd,gBAAgB,IAAI,iBAAiB,EACrC,gDAAgD,CACjD,CAAC;QACJ,CAAC;QACD,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC;YAAS,CAAC;QACT,GAAG,CAAC,KAAK,EAAE,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/bin/c4s/commands/detail.d.ts

@@ -1,2 +1,2 @@
 import type { ParsedArgs } from '../args.js';
-export declare function runDetail(args: ParsedArgs): void;
+export declare function runDetail(args: ParsedArgs): Promise<void>;

package/dist/bin/c4s/commands/detail.js

@@ -4,10 +4,10 @@ import { CliError } from '../errors.js';
 import { writeOutput } from '../output.js';
 import { normalizeEntityType } from '../type-validation.js';
 import { withMeta } from './_meta.js';
-export function runDetail(args) {
+export async function runDetail(args) {
     const type = normalizeEntityType(requireString(args, 'type'));
     const slug = requireString(args, 'slug');
-    const ctx = createContext(args);
+    const ctx = await createContext(args);
     try {
         const entity = ctx.reader.getEntity(type, slug);
         if (!entity)