@cat-factory/agents 0.6.0

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

@@ -0,0 +1,46 @@
+/** A prompt under version control: its stable id, integer version and text. */
+export interface VersionedPrompt {
+    id: string;
+    version: number;
+    text: string;
+}
+/** The currently-shipping version of each numbered prompt. */
+export declare const PROMPT_VERSIONS: {
+    readonly 'requirement-review': {
+        readonly id: 'requirement-review';
+        readonly version: 2;
+        readonly text: string;
+    };
+    readonly 'requirement-rework': {
+        readonly id: 'requirement-rework';
+        readonly version: 2;
+        readonly text: string;
+    };
+    readonly 'clarity-review': {
+        readonly id: 'clarity-review';
+        readonly version: 1;
+        readonly text: string;
+    };
+    readonly 'clarity-rework': {
+        readonly id: 'clarity-rework';
+        readonly version: 1;
+        readonly text: string;
+    };
+    readonly build: {
+        readonly id: 'build';
+        readonly version: 2;
+        readonly text: string;
+    };
+    readonly review: {
+        readonly id: 'review';
+        readonly version: 2;
+        readonly text: string;
+    };
+};
+/** Ids of the prompts currently under version control. */
+export type PromptId = keyof typeof PROMPT_VERSIONS;
+/** The current versioned prompt for an id. */
+export declare function promptVersion(id: PromptId): VersionedPrompt;
+/** The canonical `id@vN` label for a prompt id (or an explicit version). */
+export declare function promptVersionLabel(id: string, version?: number): string;
+//# sourceMappingURL=versions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"versions.d.ts","sourceRoot":"","sources":["../../../src/agents/kinds/versions.ts"],"names":[],"mappings":"AAeA,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;CACb;AAED,8DAA8D;AAC9D,eAAO,MAAM,eAAe;;iBACF,EAAE,EAAE,oBAAoB;iBAAE,OAAO,EAAE,CAAC;iBAAE,IAAI;;;iBAC1C,EAAE,EAAE,oBAAoB;iBAAE,OAAO,EAAE,CAAC;iBAAE,IAAI;;;iBAC9C,EAAE,EAAE,gBAAgB;iBAAE,OAAO,EAAE,CAAC;iBAAE,IAAI;;;iBACtC,EAAE,EAAE,gBAAgB;iBAAE,OAAO,EAAE,CAAC;iBAAE,IAAI;;;iBACjD,EAAE,EAAE,OAAO;iBAAE,OAAO,EAAE,CAAC;iBAAE,IAAI;;;iBAC5B,EAAE,EAAE,QAAQ;iBAAE,OAAO,EAAE,CAAC;iBAAE,IAAI;;CACU,CAAA;AAEpD,0DAA0D;AAC1D,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,eAAe,CAAA;AAEnD,8CAA8C;AAC9C,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,GAAG,eAAe,CAE3D;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAGvE"}

package/dist/agents/kinds/versions.js

@@ -0,0 +1,22 @@
+import { standardSystemPrompt } from '../prompts/standard.js';
+import { REVIEW_SYSTEM_PROMPT, REWORK_SYSTEM_PROMPT } from '../prompts/requirements.js';
+import { CLARITY_REVIEW_SYSTEM_PROMPT, CLARITY_REWORK_SYSTEM_PROMPT } from '../prompts/clarity.js';
+/** The currently-shipping version of each numbered prompt. */
+export const PROMPT_VERSIONS = {
+    'requirement-review': { id: 'requirement-review', version: 2, text: REVIEW_SYSTEM_PROMPT },
+    'requirement-rework': { id: 'requirement-rework', version: 2, text: REWORK_SYSTEM_PROMPT },
+    'clarity-review': { id: 'clarity-review', version: 1, text: CLARITY_REVIEW_SYSTEM_PROMPT },
+    'clarity-rework': { id: 'clarity-rework', version: 1, text: CLARITY_REWORK_SYSTEM_PROMPT },
+    build: { id: 'build', version: 2, text: standardSystemPrompt('build') },
+    review: { id: 'review', version: 2, text: standardSystemPrompt('review') },
+};
+/** The current versioned prompt for an id. */
+export function promptVersion(id) {
+    return PROMPT_VERSIONS[id];
+}
+/** The canonical `id@vN` label for a prompt id (or an explicit version). */
+export function promptVersionLabel(id, version) {
+    const v = version ?? (id in PROMPT_VERSIONS ? PROMPT_VERSIONS[id].version : 1);
+    return `${id}@v${v}`;
+}
+//# sourceMappingURL=versions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"versions.js","sourceRoot":"","sources":["../../../src/agents/kinds/versions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AACvF,OAAO,EAAE,4BAA4B,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAA;AAoBlG,8DAA8D;AAC9D,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,oBAAoB,EAAE,EAAE,EAAE,EAAE,oBAAoB,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE;IAC1F,oBAAoB,EAAE,EAAE,EAAE,EAAE,oBAAoB,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE;IAC1F,gBAAgB,EAAE,EAAE,EAAE,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,4BAA4B,EAAE;IAC1F,gBAAgB,EAAE,EAAE,EAAE,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,4BAA4B,EAAE;IAC1F,KAAK,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAAE;IACvE,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,oBAAoB,CAAC,QAAQ,CAAC,EAAE;CACxB,CAAA;AAKpD,8CAA8C;AAC9C,MAAM,UAAU,aAAa,CAAC,EAAY;IACxC,OAAO,eAAe,CAAC,EAAE,CAAC,CAAA;AAC5B,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,kBAAkB,CAAC,EAAU,EAAE,OAAgB;IAC7D,MAAM,CAAC,GAAG,OAAO,IAAI,CAAC,EAAE,IAAI,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,EAAc,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC1F,OAAO,GAAG,EAAE,KAAK,CAAC,EAAE,CAAA;AACtB,CAAC"}

package/dist/agents/mock-prompts.d.ts

@@ -0,0 +1,12 @@
+import type { AgentKind } from '@cat-factory/kernel';
+/** The single agent kind that builds external-dependency mocks. */
+export declare const MOCK_AGENT_KIND = "mocker";
+/** True when the agent kind is the mock-builder. */
+export declare function isMockKind(kind: AgentKind): boolean;
+/**
+ * The built-out system (role) prompt for the mock-builder agent kind, or
+ * `undefined` when the kind is not the mock builder (so callers can fall through
+ * to the standard phases / acceptance track / generic role).
+ */
+export declare function mockSystemPrompt(kind: AgentKind): string | undefined;
+//# sourceMappingURL=mock-prompts.d.ts.map

package/dist/agents/mock-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-prompts.d.ts","sourceRoot":"","sources":["../../src/agents/mock-prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAiBpD,mEAAmE;AACnE,eAAO,MAAM,eAAe,WAAW,CAAA;AAmCvC,oDAAoD;AACpD,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAEpE"}

package/dist/agents/mock-prompts.js

@@ -0,0 +1,61 @@
+import { STANDARDS_FOOTER } from './prompt-shared.js';
+// Built-out role prompt for the mock-builder agent. This kind stands up
+// WireMock-based mocks for the external SERVICES a building block depends on, so
+// the block can build, run and be tested locally and in CI without reaching real
+// third parties — in particular so end-to-end / Playwright suites pass on GitHub
+// Actions against the mocks rather than live APIs.
+//
+// Like the standard solution phases and the acceptance-testing track, "what the
+// agent should do" lives here and "which extra standards apply" stays in
+// @cat-factory/prompt-fragments: the prompt closes by deferring to the
+// best-practice fragments that `composeSystemPrompt` appends below it. The
+// dynamic run context (the block, its features, linked requirement docs and the
+// prior agents' output — where the external dependencies surface) is folded in by
+// the generic `userPromptFor`.
+/** The single agent kind that builds external-dependency mocks. */
+export const MOCK_AGENT_KIND = 'mocker';
+const SYSTEM_PROMPT = [
+    'You are an integration-test engineer owning the EXTERNAL-DEPENDENCY MOCKS for a building block.',
+    'Your goal: make the service runnable and usable LOCALLY with just `docker-compose up` — every external service it depends on answered by a WireMock mock, so it builds, runs and can be exercised end to end without reaching any real third party. This is what lets the later Tester step actually run the service.',
+    '',
+    'This is a HANDS-ON build step, not a write-up. You MUST inspect the repository, then create/extend the mock mappings, fixtures and wiring and COMMIT them. Do NOT merely restate what the implementer did, describe the dependencies in prose, or report "already covered" without having read the existing mappings and confirmed it. If the block calls external services that are not yet mocked, leaving them unmocked is a failure of this step. A commit with the new/updated mock files is the deliverable; the prose note is only a summary of what you committed.',
+    '',
+    'Scope — services, not infrastructure:',
+    '- Mock external SERVICES the block depends on: third-party / partner HTTP APIs, payment, email / SMS, auth or identity providers, and other internal services reached over the network.',
+    '- Do NOT mock owned infrastructure (databases, caches, queues, object storage) — those run as real local instances (e.g. containers) wired into docker-compose, not WireMock.',
+    '',
+    'Be incremental and additive:',
+    '- First discover what is already mocked: read the existing WireMock stub mappings, response fixtures and mock wiring already in the repository.',
+    '- Inventory the external calls the block actually makes — base URL, path, method, auth headers, request and response shapes — from the code and the design / prior work given to you.',
+    '- Add stubs ONLY for calls that are not mocked yet. Never duplicate, rewrite or delete an existing mapping; if an existing stub looks wrong, flag it rather than silently changing it.',
+    '',
+    'WireMock best practices:',
+    '- One stub mapping per external operation; match on method + URL path, adding header / query / body matchers only where they are needed to disambiguate — keep matchers as loose as correctness allows so they are not brittle.',
+    '- Return realistic, schema-faithful response bodies and status codes; cover the success path plus the error and edge responses the block must handle (4xx, 5xx, rate limits, timeouts).',
+    '- Keep mappings deterministic and self-contained: prefer JSON mapping files (with response bodies in `__files`) checked into the repo over programmatic stubs, and reach for response templating only where a dynamic echo is genuinely required.',
+    '- Organise mappings per upstream service and name each one after the operation it stands in for, so coverage is easy to read.',
+    '- Add a low-priority catch-all stub that fails loudly on any unmatched request, so a new, yet-unmocked call is caught instead of silently passing.',
+    '- Never hard-code real secrets in stubs; assert on the presence / shape of auth headers, not their real values.',
+    '',
+    'Hook the mocks up for local docker-compose and CI runs:',
+    "- Add the WireMock server to the service's docker-compose so a plain `docker-compose up` brings the mocks up alongside the real infra; point the block's external base URLs at it through environment variables / config, switched on for local dev and CI and off in production.",
+    '- Make it runnable in CI (e.g. a GitHub Actions service container or a start step) so end-to-end / Playwright tests pass on GHA against the mocks, waiting on a health check before the tests start.',
+    '- Document how to start the mocks and run the suite locally with the same configuration, so local and CI behave identically.',
+    '',
+    'Commit the WireMock mapping files, the response fixtures and the docker-compose / config / wiring changes. Then, as your prose output, list each external service and which of its operations are now mocked, and call out any external call you deliberately left unmocked and why.',
+    '',
+    STANDARDS_FOOTER,
+].join('\n');
+/** True when the agent kind is the mock-builder. */
+export function isMockKind(kind) {
+    return kind === MOCK_AGENT_KIND;
+}
+/**
+ * The built-out system (role) prompt for the mock-builder agent kind, or
+ * `undefined` when the kind is not the mock builder (so callers can fall through
+ * to the standard phases / acceptance track / generic role).
+ */
+export function mockSystemPrompt(kind) {
+    return isMockKind(kind) ? SYSTEM_PROMPT : undefined;
+}
+//# sourceMappingURL=mock-prompts.js.map

package/dist/agents/mock-prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-prompts.js","sourceRoot":"","sources":["../../src/agents/mock-prompts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAErD,wEAAwE;AACxE,iFAAiF;AACjF,iFAAiF;AACjF,iFAAiF;AACjF,mDAAmD;AACnD,EAAE;AACF,gFAAgF;AAChF,yEAAyE;AACzE,uEAAuE;AACvE,2EAA2E;AAC3E,gFAAgF;AAChF,kFAAkF;AAClF,+BAA+B;AAE/B,mEAAmE;AACnE,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CAAA;AAEvC,MAAM,aAAa,GAAG;IACpB,iGAAiG;IACjG,uTAAuT;IACvT,EAAE;IACF,4iBAA4iB;IAC5iB,EAAE;IACF,uCAAuC;IACvC,yLAAyL;IACzL,+KAA+K;IAC/K,EAAE;IACF,8BAA8B;IAC9B,iJAAiJ;IACjJ,uLAAuL;IACvL,wLAAwL;IACxL,EAAE;IACF,0BAA0B;IAC1B,iOAAiO;IACjO,yLAAyL;IACzL,mPAAmP;IACnP,+HAA+H;IAC/H,oJAAoJ;IACpJ,iHAAiH;IACjH,EAAE;IACF,yDAAyD;IACzD,mRAAmR;IACnR,sMAAsM;IACtM,8HAA8H;IAC9H,EAAE;IACF,sRAAsR;IACtR,EAAE;IACF,gBAAgB;CACjB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAEZ,oDAAoD;AACpD,MAAM,UAAU,UAAU,CAAC,IAAe;IACxC,OAAO,IAAI,KAAK,eAAe,CAAA;AACjC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAe;IAC9C,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAA;AACrD,CAAC"}

package/dist/agents/prompt-fragments.d.ts

@@ -0,0 +1,17 @@
+/** A block's fragment selection, as the prompt composer needs it. */
+export interface ComposableBlock {
+    fragmentIds?: string[];
+    resolvedFragments?: {
+        id: string;
+        body: string;
+    }[];
+}
+export declare function composeSystemPrompt(baseSystem: string, fragmentIds?: string[]): string;
+/**
+ * Compose the system prompt for a block, preferring the engine-resolved tenant
+ * catalog bodies when present and otherwise falling back to static id resolution.
+ * Both inline and container executors use this so the fragment-library feature
+ * applies uniformly to every agent kind, not just the reviewer.
+ */
+export declare function composeBlockSystemPrompt(baseSystem: string, block: ComposableBlock): string;
+//# sourceMappingURL=prompt-fragments.d.ts.map

package/dist/agents/prompt-fragments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-fragments.d.ts","sourceRoot":"","sources":["../../src/agents/prompt-fragments.ts"],"names":[],"mappings":"AAgBA,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,iBAAiB,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CACnD;AAcD,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,GAAE,MAAM,EAAO,GAAG,MAAM,CAM1F;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,MAAM,CAQ3F"}

package/dist/agents/prompt-fragments.js

@@ -0,0 +1,33 @@
+import { getFragment } from '@cat-factory/prompt-fragments';
+/** Fold a set of fragment bodies into the base system prompt under a header. */
+function foldStandards(baseSystem, bodies) {
+    if (bodies.length === 0)
+        return baseSystem;
+    return [
+        baseSystem,
+        '',
+        'Follow these standards while doing the work:',
+        '',
+        bodies.join('\n\n'),
+    ].join('\n');
+}
+export function composeSystemPrompt(baseSystem, fragmentIds = []) {
+    const bodies = fragmentIds
+        .map((id) => getFragment(id))
+        .filter((fragment) => fragment !== undefined)
+        .map((fragment) => fragment.body);
+    return foldStandards(baseSystem, bodies);
+}
+/**
+ * Compose the system prompt for a block, preferring the engine-resolved tenant
+ * catalog bodies when present and otherwise falling back to static id resolution.
+ * Both inline and container executors use this so the fragment-library feature
+ * applies uniformly to every agent kind, not just the reviewer.
+ */
+export function composeBlockSystemPrompt(baseSystem, block) {
+    if (block.resolvedFragments && block.resolvedFragments.length > 0) {
+        return foldStandards(baseSystem, block.resolvedFragments.map((f) => f.body));
+    }
+    return composeSystemPrompt(baseSystem, block.fragmentIds);
+}
+//# sourceMappingURL=prompt-fragments.js.map

package/dist/agents/prompt-fragments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-fragments.js","sourceRoot":"","sources":["../../src/agents/prompt-fragments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAsB3D,gFAAgF;AAChF,SAAS,aAAa,CAAC,UAAkB,EAAE,MAAgB;IACzD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,UAAU,CAAA;IAC1C,OAAO;QACL,UAAU;QACV,EAAE;QACF,8CAA8C;QAC9C,EAAE;QACF,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;KACpB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,UAAkB,EAAE,WAAW,GAAa,EAAE;IAChF,MAAM,MAAM,GAAG,WAAW;SACvB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;SAC5B,MAAM,CAAC,CAAC,QAAQ,EAA4C,EAAE,CAAC,QAAQ,KAAK,SAAS,CAAC;SACtF,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IACnC,OAAO,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,UAAkB,EAAE,KAAsB;IACjF,IAAI,KAAK,CAAC,iBAAiB,IAAI,KAAK,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClE,OAAO,aAAa,CAClB,UAAU,EACV,KAAK,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAC3C,CAAA;IACH,CAAC;IACD,OAAO,mBAAmB,CAAC,UAAU,EAAE,KAAK,CAAC,WAAW,CAAC,CAAA;AAC3D,CAAC"}

package/dist/agents/prompt-shared.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Closing line every role prompt appends before `composeSystemPrompt` folds in
+ * the user's selected best-practice fragments — it tells the agent to treat those
+ * appended standards as hard requirements rather than optional suggestions.
+ */
+export declare const STANDARDS_FOOTER = "Treat every best-practice standard appended below as a hard requirement, not a suggestion.";
+//# sourceMappingURL=prompt-shared.d.ts.map

package/dist/agents/prompt-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-shared.d.ts","sourceRoot":"","sources":["../../src/agents/prompt-shared.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,+FACiE,CAAA"}

package/dist/agents/prompt-shared.js

@@ -0,0 +1,10 @@
+// Shared constants used across the agent role prompts (standard solution phases,
+// acceptance-testing track, business-logic track and the mock prompts). Kept here
+// so the wording stays identical everywhere it is appended.
+/**
+ * Closing line every role prompt appends before `composeSystemPrompt` folds in
+ * the user's selected best-practice fragments — it tells the agent to treat those
+ * appended standards as hard requirements rather than optional suggestions.
+ */
+export const STANDARDS_FOOTER = 'Treat every best-practice standard appended below as a hard requirement, not a suggestion.';
+//# sourceMappingURL=prompt-shared.js.map

package/dist/agents/prompt-shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-shared.js","sourceRoot":"","sources":["../../src/agents/prompt-shared.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,kFAAkF;AAClF,4DAA4D;AAE5D;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAC3B,4FAA4F,CAAA"}

package/dist/agents/prompt-versions.d.ts

@@ -0,0 +1,48 @@
+export declare const REVIEW_SYSTEM_PROMPT: string;
+/**
+ * The "requirements rework" agent. Given a block's collected requirements plus the
+ * answers / dismissals a human gave to the reviewer's findings, it folds everything
+ * into ONE self-contained requirements document. The output is emitted in a fixed,
+ * standard structure so the service-level spec-writer can aggregate it with
+ * minimal synthesis (it mirrors that writer's own expectations: "The system SHALL …"
+ * statements, MoSCoW priorities, Given/When/Then acceptance criteria, and
+ * cross-cutting domain rules). It must produce this standard document even when the
+ * reviewer raised no findings — so every task can carry a clean, writer-ready spec.
+ */
+export declare const REWORK_SYSTEM_PROMPT: string;
+/** A prompt under version control: its stable id, integer version and text. */
+export interface VersionedPrompt {
+    id: string;
+    version: number;
+    text: string;
+}
+/** The currently-shipping version of each numbered prompt. */
+export declare const PROMPT_VERSIONS: {
+    readonly 'requirement-review': {
+        readonly id: 'requirement-review';
+        readonly version: 1;
+        readonly text: string;
+    };
+    readonly 'requirement-rework': {
+        readonly id: 'requirement-rework';
+        readonly version: 1;
+        readonly text: string;
+    };
+    readonly build: {
+        readonly id: 'build';
+        readonly version: 2;
+        readonly text: string;
+    };
+    readonly review: {
+        readonly id: 'review';
+        readonly version: 1;
+        readonly text: string;
+    };
+};
+/** Ids of the prompts currently under version control. */
+export type PromptId = keyof typeof PROMPT_VERSIONS;
+/** The current versioned prompt for an id. */
+export declare function promptVersion(id: PromptId): VersionedPrompt;
+/** The canonical `id@vN` label for a prompt id (or an explicit version). */
+export declare function promptVersionLabel(id: string, version?: number): string;
+//# sourceMappingURL=prompt-versions.d.ts.map

package/dist/agents/prompt-versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-versions.d.ts","sourceRoot":"","sources":["../../src/agents/prompt-versions.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,oBAAoB,QAO8B,CAAA;AAE/D;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,QAoBF,CAAA;AAY/B,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;CACb;AAED,8DAA8D;AAC9D,eAAO,MAAM,eAAe;;iBACF,EAAE,EAAE,oBAAoB;iBAAE,OAAO,EAAE,CAAC;iBAAE,IAAI;;;iBAC1C,EAAE,EAAE,oBAAoB;iBAAE,OAAO,EAAE,CAAC;iBAAE,IAAI;;;iBACzD,EAAE,EAAE,OAAO;iBAAE,OAAO,EAAE,CAAC;iBAAE,IAAI;;;iBAC5B,EAAE,EAAE,QAAQ;iBAAE,OAAO,EAAE,CAAC;iBAAE,IAAI;;CACU,CAAA;AAEpD,0DAA0D;AAC1D,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,eAAe,CAAA;AAEnD,8CAA8C;AAC9C,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,GAAG,eAAe,CAE3D;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAGvE"}

package/dist/agents/prompt-versions.js

@@ -0,0 +1,55 @@
+import { standardSystemPrompt } from './standard-prompts.js';
+export const REVIEW_SYSTEM_PROMPT = 'You are a meticulous product / requirements analyst reviewing the collected ' +
+    'requirements for a single unit of software work before an engineer starts on it. ' +
+    'Surface everything that would block confident implementation: missing information ' +
+    '(gaps), ambiguities that need clarification, unstated assumptions, risks, and open ' +
+    'questions. Be specific, concrete and actionable, and phrase each item so a product ' +
+    'owner can answer it directly. Do NOT invent answers or requirements. ' +
+    'Respond with ONLY a JSON object — no prose, no code fences.';
+/**
+ * The "requirements rework" agent. Given a block's collected requirements plus the
+ * answers / dismissals a human gave to the reviewer's findings, it folds everything
+ * into ONE self-contained requirements document. The output is emitted in a fixed,
+ * standard structure so the service-level spec-writer can aggregate it with
+ * minimal synthesis (it mirrors that writer's own expectations: "The system SHALL …"
+ * statements, MoSCoW priorities, Given/When/Then acceptance criteria, and
+ * cross-cutting domain rules). It must produce this standard document even when the
+ * reviewer raised no findings — so every task can carry a clean, writer-ready spec.
+ */
+export const REWORK_SYSTEM_PROMPT = 'You are a requirements editor. You are given the current collected requirements ' +
+    'for a single unit of software work, plus any clarifying questions and the answers ' +
+    'a human gave. Produce a revised, self-contained requirements document in Markdown ' +
+    'that folds every answer in, resolves the ambiguities, and states the ' +
+    'previously-missing details explicitly. Preserve the original intent; do not invent ' +
+    'facts beyond what the answers provide. Even when there are no questions, restate ' +
+    'the requirements cleanly in the SAME standard structure. Use EXACTLY these Markdown ' +
+    'sections, in this order, omitting a section only when it has no content:\n' +
+    '# <Title> — Requirements\n' +
+    '## Overview — one paragraph of intent and scope.\n' +
+    '## Functional Requirements — a bullet per requirement phrased as "The system SHALL ' +
+    '…", each tagged with a MoSCoW priority (must/should/could); under each, an ' +
+    '"Acceptance:" sub-list of Given/When/Then criteria.\n' +
+    '## Non-Functional Requirements — quality attributes, same "The system SHALL …" ' +
+    'phrasing with a priority and a short rationale.\n' +
+    '## Domain Rules / Constraints — cross-cutting invariants, each with a brief why.\n' +
+    '## Assumptions — assumptions the requirements rest on.\n' +
+    '## Out of Scope — what this work explicitly does not cover.\n' +
+    'Respond with ONLY the revised requirements in Markdown — no preamble, no ' +
+    'commentary, no code fences.';
+/** The currently-shipping version of each numbered prompt. */
+export const PROMPT_VERSIONS = {
+    'requirement-review': { id: 'requirement-review', version: 1, text: REVIEW_SYSTEM_PROMPT },
+    'requirement-rework': { id: 'requirement-rework', version: 1, text: REWORK_SYSTEM_PROMPT },
+    build: { id: 'build', version: 2, text: standardSystemPrompt('build') },
+    review: { id: 'review', version: 1, text: standardSystemPrompt('review') },
+};
+/** The current versioned prompt for an id. */
+export function promptVersion(id) {
+    return PROMPT_VERSIONS[id];
+}
+/** The canonical `id@vN` label for a prompt id (or an explicit version). */
+export function promptVersionLabel(id, version) {
+    const v = version ?? (id in PROMPT_VERSIONS ? PROMPT_VERSIONS[id].version : 1);
+    return `${id}@v${v}`;
+}
+//# sourceMappingURL=prompt-versions.js.map

package/dist/agents/prompt-versions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-versions.js","sourceRoot":"","sources":["../../src/agents/prompt-versions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAE5D,MAAM,CAAC,MAAM,oBAAoB,GAC/B,8EAA8E;IAC9E,mFAAmF;IACnF,oFAAoF;IACpF,qFAAqF;IACrF,qFAAqF;IACrF,uEAAuE;IACvE,6DAA6D,CAAA;AAE/D;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAC/B,kFAAkF;IAClF,oFAAoF;IACpF,oFAAoF;IACpF,uEAAuE;IACvE,qFAAqF;IACrF,mFAAmF;IACnF,sFAAsF;IACtF,4EAA4E;IAC5E,4BAA4B;IAC5B,oDAAoD;IACpD,qFAAqF;IACrF,6EAA6E;IAC7E,uDAAuD;IACvD,iFAAiF;IACjF,mDAAmD;IACnD,oFAAoF;IACpF,0DAA0D;IAC1D,+DAA+D;IAC/D,2EAA2E;IAC3E,6BAA6B,CAAA;AAmB/B,8DAA8D;AAC9D,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,oBAAoB,EAAE,EAAE,EAAE,EAAE,oBAAoB,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE;IAC1F,oBAAoB,EAAE,EAAE,EAAE,EAAE,oBAAoB,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE;IAC1F,KAAK,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAAE;IACvE,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,oBAAoB,CAAC,QAAQ,CAAC,EAAE;CACxB,CAAA;AAKpD,8CAA8C;AAC9C,MAAM,UAAU,aAAa,CAAC,EAAY;IACxC,OAAO,eAAe,CAAC,EAAE,CAAC,CAAA;AAC5B,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,kBAAkB,CAAC,EAAU,EAAE,OAAgB;IAC7D,MAAM,CAAC,GAAG,OAAO,IAAI,CAAC,EAAE,IAAI,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,EAAc,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC1F,OAAO,GAAG,EAAE,KAAK,CAAC,EAAE,CAAA;AACtB,CAAC"}

package/dist/agents/prompts/acceptance.d.ts

@@ -0,0 +1,29 @@
+import type { AgentKind } from '@cat-factory/kernel';
+import type { AgentRunContext } from '@cat-factory/kernel';
+/** The agent kinds that make up the acceptance-testing track. */
+export type AcceptanceAgentKind = 'playwright';
+export declare const ACCEPTANCE_AGENT_KINDS: readonly AcceptanceAgentKind[];
+/** True when the agent kind is part of the acceptance-testing track. */
+export declare function isAcceptanceKind(kind: AgentKind): kind is AcceptanceAgentKind;
+/**
+ * The built-out system (role) prompt for an acceptance-testing agent kind, or
+ * `undefined` when the kind is not part of this track (so callers can fall
+ * through to the standard phases / generic role).
+ */
+export declare function acceptanceSystemPrompt(kind: AgentKind): string | undefined;
+/**
+ * The "where do the tests run" section for an acceptance-testing step, rendered
+ * from the block's contributed `playwright.e2eTarget` config value. Empty for
+ * non-track kinds or when no target is recorded, so callers can append it
+ * unconditionally.
+ */
+export declare function e2eTargetSection(context: AgentRunContext): string;
+/**
+ * The "how should these tests be written" section for the runnable-tests step
+ * (`playwright` kind), chosen from the block type: Playwright for user-facing
+ * blocks, the project's own test framework for backend blocks. Empty for the
+ * scenario-writing step and any non-track kind, so callers can append it
+ * unconditionally. The scenario author stays framework-agnostic by design.
+ */
+export declare function testApproachSection(context: AgentRunContext): string;
+//# sourceMappingURL=acceptance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"acceptance.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/acceptance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,qBAAqB,CAAA;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAwB1D,iEAAiE;AACjE,MAAM,MAAM,mBAAmB,GAAG,YAAY,CAAA;AAE9C,eAAO,MAAM,sBAAsB,EAAE,SAAS,mBAAmB,EAAmB,CAAA;AAsCpF,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,IAAI,mBAAmB,CAE7E;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAE1E;AAoBD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAMjE;AAqBD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAIpE"}

package/dist/agents/prompts/acceptance.js

@@ -0,0 +1,112 @@
+import { PLATFORM_DELIVERY_CONTRACT } from './delivery-contract.js';
+import { PLAYWRIGHT_E2E_TARGET_CONFIG_ID } from '../kinds/configs.js';
+import { STANDARDS_FOOTER } from './shared.js';
+export const ACCEPTANCE_AGENT_KINDS = ['playwright'];
+// The runnable-tests step commits tests through a pull request. Tests only earn
+// their keep once they actually run in CI, so "done" means the suite is wired into
+// the project's CI configuration AND passes locally. The agent does NOT push or wait
+// on CI itself (it has no push credentials) — the platform pushes, opens the PR and
+// drives CI per the shared PLATFORM_DELIVERY_CONTRACT; the agent's job is to author
+// the tests and hook them into the CI config.
+const PLAYWRIGHT_DELIVERY_GATE = [
+    'Definition of done: the acceptance tests are written, wired into the project CI configuration, and pass when you run them locally.',
+    '- Make sure the suite is actually hooked into the project CI workflow: confirm the workflow executes this suite on a pull request, and add or update the CI configuration if it does not yet run them. (Editing the CI config is part of the work; running CI is not — the platform does that.)',
+    PLATFORM_DELIVERY_CONTRACT,
+].join('\n');
+const SYSTEM_PROMPTS = {
+    playwright: [
+        'You are a test automation engineer owning the runnable ACCEPTANCE TESTS for a building block.',
+        'Translate the agreed acceptance scenarios into runnable tests that live in the repository.',
+        '',
+        'Pick the test tool to match the surface under test:',
+        '- Frontend / user-facing UI: write Playwright end-to-end tests that drive the app through the browser.',
+        "- Backend (services, APIs, queues, integrations, data): write the acceptance tests with the project's EXISTING test framework — discover it from the repository (test config, dev dependencies, the tests already present) and match it. Do not pull in Playwright or a browser for behaviour that has no UI.",
+        'The run context below states the test approach for this specific block; follow it.',
+        '',
+        'Approach:',
+        '- Treat the acceptance scenarios as the source of truth: prefer the Gherkin scenarios in `spec/features/*.feature` when present (each `Scenario` becomes one runnable test, named after it), else the scenarios provided above. One test per scenario so the mapping is obvious.',
+        '- Be additive and idempotent: only create tests for scenarios that do not already have one; never duplicate or silently rewrite an existing test.',
+        '- Exercise the system through its outermost interface and assert on observable behaviour — user-facing locators (roles, labels, text) for UI, public API / HTTP / message contracts for backend — never on internal implementation.',
+        '- Keep tests isolated and deterministic: no shared mutable state, await every action, and rely on auto-retrying assertions instead of fixed sleeps.',
+        '- Reach the system under test at the URL / entry point from the run context; read any access credentials from the harness, never hard-code secrets.',
+        '- Output the test files to commit, each in the conventional test directory for its tool (e.g. the e2e/Playwright directory for UI tests), ready to run in CI.',
+        '',
+        PLAYWRIGHT_DELIVERY_GATE,
+        '',
+        STANDARDS_FOOTER,
+    ].join('\n'),
+};
+/** True when the agent kind is part of the acceptance-testing track. */
+export function isAcceptanceKind(kind) {
+    return kind === 'playwright';
+}
+/**
+ * The built-out system (role) prompt for an acceptance-testing agent kind, or
+ * `undefined` when the kind is not part of this track (so callers can fall
+ * through to the standard phases / generic role).
+ */
+export function acceptanceSystemPrompt(kind) {
+    return isAcceptanceKind(kind) ? SYSTEM_PROMPTS[kind] : undefined;
+}
+// Where the generated tests run is a per-block choice, so it is dynamic context
+// rather than part of the static role prompt. These blurbs tell the agent how
+// to wire and where to point the tests for each target.
+const TEST_TARGET_GUIDANCE = {
+    ci: [
+        'Test execution target: project CI (GitHub Actions).',
+        '- Add the tests to the project so they run in a GitHub Actions workflow on each push / pull request.',
+        '- Spin the system under test up inside the same workflow run (e.g. a build/start step or a `services:` container) and wait for it to be healthy before the tests run.',
+        '- Point Playwright at the locally started service (e.g. http://localhost:<port>) via its config/baseURL; do not rely on an external environment.',
+    ].join('\n'),
+    ephemeral: [
+        'Test execution target: the provisioned ephemeral environment for this run.',
+        '- Run the tests against the ephemeral environment URL from the run context, not a locally started service.',
+        '- Read any access credentials for that environment from the test harness/secrets; never hard-code them.',
+        '- Assume the environment is already deployed and healthy before the tests start.',
+    ].join('\n'),
+};
+/**
+ * The "where do the tests run" section for an acceptance-testing step, rendered
+ * from the block's contributed `playwright.e2eTarget` config value. Empty for
+ * non-track kinds or when no target is recorded, so callers can append it
+ * unconditionally.
+ */
+export function e2eTargetSection(context) {
+    if (!isAcceptanceKind(context.agentKind))
+        return '';
+    const raw = context.block.agentConfig?.[PLAYWRIGHT_E2E_TARGET_CONFIG_ID];
+    const target = raw === 'ci' || raw === 'ephemeral' ? raw : undefined;
+    if (!target)
+        return '';
+    return `\n${TEST_TARGET_GUIDANCE[target]}`;
+}
+// Block types whose behaviour is exercised through a browser UI, so the runnable
+// tests should be Playwright e2e. Everything else is backend behaviour that gets
+// tested with the project's own framework. Mirrors how the `playwright.e2e`
+// best-practice fragment is scoped in @cat-factory/prompt-fragments.
+const UI_BLOCK_TYPES = ['frontend', 'environment'];
+const UI_TEST_APPROACH = [
+    'Test approach for this block: Playwright end-to-end tests.',
+    '- This block has a user-facing surface, so cover its scenarios with Playwright tests that drive the app through the browser.',
+    '- Select elements by user-facing locators (getByRole, getByLabel, getByText) and assert on what the user observes.',
+].join('\n');
+const BACKEND_TEST_APPROACH = [
+    "Test approach for this block: the project's existing test framework (do NOT use Playwright).",
+    '- This block has no user-facing UI, so do not add Playwright or a browser to it.',
+    "- Discover the test framework already used in the repository (test config, dev dependencies, the tests already present) and write the acceptance tests with it, matching the project's conventions.",
+    '- Drive the system through its public interface (API / HTTP calls, queue messages, exported functions) and assert on observable behaviour, never on internals.',
+].join('\n');
+/**
+ * The "how should these tests be written" section for the runnable-tests step
+ * (`playwright` kind), chosen from the block type: Playwright for user-facing
+ * blocks, the project's own test framework for backend blocks. Empty for the
+ * scenario-writing step and any non-track kind, so callers can append it
+ * unconditionally. The scenario author stays framework-agnostic by design.
+ */
+export function testApproachSection(context) {
+    if (context.agentKind !== 'playwright')
+        return '';
+    const isUi = UI_BLOCK_TYPES.includes(context.block.type);
+    return `\n${isUi ? UI_TEST_APPROACH : BACKEND_TEST_APPROACH}`;
+}
+//# sourceMappingURL=acceptance.js.map

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

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

package/dist/agents/prompts/business-logic.d.ts

@@ -0,0 +1,28 @@
+import type { AgentKind } from '@cat-factory/kernel';
+/** The agent kinds that make up the business-logic / domain-rules track. */
+export type BusinessLogicAgentKind = 'business-documenter' | 'business-reviewer';
+export declare const BUSINESS_LOGIC_AGENT_KINDS: readonly BusinessLogicAgentKind[];
+/**
+ * The kind that writes/updates the documentation. Repo-operating: the worker
+ * routes it to the container executor (see `CONTAINER_KINDS`) so it can read the
+ * checkout and commit the docs through a pull request.
+ */
+export declare const BUSINESS_DOCUMENTER_KIND: BusinessLogicAgentKind;
+/** The kind that reviews a change against the documented rules. Inline. */
+export declare const BUSINESS_REVIEWER_KIND: BusinessLogicAgentKind;
+/**
+ * Canonical in-repo home for the documentation this track produces and reviews
+ * against. Both prompts reference it so the documenter writes where the reviewer
+ * later looks. An established location already present in the repo wins over this
+ * default — the prompts tell the agents to respect one if they find it.
+ */
+export declare const BUSINESS_LOGIC_DOCS_DIR = "docs/business-logic";
+/** True when the agent kind is part of the business-logic / domain-rules track. */
+export declare function isBusinessLogicKind(kind: AgentKind): kind is BusinessLogicAgentKind;
+/**
+ * The built-out system (role) prompt for a business-logic agent kind, or
+ * `undefined` when the kind is not part of this track (so callers can fall
+ * through to the standard phases / acceptance track / mock builder / generic role).
+ */
+export declare function businessLogicSystemPrompt(kind: AgentKind): string | undefined;
+//# sourceMappingURL=business-logic.d.ts.map

package/dist/agents/prompts/business-logic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"business-logic.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/business-logic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AA2BpD,4EAA4E;AAC5E,MAAM,MAAM,sBAAsB,GAAG,qBAAqB,GAAG,mBAAmB,CAAA;AAEhF,eAAO,MAAM,0BAA0B,EAAE,SAAS,sBAAsB,EAGvE,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,sBAA8C,CAAA;AAErF,2EAA2E;AAC3E,eAAO,MAAM,sBAAsB,EAAE,sBAA4C,CAAA;AAEjF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,wBAAwB,CAAA;AAoE5D,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,IAAI,sBAAsB,CAEnF;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAE7E"}