@cat-factory/contracts 0.86.0 → 0.88.0

package/dist/initiative.js

@@ -0,0 +1,325 @@
+import * as v from 'valibot';
+// ---------------------------------------------------------------------------
+// Initiative wire contracts. An Initiative is the longer-running counterpart to
+// a task: a multi-phase body of work (a cross-cutting refactor, a migration, a
+// strangler conversion) planned once by the Initiative Planning pipeline and
+// then executed as a loop of ordinary tasks until every item is resolved.
+//
+// The DB row (the `initiatives` table, one per initiative-level block) is the
+// SOURCE OF TRUTH: the execution loop needs transactional state (a `rev` CAS
+// token, item↔block mapping) that a Git file cannot provide. The committed
+// in-repo tracker (`docs/initiatives/<slug>/…`) is a deterministic, rendered
+// PROJECTION of this entity — the blueprint artifact pattern — so the plan
+// travels with the code and stays human-readable.
+//
+// Items carry planner-authored estimates (the task-estimator axes) so the loop
+// can pick each spawned task's pipeline by matching the estimate against the
+// initiative's ordered pipeline rules (OR across axes — `StepGating` semantics).
+// ---------------------------------------------------------------------------
+// Field length/value bounds, exported as named constants so the lenient coercion in
+// `@cat-factory/agents` (`coerceInitiativePlan`) clamps to the SAME limits this strict schema
+// enforces — a single source of truth, so bumping a bound here can't leave the coercion
+// silently truncating to a stale value (or emitting a plan the parser then rejects).
+export const INITIATIVE_ID_MAX = 80;
+export const INITIATIVE_TITLE_MAX = 200;
+export const INITIATIVE_PROSE_MAX = 8000;
+export const INITIATIVE_SHORT_MAX = 2000;
+export const INITIATIVE_MAX_CONCURRENT = 20;
+const score = v.pipe(v.number(), v.minValue(0), v.maxValue(1));
+const idField = v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(INITIATIVE_ID_MAX));
+const titleField = v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(INITIATIVE_TITLE_MAX));
+const proseField = v.pipe(v.string(), v.maxLength(INITIATIVE_PROSE_MAX));
+const shortProseField = v.pipe(v.string(), v.maxLength(INITIATIVE_SHORT_MAX));
+/** Lifecycle of a single tracker item (one unit of work → one spawned task). */
+export const initiativeItemStatusSchema = v.picklist([
+    'pending',
+    'in_progress',
+    'pr_open',
+    'done',
+    'blocked',
+    'skipped',
+]);
+/** Lifecycle of the initiative as a whole. */
+export const initiativeStatusSchema = v.picklist([
+    'planning',
+    'awaiting_approval',
+    'executing',
+    'paused',
+    'done',
+    'cancelled',
+]);
+/**
+ * A planner-authored triage of one item on the task-estimator axes. Stamped onto
+ * the spawned block's `estimate` (with `createdAt`/`model` added) so downstream
+ * estimate-gated steps see it, and matched against the initiative's pipeline
+ * rules to pick the task's pipeline.
+ */
+export const initiativeEstimateSchema = v.object({
+    complexity: score,
+    risk: score,
+    impact: score,
+    rationale: v.optional(shortProseField, ''),
+});
+/**
+ * One ordered pipeline-selection rule: the item's estimate matches when ANY
+ * supplied axis is met or exceeded (OR across axes — the `StepGating` semantics
+ * of `shouldRunGatedStep`). First matching rule wins; no match falls through to
+ * the policy's `defaultPipelineId`. A rule with no thresholds never matches.
+ */
+export const initiativePipelineRuleSchema = v.object({
+    pipelineId: idField,
+    minComplexity: v.optional(score),
+    minRisk: v.optional(score),
+    minImpact: v.optional(score),
+});
+/**
+ * How the execution loop runs the plan: how many tasks may be in flight at once,
+ * and which pipeline each spawned task gets. Agreed during planning.
+ */
+export const initiativeExecutionPolicySchema = v.object({
+    /** Max concurrently-running spawned tasks across the whole initiative. */
+    maxConcurrent: v.pipe(v.number(), v.integer(), v.minValue(1), v.maxValue(INITIATIVE_MAX_CONCURRENT)),
+    /** Ordered estimate→pipeline rules; first match wins. */
+    rules: v.optional(v.array(initiativePipelineRuleSchema), []),
+    /** Pipeline used when no rule matches (or the item carries no estimate). */
+    defaultPipelineId: idField,
+    /**
+     * What to do when an item has NO estimate: `default` uses `defaultPipelineId`;
+     * `strongest` uses the last rule's pipeline (rules are ordered weakest-first),
+     * fail-safe to thoroughness.
+     */
+    onMissingEstimate: v.optional(v.picklist(['default', 'strongest']), 'default'),
+});
+/** One phase of the plan. Array order IS the phase order; phases run sequentially. */
+export const initiativePhaseSchema = v.object({
+    id: idField,
+    title: titleField,
+    /** What this phase achieves — shown on the tracker, not fed to agents. */
+    goal: v.optional(shortProseField, ''),
+    /** Optional tighter concurrency cap for this phase alone. */
+    maxConcurrent: v.optional(v.pipe(v.number(), v.integer(), v.minValue(1), v.maxValue(INITIATIVE_MAX_CONCURRENT))),
+});
+/** One unit of work in the tracker — spawned just-in-time as a task block. */
+export const initiativeItemSchema = v.object({
+    id: idField,
+    /** The owning phase (must reference a `phases[].id`). */
+    phaseId: idField,
+    title: titleField,
+    /** The spawned task's description — written to be self-sufficient. */
+    description: proseField,
+    /** Intra-initiative item ids that must be `done` before this item may start. */
+    dependsOn: v.optional(v.array(idField), []),
+    /** Planner-authored estimate driving pipeline selection (absent ⇒ policy fallback). */
+    estimate: v.optional(initiativeEstimateSchema),
+    /** Explicit pipeline override; absent ⇒ the policy's rules decide. */
+    pipelineId: v.optional(idField),
+    status: initiativeItemStatusSchema,
+    /** Id of the task block the loop spawned for this item; null until spawned. */
+    blockId: v.optional(v.nullable(v.string())),
+    /** The item's pull request, copied from the spawned block at settlement. */
+    pr: v.optional(v.object({ url: v.string(), number: v.optional(v.number()) })),
+    /** Loop/human annotation — e.g. the failure detail that blocked the item. */
+    note: v.optional(shortProseField),
+});
+/** A decision recorded on the tracker (made during planning or mid-flight). */
+export const initiativeDecisionSchema = v.object({
+    id: idField,
+    at: v.number(),
+    title: titleField,
+    detail: v.optional(shortProseField, ''),
+    source: v.picklist(['planning', 'human', 'agent']),
+});
+/** A deviation from the plan discovered mid-flight (e.g. a failed item's cause). */
+export const initiativeDeviationSchema = v.object({
+    id: idField,
+    at: v.number(),
+    /** The item the deviation relates to; null for initiative-wide deviations. */
+    itemId: v.optional(v.nullable(idField)),
+    description: shortProseField,
+    resolution: v.optional(shortProseField),
+});
+/** A follow-up surfaced during execution, awaiting triage into a real item. */
+export const initiativeFollowUpSchema = v.object({
+    id: idField,
+    at: v.number(),
+    /** The item whose run surfaced this follow-up; null when raised by a human. */
+    sourceItemId: v.optional(v.nullable(idField)),
+    title: titleField,
+    detail: v.optional(shortProseField, ''),
+    status: v.picklist(['open', 'promoted', 'dismissed']),
+    /** The item this follow-up was promoted into, once `promoted`. */
+    promotedItemId: v.optional(idField),
+});
+/** A single planning-interview exchange, kept as a bounded digest on the tracker. */
+export const initiativeQaSchema = v.object({
+    question: shortProseField,
+    answer: shortProseField,
+});
+/**
+ * The persisted initiative entity — the DB source of truth the loop mutates and
+ * the snapshot carries. `rev` is the optimistic-concurrency token: every write
+ * goes through a compare-and-swap on it, making the execution loop a single
+ * writer by construction. The current phase is DERIVED (the first phase with a
+ * non-`done`/non-`skipped` item), never stored.
+ */
+export const initiativeSchema = v.object({
+    id: v.string(),
+    /** The initiative-level board block this entity belongs to (1:1). */
+    blockId: v.string(),
+    /** Stable slug naming the in-repo tracker folder (`docs/initiatives/<slug>/`). */
+    slug: idField,
+    title: titleField,
+    /** The agreed goal statement (from planning). */
+    goal: v.optional(proseField, ''),
+    constraints: v.optional(v.array(shortProseField), []),
+    nonGoals: v.optional(v.array(shortProseField), []),
+    /** Bounded digest of the planning interview. */
+    qa: v.optional(v.array(initiativeQaSchema), []),
+    /** Bounded summary of the codebase analysis that informed the plan. */
+    analysisSummary: v.optional(proseField, ''),
+    phases: v.optional(v.array(initiativePhaseSchema), []),
+    items: v.optional(v.array(initiativeItemSchema), []),
+    policy: v.optional(v.nullable(initiativeExecutionPolicySchema)),
+    decisions: v.optional(v.array(initiativeDecisionSchema), []),
+    deviations: v.optional(v.array(initiativeDeviationSchema), []),
+    followUps: v.optional(v.array(initiativeFollowUpSchema), []),
+    caveats: v.optional(v.array(shortProseField), []),
+    status: initiativeStatusSchema,
+    /**
+     * Repo-mirror bookkeeping: the last committed tracker version + content hash
+     * (see {@link initiativeVersionSchema}). Absent until the first commit, or
+     * forever on a GitHub-unwired workspace — render from the entity, never assume
+     * the mirror exists.
+     */
+    doc: v.optional(v.object({ version: v.number(), hash: v.string(), committedAt: v.number() })),
+    /** Optimistic-concurrency token; bumped on every successful write. */
+    rev: v.number(),
+    createdAt: v.number(),
+    updatedAt: v.number(),
+});
+// ---- Planner output (the plan draft) ---------------------------------------
+/** A draft item as the planner emits it — no runtime fields yet. */
+export const initiativeDraftItemSchema = v.object({
+    id: v.optional(idField),
+    phaseId: idField,
+    title: titleField,
+    description: v.optional(proseField, ''),
+    dependsOn: v.optional(v.array(idField), []),
+    estimate: v.optional(initiativeEstimateSchema),
+    pipelineId: v.optional(idField),
+});
+/**
+ * The `initiative-planner` agent's structured output: the multi-phase plan minus
+ * all runtime state. Ingest turns it into the persisted entity (`applyPlanDraft`),
+ * assigning deterministic ids where the draft omitted them and stamping every
+ * item `pending`.
+ */
+export const initiativePlanDraftSchema = v.object({
+    goal: v.optional(proseField, ''),
+    constraints: v.optional(v.array(shortProseField), []),
+    nonGoals: v.optional(v.array(shortProseField), []),
+    analysisSummary: v.optional(proseField, ''),
+    phases: v.array(v.object({
+        id: v.optional(idField),
+        title: titleField,
+        goal: v.optional(shortProseField, ''),
+        maxConcurrent: v.optional(v.pipe(v.number(), v.integer(), v.minValue(1), v.maxValue(INITIATIVE_MAX_CONCURRENT))),
+    })),
+    items: v.array(initiativeDraftItemSchema),
+    policy: initiativeExecutionPolicySchema,
+    decisions: v.optional(v.array(v.object({ title: titleField, detail: v.optional(shortProseField, '') })), []),
+    caveats: v.optional(v.array(shortProseField), []),
+});
+// ---- Request bodies ---------------------------------------------------------
+/** Create an initiative block (+ its empty entity) under a service frame. */
+export const createInitiativeSchema = v.object({
+    frameId: v.pipe(v.string(), v.trim(), v.minLength(1)),
+    title: titleField,
+    description: v.optional(proseField, ''),
+});
+// ---- In-repo tracker artifact ----------------------------------------------
+// The loop mirrors the entity into the target repo so the plan travels with the
+// code, following the blueprint artifact pattern: a canonical JSON file, a
+// deterministic human-readable markdown rendering, and a tiny version manifest
+// for cheap staleness checks.
+/** Folder, relative to the repo root, that holds all initiative trackers. */
+export const INITIATIVE_DOC_DIR = 'docs/initiatives';
+/** Folder for one initiative's tracker files. */
+export function initiativeDocDir(slug) {
+    return `${INITIATIVE_DOC_DIR}/${slug}`;
+}
+/**
+ * Canonical machine-readable tracker file. This is a CONTENT PROJECTION of the entity, NOT a
+ * full `Initiative`: the volatile bookkeeping (`rev`, `updatedAt`, `doc`) is deliberately
+ * excluded so its content hash stays stable across no-op DB writes (see
+ * `initiativeContentView`/`canonicalInitiativeJson` in `@cat-factory/agents`). Do NOT feed it
+ * back through `parseInitiative` — those required fields are absent by design; the DB row, not
+ * this file, is the source of truth for the runtime state.
+ */
+export function initiativeJsonPath(slug) {
+    return `${initiativeDocDir(slug)}/initiative.json`;
+}
+/** Human-readable tracker rendering (the CLAUDE.md tracker-document convention). */
+export function initiativeTrackerPath(slug) {
+    return `${initiativeDocDir(slug)}/tracker.md`;
+}
+/** Tiny manifest read for quick staleness checks without parsing the full entity. */
+export function initiativeVersionPath(slug) {
+    return `${initiativeDocDir(slug)}/version.json`;
+}
+/** The lightweight `version.json` manifest committed alongside the tracker. */
+export const initiativeVersionSchema = v.object({
+    version: v.pipe(v.number(), v.integer(), v.minValue(0)),
+    generatedAt: v.string(),
+    /** sha256 (hex) of the canonical `initiative.json` bytes. */
+    hash: v.string(),
+    items: v.pipe(v.number(), v.integer(), v.minValue(0)),
+});
+/**
+ * Strictly parse an arbitrary value into an {@link Initiative}, enforcing the
+ * exact schema shape. **Throws** on any violation — use at every trust boundary
+ * (reading `initiative.json`, ingesting a stored row).
+ */
+export function parseInitiative(value) {
+    return v.parse(initiativeSchema, value);
+}
+/** Non-throwing variant: returns the parsed initiative or `undefined` when invalid. */
+export function safeParseInitiative(value) {
+    const result = v.safeParse(initiativeSchema, value);
+    return result.success ? result.output : undefined;
+}
+/**
+ * Decode a stored row into the entity, re-imposing the column-lifted keys over the
+ * `doc` blob (a corrupt/unparseable row ⇒ null, so a list read can drop it rather than
+ * fail the whole board load). Shared by the D1 and Drizzle repositories so the
+ * column↔field contract lives in exactly one place and the runtimes can't drift.
+ */
+export function decodeInitiativeRow(row) {
+    let parsed;
+    try {
+        parsed = JSON.parse(row.doc);
+    }
+    catch {
+        return null;
+    }
+    return (safeParseInitiative({
+        ...(typeof parsed === 'object' && parsed !== null ? parsed : {}),
+        id: row.id,
+        blockId: row.block_id,
+        slug: row.slug,
+        status: row.status,
+        rev: row.rev,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    }) ?? null);
+}
+/** Strictly parse a planner plan draft. Throws on shape violations. */
+export function parseInitiativePlanDraft(value) {
+    return v.parse(initiativePlanDraftSchema, value);
+}
+/** Item statuses that count as settled (nothing left for the loop to drive). */
+export const INITIATIVE_ITEM_TERMINAL_STATUSES = new Set([
+    'done',
+    'skipped',
+]);
+//# sourceMappingURL=initiative.js.map

package/dist/initiative.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initiative.js","sourceRoot":"","sources":["../src/initiative.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,8EAA8E;AAC9E,gFAAgF;AAChF,+EAA+E;AAC/E,6EAA6E;AAC7E,0EAA0E;AAC1E,EAAE;AACF,8EAA8E;AAC9E,6EAA6E;AAC7E,2EAA2E;AAC3E,6EAA6E;AAC7E,2EAA2E;AAC3E,kDAAkD;AAClD,EAAE;AACF,+EAA+E;AAC/E,6EAA6E;AAC7E,iFAAiF;AACjF,8EAA8E;AAE9E,oFAAoF;AACpF,8FAA8F;AAC9F,wFAAwF;AACxF,qFAAqF;AACrF,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAA;AACnC,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAA;AACvC,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAA;AACxC,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAA;AACxC,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAA;AAE3C,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;AAC9D,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC,CAAA;AAC5F,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC,CAAA;AAClG,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC,CAAA;AACxE,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC,CAAA;AAE7E,gFAAgF;AAChF,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,QAAQ,CAAC;IACnD,SAAS;IACT,aAAa;IACb,SAAS;IACT,MAAM;IACN,SAAS;IACT,SAAS;CACV,CAAC,CAAA;AAGF,8CAA8C;AAC9C,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,QAAQ,CAAC;IAC/C,UAAU;IACV,mBAAmB;IACnB,WAAW;IACX,QAAQ;IACR,MAAM;IACN,WAAW;CACZ,CAAC,CAAA;AAGF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,UAAU,EAAE,KAAK;IACjB,IAAI,EAAE,KAAK;IACX,MAAM,EAAE,KAAK;IACb,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,eAAe,EAAE,EAAE,CAAC;CAC3C,CAAC,CAAA;AAGF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,UAAU,EAAE,OAAO;IACnB,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;IAChC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;IAC1B,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;CAC7B,CAAC,CAAA;AAGF;;;GAGG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,0EAA0E;IAC1E,aAAa,EAAE,CAAC,CAAC,IAAI,CACnB,CAAC,CAAC,MAAM,EAAE,EACV,CAAC,CAAC,OAAO,EAAE,EACX,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EACb,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CACtC;IACD,yDAAyD;IACzD,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,4BAA4B,CAAC,EAAE,EAAE,CAAC;IAC5D,4EAA4E;IAC5E,iBAAiB,EAAE,OAAO;IAC1B;;;;OAIG;IACH,iBAAiB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,EAAE,SAAS,CAAC;CAC/E,CAAC,CAAA;AAGF,sFAAsF;AACtF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,EAAE,EAAE,OAAO;IACX,KAAK,EAAE,UAAU;IACjB,0EAA0E;IAC1E,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,eAAe,EAAE,EAAE,CAAC;IACrC,6DAA6D;IAC7D,aAAa,EAAE,CAAC,CAAC,QAAQ,CACvB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC,CACtF;CACF,CAAC,CAAA;AAGF,8EAA8E;AAC9E,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,EAAE,EAAE,OAAO;IACX,yDAAyD;IACzD,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,UAAU;IACjB,sEAAsE;IACtE,WAAW,EAAE,UAAU;IACvB,gFAAgF;IAChF,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;IAC3C,uFAAuF;IACvF,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAC9C,sEAAsE;IACtE,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;IAC/B,MAAM,EAAE,0BAA0B;IAClC,+EAA+E;IAC/E,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,4EAA4E;IAC5E,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IAC7E,6EAA6E;IAC7E,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC;CAClC,CAAC,CAAA;AAGF,+EAA+E;AAC/E,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,EAAE,EAAE,OAAO;IACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,eAAe,EAAE,EAAE,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;CACnD,CAAC,CAAA;AAGF,oFAAoF;AACpF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,EAAE,EAAE,OAAO;IACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,8EAA8E;IAC9E,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACvC,WAAW,EAAE,eAAe;IAC5B,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC;CACxC,CAAC,CAAA;AAGF,+EAA+E;AAC/E,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,EAAE,EAAE,OAAO;IACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,+EAA+E;IAC/E,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC7C,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,eAAe,EAAE,EAAE,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IACrD,kEAAkE;IAClE,cAAc,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;CACpC,CAAC,CAAA;AAGF,qFAAqF;AACrF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,QAAQ,EAAE,eAAe;IACzB,MAAM,EAAE,eAAe;CACxB,CAAC,CAAA;AAGF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,qEAAqE;IACrE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,kFAAkF;IAClF,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,UAAU;IACjB,iDAAiD;IACjD,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC;IAChC,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,EAAE,CAAC;IACrD,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,EAAE,CAAC;IAClD,gDAAgD;IAChD,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAAE,EAAE,CAAC;IAC/C,uEAAuE;IACvE,eAAe,EAAE,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC;IAC3C,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,EAAE,EAAE,CAAC;IACtD,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,EAAE,EAAE,CAAC;IACpD,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC,CAAC;IAC/D,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC,EAAE,EAAE,CAAC;IAC5D,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,yBAAyB,CAAC,EAAE,EAAE,CAAC;IAC9D,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC,EAAE,EAAE,CAAC;IAC5D,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,EAAE,CAAC;IACjD,MAAM,EAAE,sBAAsB;IAC9B;;;;;OAKG;IACH,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC7F,sEAAsE;IACtE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAA;AAGF,+EAA+E;AAE/E,oEAAoE;AACpE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;IACvB,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC;IACvC,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;IAC3C,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAC9C,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;CAChC,CAAC,CAAA;AAGF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC;IAChC,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,EAAE,CAAC;IACrD,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,EAAE,CAAC;IAClD,eAAe,EAAE,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC;IAC3C,MAAM,EAAE,CAAC,CAAC,KAAK,CACb,CAAC,CAAC,MAAM,CAAC;QACP,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QACvB,KAAK,EAAE,UAAU;QACjB,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,eAAe,EAAE,EAAE,CAAC;QACrC,aAAa,EAAE,CAAC,CAAC,QAAQ,CACvB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC,CACtF;KACF,CAAC,CACH;IACD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,yBAAyB,CAAC;IACzC,MAAM,EAAE,+BAA+B;IACvC,SAAS,EAAE,CAAC,CAAC,QAAQ,CACnB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,eAAe,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,EACjF,EAAE,CACH;IACD,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,EAAE,CAAC;CAClD,CAAC,CAAA;AAGF,gFAAgF;AAEhF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACrD,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC;CACxC,CAAC,CAAA;AAGF,+EAA+E;AAC/E,gFAAgF;AAChF,2EAA2E;AAC3E,+EAA+E;AAC/E,8BAA8B;AAE9B,6EAA6E;AAC7E,MAAM,CAAC,MAAM,kBAAkB,GAAG,kBAAkB,CAAA;AACpD,iDAAiD;AACjD,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,GAAG,kBAAkB,IAAI,IAAI,EAAE,CAAA;AACxC,CAAC;AACD;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,kBAAkB,CAAA;AACpD,CAAC;AACD,oFAAoF;AACpF,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,aAAa,CAAA;AAC/C,CAAC;AACD,qFAAqF;AACrF,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,eAAe,CAAA;AACjD,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACvD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,6DAA6D;IAC7D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;CACtD,CAAC,CAAA;AAGF;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,CAAC,CAAC,KAAK,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAA;AACzC,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAA;IACnD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;AACnD,CAAC;AAkBD;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAsB;IACxD,IAAI,MAAe,CAAA;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;IACD,OAAO,CACL,mBAAmB,CAAC;QAClB,GAAG,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,OAAO,EAAE,GAAG,CAAC,QAAQ;QACrB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,SAAS,EAAE,GAAG,CAAC,UAAU;KAC1B,CAAC,IAAI,IAAI,CACX,CAAA;AACH,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,OAAO,CAAC,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAA;AAClD,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,MAAM,iCAAiC,GAAsC,IAAI,GAAG,CAAC;IAC1F,MAAM;IACN,SAAS;CACV,CAAC,CAAA"}

package/dist/primitives.d.ts

@@ -22,9 +22,12 @@ export type BlockStatus = v.InferOutput<typeof blockStatusSchema>;
  * structural containment tree (`parentId`); `epic` is a NON-structural grouping
  * node — it groups tasks (which may live under different modules/services) via
  * their `epicId` membership link, not via `parentId`, so deleting an epic never
- * deletes its member tasks.
+ * deletes its member tasks. `initiative` is a structural child of a frame (like
+ * a module) anchoring a long-running multi-task body of work: its plan lives in
+ * the `initiatives` entity, and the tasks its execution loop spawns link back
+ * via their `initiativeId` membership link (epic-style, not containment).
  */
-export declare const blockLevelSchema: v.PicklistSchema<["frame", "module", "task", "epic"], undefined>;
+export declare const blockLevelSchema: v.PicklistSchema<["frame", "module", "task", "epic", "initiative"], undefined>;
 export type BlockLevel = v.InferOutput<typeof blockLevelSchema>;
 /**
  * The kind of work a task represents, chosen by the human at creation. Drives the

package/dist/primitives.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAM5B,eAAO,MAAM,eAAe,mJAW1B,CAAA;AACF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,eAAe,CAAC,CAAA;AAE7D;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,6EAA6D,CAAA;AAC7F,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAErE,gGAAgG;AAChG,eAAO,MAAM,gBAAgB,YAAI,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,CAAU,CAAA;AAEvF,eAAO,MAAM,iBAAiB,iGAO5B,CAAA;AACF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAEjE;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,kEAAkD,CAAA;AAC/E,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE/D;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,mFAAmE,CAAA;AAC9F,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,cAAc,CAAC,CAAA;AAE3D,qGAAqG;AACrG,eAAO,MAAM,oBAAoB,sEAAsD,CAAA;AACvF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE;;;;;GAKG;AACH,eAAO,MAAM,SAAS,YACpB,KAAK,EACL,KAAK,EACL,KAAK,EACL,QAAQ,EACR,WAAW,EACX,KAAK,EACL,SAAS,EACT,UAAU,EACV,WAAW,EACX,OAAO,CACC,CAAA;AACV,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAA;AAEhD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOnD;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;IAC/B,qCAAqC;;IAErC,sDAAsD;;IAEtD,mDAAmD;;IAEnD,0DAA0D;;IAE1D,2FAA2F;;IAE3F;;;;;OAKG;;IAWH,sFAAsF;;aAEtF,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE,eAAO,MAAM,gBAAgB,iFAAiE,CAAA;AAC9F,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE/D,qEAAqE;AACrE,eAAO,MAAM,eAAe,iGAAqC,CAAA;AACjE,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,eAAe,CAAC,CAAA;AAE7D;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,gQASlE;AAED,eAAO,MAAM,cAAc;;;aAGzB,CAAA;AACF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,cAAc,CAAC,CAAA;AAE3D;;;;;GAKG;AACH,eAAO,MAAM,UAAU;;;aAGrB,CAAA;AACF,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,UAAU,CAAC,CAAA"}
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAM5B,eAAO,MAAM,eAAe,mJAW1B,CAAA;AACF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,eAAe,CAAC,CAAA;AAE7D;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,6EAA6D,CAAA;AAC7F,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAErE,gGAAgG;AAChG,eAAO,MAAM,gBAAgB,YAAI,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,CAAU,CAAA;AAEvF,eAAO,MAAM,iBAAiB,iGAO5B,CAAA;AACF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAEjE;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,gFAAgE,CAAA;AAC7F,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE/D;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,mFAAmE,CAAA;AAC9F,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,cAAc,CAAC,CAAA;AAE3D,qGAAqG;AACrG,eAAO,MAAM,oBAAoB,sEAAsD,CAAA;AACvF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE;;;;;GAKG;AACH,eAAO,MAAM,SAAS,YACpB,KAAK,EACL,KAAK,EACL,KAAK,EACL,QAAQ,EACR,WAAW,EACX,KAAK,EACL,SAAS,EACT,UAAU,EACV,WAAW,EACX,OAAO,CACC,CAAA;AACV,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAA;AAEhD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOnD;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;IAC/B,qCAAqC;;IAErC,sDAAsD;;IAEtD,mDAAmD;;IAEnD,0DAA0D;;IAE1D,2FAA2F;;IAE3F;;;;;OAKG;;IAWH,sFAAsF;;aAEtF,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE,eAAO,MAAM,gBAAgB,iFAAiE,CAAA;AAC9F,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE/D,qEAAqE;AACrE,eAAO,MAAM,eAAe,iGAAqC,CAAA;AACjE,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,eAAe,CAAC,CAAA;AAE7D;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,gQASlE;AAED,eAAO,MAAM,cAAc;;;aAGzB,CAAA;AACF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,cAAc,CAAC,CAAA;AAE3D;;;;;GAKG;AACH,eAAO,MAAM,UAAU;;;aAGrB,CAAA;AACF,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,UAAU,CAAC,CAAA"}

package/dist/primitives.js

@@ -40,9 +40,12 @@ export const blockStatusSchema = v.picklist([
  * structural containment tree (`parentId`); `epic` is a NON-structural grouping
  * node — it groups tasks (which may live under different modules/services) via
  * their `epicId` membership link, not via `parentId`, so deleting an epic never
- * deletes its member tasks.
+ * deletes its member tasks. `initiative` is a structural child of a frame (like
+ * a module) anchoring a long-running multi-task body of work: its plan lives in
+ * the `initiatives` entity, and the tasks its execution loop spawns link back
+ * via their `initiativeId` membership link (epic-style, not containment).
  */
-export const blockLevelSchema = v.picklist(['frame', 'module', 'task', 'epic']);
+export const blockLevelSchema = v.picklist(['frame', 'module', 'task', 'epic', 'initiative']);
 /**
  * The kind of work a task represents, chosen by the human at creation. Drives the
  * task card's icon/badge, per-type creation fields, and (optionally) the per-service

package/dist/primitives.js.map

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

package/dist/public-api-keys.d.ts

@@ -0,0 +1,54 @@
+import * as v from 'valibot';
+/** One public-API key as exposed to clients — metadata only, never the secret. */
+export declare const publicApiKeySchema: v.ObjectSchema<{
+    /** `pak_*` — also the non-secret lookup id embedded in the raw key. */
+    readonly id: v.StringSchema<undefined>;
+    readonly accountId: v.StringSchema<undefined>;
+    readonly workspaceId: v.StringSchema<undefined>;
+    readonly label: v.StringSchema<undefined>;
+    readonly createdAt: v.NumberSchema<undefined>;
+    readonly lastUsedAt: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+    /** Set when the key was revoked (tombstone); a revoked key never authenticates. */
+    readonly revokedAt: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+}, undefined>;
+export type PublicApiKey = v.InferOutput<typeof publicApiKeySchema>;
+export declare const publicApiKeyListResultSchema: v.ObjectSchema<{
+    readonly keys: v.ArraySchema<v.ObjectSchema<{
+        /** `pak_*` — also the non-secret lookup id embedded in the raw key. */
+        readonly id: v.StringSchema<undefined>;
+        readonly accountId: v.StringSchema<undefined>;
+        readonly workspaceId: v.StringSchema<undefined>;
+        readonly label: v.StringSchema<undefined>;
+        readonly createdAt: v.NumberSchema<undefined>;
+        readonly lastUsedAt: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+        /** Set when the key was revoked (tombstone); a revoked key never authenticates. */
+        readonly revokedAt: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+    }, undefined>, undefined>;
+}, undefined>;
+export type PublicApiKeyListResult = v.InferOutput<typeof publicApiKeyListResultSchema>;
+/** Mint a new key. Only a label is supplied; the scope comes from the mounting workspace. */
+export declare const createPublicApiKeySchema: v.ObjectSchema<{
+    readonly label: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>;
+}, undefined>;
+export type CreatePublicApiKeyInput = v.InferOutput<typeof createPublicApiKeySchema>;
+/**
+ * The create response: the key metadata PLUS the raw secret (`cf_live_<id>.<secret>`),
+ * returned exactly once and never again — the caller must store it now.
+ */
+export declare const createdPublicApiKeySchema: v.ObjectSchema<{
+    readonly key: v.ObjectSchema<{
+        /** `pak_*` — also the non-secret lookup id embedded in the raw key. */
+        readonly id: v.StringSchema<undefined>;
+        readonly accountId: v.StringSchema<undefined>;
+        readonly workspaceId: v.StringSchema<undefined>;
+        readonly label: v.StringSchema<undefined>;
+        readonly createdAt: v.NumberSchema<undefined>;
+        readonly lastUsedAt: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+        /** Set when the key was revoked (tombstone); a revoked key never authenticates. */
+        readonly revokedAt: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+    }, undefined>;
+    /** The full raw key, shown once. Store it — it is not recoverable. */
+    readonly secret: v.StringSchema<undefined>;
+}, undefined>;
+export type CreatedPublicApiKey = v.InferOutput<typeof createdPublicApiKeySchema>;
+//# sourceMappingURL=public-api-keys.d.ts.map

package/dist/public-api-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api-keys.d.ts","sourceRoot":"","sources":["../src/public-api-keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAiB5B,kFAAkF;AAClF,eAAO,MAAM,kBAAkB;IAC7B,uEAAuE;;;;;;;IAOvE,mFAAmF;;aAEnF,CAAA;AACF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAEnE,eAAO,MAAM,4BAA4B;;QAZvC,uEAAuE;;;;;;;QAOvE,mFAAmF;;;aAKM,CAAA;AAC3F,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,4BAA4B,CAAC,CAAA;AAEvF,6FAA6F;AAC7F,eAAO,MAAM,wBAAwB;;aAEnC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAEpF;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;QAzBpC,uEAAuE;;;;;;;QAOvE,mFAAmF;;;IAoBnF,sEAAsE;;aAEtE,CAAA;AACF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,yBAAyB,CAAC,CAAA"}

package/dist/public-api-keys.js

@@ -0,0 +1,42 @@
+import * as v from 'valibot';
+// ---------------------------------------------------------------------------
+// Inbound public-API key wire contracts.
+//
+// Unlike the direct-provider API keys (`api-keys.ts`, OUTBOUND credentials the
+// platform hands to an LLM vendor and therefore stores ENCRYPTED so it can be
+// recovered), a public-API key authenticates an EXTERNAL CALLER to our own
+// `/api/v1` surface. The platform only ever VERIFIES it, never replays it, so
+// the secret is stored as a one-way peppered hash (`HMAC-SHA256(secret,
+// ENCRYPTION_KEY)`) — irrecoverable, DB-leak-resistant. The raw key is returned
+// exactly once, on create; thereafter only metadata is exposed.
+//
+// A key is scoped to one account + workspace: every `/api/v1` call it makes is
+// bound to that workspace.
+// ---------------------------------------------------------------------------
+/** One public-API key as exposed to clients — metadata only, never the secret. */
+export const publicApiKeySchema = v.object({
+    /** `pak_*` — also the non-secret lookup id embedded in the raw key. */
+    id: v.string(),
+    accountId: v.string(),
+    workspaceId: v.string(),
+    label: v.string(),
+    createdAt: v.number(),
+    lastUsedAt: v.nullable(v.number()),
+    /** Set when the key was revoked (tombstone); a revoked key never authenticates. */
+    revokedAt: v.nullable(v.number()),
+});
+export const publicApiKeyListResultSchema = v.object({ keys: v.array(publicApiKeySchema) });
+/** Mint a new key. Only a label is supplied; the scope comes from the mounting workspace. */
+export const createPublicApiKeySchema = v.object({
+    label: v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(120)),
+});
+/**
+ * The create response: the key metadata PLUS the raw secret (`cf_live_<id>.<secret>`),
+ * returned exactly once and never again — the caller must store it now.
+ */
+export const createdPublicApiKeySchema = v.object({
+    key: publicApiKeySchema,
+    /** The full raw key, shown once. Store it — it is not recoverable. */
+    secret: v.string(),
+});
+//# sourceMappingURL=public-api-keys.js.map

package/dist/public-api-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api-keys.js","sourceRoot":"","sources":["../src/public-api-keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,8EAA8E;AAC9E,yCAAyC;AACzC,EAAE;AACF,+EAA+E;AAC/E,8EAA8E;AAC9E,2EAA2E;AAC3E,8EAA8E;AAC9E,wEAAwE;AACxE,gFAAgF;AAChF,gEAAgE;AAChE,EAAE;AACF,+EAA+E;AAC/E,2BAA2B;AAC3B,8EAA8E;AAE9E,kFAAkF;AAClF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,uEAAuE;IACvE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAClC,mFAAmF;IACnF,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAClC,CAAC,CAAA;AAGF,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAA;AAG3F,6FAA6F;AAC7F,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;CACtE,CAAC,CAAA;AAGF;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,GAAG,EAAE,kBAAkB;IACvB,sEAAsE;IACtE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAA"}

package/dist/public-api.d.ts

@@ -0,0 +1,57 @@
+import * as v from 'valibot';
+/** Start an initiative run. */
+export declare const createInitiativeJobSchema: v.ObjectSchema<{
+    /** Id of a PUBLIC, inline pipeline (e.g. `pl_initiative_breakdown`). */
+    readonly pipelineId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>;
+    /** The initiative brief — becomes the run's task description. */
+    readonly input: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 50000, undefined>]>;
+    /** Optional human-readable title for the run; defaults to a truncated `input`. */
+    readonly title: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MaxLengthAction<string, 200, undefined>]>, undefined>;
+}, undefined>;
+export type CreateInitiativeJobInput = v.InferOutput<typeof createInitiativeJobSchema>;
+/**
+ * The coarse public job status, mapped from the internal execution status:
+ * `done` → `succeeded`, `failed` → `failed`, everything else (running / paused /
+ * blocked) → `running`. External callers never see the block/board internals.
+ */
+export declare const publicJobStatusSchema: v.PicklistSchema<["running", "succeeded", "failed"], undefined>;
+export type PublicJobStatus = v.InferOutput<typeof publicJobStatusSchema>;
+/** The persisted result of a finished run — the terminal step's output. */
+export declare const publicJobResultSchema: v.ObjectSchema<{
+    /** The agent's prose output (the final reply). */
+    readonly output: v.StringSchema<undefined>;
+    /** The structured decomposition, when the agent produced one (`step.custom`). */
+    readonly data: v.NullableSchema<v.UnknownSchema, undefined>;
+}, undefined>;
+export type PublicJobResult = v.InferOutput<typeof publicJobResultSchema>;
+/** A public job resource — the external view of a headless initiative run. */
+export declare const publicJobSchema: v.ObjectSchema<{
+    readonly jobId: v.StringSchema<undefined>;
+    readonly status: v.PicklistSchema<["running", "succeeded", "failed"], undefined>;
+    readonly pipelineId: v.StringSchema<undefined>;
+    readonly createdAt: v.NumberSchema<undefined>;
+    /** Present once the run reaches `succeeded`; null while running or on failure. */
+    readonly result: v.NullableSchema<v.ObjectSchema<{
+        /** The agent's prose output (the final reply). */
+        readonly output: v.StringSchema<undefined>;
+        /** The structured decomposition, when the agent produced one (`step.custom`). */
+        readonly data: v.NullableSchema<v.UnknownSchema, undefined>;
+    }, undefined>, undefined>;
+    /** Present when `status` is `failed`; null otherwise. */
+    readonly error: v.NullableSchema<v.ObjectSchema<{
+        readonly code: v.StringSchema<undefined>;
+        readonly message: v.StringSchema<undefined>;
+    }, undefined>, undefined>;
+}, undefined>;
+export type PublicJob = v.InferOutput<typeof publicJobSchema>;
+/** The `202` returned by `POST /initiatives`: the job id + where to follow it. */
+export declare const initiativeAcceptedSchema: v.ObjectSchema<{
+    readonly jobId: v.StringSchema<undefined>;
+    readonly status: v.PicklistSchema<["running", "succeeded", "failed"], undefined>;
+    readonly links: v.ObjectSchema<{
+        readonly self: v.StringSchema<undefined>;
+        readonly events: v.StringSchema<undefined>;
+    }, undefined>;
+}, undefined>;
+export type InitiativeAccepted = v.InferOutput<typeof initiativeAcceptedSchema>;
+//# sourceMappingURL=public-api.d.ts.map

package/dist/public-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api.d.ts","sourceRoot":"","sources":["../src/public-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAY5B,+BAA+B;AAC/B,eAAO,MAAM,yBAAyB;IACpC,wEAAwE;;IAExE,iEAAiE;;IAEjE,kFAAkF;;aAElF,CAAA;AACF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAEtF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,iEAAiD,CAAA;AACnF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE,2EAA2E;AAC3E,eAAO,MAAM,qBAAqB;IAChC,kDAAkD;;IAElD,iFAAiF;;aAEjF,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE,8EAA8E;AAC9E,eAAO,MAAM,eAAe;;;;;IAK1B,kFAAkF;;QAblF,kDAAkD;;QAElD,iFAAiF;;;IAajF,yDAAyD;;;;;aAEzD,CAAA;AACF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,eAAe,CAAC,CAAA;AAE7D,kFAAkF;AAClF,eAAO,MAAM,wBAAwB;;;;;;;aAInC,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAA"}

package/dist/public-api.js

@@ -0,0 +1,50 @@
+import * as v from 'valibot';
+// ---------------------------------------------------------------------------
+// Public-API wire contracts (the `/api/v1` surface for external systems).
+//
+// First use-case: "break down an initiative". An external caller picks a public,
+// inline (no-GitHub) pipeline and supplies an initial brief; the platform runs it
+// headlessly and persists the result in the DB for asynchronous retrieval (poll
+// `GET /jobs/:id` or subscribe to `GET /jobs/:id/events` over SSE). Nothing is
+// committed to GitHub.
+// ---------------------------------------------------------------------------
+/** Start an initiative run. */
+export const createInitiativeJobSchema = v.object({
+    /** Id of a PUBLIC, inline pipeline (e.g. `pl_initiative_breakdown`). */
+    pipelineId: v.pipe(v.string(), v.trim(), v.minLength(1)),
+    /** The initiative brief — becomes the run's task description. */
+    input: v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(50_000)),
+    /** Optional human-readable title for the run; defaults to a truncated `input`. */
+    title: v.optional(v.pipe(v.string(), v.trim(), v.maxLength(200))),
+});
+/**
+ * The coarse public job status, mapped from the internal execution status:
+ * `done` → `succeeded`, `failed` → `failed`, everything else (running / paused /
+ * blocked) → `running`. External callers never see the block/board internals.
+ */
+export const publicJobStatusSchema = v.picklist(['running', 'succeeded', 'failed']);
+/** The persisted result of a finished run — the terminal step's output. */
+export const publicJobResultSchema = v.object({
+    /** The agent's prose output (the final reply). */
+    output: v.string(),
+    /** The structured decomposition, when the agent produced one (`step.custom`). */
+    data: v.nullable(v.unknown()),
+});
+/** A public job resource — the external view of a headless initiative run. */
+export const publicJobSchema = v.object({
+    jobId: v.string(),
+    status: publicJobStatusSchema,
+    pipelineId: v.string(),
+    createdAt: v.number(),
+    /** Present once the run reaches `succeeded`; null while running or on failure. */
+    result: v.nullable(publicJobResultSchema),
+    /** Present when `status` is `failed`; null otherwise. */
+    error: v.nullable(v.object({ code: v.string(), message: v.string() })),
+});
+/** The `202` returned by `POST /initiatives`: the job id + where to follow it. */
+export const initiativeAcceptedSchema = v.object({
+    jobId: v.string(),
+    status: publicJobStatusSchema,
+    links: v.object({ self: v.string(), events: v.string() }),
+});
+//# sourceMappingURL=public-api.js.map

package/dist/public-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api.js","sourceRoot":"","sources":["../src/public-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,8EAA8E;AAC9E,0EAA0E;AAC1E,EAAE;AACF,iFAAiF;AACjF,kFAAkF;AAClF,gFAAgF;AAChF,+EAA+E;AAC/E,uBAAuB;AACvB,8EAA8E;AAE9E,+BAA+B;AAC/B,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,wEAAwE;IACxE,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACxD,iEAAiE;IACjE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACxE,kFAAkF;IAClF,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;CAClE,CAAC,CAAA;AAGF;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAA;AAGnF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,kDAAkD;IAClD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,iFAAiF;IACjF,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;CAC9B,CAAC,CAAA;AAGF,8EAA8E;AAC9E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,qBAAqB;IAC7B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,kFAAkF;IAClF,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IACzC,yDAAyD;IACzD,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;CACvE,CAAC,CAAA;AAGF,kFAAkF;AAClF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,qBAAqB;IAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;CAC1D,CAAC,CAAA"}