@cat-factory/agents 0.20.2 → 0.21.0

package/dist/agents/kinds/companions.d.ts

@@ -8,6 +8,21 @@ export interface CompanionDefinition {
     defaultThreshold: number;
     /** Short label for the producer being reviewed, woven into the companion's prompt. */
     reviews: string;
+    /**
+     * HOW the companion runs its review.
+     *   - `inline` (default): a one-shot LLM call that grades the producer's reported output
+     *     text — adequate when the producer's deliverable IS that text (e.g. the architect's
+     *     prose plan).
+     *   - `container-explore`: a read-only container that CLONES the producer's PR branch and
+     *     reads the ACTUAL repository (the changed files / the full document) with tools before
+     *     judging, returning the verdict as structured JSON. Required whenever the producer's
+     *     real deliverable is committed to the repo rather than reported in its reply — a code
+     *     reviewer that only sees a summary is useless, and the same is true of a document
+     *     reviewer. The engine dispatches these through the same async container path the
+     *     coder/merger use (see `CompositeAgentExecutor` / `ContainerAgentExecutor`) and resolves
+     *     the verdict in `recordStepResult` → `CompanionController.resolveContainerVerdict`.
+     */
+    surface?: 'inline' | 'container-explore';
 }
 /** The built-in companion catalog. */
 export declare const COMPANIONS: CompanionDefinition[];
@@ -17,4 +32,12 @@ export declare function isCompanionKind(kind: AgentKind): boolean;
 export declare function companionFor(kind: AgentKind): CompanionDefinition | undefined;
 /** The producer kinds a companion may be attached to (empty if not a companion). */
 export declare function companionTargets(kind: AgentKind): AgentKind[];
+/**
+ * Whether `kind` is a companion that reviews in a CONTAINER (cloning the producer's PR
+ * branch and reading the real repository) rather than inline. The single source of truth
+ * the executor uses to route the companion through the container path, the engine uses to
+ * keep it off the inline companion path, and the prompt uses to tell it to read the
+ * checkout. False for non-companions and inline companions.
+ */
+export declare function isContainerBackedCompanion(kind: AgentKind): boolean;
 //# sourceMappingURL=companions.d.ts.map

package/dist/agents/kinds/companions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"companions.d.ts","sourceRoot":"","sources":["../../../src/agents/kinds/companions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAYpD,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,IAAI,EAAE,SAAS,CAAA;IACf,oFAAoF;IACpF,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB,0FAA0F;IAC1F,gBAAgB,EAAE,MAAM,CAAA;IACxB,sFAAsF;IACtF,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,sCAAsC;AACtC,eAAO,MAAM,UAAU,EAAE,mBAAmB,EAuB3C,CAAA;AAID,0FAA0F;AAC1F,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAExD;AAED,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,mBAAmB,GAAG,SAAS,CAE7E;AAED,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,EAAE,CAE7D"}
+{"version":3,"file":"companions.d.ts","sourceRoot":"","sources":["../../../src/agents/kinds/companions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAYpD,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,IAAI,EAAE,SAAS,CAAA;IACf,oFAAoF;IACpF,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB,0FAA0F;IAC1F,gBAAgB,EAAE,MAAM,CAAA;IACxB,sFAAsF;IACtF,OAAO,EAAE,MAAM,CAAA;IACf;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,EAAE,QAAQ,GAAG,mBAAmB,CAAA;CACzC;AAED,sCAAsC;AACtC,eAAO,MAAM,UAAU,EAAE,mBAAmB,EAwC3C,CAAA;AAID,0FAA0F;AAC1F,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAExD;AAED,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,mBAAmB,GAAG,SAAS,CAE7E;AAED,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,EAAE,CAE7D;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAEnE"}

package/dist/agents/kinds/companions.js

@@ -17,10 +17,26 @@ export const COMPANIONS = [
     {
         // `reviewer` is the coder's companion: it directly challenges the builder's
         // output and can loop it back for rework. Auto-only by default (no human gate).
+        // It runs in a container so it reads the ACTUAL diff / repository, not just the
+        // coder's summary reply — a code review of a summary is worthless.
         kind: 'reviewer',
         targets: ['coder'],
         defaultThreshold: DEFAULT_COMPANION_THRESHOLD,
         reviews: 'code change for correctness, quality, security and risk',
+        surface: 'container-explore',
+    },
+    {
+        // `doc-reviewer` is the document writer's companion: it rates the drafted document and
+        // loops the `doc-writer` back for rework below the threshold (the AI-to-AI convergence
+        // loop of the document-authoring pipeline, before the human gate on this step).
+        kind: 'doc-reviewer',
+        targets: ['doc-writer'],
+        defaultThreshold: DEFAULT_COMPANION_THRESHOLD,
+        reviews: 'document draft for completeness against the brief, clarity, accuracy and fitness of its ' +
+            'structure for the document kind',
+        // Runs in a container so it reads the ACTUAL committed Markdown (the whole point of the
+        // document pipeline), not the writer's summary reply.
+        surface: 'container-explore',
     },
 ];
 const BY_KIND = new Map(COMPANIONS.map((c) => [c.kind, c]));
@@ -36,4 +52,14 @@ export function companionFor(kind) {
 export function companionTargets(kind) {
     return BY_KIND.get(kind)?.targets ?? [];
 }
+/**
+ * Whether `kind` is a companion that reviews in a CONTAINER (cloning the producer's PR
+ * branch and reading the real repository) rather than inline. The single source of truth
+ * the executor uses to route the companion through the container path, the engine uses to
+ * keep it off the inline companion path, and the prompt uses to tell it to read the
+ * checkout. False for non-companions and inline companions.
+ */
+export function isContainerBackedCompanion(kind) {
+    return BY_KIND.get(kind)?.surface === 'container-explore';
+}
 //# sourceMappingURL=companions.js.map

package/dist/agents/kinds/companions.js.map

@@ -1 +1 @@
-{"version":3,"file":"companions.js","sourceRoot":"","sources":["../../../src/agents/kinds/companions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAA;AAsBpE,sCAAsC;AACtC,MAAM,CAAC,MAAM,UAAU,GAA0B;IAC/C;QACE,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,CAAC,WAAW,CAAC;QACtB,gBAAgB,EAAE,2BAA2B;QAC7C,OAAO,EAAE,yCAAyC;KACnD;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,CAAC,aAAa,CAAC;QACxB,gBAAgB,EAAE,2BAA2B;QAC7C,OAAO,EACL,mFAAmF;YACnF,kDAAkD;KACrD;IACD;QACE,4EAA4E;QAC5E,gFAAgF;QAChF,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,CAAC,OAAO,CAAC;QAClB,gBAAgB,EAAE,2BAA2B;QAC7C,OAAO,EAAE,yDAAyD;KACnE;CACF,CAAA;AAED,MAAM,OAAO,GAAG,IAAI,GAAG,CAA8B,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;AAExF,0FAA0F;AAC1F,MAAM,UAAU,eAAe,CAAC,IAAe;IAC7C,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;AAC1B,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,YAAY,CAAC,IAAe;IAC1C,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;AAC1B,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,gBAAgB,CAAC,IAAe;IAC9C,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,IAAI,EAAE,CAAA;AACzC,CAAC"}
+{"version":3,"file":"companions.js","sourceRoot":"","sources":["../../../src/agents/kinds/companions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAA;AAqCpE,sCAAsC;AACtC,MAAM,CAAC,MAAM,UAAU,GAA0B;IAC/C;QACE,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,CAAC,WAAW,CAAC;QACtB,gBAAgB,EAAE,2BAA2B;QAC7C,OAAO,EAAE,yCAAyC;KACnD;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,CAAC,aAAa,CAAC;QACxB,gBAAgB,EAAE,2BAA2B;QAC7C,OAAO,EACL,mFAAmF;YACnF,kDAAkD;KACrD;IACD;QACE,4EAA4E;QAC5E,gFAAgF;QAChF,gFAAgF;QAChF,mEAAmE;QACnE,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,CAAC,OAAO,CAAC;QAClB,gBAAgB,EAAE,2BAA2B;QAC7C,OAAO,EAAE,yDAAyD;QAClE,OAAO,EAAE,mBAAmB;KAC7B;IACD;QACE,uFAAuF;QACvF,uFAAuF;QACvF,gFAAgF;QAChF,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,CAAC,YAAY,CAAC;QACvB,gBAAgB,EAAE,2BAA2B;QAC7C,OAAO,EACL,0FAA0F;YAC1F,iCAAiC;QACnC,wFAAwF;QACxF,sDAAsD;QACtD,OAAO,EAAE,mBAAmB;KAC7B;CACF,CAAA;AAED,MAAM,OAAO,GAAG,IAAI,GAAG,CAA8B,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;AAExF,0FAA0F;AAC1F,MAAM,UAAU,eAAe,CAAC,IAAe;IAC7C,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;AAC1B,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,YAAY,CAAC,IAAe;IAC1C,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;AAC1B,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,gBAAgB,CAAC,IAAe;IAC9C,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,IAAI,EAAE,CAAA;AACzC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAe;IACxD,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,mBAAmB,CAAA;AAC3D,CAAC"}

package/dist/agents/kinds/document.d.ts

@@ -0,0 +1,15 @@
+import type { AgentKindDefinition } from './registry.js';
+export declare const DOC_RESEARCHER_KIND = "doc-researcher";
+export declare const DOC_OUTLINER_KIND = "doc-outliner";
+export declare const DOC_WRITER_KIND = "doc-writer";
+export declare const DOC_FINALIZER_KIND = "doc-finalizer";
+/** The companion that reviews {@link DOC_WRITER_KIND}; its definition lives in ./companions. */
+export declare const DOC_REVIEWER_KIND = "doc-reviewer";
+/** The document-authoring kinds (the companion `doc-reviewer` is defined in ./companions). */
+export declare const DOCUMENT_AGENT_KINDS: AgentKindDefinition[];
+/**
+ * Register the document-authoring kinds. Idempotent (the registry replaces by kind), so calling
+ * it explicitly and importing this module for its side effect are safe to combine.
+ */
+export declare function registerDocumentAgents(): void;
+//# sourceMappingURL=document.d.ts.map

package/dist/agents/kinds/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../../src/agents/kinds/document.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AA2BxD,eAAO,MAAM,mBAAmB,mBAAmB,CAAA;AACnD,eAAO,MAAM,iBAAiB,iBAAiB,CAAA;AAC/C,eAAO,MAAM,eAAe,eAAe,CAAA;AAC3C,eAAO,MAAM,kBAAkB,kBAAkB,CAAA;AACjD,gGAAgG;AAChG,eAAO,MAAM,iBAAiB,iBAAiB,CAAA;AAwL/C,8FAA8F;AAC9F,eAAO,MAAM,oBAAoB,EAAE,mBAAmB,EAiErD,CAAA;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/dist/agents/kinds/document.js

@@ -0,0 +1,258 @@
+import { CONTEXT_BUDGET, estimateTokens } from '@cat-factory/kernel';
+import { registerAgentKinds } from './registry.js';
+import { linkedContextSection } from '../prompts/standard.js';
+// ---------------------------------------------------------------------------
+// The document-authoring agent kinds — a FORWARD-authoring track whose deliverable IS an
+// in-repo Markdown document (a PRD / RFC / design doc / ADR / technical reference / runbook /
+// research report) shipped as a pull request, distinct from the reverse-documentation kinds
+// (`documenter` / `business-documenter` / `blueprints`) that describe code that already exists.
+//
+// They are registered through the SAME public `registerAgentKind` seam a deployment uses
+// (see `backend/internal/example-custom-agent`), so they become first-class palette blocks
+// (via the workspace snapshot's `customAgentKinds`) with NO bespoke harness handler:
+//   - `doc-researcher` / `doc-outliner` are INLINE (one-shot LLM, no checkout); their prose
+//     output flows to the writer as prior-step context.
+//   - `doc-writer` is CONTAINER-CODING with a non-`pr` clone, so the generic coding harness
+//     branches off base, writes the Markdown file, pushes the work branch and OPENS a PR —
+//     exactly the coder lifecycle (`ContainerAgentExecutor.buildRegisteredAgentBody`). Its
+//     companion `doc-reviewer` (see ./companions) rates the draft and loops it back for rework.
+//   - `doc-finalizer` is CONTAINER-CODING with a `pr` clone, so it polishes in place on the
+//     doc PR branch and pushes back (no new PR), fixer-like — it also folds in the human
+//     gate's revision feedback (threaded automatically by `withRevision`).
+//
+// The merge tail (`conflicts → ci → merger`) then ships the document PR like any other.
+// Nothing is persisted to a new table: the committed Markdown is the durable artifact.
+// ---------------------------------------------------------------------------
+export const DOC_RESEARCHER_KIND = 'doc-researcher';
+export const DOC_OUTLINER_KIND = 'doc-outliner';
+export const DOC_WRITER_KIND = 'doc-writer';
+export const DOC_FINALIZER_KIND = 'doc-finalizer';
+/** The companion that reviews {@link DOC_WRITER_KIND}; its definition lives in ./companions. */
+export const DOC_REVIEWER_KIND = 'doc-reviewer';
+/** Filesystem-safe slug for a document title (the default file name under `docs/<kind>/`). */
+function docSlug(title) {
+    const slug = title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    return slug || 'document';
+}
+/** The default in-repo directory each document kind is written under (overridable per task). */
+const DOC_KIND_DIR = {
+    prd: 'docs/prd',
+    rfc: 'docs/rfc',
+    adr: 'docs/adr',
+    design: 'docs/design',
+    technical: 'docs/technical',
+    api: 'docs/api',
+    runbook: 'docs/runbooks',
+    research: 'docs/research',
+    reference: 'docs/reference',
+    other: 'docs',
+};
+/** One-line structural expectation per document kind, woven into the outliner/writer prompts. */
+const DOC_KIND_STRUCTURE = {
+    prd: 'a product requirements document: problem & goals, target users, user stories, scope (in/out), functional requirements, acceptance criteria, success metrics, risks & open questions',
+    rfc: 'an RFC / design proposal: summary, motivation, detailed design, alternatives considered (with trade-offs), drawbacks, migration/rollout, unresolved questions',
+    adr: 'an architecture decision record: context, the decision, status, considered options with trade-offs, consequences (positive & negative)',
+    design: 'a technical design document: overview, goals/non-goals, architecture, key components & data flows, interfaces, alternatives, risks',
+    technical: 'a technical reference: purpose, concepts, step-by-step usage, configuration, examples, troubleshooting',
+    api: 'an API reference: overview & auth, each endpoint/operation (request, parameters, responses, errors), and worked examples',
+    runbook: 'an operational runbook: when to use it, prerequisites, numbered step-by-step procedure, verification, rollback, and escalation',
+    research: 'a research / analysis report: question, method, findings, comparison of options, recommendation, and references',
+    reference: 'a clear reference document organised by topic with a short overview and a navigable section structure',
+    other: 'a well-structured document with a short overview followed by clearly-headed sections',
+};
+/** The document fields on the task, defaulting `docKind` to `other` when unset. */
+function docFields(context) {
+    const fields = context.block.taskTypeFields;
+    const docKind = (fields?.docKind ?? 'other');
+    const targetPath = fields?.targetPath?.trim() || `${DOC_KIND_DIR[docKind]}/${docSlug(context.block.title)}.md`;
+    return {
+        docKind,
+        audience: fields?.audience?.trim() || undefined,
+        targetPath,
+        outlineHints: fields?.outlineHints?.trim() || undefined,
+    };
+}
+/** The shared "what document are we writing" brief woven into every doc-kind prompt. */
+function docBriefSection(context, opts) {
+    const { docKind, audience, targetPath, outlineHints } = docFields(context);
+    const lines = [
+        `Document title: ${context.block.title}`,
+        `Document kind: ${docKind} — produce ${DOC_KIND_STRUCTURE[docKind]}.`,
+        `Target file: \`${targetPath}\` (Markdown).`,
+    ];
+    if (audience)
+        lines.push(`Intended audience: ${audience}. Pitch the depth and tone for them.`);
+    lines.push(`Brief / requirements: ${context.block.description?.trim() || '(none provided — infer from the title and any linked context)'}`);
+    if (outlineHints)
+        lines.push(`Author-provided outline hints: ${outlineHints}`);
+    const linked = linkedContextSection(context, opts);
+    if (linked)
+        lines.push(linked);
+    return lines.join('\n');
+}
+/**
+ * Render the prior steps' work (the research brief, the approved outline) for a later step,
+ * trimmed to a shared token budget so a long research brief + outline + writer summary +
+ * reviewer feedback can't bloat the prompt unbounded (the writer/finalizer also receive the
+ * materialised linked context, which is budgeted separately). Each section is clamped to what
+ * remains, oldest-first, with a marker when truncated.
+ */
+function priorWorkSection(context) {
+    if (!context.priorOutputs.length)
+        return '';
+    const lines = ['', 'Work from earlier steps in this pipeline (build on it, do not repeat it):'];
+    let remaining = CONTEXT_BUDGET.inlineBodyTokens;
+    for (const p of context.priorOutputs) {
+        if (remaining <= 0) {
+            lines.push('### (earlier steps omitted — prior-work budget reached)');
+            break;
+        }
+        const body = clampToBudget(p.output ?? '', remaining);
+        remaining -= estimateTokens(body);
+        lines.push(`### ${p.agentKind}`, body);
+    }
+    return lines.join('\n');
+}
+/** Clamp text to roughly `maxTokens`, appending an ellipsis marker when it was cut. */
+function clampToBudget(text, maxTokens) {
+    if (estimateTokens(text) <= maxTokens)
+        return text;
+    // estimateTokens is ~chars/4, so budget the character slice the same way.
+    const maxChars = Math.max(0, maxTokens * 4);
+    return `${text.slice(0, maxChars).trimEnd()}\n…(truncated)`;
+}
+const DOC_RESEARCHER_SYSTEM_PROMPT = 'You are a documentation researcher. Before a document is drafted, investigate everything ' +
+    'needed to write it well: the problem space, prior art, any linked requirements / RFCs / ' +
+    'tracker issues, relevant standards and constraints, and the open questions a good author ' +
+    'would need answered. Produce a concise, well-organised research brief — facts, sources and ' +
+    'the key decisions to make — NOT the document itself. Flag gaps and assumptions explicitly.';
+const DOC_OUTLINER_SYSTEM_PROMPT = 'You are a documentation outliner. Turn the brief and any research into a clear, ' +
+    'kind-appropriate outline for the document: the ordered sections with a one-line statement ' +
+    'of what each will cover, plus any cross-cutting notes (terminology, diagrams to include, ' +
+    'open questions to resolve). The outline is reviewed by a human before drafting, so make it ' +
+    'specific and easy to critique. Do NOT write the prose — only the structure.';
+const DOC_WRITER_SYSTEM_PROMPT = 'You are a senior technical writer. Write the complete document as Markdown, following the ' +
+    'approved outline and folding in the research and any linked context. Write the file at the ' +
+    'target path given in the task (create the directory as needed); write ONLY that document — ' +
+    'do not touch code or unrelated files. Lead with a short overview/summary, use clear headings, ' +
+    'concrete examples and tables where they help, and keep the prose precise and self-contained. ' +
+    'When the document describes the codebase, read the relevant code to get details right. The ' +
+    'platform commits your file and opens the pull request — do not run git yourself.';
+const DOC_FINALIZER_SYSTEM_PROMPT = 'You are a documentation editor doing the final pass on a drafted document. Improve clarity, ' +
+    'consistency and flow; fix structure, headings, terminology, links and formatting; tighten the ' +
+    'overview/summary; and resolve any reviewer feedback. Preserve the substance — do not rewrite ' +
+    'from scratch or change the meaning. Edit the existing document file in place and only that ' +
+    'file. The platform commits and pushes your changes — do not run git yourself.';
+function docResearcherUserPrompt(context) {
+    return [
+        `Pipeline: ${context.pipelineName}`,
+        docBriefSection(context, {}),
+        '',
+        'Produce the research brief for this document. Be concise and concrete.',
+    ].join('\n');
+}
+function docOutlinerUserPrompt(context) {
+    return [
+        `Pipeline: ${context.pipelineName}`,
+        docBriefSection(context, {}),
+        priorWorkSection(context),
+        '',
+        'Produce the outline (sections + one-line intent each). Do not write the prose.',
+    ].join('\n');
+}
+function docWriterUserPrompt(context) {
+    const { targetPath } = docFields(context);
+    return [
+        `Pipeline: ${context.pipelineName}`,
+        docBriefSection(context, { materialized: true }),
+        priorWorkSection(context),
+        '',
+        `Write the full document to \`${targetPath}\` as Markdown, following the approved outline.`,
+    ].join('\n');
+}
+function docFinalizerUserPrompt(context) {
+    const { targetPath } = docFields(context);
+    return [
+        `Pipeline: ${context.pipelineName}`,
+        docBriefSection(context, { materialized: true }),
+        priorWorkSection(context),
+        '',
+        `Polish the document at \`${targetPath}\` — clarity, consistency, structure and formatting — ` +
+            'and apply any reviewer feedback. Edit it in place; do not rewrite from scratch.',
+    ].join('\n');
+}
+/** The document-authoring kinds (the companion `doc-reviewer` is defined in ./companions). */
+export const DOCUMENT_AGENT_KINDS = [
+    {
+        kind: DOC_RESEARCHER_KIND,
+        systemPrompt: DOC_RESEARCHER_SYSTEM_PROMPT,
+        userPrompt: docResearcherUserPrompt,
+        agent: { surface: 'inline' },
+        webResearchHint: 'gather current prior art, standards and references for the document being written',
+        presentation: {
+            label: 'Doc Researcher',
+            icon: 'i-lucide-book-marked',
+            color: '#38bdf8',
+            description: 'Investigates the topic, prior art and linked context, producing a research brief before a document is drafted.',
+            category: 'docs',
+        },
+    },
+    {
+        kind: DOC_OUTLINER_KIND,
+        systemPrompt: DOC_OUTLINER_SYSTEM_PROMPT,
+        userPrompt: docOutlinerUserPrompt,
+        agent: { surface: 'inline' },
+        presentation: {
+            label: 'Doc Outliner',
+            icon: 'i-lucide-list-tree',
+            color: '#818cf8',
+            description: 'Turns the brief and research into a kind-appropriate document outline for human review before drafting.',
+            category: 'docs',
+        },
+    },
+    {
+        kind: DOC_WRITER_KIND,
+        systemPrompt: DOC_WRITER_SYSTEM_PROMPT,
+        userPrompt: docWriterUserPrompt,
+        // Container-coding with a `work` clone ⇒ the generic coding harness branches off base,
+        // writes the Markdown, pushes the work branch and opens the PR (coder-like). Its companion
+        // `doc-reviewer` loops it back for rework below threshold.
+        agent: { surface: 'container-coding', clone: { branch: 'work' } },
+        presentation: {
+            label: 'Doc Writer',
+            icon: 'i-lucide-file-pen-line',
+            color: '#818cf8',
+            description: 'Writes the document as in-repo Markdown following the approved outline, and opens a pull request.',
+            category: 'docs',
+        },
+    },
+    {
+        kind: DOC_FINALIZER_KIND,
+        systemPrompt: DOC_FINALIZER_SYSTEM_PROMPT,
+        userPrompt: docFinalizerUserPrompt,
+        // Container-coding with a `pr` clone ⇒ polish in place on the document PR branch and push
+        // back (no new PR), fixer-like. The human gate's revision feedback is threaded in by
+        // `withRevision` (catalog.ts), so the editor addresses it on this pass.
+        agent: { surface: 'container-coding', clone: { branch: 'pr' } },
+        presentation: {
+            label: 'Doc Finalizer',
+            icon: 'i-lucide-file-check-2',
+            color: '#818cf8',
+            description: 'Final editorial pass over the drafted document — clarity, consistency, formatting and reviewer feedback.',
+            category: 'docs',
+        },
+    },
+];
+/**
+ * Register the document-authoring kinds. Idempotent (the registry replaces by kind), so calling
+ * it explicitly and importing this module for its side effect are safe to combine.
+ */
+export function registerDocumentAgents() {
+    registerAgentKinds(DOCUMENT_AGENT_KINDS);
+}
+// Side-effect registration: importing `@cat-factory/agents` registers these first-class kinds.
+registerDocumentAgents();
+//# sourceMappingURL=document.js.map

package/dist/agents/kinds/document.js.map

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

package/dist/agents/prompts/companion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"companion.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/companion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AASpD,2FAA2F;AAC3F,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAkEzE"}
+{"version":3,"file":"companion.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/companion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AASpD,2FAA2F;AAC3F,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAiFzE"}

package/dist/agents/prompts/companion.js

@@ -1,4 +1,4 @@
-import { companionFor } from '../kinds/companions.js';
+import { companionFor, isContainerBackedCompanion } from '../kinds/companions.js';
 import { FINAL_ANSWER_IN_REPLY } from './shared.js';
 // System prompt for a companion agent, parameterised by the producer kind it
 // reviews. The companion returns a single overall quality rating (0..1) plus prose
@@ -16,6 +16,21 @@ export function companionSystemPrompt(kind) {
         'anything that would block confident downstream work. Then give a SINGLE overall quality',
         'rating between 0 and 1 (1 = excellent and complete, 0 = unusable). Be a fair but demanding',
         'critic — do not rubber-stamp.',
+        // A container-backed companion gets a real, read-only checkout of the producer's PR
+        // branch. Reviewing the producer's summary reply alone is worthless — judge the ACTUAL
+        // artifact: open and read the changed files / the full committed document and whatever
+        // surrounding repository context you need to assess it properly. The preceding step's
+        // reply (if any) is only a pointer; the repository on disk is the source of truth.
+        ...(isContainerBackedCompanion(kind)
+            ? [
+                '',
+                'You have a read-only checkout of the branch under review. Do NOT judge from the',
+                "summary alone: inspect what actually changed (diff the branch against the repo's",
+                'default/base branch), then open and read the changed files in full — plus any',
+                'related code or documents in the repository you need for context — before rating.',
+                'Ground every comment in what the files actually contain. Make no commits.',
+            ]
+            : []),
         // The spec-writer only TRANSLATES the task requirements it was given into a spec
         // increment; inventing, completing, or deciding requirements is the requirements
         // step's job, not its. So judge only what the writer controls — fidelity to the

package/dist/agents/prompts/companion.js.map

@@ -1 +1 @@
-{"version":3,"file":"companion.js","sourceRoot":"","sources":["../../../src/agents/prompts/companion.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAEnD,6EAA6E;AAC7E,mFAAmF;AACnF,mFAAmF;AACnF,+BAA+B;AAE/B,2FAA2F;AAC3F,MAAM,UAAU,qBAAqB,CAAC,IAAe;IACnD,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;IAC9B,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAA;IAC1B,OAAO;QACL,wDAAwD,GAAG,CAAC,OAAO,kBAAkB;QACrF,aAAa,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,oDAAoD;QACxF,qFAAqF;QACrF,yFAAyF;QACzF,4FAA4F;QAC5F,+BAA+B;QAC/B,iFAAiF;QACjF,iFAAiF;QACjF,gFAAgF;QAChF,mFAAmF;QACnF,kFAAkF;QAClF,8DAA8D;QAC9D,GAAG,CAAC,IAAI,KAAK,gBAAgB;YAC3B,CAAC,CAAC;gBACE,EAAE;gBACF,mFAAmF;gBACnF,2EAA2E;gBAC3E,qFAAqF;gBACrF,oFAAoF;gBACpF,aAAa;gBACb,kFAAkF;gBAClF,gFAAgF;gBAChF,8EAA8E;gBAC9E,mFAAmF;gBACnF,yEAAyE;gBACzE,2EAA2E;gBAC3E,+BAA+B;gBAC/B,6EAA6E;gBAC7E,kFAAkF;gBAClF,iFAAiF;gBACjF,kFAAkF;gBAClF,wDAAwD;gBACxD,kFAAkF;gBAClF,kFAAkF;gBAClF,0DAA0D;gBAC1D,EAAE;gBACF,mFAAmF;gBACnF,qFAAqF;gBACrF,mFAAmF;gBACnF,sEAAsE;gBACtE,8EAA8E;gBAC9E,kFAAkF;gBAClF,sFAAsF;gBACtF,kFAAkF;gBAClF,sFAAsF;gBACtF,qFAAqF;gBACrF,+EAA+E;aAChF;YACH,CAAC,CAAC,EAAE,CAAC;QACP,EAAE;QACF,0CAA0C;QAC1C,wFAAwF;QACxF,0FAA0F;QAC1F,oFAAoF;QACpF,oFAAoF;QACpF,GAAG,CAAC,IAAI,KAAK,gBAAgB;YAC3B,CAAC,CAAC,CAAC,kEAAkE,CAAC;YACtE,CAAC,CAAC,EAAE,CAAC;QACP,4CAA4C;QAC5C,EAAE;QACF,qBAAqB;KACtB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC"}
+{"version":3,"file":"companion.js","sourceRoot":"","sources":["../../../src/agents/prompts/companion.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAA;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAEnD,6EAA6E;AAC7E,mFAAmF;AACnF,mFAAmF;AACnF,+BAA+B;AAE/B,2FAA2F;AAC3F,MAAM,UAAU,qBAAqB,CAAC,IAAe;IACnD,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;IAC9B,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAA;IAC1B,OAAO;QACL,wDAAwD,GAAG,CAAC,OAAO,kBAAkB;QACrF,aAAa,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,oDAAoD;QACxF,qFAAqF;QACrF,yFAAyF;QACzF,4FAA4F;QAC5F,+BAA+B;QAC/B,oFAAoF;QACpF,uFAAuF;QACvF,uFAAuF;QACvF,sFAAsF;QACtF,mFAAmF;QACnF,GAAG,CAAC,0BAA0B,CAAC,IAAI,CAAC;YAClC,CAAC,CAAC;gBACE,EAAE;gBACF,iFAAiF;gBACjF,kFAAkF;gBAClF,+EAA+E;gBAC/E,mFAAmF;gBACnF,2EAA2E;aAC5E;YACH,CAAC,CAAC,EAAE,CAAC;QACP,iFAAiF;QACjF,iFAAiF;QACjF,gFAAgF;QAChF,mFAAmF;QACnF,kFAAkF;QAClF,8DAA8D;QAC9D,GAAG,CAAC,IAAI,KAAK,gBAAgB;YAC3B,CAAC,CAAC;gBACE,EAAE;gBACF,mFAAmF;gBACnF,2EAA2E;gBAC3E,qFAAqF;gBACrF,oFAAoF;gBACpF,aAAa;gBACb,kFAAkF;gBAClF,gFAAgF;gBAChF,8EAA8E;gBAC9E,mFAAmF;gBACnF,yEAAyE;gBACzE,2EAA2E;gBAC3E,+BAA+B;gBAC/B,6EAA6E;gBAC7E,kFAAkF;gBAClF,iFAAiF;gBACjF,kFAAkF;gBAClF,wDAAwD;gBACxD,kFAAkF;gBAClF,kFAAkF;gBAClF,0DAA0D;gBAC1D,EAAE;gBACF,mFAAmF;gBACnF,qFAAqF;gBACrF,mFAAmF;gBACnF,sEAAsE;gBACtE,8EAA8E;gBAC9E,kFAAkF;gBAClF,sFAAsF;gBACtF,kFAAkF;gBAClF,sFAAsF;gBACtF,qFAAqF;gBACrF,+EAA+E;aAChF;YACH,CAAC,CAAC,EAAE,CAAC;QACP,EAAE;QACF,0CAA0C;QAC1C,wFAAwF;QACxF,0FAA0F;QAC1F,oFAAoF;QACpF,oFAAoF;QACpF,GAAG,CAAC,IAAI,KAAK,gBAAgB;YAC3B,CAAC,CAAC,CAAC,kEAAkE,CAAC;YACtE,CAAC,CAAC,EAAE,CAAC;QACP,4CAA4C;QAC5C,EAAE;QACF,qBAAqB;KACtB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC"}

package/dist/index.d.ts

@@ -17,8 +17,9 @@ export { KAIZEN_SYSTEM_PROMPT } from './agents/prompts/kaizen.js';
 export { composeSystemPrompt, composeBlockSystemPrompt, type ComposableBlock, } from './agents/runtime/fragments.js';
 export { type StandardPhase, STANDARD_PHASES, STANDARD_PHASE_BY_KIND, phaseForKind, standardSystemPrompt, renderStandardUserPrompt, CONTEXT_DIR, } from './agents/prompts/standard.js';
 export { type AcceptanceAgentKind, ACCEPTANCE_AGENT_KINDS, acceptanceSystemPrompt, isAcceptanceKind, testApproachSection, } from './agents/prompts/acceptance.js';
-export { type CompanionDefinition, COMPANIONS, isCompanionKind, companionFor, companionTargets, } from './agents/kinds/companions.js';
+export { type CompanionDefinition, COMPANIONS, isCompanionKind, companionFor, companionTargets, isContainerBackedCompanion, } from './agents/kinds/companions.js';
 export { companionSystemPrompt } from './agents/prompts/companion.js';
+export { DOC_RESEARCHER_KIND, DOC_OUTLINER_KIND, DOC_WRITER_KIND, DOC_FINALIZER_KIND, DOC_REVIEWER_KIND, DOCUMENT_AGENT_KINDS, registerDocumentAgents, } from './agents/kinds/document.js';
 export { READ_ONLY_AGENT_KINDS, READ_ONLY_GUARDRAIL, isReadOnlyAgentKind, } from './agents/kinds/read-only.js';
 export { MOCK_AGENT_KIND, isMockKind, mockSystemPrompt } from './agents/prompts/mock.js';
 export { type BusinessLogicAgentKind, BUSINESS_LOGIC_AGENT_KINDS, BUSINESS_DOCUMENTER_KIND, BUSINESS_REVIEWER_KIND, BUSINESS_LOGIC_DOCS_DIR, isBusinessLogicKind, businessLogicSystemPrompt, } from './agents/prompts/business-logic.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -32,8 +32,13 @@ export { KAIZEN_SYSTEM_PROMPT } from './agents/prompts/kaizen.js';
 export { composeSystemPrompt, composeBlockSystemPrompt, } from './agents/runtime/fragments.js';
 export { STANDARD_PHASES, STANDARD_PHASE_BY_KIND, phaseForKind, standardSystemPrompt, renderStandardUserPrompt, CONTEXT_DIR, } from './agents/prompts/standard.js';
 export { ACCEPTANCE_AGENT_KINDS, acceptanceSystemPrompt, isAcceptanceKind, testApproachSection, } from './agents/prompts/acceptance.js';
-export { COMPANIONS, isCompanionKind, companionFor, companionTargets, } from './agents/kinds/companions.js';
+export { COMPANIONS, isCompanionKind, companionFor, companionTargets, isContainerBackedCompanion, } from './agents/kinds/companions.js';
 export { companionSystemPrompt } from './agents/prompts/companion.js';
+// The document-authoring agent kinds (doc-researcher / doc-outliner / doc-writer /
+// doc-finalizer), registered as a SIDE EFFECT of importing this module so they are
+// first-class kinds in every deployment (Worker / Node / local). `doc-reviewer` — the
+// writer's companion — lives in the COMPANIONS catalog above.
+export { DOC_RESEARCHER_KIND, DOC_OUTLINER_KIND, DOC_WRITER_KIND, DOC_FINALIZER_KIND, DOC_REVIEWER_KIND, DOCUMENT_AGENT_KINDS, registerDocumentAgents, } from './agents/kinds/document.js';
 export { READ_ONLY_AGENT_KINDS, READ_ONLY_GUARDRAIL, isReadOnlyAgentKind, } from './agents/kinds/read-only.js';
 export { MOCK_AGENT_KIND, isMockKind, mockSystemPrompt } from './agents/prompts/mock.js';
 export { BUSINESS_LOGIC_AGENT_KINDS, BUSINESS_DOCUMENTER_KIND, BUSINESS_REVIEWER_KIND, BUSINESS_LOGIC_DOCS_DIR, isBusinessLogicKind, businessLogicSystemPrompt, } from './agents/prompts/business-logic.js';

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/agents",
-  "version": "0.20.2",
+  "version": "0.21.0",
   "description": "Agent catalog, routing, prompts and fragment library for the Agent Architecture Board.",
   "repository": {
     "type": "git",
@@ -30,9 +30,9 @@
     "ai": "^6.0.209",
     "handlebars": "^4.7.9",
     "valibot": "^1.4.1",
-    "@cat-factory/contracts": "0.41.0",
-    "@cat-factory/kernel": "0.42.2",
-    "@cat-factory/prompt-fragments": "0.7.40"
+    "@cat-factory/contracts": "0.42.0",
+    "@cat-factory/kernel": "0.44.0",
+    "@cat-factory/prompt-fragments": "0.7.41"
   },
   "devDependencies": {
     "typescript": "7.0.1-rc",