@cat-factory/agents 0.95.1 → 0.96.0

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

@@ -59,6 +59,28 @@ export declare const INTERVIEW_GATE_TRAIT: AgentTrait;
  * so the trait only affects kinds whose standards are folded into the prompt.
  */
 export declare const BRIEF_STANDARDS_TRAIT: AgentTrait;
+/**
+ * DESIGN-time kinds that choose which shared FOUNDATIONAL SERVICES a solution consumes. The
+ * engine injects the workspace's catalog (identity + capabilities + operation names, never a
+ * contract document) as `.cat-context/foundational-services/catalog.md`, and the guidance below
+ * requires the kind to declare the ids it designed against in a machine-readable block. That
+ * declaration is what the downstream `foundational-contracts` kinds' lazy read keys off — the
+ * whole point of splitting the two traits is that a design step pays for the cheap catalog and
+ * only the services it actually picked cost anyone a document.
+ */
+export declare const FOUNDATIONAL_CATALOG_TRAIT: AgentTrait;
+/**
+ * CONSUMER kinds that need the API details of the services the design declared. The engine
+ * resolves those ids to their full contract documents and injects one file per service. The
+ * guidance points at the index rather than restating the catalog: a consumer must not be
+ * choosing services, and handing it the whole catalog is how a coder ends up adopting a shared
+ * service the design deliberately rejected.
+ */
+export declare const FOUNDATIONAL_CONTRACTS_TRAIT: AgentTrait;
+/** The guidance a design-time kind gets: consult the catalog, then DECLARE what it used. */
+export declare const FOUNDATIONAL_CATALOG_GUIDANCE: string;
+/** The guidance a consumer kind gets: the contracts are files, and they are authoritative. */
+export declare const FOUNDATIONAL_CONTRACTS_GUIDANCE: string;
 /** The guidance appended to a spec-aware kind's system prompt — explains the spec format. */
 export declare const SPEC_AWARE_GUIDANCE: string;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"traits.d.ts","sourceRoot":"","sources":["../../../src/agents/kinds/traits.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,SAAS,EAGf,MAAM,qBAAqB,CAAA;AAC5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAetD,yFAAyF;AACzF,MAAM,MAAM,UAAU,GAAG,MAAM,CAAA;AAE/B;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,UAAyB,CAAA;AAExD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,EAAE,UAAwB,CAAA;AAEtD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,UAAyB,CAAA;AAExD;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,EAAE,UAA6B,CAAA;AAEhE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,EAAE,UAA6B,CAAA;AAEhE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,EAAE,UAA8B,CAAA;AAElE,6FAA6F;AAC7F,eAAO,MAAM,mBAAmB,QAWpB,CAAA;AAEZ;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,UAAU,EAAE,CAAC,CA6B1E,CAAA;AAED,kFAAkF;AAClF,MAAM,WAAW,oBAAoB;IACnC,mFAAmF;IACnF,EAAE,EAAE,UAAU,CAAA;IACd;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,SAAS,KAAK,MAAM,CAAC,CAAA;CAClD;AAED;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,EAAE,SAAS,oBAAoB,EAMrE,CAAA;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,iBAAiB,GAAG,GAAG,CAAC,UAAU,CAAC,CAKvF;AAED,sCAAsC;AACtC,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAEjG;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,iBAAiB,GAC1B,MAAM,GAAG,OAAO,CAElB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAQvF"}
+{"version":3,"file":"traits.d.ts","sourceRoot":"","sources":["../../../src/agents/kinds/traits.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,SAAS,EAOf,MAAM,qBAAqB,CAAA;AAC5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAetD,yFAAyF;AACzF,MAAM,MAAM,UAAU,GAAG,MAAM,CAAA;AAE/B;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,UAAyB,CAAA;AAExD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,EAAE,UAAwB,CAAA;AAEtD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,UAAyB,CAAA;AAExD;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,EAAE,UAA6B,CAAA;AAEhE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,EAAE,UAA6B,CAAA;AAEhE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,EAAE,UAA8B,CAAA;AAElE;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,EAAE,UAAmC,CAAA;AAE5E;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,EAAE,UAAqC,CAAA;AAEhF,4FAA4F;AAC5F,eAAO,MAAM,6BAA6B,QAK9B,CAAA;AAEZ,8FAA8F;AAC9F,eAAO,MAAM,+BAA+B,QAIhC,CAAA;AAEZ,6FAA6F;AAC7F,eAAO,MAAM,mBAAmB,QAWpB,CAAA;AAEZ;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,UAAU,EAAE,CAAC,CAmC1E,CAAA;AAED,kFAAkF;AAClF,MAAM,WAAW,oBAAoB;IACnC,mFAAmF;IACnF,EAAE,EAAE,UAAU,CAAA;IACd;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,SAAS,KAAK,MAAM,CAAC,CAAA;CAClD;AAED;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,EAAE,SAAS,oBAAoB,EAQrE,CAAA;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,iBAAiB,GAAG,GAAG,CAAC,UAAU,CAAC,CAKvF;AAED,sCAAsC;AACtC,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAEjG;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,iBAAiB,GAC1B,MAAM,GAAG,OAAO,CAElB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAQvF"}

package/dist/agents/kinds/traits.js

@@ -1,5 +1,5 @@
 import { SPEC_FEATURES_DIR, SPEC_MODULES_DIR, SPEC_OVERVIEW_PATH } from '@cat-factory/contracts';
-import { DOC_INTERVIEWER_AGENT_KIND, INITIATIVE_INTERVIEWER_AGENT_KIND, } from '@cat-factory/kernel';
+import { DOC_INTERVIEWER_AGENT_KIND, FOUNDATIONAL_CATALOG_FILE, FOUNDATIONAL_CONTEXT_DIR, FOUNDATIONAL_DECLARATION_TAG, FOUNDATIONAL_INDEX_FILE, INITIATIVE_INTERVIEWER_AGENT_KIND, } from '@cat-factory/kernel';
 /**
  * Code-aware kinds read and/or change the service's code. The service's selected
  * best-practice / guideline fragments (Node, Fastify, performance, …) are folded into
@@ -57,6 +57,37 @@ export const INTERVIEW_GATE_TRAIT = 'interview-gate';
  * so the trait only affects kinds whose standards are folded into the prompt.
  */
 export const BRIEF_STANDARDS_TRAIT = 'brief-standards';
+/**
+ * DESIGN-time kinds that choose which shared FOUNDATIONAL SERVICES a solution consumes. The
+ * engine injects the workspace's catalog (identity + capabilities + operation names, never a
+ * contract document) as `.cat-context/foundational-services/catalog.md`, and the guidance below
+ * requires the kind to declare the ids it designed against in a machine-readable block. That
+ * declaration is what the downstream `foundational-contracts` kinds' lazy read keys off — the
+ * whole point of splitting the two traits is that a design step pays for the cheap catalog and
+ * only the services it actually picked cost anyone a document.
+ */
+export const FOUNDATIONAL_CATALOG_TRAIT = 'foundational-catalog';
+/**
+ * CONSUMER kinds that need the API details of the services the design declared. The engine
+ * resolves those ids to their full contract documents and injects one file per service. The
+ * guidance points at the index rather than restating the catalog: a consumer must not be
+ * choosing services, and handing it the whole catalog is how a coder ends up adopting a shared
+ * service the design deliberately rejected.
+ */
+export const FOUNDATIONAL_CONTRACTS_TRAIT = 'foundational-contracts';
+/** The guidance a design-time kind gets: consult the catalog, then DECLARE what it used. */
+export const FOUNDATIONAL_CATALOG_GUIDANCE = [
+    `This deployment runs shared FOUNDATIONAL SERVICES — capabilities such as file storage, notifications or audit that already exist and that new systems are expected to CONSUME rather than rebuild. The catalog of what is available is provided to you as \`.cat-context/${FOUNDATIONAL_CATALOG_FILE}\`; read it before you settle on a design.`,
+    `Prefer an existing foundational service over designing your own equivalent. When you reject one that looks applicable, say why — "we already have this" is the single most common avoidable finding in a design review.`,
+    `The catalog lists each service's operations but NOT its full API documents. Design against the operations you can see; do not invent endpoints, fields or semantics the catalog does not show. The implementation steps get the full contracts.`,
+    `END your reply with a fenced \`\`\`${FOUNDATIONAL_DECLARATION_TAG} block listing the service ids your design consumes, one per line, and nothing else in the block. Write \`none\` when your design consumes no foundational service. This block is machine-read: the ids you list are what the later implementation steps are handed the API contracts for, so a service you omit is one nobody downstream will have the interface to, and an id you invent will be reported as unavailable.`,
+].join('\n');
+/** The guidance a consumer kind gets: the contracts are files, and they are authoritative. */
+export const FOUNDATIONAL_CONTRACTS_GUIDANCE = [
+    `The FOUNDATIONAL SERVICES the design chose for this task — shared capabilities such as file storage, notifications or audit — have their API contracts provided to you under \`.cat-context/${FOUNDATIONAL_CONTEXT_DIR}/\`. Start at \`.cat-context/${FOUNDATIONAL_INDEX_FILE}\`, which names each one and states anything the design asked for that could not be provided.`,
+    `Treat those contracts as the authoritative interface: call the operations they declare, with the shapes they declare. Do not invent an endpoint or a field, and do not reimplement a capability one of these services already provides.`,
+    `If the work needs something the provided contracts do not cover, say so in your report rather than guessing at the missing API.`,
+].join('\n');
 /** The guidance appended to a spec-aware kind's system prompt — explains the spec format. */
 export const SPEC_AWARE_GUIDANCE = [
     `This repository may contain a prescriptive SPECIFICATION for the service under the \`spec/\` directory — the source of truth for what the service must do. It is sharded by a module (domain) → feature (group) taxonomy. When it is present, read it before doing the work:`,
@@ -83,8 +114,14 @@ export const SPEC_AWARE_GUIDANCE = [
  *    `reviewer` companion is a built-in listed here while the coder declares its own).
  */
 export const STANDARD_AGENT_TRAITS = {
-    architect: [CODE_AWARE_TRAIT, SPEC_AWARE_TRAIT],
-    coder: [CODE_AWARE_TRAIT, SPEC_AWARE_TRAIT, BRIEF_STANDARDS_TRAIT],
+    // The architect DESIGNS, so it is the one built-in kind that chooses foundational services
+    // and declares them; `researcher` and `coder` CONSUME that declaration.
+    architect: [CODE_AWARE_TRAIT, SPEC_AWARE_TRAIT, FOUNDATIONAL_CATALOG_TRAIT],
+    coder: [CODE_AWARE_TRAIT, SPEC_AWARE_TRAIT, BRIEF_STANDARDS_TRAIT, FOUNDATIONAL_CONTRACTS_TRAIT],
+    // The researcher plans the solution against the design, so it needs the same contracts the
+    // coder will build to — investigating prior art for a capability the org already runs, from
+    // the catalog entry alone, is how a plan ends up proposing a library beside a shared service.
+    researcher: [FOUNDATIONAL_CONTRACTS_TRAIT],
     reviewer: [CODE_AWARE_TRAIT, SPEC_AWARE_TRAIT],
     'ci-fixer': [CODE_AWARE_TRAIT, SPEC_AWARE_TRAIT, BRIEF_STANDARDS_TRAIT],
     fixer: [CODE_AWARE_TRAIT, SPEC_AWARE_TRAIT, BRIEF_STANDARDS_TRAIT],
@@ -124,6 +161,8 @@ export const STANDARD_TRAIT_DEFINITIONS = [
     { id: SPEC_AWARE_TRAIT, guidance: SPEC_AWARE_GUIDANCE },
     { id: INTERVIEW_GATE_TRAIT },
     { id: BRIEF_STANDARDS_TRAIT },
+    { id: FOUNDATIONAL_CATALOG_TRAIT, guidance: FOUNDATIONAL_CATALOG_GUIDANCE },
+    { id: FOUNDATIONAL_CONTRACTS_TRAIT, guidance: FOUNDATIONAL_CONTRACTS_GUIDANCE },
 ];
 /**
  * The traits a kind carries: its built-in set ({@link STANDARD_AGENT_TRAITS}) unioned with a

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

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

package/dist/foundationalServices/FoundationalServiceCatalogService.d.ts

@@ -0,0 +1,65 @@
+import type { ApiContractDocument, CreateFoundationalServiceInput, FoundationalService, FoundationalServiceOwnerKind, ResolvedFoundationalService, UpdateFoundationalServiceInput } from '@cat-factory/contracts';
+import type { ApiContractRepository, Clock, FoundationalServiceRepository, GroupCacheHandle, WorkspaceRepository } from '@cat-factory/kernel';
+export interface FoundationalServiceCatalogDependencies {
+    foundationalServiceRepository: FoundationalServiceRepository;
+    apiContractRepository: ApiContractRepository;
+    workspaceRepository: WorkspaceRepository;
+    clock: Clock;
+    /** The merged per-workspace catalog cache. Absent (tests) ⇒ every resolve reads through. */
+    catalogCache?: GroupCacheHandle<ResolvedFoundationalService[]>;
+}
+/**
+ * The foundational-services catalog (docs/initiatives/foundational-services.md): per-tier CRUD
+ * plus the merged account ⊕ workspace resolve every design dispatch reads.
+ *
+ * Two properties are load-bearing and are why this is a service rather than a repository call:
+ *
+ * - **The catalog never carries a contract BODY.** `listTier` and `resolve` join the contract
+ *   MANIFEST (id, format, title, byte size, operation names) onto each service in ONE extra
+ *   query for the whole tier. The documents are read only by {@link contractsFor}, and only for
+ *   the ids a caller asks for.
+ * - **A workspace row wins over an account row of the same id, and a workspace TOMBSTONE
+ *   suppresses one.** That is what lets a board opt out of an org-wide service without an
+ *   account admin, and it is why the merge reads the workspace tier `includeDeleted`.
+ */
+export declare class FoundationalServiceCatalogService {
+    private readonly deps;
+    constructor(deps: FoundationalServiceCatalogDependencies);
+    /** One tier's registered services, contract manifests joined on. Raw — not merged. */
+    listTier(ownerKind: FoundationalServiceOwnerKind, ownerId: string): Promise<FoundationalService[]>;
+    /** Register a service at a tier. */
+    create(ownerKind: FoundationalServiceOwnerKind, ownerId: string, input: CreateFoundationalServiceInput): Promise<FoundationalService>;
+    /** Patch a registered service. `contracts`, when present, replaces the whole set. */
+    update(ownerKind: FoundationalServiceOwnerKind, ownerId: string, serviceId: string, input: UpdateFoundationalServiceInput): Promise<FoundationalService>;
+    /**
+     * Remove a service from a tier. A WORKSPACE removal writes a tombstone (which is also how a
+     * board suppresses an inherited account service); an ACCOUNT removal drops the row and its
+     * documents outright, since there is no higher tier for it to shadow.
+     */
+    remove(ownerKind: FoundationalServiceOwnerKind, ownerId: string, serviceId: string): Promise<void>;
+    /**
+     * Suppress an ACCOUNT service for one workspace by writing a workspace-tier tombstone. The
+     * row carries no content of its own — it exists only to lose the merge — so it is written
+     * here rather than through {@link create}, which would demand a name and summary for
+     * something that is never rendered.
+     */
+    suppressForWorkspace(workspaceId: string, serviceId: string): Promise<void>;
+    /** The merged catalog a workspace's agents see, cached per workspace. */
+    resolve(workspaceId: string): Promise<ResolvedFoundationalService[]>;
+    /**
+     * The LAZY contract read: full documents for the named services, resolved against the same
+     * account ⊕ workspace precedence the catalog uses. One batched query per tier — never a
+     * per-service read — and an empty `serviceIds` returns `[]` without touching the store.
+     *
+     * Precedence matters here as much as in the catalog: a workspace that overrode a service
+     * must hand out ITS documents, or the design would be reviewed against the org's spec while
+     * the code is written against the board's.
+     */
+    contractsFor(workspaceId: string, serviceIds: string[]): Promise<Map<string, ApiContractDocument[]>>;
+    /** Drop a tier's cached catalog. An account write invalidates every workspace's. */
+    invalidate(ownerKind: FoundationalServiceOwnerKind, ownerId: string): Promise<void>;
+    private loadCatalog;
+    private require;
+    private buildUploadedContracts;
+}
+//# sourceMappingURL=FoundationalServiceCatalogService.d.ts.map

package/dist/foundationalServices/FoundationalServiceCatalogService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FoundationalServiceCatalogService.d.ts","sourceRoot":"","sources":["../../src/foundationalServices/FoundationalServiceCatalogService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,8BAA8B,EAC9B,mBAAmB,EACnB,4BAA4B,EAC5B,2BAA2B,EAC3B,8BAA8B,EAC/B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EAGV,qBAAqB,EACrB,KAAK,EAEL,6BAA6B,EAC7B,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,qBAAqB,CAAA;AAU5B,MAAM,WAAW,sCAAsC;IACrD,6BAA6B,EAAE,6BAA6B,CAAA;IAC5D,qBAAqB,EAAE,qBAAqB,CAAA;IAC5C,mBAAmB,EAAE,mBAAmB,CAAA;IACxC,KAAK,EAAE,KAAK,CAAA;IACZ,4FAA4F;IAC5F,YAAY,CAAC,EAAE,gBAAgB,CAAC,2BAA2B,EAAE,CAAC,CAAA;CAC/D;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,iCAAiC;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAjC,YAA6B,IAAI,EAAE,sCAAsC,EAAI;IAE7E,sFAAsF;IAChF,QAAQ,CACZ,SAAS,EAAE,4BAA4B,EACvC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAOhC;IAED,oCAAoC;IAC9B,MAAM,CACV,SAAS,EAAE,4BAA4B,EACvC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC,mBAAmB,CAAC,CAsC9B;IAED,qFAAqF;IAC/E,MAAM,CACV,SAAS,EAAE,4BAA4B,EACvC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC,mBAAmB,CAAC,CAmC9B;IAED;;;;OAIG;IACG,MAAM,CACV,SAAS,EAAE,4BAA4B,EACvC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAKf;IAED;;;;;OAKG;IACG,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBhF;IAED,yEAAyE;IACnE,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,EAAE,CAAC,CAGzE;IAED;;;;;;;;OAQG;IACG,YAAY,CAChB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,mBAAmB,EAAE,CAAC,CAAC,CA0B7C;IAED,oFAAoF;IAC9E,UAAU,CAAC,SAAS,EAAE,4BAA4B,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQxF;YAEa,WAAW;YAoBX,OAAO;IAUrB,OAAO,CAAC,sBAAsB;CAyC/B"}

package/dist/foundationalServices/FoundationalServiceCatalogService.js

@@ -0,0 +1,284 @@
+import { ConflictError, NotFoundError, ValidationError, summarizeContract, } from '@cat-factory/kernel';
+import { mergeFoundationalTiers, toWire } from './foundational-catalog.js';
+import { validateUploadedContract } from './contract-validation.js';
+/**
+ * The foundational-services catalog (docs/initiatives/foundational-services.md): per-tier CRUD
+ * plus the merged account ⊕ workspace resolve every design dispatch reads.
+ *
+ * Two properties are load-bearing and are why this is a service rather than a repository call:
+ *
+ * - **The catalog never carries a contract BODY.** `listTier` and `resolve` join the contract
+ *   MANIFEST (id, format, title, byte size, operation names) onto each service in ONE extra
+ *   query for the whole tier. The documents are read only by {@link contractsFor}, and only for
+ *   the ids a caller asks for.
+ * - **A workspace row wins over an account row of the same id, and a workspace TOMBSTONE
+ *   suppresses one.** That is what lets a board opt out of an org-wide service without an
+ *   account admin, and it is why the merge reads the workspace tier `includeDeleted`.
+ */
+export class FoundationalServiceCatalogService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** One tier's registered services, contract manifests joined on. Raw — not merged. */
+    async listTier(ownerKind, ownerId) {
+        const [records, manifest] = await Promise.all([
+            this.deps.foundationalServiceRepository.listByOwner(ownerKind, ownerId),
+            this.deps.apiContractRepository.listManifestByOwner(ownerKind, ownerId),
+        ]);
+        const byService = indexManifest(manifest);
+        return records.map((record) => toWire(record, byService.get(record.serviceId) ?? []));
+    }
+    /** Register a service at a tier. */
+    async create(ownerKind, ownerId, input) {
+        const existing = await this.deps.foundationalServiceRepository.get(ownerKind, ownerId, input.id);
+        // A LIVE row is a conflict; a tombstoned one is revived by this write. Refusing the
+        // revival would leave an id permanently unusable after one delete.
+        if (existing && !existing.deletedAt) {
+            throw new ConflictError(`Foundational service '${input.id}' already exists at this scope`, 'foundational_service_exists', { serviceId: input.id });
+        }
+        const now = this.deps.clock.now();
+        const record = {
+            serviceId: input.id,
+            ownerKind,
+            ownerId,
+            name: input.name,
+            summary: input.summary,
+            description: input.description,
+            capabilities: input.capabilities ?? [],
+            sourceId: null,
+            sourcePath: null,
+            pinnedCommit: null,
+            createdAt: existing?.createdAt ?? now,
+            updatedAt: now,
+            deletedAt: null,
+        };
+        await this.deps.foundationalServiceRepository.upsert(record);
+        const contracts = this.buildUploadedContracts(ownerKind, ownerId, input.id, input.contracts, now);
+        await this.deps.apiContractRepository.replaceForService(ownerKind, ownerId, input.id, contracts);
+        await this.invalidate(ownerKind, ownerId);
+        return toWire(record, contracts.map(manifestOf));
+    }
+    /** Patch a registered service. `contracts`, when present, replaces the whole set. */
+    async update(ownerKind, ownerId, serviceId, input) {
+        const existing = await this.require(ownerKind, ownerId, serviceId);
+        const now = this.deps.clock.now();
+        const record = {
+            ...existing,
+            name: input.name ?? existing.name,
+            summary: input.summary ?? existing.summary,
+            description: input.description ?? existing.description,
+            capabilities: input.capabilities ?? existing.capabilities,
+            updatedAt: now,
+        };
+        await this.deps.foundationalServiceRepository.upsert(record);
+        let manifest;
+        if (input.contracts) {
+            const contracts = this.buildUploadedContracts(ownerKind, ownerId, serviceId, input.contracts, now);
+            await this.deps.apiContractRepository.replaceForService(ownerKind, ownerId, serviceId, contracts);
+            manifest = contracts.map(manifestOf);
+        }
+        else {
+            manifest = (await this.deps.apiContractRepository.listManifestByOwner(ownerKind, ownerId)).filter((entry) => entry.serviceId === serviceId);
+        }
+        await this.invalidate(ownerKind, ownerId);
+        return toWire(record, manifest);
+    }
+    /**
+     * Remove a service from a tier. A WORKSPACE removal writes a tombstone (which is also how a
+     * board suppresses an inherited account service); an ACCOUNT removal drops the row and its
+     * documents outright, since there is no higher tier for it to shadow.
+     */
+    async remove(ownerKind, ownerId, serviceId) {
+        const now = this.deps.clock.now();
+        await this.deps.foundationalServiceRepository.softDelete(ownerKind, ownerId, serviceId, now);
+        await this.deps.apiContractRepository.deleteForService(ownerKind, ownerId, serviceId);
+        await this.invalidate(ownerKind, ownerId);
+    }
+    /**
+     * Suppress an ACCOUNT service for one workspace by writing a workspace-tier tombstone. The
+     * row carries no content of its own — it exists only to lose the merge — so it is written
+     * here rather than through {@link create}, which would demand a name and summary for
+     * something that is never rendered.
+     */
+    async suppressForWorkspace(workspaceId, serviceId) {
+        const now = this.deps.clock.now();
+        await this.deps.foundationalServiceRepository.upsert({
+            serviceId,
+            ownerKind: 'workspace',
+            ownerId: workspaceId,
+            name: '',
+            summary: '',
+            description: '',
+            capabilities: [],
+            sourceId: null,
+            sourcePath: null,
+            pinnedCommit: null,
+            createdAt: now,
+            updatedAt: now,
+            deletedAt: now,
+        });
+        await this.invalidate('workspace', workspaceId);
+    }
+    /** The merged catalog a workspace's agents see, cached per workspace. */
+    async resolve(workspaceId) {
+        if (!this.deps.catalogCache)
+            return this.loadCatalog(workspaceId);
+        return this.deps.catalogCache.get(workspaceId, workspaceId, () => this.loadCatalog(workspaceId));
+    }
+    /**
+     * The LAZY contract read: full documents for the named services, resolved against the same
+     * account ⊕ workspace precedence the catalog uses. One batched query per tier — never a
+     * per-service read — and an empty `serviceIds` returns `[]` without touching the store.
+     *
+     * Precedence matters here as much as in the catalog: a workspace that overrode a service
+     * must hand out ITS documents, or the design would be reviewed against the org's spec while
+     * the code is written against the board's.
+     */
+    async contractsFor(workspaceId, serviceIds) {
+        const wanted = [...new Set(serviceIds)].filter(Boolean);
+        if (wanted.length === 0)
+            return new Map();
+        const accountId = await this.deps.workspaceRepository.accountOf(workspaceId);
+        const [workspaceDocs, accountDocs] = await Promise.all([
+            this.deps.apiContractRepository.listByServiceIds('workspace', workspaceId, wanted),
+            accountId
+                ? this.deps.apiContractRepository.listByServiceIds('account', accountId, wanted)
+                : Promise.resolve([]),
+        ]);
+        // Which TIER won for each id is decided by the catalog merge, not by which tier happens to
+        // hold documents: a workspace row that overrides an account one but ships no contract of
+        // its own must NOT silently inherit the account's documents, or the override reads as
+        // partially applied. So resolve the winning tier first, then take that tier's documents.
+        const catalog = await this.resolve(workspaceId);
+        const tierById = new Map(catalog.map((entry) => [entry.id, entry.tier]));
+        const out = new Map();
+        for (const id of wanted) {
+            const tier = tierById.get(id);
+            if (!tier)
+                continue;
+            const docs = (tier === 'workspace' ? workspaceDocs : accountDocs).filter((doc) => doc.serviceId === id);
+            out.set(id, docs.map(documentOf));
+        }
+        return out;
+    }
+    /** Drop a tier's cached catalog. An account write invalidates every workspace's. */
+    async invalidate(ownerKind, ownerId) {
+        if (!this.deps.catalogCache)
+            return;
+        // A workspace write affects exactly one group; an account write affects every workspace in
+        // the account, and enumerating them would be a read per invalidation — over-invalidation is
+        // always safe, so the account path drops everything (the same call `FragmentLibraryService`
+        // makes for the same reason).
+        if (ownerKind === 'workspace')
+            await this.deps.catalogCache.invalidateGroup(ownerId);
+        else
+            await this.deps.catalogCache.invalidateAll();
+    }
+    async loadCatalog(workspaceId) {
+        const accountId = await this.deps.workspaceRepository.accountOf(workspaceId);
+        const [workspaceRows, accountRows, workspaceManifest, accountManifest] = await Promise.all([
+            this.deps.foundationalServiceRepository.listByOwner('workspace', workspaceId, true),
+            accountId
+                ? this.deps.foundationalServiceRepository.listByOwner('account', accountId)
+                : Promise.resolve([]),
+            this.deps.apiContractRepository.listManifestByOwner('workspace', workspaceId),
+            accountId
+                ? this.deps.apiContractRepository.listManifestByOwner('account', accountId)
+                : Promise.resolve([]),
+        ]);
+        return mergeFoundationalTiers({
+            accountRows,
+            workspaceRows,
+            accountManifest: indexManifest(accountManifest),
+            workspaceManifest: indexManifest(workspaceManifest),
+        });
+    }
+    async require(ownerKind, ownerId, serviceId) {
+        const record = await this.deps.foundationalServiceRepository.get(ownerKind, ownerId, serviceId);
+        if (!record || record.deletedAt)
+            throw new NotFoundError('FoundationalService', serviceId);
+        return record;
+    }
+    buildUploadedContracts(ownerKind, ownerId, serviceId, uploads, now) {
+        const seen = new Set();
+        return (uploads ?? []).map((upload) => {
+            if (seen.has(upload.contractId)) {
+                throw new ValidationError(`Duplicate contract id '${upload.contractId}'`, {
+                    reason: 'duplicate_contract_id',
+                    contractId: upload.contractId,
+                });
+            }
+            seen.add(upload.contractId);
+            validateUploadedContract(upload);
+            const summary = summarizeContract({
+                contractId: upload.contractId,
+                format: upload.format,
+                title: upload.title,
+                path: null,
+                body: upload.body,
+            });
+            return {
+                ownerKind,
+                ownerId,
+                serviceId,
+                contractId: upload.contractId,
+                format: upload.format,
+                title: upload.title,
+                body: upload.body,
+                operations: summary.operations,
+                omittedOperations: summary.omittedOperations,
+                sourcePath: null,
+                sourceSha: null,
+                createdAt: now,
+                updatedAt: now,
+            };
+        });
+    }
+}
+function indexManifest(entries) {
+    const map = new Map();
+    for (const entry of entries) {
+        const list = map.get(entry.serviceId);
+        if (list)
+            list.push(entry);
+        else
+            map.set(entry.serviceId, [entry]);
+    }
+    return map;
+}
+/**
+ * A just-written contract record → its manifest entry. The operation index is recomputed from
+ * the body here rather than read back, so a create/update response describes exactly what was
+ * stored without a second round trip.
+ */
+function manifestOf(record) {
+    return {
+        serviceId: record.serviceId,
+        contractId: record.contractId,
+        format: record.format,
+        title: record.title,
+        size: record.body.length,
+        operations: record.operations,
+        omittedOperations: record.omittedOperations,
+        sourcePath: record.sourcePath,
+    };
+}
+/**
+ * A stored record → the wire document. The operation index is read off the ROW rather than
+ * recomputed: it is the same index the catalog showed, so a consumer can never see a document
+ * whose operation list disagrees with the one the design was chosen from.
+ */
+function documentOf(record) {
+    return {
+        contractId: record.contractId,
+        format: record.format,
+        title: record.title,
+        size: record.body.length,
+        path: record.sourcePath,
+        operations: record.operations,
+        omittedOperations: record.omittedOperations,
+        body: record.body,
+    };
+}
+//# sourceMappingURL=FoundationalServiceCatalogService.js.map

package/dist/foundationalServices/FoundationalServiceCatalogService.js.map

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

package/dist/foundationalServices/FoundationalServiceRunResolver.d.ts

@@ -0,0 +1,37 @@
+import type { FoundationalServiceSelection } from '@cat-factory/contracts';
+import type { FoundationalCatalogView, InjectedContextFile } from '@cat-factory/kernel';
+import type { FoundationalServiceCatalogService } from './FoundationalServiceCatalogService.js';
+/**
+ * The engine-facing seam over the foundational-services catalog
+ * (docs/initiatives/foundational-services.md). Two reads, deliberately separate, because they
+ * serve the two halves of the feature:
+ *
+ * - {@link catalogFor} is the DESIGN-time read: identity, capabilities and operation names for
+ *   every registered service, no document bodies. Folded into the Architect's prompt.
+ * - {@link contextFilesFor} is the CONSUMER-time read: the full contract documents, for exactly
+ *   the ids the design declared, materialised as `.cat-context/foundational-services/*` files.
+ *
+ * Implemented against the catalog SERVICE rather than the repositories so both reads go through
+ * the same tier merge and the same cache — a consumer can never be handed the account's
+ * document for a service the design chose at the workspace tier.
+ */
+export declare class FoundationalServiceRunResolver {
+    private readonly catalog;
+    constructor(catalog: FoundationalServiceCatalogService);
+    /** The catalog the design step is shown. Empty array when nothing is registered. */
+    catalogFor(workspaceId: string): Promise<FoundationalCatalogView[]>;
+    /** Just the ids in the merged catalog — the check a settled design's declaration runs against. */
+    catalogIdsFor(workspaceId: string): Promise<string[]>;
+    /**
+     * The injected context files a consumer kind receives for a design's declared services: one
+     * markdown file per service carrying its contract documents, plus an index.
+     *
+     * The INDEX is always produced, even when nothing was declared and nothing resolved. That is
+     * the "degrade loudly" half: a coder handed no foundational context cannot otherwise tell
+     * "the design decided none apply" from "the design step never ran" from "the design named a
+     * service this deployment does not have", and those need three different reactions.
+     */
+    contextFilesFor(workspaceId: string, selection: FoundationalServiceSelection | undefined): Promise<InjectedContextFile[]>;
+    private hasCatalog;
+}
+//# sourceMappingURL=FoundationalServiceRunResolver.d.ts.map

package/dist/foundationalServices/FoundationalServiceRunResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FoundationalServiceRunResolver.d.ts","sourceRoot":"","sources":["../../src/foundationalServices/FoundationalServiceRunResolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAA;AAC1E,OAAO,KAAK,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAOvF,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,wCAAwC,CAAA;AAE/F;;;;;;;;;;;;;GAaG;AACH,qBAAa,8BAA8B;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAApC,YAA6B,OAAO,EAAE,iCAAiC,EAAI;IAE3E,oFAAoF;IAC9E,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAUxE;IAED,kGAAkG;IAC5F,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAE1D;IAED;;;;;;;;OAQG;IACG,eAAe,CACnB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,4BAA4B,GAAG,SAAS,GAClD,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAyChC;YAEa,UAAU;CAGzB"}

package/dist/foundationalServices/FoundationalServiceRunResolver.js

@@ -0,0 +1,92 @@
+import { FOUNDATIONAL_INDEX_FILE, contextFileFor, renderContractDocument, renderFoundationalIndex, } from '@cat-factory/kernel';
+/**
+ * The engine-facing seam over the foundational-services catalog
+ * (docs/initiatives/foundational-services.md). Two reads, deliberately separate, because they
+ * serve the two halves of the feature:
+ *
+ * - {@link catalogFor} is the DESIGN-time read: identity, capabilities and operation names for
+ *   every registered service, no document bodies. Folded into the Architect's prompt.
+ * - {@link contextFilesFor} is the CONSUMER-time read: the full contract documents, for exactly
+ *   the ids the design declared, materialised as `.cat-context/foundational-services/*` files.
+ *
+ * Implemented against the catalog SERVICE rather than the repositories so both reads go through
+ * the same tier merge and the same cache — a consumer can never be handed the account's
+ * document for a service the design chose at the workspace tier.
+ */
+export class FoundationalServiceRunResolver {
+    catalog;
+    constructor(catalog) {
+        this.catalog = catalog;
+    }
+    /** The catalog the design step is shown. Empty array when nothing is registered. */
+    async catalogFor(workspaceId) {
+        const resolved = await this.catalog.resolve(workspaceId);
+        return resolved.map((service) => ({
+            id: service.id,
+            name: service.name,
+            summary: service.summary,
+            description: service.description,
+            capabilities: service.capabilities,
+            contracts: service.contracts,
+        }));
+    }
+    /** Just the ids in the merged catalog — the check a settled design's declaration runs against. */
+    async catalogIdsFor(workspaceId) {
+        return (await this.catalog.resolve(workspaceId)).map((service) => service.id);
+    }
+    /**
+     * The injected context files a consumer kind receives for a design's declared services: one
+     * markdown file per service carrying its contract documents, plus an index.
+     *
+     * The INDEX is always produced, even when nothing was declared and nothing resolved. That is
+     * the "degrade loudly" half: a coder handed no foundational context cannot otherwise tell
+     * "the design decided none apply" from "the design step never ran" from "the design named a
+     * service this deployment does not have", and those need three different reactions.
+     */
+    async contextFilesFor(workspaceId, selection) {
+        const declared = selection?.declared ?? [];
+        const unknown = selection?.unknown ?? [];
+        const noDeclaration = selection === undefined;
+        // Nothing to say and nothing to warn about: a run in a deployment that registers no
+        // foundational services at all would otherwise pay for an index file on every dispatch
+        // saying so. A declaration that resolved to nothing is DIFFERENT and does get the file.
+        if (noDeclaration && unknown.length === 0 && !(await this.hasCatalog(workspaceId)))
+            return [];
+        const documents = await this.catalog.contractsFor(workspaceId, declared);
+        const resolved = await this.catalog.resolve(workspaceId);
+        const byId = new Map(resolved.map((service) => [service.id, service]));
+        const bundles = declared
+            .map((id) => {
+            const service = byId.get(id);
+            if (!service)
+                return null;
+            return {
+                id: service.id,
+                name: service.name,
+                summary: service.summary,
+                description: service.description,
+                contracts: (documents.get(id) ?? []).map((doc) => ({
+                    contractId: doc.contractId,
+                    format: doc.format,
+                    title: doc.title,
+                    body: doc.body,
+                })),
+            };
+        })
+            .filter((bundle) => bundle !== null);
+        const files = [
+            {
+                path: FOUNDATIONAL_INDEX_FILE,
+                content: renderFoundationalIndex({ bundles, unknown, noDeclaration }),
+            },
+        ];
+        for (const bundle of bundles) {
+            files.push({ path: contextFileFor(bundle.id), content: renderContractDocument(bundle) });
+        }
+        return files;
+    }
+    async hasCatalog(workspaceId) {
+        return (await this.catalog.resolve(workspaceId)).length > 0;
+    }
+}
+//# sourceMappingURL=FoundationalServiceRunResolver.js.map