@xenosystem/agent-interface-core 0.1.3

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,GAM3B,MAAM,sCAAsC,CAAA;AAE7C,cAAc,wBAAwB,CAAA;AACtC,cAAc,sBAAsB,CAAA;AACpC,cAAc,2BAA2B,CAAA;AACzC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,kBAAkB,CAAA;AAChC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA;AACvC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,uBAAuB,CAAA;AACrC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,qBAAqB,CAAA;AACnC,cAAc,cAAc,CAAA;AAC5B,cAAc,yCAAyC,CAAA;AACvD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,oCAAoC,CAAA;AAClD,cAAc,mCAAmC,CAAA;AACjD,cAAc,mCAAmC,CAAA;AACjD,cAAc,wCAAwC,CAAA;AACtD,cAAc,kCAAkC,CAAA;AAChD,cAAc,uCAAuC,CAAA;AACrD,cAAc,+CAA+C,CAAA;AAE7D,MAAM,CAAC,MAAM,iCAAiC,GAAG;IAC/C,uBAAuB;IACvB,gBAAgB;IAChB,iBAAiB;IACjB,kBAAkB;IAClB,gBAAgB;CACoC,CAAA;AAEtD,MAAM,UAAU,sBAAsB,CACpC,YAAmC,EAAE,EACrC,WAAsC,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE;IAEnF,MAAM,OAAO,GAAG,0BAA0B,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC;QAC7D,UAAU;QACV,SAAS,CAAC,UAAU,CAAC,IAAI,QAAQ;KACzB,CAAC,CAAA;IACX,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAA8D,CAAA;AACjG,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,MAA6B,EAC7B,UAAkC;IAElC,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,CAAA;AAC5E,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,UAAqC;IACtE,OAAO,UAAU,CAAC,MAAM,KAAK,WAAW,IAAI,UAAU,CAAC,MAAM,KAAK,UAAU,CAAA;AAC9E,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,QAAwC;IACjF,IAAI,QAAQ,CAAC,YAAY,KAAK,WAAW,IAAI,QAAQ,CAAC,YAAY,KAAK,UAAU;QAAE,OAAO,KAAK,CAAA;IAC/F,OAAO,iCAAiC,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAC7D,kBAAkB,CAAC,gBAAgB,CAAC,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,CACxE,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,QAAwC;IAExC,OAAO,iCAAiC,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAC9D,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,CACzE,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,SAAoD,EACpD,kBAAkB,GAAG,KAAK;IAE1B,OAAO,SAAS;SACb,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,kBAAkB,IAAI,QAAQ,CAAC,YAAY,KAAK,aAAa,CAAC;SACnF,GAAG,CAAC,aAAa,CAAC;SAClB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAC3F,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAwC;IACpE,OAAO;QACL,GAAG,QAAQ;QACX,YAAY,EAAE,MAAM,CAAC,WAAW,CAC9B,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CACjG;QACD,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACtC,GAAG,KAAK;YACR,GAAG,CAAC,KAAK,CAAC,gBAAgB;gBACxB,CAAC,CAAC,EAAE,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,EAAE;gBAC/E,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CAAC;KACJ,CAAA;AACH,CAAC;AAoBD,MAAM,UAAU,4BAA4B,CAC1C,SAAoD,EACpD,KAAwC;IAExC,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,KAAK,CAAC,UAAU,CAAC,CAAA;IACjF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,oBAAoB,EAAE,UAAU,EAAE,4DAA4D,EAAE,CAAA;IAC5H,CAAC;IACD,IAAI,QAAQ,CAAC,YAAY,KAAK,WAAW,IAAI,QAAQ,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;QAClF,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,sBAAsB;YAC5B,UAAU,EAAE,QAAQ,CAAC,qBAAqB,IAAI,+CAA+C;SAC9F,CAAA;IACH,CAAC;IAED,MAAM,gBAAgB,GAAG,KAAK,CAAC,OAAO,IAAI,QAAQ,CAAC,cAAc,CAAA;IACjE,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC;WACzF,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;IACxC,MAAM,KAAK,GAAG,gBAAgB;QAC5B,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,gBAAgB,CAAC;QACxE,CAAC,CAAC,aAAa,CAAA;IAEjB,IAAI,gBAAgB,IAAI,CAAC,KAAK,EAAE,CAAC;QAC/B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,iBAAiB,EAAE,UAAU,EAAE,8DAA8D,EAAE,CAAA;IAC3H,CAAC;IACD,IAAI,KAAK,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,mBAAmB;YACzB,UAAU,EAAE,KAAK,CAAC,qBAAqB,IAAI,oCAAoC;SAChF,CAAA;IACH,CAAC;IACD,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,0BAA0B,KAAK,IAAI,EAAE,CAAC;QAC3D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,UAAU,EAAE,sDAAsD,EAAE,CAAA;IAClH,CAAC;IAED,MAAM,iBAAiB,GAAG,KAAK,CAAC,iBAAiB;WAC5C,KAAK,EAAE,gBAAgB,EAAE,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,EAAE,CAAA;IACpE,MAAM,eAAe,GAAG,iBAAiB;QACvC,CAAC,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,iBAAiB,CAAC;QAC5E,CAAC,CAAC,SAAS,CAAA;IACb,IAAI,iBAAiB,IAAI,CAAC,eAAe,EAAE,CAAC;QAC1C,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,4BAA4B;YAClC,UAAU,EAAE,gEAAgE;SAC7E,CAAA;IACH,CAAC;IAED,OAAO;QACL,EAAE,EAAE,IAAI;QACR,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC;YACvB,UAAU,EAAE,QAAQ,CAAC,EAAE;YACvB,eAAe,EAAE,QAAQ,CAAC,eAAe;YACzC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClF,CAAC;KACH,CAAA;AACH,CAAC;AAED,SAAS,aAAa,CAAC,KAAuD;IAC5E,OAAO,KAAK,CAAC,YAAY,KAAK,WAAW,IAAI,KAAK,CAAC,YAAY,KAAK,UAAU,CAAA;AAChF,CAAC;AACD,cAAc,wBAAwB,CAAA;AACtC,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA"}

package/dist/intakeBoardProjection.d.ts

@@ -0,0 +1,75 @@
+/**
+ * What an intake surface may SHOW — ADE §5.1, the presentation half.
+ *
+ * `intake.items.list` answers what is in the inbox; this decides what a person
+ * is told about each item's availability and what they may do about it. Pure, in
+ * `core`, for the same reason the review, fleet and session projections are.
+ *
+ * ## 🔴 Availability has FOUR states, and collapsing any two misleads
+ *
+ * `free` — nobody has it, take it.
+ * `mine` — you hold it, so finish or hand it back.
+ * `theirs` — someone else holds it; your claim will be refused and you should
+ *   pick something else.
+ * `dispatched` — a run is already doing it; go look at the run, do not re-do it.
+ *
+ * A board that renders `theirs` like `free` invites a claim that will fail. One
+ * that renders `dispatched` like `theirs` sends someone to negotiate with a
+ * colleague over work a machine is already finishing.
+ *
+ * ## An incomplete inbox is not a short inbox
+ *
+ * If a tracker failed, the list is missing work — and "missing work" reads as
+ * "no more work". The notice is first, for the same reason the fleet board's is.
+ */
+export interface IntakeBoardItemInput {
+    id: string;
+    sourceId: string;
+    externalId: string;
+    title: string;
+    detail?: string;
+    createdAt?: number;
+    url?: string;
+    claimState: string;
+    claimedBy?: string;
+    runId?: string;
+}
+export interface IntakeBoardInput {
+    available: boolean;
+    items: IntakeBoardItemInput[];
+    complete: boolean;
+    failedSources: Array<{
+        sourceId: string;
+        problem: string;
+    }>;
+    reason?: string;
+}
+export type IntakeAvailability = 'free' | 'mine' | 'theirs' | 'dispatched';
+export interface IntakeBoardRow {
+    id: string;
+    sourceId: string;
+    title: string;
+    detail?: string;
+    url?: string;
+    availability: IntakeAvailability;
+    /** Who holds it, when someone else does. Named, never "someone". */
+    heldBy?: string;
+    /** The run doing it, when dispatched — so a person can go look rather than ask. */
+    runId?: string;
+    /** Advice for enabling a control. The host still arbitrates. */
+    canClaim: boolean;
+    canRelease: boolean;
+    canDispatch: boolean;
+    headline: string;
+}
+export interface IntakeBoard {
+    rows: IntakeBoardRow[];
+    /** How many items nobody has taken — the number that answers "is there work?" */
+    freeCount: number;
+    /** Present when the inbox is not the whole picture, or cannot be read at all. */
+    notice?: string;
+    /** True only when every source answered. */
+    trustworthy: boolean;
+}
+export declare function projectIntakeBoard(input: IntakeBoardInput, clientId: string): IntakeBoard;
+//# sourceMappingURL=intakeBoardProjection.d.ts.map

package/dist/intakeBoardProjection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intakeBoardProjection.d.ts","sourceRoot":"","sources":["../src/intakeBoardProjection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,oBAAoB,EAAE,CAAA;IAC7B,QAAQ,EAAE,OAAO,CAAA;IACjB,aAAa,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,YAAY,CAAA;AAE1E,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,kBAAkB,CAAA;IAChC,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,mFAAmF;IACnF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gEAAgE;IAChE,QAAQ,EAAE,OAAO,CAAA;IACjB,UAAU,EAAE,OAAO,CAAA;IACnB,WAAW,EAAE,OAAO,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,cAAc,EAAE,CAAA;IACtB,iFAAiF;IACjF,SAAS,EAAE,MAAM,CAAA;IACjB,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4CAA4C;IAC5C,WAAW,EAAE,OAAO,CAAA;CACrB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAqCzF"}

package/dist/intakeBoardProjection.js

@@ -0,0 +1,90 @@
+/**
+ * What an intake surface may SHOW — ADE §5.1, the presentation half.
+ *
+ * `intake.items.list` answers what is in the inbox; this decides what a person
+ * is told about each item's availability and what they may do about it. Pure, in
+ * `core`, for the same reason the review, fleet and session projections are.
+ *
+ * ## 🔴 Availability has FOUR states, and collapsing any two misleads
+ *
+ * `free` — nobody has it, take it.
+ * `mine` — you hold it, so finish or hand it back.
+ * `theirs` — someone else holds it; your claim will be refused and you should
+ *   pick something else.
+ * `dispatched` — a run is already doing it; go look at the run, do not re-do it.
+ *
+ * A board that renders `theirs` like `free` invites a claim that will fail. One
+ * that renders `dispatched` like `theirs` sends someone to negotiate with a
+ * colleague over work a machine is already finishing.
+ *
+ * ## An incomplete inbox is not a short inbox
+ *
+ * If a tracker failed, the list is missing work — and "missing work" reads as
+ * "no more work". The notice is first, for the same reason the fleet board's is.
+ */
+export function projectIntakeBoard(input, clientId) {
+    if (!input.available) {
+        return {
+            rows: [],
+            freeCount: 0,
+            notice: input.reason ?? 'This host has no intake sources configured.',
+            // Not readable is not "no work". Nothing was measured.
+            trustworthy: false,
+        };
+    }
+    const rows = input.items.map((item) => {
+        const availability = availabilityFor(item, clientId);
+        return {
+            id: item.id,
+            sourceId: item.sourceId,
+            title: item.title,
+            ...(item.detail === undefined ? {} : { detail: item.detail }),
+            ...(item.url === undefined ? {} : { url: item.url }),
+            availability,
+            ...(availability === 'theirs' && item.claimedBy ? { heldBy: item.claimedBy } : {}),
+            ...(item.runId ? { runId: item.runId } : {}),
+            canClaim: availability === 'free',
+            // Only the holder may release or dispatch. Offering either on someone
+            // else's item produces a button whose only outcome is a refusal.
+            canRelease: availability === 'mine',
+            canDispatch: availability === 'mine',
+            headline: headlineFor(availability, item),
+        };
+    });
+    return {
+        rows,
+        freeCount: rows.filter((row) => row.availability === 'free').length,
+        ...(input.complete ? {} : { notice: noticeFor(input) }),
+        trustworthy: input.complete,
+    };
+}
+function availabilityFor(item, clientId) {
+    if (item.claimState === 'dispatched')
+        return 'dispatched';
+    if (item.claimState !== 'claimed')
+        return 'free';
+    return item.claimedBy === clientId ? 'mine' : 'theirs';
+}
+function headlineFor(availability, item) {
+    switch (availability) {
+        case 'free':
+            return 'Waiting to be picked up.';
+        case 'mine':
+            return 'Yours. Dispatch it to a run, or hand it back.';
+        case 'theirs':
+            return `${item.claimedBy} is on this.`;
+        case 'dispatched':
+            return `Being worked on by run ${item.runId}.`;
+    }
+}
+function noticeFor(input) {
+    const failed = input.failedSources;
+    if (failed.length === 0) {
+        return 'Some work could not be read, so this inbox may be missing items.';
+    }
+    // Sources NAMED, with the first reason. "Some sources failed" sends a person
+    // hunting; "jira did not answer" tells them where to look.
+    const names = failed.map((source) => source.sourceId).join(', ');
+    return `Could not read ${names}, so this inbox may be missing work — ${failed[0]?.problem ?? 'no reason given'}.`;
+}
+//# sourceMappingURL=intakeBoardProjection.js.map

package/dist/intakeBoardProjection.js.map

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

package/dist/intakeClaim.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Intake — ADE §5.1, the first pillar of the developer's loop.
+ *
+ * Work arrives from everywhere: a typed instruction, a plan document, a TODO in
+ * the repository, an issue tracker, a scheduled trigger, another agent. This is
+ * the part that decides who gets to act on an item, and it is pure so that the
+ * one rule worth trusting can be tested without a tracker.
+ *
+ * ## 🔴 Claimed exactly once, under concurrent clients
+ *
+ * §5.1's gate. Two surfaces can be looking at the same queue, and two agents can
+ * be idle and eager. If both claim the same item, the same work is done twice —
+ * and worse, both runs write to the same files, which is the merge-debt failure
+ * §5.7 exists to catch, arriving from the other end.
+ *
+ * A second claim is therefore REFUSED and told who holds it. Not queued, not
+ * silently re-granted: the caller needs to know it lost, because its next action
+ * (pick a different item) differs from the winner's.
+ *
+ * ## A source that FAILED is not a source with no work
+ *
+ * The same false-clean rule this codebase keeps re-learning. An unreachable
+ * tracker returning zero items looks exactly like a tracker with nothing to do,
+ * and an empty inbox reads as "nothing to pick up". So a failed source is
+ * reported as failed, and the aggregate says it is incomplete.
+ */
+/** Where an item came from. Adapters implement one interface; a new tracker is
+ *  configuration, never a code change here (§5.1 boundary). */
+export interface IntakeSourceRef {
+    sourceId: string;
+    /** Stable id WITHIN that source — an issue number, a file path, a line. */
+    externalId: string;
+}
+export interface IntakeItem {
+    /** Globally unique: `${sourceId}:${externalId}`. Derived, never supplied, so
+     *  two sources cannot collide on a shared external id like "42". */
+    id: string;
+    source: IntakeSourceRef;
+    title: string;
+    /** Free text — the body of an issue, the TODO line, the plan paragraph. */
+    detail?: string;
+    /** When the SOURCE says it was created, not when we saw it. */
+    createdAt?: number;
+    url?: string;
+}
+export declare function intakeItemId(source: IntakeSourceRef): string;
+export type IntakeClaimState = {
+    state: 'unclaimed';
+} | {
+    state: 'claimed';
+    byClientId: string;
+    at: number;
+    runId?: string;
+} | {
+    state: 'dispatched';
+    byClientId: string;
+    at: number;
+    runId: string;
+};
+export type IntakeClaimResult = {
+    ok: true;
+    claim: Extract<IntakeClaimState, {
+        state: 'claimed';
+    }>;
+} | {
+    ok: false;
+    code: 'already-claimed';
+    heldBy: string;
+    reason: string;
+} | {
+    ok: false;
+    code: 'already-dispatched';
+    heldBy: string;
+    runId: string;
+    reason: string;
+};
+/**
+ * The claim registry.
+ *
+ * In-memory and single-process on purpose: the host IS the single authority for
+ * a user (§7), so this is where "exactly once" is decidable without a lock
+ * service. A detached host keeps that property — it is one process by
+ * construction, which is the same reason the write lease lives there.
+ */
+export declare class IntakeClaims {
+    #private;
+    constructor(options?: {
+        now?: () => number;
+    });
+    state(itemId: string): IntakeClaimState;
+    /**
+     * Takes an item for a client.
+     *
+     * 🔴 The second caller is REFUSED and told who won. Re-granting silently would
+     * put two runs on one item; queueing would leave a caller waiting for work it
+     * will never get. Losing is a fact it can act on.
+     */
+    claim(itemId: string, clientId: string): IntakeClaimResult;
+    /**
+     * Which item was dispatched to this run — §5.1's provenance, asked the way a
+     * reviewer asks it.
+     *
+     * 🔴 The claim map answers "who is working on this ITEM". A person looking at
+     * a RUN asks the opposite question: "where did this work come from?" — and a
+     * run whose origin cannot be recovered is one nobody can audit, which is what
+     * the gate's "dispatches to a run whose provenance records the source item"
+     * requires.
+     *
+     * Returns the FIRST match, because dispatch binds an item to a run once and
+     * refuses a second dispatch; returning a list would promise a fan-out the
+     * claim rules cannot produce.
+     */
+    dispatchedTo(runId: string): string | undefined;
+    /**
+     * Binds a claimed item to the run that will do it.
+     *
+     * Refuses unless the SAME client holds the claim — dispatching someone else's
+     * item is how an item ends up worked twice with the registry showing one
+     * holder.
+     */
+    dispatch(itemId: string, clientId: string, runId: string): IntakeClaimResult;
+    /** Gives an item back. Only the holder may — otherwise any client could free
+     *  another's work and take it. */
+    release(itemId: string, clientId: string): boolean;
+    /** Every item this registry knows about, for a surface to render. */
+    entries(): Array<{
+        itemId: string;
+        state: IntakeClaimState;
+    }>;
+}
+export interface IntakeSourceResult {
+    sourceId: string;
+    items: IntakeItem[];
+    /** Present when the source could not be read. */
+    problem?: string;
+}
+export interface IntakeInbox {
+    items: Array<IntakeItem & {
+        claim: IntakeClaimState;
+    }>;
+    /** Sources that answered. */
+    healthySources: string[];
+    /** Sources that failed, with why. */
+    failedSources: Array<{
+        sourceId: string;
+        problem: string;
+    }>;
+    /**
+     * False when any source failed. 🔴 An empty inbox and an inbox we could not
+     * read are the same zero items and opposite meanings — the first says there is
+     * no work, the second says we do not know.
+     */
+    complete: boolean;
+}
+export declare function buildIntakeInbox(results: IntakeSourceResult[], claims: IntakeClaims): IntakeInbox;
+//# sourceMappingURL=intakeClaim.d.ts.map

package/dist/intakeClaim.d.ts.map

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

package/dist/intakeClaim.js

@@ -0,0 +1,190 @@
+/**
+ * Intake — ADE §5.1, the first pillar of the developer's loop.
+ *
+ * Work arrives from everywhere: a typed instruction, a plan document, a TODO in
+ * the repository, an issue tracker, a scheduled trigger, another agent. This is
+ * the part that decides who gets to act on an item, and it is pure so that the
+ * one rule worth trusting can be tested without a tracker.
+ *
+ * ## 🔴 Claimed exactly once, under concurrent clients
+ *
+ * §5.1's gate. Two surfaces can be looking at the same queue, and two agents can
+ * be idle and eager. If both claim the same item, the same work is done twice —
+ * and worse, both runs write to the same files, which is the merge-debt failure
+ * §5.7 exists to catch, arriving from the other end.
+ *
+ * A second claim is therefore REFUSED and told who holds it. Not queued, not
+ * silently re-granted: the caller needs to know it lost, because its next action
+ * (pick a different item) differs from the winner's.
+ *
+ * ## A source that FAILED is not a source with no work
+ *
+ * The same false-clean rule this codebase keeps re-learning. An unreachable
+ * tracker returning zero items looks exactly like a tracker with nothing to do,
+ * and an empty inbox reads as "nothing to pick up". So a failed source is
+ * reported as failed, and the aggregate says it is incomplete.
+ */
+export function intakeItemId(source) {
+    return `${source.sourceId}:${source.externalId}`;
+}
+/**
+ * The claim registry.
+ *
+ * In-memory and single-process on purpose: the host IS the single authority for
+ * a user (§7), so this is where "exactly once" is decidable without a lock
+ * service. A detached host keeps that property — it is one process by
+ * construction, which is the same reason the write lease lives there.
+ */
+export class IntakeClaims {
+    #claims = new Map();
+    #now;
+    constructor(options = {}) {
+        this.#now = options.now ?? (() => Date.now());
+    }
+    state(itemId) {
+        return this.#claims.get(itemId) ?? { state: 'unclaimed' };
+    }
+    /**
+     * Takes an item for a client.
+     *
+     * 🔴 The second caller is REFUSED and told who won. Re-granting silently would
+     * put two runs on one item; queueing would leave a caller waiting for work it
+     * will never get. Losing is a fact it can act on.
+     */
+    claim(itemId, clientId) {
+        const current = this.state(itemId);
+        if (current.state === 'dispatched') {
+            return {
+                ok: false,
+                code: 'already-dispatched',
+                heldBy: current.byClientId,
+                runId: current.runId,
+                reason: `This item is already being worked on by run ${current.runId}.`,
+            };
+        }
+        if (current.state === 'claimed') {
+            // Idempotent for the HOLDER: a client that claims twice — a retry, a
+            // reconnect — has not lost anything and must not be told it did.
+            if (current.byClientId === clientId)
+                return { ok: true, claim: current };
+            return {
+                ok: false,
+                code: 'already-claimed',
+                heldBy: current.byClientId,
+                reason: `${current.byClientId} claimed this item first.`,
+            };
+        }
+        const claim = { state: 'claimed', byClientId: clientId, at: this.#now() };
+        this.#claims.set(itemId, claim);
+        return { ok: true, claim };
+    }
+    /**
+     * Which item was dispatched to this run — §5.1's provenance, asked the way a
+     * reviewer asks it.
+     *
+     * 🔴 The claim map answers "who is working on this ITEM". A person looking at
+     * a RUN asks the opposite question: "where did this work come from?" — and a
+     * run whose origin cannot be recovered is one nobody can audit, which is what
+     * the gate's "dispatches to a run whose provenance records the source item"
+     * requires.
+     *
+     * Returns the FIRST match, because dispatch binds an item to a run once and
+     * refuses a second dispatch; returning a list would promise a fan-out the
+     * claim rules cannot produce.
+     */
+    dispatchedTo(runId) {
+        for (const entry of this.entries()) {
+            if (entry.state.state === 'dispatched' && entry.state.runId === runId)
+                return entry.itemId;
+        }
+        return undefined;
+    }
+    /**
+     * Binds a claimed item to the run that will do it.
+     *
+     * Refuses unless the SAME client holds the claim — dispatching someone else's
+     * item is how an item ends up worked twice with the registry showing one
+     * holder.
+     */
+    dispatch(itemId, clientId, runId) {
+        const current = this.state(itemId);
+        if (current.state === 'unclaimed') {
+            return {
+                ok: false,
+                code: 'already-claimed',
+                heldBy: '(nobody)',
+                reason: 'Claim this item before dispatching it.',
+            };
+        }
+        if (current.byClientId !== clientId) {
+            return current.state === 'dispatched'
+                ? {
+                    ok: false,
+                    code: 'already-dispatched',
+                    heldBy: current.byClientId,
+                    runId: current.runId,
+                    reason: `This item is already being worked on by run ${current.runId}.`,
+                }
+                : {
+                    ok: false,
+                    code: 'already-claimed',
+                    heldBy: current.byClientId,
+                    reason: `${current.byClientId} holds this item.`,
+                };
+        }
+        this.#claims.set(itemId, {
+            state: 'dispatched',
+            byClientId: clientId,
+            at: this.#now(),
+            runId,
+        });
+        return { ok: true, claim: { state: 'claimed', byClientId: clientId, at: this.#now() } };
+    }
+    /** Gives an item back. Only the holder may — otherwise any client could free
+     *  another's work and take it. */
+    release(itemId, clientId) {
+        const current = this.state(itemId);
+        if (current.state === 'unclaimed' || current.byClientId !== clientId)
+            return false;
+        this.#claims.delete(itemId);
+        return true;
+    }
+    /** Every item this registry knows about, for a surface to render. */
+    entries() {
+        return [...this.#claims.entries()]
+            .map(([itemId, state]) => ({ itemId, state }))
+            .sort((left, right) => left.itemId.localeCompare(right.itemId));
+    }
+}
+export function buildIntakeInbox(results, claims) {
+    const healthySources = [];
+    const failedSources = [];
+    const items = [];
+    for (const result of results) {
+        if (result.problem) {
+            failedSources.push({ sourceId: result.sourceId, problem: result.problem });
+            // Its items are still included when it returned any: a partially readable
+            // source is more useful than none, and `complete: false` carries the doubt.
+        }
+        else {
+            healthySources.push(result.sourceId);
+        }
+        for (const item of result.items) {
+            items.push({ ...item, claim: claims.state(item.id) });
+        }
+    }
+    // Oldest first: intake is a queue, and the item that has waited longest is the
+    // one most likely to be forgotten. Ties break on id so the order is stable.
+    items.sort((left, right) => {
+        const leftAt = left.createdAt ?? 0;
+        const rightAt = right.createdAt ?? 0;
+        return leftAt === rightAt ? left.id.localeCompare(right.id) : leftAt - rightAt;
+    });
+    return {
+        items,
+        healthySources,
+        failedSources,
+        complete: failedSources.length === 0,
+    };
+}
+//# sourceMappingURL=intakeClaim.js.map

package/dist/intakeClaim.js.map

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

package/dist/knowledgeBoardProjection.d.ts

@@ -0,0 +1,57 @@
+/**
+ * What a knowledge surface may SHOW — ADE §5.8, the presentation half.
+ *
+ * `knowledge.list` returns every fact ever recorded, including ones a later fact
+ * replaced. This decides which are CURRENT, which are history, and what must be
+ * said about the store keeping them.
+ *
+ * ## 🔴 Superseded facts are history, never deleted and never mixed in
+ *
+ * The store keeps "we use npm" after "we moved to pnpm" on purpose — *"when did
+ * this change, and who decided?"* is a question people ask. But a list that
+ * showed both as current would be worse than one that dropped the old fact: a
+ * reader scanning it comes away believing the workspace holds two contradictory
+ * beliefs, which is exactly what supersession exists to prevent.
+ *
+ * ## The durability warning is not a footnote
+ *
+ * A surface that renders facts identically whether or not they survive a restart
+ * invites someone to teach the workspace something important and lose it. When
+ * the store is not durable, that is the first thing on screen.
+ */
+export interface KnowledgeBoardEntryInput {
+    id: string;
+    subject: string;
+    fact: string;
+    pinned?: boolean;
+    runId: string;
+    providerId?: string;
+    at: number;
+}
+export interface KnowledgeBoardInput {
+    available: boolean;
+    entries: KnowledgeBoardEntryInput[];
+    durable: boolean;
+    reason?: string;
+}
+export interface KnowledgeBoardRow {
+    id: string;
+    subject: string;
+    fact: string;
+    pinned: boolean;
+    /** "learned by claude in run r7" — provenance a person can read. */
+    provenance: string;
+    at: number;
+}
+export interface KnowledgeBoard {
+    /** What the workspace currently believes, pinned first then newest. */
+    current: KnowledgeBoardRow[];
+    /** Replaced by a later fact about the same subject. Kept, shown apart. */
+    history: KnowledgeBoardRow[];
+    /** Present when the store does not survive a restart, or cannot be read. */
+    notice?: string;
+    /** True only when these facts will still be here tomorrow. */
+    durable: boolean;
+}
+export declare function projectKnowledgeBoard(input: KnowledgeBoardInput): KnowledgeBoard;
+//# sourceMappingURL=knowledgeBoardProjection.d.ts.map

package/dist/knowledgeBoardProjection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledgeBoardProjection.d.ts","sourceRoot":"","sources":["../src/knowledgeBoardProjection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,EAAE,EAAE,MAAM,CAAA;CACX;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,wBAAwB,EAAE,CAAA;IACnC,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,OAAO,CAAA;IACf,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAA;IAClB,EAAE,EAAE,MAAM,CAAA;CACX;AAED,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,OAAO,EAAE,iBAAiB,EAAE,CAAA;IAC5B,0EAA0E;IAC1E,OAAO,EAAE,iBAAiB,EAAE,CAAA;IAC5B,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,8DAA8D;IAC9D,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,mBAAmB,GAAG,cAAc,CAyChF"}