@prd-improve/cli 1.0.0

package/dist/validators/duplicate-ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate-ids.js","sourceRoot":"","sources":["../../src/validators/duplicate-ids.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAA4B;IAC1C,CAAC,UAAU,EAAE,UAAU,CAAC;IACxB,CAAC,UAAU,EAAE,UAAU,CAAC;IACxB,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IACpC,CAAC,WAAW,EAAE,WAAW,CAAC;IAC1B,CAAC,YAAY,EAAE,YAAY,CAAC;IAC5B,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IACpC,CAAC,qBAAqB,EAAE,qBAAqB,CAAC;IAC9C,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;CACrC,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAClC,GAAY,EACZ,OAAe;IAEf,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAC/C,MAAM,IAAI,GAAG,GAA8B,CAAC;IAC5C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC,CAAC,uBAAuB;IAC/D,MAAM,MAAM,GAAsB,EAAE,CAAC;IAErC,SAAS,KAAK,CAAC,IAAS,EAAE,IAAY;QACpC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ;YAAE,OAAO;QACjD,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QACnB,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC;gBACV,QAAQ,EAAE,OAAO;gBACjB,IAAI,EAAE,cAAc;gBACpB,OAAO;gBACP,IAAI;gBACJ,OAAO,EAAE,EAAE,EAAE,EAAE,eAAe,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAE,EAAE;aAChD,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,UAAU,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;YAAE,SAAS;QAClC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,mBAAmB;IACnB,MAAM,GAAG,GAAG,IAAI,CAAC,YAAmD,CAAC;IACrE,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,IAAI,GAA4B;YACpC,CAAC,kBAAkB,EAAE,+BAA+B,CAAC;YACrD,CAAC,iBAAiB,EAAE,8BAA8B,CAAC;YACnD,CAAC,yBAAyB,EAAE,sCAAsC,CAAC;YACnE,CAAC,sBAAsB,EAAE,mCAAmC,CAAC;SAC9D,CAAC;QACF,KAAK,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;YAC9B,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;YACnB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;gBAAE,SAAS;YAClC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/validators/references.d.ts

@@ -0,0 +1,5 @@
+import type { ValidationIssue } from "../types.js";
+/** 已知 ID 前缀(硬编码,与 design § 5.2 对齐)。 */
+declare const KNOWN_ID_PREFIXES: readonly ["EN", "S", "R", "SC", "E", "UI", "AC", "Q", "DC", "API", "PC", "SEC"];
+export declare function validateReferences(obj: unknown, feature: string): ValidationIssue[];
+export { KNOWN_ID_PREFIXES };

package/dist/validators/references.js

@@ -0,0 +1,165 @@
+/** 已知 ID 前缀(硬编码,与 design § 5.2 对齐)。 */
+const KNOWN_ID_PREFIXES = [
+    "EN", "S", "R", "SC", "E", "UI", "AC", "Q", "DC", "API", "PC", "SEC",
+];
+/**
+ * 收集文件内所有 ID 及其前缀和定义路径。
+ */
+function collectIds(data) {
+    const ids = new Map();
+    const buckets = [
+        ["entities", "entities"],
+        ["in_scope", "in_scope"],
+        ["business_rules", "business_rules"],
+        ["scenarios", "scenarios"],
+        ["edge_cases", "edge_cases"],
+        ["ui_interaction", "ui_interaction"],
+        ["acceptance_criteria", "acceptance_criteria"],
+        ["open_questions", "open_questions"],
+    ];
+    for (const [key, label] of buckets) {
+        const arr = data[key];
+        if (!Array.isArray(arr))
+            continue;
+        arr.forEach((item, idx) => {
+            if (item && typeof item.id === "string") {
+                const prefix = item.id.split("-")[0];
+                ids.set(item.id, {
+                    id: item.id,
+                    prefix,
+                    path: `${label}[${idx}].id`,
+                });
+            }
+        });
+    }
+    // data_and_api 的 4 个子数组
+    const dao = data.data_and_api;
+    if (dao && typeof dao === "object") {
+        const subs = [
+            ["data_constraints", "data_and_api.data_constraints"],
+            ["api_constraints", "data_and_api.api_constraints"],
+            ["performance_constraints", "data_and_api.performance_constraints"],
+            ["security_constraints", "data_and_api.security_constraints"],
+        ];
+        for (const [k, label] of subs) {
+            const arr = dao[k];
+            if (!Array.isArray(arr))
+                continue;
+            arr.forEach((item, idx) => {
+                if (item && typeof item.id === "string") {
+                    const prefix = item.id.split("-")[0];
+                    ids.set(item.id, {
+                        id: item.id,
+                        prefix,
+                        path: `${label}[${idx}].id`,
+                    });
+                }
+            });
+        }
+    }
+    return ids;
+}
+function collectRefs(data) {
+    const refs = [];
+    // 强类型:state_permissions.entity_id → EN-
+    const sp = data.state_permissions;
+    if (Array.isArray(sp)) {
+        sp.forEach((item, i) => {
+            if (typeof item?.entity_id === "string") {
+                refs.push({
+                    path: `state_permissions[${i}].entity_id`,
+                    value: item.entity_id,
+                    expectedPrefix: "EN",
+                });
+            }
+        });
+    }
+    // 强类型:data_and_api 三类 applies_to → EN-
+    const dao = data.data_and_api;
+    const strongDao = [
+        ["data_constraints", "data_and_api.data_constraints"],
+        ["api_constraints", "data_and_api.api_constraints"],
+        ["security_constraints", "data_and_api.security_constraints"],
+    ];
+    if (dao) {
+        for (const [k, label] of strongDao) {
+            const arr = dao[k];
+            if (!Array.isArray(arr))
+                continue;
+            arr.forEach((item, i) => {
+                const at = item?.applies_to;
+                if (!Array.isArray(at))
+                    return;
+                at.forEach((v, j) => {
+                    refs.push({
+                        path: `${label}[${i}].applies_to[${j}]`,
+                        value: v,
+                        expectedPrefix: "EN",
+                    });
+                });
+            });
+        }
+    }
+    // 弱类型
+    const weakSources = [
+        ["business_rules", "business_rules", "applies_to"],
+        ["scenarios", "scenarios", "refers_to"],
+        ["acceptance_criteria", "acceptance_criteria", "refers_to"],
+    ];
+    for (const [key, label, field] of weakSources) {
+        const arr = data[key];
+        if (!Array.isArray(arr))
+            continue;
+        arr.forEach((item, i) => {
+            const refList = item?.[field];
+            if (!Array.isArray(refList))
+                return;
+            refList.forEach((v, j) => {
+                refs.push({
+                    path: `${label}[${i}].${field}[${j}]`,
+                    value: v,
+                });
+            });
+        });
+    }
+    return refs;
+}
+export function validateReferences(obj, feature) {
+    if (!obj || typeof obj !== "object")
+        return [];
+    const data = obj;
+    const ids = collectIds(data);
+    const refs = collectRefs(data);
+    const issues = [];
+    for (const ref of refs) {
+        if (!ids.has(ref.value)) {
+            issues.push({
+                severity: "error",
+                code: "reference_not_found",
+                feature,
+                path: ref.path,
+                details: { reference: ref.value, path: ref.path },
+            });
+            continue;
+        }
+        if (ref.expectedPrefix) {
+            const actualPrefix = ref.value.split("-")[0];
+            if (actualPrefix !== ref.expectedPrefix) {
+                issues.push({
+                    severity: "error",
+                    code: "reference_wrong_type",
+                    feature,
+                    path: ref.path,
+                    details: {
+                        value: ref.value,
+                        expected_prefix: ref.expectedPrefix,
+                        path: ref.path,
+                    },
+                });
+            }
+        }
+    }
+    return issues;
+}
+export { KNOWN_ID_PREFIXES };
+//# sourceMappingURL=references.js.map

package/dist/validators/references.js.map

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

package/dist/validators/required-modules.d.ts

@@ -0,0 +1,8 @@
+import type { ValidationIssue } from "../types.js";
+/**
+ * 校验 15 个业务模块的存在性 + 强制性。
+ * - meta / in_scope / acceptance_criteria 空 → error
+ * - 其余模块缺失 → error;为空 → 通过
+ * - out_of_scope 为空数组 → warning(不算 fail)
+ */
+export declare function validateRequiredModules(obj: unknown, feature: string): ValidationIssue[];

package/dist/validators/required-modules.js

@@ -0,0 +1,59 @@
+import { BUSINESS_MODULES } from "../types.js";
+/** 这 3 个模块空时算 fail。其余允许空。 */
+const MUST_BE_NON_EMPTY = ["meta", "in_scope", "acceptance_criteria"];
+/**
+ * 校验 15 个业务模块的存在性 + 强制性。
+ * - meta / in_scope / acceptance_criteria 空 → error
+ * - 其余模块缺失 → error;为空 → 通过
+ * - out_of_scope 为空数组 → warning(不算 fail)
+ */
+export function validateRequiredModules(obj, feature) {
+    const issues = [];
+    if (!obj || typeof obj !== "object")
+        return issues;
+    const data = obj;
+    for (const mod of BUSINESS_MODULES) {
+        const value = data[mod];
+        // 缺 key
+        if (value === undefined) {
+            issues.push({
+                severity: "error",
+                code: "missing_required_module",
+                feature,
+                path: mod,
+                details: { module: mod },
+            });
+            continue;
+        }
+        // 必填非空模块
+        if (MUST_BE_NON_EMPTY.includes(mod)) {
+            const empty = value === null ||
+                (Array.isArray(value) && value.length === 0) ||
+                (typeof value === "string" && value.trim() === "") ||
+                (typeof value === "object" &&
+                    !Array.isArray(value) &&
+                    Object.keys(value).length === 0);
+            if (empty) {
+                issues.push({
+                    severity: "error",
+                    code: "module_must_be_non_empty",
+                    feature,
+                    path: mod,
+                    details: { module: mod },
+                });
+            }
+        }
+        // out_of_scope 空 → warning
+        if (mod === "out_of_scope" && Array.isArray(value) && value.length === 0) {
+            issues.push({
+                severity: "warning",
+                code: "out_of_scope_empty_warning",
+                feature,
+                path: mod,
+                details: {},
+            });
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=required-modules.js.map

package/dist/validators/required-modules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"required-modules.js","sourceRoot":"","sources":["../../src/validators/required-modules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C,6BAA6B;AAC7B,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,qBAAqB,CAAU,CAAC;AAE/E;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,GAAY,EACZ,OAAe;IAEf,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IACnD,MAAM,IAAI,GAAG,GAA8B,CAAC;IAE5C,KAAK,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QAExB,QAAQ;QACR,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC;gBACV,QAAQ,EAAE,OAAO;gBACjB,IAAI,EAAE,yBAAyB;gBAC/B,OAAO;gBACP,IAAI,EAAE,GAAG;gBACT,OAAO,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE;aACzB,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,SAAS;QACT,IAAK,iBAAuC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3D,MAAM,KAAK,GACT,KAAK,KAAK,IAAI;gBACd,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;gBAC5C,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;gBAClD,CAAC,OAAO,KAAK,KAAK,QAAQ;oBACxB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;oBACrB,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC;YAC/C,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,IAAI,CAAC;oBACV,QAAQ,EAAE,OAAO;oBACjB,IAAI,EAAE,0BAA0B;oBAChC,OAAO;oBACP,IAAI,EAAE,GAAG;oBACT,OAAO,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE;iBACzB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,2BAA2B;QAC3B,IAAI,GAAG,KAAK,cAAc,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzE,MAAM,CAAC,IAAI,CAAC;gBACV,QAAQ,EAAE,SAAS;gBACnB,IAAI,EAAE,4BAA4B;gBAClC,OAAO;gBACP,IAAI,EAAE,GAAG;gBACT,OAAO,EAAE,EAAE;aACZ,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/validators/runner.d.ts

@@ -0,0 +1,11 @@
+import type { FeatureResult } from "../types.js";
+interface Ctx {
+    feature: string;
+    filePath: string;
+}
+/**
+ * 跑所有 validator,聚合 FeatureResult。
+ * obj 必须是 yaml.load 后的 raw object(可能任意结构)。
+ */
+export declare function runValidators(obj: unknown, ctx: Ctx): FeatureResult;
+export {};

package/dist/validators/runner.js

@@ -0,0 +1,73 @@
+import { PrdSchema } from "../schema/index.js";
+import { BUSINESS_MODULES } from "../types.js";
+import { validateRequiredModules } from "./required-modules.js";
+import { validateReferences } from "./references.js";
+import { validateDuplicateIds } from "./duplicate-ids.js";
+import { validateBlocking } from "./blocking.js";
+/**
+ * 跑所有 validator,聚合 FeatureResult。
+ * obj 必须是 yaml.load 后的 raw object(可能任意结构)。
+ */
+export function runValidators(obj, ctx) {
+    const issues = [];
+    const data = (obj && typeof obj === "object" ? obj : {});
+    // 1. schema_version 校验(零容忍)
+    const schemaVersion = typeof data.schema_version === "string" ? data.schema_version : "";
+    if (schemaVersion === "") {
+        issues.push({
+            severity: "error",
+            code: "missing_required_module",
+            feature: ctx.feature,
+            path: "schema_version",
+            details: { module: "schema_version" },
+        });
+    }
+    else if (schemaVersion !== "v0.1" && schemaVersion !== "v0.2") {
+        issues.push({
+            severity: "error",
+            code: "unsupported_schema_version",
+            feature: ctx.feature,
+            path: "schema_version",
+            details: { got: schemaVersion },
+        });
+    }
+    // 2. Zod schema 严格校验(strict 模式 + 类型)
+    const parseResult = PrdSchema.safeParse(obj);
+    if (!parseResult.success) {
+        for (const z of parseResult.error.issues) {
+            // 跳过我们已经在第 1 步处理过的 schema_version literal 错
+            if (z.path[0] === "schema_version" && z.code === "invalid_literal")
+                continue;
+            issues.push({
+                severity: "error",
+                code: "schema_violation",
+                feature: ctx.feature,
+                path: z.path.join("."),
+                details: { path: z.path.join("."), message: z.message },
+            });
+        }
+    }
+    // 3. 业务校验(独立于 Zod,即使 schema fail 也跑,提供更多反馈)
+    issues.push(...validateRequiredModules(data, ctx.feature));
+    issues.push(...validateReferences(data, ctx.feature));
+    issues.push(...validateDuplicateIds(data, ctx.feature));
+    issues.push(...validateBlocking(data, ctx.feature));
+    // 计算 modulesComplete:不算缺失/空必填的模块
+    const missing = new Set(issues
+        .filter((i) => (i.code === "missing_required_module" ||
+        i.code === "module_must_be_non_empty") &&
+        BUSINESS_MODULES.includes(i.path ?? ""))
+        .map((i) => i.path));
+    const modulesComplete = BUSINESS_MODULES.filter((m) => !missing.has(m)).length;
+    const hasError = issues.some((i) => i.severity === "error");
+    return {
+        feature: ctx.feature,
+        filePath: ctx.filePath,
+        status: hasError ? "fail" : "pass",
+        modulesComplete,
+        modulesTotal: BUSINESS_MODULES.length,
+        schemaVersion,
+        issues,
+    };
+}
+//# sourceMappingURL=runner.js.map

package/dist/validators/runner.js.map

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

package/dist/workspace.d.ts

@@ -0,0 +1,32 @@
+export declare const VERSION_REGEX: RegExp;
+export interface ManifestFeatureEntry {
+    slug: string;
+    latest_frozen_version: string;
+    frozen_at: string;
+}
+export interface Manifest {
+    schema_version: string;
+    workspace_name: string;
+    created_at: string;
+    cli_version: string;
+    features: ManifestFeatureEntry[];
+}
+interface ManifestRead {
+    ok: true;
+    data: Manifest;
+}
+interface ManifestFail {
+    ok: false;
+}
+/**
+ * 读取并基本验证 .prd/manifest.json。
+ * features 必须是数组;返回的 data 类型为 Manifest,元素结构由 ManifestFeatureEntry 保证。
+ */
+export declare function readManifest(manifestPath: string): ManifestRead | ManifestFail;
+/**
+ * 列已存在的合法版本目录(过滤非 vX.Y[.Z] 命名的目录)。
+ * 这里收敛了原 freeze 本地版"列所有目录"的行为 ——
+ * freeze 的 nextAutoVersion 内部仍会再过滤一次,所以收敛安全。
+ */
+export declare function listExistingVersions(frozenDir: string): string[];
+export {};

package/dist/workspace.js

@@ -0,0 +1,37 @@
+/**
+ * Workspace 共享 util:manifest 读取 + 版本号格式 + 已存在版本列表。
+ * 由 init / freeze / context / diff 共用,集中维护 Manifest 类型。
+ */
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+export const VERSION_REGEX = /^v\d+\.\d+(\.\d+)?$/;
+/**
+ * 读取并基本验证 .prd/manifest.json。
+ * features 必须是数组;返回的 data 类型为 Manifest,元素结构由 ManifestFeatureEntry 保证。
+ */
+export function readManifest(manifestPath) {
+    if (!existsSync(manifestPath))
+        return { ok: false };
+    try {
+        const data = JSON.parse(readFileSync(manifestPath, "utf8"));
+        if (!Array.isArray(data?.features))
+            return { ok: false };
+        return { ok: true, data: data };
+    }
+    catch {
+        return { ok: false };
+    }
+}
+/**
+ * 列已存在的合法版本目录(过滤非 vX.Y[.Z] 命名的目录)。
+ * 这里收敛了原 freeze 本地版"列所有目录"的行为 ——
+ * freeze 的 nextAutoVersion 内部仍会再过滤一次,所以收敛安全。
+ */
+export function listExistingVersions(frozenDir) {
+    if (!existsSync(frozenDir))
+        return [];
+    return readdirSync(frozenDir, { withFileTypes: true })
+        .filter((d) => d.isDirectory())
+        .map((d) => d.name)
+        .filter((v) => VERSION_REGEX.test(v));
+}
+//# sourceMappingURL=workspace.js.map

package/dist/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEhE,MAAM,CAAC,MAAM,aAAa,GAAG,qBAAqB,CAAC;AAwBnD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,YAAoB;IAC/C,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;IACpD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;QAC5D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QACzD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAgB,EAAE,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,EAAE,CAAC;IACtC,OAAO,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SACnD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAClB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1C,CAAC"}

package/dist/yaml-indexer.d.ts

@@ -0,0 +1,15 @@
+export interface IndexedEntry {
+    module: string;
+    id: string;
+    title?: string;
+    priority?: string;
+    line: number;
+    refersTo?: string[];
+}
+export interface IndexResult {
+    yamlLines: number;
+    schemaVersion: string;
+    entries: IndexedEntry[];
+    reverseRefs: Record<string, string[]>;
+}
+export declare function indexYaml(yamlText: string): IndexResult;

package/dist/yaml-indexer.js

@@ -0,0 +1,112 @@
+import { parseDocument, isMap, isSeq } from "yaml";
+// 10 of 15 BUSINESS_MODULES that hold flat item lists with id/refers_to-shape fields.
+// 不在此列的 5 个模块由其他路径处理:meta / background_and_goals / users_and_roles / main_flow
+// 是 object 或简单 list 不参与 refers_to;data_and_api 单独 flatten 4 子模块 in main 函数末尾。
+// 故意保持与 BUSINESS_MODULES 独立(不从其 filter)— 避免脆弱耦合,schema 演化时显式维护此名单。
+const MODULES = [
+    "in_scope",
+    "out_of_scope",
+    "entities",
+    "business_rules",
+    "scenarios",
+    "edge_cases",
+    "ui_interaction",
+    "acceptance_criteria",
+    "state_permissions",
+    "open_questions",
+];
+function offsetToLine(text, offset) {
+    return text.slice(0, offset).split("\n").length;
+}
+function getStringField(item, key) {
+    const v = item.get?.(key);
+    return typeof v === "string" ? v : undefined;
+}
+function displayId(module, item) {
+    if (module === "state_permissions") {
+        return `${item.get?.("entity_id") ?? "?"}-${item.get?.("state") ?? "?"}`;
+    }
+    if (module === "out_of_scope") {
+        const txt = getStringField(item, "item") ?? "";
+        return txt.length > 40 ? txt.slice(0, 40) + "…" : txt;
+    }
+    return (getStringField(item, "id") ??
+        getStringField(item, "name") ??
+        "(no id)");
+}
+function titleOf(module, item) {
+    if (module === "out_of_scope" || module === "state_permissions")
+        return undefined;
+    return (getStringField(item, "name") ??
+        getStringField(item, "title") ??
+        getStringField(item, "rule")?.slice(0, 40) ??
+        getStringField(item, "criterion")?.slice(0, 40) ??
+        getStringField(item, "question")?.slice(0, 40));
+}
+function priorityOf(item) {
+    return getStringField(item, "priority") ?? getStringField(item, "severity");
+}
+function refersToOf(item) {
+    const v = item.get?.("refers_to");
+    if (!v)
+        return undefined;
+    if (isSeq(v))
+        return v.items.map((x) => String(x.value ?? x));
+    if (typeof v === "string")
+        return [v];
+    return undefined;
+}
+/**
+ * 公共 helper:把一段 yaml seq(item 必须是 map)推入 entries 列表
+ * 消主模块循环 + data_and_api flatten 两处相同的 for-loop 重复
+ */
+function pushSeqEntries(seq, modName, yamlText, entries) {
+    if (!seq || !isSeq(seq))
+        return;
+    for (const item of seq.items) {
+        if (!isMap(item))
+            continue;
+        const range = item.range;
+        entries.push({
+            module: modName,
+            id: displayId(modName, item),
+            title: titleOf(modName, item),
+            priority: priorityOf(item),
+            line: range ? offsetToLine(yamlText, range[0]) : -1,
+            refersTo: refersToOf(item),
+        });
+    }
+}
+export function indexYaml(yamlText) {
+    const doc = parseDocument(yamlText, { keepSourceTokens: true });
+    const entries = [];
+    for (const mod of MODULES) {
+        pushSeqEntries(doc.get(mod), mod, yamlText, entries);
+    }
+    // data_and_api 子模块特殊处理:flatten DC/API/PC/SEC
+    const dap = doc.get("data_and_api");
+    if (dap && isMap(dap)) {
+        pushSeqEntries(dap.get("data_constraints"), "data_and_api.data_constraints", yamlText, entries);
+        pushSeqEntries(dap.get("api"), "data_and_api.api", yamlText, entries);
+        pushSeqEntries(dap.get("performance_constraints"), "data_and_api.performance_constraints", yamlText, entries);
+        pushSeqEntries(dap.get("security_constraints"), "data_and_api.security_constraints", yamlText, entries);
+    }
+    // 反向图:对 entries[i].refersTo 中的每个 X,把 entries[i].id 加到 reverseRefs[X]
+    const reverseRefs = {};
+    for (const e of entries) {
+        if (!e.refersTo)
+            continue;
+        for (const ref of e.refersTo) {
+            if (!reverseRefs[ref])
+                reverseRefs[ref] = [];
+            reverseRefs[ref].push(e.id);
+        }
+    }
+    return {
+        yamlLines: yamlText.split("\n").length,
+        schemaVersion: doc.get("schema_version") ?? "unknown",
+        entries,
+        reverseRefs,
+    };
+}
+//# sourceMappingURL=yaml-indexer.js.map

package/dist/yaml-indexer.js.map

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

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@prd-improve/cli",
+  "version": "1.0.0",
+  "description": "PRD Improve CLI - validate / freeze / context for .prd/features/*.yaml",
+  "license": "MIT",
+  "type": "module",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "bin": {
+    "prd": "./dist/cli.js"
+  },
+  "main": "./dist/cli.js",
+  "exports": {
+    ".": "./dist/cli.js",
+    "./schema": "./dist/schema/index.js",
+    "./diff/engine": "./dist/diff/engine.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "js-yaml": "^4.1.0",
+    "yaml": "^2.9.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.14.0",
+    "tsx": "^4.16.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0",
+    "@prd-improve/server": "0.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p .",
+    "dev": "tsx src/cli.ts",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest",
+    "test:update": "vitest run -u --passWithNoTests",
+    "typecheck": "tsc --noEmit"
+  }
+}