@telora/daemon 0.22.189 → 0.22.208

package/dist/migrations/migration-manifest.js

@@ -0,0 +1,295 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/migrations/concurrent-claim-regression.test.ts,
+//   packages/daemon/src/migrations/held-set-grant-effect.test.ts,
+//   packages/daemon/src/migrations/migration-held-set.test.ts,
+//   packages/daemon/src/migrations/migration-inventory.test.ts,
+//   packages/daemon/src/migrations/migration-manifest-parity.test.ts,
+//   packages/daemon/src/migrations/migration-manifest.test.ts,
+//   packages/daemon/src/spawn/migration-numbering-wiring.test.ts,
+//   packages/daemon/src/spawn/spawn-and-acknowledge.test.ts
+// PINNED-BY-END
+/**
+ * A repo's declaration of its migration numbering (`telora.migrations.json` at
+ * the repo root).
+ *
+ * WHAT THIS IS FOR
+ * ----------------
+ * A migration number must be claimed ONCE across a product, before the file
+ * exists, or two concurrently-armed focuses compute the same "next free" number
+ * from the same stale base and both take it. The allocator that grants a number
+ * cannot do that without knowing two things it has no way to infer: where a
+ * product keeps its migrations, and how a number is read out of a filename.
+ * This module is the first half of that perception -- the repo SAYS.
+ *
+ * WHY A DECLARATION rather than a hard-coded convention
+ * -----------------------------------------------------
+ * Two live products number their migrations differently, and neither layout can
+ * be inferred from the other:
+ *
+ *   - Telora: `supabase/migrations/20260614172757_name.sql`. The ordinal is a
+ *     14-digit timestamp prefix, so the scheme is `timestamp`. No journal.
+ *   - Tinker Tailor: `lib/db/migrations/0352_a_cloth_names_its_supplier.sql`.
+ *     The ordinal is a 4-digit prefix and the scheme is `sequential`;
+ *     `lib/db/migrations/meta/_journal.json` registers each migration with an
+ *     `idx` and a `tag`. `db:generate` is unusable there, so the migrations AND
+ *     the journal entries are both written BY HAND.
+ *
+ * A mechanism that assumed a generator would serve only the first. So the repo
+ * declares, and the daemon reads the declaration -- the same shape
+ * `telora.verify.json` uses to declare the repo's gate command
+ * (`verify/verification-manifest.ts`), for the same reason: the declaration
+ * travels with the code it describes.
+ *
+ * WHY `scheme` IS REQUIRED
+ * ------------------------
+ * It is the one field the filename pattern does not already imply, and the
+ * allocator's behaviour turns on it entirely: under `sequential` the next free
+ * number is the highest held plus one, and under `timestamp` it is the current
+ * time. Guessing from the ordinal's width would read a 14-digit sequential
+ * scheme as a timestamp -- and the failure would be silent, because both
+ * guesses produce a plausible number. A product that ships this file must say
+ * which it is.
+ *
+ * WHY MALFORMED FAILS LOUDLY (missing does not)
+ * ---------------------------------------------
+ * The asymmetry is `verification-manifest.ts`'s, applied here, and downstream it
+ * is load-bearing rather than stylistic:
+ *
+ *   - MISSING file => `undefined`. A repo that ships no declaration has said
+ *     nothing: it opts out, and the daemon manages plenty of repos with no
+ *     migrations at all. Its teams keep numbering the way they do today.
+ *   - MALFORMED file => THROW, naming the path and the problem. A repo that
+ *     ships a declaration HAS said something and we could not read it. The
+ *     consumer is an allocator answering "which number is free?", and an
+ *     unreadable declaration degraded to "no declaration" would leave that
+ *     question to be answered from a worktree -- reinstating, on a typo, the
+ *     exact cause this mechanism exists to remove. A broken declaration is
+ *     louder than no declaration.
+ *
+ * That distinction is why {@link readMigrationManifest} has three outcomes and
+ * not two: undeclared, unreadable, and declared. A consumer holds on the second
+ * while ignoring the first.
+ *
+ * ORDINALS ARE STRINGS
+ * --------------------
+ * Both live schemes are zero-padded fixed width (`0352`, `20260614172757`), so
+ * string ordering IS numeric ordering within one repo. Nothing here parses an
+ * ordinal to a number; introducing a parse would only add a way to mis-read one.
+ *
+ * KNOWN SEAM, deliberately not closed here: the padding WIDTH a sequential
+ * allocator must emit is not declared. It is recoverable from the ordinals a
+ * ref holds (they are fixed width by construction), which covers every product
+ * that already has a migration. A sequential product with NO migrations yet has
+ * no width to recover, and choosing what to do there belongs to the allocator
+ * that grants the number, not to the file that describes the layout.
+ *
+ * @module migration-manifest
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+/**
+ * Filename of the repo-committed migration declaration, at the REPO ROOT.
+ *
+ * Repo-root for the same reason `telora.verify.json` is: `.gitignore` excludes
+ * `.telora/` wholesale and git cannot re-include a file whose parent directory
+ * is excluded, so a declaration nested there could never be tracked.
+ */
+export const MIGRATION_MANIFEST_FILENAME = 'telora.migrations.json';
+/** Every scheme this reader accepts, in the order an error message lists them. */
+export const MIGRATION_SCHEMES = ['sequential', 'timestamp'];
+/** Real-fs default for {@link MigrationManifestFs}. */
+export const defaultMigrationManifestFs = {
+    exists: (path) => existsSync(path),
+    readText: (path) => readFileSync(path, 'utf-8'),
+};
+/** Absolute path of the migration declaration for a repo. */
+export function resolveMigrationManifestPath(repoPath) {
+    return resolve(repoPath, MIGRATION_MANIFEST_FILENAME);
+}
+/**
+ * Thrown when a declaration EXISTS and cannot be read.
+ *
+ * A distinct class, not a bare Error, because the difference between "this
+ * product declared nothing" and "this product's declaration is broken" has to
+ * survive all the way to the team that asked for a number: the first is a
+ * product that opted out, the second is a bug someone must fix. A consumer that
+ * cannot tell them apart can only collapse both into a guess.
+ */
+export class MigrationManifestError extends Error {
+    /** Absolute path of the declaration that could not be read. */
+    manifestPath;
+    constructor(manifestPath, problem) {
+        super(`Invalid Telora migration declaration at ${manifestPath}: ${problem}. `
+            + `A malformed declaration is never degraded to "this repo declares no migration `
+            + `numbering" -- that would send the team back to numbering from its own worktree, `
+            + `which is the whole failure this declaration exists to remove. Fix the file, or `
+            + `delete it to opt this repo out of claiming migration numbers through Telora.`);
+        this.name = 'MigrationManifestError';
+        this.manifestPath = manifestPath;
+    }
+}
+/** Throw a declaration error that always names the offending file. */
+function manifestError(path, problem) {
+    throw new MigrationManifestError(path, problem);
+}
+/** A repo-relative path that is safe to hand to git as a pathspec. */
+function requireRepoRelativePath(raw, key, path) {
+    if (typeof raw !== 'string') {
+        manifestError(path, raw === undefined
+            ? `missing required "${key}" string (check for a typo in the key)`
+            : `"${key}" must be a string (got ${typeof raw})`);
+    }
+    const value = raw.trim();
+    if (value === '')
+        manifestError(path, `"${key}" must not be empty`);
+    if (value.startsWith('/')) {
+        manifestError(path, `"${key}" must be repo-relative, not absolute (got ${JSON.stringify(value)})`);
+    }
+    if (value.split('/').includes('..')) {
+        manifestError(path, `"${key}" must not escape the repo with ".." (got ${JSON.stringify(value)})`);
+    }
+    return value.replace(/\/+$/, '');
+}
+/**
+ * The file pattern must compile AND capture both `ordinal` and `tag`.
+ *
+ * A pattern missing a group is malformed rather than partially usable: a claim
+ * records the tag alongside the number, and the confirm pass matches the file
+ * that lands against the claim by both.
+ */
+function requireFilePattern(raw, path) {
+    if (typeof raw !== 'string') {
+        manifestError(path, raw === undefined
+            ? `missing required "filePattern" string (check for a typo in the key)`
+            : `"filePattern" must be a string (got ${typeof raw})`);
+    }
+    if (raw.trim() === '')
+        manifestError(path, `"filePattern" must not be empty`);
+    let compiled;
+    try {
+        compiled = new RegExp(raw);
+    }
+    catch (err) {
+        manifestError(path, `"filePattern" is not a valid regular expression (${String(err?.message ?? err)})`);
+    }
+    for (const group of ['ordinal', 'tag']) {
+        if (!compiled.source.includes(`(?<${group}>`)) {
+            manifestError(path, `"filePattern" must carry a named capture group (?<${group}>...) -- `
+                + `a claim is recorded by ${group === 'ordinal' ? 'number' : 'number AND tag'}`);
+        }
+    }
+    return raw;
+}
+/**
+ * The scheme. Required, and an unrecognised value is malformed rather than
+ * defaulted: see the module header on why guessing it fails silently.
+ */
+function requireScheme(raw, path) {
+    if (typeof raw !== 'string') {
+        manifestError(path, raw === undefined
+            ? `missing required "scheme" string -- one of ${MIGRATION_SCHEMES.join(' | ')} `
+                + `(the allocator grants the next ordinal under sequential and the current time `
+                + `under timestamp, so it cannot be inferred)`
+            : `"scheme" must be a string (got ${typeof raw})`);
+    }
+    const value = raw.trim();
+    const match = MIGRATION_SCHEMES.find((scheme) => scheme === value);
+    if (match === undefined) {
+        manifestError(path, `"scheme" must be one of ${MIGRATION_SCHEMES.join(' | ')} `
+            + `(got ${JSON.stringify(raw)})`);
+    }
+    return match;
+}
+/** The optional journal declaration. Present-but-wrong is malformed, like every other field. */
+function optionalJournal(raw, path) {
+    const value = raw.journal;
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        manifestError(path, `"journal" must be an object with a "path" `
+            + `(got ${Array.isArray(value) ? 'an array' : typeof value})`);
+    }
+    const journalPath = requireRepoRelativePath(value.path, 'journal.path', path);
+    return { path: journalPath };
+}
+/**
+ * Read the repo's migration declaration.
+ *
+ * @param repoPath Product repo root (`configForProduct` sets this per product).
+ *                 Undefined => no repo to read => `undefined`.
+ * @param fs       Injectable fs seam; defaults to real fs.
+ * @returns The parsed declaration, or `undefined` when the repo declares no
+ *          migration numbering at all.
+ * @throws  {@link MigrationManifestError} naming the file path when the
+ *          declaration exists but is unreadable / not JSON / not an object /
+ *          missing `dir`, `scheme` or a `filePattern` carrying both named
+ *          groups / carrying a malformed `journal`.
+ */
+export function readMigrationManifest(repoPath, fs = defaultMigrationManifestFs) {
+    if (!repoPath)
+        return undefined;
+    const path = resolveMigrationManifestPath(repoPath);
+    if (!fs.exists(path))
+        return undefined;
+    let text;
+    try {
+        text = fs.readText(path);
+    }
+    catch (err) {
+        manifestError(path, `file could not be read (${String(err?.message ?? err)})`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (err) {
+        manifestError(path, `not valid JSON (${String(err?.message ?? err)})`);
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        manifestError(path, `expected a JSON object, got ${Array.isArray(parsed) ? 'an array' : typeof parsed}`);
+    }
+    const raw = parsed;
+    const journal = optionalJournal(raw, path);
+    return {
+        dir: requireRepoRelativePath(raw.dir, 'dir', path),
+        filePattern: requireFilePattern(raw.filePattern, path),
+        scheme: requireScheme(raw.scheme, path),
+        ...(journal !== undefined ? { journal } : {}),
+    };
+}
+/**
+ * The ordinal width the DECLARATION fixes, or null when it fixes none.
+ *
+ * WHY THE DECLARATION IS ASKED THIS AT ALL. A journal registers `idx` as a bare
+ * number (351) while the filename carries it padded (`0351`), so unioning the
+ * two needs a width to normalise to. The filenames were the only source of one
+ * -- and a ref whose only surviving evidence is a journal entry (files removed,
+ * a journal written ahead of them) has no filenames. The raw `351` then went
+ * into the held set, the candidate rule read the width of what it was given,
+ * derived 3, and proposed `352` on a product whose migrations must match
+ * `^\d{4}`. A number that cannot be the name of a migration on this product is
+ * worse than a refusal: it is granted, written, and discovered by whoever runs
+ * the migrations.
+ *
+ * The declaration knew the width the whole time. `^(?<ordinal>\d{4})_` says
+ * four digits, and it says it authoritatively: a filename of any other width
+ * does not match the pattern, so no inventoried file can disagree with it.
+ *
+ * Null when the pattern does not FIX a width (`\d+`, a character class, an
+ * alternation). Then the filenames are the authority, as they were -- this adds
+ * a source, it does not replace one.
+ */
+export function declaredOrdinalWidth(filePattern) {
+    // The `ordinal` group's body, for a body containing no nested parens (every
+    // width-fixing pattern is of that shape; anything else answers null anyway).
+    const group = /\(\?<ordinal>((?:\\.|[^()\\])*)\)/.exec(filePattern);
+    const body = group?.[1];
+    if (body === undefined)
+        return null;
+    const fixed = /^(?:\\d|\[0-9\])\{(\d+)\}$/.exec(body);
+    if (fixed === null)
+        return null;
+    const width = Number(fixed[1]);
+    return Number.isInteger(width) && width > 0 ? width : null;
+}
+//# sourceMappingURL=migration-manifest.js.map

package/dist/migrations/migration-manifest.js.map

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

package/dist/prompt/team-prompt-base.js

@@ -1,5 +1,5 @@
 // PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
-// Pinned by: 24 tests -- run: npm run gen:pinned-by -- --list packages/daemon/src/prompt/team-prompt-base.ts
+// Pinned by: 27 tests -- run: npm run gen:pinned-by -- --list packages/daemon/src/prompt/team-prompt-base.ts
 // PINNED-BY-END
 // Role-framework sections.
 export { buildRoleSection, buildDomainBoundariesSection, buildTeamLeadRoleSection, buildReadOnlyAuditSection, } from '../prompt-sections/role-sections.js';

package/dist/prompt-sections/migration-numbering-section.d.ts

@@ -0,0 +1,58 @@
+/**
+ * The numbering rule: what a coding team is told about claiming a migration
+ * number before it names the file.
+ *
+ * WHY A PROMPT SECTION AND NOT JUST A TOOL
+ * ----------------------------------------
+ * The allocator exists, but a team that does not know to call it numbers from
+ * its worktree exactly as before -- and that is the entire failure. The MCP
+ * tool is the mechanism; this is how the team comes to use it. Telora is in the
+ * loop at the moment the file is named because the team's tooling IS Telora's
+ * MCP and the daemon composes the prompt, so the rule arrives with the work
+ * rather than living in a wiki page someone might read.
+ *
+ * WHY EVERY MESSAGE SHAPE
+ * -----------------------
+ * A team writes a migration on whichever turn the work lands on. A rule carried
+ * only by the fresh prompt is absent from the resume delta -- which is most
+ * turns of a long focus -- so the section is composed into the fresh prompt,
+ * the resume delta and the forced-fresh scoping turn alike, through the same
+ * seam `integration-reconcile-section.ts` uses, and is therefore byte-identical
+ * across both engine backends (they encode the same text).
+ *
+ * WHEN IT RENDERS NOTHING
+ * -----------------------
+ *   - A product that declares no migration numbering. Its teams keep numbering
+ *     as they do today; telling them to call a tool that will refuse would be
+ *     worse than silence.
+ *   - A REVIEW pass. A reviewer writes no migrations.
+ *
+ * It DOES render on a product whose declaration is BROKEN, with different text:
+ * that team's claims will refuse, and being told why beats discovering it at
+ * the moment it needs a number.
+ *
+ * @module migration-numbering-section
+ */
+import type { MigrationManifest } from '../migrations/migration-manifest.js';
+/** The section's heading -- the anchor callers and tests name it by. */
+export declare const MIGRATION_NUMBERING_HEADING = "# CLAIM YOUR MIGRATION NUMBER BEFORE YOU NAME THE FILE";
+/** What the spawn knows about this product's migration numbering. */
+export type MigrationNumberingState = 
+/** The product declares numbering, and it reads. */
+{
+    kind: 'declared';
+    manifest: MigrationManifest;
+}
+/** A declaration exists and is broken; claims will refuse until it is fixed. */
+ | {
+    kind: 'declarationUnreadable';
+    reason: string;
+};
+/**
+ * The numbering rule, as a block to append to a CODING message.
+ *
+ * Returns [] when `state` is null (the product declares no numbering) or when
+ * the pass is a review, so those messages compose exactly as they do today.
+ */
+export declare function buildMigrationNumberingSection(state: MigrationNumberingState | null, isReviewPass: boolean): string[];
+//# sourceMappingURL=migration-numbering-section.d.ts.map

package/dist/prompt-sections/migration-numbering-section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-numbering-section.d.ts","sourceRoot":"","sources":["../../src/prompt-sections/migration-numbering-section.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAE7E,wEAAwE;AACxE,eAAO,MAAM,2BAA2B,2DAA2D,CAAC;AAEpG,qEAAqE;AACrE,MAAM,MAAM,uBAAuB;AACjC,oDAAoD;AAClD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,iBAAiB,CAAA;CAAE;AACnD,gFAAgF;GAC9E;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,uBAAuB,GAAG,IAAI,EACrC,YAAY,EAAE,OAAO,GACpB,MAAM,EAAE,CAwDV"}

package/dist/prompt-sections/migration-numbering-section.js

@@ -0,0 +1,70 @@
+// 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/spawn/migration-numbering-spawn.test.ts,
+//   packages/daemon/src/spawn/migration-numbering-wiring.test.ts,
+//   packages/daemon/src/spawn/spawn-and-acknowledge.test.ts
+// PINNED-BY-END
+/** The section's heading -- the anchor callers and tests name it by. */
+export const MIGRATION_NUMBERING_HEADING = '# CLAIM YOUR MIGRATION NUMBER BEFORE YOU NAME THE FILE';
+/**
+ * The numbering rule, as a block to append to a CODING message.
+ *
+ * Returns [] when `state` is null (the product declares no numbering) or when
+ * the pass is a review, so those messages compose exactly as they do today.
+ */
+export function buildMigrationNumberingSection(state, isReviewPass) {
+    if (isReviewPass || state === null)
+        return [];
+    if (state.kind === 'declarationUnreadable') {
+        return [
+            MIGRATION_NUMBERING_HEADING,
+            '',
+            "This product's `telora.migrations.json` cannot be read, so Telora cannot grant",
+            'migration numbers for it:',
+            '',
+            `    ${state.reason}`,
+            '',
+            'If your work needs a migration, FIX THE DECLARATION FIRST -- a claim against a',
+            'broken declaration is refused, deliberately, rather than answered with a guessed',
+            'number. Do not fall back to reading the highest number in this worktree: that is',
+            'the exact thing the declaration exists to stop.',
+        ];
+    }
+    const { dir, scheme } = state.manifest;
+    const schemeLine = scheme === 'sequential'
+        ? 'the next number after the highest any of them holds'
+        : 'a timestamp no other claim holds';
+    return [
+        MIGRATION_NUMBERING_HEADING,
+        '',
+        'Do NOT pick a migration number by looking at this worktree. Claim it through',
+        'Telora first:',
+        '',
+        '    telora_product_migration { action: "claim", productId, focusId, tag: "<name>" }',
+        '',
+        `You get back the ordinal to use and the filename stem to write under \`${dir}\`.`,
+        '',
+        'WHY. Two focuses armed at once on this product work in separate worktrees cut',
+        'from the same base. "The next free number" computed locally is the same number',
+        'your sibling just computed locally -- and git sees no conflict, because the two',
+        'files have different names. The merge admits both, and it surfaces only when the',
+        'migrations are applied in order. On 2026-09-22 that cost a renumber of four',
+        'migrations, three renamed sensor tests, a rebuilt journal tail and ~40 corrected',
+        'references across 79 files, with a finished delivery stranded at verify.',
+        '',
+        `The claim is granted from what integration holds, what every live focus branch`,
+        `holds, and every outstanding claim -- ${schemeLine}. None of that is visible from`,
+        'here. The grant is atomic, so two teams claiming in the same instant never',
+        'receive one number.',
+        '',
+        'Pass the `tag` you intend to use. If the file ends up named differently that is',
+        'fine -- the daemon confirms your claim with the tag the file actually carries.',
+        '',
+        'IF THE CLAIM IS REFUSED, do not work around it. `migration_numbering_unavailable`',
+        'means the declaration is missing or broken; `migration_held_set_unavailable` means',
+        'no daemon has reported what the branches hold, or a branch could not be read, so',
+        'granting would be guessing. Both are refusals on purpose. Fix the cause or raise',
+        'it -- numbering by hand is what they exist to prevent.',
+    ];
+}
+//# sourceMappingURL=migration-numbering-section.js.map

package/dist/prompt-sections/migration-numbering-section.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-numbering-section.js","sourceRoot":"","sources":["../../src/prompt-sections/migration-numbering-section.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,6EAA6E;AAC7E,iEAAiE;AACjE,kEAAkE;AAClE,4DAA4D;AAC5D,gBAAgB;AAwChB,wEAAwE;AACxE,MAAM,CAAC,MAAM,2BAA2B,GAAG,wDAAwD,CAAC;AASpG;;;;;GAKG;AACH,MAAM,UAAU,8BAA8B,CAC5C,KAAqC,EACrC,YAAqB;IAErB,IAAI,YAAY,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAE9C,IAAI,KAAK,CAAC,IAAI,KAAK,uBAAuB,EAAE,CAAC;QAC3C,OAAO;YACL,2BAA2B;YAC3B,EAAE;YACF,gFAAgF;YAChF,2BAA2B;YAC3B,EAAE;YACF,OAAO,KAAK,CAAC,MAAM,EAAE;YACrB,EAAE;YACF,gFAAgF;YAChF,kFAAkF;YAClF,kFAAkF;YAClF,iDAAiD;SAClD,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC;IACvC,MAAM,UAAU,GAAG,MAAM,KAAK,YAAY;QACxC,CAAC,CAAC,qDAAqD;QACvD,CAAC,CAAC,kCAAkC,CAAC;IAEvC,OAAO;QACL,2BAA2B;QAC3B,EAAE;QACF,8EAA8E;QAC9E,eAAe;QACf,EAAE;QACF,qFAAqF;QACrF,EAAE;QACF,0EAA0E,GAAG,KAAK;QAClF,EAAE;QACF,+EAA+E;QAC/E,gFAAgF;QAChF,iFAAiF;QACjF,kFAAkF;QAClF,6EAA6E;QAC7E,kFAAkF;QAClF,0EAA0E;QAC1E,EAAE;QACF,gFAAgF;QAChF,yCAAyC,UAAU,gCAAgC;QACnF,4EAA4E;QAC5E,qBAAqB;QACrB,EAAE;QACF,iFAAiF;QACjF,gFAAgF;QAChF,EAAE;QACF,mFAAmF;QACnF,oFAAoF;QACpF,kFAAkF;QAClF,kFAAkF;QAClF,wDAAwD;KACzD,CAAC;AACJ,CAAC"}

package/dist/prompt-sections/migration-numbering-state.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Reading a product's migration numbering for the spawn prompt.
+ *
+ * A thin adapter between the declaration reader and the prompt section: the
+ * reader THROWS on a broken declaration (deliberately -- see
+ * `migration-manifest.ts`), and the prompt must not. A spawn that failed
+ * because a product's JSON had a trailing comma would be a far worse failure
+ * than the one the declaration guards against.
+ *
+ * So the throw is turned into a state the section can render: a team whose
+ * product has a broken declaration is TOLD, because its claims will refuse and
+ * being told why beats discovering it at the moment it needs a number.
+ *
+ * Lives in `prompt-sections/` rather than `migrations/`: it exists for the
+ * PROMPT, and the migrations area is a rank-0 leaf that must not reach up into
+ * a section's types.
+ *
+ * @module migration-numbering-state
+ */
+import type { MigrationNumberingState } from './migration-numbering-section.js';
+import { type MigrationManifestFs } from '../migrations/migration-manifest.js';
+/**
+ * What the spawn should tell this product's coding teams about numbering.
+ *
+ * @returns `null` when the product declares no numbering (render nothing), a
+ *          `declared` state when it reads, or `declarationUnreadable` when it
+ *          exists and is broken.
+ */
+export declare function resolveMigrationNumberingState(repoPath: string | undefined, fs?: MigrationManifestFs): MigrationNumberingState | null;
+//# sourceMappingURL=migration-numbering-state.d.ts.map

package/dist/prompt-sections/migration-numbering-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-numbering-state.d.ts","sourceRoot":"","sources":["../../src/prompt-sections/migration-numbering-state.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,EAAyB,KAAK,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAEtG;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,EAAE,CAAC,EAAE,mBAAmB,GACvB,uBAAuB,GAAG,IAAI,CAUhC"}

package/dist/prompt-sections/migration-numbering-state.js

@@ -0,0 +1,24 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/spawn/migration-numbering-spawn.test.ts
+// PINNED-BY-END
+import { readMigrationManifest } from '../migrations/migration-manifest.js';
+/**
+ * What the spawn should tell this product's coding teams about numbering.
+ *
+ * @returns `null` when the product declares no numbering (render nothing), a
+ *          `declared` state when it reads, or `declarationUnreadable` when it
+ *          exists and is broken.
+ */
+export function resolveMigrationNumberingState(repoPath, fs) {
+    try {
+        const manifest = readMigrationManifest(repoPath, fs);
+        return manifest === undefined ? null : { kind: 'declared', manifest };
+    }
+    catch (err) {
+        return {
+            kind: 'declarationUnreadable',
+            reason: String(err?.message ?? err),
+        };
+    }
+}
+//# sourceMappingURL=migration-numbering-state.js.map

package/dist/prompt-sections/migration-numbering-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-numbering-state.js","sourceRoot":"","sources":["../../src/prompt-sections/migration-numbering-state.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,yEAAyE;AACzE,gBAAgB;AAuBhB,OAAO,EAAE,qBAAqB,EAA4B,MAAM,qCAAqC,CAAC;AAEtG;;;;;;GAMG;AACH,MAAM,UAAU,8BAA8B,CAC5C,QAA4B,EAC5B,EAAwB;IAExB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,qBAAqB,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACrD,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;IACxE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,IAAI,EAAE,uBAAuB;YAC7B,MAAM,EAAE,MAAM,CAAE,GAAa,EAAE,OAAO,IAAI,GAAG,CAAC;SAC/C,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/prompt-sections/unclaimed-migration-section.d.ts

@@ -0,0 +1,38 @@
+/**
+ * What a team is told when its own branch holds a migration it never claimed.
+ *
+ * THIS IS A GUARD ON THE RULE, NOT DETECTION AIMED AT A MERGE. It names ONE
+ * team's OWN file to THAT team. It does not compare that file against a sibling
+ * branch, does not judge a merge, and does not tell two teams to renumber --
+ * the contest-notice shape was abandoned by direction (reverted on integration
+ * in 0c634616d) precisely because two teams recomputing "next free" from the
+ * same union at the same moment collide again.
+ *
+ * WHY THE TEAM AND NOT A HUMAN. The file was written by this team, and claiming
+ * the number or removing the file is something only this team can sensibly do.
+ * An escalation would be a row in a human queue that can only wait for the same
+ * team to act. So the fact is recorded as focus state and delivered here, at the
+ * next spawn, where the party who can act is already reading.
+ *
+ * WHY IT IS WORTH TELLING AT ALL. An allocator a team can bypass in silence is
+ * not an allocator. A file written without a claim is a number nobody knows is
+ * taken -- the next team to claim can be granted it, and then two migrations
+ * exist at one number with no claim record to explain either.
+ *
+ * Renders nothing when there is no record, and never on a review pass (a
+ * reviewer wrote no migrations).
+ *
+ * @module unclaimed-migration-section
+ */
+/** The section's heading -- the anchor callers and tests name it by. */
+export declare const UNCLAIMED_MIGRATION_HEADING = "# A MIGRATION ON THIS BRANCH HAS NO CLAIM BEHIND IT";
+/**
+ * The unclaimed-file notice, as a block to append to a CODING message.
+ *
+ * @param record The stored focus_debug_artifacts content, or null when the
+ *               focus has no such record. The stored prose is carried verbatim
+ *               rather than re-rendered, so the team and a human reading the
+ *               Debug tab see the identical account.
+ */
+export declare function buildUnclaimedMigrationSection(record: string | null, isReviewPass: boolean): string[];
+//# sourceMappingURL=unclaimed-migration-section.d.ts.map

package/dist/prompt-sections/unclaimed-migration-section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unclaimed-migration-section.d.ts","sourceRoot":"","sources":["../../src/prompt-sections/unclaimed-migration-section.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,wEAAwE;AACxE,eAAO,MAAM,2BAA2B,wDAAwD,CAAC;AAEjG;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,YAAY,EAAE,OAAO,GACpB,MAAM,EAAE,CAaV"}

package/dist/prompt-sections/unclaimed-migration-section.js

@@ -0,0 +1,57 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/completion/unclaimed-migration-notice-phase.test.ts,
+//   packages/daemon/src/spawn/migration-numbering-spawn.test.ts,
+//   packages/daemon/src/spawn/migration-numbering-wiring.test.ts
+// PINNED-BY-END
+/**
+ * What a team is told when its own branch holds a migration it never claimed.
+ *
+ * THIS IS A GUARD ON THE RULE, NOT DETECTION AIMED AT A MERGE. It names ONE
+ * team's OWN file to THAT team. It does not compare that file against a sibling
+ * branch, does not judge a merge, and does not tell two teams to renumber --
+ * the contest-notice shape was abandoned by direction (reverted on integration
+ * in 0c634616d) precisely because two teams recomputing "next free" from the
+ * same union at the same moment collide again.
+ *
+ * WHY THE TEAM AND NOT A HUMAN. The file was written by this team, and claiming
+ * the number or removing the file is something only this team can sensibly do.
+ * An escalation would be a row in a human queue that can only wait for the same
+ * team to act. So the fact is recorded as focus state and delivered here, at the
+ * next spawn, where the party who can act is already reading.
+ *
+ * WHY IT IS WORTH TELLING AT ALL. An allocator a team can bypass in silence is
+ * not an allocator. A file written without a claim is a number nobody knows is
+ * taken -- the next team to claim can be granted it, and then two migrations
+ * exist at one number with no claim record to explain either.
+ *
+ * Renders nothing when there is no record, and never on a review pass (a
+ * reviewer wrote no migrations).
+ *
+ * @module unclaimed-migration-section
+ */
+/** The section's heading -- the anchor callers and tests name it by. */
+export const UNCLAIMED_MIGRATION_HEADING = '# A MIGRATION ON THIS BRANCH HAS NO CLAIM BEHIND IT';
+/**
+ * The unclaimed-file notice, as a block to append to a CODING message.
+ *
+ * @param record The stored focus_debug_artifacts content, or null when the
+ *               focus has no such record. The stored prose is carried verbatim
+ *               rather than re-rendered, so the team and a human reading the
+ *               Debug tab see the identical account.
+ */
+export function buildUnclaimedMigrationSection(record, isReviewPass) {
+    if (isReviewPass || !record || !record.trim())
+        return [];
+    return [
+        UNCLAIMED_MIGRATION_HEADING,
+        '',
+        record.trim(),
+        '',
+        'Resolve it before this branch merges: claim the number',
+        '(`telora_product_migration { action: "claim", productId, focusId, tag }`) and rename',
+        'the file to the number you are granted, or delete the file if it is not needed.',
+        'Renaming to a number you picked yourself is not a resolution -- it is the same',
+        'unclaimed number under a different digit.',
+    ];
+}
+//# sourceMappingURL=unclaimed-migration-section.js.map

package/dist/prompt-sections/unclaimed-migration-section.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unclaimed-migration-section.js","sourceRoot":"","sources":["../../src/prompt-sections/unclaimed-migration-section.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,sFAAsF;AACtF,iEAAiE;AACjE,iEAAiE;AACjE,gBAAgB;AAEhB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,wEAAwE;AACxE,MAAM,CAAC,MAAM,2BAA2B,GAAG,qDAAqD,CAAC;AAEjG;;;;;;;GAOG;AACH,MAAM,UAAU,8BAA8B,CAC5C,MAAqB,EACrB,YAAqB;IAErB,IAAI,YAAY,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IACzD,OAAO;QACL,2BAA2B;QAC3B,EAAE;QACF,MAAM,CAAC,IAAI,EAAE;QACb,EAAE;QACF,wDAAwD;QACxD,sFAAsF;QACtF,iFAAiF;QACjF,gFAAgF;QAChF,2CAA2C;KAC5C,CAAC;AACJ,CAAC"}

package/dist/queries/claim-pass-focuses.d.ts

@@ -0,0 +1,19 @@
+import type { callApi } from './shared.js';
+import type { ClaimPassFocus } from '../focus/migration-claim-pass.js';
+import type { ReleaseReason } from '../migrations/migration-claim-lifecycle.js';
+/** Why this focus's claims should be released, or null while it is live. */
+export declare function endedBecause(row: {
+    status?: string;
+    assignedAgentRoleId?: string | null;
+}): ReleaseReason | null;
+/**
+ * Every focus on the product, with its branch and its ended-reason.
+ *
+ * Focuses with no branch name are included and skipped by the pass: a focus
+ * that never got a branch holds no files, and a claim under it -- if any -- is
+ * released by its ended-reason like any other.
+ */
+export declare function listClaimPassFocuses(productId: string, deps?: {
+    callApi?: typeof callApi;
+}): Promise<ClaimPassFocus[]>;
+//# sourceMappingURL=claim-pass-focuses.d.ts.map

package/dist/queries/claim-pass-focuses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim-pass-focuses.d.ts","sourceRoot":"","sources":["../../src/queries/claim-pass-focuses.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAYhF,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,GAAG,EAAE;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC,GAAG,aAAa,GAAG,IAAI,CAMvB;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,OAAO,CAAA;CAAO,GACtC,OAAO,CAAC,cAAc,EAAE,CAAC,CAmB3B"}