@telora/daemon 0.24.2 → 0.24.5

package/dist/prompt-sections/release-note-section.js

@@ -0,0 +1,285 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/prompt-sections/release-note-section.test.ts,
+//   packages/daemon/src/release-notes/release-note-author.test.ts
+// PINNED-BY-END
+/**
+ * The release-note prompt: what the pass that drafts a release's note is told,
+ * once a human has cut the release (release-notes/release-note-pass.ts runs it).
+ *
+ * The note is for the product's USERS -- not its operators, not its engineers
+ * -- so the prompt hands over every piece of the release's work in its own
+ * engineering words and asks for the change each makes for a user, in a
+ * user's words. Every internal name the work was tracked under is listed as
+ * one never to repeat, and the work's id is offered for one field only
+ * (`sources`, which no reader sees).
+ *
+ * Where each item's Why comes from is stated per piece of work: the requests
+ * users raised about it (its radar blips and themes, which the list shows),
+ * else the problem the work states (its description, acceptance criteria or
+ * focus's description). The Why says THAT source in the reader's terms and in
+ * its sense. Whether it does is judged by the drafting pass's model check
+ * (release-notes/release-note-faithfulness.ts), which sends an unfaithful Why
+ * back with the one corrective attempt; the edge refuses only a Why that turns
+ * its source around by adding or dropping a negation
+ * (release-why-grounding.ts checkWhyGrounded, which a human's edit is held to
+ * as well). An acceptance criterion is restated as not having held.
+ * How to use it may only be one of the links listed for the item's work -- the
+ * release environment's address joined to a QA case path -- and an item whose
+ * work lists a link MUST use one; No action needed is for an item none of whose
+ * work lists one. A release whose environment has no address offers no links,
+ * and the prompt says so. A listed internal name of two or more words may not
+ * appear anywhere as that phrase (rephrased in the user's words; its words on
+ * their own are fine), and no one-word name may be a headline or a link label.
+ *
+ * The format and the faithfulness rules are the edge's
+ * (src/lib/releases/release-note-format.ts, release-drafting.ts
+ * checkReleaseNoteFaithful): a draft it refuses is re-asked ONCE with
+ * buildReleaseNoteCorrection appended. The output contract (one fenced json
+ * block, last in the answer) is parsed by release-notes/release-note-author.ts;
+ * the answer's shape is shown as RELEASE_NOTE_EXAMPLE, a complete note in the
+ * one format -- the SAME object as
+ * src/lib/releases/__fixtures__/release-note-prompt-example.json, which the
+ * canonical parseReleaseNote is run over (release-note-prompt-example.test.ts).
+ * Pure: the same context gives the same text.
+ */
+import { WORK_FACING } from '@telora/daemon-core';
+/** The system prompt every release-note call runs under. */
+export const RELEASE_NOTE_SYSTEM_PROMPT = 'You write release notes for the USERS of a software product -- the people who use it, not the people who build ' +
+    'or operate it. You say what users can now do, in their words. You never edit files and never run a command. You ' +
+    'end every answer with exactly one fenced json block.';
+/** The heading the prompt opens with -- the anchor tests and logs name it by. */
+export const RELEASE_NOTE_HEADING = '# WRITE THE RELEASE NOTE FOR THIS RELEASE';
+/** The heading a corrective attempt's addition opens with. */
+export const RELEASE_NOTE_CORRECTION_HEADING = '## YOUR PREVIOUS NOTE WAS REFUSED';
+/** The audience line: who the note is for, said once, plainly. */
+export const RELEASE_NOTE_AUDIENCE_LINE = 'The AUDIENCE is the product\'s USERS -- the people who use it. Not its operators, not its engineers, not the team ' +
+    'that built it.';
+/** What a piece of work with no radar link writes its Why from. */
+export const STATED_PROBLEM_WHY_LINE = 'No radar link: write the Why FROM the problem the work states -- its description, its acceptance criteria, or ' +
+    'its focus\'s description -- in the reader\'s terms. Only when none of those is written, say what its title is ' +
+    'for, never the title itself. Keep its SENSE: never say the opposite (a problem that happens is not "no longer" ' +
+    'happening); an acceptance criterion says what must HOLD, so write that it did not hold, or that users needed it.';
+/** What a piece of work with radar links writes its Why from. */
+export const RADAR_WHY_LINE = 'Users raised this -- write the Why FROM it: say one of the requests below in the reader\'s terms, not the ' +
+    'engineering description. Keep its SENSE: where it says users cannot / do not / have no ..., the Why says so too ' +
+    '("could not", "had no way to"); where it says something happens or users can do something, the Why never ' +
+    'negates it ("no longer", "can ... already") -- or say it as what users asked for ("Creators asked to ..."). ' +
+    '(A request whose title says little: say its assessment.)';
+/** The rule every Why is held to: it states its work's source, in the sense it was written. */
+export const WHY_FROM_SOURCE_RULE = '- `why`: the problem or request it addresses, from the user\'s side, written FROM its work\'s source: a request ' +
+    'the work lists (its radar blips or themes -- what users raised) or, where it lists none, the problem the work ' +
+    'states. Say THAT request or problem -- not a couple of its words, not a different problem, not the change itself: ' +
+    'a check reads every Why against its source and sends back one that does not state it. Keep it in the SENSE it ' +
+    'was written: a Why that says the OPPOSITE -- adding or dropping a not / no / never / cannot -- is refused (users ' +
+    'who cannot reconcile payouts are not users who can). Put the not with the words it negates, in the same clause ' +
+    '("could not reconcile payouts"), and never say them elsewhere without it ("cannot reconcile invoices, but can ' +
+    'reconcile payouts" is refused); or say it as what users asked for. An acceptance criterion says what must hold, ' +
+    'so its Why says it did not hold.';
+/** The rule every How to use it is held to: a listed link whenever the work lists one. */
+export const LINK_REQUIRED_RULE = '- `howToUse`: ONLY one of the links listed for that item\'s work -- choose the one that opens the change -- as ' +
+    '`{"label": "<what it opens, in a user\'s words>", "url": "<the url exactly as listed>"}`. When ANY of the item\'s ' +
+    'work lists a link, the item MUST use one of them; `{"noActionNeeded": true}` is ONLY for an item none of whose ' +
+    'work lists a link. Never write a url that is not listed.';
+/** The rule a listed internal name is held to: a phrase nowhere, a single word never as a whole text. */
+export const INTERNAL_NAME_PHRASE_RULE = 'A listed name of TWO or more words may not appear ANYWHERE in the note as that phrase -- not in a headline, a ' +
+    'sentence or a link label, whatever its case or punctuation: rephrase it in the user\'s words (its words on their ' +
+    'own are fine -- for "PDF totals", write "the totals on your PDF"). A ONE-word name is never a headline, a link ' +
+    'label or the whole of any text: write what a user can do instead.';
+/**
+ * The answer's shape, shown as a complete note in the one release-note format
+ * for ANOTHER product. Pinned: it deep-equals
+ * src/lib/releases/__fixtures__/release-note-prompt-example.json, which the
+ * canonical parseReleaseNote accepts.
+ */
+export const RELEASE_NOTE_EXAMPLE = {
+    title: { product: 'Ledgerly', release: '3.2', date: '2026-01-15' },
+    summary: 'You can now download your invoices as a spreadsheet. Searching by email finds the right customer again.',
+    items: [
+        {
+            section: 'new',
+            headline: 'Download your invoices as a spreadsheet',
+            whatChanged: 'The Invoices page has a Download button that saves the invoices you see as a CSV file.',
+            why: 'Bookkeepers asked to bring invoices into their own accounting tools without copying them by hand.',
+            howToUse: { label: 'Open Invoices', url: 'https://app.ledgerly.example/invoices' },
+            sources: ['<work id>'],
+        },
+        {
+            section: 'fixed',
+            headline: 'Search finds customers by email again',
+            whatChanged: 'Typing a customer\'s email address into search shows that customer.',
+            why: 'Searching by email showed no results, so people scrolled the whole customer list.',
+            howToUse: { noActionNeeded: true },
+            sources: ['<work id>'],
+        },
+    ],
+    knownIssues: [],
+};
+/** What the prompt says when the release environment has no address. */
+export const NO_ADDRESS_LINE = 'This release\'s environment has NO address, so NO links may be used: every item\'s `howToUse` is ' +
+    '`{"noActionNeeded": true}`.';
+function fenced(text, none) {
+    const t = (text ?? '').trim();
+    return t ? ['```text', t, '```'] : [none];
+}
+function audienceLines(context) {
+    return [
+        RELEASE_NOTE_HEADING,
+        `${context.productName} ${context.releaseName} was released on ${context.date}. Write its release note.`,
+        '',
+        '## Who reads it',
+        RELEASE_NOTE_AUDIENCE_LINE,
+        'Write what each change lets a user DO, in the words a user would use. A user has never seen how the work was ' +
+            'tracked: they never see a focus, a delivery, an issue, a ticket, an id, a commit or a branch.',
+    ];
+}
+function internalNameLines(context) {
+    const lines = [
+        '## Never repeat these internal names',
+        'The work below was tracked under these names. They are INTERNAL: never write any of them, or a close variant, ' +
+            'anywhere in the note. Say what changed for a user instead.',
+    ];
+    const names = context.internalNames.map((n) => n.trim()).filter((n) => n.length > 0);
+    lines.push(...(names.length > 0 ? names.map((n) => `- ${JSON.stringify(n)}`) : ['(none recorded)']));
+    lines.push(INTERNAL_NAME_PHRASE_RULE, 'Never write the name or number of a focus, delivery, issue or ticket, a UUID or other id, a commit sha or a branch name.');
+    return lines;
+}
+function environmentLines(context) {
+    const address = context.environment.address?.trim();
+    return [
+        '## Where users reach the changes',
+        `- Environment: ${context.environment.name.trim() || '(unnamed)'}`,
+        address ? `- Address: ${address}` : '- Address: (none)',
+        address
+            ? 'Each piece of work below lists the links offered for it in this environment (or says it offers none).'
+            : NO_ADDRESS_LINE,
+    ];
+}
+function facingLine(work) {
+    if (work.workFacing === WORK_FACING.OUTWARD)
+        return '- Facing: outward (a change users meet)';
+    if (work.workFacing === WORK_FACING.INWARD)
+        return '- Facing: inward (internal work; users may notice nothing, or only that something got better)';
+    return '- Facing: not recorded';
+}
+function issueLines(work) {
+    if (work.issues.length === 0)
+        return [];
+    return [
+        'Its tasks and bugs (internal names -- never repeat them):',
+        ...work.issues.map((i) => `- [${i.issueType?.trim() || 'Issue'}] ${i.title}`),
+    ];
+}
+function whyLines(work) {
+    const { blips, themes } = work.radar;
+    if (blips.length === 0 && themes.length === 0)
+        return ['Why:', STATED_PROBLEM_WHY_LINE];
+    return [
+        'Why:',
+        RADAR_WHY_LINE,
+        ...blips.map((b) => `- Blip "${b.title}" (${b.category}): ${b.assessment.trim() || '(no assessment)'}`),
+        ...themes.map((t) => `- Theme "${t.title}": ${t.assessment.trim() || '(no assessment)'}`),
+    ];
+}
+function linkLines(work, hasAddress) {
+    if (work.links.length === 0) {
+        return [
+            'How to use it:',
+            hasAddress
+                ? 'No link is offered for this work: an item describing only this work has `{"noActionNeeded": true}`.'
+                : 'No link (the environment has no address): `{"noActionNeeded": true}`.',
+        ];
+    }
+    return [
+        'How to use it -- the links offered for this work. An item describing this work MUST use one of them, EXACTLY as written:',
+        ...work.links.map((l) => `- ${l.url} -- built there: ${l.built || '(not said)'}; a user sees: ${l.expected || '(not said)'}`),
+    ];
+}
+function workLines(work, hasAddress) {
+    const lines = [
+        `### Work \`${work.deliveryId}\``,
+        `- Title (internal -- never repeat it): ${work.title}`,
+        facingLine(work),
+    ];
+    if (work.focus) {
+        lines.push(`- Part of (internal -- never repeat it): ${work.focus.title}`);
+        lines.push('Its focus\'s description:', ...fenced(work.focus.description, '(none)'));
+    }
+    lines.push('Description:', ...fenced(work.description, '(none)'), 'Acceptance criteria:', ...fenced(work.acceptanceCriteria, '(none)'), ...issueLines(work), ...whyLines(work), ...linkLines(work, hasAddress));
+    return lines;
+}
+function allWorkLines(context) {
+    const hasAddress = Boolean(context.environment.address?.trim());
+    const lines = [
+        '## The work in this release',
+        'Each piece of work is described below in ENGINEERING terms, the way the team that built it wrote it. Its id ' +
+            '(after "Work") is for the `sources` field ONLY -- never write it in the text.',
+    ];
+    for (const work of context.work)
+        lines.push('', ...workLines(work, hasAddress));
+    return lines;
+}
+const RULE_LINES = [
+    '## The rules',
+    '- Group the work into items by what a user experiences. One item may describe several pieces of work: list EVERY ' +
+        'one it describes in its `sources` (their ids, exactly as shown after "Work"). Work that changes nothing a user can ' +
+        'see or feel may be left out.',
+    '- `section`: "new" = something users could not do before; "improved" = something users could already do that is ' +
+        'now better; "fixed" = something that was broken and now works. Hints: a [Bug] suggests "fixed"; outward work is ' +
+        'a change users meet; inward work is often left out, or "improved" when users feel it (faster, more reliable).',
+    '- `headline`: what a user can now do, in the user\'s words. ONE line, at most 160 characters.',
+    '- `whatChanged`: 1-2 sentences on what is different for a user.',
+    WHY_FROM_SOURCE_RULE,
+    LINK_REQUIRED_RULE,
+    '- `summary`: 2-3 sentences on what this release means for its users.',
+    '- `knownIssues` (optional): limitations a user should know about, in their words; leave it empty when there are none.',
+    '- Write no internal name, id, commit or branch anywhere a user reads: a listed name of two or more words never ' +
+        'appears as that phrase, and no one-word name is a headline or a link label.',
+    '- Do not ask questions. Do not edit files. Do not run any command.',
+];
+function outputLines(context) {
+    const title = { product: context.productName, release: context.releaseName, date: context.date };
+    return [
+        '## Your answer',
+        'End your answer with exactly ONE fenced json block and nothing after it, in exactly the shape of this EXAMPLE -- a ' +
+            'complete note for ANOTHER product. Copy its shape and its plain voice, never its words, links or ids:',
+        '```json',
+        JSON.stringify(RELEASE_NOTE_EXAMPLE, null, 2),
+        '```',
+        `The title is the release's own -- copy it exactly: ${JSON.stringify(title)}`,
+        'Each item\'s `sources` lists the ids shown after "Work" for every piece of work it describes -- never "<work id>". ' +
+            'An item with nothing to open has `"howToUse": {"noActionNeeded": true}`. `knownIssues` is a list of short texts ' +
+            'a user should know about; leave it empty when there are none.',
+    ];
+}
+/**
+ * The release-note prompt for one claimed release. Pure: the same context
+ * gives the same text.
+ */
+export function buildReleaseNotePrompt(context) {
+    const sections = [
+        audienceLines(context),
+        internalNameLines(context),
+        environmentLines(context),
+        allWorkLines(context),
+        [...RULE_LINES],
+        outputLines(context),
+    ];
+    return sections.map((s) => s.join('\n')).join('\n\n') + '\n';
+}
+/**
+ * What a corrective attempt appends to the prompt: the refused note, the
+ * reasons it was refused, one per line, and the instruction to write the whole
+ * note again. Pure.
+ */
+export function buildReleaseNoteCorrection(violations, previous = null) {
+    const lines = [RELEASE_NOTE_CORRECTION_HEADING, 'You answered this once already.'];
+    if (previous)
+        lines.push('Your note was:', '```json', JSON.stringify(previous, null, 2), '```');
+    lines.push('It was refused for these reasons:', ...violations.map((v) => `- ${v}`), '', 'Write the WHOLE note again, fixing every one of them and following every rule above: no internal name, id or ' +
+        'commit anywhere a user reads, every item\'s `sources` naming the work it describes, every `why` stating its ' +
+        'work\'s source (a request users raised, or the problem the work states) in the sense it was written, never ' +
+        'its opposite, and every `howToUse` a link listed for that work ' +
+        '-- `{"noActionNeeded": true}` only when its work lists none. End with exactly one fenced json block.');
+    return lines.join('\n') + '\n';
+}
+//# sourceMappingURL=release-note-section.js.map

package/dist/prompt-sections/release-note-section.js.map

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

package/dist/queries/api-client/shared.d.ts

@@ -25,6 +25,7 @@ declare const circuitBreakers: {
     readonly drift: CircuitBreaker;
     readonly tower: CircuitBreaker;
     readonly qa: CircuitBreaker;
+    readonly releaseNotes: CircuitBreaker;
 };
 type CircuitBreakerConcern = keyof typeof circuitBreakers;
 /**

package/dist/queries/api-client/shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/queries/api-client/shared.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAkC,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAuCrG,QAAA,MAAM,eAAe;;;;;;;;;CA8DX,CAAC;AAEX,KAAK,qBAAqB,GAAG,MAAM,OAAO,eAAe,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,GAAG,eAAe,GAAG,eAAe,CAAC;AAE7D,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,qBAAqB,EAAE,YAAY,CASrE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAIpD,CAAC;AAwFH;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAEzE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAErF;AA2BD;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,eAAe,CAE9D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAIvD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAE3D;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,YAAY,CAKxC;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEzD;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAC7B,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,OAAO,CAAC,CAAC,CAAC,CAEZ;AAED,wFAAwF;AACxF,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC;AAErC;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,OAAO,CAAC,CAAC,CAAC,CAEZ;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,OAAO,CAAC,CAAC,CAAC,CAEZ"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/queries/api-client/shared.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAkC,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAuCrG,QAAA,MAAM,eAAe;;;;;;;;;;CAwEX,CAAC;AAEX,KAAK,qBAAqB,GAAG,MAAM,OAAO,eAAe,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,GAAG,eAAe,GAAG,eAAe,CAAC;AAE7D,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,qBAAqB,EAAE,YAAY,CAUrE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAIpD,CAAC;AA4FH;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAEzE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAErF;AA2BD;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,eAAe,CAE9D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAIvD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAE3D;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,YAAY,CAKxC;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEzD;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAC7B,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,OAAO,CAAC,CAAC,CAAC,CAEZ;AAED,wFAAwF;AACxF,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC;AAErC;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,OAAO,CAAC,CAAC,CAAC,CAEZ;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,OAAO,CAAC,CAAC,CAAC,CAEZ"}

package/dist/queries/api-client/shared.js

@@ -1,5 +1,5 @@
 // PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
-// Pinned by: 97 tests -- run: npm run gen:pinned-by -- --list packages/daemon/src/queries/api-client/shared.ts
+// Pinned by: 98 tests -- run: npm run gen:pinned-by -- --list packages/daemon/src/queries/api-client/shared.ts
 // PINNED-BY-END
 import { CircuitBreaker, createApiClient, loadEnvConfig } from '@telora/daemon-core';
 // ---------------------------------------------------------------------------
@@ -99,6 +99,16 @@ const circuitBreakers = {
         maxCooldownMs: 300000,
         label: 'qa',
     }),
+    // releaseNotes: the release-note drafting pass's candidate read, claim and
+    // writes (release-notes/). Isolated for the same reason as 'qa': the pass is
+    // background work, and its failures (a refused draft included) must never
+    // open the 'polling' or 'delivery' breaker armed work runs through.
+    releaseNotes: new CircuitBreaker({
+        failureThreshold: 5,
+        cooldownMs: 60000,
+        maxCooldownMs: 300000,
+        label: 'releaseNotes',
+    }),
 };
 export const CONCERN_CLASS = {
     heartbeat: 'control-plane',
@@ -109,6 +119,7 @@ export const CONCERN_CLASS = {
     drift: 'control-plane',
     tower: 'control-plane',
     qa: 'control-plane',
+    releaseNotes: 'control-plane',
 };
 /**
  * Actions that are observability/telemetry writes. They MUST resolve to an
@@ -138,6 +149,10 @@ const actionToConcern = {
     // The QA-author pass (isolated breaker; see `qa` above).
     daemon_get_qa_packet_candidates: 'qa',
     daemon_qa_packet_write: 'qa',
+    // The release-note drafting pass (isolated breaker; see `releaseNotes` above).
+    daemon_get_release_note_candidates: 'releaseNotes',
+    daemon_release_note_claim: 'releaseNotes',
+    daemon_release_note_write: 'releaseNotes',
     agent_role_list: 'polling',
     daemon_get_done_deliveries: 'polling',
     daemon_get_merge_conflict_deliveries: 'polling',

package/dist/queries/api-client/shared.js.map

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

package/dist/queries/release-notes/release-notes.d.ts

@@ -0,0 +1,242 @@
+/**
+ * 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';
+declare const ReleaseNoteCandidateSchema: z.ZodObject<{
+    releaseId: z.ZodString;
+    productId: z.ZodString;
+    name: z.ZodString;
+    cutAt: z.ZodString;
+}, z.core.$loose>;
+/** A release still drafting that no live pass holds. */
+export type ReleaseNoteCandidate = z.infer<typeof ReleaseNoteCandidateSchema>;
+declare const DraftingWorkSchema: z.ZodObject<{
+    deliveryId: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    acceptanceCriteria: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    workFacing: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    focus: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        focusId: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    }, z.core.$loose>>>>;
+    issues: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        issueType: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    }, z.core.$loose>>>>;
+    radar: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        blips: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            category: z.ZodString;
+            assessment: z.ZodString;
+        }, z.core.$loose>>>>;
+        themes: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            assessment: z.ZodString;
+        }, z.core.$loose>>>>;
+    }, z.core.$loose>>>;
+    links: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        built: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        criterion: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        expected: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    }, z.core.$loose>>>>;
+}, z.core.$loose>;
+/** One piece of work a release carries, as the note is drafted from it. */
+export type DraftingWork = z.infer<typeof DraftingWorkSchema>;
+declare const DraftingContextSchema: z.ZodObject<{
+    releaseId: z.ZodString;
+    productId: z.ZodString;
+    productName: z.ZodString;
+    releaseName: z.ZodString;
+    date: z.ZodString;
+    environment: z.ZodObject<{
+        name: z.ZodString;
+        address: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    }, z.core.$loose>;
+    work: z.ZodArray<z.ZodObject<{
+        deliveryId: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        acceptanceCriteria: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        workFacing: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        focus: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            focusId: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        }, z.core.$loose>>>>;
+        issues: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            issueType: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        }, z.core.$loose>>>>;
+        radar: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            blips: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+                title: z.ZodString;
+                category: z.ZodString;
+                assessment: z.ZodString;
+            }, z.core.$loose>>>>;
+            themes: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+                title: z.ZodString;
+                assessment: z.ZodString;
+            }, z.core.$loose>>>>;
+        }, z.core.$loose>>>;
+        links: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            built: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            criterion: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            expected: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, z.core.$loose>>>>;
+    }, z.core.$loose>>;
+    internalNames: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+}, z.core.$loose>;
+/** Everything a release's note is drafted from. */
+export type DraftingContext = z.infer<typeof DraftingContextSchema>;
+declare const ReleaseNoteClaimSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    claimed: z.ZodLiteral<false>;
+    reason: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, z.core.$loose>, z.ZodObject<{
+    claimed: z.ZodLiteral<true>;
+    claimId: z.ZodString;
+    context: z.ZodObject<{
+        releaseId: z.ZodString;
+        productId: z.ZodString;
+        productName: z.ZodString;
+        releaseName: z.ZodString;
+        date: z.ZodString;
+        environment: z.ZodObject<{
+            name: z.ZodString;
+            address: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        }, z.core.$loose>;
+        work: z.ZodArray<z.ZodObject<{
+            deliveryId: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+            acceptanceCriteria: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+            workFacing: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+            focus: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                focusId: z.ZodString;
+                title: z.ZodString;
+                description: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+            }, z.core.$loose>>>>;
+            issues: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+                title: z.ZodString;
+                issueType: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+            }, z.core.$loose>>>>;
+            radar: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+                blips: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    title: z.ZodString;
+                    category: z.ZodString;
+                    assessment: z.ZodString;
+                }, z.core.$loose>>>>;
+                themes: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    title: z.ZodString;
+                    assessment: z.ZodString;
+                }, z.core.$loose>>>>;
+            }, z.core.$loose>>>;
+            links: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+                url: z.ZodString;
+                built: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                criterion: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                expected: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            }, z.core.$loose>>>>;
+        }, z.core.$loose>>;
+        internalNames: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    }, z.core.$loose>;
+}, z.core.$loose>], "claimed">;
+/** A claim's answer: the release is this pass's to draft (with what to draft it from), or it is not. */
+export type ReleaseNoteClaim = z.infer<typeof ReleaseNoteClaimSchema>;
+/** How to use it: a link offered for the item's work, or nothing to open. */
+export type ReleaseNoteHowToUse = {
+    label: string;
+    url: string;
+} | {
+    noActionNeeded: true;
+};
+/**
+ * A drafted note as the pass sends it. Items are kept as the model wrote them:
+ * the format (src/lib/releases/release-note-format.ts) and the faithfulness
+ * check are the edge's, and a refusal names what to fix.
+ */
+export interface ReleaseNoteDraft {
+    summary: string;
+    items: Array<Record<string, unknown>>;
+    knownIssues?: unknown;
+}
+/** One write under a claim: the draft, or the failure a human redraft retries. */
+export type ReleaseNoteWrite = {
+    releaseId: string;
+    claimId: string;
+    outcome: 'draft';
+    note: ReleaseNoteDraft;
+    draftedFromDeliveryIds: string[];
+} | {
+    releaseId: string;
+    claimId: string;
+    outcome: 'failed';
+    failureReason: string;
+};
+/** The product's releases still drafting and held by no live pass, oldest cut first (bounded by the edge). */
+export declare function getReleaseNoteCandidates(productId: string): Promise<ReleaseNoteCandidate[]>;
+/** Take one release to draft. Not claimed when it stopped drafting or another pass holds it. */
+export declare function claimReleaseNote(releaseId: string): Promise<ReleaseNoteClaim>;
+/** Write the draft or the failure under the claim. Throws on a refusal (readReleaseNoteWriteFailure reads it). */
+export declare function writeReleaseNote(write: ReleaseNoteWrite): Promise<void>;
+/** Give the claim back so the next tick can draft the release again; false when this pass no longer held it. */
+export declare function unclaimReleaseNote(releaseId: string, claimId: string): Promise<boolean>;
+/** Why a release-note write did not land. */
+export type ReleaseNoteWriteFailure = 
+/** The edge refused the note (format or faithfulness): what it said, for the corrective attempt. */
+{
+    kind: 'refused';
+    violations: string[];
+}
+/** The claim was lost, or the release's work changed while the note was drafted. */
+ | {
+    kind: 'conflict';
+    detail: string;
+}
+/** Anything else: transport, breaker, a server error. */
+ | {
+    kind: 'error';
+    detail: string;
+};
+/**
+ * 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 declare function refusalViolations(message: string): string[];
+/**
+ * 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 declare function readReleaseNoteWriteFailure(err: unknown): ReleaseNoteWriteFailure;
+export {};
+//# sourceMappingURL=release-notes.d.ts.map

package/dist/queries/release-notes/release-notes.d.ts.map

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