@cleocode/core 2.0.0

package/dist/adrs/find.js

@@ -0,0 +1,134 @@
+/**
+ * ADR Cognitive Search (T4942)
+ *
+ * In-memory fuzzy search across ADR title, summary, keywords, and topics.
+ * Chosen over SQLite FTS5 because the ADR set is small (<50) and in-memory
+ * search avoids the complexity of FTS5 virtual table DDL and drizzle integration.
+ *
+ * Scoring (higher = better match):
+ *   40 — keyword tag exact match
+ *   30 — topics tag exact match
+ *   20 — title contains query term
+ *   10 — summary contains query term
+ *    5 — id contains query term
+ *
+ * @task T4942
+ * @see ADR-017 §5.4 for cognitive search spec
+ */
+import { existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { parseAdrFile } from './parse.js';
+/** Normalise a string for comparison: lowercase, strip punctuation */
+function normalise(s) {
+    return s
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+/** Split a comma-separated tag string into normalised tokens */
+function parseTags(raw) {
+    if (!raw)
+        return [];
+    return raw
+        .split(',')
+        .map((t) => normalise(t))
+        .filter(Boolean);
+}
+/** Return true if any query term is found in the target string */
+function containsAny(target, terms) {
+    const t = normalise(target);
+    return terms.some((term) => t.includes(term));
+}
+/** Return matched query terms found in the target */
+function matchedTerms(target, terms) {
+    const t = normalise(target);
+    return terms.filter((term) => t.includes(term));
+}
+export async function findAdrs(projectRoot, query, opts) {
+    const adrsDir = join(projectRoot, '.cleo', 'adrs');
+    if (!existsSync(adrsDir)) {
+        return { adrs: [], query, total: 0 };
+    }
+    const files = readdirSync(adrsDir)
+        .filter((f) => f.endsWith('.md') && f.startsWith('ADR-'))
+        .sort();
+    const queryTerms = normalise(query)
+        .split(' ')
+        .filter((t) => t.length > 1);
+    const filterTopics = opts?.topics ? parseTags(opts.topics) : null;
+    const filterKeywords = opts?.keywords ? parseTags(opts.keywords) : null;
+    const results = [];
+    for (const file of files) {
+        const record = parseAdrFile(join(adrsDir, file), projectRoot);
+        const fm = record.frontmatter;
+        // Status filter
+        if (opts?.status && fm.Status !== opts.status)
+            continue;
+        // Topics filter (hard filter — must match all specified topics)
+        if (filterTopics && filterTopics.length > 0) {
+            const adrTopics = parseTags(fm.Topics);
+            if (!filterTopics.every((t) => adrTopics.includes(t)))
+                continue;
+        }
+        // Keywords filter (hard filter — must match all specified keywords)
+        if (filterKeywords && filterKeywords.length > 0) {
+            const adrKeywords = parseTags(fm.Keywords);
+            if (!filterKeywords.every((k) => adrKeywords.includes(k)))
+                continue;
+        }
+        // Scoring
+        let score = 0;
+        const matchedFields = [];
+        if (queryTerms.length > 0) {
+            // Keywords exact match (highest signal)
+            const adrKeywords = parseTags(fm.Keywords);
+            const kwMatches = queryTerms.filter((term) => adrKeywords.some((kw) => kw.includes(term)));
+            if (kwMatches.length > 0) {
+                score += 40 * kwMatches.length;
+                matchedFields.push('keywords');
+            }
+            // Topics match
+            const adrTopics = parseTags(fm.Topics);
+            const topicMatches = queryTerms.filter((term) => adrTopics.some((tp) => tp.includes(term)));
+            if (topicMatches.length > 0) {
+                score += 30 * topicMatches.length;
+                matchedFields.push('topics');
+            }
+            // Title contains
+            if (containsAny(record.title, queryTerms)) {
+                score += 20 * matchedTerms(record.title, queryTerms).length;
+                matchedFields.push('title');
+            }
+            // Summary contains
+            if (fm.Summary && containsAny(fm.Summary, queryTerms)) {
+                score += 10 * matchedTerms(fm.Summary, queryTerms).length;
+                matchedFields.push('summary');
+            }
+            // ID contains (e.g. "ADR-017")
+            if (containsAny(record.id, queryTerms)) {
+                score += 5;
+                matchedFields.push('id');
+            }
+            // Skip if no match and a query was provided
+            if (score === 0)
+                continue;
+        }
+        results.push({
+            id: record.id,
+            title: record.title,
+            status: fm.Status,
+            date: fm.Date,
+            filePath: record.file,
+            summary: fm.Summary,
+            keywords: fm.Keywords,
+            topics: fm.Topics,
+            score,
+            matchedFields: [...new Set(matchedFields)],
+        });
+    }
+    // Sort by score descending, then by ADR ID ascending for ties
+    results.sort((a, b) => b.score - a.score || a.id.localeCompare(b.id));
+    return { adrs: results, query, total: results.length };
+}
+//# sourceMappingURL=find.js.map

package/dist/adrs/find.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.js","sourceRoot":"","sources":["../../src/adrs/find.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,sEAAsE;AACtE,SAAS,SAAS,CAAC,CAAS;IAC1B,OAAO,CAAC;SACL,WAAW,EAAE;SACb,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,gEAAgE;AAChE,SAAS,SAAS,CAAC,GAAuB;IACxC,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,OAAO,GAAG;SACP,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;SACxB,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED,kEAAkE;AAClE,SAAS,WAAW,CAAC,MAAc,EAAE,KAAe;IAClD,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAC5B,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,qDAAqD;AACrD,SAAS,YAAY,CAAC,MAAc,EAAE,KAAe;IACnD,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAC5B,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,WAAmB,EACnB,KAAa,EACb,IAA8D;IAE9D,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAEnD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACvC,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC;SAC/B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;SACxD,IAAI,EAAE,CAAC;IAEV,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC;SAChC,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC/B,MAAM,YAAY,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClE,MAAM,cAAc,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAExE,MAAM,OAAO,GAA0B,EAAE,CAAC;IAE1C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC;QAC9D,MAAM,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC;QAE9B,gBAAgB;QAChB,IAAI,IAAI,EAAE,MAAM,IAAI,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;YAAE,SAAS;QAExD,gEAAgE;QAChE,IAAI,YAAY,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,MAAM,SAAS,GAAG,SAAS,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;YACvC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;gBAAE,SAAS;QAClE,CAAC;QAED,oEAAoE;QACpE,IAAI,cAAc,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,MAAM,WAAW,GAAG,SAAS,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;YAC3C,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;gBAAE,SAAS;QACtE,CAAC;QAED,UAAU;QACV,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,MAAM,aAAa,GAAa,EAAE,CAAC;QAEnC,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,wCAAwC;YACxC,MAAM,WAAW,GAAG,SAAS,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;YAC3C,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC3F,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,KAAK,IAAI,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC;gBAC/B,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACjC,CAAC;YAED,eAAe;YACf,MAAM,SAAS,GAAG,SAAS,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;YACvC,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC5F,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5B,KAAK,IAAI,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC;gBAClC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC/B,CAAC;YAED,iBAAiB;YACjB,IAAI,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,CAAC;gBAC1C,KAAK,IAAI,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,MAAM,CAAC;gBAC5D,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC9B,CAAC;YAED,mBAAmB;YACnB,IAAI,EAAE,CAAC,OAAO,IAAI,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC;gBACtD,KAAK,IAAI,EAAE,GAAG,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,MAAM,CAAC;gBAC1D,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAChC,CAAC;YAED,+BAA+B;YAC/B,IAAI,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,CAAC;gBACvC,KAAK,IAAI,CAAC,CAAC;gBACX,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC;YAED,4CAA4C;YAC5C,IAAI,KAAK,KAAK,CAAC;gBAAE,SAAS;QAC5B,CAAC;QAED,OAAO,CAAC,IAAI,CAAC;YACX,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,EAAE,CAAC,MAAM;YACjB,IAAI,EAAE,EAAE,CAAC,IAAI;YACb,QAAQ,EAAE,MAAM,CAAC,IAAI;YACrB,OAAO,EAAE,EAAE,CAAC,OAAO;YACnB,QAAQ,EAAE,EAAE,CAAC,QAAQ;YACrB,MAAM,EAAE,EAAE,CAAC,MAAM;YACjB,KAAK;YACL,aAAa,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC;SAC3C,CAAC,CAAC;IACL,CAAC;IAED,8DAA8D;IAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEtE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;AACzD,CAAC"}

package/dist/adrs/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * ADR Core Module (ADR-017)
+ *
+ * Barrel export for ADR operations.
+ *
+ * @task T4792
+ */
+export { findAdrs } from './find.js';
+export type { PipelineAdrLinkResult } from './link-pipeline.js';
+export { linkPipelineAdr } from './link-pipeline.js';
+export { listAdrs } from './list.js';
+export { extractAdrId, extractTitle, parseAdrFile, parseFrontmatter } from './parse.js';
+export { showAdr } from './show.js';
+export { syncAdrsToDb } from './sync.js';
+export type { AdrFindResult, AdrFrontmatter, AdrListResult, AdrRecord, AdrSyncResult, } from './types.js';
+export type { AdrValidationError, AdrValidationResult } from './validate.js';
+export { validateAllAdrs } from './validate.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adrs/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EACV,aAAa,EACb,cAAc,EACd,aAAa,EACb,SAAS,EACT,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/adrs/index.js

@@ -0,0 +1,15 @@
+/**
+ * ADR Core Module (ADR-017)
+ *
+ * Barrel export for ADR operations.
+ *
+ * @task T4792
+ */
+export { findAdrs } from './find.js';
+export { linkPipelineAdr } from './link-pipeline.js';
+export { listAdrs } from './list.js';
+export { extractAdrId, extractTitle, parseAdrFile, parseFrontmatter } from './parse.js';
+export { showAdr } from './show.js';
+export { syncAdrsToDb } from './sync.js';
+export { validateAllAdrs } from './validate.js';
+//# sourceMappingURL=index.js.map

package/dist/adrs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adrs/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AASzC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/adrs/link-pipeline.d.ts

@@ -0,0 +1,35 @@
+/**
+ * RCASD Pipeline ADR Auto-linking (T4942, T4947)
+ *
+ * When an architecture_decision stage completes for a pipeline task, this
+ * module automatically:
+ *   1. Finds ADRs in .cleo/adrs/ that reference the task in Related Tasks
+ *   2. Upserts those ADRs into architecture_decisions DB
+ *   3. Creates adr_task_links with link_type='implements'
+ *   4. Links related ADRs via adr_relations if cross-references exist
+ *
+ * Called from lifecycle/pipeline.ts when advancing FROM architecture_decision.
+ *
+ * @task T4947
+ * @see ADR-017 §5.3 for adr_task_links and adr_relations schemas
+ */
+export interface PipelineAdrLinkResult {
+    linked: Array<{
+        adrId: string;
+        taskId: string;
+    }>;
+    synced: number;
+    skipped: number;
+    errors: Array<{
+        file: string;
+        error: string;
+    }>;
+}
+/**
+ * Link ADRs to a pipeline task when the architecture_decision stage completes.
+ *
+ * @param projectRoot - Absolute path to project root
+ * @param taskId      - Task ID that owns the pipeline (e.g., 'T4942')
+ */
+export declare function linkPipelineAdr(projectRoot: string, taskId: string): Promise<PipelineAdrLinkResult>;
+//# sourceMappingURL=link-pipeline.d.ts.map

package/dist/adrs/link-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-pipeline.d.ts","sourceRoot":"","sources":["../../src/adrs/link-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAqCD;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,qBAAqB,CAAC,CA4GhC"}

package/dist/adrs/link-pipeline.js

@@ -0,0 +1,160 @@
+/**
+ * RCASD Pipeline ADR Auto-linking (T4942, T4947)
+ *
+ * When an architecture_decision stage completes for a pipeline task, this
+ * module automatically:
+ *   1. Finds ADRs in .cleo/adrs/ that reference the task in Related Tasks
+ *   2. Upserts those ADRs into architecture_decisions DB
+ *   3. Creates adr_task_links with link_type='implements'
+ *   4. Links related ADRs via adr_relations if cross-references exist
+ *
+ * Called from lifecycle/pipeline.ts when advancing FROM architecture_decision.
+ *
+ * @task T4947
+ * @see ADR-017 §5.3 for adr_task_links and adr_relations schemas
+ */
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { adrRelations, adrTaskLinks, architectureDecisions } from '../store/tasks-schema.js';
+import { parseAdrFile } from './parse.js';
+/**
+ * Parse comma-separated task IDs from a Related Tasks value
+ */
+function parseTaskIds(raw) {
+    if (!raw)
+        return [];
+    return raw
+        .split(',')
+        .map((t) => t.trim())
+        .filter((t) => /^T\d{1,5}$/.test(t));
+}
+/**
+ * Scan .cleo/adrs/ for ADRs that reference the given taskId in Related Tasks.
+ * Returns file paths of matching ADRs.
+ */
+function findAdrsForTask(adrsDir, taskId) {
+    if (!existsSync(adrsDir))
+        return [];
+    return readdirSync(adrsDir)
+        .filter((f) => f.endsWith('.md') && /^ADR-\d+/.test(f))
+        .filter((file) => {
+        try {
+            const content = readFileSync(join(adrsDir, file), 'utf-8');
+            // Quick check before parsing — look for task ID in Related Tasks line
+            const relatedTasksMatch = content.match(/^\*\*Related Tasks\*\*:\s*(.+)$/m);
+            if (!relatedTasksMatch)
+                return false;
+            const taskIds = parseTaskIds(relatedTasksMatch[1]);
+            return taskIds.includes(taskId);
+        }
+        catch {
+            return false;
+        }
+    })
+        .map((f) => join(adrsDir, f));
+}
+/**
+ * Link ADRs to a pipeline task when the architecture_decision stage completes.
+ *
+ * @param projectRoot - Absolute path to project root
+ * @param taskId      - Task ID that owns the pipeline (e.g., 'T4942')
+ */
+export async function linkPipelineAdr(projectRoot, taskId) {
+    const result = {
+        linked: [],
+        synced: 0,
+        skipped: 0,
+        errors: [],
+    };
+    const adrsDir = join(projectRoot, '.cleo', 'adrs');
+    const matchingFiles = findAdrsForTask(adrsDir, taskId);
+    if (matchingFiles.length === 0) {
+        return result;
+    }
+    const { getDb } = await import('../store/sqlite.js');
+    const { and, eq } = await import('drizzle-orm');
+    const db = await getDb(projectRoot);
+    const now = new Date().toISOString();
+    for (const filePath of matchingFiles) {
+        const filename = filePath.split('/').pop();
+        try {
+            const record = parseAdrFile(filePath, projectRoot);
+            const fm = record.frontmatter;
+            const content = readFileSync(filePath, 'utf-8');
+            const relativePath = `.cleo/adrs/${filename}`;
+            // Upsert ADR row
+            const existing = await db
+                .select({ id: architectureDecisions.id })
+                .from(architectureDecisions)
+                .where(eq(architectureDecisions.id, record.id))
+                .all();
+            const rowBase = {
+                id: record.id,
+                title: record.title,
+                status: (fm.Status ?? 'proposed'),
+                content,
+                filePath: relativePath,
+                date: fm.Date ?? '',
+                acceptedAt: fm.Accepted ?? null,
+                gate: (fm.Gate ?? null),
+                gateStatus: (fm['Gate Status'] ?? null),
+                amendsId: null,
+                supersedesId: null,
+                supersededById: null,
+                summary: fm.Summary ?? null,
+                keywords: fm.Keywords ?? null,
+                topics: fm.Topics ?? null,
+                updatedAt: now,
+            };
+            if (existing.length > 0) {
+                await db
+                    .update(architectureDecisions)
+                    .set(rowBase)
+                    .where(eq(architectureDecisions.id, record.id));
+            }
+            else {
+                await db.insert(architectureDecisions).values({ ...rowBase, createdAt: now });
+            }
+            result.synced++;
+            // Create implements link (upsert: delete existing, insert new)
+            // First remove any existing link between this ADR and task
+            await db
+                .delete(adrTaskLinks)
+                .where(and(eq(adrTaskLinks.adrId, record.id), eq(adrTaskLinks.taskId, taskId)));
+            await db.insert(adrTaskLinks).values({ adrId: record.id, taskId, linkType: 'implements' });
+            result.linked.push({ adrId: record.id, taskId });
+            // Cross-reference: if ADR references other ADRs via Related ADRs, create adr_relations
+            if (fm['Related ADRs']) {
+                const relatedIds = fm['Related ADRs']
+                    .split(',')
+                    .map((r) => r.trim())
+                    .filter((r) => /^ADR-\d+$/.test(r));
+                for (const toId of relatedIds) {
+                    try {
+                        // Only create relation if target ADR exists in DB
+                        const targetExists = await db
+                            .select({ id: architectureDecisions.id })
+                            .from(architectureDecisions)
+                            .where(eq(architectureDecisions.id, toId))
+                            .all();
+                        if (targetExists.length > 0) {
+                            await db
+                                .insert(adrRelations)
+                                .values({ fromAdrId: record.id, toAdrId: toId, relationType: 'related' })
+                                .onConflictDoNothing();
+                        }
+                    }
+                    catch {
+                        // Ignore relation errors — non-fatal
+                    }
+                }
+            }
+        }
+        catch (err) {
+            result.errors.push({ file: filename, error: String(err) });
+            result.skipped++;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=link-pipeline.js.map

package/dist/adrs/link-pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-pipeline.js","sourceRoot":"","sources":["../../src/adrs/link-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAC7F,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAS1C;;GAEG;AACH,SAAS,YAAY,CAAC,GAAuB;IAC3C,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,OAAO,GAAG;SACP,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,OAAe,EAAE,MAAc;IACtD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,OAAO,WAAW,CAAC,OAAO,CAAC;SACxB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;SACtD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;YAC3D,sEAAsE;YACtE,MAAM,iBAAiB,GAAG,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;YAC5E,IAAI,CAAC,iBAAiB;gBAAE,OAAO,KAAK,CAAC;YACrC,MAAM,OAAO,GAAG,YAAY,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;YACnD,OAAO,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,WAAmB,EACnB,MAAc;IAEd,MAAM,MAAM,GAA0B;QACpC,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,CAAC;QACT,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,EAAE;KACX,CAAC;IAEF,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACnD,MAAM,aAAa,GAAG,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAEvD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;IACrD,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IAChD,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErC,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAG,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;YACnD,MAAM,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC;YAC9B,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAChD,MAAM,YAAY,GAAG,cAAc,QAAQ,EAAE,CAAC;YAE9C,iBAAiB;YACjB,MAAM,QAAQ,GAAG,MAAM,EAAE;iBACtB,MAAM,CAAC,EAAE,EAAE,EAAE,qBAAqB,CAAC,EAAE,EAAE,CAAC;iBACxC,IAAI,CAAC,qBAAqB,CAAC;iBAC3B,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;iBAC9C,GAAG,EAAE,CAAC;YAET,MAAM,OAAO,GAAG;gBACd,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,MAAM,EAAE,CAAC,EAAE,CAAC,MAAM,IAAI,UAAU,CAA0D;gBAC1F,OAAO;gBACP,QAAQ,EAAE,YAAY;gBACtB,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,EAAE;gBACnB,UAAU,EAAE,EAAE,CAAC,QAAQ,IAAI,IAAI;gBAC/B,IAAI,EAAE,CAAC,EAAE,CAAC,IAAI,IAAI,IAAI,CAAgC;gBACtD,UAAU,EAAE,CAAC,EAAE,CAAC,aAAa,CAAC,IAAI,IAAI,CAA2C;gBACjF,QAAQ,EAAE,IAAqB;gBAC/B,YAAY,EAAE,IAAqB;gBACnC,cAAc,EAAE,IAAqB;gBACrC,OAAO,EAAE,EAAE,CAAC,OAAO,IAAI,IAAI;gBAC3B,QAAQ,EAAE,EAAE,CAAC,QAAQ,IAAI,IAAI;gBAC7B,MAAM,EAAE,EAAE,CAAC,MAAM,IAAI,IAAI;gBACzB,SAAS,EAAE,GAAG;aACf,CAAC;YAEF,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,MAAM,EAAE;qBACL,MAAM,CAAC,qBAAqB,CAAC;qBAC7B,GAAG,CAAC,OAAO,CAAC;qBACZ,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;YACpD,CAAC;iBAAM,CAAC;gBACN,MAAM,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;YAChF,CAAC;YACD,MAAM,CAAC,MAAM,EAAE,CAAC;YAEhB,+DAA+D;YAC/D,2DAA2D;YAC3D,MAAM,EAAE;iBACL,MAAM,CAAC,YAAY,CAAC;iBACpB,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;YAElF,MAAM,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;YAE3F,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAEjD,uFAAuF;YACvF,IAAI,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC;gBACvB,MAAM,UAAU,GAAG,EAAE,CAAC,cAAc,CAAC;qBAClC,KAAK,CAAC,GAAG,CAAC;qBACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;qBACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;gBAEtC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;oBAC9B,IAAI,CAAC;wBACH,kDAAkD;wBAClD,MAAM,YAAY,GAAG,MAAM,EAAE;6BAC1B,MAAM,CAAC,EAAE,EAAE,EAAE,qBAAqB,CAAC,EAAE,EAAE,CAAC;6BACxC,IAAI,CAAC,qBAAqB,CAAC;6BAC3B,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;6BACzC,GAAG,EAAE,CAAC;wBAET,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BAC5B,MAAM,EAAE;iCACL,MAAM,CAAC,YAAY,CAAC;iCACpB,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;iCACxE,mBAAmB,EAAE,CAAC;wBAC3B,CAAC;oBACH,CAAC;oBAAC,MAAM,CAAC;wBACP,qCAAqC;oBACvC,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC3D,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/adrs/list.d.ts

@@ -0,0 +1,16 @@
+/**
+ * ADR List Operation (ADR-017)
+ *
+ * Lists ADR records from .cleo/adrs/ with optional filtering.
+ *
+ * @task T4792
+ */
+import type { AdrListResult } from './types.js';
+/** List ADRs from .cleo/adrs/ directory with optional status filter */
+export declare function listAdrs(projectRoot: string, opts?: {
+    status?: string;
+    since?: string;
+    limit?: number;
+    offset?: number;
+}): Promise<AdrListResult>;
+//# sourceMappingURL=list.d.ts.map

package/dist/adrs/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/adrs/list.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,uEAAuE;AACvE,wBAAsB,QAAQ,CAC5B,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1E,OAAO,CAAC,aAAa,CAAC,CAgCxB"}

package/dist/adrs/list.js

@@ -0,0 +1,43 @@
+/**
+ * ADR List Operation (ADR-017)
+ *
+ * Lists ADR records from .cleo/adrs/ with optional filtering.
+ *
+ * @task T4792
+ */
+import { existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { paginate } from '../pagination.js';
+import { parseAdrFile } from './parse.js';
+/** List ADRs from .cleo/adrs/ directory with optional status filter */
+export async function listAdrs(projectRoot, opts) {
+    const adrsDir = join(projectRoot, '.cleo', 'adrs');
+    if (!existsSync(adrsDir)) {
+        return { adrs: [], total: 0, filtered: 0 };
+    }
+    const files = readdirSync(adrsDir)
+        .filter((f) => f.endsWith('.md') && f.startsWith('ADR-'))
+        .sort();
+    const records = files.map((f) => parseAdrFile(join(adrsDir, f), projectRoot));
+    const total = records.length;
+    const filtered = records.filter((r) => {
+        if (opts?.status && r.frontmatter.Status !== opts.status)
+            return false;
+        if (opts?.since && r.frontmatter.Date < opts.since)
+            return false;
+        return true;
+    });
+    const page = paginate(filtered, opts?.limit, opts?.offset);
+    return {
+        adrs: page.items.map((r) => ({
+            id: r.id,
+            title: r.title,
+            status: r.frontmatter.Status,
+            date: r.frontmatter.Date,
+            filePath: r.file,
+        })),
+        total,
+        filtered: filtered.length,
+    };
+}
+//# sourceMappingURL=list.js.map

package/dist/adrs/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/adrs/list.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,uEAAuE;AACvE,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,WAAmB,EACnB,IAA2E;IAE3E,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAEnD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAC7C,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC;SAC/B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;SACxD,IAAI,EAAE,CAAC;IAEV,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;IAE9E,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAC7B,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACpC,IAAI,IAAI,EAAE,MAAM,IAAI,CAAC,CAAC,WAAW,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QACvE,IAAI,IAAI,EAAE,KAAK,IAAI,CAAC,CAAC,WAAW,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACjE,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAE3D,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3B,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM;YAC5B,IAAI,EAAE,CAAC,CAAC,WAAW,CAAC,IAAI;YACxB,QAAQ,EAAE,CAAC,CAAC,IAAI;SACjB,CAAC,CAAC;QACH,KAAK;QACL,QAAQ,EAAE,QAAQ,CAAC,MAAM;KAC1B,CAAC;AACJ,CAAC"}

package/dist/adrs/parse.d.ts

@@ -0,0 +1,18 @@
+/**
+ * ADR Frontmatter Parser (ADR-017)
+ *
+ * Parses bold-key frontmatter from ADR markdown files.
+ * Pattern: **Key**: value
+ *
+ * @task T4792
+ */
+import type { AdrFrontmatter, AdrRecord } from './types.js';
+/** Extract ADR ID from filename (e.g., 'ADR-007-domain-consolidation.md' -> 'ADR-007') */
+export declare function extractAdrId(filename: string): string;
+/** Parse bold-key frontmatter pattern: **Key**: value */
+export declare function parseFrontmatter(content: string): AdrFrontmatter;
+/** Extract H1 title from markdown */
+export declare function extractTitle(content: string): string;
+/** Parse a single ADR markdown file into an AdrRecord */
+export declare function parseAdrFile(filePath: string, projectRoot: string): AdrRecord;
+//# sourceMappingURL=parse.d.ts.map

package/dist/adrs/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/adrs/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5D,0FAA0F;AAC1F,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAiBhE;AAED,qCAAqC;AACrC,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED,yDAAyD;AACzD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,CAW7E"}

package/dist/adrs/parse.js

@@ -0,0 +1,51 @@
+/**
+ * ADR Frontmatter Parser (ADR-017)
+ *
+ * Parses bold-key frontmatter from ADR markdown files.
+ * Pattern: **Key**: value
+ *
+ * @task T4792
+ */
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+/** Extract ADR ID from filename (e.g., 'ADR-007-domain-consolidation.md' -> 'ADR-007') */
+export function extractAdrId(filename) {
+    const match = filename.match(/^(ADR-\d+)/);
+    return match ? match[1] : filename.replace('.md', '');
+}
+/** Parse bold-key frontmatter pattern: **Key**: value */
+export function parseFrontmatter(content) {
+    const entries = [];
+    const lines = content.split('\n');
+    // Parse lines until first --- separator (skip H1 title)
+    for (const line of lines) {
+        if (line.trim() === '---')
+            break;
+        const match = line.match(/^\*\*([^*]+)\*\*:\s*(.+)$/);
+        if (match) {
+            entries.push([match[1].trim(), match[2].trim()]);
+        }
+    }
+    // The parsed key-value pairs are structurally an AdrFrontmatter at runtime.
+    // Use Partial first (overlap) then assert the full type.
+    const partial = Object.fromEntries(entries);
+    return partial;
+}
+/** Extract H1 title from markdown */
+export function extractTitle(content) {
+    const match = content.match(/^#\s+(.+)$/m);
+    return match ? match[1].trim() : 'Untitled';
+}
+/** Parse a single ADR markdown file into an AdrRecord */
+export function parseAdrFile(filePath, projectRoot) {
+    const absolutePath = filePath.startsWith('/') ? filePath : join(projectRoot, filePath);
+    const content = readFileSync(absolutePath, 'utf-8');
+    const filename = filePath.split('/').pop();
+    return {
+        id: extractAdrId(filename),
+        file: filePath,
+        title: extractTitle(content),
+        frontmatter: parseFrontmatter(content),
+    };
+}
+//# sourceMappingURL=parse.js.map

package/dist/adrs/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/adrs/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,0FAA0F;AAC1F,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC3C,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACzD,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,OAAO,GAA4B,EAAE,CAAC;IAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAElC,wDAAwD;IACxD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,KAAK;YAAE,MAAM;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;QACtD,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,yDAAyD;IACzD,MAAM,OAAO,GAA4B,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACrE,OAAO,OAAyB,CAAC;AACnC,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAC3C,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;AAC/C,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,WAAmB;IAChE,MAAM,YAAY,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACvF,MAAM,OAAO,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAG,CAAC;IAE5C,OAAO;QACL,EAAE,EAAE,YAAY,CAAC,QAAQ,CAAC;QAC1B,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC;QAC5B,WAAW,EAAE,gBAAgB,CAAC,OAAO,CAAC;KACvC,CAAC;AACJ,CAAC"}

package/dist/adrs/show.d.ts

@@ -0,0 +1,11 @@
+/**
+ * ADR Show Operation (ADR-017)
+ *
+ * Retrieves a single ADR record by ID.
+ *
+ * @task T4792
+ */
+import type { AdrRecord } from './types.js';
+/** Retrieve a single ADR by ID (e.g., 'ADR-007') */
+export declare function showAdr(projectRoot: string, adrId: string): Promise<AdrRecord | null>;
+//# sourceMappingURL=show.d.ts.map

package/dist/adrs/show.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../src/adrs/show.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,oDAAoD;AACpD,wBAAsB,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAU3F"}

package/dist/adrs/show.js

@@ -0,0 +1,22 @@
+/**
+ * ADR Show Operation (ADR-017)
+ *
+ * Retrieves a single ADR record by ID.
+ *
+ * @task T4792
+ */
+import { existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { parseAdrFile } from './parse.js';
+/** Retrieve a single ADR by ID (e.g., 'ADR-007') */
+export async function showAdr(projectRoot, adrId) {
+    const adrsDir = join(projectRoot, '.cleo', 'adrs');
+    if (!existsSync(adrsDir))
+        return null;
+    const files = readdirSync(adrsDir).filter((f) => f.startsWith(adrId) && f.endsWith('.md'));
+    if (files.length === 0)
+        return null;
+    const filePath = join(adrsDir, files[0]);
+    return parseAdrFile(filePath, projectRoot);
+}
+//# sourceMappingURL=show.js.map

package/dist/adrs/show.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.js","sourceRoot":"","sources":["../../src/adrs/show.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,oDAAoD;AACpD,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,WAAmB,EAAE,KAAa;IAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAEnD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAEtC,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3F,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;IAC1C,OAAO,YAAY,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AAC7C,CAAC"}

package/dist/adrs/sync.d.ts

@@ -0,0 +1,20 @@
+/**
+ * ADR DB Sync (ADR-017)
+ *
+ * Syncs ADR markdown frontmatter into the architecture_decisions DB table
+ * AND regenerates .cleo/adrs/MANIFEST.jsonl in one pass.
+ *
+ * Single command: ct adr sync (or admin.adr.sync)
+ * - Updates architecture_decisions + adr_task_links in SQLite (runtime search)
+ * - Rewrites MANIFEST.jsonl (portable export, includes archive/ ADRs)
+ *
+ * @task T4792
+ * @task T4942 — MANIFEST generation folded in so one command keeps both in sync
+ */
+import type { AdrSyncResult } from './types.js';
+/**
+ * Sync all ADR markdown files into the architecture_decisions table
+ * AND regenerate MANIFEST.jsonl in one pass.
+ */
+export declare function syncAdrsToDb(projectRoot: string): Promise<AdrSyncResult>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/adrs/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/adrs/sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA8ChD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAgI9E"}