@prd-improve/cli 1.0.0

package/dist/commands/push.js

@@ -0,0 +1,392 @@
+/**
+ * `prd push <slug> [--backend <name>] [--allow-create] [--skip-frozen]` (T6).
+ *
+ * Flow (design §6.2):
+ *   1. Load local working/prd.yaml (missing → exit 1).
+ *   2. Load sync.json (may be missing; combined with --allow-create gates the
+ *      create path).
+ *   3. Resolve backend.
+ *   4. HEAD /api/features/<slug> — branches into create / push / refuse:
+ *        - 404 + --allow-create → PUT with If-Match: *
+ *        - 404 no flag → exit 1
+ *        - 200 + ETag == base    → PUT with If-Match: <id>
+ *        - 200 + ETag != base    → exit 1 (tell user to pull)
+ *   5. Run local validate — refuse to push broken yaml (single source of truth
+ *      uses runValidateCommand which captures stdout to keep our own output
+ *      narrow).
+ *   6. PUT yaml. 409 → stash + exit 1.
+ *   7. Frozen sync (unless --skip-frozen): list local frozen/v*, GET remote
+ *      list, POST diff. Best-effort: network failure → warn but continue.
+ *      Hash conflict → exit 1 (frozen immutability red line).
+ *   8. Update sync.json.
+ */
+import { existsSync, readFileSync, readdirSync, } from "node:fs";
+import { join } from "node:path";
+import { createHash } from "node:crypto";
+import { apiFetch, apiHead, 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 { runValidateCommand } from "./validate.js";
+import { VERSION_REGEX } from "../workspace.js";
+import { getMessages, readLocale } from "../i18n/index.js";
+import * as c from "../formatter/colors.js";
+export async function runPushCommand(opts, cwd) {
+    const m = getMessages(readLocale());
+    if (!opts.slug) {
+        process.stderr.write(c.fail("✗ ") + "Usage: prd push <slug>\n");
+        return 1;
+    }
+    // 1. Read local working/prd.yaml.
+    const workingPath = join(cwd, ".prd", "features", opts.slug, "working", "prd.yaml");
+    if (!existsSync(workingPath)) {
+        // Q1 boundary (spec §14 + Task 8): even with --allow-create, push refuses
+        // to invent yaml. yaml is the single source of truth — auto-generating
+        // it would leak guesses for meta.team / meta.project / meta.feature and
+        // bypass the migrate-yaml validation. Surface the actionable next step
+        // (run `prd init <slug> --team <t> --project <p>`) rather than the generic
+        // "yaml missing" message.
+        const key = opts.allowCreate
+            ? "push_allow_create_needs_yaml"
+            : "push_working_not_found";
+        process.stderr.write(c.fail("✗ ") +
+            m[key]({ slug: opts.slug, path: workingPath }) +
+            "\n");
+        return 1;
+    }
+    const localYaml = normalizeLineEndings(readFileSync(workingPath, "utf8"));
+    // v1.1: derive (team, project, feature) from yaml meta — single source of
+    // truth per spec §4.2 / §6.2. Errors here mean v0.1 yaml; surface the
+    // migrate-yaml hint so the user can self-recover before pushing.
+    let scope;
+    try {
+        scope = parseMetaScope(localYaml);
+    }
+    catch (e) {
+        process.stderr.write(c.fail("✗ ") + e.message + "\n");
+        process.stderr.write(m.api_v0_gone_hint + "\n");
+        return 1;
+    }
+    // 2. Read sync.json (optional).
+    const sync = readSyncJson(cwd, opts.slug);
+    // 3. Resolve backend.
+    const loaded = loadRcWithWarn(opts.rcPath);
+    if (loaded.hadError)
+        return 1;
+    const backend = requireBackend(loaded.rc, { backend: opts.backend });
+    if (!backend)
+        return 1;
+    const featureUrl = projectUrl(scope.team, scope.project, "features", scope.feature);
+    // 4. HEAD probe to decide create / push / refuse.
+    const head = await apiHead(backend, featureUrl, {
+        fetchFn: opts.fetchFn,
+    });
+    let ifMatch;
+    if (head.ok) {
+        const remoteEtag = (head.headers.get("ETag") ?? head.headers.get("etag") ?? "").replace(/^"|"$/g, "");
+        if (!sync) {
+            // Local has no sync.json but remote exists — user must pull first to
+            // adopt remote's base_version_id. We refuse rather than guess.
+            process.stderr.write(c.fail("✗ ") +
+                m.push_remote_exists_needs_pull({
+                    remote: remoteEtag,
+                    base: "(none)",
+                }) +
+                "\n");
+            return 1;
+        }
+        if (remoteEtag !== sync.base_version_id) {
+            process.stderr.write(c.fail("✗ ") +
+                m.push_remote_exists_needs_pull({
+                    remote: remoteEtag,
+                    base: sync.base_version_id,
+                }) +
+                "\n");
+            return 1;
+        }
+        ifMatch = sync.base_version_id;
+    }
+    else if (head.status === 410 || head.code === "API_V0_GONE") {
+        process.stderr.write(c.fail("✗ ") + m.api_v0_gone_hint + "\n");
+        return 1;
+    }
+    else if (head.status === 404) {
+        // HEAD carries no body; follow up with GET to read body.code so we can
+        // distinguish scope-miss (NOT_FOUND — team/project inaccessible) from
+        // feature-miss (FEATURE_NOT_FOUND — project accessible but no such feature).
+        const probe = await apiFetch(backend, featureUrl, {
+            fetchFn: opts.fetchFn,
+        });
+        const probeCode = !probe.ok ? probe.code : "FEATURE_NOT_FOUND";
+        if (probeCode === "FEATURE_NOT_FOUND") {
+            if (!opts.allowCreate) {
+                process.stderr.write(c.fail("✗ ") +
+                    m.push_remote_not_found_no_create({ slug: opts.slug }) +
+                    "\n");
+                return 1;
+            }
+            ifMatch = "*";
+        }
+        else if (probeCode === "NOT_FOUND") {
+            process.stderr.write(c.fail("✗ ") +
+                m.push_no_access({ team: scope.team, project: scope.project }) +
+                "\n");
+            return 1;
+        }
+        else {
+            // Unexpected error from follow-up GET; surface as-is.
+            process.stderr.write(c.fail("✗ ") + `GET failed: ${probeCode} — ${!probe.ok ? probe.message : ""}\n`);
+            return 1;
+        }
+    }
+    else if (head.network) {
+        process.stderr.write(c.fail("✗ ") + m.push_network_error({ message: head.message }) + "\n");
+        return 1;
+    }
+    else {
+        process.stderr.write(c.fail("✗ ") + `HEAD failed: ${head.code} — ${head.message}\n`);
+        return 1;
+    }
+    // 5. Pre-validate local yaml — refuse to push broken content. Capture
+    // validate's stdout so we don't double-render the validate report; we only
+    // surface the success/fail decision via the exit code.
+    const captured = captureValidate(opts.slug, cwd);
+    if (captured.code !== 0) {
+        // Print whatever validate said so the user sees the underlying issues.
+        process.stderr.write(captured.stdout);
+        process.stderr.write(captured.stderr);
+        process.stderr.write(c.fail("✗ ") + m.push_local_validate_failed + "\n");
+        return 1;
+    }
+    // 6. PUT working yaml.
+    const put = await apiFetch(backend, featureUrl, {
+        method: "PUT",
+        headers: {
+            "If-Match": ifMatch,
+            "content-type": "application/yaml",
+        },
+        body: localYaml,
+        fetchFn: opts.fetchFn,
+    });
+    if (!put.ok) {
+        if (put.code === "API_V0_GONE" || put.status === 410) {
+            process.stderr.write(c.fail("✗ ") + m.api_v0_gone_hint + "\n");
+            return 1;
+        }
+        if (put.code === "VERSION_MISMATCH" && put.status === 409) {
+            // Stash + recover working/ + sync.json so the next `prd push` is not
+            // doomed to repeat the same 409 against the stale base.
+            const remoteYaml = extractRemoteYaml(put.details);
+            const remoteVersionId = extractRemoteVersionId(put.details);
+            const usableRemoteYaml = remoteYaml ?? "(remote yaml unavailable in error details)";
+            const dir = stashConflict(cwd, opts.slug, {
+                localYaml,
+                remoteYaml: usableRemoteYaml,
+                baseVersionId: sync?.base_version_id,
+                remoteVersionId,
+            });
+            // Sibling responsibility to stashConflict: working/ now == remote, so
+            // sync.json must reflect that new base or the next push 409s identically.
+            // Skip the rewrite only when we genuinely could not learn the remote
+            // version id — in that case leaving sync.json untouched is the lesser
+            // evil (vs. fabricating a base_version_id that no longer matches the
+            // working bytes).
+            if (remoteVersionId && remoteYaml !== undefined) {
+                writeSyncJson(cwd, opts.slug, {
+                    base_version_id: remoteVersionId,
+                    last_synced_hash: "sha256:" +
+                        createHash("sha256").update(remoteYaml).digest("hex"),
+                    last_pulled_at: new Date().toISOString(),
+                    last_pushed_at: sync?.last_pushed_at,
+                    backend_url: backend.url,
+                    team: scope.team,
+                    project: scope.project,
+                });
+            }
+            process.stderr.write(c.fail("✗ ") + m.push_409_conflict({ dir }) + "\n");
+            process.stderr.write(m.push_409_conflict_hint({ dir }) + "\n");
+            return 1;
+        }
+        if (put.network) {
+            process.stderr.write(c.fail("✗ ") + m.push_network_error({ message: put.message }) + "\n");
+            return 1;
+        }
+        process.stderr.write(c.fail("✗ ") + `PUT failed: ${put.code} — ${put.message}\n`);
+        return 1;
+    }
+    const newVersion = put.body?.data?.version_id ??
+        (put.headers.get("ETag") ?? "").replace(/^"|"$/g, "");
+    process.stdout.write(c.pass("✓ ") +
+        m.push_success({ slug: opts.slug, version: newVersion }) +
+        "\n");
+    // 7. Frozen sync (best-effort).
+    if (!opts.skipFrozen) {
+        const code = await syncFrozenVersions(backend, opts.slug, scope, cwd, m, opts.fetchFn);
+        if (code !== 0)
+            return code;
+    }
+    else {
+        const frozenCount = listLocalFrozenVersions(cwd, opts.slug).length;
+        if (frozenCount > 0) {
+            process.stdout.write(m.push_frozen_sync_skipped({ count: frozenCount }) + "\n");
+        }
+    }
+    // 8. Update sync.json.
+    writeSyncJson(cwd, opts.slug, {
+        base_version_id: newVersion,
+        last_synced_hash: "sha256:" + createHash("sha256").update(localYaml).digest("hex"),
+        last_pushed_at: new Date().toISOString(),
+        last_pulled_at: sync?.last_pulled_at,
+        backend_url: backend.url,
+        team: scope.team,
+        project: scope.project,
+    });
+    return 0;
+}
+/**
+ * Capture validate's IO so we don't double-render its report. The validate
+ * driver writes to stdout/stderr in normal use, which would confuse `prd
+ * push` output. We swap streams temporarily.
+ */
+function captureValidate(slug, cwd) {
+    let stdout = "";
+    let stderr = "";
+    const origOut = process.stdout.write.bind(process.stdout);
+    const origErr = process.stderr.write.bind(process.stderr);
+    process.stdout.write = ((s) => {
+        stdout += s;
+        return true;
+    });
+    process.stderr.write = ((s) => {
+        stderr += s;
+        return true;
+    });
+    let code;
+    try {
+        code = runValidateCommand({ feature: slug }, cwd);
+    }
+    finally {
+        process.stdout.write = origOut;
+        process.stderr.write = origErr;
+    }
+    return { code, stdout, stderr };
+}
+function extractRemoteYaml(details) {
+    if (!details || typeof details !== "object")
+        return undefined;
+    const d = details;
+    // Server's VERSION_MISMATCH details shape (features.ts): { expected, actual, remote: <FeatureRow with yaml_content> }
+    if (d.remote && typeof d.remote === "object" && typeof d.remote.yaml_content === "string") {
+        return d.remote.yaml_content;
+    }
+    return undefined;
+}
+/**
+ * Pull the remote's current version_id out of the 409 details so push.ts can
+ * stamp sync.json correctly. Server's PUT 409 sends `actual` as the live
+ * version_id (see features.ts: ApiError('VERSION_MISMATCH', 409, ..., {
+ * expected, actual, remote })). Fall back to remote.version_id since the
+ * patch-fields path emits a slimmer details shape without `actual`.
+ */
+function extractRemoteVersionId(details) {
+    if (!details || typeof details !== "object")
+        return undefined;
+    const d = details;
+    if (typeof d.actual === "string")
+        return d.actual;
+    if (d.remote && typeof d.remote === "object" && typeof d.remote.version_id === "string") {
+        return d.remote.version_id;
+    }
+    return undefined;
+}
+function listLocalFrozenVersions(cwd, slug) {
+    const frozenDir = join(cwd, ".prd", "features", slug, "frozen");
+    if (!existsSync(frozenDir))
+        return [];
+    try {
+        return readdirSync(frozenDir).filter((n) => VERSION_REGEX.test(n));
+    }
+    catch {
+        return [];
+    }
+}
+async function syncFrozenVersions(backend, slug, scope, cwd, m, fetchFn) {
+    const localVersions = listLocalFrozenVersions(cwd, slug);
+    if (localVersions.length === 0)
+        return 0;
+    process.stdout.write(m.push_frozen_sync_start + "\n");
+    const versionsUrl = projectUrl(scope.team, scope.project, "features", scope.feature, "versions");
+    // GET remote list — best-effort. Failure → warn, fall back to "try them all".
+    const list = await apiFetch(backend, versionsUrl, { fetchFn });
+    const remoteByVersion = new Map();
+    if (list.ok) {
+        for (const row of list.body.data ?? []) {
+            remoteByVersion.set(row.version, row.source_hash);
+        }
+    }
+    else {
+        process.stdout.write(c.warn(m.push_frozen_sync_warn({
+            version: "(list)",
+            message: list.message,
+        })) + "\n");
+    }
+    for (const version of localVersions) {
+        const frozenPath = join(cwd, ".prd", "features", slug, "frozen", version, "prd.yaml");
+        if (!existsSync(frozenPath))
+            continue;
+        const yamlText = normalizeLineEndings(readFileSync(frozenPath, "utf8"));
+        const sourceHash = createHash("sha256")
+            .update(yamlText)
+            .digest("hex");
+        if (remoteByVersion.has(version)) {
+            if (remoteByVersion.get(version) === sourceHash) {
+                process.stdout.write(c.dim(m.push_frozen_sync_already({ version })) + "\n");
+                continue;
+            }
+            // Hash conflict on the SAME version number → red-line violation.
+            process.stderr.write(c.fail("✗ ") +
+                m.push_frozen_sync_hash_conflict({ version }) +
+                "\n");
+            return 1;
+        }
+        // Read frozen_at from snapshot.json if present, so the server gets the
+        // original freeze timestamp (not "now").
+        let frozenAt;
+        const snapshotPath = join(cwd, ".prd", "features", slug, "frozen", version, "snapshot.json");
+        if (existsSync(snapshotPath)) {
+            try {
+                frozenAt = JSON.parse(readFileSync(snapshotPath, "utf8")).frozen_at;
+            }
+            catch {
+                // ignore — server will fill in now()
+            }
+        }
+        const post = await apiFetch(backend, versionsUrl, {
+            method: "POST",
+            headers: {
+                "X-Version": version,
+                ...(frozenAt ? { "X-Frozen-At": frozenAt } : {}),
+                "content-type": "application/yaml",
+            },
+            body: yamlText,
+            fetchFn,
+        });
+        if (post.ok) {
+            process.stdout.write(c.pass(m.push_frozen_sync_uploaded({ version })) + "\n");
+            continue;
+        }
+        if (post.code === "VERSION_MISMATCH" && post.status === 409) {
+            // Idempotent path failed → hash conflict. Same red line as above.
+            process.stderr.write(c.fail("✗ ") +
+                m.push_frozen_sync_hash_conflict({ version }) +
+                "\n");
+            return 1;
+        }
+        // Network / 5xx / etc — warn but continue with next version (best-effort
+        // sync per design §6.2 step 7).
+        process.stdout.write(c.warn(m.push_frozen_sync_warn({ version, message: post.message })) + "\n");
+    }
+    return 0;
+}
+//# sourceMappingURL=push.js.map

package/dist/commands/push.js.map

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

package/dist/commands/refresh.d.ts

@@ -0,0 +1,9 @@
+export interface RefreshOptions {
+    feature: string;
+    newPrd?: string;
+    prdAnchor?: string;
+    prdAnchorExact?: boolean;
+    out?: string;
+    format?: "md" | "json";
+}
+export declare function runRefreshCommand(opts: RefreshOptions, cwd: string): number;

package/dist/commands/refresh.js

@@ -0,0 +1,123 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join, dirname, extname } from "node:path";
+import { getMessages, readLocale } from "../i18n/index.js";
+import * as c from "../formatter/colors.js";
+import { indexYaml } from "../yaml-indexer.js";
+import { sliceByAnchor } from "../anchor-slicer.js";
+import { renderRefreshMd } from "../renderer/refresh-md.js";
+export function runRefreshCommand(opts, cwd) {
+    const locale = readLocale();
+    const m = getMessages(locale);
+    process.stderr.write(c.dim("→ ") + m.refresh_started({ feature: opts.feature }) + "\n");
+    const yamlPath = join(cwd, ".prd", "features", opts.feature, "working", "prd.yaml");
+    if (!existsSync(yamlPath)) {
+        process.stderr.write(c.fail("✗ ") +
+            m.refresh_yaml_not_found({ feature: opts.feature, path: yamlPath }) +
+            "\n");
+        return 1;
+    }
+    let yamlText;
+    try {
+        yamlText = readFileSync(yamlPath, "utf-8");
+    }
+    catch (e) {
+        process.stderr.write(c.fail("✗ ") + `read failed: ${e.message}` + "\n");
+        return 2;
+    }
+    const yamlLines = yamlText.split("\n").length;
+    process.stderr.write(c.pass("✓ ") + m.refresh_loaded_yaml({ lines: yamlLines }) + "\n");
+    const index = indexYaml(yamlText);
+    process.stderr.write(c.pass("✓ ") +
+        m.refresh_indexed_entries({ count: index.entries.length }) +
+        "\n");
+    // PRD anchor 切片(可选)
+    let slice;
+    if (opts.newPrd && opts.prdAnchor) {
+        // 1. 先检查文件存在(比后缀更基础的错误)
+        if (!existsSync(opts.newPrd)) {
+            process.stderr.write(c.fail("✗ ") +
+                m.refresh_new_prd_not_found({ path: opts.newPrd }) +
+                "\n");
+            return 1;
+        }
+        // 2. 后检查 markdown 后缀
+        const ext = extname(opts.newPrd).toLowerCase();
+        if (ext !== ".md" && ext !== ".markdown") {
+            process.stderr.write(c.fail("✗ ") +
+                m.refresh_prd_not_markdown({ path: opts.newPrd }) +
+                "\n");
+            return 1;
+        }
+        const prdText = readFileSync(opts.newPrd, "utf-8");
+        const result = sliceByAnchor(prdText, opts.prdAnchor, {
+            exact: opts.prdAnchorExact,
+        });
+        if (!result.found) {
+            if (result.matches?.length) {
+                process.stderr.write(c.fail("✗ ") +
+                    m.refresh_anchor_multiple_matches({
+                        anchor: opts.prdAnchor,
+                        count: result.matches.length,
+                    }) +
+                    "\n");
+                const lines = result.matches
+                    .map((h) => `  L${h.line}: ${h.heading}`)
+                    .join("\n");
+                process.stderr.write(m.refresh_anchor_candidates_hint({ lines }) + "\n");
+            }
+            else {
+                process.stderr.write(c.fail("✗ ") +
+                    m.refresh_anchor_not_found({ anchor: opts.prdAnchor }) +
+                    "\n");
+            }
+            return 1;
+        }
+        slice = { anchor: opts.prdAnchor, result };
+    }
+    const generatedAt = new Date().toISOString();
+    let output;
+    if (opts.format === "json") {
+        output = JSON.stringify({
+            feature: opts.feature,
+            yaml_path: yamlPath,
+            yaml_lines: index.yamlLines,
+            schema_version: index.schemaVersion,
+            generated_at: generatedAt,
+            entries: index.entries,
+            reverse_refs: index.reverseRefs,
+            prd_section: slice?.result.found
+                ? {
+                    anchor: slice.anchor,
+                    start: slice.result.sliceStart,
+                    end: slice.result.sliceEnd,
+                    text: slice.result.slice,
+                }
+                : null,
+        }, null, 2);
+    }
+    else {
+        output = renderRefreshMd({
+            feature: opts.feature,
+            yamlPath,
+            index,
+            generatedAt,
+            slice,
+        }, m);
+    }
+    if (opts.out) {
+        try {
+            mkdirSync(dirname(opts.out), { recursive: true });
+            writeFileSync(opts.out, output);
+            process.stderr.write(c.pass("✓ ") + m.refresh_output_written({ path: opts.out }) + "\n");
+        }
+        catch (e) {
+            process.stderr.write(c.fail("✗ ") + `write failed: ${e.message}` + "\n");
+            return 2;
+        }
+    }
+    else {
+        process.stdout.write(output + "\n");
+    }
+    return 0;
+}
+//# sourceMappingURL=refresh.js.map

package/dist/commands/refresh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh.js","sourceRoot":"","sources":["../../src/commands/refresh.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,CAAC,MAAM,wBAAwB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAoB,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAW5D,MAAM,UAAU,iBAAiB,CAAC,IAAoB,EAAE,GAAW;IACjE,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAE9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAClE,CAAC;IAEF,MAAM,QAAQ,GAAG,IAAI,CACnB,GAAG,EACH,MAAM,EACN,UAAU,EACV,IAAI,CAAC,OAAO,EACZ,SAAS,EACT,UAAU,CACX,CAAC;IAEF,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YACV,CAAC,CAAC,sBAAsB,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;YACnE,IAAI,CACP,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,QAAQ,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,gBAAiB,CAAW,CAAC,OAAO,EAAE,GAAG,IAAI,CAC7D,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;IAC9C,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,mBAAmB,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,GAAG,IAAI,CAClE,CAAC;IAEF,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACV,CAAC,CAAC,uBAAuB,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC1D,IAAI,CACP,CAAC;IAEF,oBAAoB;IACpB,IAAI,KAA0D,CAAC;IAC/D,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QAClC,wBAAwB;QACxB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gBACV,CAAC,CAAC,yBAAyB,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;gBAClD,IAAI,CACP,CAAC;YACF,OAAO,CAAC,CAAC;QACX,CAAC;QACD,qBAAqB;QACrB,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC/C,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YACzC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gBACV,CAAC,CAAC,wBAAwB,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjD,IAAI,CACP,CAAC;YACF,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE;YACpD,KAAK,EAAE,IAAI,CAAC,cAAc;SAC3B,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAClB,IAAI,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;gBAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;oBACV,CAAC,CAAC,+BAA+B,CAAC;wBAChC,MAAM,EAAE,IAAI,CAAC,SAAS;wBACtB,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;qBAC7B,CAAC;oBACF,IAAI,CACP,CAAC;gBACF,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO;qBACzB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;qBACxC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,CAAC,CAAC,8BAA8B,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CACnD,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;oBACV,CAAC,CAAC,wBAAwB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;oBACtD,IAAI,CACP,CAAC;YACJ,CAAC;YACD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,KAAK,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAC7C,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE7C,IAAI,MAAc,CAAC;IACnB,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC3B,MAAM,GAAG,IAAI,CAAC,SAAS,CACrB;YACE,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,QAAQ;YACnB,UAAU,EAAE,KAAK,CAAC,SAAS;YAC3B,cAAc,EAAE,KAAK,CAAC,aAAa;YACnC,YAAY,EAAE,WAAW;YACzB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,YAAY,EAAE,KAAK,CAAC,WAAW;YAC/B,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK;gBAC9B,CAAC,CAAC;oBACE,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU;oBAC9B,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ;oBAC1B,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK;iBACzB;gBACH,CAAC,CAAC,IAAI;SACT,EACD,IAAI,EACJ,CAAC,CACF,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,eAAe,CACtB;YACE,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ;YACR,KAAK;YACL,WAAW;YACX,KAAK;SACN,EACD,CAAC,CACF,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,IAAI,CAAC;YACH,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAClD,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,sBAAsB,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CACnE,CAAC;QACJ,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,iBAAkB,CAAW,CAAC,OAAO,EAAE,GAAG,IAAI,CAC9D,CAAC;YACF,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/commands/status.d.ts

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