@crewbie/cli 0.1.0-alpha.49

package/dist/config.js

@@ -0,0 +1,178 @@
+import { bounded, readJson, record, string, strings, slug, integer, safePath } from "./core.js";
+export const PLANNING_LABEL = "crewbie:ready-for-planning";
+export const RESTART_LABEL = "crewbie:restart";
+export const DEFAULT_LIMITS = { spec: 600, hot: 600, constitution: 600, topic: 1500 };
+export const DEFAULT_EXECUTION_LIMITS = { maxLaunchesPerBatch: 20, maxAttemptsPerTask: 3 };
+export const DEFAULT_MERGE = { method: "merge" };
+export function modelProfile(value) {
+    if (value !== "economy" && value !== "balanced" && value !== "quality")
+        throw new Error("Model profile must be economy, balanced or quality.");
+    return value;
+}
+export function mergeFor(config) { return config.merge ?? DEFAULT_MERGE; }
+/** The enabled reviewer of feature PRs and the model it runs with, or null when PR review is off. */
+export function reviewerFor(config) {
+    if (!config.review?.enabled)
+        return null;
+    const role = config.roles.find((role) => role.id === config.review?.role);
+    if (!role)
+        throw new Error(`review.role ${config.review.role} is not a configured role.`);
+    return { role: role.id, model: config.review.model ?? role.model };
+}
+export function limitsFor(config) { return config?.limits ?? DEFAULT_LIMITS; }
+export function isRoleContextPath(path) {
+    return /^(?:[A-Za-z0-9._ -]+\/)*[A-Za-z0-9._ -]+\.md$/i.test(path)
+        && !path.includes("..") && !path.toLowerCase().startsWith(".git/");
+}
+export function isExistingAgentPath(path) {
+    return /^(?:\.github\/agents\/[A-Za-z0-9._-]+\.agent\.md|\.claude\/agents\/[A-Za-z0-9._-]+\.md)$/.test(path)
+        && !path.includes("..") && !/\/crewbie-/i.test(path);
+}
+export function agentArchivePath(path) { return `.crewbie/agent-archive/${path.replace(/^\./, "")}`; }
+export function parseConfig(value) {
+    const data = record(value, "Configuration");
+    if (data.schemaVersion !== 1)
+        throw new Error("Unsupported configuration version.");
+    const repository = string(data.repository, "repository", true);
+    if (repository && !/^[A-Za-z0-9-]+\/[A-Za-z0-9_.-]+$/.test(repository))
+        throw new Error("repository must be owner/name.");
+    if (data.approvers !== undefined) {
+        const approvers = strings(data.approvers, "approvers");
+        if (approvers.some((login) => !/^[A-Za-z0-9-]+$/.test(login)))
+            throw new Error("Approvers must be GitHub user logins.");
+    }
+    if (!Array.isArray(data.roles) || !data.roles.length)
+        throw new Error("Define at least one role.");
+    const roles = data.roles.map((value) => {
+        const role = record(value, "role");
+        const result = { id: slug(role.id, "role id"), purpose: string(role.purpose, "role purpose"), model: string(role.model, "role model", true) };
+        if (result.model.trim().toLowerCase() === "auto")
+            throw new Error("Choose an explicit approved model, not auto.");
+        if (["coordinator", "improver"].includes(result.id))
+            throw new Error(`${result.id} is reserved for a framework role.`);
+        const guidance = {};
+        for (const key of ["checks", "nonNegotiables", "contextPaths"]) {
+            if (role[key] === undefined)
+                continue;
+            const entries = strings(role[key], `role ${key}`);
+            if (entries.length > 10 || entries.some((entry) => !entry.trim()))
+                throw new Error(`Role ${key} needs at most ten nonempty entries.`);
+            guidance[key] = entries;
+        }
+        const invalidPath = guidance.contextPaths?.find((path) => !isRoleContextPath(path));
+        if (invalidPath !== undefined) {
+            throw new Error(`Role ${result.id} contextPaths contains ${JSON.stringify(invalidPath)}; use repository-relative Markdown paths.`);
+        }
+        const sourceAgent = role.sourceAgent === undefined ? undefined : string(role.sourceAgent, "source agent");
+        if (sourceAgent !== undefined && !isExistingAgentPath(sourceAgent))
+            throw new Error(`Unsupported source agent: ${sourceAgent}`);
+        const complexity = role.complexity;
+        if (complexity !== undefined && complexity !== "routine" && complexity !== "standard" && complexity !== "complex")
+            throw new Error("Role complexity must be routine, standard or complex.");
+        return { ...result, ...guidance, ...(sourceAgent === undefined ? {} : { sourceAgent }),
+            ...(complexity === undefined ? {} : { complexity }),
+            ...(role.modelReason === undefined ? {} : { modelReason: string(role.modelReason, "model selection reason") }) };
+    });
+    if (new Set(roles.map((role) => role.id)).size !== roles.length)
+        throw new Error("Role IDs must be unique.");
+    const adopted = roles.flatMap((role) => role.sourceAgent ? [role.sourceAgent] : []);
+    if (new Set(adopted).size !== adopted.length)
+        throw new Error("Each existing agent can be adopted by only one Crewbie specialist.");
+    const nightly = record(data.nightly, "nightly");
+    if (typeof nightly.enabled !== "boolean")
+        throw new Error("nightly.enabled must be true or false.");
+    const allowedPaths = strings(nightly.allowedPaths, "nightly.allowedPaths");
+    for (const path of allowedPaths) {
+        const instruction = path === "AGENTS.md" || path === ".github/copilot-instructions.md" || /^\.github\/instructions\/[a-z0-9._-]+\.instructions\.md$/.test(path);
+        const constitutionPath = typeof data.constitution === "string" && path === data.constitution && path.endsWith(".md");
+        if ((!/^(?:\.crewbie\/(?:team|decisions)\/|\.crewbie\/(?:decisions|constitution|instructions)\.md$|\.github\/agents\/crewbie-[a-z0-9-]+\.agent\.md$)/.test(path) && !instruction && !constitutionPath) || path.includes("..") || path.includes("\\") || path.startsWith("/") || path.includes(":")) {
+            throw new Error(`Nightly path is not a supported managed memory/profile path: ${path}`);
+        }
+    }
+    const constitution = data.constitution === null ? null : string(data.constitution, "constitution");
+    if (constitution && !constitution.endsWith(".md"))
+        throw new Error("The constitution must reference a Markdown document.");
+    const adoData = data.ado === null ? null : record(data.ado, "ado");
+    const ado = adoData === null ? null : {
+        organization: string(adoData.organization, "ADO organization"),
+        project: string(adoData.project, "ADO project"),
+        workItemType: string(adoData.workItemType, "ADO work item type"),
+    };
+    if (ado && !/^[A-Za-z0-9-]+$/.test(ado.organization))
+        throw new Error("Use an ADO organization name, not a URL.");
+    const rawLimits = data.limits === undefined ? {} : record(data.limits, "word limits");
+    const limits = Object.fromEntries(Object.entries(DEFAULT_LIMITS).map(([key, fallback]) => [key, integer(rawLimits[key] ?? fallback, `${key} word limit`, 1, 10000)]));
+    if (rawLimits.pr !== undefined)
+        limits.pr = integer(rawLimits.pr, "pr word limit", 1, 10000);
+    let planning;
+    if (data.planning !== undefined) {
+        const value = record(data.planning, "planning");
+        if (typeof value.enabled !== "boolean")
+            throw new Error("planning.enabled must be true or false.");
+        const model = string(value.model, "planning.model", !value.enabled);
+        if (model && (!/^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}$/.test(model) || model.toLowerCase() === "auto"))
+            throw new Error("Choose an explicit planning model identifier, not auto.");
+        if (value.executeOnMerge !== undefined && typeof value.executeOnMerge !== "boolean")
+            throw new Error("planning.executeOnMerge must be true or false.");
+        if (value.executeOnMerge === true && !value.enabled)
+            throw new Error("Enable planning before opting into execution on merge.");
+        planning = { enabled: value.enabled, model, ...(value.executeOnMerge === undefined ? {} : { executeOnMerge: value.executeOnMerge }) };
+    }
+    const execution = data.execution === undefined ? undefined : record(data.execution, "execution limits");
+    let merge;
+    if (data.merge !== undefined) {
+        const value = record(data.merge, "merge");
+        const method = value.method ?? DEFAULT_MERGE.method;
+        if (method !== "merge" && method !== "squash" && method !== "rebase")
+            throw new Error("merge.method must be merge, squash or rebase.");
+        // Legacy merge.mode and merge.minConfidence are ignored: task PRs always merge into the feature branch.
+        merge = { method };
+    }
+    let review;
+    if (data.review !== undefined) {
+        const value = record(data.review, "review");
+        if (typeof value.enabled !== "boolean")
+            throw new Error("review.enabled must be true or false.");
+        const role = slug(value.role, "review.role");
+        if (value.enabled && !roles.some((item) => item.id === role))
+            throw new Error(`review.role ${role} is not a configured role.`);
+        const model = value.model === undefined ? undefined : string(value.model, "review.model");
+        if (model !== undefined && (!/^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}$/.test(model) || model.toLowerCase() === "auto"))
+            throw new Error("Choose an explicit review model identifier, not auto.");
+        review = { enabled: value.enabled, role, ...(model === undefined ? {} : { model }) };
+    }
+    let local;
+    if (data.local !== undefined) {
+        const value = record(data.local, "local");
+        const start = string(value.start, "local.start");
+        bounded(start, 120, "local.start");
+        local = { start };
+    }
+    return {
+        schemaVersion: 1, repository, roles, constitution,
+        maxActive: integer(data.maxActive, "maxActive", 1, 20),
+        nightly: { enabled: nightly.enabled, maxRecords: integer(nightly.maxRecords, "maxRecords", 1, 100), allowedPaths },
+        ado, limits, ...(planning ? { planning } : {}),
+        ...(data.modelProfile === undefined ? {} : { modelProfile: modelProfile(data.modelProfile) }),
+        ...(execution === undefined ? {} : { execution: {
+                maxLaunchesPerBatch: integer(execution.maxLaunchesPerBatch, "maximum launches per batch", 1, 1000),
+                maxAttemptsPerTask: integer(execution.maxAttemptsPerTask, "maximum attempts per task", 1, 100),
+            } }),
+        ...(merge ? { merge } : {}),
+        ...(review ? { review } : {}),
+        ...(local ? { local } : {}),
+    };
+}
+export async function loadConfig(root) {
+    const config = parseConfig(await readJson(await safePath(root, ".crewbie/config.json")));
+    if (config.constitution)
+        await safePath(root, config.constitution);
+    return config;
+}
+export function requireExecution(config) {
+    if (!config.repository)
+        throw new Error("Configure a repository before remote writes.");
+    if (config.roles.some((role) => !role.model.trim()))
+        throw new Error("Approve an explicit model for every specialist before execution.");
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/core.d.ts

@@ -0,0 +1,31 @@
+export declare class GitHubError extends Error {
+    readonly status: number;
+    readonly requestId: string | null;
+    constructor(status: number, requestId: string | null);
+}
+export declare function record(value: unknown, name: string): Record<string, unknown>;
+export declare function string(value: unknown, name: string, allowEmpty?: boolean): string;
+export declare function strings(value: unknown, name: string): string[];
+export declare function integer(value: unknown, name: string, min?: number, max?: number): number;
+export declare function slug(value: unknown, name: string): string;
+export declare function hash(value: string): string;
+export declare function textHash(value: string): string;
+export declare function matchesTextHash(value: string, digest: unknown): boolean;
+export declare function json(value: unknown): string;
+export declare function words(value: string): number;
+export declare function bounded(value: string, limit: number, name: string): void;
+export declare const AGENT_PROMPT_CHARACTERS = 30000;
+export declare function agentPromptLength(profile: string): number;
+export declare function agentPrompt(profile: string, name: string, remedy?: string): void;
+export declare function errorCode(error: unknown, code: string): boolean;
+export declare function optionalText(path: string): Promise<string | null>;
+export declare function readJson(path: string): Promise<unknown>;
+/**
+ * Parses a model's JSON answer without another paid request, tolerating the prose preambles and Markdown fences
+ * models add despite "return only JSON": bare JSON, else the last fenced block holding an object, else the last
+ * balanced top-level object in the text. The caller still validates the value's shape.
+ */
+export declare function modelJson(output: string, name: string): unknown;
+/** Reject traversal and symlink parents before reading or changing repository files. */
+export declare function safePath(root: string, file: string): Promise<string>;
+export declare function writeAtomic(root: string, file: string, content: string): Promise<void>;

package/dist/core.js

@@ -0,0 +1,186 @@
+import { createHash } from "node:crypto";
+import { lstat, mkdir, readFile, realpath, rename, writeFile } from "node:fs/promises";
+import { dirname, isAbsolute, relative, resolve, sep } from "node:path";
+export class GitHubError extends Error {
+    status;
+    requestId;
+    constructor(status, requestId) {
+        const advice = status === 401 ? "Authenticate with a user-authorized GitHub credential."
+            : status === 403 ? "Check repository permissions, policy, and rate limits."
+                : status === 404 ? "Check the repository, branch, profile, and token access."
+                    : status === 429 ? "Wait for the rate limit to reset before retrying."
+                        : "Check GitHub availability and the documented preview interface.";
+        super(`GitHub HTTP ${status}. ${advice}${requestId ? ` Request: ${requestId}.` : ""}`);
+        this.status = status;
+        this.requestId = requestId;
+        this.name = "GitHubError";
+    }
+}
+export function record(value, name) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error(`${name} must be an object.`);
+    return value;
+}
+export function string(value, name, allowEmpty = false) {
+    if (typeof value !== "string" || (!allowEmpty && !value.trim()))
+        throw new Error(`${name} must be text${allowEmpty ? "" : " and cannot be empty"}.`);
+    return value;
+}
+export function strings(value, name) {
+    if (!Array.isArray(value))
+        throw new Error(`${name} must be a list.`);
+    return value.map((item) => string(item, name));
+}
+export function integer(value, name, min = 1, max = Number.MAX_SAFE_INTEGER) {
+    if (!Number.isSafeInteger(value) || Number(value) < min || Number(value) > max)
+        throw new Error(`${name} must be an integer from ${min} to ${max}.`);
+    return Number(value);
+}
+export function slug(value, name) {
+    const result = string(value, name);
+    if (!/^[a-z][a-z0-9-]{0,63}$/.test(result))
+        throw new Error(`${name} must start with a letter and contain only lowercase letters, digits, and hyphens.`);
+    return result;
+}
+export function hash(value) {
+    return createHash("sha256").update(value).digest("hex");
+}
+export function textHash(value) {
+    return hash(value.replaceAll("\r\n", "\n"));
+}
+export function matchesTextHash(value, digest) {
+    const lf = value.replaceAll("\r\n", "\n");
+    // Accept pre-normalization manifests and proposals from either checkout style.
+    return digest === hash(lf) || digest === hash(value) || digest === hash(lf.replaceAll("\n", "\r\n"));
+}
+export function json(value) {
+    return JSON.stringify(value, null, 2) + "\n";
+}
+export function words(value) {
+    return value.trim() ? value.trim().split(/\s+/u).length : 0;
+}
+export function bounded(value, limit, name) {
+    if (words(value) > limit)
+        throw new Error(`${name} exceeds ${limit} words. Curate or split it; nothing was truncated.`);
+}
+// GitHub's documented maximum for a custom agent's Markdown prompt below the frontmatter:
+// https://docs.github.com/en/copilot/reference/custom-agents-configuration
+export const AGENT_PROMPT_CHARACTERS = 30_000;
+export function agentPromptLength(profile) {
+    const text = profile.replace(/^\uFEFF/, "");
+    const header = /^---\r?\n[\s\S]*?\r?\n---(?:\r?\n|$)/.exec(text);
+    return (header ? text.slice(header[0].length) : text).length;
+}
+export function agentPrompt(profile, name, remedy = "Shorten it; nothing was truncated.") {
+    const length = agentPromptLength(profile);
+    if (length > AGENT_PROMPT_CHARACTERS)
+        throw new Error(`${name} prompt has ${length} characters; GitHub custom agents allow at most ${AGENT_PROMPT_CHARACTERS}. ${remedy}`);
+}
+export function errorCode(error, code) {
+    return error instanceof Error && "code" in error && error.code === code;
+}
+export async function optionalText(path) {
+    try {
+        return await readFile(path, "utf8");
+    }
+    catch (error) {
+        if (errorCode(error, "ENOENT"))
+            return null;
+        throw error;
+    }
+}
+export async function readJson(path) {
+    return JSON.parse(await readFile(path, "utf8"));
+}
+/**
+ * Parses a model's JSON answer without another paid request, tolerating the prose preambles and Markdown fences
+ * models add despite "return only JSON": bare JSON, else the last fenced block holding an object, else the last
+ * balanced top-level object in the text. The caller still validates the value's shape.
+ */
+export function modelJson(output, name) {
+    const text = output.replace(/^\uFEFF/, "").trim();
+    if (!text)
+        throw new SyntaxError(`${name} is empty.`);
+    const parse = (candidate) => {
+        try {
+            const value = JSON.parse(candidate);
+            return typeof value === "object" && value !== null && !Array.isArray(value) ? value : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    };
+    const whole = parse(text);
+    if (whole)
+        return whole;
+    const fenced = [...text.matchAll(/```[a-zA-Z0-9_-]*[ \t]*\r?\n([\s\S]*?)\r?\n[ \t]*```/g)].map((match) => parse(match[1].trim())).filter((value) => value !== undefined);
+    if (fenced.length)
+        return fenced.at(-1);
+    const objects = [];
+    let unclosed = false;
+    for (let start = text.indexOf("{"); start !== -1; start = text.indexOf("{", start + 1)) {
+        let depth = 0, quoted = false, escaped = false, end = -1;
+        for (let index = start; index < text.length && end === -1; index++) {
+            const char = text[index];
+            if (quoted) {
+                if (escaped)
+                    escaped = false;
+                else if (char === "\\")
+                    escaped = true;
+                else if (char === "\"")
+                    quoted = false;
+            }
+            else if (char === "\"")
+                quoted = true;
+            else if (char === "{")
+                depth++;
+            else if (char === "}" && --depth === 0)
+                end = index;
+        }
+        if (end === -1) {
+            unclosed = true;
+            break;
+        }
+        const value = parse(text.slice(start, end + 1));
+        if (value) {
+            objects.push(value);
+            start = end;
+        }
+    }
+    if (objects.length)
+        return objects.at(-1);
+    throw new SyntaxError(`${name} contains no complete JSON object${unclosed ? "; an object opens but never closes, so the output looks truncated" : ""}.`);
+}
+/** Reject traversal and symlink parents before reading or changing repository files. */
+export async function safePath(root, file) {
+    if (!file || isAbsolute(file) || /^[A-Za-z]:/.test(file) || file.includes("\0"))
+        throw new Error(`Unsafe repository path: ${file}`);
+    const base = await realpath(root);
+    const target = resolve(base, file.replaceAll("\\", sep).replaceAll("/", sep));
+    const rel = relative(base, target);
+    if (!rel || rel.startsWith(`..${sep}`) || rel === ".." || isAbsolute(rel))
+        throw new Error(`Path leaves repository: ${file}`);
+    if (rel.split(sep).some((part) => part.toLowerCase() === ".git"))
+        throw new Error("Crewbie does not read or write Git internals through repository paths.");
+    let current = base;
+    for (const part of rel.split(sep)) {
+        current = resolve(current, part);
+        try {
+            if ((await lstat(current)).isSymbolicLink())
+                throw new Error(`Symlinks are not allowed in managed paths: ${file}`);
+        }
+        catch (error) {
+            if (!errorCode(error, "ENOENT"))
+                throw error;
+        }
+    }
+    return target;
+}
+export async function writeAtomic(root, file, content) {
+    const target = await safePath(root, file);
+    await mkdir(dirname(target), { recursive: true });
+    const temporary = `${target}.${process.pid}.${crypto.randomUUID()}.tmp`;
+    await writeFile(temporary, content, { flag: "wx" });
+    await rename(temporary, target);
+}
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

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

package/dist/execution/attribution.d.ts

@@ -0,0 +1,10 @@
+import type { Config } from "../config.js";
+import type { GitHubApi } from "../tracking/github.js";
+export declare function attributedBody(body: string, specialist: string, model: string, taskUrl: string, issue?: number, usage?: string): string;
+export declare function attributePull(client: GitHubApi, config: Config, pr: Record<string, unknown>, task: Record<string, unknown>, owner: string, model: string, issue?: number): Promise<void>;
+export declare function specialistNote(edits: readonly {
+    editor: string | null;
+    body: string;
+}[], profile: string): string | null;
+/** The specialist's description replaces Copilot's summary; Copilot's suffix block is kept. */
+export declare function restoredBody(note: string, body: string): string;

package/dist/execution/attribution.js

@@ -0,0 +1,102 @@
+import { integer, record, string } from "../core.js";
+import { collectPrUsage, renderPrUsage } from "../reporting/pr-usage.js";
+export function attributedBody(body, specialist, model, taskUrl, issue, usage) {
+    const start = "<!-- crewbie-attribution -->", end = "<!-- /crewbie-attribution -->";
+    const blocks = [...body.matchAll(/<!-- crewbie-attribution -->[\s\S]*?<!-- \/crewbie-attribution -->/g)];
+    if (blocks.length > 1 || (body.includes(start) !== body.includes(end)) || (body.includes(start) && !blocks.length)) {
+        throw new Error("PR attribution markers are ambiguous; reconcile the description.");
+    }
+    const attribution = `${start}\n**Specialist:** \`${specialist}\` | **Requested model:** \`${model}\`\n[GitHub-confirmed specialist task](${taskUrl})${issue === undefined ? "" : `\nCloses #${integer(issue, "execution issue")}`}${usage ? `\n\n${usage}` : ""}\n${end}`;
+    return blocks[0] ? body.replace(blocks[0][0], attribution) : `${attribution}\n\n${body}`;
+}
+export async function attributePull(client, config, pr, task, owner, model, issue) {
+    const profile = `crewbie-${owner}`;
+    if (!task.custom_agent || record(task.custom_agent, "native profile").id !== profile) {
+        throw new Error(`PR #${pr.number}: GitHub did not confirm ${profile}; attribution was not invented.`);
+    }
+    const id = string(task.id, "native task ID");
+    if (!/^[a-zA-Z0-9-]+$/.test(id))
+        throw new Error("Invalid native task ID.");
+    const number = integer(pr.number, "PR number");
+    const body = typeof pr.body === "string" ? pr.body : "";
+    const usage = typeof task.session_count === "number" ? renderPrUsage(await collectPrUsage(client, config.repository, pr))
+        : "**Observed tokens:** unavailable. **AI credits:** unavailable. Native session metadata was not exposed.";
+    let note = null;
+    try {
+        note = specialistNote(await prEdits(client, config, number), profile);
+    }
+    catch (error) {
+        console.warn(`Crewbie: specialist description for PR #${number} could not be recovered: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const restore = note !== null && note.length <= 60_000 && !body.includes(note);
+    const attributed = (text) => attributedBody(text, profile, model, `https://github.com/${config.repository}/tasks/${id}`, issue, usage);
+    let after = attributed(restore ? restoredBody(note, body) : body);
+    if (after === body)
+        return;
+    const path = `/repos/${config.repository}/pulls/${number}`;
+    const fresh = record(await client.request("GET", path), "fresh PR");
+    if (fresh.body !== pr.body || record(fresh.head, "fresh head").sha !== record(pr.head, "expected head").sha || fresh.state !== "open") {
+        throw new Error("PR changed before attribution; reconcile again rather than overwriting it.");
+    }
+    if (restore) {
+        try {
+            await keepCopilotSummary(client, config, number, id, body);
+        }
+        catch (error) {
+            console.warn(`Crewbie: kept Copilot's summary on PR #${number} because it could not be saved as a comment: ${error instanceof Error ? error.message : String(error)}`);
+            after = attributed(body);
+            if (after === body)
+                return;
+        }
+    }
+    const updated = record(await client.request("PATCH", path, { body: after }), "updated PR");
+    if (updated.body !== after)
+        throw new Error("GitHub did not confirm specialist attribution.");
+}
+const COPILOT_EDITOR = "copilot-swe-agent";
+const SUFFIX = "<!-- START COPILOT CODING AGENT SUFFIX -->";
+const ATTRIBUTION = /<!-- crewbie-attribution -->[\s\S]*?<!-- \/crewbie-attribution -->\s*/g;
+// The cloud agent's final summary replaces the specialist's own PR description; recover the specialist's last version.
+export function specialistNote(edits, profile) {
+    const marker = new RegExp(`^\\s*(?:\\*\\*)?Specialist:(?:\\*\\*)?\\s*\`?${profile.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\`?`, "m");
+    for (const edit of edits) {
+        if (edit.editor !== COPILOT_EDITOR || edit.body.includes("<!-- crewbie-attribution -->") || !marker.test(edit.body))
+            continue;
+        const note = edit.body.split(SUFFIX)[0].trim();
+        return note.length ? note : null;
+    }
+    return null;
+}
+/** The specialist's description replaces Copilot's summary; Copilot's suffix block is kept. */
+export function restoredBody(note, body) {
+    const suffix = body.indexOf(SUFFIX);
+    return suffix < 0 ? note : `${note}\n\n${body.slice(suffix)}`;
+}
+async function prEdits(client, config, number) {
+    const [owner, name] = config.repository.split("/");
+    const result = record(await client.request("POST", "/graphql", {
+        query: "query($owner:String!,$name:String!,$number:Int!){repository(owner:$owner,name:$name){pullRequest(number:$number){userContentEdits(first:50){nodes{editor{login} diff}}}}}",
+        variables: { owner, name, number },
+    }), "PR edit history");
+    const nodes = record(record(record(record(result.data, "GraphQL data").repository, "repository").pullRequest, "pull request").userContentEdits, "PR edits").nodes;
+    if (!Array.isArray(nodes))
+        throw new Error("GitHub returned no PR edit history.");
+    return nodes.map((raw) => {
+        const node = record(raw, "PR edit");
+        const editor = node.editor === null ? null : record(node.editor, "PR editor").login;
+        return { editor: typeof editor === "string" ? editor : null, body: typeof node.diff === "string" ? node.diff : "" };
+    });
+}
+async function keepCopilotSummary(client, config, number, taskId, body) {
+    const tag = `<!-- crewbie-copilot-summary:${taskId} -->`;
+    const comments = await client.list(`/repos/${config.repository}/issues/${number}/comments`);
+    if (comments.some((comment) => typeof comment.body === "string" && comment.body.includes(tag)))
+        return;
+    const summary = body.split(SUFFIX)[0].replace(ATTRIBUTION, "").trim();
+    if (!summary)
+        return;
+    await client.request("POST", `/repos/${config.repository}/issues/${number}/comments`, {
+        body: `${tag}\n**Copilot's final session summary.** Crewbie restored the specialist's own description as the PR body:\n\n${summary.split("\n").map((line) => `> ${line}`).join("\n")}`,
+    });
+}
+//# sourceMappingURL=attribution.js.map

package/dist/execution/attribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribution.js","sourceRoot":"","sources":["../../src/execution/attribution.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzE,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,UAAkB,EAAE,KAAa,EAAE,OAAe,EAAE,KAAc,EAAE,KAAc;IAC7H,MAAM,KAAK,GAAG,8BAA8B,EAAE,GAAG,GAAG,+BAA+B,CAAC;IACpF,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,qEAAqE,CAAC,CAAC,CAAC;IACzG,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACnH,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACtF,CAAC;IACD,MAAM,WAAW,GAAG,GAAG,KAAK,uBAAuB,UAAU,+BAA+B,KAAK,0CAA0C,OAAO,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,OAAO,CAAC,KAAK,EAAE,iBAAiB,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,EAAE,CAAC;IAC1Q,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,OAAO,IAAI,EAAE,CAAC;AAC3F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAiB,EAAE,MAAc,EAAE,EAA2B,EAAE,IAA6B,EAAE,KAAa,EAAE,KAAa,EAAE,KAAc;IAC7K,MAAM,OAAO,GAAG,WAAW,KAAK,EAAE,CAAC;IACnC,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC,EAAE,KAAK,OAAO,EAAE,CAAC;QACrF,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,MAAM,4BAA4B,OAAO,iCAAiC,CAAC,CAAC;IACxG,CAAC;IACD,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;IAC7C,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5E,MAAM,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,MAAM,KAAK,GAAG,OAAO,IAAI,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACvH,CAAC,CAAC,yGAAyG,CAAC;IAC9G,IAAI,IAAI,GAAkB,IAAI,CAAC;IAC/B,IAAI,CAAC;QAAC,IAAI,GAAG,cAAc,CAAC,MAAM,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;IAAC,CAAC;IAC9E,OAAO,KAAK,EAAE,CAAC;QAAC,OAAO,CAAC,IAAI,CAAC,2CAA2C,MAAM,4BAA4B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAAC,CAAC;IACtK,MAAM,OAAO,GAAG,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,MAAM,IAAI,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC/E,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,sBAAsB,MAAM,CAAC,UAAU,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAC/I,IAAI,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,IAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACnE,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO;IAC3B,MAAM,IAAI,GAAG,UAAU,MAAM,CAAC,UAAU,UAAU,MAAM,EAAE,CAAC;IAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC;IACpE,IAAI,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,GAAG,KAAK,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;QACtI,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAC;IAChG,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,CAAC;YAAC,MAAM,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QAAC,CAAC;QACnE,OAAO,KAAK,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,0CAA0C,MAAM,gDAAgD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACvK,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;YACzB,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAO;QAC7B,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,YAAY,CAAC,CAAC;IAC3F,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;AAChG,CAAC;AAED,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAC3C,MAAM,MAAM,GAAG,4CAA4C,CAAC;AAC5D,MAAM,WAAW,GAAG,wEAAwE,CAAC;AAE7F,uHAAuH;AACvH,MAAM,UAAU,cAAc,CAAC,KAAyD,EAAE,OAAe;IACvG,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,gDAAgD,OAAO,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpI,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,MAAM,KAAK,cAAc,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,8BAA8B,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,SAAS;QAC9H,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACnC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,IAAY;IACrD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,OAAO,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;AAChE,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,MAAiB,EAAE,MAAc,EAAE,MAAc;IACtE,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE;QAC7D,KAAK,EAAE,2KAA2K;QAClL,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE;KACnC,CAAC,EAAE,iBAAiB,CAAC,CAAC;IACvB,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC,KAAK,CAAC;IAClK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IAClF,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,KAAK,CAAC;QACpF,OAAO,EAAE,MAAM,EAAE,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACtH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,MAAiB,EAAE,MAAc,EAAE,MAAc,EAAE,MAAc,EAAE,IAAY;IAC/G,MAAM,GAAG,GAAG,gCAAgC,MAAM,MAAM,CAAC;IACzD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,UAAU,WAAW,MAAM,WAAW,CAAC,CAAC;IAC5F,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAAE,OAAO;IACvG,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACvE,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,MAAM,CAAC,UAAU,WAAW,MAAM,WAAW,EAAE;QACpF,IAAI,EAAE,GAAG,GAAG,+GAA+G,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;KACvL,CAAC,CAAC;AACL,CAAC"}

package/dist/execution/cancel.d.ts

@@ -0,0 +1,3 @@
+import type { Config } from "../config.js";
+import { type GitHubApi } from "../tracking/github.js";
+export declare function cancelRun(client: GitHubApi, config: Config, issueNumber: number, runId: number, apply: boolean): Promise<string>;

package/dist/execution/cancel.js

@@ -0,0 +1,59 @@
+import { GitHubError, integer, record, string } from "../core.js";
+import { taskMetadata } from "../specification/batch.js";
+import { requireWriter } from "../tracking/github.js";
+import { linkedPull } from "./dispatch.js";
+import { withDispatchLock } from "./controls.js";
+export async function cancelRun(client, config, issueNumber, runId, apply) {
+    integer(issueNumber, "issue");
+    integer(runId, "run ID");
+    const prefix = `/repos/${config.repository}`;
+    const inspect = async () => {
+        const issue = record(await client.request("GET", `${prefix}/issues/${issueNumber}`), "execution issue");
+        const metadata = taskMetadata(string(issue.body, "issue body"));
+        if (!metadata)
+            throw new Error("Cancellation requires a Crewbie execution issue.");
+        const pr = await linkedPull(client, config.repository, issueNumber, metadata.branch);
+        if (!pr)
+            throw new Error("No unambiguous linked Copilot PR. Use GitHub's session viewer to stop the session manually.");
+        const run = record(await client.request("GET", `${prefix}/actions/runs/${runId}`), "agent run");
+        const head = record(pr.head, "PR head");
+        if (run.event !== "dynamic" || record(run.repository, "run repository").full_name !== config.repository
+            || record(head.repo, "PR repository").full_name !== config.repository || run.head_branch !== head.ref
+            || !Array.isArray(run.pull_requests) || !run.pull_requests.some((raw) => record(raw, "run PR").id === pr.id)) {
+            throw new Error("Run is not an attributable cloud-agent run for this issue. No cancellation requested.");
+        }
+        return run;
+    };
+    const run = await inspect();
+    const url = `https://github.com/${config.repository}/actions/runs/${runId}`;
+    if (run.status === "completed")
+        return `Run already completed (${String(run.conclusion)}). Nothing cancelled; inspect preserved work. ${url}`;
+    if (!apply)
+        return `Preview: request cancellation of cloud-agent run ${runId} for issue #${issueNumber}. Commits, approvals and consumed launch allowances remain. This does not pause future launches. ${url}\nRepeat with --apply.`;
+    await requireWriter(client, config.repository);
+    return withDispatchLock(client, config, async () => {
+        const fresh = await inspect();
+        if (fresh.status === "completed")
+            return "Run completed before cancellation; nothing cancelled.";
+        if (fresh.run_attempt !== run.run_attempt)
+            throw new Error("Run attempt changed; preview cancellation again.");
+        try {
+            await client.request("POST", `${prefix}/actions/runs/${runId}/cancel`);
+        }
+        catch (error) {
+            const reason = error instanceof GitHubError ? `HTTP ${error.status}` : error instanceof Error ? error.message : "unknown request outcome";
+            throw new Error(`Cancellation was not confirmed (${reason}); inspect the run before retrying. This backend or credential may not support it. Use Stop session in GitHub's session viewer. No force-cancel, replacement or refund was attempted. ${url}`);
+        }
+        let result;
+        try {
+            result = record(await client.request("GET", `${prefix}/actions/runs/${runId}`), "cancellation status");
+        }
+        catch (error) {
+            throw new Error(`Cancellation requested, but verification failed. Inspect ${url} before retrying. ${error instanceof Error ? error.message : "Status unavailable."}`);
+        }
+        return result.status === "completed" && result.conclusion === "cancelled"
+            ? `Actions run cancellation confirmed. Commits and launch claims are preserved; verify native session termination before replacement. ${url}`
+            : `Cancellation requested, not confirmed. Do not assume the agent has stopped or spending has ended. Inspect ${url}; no replacement was started.`;
+    });
+}
+//# sourceMappingURL=cancel.js.map