@cat-factory/contracts 0.6.0

package/dist/board-scan.d.ts

@@ -0,0 +1,89 @@
+import * as v from 'valibot';
+/** A cohesive area of the service (e.g. `auth`, `billing`). */
+export declare const blueprintModuleSchema: v.ObjectSchema<{
+    /** Module name, typically the owning directory's domain (e.g. `Auth`). */
+    readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>;
+    /** One or two sentences on the module's responsibility. */
+    readonly summary: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, "">;
+    /** Repo-relative paths the module owns (its directories / key files). */
+    readonly references: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 400, undefined>]>, undefined>, readonly []>;
+}, undefined>;
+export type BlueprintModule = v.InferOutput<typeof blueprintModuleSchema>;
+/** The repository as a single top-level service frame with its modules. */
+export declare const blueprintServiceSchema: v.ObjectSchema<{
+    /** Board frame type the repo presents as (service / api / frontend / …). */
+    readonly type: v.PicklistSchema<["frontend", "service", "api", "database", "queue", "integration", "external", "environment"], undefined>;
+    /** Human name for the service (defaults to the repo name). */
+    readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>;
+    /** One or two sentences describing the service overall. */
+    readonly summary: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, "">;
+    /** Repo-relative entrypoints / root files (e.g. `package.json`, `src/index.ts`). */
+    readonly references: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 400, undefined>]>, undefined>, readonly []>;
+    readonly modules: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+        /** Module name, typically the owning directory's domain (e.g. `Auth`). */
+        readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>;
+        /** One or two sentences on the module's responsibility. */
+        readonly summary: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, "">;
+        /** Repo-relative paths the module owns (its directories / key files). */
+        readonly references: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 400, undefined>]>, undefined>, readonly []>;
+    }, undefined>, undefined>, readonly []>;
+}, undefined>;
+export type BlueprintService = v.InferOutput<typeof blueprintServiceSchema>;
+/** How a blueprint was produced: an LLM scan, or the deterministic tree heuristic. */
+export declare const blueprintSourceSchema: v.PicklistSchema<["llm", "heuristic"], undefined>;
+export type BlueprintSource = v.InferOutput<typeof blueprintSourceSchema>;
+/**
+ * Counts of board blocks touched when the `blueprints` pipeline step materialises
+ * (or reconciles) a decomposition onto the board: the service frame and its modules.
+ */
+export declare const boardScanSpawnResultSchema: v.ObjectSchema<{
+    /** Id of the service frame the blueprint was reconciled onto / spawned as. */
+    readonly frameId: v.StringSchema<undefined>;
+    readonly modules: v.NumberSchema<undefined>;
+}, undefined>;
+export type BoardScanSpawnResult = v.InferOutput<typeof boardScanSpawnResultSchema>;
+/** Folder, relative to the repo root, that holds the persisted blueprint. */
+export declare const BLUEPRINT_DIR = "blueprints";
+/** Canonical machine-readable blueprint file (the BlueprintService tree). */
+export declare const BLUEPRINT_JSON_PATH = "blueprints/blueprint.json";
+/** High-level overview markdown — the file agents read first. */
+export declare const BLUEPRINT_OVERVIEW_PATH = "blueprints/overview.md";
+/** Sub-folder holding one deep-dive markdown per module. */
+export declare const BLUEPRINT_MODULES_DIR = "blueprints/modules";
+/** Tiny manifest read for quick staleness checks without parsing the full tree. */
+export declare const BLUEPRINT_VERSION_PATH = "blueprints/version.json";
+/**
+ * The lightweight `version.json` manifest committed alongside the blueprint. It
+ * carries a monotonic version counter, the generation timestamp, and a content
+ * hash of the canonical tree, so staleness checks are a tiny read rather than a
+ * full parse of `blueprint.json`.
+ */
+export declare const blueprintVersionSchema: v.ObjectSchema<{
+    readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    readonly generatedAt: v.StringSchema<undefined>;
+    /** sha256 (hex) of the canonical `blueprint.json` bytes. */
+    readonly hash: v.StringSchema<undefined>;
+    readonly modules: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+}, undefined>;
+export type BlueprintVersion = v.InferOutput<typeof blueprintVersionSchema>;
+/**
+ * Strictly parse an arbitrary value (e.g. the JSON read from `blueprint.json`, or
+ * a tree returned by the Blueprinter container) into a {@link BlueprintService},
+ * enforcing the exact schema shape. Unlike the harness's lenient coercion (which
+ * silently drops malformed nodes), this **throws** on any shape violation, so a
+ * bad payload can never be materialised onto the board. Use it at every trust
+ * boundary that ingests a blueprint.
+ */
+export declare function parseBlueprintService(value: unknown): BlueprintService;
+/** Non-throwing variant: returns the parsed service or `undefined` when invalid. */
+export declare function safeParseBlueprintService(value: unknown): BlueprintService | undefined;
+/**
+ * Render a {@link BlueprintService} as readable markdown for HUMAN + COMPANION
+ * review — the descriptive counterpart of {@link renderSpecForReview}. A Blueprinter
+ * is a container agent whose reviewable work product is the decomposition tree, not
+ * its raw Pi transcript summary, so any companion grading it (today or in future)
+ * must see the tree itself: the service, its entrypoints, and each module with its
+ * responsibility and owned paths. Deterministic and dependency-free.
+ */
+export declare function renderBlueprintForReview(service: BlueprintService): string;
+//# sourceMappingURL=board-scan.d.ts.map

package/dist/board-scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-scan.d.ts","sourceRoot":"","sources":["../src/board-scan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAyB5B,+DAA+D;AAC/D,eAAO,MAAM,qBAAqB;IAChC,0EAA0E;;IAE1E,2DAA2D;;IAE3D,yEAAyE;;aAEzE,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE,2EAA2E;AAC3E,eAAO,MAAM,sBAAsB;IACjC,4EAA4E;;IAE5E,8DAA8D;;IAE9D,2DAA2D;;IAE3D,oFAAoF;;;QAjBpF,0EAA0E;;QAE1E,2DAA2D;;QAE3D,yEAAyE;;;aAgBzE,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E,sFAAsF;AACtF,eAAO,MAAM,qBAAqB,mDAAmC,CAAA;AACrE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE;;;GAGG;AACH,eAAO,MAAM,0BAA0B;IACrC,8EAA8E;;;aAG9E,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,0BAA0B,CAAC,CAAA;AASnF,6EAA6E;AAC7E,eAAO,MAAM,aAAa,eAAe,CAAA;AACzC,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB,8BAAoC,CAAA;AACpE,iEAAiE;AACjE,eAAO,MAAM,uBAAuB,2BAAiC,CAAA;AACrE,4DAA4D;AAC5D,eAAO,MAAM,qBAAqB,uBAA6B,CAAA;AAC/D,mFAAmF;AACnF,eAAO,MAAM,sBAAsB,4BAAkC,CAAA;AAErE;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;;;IAGjC,4DAA4D;;;aAG5D,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAEtE;AAED,oFAAoF;AACpF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAGtF;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAU1E"}

package/dist/board-scan.js

@@ -0,0 +1,122 @@
+import * as v from 'valibot';
+import { blockTypeSchema } from './primitives.js';
+// ---------------------------------------------------------------------------
+// Service-blueprint wire contracts. The `blueprints` pipeline step decomposes a
+// repository into one canonical board structure — a single service and the modules
+// inside it — anchored to the codebase by explicit file/directory references on
+// every node. The agent commits the decomposition into the repo (`blueprints/`)
+// and returns the tree, which the engine reconciles onto the run's service frame.
+//
+// The shape is deliberately shallow and uniform (service → modules), mirroring the
+// board's frame → module levels, so a blueprint reconciles directly onto the board
+// and reads the same way an LLM would navigate the code. Individual tasks are
+// authored by people, not derived from the map.
+// ---------------------------------------------------------------------------
+const nameField = v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(120));
+const summaryField = v.pipe(v.string(), v.maxLength(2000));
+/** A single codebase reference: a repo-relative file or directory path. */
+const referenceField = v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(400));
+/** The file/directory paths a node maps to — what to read to work on it. */
+const referencesField = v.array(referenceField);
+// ---- Blueprint tree (service → modules) -----------------------------------
+/** A cohesive area of the service (e.g. `auth`, `billing`). */
+export const blueprintModuleSchema = v.object({
+    /** Module name, typically the owning directory's domain (e.g. `Auth`). */
+    name: nameField,
+    /** One or two sentences on the module's responsibility. */
+    summary: v.optional(summaryField, ''),
+    /** Repo-relative paths the module owns (its directories / key files). */
+    references: v.optional(referencesField, []),
+});
+/** The repository as a single top-level service frame with its modules. */
+export const blueprintServiceSchema = v.object({
+    /** Board frame type the repo presents as (service / api / frontend / …). */
+    type: blockTypeSchema,
+    /** Human name for the service (defaults to the repo name). */
+    name: nameField,
+    /** One or two sentences describing the service overall. */
+    summary: v.optional(summaryField, ''),
+    /** Repo-relative entrypoints / root files (e.g. `package.json`, `src/index.ts`). */
+    references: v.optional(referencesField, []),
+    modules: v.optional(v.array(blueprintModuleSchema), []),
+});
+/** How a blueprint was produced: an LLM scan, or the deterministic tree heuristic. */
+export const blueprintSourceSchema = v.picklist(['llm', 'heuristic']);
+/**
+ * Counts of board blocks touched when the `blueprints` pipeline step materialises
+ * (or reconciles) a decomposition onto the board: the service frame and its modules.
+ */
+export const boardScanSpawnResultSchema = v.object({
+    /** Id of the service frame the blueprint was reconciled onto / spawned as. */
+    frameId: v.string(),
+    modules: v.number(),
+});
+// ---- In-repo blueprint artifact -------------------------------------------
+// The Blueprinter agent persists the decomposition in the repository itself,
+// under a dedicated folder, so it travels with the code and every agent can read
+// it. The canonical, machine-readable file is `blueprint.json` (a BlueprintService
+// tree); the markdown files are deterministic, human/agent-friendly renderings of
+// the same tree (high-level overview + per-module deep dives).
+/** Folder, relative to the repo root, that holds the persisted blueprint. */
+export const BLUEPRINT_DIR = 'blueprints';
+/** Canonical machine-readable blueprint file (the BlueprintService tree). */
+export const BLUEPRINT_JSON_PATH = `${BLUEPRINT_DIR}/blueprint.json`;
+/** High-level overview markdown — the file agents read first. */
+export const BLUEPRINT_OVERVIEW_PATH = `${BLUEPRINT_DIR}/overview.md`;
+/** Sub-folder holding one deep-dive markdown per module. */
+export const BLUEPRINT_MODULES_DIR = `${BLUEPRINT_DIR}/modules`;
+/** Tiny manifest read for quick staleness checks without parsing the full tree. */
+export const BLUEPRINT_VERSION_PATH = `${BLUEPRINT_DIR}/version.json`;
+/**
+ * The lightweight `version.json` manifest committed alongside the blueprint. It
+ * carries a monotonic version counter, the generation timestamp, and a content
+ * hash of the canonical tree, so staleness checks are a tiny read rather than a
+ * full parse of `blueprint.json`.
+ */
+export const blueprintVersionSchema = v.object({
+    version: v.pipe(v.number(), v.integer(), v.minValue(0)),
+    generatedAt: v.string(),
+    /** sha256 (hex) of the canonical `blueprint.json` bytes. */
+    hash: v.string(),
+    modules: v.pipe(v.number(), v.integer(), v.minValue(0)),
+});
+/**
+ * Strictly parse an arbitrary value (e.g. the JSON read from `blueprint.json`, or
+ * a tree returned by the Blueprinter container) into a {@link BlueprintService},
+ * enforcing the exact schema shape. Unlike the harness's lenient coercion (which
+ * silently drops malformed nodes), this **throws** on any shape violation, so a
+ * bad payload can never be materialised onto the board. Use it at every trust
+ * boundary that ingests a blueprint.
+ */
+export function parseBlueprintService(value) {
+    return v.parse(blueprintServiceSchema, value);
+}
+/** Non-throwing variant: returns the parsed service or `undefined` when invalid. */
+export function safeParseBlueprintService(value) {
+    const result = v.safeParse(blueprintServiceSchema, value);
+    return result.success ? result.output : undefined;
+}
+/**
+ * Render a {@link BlueprintService} as readable markdown for HUMAN + COMPANION
+ * review — the descriptive counterpart of {@link renderSpecForReview}. A Blueprinter
+ * is a container agent whose reviewable work product is the decomposition tree, not
+ * its raw Pi transcript summary, so any companion grading it (today or in future)
+ * must see the tree itself: the service, its entrypoints, and each module with its
+ * responsibility and owned paths. Deterministic and dependency-free.
+ */
+export function renderBlueprintForReview(service) {
+    const lines = [`# Service: ${service.name} (${service.type})`];
+    if (service.summary)
+        lines.push('', service.summary);
+    if (service.references?.length)
+        lines.push('', `Entrypoints: ${service.references.join(', ')}`);
+    for (const mod of service.modules ?? []) {
+        lines.push('', `## Module: ${mod.name}`);
+        if (mod.summary)
+            lines.push('', mod.summary);
+        if (mod.references?.length)
+            lines.push('', `Paths: ${mod.references.join(', ')}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=board-scan.js.map

package/dist/board-scan.js.map

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

package/dist/bootstrap.d.ts

@@ -0,0 +1,168 @@
+import * as v from 'valibot';
+/** A managed base repository new repos are bootstrapped from. */
+export declare const referenceArchitectureSchema: v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly workspaceId: v.StringSchema<undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly description: v.StringSchema<undefined>;
+    /** GitHub owner of the base repo (e.g. `acme`). */
+    readonly repoOwner: v.StringSchema<undefined>;
+    /** GitHub name of the base repo (e.g. `service-template`). */
+    readonly repoName: v.StringSchema<undefined>;
+    /** Default bootstrapper instructions, prepended to any per-run instructions. */
+    readonly defaultInstructions: v.StringSchema<undefined>;
+    readonly createdAt: v.NumberSchema<undefined>;
+    readonly updatedAt: v.NumberSchema<undefined>;
+}, undefined>;
+export type ReferenceArchitecture = v.InferOutput<typeof referenceArchitectureSchema>;
+/** Register a new reference architecture. */
+export declare const createReferenceArchitectureSchema: v.ObjectSchema<{
+    readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>;
+    readonly description: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, "">;
+    readonly repoOwner: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.RegexAction<string, "Only letters, digits, '.', '_' and '-' are allowed">, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 100, undefined>]>;
+    readonly repoName: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.RegexAction<string, "Only letters, digits, '.', '_' and '-' are allowed">, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 100, undefined>]>;
+    readonly defaultInstructions: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 8000, undefined>]>, "">;
+}, undefined>;
+export type CreateReferenceArchitectureInput = v.InferOutput<typeof createReferenceArchitectureSchema>;
+/** Patch an existing reference architecture (only the supplied fields change). */
+export declare const updateReferenceArchitectureSchema: v.ObjectSchema<{
+    readonly name: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>, undefined>;
+    readonly description: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+    readonly repoOwner: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.RegexAction<string, "Only letters, digits, '.', '_' and '-' are allowed">, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 100, undefined>]>, undefined>;
+    readonly repoName: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.RegexAction<string, "Only letters, digits, '.', '_' and '-' are allowed">, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 100, undefined>]>, undefined>;
+    readonly defaultInstructions: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 8000, undefined>]>, undefined>;
+}, undefined>;
+export type UpdateReferenceArchitectureInput = v.InferOutput<typeof updateReferenceArchitectureSchema>;
+/** Lifecycle of a single "bootstrap repo" run. */
+export declare const bootstrapStatusSchema: v.PicklistSchema<["pending", "running", "succeeded", "failed"], undefined>;
+export type BootstrapStatus = v.InferOutput<typeof bootstrapStatusSchema>;
+/**
+ * How a bootstrap run faulted, so the board can classify the failure (and decide
+ * whether a retry is likely to help):
+ *   - `preflight` — rejected before dispatch (repo missing/not empty, not connected).
+ *   - `dispatch`  — the container accepted-request itself failed (HTTP / network).
+ *   - `evicted`   — the container vanished mid-run (eviction/crash): its in-memory
+ *                   job was gone on the next poll. Retrying spins a fresh container.
+ *   - `timeout`   — a container watchdog fired (inactivity or max-duration).
+ *   - `agent`     — the bootstrapper agent / git push reported a failure.
+ *   - `cancelled` — the user (or an orphan sweep) explicitly stopped the run.
+ *   - `unknown`   — anything not otherwise classified.
+ */
+export declare const bootstrapFailureKindSchema: v.PicklistSchema<["preflight", "dispatch", "evicted", "timeout", "agent", "cancelled", "unknown"], undefined>;
+export type BootstrapFailureKind = v.InferOutput<typeof bootstrapFailureKindSchema>;
+/**
+ * Structured diagnostics captured when a bootstrap run fails. This is now the
+ * shared {@link agentFailureSchema} (the same shape execution runs use), so the
+ * board renders one failure banner + retry for any agent. `bootstrapFailureKind`
+ * stays a narrow alias documenting the subset a bootstrap run actually produces.
+ */
+export declare const bootstrapFailureSchema: v.ObjectSchema<{
+    readonly kind: v.PicklistSchema<["preflight", "dispatch", "evicted", "timeout", "agent", "job_failed", "rejected", "companion_rejected", "cancelled", "unknown"], undefined>;
+    readonly message: v.StringSchema<undefined>;
+    readonly detail: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly hint: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly occurredAt: v.NumberSchema<undefined>;
+    readonly lastSubtasks: v.NullableSchema<v.ObjectSchema<{
+        readonly completed: v.NumberSchema<undefined>;
+        readonly inProgress: v.NumberSchema<undefined>;
+        readonly total: v.NumberSchema<undefined>;
+        readonly items: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+            readonly label: v.StringSchema<undefined>;
+            readonly status: v.PicklistSchema<["pending", "in_progress", "completed"], undefined>;
+        }, undefined>, undefined>, undefined>;
+    }, undefined>, undefined>;
+}, undefined>;
+export type BootstrapFailure = v.InferOutput<typeof bootstrapFailureSchema>;
+/** One "bootstrap repo" run, with its outcome. */
+export declare const bootstrapJobSchema: v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly workspaceId: v.StringSchema<undefined>;
+    /** Reference architecture the run was based on, or null for a from-scratch (freeform) run. */
+    readonly referenceArchitectureId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** Denormalized at creation so the job is self-describing even if the base is later removed; null for from-scratch runs. */
+    readonly referenceArchitectureName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** Name of the new repository being created. */
+    readonly repoName: v.StringSchema<undefined>;
+    /** Owner the new repo was created under (resolved at run time), or null until known. */
+    readonly repoOwner: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** Web URL of the created repository, or null until/unless it succeeds. */
+    readonly repoUrl: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** Effective bootstrapper instructions (defaults + per-run), for transparency. */
+    readonly instructions: v.StringSchema<undefined>;
+    readonly status: v.PicklistSchema<["pending", "running", "succeeded", "failed"], undefined>;
+    /**
+     * The board service frame this run materialises. Created up front (in
+     * `running` state) so the bootstrap shows on the board immediately as a
+     * provisional "bootstrapping…" card; on success the frame is linked to the new
+     * repo and becomes a normal, droppable service. Null only if frame creation
+     * was skipped (e.g. an older job recorded before this field existed).
+     */
+    readonly blockId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /**
+     * Live subtask counts from the bootstrapper agent's todo list while the
+     * container runs, so the board can render an "N/M done" progress bar
+     * identically to a pipeline step. Null until the agent first reports.
+     */
+    readonly subtasks: v.NullableSchema<v.ObjectSchema<{
+        readonly completed: v.NumberSchema<undefined>;
+        readonly inProgress: v.NumberSchema<undefined>;
+        readonly total: v.NumberSchema<undefined>;
+        readonly items: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+            readonly label: v.StringSchema<undefined>;
+            readonly status: v.PicklistSchema<["pending", "in_progress", "completed"], undefined>;
+        }, undefined>, undefined>, undefined>;
+    }, undefined>, undefined>;
+    /** Failure reason when `status` is `failed` (one-line; see `failure` for detail). */
+    readonly error: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** Structured failure diagnostics when `status` is `failed`; null otherwise. */
+    readonly failure: v.NullableSchema<v.ObjectSchema<{
+        readonly kind: v.PicklistSchema<["preflight", "dispatch", "evicted", "timeout", "agent", "job_failed", "rejected", "companion_rejected", "cancelled", "unknown"], undefined>;
+        readonly message: v.StringSchema<undefined>;
+        readonly detail: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly hint: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly occurredAt: v.NumberSchema<undefined>;
+        readonly lastSubtasks: v.NullableSchema<v.ObjectSchema<{
+            readonly completed: v.NumberSchema<undefined>;
+            readonly inProgress: v.NumberSchema<undefined>;
+            readonly total: v.NumberSchema<undefined>;
+            readonly items: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+                readonly label: v.StringSchema<undefined>;
+                readonly status: v.PicklistSchema<["pending", "in_progress", "completed"], undefined>;
+            }, undefined>, undefined>, undefined>;
+        }, undefined>, undefined>;
+    }, undefined>, undefined>;
+    readonly createdAt: v.NumberSchema<undefined>;
+    readonly updatedAt: v.NumberSchema<undefined>;
+}, undefined>;
+export type BootstrapJob = v.InferOutput<typeof bootstrapJobSchema>;
+/**
+ * Kick off a "bootstrap repo" run. Two modes are supported:
+ *   - from a reference architecture: supply `referenceArchitectureId` (its base
+ *     repo is cloned and adapted), optionally with extra `instructions`.
+ *   - from scratch: omit `referenceArchitectureId` and describe the new service
+ *     entirely in `instructions` (the bootstrapper scaffolds an empty repo).
+ * Either a reference architecture or non-empty instructions must be provided.
+ */
+export declare const bootstrapRepoSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    /** Reference architecture to clone from; omit to bootstrap from a freeform prompt. */
+    readonly referenceArchitectureId: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>, undefined>;
+    /** Name for the new repository. */
+    readonly repoName: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.RegexAction<string, "Only letters, digits, '.', '_' and '-' are allowed">, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 100, undefined>]>;
+    /** Description applied to the new repository. */
+    readonly description: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, "">;
+    /** Whether the new repository is private (defaults to private). */
+    readonly private: v.OptionalSchema<v.BooleanSchema<undefined>, true>;
+    /**
+     * Instructions for the bootstrapper agent. With a reference architecture these
+     * are appended to its defaults; with no reference they are the whole brief.
+     */
+    readonly instructions: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 8000, undefined>]>, "">;
+}, undefined>, v.CheckAction<{
+    referenceArchitectureId?: string | null | undefined;
+    repoName: string;
+    description: string;
+    private: boolean;
+    instructions: string;
+}, "Provide a reference architecture or freeform instructions to bootstrap from.">]>;
+export type BootstrapRepoInput = v.InferOutput<typeof bootstrapRepoSchema>;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAkC5B,iEAAiE;AACjE,eAAO,MAAM,2BAA2B;;;;;IAKtC,mDAAmD;;IAEnD,8DAA8D;;IAE9D,gFAAgF;;;;aAIhF,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAErF,6CAA6C;AAC7C,eAAO,MAAM,iCAAiC;;;;;;aAM5C,CAAA;AACF,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,WAAW,CAC1D,OAAO,iCAAiC,CACzC,CAAA;AAED,kFAAkF;AAClF,eAAO,MAAM,iCAAiC;;;;;;aAM5C,CAAA;AACF,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,WAAW,CAC1D,OAAO,iCAAiC,CACzC,CAAA;AAID,kDAAkD;AAClD,eAAO,MAAM,qBAAqB,4EAA4D,CAAA;AAC9F,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,0BAA0B,+GAQrC,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAEnF;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;aAAqB,CAAA;AACxD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E,kDAAkD;AAClD,eAAO,MAAM,kBAAkB;;;IAG7B,8FAA8F;;IAE9F,4HAA4H;;IAE5H,gDAAgD;;IAEhD,wFAAwF;;IAExF,2EAA2E;;IAE3E,kFAAkF;;;IAGlF;;;;;;OAMG;;IAEH;;;;OAIG;;;;;;;;;;IAEH,qFAAqF;;IAErF,gFAAgF;;;;;;;;;;;;;;;;;;;aAIhF,CAAA;AACF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAEnE;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB;IAE5B,sFAAsF;;IAEtF,mCAAmC;;IAEnC,iDAAiD;;IAEjD,mEAAmE;;IAEnE;;;OAGG;;;;;;;;oFAON,CAAA;AACD,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,mBAAmB,CAAC,CAAA"}

package/dist/bootstrap.js

@@ -0,0 +1,148 @@
+import * as v from 'valibot';
+import { agentFailureSchema, stepSubtasksSchema } from './entities.js';
+// ---------------------------------------------------------------------------
+// Repo-bootstrap wire contracts. A "reference architecture" is a named base repo
+// (an opinionated starter / golden template an org wants new services to follow)
+// that the platform clones to spin up a brand-new repository. The bootstrap task
+// creates that new repo from the chosen reference architecture and runs a
+// bootstrapper agent inside a sandbox container to adapt it per free-form
+// instructions (rename packages, prune unused pieces, wire in the new domain…).
+//
+// Two managed resources live here:
+//   - reference architectures: a workspace-scoped, CRUD-managed list of bases.
+//   - bootstrap jobs: one record per "bootstrap repo" run, tracking its outcome.
+// ---------------------------------------------------------------------------
+const nameField = v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(120));
+/**
+ * A single GitHub owner OR repository segment (the `owner` or the `name` in
+ * `owner/name`), validated on its own — never the combined `owner/name`, so a
+ * slash is not allowed. The message reflects exactly what the regex accepts.
+ */
+const slugField = v.pipe(v.string(), v.trim(), v.regex(/^[A-Za-z0-9_.-]+$/, "Only letters, digits, '.', '_' and '-' are allowed"), v.minLength(1), v.maxLength(100));
+const descriptionField = v.pipe(v.string(), v.maxLength(2000));
+const instructionsField = v.pipe(v.string(), v.maxLength(8000));
+// ---- Reference architectures ----------------------------------------------
+/** A managed base repository new repos are bootstrapped from. */
+export const referenceArchitectureSchema = v.object({
+    id: v.string(),
+    workspaceId: v.string(),
+    name: v.string(),
+    description: v.string(),
+    /** GitHub owner of the base repo (e.g. `acme`). */
+    repoOwner: v.string(),
+    /** GitHub name of the base repo (e.g. `service-template`). */
+    repoName: v.string(),
+    /** Default bootstrapper instructions, prepended to any per-run instructions. */
+    defaultInstructions: v.string(),
+    createdAt: v.number(),
+    updatedAt: v.number(),
+});
+/** Register a new reference architecture. */
+export const createReferenceArchitectureSchema = v.object({
+    name: nameField,
+    description: v.optional(descriptionField, ''),
+    repoOwner: slugField,
+    repoName: slugField,
+    defaultInstructions: v.optional(instructionsField, ''),
+});
+/** Patch an existing reference architecture (only the supplied fields change). */
+export const updateReferenceArchitectureSchema = v.object({
+    name: v.optional(nameField),
+    description: v.optional(descriptionField),
+    repoOwner: v.optional(slugField),
+    repoName: v.optional(slugField),
+    defaultInstructions: v.optional(instructionsField),
+});
+// ---- Bootstrap jobs --------------------------------------------------------
+/** Lifecycle of a single "bootstrap repo" run. */
+export const bootstrapStatusSchema = v.picklist(['pending', 'running', 'succeeded', 'failed']);
+/**
+ * How a bootstrap run faulted, so the board can classify the failure (and decide
+ * whether a retry is likely to help):
+ *   - `preflight` — rejected before dispatch (repo missing/not empty, not connected).
+ *   - `dispatch`  — the container accepted-request itself failed (HTTP / network).
+ *   - `evicted`   — the container vanished mid-run (eviction/crash): its in-memory
+ *                   job was gone on the next poll. Retrying spins a fresh container.
+ *   - `timeout`   — a container watchdog fired (inactivity or max-duration).
+ *   - `agent`     — the bootstrapper agent / git push reported a failure.
+ *   - `cancelled` — the user (or an orphan sweep) explicitly stopped the run.
+ *   - `unknown`   — anything not otherwise classified.
+ */
+export const bootstrapFailureKindSchema = v.picklist([
+    'preflight',
+    'dispatch',
+    'evicted',
+    'timeout',
+    'agent',
+    'cancelled',
+    'unknown',
+]);
+/**
+ * Structured diagnostics captured when a bootstrap run fails. This is now the
+ * shared {@link agentFailureSchema} (the same shape execution runs use), so the
+ * board renders one failure banner + retry for any agent. `bootstrapFailureKind`
+ * stays a narrow alias documenting the subset a bootstrap run actually produces.
+ */
+export const bootstrapFailureSchema = agentFailureSchema;
+/** One "bootstrap repo" run, with its outcome. */
+export const bootstrapJobSchema = v.object({
+    id: v.string(),
+    workspaceId: v.string(),
+    /** Reference architecture the run was based on, or null for a from-scratch (freeform) run. */
+    referenceArchitectureId: v.nullable(v.string()),
+    /** Denormalized at creation so the job is self-describing even if the base is later removed; null for from-scratch runs. */
+    referenceArchitectureName: v.nullable(v.string()),
+    /** Name of the new repository being created. */
+    repoName: v.string(),
+    /** Owner the new repo was created under (resolved at run time), or null until known. */
+    repoOwner: v.nullable(v.string()),
+    /** Web URL of the created repository, or null until/unless it succeeds. */
+    repoUrl: v.nullable(v.string()),
+    /** Effective bootstrapper instructions (defaults + per-run), for transparency. */
+    instructions: v.string(),
+    status: bootstrapStatusSchema,
+    /**
+     * The board service frame this run materialises. Created up front (in
+     * `running` state) so the bootstrap shows on the board immediately as a
+     * provisional "bootstrapping…" card; on success the frame is linked to the new
+     * repo and becomes a normal, droppable service. Null only if frame creation
+     * was skipped (e.g. an older job recorded before this field existed).
+     */
+    blockId: v.nullable(v.string()),
+    /**
+     * Live subtask counts from the bootstrapper agent's todo list while the
+     * container runs, so the board can render an "N/M done" progress bar
+     * identically to a pipeline step. Null until the agent first reports.
+     */
+    subtasks: v.nullable(stepSubtasksSchema),
+    /** Failure reason when `status` is `failed` (one-line; see `failure` for detail). */
+    error: v.nullable(v.string()),
+    /** Structured failure diagnostics when `status` is `failed`; null otherwise. */
+    failure: v.nullable(bootstrapFailureSchema),
+    createdAt: v.number(),
+    updatedAt: v.number(),
+});
+/**
+ * Kick off a "bootstrap repo" run. Two modes are supported:
+ *   - from a reference architecture: supply `referenceArchitectureId` (its base
+ *     repo is cloned and adapted), optionally with extra `instructions`.
+ *   - from scratch: omit `referenceArchitectureId` and describe the new service
+ *     entirely in `instructions` (the bootstrapper scaffolds an empty repo).
+ * Either a reference architecture or non-empty instructions must be provided.
+ */
+export const bootstrapRepoSchema = v.pipe(v.object({
+    /** Reference architecture to clone from; omit to bootstrap from a freeform prompt. */
+    referenceArchitectureId: v.optional(v.nullable(v.pipe(v.string(), v.minLength(1)))),
+    /** Name for the new repository. */
+    repoName: slugField,
+    /** Description applied to the new repository. */
+    description: v.optional(descriptionField, ''),
+    /** Whether the new repository is private (defaults to private). */
+    private: v.optional(v.boolean(), true),
+    /**
+     * Instructions for the bootstrapper agent. With a reference architecture these
+     * are appended to its defaults; with no reference they are the whole brief.
+     */
+    instructions: v.optional(instructionsField, ''),
+}), v.check((input) => Boolean(input.referenceArchitectureId) || input.instructions.trim().length > 0, 'Provide a reference architecture or freeform instructions to bootstrap from.'));
+//# sourceMappingURL=bootstrap.js.map

package/dist/bootstrap.js.map

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