@cleocode/core 2026.6.12 → 2026.6.13

package/migrations/drizzle-cleo-global/20260608010000_t11709-accounts-credential-pool/migration.sql

@@ -0,0 +1,72 @@
+-- T11709 (EP-PROVIDER-VAULT · epic T10410 · saga SG-VAULT-CORE T10409) — the
+-- pooled-LLM-credential `accounts` table in the consolidated GLOBAL cleo.db
+-- (drizzle-cleo-global scope ONLY — this is a cross-project, machine-wide
+-- credential pool with no project-tier analog, so it is NOT mirrored into
+-- drizzle-cleo-project).
+--
+-- One row per LLM credential ("account") for one provider: the encrypted
+-- secret/refresh material plus rotation / cooldown / health metadata the pool
+-- runner consults to select the next live account and retire dead ones. Replaces
+-- the legacy plaintext JSON blob with a queryable, `cleo health`-visible table.
+--
+-- `secret_enc` / `refresh_enc` are encryptGlobal() ciphertext (T11710), NEVER
+-- plaintext. This is DISTINCT from `agent_registry_accounts` (the better-auth
+-- OAuth-account table) — different physical name, different purpose.
+--
+-- ## Active-account pointer (raw partial unique index)
+--
+-- `is_active` is the per-provider "currently-selected" pointer: AT MOST ONE row
+-- per `provider` may carry `is_active = 1`. drizzle-orm cannot model a partial
+-- `WHERE` unique index, so it is emitted here as raw SQL (the established repo
+-- pattern — cf. `_writer_leases.active`, T11627 · `project_agent_refs.enabled`).
+-- The drizzle schema (accounts.ts) declares only the full-column table plus the
+-- non-partial `(provider, label)` unique index that drizzle CAN emit.
+--
+-- ## Page-2 invariant
+--
+-- This migration runs AFTER the consolidation baseline (…_t11363-consolidation-
+-- cleo-global) which already creates dozens of tables, so `accounts` is NEVER the
+-- first CREATE on a fresh DB — rootpage 2 is already owned by
+-- `__drizzle_migrations` / the baseline tables. No journal pre-create is required.
+--
+-- `IF NOT EXISTS` so a re-open over an already-migrated DB is a no-op. Each
+-- statement is separated by a drizzle breakpoint marker line so node:sqlite
+-- prepare() does not silently truncate the multi-statement file to statement one
+-- (the marker token is intentionally not spelled out in this comment — drizzle's
+-- readMigrationFiles splits the file on that literal substring).
+--
+-- @task T11709
+-- @epic T10410
+-- @saga T10409
+
+CREATE TABLE IF NOT EXISTS `accounts` (
+  `id` integer PRIMARY KEY NOT NULL,
+  `provider` text NOT NULL,
+  `label` text NOT NULL,
+  `auth_type` text NOT NULL,
+  `secret_enc` text,
+  `refresh_enc` text,
+  `expires_at` text,
+  `priority` integer NOT NULL DEFAULT 0,
+  `source` text,
+  `status` text NOT NULL DEFAULT 'ok',
+  `last_error_code` text,
+  `cooldown_reset_at` text,
+  `request_count` integer NOT NULL DEFAULT 0,
+  `metadata` text NOT NULL DEFAULT '{}',
+  `is_active` integer NOT NULL DEFAULT 0,
+  `created_at` text NOT NULL DEFAULT (datetime('now')),
+  `updated_at` text NOT NULL DEFAULT (datetime('now')),
+  CHECK ("status" IN ('ok', 'exhausted', 'dead')),
+  CHECK ("is_active" IN (0, 1)),
+  CHECK ("expires_at" IS NULL OR "expires_at" GLOB '[0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9]*'),
+  CHECK ("cooldown_reset_at" IS NULL OR "cooldown_reset_at" GLOB '[0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9]*'),
+  CHECK ("created_at" IS NULL OR "created_at" GLOB '[0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9]*'),
+  CHECK ("updated_at" IS NULL OR "updated_at" GLOB '[0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9]*')
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX IF NOT EXISTS `ux_accounts_provider_label` ON `accounts` (`provider`, `label`);
+--> statement-breakpoint
+CREATE UNIQUE INDEX IF NOT EXISTS `ux_accounts_active_provider` ON `accounts` (`provider`) WHERE `is_active` = 1;
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_accounts_provider_status_priority` ON `accounts` (`provider`, `status`, `priority`);

package/migrations/drizzle-cleo-global/20260608020000_t11889-selfimprove-dhq/migration.sql

@@ -0,0 +1,64 @@
+-- T11889 (T11889-A · T11911) — the self-improvement-loop DHQ sink (`selfimprove_dhq`).
+--
+-- One row per Dogfood-Harness-Question raised by `cleo selfimprove run`: the loop
+-- replays a canned scenario, diffs the LAFS envelopes against a golden, and on
+-- regression UPSERTs exactly ONE row here via the leased Gate-3 accessor
+-- (selfimprove-dhq-store.ts). On green it writes nothing.
+--
+-- Co-located inside EACH scope's consolidated cleo.db (this file is byte-identical
+-- in drizzle-cleo-project and drizzle-cleo-global so the two lineages produce the
+-- SAME migration hash — the consolidated single-file journal converges across both
+-- under the CONSOLIDATED_JOURNAL_LINEAGES cross-lineage guard, T11829). Pure runtime
+-- infrastructure (like `_writer_leases` from T11627 and `pi_session_*` from T11899)
+-- — NOT part of the exodus target shape under `schema/cleo-project/`.
+--
+-- ## Idempotency invariant (partial UNIQUE index)
+--
+-- At most ONE row per `question_hash` may carry `status = 'open'`, so a repeated
+-- regression UPSERTs the same open row instead of spamming duplicates. drizzle-orm
+-- cannot model a partial WHERE unique index, so it is emitted here as raw SQL (the
+-- established repo pattern — cf. `_writer_leases.active`, T11627 ·
+-- `project_agent_refs.enabled`). The drizzle schema (selfimprove-dhq-schema.ts)
+-- declares ONLY the full-column table plus the two non-partial indexes drizzle CAN
+-- emit; the runtime bootstrap asserts this partial index exists
+-- (assertSelfimproveDhqOpenIndexPresent).
+--
+-- ## Page-2 invariant
+--
+-- This migration runs AFTER the consolidation baseline (…_t11363-consolidation-
+-- cleo-project) which already creates dozens of tables, so `selfimprove_dhq` is
+-- NEVER the first CREATE on a fresh DB — rootpage 2 is already owned by
+-- `__drizzle_migrations` / the baseline tables. No journal pre-create is required
+-- (the lease cold-open path pre-creates `__drizzle_migrations` before any first
+-- table, so the precondition holds even on a freshly cold-opened DB).
+--
+-- `IF NOT EXISTS` so a re-open over an already-migrated DB is a no-op. Each
+-- statement is separated by a drizzle breakpoint marker line so node:sqlite
+-- prepare() does not silently truncate the multi-statement file to statement one
+-- (the marker token is intentionally not spelled out in this comment — drizzle's
+-- readMigrationFiles splits the file on that literal substring).
+--
+-- @task T11889
+-- @task T11911
+-- @epic T11889
+
+CREATE TABLE IF NOT EXISTS `selfimprove_dhq` (
+  `id` INTEGER PRIMARY KEY,
+  `dhq_id` TEXT NOT NULL,
+  `scenario` TEXT NOT NULL,
+  `question_hash` TEXT NOT NULL,
+  `title` TEXT NOT NULL,
+  `regression_json` TEXT NOT NULL,
+  `status` TEXT NOT NULL DEFAULT 'open',
+  `severity` TEXT,
+  `pr_url` TEXT,
+  `run_id` TEXT NOT NULL,
+  `created_at` INTEGER NOT NULL,
+  `updated_at` INTEGER NOT NULL
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `ix_selfimprove_dhq_status` ON `selfimprove_dhq` (`status`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `ix_selfimprove_dhq_scenario` ON `selfimprove_dhq` (`scenario`);
+--> statement-breakpoint
+CREATE UNIQUE INDEX IF NOT EXISTS `ux_selfimprove_dhq_open` ON `selfimprove_dhq` (`question_hash`) WHERE `status` = 'open';

package/migrations/drizzle-cleo-project/20260607000000_t11891-writer-leases/migration.sql

@@ -0,0 +1,55 @@
+-- T11627 (ST-2) — DbWriterLease arbitration tables (local-mode, daemon-disabled).
+--
+-- Co-located inside EACH scope's consolidated cleo.db (this file is byte-identical
+-- in drizzle-cleo-project and drizzle-cleo-global so the two lineages produce the
+-- SAME migration hash — the consolidated single-file journal converges across both
+-- under the CONSOLIDATED_JOURNAL_LINEAGES cross-lineage guard, T11829).
+--
+-- The lease engine (packages/core/src/store/writer-lease.ts) arbitrates a single
+-- in-process writer per (scope, lane) via BEGIN IMMEDIATE + epoch-CAS over the
+-- `_writer_leases` row, healing the T5158 multi-writer corruption WITHOUT a running
+-- supervisor daemon.
+--
+-- AC1 (at most one active writer per scope/lane) is enforced by the PARTIAL UNIQUE
+-- index `ux_writer_leases_active … WHERE active = 1`. drizzle-orm cannot model a
+-- partial WHERE index, so it is emitted here as raw SQL (the established repo
+-- pattern — cf. project_agent_refs.enabled in conduit-schema). The drizzle schema
+-- (writer-lease-schema.ts) declares ONLY the full-column tables; the runtime
+-- bootstrap asserts this index exists (assertWriterLeaseActiveIndexPresent).
+--
+-- Each statement is separated by a drizzle breakpoint marker line so node:sqlite
+-- prepare() does not silently truncate the multi-statement file to statement one.
+-- (The marker token is intentionally NOT spelled out in this comment: drizzle's
+-- readMigrationFiles splits the file on that literal substring, so writing it here
+-- would split the comment mid-line and corrupt statement one.)
+--
+-- @task T11627
+-- @epic T11625
+
+CREATE TABLE IF NOT EXISTS `_writer_leases` (
+  `id` INTEGER PRIMARY KEY,
+  `scope` TEXT NOT NULL,
+  `lane` TEXT NOT NULL,
+  `holder_id` TEXT NOT NULL,
+  `holder_pid` INTEGER NOT NULL,
+  `epoch` INTEGER NOT NULL,
+  `acquired_at` INTEGER NOT NULL,
+  `heartbeat_at` INTEGER NOT NULL,
+  `ttl_ms` INTEGER NOT NULL,
+  `reentrancy_depth` INTEGER NOT NULL DEFAULT 1,
+  `active` INTEGER NOT NULL DEFAULT 1
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX IF NOT EXISTS `ux_writer_leases_active` ON `_writer_leases` (`scope`, `lane`) WHERE `active` = 1;
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS `_writer_queue` (
+  `ticket` INTEGER PRIMARY KEY AUTOINCREMENT,
+  `scope` TEXT NOT NULL,
+  `lane` TEXT NOT NULL,
+  `holder_id` TEXT NOT NULL,
+  `priority` INTEGER NOT NULL DEFAULT 100,
+  `enqueued_at` INTEGER NOT NULL,
+  `deadline_at` INTEGER NOT NULL
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `ix_writer_queue_order` ON `_writer_queue` (`scope`, `lane`, `priority` ASC, `ticket` ASC);

package/migrations/drizzle-cleo-project/20260607010000_t11639-session-parent/migration.sql

@@ -0,0 +1,22 @@
+-- T11639 (EP-SESSION-MANIFEST · epic T11638) — add nullable `parent_session_id`
+-- to `tasks_sessions` (consolidated PROJECT cleo.db, drizzle-cleo-project scope).
+--
+-- The fork-tree PARENT session edge: the orchestrator→worker spawn relationship,
+-- sourced from CLEO_PARENT_SESSION_ID (stamped by the supervisor — T11629 / PR #996)
+-- at session start. Distinct from `previous_session_id` (the linear resume chain).
+-- Soft self-reference to `tasks_sessions.id`; nullable so a root session (no spawning
+-- parent) and every existing row stay valid.
+--
+-- No CHECK constraint: `parent_session_id` is a plain free-text soft self-FK (not a
+-- timestamp `_at`, boolean, or enum), so the T11363 consolidation-check injector
+-- contributes nothing for it.
+--
+-- Each statement is separated by a drizzle breakpoint marker so node:sqlite prepare()
+-- does not truncate the multi-statement file to statement one.
+--
+-- @task T11639
+-- @epic T11638
+
+ALTER TABLE `tasks_sessions` ADD COLUMN `parent_session_id` text;
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_tasks_sessions_parent` ON `tasks_sessions` (`parent_session_id`);

package/migrations/drizzle-cleo-project/20260608000000_t11899-pi-session-tree/migration.sql

@@ -0,0 +1,52 @@
+-- T11761 (S3 · T11899) — Pi `SessionStorage` tree-persistence tables.
+--
+-- Backs `CleoSessionStorage` (packages/core/src/llm/pi/pi-session-storage.ts):
+-- the durable cleo.db implementation of Pi's tree-structured `SessionStorage`
+-- interface (@earendil-works/pi-agent-core). Every Pi session is a tree of
+-- `SessionTreeEntry` nodes (id / parentId / timestamp / type / payload) plus one
+-- leaf pointer per session; this file is the physical home for both.
+--
+-- Pure runtime infrastructure (like `_writer_leases` from T11627) — NOT part of
+-- the exodus target shape under `schema/cleo-project/`. Co-located inside EACH
+-- scope's consolidated cleo.db via the existing drizzle-cleo-project /
+-- drizzle-cleo-global migration sets; this file is byte-identical across both
+-- lineages so the two produce the SAME migration hash (the consolidated
+-- single-file journal converges across both under CONSOLIDATED_JOURNAL_LINEAGES,
+-- T11829). The Pi adapter resolves PROJECT scope; the global copy keeps the two
+-- lineages' DDL convergent (the lease-table precedent).
+--
+-- ALL writes go through the writer lease (withWriterLease('project', 'bulk', …),
+-- writer-lease.ts:1067) — the adapter NEVER opens a raw writer (Gate 3). These
+-- tables are written by the store accessor (pi-session-store.ts) over the native
+-- handle openDualScopeDb already holds, inside the leased section.
+--
+-- Each statement is separated by a drizzle breakpoint marker line so node:sqlite
+-- prepare() does not silently truncate the multi-statement file to statement one
+-- (the marker token is intentionally not spelled out in this comment — drizzle's
+-- readMigrationFiles splits the file on that literal substring).
+--
+-- @task T11899
+-- @task T11761
+-- @epic T10403
+
+CREATE TABLE IF NOT EXISTS `pi_session_entries` (
+  `session_id` TEXT NOT NULL,
+  `entry_id` TEXT NOT NULL,
+  `parent_id` TEXT,
+  `type` TEXT NOT NULL,
+  `payload_json` TEXT NOT NULL,
+  `seq` INTEGER NOT NULL,
+  `ts` TEXT NOT NULL,
+  PRIMARY KEY (`session_id`, `entry_id`)
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `ix_pi_session_entries_seq` ON `pi_session_entries` (`session_id`, `seq` ASC);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `ix_pi_session_entries_parent` ON `pi_session_entries` (`session_id`, `parent_id`);
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS `pi_session_leaf` (
+  `session_id` TEXT PRIMARY KEY,
+  `leaf_id` TEXT,
+  `created_at` TEXT NOT NULL,
+  `updated_at` TEXT NOT NULL
+);

package/migrations/drizzle-cleo-project/20260608020000_t11889-selfimprove-dhq/migration.sql

@@ -0,0 +1,64 @@
+-- T11889 (T11889-A · T11911) — the self-improvement-loop DHQ sink (`selfimprove_dhq`).
+--
+-- One row per Dogfood-Harness-Question raised by `cleo selfimprove run`: the loop
+-- replays a canned scenario, diffs the LAFS envelopes against a golden, and on
+-- regression UPSERTs exactly ONE row here via the leased Gate-3 accessor
+-- (selfimprove-dhq-store.ts). On green it writes nothing.
+--
+-- Co-located inside EACH scope's consolidated cleo.db (this file is byte-identical
+-- in drizzle-cleo-project and drizzle-cleo-global so the two lineages produce the
+-- SAME migration hash — the consolidated single-file journal converges across both
+-- under the CONSOLIDATED_JOURNAL_LINEAGES cross-lineage guard, T11829). Pure runtime
+-- infrastructure (like `_writer_leases` from T11627 and `pi_session_*` from T11899)
+-- — NOT part of the exodus target shape under `schema/cleo-project/`.
+--
+-- ## Idempotency invariant (partial UNIQUE index)
+--
+-- At most ONE row per `question_hash` may carry `status = 'open'`, so a repeated
+-- regression UPSERTs the same open row instead of spamming duplicates. drizzle-orm
+-- cannot model a partial WHERE unique index, so it is emitted here as raw SQL (the
+-- established repo pattern — cf. `_writer_leases.active`, T11627 ·
+-- `project_agent_refs.enabled`). The drizzle schema (selfimprove-dhq-schema.ts)
+-- declares ONLY the full-column table plus the two non-partial indexes drizzle CAN
+-- emit; the runtime bootstrap asserts this partial index exists
+-- (assertSelfimproveDhqOpenIndexPresent).
+--
+-- ## Page-2 invariant
+--
+-- This migration runs AFTER the consolidation baseline (…_t11363-consolidation-
+-- cleo-project) which already creates dozens of tables, so `selfimprove_dhq` is
+-- NEVER the first CREATE on a fresh DB — rootpage 2 is already owned by
+-- `__drizzle_migrations` / the baseline tables. No journal pre-create is required
+-- (the lease cold-open path pre-creates `__drizzle_migrations` before any first
+-- table, so the precondition holds even on a freshly cold-opened DB).
+--
+-- `IF NOT EXISTS` so a re-open over an already-migrated DB is a no-op. Each
+-- statement is separated by a drizzle breakpoint marker line so node:sqlite
+-- prepare() does not silently truncate the multi-statement file to statement one
+-- (the marker token is intentionally not spelled out in this comment — drizzle's
+-- readMigrationFiles splits the file on that literal substring).
+--
+-- @task T11889
+-- @task T11911
+-- @epic T11889
+
+CREATE TABLE IF NOT EXISTS `selfimprove_dhq` (
+  `id` INTEGER PRIMARY KEY,
+  `dhq_id` TEXT NOT NULL,
+  `scenario` TEXT NOT NULL,
+  `question_hash` TEXT NOT NULL,
+  `title` TEXT NOT NULL,
+  `regression_json` TEXT NOT NULL,
+  `status` TEXT NOT NULL DEFAULT 'open',
+  `severity` TEXT,
+  `pr_url` TEXT,
+  `run_id` TEXT NOT NULL,
+  `created_at` INTEGER NOT NULL,
+  `updated_at` INTEGER NOT NULL
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `ix_selfimprove_dhq_status` ON `selfimprove_dhq` (`status`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `ix_selfimprove_dhq_scenario` ON `selfimprove_dhq` (`scenario`);
+--> statement-breakpoint
+CREATE UNIQUE INDEX IF NOT EXISTS `ux_selfimprove_dhq_open` ON `selfimprove_dhq` (`question_hash`) WHERE `status` = 'open';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/core",
-  "version": "2026.6.12",
+  "version": "2026.6.13",
   "description": "CLEO core business logic kernel — tasks, sessions, memory, orchestration, lifecycle, with bundled SQLite store",
   "type": "module",
   "main": "./dist/index.js",
@@ -398,6 +398,8 @@
     "@anthropic-ai/sdk": "^0.88.0",
     "@aws-sdk/client-bedrock-runtime": "^3.0.0",
     "@aws-sdk/credential-providers": "^3.0.0",
+    "@earendil-works/pi-agent-core": "0.78.1",
+    "@earendil-works/pi-ai": "0.78.1",
     "@google/generative-ai": "^0.21.0",
     "@huggingface/transformers": "^4.0.1",
     "ai": "^6.0.162",
@@ -429,16 +431,16 @@
     "write-file-atomic": "^7.0.1",
     "yaml": "^2.8.3",
     "zod": "^4.3.6",
-    "@cleocode/caamp": "2026.6.12",
-    "@cleocode/agents": "2026.6.12",
-    "@cleocode/contracts": "2026.6.12",
-    "@cleocode/adapters": "2026.6.12",
-    "@cleocode/git-shim": "2026.6.12",
-    "@cleocode/lafs": "2026.6.12",
-    "@cleocode/nexus": "2026.6.12",
-    "@cleocode/worktree": "2026.6.12",
-    "@cleocode/paths": "2026.6.12",
-    "@cleocode/skills": "2026.6.12"
+    "@cleocode/adapters": "2026.6.13",
+    "@cleocode/agents": "2026.6.13",
+    "@cleocode/contracts": "2026.6.13",
+    "@cleocode/caamp": "2026.6.13",
+    "@cleocode/git-shim": "2026.6.13",
+    "@cleocode/nexus": "2026.6.13",
+    "@cleocode/paths": "2026.6.13",
+    "@cleocode/skills": "2026.6.13",
+    "@cleocode/lafs": "2026.6.13",
+    "@cleocode/worktree": "2026.6.13"
   },
   "engines": {
     "node": ">=24.16.0"
@@ -472,13 +474,13 @@
   },
   "optionalDependencies": {
     "llmtxt": "^2026.5.15",
-    "@cleocode/studio": "^2026.6.12"
+    "@cleocode/studio": "^2026.6.13"
   },
   "scripts": {
     "build": "tsc",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
-    "test:integration": "vitest run --include 'src/store/__tests__/*-integration.test.ts'",
+    "test:integration": "cd ../.. && vitest run --config packages/core/vitest.integration.config.ts",
     "postinstall": "node scripts/install-supervisor-binary.mjs"
   }
 }

package/dist/lifecycle/chain-composition.d.ts

@@ -1,30 +0,0 @@
-/**
- * Chain Composition Operators
- *
- * Provides operators to combine WarpChains via sequencing (A then B)
- * and parallel execution (fork-join).
- *
- * @task T5406
- */
-import type { WarpChain, WarpStage } from '@cleocode/contracts';
-/**
- * Sequence two chains: connect A's exit points to B's entry point.
- *
- * B's stage IDs are prefixed with "b" to avoid collision with A.
- * The result is validated and throws if invalid.
- *
- * @task T5406
- */
-export declare function sequenceChains(a: WarpChain, b: WarpChain): WarpChain;
-/**
- * Compose chains in parallel with a common fork entry and join stage.
- *
- * Creates a fork entry stage that links to each chain's entry, and
- * all chain exits link to the provided joinStage.
- *
- * Each chain's IDs are prefixed with "p{index}" to avoid collisions.
- *
- * @task T5406
- */
-export declare function parallelChains(chains: WarpChain[], joinStage: WarpStage): WarpChain;
-//# sourceMappingURL=chain-composition.d.ts.map

package/dist/lifecycle/chain-composition.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"chain-composition.d.ts","sourceRoot":"","sources":["../../src/lifecycle/chain-composition.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAA4B,SAAS,EAAY,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAqDpG;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,SAAS,CA+BpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,SAAS,GAAG,SAAS,CAiEnF"}

package/dist/lifecycle/chain-composition.js

@@ -1,152 +0,0 @@
-/**
- * Chain Composition Operators
- *
- * Provides operators to combine WarpChains via sequencing (A then B)
- * and parallel execution (fork-join).
- *
- * @task T5406
- */
-import { validateChain } from '../validation/chain-validation.js';
-/**
- * Prefix all stage IDs, link references, gate stageIds, and gate check stageIds
- * in a chain to avoid ID collisions during composition.
- *
- * @task T5406
- */
-function prefixChain(chain, prefix) {
-    const pfx = (id) => `${prefix}_${id}`;
-    const stages = chain.shape.stages.map((s) => ({
-        ...s,
-        id: pfx(s.id),
-    }));
-    const links = chain.shape.links.map((l) => ({
-        ...l,
-        from: pfx(l.from),
-        to: pfx(l.to),
-    }));
-    const gates = chain.gates.map((g) => {
-        const prefixed = {
-            ...g,
-            id: pfx(g.id),
-            stageId: pfx(g.stageId),
-            check: { ...g.check },
-        };
-        if (prefixed.check.type === 'stage_complete') {
-            prefixed.check = {
-                type: 'stage_complete',
-                stageId: pfx(g.check.type === 'stage_complete' ? g.check.stageId : ''),
-            };
-        }
-        return prefixed;
-    });
-    const shape = {
-        stages,
-        links,
-        entryPoint: pfx(chain.shape.entryPoint),
-        exitPoints: chain.shape.exitPoints.map(pfx),
-    };
-    return {
-        ...chain,
-        shape,
-        gates,
-    };
-}
-/**
- * Sequence two chains: connect A's exit points to B's entry point.
- *
- * B's stage IDs are prefixed with "b" to avoid collision with A.
- * The result is validated and throws if invalid.
- *
- * @task T5406
- */
-export function sequenceChains(a, b) {
-    const prefixedB = prefixChain(b, 'b');
-    const bridgeLinks = a.shape.exitPoints.map((exit) => ({
-        from: exit,
-        to: prefixedB.shape.entryPoint,
-        type: 'linear',
-    }));
-    const shape = {
-        stages: [...a.shape.stages, ...prefixedB.shape.stages],
-        links: [...a.shape.links, ...bridgeLinks, ...prefixedB.shape.links],
-        entryPoint: a.shape.entryPoint,
-        exitPoints: prefixedB.shape.exitPoints,
-    };
-    const result = {
-        id: `${a.id}+${b.id}`,
-        name: `${a.name} -> ${b.name}`,
-        version: '1.0.0',
-        description: `Sequential composition of ${a.id} and ${b.id}`,
-        shape,
-        gates: [...a.gates, ...prefixedB.gates],
-    };
-    const validation = validateChain(result);
-    if (validation.errors.length > 0) {
-        throw new Error(`sequenceChains produced invalid chain: ${validation.errors.join('; ')}`);
-    }
-    return result;
-}
-/**
- * Compose chains in parallel with a common fork entry and join stage.
- *
- * Creates a fork entry stage that links to each chain's entry, and
- * all chain exits link to the provided joinStage.
- *
- * Each chain's IDs are prefixed with "p{index}" to avoid collisions.
- *
- * @task T5406
- */
-export function parallelChains(chains, joinStage) {
-    if (chains.length === 0) {
-        throw new Error('parallelChains requires at least one chain');
-    }
-    const forkStage = {
-        id: 'parallel-fork',
-        name: 'Parallel Fork',
-        category: 'custom',
-        skippable: false,
-        description: 'Fork point for parallel chain execution',
-    };
-    const prefixedChains = chains.map((c, i) => prefixChain(c, `p${i}`));
-    const forkLinks = prefixedChains.map((pc) => ({
-        from: forkStage.id,
-        to: pc.shape.entryPoint,
-        type: 'fork',
-    }));
-    const joinLinks = prefixedChains.flatMap((pc) => pc.shape.exitPoints.map((exit) => ({
-        from: exit,
-        to: joinStage.id,
-        type: 'branch',
-    })));
-    const allStages = [
-        forkStage,
-        ...prefixedChains.flatMap((pc) => pc.shape.stages),
-        joinStage,
-    ];
-    const allLinks = [
-        ...forkLinks,
-        ...prefixedChains.flatMap((pc) => pc.shape.links),
-        ...joinLinks,
-    ];
-    const allGates = prefixedChains.flatMap((pc) => pc.gates);
-    const shape = {
-        stages: allStages,
-        links: allLinks,
-        entryPoint: forkStage.id,
-        exitPoints: [joinStage.id],
-    };
-    const result = {
-        id: `parallel(${chains.map((c) => c.id).join(',')})`,
-        name: `Parallel: ${chains.map((c) => c.name).join(' | ')}`,
-        version: '1.0.0',
-        description: `Parallel composition of ${chains.length} chains`,
-        shape,
-        gates: allGates,
-    };
-    const validation = validateChain(result);
-    if (validation.errors.length > 0) {
-        throw new Error(`parallelChains produced invalid chain: ${validation.errors.join('; ')}`);
-    }
-    return result;
-}
-//# sourceMappingURL=chain-composition.js.map

package/dist/lifecycle/chain-composition.js.map

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

package/dist/lifecycle/chain-store.d.ts

@@ -1,70 +0,0 @@
-/**
- * WarpChain Storage — CRUD operations for chain definitions and instances.
- *
- * Uses tasks.db (main database) via the native SQLite adapter.
- * Tables: warp_chains, warp_chain_instances (defined in chain-schema.ts).
- *
- * @task T5403
- */
-import type { GateResult, WarpChain, WarpChainInstance } from '@cleocode/contracts';
-export interface ChainFindCriteria {
-    query?: string;
-    category?: WarpChain['shape']['stages'][number]['category'];
-    tessera?: string;
-    archetype?: string;
-    limit?: number;
-}
-/**
- * Store a validated WarpChain definition.
- *
- * Validates the chain before storing. Throws if validation fails.
- *
- * @task T5403
- */
-export declare function addChain(chain: WarpChain, projectRoot: string): Promise<void>;
-/**
- * Retrieve a WarpChain definition by ID.
- *
- * @task T5403
- */
-export declare function showChain(id: string, projectRoot: string): Promise<WarpChain | null>;
-/**
- * List all stored WarpChain definitions.
- *
- * @task T5403
- */
-export declare function listChains(projectRoot: string): Promise<WarpChain[]>;
-/**
- * Find WarpChain definitions by criteria.
- *
- * @task T5403
- */
-export declare function findChains(criteria: ChainFindCriteria, projectRoot: string): Promise<WarpChain[]>;
-/**
- * Create a chain instance binding a chain to an epic.
- *
- * @task T5403
- */
-export declare function createInstance(params: {
-    chainId: string;
-    epicId: string;
-    variables?: Record<string, unknown>;
-    stageToTask?: Record<string, string>;
-}, projectRoot: string): Promise<WarpChainInstance>;
-/**
- * Retrieve a chain instance by ID.
- *
- * @task T5403
- */
-export declare function showInstance(id: string, projectRoot: string): Promise<WarpChainInstance | null>;
-/**
- * Read persisted gate results for a chain instance.
- */
-export declare function listInstanceGateResults(id: string, projectRoot: string): Promise<GateResult[]>;
-/**
- * Advance a chain instance to the next stage, recording gate results.
- *
- * @task T5403
- */
-export declare function advanceInstance(id: string, nextStage: string, gateResults: GateResult[], projectRoot: string): Promise<WarpChainInstance>;
-//# sourceMappingURL=chain-store.d.ts.map

package/dist/lifecycle/chain-store.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"chain-store.d.ts","sourceRoot":"","sources":["../../src/lifecycle/chain-store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAIpF,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAiBD;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBnF;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAQ1F;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAK1E;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,iBAAiB,EAC3B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,SAAS,EAAE,CAAC,CAmCtB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE;IACN,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC,EACD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,CAAC,CAqC5B;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAoBnC;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,EAAE,CAAC,CAgBvB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,UAAU,EAAE,EACzB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,CAAC,CAoE5B"}