adr-kit 0.2.0

package/dist/core/adr.js

@@ -0,0 +1,143 @@
+import { readFileSync } from 'node:fs';
+import { basename } from 'node:path';
+export class AdrFormatError extends Error {
+    path;
+    constructor(message, path) {
+        super(`${message} (${path})`);
+        this.path = path;
+        this.name = 'AdrFormatError';
+    }
+}
+export function statusForFolder(folder) {
+    switch (folder) {
+        case 'decisions':
+            return 'accepted';
+        case 'proposed':
+            return 'proposed';
+        case 'rejected':
+            return 'rejected';
+    }
+}
+export function folderForStatus(status) {
+    switch (status) {
+        case 'accepted':
+        case 'superseded':
+            return 'decisions';
+        case 'proposed':
+            return 'proposed';
+        case 'rejected':
+            return 'rejected';
+    }
+}
+export function section(record, heading) {
+    return record.sections.find((candidate) => candidate.heading === heading)?.body;
+}
+export function hasMeaningfulBody(body) {
+    if (body === undefined)
+        return false;
+    const withoutComments = body.replace(/<!--[\s\S]*?-->/g, '');
+    return withoutComments.trim().length > 0;
+}
+/**
+ * Parse a single ADR markdown file into its structured parts.
+ *
+ * The format is deliberately plain Markdown, with no front matter:
+ *
+ *   # ADR: <title or "NNNN Title">
+ *   Status: proposed | accepted | rejected — <reason>
+ *   <blank line>
+ *   ## Problem
+ *   ...
+ */
+export function parseAdrFile(filePath) {
+    const text = readFileSync(filePath, 'utf8');
+    const lines = text.split(/\r?\n/);
+    const titleLine = lines[0] ?? '';
+    if (!titleLine.startsWith('# ADR: ')) {
+        throw new AdrFormatError('first line must be "# ADR: <title>"', filePath);
+    }
+    const title = titleLine.slice('# ADR: '.length).trim();
+    if (title.length === 0) {
+        throw new AdrFormatError('ADR title must not be empty', filePath);
+    }
+    const statusLine = lines[1] ?? '';
+    if (!statusLine.startsWith('Status: ')) {
+        throw new AdrFormatError('second line must be "Status: <status>"', filePath);
+    }
+    const statusText = statusLine.slice('Status: '.length).trim();
+    let status;
+    let rejectionReason;
+    let supersededBy;
+    if (statusText === 'proposed') {
+        status = 'proposed';
+    }
+    else if (statusText === 'accepted') {
+        status = 'accepted';
+    }
+    else if (statusText.startsWith('rejected — ')) {
+        status = 'rejected';
+        rejectionReason = statusText.slice('rejected — '.length).trim();
+        if (rejectionReason.length === 0) {
+            throw new AdrFormatError('rejected status must include a reason', filePath);
+        }
+    }
+    else if (/^superseded by \d{1,4}$/.test(statusText)) {
+        status = 'superseded';
+        supersededBy = Number(statusText.slice('superseded by '.length));
+    }
+    else {
+        throw new AdrFormatError('status must be "proposed", "accepted", "rejected — <reason>", or "superseded by NNNN"', filePath);
+    }
+    if ((lines[2] ?? '') !== '') {
+        throw new AdrFormatError('line 3 must be blank', filePath);
+    }
+    const sections = [];
+    let current = null;
+    for (const line of lines.slice(3)) {
+        if (line.startsWith('## ')) {
+            if (current !== null)
+                sections.push(current);
+            const heading = line.slice(3).trim();
+            if (heading.length === 0) {
+                throw new AdrFormatError('section heading must not be empty', filePath);
+            }
+            current = { heading, body: '' };
+        }
+        else if (current !== null) {
+            current.body += `${line}\n`;
+        }
+    }
+    if (current !== null)
+        sections.push(current);
+    const numberMatch = title.match(/^(\d{4})\s+(.+)$/);
+    const parsed = {
+        folder: 'proposed',
+        path: filePath,
+        fileName: basename(filePath),
+        title,
+        status,
+        sections,
+    };
+    if (rejectionReason !== undefined)
+        parsed.rejectionReason = rejectionReason;
+    if (supersededBy !== undefined)
+        parsed.supersededBy = supersededBy;
+    if (numberMatch !== null) {
+        parsed.number = Number(numberMatch[1]);
+    }
+    return parsed;
+}
+export function renderAdr(options) {
+    const lines = [`# ADR: ${options.title}`, `Status: ${options.status}`, ''];
+    for (const section of options.sections) {
+        lines.push(`## ${section.heading}`, '');
+        if (section.body.trim().length > 0) {
+            lines.push(section.body.replace(/\n+$/, ''), '');
+        }
+        else {
+            lines.push('', '');
+        }
+    }
+    return `${lines.join('\n').trimEnd()}\n`;
+}
+//# sourceMappingURL=adr.js.map

package/dist/core/adr.js.map

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

package/dist/core/config.d.ts

@@ -0,0 +1,22 @@
+export declare const ADR_DIR = "adr";
+export declare const CONFIG_FILE = "config.yaml";
+export interface OpenAdrConfig {
+    /** Project context shown to agents and humans when records are created. */
+    context?: string;
+    /** Optional per-status rules, e.g. `rules.proposal: ["Keep it short"]`. */
+    rules?: Record<string, string[]>;
+    /** AI tool integrations selected at init time, e.g. `["claude", "codex"]`. */
+    tools?: string[];
+    /** The raw parsed YAML document (for forward compatibility). */
+    raw: Record<string, unknown>;
+}
+/**
+ * Walk from `startDir` upward to find the nearest directory that contains
+ * `adr/config.yaml`. Returns the project root (the parent of `adr/`), or
+ * `undefined` when no OpenADR repository exists.
+ */
+export declare function findRoot(startDir: string): string | undefined;
+export declare function requireRoot(startDir: string): string;
+export declare function configPath(root: string): string;
+export declare function readConfig(root: string): OpenAdrConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,OAAO,QAAQ,CAAC;AAC7B,eAAO,MAAM,WAAW,gBAAgB,CAAC;AAEzC,MAAM,WAAW,aAAa;IAC5B,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACjC,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,gEAAgE;IAChE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAU7D;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQpD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CA8BtD"}

package/dist/core/config.js

@@ -0,0 +1,63 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { isMap, parseDocument } from 'yaml';
+export const ADR_DIR = 'adr';
+export const CONFIG_FILE = 'config.yaml';
+/**
+ * Walk from `startDir` upward to find the nearest directory that contains
+ * `adr/config.yaml`. Returns the project root (the parent of `adr/`), or
+ * `undefined` when no OpenADR repository exists.
+ */
+export function findRoot(startDir) {
+    let current = resolve(startDir);
+    for (;;) {
+        if (existsSync(join(current, ADR_DIR, CONFIG_FILE))) {
+            return current;
+        }
+        const parent = dirname(current);
+        if (parent === current)
+            return undefined;
+        current = parent;
+    }
+}
+export function requireRoot(startDir) {
+    const root = findRoot(startDir);
+    if (root === undefined) {
+        throw new Error(`no OpenADR repository found from "${startDir}" (run "openadr init" first)`);
+    }
+    return root;
+}
+export function configPath(root) {
+    return join(root, ADR_DIR, CONFIG_FILE);
+}
+export function readConfig(root) {
+    const file = configPath(root);
+    const text = readFileSync(file, 'utf8');
+    const document = parseDocument(text, { prettyErrors: true });
+    const firstError = document.errors[0];
+    if (firstError !== undefined) {
+        throw new Error(`invalid ${ADR_DIR}/${CONFIG_FILE}: ${firstError.message}`);
+    }
+    if (!isMap(document.contents)) {
+        throw new Error(`invalid ${ADR_DIR}/${CONFIG_FILE}: top-level value must be a mapping`);
+    }
+    const raw = document.contents.toJSON();
+    const config = { raw };
+    if (typeof raw.context === 'string') {
+        config.context = raw.context;
+    }
+    if (Array.isArray(raw.tools) && raw.tools.every((entry) => typeof entry === 'string')) {
+        config.tools = raw.tools;
+    }
+    if (raw.rules !== null && typeof raw.rules === 'object' && !Array.isArray(raw.rules)) {
+        const rules = {};
+        for (const [key, value] of Object.entries(raw.rules)) {
+            if (Array.isArray(value) && value.every((entry) => typeof entry === 'string')) {
+                rules[key] = value;
+            }
+        }
+        config.rules = rules;
+    }
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

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

package/dist/core/repository.d.ts

@@ -0,0 +1,19 @@
+import { type AdrFolder, type AdrRecord } from './adr.js';
+export declare const FOLDERS: AdrFolder[];
+export interface InitResult {
+    root: string;
+    created: string[];
+}
+export declare function initRepository(targetDir: string, tools?: string[]): InitResult;
+export declare function adrRoot(root: string): string;
+export declare function folderPath(root: string, folder: AdrFolder): string;
+export declare function listRecords(root: string): AdrRecord[];
+export declare function resolveRecord(root: string, query: string): AdrRecord;
+export declare function nextDecisionNumber(root: string): number;
+export declare function todayStamp(): string;
+export declare function writeRecord(root: string, folder: AdrFolder, fileName: string, content: string): string;
+export declare function removeRecord(record: AdrRecord): void;
+export declare function readRecord(record: AdrRecord): string;
+export declare function displayName(record: AdrRecord): string;
+export declare function relativePath(record: AdrRecord): string;
+//# sourceMappingURL=repository.d.ts.map

package/dist/core/repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../src/core/repository.ts"],"names":[],"mappings":"AAUA,OAAO,EAAgB,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAExE,eAAO,MAAM,OAAO,EAAE,SAAS,EAA0C,CAAC;AAE1E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAwDD,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,EAAO,GAAG,UAAU,CA0BlF;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,MAAM,CAElE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CA0BrD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAiCpE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQvD;AAED,wBAAgB,UAAU,IAAI,MAAM,CAMnC;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAItG;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAEpD;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAEpD;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAOrD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAEtD"}

package/dist/core/repository.js

@@ -0,0 +1,190 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync, } from 'node:fs';
+import { basename, join, relative, resolve } from 'node:path';
+import { ADR_DIR, CONFIG_FILE, configPath } from './config.js';
+import { parseAdrFile } from './adr.js';
+export const FOLDERS = ['decisions', 'proposed', 'rejected'];
+function initConfig(tools) {
+    // tools 始终作为顶层键输出：全注释的 YAML 文档会被解析为空，
+    // readConfig 的 isMap 检查会报 "top-level value must be a mapping"。
+    const toolsYaml = `tools: [${tools.join(', ')}]\n`;
+    return `# OpenADR configuration
+# Fill in \`context\` and it is injected as a comment into every new
+# proposal/decision draft (openadr propose / openadr decide).
+# context: |
+#   Tech stack: TypeScript
+#   Conventions that decision records should respect.
+
+# AI tool integrations written by openadr init --tools.
+${toolsYaml}
+# Optional per-status conventions. These are hints for writers and agents;
+# validate does not enforce them (it cannot check prose).
+# rules:
+#   proposal:
+#     - Keep proposals under 500 words.
+#   decision:
+#     - Always name the owning team.
+`;
+}
+const INIT_README = `# Architecture Decision Records
+
+This directory is an OpenADR repository. Each record is plain Markdown with a
+machine-checkable header and lifecycle folders.
+
+## Folders
+
+| Folder | Meaning |
+| --- | --- |
+| \`decisions/\` | Accepted decisions, numbered \`NNNN\`, current truth |
+| \`proposed/\` | Proposals that are not yet accepted or rejected |
+| \`rejected/\` | Rejected proposals, frozen for the record |
+
+## Record format
+
+Every record starts with exactly:
+
+\`\`\`markdown
+# ADR: <title>
+
+Status: proposed | accepted | rejected — <reason>
+\`\`\`
+
+Accepted decisions use \`# ADR: NNNN <title>\` and require
+\`Problem\`, \`Decision\`, \`Alternatives considered\`, and \`Consequences\`.
+Proposals require \`Problem\`, \`Proposal\`, \`Alternatives considered\`,
+\`Acceptance criteria\`, and \`Risks\`.
+
+Run \`openadr validate\` to check every record.
+`;
+export function initRepository(targetDir, tools = []) {
+    const root = resolve(targetDir);
+    const adrRoot = join(root, ADR_DIR);
+    if (existsSync(adrRoot)) {
+        throw new Error(`OpenADR already exists at ${adrRoot}`);
+    }
+    const created = [];
+    mkdirSync(adrRoot, { recursive: true });
+    created.push(ADR_DIR);
+    for (const folder of FOLDERS) {
+        const path = join(adrRoot, folder);
+        mkdirSync(path, { recursive: true });
+        writeFileSync(join(path, '.gitkeep'), '');
+        created.push(`${ADR_DIR}/${folder}`);
+    }
+    const config = configPath(root);
+    writeFileSync(config, initConfig(tools));
+    created.push(`${ADR_DIR}/${CONFIG_FILE}`);
+    const readme = join(adrRoot, 'README.md');
+    writeFileSync(readme, INIT_README);
+    created.push(`${ADR_DIR}/README.md`);
+    return { root, created };
+}
+export function adrRoot(root) {
+    return join(root, ADR_DIR);
+}
+export function folderPath(root, folder) {
+    return join(adrRoot(root), folder);
+}
+export function listRecords(root) {
+    const records = [];
+    for (const folder of FOLDERS) {
+        const dir = folderPath(root, folder);
+        if (!existsSync(dir))
+            continue;
+        for (const entry of readdirSync(dir)) {
+            if (!entry.endsWith('.md'))
+                continue;
+            const path = join(dir, entry);
+            try {
+                const record = parseAdrFile(path);
+                record.folder = folder;
+                records.push(record);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                throw new Error(`failed to parse ${relative(root, path)}: ${message}`);
+            }
+        }
+    }
+    records.sort((a, b) => {
+        const folderOrder = (folder) => FOLDERS.indexOf(folder);
+        const folderDelta = folderOrder(a.folder) - folderOrder(b.folder);
+        if (folderDelta !== 0)
+            return folderDelta;
+        if (a.folder === 'decisions')
+            return (a.number ?? 0) - (b.number ?? 0);
+        return a.fileName.localeCompare(b.fileName);
+    });
+    return records;
+}
+export function resolveRecord(root, query) {
+    const records = listRecords(root);
+    const normalized = query.trim();
+    const candidates = records.filter((record) => {
+        const bareName = record.fileName.replace(/\.md$/, '');
+        const slug = bareName.replace(/^\d{4}-\d{2}-\d{2}-/, '').replace(/^\d{4}-/, '');
+        if (record.fileName === normalized || bareName === normalized || slug === normalized) {
+            return true;
+        }
+        if (record.title === normalized || `# ADR: ${record.title}` === normalized) {
+            return true;
+        }
+        if (record.folder === 'decisions') {
+            const padded = String(record.number ?? 0).padStart(4, '0');
+            if (padded === normalized || String(record.number ?? 0) === normalized) {
+                return true;
+            }
+        }
+        return false;
+    });
+    if (candidates.length === 0) {
+        throw new Error(`no ADR matches "${query}"`);
+    }
+    if (candidates.length > 1) {
+        const paths = candidates.map((record) => relative(root, record.path)).join(', ');
+        throw new Error(`"${query}" is ambiguous; matches: ${paths}`);
+    }
+    const first = candidates[0];
+    if (first === undefined) {
+        throw new Error(`no ADR matches "${query}"`);
+    }
+    return first;
+}
+export function nextDecisionNumber(root) {
+    let max = 0;
+    for (const record of listRecords(root)) {
+        if (record.folder === 'decisions' && (record.number ?? 0) > max) {
+            max = record.number ?? 0;
+        }
+    }
+    return max + 1;
+}
+export function todayStamp() {
+    const now = new Date();
+    const year = now.getFullYear();
+    const month = String(now.getMonth() + 1).padStart(2, '0');
+    const day = String(now.getDate()).padStart(2, '0');
+    return `${year}-${month}-${day}`;
+}
+export function writeRecord(root, folder, fileName, content) {
+    const path = join(folderPath(root, folder), fileName);
+    writeFileSync(path, content);
+    return path;
+}
+export function removeRecord(record) {
+    rmSync(record.path);
+}
+export function readRecord(record) {
+    return readFileSync(record.path, 'utf8');
+}
+export function displayName(record) {
+    if (record.folder === 'decisions' && Number.isInteger(record.number)) {
+        const padded = String(record.number).padStart(4, '0');
+        const titleWithoutNumber = record.title.replace(/^\d{4}\s+/, '');
+        return `[${padded}] ${titleWithoutNumber}`;
+    }
+    return record.title;
+}
+export function relativePath(record) {
+    return join(ADR_DIR, record.folder, basename(record.path));
+}
+//# sourceMappingURL=repository.js.map

package/dist/core/repository.js.map

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

package/dist/core/slug.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Convert an ADR title into a file-name slug.
+ *
+ * The slug keeps ASCII letters, digits, and CJK characters so that English
+ * and Chinese titles both remain readable in file names. Everything else
+ * becomes a single dash, and the result is capped so generated paths stay
+ * reasonable on every file system.
+ */
+export declare function slugify(title: string): string;
+//# sourceMappingURL=slug.d.ts.map

package/dist/core/slug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.d.ts","sourceRoot":"","sources":["../../src/core/slug.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAU7C"}

package/dist/core/slug.js

@@ -0,0 +1,19 @@
+/**
+ * Convert an ADR title into a file-name slug.
+ *
+ * The slug keeps ASCII letters, digits, and CJK characters so that English
+ * and Chinese titles both remain readable in file names. Everything else
+ * becomes a single dash, and the result is capped so generated paths stay
+ * reasonable on every file system.
+ */
+export function slugify(title) {
+    const slug = title
+        .trim()
+        .toLowerCase()
+        .replace(/['"`'']/g, '')
+        .replace(/[^a-z0-9\u4e00-\u9fff]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 80);
+    return slug.length > 0 ? slug : 'untitled';
+}
+//# sourceMappingURL=slug.js.map

package/dist/core/slug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.js","sourceRoot":"","sources":["../../src/core/slug.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,MAAM,IAAI,GAAG,KAAK;SACf,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,OAAO,CAAC,0BAA0B,EAAE,GAAG,CAAC;SACxC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEhB,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC;AAC7C,CAAC"}

package/dist/core/templates.d.ts

@@ -0,0 +1,11 @@
+import type { AdrRecord } from './adr.js';
+export declare function proposalTemplate(title: string, context?: string): string;
+export declare function decisionTemplate(number: number, title: string, context?: string): string;
+export declare function rejectedTemplate(title: string, reason: string): string;
+/**
+ * Convert a proposal into an accepted decision using the same mechanical
+ * rewrite the format requires: Proposal becomes Decision, and the
+ * acceptance criteria and risks are folded into Consequences.
+ */
+export declare function proposalToDecision(proposal: AdrRecord, number: number): string;
+//# sourceMappingURL=templates.d.ts.map

package/dist/core/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/core/templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAiB1C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAyBxE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAsBxF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAgBtE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAqC9E"}

package/dist/core/templates.js

@@ -0,0 +1,126 @@
+/**
+ * 把 config.yaml 的 context 注入模板：放在标题块之后、第一个 section 之前。
+ * 解析器忽略游离文本（current 为 null 时不收集），accept 的机械改写也会
+ * 丢弃它——注释只在草案期可见，正是写作者需要项目上下文的时刻。
+ */
+function contextBlock(context) {
+    const text = context?.trim() ?? '';
+    // 空 context 或纯占位注释（老 init 模板遗留）都不注入
+    if (text.length === 0 || text.startsWith('<!--'))
+        return '';
+    return `<!-- Project context (adr/config.yaml):
+${text}
+-->
+`;
+}
+export function proposalTemplate(title, context) {
+    return `# ADR: ${title}
+Status: proposed
+
+${contextBlock(context)}## Problem
+
+<!-- What problem or opportunity does this decision address? Why now? -->
+
+## Proposal
+
+<!-- The proposed decision. Be specific about what will change. -->
+
+## Alternatives considered
+
+<!-- Each genuine alternative and why it lost. Keep this section: it is the
+     part of a decision record that prevents re-litigating old choices. -->
+
+## Acceptance criteria
+
+<!-- Observable state that means the proposal is done. -->
+
+## Risks
+
+<!-- What could go wrong, and what the change knowingly gives up. -->
+`;
+}
+export function decisionTemplate(number, title, context) {
+    const padded = String(number).padStart(4, '0');
+    return `# ADR: ${padded} ${title}
+Status: accepted
+
+${contextBlock(context)}## Problem
+
+<!-- What problem or opportunity does this decision address? -->
+
+## Decision
+
+<!-- The decision that shipped, in present tense. -->
+
+## Alternatives considered
+
+<!-- Each genuine alternative and why it lost. Keep this section: it is the
+     part of a decision record that prevents re-litigating old choices. -->
+
+## Consequences
+
+<!-- What the trade-off cost and bought. -->
+`;
+}
+export function rejectedTemplate(title, reason) {
+    return `# ADR: ${title}
+Status: rejected — ${reason}
+
+## Problem
+
+<!-- What problem or opportunity was this proposal addressing? -->
+
+## Proposal
+
+<!-- The rejected proposal. -->
+
+## Alternatives considered
+
+<!-- Each genuine alternative and why it lost. -->
+`;
+}
+/**
+ * Convert a proposal into an accepted decision using the same mechanical
+ * rewrite the format requires: Proposal becomes Decision, and the
+ * acceptance criteria and risks are folded into Consequences.
+ */
+export function proposalToDecision(proposal, number) {
+    const problem = sectionBody(proposal, 'Problem');
+    const decision = sectionBody(proposal, 'Proposal');
+    const alternatives = sectionBody(proposal, 'Alternatives considered');
+    const acceptance = sectionBody(proposal, 'Acceptance criteria');
+    const risks = sectionBody(proposal, 'Risks');
+    const consequences = [];
+    if (acceptance.trim().length > 0) {
+        consequences.push('### Acceptance criteria', '', acceptance.trim(), '');
+    }
+    if (risks.trim().length > 0) {
+        consequences.push('### Risks', '', risks.trim(), '');
+    }
+    if (consequences.length === 0) {
+        consequences.push('_No consequences recorded._', '');
+    }
+    const padded = String(number).padStart(4, '0');
+    return `# ADR: ${padded} ${proposal.title}
+Status: accepted
+
+## Problem
+
+${problem.trim() || '_No problem recorded._'}
+
+## Decision
+
+${decision.trim() || '_No decision recorded._'}
+
+## Alternatives considered
+
+${alternatives.trim() || '_No alternatives recorded._'}
+
+## Consequences
+
+${consequences.join('\n')}\n`;
+}
+function sectionBody(record, heading) {
+    return record.sections.find((candidate) => candidate.heading === heading)?.body.trim() ?? '';
+}
+//# sourceMappingURL=templates.js.map