@asturiu/v0-sdk 0.0.0-stage → 1.0.0

package/dist/cli/context.js

@@ -0,0 +1,258 @@
+/**
+ * What every command of `asturiu-v0-tenant` shares: the run's context, failures the person can act on, the Tenant
+ * API through the SDK's own calls, and the repository's local state. The Tenant key is read from the environment and
+ * never printed (ADR-074 §14).
+ */
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import * as sdk from "../index.js";
+import { TenantApiError, parseTenantKey } from "../definition-set.js";
+import { folderSources } from "./sources.js";
+import { plain } from "./terminal.js";
+/** The exit codes (ADR-074 §5). */
+export const EXIT = { done: 0, failed: 1, misunderstood: 2, notReported: 3 };
+/** A failure the person can act on: a title, what happened, what to do. */
+export class Fail extends Error {
+    hint;
+    lines;
+    code;
+    data;
+    constructor(message, o = {}) {
+        super(message);
+        this.hint = o.hint;
+        this.lines = o.lines ?? [];
+        this.code = o.code ?? EXIT.failed;
+        this.data = o.data;
+    }
+}
+/** The repository's configuration: `asturiu.config.mjs` at its root, else `asturiu/config.mjs`, else none. */
+export async function loadConfig(root) {
+    for (const name of ["asturiu.config.mjs", path.join("asturiu", "config.mjs")]) {
+        const file = path.join(root, name);
+        if (!existsSync(file))
+            continue;
+        const mod = (await import(pathToFileURL(file).href));
+        return { ...(mod.default ?? mod), file: name };
+    }
+    return {};
+}
+/** How the person runs this, for the hints: the package script when there is one, else `npx --no-install asturiu-v0-tenant`. */
+export function commandPrefix(env, fallback) {
+    const script = env.npm_lifecycle_event;
+    const ua = env.npm_config_user_agent ?? "";
+    if (!script || script === "npx")
+        return fallback;
+    if (ua.startsWith("pnpm"))
+        return `pnpm ${script}`;
+    if (ua.startsWith("yarn"))
+        return `yarn ${script}`;
+    if (ua.startsWith("bun"))
+        return `bun run ${script}`;
+    return `npm run ${script} --`;
+}
+/** The Tenant's slug, out of the key's first part (`atk.<slug>.…`): not a secret. */
+export function slugOf(key) {
+    if (!key)
+        return null;
+    try {
+        return parseTenantKey(key).slug;
+    }
+    catch {
+        return null;
+    }
+}
+/** The key's id, out of its second part: not a secret either. */
+export function keyIdOf(key) {
+    if (!key)
+        return null;
+    try {
+        return parseTenantKey(key).kid;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * One SDK call, with what the network answered: its HTTP status, or why it could not reach the Tenant API. A
+ * `TenantApiError` carries the status itself; the calls that never throw (`applyDefinitions` and the like) are read
+ * through the status the wrapped `fetch` saw.
+ */
+export async function call(ctx, fn) {
+    if (!ctx.key)
+        return { ok: false, why: "no-key", status: 0, network: "", message: "ASTURIU_TENANT_KEY is not set", type: null };
+    if (!ctx.cfg)
+        return { ok: false, why: "no-url", status: 0, network: "", message: "ASTURIU_TENANT_API_URL is not set", type: null };
+    const seen = { status: 0, network: "" };
+    const cfg = ctx.cfg;
+    const tracked = async (input, init) => {
+        try {
+            const res = await (ctx.fetch ?? ((i, n) => globalThis.fetch(i, n)))(input, init);
+            seen.status = res.status;
+            const expires = res.headers.get("asturiu-key-expires");
+            if (expires)
+                ctx.keyExpires = expires;
+            return res;
+        }
+        catch (err) {
+            seen.network = unreachable(err, cfg.baseUrl);
+            throw err;
+        }
+    };
+    try {
+        return { ok: true, value: await fn(tracked, cfg), ...seen };
+    }
+    catch (err) {
+        const status = err instanceof TenantApiError ? err.status : seen.status;
+        const message = seen.network || plain(err instanceof Error ? err.message : String(err));
+        const why = seen.network ? "network" : status === 404 ? "no-route" : "refused";
+        return { ok: false, why, status, network: seen.network, message, type: err instanceof TenantApiError ? err.type : null };
+    }
+}
+/** Why the Tenant API could not be reached, in words. */
+export function unreachable(err, baseUrl) {
+    const cause = err?.cause;
+    const code = cause?.code ?? "";
+    const words = {
+        ECONNREFUSED: "nothing answers there",
+        ENOTFOUND: "the host is unknown",
+        EAI_AGAIN: "the host could not be looked up",
+        ETIMEDOUT: "it did not answer in time",
+        UND_ERR_CONNECT_TIMEOUT: "it did not answer in time",
+        ECONNRESET: "the connection was cut",
+        EPERM: "the connection was not permitted here (a sandbox?)",
+        EHOSTUNREACH: "the host cannot be reached",
+        CERT_HAS_EXPIRED: "its certificate has expired",
+        DEPTH_ZERO_SELF_SIGNED_CERT: "its certificate is self-signed",
+        UNABLE_TO_VERIFY_LEAF_SIGNATURE: "its certificate could not be verified",
+    };
+    return `could not reach the Tenant API at ${hostOf(baseUrl)}: ${words[code] ?? plain(cause?.message ?? (err instanceof Error ? err.message : String(err)))}`;
+}
+export const hostOf = (url) => {
+    if (!url)
+        return "—";
+    try {
+        return new URL(url).host;
+    }
+    catch {
+        return url;
+    }
+};
+/** A failed read in a few words, for a status line. */
+export function readFailure(r, scope) {
+    if (r.why === "no-key")
+        return "not read: ASTURIU_TENANT_KEY is not set";
+    if (r.why === "no-url")
+        return "not read: ASTURIU_TENANT_API_URL is not set";
+    if (r.why === "no-route")
+        return scope ? `not read: the key lacks the scope “${scope}”, or the Engine has no such route` : "not read: the Engine has no such route";
+    if (r.status === 401)
+        return "not read: the Tenant API refused the key (revoked, expired, or for another Tenant)";
+    return `not read: ${r.message}`;
+}
+/** The repository's sources, made once. */
+export function sources(ctx) {
+    if (!ctx._sources) {
+        const s = ctx.config.sources;
+        ctx._sources = typeof s === "function" ? s({ root: ctx.root, kit: sdk }) : (s ?? folderSources({ root: ctx.root }));
+    }
+    return ctx._sources;
+}
+/** Fails when no key or address is set: for commands that cannot do anything without. */
+export function needTenantApi(ctx, what) {
+    if (!ctx.key)
+        throw new Fail(`ASTURIU_TENANT_KEY is not set: ${what}`, { lines: ["The Tenant key is made in the Admin UI (your Tenant › Tenant keys) with the scopes the repository needs. Put it in the server's environment, or in .env, as ASTURIU_TENANT_KEY. Never paste it into a chat, a file under version control or a report."], hint: `${ctx.cmd} doctor checks the whole set-up` });
+    if (!ctx.cfg)
+        throw new Fail(`ASTURIU_TENANT_API_URL is not set: ${what}`, { lines: ["It is the Tenant API's address, given with your Tenant."] });
+}
+/** One JSON document on stdout. */
+export function emit(ctx, data) {
+    ctx.t.out(JSON.stringify(data, null, 2));
+}
+// ================================================================== local state
+export function places(ctx) {
+    return {
+        state: path.join(ctx.root, "asturiu", ".state.json"),
+        queue: path.join(ctx.root, "asturiu", "feedback", "queue"),
+        sent: path.join(ctx.root, "asturiu", "feedback", "sent"),
+        offline: path.join(ctx.root, "asturiu-feedback"),
+        changesets: path.join(ctx.root, ctx.config.changesetsDir ?? path.join("asturiu", "changesets")),
+        agents: path.join(ctx.root, ctx.config.agentsFile ?? "AGENTS.md"),
+    };
+}
+export const rel = (ctx, file) => path.relative(ctx.root, file) || ".";
+export function readState(ctx) {
+    try {
+        return JSON.parse(readFileSync(places(ctx).state, "utf8"));
+    }
+    catch {
+        return {};
+    }
+}
+export function writeState(ctx, patch) {
+    const file = places(ctx).state;
+    mkdirSync(path.dirname(file), { recursive: true });
+    writeFileSync(file, `${JSON.stringify({ ...readState(ctx), ...patch }, null, 2)}\n`);
+}
+/** The Engine version and changeset the Asturiu section in AGENTS.md was written for. */
+export function agentsSection(ctx) {
+    try {
+        const m = /<!-- asturiu:begin engine=(\S+) changeset=(\d+) -->/.exec(readFileSync(places(ctx).agents, "utf8"));
+        return m ? { engine: m[1], changeset: Number(m[2]) } : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** The changesets the repository records as done. */
+export function recorded(ctx) {
+    if (ctx.config.recorded)
+        return ctx.config.recorded(ctx.root);
+    const upTo = agentsSection(ctx)?.changeset ?? 0;
+    return new Set(Array.from({ length: upTo }, (_, i) => i + 1));
+}
+export function pulledDocuments(ctx) {
+    const dir = places(ctx).changesets;
+    return new Set(existsSync(dir) ? readdirSync(dir) : []);
+}
+/** Whether git ignores a path: true, false, or null outside a repository. */
+export function gitIgnores(ctx, file) {
+    const r = spawnSync("git", ["check-ignore", "-q", rel(ctx, file)], { cwd: ctx.root, stdio: "ignore" });
+    if (r.error || (r.status !== 0 && r.status !== 1))
+        return null;
+    return r.status === 0;
+}
+// ================================================================== secrets
+/** Text that looks like a secret: the Tenant key, a token, a session, a password. Reports and notes never carry one. */
+export function secretIn(ctx, text) {
+    if (ctx.key && text.includes(ctx.key))
+        return "the Tenant key";
+    if (/\batk\.[a-z0-9-]+\.[0-9a-f]{8,}\./i.test(text))
+        return "a Tenant key";
+    if (/-----BEGIN [A-Z ]*PRIVATE KEY-----/.test(text))
+        return "a private key";
+    if (/\beyJ[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}\./.test(text))
+        return "a token";
+    if (/\b(authorization:\s*(bearer|asturiu-assertion)\s+\S{12,}|x-asturiu-session:\s*\S{12,})/i.test(text))
+        return "a credential header";
+    if (/\b[a-z0-9_]*session=[A-Za-z0-9._~%-]{16,}/i.test(text))
+        return "a session identifier";
+    if (/\b(app_password|client_secret|password)\s*[:=]\s*\S{6,}/i.test(text))
+        return "a password or client secret";
+    for (const re of ctx.config.secrets ?? [])
+        if (re.test(text))
+            return "a secret this repository names";
+    return null;
+}
+/** Fails when the text holds a secret: nothing is sent. */
+export function refuseSecrets(ctx, ...texts) {
+    for (const text of texts) {
+        const secret = text ? secretIn(ctx, text) : null;
+        if (secret)
+            throw new Fail(`The text looks like it holds ${secret}. Nothing was sent.`);
+    }
+}
+/** A flag's string value. */
+export const str = (v) => (typeof v === "string" ? v : undefined);
+//# sourceMappingURL=context.js.map

package/dist/cli/context.js.map

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

package/dist/cli/engine.d.ts

@@ -0,0 +1,59 @@
+/**
+ * The Engine as the Tenant API tells it, the SDK versions it serves (ADR-074 §4), and its changesets with this
+ * Tenant's tickets. The SDK carries no changesets (§9): without the Tenant API the list is not known, and every
+ * command says so instead of guessing.
+ */
+import type { ChangesetEntry, TenantChangeset } from "../changesets.js";
+import { type Ctx } from "./context.js";
+import type { Terminal } from "./terminal.js";
+export type Changeset = ChangesetEntry & Partial<TenantChangeset>;
+export interface EngineState {
+    live: boolean;
+    version: string | null;
+    released_at: string | null;
+    latest: number | null;
+    site: {
+        docs: string | null;
+        changesets: string | null;
+    };
+    sdk: SdkFit;
+    reason: string | null;
+}
+/** How the installed SDK stands with the Engine: `minimum` and `built_with` from `GET /tenant/v0/engine`. */
+export interface SdkFit {
+    installed: string;
+    built_with: string | null;
+    minimum: string | null;
+    /** `served`: at or above the minimum; `below-minimum`: the Engine no longer serves it without a break; `unknown`: the Engine did not say. */
+    fit: "served" | "below-minimum" | "unknown";
+    /** Whether the Engine was built with a newer SDK than the one installed. */
+    newer_available: boolean;
+    /** Whether the installed SDK is newer than the Engine knows: calls it adds may answer 404. */
+    ahead_of_engine: boolean;
+}
+/** Semantic versions compared by their numbers; a pre-release comes before its release. */
+export declare function compareVersions(a: string, b: string): number;
+export declare function sdkFit(sdk: {
+    built_with: string;
+    minimum: string;
+} | null | undefined, installed?: string): SdkFit;
+export declare function engineInfo(ctx: Ctx): Promise<EngineState>;
+/** The changesets after `since`, with the Tenant's ticket and status, when the Tenant API answers. */
+export declare function changesetList(ctx: Ctx, since: number): Promise<{
+    live: boolean;
+    latest: number | null;
+    list: Changeset[];
+    reason: string | null;
+}>;
+export declare const CLOSED: Set<string>;
+export declare const isOpen: (c: Changeset) => boolean;
+/** Open changesets in the order AGENTS.md asks for: the earliest deadline first, then the oldest. */
+export declare function byUrgency(a: Changeset, b: Changeset): number;
+/** How each status looks: its words, its colour, its symbol. */
+export declare const LOOK: Record<string, [string, "blue" | "cyan" | "yellow" | "magenta" | "green" | "gray", keyof Terminal["sym"]]>;
+/** A status as text, and painted. */
+export declare function pill(t: Terminal, key: string): {
+    text: string;
+    painted: string;
+};
+//# sourceMappingURL=engine.d.ts.map

package/dist/cli/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/cli/engine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGxE,OAAO,EAAE,KAAK,GAAG,EAAqB,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAElE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACzD,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,6GAA6G;AAC7G,MAAM,WAAW,MAAM;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,6IAA6I;IAC7I,GAAG,EAAE,QAAQ,GAAG,eAAe,GAAG,SAAS,CAAC;IAC5C,4EAA4E;IAC5E,eAAe,EAAE,OAAO,CAAC;IACzB,8FAA8F;IAC9F,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,2FAA2F;AAC3F,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAY5D;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,EAAE,SAAS,SAAc,GAAG,MAAM,CAUvH;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAI/D;AAED,sGAAsG;AACtG,wBAAsB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,SAAS,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAIxJ;AAED,eAAO,MAAM,MAAM,aAAoC,CAAC;AACxD,eAAO,MAAM,MAAM,GAAI,GAAG,SAAS,KAAG,OAAiE,CAAC;AAExG,qGAAqG;AACrG,wBAAgB,SAAS,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,MAAM,CAK5D;AAED,gEAAgE;AAChE,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,EAAE,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC,CAe3H,CAAC;AAEF,qCAAqC;AACrC,wBAAgB,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAKhF"}

package/dist/cli/engine.js

@@ -0,0 +1,85 @@
+import { readChangesets, readEngine } from "../definition-set.js";
+import { SDK_VERSION } from "../version.js";
+import { call, readFailure } from "./context.js";
+/** Semantic versions compared by their numbers; a pre-release comes before its release. */
+export function compareVersions(a, b) {
+    const parse = (v) => {
+        const [main, pre] = v.split("-", 2);
+        return { n: main.split(".").map((x) => Number(x) || 0), pre: pre ?? null };
+    };
+    const x = parse(a);
+    const y = parse(b);
+    for (let i = 0; i < 3; i++)
+        if ((x.n[i] ?? 0) !== (y.n[i] ?? 0))
+            return (x.n[i] ?? 0) - (y.n[i] ?? 0);
+    if (x.pre === y.pre)
+        return 0;
+    if (x.pre === null)
+        return 1;
+    if (y.pre === null)
+        return -1;
+    return x.pre < y.pre ? -1 : 1;
+}
+export function sdkFit(sdk, installed = SDK_VERSION) {
+    if (!sdk)
+        return { installed, built_with: null, minimum: null, fit: "unknown", newer_available: false, ahead_of_engine: false };
+    return {
+        installed,
+        built_with: sdk.built_with,
+        minimum: sdk.minimum,
+        fit: compareVersions(installed, sdk.minimum) >= 0 ? "served" : "below-minimum",
+        newer_available: compareVersions(installed, sdk.built_with) < 0,
+        ahead_of_engine: compareVersions(installed, sdk.built_with) > 0,
+    };
+}
+export async function engineInfo(ctx) {
+    const r = await call(ctx, (fetch, cfg) => readEngine({ ...cfg, fetch }));
+    if (r.ok)
+        return { live: true, version: r.value.version, released_at: r.value.released_at, latest: r.value.latest_changeset, site: r.value.site, sdk: sdkFit(r.value.sdk), reason: null };
+    return { live: false, version: null, released_at: null, latest: null, site: { docs: null, changesets: null }, sdk: sdkFit(null), reason: readFailure(r) };
+}
+/** The changesets after `since`, with the Tenant's ticket and status, when the Tenant API answers. */
+export async function changesetList(ctx, since) {
+    const r = await call(ctx, (fetch, cfg) => readChangesets({ ...cfg, since, fetch }));
+    if (r.ok)
+        return { live: true, latest: r.value.latest, list: r.value.changesets, reason: null };
+    return { live: false, latest: null, list: [], reason: readFailure(r) };
+}
+export const CLOSED = new Set(["resolved", "canceled"]);
+export const isOpen = (c) => Boolean(c.ticket && c.status && !CLOSED.has(c.status));
+/** Open changesets in the order AGENTS.md asks for: the earliest deadline first, then the oldest. */
+export function byUrgency(a, b) {
+    if (a.deadline && b.deadline)
+        return a.deadline.localeCompare(b.deadline) || a.number - b.number;
+    if (a.deadline)
+        return -1;
+    if (b.deadline)
+        return 1;
+    return a.number - b.number;
+}
+/** How each status looks: its words, its colour, its symbol. */
+export const LOOK = {
+    new: ["new", "blue", "info"],
+    acknowledged: ["acknowledged", "cyan", "open"],
+    in_progress: ["in progress", "yellow", "half"],
+    waiting: ["waiting for you", "yellow", "warn"],
+    on_hold: ["on hold", "magenta", "pause"],
+    resolved: ["resolved", "green", "ok"],
+    canceled: ["canceled", "gray", "cross"],
+    draft: ["draft", "gray", "open"],
+    scheduled: ["scheduled", "cyan", "half"],
+    published: ["published", "green", "ok"],
+    expired: ["expired", "gray", "dash"],
+    withdrawn: ["withdrawn", "gray", "cross"],
+    "nothing asked": ["nothing asked", "gray", "dash"],
+    "no ticket": ["no ticket", "gray", "dash"],
+};
+/** A status as text, and painted. */
+export function pill(t, key) {
+    const look = LOOK[key];
+    if (!look)
+        return { text: key || "—", painted: t.paint.gray(key || "—") };
+    const text = `${t.sym[look[2]]} ${look[0]}`;
+    return { text, painted: t.paint[look[1]](text) };
+}
+//# sourceMappingURL=engine.js.map

package/dist/cli/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/cli/engine.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAY,IAAI,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AA4B3D,2FAA2F;AAC3F,MAAM,UAAU,eAAe,CAAC,CAAS,EAAE,CAAS;IAClD,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,EAAE;QAC1B,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACpC,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC;IAC7E,CAAC,CAAC;IACF,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACnB,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;QAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACtG,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG;QAAE,OAAO,CAAC,CAAC;IAC9B,IAAI,CAAC,CAAC,GAAG,KAAK,IAAI;QAAE,OAAO,CAAC,CAAC;IAC7B,IAAI,CAAC,CAAC,GAAG,KAAK,IAAI;QAAE,OAAO,CAAC,CAAC,CAAC;IAC9B,OAAO,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,GAA+D,EAAE,SAAS,GAAG,WAAW;IAC7G,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,eAAe,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC;IAChI,OAAO;QACL,SAAS;QACT,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,GAAG,EAAE,eAAe,CAAC,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,eAAe;QAC9E,eAAe,EAAE,eAAe,CAAC,SAAS,EAAE,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;QAC/D,eAAe,EAAE,eAAe,CAAC,SAAS,EAAE,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;KAChE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAQ;IACvC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,GAAG,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACzE,IAAI,CAAC,CAAC,EAAE;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC1L,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5J,CAAC;AAED,sGAAsG;AACtG,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAQ,EAAE,KAAa;IACzD,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,cAAc,CAAC,EAAE,GAAG,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACpF,IAAI,CAAC,CAAC,EAAE;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAChG,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;AACzE,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;AACxD,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAY,EAAW,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAExG,qGAAqG;AACrG,MAAM,UAAU,SAAS,CAAC,CAAY,EAAE,CAAY;IAClD,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ;QAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACjG,IAAI,CAAC,CAAC,QAAQ;QAAE,OAAO,CAAC,CAAC,CAAC;IAC1B,IAAI,CAAC,CAAC,QAAQ;QAAE,OAAO,CAAC,CAAC;IACzB,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;AAC7B,CAAC;AAED,gEAAgE;AAChE,MAAM,CAAC,MAAM,IAAI,GAA+G;IAC9H,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC;IAC9C,WAAW,EAAE,CAAC,aAAa,EAAE,QAAQ,EAAE,MAAM,CAAC;IAC9C,OAAO,EAAE,CAAC,iBAAiB,EAAE,QAAQ,EAAE,MAAM,CAAC;IAC9C,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC;IACxC,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;IACrC,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC;IACvC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC;IAChC,SAAS,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC;IACxC,SAAS,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC;IACvC,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC;IACpC,SAAS,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC;IACzC,eAAe,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,CAAC;IAClD,WAAW,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC;CAC3C,CAAC;AAEF,qCAAqC;AACrC,MAAM,UAAU,IAAI,CAAC,CAAW,EAAE,GAAW;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACvB,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC;IAC1E,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;AACnD,CAAC"}

package/dist/cli/feedback.d.ts

@@ -0,0 +1,40 @@
+import type { FeedbackReport } from "../changesets.js";
+import { type Ctx } from "./context.js";
+/** The skill version this command line goes with (implement.md version 3, ADR-074 §13). */
+export declare const SKILL = "implement 3";
+/** One finding as the queue keeps it: a report's parts, before bundling. */
+export interface Finding {
+    kind: "defect" | "limitation" | "question";
+    area: string;
+    summary: string;
+    detail: string;
+    refusal?: FeedbackReport["refusal"];
+    source?: string;
+    queued_at: string;
+}
+/** The queued findings, oldest first. */
+export declare function queued(ctx: Ctx): {
+    file: string;
+    finding: Finding;
+}[];
+/**
+ * Findings in as few reports as fit: one, unless they pass 64 KiB. The kind is the most pressing of them (a defect
+ * before a limitation before a question), the areas are named together, each finding is a section of the detail. A
+ * lone finding keeps its own summary and refusal.
+ */
+export declare function bundle(findings: Finding[], o?: {
+    product?: string;
+    engine?: string;
+    changeset?: number | null;
+}): {
+    report: FeedbackReport;
+    findings: number[];
+}[];
+export declare function cmdFeedback(ctx: Ctx, args: string[]): Promise<void>;
+/** How many feedback tickets have answers since the saved place, without moving it. */
+export declare function repliesWaiting(ctx: Ctx): Promise<{
+    count: number;
+    reason: string | null;
+}>;
+export declare function cmdReply(ctx: Ctx, args: string[]): Promise<void>;
+//# sourceMappingURL=feedback.d.ts.map

package/dist/cli/feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../../src/cli/feedback.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD,OAAO,EAAE,KAAK,GAAG,EAAgI,MAAM,cAAc,CAAC;AAItK,2FAA2F;AAC3F,eAAO,MAAM,KAAK,gBAAgB,CAAC;AAQnC,4EAA4E;AAC5E,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,QAAQ,GAAG,YAAY,GAAG,UAAU,CAAC;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAyCD,yCAAyC;AACzC,wBAAgB,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,EAAE,CAOrE;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAO,GAAG;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,CAiCtK;AA+BD,wBAAsB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,iBASzD;AAoLD,uFAAuF;AACvF,wBAAsB,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAMhG;AAkCD,wBAAsB,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,iBAuBtD"}