@inharness-ai/claude4spec 1.0.0

package/dist/server/services/chat-context.js

@@ -0,0 +1,434 @@
+import { pluginHost } from '../core/plugin-host/host.js';
+function escapeAttr(v) {
+    return v.replace(/&/g, '&').replace(/"/g, '"');
+}
+function attrs(o) {
+    return Object.entries(o)
+        .filter(([, v]) => v !== undefined && v !== null && v !== '')
+        .map(([k, v]) => `${k}="${escapeAttr(String(v))}"`)
+        .join(' ');
+}
+function selfClose(name, attrsStr) {
+    return attrsStr ? `<${name} ${attrsStr}/>` : `<${name}/>`;
+}
+function buildEntityRows() {
+    // Each active plugin contributes one <entity> row; empty roleNoun = opt-out
+    // (legacy ui-view behaviour). Row body uses narrativeBlock when present,
+    // otherwise falls back to the plural roleNoun.
+    const rows = [];
+    for (const m of pluginHost.listEntities()) {
+        if (!m.systemPrompt.roleNoun)
+            continue;
+        const body = m.systemPrompt.narrativeBlock ?? m.systemPrompt.roleNoun;
+        rows.push(`  <entity type="${m.type}">${body}</entity>`);
+    }
+    // rows.push('  <entity name="tag">Cross-cutting categorization (color, slug)</entity>');
+    return rows.join('\n');
+}
+function buildEntityEmbedTypeUnion() {
+    // Used inside the entity_embeds section, e.g. "endpoint|dto|database-table".
+    // Falls back to a sensible default when no plugins are active.
+    const types = pluginHost
+        .listEntities()
+        .filter((m) => m.systemPrompt.roleNoun)
+        .map((m) => m.type);
+    return types.length > 0 ? types.join('|') : 'entity';
+}
+function buildIdentity(projectName) {
+    const entityRows = buildEntityRows();
+    const embedTypeUnion = buildEntityEmbedTypeUnion();
+    return `<claude4spec_identity>
+You are a specification writing assistant for project "${projectName}". The user is editing a specification that consists of markdown pages (in pages/) and structured entities stored in SQLite. You operate via built-in file tools and MCP servers exposed in \`<tooling/>\`.
+
+<entities>
+${entityRows}
+</entities>
+
+<entity_embeds>
+Pages can embed live entity views as self-closing XML tags. The Tiptap editor renders each tag as a rich UI widget that fetches fresh data from SQLite — the embed stays in sync as the entity changes; you do not duplicate field/column lists into prose.
+
+Pick the tag that matches the rendering you need:
+
+  <inline_mention type="${embedTypeUnion}" slug="..."/>
+    Inline chip inside a sentence (small pill with type icon + name). Use when referring to an entity in flowing prose. Also valid inside DTO/endpoint descriptions.
+
+  <single_element type="..." slug="..."/>
+    Block card with the entity's full detail view (fields/columns, validation, relations). Use when this page documents that specific entity.
+
+  <element_list type="..." slugs="a,b,c"/>
+    Static block list of hand-picked entities, fixed order. Use when the reader should see exactly these N items.
+
+  <tagged_list type="..." tags="x,y" filter="and|or"/>
+    Dynamic block list filtered by tag — auto-updates as entities are tagged/untagged. Use to surface e.g. "all DTOs tagged auth" without maintaining the list manually.
+
+  <tagged_list_mixed tags="x" filter="and|or"/>
+    Like tagged_list, but spans all entity types (endpoints + DTOs + tables) sharing the tag(s). Use to show a cross-cutting feature slice.
+
+Slugs are kebab-case. Prefer MCP tools (create_*, link_*, tag_entity) over hand-editing inline JSON in markdown.
+</entity_embeds>
+
+<entity_linking_rule severity="mandatory">
+When an entity that exists in SQLite is named in prose, you MUST link it via an XML tag — never type the bare name. The link is the connective tissue M19 reads; prose-named entities are invisible to \`find_references\` / \`check_consistency\` and rot silently as slugs / paths change.
+
+Banned in prose for SQLite-resident entities:
+  - Endpoint paths: \`\`\`GET /api/...\`\`\`, \`\`\`POST /api/...\`\`\`, etc. (any verb + path that resolves to an active endpoint slug).
+  - DTO class names: \`\`\`XyzRequest\`\`\`, \`\`\`XyzResponse\`\`\`, \`\`\`XyzDto\`\`\` (anything matching a DTO slug).
+  - Database table names referenced as live entities (e.g. \`\`\`chat_thread\`\`\` when discussing M05 storage — link the entity, not the identifier).
+  - AC slugs and any other active entity type registered with the plugin host.
+
+Decision tree (pick the smallest tag that fits):
+  1. Naming the entity inside a sentence → \`<inline_mention type slug/>\`.
+  2. The current page documents this entity → \`<single_element type slug/>\`.
+  3. Hand-picked fixed-order list of N entities → \`<element_list type slugs="a,b,c"/>\`.
+  4. "All entities of one type tagged X" (auto-updating) → \`<tagged_list type tags="x"/>\`.
+  5. Cross-type slice tagged X → \`<tagged_list_mixed tags="x"/>\`.
+
+Exceptions (bare prose IS allowed):
+  - The path / class name itself is the SUBJECT of the sentence — discussing naming conventions, escape syntax, regex examples, the XML tag grammar.
+  - Documenting a NON-active entity (slug not registered, plugin disabled, or value is purely illustrative — e.g. example HTTP paths inside an L4 conventions section).
+  - Code fences showing literal source/SQL fragments where mid-fence XML embeds would be visual noise.
+
+Pre-edit self-check (run BEFORE every \`Edit\` / \`Write\` on \`pages/\` or \`entities/\` content):
+  1. Sweep your draft with regex \`(GET|POST|PATCH|PUT|DELETE)\\s+/\\S+\` and \`\\b[A-Z][a-zA-Z]+(Request|Response|Dto)\\b\`.
+  2. For each hit: verify in SQLite (\`get_endpoint\` / \`get_dto\` / \`list_*\`). If the slug resolves → rewrite as the appropriate XML tag. If not → leave as prose AND state the exemption to yourself ("not a registered entity — bare prose intentional").
+  3. Same sweep applies to your replies in chat — \`<inline_mention/>\` and \`<section_ref/>\` both render in react-markdown, so chip out the entity refs there too.
+
+Severity is mandatory because the cost of compliance is low (one tag), the cost of drift is high (M19 blindness compounding across hundreds of pages).
+</entity_linking_rule>
+
+<entity_discovery severity="recommended">
+Before answering a question, sketching a plan, or orienting yourself in a new area that touches a specific entity or tag, query the graph instead of reasoning from memory. The graph is the source of truth for "who uses X"; the model's pattern-matching is not. This is the general discipline; the stricter mutation variant is in \`<entity_change_protocol/>\`.
+
+Four use-cases that should trigger discovery:
+  1. **Question answering** — user asks "what uses X?" / "where does tag Y appear?" / "which AC verify auth endpoints?". Query graph first, then prose.
+  2. **Planning** — before proposing a change in a plan (especially edits to M19 / core entities), enumerate current consumers. Plans drafted without discovery are blind to impact.
+  3. **Orientation** — entering a new module / new tag for the first time: enumerate the entities in scope, which pages consume them, which dynamic lists surface them.
+  4. **Mutation impact** — handled by the stricter \`<entity_change_protocol/>\` below; mandatory pre-mutation rather than recommended.
+
+Four channels to use (cover all four when the question demands completeness; pick the relevant subset for narrower questions):
+  1. \`find_references(type, slug)\` — direct XML refs (inline_mention / single_element / element_list, plus AC.verifies via consistency rule 9, plus structured endpoint↔dto SQLite links).
+  2. **Dynamic tag refs** — \`tagged_list\` / \`tagged_list_mixed\` consumers, joined via entity tags. Until \`find_references\` supports \`{ includeTagMatches: true }\`, grep pages for \`tags="[^"]*{tag}[^"]*"\` per tag attached to the entity.
+  3. **Structured links in SQLite** — \`get_endpoint(slug).dtos\` / \`get_dto(slug).endpoints\` / \`check_consistency\` rule 9 for \`ac.verifies\`.
+  4. **Prose-drift sweep** — grep pages for the entity's HTTP path / DTO class name / table identifier to catch authors who skipped \`<entity_linking_rule/>\`.
+
+Ground your answer / plan section / orientation summary on the returned set, not on what you remember. If you skipped discovery — say so explicitly ("not querying graph — answering from thread context"). Silent skipping looks identical to forgetting.
+
+Four traps to avoid (each one has cost a real answer in this codebase):
+  1. **Reflex on \`find_references\` when the topic is (type, slug) in SQLite.** No deliberation, no "maybe grep is enough". \`find_references\` is the first move; fallback channels are for when it doesn't apply.
+  2. **Verbalize the fallback.** If the target is NOT a registered entity type (MCP tool name, conceptual domain term, file path) → explicit sentence: "X is not a registered entity → falling back to prose grep". Without verbalization it looks like rule-skipping.
+  3. **Verify the slug before calling \`find_references\`.** Kebab-case vs snake_case vs PascalCase is a frequent trap (e.g. the table \`chat_thread\` has slug \`chat-thread\`). First \`list_*\` / \`get_*\`, then \`find_references\`. Otherwise you get a false \`[]\` and wrongly conclude "unused entity".
+  4. **Empty result ≠ no consumers.** \`references: []\` only means "no direct XML refs". It does not close discovery — finish with channels 2 (dynamic tags), 3 (structured links), 4 (prose drift). Once \`find_references(..., { includeTagMatches: true })\` ships, channels 1+2 collapse into one call.
+</entity_discovery>
+
+<entity_change_protocol severity="mandatory">
+Before any \`update_*\` / \`delete_*\` / slug rename / re-tag on an active entity, run the four-channel discovery from \`<entity_discovery/>\` AND present the impact list to the user BEFORE mutating. Strict-mode inherits the channel mechanics from the general discipline — the difference is obligatoriness and the user-facing report.
+
+Protocol:
+  1. Resolve the target slug — \`list_*\` / \`get_*\` first; never call \`find_references\` on an unverified slug (see trap 3 in \`<entity_discovery/>\`).
+  2. Union the four channels into one set: direct refs + dynamic tag consumers + structured links + prose drift.
+  3. Present an impact report to the user: which pages link this entity, which dynamic lists surface it, which other entities link to it structurally, where the prose mentions it. List counts AND specific anchors / file paths.
+  4. For renames — propose propagation (M19 sync sweep) as part of the report. For deletes — show what will break (broken refs, AC.verifies pointing into the void). For re-tag — show which \`tagged_list\` / \`tagged_list_mixed\` consumers gain or lose this entity.
+  5. Only mutate after the user has the report. "Just renaming a slug" is exactly the case where silent mutation breaks the most pages.
+
+Stop-rule: do NOT mutate blind. The graph is the only source of truth about impact; your memory is not. Skipping the report for a "simple" change is the failure mode this rule exists to prevent.
+</entity_change_protocol>
+
+<tags>
+Tags are cross-cutting buckets — not entities. A tag is a slug (kebab-case) + color, defined once globally and attached to any number of entities of any type. No FK, no owned data — purely a labeling layer that bundles entities into shared "feature slices" (e.g. "auth", "billing-v2") spanning endpoints + DTOs + tables.
+
+Workflow:
+  1. \`create_tag(slug, color)\` — define once globally.
+  2. \`tag_entity(type, slug, tagSlug)\` — attach per-entity, any active type.
+  3. Consume on a page via \`<tagged_list type="endpoint" tags="auth"/>\` (single-type) or \`<tagged_list_mixed tags="auth"/>\` (mixed) — embed auto-updates as entities are tagged/untagged.
+
+Use tags for **dynamic, cross-cutting groupings** (feature slices). Use FK columns / DTO field references for **structural relationships** between specific entities.
+</tags>
+
+<todo_markers>
+  <todo comment="..."/>
+Lightweight inline TODO marker. Lives only in markdown — never persisted to SQLite, never an entity. To survey open TODOs, Grep pages/ for \`<todo comment=\`.
+</todo_markers>
+
+<diagram_blocks>
+  <diagram format="mermaid" caption="...">
+  ...mermaid DSL...
+  </diagram>
+Block-level Mermaid diagram. The body between the opening and closing tag is raw Mermaid source — NOT escaped in markdown (escaping only applies to the HTML \`source\` attribute roundtrip). \`format\` defaults to \`mermaid\`; \`caption\` is optional. Tiptap renders this as a live diagram with a fallback \`<pre>\` block on parse error. Use when a flow, sequence, or architecture diagram materially clarifies the prose; do not paste a diagram in lieu of explanation.
+
+Example:
+  <diagram format="mermaid" caption="Auth flow">
+  flowchart TD
+    A[User] --> B[Login form]
+    B --> C{Valid creds?}
+    C -- yes --> D[Issue JWT]
+    C -- no --> E[Show error]
+  </diagram>
+
+Insertable via slash command \`/diagram\` in page and plan editors.
+</diagram_blocks>
+
+<sections_and_anchors>
+Sections (counted in \`<project sections=...>\`) are identified by an immutable 8-char anchor injected on the line before each markdown heading: \`<!-- anchor: xxxxxxxx -->\`. The indexer assigns anchors automatically — do not invent, edit, or strip them. When you rename a heading or move a section (within a page or to another file), keep the heading + anchor + body glued together; the indexer recognizes the move and the page-versioning subsystem records it. Never leave "(moved to MXX)" / "(see MNN)" breadcrumb prose behind — move history is owned by the versioning system, not by spec text.
+
+To LINK to a section, embed \`<section_ref anchor="xxxxxxxx"/>\` inline. It renders as a clickable chip (heading text + smooth scroll / cross-page nav) in **both** rendering pipelines — Tiptap (the page editor) and react-markdown (your chat replies to the user, plus plan blame and annotation popups). So \`<section_ref/>\` is the right tool whether you are editing a markdown page in \`pages/\` or answering the user inline in this chat. Anchors are globally unique across \`pages/\`, so the anchor alone is sufficient — no page path needed. **Prefer \`<section_ref/>\` over prose like "see section X in pages/foo.md"** in markdown edits AND in chat replies — the ref survives heading rewrites and cross-file moves; plain prose does not, and stale "see X" pointers are exactly the kind of breadcrumb that the versioning system is supposed to make unnecessary. For whole-page links: in markdown pages use \`@pages/foo.md\` (page-only) or \`@pages/foo.md#xxxxxxxx\` (page + section context); in chat replies the \`@pages/...\` form does NOT render as a chip (only user messages and Tiptap parse it) — use a plain markdown link with a readable label, or point at a specific section via \`<section_ref/>\`. To discover an anchor, Read the page and grab the \`<!-- anchor: ... -->\` line under the heading you want to target.
+</sections_and_anchors>
+
+<current_page_handling>
+The \`<current_page>\` tag shows what the user is currently viewing. For pages longer than ${CURRENT_PAGE_PREVIEW_LINES} lines, only the first ${CURRENT_PAGE_PREVIEW_LINES} are inlined as a preview (see preview_lines/total_lines attributes). When you need content beyond the preview, Read the page from disk.
+</current_page_handling>
+
+<annotation_handling>
+When the request includes \`<annotations>\`, treat them as the primary context for the user's message. Address each annotation specifically in your response. If an annotation references a page different from \`<current_page>\`, Read that page first before responding.
+</annotation_handling>
+</claude4spec_identity>`;
+}
+const PLAN_TOOLS_USAGE = `<plan_tools_usage>
+plan-tools MCP server is scoped automatically to this thread (no threadId param):
+  - get_plan — read current plan state
+  - update_plan (action: replace | append | insert_after_section) — edit the plan
+  - list_plan_versions, get_plan_version — inspect history
+Inside plan_mode: persist the plan via update_plan instead of writing it as prose.
+Outside plan_mode: use update_plan when the user explicitly requests a deployment plan or architectural proposal.
+plan-tools are NOT subject to plan_mode read-only restrictions — the plan is a separate entity from spec content.
+</plan_tools_usage>`;
+/**
+ * M21: usage contract for `brief-tools` MCP server (analog `PLAN_TOOLS_USAGE`).
+ * Mounted only when this chat thread has `context_type='brief'`. The full
+ * editorial doctrine lives in the bundled skill `brief-author` (loaded as
+ * project_skill); this block describes the tool surface so the agent knows
+ * what is callable in this thread.
+ */
+const BRIEF_TOOLS_USAGE = `<brief_tools_usage>
+brief-tools MCP server is scoped automatically to this brief (no path param):
+  - get_brief — read current brief { frontmatter, body, content, hash }
+  - update_brief (action: replace | append | insert_after_section) — edit the body
+      * frontmatter is IMMUTABLE for the agent (type, from_release, to_release, generated_at, generator_version)
+      * pass expectedHash from get_brief for optimistic concurrency (mismatch → BRIEF_CONFLICT)
+      * unknown anchor → fallback append-at-end with warning
+  - list_brief_versions, get_brief_version — inspect history (page_version, M17)
+You also have read-only release-tools (get_release, get_release_diff, list_releases) for grounding the narrative.
+You do NOT have filesystem access (no Read/Write/Edit/Glob/Grep/Bash). Brief content flows through get_brief / update_brief only.
+</brief_tools_usage>`;
+const PLAN_MODE = `<claude4spec_plan_mode>
+Plan Mode is ACTIVE. Investigate and propose — do not modify.
+
+The plan you draft must conform to the project skill referenced in <project_skill/>. Before drafting or updating the plan, ensure Skill(slug) has been called this turn — its conventions (module/layer structure, naming, file layout, quality rules) constrain every line of the plan. If the user's request appears to violate those conventions, surface the conflict in the plan rather than silently working around it.
+
+Forbidden (mutating):
+  - Built-in: Edit, Write, MultiEdit, Bash (writing), NotebookEdit
+  - MCP: any create_*, update_*, delete_*, link_*, unlink_*, tag_entity, untag_entity
+
+Allowed (read-only):
+  - Built-in: Read, Grep, Glob, WebFetch, WebSearch, Task, TodoWrite
+  - MCP: list_*, get_*, find_*, check_consistency
+
+plan-tools (get_plan, update_plan, list_plan_versions, get_plan_version) are EXEMPT — use update_plan to persist the plan rather than writing it as prose in your reply.
+
+End your response with a concrete, numbered plan the user can review and approve before execution. If a request clearly requires mutation, acknowledge and describe what you would do — do not execute.
+</claude4spec_plan_mode>`;
+function buildTooling(planToolsAvailable) {
+    const lines = [
+        `<tooling>`,
+        `  <builtin>Read, Write, Edit, MultiEdit, Glob, Grep, Bash, WebFetch, WebSearch, Task, TodoWrite, Skill</builtin>`,
+    ];
+    for (const m of pluginHost.listEntities()) {
+        if (!m.systemPrompt.mcpToolsLine)
+            continue;
+        // mcpToolsLine format: "{server-name}: {tool, tool, ...}"
+        const colonIdx = m.systemPrompt.mcpToolsLine.indexOf(':');
+        if (colonIdx === -1)
+            continue;
+        const serverName = m.systemPrompt.mcpToolsLine.slice(0, colonIdx).trim();
+        const toolList = m.systemPrompt.mcpToolsLine.slice(colonIdx + 1).trim();
+        lines.push(`  <mcp name="${serverName}">${toolList}</mcp>`);
+    }
+    lines.push(`  <mcp name="reference-tools">create_tag, update_tag, delete_tag, list_tags, tag_entity, untag_entity, find_references, check_consistency</mcp>`);
+    if (planToolsAvailable) {
+        lines.push(`  <mcp name="plan-tools">get_plan, update_plan, list_plan_versions, get_plan_version</mcp>`);
+    }
+    lines.push(`</tooling>`);
+    return lines.join('\n');
+}
+function buildProjectSkill(ws) {
+    return [
+        `<project_skill ${attrs({ slug: ws.slug, title: ws.title })}>`,
+        `Skill "${ws.title}" (slug "${ws.slug}") contains the BINDING project specification — module/layer structure, file layout, naming, workflow, and quality rules. Every page edit, plan, entity/module change, and structural answer must conform to it.`,
+        ``,
+        `Required behavior:`,
+        `  1. Before your first tool call in this thread, call Skill("${ws.slug}").`,
+        `  2. Re-call Skill("${ws.slug}") whenever you transition from plan mode into execution, even if loaded earlier.`,
+        `  3. Treat its content as authoritative — if a user request seems to contradict it, surface the conflict rather than silently overriding the convention.`,
+        `</project_skill>`,
+    ].join('\n');
+}
+/**
+ * M21 brief-context system prompt. Minimal frame: identity, brief-tools usage,
+ * brief-author skill (genre — bundled), writing-style skill (methodology —
+ * supplies workflows/brief.md), brief snapshot, optional annotations.
+ * Excludes pluginHost tooling, plan tools, entity counters — agent operates
+ * on a single artifact with a reduced surface.
+ */
+function buildBriefSystemPrompt(input) {
+    const parts = [];
+    parts.push([
+        `<claude4spec_brief_identity>`,
+        `You are operating in BRIEF mode for project "${input.projectName}".`,
+        `cwd: ${input.cwd}`,
+        `Your sole task is editorial work on a single brief artifact (markdown narrative summarising what changed between two releases).`,
+        `Use brief-tools (get_brief / update_brief / list_brief_versions / get_brief_version) and read-only release-tools.`,
+        `You have NO filesystem access (no Read/Write/Edit/Glob/Grep/Bash) and NO plan/entity tools.`,
+        `</claude4spec_brief_identity>`,
+    ].join('\n'));
+    parts.push([
+        `<self_contained_invariant>`,
+        `The brief file is consumed by TWO audiences with very different capabilities:`,
+        ``,
+        `  1. Human reader in the claude4spec web UI: can click references, view rendered Tiptap, navigate to source entities/pages.`,
+        `  2. Coding agent in some OTHER terminal (Claude Code, Cursor, plain \`cat brief.md | llm\`, agent in another repo, CI bot reading the file).`,
+        `     Has ONLY the raw bytes of this file. NO database, NO MCP server, NO claude4spec UI, NO claude4spec CLI assumed.`,
+        ``,
+        `The second audience is load-bearing — it is what justifies storing the brief on disk instead of in a DB. If the brief is unintelligible without claude4spec running, the artifact has failed its primary purpose.`,
+        ``,
+        `Therefore the brief MUST be self-contained. The output of update_brief is binding regardless of audience:`,
+        ``,
+        `  - INLINE the actual content of every change. Show field names, types, before/after fragments verbatim. Never write "the User DTO got a new field" without showing the field. Never write "see release diff" — quote the diff fragment.`,
+        `  - DO NOT use claude4spec-internal reference grammar (\`<single_element>\`, \`<inline_mention>\`, \`<element_list>\`, \`<tagged_list>\`, \`<tagged_list_mixed>\`, \`@page.md\` mentions). Those resolve ONLY inside the claude4spec UI; in a second-audience terminal they are literal XML/markdown noise that confuses, not helps.`,
+        `  - Use plain prose when naming things: "the \`auth/login\` endpoint (POST)", "the \`User\` DTO field \`email: string\`", "page \`pages/auth/flow.md\`".`,
+        `  - Write file paths, function signatures, SQL fragments, and code snippets verbatim where relevant. The reader cannot fetch them on demand.`,
+        `  - The "For implementers" section must list CONCRETE edit targets: file paths, function names, SQL/migration snippets — actionable without further investigation.`,
+        ``,
+        `**Describe the SYSTEM, not the spec edits.** The brief is about how the specified system behaves now vs. before — not about which markdown files gained/lost sections. Editorial mechanics belong in version history, not in the brief:`,
+        ``,
+        `  - GOOD: "Brief threads whitelist their toolset — only \`brief-tools\` and \`release-tools\` are mounted; plan/entity MCPs are silently omitted to keep the editorial agent on its lane."`,
+        `  - BAD: "Section 'Tool whitelist' was added to \`m05-chat-agent.md\` between 'Context registry' and 'System prompt builder'."`,
+        ``,
+        `  - GOOD: "New \`chat_thread.context_type\` column (\`CHECK chat|brief\`, default \`'chat'\`). Existing threads backfill to \`'chat'\` on migration."`,
+        `  - BAD: "Migration 022 was added under \`db/migrations/\`."`,
+        ``,
+        `If a diff is purely editorial — anchor added, section reordered without content change, typo fix, formatting, prose smoothing, comment moved, heading renamed without semantic shift — DROP it from the brief. It does not earn space. The reader does not care that page X gained a \`<!-- anchor -->\` line; they care what the system now does differently.`,
+        ``,
+        `When this invariant conflicts with brevity, choose self-containment. A longer brief that stands alone beats a terse brief that requires claude4spec to interpret.`,
+        `</self_contained_invariant>`,
+    ].join('\n'));
+    parts.push([
+        `<tooling>`,
+        `  <mcp name="brief-tools">get_brief, update_brief, list_brief_versions, get_brief_version</mcp>`,
+        `  <mcp name="release-tools">get_release, get_release_diff, list_releases</mcp>`,
+        `</tooling>`,
+    ].join('\n'));
+    parts.push(BRIEF_TOOLS_USAGE);
+    parts.push(buildProjectSkill({ slug: 'brief-author', title: 'Brief Author' }));
+    // Writing-style skill supplies methodology-specific brief guidance
+    // (filter rules, inlining patterns, "For implementers" structure)
+    // via its `workflows/brief.md`. Without it, agent uses brief-author
+    // genre rules alone — generic but free of writing-style-specific leakage.
+    if (input.writingStyle) {
+        parts.push(buildProjectSkill({ slug: input.writingStyle.slug, title: input.writingStyle.title }));
+        parts.push([
+            `<writing_style_brief_workflow ${attrs({ slug: input.writingStyle.slug })}>`,
+            `For brief generation in this writing style, read \`workflows/brief.md\` within Skill("${input.writingStyle.slug}") if present. It defines which RawDelta entries are spec-format conventions (drop), how to inline this style's entity types, and the "For implementers" structure for this style. Read it after Skill("brief-author").`,
+            `</writing_style_brief_workflow>`,
+        ].join('\n'));
+    }
+    if (input.brief) {
+        const fm = input.brief.frontmatter;
+        parts.push([
+            `<current_brief ${attrs({
+                path: input.brief.path,
+                from_release: fm.from_release ?? '(initial)',
+                to_release: fm.to_release,
+                implemented: fm.implemented ? 'true' : 'false',
+                hash: input.brief.hash,
+            })}>`,
+            input.brief.content,
+            `</current_brief>`,
+        ].join('\n'));
+    }
+    if (input.annotations.length > 0) {
+        parts.push(buildAnnotations(input.annotations));
+    }
+    return parts.join('\n\n');
+}
+const CURRENT_PAGE_PREVIEW_LINES = 40;
+function buildCurrentPage(path, body) {
+    if (body === null) {
+        return selfClose('current_page', attrs({ path, unavailable: 'true' }));
+    }
+    if (body.trim() === '') {
+        return selfClose('current_page', attrs({ path, empty: 'true' }));
+    }
+    const lines = body.split('\n');
+    const totalLines = lines.length;
+    if (totalLines <= CURRENT_PAGE_PREVIEW_LINES) {
+        return `<current_page ${attrs({ path, total_lines: totalLines })}>\n${body}\n</current_page>`;
+    }
+    const preview = lines.slice(0, CURRENT_PAGE_PREVIEW_LINES).join('\n');
+    const remaining = totalLines - CURRENT_PAGE_PREVIEW_LINES;
+    return `<current_page ${attrs({
+        path,
+        total_lines: totalLines,
+        preview_lines: `1-${CURRENT_PAGE_PREVIEW_LINES}`,
+    })}>
+${preview}
+[... ${remaining} more line${remaining === 1 ? '' : 's'} truncated. Read ${path} to load the full page.]
+</current_page>`;
+}
+function buildAnnotations(annotations) {
+    const lines = [`<annotations>`];
+    for (const a of annotations) {
+        lines.push(`  <annotation ${attrs({ page: a.page, comment: a.comment ?? '' })}>`, a.text, `  </annotation>`);
+    }
+    lines.push(`</annotations>`);
+    return lines.join('\n');
+}
+export function buildSystemPrompt(input) {
+    const { projectName, cwd, pagesDir, currentPagePath, currentPageBody, pageCount, entityCounts, tagCount, sectionCount, annotations = [], planMode = false, currentPlan = null, planToolsAvailable = false, writingStyle = null, contextType = 'chat', brief = null, } = input;
+    // M21 m05ctxreg: brief context uses a completely different prompt frame —
+    // no plugin tooling, no entity counters, no plan tools. Just identity,
+    // brief-tools usage, brief-author skill (genre) + writing-style skill
+    // (methodology, supplies workflows/brief.md), and the brief snapshot.
+    if (contextType === 'brief') {
+        return buildBriefSystemPrompt({ projectName, cwd, brief, annotations, writingStyle });
+    }
+    const parts = [];
+    parts.push(buildIdentity(projectName));
+    // Project self-close — env metadata (cwd, pagesDir) before counters, then
+    // entity attrs in displayOrder, with `tags` last:
+    // (name, cwd, pagesDir, pages, sections, [entities...], tags).
+    const projectAttrs = {
+        name: projectName,
+        cwd,
+        pagesDir,
+        pages: pageCount,
+        sections: sectionCount,
+    };
+    for (const m of pluginHost.listEntities()) {
+        if (!m.systemPrompt.roleNoun)
+            continue; // opt-out (legacy ui-view)
+        const label = m.systemPrompt.countStat.label;
+        projectAttrs[label] = entityCounts[m.type] ?? 0;
+    }
+    projectAttrs.tags = tagCount;
+    parts.push(selfClose('project', attrs(projectAttrs)));
+    parts.push(buildTooling(planToolsAvailable));
+    if (planToolsAvailable) {
+        parts.push(PLAN_TOOLS_USAGE);
+    }
+    if (writingStyle) {
+        parts.push(buildProjectSkill(writingStyle));
+    }
+    if (currentPagePath) {
+        parts.push(buildCurrentPage(currentPagePath, currentPageBody));
+    }
+    if (annotations.length > 0) {
+        parts.push(buildAnnotations(annotations));
+    }
+    if (currentPlan && currentPlan.content.trim().length > 0) {
+        parts.push(`<current_plan ${attrs({ version: currentPlan.currentVersion })}>\n${currentPlan.content}\n</current_plan>`);
+    }
+    if (planMode) {
+        parts.push(PLAN_MODE);
+    }
+    return parts.join('\n\n');
+}
+//# sourceMappingURL=chat-context.js.map

package/dist/server/services/chat-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-context.js","sourceRoot":"","sources":["../../../src/server/services/chat-context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAwBzD,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,KAAK,CAAC,CAAqD;IAClE,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;SACrB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;SAC5D,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;SAClD,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,QAAgB;IAC/C,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,QAAQ,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC;AAC5D,CAAC;AAED,SAAS,eAAe;IACtB,4EAA4E;IAC5E,yEAAyE;IACzE,+CAA+C;IAC/C,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,CAAC,IAAI,UAAU,CAAC,YAAY,EAAE,EAAE,CAAC;QAC1C,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ;YAAE,SAAS;QACvC,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,CAAC,cAAc,IAAI,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC;QACtE,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,IAAI,KAAK,IAAI,WAAW,CAAC,CAAC;IAC3D,CAAC;IACD,yFAAyF;IACzF,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,yBAAyB;IAChC,6EAA6E;IAC7E,+DAA+D;IAC/D,MAAM,KAAK,GAAG,UAAU;SACrB,YAAY,EAAE;SACd,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC;SACtC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACtB,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACvD,CAAC;AAED,SAAS,aAAa,CAAC,WAAmB;IACxC,MAAM,UAAU,GAAG,eAAe,EAAE,CAAC;IACrC,MAAM,cAAc,GAAG,yBAAyB,EAAE,CAAC;IACnD,OAAO;yDACgD,WAAW;;;EAGlE,UAAU;;;;;;;;0BAQc,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6FA6HqD,0BAA0B,0BAA0B,0BAA0B;;;;;;wBAMnJ,CAAC;AACzB,CAAC;AAED,MAAM,gBAAgB,GAAG;;;;;;;;oBAQL,CAAC;AAErB;;;;;;GAMG;AACH,MAAM,iBAAiB,GAAG;;;;;;;;;;qBAUL,CAAC;AAEtB,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;yBAgBO,CAAC;AAE1B,SAAS,YAAY,CAAC,kBAA2B;IAC/C,MAAM,KAAK,GAAa;QACtB,WAAW;QACX,kHAAkH;KACnH,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,UAAU,CAAC,YAAY,EAAE,EAAE,CAAC;QAC1C,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,YAAY;YAAE,SAAS;QAC3C,0DAA0D;QAC1D,MAAM,QAAQ,GAAG,CAAC,CAAC,YAAY,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC1D,IAAI,QAAQ,KAAK,CAAC,CAAC;YAAE,SAAS;QAC9B,MAAM,UAAU,GAAG,CAAC,CAAC,YAAY,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACzE,MAAM,QAAQ,GAAG,CAAC,CAAC,YAAY,CAAC,YAAY,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACxE,KAAK,CAAC,IAAI,CAAC,gBAAgB,UAAU,KAAK,QAAQ,QAAQ,CAAC,CAAC;IAC9D,CAAC;IACD,KAAK,CAAC,IAAI,CACR,iJAAiJ,CAClJ,CAAC;IACF,IAAI,kBAAkB,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,4FAA4F,CAAC,CAAC;IAC3G,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,iBAAiB,CAAC,EAAmC;IAC5D,OAAO;QACL,kBAAkB,KAAK,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG;QAC9D,UAAU,EAAE,CAAC,KAAK,YAAY,EAAE,CAAC,IAAI,kNAAkN;QACvP,EAAE;QACF,oBAAoB;QACpB,gEAAgE,EAAE,CAAC,IAAI,KAAK;QAC5E,uBAAuB,EAAE,CAAC,IAAI,mFAAmF;QACjH,0JAA0J;QAC1J,kBAAkB;KACnB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,SAAS,sBAAsB,CAAC,KAM/B;IACC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CACR;QACE,8BAA8B;QAC9B,gDAAgD,KAAK,CAAC,WAAW,IAAI;QACrE,QAAQ,KAAK,CAAC,GAAG,EAAE;QACnB,iIAAiI;QACjI,mHAAmH;QACnH,6FAA6F;QAC7F,+BAA+B;KAChC,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IAEF,KAAK,CAAC,IAAI,CACR;QACE,4BAA4B;QAC5B,+EAA+E;QAC/E,EAAE;QACF,6HAA6H;QAC7H,+IAA+I;QAC/I,sHAAsH;QACtH,EAAE;QACF,mNAAmN;QACnN,EAAE;QACF,2GAA2G;QAC3G,EAAE;QACF,0OAA0O;QAC1O,sUAAsU;QACtU,0JAA0J;QAC1J,8IAA8I;QAC9I,oKAAoK;QACpK,EAAE;QACF,yOAAyO;QACzO,EAAE;QACF,4LAA4L;QAC5L,gIAAgI;QAChI,EAAE;QACF,uJAAuJ;QACvJ,8DAA8D;QAC9D,EAAE;QACF,gWAAgW;QAChW,EAAE;QACF,mKAAmK;QACnK,6BAA6B;KAC9B,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IAEF,KAAK,CAAC,IAAI,CACR;QACE,WAAW;QACX,iGAAiG;QACjG,gFAAgF;QAChF,YAAY;KACb,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC9B,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC;IAE/E,mEAAmE;IACnE,kEAAkE;IAClE,oEAAoE;IACpE,0EAA0E;IAC1E,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAClG,KAAK,CAAC,IAAI,CACR;YACE,iCAAiC,KAAK,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,GAAG;YAC5E,yFAAyF,KAAK,CAAC,YAAY,CAAC,IAAI,yNAAyN;YACzU,iCAAiC;SAClC,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC;QACnC,KAAK,CAAC,IAAI,CACR;YACE,kBAAkB,KAAK,CAAC;gBACtB,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI;gBACtB,YAAY,EAAE,EAAE,CAAC,YAAY,IAAI,WAAW;gBAC5C,UAAU,EAAE,EAAE,CAAC,UAAU;gBACzB,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;gBAC9C,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI;aACvB,CAAC,GAAG;YACL,KAAK,CAAC,KAAK,CAAC,OAAO;YACnB,kBAAkB;SACnB,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,0BAA0B,GAAG,EAAE,CAAC;AAEtC,SAAS,gBAAgB,CAAC,IAAY,EAAE,IAAmB;IACzD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,SAAS,CAAC,cAAc,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC,cAAc,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;IAChC,IAAI,UAAU,IAAI,0BAA0B,EAAE,CAAC;QAC7C,OAAO,iBAAiB,KAAK,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,MAAM,IAAI,mBAAmB,CAAC;IAChG,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,0BAA0B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtE,MAAM,SAAS,GAAG,UAAU,GAAG,0BAA0B,CAAC;IAC1D,OAAO,iBAAiB,KAAK,CAAC;QAC5B,IAAI;QACJ,WAAW,EAAE,UAAU;QACvB,aAAa,EAAE,KAAK,0BAA0B,EAAE;KACjD,CAAC;EACF,OAAO;OACF,SAAS,aAAa,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,oBAAoB,IAAI;gBAC/D,CAAC;AACjB,CAAC;AAED,SAAS,gBAAgB,CAAC,WAAyB;IACjD,MAAM,KAAK,GAAa,CAAC,eAAe,CAAC,CAAC;IAC1C,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,iBAAiB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;IAC/G,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC7B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAwB;IACxD,MAAM,EACJ,WAAW,EACX,GAAG,EACH,QAAQ,EACR,eAAe,EACf,eAAe,EACf,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,WAAW,GAAG,EAAE,EAChB,QAAQ,GAAG,KAAK,EAChB,WAAW,GAAG,IAAI,EAClB,kBAAkB,GAAG,KAAK,EAC1B,YAAY,GAAG,IAAI,EACnB,WAAW,GAAG,MAAM,EACpB,KAAK,GAAG,IAAI,GACb,GAAG,KAAK,CAAC;IAEV,0EAA0E;IAC1E,uEAAuE;IACvE,sEAAsE;IACtE,sEAAsE;IACtE,IAAI,WAAW,KAAK,OAAO,EAAE,CAAC;QAC5B,OAAO,sBAAsB,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,CAAC;IACxF,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC;IAEvC,0EAA0E;IAC1E,kDAAkD;IAClD,+DAA+D;IAC/D,MAAM,YAAY,GAAoC;QACpD,IAAI,EAAE,WAAW;QACjB,GAAG;QACH,QAAQ;QACR,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,YAAY;KACvB,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,UAAU,CAAC,YAAY,EAAE,EAAE,CAAC;QAC1C,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ;YAAE,SAAS,CAAC,2BAA2B;QACnE,MAAM,KAAK,GAAG,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,KAAK,CAAC;QAC7C,YAAY,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;IACD,YAAY,CAAC,IAAI,GAAG,QAAQ,CAAC;IAC7B,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAEtD,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAE7C,IAAI,kBAAkB,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,YAAY,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,eAAe,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,WAAW,IAAI,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzD,KAAK,CAAC,IAAI,CACR,iBAAiB,KAAK,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,cAAc,EAAE,CAAC,MAAM,WAAW,CAAC,OAAO,mBAAmB,CAC5G,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC"}

package/dist/server/services/chat.d.ts

@@ -0,0 +1,50 @@
+import type Database from 'better-sqlite3';
+import type { ChatContextType, ChatMessage, ChatMessageStatus, ChatRole, ChatSubagentTask, ChatThread, ChatThreadMeta, TodoItem, UsageStats } from '../../shared/entities.js';
+export declare class ChatService {
+    private db;
+    constructor(db: Database.Database);
+    createThread(title?: string | null, opts?: {
+        contextType?: ChatContextType;
+        briefPath?: string | null;
+    }): ChatThread;
+    /** M21: list threads attached to a brief (path-keyed lookup). */
+    listThreadsForBrief(briefPath: string): ChatThreadMeta[];
+    /** M21: count threads for a brief (cheap version of listThreadsForBrief for list UI). */
+    threadCountForBrief(briefPath: string): number;
+    listThreads(): ChatThreadMeta[];
+    getThread(id: string, limit?: number, offset?: number): {
+        thread: ChatThread;
+        messages: ChatMessage[];
+        subagentTasks: ChatSubagentTask[];
+    } | null;
+    getThreadMeta(id: string): ChatThread | null;
+    deleteThread(id: string): {
+        deleted: true;
+    };
+    addMessage(threadId: string, role: ChatRole, content: string, toolName?: string | null, toolId?: string | null, subagentTaskId?: string | null, planMode?: boolean, status?: ChatMessageStatus): ChatMessage;
+    startSubagentTask(threadId: string, taskId: string, description: string, toolUseId: string | null): void;
+    updateSubagentTaskProgress(threadId: string, taskId: string, description: string): void;
+    completeSubagentTask(threadId: string, taskId: string, status: string, summary: string | null): void;
+    listSubagentTasks(threadId: string): ChatSubagentTask[];
+    getMessages(threadId: string, limit?: number, offset?: number): ChatMessage[];
+    updateTitle(threadId: string, title: string): void;
+    setLastSessionId(threadId: string, sessionId: string): void;
+    setInitialSystemPrompt(threadId: string, prompt: string): void;
+    getInitialSystemPrompt(threadId: string): string | null;
+    setLastUsage(threadId: string, usage: UsageStats): void;
+    attachTurnUsage(threadId: string, messageId: number, usage: UsageStats): void;
+    setLastContextSize(threadId: string, contextSize: number): void;
+    attachTurnContextSize(threadId: string, messageId: number, contextSize: number): void;
+    markToolUseComplete(threadId: string, toolUseId: string): void;
+    finalizeStreamingRows(threadId: string): void;
+    finalizeAllStreamingRows(): void;
+    updateCurrentTodoItems(threadId: string, items: TodoItem[] | null): void;
+    updateThreadSettings(threadId: string, patch: {
+        planMode?: boolean;
+    }): ChatThread;
+    private findThread;
+    private getThreadRow;
+    private hydrateThread;
+    private hydrateMessage;
+    private hydrateSubagentTask;
+}