@prd-improve/cli 1.0.0

package/README.md

@@ -0,0 +1,38 @@
+# @prd-improve/cli
+
+PRD Improve CLI —— PRD 生命周期 + 团队协作。完整命令见 `prd --help`。
+
+## 安装
+
+```bash
+npm install -g @prd-improve/cli
+```
+
+## 用法
+
+命令分 5 组(`prd --help` 列全;`--lang en` / `PRD_LANG=en` 切英文):
+
+```bash
+# 生命周期(离线,无需后端)
+prd init / validate / freeze / context / diff / refresh / migrate-yaml
+
+# 认证 / 会话
+prd login / logout / whoami
+
+# 后端同步
+prd push / pull / status
+
+# 团队 / 项目
+prd team list / project list
+
+# 管理 / 配置
+prd admin <user|token|team|project|member|team-member|audit> / config <show|set|use>
+```
+
+每个命令的参数与示例见 `prd <command> --help`。
+
+## 退出码(`prd validate`)
+
+- `0`: 全部 PASS 或仅 SKIP
+- `1`: 有 FAIL(模块缺失 / 引用错误 / 重复 ID / blocking 问题 / schema 违反)
+- `2`: 解析错误(yaml 语法错 / 用户指定路径不存在 / .prd 目录缺失)

package/dist/anchor-slicer.d.ts

@@ -0,0 +1,18 @@
+export interface AnchorMatch {
+    line: number;
+    heading: string;
+    level: number;
+    text: string;
+}
+export interface SliceResult {
+    found: boolean;
+    matches?: AnchorMatch[];
+    slice?: string;
+    sliceStart?: number;
+    sliceEnd?: number;
+}
+interface SliceOptions {
+    exact?: boolean;
+}
+export declare function sliceByAnchor(markdown: string, anchor: string, opts: SliceOptions): SliceResult;
+export {};

package/dist/anchor-slicer.js

@@ -0,0 +1,114 @@
+function parseHeadings(markdown) {
+    const lines = markdown.split("\n");
+    const out = [];
+    let inFence = false;
+    for (let i = 0; i < lines.length; i++) {
+        // fenced code block guard: 切换 inFence,fence 内不识别 heading
+        if (/^(```|~~~)/.test(lines[i])) {
+            inFence = !inFence;
+            continue;
+        }
+        if (inFence)
+            continue;
+        const m = lines[i].match(/^(#{1,6})\s+(.+?)\s*$/);
+        if (m) {
+            out.push({
+                line: i + 1,
+                heading: lines[i],
+                level: m[1].length,
+                text: m[2],
+            });
+        }
+    }
+    return out;
+}
+function distanceToNextSameOrHigher(headings, index) {
+    const h = headings[index];
+    for (let j = index + 1; j < headings.length; j++) {
+        if (headings[j].level <= h.level)
+            return j - index;
+    }
+    return headings.length - index;
+}
+function extractSlice(markdown, headings, matchIdx) {
+    const h = headings[matchIdx];
+    const lines = markdown.split("\n");
+    let endLine = lines.length;
+    for (let j = matchIdx + 1; j < headings.length; j++) {
+        if (headings[j].level <= h.level) {
+            endLine = headings[j].line - 1;
+            break;
+        }
+    }
+    const slice = lines.slice(h.line - 1, endLine).join("\n");
+    return { slice, start: h.line, end: endLine };
+}
+/**
+ * 公共 tier resolver:消三级 tier 的 copy-paste 重复
+ * - 0 匹配 → null(交给下一级)
+ * - 1 匹配 → 切片返回
+ * - 多匹配 → 若允许 section-head ranking 且第一名距离严格大于第二名,选第一名切片;
+ *   否则返回候选列表不切片(found: false)
+ */
+function resolveTier(markdown, headings, candidates, allowSectionHeadRanking) {
+    if (candidates.length === 0)
+        return null;
+    if (candidates.length === 1) {
+        const idx = headings.indexOf(candidates[0]);
+        const s = extractSlice(markdown, headings, idx);
+        return {
+            found: true,
+            matches: candidates,
+            slice: s.slice,
+            sliceStart: s.start,
+            sliceEnd: s.end,
+        };
+    }
+    // 多匹配
+    if (!allowSectionHeadRanking)
+        return { found: false, matches: candidates };
+    const ranked = candidates
+        .map((h) => ({
+        h,
+        idx: headings.indexOf(h),
+        dist: distanceToNextSameOrHigher(headings, headings.indexOf(h)),
+    }))
+        .sort((a, b) => b.dist - a.dist);
+    if (ranked[0].dist > ranked[1].dist) {
+        const s = extractSlice(markdown, headings, ranked[0].idx);
+        return {
+            found: true,
+            matches: [ranked[0].h],
+            slice: s.slice,
+            sliceStart: s.start,
+            sliceEnd: s.end,
+        };
+    }
+    return { found: false, matches: candidates };
+}
+export function sliceByAnchor(markdown, anchor, opts) {
+    const headings = parseHeadings(markdown);
+    const trimmed = anchor.trim();
+    // tier 1: exact match (全 heading 文字精确等值,或带井号前缀的完整 heading 等值)
+    // 不允许 section-head ranking:精确等值多匹配只可能是重复 heading,应返回候选不切片
+    const tier1 = headings.filter((h) => h.text === trimmed ||
+        h.heading === trimmed ||
+        h.heading.replace(/^#+\s+/, "") === trimmed);
+    const r1 = resolveTier(markdown, headings, tier1, false);
+    if (r1)
+        return r1;
+    if (opts.exact)
+        return { found: false }; // exact mode 不 fallback
+    // tier 2: prefix match
+    const tier2 = headings.filter((h) => h.heading.startsWith(trimmed));
+    const r2 = resolveTier(markdown, headings, tier2, true);
+    if (r2)
+        return r2;
+    // tier 3: substring match
+    const tier3 = headings.filter((h) => h.heading.includes(trimmed));
+    const r3 = resolveTier(markdown, headings, tier3, true);
+    if (r3)
+        return r3;
+    return { found: false };
+}
+//# sourceMappingURL=anchor-slicer.js.map

package/dist/anchor-slicer.js.map

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

package/dist/api/client.d.ts

@@ -0,0 +1,68 @@
+import type { ResolvedBackend } from "../config/schema.js";
+export interface ApiOk<T = unknown> {
+    ok: true;
+    status: number;
+    headers: Headers;
+    body: T;
+}
+export interface ApiErr {
+    ok: false;
+    status: number;
+    code: string;
+    message: string;
+    details?: unknown;
+    /**
+     * Set when the failure was network-level (DNS, abort, refused) rather than
+     * a structured server response. status === 0 in that case.
+     */
+    network?: boolean;
+}
+export type ApiResult<T = unknown> = ApiOk<T> | ApiErr;
+interface FetchOpts {
+    method?: string;
+    body?: string | undefined;
+    headers?: Record<string, string>;
+    /** Override global fetch (tests inject in-process Hono app dispatcher). */
+    fetchFn?: typeof fetch;
+}
+export declare function apiFetch<T = unknown>(backend: ResolvedBackend, path: string, opts?: FetchOpts): Promise<ApiResult<T>>;
+/**
+ * v1.1 URL builder for scoped feature/comment/version routes
+ * (spec §4.2 / §6.2). Returns a leading-slash path relative to backend.url so
+ * apiFetch can concatenate it directly.
+ *
+ *   projectUrl('team-a', 'p1', 'features', 'foo')
+ *     → '/api/teams/team-a/projects/p1/features/foo'
+ *   projectUrl('team-a', 'p1', 'features')
+ *     → '/api/teams/team-a/projects/p1/features'
+ *
+ * Callers are responsible for slug-shape pre-validation; this builder just
+ * concatenates so a bad slug surfaces as 400/404 from the server rather than
+ * being silently rewritten.
+ */
+export declare function projectUrl(team: string, project: string, ...rest: string[]): string;
+/**
+ * Read meta.team / meta.project / meta.feature from yaml content
+ * (spec §4.2 step 1). All three are required for v1.1 routing — v0.1 yaml
+ * (pre-`prd migrate-yaml`) lacks meta.team and intentionally errors here so
+ * the user sees a self-service hint instead of getting a 410 dance from a
+ * blindly-routed request.
+ */
+export declare function parseMetaScope(yamlContent: string): {
+    team: string;
+    project: string;
+    feature: string;
+};
+/**
+ * HEAD specialization. Servers send no body, so we just return the status
+ * and headers. No body parse attempt.
+ */
+export declare function apiHead(backend: ResolvedBackend, path: string, opts?: {
+    fetchFn?: typeof fetch;
+    headers?: Record<string, string>;
+}): Promise<{
+    ok: true;
+    status: number;
+    headers: Headers;
+} | ApiErr>;
+export {};

package/dist/api/client.js

@@ -0,0 +1,175 @@
+/**
+ * API client for sync commands (T6).
+ *
+ * Thin wrapper around global fetch with:
+ *  - Bearer-token auth header (token comes from ResolvedBackend).
+ *  - Uniform error shape: success → { ok, status, headers, body }; error →
+ *    { ok:false, status, code, message, details? } matching server's
+ *    {ok:false,code,message,details} body schema.
+ *  - HEAD specialization: don't try to JSON-parse 200 body (servers may send
+ *    null per RFC 7231 §4.3.2 — Hono does in our case).
+ *
+ * v1.1 additions (T-v1.1-6, spec §4.2 / §6.2):
+ *  - projectUrl(team, project, ...rest) — URL builder for the scoped
+ *    /api/teams/:teamSlug/projects/:projectSlug/* paths.
+ *  - parseMetaScope(yaml) — read meta.team / meta.project / meta.feature
+ *    from yaml so sync commands can route requests without flags.
+ *  - 410 API_V0_GONE is already surfaced verbatim by apiFetch's structured
+ *    error branch; callers detect by `res.code === 'API_V0_GONE'`.
+ */
+import { load as yamlLoad } from "js-yaml";
+export async function apiFetch(backend, path, opts = {}) {
+    const url = backend.url.replace(/\/+$/, "") + path;
+    const fn = opts.fetchFn ?? globalThis.fetch;
+    let res;
+    try {
+        res = await fn(url, {
+            method: opts.method ?? "GET",
+            headers: {
+                Authorization: `Bearer ${backend.token}`,
+                ...(opts.headers ?? {}),
+            },
+            body: opts.body,
+        });
+    }
+    catch (e) {
+        return {
+            ok: false,
+            status: 0,
+            code: "NETWORK_ERROR",
+            message: e.message,
+            network: true,
+        };
+    }
+    // Empty body responses (204, 205) — short-circuit. Otherwise try JSON, fall
+    // back to text if parse fails (server returns YAML for `?for=pull`).
+    // 304 Not Modified is conventionally `ok:true` in this client — callers like
+    // `prd pull` distinguish via `status === 304` to render the F7 "已是最新"
+    // message (spec §8). The native Response.ok is false for 304, so this
+    // explicit branch overrides that.
+    if (res.status === 304) {
+        return { ok: true, status: 304, headers: res.headers, body: null };
+    }
+    if (res.status === 204 || res.status === 205) {
+        return { ok: true, status: res.status, headers: res.headers, body: null };
+    }
+    const ct = res.headers.get("content-type") ?? "";
+    let parsed;
+    if (ct.includes("application/json")) {
+        try {
+            parsed = await res.json();
+        }
+        catch (e) {
+            return {
+                ok: false,
+                status: res.status,
+                code: "INVALID_RESPONSE",
+                message: `Failed to parse JSON: ${e.message}`,
+            };
+        }
+    }
+    else {
+        parsed = await res.text();
+    }
+    if (res.ok) {
+        // Server convention is { ok:true, data: ... } for JSON responses.
+        return { ok: true, status: res.status, headers: res.headers, body: parsed };
+    }
+    // Error path. JSON body: { ok:false, code, message, details? }. Plaintext
+    // body: stuff it into message so the user sees something.
+    if (parsed && typeof parsed === "object" && parsed.code) {
+        return {
+            ok: false,
+            status: res.status,
+            code: String(parsed.code),
+            message: String(parsed.message ?? "(no message)"),
+            details: parsed.details,
+        };
+    }
+    return {
+        ok: false,
+        status: res.status,
+        code: "HTTP_ERROR",
+        message: typeof parsed === "string" ? parsed : `HTTP ${res.status}`,
+    };
+}
+/**
+ * v1.1 URL builder for scoped feature/comment/version routes
+ * (spec §4.2 / §6.2). Returns a leading-slash path relative to backend.url so
+ * apiFetch can concatenate it directly.
+ *
+ *   projectUrl('team-a', 'p1', 'features', 'foo')
+ *     → '/api/teams/team-a/projects/p1/features/foo'
+ *   projectUrl('team-a', 'p1', 'features')
+ *     → '/api/teams/team-a/projects/p1/features'
+ *
+ * Callers are responsible for slug-shape pre-validation; this builder just
+ * concatenates so a bad slug surfaces as 400/404 from the server rather than
+ * being silently rewritten.
+ */
+export function projectUrl(team, project, ...rest) {
+    const base = `/api/teams/${team}/projects/${project}`;
+    if (rest.length === 0)
+        return base;
+    return `${base}/${rest.join("/")}`;
+}
+/**
+ * Read meta.team / meta.project / meta.feature from yaml content
+ * (spec §4.2 step 1). All three are required for v1.1 routing — v0.1 yaml
+ * (pre-`prd migrate-yaml`) lacks meta.team and intentionally errors here so
+ * the user sees a self-service hint instead of getting a 410 dance from a
+ * blindly-routed request.
+ */
+export function parseMetaScope(yamlContent) {
+    let doc;
+    try {
+        doc = yamlLoad(yamlContent);
+    }
+    catch (e) {
+        throw new Error(`parseMetaScope: yaml parse failed — ${e.message}`);
+    }
+    const meta = doc?.meta ?? {};
+    const team = typeof meta.team === "string" ? meta.team : "";
+    const project = typeof meta.project === "string" ? meta.project : "";
+    const feature = typeof meta.feature === "string" ? meta.feature : "";
+    if (!team || !project || !feature) {
+        throw new Error("meta.team / meta.project / meta.feature 必须全部存在;请先跑 prd migrate-yaml 升级 v0.1 → v0.2 yaml");
+    }
+    return { team, project, feature };
+}
+/**
+ * HEAD specialization. Servers send no body, so we just return the status
+ * and headers. No body parse attempt.
+ */
+export async function apiHead(backend, path, opts = {}) {
+    const url = backend.url.replace(/\/+$/, "") + path;
+    const fn = opts.fetchFn ?? globalThis.fetch;
+    try {
+        const res = await fn(url, {
+            method: "HEAD",
+            headers: {
+                Authorization: `Bearer ${backend.token}`,
+                ...(opts.headers ?? {}),
+            },
+        });
+        if (res.ok || res.status === 304) {
+            return { ok: true, status: res.status, headers: res.headers };
+        }
+        return {
+            ok: false,
+            status: res.status,
+            code: res.status === 404 ? "FEATURE_NOT_FOUND" : "HTTP_ERROR",
+            message: `HTTP ${res.status}`,
+        };
+    }
+    catch (e) {
+        return {
+            ok: false,
+            status: 0,
+            code: "NETWORK_ERROR",
+            message: e.message,
+            network: true,
+        };
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/api/client.js.map

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

package/dist/changelog.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Promote the [Unreleased] (or [未发布]) H2 section to a versioned H2,
+ * and insert a new empty [Unreleased] section right after the H1 (if any).
+ *
+ * If no [Unreleased] / [未发布] section is found, returns content unchanged
+ * (degraded fallback — user's CHANGELOG may use non-Keep-a-Changelog format).
+ * --- separators and other user formatting are preserved verbatim.
+ */
+export declare function promoteUnreleasedSection(content: string, version: string, frozenAt: string): string;

package/dist/changelog.js

@@ -0,0 +1,34 @@
+/**
+ * Promote the [Unreleased] (or [未发布]) H2 section to a versioned H2,
+ * and insert a new empty [Unreleased] section right after the H1 (if any).
+ *
+ * If no [Unreleased] / [未发布] section is found, returns content unchanged
+ * (degraded fallback — user's CHANGELOG may use non-Keep-a-Changelog format).
+ * --- separators and other user formatting are preserved verbatim.
+ */
+export function promoteUnreleasedSection(content, version, frozenAt) {
+    const lines = content.split("\n");
+    // 找 [Unreleased] 或 [未发布] H2
+    const unreleasedIdx = lines.findIndex((l) => /^##\s+\[Unreleased\]\s*$/.test(l) || /^##\s+\[未发布\]\s*$/.test(l));
+    if (unreleasedIdx < 0)
+        return content; // 降级:找不到不动
+    // promote
+    lines[unreleasedIdx] = `## [${version}] - ${frozenAt}`;
+    // 找 H1(`# `开头),在其后第一个非空行前插新 [Unreleased] 段
+    const h1Idx = lines.findIndex((l) => /^#\s+/.test(l));
+    const insertSegment = ["## [Unreleased]", ""];
+    if (h1Idx >= 0) {
+        // 跳过 H1 后的连续空行
+        let insertAt = h1Idx + 1;
+        while (insertAt < lines.length && lines[insertAt].trim() === "")
+            insertAt++;
+        // 在 insertAt 之前插:[Unreleased] 段 + 一个空行
+        lines.splice(insertAt, 0, ...insertSegment, "");
+    }
+    else {
+        // 没 H1,塞最顶
+        lines.unshift(...insertSegment, "");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=changelog.js.map

package/dist/changelog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.js","sourceRoot":"","sources":["../src/changelog.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAe,EACf,OAAe,EACf,QAAgB;IAEhB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,4BAA4B;IAC5B,MAAM,aAAa,GAAG,KAAK,CAAC,SAAS,CACnC,CAAC,CAAC,EAAE,EAAE,CAAC,0BAA0B,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,CACzE,CAAC;IACF,IAAI,aAAa,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC,CAAC,WAAW;IAElD,UAAU;IACV,KAAK,CAAC,aAAa,CAAC,GAAG,OAAO,OAAO,OAAO,QAAQ,EAAE,CAAC;IAEvD,2CAA2C;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,MAAM,aAAa,GAAG,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;IAC9C,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,eAAe;QACf,IAAI,QAAQ,GAAG,KAAK,GAAG,CAAC,CAAC;QACzB,OAAO,QAAQ,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,QAAQ,EAAE,CAAC;QAC5E,uCAAuC;QACvC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,EAAE,GAAG,aAAa,EAAE,EAAE,CAAC,CAAC;IAClD,CAAC;SAAM,CAAC;QACN,WAAW;QACX,KAAK,CAAC,OAAO,CAAC,GAAG,aAAa,EAAE,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};