@chief-clancy/core 0.1.0

package/dist/dev/lifecycle/quality/quality.js

@@ -0,0 +1,213 @@
+/**
+ * Quality feedback tracking for `.clancy/quality.json`.
+ *
+ * Tracks per-ticket quality metrics: rework cycles, verification retries,
+ * and delivery duration. Filesystem access is dependency-injected for
+ * testability.
+ */
+import { join } from 'node:path';
+// ─── Constants ───────────────────────────────────────────────────────────────
+const CLANCY_DIR = '.clancy';
+const QUALITY_FILE = 'quality.json';
+const QUALITY_PATH = `${CLANCY_DIR}/${QUALITY_FILE}`;
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+const EMPTY_SUMMARY = {
+    totalTickets: 0,
+    avgReworkCycles: 0,
+    avgVerificationRetries: 0,
+    avgDuration: 0,
+};
+function emptyData() {
+    return { tickets: {}, summary: EMPTY_SUMMARY };
+}
+/** Round a number to two decimal places. */
+function round2(value) {
+    return Math.round(value * 100) / 100;
+}
+/** Sum a numeric property across an array of items (recursive — safe for bounded ticket counts). */
+function sumBy(items, fn, i = 0) {
+    return i >= items.length ? 0 : fn(items[i]) + sumBy(items, fn, i + 1);
+}
+/** Whether an entry has valid numeric reworkCycles and verificationRetries. */
+function isValidEntry(entry) {
+    return (entry !== null &&
+        typeof entry === 'object' &&
+        'reworkCycles' in entry &&
+        'verificationRetries' in entry &&
+        // Safe: `in` checks above confirm the properties exist
+        Number.isFinite(entry.reworkCycles) &&
+        Number.isFinite(entry.verificationRetries));
+}
+/** Whether `value` looks like a `{ tickets: Record<…> }` object. */
+function hasTicketsRecord(value) {
+    return (value !== null &&
+        typeof value === 'object' &&
+        'tickets' in value &&
+        typeof value.tickets === 'object' &&
+        value.tickets !== null &&
+        !Array.isArray(value.tickets));
+}
+/** Recompute aggregate summary from ticket entries. */
+function recomputeSummary(tickets) {
+    const entries = Object.values(tickets);
+    const total = entries.length;
+    if (total === 0)
+        return EMPTY_SUMMARY;
+    const delivered = entries.filter((e) => e.duration != null);
+    return {
+        totalTickets: total,
+        avgReworkCycles: round2(sumBy(entries, (e) => e.reworkCycles) / total),
+        avgVerificationRetries: round2(sumBy(entries, (e) => e.verificationRetries) / total),
+        avgDuration: delivered.length > 0
+            ? round2(sumBy(delivered, (e) => e.duration) / delivered.length)
+            : 0,
+    };
+}
+/** Write quality data atomically via temp file + rename. */
+function writeQualityData(fs, projectRoot, data) {
+    const filePath = join(projectRoot, QUALITY_PATH);
+    const tmpPath = `${filePath}.tmp`;
+    fs.mkdir(join(projectRoot, CLANCY_DIR));
+    fs.writeFile(tmpPath, JSON.stringify(data, null, 2) + '\n');
+    fs.rename(tmpPath, filePath);
+}
+/**
+ * Ensure a ticket entry exists, returning the entry and updated tickets map.
+ *
+ * @returns A tuple of [entry, updatedTickets].
+ */
+function ensureEntry(tickets, ticketKey) {
+    const existing = tickets[ticketKey];
+    if (existing)
+        return [existing, tickets];
+    const entry = { reworkCycles: 0, verificationRetries: 0 };
+    return [entry, { ...tickets, [ticketKey]: entry }];
+}
+// ─── Public API ──────────────────────────────────────────────────────────────
+/**
+ * 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 function readQualityData(fs, projectRoot) {
+    try {
+        const raw = JSON.parse(fs.readFile(join(projectRoot, QUALITY_PATH)));
+        if (hasTicketsRecord(raw)) {
+            // Safe: hasTicketsRecord narrows raw.tickets to object
+            const rawTickets = raw.tickets;
+            // Safe: isValidEntry filter ensures all remaining values are QualityEntry
+            const tickets = Object.fromEntries(Object.entries(rawTickets).filter(([, v]) => isValidEntry(v)));
+            return { tickets, summary: recomputeSummary(tickets) };
+        }
+    }
+    catch {
+        // File missing or corrupt — return empty
+    }
+    return emptyData();
+}
+/**
+ * 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 function recordRework(fs, projectRoot, ticketKey) {
+    try {
+        const data = readQualityData(fs, projectRoot);
+        const [entry, tickets] = ensureEntry(data.tickets, ticketKey);
+        const updated = {
+            ...tickets,
+            [ticketKey]: { ...entry, reworkCycles: entry.reworkCycles + 1 },
+        };
+        writeQualityData(fs, projectRoot, {
+            tickets: updated,
+            summary: recomputeSummary(updated),
+        });
+    }
+    catch {
+        // Best-effort — never crash the orchestrator
+    }
+}
+/**
+ * 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 function recordVerificationRetry(fs, projectRoot, opts) {
+    try {
+        const data = readQualityData(fs, projectRoot);
+        const [entry, tickets] = ensureEntry(data.tickets, opts.ticketKey);
+        const updated = {
+            ...tickets,
+            [opts.ticketKey]: { ...entry, verificationRetries: opts.retries },
+        };
+        writeQualityData(fs, projectRoot, {
+            tickets: updated,
+            summary: recomputeSummary(updated),
+        });
+    }
+    catch {
+        // Best-effort — never crash the orchestrator
+    }
+}
+/**
+ * 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 function recordDelivery(fs, projectRoot, opts) {
+    try {
+        const data = readQualityData(fs, projectRoot);
+        const [entry, tickets] = ensureEntry(data.tickets, opts.ticketKey);
+        const updated = {
+            ...tickets,
+            [opts.ticketKey]: {
+                ...entry,
+                deliveredAt: new Date(opts.now).toISOString(),
+                duration: Math.max(0, opts.duration),
+            },
+        };
+        writeQualityData(fs, projectRoot, {
+            tickets: updated,
+            summary: recomputeSummary(updated),
+        });
+    }
+    catch {
+        // Best-effort — never crash the orchestrator
+    }
+}
+/**
+ * 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 function getQualityData(fs, projectRoot) {
+    const data = readQualityData(fs, projectRoot);
+    return Object.keys(data.tickets).length === 0 ? undefined : data;
+}
+//# sourceMappingURL=quality.js.map

package/dist/dev/lifecycle/quality/quality.js.map

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

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

@@ -0,0 +1,64 @@
+/**
+ * Resume detection and execution for crash recovery.
+ *
+ * After a stale lock is cleaned up, checks if the ticket branch exists
+ * locally with uncommitted or unpushed work. If so, the caller can
+ * resume by committing, pushing, and optionally creating a PR.
+ */
+import type { LockData } from '../../../dev/lifecycle/lock/index.js';
+import type { ProgressFs } from '../../../dev/lifecycle/progress/index.js';
+import type { ExecGit } from '../../../shared/git-ops/index.js';
+import type { PrCreationResult } from '../../../types/remote.js';
+/** Detection result for a resumable stale lock. */
+type ResumeInfo = {
+    readonly branch: string;
+    readonly hasUncommitted: boolean;
+    readonly hasUnpushed: boolean;
+    readonly alreadyDelivered: boolean;
+};
+/** Options for {@link detectResume}. */
+type DetectResumeOpts = {
+    readonly exec: ExecGit;
+    readonly progressFs: ProgressFs;
+    readonly projectRoot: string;
+    readonly lock: LockData;
+};
+/** Callback for PR creation during resume. */
+type CreateResumePr = (lock: LockData, sourceBranch: string) => Promise<PrCreationResult | undefined>;
+/** Result of executing a resume. */
+type ResumeExecResult = {
+    readonly ok: boolean;
+    readonly prResult?: PrCreationResult;
+    readonly error?: string;
+};
+/** Options for {@link executeResume}. */
+type ExecuteResumeOpts = {
+    readonly exec: ExecGit;
+    readonly progressFs: ProgressFs;
+    readonly projectRoot: string;
+    readonly lock: LockData;
+    readonly resumeInfo: ResumeInfo;
+    readonly createPr?: CreateResumePr;
+};
+/**
+ * Check if the ticket branch from a stale lock has recoverable work.
+ *
+ * Switches to the branch, inspects for uncommitted or unpushed changes,
+ * then restores the original branch. If no local work exists, checks
+ * progress for an already-delivered ticket (crash after push but before
+ * lock deletion).
+ *
+ * @param opts - Detection options with DI dependencies.
+ * @returns Resume info if recovery is possible, `undefined` otherwise.
+ */
+export declare function detectResume(opts: DetectResumeOpts): ResumeInfo | undefined;
+/**
+ * Resume a crashed session: commit uncommitted changes, push, and
+ * optionally create a PR.
+ *
+ * @param opts - Execution options with DI dependencies.
+ * @returns Result indicating success/failure and optional PR info.
+ */
+export declare function executeResume(opts: ExecuteResumeOpts): Promise<ResumeExecResult>;
+export {};
+//# sourceMappingURL=resume.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resume.d.ts","sourceRoot":"","sources":["../../../../src/dev/lifecycle/resume/resume.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAiB5D,mDAAmD;AACnD,KAAK,UAAU,GAAG;IAChB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;CACpC,CAAC;AAEF,wCAAwC;AACxC,KAAK,gBAAgB,GAAG;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CACzB,CAAC;AAEF,8CAA8C;AAC9C,KAAK,cAAc,GAAG,CACpB,IAAI,EAAE,QAAQ,EACd,YAAY,EAAE,MAAM,KACjB,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;AAE3C,oCAAoC;AACpC,KAAK,gBAAgB,GAAG;IACtB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,yCAAyC;AACzC,KAAK,iBAAiB,GAAG;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;CACpC,CAAC;AAIF;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,UAAU,GAAG,SAAS,CAsB3E;AAID;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,gBAAgB,CAAC,CA4B3B"}

package/dist/dev/lifecycle/resume/resume.js

@@ -0,0 +1,171 @@
+import { appendProgress, findLastEntry, } from '../../../dev/lifecycle/progress/index.js';
+import { branchExists, checkout, currentBranch, hasUncommittedChanges, pushBranch, } from '../../../shared/git-ops/index.js';
+import { DELIVERED_STATUSES } from '../../../types/progress.js';
+// ─── Detection ───────────────────────────────────────────────────────────────
+/**
+ * Check if the ticket branch from a stale lock has recoverable work.
+ *
+ * Switches to the branch, inspects for uncommitted or unpushed changes,
+ * then restores the original branch. If no local work exists, checks
+ * progress for an already-delivered ticket (crash after push but before
+ * lock deletion).
+ *
+ * @param opts - Detection options with DI dependencies.
+ * @returns Resume info if recovery is possible, `undefined` otherwise.
+ */
+export function detectResume(opts) {
+    const { exec, progressFs, projectRoot, lock } = opts;
+    const branch = lock.ticketBranch;
+    if (!branchExists(exec, branch))
+        return undefined;
+    const previous = safeCurrent(exec);
+    if (!previous)
+        return undefined;
+    if (!safeCheckout(exec, branch)) {
+        safeCheckout(exec, previous);
+        return undefined;
+    }
+    const state = inspectBranch(exec, branch, lock.targetBranch);
+    safeCheckout(exec, previous);
+    if (!state.hasUncommitted && !state.hasUnpushed) {
+        return checkAlreadyDelivered({ progressFs, projectRoot, lock }, branch);
+    }
+    return { branch, ...state, alreadyDelivered: false };
+}
+// ─── Execution ───────────────────────────────────────────────────────────────
+/**
+ * Resume a crashed session: commit uncommitted changes, push, and
+ * optionally create a PR.
+ *
+ * @param opts - Execution options with DI dependencies.
+ * @returns Result indicating success/failure and optional PR info.
+ */
+export async function executeResume(opts) {
+    const { exec, progressFs, projectRoot, lock, resumeInfo, createPr } = opts;
+    try {
+        checkout(exec, resumeInfo.branch);
+        if (resumeInfo.hasUncommitted && !commitResumableWork(exec, lock)) {
+            return { ok: false, error: 'Could not commit in-progress work' };
+        }
+        if (!pushBranch(exec, resumeInfo.branch)) {
+            return { ok: false, error: 'Could not push branch' };
+        }
+        const prResult = createPr
+            ? await createPr(lock, resumeInfo.branch)
+            : undefined;
+        appendResumedProgress({ progressFs, projectRoot, lock }, prResult);
+        safeCheckout(exec, lock.targetBranch);
+        return { ok: true, prResult };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+// ─── Internal helpers ────────────────────────────────────────────────────────
+/** Get current branch, returning `undefined` on failure. */
+function safeCurrent(exec) {
+    try {
+        return currentBranch(exec);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Checkout a branch, returning `true` on success. */
+function safeCheckout(exec, branch) {
+    try {
+        checkout(exec, branch);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Inspect a branch for uncommitted and unpushed changes.
+ *
+ * Assumes the branch is already checked out.
+ */
+function inspectBranch(exec, branch, targetBranch) {
+    const uncommitted = safeHasUncommitted(exec);
+    const unpushed = hasUnpushedCommits(exec, branch, targetBranch);
+    return { hasUncommitted: uncommitted, hasUnpushed: unpushed };
+}
+/** Check for uncommitted changes, returning `false` on error. */
+function safeHasUncommitted(exec) {
+    try {
+        return hasUncommittedChanges(exec);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check for unpushed commits on a branch.
+ *
+ * First checks `origin/{branch}..{branch}`. If the remote branch
+ * doesn't exist, falls back to `origin/{targetBranch}..{branch}`.
+ */
+function hasUnpushedCommits(exec, branch, targetBranch) {
+    try {
+        const log = exec(['log', `origin/${branch}..${branch}`, '--oneline']);
+        return log.trim().length > 0;
+    }
+    catch {
+        try {
+            const log = exec([
+                'log',
+                `origin/${targetBranch}..${branch}`,
+                '--oneline',
+            ]);
+            return log.trim().length > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+/** Check progress file for an already-delivered ticket. */
+function checkAlreadyDelivered(opts, branch) {
+    const lastEntry = findLastEntry(opts.progressFs, opts.projectRoot, opts.lock.ticketKey);
+    if (lastEntry && DELIVERED_STATUSES.has(lastEntry.status)) {
+        return {
+            branch,
+            hasUncommitted: false,
+            hasUnpushed: false,
+            alreadyDelivered: true,
+        };
+    }
+    return undefined;
+}
+/** Commit in-progress work during resume. Returns `true` on success. */
+function commitResumableWork(exec, lock) {
+    try {
+        exec(['add', '-A']);
+        exec(['commit', '-m', `fix(${lock.ticketKey}): resume after crash`]);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Resolve parentKey from lock, treating empty/'none' as `undefined`. */
+function resolveParentKey(lock) {
+    return lock.parentKey && lock.parentKey !== 'none'
+        ? lock.parentKey
+        : undefined;
+}
+/** Append a RESUMED progress entry. */
+function appendResumedProgress(opts, prResult) {
+    appendProgress(opts.progressFs, opts.projectRoot, {
+        key: opts.lock.ticketKey,
+        summary: opts.lock.ticketTitle,
+        status: 'RESUMED',
+        prNumber: prResult?.ok ? prResult.number : undefined,
+        parent: resolveParentKey(opts.lock),
+    });
+}
+//# sourceMappingURL=resume.js.map

package/dist/dev/lifecycle/resume/resume.js.map

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

package/dist/dev/lifecycle/rework/rework-builders.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Platform-specific rework handler builders.
+ *
+ * Each builder wires a platform's PR API into the uniform
+ * {@link PlatformReworkHandlers} interface. Called exclusively by
+ * `resolvePlatformHandlers` in `rework-handlers.ts`.
+ */
+import type { PlatformReworkHandlers, ReworkCtx } from './rework-handlers.js';
+import type { AzdoRemote, BitbucketRemote, BitbucketServerRemote, GitHubRemote, GitLabRemote } from '../../../types/remote.js';
+/** Build rework handlers for GitHub. */
+export declare function githubHandlers(ctx: ReworkCtx, remote: GitHubRemote): PlatformReworkHandlers;
+/** Build rework handlers for GitLab. */
+export declare function gitlabHandlers(ctx: ReworkCtx, remote: GitLabRemote): PlatformReworkHandlers;
+/** Build rework handlers for Bitbucket Cloud. */
+export declare function bbCloudHandlers(ctx: ReworkCtx, remote: BitbucketRemote): PlatformReworkHandlers;
+/** Build rework handlers for Bitbucket Server. */
+export declare function bbServerHandlers(ctx: ReworkCtx, remote: BitbucketServerRemote): PlatformReworkHandlers;
+/** Build rework handlers for Azure DevOps. */
+export declare function azdoHandlers(ctx: ReworkCtx, remote: AzdoRemote): PlatformReworkHandlers;
+//# sourceMappingURL=rework-builders.d.ts.map

package/dist/dev/lifecycle/rework/rework-builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rework-builders.d.ts","sourceRoot":"","sources":["../../../../src/dev/lifecycle/rework/rework-builders.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,sBAAsB,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,YAAY,EACZ,YAAY,EACb,MAAM,qBAAqB,CAAC;AA+B7B,wCAAwC;AACxC,wBAAgB,cAAc,CAC5B,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,YAAY,GACnB,sBAAsB,CA4CxB;AAED,wCAAwC;AACxC,wBAAgB,cAAc,CAC5B,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,YAAY,GACnB,sBAAsB,CAyCxB;AAED,iDAAiD;AACjD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,eAAe,GACtB,sBAAsB,CAsCxB;AAED,kDAAkD;AAClD,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,qBAAqB,GAC5B,sBAAsB,CAqCxB;AAED,8CAA8C;AAC9C,wBAAgB,YAAY,CAC1B,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,UAAU,GACjB,sBAAsB,CAsCxB"}