@prd-improve/cli 1.0.0

package/dist/commands/migrate-yaml.js

@@ -0,0 +1,288 @@
+/**
+ * `prd migrate-yaml [<slug>]` — schema v0.1 → v0.2 yaml upgrader.
+ *
+ * Spec §5.2 / Task 8. Independent from `prd refresh` (refresh = "sync upstream
+ * PRD heading slice into yaml index"; this command = pure schema version bump).
+ *
+ * Two modes:
+ *   - single slug: migrate one feature
+ *   - no slug:     batch-iterate every feature in .prd/features/*\/working/prd.yaml
+ *                  and report rolled-up counts at the end
+ *
+ * Hard invariant (reviewer I6 patch): SERVER-VALIDATE before writing yaml.
+ * If the user types a non-existent team / project slug we MUST refuse to
+ * persist it — otherwise the yaml goes to v0.2 but every push 410s forever,
+ * "bricked" until a hand-edit. We probe via the scoped feature-list endpoint
+ * (`GET /api/teams/:t/projects/:p/features`) which is already mounted; a 200
+ * proves team+project exist AND user has membership, a 404 means at least one
+ * of the three is missing (anti-enumeration uniform per spec §3.4).
+ *
+ * yaml mutation: eemeli/yaml's `Document.setIn(...)` lets us insert
+ * `meta.team` into an existing meta map. Other comments / key order / values
+ * remain in place. We do NOT try harder than the library's built-in
+ * comment-preservation — best-effort is sufficient for v0.1 yaml which has at
+ * most a handful of head comments.
+ */
+import { existsSync, readFileSync, writeFileSync, readdirSync, statSync, } from "node:fs";
+import { join } from "node:path";
+import { parseDocument } from "yaml";
+import { createInterface } from "node:readline";
+import { apiFetch, projectUrl } from "../api/client.js";
+import { loadRcWithWarn, requireBackend } from "../sync/cliRcHelpers.js";
+import { getMessages, readLocale } from "../i18n/index.js";
+import * as c from "../formatter/colors.js";
+/**
+ * Resolve target (team, project) for a single feature given precedence:
+ *   1. --team / --project flags  (explicit)
+ *   2. .prdrc backends.<n> default_team / default_project (per spec §6.3)
+ *   3. interactive prompt: confirm rc defaults, or hand-fill
+ *
+ * Returns null on user decline / non-interactive without flags.
+ */
+async function resolveTeamProject(opts, rcDefaults, m, prompt) {
+    // 1) Flags win unconditionally.
+    if (opts.team && opts.project) {
+        return { team: opts.team, project: opts.project };
+    }
+    // 2) --non-interactive: only flag-driven path is allowed. We refuse to read
+    //    .prdrc defaults without an explicit user opt-in because the user may
+    //    not realize the .prdrc has stale defaults (CI scripts using
+    //    --non-interactive must spell out their intent).
+    if (opts.nonInteractive) {
+        process.stderr.write(c.fail("✗ ") + m.migrate_yaml_non_interactive_missing_flags + "\n");
+        return null;
+    }
+    // 3) Interactive: prefer rc defaults if both are set — surface a Y/n prompt.
+    if (rcDefaults.team && rcDefaults.project) {
+        const ans = await prompt(m.migrate_yaml_prompt_confirm({
+            team: rcDefaults.team,
+            project: rcDefaults.project,
+        }));
+        if (ans.trim() === "" || /^y(es)?$/i.test(ans.trim())) {
+            return { team: rcDefaults.team, project: rcDefaults.project };
+        }
+        // User said "n" → fall through to manual entry below.
+    }
+    // 4) No defaults (or user declined) → hand-fill.
+    let team = opts.team;
+    if (!team) {
+        const ans = await prompt(m.migrate_yaml_prompt_team);
+        team = ans.trim();
+        if (!team) {
+            process.stderr.write(c.fail("✗ ") + m.migrate_yaml_skipped_user_no + "\n");
+            return null;
+        }
+    }
+    let project = opts.project;
+    if (!project) {
+        const ans = await prompt(m.migrate_yaml_prompt_project);
+        project = ans.trim();
+        if (!project) {
+            process.stderr.write(c.fail("✗ ") + m.migrate_yaml_skipped_user_no + "\n");
+            return null;
+        }
+    }
+    return { team, project };
+}
+/**
+ * Probe `GET /api/teams/:team/projects/:project/features` — 200 means both
+ * team and project exist AND the caller has at least viewer membership; any
+ * other status (most importantly 404) means refuse-to-write.
+ */
+async function verifyTeamProjectOnServer(backend, team, project, fetchFn) {
+    const res = await apiFetch(backend, projectUrl(team, project, "features"), {
+        fetchFn,
+    });
+    if (res.ok)
+        return { ok: true };
+    if (res.network) {
+        return { ok: false, reason: "network", message: res.message };
+    }
+    // Any non-2xx (404 anti-enum, 401, 403, 5xx) → treat as miss. We don't try
+    // to distinguish team-miss vs project-miss vs membership-miss because spec
+    // §3.4 explicitly collapses them server-side. The user gets one actionable
+    // error: "ask admin or fix the slug".
+    return { ok: false, reason: "miss" };
+}
+/**
+ * Migrate one feature's working/prd.yaml in place.
+ *
+ * Returns `FeatureOutcome` so the batch driver can roll up a summary line.
+ * Writes user-facing IO directly (per-feature `·` / `✓` / `✗` lines).
+ */
+async function migrateOneFeature(slug, yamlPath, backend, resolved, m, fetchFn) {
+    const raw = readFileSync(yamlPath, "utf8");
+    let doc;
+    try {
+        doc = parseDocument(raw);
+    }
+    catch (e) {
+        process.stderr.write(c.fail("✗ ") +
+            m.migrate_yaml_parse_error({ slug, message: e.message }) +
+            "\n");
+        return "failed";
+    }
+    const schemaVersion = doc.get("schema_version");
+    if (schemaVersion === "v0.2") {
+        process.stdout.write(m.migrate_yaml_already_v02({ slug }) + "\n");
+        return "skipped";
+    }
+    if (schemaVersion !== "v0.1") {
+        process.stderr.write(c.fail("✗ ") +
+            m.migrate_yaml_unknown_schema({ slug, got: String(schemaVersion) }) +
+            "\n");
+        return "failed";
+    }
+    // Server validation — refuse to write yaml if (team, project) is bogus.
+    const verify = await verifyTeamProjectOnServer(backend, resolved.team, resolved.project, fetchFn);
+    if (!verify.ok) {
+        if (verify.reason === "network") {
+            process.stderr.write(c.fail("✗ ") +
+                m.migrate_yaml_server_network_error({
+                    message: verify.message ?? "(no message)",
+                }) +
+                "\n");
+        }
+        else {
+            process.stderr.write(c.fail("✗ ") +
+                m.migrate_yaml_server_miss({
+                    team: resolved.team,
+                    project: resolved.project,
+                }) +
+                "\n");
+        }
+        return "failed";
+    }
+    // Mutate the Document in place and serialize. eemeli/yaml preserves head
+    // comments, key order on existing keys, and indentation. The newly added
+    // meta.team key lands at the end of the meta map (acceptable — meta is a
+    // small map, exact insertion position isn't load-bearing for schema).
+    doc.setIn(["meta", "team"], resolved.team);
+    doc.setIn(["meta", "project"], resolved.project);
+    doc.set("schema_version", "v0.2");
+    const newYaml = String(doc);
+    writeFileSync(yamlPath, newYaml, "utf8");
+    process.stdout.write(c.pass("✓ ") +
+        m.migrate_yaml_written({
+            slug,
+            team: resolved.team,
+            project: resolved.project,
+        }) +
+        "\n");
+    return "upgraded";
+}
+/** Default stdin-backed prompt. Tests inject via `opts.promptFn`. */
+function defaultPrompt(question) {
+    return new Promise((resolve) => {
+        const rl = createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer);
+        });
+    });
+}
+/** Walk .prd/features/ and return feature slugs that have working/prd.yaml. */
+function listFeatureSlugs(cwd) {
+    const featuresDir = join(cwd, ".prd", "features");
+    if (!existsSync(featuresDir))
+        return [];
+    let entries;
+    try {
+        entries = readdirSync(featuresDir);
+    }
+    catch {
+        return [];
+    }
+    const slugs = [];
+    for (const entry of entries) {
+        const yamlPath = join(featuresDir, entry, "working", "prd.yaml");
+        try {
+            if (statSync(yamlPath).isFile())
+                slugs.push(entry);
+        }
+        catch {
+            // missing working/prd.yaml — skip silently (workspace may contain
+            // half-initialized features, common during user setup).
+        }
+    }
+    return slugs.sort();
+}
+export async function runMigrateYamlCommand(opts, cwd) {
+    const m = getMessages(readLocale());
+    // .prd workspace gate — runs before backend resolve so users without a
+    // workspace get the actionable "run prd init" hint rather than a
+    // backend-loading error.
+    const prdDir = join(cwd, ".prd");
+    if (!existsSync(prdDir)) {
+        process.stderr.write(c.fail("✗ ") + m.migrate_yaml_workspace_not_init + "\n");
+        return 1;
+    }
+    // Resolve backend before any per-feature work — server validation is
+    // mandatory and we want to fail fast on "no backend" rather than after
+    // prompting the user for slug values.
+    const loaded = loadRcWithWarn(opts.rcPath);
+    if (loaded.hadError)
+        return 1;
+    const backend = requireBackend(loaded.rc, { backend: opts.backend });
+    if (!backend)
+        return 1;
+    // Resolve .prdrc defaults from the backend the user is actually using.
+    // (`requireBackend` already returned its name as `backend.name`; we look it
+    // up in the rc to pull default_team / default_project.)
+    const rcEntry = loaded.rc && backend.name !== "(env)"
+        ? loaded.rc.backends[backend.name]
+        : undefined;
+    const rcDefaults = {
+        team: rcEntry?.default_team,
+        project: rcEntry?.default_project,
+    };
+    const prompt = opts.promptFn ?? defaultPrompt;
+    // Batch mode: no slug → iterate all features.
+    if (!opts.slug) {
+        const slugs = listFeatureSlugs(cwd);
+        if (slugs.length === 0) {
+            process.stdout.write(m.migrate_yaml_batch_no_features + "\n");
+            return 0;
+        }
+        let upgraded = 0;
+        let skipped = 0;
+        let failed = 0;
+        for (const slug of slugs) {
+            const yamlPath = join(cwd, ".prd", "features", slug, "working", "prd.yaml");
+            // Resolve per-feature (could differ per slug if user types a different
+            // team/project at the prompt). Cache once when flags + defaults force
+            // the same answer; otherwise re-prompt is the path the spec requires.
+            const resolved = await resolveTeamProject(opts, rcDefaults, m, prompt);
+            if (!resolved) {
+                failed++;
+                continue;
+            }
+            const outcome = await migrateOneFeature(slug, yamlPath, backend, resolved, m, opts.fetchFn);
+            if (outcome === "upgraded")
+                upgraded++;
+            else if (outcome === "skipped")
+                skipped++;
+            else
+                failed++;
+        }
+        process.stdout.write(m.migrate_yaml_batch_summary({ upgraded, skipped, failed }) + "\n");
+        return failed > 0 ? 1 : 0;
+    }
+    // Single-slug mode.
+    const yamlPath = join(cwd, ".prd", "features", opts.slug, "working", "prd.yaml");
+    if (!existsSync(yamlPath)) {
+        process.stderr.write(c.fail("✗ ") +
+            m.migrate_yaml_feature_yaml_missing({ slug: opts.slug, path: yamlPath }) +
+            "\n");
+        return 1;
+    }
+    const resolved = await resolveTeamProject(opts, rcDefaults, m, prompt);
+    if (!resolved)
+        return 1;
+    const outcome = await migrateOneFeature(opts.slug, yamlPath, backend, resolved, m, opts.fetchFn);
+    return outcome === "failed" ? 1 : 0;
+}
+//# sourceMappingURL=migrate-yaml.js.map

package/dist/commands/migrate-yaml.js.map

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

package/dist/commands/project.d.ts

@@ -0,0 +1,7 @@
+export interface ProjectListOptions {
+    team?: string;
+    backend?: string;
+    fetchFn?: typeof fetch;
+    rcPath?: string;
+}
+export declare function runProjectListCommand(opts: ProjectListOptions, cwd: string): Promise<number>;

package/dist/commands/project.js

@@ -0,0 +1,87 @@
+/**
+ * `prd project list --team <slug>` — UAT2-G1 (spec §6.2 / plan §Task 7).
+ *
+ * USER-视角只读视图:列出当前 PAT 用户在指定 team 下能看见的 project(=自己
+ * 有 membership 的 project),并附上 my_role 和 feature_count。
+ *
+ * 与 `prd admin project list` 的区别同 team.ts:走 ~/.prdrc + Bearer PAT,
+ * 不需要 PRDSERVER_ADMIN_TOKEN。
+ *
+ * Server endpoint:GET /api/teams/:teamSlug/projects(T-v1.1-9 Part A)。
+ *   返回 { ok:true, data:[{slug, name, my_role, feature_count}] }
+ *
+ * 404 处理:server 在 teamScopeMiddleware 里把 "team 不存在" 和 "你没看见这个
+ * team 的任何 project" 都返回 404(防 enumeration),CLI 这边映射为同一句话
+ * "team not found or no membership" 比较安全。
+ */
+import { apiFetch } from "../api/client.js";
+import { loadRcWithWarn, requireBackend } from "../sync/cliRcHelpers.js";
+import { getMessages, readLocale } from "../i18n/index.js";
+import * as c from "../formatter/colors.js";
+function renderTable(rows, headers) {
+    const cols = [
+        { key: "slug", label: headers.slug },
+        { key: "name", label: headers.name },
+        { key: "role", label: headers.role },
+        { key: "features", label: headers.features },
+    ];
+    const dataRows = rows.map((r) => ({
+        slug: r.slug,
+        name: r.name,
+        role: r.my_role,
+        features: String(r.feature_count),
+    }));
+    const widths = cols.map((col) => Math.max(col.label.length, ...dataRows.map((row) => row[col.key].length)));
+    const fmt = (vals) => vals.map((v, i) => v.padEnd(widths[i])).join("  ").trimEnd();
+    const lines = [];
+    lines.push(fmt(cols.map((col) => col.label)));
+    for (const row of dataRows) {
+        lines.push(fmt(cols.map((col) => row[col.key])));
+    }
+    return lines.join("\n");
+}
+export async function runProjectListCommand(opts, cwd) {
+    void cwd;
+    const m = getMessages(readLocale());
+    if (!opts.team) {
+        process.stderr.write(c.fail("✗ ") + m.project_list_team_required + "\n");
+        return 1;
+    }
+    const loaded = loadRcWithWarn(opts.rcPath);
+    if (loaded.hadError)
+        return 1;
+    const backend = requireBackend(loaded.rc, { backend: opts.backend });
+    if (!backend)
+        return 1;
+    const res = await apiFetch(backend, `/api/teams/${encodeURIComponent(opts.team)}/projects`, { fetchFn: opts.fetchFn });
+    if (!res.ok) {
+        if (res.code === "UNAUTHENTICATED") {
+            process.stderr.write(c.fail("✗ ") + m.whoami_unauth + "\n");
+            return 1;
+        }
+        if (res.status === 404) {
+            process.stderr.write(c.fail("✗ ") + m.admin_team_not_found({ slug: opts.team }) + "\n");
+            return 1;
+        }
+        if (res.network) {
+            process.stderr.write(c.fail("✗ ") + m.push_network_error({ message: res.message }) + "\n");
+            return 1;
+        }
+        process.stderr.write(c.fail("✗ ") + `Failed: ${res.code} — ${res.message}\n`);
+        return 1;
+    }
+    const rows = res.body.data;
+    if (rows.length === 0) {
+        process.stdout.write(m.project_list_empty({ team: opts.team }) + "\n");
+        return 0;
+    }
+    const table = renderTable(rows, {
+        slug: m.project_list_header_slug,
+        name: m.project_list_header_name,
+        role: m.project_list_header_role,
+        features: m.project_list_header_features,
+    });
+    process.stdout.write(table + "\n");
+    return 0;
+}
+//# sourceMappingURL=project.js.map

package/dist/commands/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/commands/project.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,CAAC,MAAM,wBAAwB,CAAC;AAqB5C,SAAS,WAAW,CAClB,IAAkB,EAClB,OAAuE;IAEvE,MAAM,IAAI,GAAG;QACX,EAAE,GAAG,EAAE,MAAe,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE;QAC7C,EAAE,GAAG,EAAE,MAAe,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE;QAC7C,EAAE,GAAG,EAAE,MAAe,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE;QAC7C,EAAE,GAAG,EAAE,UAAmB,EAAE,KAAK,EAAE,OAAO,CAAC,QAAQ,EAAE;KACtD,CAAC;IACF,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChC,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,IAAI,EAAE,CAAC,CAAC,OAAO;QACf,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC;KAClC,CAAC,CAAC,CAAC;IACJ,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAC9B,IAAI,CAAC,GAAG,CACN,GAAG,CAAC,KAAK,CAAC,MAAM,EAChB,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAC9C,CACF,CAAC;IACF,MAAM,GAAG,GAAG,CAAC,IAAc,EAAU,EAAE,CACrC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;IAChE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9C,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,IAAwB,EACxB,GAAW;IAEX,KAAK,GAAG,CAAC;IACT,MAAM,CAAC,GAAG,WAAW,CAAC,UAAU,EAAE,CAAC,CAAC;IAEpC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,0BAA0B,GAAG,IAAI,CAAC,CAAC;QACzE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,MAAM,CAAC,QAAQ;QAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IACrE,IAAI,CAAC,OAAO;QAAE,OAAO,CAAC,CAAC;IAEvB,MAAM,GAAG,GAAG,MAAM,QAAQ,CACxB,OAAO,EACP,cAAc,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EACtD,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAC1B,CAAC;IACF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,IAAI,GAAG,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;YACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;YAC5D,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,oBAAoB,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAClE,CAAC;YACF,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,kBAAkB,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CACrE,CAAC;YACF,OAAO,CAAC,CAAC;QACX,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,WAAW,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,OAAO,IAAI,CACxD,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;IAC3B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QACvE,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,EAAE;QAC9B,IAAI,EAAE,CAAC,CAAC,wBAAwB;QAChC,IAAI,EAAE,CAAC,CAAC,wBAAwB;QAChC,IAAI,EAAE,CAAC,CAAC,wBAAwB;QAChC,QAAQ,EAAE,CAAC,CAAC,4BAA4B;KACzC,CAAC,CAAC;IACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IACnC,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/commands/pull.d.ts

@@ -0,0 +1,16 @@
+export interface PullOptions {
+    slug: string;
+    backend?: string;
+    force?: boolean;
+    /** Stash local working/prd.yaml to .prd/.conflicts/ before fast-forward. */
+    stash?: boolean;
+    fetchFn?: typeof fetch;
+    rcPath?: string;
+    /**
+     * v1.1: explicit scope override for fresh-clone pulls where local yaml and
+     * sync.json both lack team/project. CLI flag wiring lives in cli.ts (T7).
+     */
+    team?: string;
+    project?: string;
+}
+export declare function runPullCommand(opts: PullOptions, cwd: string): Promise<number>;

package/dist/commands/pull.js

@@ -0,0 +1,197 @@
+/**
+ * `prd pull <slug> [--backend <name>] [--force] [--stash]` (T6, design §6.3;
+ * v1.1 spec §4.2 / §6.2 + UAT F7 / F8).
+ *
+ * Dirty detection:
+ *   sha256( normalizeLineEndings(working/prd.yaml) ) !== sync.json.last_synced_hash
+ * Note the line-ending normalize step — must mirror server (T5) so CRLF
+ * checkouts from git on Windows don't flag identical bytes as "dirty".
+ *
+ * --force overwrites local working/. No stash (user already warned).
+ *
+ * Fresh-clone path: no local working/, no sync.json → just write what server
+ * returns, sync.json initialized with server's ETag.
+ *
+ * F7 (UAT polish): If-None-Match → 304 → print "已是最新" + exit 0 without
+ * overwrite.
+ *
+ * F8 (UAT polish): dirty check happens BEFORE any stash directory creation.
+ * Bare `prd pull` against dirty working/ rejects with exit 1 and produces no
+ * .conflicts/ noise. `--stash` is the only path that calls stashConflict().
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { createHash } from "node:crypto";
+import { apiFetch, parseMetaScope, projectUrl } from "../api/client.js";
+import { loadRcWithWarn, requireBackend } from "../sync/cliRcHelpers.js";
+import { readSyncJson, writeSyncJson } from "../sync/syncJson.js";
+import { normalizeLineEndings } from "../sync/normalize.js";
+import { stashConflict } from "../sync/conflicts.js";
+import { getMessages, readLocale } from "../i18n/index.js";
+import * as c from "../formatter/colors.js";
+export async function runPullCommand(opts, cwd) {
+    const m = getMessages(readLocale());
+    if (!opts.slug) {
+        process.stderr.write(c.fail("✗ ") + "Usage: prd pull <slug>\n");
+        return 1;
+    }
+    const loaded = loadRcWithWarn(opts.rcPath);
+    if (loaded.hadError)
+        return 1;
+    const backend = requireBackend(loaded.rc, { backend: opts.backend });
+    if (!backend)
+        return 1;
+    const workingDir = join(cwd, ".prd", "features", opts.slug, "working");
+    const workingPath = join(workingDir, "prd.yaml");
+    const sync = readSyncJson(cwd, opts.slug);
+    // F8 (UAT polish): inspect dirty state BEFORE we do anything fetch-related
+    // or stash-related. Bare `prd pull` against dirty working/ must reject
+    // with exit 1 and produce no .conflicts/ noise. The stash path runs later,
+    // only when isDirty && opts.stash.
+    let isDirty = false;
+    let dirtyLocalYaml = "";
+    if (existsSync(workingPath) && sync) {
+        if (sync.backend_url && sync.backend_url !== backend.url) {
+            process.stderr.write(c.fail("✗ ") +
+                m.pull_backend_url_changed({
+                    old: sync.backend_url,
+                    current: backend.url,
+                }) +
+                "\n");
+            return 1;
+        }
+        dirtyLocalYaml = readFileSync(workingPath, "utf8");
+        const localBytes = normalizeLineEndings(dirtyLocalYaml);
+        const localHash = "sha256:" + createHash("sha256").update(localBytes).digest("hex");
+        isDirty = localHash !== sync.last_synced_hash;
+    }
+    // F8: refuse on dirty unless --force or --stash. --force overwrites
+    // silently; --stash preserves local in .conflicts/ before fast-forward
+    // (B-5 fix: gives users a first-class "save local + take remote" path so
+    // they don't have to choose between `--force` data loss and the push/pull
+    // deadlock documented in the T11 dogfood report). Critically, stash dir
+    // creation must NOT happen here — only after the server fetch succeeds.
+    if (isDirty && !opts.force && !opts.stash) {
+        process.stderr.write(c.fail("✗ ") +
+            m.pull_refuse_dirty({ path: workingPath }) +
+            "\n");
+        return 1;
+    }
+    // v1.1 scope resolution (spec §4.2). Priority:
+    //   1. opts.team/project (explicit flag)
+    //   2. working/prd.yaml meta (parseMetaScope)
+    //   3. sync.json.team / sync.json.project
+    // With --force we tolerate parse failures on local yaml (the whole point
+    // of --force is "blow away whatever junk is there"), so we'll fall through
+    // to sync.json or opts in that case rather than refuse.
+    let scope = null;
+    if (opts.team && opts.project) {
+        scope = { team: opts.team, project: opts.project, feature: opts.slug };
+    }
+    else if (existsSync(workingPath)) {
+        const localContent = dirtyLocalYaml || readFileSync(workingPath, "utf8");
+        try {
+            scope = parseMetaScope(localContent);
+        }
+        catch (e) {
+            if (opts.force && sync?.team && sync?.project) {
+                scope = {
+                    team: sync.team,
+                    project: sync.project,
+                    feature: opts.slug,
+                };
+            }
+            else {
+                process.stderr.write(c.fail("✗ ") + e.message + "\n");
+                process.stderr.write(m.api_v0_gone_hint + "\n");
+                return 1;
+            }
+        }
+    }
+    else if (sync?.team && sync?.project) {
+        scope = { team: sync.team, project: sync.project, feature: opts.slug };
+    }
+    else {
+        process.stderr.write(c.fail("✗ ") + m.pull_scope_unresolvable({ slug: opts.slug }) + "\n");
+        return 1;
+    }
+    const featureUrl = projectUrl(scope.team, scope.project, "features", scope.feature);
+    // F7 (UAT polish): conditional GET via If-None-Match. Server returns 304
+    // with no body if local base matches remote → CLI prints "已是最新" and
+    // exits 0 without touching working/. Skip when --force so the explicit
+    // "blow away local junk and re-download" path always re-fetches the yaml.
+    const conditionalHeaders = {};
+    if (sync?.base_version_id && !opts.force) {
+        conditionalHeaders["If-None-Match"] = `"${sync.base_version_id}"`;
+    }
+    const res = await apiFetch(backend, `${featureUrl}?for=pull`, { fetchFn: opts.fetchFn, headers: conditionalHeaders });
+    if (res.ok && res.status === 304) {
+        process.stdout.write(m.pull_already_up_to_date({
+            slug: opts.slug,
+            version: sync?.base_version_id ?? "(unknown)",
+        }) + "\n");
+        return 0;
+    }
+    if (!res.ok) {
+        if (res.code === "API_V0_GONE" || res.status === 410) {
+            process.stderr.write(c.fail("✗ ") + m.api_v0_gone_hint + "\n");
+            return 1;
+        }
+        if (res.code === "FEATURE_NOT_FOUND" || res.status === 404) {
+            process.stderr.write(c.fail("✗ ") + m.pull_remote_not_found({ slug: opts.slug }) + "\n");
+            return 1;
+        }
+        if (res.network) {
+            process.stderr.write(c.fail("✗ ") + m.push_network_error({ message: res.message }) + "\n");
+            return 1;
+        }
+        process.stderr.write(c.fail("✗ ") + `Pull failed: ${res.code} — ${res.message}\n`);
+        return 1;
+    }
+    // Server sends YAML as text (Content-Type: application/yaml) — apiFetch
+    // falls back to text() for non-JSON, so res.body is the raw yaml string.
+    const yamlText = typeof res.body === "string" ? res.body : String(res.body);
+    const normalized = normalizeLineEndings(yamlText);
+    const etag = res.headers.get("ETag") ?? res.headers.get("etag");
+    if (!etag) {
+        process.stderr.write(c.fail("✗ ") + `Server response missing ETag header\n`);
+        return 1;
+    }
+    const version = etag.replace(/^"|"$/g, "");
+    if (!existsSync(dirname(workingPath))) {
+        mkdirSync(dirname(workingPath), { recursive: true });
+    }
+    let stashDir;
+    if (opts.stash && isDirty) {
+        // stashConflict writes local.yaml + remote.yaml + README.md AND overwrites
+        // working/prd.yaml with remote — exact semantics we want for `--stash`.
+        stashDir = stashConflict(cwd, opts.slug, {
+            localYaml: dirtyLocalYaml,
+            remoteYaml: normalized,
+            baseVersionId: sync?.base_version_id,
+            remoteVersionId: version,
+        });
+    }
+    else {
+        writeFileSync(workingPath, normalized, "utf8");
+    }
+    const hash = "sha256:" + createHash("sha256").update(normalized).digest("hex");
+    writeSyncJson(cwd, opts.slug, {
+        base_version_id: version,
+        last_synced_hash: hash,
+        last_pulled_at: new Date().toISOString(),
+        last_pushed_at: sync?.last_pushed_at,
+        backend_url: backend.url,
+        team: scope.team,
+        project: scope.project,
+    });
+    if (stashDir) {
+        process.stdout.write(c.pass("✓ ") + m.pull_stash_success({ dir: stashDir }) + "\n");
+    }
+    else if (opts.force) {
+        process.stdout.write(c.pass("✓ ") + m.pull_force_overwrote({ slug: opts.slug }) + "\n");
+    }
+    process.stdout.write(c.pass("✓ ") + m.pull_success({ slug: opts.slug, version }) + "\n");
+    return 0;
+}
+//# sourceMappingURL=pull.js.map

package/dist/commands/pull.js.map

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

package/dist/commands/push.d.ts

@@ -0,0 +1,9 @@
+export interface PushOptions {
+    slug: string;
+    backend?: string;
+    allowCreate?: boolean;
+    skipFrozen?: boolean;
+    fetchFn?: typeof fetch;
+    rcPath?: string;
+}
+export declare function runPushCommand(opts: PushOptions, cwd: string): Promise<number>;