@cleocode/core 2026.6.11 → 2026.6.13

package/dist/lifecycle/default-chain.js

@@ -1,176 +0,0 @@
-/**
- * Default RCASD-IVTR+C WarpChain Builder
- *
- * Constructs the canonical 9-stage pipeline chain from existing
- * stage definitions, prerequisites, and verification gates.
- *
- * @task T5399
- */
-import { PROTOCOL_TYPES } from '../orchestration/protocol-validators.js';
-import { VERIFICATION_GATE_ORDER } from '../validation/verification.js';
-import { PIPELINE_STAGES, STAGE_DEFINITIONS, STAGE_PREREQUISITES } from './stages.js';
-export const DEFAULT_CHAIN_ID = 'rcasd-ivtrc';
-/**
- * Stage mapping for protocol validation gates in the default chain.
- *
- * Cross-cutting protocols compose with specific host stages:
- * - `contribution` is validated at implementation (author attribution).
- * - `artifact-publish` and `provenance` are validated at release
- *   (see release.md composition: release triggers artifact-publish for the
- *   distribution phase, which delegates signing/attestation to provenance).
- *
- * Pipeline stages map 1:1 to their own protocol validators.
- *
- * @task T5419
- * @task T260 — add architecture-decision, validation, testing mappings
- */
-export const DEFAULT_PROTOCOL_STAGE_MAP = {
-    research: 'research',
-    consensus: 'consensus',
-    'architecture-decision': 'architecture_decision',
-    specification: 'specification',
-    decomposition: 'decomposition',
-    implementation: 'implementation',
-    contribution: 'implementation',
-    validation: 'validation',
-    testing: 'testing',
-    release: 'release',
-    'artifact-publish': 'release',
-    provenance: 'release',
-};
-/**
- * Map a pipeline stage name to the WarpStage category union.
- *
- * @task T5399
- */
-function stageToCategory(stage) {
-    const map = {
-        research: 'research',
-        consensus: 'consensus',
-        architecture_decision: 'architecture',
-        specification: 'specification',
-        decomposition: 'decomposition',
-        implementation: 'implementation',
-        validation: 'validation',
-        testing: 'testing',
-        release: 'release',
-    };
-    return map[stage];
-}
-/**
- * Map verification gate names to the stages they guard (exit gates).
- *
- * Each gate is positioned as an exit gate on the stage it validates:
- * - implemented -> implementation
- * - testsPassed -> testing
- * - qaPassed -> validation
- * - cleanupDone -> decomposition
- * - securityPassed -> validation
- * - documented -> specification
- *
- * @task T5399
- */
-function gateToStageId(gate) {
-    const map = {
-        implemented: 'implementation',
-        testsPassed: 'testing',
-        qaPassed: 'validation',
-        cleanupDone: 'decomposition',
-        securityPassed: 'validation',
-        documented: 'specification',
-    };
-    return map[gate];
-}
-/**
- * Build the canonical 9-stage RCASD-IVTR+C WarpChain.
- *
- * - Each PIPELINE_STAGE becomes a WarpStage
- * - Each prerequisite from STAGE_PREREQUISITES becomes an entry GateContract
- * - Each verification gate from VERIFICATION_GATE_ORDER becomes an exit GateContract
- * - All 8 links are linear (stage[i] -> stage[i+1])
- *
- * @task T5399
- */
-export function buildDefaultChain() {
-    const stages = PIPELINE_STAGES.map((stage) => {
-        const def = STAGE_DEFINITIONS[stage];
-        return {
-            id: stage,
-            name: def.name,
-            category: stageToCategory(stage),
-            skippable: def.skippable,
-            description: def.description,
-        };
-    });
-    const links = [];
-    for (let i = 0; i < PIPELINE_STAGES.length - 1; i++) {
-        links.push({
-            from: PIPELINE_STAGES[i],
-            to: PIPELINE_STAGES[i + 1],
-            type: 'linear',
-        });
-    }
-    const gates = [];
-    let gateCounter = 0;
-    for (const stage of PIPELINE_STAGES) {
-        const prereqs = STAGE_PREREQUISITES[stage];
-        for (const prereq of prereqs) {
-            gateCounter++;
-            gates.push({
-                id: `gate-entry-${gateCounter}`,
-                name: `${prereq} complete (prereq for ${stage})`,
-                type: 'entry',
-                stageId: stage,
-                position: 'before',
-                check: { type: 'stage_complete', stageId: prereq },
-                severity: 'blocking',
-                canForce: false,
-            });
-        }
-    }
-    for (const stage of PIPELINE_STAGES) {
-        for (const protocolType of PROTOCOL_TYPES) {
-            if (DEFAULT_PROTOCOL_STAGE_MAP[protocolType] !== stage) {
-                continue;
-            }
-            gateCounter++;
-            gates.push({
-                id: `gate-protocol-${gateCounter}`,
-                name: `${protocolType} protocol validation`,
-                type: 'exit',
-                stageId: stage,
-                position: 'after',
-                check: { type: 'protocol_valid', protocolType },
-                severity: 'blocking',
-                canForce: false,
-            });
-        }
-    }
-    for (const gate of VERIFICATION_GATE_ORDER) {
-        gateCounter++;
-        gates.push({
-            id: `gate-exit-${gateCounter}`,
-            name: `${gate} verification gate`,
-            type: 'exit',
-            stageId: gateToStageId(gate),
-            position: 'after',
-            check: { type: 'verification_gate', gateName: gate },
-            severity: 'blocking',
-            canForce: true,
-        });
-    }
-    return {
-        id: DEFAULT_CHAIN_ID,
-        name: 'RCASD-IVTR+C Default Pipeline',
-        version: '1.0.0',
-        description: 'Canonical 9-stage CLEO lifecycle pipeline: Research, Consensus, Architecture, Specification, Decomposition, Implementation, Validation, Testing, Release (+Contribution)',
-        shape: {
-            stages,
-            links,
-            entryPoint: PIPELINE_STAGES[0],
-            exitPoints: [PIPELINE_STAGES[PIPELINE_STAGES.length - 1]],
-        },
-        gates,
-    };
-}
-//# sourceMappingURL=default-chain.js.map

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

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

package/dist/lifecycle/tessera-engine.d.ts

@@ -1,48 +0,0 @@
-/**
- * Tessera Instantiation Engine
- *
- * Provides template management and instantiation for parameterized
- * WarpChain workflows. Wraps buildDefaultChain() with template
- * variables and manages the template registry.
- *
- * @task T5409
- */
-import type { TesseraInstantiationInput, TesseraTemplate, WarpChainInstance } from '@cleocode/contracts';
-/**
- * Build the default RCASD Tessera template.
- *
- * Wraps buildDefaultChain() with template variables:
- * - epicId (required, type 'epicId')
- * - projectName (optional, type 'string', default 'unnamed')
- * - skipResearch (optional, type 'boolean', default false)
- *
- * @task T5409
- */
-export declare function buildDefaultTessera(): TesseraTemplate;
-/**
- * Instantiate a Tessera template into a concrete WarpChainInstance.
- *
- * Steps:
- * 1. Validate all required variables are provided
- * 2. Apply defaults for missing optional variables
- * 3. Construct concrete WarpChain from template
- * 4. Validate chain via validateChain()
- * 5. Store via createInstance() from chain-store
- * 6. Return instance
- *
- * @task T5409
- */
-export declare function instantiateTessera(template: TesseraTemplate, input: TesseraInstantiationInput, projectRoot: string): Promise<WarpChainInstance>;
-/**
- * List all registered Tessera templates.
- *
- * @task T5409
- */
-export declare function listTesseraTemplates(): TesseraTemplate[];
-/**
- * Find a Tessera template by ID.
- *
- * @task T5409
- */
-export declare function showTessera(id: string): TesseraTemplate | null;
-//# sourceMappingURL=tessera-engine.d.ts.map

package/dist/lifecycle/tessera-engine.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tessera-engine.d.ts","sourceRoot":"","sources":["../../src/lifecycle/tessera-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,yBAAyB,EACzB,eAAe,EAGf,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AA6J7B;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,IAAI,eAAe,CAoCrD;AAYD;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,yBAAyB,EAChC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,CAAC,CA6C5B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,eAAe,EAAE,CAGxD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAG9D"}

package/dist/lifecycle/tessera-engine.js

@@ -1,249 +0,0 @@
-/**
- * Tessera Instantiation Engine
- *
- * Provides template management and instantiation for parameterized
- * WarpChain workflows. Wraps buildDefaultChain() with template
- * variables and manages the template registry.
- *
- * @task T5409
- */
-import { validateChain } from '../validation/chain-validation.js';
-import { addChain, createInstance, showChain } from './chain-store.js';
-import { buildDefaultChain } from './default-chain.js';
-const DEFAULT_TESSERA_ID = 'tessera-rcasd';
-const TASK_ID_PATTERN = /^T\d+$/;
-const PLACEHOLDER_EXACT = /^\{\{\s*([A-Za-z0-9_]+)\s*\}\}$/;
-const PLACEHOLDER_GLOBAL = /\{\{\s*([A-Za-z0-9_]+)\s*\}\}/g;
-function valueType(value) {
-    if (value === null) {
-        return 'null';
-    }
-    if (Array.isArray(value)) {
-        return 'array';
-    }
-    return typeof value;
-}
-function hasOwn(obj, key) {
-    return Object.hasOwn(obj, key);
-}
-function validateVariableType(name, varDef, value) {
-    switch (varDef.type) {
-        case 'string': {
-            if (typeof value !== 'string') {
-                throw new Error(`Invalid variable type for "${name}": expected string, got ${valueType(value)}`);
-            }
-            return;
-        }
-        case 'number': {
-            if (typeof value !== 'number' || !Number.isFinite(value)) {
-                throw new Error(`Invalid variable type for "${name}": expected finite number, got ${valueType(value)}`);
-            }
-            return;
-        }
-        case 'boolean': {
-            if (typeof value !== 'boolean') {
-                throw new Error(`Invalid variable type for "${name}": expected boolean, got ${valueType(value)}`);
-            }
-            return;
-        }
-        case 'taskId':
-        case 'epicId': {
-            if (typeof value !== 'string') {
-                throw new Error(`Invalid variable type for "${name}": expected ${varDef.type}, got ${valueType(value)}`);
-            }
-            if (!TASK_ID_PATTERN.test(value)) {
-                throw new Error(`Invalid variable format for "${name}": expected ${varDef.type} like "T1234", got "${value}"`);
-            }
-            return;
-        }
-        default: {
-            throw new Error(`Unsupported variable type for "${name}": ${String(varDef.type)}`);
-        }
-    }
-}
-function substituteTemplateValue(value, variables, path) {
-    if (typeof value === 'string') {
-        const exact = value.match(PLACEHOLDER_EXACT);
-        if (exact) {
-            const variableName = exact[1];
-            if (!hasOwn(variables, variableName)) {
-                throw new Error(`Unknown template variable "${variableName}" at ${path}`);
-            }
-            return variables[variableName];
-        }
-        return value.replace(PLACEHOLDER_GLOBAL, (_full, variableName) => {
-            if (!hasOwn(variables, variableName)) {
-                throw new Error(`Unknown template variable "${variableName}" at ${path}`);
-            }
-            return String(variables[variableName]);
-        });
-    }
-    if (Array.isArray(value)) {
-        return value.map((entry, index) => substituteTemplateValue(entry, variables, `${path}[${index}]`));
-    }
-    if (value !== null && typeof value === 'object') {
-        const out = {};
-        for (const [key, nested] of Object.entries(value)) {
-            out[key] = substituteTemplateValue(nested, variables, `${path}.${key}`);
-        }
-        return out;
-    }
-    return value;
-}
-function resolveVariables(template, inputVariables) {
-    const variableKeys = Object.keys(template.variables).sort();
-    const allowedVariables = new Set(variableKeys);
-    for (const key of Object.keys(inputVariables).sort()) {
-        if (!allowedVariables.has(key)) {
-            throw new Error(`Unknown variable: ${key}. Allowed variables: ${variableKeys.join(', ')}`);
-        }
-    }
-    const resolvedVariables = {};
-    for (const key of variableKeys) {
-        const varDef = template.variables[key];
-        const hasInput = hasOwn(inputVariables, key);
-        const inputValue = hasInput ? inputVariables[key] : undefined;
-        if (inputValue === undefined) {
-            if (varDef.required) {
-                throw new Error(`Missing required variable: ${key}`);
-            }
-            if (hasOwn(template.defaultValues, key)) {
-                const defaultValue = template.defaultValues[key];
-                validateVariableType(key, varDef, defaultValue);
-                resolvedVariables[key] = defaultValue;
-            }
-            else if (varDef.default !== undefined) {
-                validateVariableType(key, varDef, varDef.default);
-                resolvedVariables[key] = varDef.default;
-            }
-            continue;
-        }
-        validateVariableType(key, varDef, inputValue);
-        resolvedVariables[key] = inputValue;
-    }
-    return resolvedVariables;
-}
-/**
- * Build the default RCASD Tessera template.
- *
- * Wraps buildDefaultChain() with template variables:
- * - epicId (required, type 'epicId')
- * - projectName (optional, type 'string', default 'unnamed')
- * - skipResearch (optional, type 'boolean', default false)
- *
- * @task T5409
- */
-export function buildDefaultTessera() {
-    const chain = buildDefaultChain();
-    return {
-        ...chain,
-        id: DEFAULT_TESSERA_ID,
-        tessera: DEFAULT_TESSERA_ID,
-        variables: {
-            epicId: {
-                name: 'epicId',
-                type: 'epicId',
-                description: 'The epic task ID to bind this pipeline to',
-                required: true,
-            },
-            projectName: {
-                name: 'projectName',
-                type: 'string',
-                description: 'Name of the project for labeling',
-                required: false,
-                default: 'unnamed',
-            },
-            skipResearch: {
-                name: 'skipResearch',
-                type: 'boolean',
-                description: 'Whether to skip the research stage',
-                required: false,
-                default: false,
-            },
-        },
-        archetypes: ['lifecycle', 'rcasd'],
-        defaultValues: {
-            projectName: 'unnamed',
-            skipResearch: false,
-        },
-        category: 'lifecycle',
-    };
-}
-/** In-memory template registry. */
-const templates = new Map();
-/** Ensure the default template is registered. */
-function ensureDefaults() {
-    if (!templates.has(DEFAULT_TESSERA_ID)) {
-        templates.set(DEFAULT_TESSERA_ID, buildDefaultTessera());
-    }
-}
-/**
- * Instantiate a Tessera template into a concrete WarpChainInstance.
- *
- * Steps:
- * 1. Validate all required variables are provided
- * 2. Apply defaults for missing optional variables
- * 3. Construct concrete WarpChain from template
- * 4. Validate chain via validateChain()
- * 5. Store via createInstance() from chain-store
- * 6. Return instance
- *
- * @task T5409
- */
-export async function instantiateTessera(template, input, projectRoot) {
-    // 1. Resolve and validate input variables
-    const inputVariables = input.variables && typeof input.variables === 'object' ? input.variables : {};
-    const resolvedVariables = resolveVariables(template, inputVariables);
-    // 2. Build chain from template with deep substitution
-    const chainSeed = {
-        id: template.id,
-        name: template.name,
-        version: template.version,
-        description: template.description,
-        shape: template.shape,
-        gates: template.gates,
-        tessera: template.id,
-        metadata: template.metadata,
-    };
-    const substituted = substituteTemplateValue(chainSeed, resolvedVariables, 'chain');
-    const chain = substituted;
-    chain.metadata = {
-        ...(chain.metadata ?? {}),
-        variables: resolvedVariables,
-    };
-    // 3. Validate the chain
-    const validation = validateChain(chain);
-    if (validation.errors.length > 0) {
-        throw new Error(`Tessera chain validation failed: ${validation.errors.join('; ')}`);
-    }
-    // 4. Store chain if not already stored, then create instance
-    const existing = await showChain(chain.id, projectRoot);
-    if (!existing) {
-        await addChain(chain, projectRoot);
-    }
-    // 5. Create and return instance
-    return createInstance({
-        chainId: chain.id,
-        epicId: input.epicId,
-        variables: resolvedVariables,
-    }, projectRoot);
-}
-/**
- * List all registered Tessera templates.
- *
- * @task T5409
- */
-export function listTesseraTemplates() {
-    ensureDefaults();
-    return Array.from(templates.values());
-}
-/**
- * Find a Tessera template by ID.
- *
- * @task T5409
- */
-export function showTessera(id) {
-    ensureDefaults();
-    return templates.get(id) ?? null;
-}
-//# sourceMappingURL=tessera-engine.js.map

package/dist/lifecycle/tessera-engine.js.map

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

package/dist/release/provenance-fk.d.ts

@@ -1,74 +0,0 @@
-/**
- * Post-cutover provenance `task_id` / `epic_id` FK reconciliation (DHQ-051).
- *
- * Shared between `cleo release reconcile` ({@link releaseReconcileV2}) and
- * `cleo release plan` ({@link releasePlan} → `upsertReleasesRow`). Both verbs
- * write provenance rows (`task_commits`, `pr_tasks`, `releases`,
- * `release_changes`) whose `task_id` / `epic_id` foreign keys reference the
- * BARE `tasks` table — which is empty on a consolidated dual-scope `cleo.db`
- * after the T11578 cutover (runtime task data moved to the prefixed
- * `tasks_tasks` table). A row inserted with an `epicId` / `taskId` that exists
- * only in `tasks_tasks` violates the FK at INSERT time, aborting the verb.
- *
- * This module is the single source of truth for the FK-ordered parent backfill
- * that makes those FKs satisfiable. `reconcile.ts` re-exports both symbols so
- * its public surface is unchanged.
- *
- * @task T11659 — reconcile slice (original)
- * @task T11818 — plan/open slice (DRY hoist)
- * @epic T11466
- */
-import type { DatabaseSync } from '../store/sqlite.js';
-/** Result of resolving + reconciling the provenance `task_id` FK parent table. */
-export interface FkParentTaskResolution {
-    /** Physical table the provenance `task_id` FK references, or null if absent. */
-    parentTable: string | null;
-    /**
-     * Task IDs the FK can now resolve (FK parent rows present after any
-     * FK-ordered shim backfill). A `task_id` reference to an id in this set is
-     * safe to INSERT under strict FK enforcement.
-     */
-    resolvableIds: Set<string>;
-}
-/**
- * Make the provenance `task_id` foreign keys satisfiable on a consolidated
- * `cleo.db` by inserting any missing FK-parent rows in FK order (parent-before
- * -child), then returning the set of IDs the FK can resolve.
- *
- * ## Background (DHQ-051 · T11659 / T11818 — same class as DHQ-045)
- *
- * After the dual-scope `cleo.db` cutover (T11578) the runtime task store moved
- * from the bare `tasks` table to the prefixed `tasks_tasks` table. The drizzle
- * `schema.tasks` symbol is shadowed at the barrel (`tasks-schema.ts`) onto
- * `tasks_tasks`, so token-validity probes read the populated prefixed table.
- * BUT the provenance tables (`task_commits`, `pr_tasks`, `releases`,
- * `release_changes`) predate the cutover — their `task_id` / `epic_id` FKs
- * still reference the BARE `tasks` table, which is empty on a consolidated
- * `cleo.db`. A token validated against `tasks_tasks` therefore passes the
- * legacy gate yet violates the FK at INSERT time, aborting the whole verb with
- * `E_PROVENANCE_FAILED` (reconcile) or `E_INTERNAL` (plan).
- *
- * ## Strategy — FK-ordered parent backfill (Strategy 1)
- *
- * For every task referenced by this release we ensure a row exists in the FK
- * parent table BEFORE the child provenance rows are written. The parent table
- * is discovered dynamically via `PRAGMA foreign_key_list('task_commits')` (so
- * the logic tracks whatever the live schema enforces — including a future
- * schema that repoints the FK at `tasks_tasks`, where this becomes a no-op).
- * Missing parent rows are copied from the runtime `tasks_tasks` store via
- * `INSERT OR IGNORE … SELECT` of only the NOT NULL columns, so the copied rows
- * satisfy the parent table's own CHECK/NOT NULL constraints. Tasks that exist
- * in neither table remain unresolvable and are skipped-with-warn / NULLed by
- * the callers (the row, never the whole verb).
- *
- * Idempotent: `INSERT OR IGNORE` never duplicates and never overwrites an
- * existing parent row. Callers run it inside their write transaction so a later
- * failure rolls the shim rows back too.
- *
- * @param nativeDb - The consolidated `cleo.db` native handle.
- * @param referencedIds - Every task id this verb may reference (commit tokens,
- *   PR tokens, plan tasks, epic).
- * @returns The FK parent table name + the IDs it can now resolve.
- */
-export declare function ensureProvenanceTaskFkParents(nativeDb: DatabaseSync, referencedIds: ReadonlySet<string>): FkParentTaskResolution;
-//# sourceMappingURL=provenance-fk.d.ts.map

package/dist/release/provenance-fk.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"provenance-fk.d.ts","sourceRoot":"","sources":["../../src/release/provenance-fk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD,kFAAkF;AAClF,MAAM,WAAW,sBAAsB;IACrC,gFAAgF;IAChF,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;;;;OAIG;IACH,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,YAAY,EACtB,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,GACjC,sBAAsB,CAmExB"}