felenova-backlog 0.1.0

package/dist/commands/next.js

@@ -0,0 +1,30 @@
+import { asArray, asRecord, CommandError, jsonResult, pad, runCommand, text, } from './common.js';
+export async function runNext(io, flags) {
+    return runCommand('next', io, flags, async (ctx) => {
+        let query = '';
+        if (flags.limit !== undefined) {
+            if (!Number.isInteger(flags.limit) || flags.limit < 1) {
+                throw new CommandError(`--limit must be a positive whole number, not ${flags.limit}`);
+            }
+            query = `?limit=${flags.limit}`;
+        }
+        const payload = await ctx.client.get(`/v1/projects/${encodeURIComponent(ctx.project)}/next${query}`);
+        if (flags.json)
+            return jsonResult(payload);
+        const result = asRecord(payload);
+        const items = asArray(result.items);
+        const lines = [];
+        for (const entry of items) {
+            const item = asRecord(entry);
+            lines.push(`${pad(text(item.id), 12)}${pad(text(item.priority), 4)}${pad(text(item.domain), 14)}${text(item.title, '(untitled)')}`);
+        }
+        if (items.length === 0) {
+            lines.push(`nothing is ready — lock some criteria (${ctx.url}/lock-queue)`);
+        }
+        for (const warning of asArray(result.warnings)) {
+            lines.push(`warning: ${text(warning, 'a prerequisite does not resolve')}`);
+        }
+        return { ok: true, lines };
+    });
+}
+//# sourceMappingURL=next.js.map

package/dist/commands/next.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.js","sourceRoot":"","sources":["../../src/commands/next.ts"],"names":[],"mappings":"AACA,OAAO,EACL,OAAO,EACP,QAAQ,EACR,YAAY,EAGZ,UAAU,EACV,GAAG,EACH,UAAU,EACV,IAAI,GACL,MAAM,aAAa,CAAC;AAerB,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,EAAa,EAAE,KAAgB;IAC3D,OAAO,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACjD,IAAI,KAAK,GAAG,EAAE,CAAC;QACf,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;gBACtD,MAAM,IAAI,YAAY,CAAC,gDAAgD,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YACxF,CAAC;YACD,KAAK,GAAG,UAAU,KAAK,CAAC,KAAK,EAAE,CAAC;QAClC,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,GAAG,CAClC,gBAAgB,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,EAAE,CAC/D,CAAC;QACF,IAAI,KAAK,CAAC,IAAI;YAAE,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC;QAE3C,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QACjC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACpC,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC7B,KAAK,CAAC,IAAI,CACR,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAC3D,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EACjB,EAAE,CACH,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,YAAY,CAAC,EAAE,CACrC,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,0CAA0C,GAAG,CAAC,GAAG,cAAc,CAAC,CAAC;QAC9E,CAAC;QACD,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/C,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,OAAO,EAAE,iCAAiC,CAAC,EAAE,CAAC,CAAC;QAC7E,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/promote.d.ts

@@ -0,0 +1,15 @@
+import type { TargetFlags } from '../config.js';
+import { type CommandIo, type CommandResult } from './common.js';
+export interface PromoteFlags extends TargetFlags {
+    ids: string[];
+    /** `--track <slug>`; absent means the service builds the slug from the first item's title. */
+    track?: string | undefined;
+    type?: string | undefined;
+    /** The track's human name for `metadata.json`; defaults to `<base> — <first item title>`. */
+    name?: string | undefined;
+    plan?: string | undefined;
+    /** Skips the items read: with it, `promote` is exactly one HTTP call. */
+    priority?: string | undefined;
+    json?: boolean | undefined;
+}
+export declare function runPromote(io: CommandIo, flags: PromoteFlags): Promise<CommandResult>;

package/dist/commands/promote.js

@@ -0,0 +1,172 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join, relative } from 'node:path';
+import { PRIORITIES, renderTrackFiles, TRACK_FILENAMES, trackBaseName, } from '../_core/index.js';
+import { addActiveTrack, dropNextRow } from '../conductor/registry.js';
+import { asArray, asRecord, CommandError, jsonResult, renderFailure, runCommand, text, } from './common.js';
+/**
+ * `backlog promote <ID…>` — the local half of `promote_items` (§6.2). The service owns the
+ * promotion; the CLI owns the files. Two things make the order matter:
+ *
+ *  1. **The directory is checked first.** A promotion the service accepted while the local
+ *     write refuses leaves an item `promoted` with no track files — the worst state in the
+ *     system. So when `--track` names a directory that already exists, nothing is sent at all.
+ *  2. **Nothing is written until every path is clear.** The three files are rendered in
+ *     memory, the leaf directory is created with `recursive: false` so a race still fails,
+ *     and only then does anything land on disk.
+ */
+const TRACK_TYPES = ['feature', 'infra', 'fix'];
+/** `plugin_20260912` → `2026-09-12`. The slug's stamp *is* the promotion date (the service's). */
+function createdFrom(slug) {
+    const stamp = /_(\d{4})(\d{2})(\d{2})$/.exec(slug);
+    if (stamp)
+        return `${stamp[1]}-${stamp[2]}-${stamp[3]}`;
+    return new Date().toISOString().slice(0, 10);
+}
+function highestPriority(items, refs) {
+    const wanted = new Set(refs);
+    let best = null;
+    for (const entry of items) {
+        const item = asRecord(entry);
+        if (typeof item.id !== 'string' || !wanted.has(item.id))
+            continue;
+        const rank = PRIORITIES.indexOf(text(item.priority, ''));
+        if (rank !== -1 && (best === null || rank < best))
+            best = rank;
+    }
+    return best === null ? null : PRIORITIES[best];
+}
+/** `plugin — the command set`: the track's own word, then what the first item is called. */
+function trackName(slug, spec) {
+    const base = trackBaseName(slug);
+    const first = text(spec[0]?.title, '');
+    return first === '' ? base : `${base} — ${first}`;
+}
+function normaliseIds(ids) {
+    const seen = new Set();
+    const out = [];
+    for (const raw of ids) {
+        const ref = raw.trim().toUpperCase();
+        if (ref === '' || seen.has(ref))
+            continue;
+        seen.add(ref);
+        out.push(ref);
+    }
+    return out;
+}
+export async function runPromote(io, flags) {
+    const ids = normaliseIds(flags.ids ?? []);
+    if (ids.length === 0) {
+        return {
+            ok: false,
+            lines: ['promote needs at least one item ref — e.g. backlog promote PLG-001'],
+        };
+    }
+    const type = (flags.type ?? 'feature').trim().toLowerCase();
+    if (!TRACK_TYPES.includes(type)) {
+        return {
+            ok: false,
+            lines: [`unknown track type "${flags.type}" — allowed: ${TRACK_TYPES.join(', ')}`],
+        };
+    }
+    if (flags.priority !== undefined && !PRIORITIES.includes(flags.priority)) {
+        return {
+            ok: false,
+            lines: [`unknown priority "${flags.priority}" — allowed: ${PRIORITIES.join(', ')}`],
+        };
+    }
+    return runCommand('promote', io, flags, async (ctx) => {
+        const asked = flags.track?.trim();
+        // (1) the refusal that must happen before the service is told anything.
+        if (asked) {
+            const target = trackDir(ctx, asked);
+            if (existsSync(target)) {
+                return {
+                    ok: false,
+                    lines: [
+                        `track ${asked} already exists at ${rel(ctx, target)} — pick another --track, or run: backlog sync ${asked}`,
+                    ],
+                };
+            }
+        }
+        // The register does not carry a track priority, and `metadata.json` v3 needs one: the
+        // highest across the promoted items, read before the write so a refusal costs nothing.
+        const priority = flags.priority !== undefined
+            ? flags.priority
+            : highestPriority(asArray(await ctx.client.get(`/v1/projects/${encodeURIComponent(ctx.project)}/items`)), ids);
+        const payload = await ctx.client.post(`/v1/projects/${encodeURIComponent(ctx.project)}/tracks`, {
+            ids,
+            ...(asked ? { track_slug: asked } : {}),
+            type,
+        });
+        const detail = asRecord(payload);
+        const slug = text(asRecord(detail.track).slug, asked ?? '');
+        if (slug === '') {
+            throw new CommandError('the service promoted the items but returned no track slug — run: backlog status');
+        }
+        // (2) the same refusal again, for the slug the service chose. Nothing is written.
+        const dir = trackDir(ctx, slug);
+        if (existsSync(dir)) {
+            return {
+                ok: false,
+                lines: [
+                    `${ids.join(', ')} promoted into ${slug}, but ${rel(ctx, dir)} already exists — nothing was written; the items are promoted on the service — fix the filesystem and re-run \`backlog sync ${slug}\``,
+                ],
+            };
+        }
+        const files = renderTrackFiles(detail, {
+            name: flags.name?.trim() ||
+                trackName(slug, asArray(detail.spec).map((e) => asRecord(e))),
+            priority: priority ?? 'P1',
+            created: createdFrom(slug),
+            ...(flags.plan?.trim() ? { planPath: flags.plan.trim() } : {}),
+            backlogIds: ids,
+        });
+        const written = [];
+        try {
+            mkdirSync(join(ctx.root, ctx.conductorDir, 'tracks'), { recursive: true });
+            // `recursive: false`: a second promoter that won the race gets EEXIST, not a silent merge.
+            mkdirSync(dir, { recursive: false });
+            for (const name of TRACK_FILENAMES) {
+                writeFileSync(join(dir, name), files[name], 'utf8');
+                written.push(rel(ctx, join(dir, name)));
+            }
+            written.push(rel(ctx, writeRegistry(ctx, slug, files, priority ?? 'P1', type, ids)));
+        }
+        catch (err) {
+            // The service half is done and is not idempotent: never re-POST. Say exactly what is
+            // on disk and hand the reader the one command that finishes the job.
+            return {
+                ok: false,
+                lines: [
+                    `${ids.join(', ')} promoted into ${slug} on the service`,
+                    ...written.map((p) => `wrote ${p}`),
+                    `but the local write failed: ${renderFailure(err, ctx.ctx)}`,
+                    `the items are promoted on the service — fix the filesystem and re-run \`backlog sync ${slug}\``,
+                ],
+            };
+        }
+        if (flags.json)
+            return jsonResult(payload);
+        return {
+            ok: true,
+            lines: [...written.map((p) => `wrote ${p}`), `promoted: ${ids.join(', ')} → ${slug}`],
+        };
+    });
+}
+function trackDir(ctx, slug) {
+    return join(ctx.root, ctx.conductorDir, 'tracks', slug);
+}
+function rel(ctx, path) {
+    return relative(ctx.root, path) || path;
+}
+/** Appends the Active row and drops the Next row this promotion consumed. */
+function writeRegistry(ctx, slug, files, priority, type, ids) {
+    const path = join(ctx.root, ctx.conductorDir, 'tracks.md');
+    const current = existsSync(path) ? readFileSync(path, 'utf8') : null;
+    const name = JSON.parse(files['metadata.json']).name;
+    let updated = addActiveTrack(current, { track_id: slug, name, type, priority });
+    updated = dropNextRow(updated, slug, ids);
+    writeFileSync(path, updated, 'utf8');
+    return path;
+}
+//# sourceMappingURL=promote.js.map

package/dist/commands/promote.js.map

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

package/dist/commands/report.d.ts

@@ -0,0 +1,18 @@
+import type { TargetFlags } from '../config.js';
+import { type CommandIo, type CommandResult } from './common.js';
+/**
+ * `backlog report <track> <step> <status> [--note]` — the Evaluate-Loop half of the bridge
+ * (§6.2). The **vocabulary** is checked locally first, because a typo is the one refusal the
+ * CLI can diagnose without asking: a round trip to hear "BUILD is not a step" costs the user
+ * a network wait and tells them nothing the closed set would not have. Everything else —
+ * whether that transition is legal, whether the role may report, which refs the report moves
+ * to `in-progress` — is the service's call, and is never second-guessed here.
+ */
+export interface ReportFlags extends TargetFlags {
+    track: string;
+    step: string;
+    status: string;
+    note?: string | undefined;
+    json?: boolean | undefined;
+}
+export declare function runReport(io: CommandIo, flags: ReportFlags): Promise<CommandResult>;

package/dist/commands/report.js

@@ -0,0 +1,45 @@
+import { LOOP_STATUSES, LOOP_STEPS } from '../_core/index.js';
+import { asArray, asRecord, jsonResult, runCommand, text, } from './common.js';
+/** The closed sets live in core, so the CLI cannot drift from what the service accepts. */
+function oneOf(raw, allowed, label) {
+    const candidate = raw
+        .trim()
+        .toUpperCase()
+        .replace(/[\s-]+/g, '_');
+    if (allowed.includes(candidate))
+        return { value: candidate };
+    return {
+        line: `unknown ${label} "${raw}" — allowed: ${allowed.join(', ')}`,
+    };
+}
+export async function runReport(io, flags) {
+    const step = oneOf(flags.step, LOOP_STEPS, 'step');
+    if ('line' in step)
+        return { ok: false, lines: [step.line] };
+    const status = oneOf(flags.status, LOOP_STATUSES, 'status');
+    if ('line' in status)
+        return { ok: false, lines: [status.line] };
+    return runCommand('report', io, flags, async (ctx) => {
+        const note = flags.note?.trim();
+        const payload = await ctx.client.post(`/v1/tracks/${encodeURIComponent(ctx.project)}/${encodeURIComponent(flags.track)}/progress`, { step: step.value, status: status.value, ...(note ? { note } : {}) });
+        if (flags.json)
+            return jsonResult(payload);
+        const result = asRecord(payload);
+        const report = asRecord(result.report);
+        const loop = asRecord(result.loop);
+        const lines = [
+            `${flags.track}: recorded ${text(report.step, step.value)} ${text(report.status, status.value)} at ${text(report.at, 'now')}`,
+        ];
+        if (typeof report.note === 'string' && report.note !== '')
+            lines.push(`note: ${report.note}`);
+        lines.push(`loop: ${text(loop.loop_step, step.value)} ${text(loop.loop_status, status.value)}`);
+        const started = asArray(result.started).map((ref) => text(ref, '?'));
+        if (started.length > 0)
+            lines.push(`started: ${started.join(', ')}`);
+        if (asRecord(result.track).spec_drift === true) {
+            lines.push('spec drift: the items moved since promotion — run: backlog sync');
+        }
+        return { ok: true, lines };
+    });
+}
+//# sourceMappingURL=report.js.map

package/dist/commands/report.js.map

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

package/dist/commands/ship.d.ts

@@ -0,0 +1,15 @@
+import type { TargetFlags } from '../config.js';
+import { type CommandIo, type CommandResult } from './common.js';
+export interface ShipFlags extends TargetFlags {
+    track: string;
+    commit?: string | undefined;
+    date?: string | undefined;
+    /** Fill `--commit` from `git rev-parse --short HEAD` and `--date` from today. */
+    auto?: boolean | undefined;
+    overrideReason?: string | undefined;
+    /** `PLG-001=1,3` — repeatable. */
+    criteriaDone?: string[] | undefined;
+    note?: string | undefined;
+    json?: boolean | undefined;
+}
+export declare function runShip(io: CommandIo, flags: ShipFlags): Promise<CommandResult>;

package/dist/commands/ship.js

@@ -0,0 +1,231 @@
+import { execFileSync } from 'node:child_process';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join, relative } from 'node:path';
+import { ROLES } from '../_core/index.js';
+import { ApiError } from '../api.js';
+import { addRecentCompletion, setTrackStatus } from '../conductor/registry.js';
+import { asArray, asRecord, jsonResult, runCommand, text, } from './common.js';
+/**
+ * `backlog ship <track> --commit <sha> --date <YYYY-MM-DD>` — the gate is the service's
+ * (§5.6); the CLI's job is the local half of the §6 shipment sweep, and the one refusal
+ * PLG-001 pins to a byte: an Engineer trying to ship gets **one sentence and nothing else**,
+ * and no file is touched. So every local write happens strictly after a 2xx.
+ */
+const ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
+/** `PLG-001=1,3` → `{ 'PLG-001': [1, 3] }`. A malformed pair is a local refusal. */
+function parseCriteriaDone(pairs) {
+    const out = {};
+    for (const pair of pairs) {
+        const at = pair.indexOf('=');
+        const ref = at === -1 ? '' : pair.slice(0, at).trim().toUpperCase();
+        const numbers = at === -1 ? [] : pair.slice(at + 1).split(',');
+        const parsed = numbers.map((n) => Number.parseInt(n.trim(), 10));
+        if (ref === '' || parsed.length === 0 || parsed.some((n) => !Number.isInteger(n) || n < 1)) {
+            return {
+                line: `--criteria-done wants <REF>=<n,n> (e.g. PLG-001=1,3) — got "${pair}"`,
+            };
+        }
+        out[ref] = parsed;
+    }
+    return { value: out };
+}
+/**
+ * The role, for the sentence. The service's own `forbidden` message already names it
+ * (`role engineer may not ship_track`), so prefer that and spend no extra request; only when
+ * it does not, ask `/v1/me` for the caller's role **on the configured project**.
+ */
+async function roleFor(ctx, err) {
+    const named = /\brole\s+([a-z_]+)\b/i.exec(err.message);
+    if (named && ROLES.includes(named[1].toLowerCase())) {
+        return named[1].toLowerCase();
+    }
+    try {
+        const me = asRecord(await ctx.client.get('/v1/me'));
+        for (const entry of asArray(me.projects)) {
+            const project = asRecord(entry);
+            if (project.slug === ctx.project)
+                return text(project.role, '') || null;
+        }
+    }
+    catch {
+        // The sentence must still be one sentence: a second failure is not worth reporting.
+    }
+    return null;
+}
+function engineerSentence(project, role) {
+    return role === null
+        ? `ship_track is Product+; you are not allowed to ship on ${project}`
+        : `ship_track is Product+; you are ${role} on ${project}`;
+}
+export async function runShip(io, flags) {
+    const commit = flags.commit?.trim();
+    const date = flags.date?.trim();
+    if (!flags.auto && (!commit || !date)) {
+        return {
+            ok: false,
+            lines: [
+                'ship needs the shipment: pass --commit <sha> and --date <YYYY-MM-DD> (or --auto to read HEAD and today)',
+            ],
+        };
+    }
+    if (date && !ISO_DATE.test(date)) {
+        return { ok: false, lines: [`--date wants YYYY-MM-DD — got "${flags.date}"`] };
+    }
+    const criteria = parseCriteriaDone(flags.criteriaDone ?? []);
+    if ('line' in criteria)
+        return { ok: false, lines: [criteria.line] };
+    return runCommand('ship', io, flags, async (ctx) => {
+        const shipment = resolveShipment(ctx, commit, date, Boolean(flags.auto));
+        if ('line' in shipment)
+            return { ok: false, lines: [shipment.line] };
+        const reason = flags.overrideReason?.trim();
+        const body = {
+            commit: shipment.commit,
+            production_date: shipment.date,
+            ...(reason ? { override_reason: reason } : {}),
+            ...(Object.keys(criteria.value).length > 0 ? { criteria_done: criteria.value } : {}),
+        };
+        let payload;
+        try {
+            payload = await ctx.client.post(`/v1/tracks/${encodeURIComponent(ctx.project)}/${encodeURIComponent(flags.track)}/ship`, body);
+        }
+        catch (err) {
+            // The criterion, to the byte: one sentence, no JSON, no status code, no file touched.
+            if (err instanceof ApiError && err.code === 'forbidden') {
+                return { ok: false, lines: [engineerSentence(ctx.project, await roleFor(ctx, err))] };
+            }
+            throw err;
+        }
+        const detail = asRecord(payload);
+        const refs = asArray(asRecord(detail.track).backlog_ids).map((r) => text(r, '?'));
+        const lines = [
+            `shipped ${flags.track}: ${refs.length === 0 ? '(no items)' : refs.join(', ')}`,
+            `commit ${shipment.commit} · production ${shipment.date}`,
+            ...asArray(detail.warnings).map((row) => `⚠ ${text(row, '?')} is not verified (permissive)`),
+        ];
+        if (flags.json)
+            return jsonResult(payload);
+        lines.push(...sweepConductor(ctx, flags, shipment, refs));
+        lines.push(...sweepRegister(ctx, shipment, refs));
+        return { ok: true, lines };
+    });
+}
+/** `--auto` reads HEAD and today; both are printed, so a wrong guess is visible. */
+function resolveShipment(ctx, commit, date, auto) {
+    if (commit && date)
+        return { commit, date };
+    if (!auto)
+        return { line: 'ship needs --commit and --date' };
+    let head = commit;
+    if (!head) {
+        try {
+            // The only place the CLI shells out, and only under `--auto`.
+            head = execFileSync('git', ['rev-parse', '--short', 'HEAD'], {
+                cwd: ctx.root,
+                encoding: 'utf8',
+            }).trim();
+        }
+        catch {
+            return { line: 'could not read HEAD — pass --commit <sha> instead of --auto' };
+        }
+    }
+    return { commit: head, date: date ?? new Date().toISOString().slice(0, 10) };
+}
+/** §6 as it applies to conductor: the track's metadata, its registry row, Recent Completions. */
+function sweepConductor(ctx, flags, shipment, refs) {
+    const lines = [];
+    const dir = join(ctx.root, ctx.conductorDir, 'tracks', flags.track);
+    const metadataPath = join(dir, 'metadata.json');
+    if (existsSync(metadataPath)) {
+        const doc = JSON.parse(readFileSync(metadataPath, 'utf8'));
+        // Four fields, and not one more: `loop_state` is the Evaluate-Loop's and conductor is not
+        // modified by this track (§7.3).
+        doc.status = 'done';
+        doc.completed = shipment.date;
+        doc.shipped_commit = shipment.commit;
+        doc.production_date = shipment.date;
+        writeFileSync(metadataPath, `${JSON.stringify(doc, null, 2)}\n`, 'utf8');
+        lines.push(`wrote ${relative(ctx.root, metadataPath)}`);
+    }
+    else {
+        lines.push(`no ${relative(ctx.root, metadataPath)} — the track files are not in this repo`);
+    }
+    const tracksPath = join(ctx.root, ctx.conductorDir, 'tracks.md');
+    if (existsSync(tracksPath)) {
+        const updated = setTrackStatus(readFileSync(tracksPath, 'utf8'), flags.track, 'done');
+        if (updated === null) {
+            lines.push(`${relative(ctx.root, tracksPath)} has no row for ${flags.track} — left alone`);
+        }
+        else {
+            writeFileSync(tracksPath, updated, 'utf8');
+            lines.push(`wrote ${relative(ctx.root, tracksPath)}`);
+        }
+    }
+    const indexPath = join(ctx.root, ctx.conductorDir, 'index.md');
+    if (existsSync(indexPath)) {
+        const notes = flags.note?.trim() || `${refs.join(', ')} shipped in ${shipment.commit}`;
+        const updated = addRecentCompletion(readFileSync(indexPath, 'utf8'), {
+            track: flags.track,
+            date: shipment.date,
+            notes,
+        });
+        if (updated === null) {
+            lines.push(`${relative(ctx.root, indexPath)} has no "## Recent Completions" table (or already lists ${flags.track}) — left alone`);
+        }
+        else {
+            writeFileSync(indexPath, updated, 'utf8');
+            lines.push(`wrote ${relative(ctx.root, indexPath)}`);
+        }
+    }
+    return lines;
+}
+const FRONTMATTER_SWEEP = ['status', 'shipped_commit', 'production_date', 'updated'];
+/**
+ * §6 steps 2–3 only apply where the repo still holds the markdown register. In a consumer
+ * repo it does not — the items live on the service — and saying so is better than silence.
+ *
+ * Where it does exist, the edit is **surgical**: four frontmatter values by line, and the body
+ * is not re-serialised, so a human's formatting survives. Reconciling the criteria prose is
+ * the one step §6 calls out as the most-skipped, and it is a human's, not this command's.
+ */
+function sweepRegister(ctx, shipment, refs) {
+    const itemsDir = join(ctx.root, 'docs', 'backlog', 'items');
+    if (!existsSync(itemsDir)) {
+        return [
+            'docs/backlog/items/ is not in this repo — the item register is service-side; nothing to sweep',
+        ];
+    }
+    const lines = [];
+    const values = {
+        status: 'shipped',
+        shipped_commit: shipment.commit,
+        production_date: shipment.date,
+        updated: shipment.date,
+    };
+    for (const ref of refs) {
+        const path = join(itemsDir, `${ref}.md`);
+        if (!existsSync(path)) {
+            lines.push(`${ref}: no ${relative(ctx.root, path)} — reconcile it in the register`);
+            continue;
+        }
+        const body = readFileSync(path, 'utf8');
+        const end = body.indexOf('\n---', 4);
+        if (!body.startsWith('---\n') || end === -1) {
+            lines.push(`${ref}: ${relative(ctx.root, path)} has no frontmatter — left alone`);
+            continue;
+        }
+        const head = body.slice(0, end);
+        let updated = head;
+        for (const key of FRONTMATTER_SWEEP) {
+            const line = new RegExp(`^${key}:.*$`, 'm');
+            updated = line.test(updated)
+                ? updated.replace(line, `${key}: ${values[key]}`)
+                : `${updated}\n${key}: ${values[key]}`;
+        }
+        writeFileSync(path, `${updated}${body.slice(end)}`, 'utf8');
+        lines.push(`wrote ${relative(ctx.root, path)}`);
+    }
+    lines.push('§6 still wants a human: reconcile the acceptance criteria with what actually shipped, and update docs/backlog/README.md');
+    return lines;
+}
+//# sourceMappingURL=ship.js.map

package/dist/commands/ship.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ship.js","sourceRoot":"","sources":["../../src/commands/ship.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/E,OAAO,EACL,OAAO,EACP,QAAQ,EAIR,UAAU,EACV,UAAU,EACV,IAAI,GACL,MAAM,aAAa,CAAC;AAErB;;;;;GAKG;AAEH,MAAM,QAAQ,GAAG,qBAAqB,CAAC;AAevC,oFAAoF;AACpF,SAAS,iBAAiB,CACxB,KAAwB;IAExB,MAAM,GAAG,GAA6B,EAAE,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,GAAG,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACpE,MAAM,OAAO,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/D,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QACjE,IAAI,GAAG,KAAK,EAAE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC3F,OAAO;gBACL,IAAI,EAAE,+DAA+D,IAAI,GAAG;aAC7E,CAAC;QACJ,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;IACpB,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AACxB,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,OAAO,CAAC,GAAmB,EAAE,GAAa;IACvD,MAAM,KAAK,GAAG,uBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACxD,IAAI,KAAK,IAAK,KAA2B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QAC3E,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAChC,CAAC;IACD,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QACpD,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzC,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;YAChC,IAAI,OAAO,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO;gBAAE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC;QAC1E,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,oFAAoF;IACtF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAe,EAAE,IAAmB;IAC5D,OAAO,IAAI,KAAK,IAAI;QAClB,CAAC,CAAC,0DAA0D,OAAO,EAAE;QACrE,CAAC,CAAC,mCAAmC,IAAI,OAAO,OAAO,EAAE,CAAC;AAC9D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,EAAa,EAAE,KAAgB;IAC3D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IACpC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IAChC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE;gBACL,yGAAyG;aAC1G;SACF,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,kCAAkC,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;IACjF,CAAC;IACD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;IAC7D,IAAI,MAAM,IAAI,QAAQ;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IAErE,OAAO,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACjD,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACzE,IAAI,MAAM,IAAI,QAAQ;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAErE,MAAM,MAAM,GAAG,KAAK,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG;YACX,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,eAAe,EAAE,QAAQ,CAAC,IAAI;YAC9B,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrF,CAAC;QAEF,IAAI,OAAgB,CAAC;QACrB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAC7B,cAAc,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EACvF,IAAI,CACL,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,sFAAsF;YACtF,IAAI,GAAG,YAAY,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBACxD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACxF,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAClF,MAAM,KAAK,GAAG;YACZ,WAAW,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAC/E,UAAU,QAAQ,CAAC,MAAM,iBAAiB,QAAQ,CAAC,IAAI,EAAE;YACzD,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,+BAA+B,CAAC;SAC7F,CAAC;QAEF,IAAI,KAAK,CAAC,IAAI;YAAE,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC;QAE3C,KAAK,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;QAClD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC;AAOD,oFAAoF;AACpF,SAAS,eAAe,CACtB,GAAmB,EACnB,MAA0B,EAC1B,IAAwB,EACxB,IAAa;IAEb,IAAI,MAAM,IAAI,IAAI;QAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC5C,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,gCAAgC,EAAE,CAAC;IAC7D,IAAI,IAAI,GAAG,MAAM,CAAC;IAClB,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,CAAC;YACH,8DAA8D;YAC9D,IAAI,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE;gBAC3D,GAAG,EAAE,GAAG,CAAC,IAAI;gBACb,QAAQ,EAAE,MAAM;aACjB,CAAC,CAAC,IAAI,EAAE,CAAC;QACZ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,IAAI,EAAE,6DAA6D,EAAE,CAAC;QACjF,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AAC/E,CAAC;AAED,iGAAiG;AACjG,SAAS,cAAc,CACrB,GAAmB,EACnB,KAAgB,EAChB,QAAkB,EAClB,IAAuB;IAEvB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,YAAY,EAAE,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAEpE,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAChD,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAA4B,CAAC;QACtF,0FAA0F;QAC1F,iCAAiC;QACjC,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;QACpB,GAAG,CAAC,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC;QAC9B,GAAG,CAAC,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC;QACrC,GAAG,CAAC,eAAe,GAAG,QAAQ,CAAC,IAAI,CAAC;QACpC,aAAa,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACzE,KAAK,CAAC,IAAI,CAAC,SAAS,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC;IAC1D,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,CAAC,yCAAyC,CAAC,CAAC;IAC9F,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;IACjE,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,cAAc,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACtF,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,mBAAmB,KAAK,CAAC,KAAK,eAAe,CAAC,CAAC;QAC7F,CAAC;aAAM,CAAC;YACN,aAAa,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YAC3C,KAAK,CAAC,IAAI,CAAC,SAAS,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAC/D,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,QAAQ,CAAC,MAAM,EAAE,CAAC;QACvF,MAAM,OAAO,GAAG,mBAAmB,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE;YACnE,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,KAAK;SACN,CAAC,CAAC;QACH,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CACR,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,2DAA2D,KAAK,CAAC,KAAK,gBAAgB,CACvH,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC,SAAS,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,iBAAiB,GAAG,CAAC,QAAQ,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,SAAS,CAAU,CAAC;AAE9F;;;;;;;GAOG;AACH,SAAS,aAAa,CAAC,GAAmB,EAAE,QAAkB,EAAE,IAAuB;IACrF,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAC5D,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO;YACL,+FAA+F;SAChG,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,MAAM,GAA2B;QACrC,MAAM,EAAE,SAAS;QACjB,cAAc,EAAE,QAAQ,CAAC,MAAM;QAC/B,eAAe,EAAE,QAAQ,CAAC,IAAI;QAC9B,OAAO,EAAE,QAAQ,CAAC,IAAI;KACvB,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,GAAG,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,QAAQ,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,iCAAiC,CAAC,CAAC;YACpF,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;YAC5C,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,kCAAkC,CAAC,CAAC;YAClF,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAChC,IAAI,OAAO,GAAG,IAAI,CAAC;QACnB,KAAK,MAAM,GAAG,IAAI,iBAAiB,EAAE,CAAC;YACpC,MAAM,IAAI,GAAG,IAAI,MAAM,CAAC,IAAI,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC;YAC5C,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;gBAC1B,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,KAAK,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;gBACjD,CAAC,CAAC,GAAG,OAAO,KAAK,GAAG,KAAK,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3C,CAAC;QACD,aAAa,CAAC,IAAI,EAAE,GAAG,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC5D,KAAK,CAAC,IAAI,CAAC,SAAS,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,KAAK,CAAC,IAAI,CACR,yHAAyH,CAC1H,CAAC;IACF,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/commands/status.d.ts

@@ -0,0 +1,13 @@
+import type { TargetFlags } from '../config.js';
+import { type CommandIo, type CommandResult } from './common.js';
+/**
+ * `backlog status` — the one command that must answer when the service does not (PLG-001:
+ * "prints the last fetched view from `.backlog/cache.json` when the service is unreachable,
+ * marked cached"). Three reads, all of them `/v1`: the visible projects (for the role in the
+ * header), the active tracks, and the items. Every successful run leaves the cache warm; only
+ * `unreachable` falls back to it, and a failed run never touches it.
+ */
+export interface StatusFlags extends TargetFlags {
+    json?: boolean | undefined;
+}
+export declare function runStatus(io: CommandIo, flags: StatusFlags): Promise<CommandResult>;