spec-manager 0.1.0

package/dist/core/audit-events.js

@@ -0,0 +1,16 @@
+import { hit } from './audit.js';
+export const writeAuditSink = {
+    hit(event) {
+        hit(event);
+    },
+};
+export class CollectingAuditSink {
+    events = [];
+    hit(event) {
+        this.events.push(event);
+    }
+}
+export function recordAuditHit(event, sink = writeAuditSink) {
+    sink.hit(event);
+}
+//# sourceMappingURL=audit-events.js.map

package/dist/core/audit-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-events.js","sourceRoot":"","sources":["../../src/core/audit-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAiB,MAAM,YAAY,CAAC;AAQhD,MAAM,CAAC,MAAM,cAAc,GAAc;IACvC,GAAG,CAAC,KAAiB;QACnB,GAAG,CAAC,KAAK,CAAC,CAAC;IACb,CAAC;CACF,CAAC;AAEF,MAAM,OAAO,mBAAmB;IACrB,MAAM,GAAiB,EAAE,CAAC;IAEnC,GAAG,CAAC,KAAiB;QACnB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,UAAU,cAAc,CAAC,KAAiB,EAAE,OAAkB,cAAc;IAChF,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAClB,CAAC"}

package/dist/core/audit.d.ts

@@ -0,0 +1,78 @@
+/**
+ * 规则审计（本地版）
+ *
+ * 数据结构（.spec-manager/audit.json）：
+ * {
+ *   sessionId: string,
+ *   startedAt: string (ISO),
+ *   topic: string,
+ *   rules: { R1: 0, R2: 0, ..., R24: 0 },
+ *   pending: PendingEntry[],
+ *   lastUpdated: string (ISO)
+ * }
+ *
+ * PendingEntry 字段：{ ruleId, timestamp, specCode?, taskCode? }
+ *
+ * at-least-once 语义：
+ * - hit() 永远 append pending 队列（即使已 session-bound）
+ * - report() 把 pending 中 reported=false 的标记为 reported=true
+ *   （本地版"report"=标记已审计，不发任何网络请求；如未来要接远程后端，
+ *    在 report() 里加 POST 即可，pending 机制不变）
+ */
+import type { ProjectPaths } from './paths.js';
+export declare const RULE_ID_RE: RegExp;
+export declare const ALL_RULE_IDS: string[];
+/** 最低合规基线：这些规则的 hit 计数必须 ≥1 */
+export declare const COMPLIANCE_BASELINE: readonly string[];
+export interface PendingEntry {
+    ruleId: string;
+    timestamp: string;
+    specCode?: string;
+    taskCode?: string;
+    reported: boolean;
+}
+export interface AuditState {
+    sessionId: string;
+    startedAt: string;
+    topic: string;
+    rules: Record<string, number>;
+    pending: PendingEntry[];
+    lastUpdated: string;
+}
+export declare function readAudit(paths: ProjectPaths): AuditState;
+export declare function writeAudit(paths: ProjectPaths, state: AuditState): void;
+export interface HitInput {
+    paths: ProjectPaths;
+    ruleId: string;
+    specCode?: string;
+    taskCode?: string;
+}
+export declare function hit(input: HitInput): AuditState;
+export declare function startSession(paths: ProjectPaths, opts: {
+    sessionId: string;
+    topic?: string;
+}): AuditState;
+export interface ReportResult {
+    markedReported: number;
+    remaining: number;
+}
+/**
+ * 标记 pending 中 reported=false 的条目为 reported=true。
+ * 本地版"report"语义 = 落库到 .spec-manager/audit-archive.json
+ */
+export declare function report(paths: ProjectPaths): ReportResult;
+export declare function showSummary(paths: ProjectPaths, opts?: {
+    ruleId?: string;
+}): string;
+export interface ComplianceResult {
+    pass: boolean;
+    details: Array<{
+        ruleId: string;
+        count: number;
+        min: number;
+        pass: boolean;
+    }>;
+}
+/** 检查最低合规基线：R1≥1, R4≥1, R13≥1, R22≥1 */
+export declare function checkCompliance(state: AuditState): ComplianceResult;
+//# sourceMappingURL=audit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/core/audit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,eAAO,MAAM,UAAU,QAA6B,CAAC;AACrD,eAAO,MAAM,YAAY,UAAoD,CAAC;AAE9E,+BAA+B;AAC/B,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAA+B,CAAC;AAKjF,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAQD,wBAAgB,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,UAAU,CAqBzD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAOvE;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,UAAU,CAgB/C;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,CAWzG;AAED,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,CAqBxD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAyBnF;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC/E;AAED,wCAAwC;AACxC,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,gBAAgB,CAMnE"}

package/dist/core/audit.js

@@ -0,0 +1,157 @@
+/**
+ * 规则审计（本地版）
+ *
+ * 数据结构（.spec-manager/audit.json）：
+ * {
+ *   sessionId: string,
+ *   startedAt: string (ISO),
+ *   topic: string,
+ *   rules: { R1: 0, R2: 0, ..., R24: 0 },
+ *   pending: PendingEntry[],
+ *   lastUpdated: string (ISO)
+ * }
+ *
+ * PendingEntry 字段：{ ruleId, timestamp, specCode?, taskCode? }
+ *
+ * at-least-once 语义：
+ * - hit() 永远 append pending 队列（即使已 session-bound）
+ * - report() 把 pending 中 reported=false 的标记为 reported=true
+ *   （本地版"report"=标记已审计，不发任何网络请求；如未来要接远程后端，
+ *    在 report() 里加 POST 即可，pending 机制不变）
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync, renameSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+export const RULE_ID_RE = /^R([1-9]|1[0-9]|2[0-4])$/;
+export const ALL_RULE_IDS = Array.from({ length: 24 }, (_, i) => `R${i + 1}`);
+/** 最低合规基线：这些规则的 hit 计数必须 ≥1 */
+export const COMPLIANCE_BASELINE = ['R1', 'R4', 'R13', 'R22'];
+for (const id of COMPLIANCE_BASELINE) {
+    if (!RULE_ID_RE.test(id))
+        throw new Error(`COMPLIANCE_BASELINE contains invalid ruleId: ${id}`);
+}
+function emptyRules() {
+    const r = {};
+    for (const id of ALL_RULE_IDS)
+        r[id] = 0;
+    return r;
+}
+export function readAudit(paths) {
+    if (!existsSync(paths.auditFile)) {
+        return {
+            sessionId: '',
+            startedAt: '',
+            topic: '',
+            rules: emptyRules(),
+            pending: [],
+            lastUpdated: '',
+        };
+    }
+    const raw = JSON.parse(readFileSync(paths.auditFile, 'utf8'));
+    // 兜底：缺失 rules 时填充完整 24 条
+    for (const id of ALL_RULE_IDS) {
+        if (typeof raw.rules?.[id] !== 'number') {
+            raw.rules = raw.rules ?? {};
+            raw.rules[id] = 0;
+        }
+    }
+    raw.pending = raw.pending ?? [];
+    return raw;
+}
+export function writeAudit(paths, state) {
+    const dir = dirname(paths.auditFile);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    const tmp = join(dir, `.audit-${Date.now()}.tmp`);
+    writeFileSync(tmp, JSON.stringify(state, null, 2), 'utf8');
+    // rename 替换原文件
+    renameSync(tmp, paths.auditFile);
+}
+export function hit(input) {
+    if (!RULE_ID_RE.test(input.ruleId)) {
+        throw new Error(`ruleId 格式非法: ${input.ruleId}（必须 /^R([1-9]|1[0-9]|2[0-4])$/）`);
+    }
+    const state = readAudit(input.paths);
+    state.rules[input.ruleId] = (state.rules[input.ruleId] ?? 0) + 1;
+    state.pending.push({
+        ruleId: input.ruleId,
+        timestamp: new Date().toISOString(),
+        specCode: input.specCode,
+        taskCode: input.taskCode,
+        reported: false,
+    });
+    state.lastUpdated = new Date().toISOString();
+    writeAudit(input.paths, state);
+    return state;
+}
+export function startSession(paths, opts) {
+    const state = {
+        sessionId: opts.sessionId,
+        startedAt: new Date().toISOString(),
+        topic: opts.topic ?? '',
+        rules: emptyRules(),
+        pending: [],
+        lastUpdated: new Date().toISOString(),
+    };
+    writeAudit(paths, state);
+    return state;
+}
+/**
+ * 标记 pending 中 reported=false 的条目为 reported=true。
+ * 本地版"report"语义 = 落库到 .spec-manager/audit-archive.json
+ */
+export function report(paths) {
+    const state = readAudit(paths);
+    let marked = 0;
+    for (const e of state.pending) {
+        if (!e.reported) {
+            e.reported = true;
+            marked++;
+        }
+    }
+    // 把已 reported 的条目移到 archive（本地存档）
+    const archivePath = join(dirname(paths.auditFile), 'audit-archive.json');
+    let archive = [];
+    if (existsSync(archivePath)) {
+        archive = JSON.parse(readFileSync(archivePath, 'utf8'));
+    }
+    archive.push(...state.pending);
+    state.pending = [];
+    state.lastUpdated = new Date().toISOString();
+    writeAudit(paths, state);
+    writeFileSync(archivePath, JSON.stringify(archive, null, 2), 'utf8');
+    return { markedReported: marked, remaining: 0 };
+}
+export function showSummary(paths, opts) {
+    const state = readAudit(paths);
+    const lines = [];
+    lines.push(`session: ${state.sessionId || '(无)'}  topic: ${state.topic || '(无)'}  updated: ${state.lastUpdated}`);
+    lines.push('');
+    lines.push('rule hit counts:');
+    for (const id of ALL_RULE_IDS) {
+        const n = state.rules[id] ?? 0;
+        if (opts?.ruleId && opts.ruleId !== id)
+            continue;
+        const sym = n > 0 ? '✓' : '·';
+        lines.push(`  ${sym} ${id}: ${n}`);
+    }
+    lines.push('');
+    const unreported = state.pending.filter(e => !e.reported);
+    lines.push(`pending: ${state.pending.length}（未 report: ${unreported.length}）`);
+    // 合规基线检查
+    const baseline = checkCompliance(state);
+    lines.push('');
+    lines.push(`compliance: ${baseline.pass ? '✓ PASS' : '✗ FAIL'}`);
+    for (const item of baseline.details) {
+        lines.push(`  ${item.pass ? '✓' : '✗'} ${item.ruleId}: ${item.count} (min ${item.min})`);
+    }
+    return lines.join('\n');
+}
+/** 检查最低合规基线：R1≥1, R4≥1, R13≥1, R22≥1 */
+export function checkCompliance(state) {
+    const details = COMPLIANCE_BASELINE.map(ruleId => {
+        const count = state.rules[ruleId] ?? 0;
+        return { ruleId, count, min: 1, pass: count >= 1 };
+    });
+    return { pass: details.every(d => d.pass), details };
+}
+//# sourceMappingURL=audit.js.map

package/dist/core/audit.js.map

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

package/dist/core/constants.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 项目内魔数集中地。修改前先确认是否有测试覆盖。
+ */
+/** Decision card what 字段最大字符数 */
+export declare const DECISION_WHAT_MAX = 500;
+/** Decision card why 字段最大字符数 */
+export declare const DECISION_WHY_MAX = 500;
+/** Spec aiSummary 字段最大字符数(R13/R21 强约束) */
+export declare const AI_SUMMARY_MAX = 300;
+/** PlanJson 步骤数上限(R11) */
+export declare const PLAN_STEPS_MAX = 20;
+/** Decision/Task/Incident ID 编号位数(如 DC-001 / T-001 / INC-...-001) */
+export declare const ID_PAD_WIDTH = 3;
+/** createSpec 写入的占位正文标记,R22 校验用 */
+export declare const PLACEHOLDER_MARKER = "<!-- \u5728\u6B64\u7C98\u8D34\u6B63\u6587 -->";
+/** R22: 占位正文判定阈值 — 去掉 marker 后正文长度低于此值视为占位 */
+export declare const PLACEHOLDER_CONTENT_MAX = 200;
+/** Task 文件扩展名 */
+export declare const TASK_FILE_EXT = ".json";
+/** Task ID 前缀 */
+export declare const TASK_ID_PREFIX = "T-";
+/** topic 必须是安全的单段路径名 */
+export declare const TOPIC_RE: RegExp;
+/** spec code: <topic>-L1 / <topic>-L2.1 / <topic>-L3.1.1[-desc];desc 不能是 8 位日期 */
+export declare const SPEC_CODE_RE: RegExp;
+/** 当天日期 YYYYMMDD */
+export declare function todayYYYYMMDD(): string;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,iCAAiC;AACjC,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,gCAAgC;AAChC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,0CAA0C;AAC1C,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC,0BAA0B;AAC1B,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC,qEAAqE;AACrE,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B,mCAAmC;AACnC,eAAO,MAAM,kBAAkB,kDAAoB,CAAC;AAEpD,8CAA8C;AAC9C,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C,iBAAiB;AACjB,eAAO,MAAM,aAAa,UAAU,CAAC;AAErC,iBAAiB;AACjB,eAAO,MAAM,cAAc,OAAO,CAAC;AAEnC,wBAAwB;AACxB,eAAO,MAAM,QAAQ,QAAyB,CAAC;AAE/C,kFAAkF;AAClF,eAAO,MAAM,YAAY,QAA4E,CAAC;AAEtG,oBAAoB;AACpB,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/dist/core/constants.js

@@ -0,0 +1,30 @@
+/**
+ * 项目内魔数集中地。修改前先确认是否有测试覆盖。
+ */
+/** Decision card what 字段最大字符数 */
+export const DECISION_WHAT_MAX = 500;
+/** Decision card why 字段最大字符数 */
+export const DECISION_WHY_MAX = 500;
+/** Spec aiSummary 字段最大字符数(R13/R21 强约束) */
+export const AI_SUMMARY_MAX = 300;
+/** PlanJson 步骤数上限(R11) */
+export const PLAN_STEPS_MAX = 20;
+/** Decision/Task/Incident ID 编号位数(如 DC-001 / T-001 / INC-...-001) */
+export const ID_PAD_WIDTH = 3;
+/** createSpec 写入的占位正文标记,R22 校验用 */
+export const PLACEHOLDER_MARKER = '<!-- 在此粘贴正文 -->';
+/** R22: 占位正文判定阈值 — 去掉 marker 后正文长度低于此值视为占位 */
+export const PLACEHOLDER_CONTENT_MAX = 200;
+/** Task 文件扩展名 */
+export const TASK_FILE_EXT = '.json';
+/** Task ID 前缀 */
+export const TASK_ID_PREFIX = 'T-';
+/** topic 必须是安全的单段路径名 */
+export const TOPIC_RE = /^[a-z0-9][a-z0-9-]*$/;
+/** spec code: <topic>-L1 / <topic>-L2.1 / <topic>-L3.1.1[-desc];desc 不能是 8 位日期 */
+export const SPEC_CODE_RE = /^[a-z0-9][a-z0-9-]*-L[0-3](?:\.\d+)*(?:-(?!\d{8}$)[a-z0-9][a-z0-9-]*)?$/;
+/** 当天日期 YYYYMMDD */
+export function todayYYYYMMDD() {
+    return new Date().toISOString().slice(0, 10).replace(/-/g, '');
+}
+//# sourceMappingURL=constants.js.map

package/dist/core/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,iCAAiC;AACjC,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAErC,gCAAgC;AAChC,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAEpC,0CAA0C;AAC1C,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAElC,0BAA0B;AAC1B,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AAEjC,qEAAqE;AACrE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAE9B,mCAAmC;AACnC,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AAEpD,8CAA8C;AAC9C,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAE3C,iBAAiB;AACjB,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC;AAErC,iBAAiB;AACjB,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AAEnC,wBAAwB;AACxB,MAAM,CAAC,MAAM,QAAQ,GAAG,sBAAsB,CAAC;AAE/C,kFAAkF;AAClF,MAAM,CAAC,MAAM,YAAY,GAAG,yEAAyE,CAAC;AAEtG,oBAAoB;AACpB,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AACjE,CAAC"}

package/dist/core/decision.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Decision Cards — 结构化 what/why/affectedCriteria
+ * 存储位置：specs/<topic>/<L1-code>/decisions/<id>.md
+ * 一决策一文件，frontmatter 索引元数据，正文可读详情。
+ */
+import { type ProjectPaths } from './paths.js';
+export type DecisionStatus = 'active' | 'superseded' | 'partial';
+export interface DecisionRecord {
+    id: string;
+    fm: {
+        id: string;
+        docCode: string;
+        topic: string;
+        what: string;
+        why?: string;
+        status: DecisionStatus;
+        supersededById: string | null;
+        affectedCriteria?: string[];
+        created: string;
+        updated: string;
+    };
+    content: string;
+    filePath: string;
+}
+export declare function listDecisions(paths: ProjectPaths, opts?: {
+    topic?: string;
+    docCode?: string;
+    includeAll?: boolean;
+    criteria?: string | string[];
+}): DecisionRecord[];
+export declare function findDecision(paths: ProjectPaths, id: string): DecisionRecord | null;
+export declare function nextDecisionId(paths: ProjectPaths, topic: string): string;
+export interface CreateDecisionInput {
+    paths: ProjectPaths;
+    docCode: string;
+    topic: string;
+    what: string;
+    why?: string;
+    affectedCriteria?: string[];
+}
+export declare function createDecision(input: CreateDecisionInput): DecisionRecord;
+export declare function supersedeDecision(paths: ProjectPaths, oldId: string, newId: string): void;
+/**
+ * 删除决策。仅 active 状态可删;superseded/partial 状态需先恢复或归档(避免丢失审计轨迹)。
+ */
+export declare function deleteDecision(paths: ProjectPaths, id: string): void;
+export interface UpdateDecisionInput {
+    paths: ProjectPaths;
+    id: string;
+    what?: string;
+    why?: string;
+    affectedCriteria?: string[];
+}
+/**
+ * 编辑决策的 what/why/affectedCriteria。状态变更走 supersede / set-partial。
+ * superseded 状态的决策不可编辑（避免改历史）。
+ */
+export declare function updateDecision(input: UpdateDecisionInput): DecisionRecord;
+export interface SetPartialInput {
+    paths: ProjectPaths;
+    id: string;
+    reason: string;
+}
+/**
+ * 把决策标记为 partial(部分被取代/部分作废),需 --reason 解释。
+ * 区别于 supersede:partial 不指向新决策 ID,只标记"局部失效"。
+ */
+export declare function setDecisionPartial(input: SetPartialInput): DecisionRecord;
+//# sourceMappingURL=decision.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decision.d.ts","sourceRoot":"","sources":["../../src/core/decision.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAK/D,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAC;AAEjE,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE;QACF,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,cAAc,CAAC;QACvB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC5B,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAKD,wBAAgB,aAAa,CAC3B,KAAK,EAAE,YAAY,EACnB,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAAE,GAC9F,cAAc,EAAE,CAelB;AAeD,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAKnF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAOzE;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,cAAc,CAoCzE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAgBzF;AAwBD;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAUpE;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,YAAY,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,cAAc,CAyBzE;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,YAAY,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,cAAc,CAkBzE"}

package/dist/core/decision.js

@@ -0,0 +1,210 @@
+/**
+ * Decision Cards — 结构化 what/why/affectedCriteria
+ * 存储位置：specs/<topic>/<L1-code>/decisions/<id>.md
+ * 一决策一文件，frontmatter 索引元数据，正文可读详情。
+ */
+import { unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+import { readFrontmatter, writeFrontmatterAtomic } from './frontmatter.js';
+import { siblingMetaDir } from './paths.js';
+import { findSpecByCode } from './spec-io.js';
+import { DECISION_WHAT_MAX, DECISION_WHY_MAX, ID_PAD_WIDTH } from './constants.js';
+import { listTopicMetaFiles } from './repository.js';
+const WHAT_MAX = DECISION_WHAT_MAX;
+const WHY_MAX = DECISION_WHY_MAX;
+export function listDecisions(paths, opts) {
+    const out = [];
+    const criteriaFilter = normalizeCriteriaFilter(opts?.criteria);
+    const files = listTopicMetaFiles(paths, 'decisions', { topic: opts?.topic, extension: '.md' });
+    for (const file of files) {
+        const { data, content } = readFrontmatter(file.filePath);
+        const fm = data;
+        if (opts?.topic && fm.topic !== opts.topic)
+            continue;
+        if (opts?.docCode && fm.docCode !== opts.docCode)
+            continue;
+        if (!opts?.includeAll && fm.status !== 'active')
+            continue;
+        if (criteriaFilter && !decisionAffectsAny(fm.affectedCriteria, criteriaFilter))
+            continue;
+        out.push({ id: fm.id, fm, content, filePath: file.filePath });
+    }
+    out.sort((a, b) => a.fm.created.localeCompare(b.fm.created));
+    return out;
+}
+function normalizeCriteriaFilter(input) {
+    if (input === undefined)
+        return null;
+    const arr = Array.isArray(input) ? input : input.split(',');
+    const trimmed = arr.map(s => s.trim()).filter(Boolean);
+    return trimmed.length > 0 ? trimmed : null;
+}
+function decisionAffectsAny(affected, criteria) {
+    if (!affected || affected.length === 0)
+        return false;
+    const set = new Set(affected);
+    return criteria.some(c => set.has(c));
+}
+export function findDecision(paths, id) {
+    for (const d of listDecisions(paths, { includeAll: true })) {
+        if (d.id === id || d.fm.id === id)
+            return d;
+    }
+    return null;
+}
+export function nextDecisionId(paths, topic) {
+    let max = 0;
+    for (const file of listTopicMetaFiles(paths, 'decisions', { topic, extension: '.md' })) {
+        const m = file.fileName.match(/^DC-(\d+)\.md$/);
+        if (m)
+            max = Math.max(max, Number(m[1]));
+    }
+    return `DC-${String(max + 1).padStart(ID_PAD_WIDTH, '0')}`;
+}
+export function createDecision(input) {
+    // R18 校验：只能给 implemented L1 建决策
+    const spec = findSpecByCode(input.paths, input.docCode);
+    if (!spec) {
+        throw new Error(`Spec not found: ${input.docCode}`);
+    }
+    if (spec.fm.level !== 'L1') {
+        throw new Error(`Decision card 只能关联 L1 spec，${input.docCode} 是 ${spec.fm.level}`);
+    }
+    if (spec.fm.status !== 'implemented') {
+        throw new Error(`R18: L1 必须 implemented 才能建决策卡片，当前 status=${spec.fm.status}`);
+    }
+    if (input.what.length > WHAT_MAX) {
+        throw new Error(`what 长度 ${input.what.length} > ${WHAT_MAX}`);
+    }
+    if (input.why && input.why.length > WHY_MAX) {
+        throw new Error(`why 长度 ${input.why.length} > ${WHY_MAX}`);
+    }
+    const id = nextDecisionId(input.paths, input.topic);
+    const now = new Date().toISOString();
+    const fm = {
+        id,
+        docCode: input.docCode,
+        topic: input.topic,
+        what: input.what,
+        why: input.why,
+        status: 'active',
+        supersededById: null,
+        affectedCriteria: input.affectedCriteria,
+        created: now,
+        updated: now,
+    };
+    const content = renderContent(fm);
+    const filePath = join(siblingMetaDir(spec.filePath, 'decisions'), `${id}.md`);
+    writeFrontmatterAtomic(filePath, fm, content);
+    return { id, fm, content, filePath };
+}
+export function supersedeDecision(paths, oldId, newId) {
+    const old = findDecision(paths, oldId);
+    if (!old)
+        throw new Error(`Decision not found: ${oldId}`);
+    const newDec = findDecision(paths, newId);
+    if (!newDec)
+        throw new Error(`New decision not found: ${newId}`);
+    const updated = {
+        ...old,
+        fm: {
+            ...old.fm,
+            status: 'superseded',
+            supersededById: newId,
+            updated: new Date().toISOString(),
+        },
+    };
+    updated.content = renderContent(updated.fm);
+    writeFrontmatterAtomic(old.filePath, updated.fm, updated.content);
+}
+function renderContent(fm) {
+    const lines = [];
+    lines.push(`# ${fm.id} — ${fm.what}`);
+    lines.push('');
+    lines.push(`> 关联 spec: **${fm.docCode}**  |  状态: **${fm.status}**${fm.supersededById ? `  |  被 ${fm.supersededById} 取代` : ''}`);
+    lines.push('');
+    lines.push('## 决定');
+    lines.push(fm.what);
+    lines.push('');
+    if (fm.why) {
+        lines.push('## 为什么');
+        lines.push(fm.why);
+        lines.push('');
+    }
+    if (fm.affectedCriteria && fm.affectedCriteria.length > 0) {
+        lines.push('## 影响的验收标准');
+        for (const c of fm.affectedCriteria)
+            lines.push(`- ${c}`);
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/**
+ * 删除决策。仅 active 状态可删;superseded/partial 状态需先恢复或归档(避免丢失审计轨迹)。
+ */
+export function deleteDecision(paths, id) {
+    const d = findDecision(paths, id);
+    if (!d)
+        throw new Error(`Decision not found: ${id}`);
+    if (d.fm.status !== 'active') {
+        throw new Error(`Decision ${id} 是 ${d.fm.status} 状态,不能直接删除;` +
+            `如确需删除,先用 set-partial 标记或 supersede 取代`);
+    }
+    unlinkSync(d.filePath);
+}
+/**
+ * 编辑决策的 what/why/affectedCriteria。状态变更走 supersede / set-partial。
+ * superseded 状态的决策不可编辑（避免改历史）。
+ */
+export function updateDecision(input) {
+    const existing = findDecision(input.paths, input.id);
+    if (!existing)
+        throw new Error(`Decision not found: ${input.id}`);
+    if (existing.fm.status !== 'active') {
+        throw new Error(`不能编辑 ${existing.fm.status} 状态的决策(只能编辑 active);用 supersede / set-partial 推进`);
+    }
+    if (input.what === undefined && input.why === undefined && input.affectedCriteria === undefined) {
+        throw new Error('未提供任何可更新字段(what/why/affectedCriteria)');
+    }
+    if (input.what !== undefined && input.what.length > WHAT_MAX) {
+        throw new Error(`what 长度 ${input.what.length} > ${WHAT_MAX}`);
+    }
+    if (input.why !== undefined && input.why.length > WHY_MAX) {
+        throw new Error(`why 长度 ${input.why.length} > ${WHY_MAX}`);
+    }
+    const fm = {
+        ...existing.fm,
+        what: input.what ?? existing.fm.what,
+        why: input.why ?? existing.fm.why,
+        affectedCriteria: input.affectedCriteria ?? existing.fm.affectedCriteria,
+        updated: new Date().toISOString(),
+    };
+    const content = renderContent(fm);
+    writeFrontmatterAtomic(existing.filePath, fm, content);
+    return { id: existing.id, fm, content, filePath: existing.filePath };
+}
+/**
+ * 把决策标记为 partial(部分被取代/部分作废),需 --reason 解释。
+ * 区别于 supersede:partial 不指向新决策 ID,只标记"局部失效"。
+ */
+export function setDecisionPartial(input) {
+    const existing = findDecision(input.paths, input.id);
+    if (!existing)
+        throw new Error(`Decision not found: ${input.id}`);
+    if (existing.fm.status !== 'active') {
+        throw new Error(`Decision ${input.id} 已经是 ${existing.fm.status},无需重复标记`);
+    }
+    if (!input.reason.trim()) {
+        throw new Error('partial 必须提供 reason(说明哪些部分失效 / 为什么)');
+    }
+    const fm = {
+        ...existing.fm,
+        status: 'partial',
+        supersededById: null,
+        updated: new Date().toISOString(),
+    };
+    const content = renderContent(fm) + `\n## Partial 标记\n\n${input.reason}\n`;
+    writeFrontmatterAtomic(existing.filePath, fm, content);
+    return { id: existing.id, fm, content, filePath: existing.filePath };
+}
+//# sourceMappingURL=decision.js.map

package/dist/core/decision.js.map

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