@prd-improve/cli 1.0.0

package/dist/diff/engine.js

@@ -0,0 +1,305 @@
+/**
+ * Pure function:把两份 PRD yaml AST 对比成结构化 DiffResult。
+ * 不读不写,可独立单测。
+ *
+ * 18 个 diffable 单元 = 14 个普通模块 + data_and_api 的 4 子组(DC/API/PC/SEC)。
+ * Summary 的 unchanged_modules 用 15 模块(parent)计数。
+ */
+// ---------- helpers ----------
+function isEmpty(v) {
+    if (v === null || v === undefined)
+        return true;
+    if (typeof v === "string" && v === "")
+        return true;
+    if (Array.isArray(v) && v.length === 0)
+        return true;
+    return false;
+}
+function valueEqual(a, b) {
+    if (isEmpty(a) && isEmpty(b))
+        return true;
+    if (Array.isArray(a) && Array.isArray(b)) {
+        if (a.length !== b.length)
+            return false;
+        return a.every((v, i) => valueEqual(v, b[i]));
+    }
+    if (typeof a === "object" &&
+        a !== null &&
+        typeof b === "object" &&
+        b !== null) {
+        const ak = Object.keys(a).filter((k) => !isEmpty(a[k]));
+        const bk = Object.keys(b).filter((k) => !isEmpty(b[k]));
+        if (ak.length !== bk.length)
+            return false;
+        return ak.every((k) => valueEqual(a[k], b[k]));
+    }
+    return a === b;
+}
+function isMultiline(v) {
+    if (typeof v !== "string")
+        return false;
+    if (v.includes("\n"))
+        return true;
+    if (v.length > 80)
+        return true;
+    return false;
+}
+function objectFieldChanges(before, after, fieldList) {
+    const changes = [];
+    for (const f of fieldList) {
+        const bv = before?.[f];
+        const av = after?.[f];
+        if (!valueEqual(bv, av)) {
+            changes.push({
+                field: f,
+                before: bv ?? null,
+                after: av ?? null,
+                is_multiline: isMultiline(bv) || isMultiline(av),
+            });
+        }
+    }
+    return changes;
+}
+function diffList(leftArr, rightArr, opts) {
+    const left = Array.isArray(leftArr) ? leftArr : [];
+    const right = Array.isArray(rightArr) ? rightArr : [];
+    const leftMap = new Map();
+    for (const item of left) {
+        const k = opts.primaryKeyOf(item);
+        if (k)
+            leftMap.set(k, item);
+    }
+    const rightMap = new Map();
+    for (const item of right) {
+        const k = opts.primaryKeyOf(item);
+        if (k)
+            rightMap.set(k, item);
+    }
+    const added = [];
+    const modified = [];
+    const removed = [];
+    for (const [k, rItem] of rightMap) {
+        if (!leftMap.has(k)) {
+            added.push({
+                primary_key: k,
+                display_label: opts.displayLabelOf?.(rItem),
+            });
+        }
+        else {
+            const lItem = leftMap.get(k);
+            const fc = objectFieldChanges(lItem, rItem, opts.fieldList);
+            if (fc.length > 0) {
+                modified.push({
+                    primary_key: k,
+                    display_label: opts.displayLabelOf?.(rItem),
+                    field_changes: fc,
+                });
+            }
+        }
+    }
+    for (const [k, lItem] of leftMap) {
+        if (!rightMap.has(k)) {
+            removed.push({
+                primary_key: k,
+                display_label: opts.displayLabelOf?.(lItem),
+            });
+        }
+    }
+    return {
+        module_key: opts.module_key,
+        module_label: opts.module_label,
+        added,
+        modified,
+        removed,
+    };
+}
+function diffObjectModule(left, right, module_key, module_label, fieldList) {
+    const fc = objectFieldChanges(left ?? {}, right ?? {}, fieldList);
+    const modified = fc.length > 0
+        ? [{ primary_key: module_key, field_changes: fc }]
+        : [];
+    return {
+        module_key,
+        module_label,
+        added: [],
+        modified,
+        removed: [],
+    };
+}
+// ---------- 模块字段定义表 ----------
+const META_FIELDS = [
+    "project",
+    "feature",
+    "title",
+    "summary",
+    "owner",
+    "tags",
+    "created_at",
+    "source_materials",
+    "lifecycle",
+];
+const BG_FIELDS = ["background", "goals"];
+const ENTITY_FIELDS = ["name", "description", "fields", "relations", "lifecycle_states"];
+const IN_SCOPE_FIELDS = ["name", "summary"];
+const OOS_FIELDS = ["reason"];
+const FLOW_FIELDS = ["actor", "trigger", "action", "outcome"];
+const SP_FIELDS = ["allowed_actions", "notes"];
+const RULE_FIELDS = ["rule", "rationale", "applies_to"];
+const SCENARIO_FIELDS = ["condition", "expected_behavior", "input", "output", "refers_to"];
+const EDGE_FIELDS = ["situation", "expected_behavior", "mitigation"];
+const UI_FIELDS = [
+    "page",
+    "purpose",
+    "key_elements",
+    "user_actions",
+    "empty_state",
+    "loading_state",
+    "error_state",
+];
+const CONSTRAINT_FIELDS = ["text", "applies_to"];
+const AC_FIELDS = ["criterion", "priority", "verification_method", "refers_to"];
+const Q_FIELDS = ["question", "severity", "deferred_to", "owner", "due_date"];
+const ROLE_FIELDS = ["description", "typical_goals"];
+// ---------- 主入口 ----------
+export function diffPRDs(left, right) {
+    const perModule = {};
+    perModule.meta = diffObjectModule(left?.meta, right?.meta, "meta", "版本信息", META_FIELDS);
+    perModule.background_and_goals = diffObjectModule(left?.background_and_goals, right?.background_and_goals, "background_and_goals", "背景与目标", BG_FIELDS);
+    perModule.users_and_roles = diffList(left?.users_and_roles, right?.users_and_roles, {
+        module_key: "users_and_roles",
+        module_label: "用户与角色",
+        primaryKeyOf: (u) => (typeof u?.role === "string" ? u.role : ""),
+        fieldList: ROLE_FIELDS,
+    });
+    perModule.in_scope = diffList(left?.in_scope, right?.in_scope, {
+        module_key: "in_scope",
+        module_label: "本期范围",
+        primaryKeyOf: (s) => (typeof s?.id === "string" ? s.id : ""),
+        displayLabelOf: (s) => s?.name,
+        fieldList: IN_SCOPE_FIELDS,
+    });
+    perModule.out_of_scope = diffList(left?.out_of_scope, right?.out_of_scope, {
+        module_key: "out_of_scope",
+        module_label: "明确不做",
+        primaryKeyOf: (o) => (typeof o?.item === "string" ? o.item : ""),
+        fieldList: OOS_FIELDS,
+    });
+    perModule.entities = diffList(left?.entities, right?.entities, {
+        module_key: "entities",
+        module_label: "核心实体",
+        primaryKeyOf: (e) => (typeof e?.id === "string" ? e.id : ""),
+        displayLabelOf: (e) => e?.name,
+        fieldList: ENTITY_FIELDS,
+    });
+    perModule.main_flow = diffList(left?.main_flow, right?.main_flow, {
+        module_key: "main_flow",
+        module_label: "主流程",
+        primaryKeyOf: (s) => (typeof s?.step === "number" ? `step-${s.step}` : ""),
+        fieldList: FLOW_FIELDS,
+    });
+    perModule.state_permissions = diffList(left?.state_permissions, right?.state_permissions, {
+        module_key: "state_permissions",
+        module_label: "状态与操作权限",
+        primaryKeyOf: (sp) => typeof sp?.entity_id === "string" && typeof sp?.state === "string"
+            ? `${sp.entity_id} · ${sp.state}`
+            : "",
+        fieldList: SP_FIELDS,
+    });
+    perModule.business_rules = diffList(left?.business_rules, right?.business_rules, {
+        module_key: "business_rules",
+        module_label: "业务规则",
+        primaryKeyOf: (r) => (typeof r?.id === "string" ? r.id : ""),
+        fieldList: RULE_FIELDS,
+    });
+    perModule.scenarios = diffList(left?.scenarios, right?.scenarios, {
+        module_key: "scenarios",
+        module_label: "场景矩阵",
+        primaryKeyOf: (s) => (typeof s?.id === "string" ? s.id : ""),
+        fieldList: SCENARIO_FIELDS,
+    });
+    perModule.edge_cases = diffList(left?.edge_cases, right?.edge_cases, {
+        module_key: "edge_cases",
+        module_label: "异常与边界",
+        primaryKeyOf: (e) => (typeof e?.id === "string" ? e.id : ""),
+        displayLabelOf: (e) => e?.situation,
+        fieldList: EDGE_FIELDS,
+    });
+    perModule.ui_interaction = diffList(left?.ui_interaction, right?.ui_interaction, {
+        module_key: "ui_interaction",
+        module_label: "页面与交互",
+        primaryKeyOf: (u) => (typeof u?.id === "string" ? u.id : ""),
+        displayLabelOf: (u) => u?.page,
+        fieldList: UI_FIELDS,
+    });
+    // data_and_api: 4 subgroups merged into one ModuleDiff
+    const dArr = [
+        diffList(left?.data_and_api?.data_constraints, right?.data_and_api?.data_constraints, {
+            module_key: "data_and_api",
+            module_label: "数据与接口约束",
+            primaryKeyOf: (c) => (typeof c?.id === "string" ? c.id : ""),
+            fieldList: CONSTRAINT_FIELDS,
+        }),
+        diffList(left?.data_and_api?.api_constraints, right?.data_and_api?.api_constraints, {
+            module_key: "data_and_api",
+            module_label: "数据与接口约束",
+            primaryKeyOf: (c) => (typeof c?.id === "string" ? c.id : ""),
+            fieldList: CONSTRAINT_FIELDS,
+        }),
+        diffList(left?.data_and_api?.performance_constraints, right?.data_and_api?.performance_constraints, {
+            module_key: "data_and_api",
+            module_label: "数据与接口约束",
+            primaryKeyOf: (c) => (typeof c?.id === "string" ? c.id : ""),
+            fieldList: CONSTRAINT_FIELDS,
+        }),
+        diffList(left?.data_and_api?.security_constraints, right?.data_and_api?.security_constraints, {
+            module_key: "data_and_api",
+            module_label: "数据与接口约束",
+            primaryKeyOf: (c) => (typeof c?.id === "string" ? c.id : ""),
+            fieldList: CONSTRAINT_FIELDS,
+        }),
+    ];
+    perModule.data_and_api = {
+        module_key: "data_and_api",
+        module_label: "数据与接口约束",
+        added: dArr.flatMap((m) => m.added),
+        modified: dArr.flatMap((m) => m.modified),
+        removed: dArr.flatMap((m) => m.removed),
+    };
+    perModule.acceptance_criteria = diffList(left?.acceptance_criteria, right?.acceptance_criteria, {
+        module_key: "acceptance_criteria",
+        module_label: "验收标准",
+        primaryKeyOf: (a) => (typeof a?.id === "string" ? a.id : ""),
+        displayLabelOf: (a) => a?.criterion,
+        fieldList: AC_FIELDS,
+    });
+    perModule.open_questions = diffList(left?.open_questions, right?.open_questions, {
+        module_key: "open_questions",
+        module_label: "待确认问题",
+        primaryKeyOf: (q) => (typeof q?.id === "string" ? q.id : ""),
+        displayLabelOf: (q) => q?.question,
+        fieldList: Q_FIELDS,
+    });
+    // totals
+    let added = 0;
+    let modified = 0;
+    let removed = 0;
+    let changed_module_count = 0;
+    for (const md of Object.values(perModule)) {
+        added += md.added.length;
+        modified += md.modified.length;
+        removed += md.removed.length;
+        if (md.added.length + md.modified.length + md.removed.length > 0) {
+            changed_module_count++;
+        }
+    }
+    return {
+        perModule,
+        totals: {
+            added,
+            modified,
+            removed,
+            unchanged_modules: 15 - changed_module_count,
+        },
+    };
+}
+//# sourceMappingURL=engine.js.map

package/dist/diff/engine.js.map

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

package/dist/diff/render.d.ts

@@ -0,0 +1,18 @@
+import type { DiffResult } from "./engine.js";
+import { type Locale } from "../i18n/index.js";
+export interface DiffMeta {
+    feature: string;
+    from: {
+        ref: string;
+        frozen_at?: string;
+    };
+    to: {
+        ref: string;
+        frozen_at?: string;
+    };
+}
+export interface RenderOptions {
+    color: boolean;
+    locale: Locale;
+}
+export declare function renderDiff(result: DiffResult, meta: DiffMeta, opts: RenderOptions): string;

package/dist/diff/render.js

@@ -0,0 +1,129 @@
+/**
+ * Pure function:把 DiffResult 渲染成 plain text(可选 ANSI 上色)。
+ * 不读不写,可独立单测。
+ */
+import { Chalk } from "chalk";
+import { getMessages } from "../i18n/index.js";
+const MODULE_ORDER = [
+    "meta",
+    "background_and_goals",
+    "users_and_roles",
+    "in_scope",
+    "out_of_scope",
+    "entities",
+    "main_flow",
+    "state_permissions",
+    "business_rules",
+    "scenarios",
+    "edge_cases",
+    "ui_interaction",
+    "data_and_api",
+    "acceptance_criteria",
+    "open_questions",
+];
+// Forced-color chalk instance (level 3 = truecolor); used when color=true
+const colorChalk = new Chalk({ level: 3 });
+function refLabel(r) {
+    if (r.ref === "working")
+        return "working";
+    if (r.frozen_at)
+        return `${r.ref} (frozen ${r.frozen_at.slice(0, 10)})`;
+    return r.ref;
+}
+function colorize(s, fn, on) {
+    return on ? fn(s) : s;
+}
+function stringifyValue(v) {
+    if (v === null || v === undefined)
+        return "(空)";
+    if (Array.isArray(v))
+        return "[" + v.map((x) => String(x)).join(", ") + "]";
+    if (typeof v === "object")
+        return JSON.stringify(v);
+    return String(v);
+}
+function renderFieldChange(fc, beforeLabel, afterLabel, color) {
+    if (!fc.is_multiline) {
+        const before = colorize(stringifyValue(fc.before), colorChalk.red.bind(colorChalk), color);
+        const after = colorize(stringifyValue(fc.after), colorChalk.green.bind(colorChalk), color);
+        return `  - ${fc.field}: ${before} → ${after}`;
+    }
+    const before = stringifyValue(fc.before);
+    const after = stringifyValue(fc.after);
+    return [
+        `  - ${fc.field}:`,
+        `      ${beforeLabel}:${colorize(before, colorChalk.red.bind(colorChalk), color)}`,
+        `      ${afterLabel}:${colorize(after, colorChalk.green.bind(colorChalk), color)}`,
+    ].join("\n");
+}
+export function renderDiff(result, meta, opts) {
+    const m = getMessages(opts.locale);
+    const lines = [];
+    lines.push(m.diff_header({ from: refLabel(meta.from), to: refLabel(meta.to) }));
+    lines.push(m.diff_summary({
+        added: result.totals.added,
+        modified: result.totals.modified,
+        removed: result.totals.removed,
+        unchanged: result.totals.unchanged_modules,
+    }));
+    lines.push("");
+    if (result.totals.added === 0 &&
+        result.totals.modified === 0 &&
+        result.totals.removed === 0) {
+        lines.push(m.diff_no_changes);
+        return lines.join("\n") + "\n";
+    }
+    if (result.totals.added > 0) {
+        lines.push(colorize(m.diff_section_added({ count: result.totals.added }), colorChalk.green.bind(colorChalk), opts.color));
+        for (const key of MODULE_ORDER) {
+            const md = result.perModule[key];
+            if (!md)
+                continue;
+            const sorted = [...md.added].sort((a, b) => a.primary_key.localeCompare(b.primary_key));
+            for (const item of sorted) {
+                const head = `[+] ${md.module_label} · ${item.primary_key}`;
+                const labeled = item.display_label && item.display_label !== item.primary_key
+                    ? `${head} — ${item.display_label}`
+                    : head;
+                lines.push(colorize(labeled, colorChalk.green.bind(colorChalk), opts.color));
+            }
+        }
+        lines.push("");
+    }
+    if (result.totals.modified > 0) {
+        lines.push(colorize(m.diff_section_modified({ count: result.totals.modified }), colorChalk.yellow.bind(colorChalk), opts.color));
+        for (const key of MODULE_ORDER) {
+            const md = result.perModule[key];
+            if (!md)
+                continue;
+            const sorted = [...md.modified].sort((a, b) => a.primary_key.localeCompare(b.primary_key));
+            for (const item of sorted) {
+                const head = `[~] ${md.module_label}${item.primary_key !== md.module_key ? ` · ${item.primary_key}` : ""}`;
+                lines.push(colorize(head, colorChalk.yellow.bind(colorChalk), opts.color));
+                for (const fc of item.field_changes ?? []) {
+                    lines.push(renderFieldChange(fc, m.diff_before_label, m.diff_after_label, opts.color));
+                }
+                lines.push("");
+            }
+        }
+    }
+    if (result.totals.removed > 0) {
+        lines.push(colorize(m.diff_section_removed({ count: result.totals.removed }), colorChalk.red.bind(colorChalk), opts.color));
+        for (const key of MODULE_ORDER) {
+            const md = result.perModule[key];
+            if (!md)
+                continue;
+            const sorted = [...md.removed].sort((a, b) => a.primary_key.localeCompare(b.primary_key));
+            for (const item of sorted) {
+                const head = `[-] ${md.module_label} · ${item.primary_key}`;
+                const labeled = item.display_label && item.display_label !== item.primary_key
+                    ? `${head} — ${item.display_label}`
+                    : head;
+                lines.push(colorize(labeled, colorChalk.red.bind(colorChalk), opts.color));
+            }
+        }
+        lines.push("");
+    }
+    return lines.join("\n").trimEnd() + "\n";
+}
+//# sourceMappingURL=render.js.map

package/dist/diff/render.js.map

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

package/dist/formatter/colors.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 是否启用颜色:
+ * - NO_COLOR=1 → 禁用
+ * - 非 TTY → 禁用
+ * - 否则启用
+ */
+export declare function colorEnabled(): boolean;
+export declare function pass(s: string): string;
+export declare function fail(s: string): string;
+export declare function skip(s: string): string;
+/**
+ * Semantic alias for `skip` — yellow text used to flag warnings (e.g. sync
+ * drift, backend unreachable) that don't change exit code. Aliased rather
+ * than duplicated so the existing "[SKIP] = yellow" convention stays intact.
+ */
+export declare function warn(s: string): string;
+export declare function dim(s: string): string;

package/dist/formatter/colors.js

@@ -0,0 +1,35 @@
+import chalk from "chalk";
+/**
+ * 是否启用颜色:
+ * - NO_COLOR=1 → 禁用
+ * - 非 TTY → 禁用
+ * - 否则启用
+ */
+export function colorEnabled() {
+    if (process.env.NO_COLOR)
+        return false;
+    if (!process.stdout.isTTY)
+        return false;
+    return true;
+}
+export function pass(s) {
+    return colorEnabled() ? chalk.green(s) : s;
+}
+export function fail(s) {
+    return colorEnabled() ? chalk.red(s) : s;
+}
+export function skip(s) {
+    return colorEnabled() ? chalk.yellow(s) : s;
+}
+/**
+ * Semantic alias for `skip` — yellow text used to flag warnings (e.g. sync
+ * drift, backend unreachable) that don't change exit code. Aliased rather
+ * than duplicated so the existing "[SKIP] = yellow" convention stays intact.
+ */
+export function warn(s) {
+    return colorEnabled() ? chalk.yellow(s) : s;
+}
+export function dim(s) {
+    return colorEnabled() ? chalk.dim(s) : s;
+}
+//# sourceMappingURL=colors.js.map

package/dist/formatter/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../src/formatter/colors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;;;GAKG;AACH,MAAM,UAAU,YAAY;IAC1B,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IACvC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,CAAS;IAC5B,OAAO,YAAY,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,CAAS;IAC5B,OAAO,YAAY,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,CAAS;IAC5B,OAAO,YAAY,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAAC,CAAS;IAC5B,OAAO,YAAY,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,CAAS;IAC3B,OAAO,YAAY,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3C,CAAC"}

package/dist/formatter/human.d.ts

@@ -0,0 +1,7 @@
+import { type Locale } from "../i18n/index.js";
+import type { ValidationResult } from "../types.js";
+interface FormatOptions {
+    pattern: string;
+}
+export declare function formatHuman(result: ValidationResult, locale: Locale, opts: FormatOptions): string;
+export {};

package/dist/formatter/human.js

@@ -0,0 +1,70 @@
+import { getMessages } from "../i18n/index.js";
+import * as c from "./colors.js";
+export function formatHuman(result, locale, opts) {
+    const m = getMessages(locale);
+    const lines = [];
+    // header
+    lines.push(m.validating({ pattern: opts.pattern }));
+    lines.push("");
+    for (const r of result.results) {
+        lines.push(...renderFeature(r, m));
+        lines.push("");
+    }
+    lines.push(m.summary_line({
+        passed: result.summary.passed,
+        failed: result.summary.failed,
+        skipped: result.summary.skipped,
+    }));
+    lines.push(m.exit_code_line({ code: result.exitCode }));
+    return lines.join("\n");
+}
+function renderIssueText(issue, m) {
+    // Dynamic lookup by issue code — escape hatch for string-keyed dispatch
+    const renderer = m[issue.code];
+    if (typeof renderer === "function")
+        return renderer(issue.details);
+    if (typeof renderer === "string")
+        return renderer;
+    return `[${issue.code}] ${JSON.stringify(issue.details)}`;
+}
+function renderFeature(r, m) {
+    const lines = [];
+    const warnings = r.issues.filter((i) => i.severity === "warning");
+    if (r.status === "pass") {
+        lines.push(`${c.pass(m.status_pass)} ${r.feature}`);
+        lines.push("       " +
+            m.feature_pass_summary({
+                complete: r.modulesComplete,
+                total: r.modulesTotal,
+                schema_version: r.schemaVersion || "?",
+            }));
+        for (const w of warnings) {
+            lines.push("       ! " + renderIssueText(w, m));
+        }
+        return lines;
+    }
+    if (r.status === "skip") {
+        lines.push(`${c.skip(m.status_skip)} ${r.feature}`);
+        lines.push("       " + m.feature_skip_reason_no_yaml);
+        return lines;
+    }
+    // fail
+    const refs = r.issues.filter((i) => i.code === "reference_not_found" || i.code === "reference_wrong_type").length;
+    const blocks = r.issues.filter((i) => i.code === "blocking_question").length;
+    lines.push(`${c.fail(m.status_fail)} ${r.feature}`);
+    lines.push("       " +
+        m.feature_fail_summary({
+            complete: r.modulesComplete,
+            total: r.modulesTotal,
+            refs,
+            blocks,
+        }));
+    for (const issue of r.issues) {
+        if (issue.severity === "info")
+            continue;
+        const prefix = issue.severity === "warning" ? "! " : "- ";
+        lines.push("       " + prefix + renderIssueText(issue, m));
+    }
+    return lines;
+}
+//# sourceMappingURL=human.js.map

package/dist/formatter/human.js.map

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

package/dist/fs/atomicWrite.d.ts

@@ -0,0 +1,7 @@
+export interface AtomicWriteOptions {
+    /** Posix permission mode applied via chmod after write. Optional. */
+    mode?: number;
+    /** Text encoding. Defaults to utf8. */
+    encoding?: BufferEncoding;
+}
+export declare function writeFileAtomic(path: string, data: string, opts?: AtomicWriteOptions): void;