@telora/daemon 0.22.187 → 0.22.208

package/dist/queries/focus-unclaimed-migration.d.ts

@@ -0,0 +1,146 @@
+/**
+ * The focus's durable record of "my branch holds a migration I never claimed",
+ * and its clear.
+ *
+ * WHY THIS IS STATE AND NOT AN ESCALATION. It names no human-only act: the team
+ * that wrote the file is the one that can claim the number or remove it. An
+ * escalation would be a row in a human queue that can only wait for the same
+ * team to act, and a routine triage pass could resolve it while the file is
+ * still unclaimed. So it is a fact about the focus that clears itself when the
+ * fact stops being true.
+ *
+ * WHY focus_debug_artifacts, and not the deliveries' git_state: the same reason
+ * `focus-integration-conflict.ts` gives. `org_nodes.git_state` is a
+ * forward-only ladder with one slot per delivery, and this is a fact about the
+ * focus BRANCH shared by every delivery on it -- with no room for the number or
+ * the path. A debug section is one row per (focus, kind), rendered with its own
+ * stamp, read by nothing in the machine's decision path, and cleared by
+ * DELETING the row, which is exactly what "until the team claims or removes it"
+ * wants.
+ *
+ * SINCE-WHEN SURVIVES THE RE-RECORD. `updated_at` moves on every write and the
+ * record is re-written on every pass that still sees the file, so `updated_at`
+ * alone would always read "just now" and hide a file unclaimed for a week. The
+ * content carries `Unclaimed since:` explicitly and a re-record reads the
+ * existing section and carries the value forward; a failed read degrades to
+ * "since now" rather than losing the record.
+ *
+ * @module queries/focus-unclaimed-migration
+ */
+import { type CallApiDeps } from './shared.js';
+import type { UnclaimedFile } from '../migrations/migration-claim-lifecycle.js';
+/** The focus_debug_artifacts section the record lives in. */
+export declare const UNCLAIMED_MIGRATION_SECTION_KIND = "unclaimed_migration";
+/** The line carrying the first-observed timestamp across re-records. */
+export declare const UNCLAIMED_SINCE_PREFIX = "Unclaimed since: ";
+/**
+ * The line recording that this record has been PUT IN FRONT OF THE TEAM.
+ *
+ * WHY THE RECORD IS NOT ENOUGH ON ITS OWN. A record that nobody reads before
+ * the branch merges is a note written to an empty room: the file lands on
+ * integration holding a number no claim knows about, and the team that wrote it
+ * has finished. So an unnamed record is TEAM-ACTIONABLE WORK -- the completion
+ * path treats it the way it treats an outstanding merge-conflict resolution,
+ * and the team is not torn down before it has been handed the file.
+ *
+ * WHY IT IS MARKED, AND WHY THAT BOUNDS IT. The hold lasts exactly one coding
+ * turn: once the record has been composed into a spawn prompt, this line is
+ * written and the hold lifts, whether or not the team acted. A hold that
+ * persisted until the team complied would be a wedge -- the record clears only
+ * on a claim or a removal, and neither is something the daemon can force.
+ * Telling the team once is what was missing; compelling it is not this
+ * mechanism's business.
+ */
+export declare const UNCLAIMED_NAMED_PREFIX = "Named to the team at: ";
+/** Render the human-facing record. */
+export declare function renderUnclaimedMigrationArtifact(args: {
+    focusName: string;
+    branchName: string;
+    files: readonly UnclaimedFile[];
+    since: string;
+    /** When the team was handed this record, if it has been. */
+    namedAt?: string | null;
+}): string;
+/** When an existing record was last put in front of the team, or null. */
+export declare function parseUnclaimedNamedAt(content: string | null | undefined): string | null;
+/** Read the first-observed timestamp back out of an existing record. */
+export declare function parseUnclaimedSince(content: string | undefined): string | null;
+/**
+ * Record that this focus's branch holds unclaimed migrations, carrying forward
+ * the first-observed timestamp when one is already on record.
+ */
+export declare function recordUnclaimedMigrations(args: {
+    focusId: string;
+    focusName: string;
+    branchName: string;
+    files: readonly UnclaimedFile[];
+    detectedAt: string;
+}, deps?: CallApiDeps): Promise<void>;
+/** Clear the record. Idempotent: deleting a section that is not there is a no-op. */
+export declare function clearUnclaimedMigrations(focusId: string, deps?: CallApiDeps): Promise<void>;
+/**
+ * Read the record back, for the spawn prompt.
+ *
+ * Returns the rendered content, or null when the focus has no such record.
+ * The section is stored as prose because it is also a human-facing Debug-tab
+ * artifact; the prompt carries the same text rather than re-rendering it, so a
+ * team and a human read the identical account.
+ */
+export declare function readUnclaimedMigrationRecord(focusId: string, deps?: CallApiDeps): Promise<string | null>;
+/**
+ * The same read, but a FAILURE THROWS.
+ *
+ * Two callers need the difference. A spawn must never be failed by a debug-tab
+ * read, so it takes the lenient form above. The completion path must not read
+ * a failed read as "there is nothing to tell" -- that is the destructive
+ * direction, the one that lets a team go with an unclaimed migration still on
+ * its branch -- so it takes this one and fails closed. Swallowing inside the
+ * query made both callers the same, and quietly defeated the second one's
+ * fail-closed handler: it could never see the failure it was written for.
+ */
+export declare function readUnclaimedMigrationRecordStrict(focusId: string, deps?: CallApiDeps): Promise<string | null>;
+/**
+ * The ordinals an existing record names.
+ *
+ * Read back so the lifecycle can keep an ordinal NAMED until the team resolves
+ * it. Without this the record clears the moment the branch merges -- its own
+ * unclaimed file then reads as inherited from integration, the detection goes
+ * quiet, and the record reports success for a problem that only moved.
+ *
+ * Parsed from the rendered lines rather than stored twice: one text is what a
+ * human reads on the Debug tab AND what the team is shown, and a second
+ * machine-readable copy is a second thing to keep in step.
+ */
+export declare function parseUnclaimedOrdinals(content: string | null | undefined): string[];
+/** One migration an existing record names: its number and the file it named. */
+export interface RecordedUnclaimedEntry {
+    ordinal: string;
+    path: string;
+}
+/**
+ * The record's entries, WITH their paths.
+ *
+ * The ordinals alone are not enough to re-render the record. When integration
+ * cannot be read, an ordinal the branch no longer shows can be neither proved
+ * merged nor proved removed -- so it must be carried forward verbatim, and
+ * carrying it forward needs the file it named. Reading it back from the record
+ * (rather than storing a second machine-readable copy) keeps one text as both
+ * what a human reads and what the lifecycle reasons over.
+ */
+export declare function parseUnclaimedEntries(content: string | null | undefined): RecordedUnclaimedEntry[];
+/**
+ * Mark this focus's record as having been handed to the team.
+ *
+ * Called when the record is composed into a spawn prompt -- the moment the team
+ * is actually told. Writing it earlier (at detection) would lift the hold
+ * before anyone read it; writing it later (after the session ends) would hold a
+ * second turn for a file already named.
+ *
+ * Best effort by construction: a spawn is never failed by this write. The cost
+ * of losing it is one extra coding turn, and the cost of the whole mechanism
+ * failing is what it was before -- the team is still shown the record on every
+ * spawn while it stands, because the section renders on the record's existence,
+ * not on this marker.
+ */
+export declare function markUnclaimedMigrationNamed(focusId: string, namedAt: string, deps?: CallApiDeps): Promise<void>;
+//# sourceMappingURL=focus-unclaimed-migration.d.ts.map

package/dist/queries/focus-unclaimed-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-unclaimed-migration.d.ts","sourceRoot":"","sources":["../../src/queries/focus-unclaimed-migration.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAW,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAEhF,6DAA6D;AAC7D,eAAO,MAAM,gCAAgC,wBAAwB,CAAC;AAEtE,wEAAwE;AACxE,eAAO,MAAM,sBAAsB,sBAAsB,CAAC;AAE1D;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAQ/D,sCAAsC;AACtC,wBAAgB,gCAAgC,CAAC,IAAI,EAAE;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,GAAG,MAAM,CAwBT;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CASvF;AAED,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAS9E;AASD;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE;IACJ,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB,EACD,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAED,qFAAqF;AACrF,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;;;;;GAOG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQxB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,kCAAkC,CACtD,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAMxB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE,CAEnF;AAED,gFAAgF;AAChF,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACjC,sBAAsB,EAAE,CAQ1B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/dist/queries/focus-unclaimed-migration.js

@@ -0,0 +1,266 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/completion/exit-unclaimed-migration-hold.test.ts,
+//   packages/daemon/src/completion/unclaimed-migration-notice-phase.test.ts,
+//   packages/daemon/src/queries/focus-unclaimed-migration.test.ts,
+//   packages/daemon/src/spawn/migration-numbering-wiring.test.ts
+// PINNED-BY-END
+/**
+ * The focus's durable record of "my branch holds a migration I never claimed",
+ * and its clear.
+ *
+ * WHY THIS IS STATE AND NOT AN ESCALATION. It names no human-only act: the team
+ * that wrote the file is the one that can claim the number or remove it. An
+ * escalation would be a row in a human queue that can only wait for the same
+ * team to act, and a routine triage pass could resolve it while the file is
+ * still unclaimed. So it is a fact about the focus that clears itself when the
+ * fact stops being true.
+ *
+ * WHY focus_debug_artifacts, and not the deliveries' git_state: the same reason
+ * `focus-integration-conflict.ts` gives. `org_nodes.git_state` is a
+ * forward-only ladder with one slot per delivery, and this is a fact about the
+ * focus BRANCH shared by every delivery on it -- with no room for the number or
+ * the path. A debug section is one row per (focus, kind), rendered with its own
+ * stamp, read by nothing in the machine's decision path, and cleared by
+ * DELETING the row, which is exactly what "until the team claims or removes it"
+ * wants.
+ *
+ * SINCE-WHEN SURVIVES THE RE-RECORD. `updated_at` moves on every write and the
+ * record is re-written on every pass that still sees the file, so `updated_at`
+ * alone would always read "just now" and hide a file unclaimed for a week. The
+ * content carries `Unclaimed since:` explicitly and a re-record reads the
+ * existing section and carries the value forward; a failed read degrades to
+ * "since now" rather than losing the record.
+ *
+ * @module queries/focus-unclaimed-migration
+ */
+import { callApi } from './shared.js';
+/** The focus_debug_artifacts section the record lives in. */
+export const UNCLAIMED_MIGRATION_SECTION_KIND = 'unclaimed_migration';
+/** The line carrying the first-observed timestamp across re-records. */
+export const UNCLAIMED_SINCE_PREFIX = 'Unclaimed since: ';
+/**
+ * The line recording that this record has been PUT IN FRONT OF THE TEAM.
+ *
+ * WHY THE RECORD IS NOT ENOUGH ON ITS OWN. A record that nobody reads before
+ * the branch merges is a note written to an empty room: the file lands on
+ * integration holding a number no claim knows about, and the team that wrote it
+ * has finished. So an unnamed record is TEAM-ACTIONABLE WORK -- the completion
+ * path treats it the way it treats an outstanding merge-conflict resolution,
+ * and the team is not torn down before it has been handed the file.
+ *
+ * WHY IT IS MARKED, AND WHY THAT BOUNDS IT. The hold lasts exactly one coding
+ * turn: once the record has been composed into a spawn prompt, this line is
+ * written and the hold lifts, whether or not the team acted. A hold that
+ * persisted until the team complied would be a wedge -- the record clears only
+ * on a claim or a removal, and neither is something the daemon can force.
+ * Telling the team once is what was missing; compelling it is not this
+ * mechanism's business.
+ */
+export const UNCLAIMED_NAMED_PREFIX = 'Named to the team at: ';
+/** Render the human-facing record. */
+export function renderUnclaimedMigrationArtifact(args) {
+    const { focusName, branchName, files, since } = args;
+    const lines = [
+        `Focus: ${focusName}`,
+        `Branch: ${branchName}`,
+        `${UNCLAIMED_SINCE_PREFIX}${since}`,
+        '',
+        `${files.length} migration file${files.length === 1 ? '' : 's'} on this branch `
+            + 'were not claimed through Telora:',
+        '',
+        ...files.map((f) => `- ${f.ordinal}  ${f.path}`),
+        '',
+        'A migration number is claimed once, before the file is named, so two focuses',
+        'cut from one base cannot both take it. A file written without a claim is a',
+        'number nobody knows is taken: the next team to claim can be granted it.',
+        '',
+        'The team resolves this by claiming the number (telora_product_migration',
+        'action=claim) or removing the file. This record clears itself on the next',
+        'pass that sees either.',
+        // Carried across re-records so the one-turn hold is not re-armed by a
+        // commit; see UNCLAIMED_NAMED_PREFIX.
+        ...(args.namedAt ? ['', `${UNCLAIMED_NAMED_PREFIX}${args.namedAt}`] : []),
+    ];
+    return lines.join('\n');
+}
+/** When an existing record was last put in front of the team, or null. */
+export function parseUnclaimedNamedAt(content) {
+    if (!content)
+        return null;
+    for (const line of content.split('\n')) {
+        if (line.startsWith(UNCLAIMED_NAMED_PREFIX)) {
+            const value = line.slice(UNCLAIMED_NAMED_PREFIX.length).trim();
+            if (value)
+                return value;
+        }
+    }
+    return null;
+}
+/** Read the first-observed timestamp back out of an existing record. */
+export function parseUnclaimedSince(content) {
+    if (!content)
+        return null;
+    for (const line of content.split('\n')) {
+        if (line.startsWith(UNCLAIMED_SINCE_PREFIX)) {
+            const value = line.slice(UNCLAIMED_SINCE_PREFIX.length).trim();
+            if (value)
+                return value;
+        }
+    }
+    return null;
+}
+/** The record already on file for this focus, or undefined. */
+async function readExistingRecord(focusId, api) {
+    const result = await api('focus_debug_get', { focusId });
+    return (result?.sections ?? [])
+        .find((s) => s.sectionKind === UNCLAIMED_MIGRATION_SECTION_KIND)?.content;
+}
+/**
+ * Record that this focus's branch holds unclaimed migrations, carrying forward
+ * the first-observed timestamp when one is already on record.
+ */
+export async function recordUnclaimedMigrations(args, deps = {}) {
+    const api = deps.callApi ?? callApi;
+    const { focusId, focusName, branchName, files, detectedAt } = args;
+    let existing;
+    try {
+        existing = await readExistingRecord(focusId, api);
+    }
+    catch {
+        // A failed read costs the ORIGINAL since-when, never the record itself.
+        existing = undefined;
+    }
+    // THE NAMED MARKER SURVIVES A RE-RECORD, BUT ONLY WHILE THE SET DOES NOT GROW.
+    // Re-recording happens on any tick where the branch moved, so resetting the
+    // marker each time would hold the team's teardown again after every commit --
+    // a fresh coding turn for a file it was told about already. A NEW unclaimed
+    // ordinal is new information, though, and earns its own turn, so the marker
+    // is dropped the moment the set grows.
+    const alreadyNamed = new Set(parseUnclaimedOrdinals(existing));
+    const grew = files.some((f) => !alreadyNamed.has(f.ordinal));
+    const namedAt = grew ? null : parseUnclaimedNamedAt(existing);
+    await api('focus_debug_set', {
+        focusId,
+        fields: {
+            sectionKind: UNCLAIMED_MIGRATION_SECTION_KIND,
+            content: renderUnclaimedMigrationArtifact({
+                focusName, branchName, files, since: parseUnclaimedSince(existing) ?? detectedAt, namedAt,
+            }),
+        },
+    });
+}
+/** Clear the record. Idempotent: deleting a section that is not there is a no-op. */
+export async function clearUnclaimedMigrations(focusId, deps = {}) {
+    const api = deps.callApi ?? callApi;
+    await api('focus_debug_clear', {
+        focusId,
+        fields: { sectionKind: UNCLAIMED_MIGRATION_SECTION_KIND },
+    });
+}
+/**
+ * Read the record back, for the spawn prompt.
+ *
+ * Returns the rendered content, or null when the focus has no such record.
+ * The section is stored as prose because it is also a human-facing Debug-tab
+ * artifact; the prompt carries the same text rather than re-rendering it, so a
+ * team and a human read the identical account.
+ */
+export async function readUnclaimedMigrationRecord(focusId, deps = {}) {
+    try {
+        return await readUnclaimedMigrationRecordStrict(focusId, deps);
+    }
+    catch {
+        // A spawn is never failed by a missing debug read: the team simply is not
+        // told this time, and the next pass re-records.
+        return null;
+    }
+}
+/**
+ * The same read, but a FAILURE THROWS.
+ *
+ * Two callers need the difference. A spawn must never be failed by a debug-tab
+ * read, so it takes the lenient form above. The completion path must not read
+ * a failed read as "there is nothing to tell" -- that is the destructive
+ * direction, the one that lets a team go with an unclaimed migration still on
+ * its branch -- so it takes this one and fails closed. Swallowing inside the
+ * query made both callers the same, and quietly defeated the second one's
+ * fail-closed handler: it could never see the failure it was written for.
+ */
+export async function readUnclaimedMigrationRecordStrict(focusId, deps = {}) {
+    const api = deps.callApi ?? callApi;
+    const result = await api('focus_debug_get', { focusId });
+    const section = (result?.sections ?? [])
+        .find((s) => s.sectionKind === UNCLAIMED_MIGRATION_SECTION_KIND);
+    return section?.content ?? null;
+}
+/**
+ * The ordinals an existing record names.
+ *
+ * Read back so the lifecycle can keep an ordinal NAMED until the team resolves
+ * it. Without this the record clears the moment the branch merges -- its own
+ * unclaimed file then reads as inherited from integration, the detection goes
+ * quiet, and the record reports success for a problem that only moved.
+ *
+ * Parsed from the rendered lines rather than stored twice: one text is what a
+ * human reads on the Debug tab AND what the team is shown, and a second
+ * machine-readable copy is a second thing to keep in step.
+ */
+export function parseUnclaimedOrdinals(content) {
+    return parseUnclaimedEntries(content).map((e) => e.ordinal);
+}
+/**
+ * The record's entries, WITH their paths.
+ *
+ * The ordinals alone are not enough to re-render the record. When integration
+ * cannot be read, an ordinal the branch no longer shows can be neither proved
+ * merged nor proved removed -- so it must be carried forward verbatim, and
+ * carrying it forward needs the file it named. Reading it back from the record
+ * (rather than storing a second machine-readable copy) keeps one text as both
+ * what a human reads and what the lifecycle reasons over.
+ */
+export function parseUnclaimedEntries(content) {
+    if (!content)
+        return [];
+    const entries = [];
+    for (const line of content.split('\n')) {
+        const match = /^- (\S+)\s\s(.+)$/.exec(line);
+        if (match?.[1])
+            entries.push({ ordinal: match[1], path: (match[2] ?? '').trim() });
+    }
+    return entries;
+}
+/**
+ * Mark this focus's record as having been handed to the team.
+ *
+ * Called when the record is composed into a spawn prompt -- the moment the team
+ * is actually told. Writing it earlier (at detection) would lift the hold
+ * before anyone read it; writing it later (after the session ends) would hold a
+ * second turn for a file already named.
+ *
+ * Best effort by construction: a spawn is never failed by this write. The cost
+ * of losing it is one extra coding turn, and the cost of the whole mechanism
+ * failing is what it was before -- the team is still shown the record on every
+ * spawn while it stands, because the section renders on the record's existence,
+ * not on this marker.
+ */
+export async function markUnclaimedMigrationNamed(focusId, namedAt, deps = {}) {
+    const api = deps.callApi ?? callApi;
+    try {
+        const existing = await readExistingRecord(focusId, api);
+        if (existing === undefined)
+            return;
+        if (parseUnclaimedNamedAt(existing) !== null)
+            return; // already named
+        await api('focus_debug_set', {
+            focusId,
+            fields: {
+                sectionKind: UNCLAIMED_MIGRATION_SECTION_KIND,
+                content: `${existing}\n${UNCLAIMED_NAMED_PREFIX}${namedAt}`,
+            },
+        });
+    }
+    catch {
+        // See above: never fails a spawn.
+    }
+}
+//# sourceMappingURL=focus-unclaimed-migration.js.map

package/dist/queries/focus-unclaimed-migration.js.map

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

package/dist/queries/live-focus-branches.d.ts

@@ -0,0 +1,32 @@
+import type { callApi } from './shared.js';
+/**
+ * Focus statuses whose branch holds no numbers the allocator must avoid.
+ *
+ * The daemon's copy of `supabase/functions/_shared/migration-branch-population.ts`'s list --
+ * pinned EQUAL to it by `live-focus-branches.test.ts`, which imports the shared
+ * module itself rather than restating the values. Copied rather than imported
+ * because a Deno `_shared` module is not on the daemon's import graph, and
+ * copied WITH a test rather than trusted, because that is the whole lesson
+ * above.
+ */
+export declare const TERMINAL_FOCUS_STATUSES: readonly string[];
+/** A focus row as the branch population question needs it. */
+export interface BranchPopulationRow {
+    status?: string;
+    branchName?: string | null;
+}
+/** Does this focus's branch hold migration numbers? */
+export declare function branchHoldsMigrationNumbers(row: BranchPopulationRow): boolean;
+/** Every branch in that population, deduplicated and ordered. */
+export declare function migrationBranchPopulation(rows: ReadonlyArray<BranchPopulationRow>): string[];
+/**
+ * Read that population for one product.
+ *
+ * Scans EVERY focus (the same read the claim lifecycle pass uses) and narrows
+ * with the shared rule, rather than asking the API for a pre-narrowed set whose
+ * definition of "live" is somebody else's.
+ */
+export declare function listLiveFocusBranches(productId: string, deps?: {
+    callApi?: typeof callApi;
+}): Promise<string[]>;
+//# sourceMappingURL=live-focus-branches.d.ts.map

package/dist/queries/live-focus-branches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-focus-branches.d.ts","sourceRoot":"","sources":["../../src/queries/live-focus-branches.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAA8B,CAAC;AAEpF,8DAA8D;AAC9D,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,uDAAuD;AACvD,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAI7E;AAED,iEAAiE;AACjE,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,aAAa,CAAC,mBAAmB,CAAC,GAAG,MAAM,EAAE,CAK5F;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,OAAO,CAAA;CAAO,GACtC,OAAO,CAAC,MAAM,EAAE,CAAC,CAOnB"}

package/dist/queries/live-focus-branches.js

@@ -0,0 +1,66 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/migrations/claim-production-wiring.test.ts,
+//   packages/daemon/src/queries/live-focus-branches.test.ts
+// PINNED-BY-END
+/**
+ * The branches a product's held set must be read from.
+ *
+ * DELIBERATELY NOT `getActiveFocuses`. That read is the SPAWN set: active
+ * focuses WITH an assigned agent role. Using it here published only the
+ * branches of focuses a team was currently running on -- while the grant
+ * handler required a reading to cover every non-terminal focus branch. An
+ * active focus whose arm had been cleared therefore sat in the required set and
+ * never in the published one, and every claim on that product refused as
+ * uncovered until somebody re-armed or ended it. A fail-closed allocator with
+ * no way out is worse than the collision it guards against: the only move left
+ * to a team is to number by hand, which is the failure being removed.
+ *
+ * The rule itself is stated once, in `supabase/functions/_shared/migration-branch-population.ts`
+ * (canonical `src/lib/vocabulary/migration-branch-population.ts`), and applied
+ * by BOTH sides -- here and in the grant handler's coverage check. This module
+ * is only the daemon's reader for it.
+ *
+ * @module queries/live-focus-branches
+ */
+import { scanAllFocuses } from './focuses.js';
+/**
+ * Focus statuses whose branch holds no numbers the allocator must avoid.
+ *
+ * The daemon's copy of `supabase/functions/_shared/migration-branch-population.ts`'s list --
+ * pinned EQUAL to it by `live-focus-branches.test.ts`, which imports the shared
+ * module itself rather than restating the values. Copied rather than imported
+ * because a Deno `_shared` module is not on the daemon's import graph, and
+ * copied WITH a test rather than trusted, because that is the whole lesson
+ * above.
+ */
+export const TERMINAL_FOCUS_STATUSES = ['complete', 'cancelled'];
+/** Does this focus's branch hold migration numbers? */
+export function branchHoldsMigrationNumbers(row) {
+    const branch = (row.branchName ?? '').trim();
+    if (branch === '')
+        return false;
+    return !TERMINAL_FOCUS_STATUSES.includes(row.status ?? '');
+}
+/** Every branch in that population, deduplicated and ordered. */
+export function migrationBranchPopulation(rows) {
+    const branches = rows
+        .filter((row) => branchHoldsMigrationNumbers(row))
+        .map((row) => (row.branchName ?? '').trim());
+    return [...new Set(branches)].sort();
+}
+/**
+ * Read that population for one product.
+ *
+ * Scans EVERY focus (the same read the claim lifecycle pass uses) and narrows
+ * with the shared rule, rather than asking the API for a pre-narrowed set whose
+ * definition of "live" is somebody else's.
+ */
+export async function listLiveFocusBranches(productId, deps = {}) {
+    const result = await scanAllFocuses({
+        productId,
+        detail: 'summary',
+        ...(deps.callApi ? { callApi: deps.callApi } : {}),
+    });
+    return migrationBranchPopulation(result.focuses);
+}
+//# sourceMappingURL=live-focus-branches.js.map

package/dist/queries/live-focus-branches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-focus-branches.js","sourceRoot":"","sources":["../../src/queries/live-focus-branches.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,6EAA6E;AAC7E,4DAA4D;AAC5D,gBAAgB;AAEhB;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAsB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AAQpF,uDAAuD;AACvD,MAAM,UAAU,2BAA2B,CAAC,GAAwB;IAClE,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,IAAI,MAAM,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IAChC,OAAO,CAAC,uBAAuB,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,yBAAyB,CAAC,IAAwC;IAChF,MAAM,QAAQ,GAAG,IAAI;SAClB,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,2BAA2B,CAAC,GAAG,CAAC,CAAC;SACjD,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACvC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,SAAiB,EACjB,OAAqC,EAAE;IAEvC,MAAM,MAAM,GAAG,MAAM,cAAc,CAAkD;QACnF,SAAS;QACT,MAAM,EAAE,SAAS;QACjB,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACnD,CAAC,CAAC;IACH,OAAO,yBAAyB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACnD,CAAC"}

package/dist/queries/migration-claims.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Reading and moving migration claims from the daemon.
+ *
+ * The daemon is the only party that can SEE what a focus branch holds, so it is
+ * the only party that can say a claim was realised or abandoned. It never
+ * GRANTS one -- that is the edge handler's, atomically, under the partial
+ * unique index -- so nothing here computes a number.
+ *
+ * @module queries/migration-claims
+ */
+import { type CallApiDeps } from './shared.js';
+import type { ConfirmDecision, LifecycleClaim, ReleaseDecision } from '../migrations/migration-claim-lifecycle.js';
+/**
+ * Every UNRELEASED claim on a product, keyed by focus.
+ *
+ * Read per product rather than per focus: one call answers the whole pass, and
+ * a focus with no claims simply has no entry -- which is different from a focus
+ * whose read failed, and the caller can tell because a failed read throws.
+ */
+export declare function listLiveMigrationClaims(productId: string, deps?: CallApiDeps): Promise<Map<string, LifecycleClaim[]>>;
+/** Mark claims confirmed, with the tag the file on the branch actually carries. */
+export declare function confirmMigrationClaims(productId: string, decisions: readonly ConfirmDecision[], deps?: CallApiDeps): Promise<void>;
+/** Release claims whose focus ended without the file, recording why. */
+export declare function releaseMigrationClaims(productId: string, decisions: readonly ReleaseDecision[], deps?: CallApiDeps): Promise<void>;
+//# sourceMappingURL=migration-claims.d.ts.map

package/dist/queries/migration-claims.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-claims.d.ts","sourceRoot":"","sources":["../../src/queries/migration-claims.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AAEH,OAAO,EAAW,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,eAAe,EAChB,MAAM,4CAA4C,CAAC;AAYpD;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC,CA8BxC;AAED,mFAAmF;AACnF,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,SAAS,eAAe,EAAE,EACrC,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wEAAwE;AACxE,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,SAAS,eAAe,EAAE,EACrC,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/queries/migration-claims.js

@@ -0,0 +1,79 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/queries/migration-claims.test.ts
+// PINNED-BY-END
+/**
+ * Reading and moving migration claims from the daemon.
+ *
+ * The daemon is the only party that can SEE what a focus branch holds, so it is
+ * the only party that can say a claim was realised or abandoned. It never
+ * GRANTS one -- that is the edge handler's, atomically, under the partial
+ * unique index -- so nothing here computes a number.
+ *
+ * @module queries/migration-claims
+ */
+import { callApi } from './shared.js';
+/**
+ * Every UNRELEASED claim on a product, keyed by focus.
+ *
+ * Read per product rather than per focus: one call answers the whole pass, and
+ * a focus with no claims simply has no entry -- which is different from a focus
+ * whose read failed, and the caller can tell because a failed read throws.
+ */
+export async function listLiveMigrationClaims(productId, deps = {}) {
+    const api = deps.callApi ?? callApi;
+    const result = await api('migration_claim_list', {
+        productId,
+        includeReleased: false,
+        limit: 500,
+    });
+    const byFocus = new Map();
+    for (const row of result?.claims ?? []) {
+        if (!row.migrationClaimId || !row.ordinal)
+            continue;
+        const focusId = row.focusId ?? '';
+        // A claim with no focus follows no branch, so the lifecycle has nothing to
+        // confirm or release it against. It is grouped under '' and simply skipped
+        // by the pass, rather than being attributed to an arbitrary focus.
+        const claims = byFocus.get(focusId) ?? [];
+        claims.push({
+            migrationClaimId: row.migrationClaimId,
+            focusId: row.focusId ?? null,
+            ordinal: row.ordinal,
+            tag: row.tag ?? null,
+            confirmedAt: row.confirmedAt ?? null,
+            // What the FILE carried at the last confirmation -- the only thing a
+            // re-confirmation may compare against. Dropping it here is what made the
+            // decision fall back to the frozen intent and rewrite forever.
+            confirmedTag: row.confirmedTag ?? null,
+        });
+        byFocus.set(focusId, claims);
+    }
+    return byFocus;
+}
+/** Mark claims confirmed, with the tag the file on the branch actually carries. */
+export async function confirmMigrationClaims(productId, decisions, deps = {}) {
+    if (decisions.length === 0)
+        return;
+    const api = deps.callApi ?? callApi;
+    await api('migration_claim_confirm', {
+        productId,
+        claims: decisions.map((d) => ({
+            migrationClaimId: d.migrationClaimId,
+            confirmedTag: d.confirmedTag,
+        })),
+    });
+}
+/** Release claims whose focus ended without the file, recording why. */
+export async function releaseMigrationClaims(productId, decisions, deps = {}) {
+    if (decisions.length === 0)
+        return;
+    const api = deps.callApi ?? callApi;
+    await api('migration_claim_release', {
+        productId,
+        claims: decisions.map((d) => ({
+            migrationClaimId: d.migrationClaimId,
+            reason: d.reason,
+        })),
+    });
+}
+//# sourceMappingURL=migration-claims.js.map

package/dist/queries/migration-claims.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-claims.js","sourceRoot":"","sources":["../../src/queries/migration-claims.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,kEAAkE;AAClE,gBAAgB;AAEhB;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAoB,MAAM,aAAa,CAAC;AAiBxD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,SAAiB,EACjB,OAAoB,EAAE;IAEtB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC;IACpC,MAAM,MAAM,GAAG,MAAM,GAAG,CAA0B,sBAAsB,EAAE;QACxE,SAAS;QACT,eAAe,EAAE,KAAK;QACtB,KAAK,EAAE,GAAG;KACX,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,IAAI,GAAG,EAA4B,CAAC;IACpD,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC;QACvC,IAAI,CAAC,GAAG,CAAC,gBAAgB,IAAI,CAAC,GAAG,CAAC,OAAO;YAAE,SAAS;QACpD,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;QAClC,2EAA2E;QAC3E,2EAA2E;QAC3E,mEAAmE;QACnE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC;YACV,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;YACtC,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI;YAC5B,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,IAAI;YACpB,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,IAAI;YACpC,qEAAqE;YACrE,yEAAyE;YACzE,+DAA+D;YAC/D,YAAY,EAAE,GAAG,CAAC,YAAY,IAAI,IAAI;SACvC,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,SAAiB,EACjB,SAAqC,EACrC,OAAoB,EAAE;IAEtB,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC;IACpC,MAAM,GAAG,CAAC,yBAAyB,EAAE;QACnC,SAAS;QACT,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5B,gBAAgB,EAAE,CAAC,CAAC,gBAAgB;YACpC,YAAY,EAAE,CAAC,CAAC,YAAY;SAC7B,CAAC,CAAC;KACJ,CAAC,CAAC;AACL,CAAC;AAED,wEAAwE;AACxE,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,SAAiB,EACjB,SAAqC,EACrC,OAAoB,EAAE;IAEtB,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC;IACpC,MAAM,GAAG,CAAC,yBAAyB,EAAE;QACnC,SAAS;QACT,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5B,gBAAgB,EAAE,CAAC,CAAC,gBAAgB;YACpC,MAAM,EAAE,CAAC,CAAC,MAAM;SACjB,CAAC,CAAC;KACJ,CAAC,CAAC;AACL,CAAC"}