@telora/daemon 0.23.29 → 0.23.32

package/dist/prompt-sections/qa-author-section.js

@@ -0,0 +1,189 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/prompt-sections/qa-author-section.test.ts,
+//   packages/daemon/src/qa/qa-author-unfaithful-answer.test.ts
+// PINNED-BY-END
+import { QA_AUTHOR_MODE } from '../types/qa-packet.js';
+/** The system prompt every QA-author call runs under (a resumed session may keep its recorded one). */
+export const QA_AUTHOR_SYSTEM_PROMPT = 'You write UI test packets: click-level test cases a person runs by hand in a web browser against a ' +
+    'QA environment. You never edit files and never run a command that changes anything. 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 QA_AUTHOR_HEADING = '# WRITE THE UI TEST PACKET FOR THIS FOCUS';
+function verbatim(text, none) {
+    const t = (text ?? '').trim();
+    return t ? ['```text', t, '```'] : [none];
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** The armed baseline criteria, each quoted as the arm stamped it. */
+function armedBaselineLines(criteria) {
+    if (criteria === null || criteria === undefined)
+        return ['(the arm stamped no criteria)'];
+    if (!Array.isArray(criteria))
+        return ['```json', JSON.stringify(criteria, null, 2), '```'];
+    const lines = [];
+    for (const entry of criteria) {
+        if (isRecord(entry) && typeof entry.criterion === 'string' && entry.criterion.trim()) {
+            lines.push(...verbatim(entry.criterion, ''));
+            if (entry.drafted === true)
+                lines.push('(machine-drafted, accepted at the arm)');
+        }
+        else {
+            lines.push('```json', JSON.stringify(entry), '```');
+        }
+    }
+    return lines.length > 0 ? lines : ['(the arm stamped no criteria)'];
+}
+function targetLines(candidate, reviewedSha) {
+    const { environment, baseUrl, accessNote } = candidate.qaTarget;
+    return [
+        '## The QA target',
+        `- Environment: ${environment?.trim() || '(not set)'}`,
+        baseUrl?.trim()
+            ? `- Base URL: ${baseUrl.trim()}`
+            : '- Base URL: (not set) -- write every path relative anyway; the human resolves it against the environment they test in.',
+        `- Access: ${accessNote?.trim() || '(no access note)'}`,
+        `- The packet describes commit \`${reviewedSha}\`.`,
+        '',
+        'Every case\'s `path` is RELATIVE to the base URL (for example `/settings?tab=billing`). Never write a scheme, a host, or `..`.',
+    ];
+}
+function criteriaLines(candidate) {
+    const lines = [
+        '## The acceptance criteria -- quote them VERBATIM',
+        'Each case names ONE of the criteria below in its `criterion` field, copied EXACTLY: one whole line of a criteria ' +
+            'block (without its leading bullet or number) or one whole block. A paraphrase, a summary, a fragment or two ' +
+            'criteria merged into one is REFUSED. Only the focus\'s acceptance criteria, the armed baseline criteria and each ' +
+            'delivery\'s "Acceptance criteria" count -- a description is not a criterion.',
+        '',
+        `### Focus "${candidate.focusName}"`,
+        ...verbatim(candidate.focusAcceptanceCriteria, '(the focus declares no acceptance criteria)'),
+        '',
+        '### Armed baseline criteria (what the human held this focus to when they armed it)',
+        ...armedBaselineLines(candidate.armedBaselineCriteria),
+    ];
+    for (const d of candidate.deliveries) {
+        lines.push('', `### Delivery "${d.name}" (${d.executionStatus ?? 'status unknown'})`);
+        if (d.description?.trim())
+            lines.push(...verbatim(d.description, ''));
+        lines.push('Acceptance criteria:', ...verbatim(d.acceptanceCriteria, '(none declared)'));
+    }
+    return lines;
+}
+function retestLines(candidate) {
+    const failed = candidate.previousPacket?.failedCases ?? [];
+    if (failed.length === 0)
+        return [];
+    const lines = [
+        '## Re-test: the previous QA cycle FAILED',
+        'A human failed these cases when they ran the previous packet. For each one whose criterion is still among the ' +
+            'criteria above, a case with `"retest": true` and `"retestOf": "<its id>"` that quotes THAT SAME criterion is ' +
+            'REQUIRED -- the packet is refused without it, and a retest quoting another criterion does not count. Drop one ' +
+            'only when its criterion is no longer listed above. While any of them still applies, the no-UI-surface marker is ' +
+            'refused too.',
+    ];
+    for (const c of failed) {
+        lines.push(`- \`${c.id}\` -- criterion: ${JSON.stringify(c.criterion)}; path \`${c.path}\`; ` +
+            `steps: ${JSON.stringify(c.steps)}; expected: ${JSON.stringify(c.expected)}`);
+    }
+    return lines;
+}
+function knowledgeLines(candidate, mode, fresh) {
+    if (mode === QA_AUTHOR_MODE.RESUMED) {
+        return [
+            '## What you know',
+            'You built this focus: this conversation is the coding session that built it, and the review has passed. ' +
+                'Describe what you built in your own words. You may read files in the working directory (Read, Grep, Glob) ' +
+                'to confirm a route, a label or a button name. Change nothing.',
+        ];
+    }
+    const lines = [
+        '## What was built',
+        'You did not build this focus. Work from its deliveries above, the review summary, its commits and its diff below.',
+        '',
+        '### Review summary',
+        ...verbatim(candidate.latestReviewSummary, '(no review summary was recorded)'),
+        '',
+        '### Commits',
+        ...verbatim(fresh?.commitLog, '(no commits could be listed)'),
+        '',
+        '### Diff',
+    ];
+    if (fresh?.note)
+        lines.push(`(${fresh.note})`);
+    lines.push(...(fresh?.diff.trim() ? ['```diff', fresh.diff, '```'] : ['(no diff could be read)']));
+    if (fresh?.truncated)
+        lines.push('(The diff was cut at its size cap; the rest of the change is not shown.)');
+    return lines;
+}
+const RULE_LINES = [
+    '## The rules',
+    '- Write ONLY UI-facing cases: something a person opens, clicks or types into in the browser and sees the result of. ' +
+        'No API calls, CLI commands, database queries, log reading or code inspection.',
+    '- One case per behavior a person can observe, tied to ONE criterion. A criterion nothing in the UI can show gets no case.',
+    '- `id`: short and unique within the packet (c1, c2, ...).',
+    '- `criterion`: that criterion, copied exactly from the list above -- one line without its bullet, or one whole block.',
+    '- `built`: what was built for it, in a sentence or two.',
+    '- `path`: where to start, relative to the base URL.',
+    '- `steps`: click-level actions in order, one action each ("Click **Save**").',
+    '- `expected`: what the person should see when the criterion is met.',
+    '- If nothing in this focus changes anything a person can click or see, answer with the no-UI-surface marker instead of cases.',
+    '- Do not ask questions. Do not edit files. Do not run git or any command that writes.',
+];
+const OUTPUT_LINES = [
+    '## Your answer',
+    'End your answer with exactly ONE fenced json block and nothing after it. Either the cases:',
+    '```json',
+    '{"cases": [{"id": "c1", "criterion": "<verbatim criterion>", "built": "<what was built>", "path": "/relative/path", ' +
+        '"steps": ["<step 1>", "<step 2>"], "expected": "<what the person sees>"}]}',
+    '```',
+    'or, when nothing in the focus has a UI surface:',
+    '```json',
+    '{"noUiSurface": true}',
+    '```',
+    'Add `"retest": true, "retestOf": "<previous case id>"` only to a case that re-tests a previously failed one.',
+];
+/** The heading a corrective attempt's addition opens with. */
+export const QA_AUTHOR_CORRECTION_HEADING = '## YOUR PREVIOUS ANSWER WAS REFUSED';
+/**
+ * What a corrective attempt appends to the prompt: the rules the previous
+ * answer broke, one per line, and the instruction to write the whole packet
+ * again. Pure; the same text for every engine.
+ */
+export function buildQaAuthorCorrection(violations) {
+    return [
+        QA_AUTHOR_CORRECTION_HEADING,
+        'You answered this once already, and that packet was refused because it broke these rules:',
+        ...violations.map((v) => `- ${v}`),
+        '',
+        'Write the WHOLE packet again, following every rule above: copy each `criterion` exactly from the criteria ' +
+            'listed, and add every required retest case. End with exactly one fenced json block.',
+    ].join('\n') + '\n';
+}
+/**
+ * The QA-author prompt for one candidate. `reviewedSha` is the commit the
+ * packet is pinned to; `fresh` carries the change for a fresh pass (ignored
+ * when resumed). Pure: the same inputs give the same text.
+ */
+export function buildQaAuthorPrompt(candidate, mode, reviewedSha, fresh = null) {
+    const intro = [
+        QA_AUTHOR_HEADING,
+        `The team's work on the focus "${candidate.focusName}" is finished and reviewed. A HUMAN will now check it by hand: ` +
+            'they open the product in a web browser at the QA target below and run the test packet you write, case by case. ' +
+            'Write that packet.',
+    ];
+    if (candidate.focusDescription?.trim())
+        intro.push('', 'The focus:', ...verbatim(candidate.focusDescription, ''));
+    const sections = [
+        intro,
+        targetLines(candidate, reviewedSha),
+        criteriaLines(candidate),
+        retestLines(candidate),
+        knowledgeLines(candidate, mode, fresh),
+        [...RULE_LINES],
+        [...OUTPUT_LINES],
+    ].filter((s) => s.length > 0);
+    return sections.map((s) => s.join('\n')).join('\n\n') + '\n';
+}
+//# sourceMappingURL=qa-author-section.js.map

package/dist/prompt-sections/qa-author-section.js.map

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

package/dist/qa/qa-author-faithfulness.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Is a QA-author answer FAITHFUL to its focus? Every case quotes one of the
+ * criteria the pass was shown (the focus's acceptance criteria, each
+ * non-cancelled delivery's, each armed baseline criterion -- normalized, never
+ * paraphrased), and on a re-entry after a QA fail every failed case whose
+ * criterion still applies is re-tested (retest: true, retestOf: <its id>).
+ *
+ * The daemon runs this BEFORE it asks for the ready write, so an unfaithful
+ * answer can be re-asked (qa-author-runner.ts) instead of only refused. The
+ * authoritative rule is the edge's: checkQaPacketFaithful in
+ * src/lib/qa/qa-packet.ts (mirrored to supabase/functions/_shared), which
+ * daemon_qa_packet_write applies before a ready or no_ui_surface write. The
+ * daemon cannot import src/lib, so this is its own copy; qa-author-
+ * faithfulness.test.ts runs the SAME conformance table
+ * (src/lib/qa/__fixtures__/qa-faithfulness-cases.json) the canonical vitest
+ * runs, so the two cannot drift.
+ */
+import type { QaPacketCandidate } from '../queries/qa-packets/qa-packets.js';
+/** What the rule reads of one case. */
+export interface QaFaithfulnessCase {
+    id: string;
+    criterion: string;
+    retest?: boolean;
+    retestOf?: string;
+}
+/** What the rule reads of a packet and its focus. */
+export interface QaPacketFaithfulnessInput {
+    /** The packet's cases ([] for a no-UI-surface packet). */
+    cases: readonly QaFaithfulnessCase[];
+    noUiSurface: boolean;
+    /** The quotable criteria (qaCriteriaFromTexts); normalized again here. */
+    criteria: readonly string[];
+    /** The cases a human failed in the previous QA cycle ([] when it did not fail). */
+    previousFailedCases: ReadonlyArray<Pick<QaFaithfulnessCase, 'id' | 'criterion'>>;
+}
+/**
+ * The one normalization both sides of a criterion comparison get. Pure and
+ * idempotent: trim; strip surrounding quotes and a leading list marker, one
+ * layer at a time until neither is left; collapse whitespace runs to one
+ * space. Case, punctuation and wording are kept.
+ */
+export declare function normalizeQaCriterion(text: string): string;
+/** Every whole text block and each of its non-empty lines, normalized and de-duplicated. Pure. */
+export declare function qaCriteriaFromTexts(texts: ReadonlyArray<string | null | undefined>): string[];
+/** The criterion strings of an armed_baseline_criteria array; anything else yields none. Pure. */
+export declare function qaArmedBaselineCriterionTexts(value: unknown): string[];
+/**
+ * Is the packet faithful? Pure. One human-readable line per violation; [] is
+ * faithful. Rules: (1) every criterion is one of `criteria`; (2) every
+ * previously failed case whose criterion still applies is re-tested by a case
+ * quoting that same criterion; (3) a retest case carries both flag and
+ * retestOf, naming a failed case, and quotes the criterion that case tested;
+ * (4) no UI surface while a retest is owed is refused.
+ */
+export declare function checkQaPacketFaithful(input: QaPacketFaithfulnessInput): string[];
+/**
+ * The violations of one parsed answer against what the candidate read handed
+ * the author -- the same inputs daemon_qa_packet_write checks the write
+ * against. Pure.
+ */
+export declare function qaAnswerFaithfulnessViolations(candidate: Pick<QaPacketCandidate, 'focusAcceptanceCriteria' | 'deliveries' | 'armedBaselineCriteria' | 'previousPacket'>, answer: {
+    kind: 'cases';
+    cases: readonly unknown[];
+} | {
+    kind: 'no_ui_surface';
+}): string[];
+//# sourceMappingURL=qa-author-faithfulness.d.ts.map

package/dist/qa/qa-author-faithfulness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-author-faithfulness.d.ts","sourceRoot":"","sources":["../../src/qa/qa-author-faithfulness.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAE7E,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qDAAqD;AACrD,MAAM,WAAW,yBAAyB;IACxC,0DAA0D;IAC1D,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACrC,WAAW,EAAE,OAAO,CAAC;IACrB,0EAA0E;IAC1E,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,mFAAmF;IACnF,mBAAmB,EAAE,aAAa,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC;CAClF;AAsBD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQzD;AAED,kGAAkG;AAClG,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,MAAM,EAAE,CAU7F;AAMD,kGAAkG;AAClG,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAOtE;AAqCD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,yBAAyB,GAAG,MAAM,EAAE,CAgChF;AAcD;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,yBAAyB,GAAG,YAAY,GAAG,uBAAuB,GAAG,gBAAgB,CAAC,EACzH,MAAM,EAAE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GAC/E,MAAM,EAAE,CAYV"}

package/dist/qa/qa-author-faithfulness.js

@@ -0,0 +1,157 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/qa/qa-author-faithfulness.test.ts
+// PINNED-BY-END
+const QUOTE_PAIRS = [
+    ['"', '"'],
+    ["'", "'"],
+    ['“', '”'],
+    ['‘', '’'],
+];
+const LIST_MARKER = /^(?:[-*+•]|\d+[.)])\s+/;
+const QUOTE_MAX_CHARS = 160;
+function stripQuotePair(text) {
+    for (const [open, close] of QUOTE_PAIRS) {
+        if (text.length >= 2 && text.startsWith(open) && text.endsWith(close))
+            return text.slice(1, -1).trim();
+    }
+    return text;
+}
+function stripListMarker(text) {
+    return text.replace(LIST_MARKER, '').trim();
+}
+/**
+ * The one normalization both sides of a criterion comparison get. Pure and
+ * idempotent: trim; strip surrounding quotes and a leading list marker, one
+ * layer at a time until neither is left; collapse whitespace runs to one
+ * space. Case, punctuation and wording are kept.
+ */
+export function normalizeQaCriterion(text) {
+    let t = text.trim();
+    for (;;) {
+        const next = stripListMarker(stripQuotePair(t));
+        if (next === t)
+            break;
+        t = next;
+    }
+    return t.replace(/\s+/g, ' ');
+}
+/** Every whole text block and each of its non-empty lines, normalized and de-duplicated. Pure. */
+export function qaCriteriaFromTexts(texts) {
+    const out = new Set();
+    for (const text of texts) {
+        if (typeof text !== 'string')
+            continue;
+        for (const piece of [text, ...text.split(/\r?\n/)]) {
+            const normalized = normalizeQaCriterion(piece);
+            if (normalized)
+                out.add(normalized);
+        }
+    }
+    return [...out];
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** The criterion strings of an armed_baseline_criteria array; anything else yields none. Pure. */
+export function qaArmedBaselineCriterionTexts(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.flatMap((entry) => {
+        if (!isRecord(entry))
+            return [];
+        const criterion = entry.criterion;
+        return typeof criterion === 'string' && criterion.trim().length > 0 ? [criterion] : [];
+    });
+}
+function quoteForViolation(text) {
+    const t = text.trim();
+    return JSON.stringify(t.length > QUOTE_MAX_CHARS ? `${t.slice(0, QUOTE_MAX_CHARS)}...` : t);
+}
+/** Rules 1 and 3 for one case: it quotes a criterion; its retest flag and retestOf agree and name a failed case. */
+function caseViolations(c, quotable, failedCriteria) {
+    const out = [];
+    if (!quotable.has(normalizeQaCriterion(c.criterion))) {
+        out.push(`case ${c.id}: criterion ${quoteForViolation(c.criterion)} is not one of the focus's acceptance criteria ` +
+            '(copy one line, without its bullet, or one whole block, exactly)');
+    }
+    const retestOf = typeof c.retestOf === 'string' ? c.retestOf.trim() : '';
+    const failedList = failedCriteria.size > 0 ? `failed: ${[...failedCriteria.keys()].join(', ')}` : 'it failed no case';
+    if (c.retest === true && !retestOf) {
+        out.push(`case ${c.id}: is flagged "retest": true but names no retestOf`);
+    }
+    else if (retestOf && c.retest !== true) {
+        out.push(`case ${c.id}: names retestOf ${quoteForViolation(retestOf)} but is not flagged "retest": true`);
+    }
+    else if (retestOf && !failedCriteria.has(retestOf)) {
+        out.push(`case ${c.id}: retestOf ${quoteForViolation(retestOf)} is not a case the human failed in the previous QA cycle (${failedList})`);
+    }
+    else if (retestOf && failedCriteria.get(retestOf) !== normalizeQaCriterion(c.criterion)) {
+        out.push(`case ${c.id}: re-tests failed case ${retestOf} but quotes a different criterion -- a retest quotes the ` +
+            `criterion the failed case tested, ${quoteForViolation(failedCriteria.get(retestOf) ?? '')}`);
+    }
+    return out;
+}
+/**
+ * Is the packet faithful? Pure. One human-readable line per violation; [] is
+ * faithful. Rules: (1) every criterion is one of `criteria`; (2) every
+ * previously failed case whose criterion still applies is re-tested by a case
+ * quoting that same criterion; (3) a retest case carries both flag and
+ * retestOf, naming a failed case, and quotes the criterion that case tested;
+ * (4) no UI surface while a retest is owed is refused.
+ */
+export function checkQaPacketFaithful(input) {
+    const quotable = new Set(input.criteria.map(normalizeQaCriterion).filter((c) => c.length > 0));
+    const failedCriteria = new Map(input.previousFailedCases.map((f) => [f.id.trim(), normalizeQaCriterion(f.criterion)]));
+    const violations = input.cases.flatMap((c) => caseViolations(c, quotable, failedCriteria));
+    const required = input.previousFailedCases.filter((f) => quotable.has(normalizeQaCriterion(f.criterion)));
+    if (input.noUiSurface && required.length > 0) {
+        violations.push(`the packet marks no UI surface, but the previous QA cycle failed UI case(s) ${required.map((f) => f.id).join(', ')} ` +
+            'whose criteria still apply; each needs a retest case');
+        return violations;
+    }
+    for (const f of required) {
+        const id = f.id.trim();
+        const criterion = normalizeQaCriterion(f.criterion);
+        const retested = input.cases.some((c) => c.retest === true &&
+            typeof c.retestOf === 'string' &&
+            c.retestOf.trim() === id &&
+            normalizeQaCriterion(c.criterion) === criterion);
+        if (!retested) {
+            violations.push(`previous failed case ${id} (criterion ${quoteForViolation(f.criterion)}) still applies but no case re-tests it: ` +
+                `add a case quoting that criterion with "retest": true, "retestOf": "${id}"`);
+        }
+    }
+    return violations;
+}
+/** The fields the rule reads of a structurally parsed answer case (qa-author-output.ts checked id and criterion). */
+function toFaithfulnessCase(value) {
+    const c = isRecord(value) ? value : {};
+    const out = {
+        id: typeof c.id === 'string' ? c.id.trim() : '',
+        criterion: typeof c.criterion === 'string' ? c.criterion : '',
+    };
+    if (c.retest === true)
+        out.retest = true;
+    if (typeof c.retestOf === 'string' && c.retestOf.trim())
+        out.retestOf = c.retestOf.trim();
+    return out;
+}
+/**
+ * The violations of one parsed answer against what the candidate read handed
+ * the author -- the same inputs daemon_qa_packet_write checks the write
+ * against. Pure.
+ */
+export function qaAnswerFaithfulnessViolations(candidate, answer) {
+    const criteria = qaCriteriaFromTexts([
+        candidate.focusAcceptanceCriteria,
+        ...candidate.deliveries.map((d) => d.acceptanceCriteria),
+        ...qaArmedBaselineCriterionTexts(candidate.armedBaselineCriteria),
+    ]);
+    return checkQaPacketFaithful({
+        cases: answer.kind === 'cases' ? answer.cases.map(toFaithfulnessCase) : [],
+        noUiSurface: answer.kind === 'no_ui_surface',
+        criteria,
+        previousFailedCases: candidate.previousPacket?.failedCases ?? [],
+    });
+}
+//# sourceMappingURL=qa-author-faithfulness.js.map

package/dist/qa/qa-author-faithfulness.js.map

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

package/dist/qa/qa-author-mode.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Which way the QA-author pass runs for one focus: RESUMED -- a fork of the
+ * coding team's own Claude session, which already knows what it built -- or
+ * FRESH, over the delivery summaries and the diff.
+ *
+ * Resume only when the focus's coding lineage holds a CLAUDE session id (a
+ * Codex id cannot be resumed by the claude CLI; session/session-lineage.ts
+ * keys Claude under the bare lineage) AND the focus worktree that session ran
+ * in still exists: the CLI finds a session's transcript by the directory it
+ * ran in, and the session's file reads are relative to it. Anything else runs
+ * fresh, with the reason recorded in the log.
+ */
+import type { QaPacketCandidate } from '../queries/qa-packets/qa-packets.js';
+import { QA_AUTHOR_MODE } from '../types/qa-packet.js';
+/** The lineage whose session built the focus. */
+export declare const QA_CODING_LINEAGE = "coding";
+/** What the decision reads besides the candidate. */
+export interface QaAuthorModeFacts {
+    /** The focus worktree the coding session ran in, or null when none is known. */
+    worktreePath: string | null;
+    /** Whether that directory still exists. */
+    worktreeExists: boolean;
+}
+export type QaAuthorModeDecision = {
+    mode: typeof QA_AUTHOR_MODE.RESUMED;
+    sessionId: string;
+    cwd: string;
+} | {
+    mode: typeof QA_AUTHOR_MODE.FRESH;
+    reason: string;
+};
+/** Decide resumed vs fresh. Pure. */
+export declare function decideQaAuthorMode(candidate: Pick<QaPacketCandidate, 'codingSessionIds'>, facts: QaAuthorModeFacts): QaAuthorModeDecision;
+//# sourceMappingURL=qa-author-mode.d.ts.map

package/dist/qa/qa-author-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-author-mode.d.ts","sourceRoot":"","sources":["../../src/qa/qa-author-mode.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAE7E,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,iDAAiD;AACjD,eAAO,MAAM,iBAAiB,WAAW,CAAC;AAE1C,qDAAqD;AACrD,MAAM,WAAW,iBAAiB;IAChC,gFAAgF;IAChF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,2CAA2C;IAC3C,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,OAAO,cAAc,CAAC,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,IAAI,EAAE,OAAO,cAAc,CAAC,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,qCAAqC;AACrC,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,kBAAkB,CAAC,EACtD,KAAK,EAAE,iBAAiB,GACvB,oBAAoB,CAmBtB"}

package/dist/qa/qa-author-mode.js

@@ -0,0 +1,29 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/qa/qa-author-mode.test.ts
+// PINNED-BY-END
+import { sessionMapKey } from '../session/session-lineage.js';
+import { QA_AUTHOR_MODE } from '../types/qa-packet.js';
+/** The lineage whose session built the focus. */
+export const QA_CODING_LINEAGE = 'coding';
+/** Decide resumed vs fresh. Pure. */
+export function decideQaAuthorMode(candidate, facts) {
+    const sessions = candidate.codingSessionIds;
+    const sessionId = sessions[sessionMapKey('claude', QA_CODING_LINEAGE)];
+    if (!sessionId) {
+        const codex = sessions[sessionMapKey('codex', QA_CODING_LINEAGE)];
+        return {
+            mode: QA_AUTHOR_MODE.FRESH,
+            reason: codex
+                ? 'the coding session ran on codex, which the claude CLI cannot resume'
+                : 'no coding session is recorded for the focus',
+        };
+    }
+    if (!facts.worktreePath) {
+        return { mode: QA_AUTHOR_MODE.FRESH, reason: 'no focus worktree is known to resume the coding session in' };
+    }
+    if (!facts.worktreeExists) {
+        return { mode: QA_AUTHOR_MODE.FRESH, reason: `the focus worktree ${facts.worktreePath} no longer exists` };
+    }
+    return { mode: QA_AUTHOR_MODE.RESUMED, sessionId, cwd: facts.worktreePath };
+}
+//# sourceMappingURL=qa-author-mode.js.map

package/dist/qa/qa-author-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-author-mode.js","sourceRoot":"","sources":["../../src/qa/qa-author-mode.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,2DAA2D;AAC3D,gBAAgB;AAgBhB,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,iDAAiD;AACjD,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAC;AAc1C,qCAAqC;AACrC,MAAM,UAAU,kBAAkB,CAChC,SAAsD,EACtD,KAAwB;IAExB,MAAM,QAAQ,GAAG,SAAS,CAAC,gBAAgB,CAAC;IAC5C,MAAM,SAAS,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACvE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC;QAClE,OAAO;YACL,IAAI,EAAE,cAAc,CAAC,KAAK;YAC1B,MAAM,EAAE,KAAK;gBACX,CAAC,CAAC,qEAAqE;gBACvE,CAAC,CAAC,6CAA6C;SAClD,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;QACxB,OAAO,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,4DAA4D,EAAE,CAAC;IAC9G,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;QAC1B,OAAO,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,sBAAsB,KAAK,CAAC,YAAY,mBAAmB,EAAE,CAAC;IAC7G,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,cAAc,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC;AAC9E,CAAC"}

package/dist/qa/qa-author-output.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Read the QA-author pass's answer: the LAST fenced ```json block of the
+ * output, holding either {"cases": [...]} or {"noUiSurface": true} (the output
+ * contract prompt-sections/qa-author-section.ts states).
+ *
+ * The check here is structural only -- an array of objects with string fields,
+ * click-level steps, a path that is not absolute -- so an answer that could
+ * never be a packet is caught before it is written. The authoritative case
+ * contract is the edge's (supabase/functions/_shared/qa-packet.ts
+ * parseQaCases): a ready write it refuses is recorded as a failed packet.
+ */
+export type QaAuthorOutput = {
+    kind: 'cases';
+    cases: unknown[];
+} | {
+    kind: 'no_ui_surface';
+} | {
+    kind: 'error';
+    error: string;
+};
+/** Parse a QA-author answer. Pure. */
+export declare function parseQaAuthorOutput(text: string): QaAuthorOutput;
+//# sourceMappingURL=qa-author-output.d.ts.map

package/dist/qa/qa-author-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-author-output.d.ts","sourceRoot":"","sources":["../../src/qa/qa-author-output.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AA+BrC,sCAAsC;AACtC,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAyBhE"}

package/dist/qa/qa-author-output.js

@@ -0,0 +1,66 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/prompt-sections/qa-author-section.test.ts,
+//   packages/daemon/src/qa/qa-author-output.test.ts
+// PINNED-BY-END
+const FENCED_JSON = /```json[^\S\n]*\n([\s\S]*?)```/gi;
+const CASE_STRING_FIELDS = ['id', 'criterion', 'built', 'path', 'expected'];
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** Whether `path` reaches off the QA target: a scheme, a protocol-relative or backslash start. */
+function isAbsolutePath(path) {
+    const p = path.trim();
+    return /^[a-z][a-z0-9+.-]*:/i.test(p) || p.startsWith('//') || p.startsWith('\\');
+}
+/** The first structural problem of one case, or null. */
+function caseProblem(value, index) {
+    const at = `case ${index + 1}`;
+    if (!isRecord(value))
+        return `${at} is not an object`;
+    for (const field of CASE_STRING_FIELDS) {
+        const v = value[field];
+        if (typeof v !== 'string' || v.trim() === '')
+            return `${at}: ${field} must be a non-empty string`;
+    }
+    if (isAbsolutePath(value.path))
+        return `${at}: path must be relative to the QA target base URL`;
+    const steps = value.steps;
+    if (!Array.isArray(steps) || steps.length === 0 || !steps.every((s) => typeof s === 'string' && s.trim() !== '')) {
+        return `${at}: steps must be a non-empty array of strings`;
+    }
+    return null;
+}
+/** Parse a QA-author answer. Pure. */
+export function parseQaAuthorOutput(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 cases = parsed.cases;
+    const hasCases = Array.isArray(cases) && cases.length > 0;
+    if (parsed.noUiSurface === true) {
+        return hasCases
+            ? { kind: 'error', error: 'the answer both marks no UI surface and lists cases' }
+            : { kind: 'no_ui_surface' };
+    }
+    if (!Array.isArray(cases))
+        return { kind: 'error', error: 'the last json block has neither "cases" nor "noUiSurface": true' };
+    if (cases.length === 0)
+        return { kind: 'error', error: 'the answer lists no cases and does not mark no UI surface' };
+    for (let i = 0; i < cases.length; i++) {
+        const problem = caseProblem(cases[i], i);
+        if (problem)
+            return { kind: 'error', error: problem };
+    }
+    return { kind: 'cases', cases };
+}
+//# sourceMappingURL=qa-author-output.js.map

package/dist/qa/qa-author-output.js.map

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