@prd-improve/cli 1.0.0

package/dist/commands/diff.js

@@ -0,0 +1,208 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { load as yamlLoad } from "js-yaml";
+import { getMessages, readLocale } from "../i18n/index.js";
+import { renderError } from "../i18n/dispatch.js";
+import * as c from "../formatter/colors.js";
+import { VERSION_REGEX, readManifest, listExistingVersions, } from "../workspace.js";
+import { diffPRDs } from "../diff/engine.js";
+import { renderDiff } from "../diff/render.js";
+import { asyncHeadProbe } from "../sync/headProbe.js";
+function parseRef(s) {
+    if (s === "working")
+        return { kind: "working" };
+    if (VERSION_REGEX.test(s))
+        return { kind: "frozen", version: s };
+    return null;
+}
+function readSnapshotFrozenAt(snapshotPath) {
+    if (!existsSync(snapshotPath))
+        return undefined;
+    try {
+        const data = JSON.parse(readFileSync(snapshotPath, "utf8"));
+        return typeof data.frozen_at === "string" ? data.frozen_at : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function resolveRef(refStr, isFromSide, slug, cwd, manifest) {
+    const featureDir = join(cwd, ".prd/features", slug);
+    if (!refStr) {
+        if (isFromSide) {
+            const featureEntry = manifest.features.find((f) => f.slug === slug);
+            if (!featureEntry || !featureEntry.latest_frozen_version) {
+                return {
+                    ok: false,
+                    fail: {
+                        errorKey: "diff_feature_not_frozen_default",
+                        details: { slug },
+                        exitCode: 1,
+                    },
+                };
+            }
+            const version = featureEntry.latest_frozen_version;
+            const path = join(featureDir, "frozen", version, "prd.yaml");
+            if (!existsSync(path)) {
+                return {
+                    ok: false,
+                    fail: {
+                        errorKey: "diff_manifest_disk_mismatch",
+                        details: { slug, version },
+                        exitCode: 2,
+                    },
+                };
+            }
+            return {
+                ok: true,
+                src: {
+                    path,
+                    refLabel: version,
+                    frozenAt: readSnapshotFrozenAt(join(featureDir, "frozen", version, "snapshot.json")),
+                },
+            };
+        }
+        const path = join(featureDir, "working/prd.yaml");
+        if (!existsSync(path)) {
+            return {
+                ok: false,
+                fail: {
+                    errorKey: "diff_working_not_found",
+                    details: { slug },
+                    exitCode: 1,
+                },
+            };
+        }
+        return { ok: true, src: { path, refLabel: "working" } };
+    }
+    const parsed = parseRef(refStr);
+    if (!parsed) {
+        return {
+            ok: false,
+            fail: {
+                errorKey: "diff_invalid_ref",
+                details: { value: refStr },
+                exitCode: 1,
+            },
+        };
+    }
+    if (parsed.kind === "working") {
+        const path = join(featureDir, "working/prd.yaml");
+        if (!existsSync(path)) {
+            return {
+                ok: false,
+                fail: {
+                    errorKey: "diff_working_not_found",
+                    details: { slug },
+                    exitCode: 1,
+                },
+            };
+        }
+        return { ok: true, src: { path, refLabel: "working" } };
+    }
+    const versionDir = join(featureDir, "frozen", parsed.version);
+    const path = join(versionDir, "prd.yaml");
+    if (!existsSync(path)) {
+        const existing = listExistingVersions(join(featureDir, "frozen"));
+        return {
+            ok: false,
+            fail: {
+                errorKey: "diff_version_not_found",
+                details: {
+                    version: parsed.version,
+                    existing: existing.length === 0 ? "(无)" : existing.join(", "),
+                },
+                exitCode: 1,
+            },
+        };
+    }
+    return {
+        ok: true,
+        src: {
+            path,
+            refLabel: parsed.version,
+            frozenAt: readSnapshotFrozenAt(join(versionDir, "snapshot.json")),
+        },
+    };
+}
+function loadYamlOrFail(path) {
+    let text;
+    try {
+        text = readFileSync(path, "utf8");
+    }
+    catch (e) {
+        return {
+            ok: false,
+            errorKey: "diff_fs_error",
+            details: { operation: `read ${path}`, message: e.message },
+            exitCode: 2,
+        };
+    }
+    try {
+        return { ok: true, data: yamlLoad(text) };
+    }
+    catch (e) {
+        return {
+            ok: false,
+            errorKey: "diff_yaml_parse_error",
+            details: { path, message: e.message },
+            exitCode: 2,
+        };
+    }
+}
+export function runDiffCommand(opts, cwd) {
+    const locale = readLocale();
+    const m = getMessages(locale);
+    if (!opts.feature) {
+        process.stderr.write(c.fail("✗ ") + m.diff_feature_required + "\n");
+        return 1;
+    }
+    // T6: HEAD probe (fire-and-forget; design §6.10).
+    void asyncHeadProbe(opts.feature, cwd);
+    const manifestPath = join(cwd, ".prd/manifest.json");
+    const manifestRead = readManifest(manifestPath);
+    if (!manifestRead.ok) {
+        process.stderr.write(c.fail("✗ ") + m.diff_workspace_not_init + "\n");
+        return 1;
+    }
+    const fromR = resolveRef(opts.from, true, opts.feature, cwd, manifestRead.data);
+    if (!fromR.ok) {
+        process.stderr.write(c.fail("✗ ") +
+            renderError(m, fromR.fail.errorKey, fromR.fail.details ?? {}) +
+            "\n");
+        return fromR.fail.exitCode;
+    }
+    const toR = resolveRef(opts.to, false, opts.feature, cwd, manifestRead.data);
+    if (!toR.ok) {
+        process.stderr.write(c.fail("✗ ") +
+            renderError(m, toR.fail.errorKey, toR.fail.details ?? {}) +
+            "\n");
+        return toR.fail.exitCode;
+    }
+    const leftLoad = loadYamlOrFail(fromR.src.path);
+    if (!leftLoad.ok) {
+        process.stderr.write(c.fail("✗ ") +
+            renderError(m, leftLoad.errorKey, leftLoad.details) +
+            "\n");
+        return leftLoad.exitCode;
+    }
+    const rightLoad = loadYamlOrFail(toR.src.path);
+    if (!rightLoad.ok) {
+        process.stderr.write(c.fail("✗ ") +
+            renderError(m, rightLoad.errorKey, rightLoad.details) +
+            "\n");
+        return rightLoad.exitCode;
+    }
+    const result = diffPRDs(leftLoad.data, rightLoad.data);
+    const text = renderDiff(result, {
+        feature: opts.feature,
+        from: { ref: fromR.src.refLabel, frozen_at: fromR.src.frozenAt },
+        to: { ref: toR.src.refLabel, frozen_at: toR.src.frozenAt },
+    }, {
+        color: c.colorEnabled(),
+        locale,
+    });
+    process.stdout.write(text);
+    return 0;
+}
+//# sourceMappingURL=diff.js.map

package/dist/commands/diff.js.map

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

package/dist/commands/freeze.d.ts

@@ -0,0 +1,10 @@
+export interface FreezeOptions {
+    feature?: string;
+    version?: string;
+    auto?: boolean;
+}
+export declare function nextAutoVersion(existing: string[]): string;
+/**
+ * freeze 命令主逻辑。返回退出码,由调用方负责 process.exit。
+ */
+export declare function runFreezeCommand(opts: FreezeOptions, cwd: string): number;

package/dist/commands/freeze.js

@@ -0,0 +1,269 @@
+import { copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync, } from "node:fs";
+import { join } from "node:path";
+import { createHash } from "node:crypto";
+import { getMessages, readLocale } from "../i18n/index.js";
+import { renderError } from "../i18n/dispatch.js";
+import * as c from "../formatter/colors.js";
+import { runValidateCommand } from "./validate.js";
+import { promoteUnreleasedSection } from "../changelog.js";
+import { VERSION_REGEX, readManifest, listExistingVersions, } from "../workspace.js";
+import { asyncHeadProbe } from "../sync/headProbe.js";
+function resolveVersion(opts, existingVersions) {
+    const hasVersion = typeof opts.version === "string" && opts.version !== "";
+    const hasAuto = opts.auto === true;
+    if (hasVersion && hasAuto) {
+        return { ok: false, errorKey: "freeze_version_auto_conflict" };
+    }
+    if (!hasVersion && !hasAuto) {
+        return { ok: false, errorKey: "freeze_version_or_auto_required" };
+    }
+    if (hasVersion) {
+        if (!VERSION_REGEX.test(opts.version)) {
+            return {
+                ok: false,
+                errorKey: "freeze_invalid_version",
+                details: { value: opts.version },
+            };
+        }
+        return { ok: true, version: opts.version };
+    }
+    // --auto
+    return { ok: true, version: nextAutoVersion(existingVersions) };
+}
+/**
+ * 数值比较(忽略段数差异:v1.0 == v1.0.0)。当语义等价时返回 0;
+ * 调用方对此 case 的稳定性依赖 V8 stable sort + readdirSync 顺序,接受非确定性(spec 4.x)。
+ */
+function versionCompare(a, b) {
+    const segs = (s) => s.slice(1).split(".").map(Number);
+    const sa = segs(a);
+    const sb = segs(b);
+    for (let i = 0; i < Math.max(sa.length, sb.length); i++) {
+        const da = sa[i] ?? 0;
+        const db = sb[i] ?? 0;
+        if (da !== db)
+            return da - db;
+    }
+    return 0;
+}
+export function nextAutoVersion(existing) {
+    if (existing.length === 0)
+        return "v1.0";
+    const sorted = [...existing].sort(versionCompare);
+    const max = sorted[sorted.length - 1];
+    const segments = max.slice(1).split(".").map(Number);
+    segments[segments.length - 1]++;
+    return "v" + segments.join(".");
+}
+function upsertFeature(manifest, slug, version, frozenAt) {
+    const idx = manifest.features.findIndex((f) => f.slug === slug);
+    const entry = {
+        slug,
+        latest_frozen_version: version,
+        frozen_at: frozenAt,
+    };
+    if (idx >= 0) {
+        manifest.features[idx] = entry;
+    }
+    else {
+        manifest.features.push(entry);
+    }
+}
+/**
+ * freeze 命令主逻辑。返回退出码,由调用方负责 process.exit。
+ */
+export function runFreezeCommand(opts, cwd) {
+    const locale = readLocale();
+    const m = getMessages(locale);
+    // 1. --feature 必填
+    if (!opts.feature) {
+        process.stderr.write(c.fail("✗ ") + m.freeze_feature_required + "\n");
+        return 1;
+    }
+    // T6: HEAD probe (fire-and-forget; design §6.10).
+    void asyncHeadProbe(opts.feature, cwd);
+    // 2. workspace 已 init?
+    const manifestPath = join(cwd, ".prd/manifest.json");
+    const manifestRead = readManifest(manifestPath);
+    if (!manifestRead.ok) {
+        process.stderr.write(c.fail("✗ ") + m.freeze_workspace_not_init + "\n");
+        return 1;
+    }
+    // 3. feature 目录存在?(working 目录可能空但目录本身要存在)
+    const featureDir = join(cwd, ".prd/features", opts.feature);
+    const workingPath = join(featureDir, "working/prd.yaml");
+    if (!existsSync(workingPath)) {
+        process.stderr.write(c.fail("✗ ") + m.freeze_working_not_found({ slug: opts.feature }) + "\n");
+        return 1;
+    }
+    // 4. 解析版本号
+    const frozenDir = join(featureDir, "frozen");
+    const existingVersions = listExistingVersions(frozenDir);
+    const verResult = resolveVersion(opts, existingVersions);
+    if (!verResult.ok) {
+        process.stderr.write(c.fail("✗ ") +
+            renderError(m, verResult.errorKey, verResult.details ?? {}) +
+            "\n");
+        return 1;
+    }
+    const version = verResult.version;
+    // 5. 版本已存在?
+    const versionDir = join(frozenDir, version);
+    const existingSnapshotPath = join(versionDir, "snapshot.json");
+    if (existsSync(versionDir)) {
+        let frozenAt = "(unknown)";
+        if (existsSync(existingSnapshotPath)) {
+            try {
+                frozenAt = JSON.parse(readFileSync(existingSnapshotPath, "utf8")).frozen_at;
+            }
+            catch {
+                // ignore, use placeholder
+            }
+        }
+        process.stderr.write(c.fail("✗ ") +
+            m.freeze_version_exists({ version, frozen_at: frozenAt }) +
+            "\n");
+        return 1;
+    }
+    // 6. pre-validate(复用 runValidateCommand)
+    process.stdout.write(m.freeze_prevalidating({ slug: opts.feature }) + "\n");
+    const validateCode = runValidateCommand({ feature: opts.feature }, cwd);
+    if (validateCode !== 0) {
+        process.stderr.write(c.fail("✗ ") + m.freeze_prevalidate_fail + "\n");
+        return 1;
+    }
+    process.stdout.write(c.pass(m.freeze_prevalidate_pass) + "\n\n");
+    // 7. 读 working yaml
+    let yamlText;
+    try {
+        yamlText = readFileSync(workingPath, "utf8");
+    }
+    catch (e) {
+        process.stderr.write(c.fail("✗ ") +
+            m.freeze_fs_error({
+                operation: "read working/prd.yaml",
+                message: e.message,
+            }) +
+            "\n");
+        return 2;
+    }
+    // 8. source_hash
+    const sourceHash = "sha256:" + createHash("sha256").update(yamlText).digest("hex");
+    // 9. 写 frozen/<version>/
+    try {
+        mkdirSync(versionDir, { recursive: true });
+    }
+    catch (e) {
+        process.stderr.write(c.fail("✗ ") +
+            m.freeze_fs_error({
+                operation: `mkdir ${versionDir}`,
+                message: e.message,
+            }) +
+            "\n");
+        return 2;
+    }
+    try {
+        writeFileSync(join(versionDir, "prd.yaml"), yamlText, "utf8");
+    }
+    catch (e) {
+        process.stderr.write(c.fail("✗ ") +
+            m.freeze_fs_error({
+                operation: "write prd.yaml",
+                message: e.message,
+            }) +
+            "\n");
+        process.stderr.write(m.freeze_partial_recovery_hint({ dir: versionDir }) + "\n");
+        return 2;
+    }
+    const frozenAt = new Date().toISOString();
+    // 9.5 CHANGELOG.md 联动(设计 doc Section 5.5)
+    const workingDir = join(featureDir, "working");
+    const workingChangelogPath = join(workingDir, "CHANGELOG.md");
+    const frozenChangelogPath = join(versionDir, "CHANGELOG.md");
+    if (existsSync(workingChangelogPath)) {
+        // Step 1: byte-for-byte copy to frozen/
+        try {
+            copyFileSync(workingChangelogPath, frozenChangelogPath);
+            process.stdout.write(c.pass("✓ ") +
+                m.freeze_changelog_copied({ path: frozenChangelogPath }) +
+                "\n");
+        }
+        catch (e) {
+            process.stderr.write(c.fail("✗ ") +
+                m.freeze_changelog_copy_failed({ message: e.message }) +
+                "\n");
+            process.stderr.write(m.freeze_partial_recovery_hint({ dir: versionDir }) + "\n");
+            return 2;
+        }
+        // Step 2: promote working [Unreleased] → versioned + insert new [Unreleased]
+        try {
+            const content = readFileSync(workingChangelogPath, "utf8");
+            const promoted = promoteUnreleasedSection(content, version, frozenAt);
+            if (promoted !== content) {
+                writeFileSync(workingChangelogPath, promoted, "utf8");
+                process.stdout.write(c.pass("✓ ") +
+                    m.freeze_changelog_unreleased_promoted({ version }) +
+                    "\n");
+                process.stdout.write(c.pass("✓ ") +
+                    m.freeze_changelog_new_unreleased_inserted() +
+                    "\n");
+            }
+        }
+        catch (e) {
+            process.stderr.write(c.fail("✗ ") +
+                m.freeze_changelog_rewrite_failed({ message: e.message }) +
+                "\n");
+            process.stderr.write(m.freeze_changelog_recovery_sed_hint({ version, frozenAt }) + "\n");
+            return 2;
+        }
+    }
+    const snapshot = {
+        schema_version: "v0.1",
+        version,
+        feature: opts.feature,
+        frozen_at: frozenAt,
+        cli_version: manifestRead.data.cli_version,
+        source_hash: sourceHash,
+    };
+    try {
+        writeFileSync(join(versionDir, "snapshot.json"), JSON.stringify(snapshot, null, 2) + "\n", "utf8");
+    }
+    catch (e) {
+        process.stderr.write(c.fail("✗ ") +
+            m.freeze_fs_error({
+                operation: "write snapshot.json",
+                message: e.message,
+            }) +
+            "\n");
+        process.stderr.write(m.freeze_partial_recovery_hint({ dir: versionDir }) + "\n");
+        return 2;
+    }
+    // 10. 更新 manifest
+    upsertFeature(manifestRead.data, opts.feature, version, frozenAt);
+    try {
+        writeFileSync(manifestPath, JSON.stringify(manifestRead.data, null, 2) + "\n", "utf8");
+    }
+    catch (e) {
+        process.stderr.write(c.fail("✗ ") +
+            m.freeze_fs_error({
+                operation: "write manifest.json",
+                message: e.message,
+            }) +
+            "\n");
+        process.stderr.write(m.freeze_partial_recovery_hint({ dir: versionDir }) + "\n");
+        return 2;
+    }
+    // 11. 渲染成功
+    process.stdout.write(c.pass("✓ ") +
+        m.freeze_success_yaml({ slug: opts.feature, version }) +
+        "\n");
+    process.stdout.write(c.pass("✓ ") +
+        m.freeze_success_snapshot({ slug: opts.feature, version }) +
+        "\n");
+    process.stdout.write(c.pass("✓ ") +
+        m.freeze_success_manifest({ slug: opts.feature, version }) +
+        "\n");
+    process.stdout.write("\n" + m.freeze_success_summary({ slug: opts.feature, version }) + "\n");
+    return 0;
+}
+//# sourceMappingURL=freeze.js.map

package/dist/commands/freeze.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,24 @@
+export interface InitOptions {
+    workspace?: string;
+    /**
+     * v1.1 §6.3 — optional feature slug. When provided (with --team and
+     * --project resolved), init also writes a v0.2 yaml stub at
+     * `.prd/features/<slug>/working/prd.yaml` so the user can go straight from
+     * `prd init` to `prd push --allow-create <slug>` without hand-authoring the
+     * meta block. Q1 boundary: `prd push --allow-create` will refuse if this
+     * yaml is missing — `prd init <slug>` is the supported way to create it.
+     */
+    slug?: string;
+    /** v1.1 — workspace-level team slug for the new yaml stub. */
+    team?: string;
+    /** v1.1 — workspace-level project slug for the new yaml stub. */
+    project?: string;
+    /** Test seam — point rc reader at an isolated path. */
+    rcPath?: string;
+    /** v1.1 — backend name for .prdrc default lookup. */
+    backend?: string;
+}
+/**
+ * init 命令主逻辑。返回退出码,由调用方负责 process.exit。
+ */
+export declare function runInitCommand(opts: InitOptions, cwd: string): number;