felenova-backlog 0.1.0

package/dist/_core/schema.js

@@ -0,0 +1,304 @@
+import { z } from 'zod';
+import { SPEC_FIELDS } from './criteria.js';
+// ---- enums (PRODUCT-SPEC §3, §5.2, §5.3, §5.6) -------------------------------
+export const STATUSES = [
+    'backlog',
+    'scheduled',
+    'promoted',
+    'in-progress',
+    'shipped',
+    'rejected',
+];
+export const CRITERIA_STATUSES = ['draft', 'reviewed', 'locked'];
+export const MATRIX_STATUSES = ['☐', '🟡', '✅', '🔬', '🚀', '⏭️'];
+export const ROLES = ['owner', 'product', 'engineer', 'qa', 'viewer'];
+export const PRIORITIES = ['P0', 'P1', 'P2', 'P3', 'P4'];
+export const TEST_TYPES = [
+    'Unit',
+    'Integration',
+    'E2E',
+    'Code review',
+    'Manual',
+    'Infra',
+    'Telemetry',
+];
+export const Status = z.enum(STATUSES);
+export const CriteriaStatus = z.enum(CRITERIA_STATUSES);
+export const MatrixStatus = z.enum(MATRIX_STATUSES);
+export const Role = z.enum(ROLES);
+export const Priority = z.enum(PRIORITIES);
+export const TestType = z.enum(TEST_TYPES);
+// ---- ids ----------------------------------------------------------------------
+const ITEM_ID = /^[A-Z][A-Z0-9]*-\d{3,}$/;
+export function isItemId(s) {
+    return ITEM_ID.test(s);
+}
+export const ItemId = z.string().regex(ITEM_ID, 'expected PREFIX-NNN');
+const IsoDate = z.string().regex(/^\d{4}-\d{2}-\d{2}$/, 'expected YYYY-MM-DD');
+// ---- item ---------------------------------------------------------------------
+export const Criterion = z.object({
+    index: z.number().int().positive(), // AC{n}, stable
+    text: z.string().min(1),
+    done: z.boolean(),
+});
+/** A body section the schema does not name (e.g. `## Estimated effort`). Kept so canonical export loses nothing. */
+export const ExtraSection = z.object({ heading: z.string().min(1), text: z.string() });
+export const Item = z
+    .object({
+    id: ItemId,
+    title: z.string().min(1),
+    status: Status,
+    domain: z.string().min(1),
+    priority: Priority,
+    origin: z.string(),
+    created: IsoDate,
+    updated: IsoDate,
+    prerequisites: z.array(ItemId),
+    blocks: z.array(ItemId),
+    criteria_status: CriteriaStatus,
+    criteria_version: z.number().int().positive().default(1),
+    revisit_when: z.string(),
+    track: z.string().nullable(),
+    shipped_commit: z.string().nullable(),
+    production_date: IsoDate.nullable(),
+    rejected_reason: z.string().nullable().default(null),
+    // body (markdown)
+    what: z.string(),
+    why: z.string(),
+    criteria: z.array(Criterion),
+    /** Prose inside `## Acceptance criteria` that is not a checkbox (AI-001's `*Pending — …*`). */
+    criteria_notes: z.string().default(''),
+    critique: z.string(),
+    out_of_scope: z.string(),
+    dependencies_note: z.string(),
+    extra_sections: z.array(ExtraSection).default([]),
+    /** Prose before the first `## ` heading (liblib-meet WL-001 has some). Kept verbatim in canonical export. */
+    preamble: z.string().default(''),
+})
+    .superRefine((it, ctx) => {
+    if (it.status === 'rejected' && !it.rejected_reason) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['rejected_reason'],
+            message: 'rejected_reason is required when status is rejected',
+        });
+    }
+    if (it.status === 'shipped' && (!it.shipped_commit || !it.production_date)) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['status'],
+            message: 'shipped requires shipped_commit and production_date',
+        });
+    }
+});
+// ---- track --------------------------------------------------------------------
+/** How hard §5.6's ship gate bites: the closed set `Track.qa_enforcement` is derived from. */
+export const QA_ENFORCEMENTS = ['permissive', 'strict'];
+export const Shipment = z.object({
+    commit: z.string().min(1),
+    production_date: IsoDate,
+    shipped_by: z.string(),
+});
+export const Track = z.object({
+    slug: z.string().min(1),
+    type: z.string().min(1),
+    backlog_ids: z.array(ItemId),
+    follow_up_backlog: z.array(ItemId).default([]),
+    qa_doc: z.string().nullable().default(null),
+    qa_enforcement: z.enum(QA_ENFORCEMENTS).default('permissive'),
+    spec_drift: z.boolean().default(false),
+    shipment: Shipment.nullable().default(null),
+});
+// ---- matrix -------------------------------------------------------------------
+export const LinkedCriterion = z.union([
+    z.object({ item: ItemId, ac: z.number().int().positive() }),
+    /** Legacy `A1`/`B2` rows link to a README rule, not a criterion (MIG-001 critique). */
+    z.object({ legacy: z.string().min(1) }),
+]);
+export const Evidence = z.object({
+    path: z.string().min(1),
+    content_type: z.string(),
+    uploaded_by: z.string(),
+    uploaded_at: z.string(),
+});
+export const MatrixRow = z.object({
+    id: z.string().min(1), // `{ITEM}-AC{n}.M{m}` or legacy `A1`
+    what_to_verify: z.string(),
+    how_to_verify: z.string(),
+    /** Free text on import (legacy: "Unit · Manual"); MCP-004 enforces TestType for new rows. */
+    test_type: z.string(),
+    linked_criterion: LinkedCriterion,
+    /** The original "Linked criterion" cell text, so a regenerated file keeps the human-readable link. */
+    linked_text: z.string().default(''),
+    environment: z.string().nullable().default(null),
+    /** null = the cell was not a recognised symbol on import (kept in status_raw). */
+    status: MatrixStatus.nullable(),
+    status_raw: z.string().default(''),
+    notes: z.string(),
+    evidence: z.array(Evidence).default([]),
+});
+// ---- org ----------------------------------------------------------------------
+export const Member = z.object({ user_id: z.string().min(1), org: z.string().min(1), role: Role });
+export const Token = z.object({
+    id: z.string().min(1),
+    user_id: z.string().min(1),
+    scope: z.enum(['full', 'read_only']),
+    expires_at: z.string().nullable(),
+    hash: z.string().min(1),
+});
+export const AuditEvent = z.object({
+    who: z.string().min(1),
+    via: z.enum(['web', 'cli', 'mcp']),
+    actor_kind: z.enum(['human', 'agent']).default('human'),
+    when: z.string().min(1),
+    action: z.string().min(1),
+    target: z.string().min(1),
+    before: z.unknown().nullable(),
+    after: z.unknown().nullable(),
+    reason: z.string().nullable().default(null),
+});
+export const Decision = z.object({
+    anchor: z.string().min(1),
+    title: z.string(),
+    blocks: z.array(z.string()),
+    next_step: z.string(),
+    status: z.enum(['open', 'resolved']).default('open'),
+});
+// ---- review layer (docs/service/review-layer.md) --------------------------------
+export const SUGGESTION_STATUSES = [
+    'open',
+    'accepted',
+    'declined',
+    'withdrawn',
+    'superseded',
+];
+export const REVISION_SOURCES = ['edit', 'unlock', 'suggestion_accept', 'ship_reconcile'];
+export const SuggestionStatus = z.enum(SUGGESTION_STATUSES);
+export const RevisionSource = z.enum(REVISION_SOURCES);
+/** §12: "QA owns the text, Engineer proposes via comment" needs a target that can be a matrix row. */
+export const CommentTarget = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('item') }),
+    z.object({ kind: z.literal('criterion'), ac: z.number().int().positive() }),
+    z.object({ kind: z.literal('matrix_row'), row_id: z.string().min(1) }),
+]);
+/** Discussion. Immutable once posted — no edit, no delete; if you were wrong, post another. */
+export const Comment = z.object({
+    id: z.string().min(1),
+    item_id: ItemId,
+    target: CommentTarget.default({ kind: 'item' }),
+    body: z.string().min(1),
+    created_by: z.string().min(1),
+    created_at: z.string().min(1),
+});
+/** A proposed change to a **locked** item, held until Product rules on it (§5.4 rule 4). */
+export const Suggestion = z.object({
+    id: z.string().min(1),
+    item_id: ItemId,
+    /** The version it was filed against — what makes `superseded` mechanical. */
+    criteria_version: z.number().int().positive(),
+    target: CommentTarget.default({ kind: 'item' }),
+    text: z.string().min(1),
+    rationale: z.string().min(1),
+    status: SuggestionStatus.default('open'),
+    created_by: z.string().min(1),
+    created_at: z.string().min(1),
+    resolved_by: z.string().nullable().default(null),
+    resolved_at: z.string().nullable().default(null),
+    resolution_note: z.string().nullable().default(null),
+});
+export const RevisionField = z.object({
+    field: z.enum(SPEC_FIELDS),
+    before: z.unknown(),
+    after: z.unknown(),
+});
+/**
+ * The record of a spec-field change that already happened. Field-level diffs, never a whole item
+ * (SVC-004 critique). `id` is null until the store assigns one — core builds revisions, it does
+ * not number them.
+ */
+export const Revision = z.object({
+    id: z.string().min(1).nullable().default(null),
+    item_id: ItemId,
+    version_before: z.number().int().positive(),
+    version_after: z.number().int().positive(),
+    fields: z.array(RevisionField),
+    source: RevisionSource,
+    reason: z.string().nullable().default(null),
+    changed_by: z.string().min(1),
+    changed_at: z.string().min(1),
+});
+// ---- matrix, DB-shaped (MCP-004) ------------------------------------------------
+// Additive: the `MatrixRow`/`Evidence` above are the markdown-era shapes the importer round-trips
+// (free-text `test_type`, nullable `status`, legacy links). The records below are what
+// `backlog.matrix_rows` / `backlog.evidence` hold — every field constrained, nothing legacy.
+/** A matrix row always links to a real criterion here: the legacy `A1` form has no DB home. */
+export const MatrixCriterionRef = z.object({ item: ItemId, ac: z.number().int().positive() });
+export const EvidenceRecord = z.object({
+    id: z.string().min(1),
+    path: z.string().min(1),
+    filename: z.string().min(1),
+    content_type: z.string().min(1),
+    size_bytes: z.number().int().positive(),
+    uploaded_by: z.string().min(1),
+    created_at: z.string().min(1),
+    /** Null until the object is confirmed against Storage (DECISION-019's second step). */
+    uploaded_at: z.string().nullable().default(null),
+});
+export const MatrixRowRecord = z.object({
+    /** The row's uuid; `row_id` is the human `{ITEM}-AC{n}.M{m}` id, unique within the track. */
+    id: z.string().min(1),
+    track: z.string().min(1),
+    row_id: z.string().min(1),
+    linked_criterion: MatrixCriterionRef,
+    /** The criterion text as it read when the row was written — the drift comparand. */
+    linked_text: z.string(),
+    criteria_version: z.number().int().positive(),
+    what_to_verify: z.string(),
+    how_to_verify: z.string().default(''),
+    test_type: TestType,
+    environment: z.string().nullable().default(null),
+    status: MatrixStatus,
+    notes: z.string().default(''),
+    evidence: z.array(EvidenceRecord).default([]),
+    updated_by: z.string().nullable().default(null),
+    updated_at: z.string().min(1),
+});
+/** What `scaffoldMatrix` emits: a row the store has not numbered or timestamped yet. */
+export const NewMatrixRow = z.object({
+    row_id: z.string().min(1),
+    linked_criterion: MatrixCriterionRef,
+    linked_text: z.string(),
+    criteria_version: z.number().int().positive(),
+    what_to_verify: z.string(),
+    how_to_verify: z.string().default(''),
+    test_type: TestType.default('Manual'),
+    environment: z.string().nullable().default(null),
+    status: MatrixStatus.default('☐'),
+    notes: z.string().default(''),
+});
+/**
+ * What scaffolding needs about an existing row: which criterion, which M, whether the row is
+ * live — and the criterion text it quotes, because a `⏭️` row keeps covering *that* text and
+ * nothing else.
+ */
+export const MatrixRowRef = z.object({
+    row_id: z.string().min(1),
+    linked_criterion: MatrixCriterionRef,
+    /** The criterion text the row was written against; `''` never matches a live criterion. */
+    linked_text: z.string(),
+    status: MatrixStatus,
+});
+/** DECISION-020: the QA queue is grouped `track → environment → rows`, Viewer-readable. */
+export const QaQueueGroup = z.object({
+    track: z.string().min(1),
+    /** `'any'` stands in for a row with no environment. */
+    environment: z.string().min(1),
+    rows: z.array(MatrixRowRecord),
+});
+export const QaQueue = z.object({
+    /** `✅` — implemented, waiting to be verified on staging. */
+    waiting_staging: z.array(QaQueueGroup),
+    /** `🔬` — verified on staging, waiting to be verified in production. */
+    waiting_production: z.array(QaQueueGroup),
+});
+//# sourceMappingURL=schema.js.map

package/dist/_core/schema.js.map

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

package/dist/_core/ship.d.ts

@@ -0,0 +1,23 @@
+import type { LoopState } from './loop.js';
+import type { Item, Role } from './schema.js';
+export interface ShipGateInput {
+    items: readonly Item[];
+    lastReport: LoopState | null;
+    /** §3.1 Ship is Product+, but only the Owner may ship without a COMPLETE loop, and must say why. */
+    override?: {
+        reason: string;
+        role: Role;
+    };
+}
+export type ShipGateResult = {
+    ok: true;
+} | {
+    ok: false;
+    reasons: string[];
+};
+/**
+ * The gate `ship_track` runs before writing a commit and a production date: every item is on the
+ * track (promoted or in-progress) and the loop reached `COMPLETE`. Returns every refusal, not the
+ * first — a caller that has to fix three things should learn all three at once.
+ */
+export declare function shipGate(input: ShipGateInput): ShipGateResult;

package/dist/_core/ship.js

@@ -0,0 +1,31 @@
+/**
+ * The gate `ship_track` runs before writing a commit and a production date: every item is on the
+ * track (promoted or in-progress) and the loop reached `COMPLETE`. Returns every refusal, not the
+ * first — a caller that has to fix three things should learn all three at once.
+ */
+export function shipGate(input) {
+    const reasons = [];
+    if (input.items.length === 0)
+        reasons.push('the track has no items');
+    for (const it of input.items) {
+        if (it.status !== 'promoted' && it.status !== 'in-progress')
+            reasons.push(`${it.id} is ${it.status}, not promoted/in-progress`);
+    }
+    const complete = input.lastReport?.step === 'COMPLETE' && input.lastReport?.status === 'COMPLETE';
+    if (!complete) {
+        const ov = input.override;
+        if (ov === undefined) {
+            reasons.push(input.lastReport === null
+                ? 'the track has no progress report; the loop must reach COMPLETE (or an Owner must override)'
+                : `the last progress report is ${input.lastReport.step}/${input.lastReport.status}, not COMPLETE/COMPLETE`);
+        }
+        else {
+            if (ov.role !== 'owner')
+                reasons.push(`only the owner may override the ship gate, not ${ov.role}`);
+            if (!ov.reason.trim())
+                reasons.push('a ship-gate override requires a non-empty reason');
+        }
+    }
+    return reasons.length === 0 ? { ok: true } : { ok: false, reasons };
+}
+//# sourceMappingURL=ship.js.map

package/dist/_core/ship.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ship.js","sourceRoot":"","sources":["../src/ship.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAoB;IAC3C,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACrE,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC7B,IAAI,EAAE,CAAC,MAAM,KAAK,UAAU,IAAI,EAAE,CAAC,MAAM,KAAK,aAAa;YACzD,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,MAAM,4BAA4B,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,EAAE,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,UAAU,EAAE,MAAM,KAAK,UAAU,CAAC;IAClG,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC1B,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CACV,KAAK,CAAC,UAAU,KAAK,IAAI;gBACvB,CAAC,CAAC,4FAA4F;gBAC9F,CAAC,CAAC,+BAA+B,KAAK,CAAC,UAAU,CAAC,IAAI,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,yBAAyB,CAC7G,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,IAAI,EAAE,CAAC,IAAI,KAAK,OAAO;gBACrB,OAAO,CAAC,IAAI,CAAC,kDAAkD,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;YAC5E,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE;gBAAE,OAAO,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACtE,CAAC"}

package/dist/_core/spec-diff.d.ts

@@ -0,0 +1,19 @@
+import { type SpecField } from './criteria.js';
+import type { Item } from './schema.js';
+export interface FieldChange {
+    before: unknown;
+    after: unknown;
+}
+export type SpecDiff = Partial<Record<SpecField, FieldChange>>;
+/**
+ * Field-level diff over `SPEC_FIELDS` only — never the whole item, never a non-spec column.
+ * `criteria` is an array of objects, so it is compared structurally (`deepEqual`): an item that
+ * has been through `jsonb` and back must not read as changed.
+ */
+export declare function specDiff(before: Item, after: Item): SpecDiff;
+/** The same diff in `Revision.fields` shape, in `SPEC_FIELDS` order. */
+export declare function specDiffFields(before: Item, after: Item): Array<{
+    field: SpecField;
+    before: unknown;
+    after: unknown;
+}>;

package/dist/_core/spec-diff.js

@@ -0,0 +1,25 @@
+import { SPEC_FIELDS } from './criteria.js';
+import { deepEqual } from './util/deep-equal.js';
+/**
+ * Field-level diff over `SPEC_FIELDS` only — never the whole item, never a non-spec column.
+ * `criteria` is an array of objects, so it is compared structurally (`deepEqual`): an item that
+ * has been through `jsonb` and back must not read as changed.
+ */
+export function specDiff(before, after) {
+    const out = {};
+    for (const field of SPEC_FIELDS) {
+        if (!deepEqual(before[field], after[field]))
+            out[field] = { before: before[field], after: after[field] };
+    }
+    return out;
+}
+/** The same diff in `Revision.fields` shape, in `SPEC_FIELDS` order. */
+export function specDiffFields(before, after) {
+    const diff = specDiff(before, after);
+    return SPEC_FIELDS.filter((f) => diff[f] !== undefined).map((field) => ({
+        field,
+        before: diff[field].before,
+        after: diff[field].after,
+    }));
+}
+//# sourceMappingURL=spec-diff.js.map

package/dist/_core/spec-diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-diff.js","sourceRoot":"","sources":["../src/spec-diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAkB,MAAM,eAAe,CAAC;AAE5D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAQjD;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAY,EAAE,KAAW;IAChD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAChC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YACzC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;IAChE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,cAAc,CAC5B,MAAY,EACZ,KAAW;IAEX,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACtE,KAAK;QACL,MAAM,EAAG,IAAI,CAAC,KAAK,CAAiB,CAAC,MAAM;QAC3C,KAAK,EAAG,IAAI,CAAC,KAAK,CAAiB,CAAC,KAAK;KAC1C,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/_core/status.d.ts

@@ -0,0 +1,7 @@
+import type { Item, Status } from './schema.js';
+/** PRODUCT-SPEC §5.3 — one-way except scheduled→backlog; rejected only from backlog/scheduled. */
+export declare const STATUS_TRANSITIONS: ReadonlyArray<readonly [Status, Status]>;
+export declare function canTransitionStatus(from: Status, to: Status): boolean;
+export declare function transitionStatus(item: Item, to: Status, opts?: {
+    rejected_reason?: string;
+}): Item;

package/dist/_core/status.js

@@ -0,0 +1,25 @@
+import { ReasonRequiredError, TransitionError } from './errors.js';
+/** PRODUCT-SPEC §5.3 — one-way except scheduled→backlog; rejected only from backlog/scheduled. */
+export const STATUS_TRANSITIONS = [
+    ['backlog', 'scheduled'],
+    ['scheduled', 'promoted'],
+    ['promoted', 'in-progress'],
+    ['in-progress', 'shipped'],
+    ['scheduled', 'backlog'],
+    ['backlog', 'rejected'],
+    ['scheduled', 'rejected'],
+];
+export function canTransitionStatus(from, to) {
+    return STATUS_TRANSITIONS.some(([f, t]) => f === from && t === to);
+}
+export function transitionStatus(item, to, opts = {}) {
+    if (!canTransitionStatus(item.status, to))
+        throw new TransitionError('status', item.status, to);
+    if (to === 'rejected') {
+        if (!opts.rejected_reason?.trim())
+            throw new ReasonRequiredError('reject');
+        return { ...item, status: to, rejected_reason: opts.rejected_reason };
+    }
+    return { ...item, status: to };
+}
+//# sourceMappingURL=status.js.map

package/dist/_core/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnE,kGAAkG;AAClG,MAAM,CAAC,MAAM,kBAAkB,GAA6C;IAC1E,CAAC,SAAS,EAAE,WAAW,CAAC;IACxB,CAAC,WAAW,EAAE,UAAU,CAAC;IACzB,CAAC,UAAU,EAAE,aAAa,CAAC;IAC3B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,SAAS,EAAE,UAAU,CAAC;IACvB,CAAC,WAAW,EAAE,UAAU,CAAC;CAC1B,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,EAAU;IAC1D,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,IAAU,EACV,EAAU,EACV,OAAqC,EAAE;IAEvC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QAAE,MAAM,IAAI,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAChG,IAAI,EAAE,KAAK,UAAU,EAAE,CAAC;QACtB,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,EAAE;YAAE,MAAM,IAAI,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAC3E,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC;IACxE,CAAC;IACD,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AACjC,CAAC"}

package/dist/_core/util/deep-equal.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Structural equality: key-order-insensitive for plain objects, order-sensitive for arrays.
+ *
+ * `JSON.stringify(a) === JSON.stringify(b)` is not usable for "is this object still pristine?":
+ * once a value has been through Postgres `jsonb` its key order is whatever Postgres chose, so a
+ * byte-identical item would compare unequal and be silently re-emitted in canonical form.
+ */
+export declare function deepEqual(a: unknown, b: unknown): boolean;

package/dist/_core/util/deep-equal.js

@@ -0,0 +1,31 @@
+/**
+ * Structural equality: key-order-insensitive for plain objects, order-sensitive for arrays.
+ *
+ * `JSON.stringify(a) === JSON.stringify(b)` is not usable for "is this object still pristine?":
+ * once a value has been through Postgres `jsonb` its key order is whatever Postgres chose, so a
+ * byte-identical item would compare unequal and be silently re-emitted in canonical form.
+ */
+export function deepEqual(a, b) {
+    if (Object.is(a, b))
+        return true;
+    if (typeof a !== typeof b)
+        return false;
+    if (a === null || b === null || typeof a !== 'object')
+        return false;
+    const aArr = Array.isArray(a);
+    if (aArr !== Array.isArray(b))
+        return false;
+    if (aArr) {
+        const x = a;
+        const y = b;
+        return x.length === y.length && x.every((v, i) => deepEqual(v, y[i]));
+    }
+    const x = a;
+    const y = b;
+    const ka = Object.keys(x);
+    const kb = Object.keys(y);
+    if (ka.length !== kb.length)
+        return false;
+    return ka.every((k) => Object.hasOwn(y, k) && deepEqual(x[k], y[k]));
+}
+//# sourceMappingURL=deep-equal.js.map

package/dist/_core/util/deep-equal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-equal.js","sourceRoot":"","sources":["../../src/util/deep-equal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,CAAU,EAAE,CAAU;IAC9C,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,OAAO,CAAC,KAAK,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACpE,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,IAAI,KAAK,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,CAAC,GAAG,CAAc,CAAC;QACzB,MAAM,CAAC,GAAG,CAAc,CAAC;QACzB,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,CAAC,GAAG,CAA4B,CAAC;IACvC,MAAM,CAAC,GAAG,CAA4B,CAAC;IACvC,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1B,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,MAAM,KAAK,EAAE,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1C,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAG,CAA6B,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpG,CAAC"}

package/dist/api.d.ts

@@ -0,0 +1,46 @@
+/**
+ * The single HTTP call site in the CLI (DECISION-025). The CLI speaks REST `/v1` with a PAT:
+ * one call per command, the same `{ error, message }` refusal contract as `/mcp`, and no
+ * retries — every write in the register is non-idempotent.
+ *
+ * `src/no-stray-fetch.test.ts` fails the build if any other module calls `fetch`.
+ */
+export type HttpMethod = 'GET' | 'POST' | 'PATCH' | 'DELETE';
+/** A refusal the CLI can render. `status: 0` means the request never reached the service. */
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, code: string, message: string);
+}
+export interface RequestConfig {
+    url: string;
+    /** Present for symmetry with `BacklogConfig`; the request itself never needs it. */
+    project?: string | undefined;
+    fetchImpl?: typeof fetch | undefined;
+    timeoutMs?: number | undefined;
+}
+/**
+ * One request. A 2xx JSON body is parsed and returned (`204` and an empty body are `null`);
+ * anything else throws `ApiError` built from the service's `{ error, message }`, and a body
+ * that is not that shape is `internal`. A transport failure is `status: 0`/`unreachable`.
+ */
+export declare function request(cfg: RequestConfig, token: string | null, method: HttpMethod, path: string, body?: unknown): Promise<unknown>;
+export declare const get: (cfg: RequestConfig, token: string | null, path: string) => Promise<unknown>;
+export declare const post: (cfg: RequestConfig, token: string | null, path: string, body?: unknown) => Promise<unknown>;
+export declare const patch: (cfg: RequestConfig, token: string | null, path: string, body?: unknown) => Promise<unknown>;
+export declare const del: (cfg: RequestConfig, token: string | null, path: string) => Promise<unknown>;
+export interface ApiClient {
+    url: string;
+    get(path: string): Promise<unknown>;
+    post(path: string, body?: unknown): Promise<unknown>;
+    patch(path: string, body?: unknown): Promise<unknown>;
+    del(path: string): Promise<unknown>;
+}
+/** A config + token bound once, so a command never handles the token itself. */
+export declare function createClient(opts: {
+    url: string;
+    token: string | null;
+    project?: string | undefined;
+    fetchImpl?: typeof fetch | undefined;
+    timeoutMs?: number | undefined;
+}): ApiClient;