@chief-clancy/core 0.1.0

package/dist/dev/lifecycle/pull-request/post-pr/post-pr.js

@@ -0,0 +1,64 @@
+/** Timeout in milliseconds for PR creation requests. */
+const REQUEST_TIMEOUT_MS = 30_000;
+/**
+ * POST a pull request / merge request and return a typed result.
+ *
+ * Handles the common try/catch, response parsing, error formatting,
+ * and "already exists" detection shared by all git host implementations.
+ *
+ * @param opts - Request options including fetch, URL, headers, body, and callbacks.
+ * @returns A typed `PrCreationResult`.
+ */
+export async function postPullRequest(opts) {
+    const { fetchFn, url, headers, body, parseSuccess, isAlreadyExists } = opts;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+    try {
+        const response = await fetchFn(url, {
+            method: 'POST',
+            headers: { ...headers, 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+            signal: controller.signal,
+        });
+        if (!response.ok) {
+            const text = await response.text().catch(() => '');
+            const alreadyExists = isAlreadyExists?.(response.status, text) ?? false;
+            return {
+                ok: false,
+                error: `HTTP ${response.status}${text ? `: ${text.slice(0, 200)}` : ''}`,
+                alreadyExists,
+            };
+        }
+        const json = await response.json();
+        const parsed = parseSuccess(json);
+        if (!parsed.url && !parsed.number) {
+            return {
+                ok: false,
+                error: 'PR created but response missing URL and number',
+            };
+        }
+        return { ok: true, url: parsed.url, number: parsed.number };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+/**
+ * Build a Basic Auth header value from username and token.
+ *
+ * Used by Bitbucket Cloud and Azure DevOps for HTTP Basic Auth.
+ *
+ * @param username - The username (empty string for AzDO PAT auth).
+ * @param token - The token or app password.
+ * @returns The `Basic {base64}` header value.
+ */
+export function basicAuth(username, token) {
+    return `Basic ${Buffer.from(`${username}:${token}`).toString('base64')}`;
+}
+//# sourceMappingURL=post-pr.js.map

package/dist/dev/lifecycle/pull-request/post-pr/post-pr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-pr.js","sourceRoot":"","sources":["../../../../../src/dev/lifecycle/pull-request/post-pr/post-pr.ts"],"names":[],"mappings":"AAyBA,wDAAwD;AACxD,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAgB;IAEhB,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;IAC5E,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,kBAAkB,CAAC,CAAC;IAEzE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE;YAClC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC3D,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAC1B,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACnD,MAAM,aAAa,GAAG,eAAe,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC;YAExE,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,QAAQ,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;gBACxE,aAAa;aACd,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAY,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAElC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,gDAAgD;aACxD,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC9D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,KAAa;IACvD,OAAO,SAAS,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,IAAI,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;AAC3E,CAAC"}

package/dist/dev/lifecycle/pull-request/pr-body/index.d.ts

@@ -0,0 +1,3 @@
+export type { EpicContext } from './pr-body.js';
+export { buildEpicPrBody, buildPrBody, isEpicBranch } from './pr-body.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/dev/lifecycle/pull-request/pr-body/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/dev/lifecycle/pull-request/pr-body/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/dev/lifecycle/pull-request/pr-body/index.js

@@ -0,0 +1,2 @@
+export { buildEpicPrBody, buildPrBody, isEpicBranch } from './pr-body.js';
+//# sourceMappingURL=index.js.map

package/dist/dev/lifecycle/pull-request/pr-body/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/dev/lifecycle/pull-request/pr-body/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/dev/lifecycle/pull-request/pr-body/pr-body.d.ts

@@ -0,0 +1,65 @@
+/**
+ * PR/MR body builder.
+ *
+ * Constructs the pull request description with a link back to the
+ * board ticket and a Clancy footer.
+ */
+import type { ProgressEntry } from '../../../../dev/lifecycle/progress/index.js';
+import type { BoardConfig } from '../../../../schemas/env/env.js';
+import type { Ticket } from '../../../../types/index.js';
+/** Epic context for child PRs targeting an epic/milestone branch. */
+export type EpicContext = {
+    /** Parent epic key (e.g., `'#49'`, `'PROJ-100'`). */
+    readonly parentKey: string;
+    /** Number of sibling tickets already delivered to the epic branch. */
+    readonly siblingsDelivered: number;
+    /** Target epic branch name (e.g., `'milestone/49'`). */
+    readonly epicBranch: string;
+};
+/** Options for {@link buildPrBody}. */
+type BuildPrBodyOpts = {
+    readonly config: BoardConfig;
+    readonly ticket: Ticket;
+    readonly targetBranch?: string;
+    readonly verificationWarning?: string;
+    readonly singleChildParent?: string;
+    readonly epicContext?: EpicContext;
+};
+/** Options for {@link buildEpicPrBody}. */
+type BuildEpicPrBodyOpts = {
+    readonly epicKey: string;
+    readonly epicTitle: string;
+    readonly childEntries: readonly ProgressEntry[];
+    readonly provider?: string;
+};
+/**
+ * Check whether a target branch is an epic or milestone branch.
+ *
+ * @param targetBranch - The branch the PR targets.
+ * @returns `true` if it's an epic (`epic/`) or milestone (`milestone/`) branch.
+ */
+export declare function isEpicBranch(targetBranch: string): boolean;
+/**
+ * Build the PR/MR body for a ticket.
+ *
+ * Includes a link back to the board ticket (auto-close for GitHub Issues
+ * when targeting the base branch, or "Part of" when targeting an epic branch)
+ * and a Clancy attribution footer.
+ *
+ * @param opts - Build options including config, ticket, and optional context.
+ * @returns The PR body as a markdown string.
+ */
+export declare function buildPrBody(opts: BuildPrBodyOpts): string;
+/**
+ * Build the PR body for the final epic PR (epic branch → base branch).
+ *
+ * Lists all child tickets with their PR numbers for traceability.
+ * For GitHub, includes `Closes` keywords to auto-close child issues
+ * and the parent epic when the PR is merged to the default branch.
+ *
+ * @param opts - Build options including epic key, title, children, and provider.
+ * @returns The epic PR body as a markdown string.
+ */
+export declare function buildEpicPrBody(opts: BuildEpicPrBodyOpts): string;
+export {};
+//# sourceMappingURL=pr-body.d.ts.map

package/dist/dev/lifecycle/pull-request/pr-body/pr-body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-body.d.ts","sourceRoot":"","sources":["../../../../../src/dev/lifecycle/pull-request/pr-body/pr-body.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,qEAAqE;AACrE,MAAM,MAAM,WAAW,GAAG;IACxB,qDAAqD;IACrD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,sEAAsE;IACtE,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,wDAAwD;IACxD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,uCAAuC;AACvC,KAAK,eAAe,GAAG;IACrB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;CACpC,CAAC;AAEF,2CAA2C;AAC3C,KAAK,mBAAmB,GAAG;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,SAAS,aAAa,EAAE,CAAC;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAI1D;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAezD;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAwBjE"}

package/dist/dev/lifecycle/pull-request/pr-body/pr-body.js

@@ -0,0 +1,144 @@
+/**
+ * Check whether a target branch is an epic or milestone branch.
+ *
+ * @param targetBranch - The branch the PR targets.
+ * @returns `true` if it's an epic (`epic/`) or milestone (`milestone/`) branch.
+ */
+export function isEpicBranch(targetBranch) {
+    return (targetBranch.startsWith('epic/') || targetBranch.startsWith('milestone/'));
+}
+/**
+ * Build the PR/MR body for a ticket.
+ *
+ * Includes a link back to the board ticket (auto-close for GitHub Issues
+ * when targeting the base branch, or "Part of" when targeting an epic branch)
+ * and a Clancy attribution footer.
+ *
+ * @param opts - Build options including config, ticket, and optional context.
+ * @returns The PR body as a markdown string.
+ */
+export function buildPrBody(opts) {
+    const { config, ticket, targetBranch, verificationWarning } = opts;
+    const { singleChildParent, epicContext } = opts;
+    const isEpic = targetBranch ? isEpicBranch(targetBranch) : false;
+    const sections = [
+        ...epicBannerLines(epicContext, isEpic),
+        ...ticketReferenceLines({ config, ticket, isEpic, singleChildParent }),
+        '',
+        ...descriptionLines(ticket.description),
+        ...verificationLines(verificationWarning),
+        ...footerLines(),
+    ];
+    return sections.join('\n');
+}
+/**
+ * Build the PR body for the final epic PR (epic branch → base branch).
+ *
+ * Lists all child tickets with their PR numbers for traceability.
+ * For GitHub, includes `Closes` keywords to auto-close child issues
+ * and the parent epic when the PR is merged to the default branch.
+ *
+ * @param opts - Build options including epic key, title, children, and provider.
+ * @returns The epic PR body as a markdown string.
+ */
+export function buildEpicPrBody(opts) {
+    const { epicKey, epicTitle, childEntries, provider } = opts;
+    const childLines = childEntries.map((entry) => {
+        const prRef = entry.prNumber ? ` (#${entry.prNumber})` : '';
+        return `- ${entry.key} — ${entry.summary}${prRef}`;
+    });
+    const closesLines = provider === 'github' ? githubClosesLines(epicKey, childEntries) : [];
+    const sections = [
+        `## ${epicKey} — ${epicTitle}`,
+        '',
+        '### Children',
+        '',
+        ...childLines,
+        ...closesLines,
+        '',
+        '---',
+        '*Created by [Clancy](https://github.com/Pushedskydiver/chief-clancy)*',
+    ];
+    return sections.join('\n');
+}
+// ─── private helpers ────────────────────────────────────────────────────────
+function epicBannerLines(epic, isEpic) {
+    if (!epic || !isEpic)
+        return [];
+    const delivered = epic.siblingsDelivered;
+    const deliveredText = delivered === 0
+        ? 'No siblings delivered yet'
+        : `${delivered} sibling${delivered === 1 ? '' : 's'} previously delivered to \`${epic.epicBranch}\``;
+    return [
+        `## Part of epic ${epic.parentKey}`,
+        deliveredText,
+        '',
+        `> This PR targets \`${epic.epicBranch}\`. A final epic PR will be created when all children are complete.`,
+        '',
+    ];
+}
+function ticketReferenceLines(opts) {
+    const { config, ticket, isEpic, singleChildParent } = opts;
+    switch (config.provider) {
+        case 'github': {
+            const ref = isEpic ? `Part of ${ticket.key}` : `Closes ${ticket.key}`;
+            const parentClose = singleChildParent && !isEpic ? [`Closes ${singleChildParent}`] : [];
+            return [ref, ...parentClose];
+        }
+        case 'jira':
+            return [
+                `**Jira:** [${ticket.key}](${config.env.JIRA_BASE_URL}/browse/${ticket.key})`,
+            ];
+        case 'linear':
+            return [`**Linear:** ${ticket.key}`];
+        case 'shortcut':
+        case 'notion':
+        case 'azdo':
+            return [`**Ticket:** ${ticket.key}`];
+    }
+}
+function descriptionLines(description) {
+    if (!description)
+        return [];
+    return ['## Description', '', description, ''];
+}
+function verificationLines(warning) {
+    if (!warning)
+        return [];
+    return [
+        '## ⚠ Verification Warning',
+        '',
+        warning,
+        '',
+        'This PR may need manual fixes before merging.',
+        '',
+    ];
+}
+const FOOTER = `---
+*Created by [Clancy](https://github.com/Pushedskydiver/chief-clancy)*
+
+---
+<details>
+<summary><strong>Rework instructions</strong> (click to expand)</summary>
+
+To request changes:
+- **Code comments** — leave inline comments on specific lines. These are always picked up automatically.
+- **General feedback** — reply with a comment starting with \`Rework:\` followed by what needs fixing. Comments without the \`Rework:\` prefix are treated as discussion.
+
+Example: \`Rework: The form validation doesn't handle empty passwords\`
+
+</details>`;
+function footerLines() {
+    return FOOTER.split('\n');
+}
+function githubClosesLines(epicKey, childEntries) {
+    const childKeys = childEntries
+        .map((e) => e.key)
+        .filter((k) => k.startsWith('#'));
+    const epicPrefix = epicKey.startsWith('#') ? [epicKey] : [];
+    const issueKeys = [...epicPrefix, ...childKeys];
+    if (issueKeys.length === 0)
+        return [];
+    return ['', '### Closes', '', issueKeys.map((k) => `Closes ${k}`).join(', ')];
+}
+//# sourceMappingURL=pr-body.js.map

package/dist/dev/lifecycle/pull-request/pr-body/pr-body.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-body.js","sourceRoot":"","sources":["../../../../../src/dev/lifecycle/pull-request/pr-body/pr-body.ts"],"names":[],"mappings":"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"}

package/dist/dev/lifecycle/pull-request/rework-comment/rework-comment.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Rework comment detection and extraction utilities.
+ *
+ * Comments starting with "Rework:" (case-insensitive) are treated as
+ * rework requests. All other comments are treated as discussion and ignored.
+ */
+/**
+ * Check if a comment is a rework request (starts with "Rework:" case-insensitive).
+ *
+ * @param body - The comment body to check.
+ * @returns `true` if the comment starts with "Rework:".
+ */
+export declare function isReworkComment(body: string): boolean;
+/**
+ * Check if a comment was posted by Clancy's automation (starts with `[clancy]`).
+ *
+ * @param body - The comment body to check.
+ * @returns `true` if the comment starts with `[clancy]`.
+ */
+export declare function isClancyComment(body: string): boolean;
+/**
+ * Extract the rework description from a "Rework: ..." comment.
+ *
+ * Strips the "Rework:" prefix and returns the remaining content trimmed.
+ *
+ * @param body - The full comment body starting with "Rework:".
+ * @returns The description after the prefix.
+ */
+export declare function extractReworkContent(body: string): string;
+//# sourceMappingURL=rework-comment.d.ts.map

package/dist/dev/lifecycle/pull-request/rework-comment/rework-comment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rework-comment.d.ts","sourceRoot":"","sources":["../../../../../src/dev/lifecycle/pull-request/rework-comment/rework-comment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKzD"}

package/dist/dev/lifecycle/pull-request/rework-comment/rework-comment.js

@@ -0,0 +1,39 @@
+/**
+ * Rework comment detection and extraction utilities.
+ *
+ * Comments starting with "Rework:" (case-insensitive) are treated as
+ * rework requests. All other comments are treated as discussion and ignored.
+ */
+/**
+ * Check if a comment is a rework request (starts with "Rework:" case-insensitive).
+ *
+ * @param body - The comment body to check.
+ * @returns `true` if the comment starts with "Rework:".
+ */
+export function isReworkComment(body) {
+    return body.trim().toLowerCase().startsWith('rework:');
+}
+/**
+ * Check if a comment was posted by Clancy's automation (starts with `[clancy]`).
+ *
+ * @param body - The comment body to check.
+ * @returns `true` if the comment starts with `[clancy]`.
+ */
+export function isClancyComment(body) {
+    return body.trimStart().startsWith('[clancy]');
+}
+/**
+ * Extract the rework description from a "Rework: ..." comment.
+ *
+ * Strips the "Rework:" prefix and returns the remaining content trimmed.
+ *
+ * @param body - The full comment body starting with "Rework:".
+ * @returns The description after the prefix.
+ */
+export function extractReworkContent(body) {
+    return body
+        .trim()
+        .replace(/^rework:\s*/i, '')
+        .trim();
+}
+//# sourceMappingURL=rework-comment.js.map

package/dist/dev/lifecycle/pull-request/rework-comment/rework-comment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rework-comment.js","sourceRoot":"","sources":["../../../../../src/dev/lifecycle/pull-request/rework-comment/rework-comment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AACzD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,IAAI;SACR,IAAI,EAAE;SACN,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;SAC3B,IAAI,EAAE,CAAC;AACZ,CAAC"}

package/dist/dev/lifecycle/quality/quality.d.ts

@@ -0,0 +1,99 @@
+/** Injected filesystem operations for quality data I/O. */
+export type QualityFs = {
+    /** Read a file as UTF-8, throwing if missing. */
+    readonly readFile: (path: string) => string;
+    /** Write UTF-8 content to a file (creates if missing, overwrites if exists). */
+    readonly writeFile: (path: string, content: string) => void;
+    /** Atomically rename a file. */
+    readonly rename: (from: string, to: string) => void;
+    /** Create directory recursively. */
+    readonly mkdir: (path: string) => void;
+};
+/** Quality metrics for a single ticket. */
+type QualityEntry = {
+    readonly reworkCycles: number;
+    readonly verificationRetries: number;
+    readonly deliveredAt?: string;
+    readonly duration?: number;
+};
+/** Aggregate quality summary across all tracked tickets. */
+type QualitySummary = {
+    readonly totalTickets: number;
+    readonly avgReworkCycles: number;
+    readonly avgVerificationRetries: number;
+    readonly avgDuration: number;
+};
+/** Options for recording a verification retry. */
+type VerificationRetryOpts = {
+    readonly ticketKey: string;
+    readonly retries: number;
+};
+/** Options for recording a delivery. */
+type DeliveryOpts = {
+    readonly ticketKey: string;
+    readonly duration: number;
+    readonly now: number;
+};
+/** Quality data persisted to `.clancy/quality.json`. */
+type QualityData = {
+    readonly tickets: Record<string, QualityEntry>;
+    readonly summary: QualitySummary;
+};
+/**
+ * Read quality data from `.clancy/quality.json`.
+ *
+ * Returns empty data if the file is missing, corrupt, or structurally invalid.
+ * Summary is always recomputed from ticket entries to guard against stale data.
+ *
+ * @param fs - Injected filesystem operations.
+ * @param projectRoot - Absolute path to the project root.
+ * @returns The quality data.
+ */
+export declare function readQualityData(fs: QualityFs, projectRoot: string): QualityData;
+/**
+ * Record a rework cycle for a ticket.
+ *
+ * Increments the rework counter. Best-effort — filesystem errors are
+ * swallowed to avoid crashing the orchestrator.
+ *
+ * @param fs - Injected filesystem operations.
+ * @param projectRoot - Absolute path to the project root.
+ * @param ticketKey - The ticket identifier.
+ * @returns Nothing.
+ */
+export declare function recordRework(fs: QualityFs, projectRoot: string, ticketKey: string): void;
+/**
+ * Record verification retries for a ticket.
+ *
+ * Sets the verification retry count. Best-effort — filesystem errors are
+ * swallowed to avoid crashing the orchestrator.
+ *
+ * @param fs - Injected filesystem operations.
+ * @param projectRoot - Absolute path to the project root.
+ * @param opts - Verification retry options (ticket key, retry count).
+ * @returns Nothing.
+ */
+export declare function recordVerificationRetry(fs: QualityFs, projectRoot: string, opts: VerificationRetryOpts): void;
+/**
+ * Record successful delivery of a ticket.
+ *
+ * Sets the delivery timestamp (from injected `now`) and duration.
+ * Best-effort — filesystem errors are swallowed to avoid crashing
+ * the orchestrator.
+ *
+ * @param fs - Injected filesystem operations.
+ * @param projectRoot - Absolute path to the project root.
+ * @param opts - Delivery options (ticket key, duration, timestamp).
+ * @returns Nothing.
+ */
+export declare function recordDelivery(fs: QualityFs, projectRoot: string, opts: DeliveryOpts): void;
+/**
+ * Read quality data for reporting.
+ *
+ * @param fs - Injected filesystem operations.
+ * @param projectRoot - Absolute path to the project root.
+ * @returns The quality data, or `undefined` if no tickets have been tracked.
+ */
+export declare function getQualityData(fs: QualityFs, projectRoot: string): QualityData | undefined;
+export {};
+//# sourceMappingURL=quality.d.ts.map

package/dist/dev/lifecycle/quality/quality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality.d.ts","sourceRoot":"","sources":["../../../../src/dev/lifecycle/quality/quality.ts"],"names":[],"mappings":"AAWA,2DAA2D;AAC3D,MAAM,MAAM,SAAS,GAAG;IACtB,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5C,gFAAgF;IAChF,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5D,gCAAgC;IAChC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC,CAAC;AAEF,2CAA2C;AAC3C,KAAK,YAAY,GAAG;IAClB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,4DAA4D;AAC5D,KAAK,cAAc,GAAG;IACpB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,kDAAkD;AAClD,KAAK,qBAAqB,GAAG;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,wCAAwC;AACxC,KAAK,YAAY,GAAG;IAClB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wDAAwD;AACxD,KAAK,WAAW,GAAG;IACjB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;CAClC,CAAC;AAoHF;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,SAAS,EACb,WAAW,EAAE,MAAM,GAClB,WAAW,CAoBb;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,SAAS,EACb,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,IAAI,CAeN;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,SAAS,EACb,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,qBAAqB,GAC1B,IAAI,CAeN;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,SAAS,EACb,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,YAAY,GACjB,IAAI,CAmBN;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,SAAS,EACb,WAAW,EAAE,MAAM,GAClB,WAAW,GAAG,SAAS,CAGzB"}