@crewbie/cli 0.1.0-alpha.49

package/dist/specification/batch.d.ts

@@ -0,0 +1,50 @@
+import { type Config } from "../config.js";
+export interface Task {
+    id: string;
+    title: string;
+    body: string;
+    owner: string;
+    model: string;
+    priority: number;
+    dependsOn: string[];
+    kind?: "implementation" | "review";
+    adoWorkItem?: number;
+}
+/** Task PRs of a plan merge into this branch; one feature PR then takes the whole plan to the default branch. */
+/** One branch per approved revision, so a replanned batch never builds on, or reports, an earlier revision's feature PR. */
+export declare function featureBranch(batch: Batch): string;
+export interface SourceReference {
+    uri: string;
+    revision: string;
+    fingerprint?: string;
+}
+export declare function sourceReferences(value: unknown): SourceReference[];
+export interface Batch {
+    schemaVersion: 1;
+    id: string;
+    spec: string;
+    sources: SourceReference[];
+    tasks: Task[];
+    approval: {
+        digest: string;
+        execute: boolean;
+    } | null;
+}
+export declare function parseBatch(value: unknown, config?: Config): Batch;
+export declare function batchDigest(batch: Batch): string;
+export declare function approvedBatch(batch: Batch, execute: boolean): Batch;
+export declare function requireApproval(batch: Batch): void;
+export declare function issueDigest(title: string, body: string): string;
+export declare function issueBody(batch: Batch, task: Task, metadataOverride?: {
+    batchDigest?: string;
+    branch?: string;
+}): string;
+export interface TaskMetadata {
+    batch: string;
+    batchDigest: string;
+    sources: SourceReference[];
+    task: Task;
+    branch: string;
+}
+/** Null for bodies without Crewbie metadata and for tasks published before feature branches, which people finish by hand. */
+export declare function taskMetadata(body: string): TaskMetadata | null;

package/dist/specification/batch.js

@@ -0,0 +1,127 @@
+import { bounded, hash, integer, record, slug, string, strings } from "../core.js";
+import { limitsFor } from "../config.js";
+function taskKind(value) {
+    if (value !== "implementation" && value !== "review")
+        throw new Error("Task kind must be implementation or review.");
+    return value;
+}
+/** Task PRs of a plan merge into this branch; one feature PR then takes the whole plan to the default branch. */
+/** One branch per approved revision, so a replanned batch never builds on, or reports, an earlier revision's feature PR. */
+export function featureBranch(batch) { return `crewbie/${slug(batch.id, "batch ID").slice(0, 55)}-${batchDigest(batch).slice(0, 8)}`; }
+export function sourceReferences(value) {
+    if (!Array.isArray(value))
+        throw new Error("sources must be a list of URI/revision records.");
+    return value.map((item) => {
+        const source = record(item, "source");
+        return {
+            uri: string(source.uri, "source URI"), revision: string(source.revision, "source revision"),
+            ...(source.fingerprint === undefined ? {} : { fingerprint: string(source.fingerprint, "source fingerprint") }),
+        };
+    });
+}
+export function parseBatch(value, config) {
+    const data = record(value, "batch");
+    if (data.schemaVersion !== 1)
+        throw new Error("Unsupported batch version.");
+    const spec = string(data.spec, "user-supplied scope or source reference");
+    bounded(spec, limitsFor(config).spec, "User-supplied scope or source reference");
+    const sources = sourceReferences(data.sources);
+    if (!Array.isArray(data.tasks) || !data.tasks.length || data.tasks.length > 100)
+        throw new Error("A batch must contain 1-100 tasks.");
+    const tasks = data.tasks.map((item) => {
+        const task = record(item, "task");
+        const result = {
+            id: slug(task.id, "task ID"), title: string(task.title, "title"), body: string(task.body, "task body"),
+            owner: slug(task.owner, "owner"), model: string(task.model, "model"),
+            priority: integer(task.priority, "priority", 0, 1000), dependsOn: strings(task.dependsOn, "dependencies"),
+            ...(task.kind === undefined ? {} : { kind: taskKind(task.kind) }),
+            ...(task.adoWorkItem === undefined ? {} : { adoWorkItem: integer(task.adoWorkItem, "ADO work item") }),
+        };
+        bounded(result.body, limitsFor(config).spec, `${result.id} description`);
+        if (result.model.trim().toLowerCase() === "auto")
+            throw new Error("Tasks require an explicit approved model.");
+        if (!/^#{1,3}\s+Acceptance criteria\s*$/im.test(result.body))
+            throw new Error(`${result.id} needs an Acceptance criteria heading.`);
+        if (config && !config.roles.some((role) => role.id === result.owner && role.model === result.model))
+            throw new Error(`${result.id} owner/model does not match approved configuration.`);
+        return result;
+    });
+    if (new Set(tasks.map((task) => task.id)).size !== tasks.length)
+        throw new Error("Task IDs must be unique.");
+    const byId = new Map(tasks.map((task) => [task.id, task]));
+    const complete = new Set();
+    const visiting = new Set();
+    function visit(id) {
+        if (complete.has(id))
+            return;
+        if (visiting.has(id))
+            throw new Error(`Dependency cycle at ${id}.`);
+        const task = byId.get(id);
+        if (!task)
+            throw new Error(`Missing dependency: ${id}.`);
+        visiting.add(id);
+        for (const dependency of task.dependsOn)
+            visit(dependency);
+        visiting.delete(id);
+        complete.add(id);
+    }
+    for (const task of tasks)
+        visit(task.id);
+    const approval = data.approval == null ? null : record(data.approval, "approval");
+    if (approval && typeof approval.execute !== "boolean")
+        throw new Error("approval.execute must be boolean.");
+    return {
+        schemaVersion: 1, id: slug(data.id, "batch ID"), spec, sources, tasks,
+        approval: approval ? { digest: string(approval.digest, "approval digest"), execute: approval.execute === true } : null,
+    };
+}
+export function batchDigest(batch) {
+    return hash(JSON.stringify({ schemaVersion: batch.schemaVersion, id: batch.id, spec: batch.spec, sources: batch.sources, tasks: batch.tasks }));
+}
+export function approvedBatch(batch, execute) {
+    return { ...batch, approval: { digest: batchDigest(batch), execute } };
+}
+export function requireApproval(batch) {
+    if (batch.approval?.digest !== batchDigest(batch))
+        throw new Error("This batch is unapproved or changed after approval. Review and approve it again.");
+}
+export function issueDigest(title, body) {
+    return hash(JSON.stringify({ title, body }));
+}
+export function issueBody(batch, task, metadataOverride = {}) {
+    const metadata = JSON.stringify({ batch: batch.id, batchDigest: metadataOverride.batchDigest ?? batchDigest(batch), sources: batch.sources, task, branch: metadataOverride.branch ?? featureBranch(batch) });
+    if (task.body.includes("<!-- crewbie-task:"))
+        throw new Error("Task body contains a reserved metadata marker.");
+    return `${task.body}\n\n## Context\n\n${batch.spec}\n\n${batch.sources.map((source) => `- ${source.uri} (revision: ${source.revision})`).join("\n")}\n\nUse the named Crewbie specialist. Link the resulting PR to this issue. Read and report the specialist's charter and relevant memory. Keep the PR description concise.\n\n<!-- crewbie-task:${Buffer.from(metadata).toString("base64")} -->`;
+}
+function taskBranch(value) {
+    const branch = string(value, "feature branch");
+    if (!/^crewbie\/[a-z][a-z0-9-]{0,63}$/.test(branch))
+        throw new Error("Invalid Crewbie feature branch.");
+    return branch;
+}
+/** Null for bodies without Crewbie metadata and for tasks published before feature branches, which people finish by hand. */
+export function taskMetadata(body) {
+    const matches = [...body.matchAll(/<!-- crewbie-task:([A-Za-z0-9+/=]+) -->/g)];
+    if (!matches.length)
+        return null;
+    if (matches.length !== 1 || !matches[0]?.[1])
+        throw new Error("Issue has ambiguous Crewbie metadata.");
+    const value = record(JSON.parse(Buffer.from(matches[0][1], "base64").toString("utf8")), "issue metadata");
+    if (value.branch === undefined)
+        return null;
+    const task = record(value.task, "issue task");
+    return {
+        batch: slug(value.batch, "batch"), batchDigest: string(value.batchDigest, "batch digest"),
+        sources: sourceReferences(value.sources),
+        task: {
+            id: slug(task.id, "task ID"), title: string(task.title, "title"), body: string(task.body, "body"),
+            owner: slug(task.owner, "owner"), model: string(task.model, "model"),
+            dependsOn: strings(task.dependsOn, "dependencies"), priority: integer(task.priority, "priority", 0, 1000),
+            ...(task.kind === undefined ? {} : { kind: taskKind(task.kind) }),
+            ...(task.adoWorkItem === undefined ? {} : { adoWorkItem: integer(task.adoWorkItem, "ADO work item") }),
+        },
+        branch: taskBranch(value.branch),
+    };
+}
+//# sourceMappingURL=batch.js.map

package/dist/specification/batch.js.map

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

package/dist/specification/plan-checks.d.ts

@@ -0,0 +1,6 @@
+import type { Batch } from "./batch.js";
+import { type RepositoryMap } from "../setup/repository-map.js";
+/** Concrete contract values: HTTP status codes and quantities with units, normalized for comparison. */
+export declare function contractValues(text: string): string[];
+export declare function planChecks(batch: Batch, source: string, map: RepositoryMap | null): string[];
+export declare function renderPlanChecks(warnings: string[]): string;

package/dist/specification/plan-checks.js

@@ -0,0 +1,73 @@
+import { missingPaths } from "../setup/repository-map.js";
+/**
+ * Deterministic checks of a proposed plan against its source issue and the working tree. They are advisory:
+ * they surface under-specified contracts, overlapping paid runs and stale paths for the human reviewing the plan.
+ */
+const UNIT = {
+    ms: "ms", millisecond: "ms", milliseconds: "ms",
+    s: "s", sec: "s", secs: "s", second: "s", seconds: "s",
+    m: "min", min: "min", mins: "min", minute: "min", minutes: "min",
+    h: "h", hr: "h", hrs: "h", hour: "h", hours: "h",
+    d: "d", day: "d", days: "d",
+    kb: "KB", mb: "MB", gb: "GB", "%": "%",
+};
+const QUANTITY = /(?<![\w.])(\d+(?:\.\d+)?)\s?(ms|milliseconds?|secs?|seconds?|s|mins?|minutes?|m|hrs?|hours?|h|days?|d|kb|mb|gb|%)(?![\w])/gi;
+const STATUS = /\b(?:HTTP\s*|status\s*(?:code\s*)?(?:of\s*)?|returns?\s+(?:an?\s+)?|respond(?:s|ing)?\s+with\s+(?:an?\s+)?)([1-5]\d\d)\b|\b([1-5]\d\d)\s+(?:OK|Created|Accepted|No Content|Bad Request|Unauthorized|Forbidden|Not Found|Conflict|Gone|Unprocessable|Too Many Requests|Internal Server Error|Service Unavailable)\b/gi;
+/** Concrete contract values: HTTP status codes and quantities with units, normalized for comparison. */
+export function contractValues(text) {
+    const values = new Set();
+    for (const match of text.matchAll(STATUS))
+        values.add(`HTTP ${match[1] ?? match[2]}`);
+    for (const match of text.matchAll(QUANTITY))
+        values.add(`${Number(match[1])}${UNIT[match[2].toLowerCase()] ?? match[2]}`);
+    return [...values];
+}
+const STOP = new Set(["the", "and", "for", "with", "that", "this", "are", "is", "be", "to", "of", "in", "on", "a", "an", "or", "it", "its", "when", "each", "all", "any", "from", "into", "by", "as", "at", "not", "no", "must", "should", "can", "only", "via", "per"]);
+function words(line) {
+    return new Set(line.toLowerCase().replace(/`[^`]*`/g, (span) => span.replace(/[^\w]+/g, "_")).split(/[^\w/.-]+/).filter((word) => word.length >= 3 && !STOP.has(word)));
+}
+function criteria(task) {
+    const section = /^#{2,3}\s+Acceptance criteria\s*$([\s\S]*?)(?=^#{1,3}\s|(?![\s\S]))/im.exec(task.body)?.[1] ?? "";
+    return section.split(/\r?\n/).map((line) => line.replace(/^\s*(?:[-*]|\d+\.)\s+(?:\[[ x]\]\s+)?/i, "").trim()).filter((line) => line.length > 0);
+}
+function jaccard(a, b) {
+    const shared = [...a].filter((word) => b.has(word)).length;
+    return shared / (a.size + b.size - shared || 1);
+}
+const OVERLAP = 0.6;
+const GENERIC = /^(?:existing behavio(?:u)?r remains covered by relevant tests|all (?:existing )?tests pass|no regressions?)\.?$/i;
+export function planChecks(batch, source, map) {
+    const warnings = [];
+    const issueValues = new Set(contractValues(source));
+    const carried = new Set();
+    for (const task of batch.tasks) {
+        const values = contractValues(`${task.title}\n${task.body}`);
+        values.forEach((value) => carried.add(value));
+        const invented = values.filter((value) => !issueValues.has(value));
+        if (invented.length)
+            warnings.push(`\`${task.id}\` states values the source issue does not: ${invented.join(", ")}. Confirm them, or ask instead of guessing.`);
+        const missing = map ? missingPaths(map, `${task.title}\n${task.body}`) : [];
+        if (missing.length)
+            warnings.push(`\`${task.id}\` cites paths not in the repository: ${missing.slice(0, 8).map((path) => `\`${path}\``).join(", ")}. Fine if the task creates them; otherwise correct the plan.`);
+    }
+    const dropped = [...issueValues].filter((value) => !carried.has(value));
+    if (dropped.length)
+        warnings.push(`The source issue states values no task carries: ${dropped.join(", ")}. Put them verbatim in the task that owns that behavior.`);
+    const work = batch.tasks.filter((task) => task.kind !== "review");
+    for (let i = 0; i < work.length; i++)
+        for (let j = i + 1; j < work.length; j++) {
+            const shared = criteria(work[i]).filter((line) => !GENERIC.test(line))
+                .find((line) => criteria(work[j]).some((other) => !GENERIC.test(other) && jaccard(words(line), words(other)) >= OVERLAP));
+            if (shared)
+                warnings.push(`\`${work[i].id}\` and \`${work[j].id}\` share an acceptance criterion ("${shared.slice(0, 120)}"). Give each deliverable, including its tests, one owning task so two paid runs do not build it.`);
+        }
+    return warnings;
+}
+const SHOWN = 12;
+export function renderPlanChecks(warnings) {
+    if (!warnings.length)
+        return "";
+    const more = warnings.length > SHOWN ? `\n- ${warnings.length - SHOWN} more warnings not shown.` : "";
+    return `## Plan checks\n\nCrewbie compared the tasks with the source issue and the repository file names. Advisory; nothing was changed.\n\n${warnings.slice(0, SHOWN).map((warning) => `- ${warning.slice(0, 400)}`).join("\n")}${more}\n\n`;
+}
+//# sourceMappingURL=plan-checks.js.map

package/dist/specification/plan-checks.js.map

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

package/dist/specification/planning.d.ts

@@ -0,0 +1,26 @@
+import { type Config } from "../config.js";
+import { type GitHubApi } from "../tracking/github.js";
+import { type Batch } from "./batch.js";
+export { PLANNING_LABEL } from "../config.js";
+interface Source {
+    number: number;
+    title: string;
+    body: string;
+    revision: string;
+    labelEvent: number;
+}
+export interface Plan {
+    summary: string;
+    questions: string[];
+    teamSuggestions: string[];
+    batch: Batch | null;
+    decisions: string | null;
+}
+export declare function requestPlanningRevision(client: GitHubApi, config: Config, number: number, feedback: string, apply: boolean): Promise<string>;
+export declare function preparePlanning(root: string, client: GitHubApi, config: Config, eventValue: unknown, runId?: number): Promise<{
+    ready: boolean;
+    reason: string;
+    model: string;
+}>;
+export declare function parsePlan(value: unknown, config: Config, source: Source): Plan;
+export declare function publishPlanning(root: string, client: GitHubApi, config: Config): Promise<string>;