@telora/daemon 0.24.2 → 0.24.5

package/dist/queries/release-notes/release-notes.js

@@ -0,0 +1,148 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/composition/release-note-pass-context.test.ts,
+//   packages/daemon/src/prompt-sections/release-note-section.test.ts,
+//   packages/daemon/src/queries/release-notes/release-notes.test.ts,
+//   packages/daemon/src/release-notes/release-note-author.test.ts,
+//   packages/daemon/src/release-notes/release-note-faithfulness.test.ts,
+//   packages/daemon/src/release-notes/release-note-pass.test.ts
+// PINNED-BY-END
+/**
+ * The release-note drafting pass's reads and writes (product-api
+ * daemon_get_release_note_candidates / daemon_release_note_claim /
+ * daemon_release_note_write; the edge side is
+ * supabase/functions/product-api/handlers/daemon-release-note-handlers.ts and
+ * the drafting context release-drafting.ts). All three ride the isolated
+ * `releaseNotes` circuit breaker, so a failing drafting pass never opens a
+ * breaker armed work reads or writes through.
+ *
+ * A claim answers the DRAFTING CONTEXT: every piece of work the release
+ * carries, in its own engineering words (the source material, and the internal
+ * names the note must not repeat), the radar blips and themes that informed it,
+ * and the links a user reaches it by in the release's environment.
+ *
+ * Every outcome is written under the claim it was made with. A draft the edge
+ * refuses comes back as an ApiError: HTTP 400 `validation_failed` (the note is
+ * not in the format, or not faithful) or HTTP 409 `state_conflict` (the claim
+ * was lost, or the human changed the release's work while it was drafted).
+ * readReleaseNoteWriteFailure is the one reader of those.
+ *
+ * WHAT THE DAEMON CAN READ OF A REFUSAL. The edge's 400 body carries every
+ * violation in a `violations` array, but the daemon's API transport
+ * (@telora/daemon-core createApiClient -> ApiError) keeps only the body's
+ * `error` text, the HTTP status and the `code`. The refusal's violations are
+ * therefore read from the error TEXT, verbatim, as one entry -- whatever the
+ * edge writes there is what the corrective attempt is shown.
+ */
+import { z } from 'zod';
+import { callApiValidated } from '../api-client/shared.js';
+const nullableString = () => z.string().nullable().optional().default(null);
+const ReleaseNoteCandidateSchema = z.object({
+    releaseId: z.string(),
+    productId: z.string(),
+    name: z.string(),
+    cutAt: z.string(),
+}).passthrough();
+const ReleaseNoteCandidatesSchema = z.object({
+    releases: z.array(ReleaseNoteCandidateSchema),
+}).passthrough();
+const DraftingLinkSchema = z.object({
+    /** Absolute https: the environment's address joined to a QA case path. */
+    url: z.string(),
+    built: z.string().optional().default(''),
+    criterion: z.string().optional().default(''),
+    expected: z.string().optional().default(''),
+}).passthrough();
+const DraftingWorkSchema = z.object({
+    deliveryId: z.string(),
+    title: z.string(),
+    description: nullableString(),
+    acceptanceCriteria: nullableString(),
+    workFacing: nullableString(),
+    focus: z.object({
+        focusId: z.string(),
+        title: z.string(),
+        description: nullableString(),
+    }).passthrough().nullable().optional().default(null),
+    issues: z.array(z.object({ title: z.string(), issueType: nullableString() }).passthrough()).optional().default([]),
+    radar: z.object({
+        blips: z.array(z.object({ title: z.string(), category: z.string(), assessment: z.string() }).passthrough()).optional().default([]),
+        themes: z.array(z.object({ title: z.string(), assessment: z.string() }).passthrough()).optional().default([]),
+    }).passthrough().optional().default({ blips: [], themes: [] }),
+    links: z.array(DraftingLinkSchema).optional().default([]),
+}).passthrough();
+const DraftingContextSchema = z.object({
+    releaseId: z.string(),
+    productId: z.string(),
+    productName: z.string(),
+    releaseName: z.string(),
+    /** The release date, YYYY-MM-DD. */
+    date: z.string(),
+    environment: z.object({ name: z.string(), address: nullableString() }).passthrough(),
+    work: z.array(DraftingWorkSchema),
+    /** Focus, delivery and issue titles: internal names no note may repeat. */
+    internalNames: z.array(z.string()).optional().default([]),
+}).passthrough();
+const ReleaseNoteClaimSchema = z.discriminatedUnion('claimed', [
+    z.object({ claimed: z.literal(false), reason: z.string().optional().default('') }).passthrough(),
+    z.object({ claimed: z.literal(true), claimId: z.string(), context: DraftingContextSchema }).passthrough(),
+]);
+const ReleaseNoteWriteResultSchema = z.object({
+    release: z.unknown().optional(),
+    released: z.boolean().optional(),
+}).passthrough();
+/** The product's releases still drafting and held by no live pass, oldest cut first (bounded by the edge). */
+export async function getReleaseNoteCandidates(productId) {
+    const result = await callApiValidated('daemon_get_release_note_candidates', ReleaseNoteCandidatesSchema, { productId });
+    return result.releases;
+}
+/** Take one release to draft. Not claimed when it stopped drafting or another pass holds it. */
+export async function claimReleaseNote(releaseId) {
+    return callApiValidated('daemon_release_note_claim', ReleaseNoteClaimSchema, { releaseId });
+}
+/** Write the draft or the failure under the claim. Throws on a refusal (readReleaseNoteWriteFailure reads it). */
+export async function writeReleaseNote(write) {
+    await callApiValidated('daemon_release_note_write', ReleaseNoteWriteResultSchema, { ...write });
+}
+/** Give the claim back so the next tick can draft the release again; false when this pass no longer held it. */
+export async function unclaimReleaseNote(releaseId, claimId) {
+    const result = await callApiValidated('daemon_release_note_write', ReleaseNoteWriteResultSchema, {
+        releaseId, claimId, outcome: 'unclaim',
+    });
+    return result.released === true;
+}
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+/** The edge's refusal text: this first line, then one "- <violation>" line per violation. */
+const REFUSAL_PREFIX = 'the note was refused:';
+/**
+ * The violations a refusal names. The edge writes each one into its message,
+ * one per line (the api client keeps the message, not the body), so they are
+ * read back from it; a message in any other shape is kept whole as one
+ * violation.
+ */
+export function refusalViolations(message) {
+    if (!message.startsWith(REFUSAL_PREFIX))
+        return [message];
+    const parts = message
+        .slice(REFUSAL_PREFIX.length)
+        .split('\n')
+        .map((line) => line.trim().replace(/^- /, '').trim())
+        .filter((line) => line.length > 0);
+    return parts.length > 0 ? parts : [message];
+}
+/**
+ * Classify what a release-note write threw, from the edge envelope's HTTP
+ * status and machine code (ApiError.statusCode / wireCode), never its prose.
+ * Total: every input yields a failure. Pure.
+ */
+export function readReleaseNoteWriteFailure(err) {
+    const { statusCode, wireCode } = (err ?? {});
+    const detail = errorMessage(err);
+    if (statusCode === 400 && wireCode === 'validation_failed')
+        return { kind: 'refused', violations: refusalViolations(detail) };
+    if (statusCode === 409)
+        return { kind: 'conflict', detail };
+    return { kind: 'error', detail };
+}
+//# sourceMappingURL=release-notes.js.map

package/dist/queries/release-notes/release-notes.js.map

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

package/dist/release-notes/release-note-author.d.ts

@@ -0,0 +1,56 @@
+import type { DraftingContext, ReleaseNoteDraft } from '../queries/release-notes/release-notes.js';
+/** Each attempt's wall-clock bound. */
+export declare const RELEASE_NOTE_TIMEOUT_MS: number;
+/** The turn cap (the pass has no tools: everything it knows is in its prompt). */
+export declare const RELEASE_NOTE_MAX_TURNS = 3;
+/** One model run, as the author asks for it. */
+export interface ReleaseNoteInvokeOptions {
+    label: string;
+    extraArgs: readonly string[];
+    timeoutMs: number;
+    maxTurns: number;
+}
+/** Run the model once; resolve with its final answer text, or reject (a ModelUnavailable names why). */
+export type ReleaseNoteInvoke = (systemPrompt: string, userMessage: string, opts: ReleaseNoteInvokeOptions) => Promise<{
+    text: string;
+}>;
+export interface ReleaseNoteAuthorDeps {
+    invoke: ReleaseNoteInvoke;
+}
+/** What the corrective attempt is shown: the refused note and why it was refused. */
+export interface ReleaseNoteCorrection {
+    previous: ReleaseNoteDraft;
+    violations: readonly string[];
+}
+export type ReleaseNoteAuthorResult = {
+    kind: 'note';
+    note: ReleaseNoteDraft;
+} | {
+    kind: 'failed';
+    reason: string;
+} | {
+    kind: 'held';
+    reason: string;
+};
+export type ReleaseNoteOutput = {
+    kind: 'note';
+    note: ReleaseNoteDraft;
+} | {
+    kind: 'error';
+    error: string;
+};
+/** The argv the pass adds to the one-shot argv: no tools, no MCP servers. Pure. */
+export declare function buildReleaseNoteArgs(): string[];
+/**
+ * Parse a release-note answer: the last fenced json block, holding a note
+ * object. Only the note's own fields are kept (a title is the release's own,
+ * set by the edge). Pure.
+ */
+export declare function parseReleaseNoteOutput(text: string): ReleaseNoteOutput;
+/**
+ * Author one release's note -- or, given a correction, the whole note again
+ * with the refused note and its violations appended. Never throws for a model
+ * or parse problem (those are results).
+ */
+export declare function authorReleaseNote(context: DraftingContext, deps: ReleaseNoteAuthorDeps, correction?: ReleaseNoteCorrection | null): Promise<ReleaseNoteAuthorResult>;
+//# sourceMappingURL=release-note-author.d.ts.map

package/dist/release-notes/release-note-author.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-note-author.d.ts","sourceRoot":"","sources":["../../src/release-notes/release-note-author.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAOnG,uCAAuC;AACvC,eAAO,MAAM,uBAAuB,QAAc,CAAC;AACnD,kFAAkF;AAClF,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,gDAAgD;AAChD,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wGAAwG;AACxG,MAAM,MAAM,iBAAiB,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,wBAAwB,KAAK,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEzI,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED,qFAAqF;AACrF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,MAAM,uBAAuB,GAC/B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAErC,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5G,mFAAmF;AACnF,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C;AAQD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAmBtE;AAMD;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,qBAAqB,EAC3B,UAAU,GAAE,qBAAqB,GAAG,IAAW,GAC9C,OAAO,CAAC,uBAAuB,CAAC,CAsBlC"}

package/dist/release-notes/release-note-author.js

@@ -0,0 +1,107 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/composition/release-note-pass-context.test.ts,
+//   packages/daemon/src/prompt-sections/release-note-section.test.ts,
+//   packages/daemon/src/release-notes/release-note-author.test.ts,
+//   packages/daemon/src/release-notes/release-note-faithfulness.test.ts,
+//   packages/daemon/src/release-notes/release-note-pass.test.ts
+// PINNED-BY-END
+/**
+ * Author one release's note: a FRESH one-shot model run (no tools, no MCP
+ * servers, a three-turn cap, ten minutes) over the drafting context the claim
+ * answered, read back as the LAST fenced ```json block of the answer.
+ *
+ * The check here is structural only -- a summary, a non-empty list of item
+ * objects -- so an answer that could never be a note is caught before it is
+ * written. The format (src/lib/releases/release-note-format.ts) and the
+ * faithfulness rules (sources name release work, links are ones offered for
+ * that work, no internal names, ids or commits) are the edge's: a draft it
+ * refuses comes back to the pass, which asks ONCE more with the refusal
+ * appended (a `correction`). Items are sent as the model wrote them, so the
+ * edge's refusal names exactly what to fix.
+ *
+ * A provider rate limit is not a failure of the pass: it returns `held`, and
+ * the pass gives the claim back so a later tick drafts the release. Every other
+ * problem is `failed` with its reason. The model run is injected
+ * (ReleaseNoteAuthorDeps.invoke), so no test needs a claude binary.
+ */
+import { isModelUnavailable } from '../backends/claude/one-shot-model.js';
+import { buildReleaseNoteCorrection, buildReleaseNotePrompt, RELEASE_NOTE_SYSTEM_PROMPT, } from '../prompt-sections/release-note-section.js';
+/** Each attempt's wall-clock bound. */
+export const RELEASE_NOTE_TIMEOUT_MS = 10 * 60_000;
+/** The turn cap (the pass has no tools: everything it knows is in its prompt). */
+export const RELEASE_NOTE_MAX_TURNS = 3;
+/** The argv the pass adds to the one-shot argv: no tools, no MCP servers. Pure. */
+export function buildReleaseNoteArgs() {
+    return ['--tools', '', '--strict-mcp-config'];
+}
+const FENCED_JSON = /```json[^\S\n]*\n([\s\S]*?)```/gi;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Parse a release-note answer: the last fenced json block, holding a note
+ * object. Only the note's own fields are kept (a title is the release's own,
+ * set by the edge). Pure.
+ */
+export function parseReleaseNoteOutput(text) {
+    const blocks = [...text.matchAll(FENCED_JSON)].map((m) => m[1] ?? '');
+    const last = blocks.at(-1);
+    if (last === undefined)
+        return { kind: 'error', error: 'the answer has no fenced json block' };
+    let parsed;
+    try {
+        parsed = JSON.parse(last);
+    }
+    catch (err) {
+        return { kind: 'error', error: `the last json block is not valid JSON: ${err.message}` };
+    }
+    if (!isRecord(parsed))
+        return { kind: 'error', error: 'the last json block is not an object' };
+    const { summary, items, knownIssues } = parsed;
+    if (typeof summary !== 'string' || summary.trim() === '')
+        return { kind: 'error', error: 'the note has no summary' };
+    if (!Array.isArray(items) || items.length === 0)
+        return { kind: 'error', error: 'the note lists no items' };
+    const bad = items.findIndex((item) => !isRecord(item));
+    if (bad !== -1)
+        return { kind: 'error', error: `item ${bad + 1} is not an object` };
+    const note = { summary, items: items };
+    if (knownIssues !== undefined && knownIssues !== null)
+        note.knownIssues = knownIssues;
+    return { kind: 'note', note };
+}
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+/**
+ * Author one release's note -- or, given a correction, the whole note again
+ * with the refused note and its violations appended. Never throws for a model
+ * or parse problem (those are results).
+ */
+export async function authorReleaseNote(context, deps, correction = null) {
+    const attempt = correction ? 'corrective attempt' : 'drafting pass';
+    let prompt = buildReleaseNotePrompt(context);
+    if (correction)
+        prompt = `${prompt}\n${buildReleaseNoteCorrection(correction.violations, correction.previous)}`;
+    const label = `release-note:${context.releaseId.slice(0, 8)}${correction ? ':corrective' : ''}`;
+    let text;
+    try {
+        text = (await deps.invoke(RELEASE_NOTE_SYSTEM_PROMPT, prompt, {
+            label,
+            extraArgs: buildReleaseNoteArgs(),
+            timeoutMs: RELEASE_NOTE_TIMEOUT_MS,
+            maxTurns: RELEASE_NOTE_MAX_TURNS,
+        })).text;
+    }
+    catch (err) {
+        if (isModelUnavailable(err) && err.kind === 'rate_limit') {
+            return { kind: 'held', reason: `the ${attempt} hit the provider rate limit: ${err.message}` };
+        }
+        return { kind: 'failed', reason: `the ${attempt} could not run: ${errorMessage(err)}` };
+    }
+    const out = parseReleaseNoteOutput(text);
+    if (out.kind === 'error')
+        return { kind: 'failed', reason: `the ${attempt} answered no usable note: ${out.error}` };
+    return out;
+}
+//# sourceMappingURL=release-note-author.js.map

package/dist/release-notes/release-note-author.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-note-author.js","sourceRoot":"","sources":["../../src/release-notes/release-note-author.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,gFAAgF;AAChF,sEAAsE;AACtE,mEAAmE;AACnE,yEAAyE;AACzE,gEAAgE;AAChE,gBAAgB;AAEhB;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAE1E,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,4CAA4C,CAAC;AAEpD,uCAAuC;AACvC,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,GAAG,MAAM,CAAC;AACnD,kFAAkF;AAClF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AA8BxC,mFAAmF;AACnF,MAAM,UAAU,oBAAoB;IAClC,OAAO,CAAC,SAAS,EAAE,EAAE,EAAE,qBAAqB,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,WAAW,GAAG,kCAAkC,CAAC;AAEvD,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACtE,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC;IAC/F,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,0CAA2C,GAAa,CAAC,OAAO,EAAE,EAAE,CAAC;IACtG,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;IAC/F,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IAC/C,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;IACrH,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;IAC5G,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IACvD,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,GAAG,GAAG,CAAC,mBAAmB,EAAE,CAAC;IACpF,MAAM,IAAI,GAAqB,EAAE,OAAO,EAAE,KAAK,EAAE,KAAuC,EAAE,CAAC;IAC3F,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,IAAI;QAAE,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACtF,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAChC,CAAC;AAED,SAAS,YAAY,CAAC,GAAY;IAChC,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAwB,EACxB,IAA2B,EAC3B,aAA2C,IAAI;IAE/C,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,eAAe,CAAC;IACpE,IAAI,MAAM,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAC7C,IAAI,UAAU;QAAE,MAAM,GAAG,GAAG,MAAM,KAAK,0BAA0B,CAAC,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;IAChH,MAAM,KAAK,GAAG,gBAAgB,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAChG,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,0BAA0B,EAAE,MAAM,EAAE;YAC5D,KAAK;YACL,SAAS,EAAE,oBAAoB,EAAE;YACjC,SAAS,EAAE,uBAAuB;YAClC,QAAQ,EAAE,sBAAsB;SACjC,CAAC,CAAC,CAAC,IAAI,CAAC;IACX,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,kBAAkB,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YACzD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,OAAO,iCAAiC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;QAChG,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,OAAO,mBAAmB,YAAY,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;IAC1F,CAAC;IACD,MAAM,GAAG,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,OAAO,6BAA6B,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC;IACpH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/release-notes/release-note-faithfulness.d.ts

@@ -0,0 +1,40 @@
+import type { DraftingContext, ReleaseNoteDraft } from '../queries/release-notes/release-notes.js';
+import { type ReleaseNoteAuthorDeps } from './release-note-author.js';
+/** The check's wall-clock bound. */
+export declare const RELEASE_NOTE_FAITHFULNESS_TIMEOUT_MS: number;
+/** Its turn cap: it has no tools, so it answers in one. */
+export declare const RELEASE_NOTE_FAITHFULNESS_MAX_TURNS = 2;
+export type ReleaseNoteJudgement = {
+    kind: 'faithful';
+} | {
+    kind: 'unfaithful';
+    violations: string[];
+} | {
+    kind: 'failed';
+    reason: string;
+} | {
+    kind: 'held';
+    reason: string;
+};
+export interface FaithfulnessVerdict {
+    item: number;
+    faithful: boolean;
+    reason: string;
+}
+export type FaithfulnessOutput = {
+    kind: 'verdicts';
+    verdicts: FaithfulnessVerdict[];
+} | {
+    kind: 'error';
+    error: string;
+};
+/**
+ * Read the check's answer: the last fenced json block, holding exactly one
+ * verdict for each of the note's `itemCount` items. Pure.
+ */
+export declare function parseFaithfulnessOutput(text: string, itemCount: number): FaithfulnessOutput;
+/** A not-faithful verdict as a violation the corrective attempt is shown. */
+export declare function faithfulnessViolation(note: ReleaseNoteDraft, verdict: FaithfulnessVerdict): string;
+/** Judge every item's Why against its work's source. Never throws for a model or parse problem. */
+export declare function judgeReleaseNoteWhys(context: DraftingContext, note: ReleaseNoteDraft, deps: ReleaseNoteAuthorDeps): Promise<ReleaseNoteJudgement>;
+//# sourceMappingURL=release-note-faithfulness.d.ts.map

package/dist/release-notes/release-note-faithfulness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-note-faithfulness.d.ts","sourceRoot":"","sources":["../../src/release-notes/release-note-faithfulness.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAKnG,OAAO,EAAwB,KAAK,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAE5F,oCAAoC;AACpC,eAAO,MAAM,oCAAoC,QAAa,CAAC;AAC/D,2DAA2D;AAC3D,eAAO,MAAM,mCAAmC,IAAI,CAAC;AAErD,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAErC,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,kBAAkB,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,mBAAmB,EAAE,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAQ1H;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,kBAAkB,CAwB3F;AAOD,6EAA6E;AAC7E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAIlG;AAMD,mGAAmG;AACnG,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,gBAAgB,EACtB,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,oBAAoB,CAAC,CAqB/B"}

package/dist/release-notes/release-note-faithfulness.js

@@ -0,0 +1,107 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/release-notes/release-note-faithfulness.test.ts,
+//   packages/daemon/src/release-notes/release-note-pass.test.ts
+// PINNED-BY-END
+/**
+ * The drafting pass's MODEL faithfulness check: before a drafted note is
+ * written, a FRESH one-shot model run (no tools, no MCP servers) reads each
+ * item's Why against the source of the work it names -- the requests users
+ * raised, else the problem the work states -- and answers, per item, whether
+ * the Why states it (prompt-sections/release-note-faithfulness-section.ts).
+ *
+ * This is where a Why's MEANING is judged. The edge refuses only a Why that
+ * turns its source around by adding or dropping a negation; whether it states
+ * its source well is this check's and, after it, the human's who edits and
+ * publishes the note (docs/DECISIONS.md, "A release carries done deliveries
+ * once per environment", item 7).
+ *
+ * An item judged unfaithful comes back to the pass as a violation, on the same
+ * footing as an edge refusal: the pass re-asks the author ONCE with it
+ * appended (release-note-pass.ts). A provider rate limit is `held` (the claim
+ * is given back); a run that fails, or an answer that is not one verdict per
+ * item, is `failed` -- a note the check could not judge is not written as if
+ * it had been. The model run is injected, so no test needs a claude binary.
+ */
+import { isModelUnavailable } from '../backends/claude/one-shot-model.js';
+import { buildReleaseNoteFaithfulnessPrompt, RELEASE_NOTE_FAITHFULNESS_SYSTEM_PROMPT, } from '../prompt-sections/release-note-faithfulness-section.js';
+import { buildReleaseNoteArgs } from './release-note-author.js';
+/** The check's wall-clock bound. */
+export const RELEASE_NOTE_FAITHFULNESS_TIMEOUT_MS = 5 * 60_000;
+/** Its turn cap: it has no tools, so it answers in one. */
+export const RELEASE_NOTE_FAITHFULNESS_MAX_TURNS = 2;
+const FENCED_JSON = /```json[^\S\n]*\n([\s\S]*?)```/gi;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Read the check's answer: the last fenced json block, holding exactly one
+ * verdict for each of the note's `itemCount` items. Pure.
+ */
+export function parseFaithfulnessOutput(text, itemCount) {
+    const last = [...text.matchAll(FENCED_JSON)].map((m) => m[1] ?? '').at(-1);
+    if (last === undefined)
+        return { kind: 'error', error: 'the answer has no fenced json block' };
+    let parsed;
+    try {
+        parsed = JSON.parse(last);
+    }
+    catch (err) {
+        return { kind: 'error', error: `the last json block is not valid JSON: ${err.message}` };
+    }
+    if (!isRecord(parsed) || !Array.isArray(parsed.items))
+        return { kind: 'error', error: 'the answer lists no items' };
+    const byItem = new Map();
+    for (const entry of parsed.items) {
+        if (!isRecord(entry) || typeof entry.item !== 'number' || typeof entry.faithful !== 'boolean') {
+            return { kind: 'error', error: 'a verdict is not {item, faithful, reason}' };
+        }
+        byItem.set(entry.item, { item: entry.item, faithful: entry.faithful, reason: typeof entry.reason === 'string' ? entry.reason.trim() : '' });
+    }
+    const verdicts = [];
+    for (let item = 1; item <= itemCount; item++) {
+        const verdict = byItem.get(item);
+        if (!verdict)
+            return { kind: 'error', error: `item ${item} has no verdict` };
+        verdicts.push(verdict);
+    }
+    return { kind: 'verdicts', verdicts };
+}
+function headlineOf(note, index) {
+    const headline = note.items[index]?.headline;
+    return typeof headline === 'string' ? headline.slice(0, 60) : '';
+}
+/** A not-faithful verdict as a violation the corrective attempt is shown. */
+export function faithfulnessViolation(note, verdict) {
+    return `item ${verdict.item} ("${headlineOf(note, verdict.item - 1)}"): its Why does not state its work's source -- ` +
+        `${verdict.reason || 'the check gave no reason'}: say the request users raised (or the problem the work states), ` +
+        'in its sense, in the reader\'s words';
+}
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+/** Judge every item's Why against its work's source. Never throws for a model or parse problem. */
+export async function judgeReleaseNoteWhys(context, note, deps) {
+    let text;
+    try {
+        text = (await deps.invoke(RELEASE_NOTE_FAITHFULNESS_SYSTEM_PROMPT, buildReleaseNoteFaithfulnessPrompt(context, note), {
+            label: `release-note:${context.releaseId.slice(0, 8)}:faithfulness`,
+            extraArgs: buildReleaseNoteArgs(),
+            timeoutMs: RELEASE_NOTE_FAITHFULNESS_TIMEOUT_MS,
+            maxTurns: RELEASE_NOTE_FAITHFULNESS_MAX_TURNS,
+        })).text;
+    }
+    catch (err) {
+        if (isModelUnavailable(err) && err.kind === 'rate_limit') {
+            return { kind: 'held', reason: `the faithfulness check hit the provider rate limit: ${err.message}` };
+        }
+        return { kind: 'failed', reason: `the faithfulness check could not run: ${errorMessage(err)}` };
+    }
+    const out = parseFaithfulnessOutput(text, note.items.length);
+    if (out.kind === 'error')
+        return { kind: 'failed', reason: `the faithfulness check answered no usable verdicts: ${out.error}` };
+    const unfaithful = out.verdicts.filter((v) => !v.faithful);
+    return unfaithful.length === 0
+        ? { kind: 'faithful' }
+        : { kind: 'unfaithful', violations: unfaithful.map((v) => faithfulnessViolation(note, v)) };
+}
+//# sourceMappingURL=release-note-faithfulness.js.map

package/dist/release-notes/release-note-faithfulness.js.map

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

package/dist/release-notes/release-note-pass.d.ts

@@ -0,0 +1,77 @@
+/**
+ * The release-note drafting pass: for every configured product, the releases a
+ * human has cut that are still drafting and held by no live pass get their
+ * note drafted, one release at a time.
+ *
+ * Per candidate: claim it (a release another pass holds, or that stopped
+ * drafting, is skipped) -> author the note from the drafting context the claim
+ * answered (release-note-author.ts) -> JUDGE it: the model faithfulness check
+ * reads each item's Why against its work's source (release-note-faithfulness.ts)
+ * -> write it as the release's draft under the claim. The edge stores a draft
+ * only when it is a note in the one format and keeps its rules. A draft the
+ * check finds unfaithful, or the edge REFUSES, is authored ONCE more with what
+ * was wrong appended, judged and written again; a second rejection is written
+ * as the release's failure with what was said (a human redraft retries). A
+ * check that cannot judge the note records the failure too: a note is never
+ * written as if it had been judged.
+ * A draft written after the human changed the release's work is a conflict:
+ * the claim is given back, so the next tick drafts the release again from the
+ * work it now carries. A claim this pass lost is left alone. A provider rate
+ * limit gives the claim back too: the next tick may take it at once.
+ *
+ * The pass's only writes are those release-note writes (product-api
+ * daemon_release_note_claim / daemon_release_note_write); it never writes a
+ * focus, a delivery or an arm.
+ *
+ * IT NEVER DELAYS ARMED WORK. It acquires no ResourceGovernor slot and never
+ * waits on one: its hold (composition/release-note-pass-context.ts) reads the
+ * governor's utilization and does not start, or go on to the next release,
+ * while every session slot is taken or a spawn is queued for one, while the
+ * claude provider's rate-limit window is open, or while the daemon is
+ * read-only. At most ONE pass runs per daemon: a tick that finds one in flight
+ * returns at once.
+ */
+import type { ResourceGovernor } from '@telora/daemon-core';
+import { type DraftingContext, type ReleaseNoteCandidate, type ReleaseNoteClaim, type ReleaseNoteDraft, type ReleaseNoteWrite } from '../queries/release-notes/release-notes.js';
+import type { ReleaseNoteAuthorResult, ReleaseNoteCorrection } from './release-note-author.js';
+import type { ReleaseNoteJudgement } from './release-note-faithfulness.js';
+/** The loop's cadence. */
+export declare const RELEASE_NOTE_PASS_INTERVAL_MS = 60000;
+export interface ReleaseNotePassDeps {
+    products: ReadonlyArray<{
+        id: string;
+    }>;
+    readCandidates: (productId: string) => Promise<ReleaseNoteCandidate[]>;
+    claim: (releaseId: string) => Promise<ReleaseNoteClaim>;
+    write: (write: ReleaseNoteWrite) => Promise<void>;
+    /** Give the claim back; false when this pass no longer held it. */
+    unclaim: (releaseId: string, claimId: string) => Promise<boolean>;
+    author: (context: DraftingContext, correction: ReleaseNoteCorrection | null) => Promise<ReleaseNoteAuthorResult>;
+    /** The model faithfulness check: does each item's Why state its work's source? */
+    judge: (context: DraftingContext, note: ReleaseNoteDraft) => Promise<ReleaseNoteJudgement>;
+    /** Why the pass must not start or go on to the next release now, or null. */
+    holdReason: () => string | null;
+}
+/** The pass's deps over the running daemon, or null before it has a live config (composition/release-note-pass-context.ts). */
+export type ReleaseNotePassDepsSource = (governor: ResourceGovernor | null) => ReleaseNotePassDeps | null;
+export interface ReleaseNotePassOutcome {
+    /** Why the pass stopped early or did not start, when it did. */
+    skipped: string | null;
+    /** Drafts stored. */
+    drafted: number;
+    /** Releases written draft_failed. */
+    failed: number;
+    /** Claims given back (a provider rate limit, or the release's work changed while drafting). */
+    released: number;
+    /** Claims this pass lost to another (or the release left drafting) before it wrote. */
+    lost: number;
+    /** Candidates another pass held when this one tried to claim them. */
+    notClaimed: number;
+    /** Failed reads, claims and writes. */
+    errors: number;
+}
+/** Run one pass over every product. One product's failed read never stops another's. */
+export declare function runReleaseNotePass(deps: ReleaseNotePassDeps): Promise<ReleaseNotePassOutcome>;
+/** The loop tick: one pass over the live deps, never throwing into the timer. */
+export declare function runReleaseNotePassSafely(source: ReleaseNotePassDepsSource, governor: ResourceGovernor | null): Promise<void>;
+//# sourceMappingURL=release-note-pass.d.ts.map

package/dist/release-notes/release-note-pass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-note-pass.d.ts","sourceRoot":"","sources":["../../src/release-notes/release-note-pass.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EAEtB,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAC/F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAI3E,0BAA0B;AAC1B,eAAO,MAAM,6BAA6B,QAAS,CAAC;AAEpD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,aAAa,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxC,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;IACvE,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACxD,KAAK,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,mEAAmE;IACnE,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE,MAAM,EAAE,CAAC,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,qBAAqB,GAAG,IAAI,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACjH,kFAAkF;IAClF,KAAK,EAAE,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,gBAAgB,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC3F,6EAA6E;IAC7E,UAAU,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,+HAA+H;AAC/H,MAAM,MAAM,yBAAyB,GAAG,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,KAAK,mBAAmB,GAAG,IAAI,CAAC;AAE1G,MAAM,WAAW,sBAAsB;IACrC,gEAAgE;IAChE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,+FAA+F;IAC/F,QAAQ,EAAE,MAAM,CAAC;IACjB,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;CAChB;AA2JD,wFAAwF;AACxF,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA0BnG;AAED,iFAAiF;AACjF,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,yBAAyB,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAclI"}