@crewbie/cli 0.1.0-alpha.49

package/dist/reporting/pr-usage.js

@@ -0,0 +1,179 @@
+import { execFileSync } from "node:child_process";
+import { GitHubError, integer, record, string } from "../core.js";
+import { cloudTasks } from "../tracking/native.js";
+export class UsageUnavailable extends Error {
+}
+export function parseUsageLog(log) {
+    const sessions = new Set([...log.matchAll(/\bCOPILOT_AGENT_SESSION_ID:\s*([a-f0-9-]{36})\b/g)].map((match) => match[1]));
+    if (sessions.size !== 1)
+        return null;
+    const turns = new Map();
+    for (const match of log.matchAll(/\[cca-engine\] turn=(\d+) assistant\.usage: model=\S+ input=(\d+) output=(\d+)(?=\s|$)/g)) {
+        const value = { input: integer(Number(match[2]), "input tokens", 0, Number.MAX_SAFE_INTEGER), output: integer(Number(match[3]), "output tokens", 0, Number.MAX_SAFE_INTEGER) };
+        const prior = turns.get(match[1]);
+        if (prior && (prior.input !== value.input || prior.output !== value.output))
+            return null;
+        turns.set(match[1], value);
+    }
+    if (!turns.size)
+        return null;
+    if ([...turns.keys()].some((turn) => Number(turn) < 1 || Number(turn) > turns.size))
+        return null;
+    const total = [...turns.values()].reduce((sum, turn) => ({ input: sum.input + turn.input, output: sum.output + turn.output }), { input: 0, output: 0 });
+    if (!Number.isSafeInteger(total.input) || !Number.isSafeInteger(total.output))
+        throw new Error("Token totals exceed safe integer limits.");
+    return { sessionId: [...sessions][0], inputTokens: total.input, outputTokens: total.output };
+}
+function actionsLog(repository, runId) {
+    try {
+        return execFileSync("gh", ["run", "view", String(runId), "--repo", repository, "--log"], {
+            encoding: "utf8", stdio: ["ignore", "pipe", "pipe"], timeout: 60_000, maxBuffer: 8_000_000, windowsHide: true,
+        });
+    }
+    catch {
+        throw new UsageUnavailable("Actions logs could not be read within the time/size limit; check gh access and log retention.");
+    }
+}
+export async function collectPrUsage(client, repository, pr, readLog = actionsLog) {
+    const result = { sessions: 0, measuredSessions: 0, inputTokens: null, outputTokens: null, credits: null, sources: [], warnings: [], actionsMinutes: null, actionsRuns: 0 };
+    const head = string(record(pr.head, "PR head").ref, "PR branch");
+    try {
+        await actionsTime(client, repository, head, result);
+    }
+    catch (error) {
+        if (!(error instanceof GitHubError && [403, 404, 410].includes(error.status)))
+            throw error;
+        result.warnings.push(`Actions run time is unavailable (HTTP ${error.status}).`);
+    }
+    try {
+        const native = await cloudTasks(client, repository);
+        if (native.warning) {
+            result.warnings.push(native.warning);
+            return result;
+        }
+        const sessions = new Set();
+        for (const task of native.tasks) {
+            if (!Array.isArray(task.artifacts) || !task.artifacts.some((raw) => {
+                const artifact = record(raw, "task artifact");
+                return artifact.provider === "github" && artifact.type === "pull" && record(artifact.data, "pull artifact").id === pr.id;
+            }))
+                continue;
+            const id = string(task.id, "task ID");
+            if (!/^[a-zA-Z0-9-]+$/.test(id))
+                throw new Error("Invalid native task ID.");
+            const detail = record(await client.request("GET", `/agents/repos/${repository}/tasks/${id}`), "native task");
+            if (!Array.isArray(detail.sessions)) {
+                result.warnings.push("Native session detail is unavailable.");
+                continue;
+            }
+            if (detail.session_count !== detail.sessions.length)
+                result.warnings.push("Native session coverage is incomplete.");
+            for (const raw of detail.sessions) {
+                const session = record(raw, "native session");
+                const sessionId = string(session.id, "session ID");
+                if (sessions.has(sessionId))
+                    throw new Error("Duplicate native session would double-count usage.");
+                sessions.add(sessionId);
+            }
+        }
+        result.sessions = sessions.size;
+        if (!sessions.size) {
+            result.warnings.push("No attributable native sessions found.");
+            return result;
+        }
+        const measured = new Set(), runs = new Set();
+        for (let page = 1; page <= 100; page++) {
+            const response = record(await client.request("GET", `/repos/${repository}/actions/runs?event=dynamic&branch=${encodeURIComponent(head)}&per_page=100&page=${page}`), "Actions runs");
+            if (!Array.isArray(response.workflow_runs))
+                throw new Error("Actions returned invalid run coverage.");
+            for (const raw of response.workflow_runs) {
+                const run = record(raw, "Actions run");
+                // Copilot session runs carry no pull_requests link; the branch query attributes them and the log's session ID verifies it.
+                const pulls = Array.isArray(run.pull_requests) ? run.pull_requests : [];
+                if (pulls.length ? !pulls.some((pull) => record(pull, "run pull request").id === pr.id) : run.head_branch !== head)
+                    continue;
+                const id = integer(run.id, "Actions run");
+                if (runs.has(id))
+                    throw new Error("Actions pagination repeated a run.");
+                runs.add(id);
+                if (run.status !== "completed")
+                    continue;
+                let usage;
+                try {
+                    usage = parseUsageLog(readLog(repository, id));
+                }
+                catch (error) {
+                    if (!(error instanceof UsageUnavailable))
+                        throw error;
+                    result.warnings.push(error.message);
+                    continue;
+                }
+                if (!usage || !sessions.has(usage.sessionId)) {
+                    result.warnings.push(`Run ${id} has no verifiable session-token record.`);
+                    continue;
+                }
+                if (measured.has(usage.sessionId)) {
+                    result.warnings.push("Multiple runs reference one session; repeated session usage was excluded.");
+                    continue;
+                }
+                measured.add(usage.sessionId);
+                result.measuredSessions = measured.size;
+                result.inputTokens = (result.inputTokens ?? 0) + usage.inputTokens;
+                result.outputTokens = (result.outputTokens ?? 0) + usage.outputTokens;
+                if (!Number.isSafeInteger(result.inputTokens + result.outputTokens))
+                    throw new Error("PR token totals exceed safe integer limits.");
+                result.sources.push(`https://github.com/${repository}/actions/runs/${id}`);
+            }
+            if (response.workflow_runs.length < 100)
+                break;
+            if (page === 100)
+                result.warnings.push("Actions run coverage exceeded the pagination bound.");
+        }
+        if (measured.size !== sessions.size)
+            result.warnings.push("Some native sessions have missing, unsupported or pending logs.");
+        result.warnings.push("AI-credit amount scaling is undocumented in the task API; credits are not inferred from tokens or legacy multipliers.");
+        return result;
+    }
+    catch (error) {
+        if (error instanceof GitHubError && [403, 404, 410].includes(error.status)) {
+            result.warnings.push(`Usage coverage is unavailable (HTTP ${error.status}).`);
+            return result;
+        }
+        throw error;
+    }
+}
+const RUN_PAGES = 10;
+async function actionsTime(client, repository, head, result) {
+    let milliseconds = 0;
+    const seen = new Set();
+    for (let page = 1; page <= RUN_PAGES; page++) {
+        const response = record(await client.request("GET", `/repos/${repository}/actions/runs?branch=${encodeURIComponent(head)}&status=completed&per_page=100&page=${page}`), "Actions runs");
+        if (!Array.isArray(response.workflow_runs))
+            throw new Error("Actions returned invalid run coverage.");
+        for (const raw of response.workflow_runs) {
+            const run = record(raw, "Actions run");
+            const id = integer(run.id, "Actions run");
+            if (seen.has(id) || run.head_branch !== head || run.status !== "completed")
+                continue;
+            const started = Date.parse(String(run.run_started_at ?? run.created_at)), ended = Date.parse(String(run.updated_at));
+            if (!Number.isFinite(started) || !Number.isFinite(ended) || ended < started) {
+                result.warnings.push(`Run ${id} has no usable timing.`);
+                continue;
+            }
+            seen.add(id);
+            milliseconds += ended - started;
+        }
+        if (response.workflow_runs.length < 100)
+            break;
+        if (page === RUN_PAGES)
+            result.warnings.push("Actions run time exceeded the pagination bound; minutes are a lower bound.");
+    }
+    result.actionsRuns = seen.size;
+    result.actionsMinutes = Math.round(milliseconds / 6_000) / 10;
+}
+export function renderPrUsage(usage) {
+    const tokens = usage.inputTokens === null || usage.outputTokens === null ? "unavailable"
+        : `${usage.inputTokens + usage.outputTokens} (${usage.inputTokens} input + ${usage.outputTokens} output)`;
+    return `**Observed tokens:** ${tokens}; ${usage.sessions ? `${usage.measuredSessions}/${usage.sessions} known sessions` : "session coverage unavailable"}. **AI credits:** unavailable (API scaling unverified). **Actions time:** ${usage.actionsMinutes === null ? "unavailable" : `${usage.actionsMinutes} min wall-clock across ${usage.actionsRuns} runs (not billed minutes)`}. Main-session log counts, not an invoice or unique-context count; unreported subagent/tool usage is excluded.${usage.sources.length ? ` [Evidence](${usage.sources[0]})` : ""}${usage.warnings.some((warning) => !warning.startsWith("AI-credit")) ? " Coverage incomplete; inspect session logs." : ""}`;
+}
+//# sourceMappingURL=pr-usage.js.map

package/dist/reporting/pr-usage.js.map

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

package/dist/reporting/records.d.ts

@@ -0,0 +1,28 @@
+import type { Config } from "../config.js";
+import { type GitHubApi } from "../tracking/github.js";
+export interface RunRecord {
+    schemaVersion: 1;
+    kind: "work-item" | "session" | "improvement-review";
+    sessionId: string | null;
+    contextStatus: "unreported" | "attested";
+    id: string;
+    specialist: string;
+    requestedModel: string;
+    observedModel: string | null;
+    observedModelSource: string | null;
+    date: string;
+    status: string;
+    issue: string;
+    pullRequest: string | null;
+    inputTokens: number | null;
+    outputTokens: number | null;
+    credits: number | null;
+    currencyAmount: number | null;
+    currency: string | null;
+    usageSource: string | null;
+    summary: string;
+}
+export declare function runRecord(value: unknown): RunRecord;
+export declare function collectRecords(client: GitHubApi, config: Config): Promise<RunRecord[]>;
+export declare function evidenceId(run: RunRecord): string;
+export declare function parseRecords(value: unknown): RunRecord[];

package/dist/reporting/records.js

@@ -0,0 +1,152 @@
+import { hash, integer, record, string } from "../core.js";
+import { isWriter } from "../tracking/github.js";
+import { managedIssues } from "../tracking/issues.js";
+import { taskMetadata } from "../specification/batch.js";
+import { linkedPull } from "../execution/dispatch.js";
+function metric(value, name) {
+    if (value === null || value === undefined)
+        return null;
+    if (typeof value !== "number" || !Number.isFinite(value) || value < 0)
+        throw new Error(`${name} must be non-negative or null.`);
+    return value;
+}
+function nullable(value, name) {
+    return value === null || value === undefined ? null : string(value, name);
+}
+export function runRecord(value) {
+    const data = record(value, "run");
+    if (data.schemaVersion !== undefined && data.schemaVersion !== 1)
+        throw new Error("Unsupported run-record version.");
+    if (data.kind !== undefined && !["session", "work-item", "improvement-review"].includes(String(data.kind)))
+        throw new Error("Invalid record kind.");
+    if (data.contextStatus !== undefined && !["unreported", "attested"].includes(String(data.contextStatus)))
+        throw new Error("Memory-read evidence must be unreported or explicitly attested.");
+    const result = {
+        schemaVersion: 1,
+        kind: data.kind === "session" ? "session" : data.kind === "improvement-review" ? "improvement-review" : "work-item",
+        sessionId: nullable(data.sessionId, "session ID"),
+        contextStatus: data.contextStatus === "attested" ? "attested" : "unreported",
+        id: string(data.id, "run ID"), specialist: string(data.specialist, "specialist"),
+        requestedModel: string(data.requestedModel, "requested model"),
+        observedModel: nullable(data.observedModel, "observed model"),
+        observedModelSource: nullable(data.observedModelSource, "observed-model evidence"),
+        date: string(data.date, "date"), status: string(data.status, "status"),
+        issue: string(data.issue, "issue"), pullRequest: nullable(data.pullRequest, "PR"),
+        inputTokens: metric(data.inputTokens, "input tokens"), outputTokens: metric(data.outputTokens, "output tokens"),
+        credits: metric(data.credits, "credits"), currencyAmount: metric(data.currencyAmount, "currency amount"),
+        currency: nullable(data.currency, "currency"), usageSource: nullable(data.usageSource, "usage evidence"),
+        summary: string(data.summary, "summary", true),
+    };
+    if (!Number.isFinite(Date.parse(result.date)))
+        throw new Error("Invalid run date.");
+    result.date = new Date(result.date).toISOString();
+    if (result.kind === "session" && !result.sessionId)
+        throw new Error("A session record needs a real session identifier.");
+    for (const count of [result.inputTokens, result.outputTokens])
+        if (count !== null && !Number.isSafeInteger(count))
+            throw new Error("Token counts must be whole safe integers.");
+    if (result.observedModel !== null && !result.observedModelSource)
+        throw new Error("Observed model requires runtime evidence, not an agent's assertion.");
+    if ([result.inputTokens, result.outputTokens, result.credits, result.currencyAmount].some((value) => value !== null) && !result.usageSource)
+        throw new Error("Reported usage needs an evidence source.");
+    if (result.currencyAmount !== null && !result.currency)
+        throw new Error("Currency amount requires its currency.");
+    if (result.summary.length > 4000)
+        throw new Error("Run summaries must remain compact.");
+    return result;
+}
+export async function collectRecords(client, config) {
+    const records = [];
+    for (const issue of await managedIssues(client, config.repository)) {
+        const metadata = taskMetadata(String(issue.body ?? ""));
+        if (!metadata)
+            continue;
+        const number = integer(issue.number, "issue number");
+        const pr = await linkedPull(client, config.repository, number, metadata.branch);
+        let date = string(pr?.updated_at ?? issue.updated_at, "updated timestamp");
+        const evidence = [];
+        if (pr) {
+            const comments = await client.list(`/repos/${config.repository}/issues/${integer(pr.number, "PR number")}/comments`);
+            for (const comment of comments) {
+                const user = comment.user === null || comment.user === undefined ? null : record(comment.user, "comment author");
+                const trusted = await isWriter(client, config.repository, user) || (user?.type === "Bot" && ["Copilot", "copilot-swe-agent[bot]"].includes(String(user.login)));
+                const body = typeof comment.body === "string" ? comment.body : "";
+                if (!trusted || !body.trimStart().startsWith("<!-- crewbie-memory-proposal -->"))
+                    continue;
+                if (typeof comment.updated_at === "string" && comment.updated_at > date)
+                    date = comment.updated_at;
+                const link = `https://github.com/${config.repository}/pull/${pr.number}#issuecomment-${comment.id}`;
+                evidence.push(`Deferred memory proposal (${link}): ${body.length <= 1000 ? body : "Body omitted because it exceeds the summary budget; consult the comment."}`);
+            }
+            const reviews = await client.list(`/repos/${config.repository}/pulls/${integer(pr.number, "PR number")}/reviews`);
+            for (const review of reviews) {
+                if (review.state === "DISMISSED")
+                    continue;
+                if (typeof review.submitted_at === "string" && review.submitted_at > date)
+                    date = review.submitted_at;
+                const body = typeof review.body === "string" ? review.body : "";
+                evidence.push(`Review ${review.id}: ${review.state}. ${body.length <= 1000 ? body : "Body omitted because it exceeds the summary budget; consult the review."}`);
+            }
+            const head = record(pr.head, "PR head");
+            const checks = record(await client.request("GET", `/repos/${config.repository}/commits/${encodeURIComponent(string(head.sha, "head revision"))}/check-runs?per_page=100`), "check runs");
+            if (!Array.isArray(checks.check_runs))
+                throw new Error("GitHub returned invalid CI results.");
+            for (const raw of checks.check_runs) {
+                const check = record(raw, "check run");
+                if (typeof check.completed_at === "string" && check.completed_at > date)
+                    date = check.completed_at;
+                evidence.push(`CI ${String(check.name)}: ${String(check.conclusion ?? check.status)}.`);
+            }
+            if (typeof checks.total_count === "number" && checks.total_count > checks.check_runs.length)
+                evidence.push("Additional CI results are not included; consult the PR.");
+        }
+        const primary = String(pr?.body ?? issue.title ?? "");
+        let summary = [primary.length <= 2500 ? primary : "PR body omitted because it exceeds the summary budget; consult the PR.", ...evidence].join("\n");
+        if (summary.length > 4000)
+            summary = "Detailed feedback exceeds the compact record budget. Review the linked issue/PR, reviews and CI before proposing changes.";
+        records.push(runRecord({
+            id: `${config.repository}#${number}`, specialist: metadata.task.owner, requestedModel: metadata.task.model,
+            date,
+            status: pr?.merged_at ? "merged" : pr?.state === "closed" ? "failed" : pr ? "review" : issue.state === "closed" ? "closed-unmerged" : "pending",
+            issue: `https://github.com/${config.repository}/issues/${number}`,
+            pullRequest: pr ? `https://github.com/${config.repository}/pull/${integer(pr.number, "PR number")}` : null,
+            observedModel: null, observedModelSource: null, inputTokens: null, outputTokens: null,
+            credits: null, currencyAmount: null, currency: null, usageSource: null,
+            summary,
+        }));
+    }
+    const improvements = await client.list(`/repos/${config.repository}/pulls?state=closed&head=${config.repository.split("/")[0]}:crewbie/improvements`);
+    for (const pull of improvements) {
+        const number = integer(pull.number, "improvement PR");
+        const comments = await client.list(`/repos/${config.repository}/issues/${number}/comments`);
+        const trusted = [];
+        for (const comment of comments)
+            if (await isWriter(client, config.repository, comment.user))
+                trusted.push(comment);
+        const feedback = trusted.map((comment) => typeof comment.body === "string" ? comment.body : "").filter(Boolean).join("\n");
+        records.push(runRecord({
+            id: `${config.repository}:improvement#${number}`, kind: "improvement-review", specialist: "improver",
+            requestedModel: "Unrecorded", date: string(pull.closed_at, "closed timestamp"),
+            status: pull.merged_at ? "proposal-accepted" : "closed-unmerged",
+            issue: `https://github.com/${config.repository}/pull/${number}`,
+            pullRequest: `https://github.com/${config.repository}/pull/${number}`,
+            summary: feedback.length <= 3000 ? `Human review outcome: ${pull.merged_at ? "merged" : "closed without merge; the reason is not inferred"}.\n${feedback}` : "Human feedback exceeds the compact record budget. Consult the linked improvement PR.",
+        }));
+    }
+    return records;
+}
+export function evidenceId(run) {
+    return hash(JSON.stringify({ id: run.id, date: run.date, status: run.status, summary: run.summary }));
+}
+export function parseRecords(value) {
+    if (!Array.isArray(value))
+        throw new Error("Run records must be a list.");
+    const records = value.map(runRecord);
+    if (new Set(records.map((run) => run.id)).size !== records.length)
+        throw new Error("Duplicate run IDs would double-count usage.");
+    const sessions = records.flatMap((run) => run.sessionId ? [run.sessionId] : []);
+    if (new Set(sessions).size !== sessions.length)
+        throw new Error("Duplicate session IDs would double-count usage.");
+    return records;
+}
+//# sourceMappingURL=records.js.map

package/dist/reporting/records.js.map

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

package/dist/setup/agents.d.ts

@@ -0,0 +1,8 @@
+import { type Config, type Role } from "../config.js";
+export declare function roleProfile(root: string, role: Role, config: Config): Promise<string>;
+export declare function adoptedProfile(role: Role, config: Config, original: string): string;
+/**
+ * Refreshes Crewbie's block inside a charter a human edited and keeps every other line as they wrote it,
+ * with the frontmatter name (and model, when both declare one) kept in step. Null when the markers are gone.
+ */
+export declare function mergeManagedBlock(current: string, generated: string): string | null;

package/dist/setup/agents.js

@@ -0,0 +1,83 @@
+import { parseDocument, isMap, isSeq } from "yaml";
+import { agentArchivePath } from "../config.js";
+import { agentPrompt, optionalText, safePath } from "../core.js";
+import { charterTools, MANAGED_END, profile } from "./templates.js";
+import { removeAutoLoadedPointers } from "./auto-loaded.js";
+export async function roleProfile(root, role, config) {
+    const generated = profile(role, config);
+    if (!role.sourceAgent)
+        return generated;
+    const original = await optionalText(await safePath(root, agentArchivePath(role.sourceAgent)))
+        ?? await optionalText(await safePath(root, role.sourceAgent));
+    if (original === null)
+        throw new Error(`Restore the original or archived agent before updating ${role.id}: ${role.sourceAgent}`);
+    return adoptedProfile(role, config, original);
+}
+export function adoptedProfile(role, config, original) {
+    const generated = profile(role, config);
+    const text = original.replace(/^\uFEFF/, "");
+    const header = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/.exec(text);
+    if (!header && text.startsWith("---"))
+        throw new Error(`Agent frontmatter is incomplete: ${role.sourceAgent}`);
+    const document = parseDocument(header ? header[1] : `name: crewbie-${role.id}\n`, { uniqueKeys: true });
+    if (document.errors.length || !isMap(document.contents))
+        throw new Error(`Agent frontmatter must be a valid YAML mapping: ${role.sourceAgent}`);
+    if (document.has("tools") && !isSeq(document.get("tools")))
+        throw new Error(`Preserve tool restrictions by converting ${role.sourceAgent}'s tools to a reviewed YAML list before adoption.`);
+    if (!document.has("tools"))
+        document.set("tools", charterTools(role));
+    document.set("name", `crewbie-${role.id}`);
+    if (!document.has("description"))
+        document.set("description", role.purpose);
+    // Assignment and an inherited frontmatter model must not disagree.
+    if (document.has("model"))
+        document.set("model", role.model);
+    const handoffs = document.get("handoffs");
+    if (isSeq(handoffs))
+        for (const handoff of handoffs.items) {
+            if (!isMap(handoff))
+                continue;
+            const target = handoff.get("agent");
+            const adopted = config.roles.find((candidate) => candidate.sourceAgent
+                && candidate.sourceAgent.split("/").at(-1)?.replace(/(?:\.agent)?\.md$/, "") === target);
+            if (adopted)
+                handoff.set("agent", `crewbie-${adopted.id}`);
+        }
+    // Pointers to guidance Copilot already attaches only repeat context; the archive keeps the original.
+    const body = removeAutoLoadedPointers(header ? text.slice(header[0].length) : text).text;
+    const result = `---\n${document.toString()}---\n${body}\n\n${generated.replace(/^---\n[\s\S]*?\n---\n# [^\n]*\n/, "## Crewbie integration\n")}`;
+    agentPrompt(result, `Adopted ${role.id} charter`, `Shorten the original ${role.sourceAgent} and rerun init, leaving room for Crewbie integration. No original instructions were truncated or archived.`);
+    return result;
+}
+const START = /<!-- crewbie:managed:start[^>]*-->/g;
+function managedBlock(text) {
+    const starts = [...text.matchAll(START)];
+    const end = text.indexOf(MANAGED_END);
+    if (starts.length !== 1 || end < 0 || text.indexOf(MANAGED_END, end + 1) >= 0 || end < starts[0].index)
+        return null;
+    return [starts[0].index, end + MANAGED_END.length];
+}
+/**
+ * Refreshes Crewbie's block inside a charter a human edited and keeps every other line as they wrote it,
+ * with the frontmatter name (and model, when both declare one) kept in step. Null when the markers are gone.
+ */
+export function mergeManagedBlock(current, generated) {
+    const eol = current.includes("\r\n") ? "\r\n" : "\n";
+    const text = current.replace(/\r\n/g, "\n");
+    const mine = managedBlock(text), fresh = managedBlock(generated);
+    if (!mine || !fresh)
+        return null;
+    let merged = text.slice(0, mine[0]) + generated.slice(fresh[0], fresh[1]) + text.slice(mine[1]);
+    const header = /^---\n([\s\S]*?)\n---\n/.exec(merged), source = /^---\n([\s\S]*?)\n---\n/.exec(generated);
+    if (header && source) {
+        const document = parseDocument(header[1]), wanted = parseDocument(source[1]);
+        if (!document.errors.length && isMap(document.contents) && !wanted.errors.length) {
+            document.set("name", wanted.get("name"));
+            if (document.has("model") && wanted.has("model"))
+                document.set("model", wanted.get("model"));
+            merged = `---\n${document.toString()}---\n${merged.slice(header[0].length)}`;
+        }
+    }
+    return merged.replace(/\n/g, eol);
+}
+//# sourceMappingURL=agents.js.map

package/dist/setup/agents.js.map

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

package/dist/setup/assessment.d.ts

@@ -0,0 +1,31 @@
+import { type Config, type Role } from "../config.js";
+import { type InstructionQuality } from "./instruction-quality.js";
+import { type TeamAssessment } from "./team.js";
+import { type Inventory } from "./inventory.js";
+import { type RepositoryMap } from "./repository-map.js";
+export interface Assessment {
+    schemaVersion: 1;
+    findings: {
+        area: string;
+        status: "ready" | "gap" | "unknown";
+        evidence: string[];
+        detail: string;
+    }[];
+    questions: string[];
+    config: Config;
+    constitutionText: string | null;
+    instructions: {
+        path: string;
+        content: string;
+        beforeHash: string | null;
+        reason?: string;
+    }[];
+    instructionQuality: InstructionQuality;
+    configBeforeHash: string | null;
+    team: TeamAssessment;
+    inventory: Inventory;
+    installedRoles: Role[];
+    /** Names-only working-tree map; absent in proposals saved before it existed. */
+    repository?: RepositoryMap;
+}
+export declare function assess(root: string): Promise<Assessment>;

package/dist/setup/assessment.js

@@ -0,0 +1,75 @@
+import { execFileSync } from "node:child_process";
+import { realpath } from "node:fs/promises";
+import { relative, resolve } from "node:path";
+import { DEFAULT_EXECUTION_LIMITS, parseConfig } from "../config.js";
+import { optionalText, safePath, textHash } from "../core.js";
+import { assessInstructions, instructionFile } from "./instruction-quality.js";
+import { assessTeam } from "./team.js";
+import { inventory } from "./inventory.js";
+import { repositoryMap } from "./repository-map.js";
+const SETUP_STEPS = ".github/workflows/copilot-setup-steps.yml";
+export async function assess(root) {
+    const absolute = await realpath(resolve(root));
+    const gitRoot = await realpath(execFileSync("git", ["-C", absolute, "rev-parse", "--show-toplevel"], { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] }).trim());
+    if (relative(absolute, gitRoot) !== "")
+        throw new Error("Initialize Crewbie at the repository root, not a nested directory.");
+    const output = execFileSync("git", ["-C", absolute, "ls-files", "--cached", "--others", "--exclude-standard", "-z"], {
+        encoding: "utf8", maxBuffer: 8 * 1024 * 1024, stdio: ["ignore", "pipe", "pipe"],
+    });
+    const paths = [...new Set(output.split("\0").filter(Boolean))].sort();
+    const guidance = paths.filter(instructionFile);
+    const ci = paths.filter((path) => path.startsWith(".github/workflows/") && /\.ya?ml$/.test(path));
+    const existingConstitution = paths.find((path) => /(^|\/)constitution\.md$/i.test(path)) ?? null;
+    const installedText = await optionalText(await safePath(root, ".crewbie/config.json"));
+    const installed = installedText === null ? null : parseConfig(JSON.parse(installedText));
+    const team = await assessTeam(root, paths, installed?.roles ?? []);
+    const roles = [
+        ...(installed?.roles ?? []),
+        ...team.suggestions.filter(({ role }) => !installed?.roles.some((existing) => existing.id === role.id)).map(({ role }) => role),
+    ];
+    const findings = [
+        { area: "Instructions", status: guidance.length ? "unknown" : "gap", evidence: guidance.slice(0, 12), detail: guidance.length ? "Guidance exists; presence does not establish quality. Review the evidence-linked instruction signals and resolve policy conflicts." : "Propose agent-specific guidance only for useful missing context." },
+        { area: "Decisions", status: existingConstitution ? "ready" : "gap", evidence: existingConstitution ? [existingConstitution] : [], detail: "Reuse the existing constitution." },
+        { area: "Cloud execution", status: "unknown", evidence: ci.slice(0, 5), detail: "Run doctor with a selected repository and specialist. Account permissions and model support require separate verification." },
+        ci.includes(SETUP_STEPS)
+            ? { area: "Agent environment", status: "ready", evidence: [SETUP_STEPS], detail: "Cloud agents start with the setup steps in this workflow." }
+            : { area: "Agent environment", status: "gap", evidence: [], detail: `Add ${SETUP_STEPS} that installs dependencies (and checks out with fetch-depth: 0 for reviewers). Without it every agent session spends model turns installing them.` },
+    ];
+    const instructionQuality = await assessInstructions(root, paths);
+    const context = await inventory(root, paths);
+    findings.push({ area: "MCP servers", status: "unknown", evidence: context.mcp.map((file) => file.path), detail: "Inspect configured capabilities, overlap and missing integrations. Server connectivity and personal/global settings are not verified; credential values are withheld." }, { area: "Custom agents", status: "unknown", evidence: context.files.filter((file) => file.kind === "agents").map((file) => file.path), detail: "Review existing responsibilities and reuse their guidance before proposing new specialists." });
+    findings.push({
+        area: "Instruction quality", status: instructionQuality.signals.length ? "gap" : "unknown",
+        evidence: instructionQuality.signals.length ? [...new Set(instructionQuality.signals.map((signal) => `${signal.path}:${signal.line}`))].slice(0, 12) : instructionQuality.inspected.slice(0, 12),
+        detail: instructionQuality.signals.length
+            ? `${instructionQuality.signals.length + instructionQuality.signalsOmitted} advisory signals detected; showing ${instructionQuality.signals.length}. See instructionQuality for evidence, recommendations and study limitations. They do not block adoption or authorize rewrites.`
+            : "No selected static warning was found. This is not a quality certification; review repository-specific value and the disclosed inspection coverage.",
+    });
+    return {
+        schemaVersion: 1, findings, instructionQuality, team, inventory: context, installedRoles: installed?.roles ?? [], repository: repositoryMap(paths),
+        configBeforeHash: installedText === null ? null : textHash(installedText),
+        questions: [
+            "Which existing constraints are intentional, and which are legacy debt?",
+            "Which checks and human approvals are required before merge?",
+            "Which areas must agents leave unchanged?",
+            "Which instruction-quality warnings reflect stale or redundant guidance, and which are justified policies to preserve?",
+            "Which expertise does the project and upcoming feature need? Review the team evidence; add custom specialists or split, specialize and retire existing roles only after reviewing their open work.",
+            "Approve explicit models and domain checks for added roles. Existing models, policy and memory are preserved; discovery hints are not a fixed roster.",
+            "Enable hosted planning from crewbie:ready-for-planning labels? Approve planning.model first; users with repository write access can request planning, but this authorizes planning, not implementation.",
+            "Enable planning.executeOnMerge? Then a human approval of the exact planning head plus a human merge authorizes automatic paid execution; configure the supported assignment credential once.",
+        ],
+        config: installed ? { ...installed, roles } : {
+            schemaVersion: 1, repository: "", roles, constitution: existingConstitution,
+            maxActive: 2, modelProfile: "balanced", execution: { ...DEFAULT_EXECUTION_LIMITS }, nightly: {
+                enabled: false, maxRecords: 20,
+                allowedPaths: [
+                    ".crewbie/team/", ".crewbie/decisions/", ".crewbie/decisions.md", ".crewbie/instructions.md",
+                    ...[...roles.map((role) => role.id), "coordinator", "improver"].map((role) => `.github/agents/crewbie-${role}.agent.md`),
+                ],
+            }, ado: null, planning: { enabled: false, model: "" },
+        },
+        constitutionText: null,
+        instructions: [],
+    };
+}
+//# sourceMappingURL=assessment.js.map