@cleocode/core 2026.3.42 → 2026.3.43

package/dist/issue/create.d.ts

@@ -0,0 +1,43 @@
+/**
+ * GitHub issue creation logic.
+ *
+ * Extracted from CLI issue command to core for shared use
+ * by both CLI and dispatch layer.
+ *
+ * @task T4555
+ * @epic T4820
+ */
+/**
+ * Build structured issue body with template sections.
+ */
+export declare function buildIssueBody(subcommand: string, rawBody: string, severity?: string, area?: string): string;
+/**
+ * Check that gh CLI is installed and authenticated.
+ */
+export declare function checkGhCli(): void;
+export interface AddIssueParams {
+    issueType: string;
+    title: string;
+    body: string;
+    severity?: string;
+    area?: string;
+    dryRun?: boolean;
+}
+export interface AddIssueResult {
+    type: string;
+    url?: string;
+    number?: number | string;
+    title: string;
+    labels: string[];
+    body: string;
+    repo: string;
+    dryRun: boolean;
+}
+/**
+ * Add a GitHub issue for a given type (bug, feature, help).
+ * Returns structured result. Does not handle CLI output or process.exit.
+ *
+ * Note: Named 'add' per VERB-STANDARDS.md (canonical verb for "Create new entity")
+ */
+export declare function addIssue(params: AddIssueParams): AddIssueResult;
+//# sourceMappingURL=create.d.ts.map

package/dist/issue/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/issue/create.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH;;GAEG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,MAAM,GACZ,MAAM,CAoBR;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAsBjC;AA2BD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAqC/D"}

package/dist/issue/diagnostics.d.ts

@@ -0,0 +1,18 @@
+/**
+ * System diagnostics collection for issue reports.
+ *
+ * Extracted from CLI issue command to core for shared use
+ * by both CLI and dispatch layer.
+ *
+ * @task T4555
+ * @epic T4820
+ */
+/**
+ * Collect system diagnostics for bug reports.
+ */
+export declare function collectDiagnostics(): Record<string, string>;
+/**
+ * Format diagnostics as markdown table.
+ */
+export declare function formatDiagnosticsTable(diag: Record<string, string>): string;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/issue/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/issue/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA0B3D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAa3E"}

package/dist/issue/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Issue module - GitHub issue template parsing, diagnostics, and creation.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+export type { AddIssueParams, AddIssueResult } from './create.js';
+export { addIssue, buildIssueBody, checkGhCli, } from './create.js';
+export { collectDiagnostics, formatDiagnosticsTable, } from './diagnostics.js';
+export type { IssueTemplate } from './template-parser.js';
+export { cacheTemplates, getTemplateConfig, getTemplateForSubcommand, parseIssueTemplates, validateLabelsExist, } from './template-parser.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/issue/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/issue/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EACL,QAAQ,EACR,cAAc,EACd,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC"}

package/dist/issue/template-parser.d.ts

@@ -0,0 +1,48 @@
+/**
+ * GitHub Issue Template Parser.
+ *
+ * Parses .github/ISSUE_TEMPLATE/*.yml files into JSON config.
+ * Supports three resolution strategies:
+ *   1. Live parse from YAML templates (if in a repo with templates)
+ *   2. Cached config from .cleo/issue-templates.json
+ *   3. Hardcoded fallback defaults
+ *
+ * @task T4454
+ * @epic T4454
+ */
+/** Parsed issue template. */
+export interface IssueTemplate {
+    name: string;
+    description: string;
+    title: string;
+    labels: string[];
+    subcommand: string;
+    fileName: string;
+}
+/**
+ * Parse all issue templates from available sources.
+ * Priority:
+ *   1. Packaged templates in the CLEO installation (for npm-installed users)
+ *   2. Project's .github/ISSUE_TEMPLATE/ (for contributors working on CLEO)
+ */
+export declare function parseIssueTemplates(projectDir?: string): IssueTemplate[];
+/**
+ * Get template configuration - tries live parse, cache, then fallback.
+ */
+export declare function getTemplateConfig(cwd?: string): IssueTemplate[];
+/**
+ * Get the template for a specific subcommand (bug, feature, etc.).
+ */
+export declare function getTemplateForSubcommand(subcommand: string, cwd?: string): IssueTemplate | null;
+/**
+ * Cache parsed templates to .cleo/issue-templates.json.
+ */
+export declare function cacheTemplates(templates: IssueTemplate[], cwd?: string): void;
+/**
+ * Validate that required labels exist (informational).
+ */
+export declare function validateLabelsExist(_templates: IssueTemplate[]): {
+    valid: boolean;
+    missingLabels: string[];
+};
+//# sourceMappingURL=template-parser.d.ts.map

package/dist/issue/template-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-parser.d.ts","sourceRoot":"","sources":["../../src/issue/template-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAmBH,6BAA6B;AAC7B,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAuGD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE,CAkCxE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE,CAmB/D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAG/F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,aAAa,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAQ7E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG;IAChE,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB,CAGA"}

package/dist/json-schema-validator.d.ts

@@ -0,0 +1,20 @@
+/**
+ * JSON Schema validation engine using ajv.
+ * @epic T4454
+ * @task T4458
+ */
+/**
+ * Validate data against a JSON Schema object.
+ * Throws CleoError on validation failure.
+ */
+export declare function validateAgainstSchema(data: unknown, schema: Record<string, unknown>, schemaId?: string): void;
+/**
+ * Load a JSON Schema file and validate data against it.
+ */
+export declare function validateAgainstSchemaFile(data: unknown, schemaPath: string): Promise<void>;
+/**
+ * Check if data is valid against a schema without throwing.
+ * Returns an array of error messages (empty if valid).
+ */
+export declare function checkSchema(data: unknown, schema: Record<string, unknown>): string[];
+//# sourceMappingURL=json-schema-validator.d.ts.map

package/dist/json-schema-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-validator.d.ts","sourceRoot":"","sources":["../src/json-schema-validator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqCH;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI,CAsBN;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMhG;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAUpF"}

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

@@ -0,0 +1,30 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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-store.d.ts

@@ -0,0 +1,70 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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"}

package/dist/lifecycle/consolidate-rcasd.d.ts

@@ -0,0 +1,81 @@
+/**
+ * One-time migration to consolidate provenance files into the unified
+ * `.cleo/rcasd/{epicId}/` structure with stage subdirectories.
+ *
+ * Migrates files from:
+ *   - `.cleo/consensus/` → `rcasd/{epicId}/consensus/`
+ *   - `.cleo/contributions/` → `rcasd/{epicId}/contributions/`
+ *   - `.cleo/rcasd/T####_*.md` (loose) → `rcasd/{epicId}/research/`
+ *   - Suffixed dirs like `T4881_install-channels` → `T4881`
+ *
+ * @task T5200
+ * @epic T4798
+ */
+interface MoveRecord {
+    from: string;
+    to: string;
+    type: 'move' | 'rename';
+    status: 'success' | 'skipped' | 'error';
+    reason?: string;
+}
+interface MigrationResult {
+    moves: MoveRecord[];
+    totalMoved: number;
+    totalSkipped: number;
+    totalErrors: number;
+    dryRun: boolean;
+}
+interface ConsolidateOptions {
+    dryRun?: boolean;
+    cwd?: string;
+}
+/**
+ * Extract an epic/task ID from file content by searching for:
+ *   1. `@task T####` or `@epic T####` annotations (highest priority)
+ *   2. JSON `"task"`, `"epicId"`, or `"taskId"` fields
+ *   3. First `T####` at a word boundary (fallback)
+ */
+export declare function resolveEpicFromContent(content: string): string | null;
+/**
+ * Extract an epic ID from a filename pattern like `T####-*` or `T####_*`.
+ */
+export declare function resolveEpicFromFilename(filename: string): string | null;
+/**
+ * Rename suffixed epic directories (e.g. `T4881_install-channels` → `T4881`).
+ */
+export declare function normalizeDirectoryNames(options?: ConsolidateOptions): MoveRecord[];
+/**
+ * Migrate `.cleo/consensus/` files to appropriate epic's consensus/ subdirectory.
+ *
+ * - T4869-checkpoint-consensus.json → rcasd/T4869/consensus/
+ * - Agent finding files and CONSENSUS-REPORT.md → resolve epic from content
+ * - phase1-best-practices-evidence.md → resolve epic from content → research/
+ */
+export declare function migrateConsensusFiles(options?: ConsolidateOptions): MoveRecord[];
+/**
+ * Migrate `.cleo/contributions/` files to appropriate epic's contributions/ subdirectory.
+ *
+ * Files follow the pattern `T####-session-*.json` with epicId in content.
+ */
+export declare function migrateContributionFiles(options?: ConsolidateOptions): MoveRecord[];
+/**
+ * Migrate loose `T####_*.md` files from `.cleo/rcasd/` root into
+ * `rcasd/{epicId}/research/` subdirectories.
+ */
+export declare function migrateLooseFiles(options?: ConsolidateOptions): MoveRecord[];
+/**
+ * Consolidate all provenance files into the unified `.cleo/rcasd/{epicId}/`
+ * structure with stage subdirectories.
+ *
+ * Performs migrations in order:
+ *   1. Rename suffixed directories (T4881_install-channels → T4881)
+ *   2. Move consensus files to appropriate epic's consensus/ subdirectory
+ *   3. Move contribution files to appropriate epic's contributions/ subdirectory
+ *   4. Move loose research files to appropriate epic's research/ subdirectory
+ *
+ * @param options.dryRun - If true, log planned moves without executing them
+ * @param options.cwd - Optional working directory override
+ */
+export declare function consolidateRcasd(options?: ConsolidateOptions): MigrationResult;
+export {};
+//# sourceMappingURL=consolidate-rcasd.d.ts.map

package/dist/lifecycle/consolidate-rcasd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consolidate-rcasd.d.ts","sourceRoot":"","sources":["../../src/lifecycle/consolidate-rcasd.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA2BH,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACxB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,eAAe;IACvB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,UAAU,kBAAkB;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAuID;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAerE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGvE;AAMD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,kBAAuB,GAAG,UAAU,EAAE,CAatF;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,kBAAuB,GAAG,UAAU,EAAE,CA6DpF;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,kBAAuB,GAAG,UAAU,EAAE,CAwDvF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,UAAU,EAAE,CAehF;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,kBAAuB,GAAG,eAAe,CAwBlF"}

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

@@ -0,0 +1,33 @@
+/**
+ * Default RCASD-IVTR+C WarpChain Builder
+ *
+ * Constructs the canonical 9-stage pipeline chain from existing
+ * stage definitions, prerequisites, and verification gates.
+ *
+ * @task T5399
+ */
+import type { WarpChain } from '@cleocode/contracts';
+import type { ProtocolType } from '../orchestration/protocol-validators.js';
+import type { Stage } from './stages.js';
+export declare const DEFAULT_CHAIN_ID = "rcasd-ivtrc";
+/**
+ * Stage mapping for protocol validation gates in the default chain.
+ *
+ * `contribution` is cross-cutting and is validated at implementation.
+ * `artifact-publish` and `provenance` are validated at release.
+ *
+ * @task T5419
+ */
+export declare const DEFAULT_PROTOCOL_STAGE_MAP: Record<ProtocolType, Stage>;
+/**
+ * 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 declare function buildDefaultChain(): WarpChain;
+//# sourceMappingURL=default-chain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"default-chain.d.ts","sourceRoot":"","sources":["../../src/lifecycle/default-chain.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAgB,SAAS,EAAuB,MAAM,qBAAqB,CAAC;AACxF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAI5E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGzC,eAAO,MAAM,gBAAgB,gBAAgB,CAAC;AAE9C;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,YAAY,EAAE,KAAK,CAUlE,CAAC;AA+CF;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,IAAI,SAAS,CAyF7C"}

package/dist/lifecycle/evidence.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Evidence recording for RCASD lifecycle stages.
+ *
+ * Records provenance evidence (files, URLs, manifests) linked to
+ * lifecycle stages in SQLite.
+ *
+ * @task T5200
+ * @epic T4798
+ */
+export type EvidenceType = 'file' | 'url' | 'manifest';
+export interface EvidenceRecord {
+    id: string;
+    stageId: string;
+    uri: string;
+    type: EvidenceType;
+    recordedAt: string;
+    recordedBy?: string;
+    description?: string;
+}
+/**
+ * Record an evidence artifact linked to a lifecycle stage.
+ *
+ * Writes to the SQLite `lifecycle_evidence` table.
+ *
+ * @param epicId - Epic task ID (e.g. 'T4881')
+ * @param stage - Canonical stage name (e.g. 'research')
+ * @param uri - URI of the evidence artifact
+ * @param type - Evidence type: 'file', 'url', or 'manifest'
+ * @param options - Optional agent and description
+ * @returns The created evidence record
+ */
+export declare function recordEvidence(epicId: string, stage: string, uri: string, type: EvidenceType, options?: {
+    agent?: string;
+    description?: string;
+    cwd?: string;
+}): Promise<EvidenceRecord>;
+/**
+ * Query evidence records for an epic, optionally filtered by stage.
+ *
+ * @param epicId - Epic task ID
+ * @param stage - Optional stage name filter
+ * @param cwd - Optional working directory
+ * @returns Array of evidence records
+ */
+export declare function getEvidence(epicId: string, stage?: string, cwd?: string): Promise<EvidenceRecord[]>;
+/**
+ * Convenience wrapper to record a file as provenance evidence.
+ *
+ * Converts the file path to a URI relative to the `.cleo/` directory,
+ * sets the type to 'file', and extracts a description from the filename.
+ *
+ * @param epicId - Epic task ID
+ * @param stage - Canonical stage name
+ * @param filePath - Absolute or relative path to the file
+ * @param cwd - Optional working directory
+ * @returns The created evidence record
+ */
+export declare function linkProvenance(epicId: string, stage: string, filePath: string, cwd?: string): Promise<EvidenceRecord>;
+/**
+ * Aggregate evidence counts per stage for an epic.
+ *
+ * @param epicId - Epic task ID
+ * @param cwd - Optional working directory
+ * @returns Array of per-stage summaries with type breakdowns
+ */
+export declare function getEvidenceSummary(epicId: string, cwd?: string): Promise<{
+    stage: string;
+    count: number;
+    types: Record<EvidenceType, number>;
+}[]>;
+//# sourceMappingURL=evidence.d.ts.map

package/dist/lifecycle/evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.d.ts","sourceRoot":"","sources":["../../src/lifecycle/evidence.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,CAAC;AAEvD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,YAAY,EAClB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/D,OAAO,CAAC,cAAc,CAAC,CAoCzB;AAMD;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,EAAE,CAAC,CAsC3B;AAMD;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,CAAC,CASzB;AAMD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAA;CAAE,EAAE,CAAC,CAmClF"}

package/dist/lifecycle/frontmatter.d.ts

@@ -0,0 +1,104 @@
+/**
+ * YAML frontmatter parser/writer for RCASD provenance files.
+ *
+ * Provides Obsidian-like backlinks via YAML frontmatter blocks
+ * (delimited by `---`). No YAML library dependency — uses
+ * simple key-value parsing for the supported fields.
+ *
+ * @task T5200
+ * @epic T4798
+ */
+/** Related link in frontmatter. */
+export interface RelatedLink {
+    type: 'consensus' | 'adr' | 'task' | 'research' | 'spec' | 'contribution' | 'file';
+    path?: string;
+    id?: string;
+}
+/** Frontmatter metadata for an RCASD artifact. */
+export interface FrontmatterMetadata {
+    epic: string;
+    stage: string;
+    task?: string;
+    related?: RelatedLink[];
+    created?: string;
+    updated?: string;
+    [key: string]: unknown;
+}
+/** Result of parsing frontmatter from a markdown file. */
+export interface ParsedFrontmatter {
+    frontmatter: FrontmatterMetadata | null;
+    body: string;
+    raw: string;
+}
+/**
+ * Parse YAML frontmatter from a markdown string.
+ *
+ * Finds the YAML block delimited by `---` at the start of the file,
+ * parses key-value pairs, and returns the structured metadata plus
+ * the remaining body content.
+ *
+ * @param content - Full markdown file content
+ * @returns Parsed frontmatter, body, and raw YAML block
+ */
+export declare function parseFrontmatter(content: string): ParsedFrontmatter;
+/**
+ * Convert a FrontmatterMetadata object to a YAML frontmatter string.
+ *
+ * Output format:
+ * ```
+ * ---
+ * epic: T4881
+ * stage: research
+ * related:
+ *   - type: consensus
+ *     path: ../consensus/consensus-report.md
+ * created: 2026-02-15
+ * ---
+ * ```
+ *
+ * @param metadata - The frontmatter metadata to serialize
+ * @returns YAML frontmatter string including `---` delimiters
+ */
+export declare function serializeFrontmatter(metadata: FrontmatterMetadata): string;
+/**
+ * Add or replace YAML frontmatter in markdown content.
+ *
+ * If the content already has a frontmatter block, it is replaced.
+ * Otherwise the YAML block is prepended.
+ *
+ * @param content - Original markdown content
+ * @param metadata - Frontmatter metadata to set
+ * @returns Updated content with new frontmatter
+ */
+export declare function addFrontmatter(content: string, metadata: FrontmatterMetadata): string;
+/**
+ * Convenience builder for common frontmatter patterns.
+ *
+ * Auto-sets `updated` to the current ISO date string.
+ *
+ * @param epicId - Epic identifier (e.g. `T4881`)
+ * @param stage - RCASD stage name (e.g. `research`)
+ * @param options - Optional fields: task, related links, created date
+ * @returns A FrontmatterMetadata object ready for serialization
+ */
+export declare function buildFrontmatter(epicId: string, stage: string, options?: {
+    task?: string;
+    related?: RelatedLink[];
+    created?: string;
+}): FrontmatterMetadata;
+/**
+ * Scan all markdown files in `.cleo/rcasd/` for files that reference
+ * the given epic+stage combination via their `related` frontmatter links.
+ *
+ * This enables "what links here?" queries (Obsidian-style backlinks).
+ *
+ * @param epicId - Epic identifier to search for
+ * @param stage - Stage name to search for
+ * @param cwd - Optional working directory override
+ * @returns Array of files with matching related links
+ */
+export declare function getBacklinks(epicId: string, stage: string, cwd?: string): Array<{
+    file: string;
+    link: RelatedLink;
+}>;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/lifecycle/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/lifecycle/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAUH,mCAAmC;AACnC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,cAAc,GAAG,MAAM,CAAC;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,kDAAkD;AAClD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AA2HD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAoBnE;AAqBD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,CAuE1E;AAMD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,MAAM,CAWrF;AAMD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IACR,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,mBAAmB,CAoBrB;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,GAAG,CAAC,EAAE,MAAM,GACX,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC,CAU5C"}