@telora/daemon 0.22.245 → 0.22.289

package/dist/queries/focus-review-approval.js

@@ -1,163 +0,0 @@
-// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
-// Pinned by: packages/daemon/src/completion/review-approved-head-gate.test.ts,
-//   packages/daemon/src/completion/teardown-merge-gate.test.ts,
-//   packages/daemon/src/integration/approved-head-gate-failure-respawn-regression.test.ts,
-//   packages/daemon/src/integration/approved-head-hold-release-regression.test.ts,
-//   packages/daemon/src/integration/shortfall-ruling-disposes-proposals-regression.test.ts,
-//   packages/daemon/src/integration/standing-approval-release-regression.test.ts,
-//   packages/daemon/src/queries/focus-review-approval.test.ts
-// PINNED-BY-END
-/**
- * The commit a focus's newest CURRENT approval judged.
- *
- * product_focuses.reviewed_through_sha is a coverage watermark, not an approval:
- * it advances for an approved, an auto-approved and a gaps_found review alike
- * (the review exit stamps it on any routed outcome, and the focus_reviews mirror
- * trigger promotes reviewed_sha for every verdict), so a gaps_found review moves
- * it over the very window it found defective.
- *
- * Two durable records tie an approving outcome to the exact commit it judged:
- *   - the focus_reviews row itself: outcome 'approved' plus reviewed_sha (the
- *     review_coverage_sha the review team was checked out to, copied onto the row
- *     by review_complete in the same write as the outcome), read here through
- *     focus_review_list (completed reviews, newest first); and
- *   - a clean full-coverage auto-approval, which writes no focus_reviews row, so
- *     the review exit records the commit it covered
- *     (completion/review-auto-approval-record.ts); the caller passes those records
- *     in and each is placed in the newest-first timeline by the time it was
- *     recorded.
- *
- * An approval is CURRENT until a newer gaps_found review judges the same commit:
- * approved(X) then gaps_found(X) authorizes nothing for X until a later approval
- * of X. A newer gaps_found of a DIFFERENT commit revokes nothing -- the older
- * approval still gates the commit it judged and that commit's ancestry, while
- * the newer commits stay held -- and a newer gaps_found that recorded no sha
- * revokes every older approval (it cannot be shown to have judged another
- * commit). A skipped or outcome-less row, and an approved row with no recorded
- * sha, neither authorize nor revoke.
- *
- * @module focus-review-approval
- */
-import { z } from 'zod';
-import { callApi } from './shared.js';
-/** The focus_reviews outcome that approves the reviewed commit. */
-export const APPROVED_REVIEW_OUTCOME = 'approved';
-/** The focus_reviews outcome that rejects the reviewed commit. */
-export const GAPS_FOUND_REVIEW_OUTCOME = 'gaps_found';
-/** Reviews read per focus_review_list page. */
-export const REVIEW_PAGE_SIZE = 100;
-/**
- * Pages read before giving up; an approval older than this many reviews counts as
- * none, and so does an auto-approval no newer than every review read.
- */
-export const MAX_REVIEW_PAGES = 20;
-const ReviewVerdictRowSchema = z.object({
-    outcome: z.string().nullish(),
-    reviewedSha: z.string().nullish(),
-    completedAt: z.string().nullish(),
-});
-const ReviewPageSchema = z.object({
-    reviews: z.array(ReviewVerdictRowSchema),
-    totalCount: z.number(),
-});
-/** Whether two recorded shas name the same commit (either may be abbreviated). Pure. */
-export function sameCommit(a, b) {
-    const x = a.toLowerCase();
-    const y = b.toLowerCase();
-    return x.startsWith(y) || y.startsWith(x);
-}
-/**
- * The reviewed_sha of the newest approved row carrying one that no NEWER
- * gaps_found row revoked (one naming the same commit, or naming none), in
- * newest-first rows; null when none. Pure.
- */
-export function approvedReviewShaIn(rows) {
-    const rejected = [];
-    for (const row of rows) {
-        if (row.outcome === GAPS_FOUND_REVIEW_OUTCOME) {
-            if (!row.reviewedSha)
-                return null;
-            rejected.push(row.reviewedSha);
-        }
-        else if (row.outcome === APPROVED_REVIEW_OUTCOME && row.reviewedSha) {
-            const approved = row.reviewedSha;
-            if (!rejected.some((sha) => sameCommit(sha, approved)))
-                return approved;
-        }
-    }
-    return null;
-}
-/**
- * The newest-first review timeline with each auto-approval placed as an approved
- * row ahead of the first row completed strictly before it (a review completed at
- * the same instant stays newer). A row whose time does not parse places nothing
- * ahead of it; an auto-approval older than every timed row follows the rows, and
- * one whose own time does not parse is dropped (it approves nothing). Pure.
- */
-export function withAutoApprovals(rows, autoApprovals) {
-    const pending = autoApprovals
-        .map((a) => ({ sha: a.sha, at: Date.parse(a.recordedAt) }))
-        .filter((a) => a.sha !== '' && Number.isFinite(a.at))
-        .sort((a, b) => b.at - a.at);
-    const timeline = [];
-    const place = (newerThan) => {
-        for (let next = pending[0]; next !== undefined && next.at > newerThan; next = pending[0]) {
-            pending.shift();
-            timeline.push({ outcome: APPROVED_REVIEW_OUTCOME, reviewedSha: next.sha, completedAt: new Date(next.at).toISOString() });
-        }
-    };
-    for (const row of rows) {
-        const at = row.completedAt ? Date.parse(row.completedAt) : Number.NaN;
-        if (Number.isFinite(at))
-            place(at);
-        timeline.push(row);
-    }
-    place(Number.NEGATIVE_INFINITY);
-    return timeline;
-}
-/**
- * The auto-approvals a history cut off at MAX_REVIEW_PAGES can still judge: those
- * recorded strictly after some review that was read. Such a record is placed ahead
- * of that review, so every unread review follows it and none can revoke it. A record
- * no newer than every review read (or with no timed review read at all) may be
- * revoked by a review that was not read, so it approves nothing and the merge holds.
- * Pure.
- */
-function autoApprovalsWithinHistory(rows, autoApprovals) {
-    const oldestRead = rows.reduce((oldest, row) => {
-        const at = row.completedAt ? Date.parse(row.completedAt) : Number.NaN;
-        return Number.isFinite(at) ? Math.min(oldest, at) : oldest;
-    }, Number.POSITIVE_INFINITY);
-    return autoApprovals.filter((a) => Date.parse(a.recordedAt) > oldestRead);
-}
-/**
- * The commit the focus's newest current approval judged -- an approved
- * focus_reviews row or one of `autoApprovals` -- or null when none. Throws when a
- * page cannot be read or does not parse (the merge gate holds on a throw).
- * Without auto-approvals the read stops at the first page that yields a current
- * approval (revocation reads only newer rows, all already read); with them every
- * page is read, since a record may belong anywhere in the timeline. When the
- * history runs past MAX_REVIEW_PAGES, only an auto-approval provably newer than a
- * review read counts (autoApprovalsWithinHistory).
- */
-export async function readLatestApprovedReviewSha(focusId, deps = {}) {
-    const call = deps.callApi ?? callApi;
-    const autoApprovals = deps.autoApprovals ?? [];
-    const rows = [];
-    let historyComplete = false;
-    for (let page = 0; page < MAX_REVIEW_PAGES; page += 1) {
-        const offset = page * REVIEW_PAGE_SIZE;
-        const raw = await call('focus_review_list', { focusId, limit: REVIEW_PAGE_SIZE, offset });
-        const { reviews, totalCount } = ReviewPageSchema.parse(raw);
-        rows.push(...reviews);
-        if (autoApprovals.length === 0 && approvedReviewShaIn(rows) !== null)
-            break;
-        if (reviews.length < REVIEW_PAGE_SIZE || offset + reviews.length >= totalCount) {
-            historyComplete = true;
-            break;
-        }
-    }
-    const placeable = historyComplete ? autoApprovals : autoApprovalsWithinHistory(rows, autoApprovals);
-    return approvedReviewShaIn(withAutoApprovals(rows, placeable));
-}
-//# sourceMappingURL=focus-review-approval.js.map

package/dist/queries/focus-review-approval.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"focus-review-approval.js","sourceRoot":"","sources":["../../src/queries/focus-review-approval.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,+EAA+E;AAC/E,gEAAgE;AAChE,2FAA2F;AAC3F,mFAAmF;AACnF,4FAA4F;AAC5F,kFAAkF;AAClF,8DAA8D;AAC9D,gBAAgB;AAEhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAoB,MAAM,aAAa,CAAC;AAExD,mEAAmE;AACnE,MAAM,CAAC,MAAM,uBAAuB,GAAG,UAAU,CAAC;AAElD,kEAAkE;AAClE,MAAM,CAAC,MAAM,yBAAyB,GAAG,YAAY,CAAC;AAEtD,+CAA+C;AAC/C,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAEpC;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAEnC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IAC7B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IACjC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;CAClC,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC;IACxC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC;AAUH,wFAAwF;AACxF,MAAM,UAAU,UAAU,CAAC,CAAS,EAAE,CAAS;IAC7C,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1B,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1B,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAiC;IACnE,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,OAAO,KAAK,yBAAyB,EAAE,CAAC;YAC9C,IAAI,CAAC,GAAG,CAAC,WAAW;gBAAE,OAAO,IAAI,CAAC;YAClC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACjC,CAAC;aAAM,IAAI,GAAG,CAAC,OAAO,KAAK,uBAAuB,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;YACtE,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,CAAC;YACjC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;gBAAE,OAAO,QAAQ,CAAC;QAC1E,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAiC,EACjC,aAAiD;IAEjD,MAAM,OAAO,GAAG,aAAa;SAC1B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;SAC1D,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SACpD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAuB,EAAE,CAAC;IACxC,MAAM,KAAK,GAAG,CAAC,SAAiB,EAAQ,EAAE;QACxC,KAAK,IAAI,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,EAAE,GAAG,SAAS,EAAE,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YACzF,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,uBAAuB,EAAE,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC3H,CAAC;IACH,CAAC,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,EAAE,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QACtE,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAE,KAAK,CAAC,EAAE,CAAC,CAAC;QACnC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAChC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,0BAA0B,CACjC,IAAiC,EACjC,aAAiD;IAEjD,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;QAC7C,MAAM,EAAE,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QACtE,OAAO,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC7D,CAAC,EAAE,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAC7B,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC,CAAC;AAC5E,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,OAAe,EACf,OAA6E,EAAE;IAE/E,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC;IACrC,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC;IAC/C,MAAM,IAAI,GAAuB,EAAE,CAAC;IACpC,IAAI,eAAe,GAAG,KAAK,CAAC;IAC5B,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,gBAAgB,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QACtD,MAAM,MAAM,GAAG,IAAI,GAAG,gBAAgB,CAAC;QACvC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAU,mBAAmB,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC,CAAC;QACnG,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;QACtB,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,IAAI,mBAAmB,CAAC,IAAI,CAAC,KAAK,IAAI;YAAE,MAAM;QAC5E,IAAI,OAAO,CAAC,MAAM,GAAG,gBAAgB,IAAI,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;YAC/E,eAAe,GAAG,IAAI,CAAC;YACvB,MAAM;QACR,CAAC;IACH,CAAC;IACD,MAAM,SAAS,GAAG,eAAe,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,0BAA0B,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACpG,OAAO,mBAAmB,CAAC,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;AACjE,CAAC"}

package/dist/queries/focus-review-watermark.d.ts

@@ -1,35 +0,0 @@
-/**
- * The review-coverage watermark write.
- *
- * One function, its own module, for two reasons. It is now a TWO-PART write --
- * the watermark and the range it stands for, which must travel together (Bug
- * TEL-10) -- so it is no longer a one-line field setter among the focus
- * setters. And `queries/focuses.ts` sits at the file-size ceiling, where the
- * repo's answer is a focused module rather than a floor entry.
- *
- * @module queries/focus-review-watermark
- */
-import { type CallApiDeps } from './shared.js';
-/**
- * Stamp the review coverage watermark (product_focuses.reviewed_through_sha)
- * with the branch SHA a COMPLETED review cycle covered. Advances on any routed
- * review outcome (approve / auto-approve / defects filed) -- coverage, not
- * approval. Aborted / killed / cancelled cycles never call this, so an aborted
- * review's successor inherits the full unreviewed range. Does not change focus
- * status or stage.
- *
- * `coveredMergeShas` is the RANGE that watermark stands for: the delivery merge
- * commits git proved it covers, resolved by the caller because this layer does
- * no git (`completion/review-coverage-shas.ts` is the resolver, and explains
- * why the edge cannot ask the question itself). Sent in the SAME call, because
- * the two describe one review pass and a set that outlived its watermark would
- * claim coverage the review did not have. Omitted leaves the stored set
- * untouched -- the edge then falls back to the watermark alone, which holds
- * MORE, never less.
- *
- * `deps` is the product-api seam (queries/shared.ts CallApiDeps): production
- * passes nothing, a test injects a fake client rather than mock.module-ing the
- * ambient one.
- */
-export declare function setReviewedThroughSha(focusId: string, sha: string, coveredMergeShas?: readonly string[], deps?: CallApiDeps): Promise<void>;
-//# sourceMappingURL=focus-review-watermark.d.ts.map

package/dist/queries/focus-review-watermark.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"focus-review-watermark.d.ts","sourceRoot":"","sources":["../../src/queries/focus-review-watermark.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;GAUG;AAEH,OAAO,EAAW,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,EACpC,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/dist/queries/focus-review-watermark.js

@@ -1,47 +0,0 @@
-// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
-// Pinned by: packages/daemon/src/completion/review-coverage-seam.test.ts,
-//   packages/daemon/src/queries/focus-review-watermark.test.ts
-// PINNED-BY-END
-/**
- * The review-coverage watermark write.
- *
- * One function, its own module, for two reasons. It is now a TWO-PART write --
- * the watermark and the range it stands for, which must travel together (Bug
- * TEL-10) -- so it is no longer a one-line field setter among the focus
- * setters. And `queries/focuses.ts` sits at the file-size ceiling, where the
- * repo's answer is a focused module rather than a floor entry.
- *
- * @module queries/focus-review-watermark
- */
-import { callApi } from './shared.js';
-/**
- * Stamp the review coverage watermark (product_focuses.reviewed_through_sha)
- * with the branch SHA a COMPLETED review cycle covered. Advances on any routed
- * review outcome (approve / auto-approve / defects filed) -- coverage, not
- * approval. Aborted / killed / cancelled cycles never call this, so an aborted
- * review's successor inherits the full unreviewed range. Does not change focus
- * status or stage.
- *
- * `coveredMergeShas` is the RANGE that watermark stands for: the delivery merge
- * commits git proved it covers, resolved by the caller because this layer does
- * no git (`completion/review-coverage-shas.ts` is the resolver, and explains
- * why the edge cannot ask the question itself). Sent in the SAME call, because
- * the two describe one review pass and a set that outlived its watermark would
- * claim coverage the review did not have. Omitted leaves the stored set
- * untouched -- the edge then falls back to the watermark alone, which holds
- * MORE, never less.
- *
- * `deps` is the product-api seam (queries/shared.ts CallApiDeps): production
- * passes nothing, a test injects a fake client rather than mock.module-ing the
- * ambient one.
- */
-export async function setReviewedThroughSha(focusId, sha, coveredMergeShas, deps = {}) {
-    await (deps.callApi ?? callApi)('daemon_update_focus_status', {
-        focusId,
-        fields: {
-            reviewedThroughSha: sha,
-            ...(coveredMergeShas === undefined ? {} : { reviewedThroughShas: [...coveredMergeShas] }),
-        },
-    });
-}
-//# sourceMappingURL=focus-review-watermark.js.map

package/dist/queries/focus-review-watermark.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"focus-review-watermark.js","sourceRoot":"","sources":["../../src/queries/focus-review-watermark.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,0EAA0E;AAC1E,+DAA+D;AAC/D,gBAAgB;AAEhB;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAoB,MAAM,aAAa,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAe,EACf,GAAW,EACX,gBAAoC,EACpC,OAAoB,EAAE;IAEtB,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC,4BAA4B,EAAE;QAC5D,OAAO;QACP,MAAM,EAAE;YACN,kBAAkB,EAAE,GAAG;YACvB,GAAG,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,CAAC,GAAG,gBAAgB,CAAC,EAAE,CAAC;SAC1F;KACF,CAAC,CAAC;AACL,CAAC"}

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

@@ -1,146 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}