edsger 0.77.0 → 0.78.0

package/dist/phases/release-sync/snapshot.js

@@ -1,158 +0,0 @@
-/**
- * Snapshot detection: after the latest GitHub release already has a
- * smoke-test plan, inspect the cloned repo for a yet-to-be-released
- * "snapshot" version (next package.json version, an [Unreleased] entry
- * in CHANGELOG, an unreleased git tag, etc.) so we can prepare the
- * next smoke test before anyone cuts the tag on GitHub.
- */
-import { query } from '@anthropic-ai/claude-agent-sdk';
-import { DEFAULT_MODEL } from '../../constants.js';
-import { findBalancedJsonObject } from '../../utils/json-extract.js';
-import { logDebug, logInfo } from '../../utils/logger.js';
-export function buildSnapshotDetectionPrompt(latestReleaseTag) {
-    return `You are inspecting a code repository to decide whether an unreleased "snapshot" version is being prepared.
-
-The most recent shipped release on GitHub is tagged: **${latestReleaseTag}**
-
-Your job:
-
-1. Read the repository's primary version source. In priority order:
-   - package.json "version" field (JS/TS projects)
-   - Cargo.toml [package] version (Rust)
-   - pyproject.toml [project] / [tool.poetry] version (Python)
-   - pom.xml <version> (Java / Maven)
-   - VERSION file (plain text)
-2. Read CHANGELOG.md / HISTORY.md / RELEASES.md for an [Unreleased] or similarly labelled section.
-3. Run \`git tag --list\` and \`git tag --sort=-creatordate | head -5\` to look for tags newer than ${latestReleaseTag} that have not yet been cut as GitHub releases.
-
-Then decide:
-- If the primary version source is strictly greater than ${latestReleaseTag} (accounting for "v" prefixes and semver prerelease suffixes like \`-SNAPSHOT\`, \`-rc.1\`, \`-next.0\`), OR there is a newer unreleased git tag, report that string as \`snapshot_tag\`.
-- Otherwise report \`snapshot_tag: null\`.
-- Do NOT invent a version. Use the exact string from the source file. Preserve the repo's existing tag convention (e.g. if releases are \`v1.2.3\` but package.json says \`1.2.3\`, return \`v1.2.3\`).
-
-Respond with ONLY a JSON object — no prose, no markdown fences:
-
-{
-  "snapshot_tag": "v2.0.0" | null,
-  "source": "package.json" | "Cargo.toml" | "pyproject.toml" | "pom.xml" | "VERSION" | "CHANGELOG" | "git_tag" | null,
-  "reasoning": "<one sentence>"
-}`;
-}
-export function parseSnapshotDetection(raw) {
-    let body = raw.trim();
-    const fence = body.match(/```(?:json)?\s*([\s\S]*?)```/);
-    if (fence) {
-        body = fence[1].trim();
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(body);
-    }
-    catch {
-        const object = findBalancedJsonObject(body);
-        if (!object) {
-            throw new Error('No JSON object found in snapshot-detection output');
-        }
-        parsed = JSON.parse(object);
-    }
-    if (typeof parsed !== 'object' || parsed === null) {
-        throw new Error('Snapshot detection returned non-object response');
-    }
-    const obj = parsed;
-    const rawTag = obj.snapshot_tag;
-    const snapshotTag = typeof rawTag === 'string' && rawTag.trim().length > 0
-        ? rawTag.trim()
-        : null;
-    const source = typeof obj.source === 'string' ? obj.source : null;
-    const reasoning = typeof obj.reasoning === 'string' ? obj.reasoning : '(no reasoning given)';
-    return { snapshot_tag: snapshotTag, source, reasoning };
-}
-/**
- * Very loose sanity check on a proposed snapshot tag. We reject tags
- * that are obviously the same as the latest release or that contain
- * characters that would break downstream git / GitHub API calls.
- */
-export function isPlausibleSnapshotTag(candidate, latestReleaseTag) {
-    if (candidate === latestReleaseTag) {
-        return false;
-    }
-    if (candidate.length === 0 || candidate.length > 100) {
-        return false;
-    }
-    if (/\s/.test(candidate)) {
-        return false;
-    }
-    if (/^[-.]/.test(candidate) ||
-        candidate.includes('..') ||
-        candidate.includes('@{')) {
-        return false;
-    }
-    return /^[A-Za-z0-9._\-+/@]+$/.test(candidate);
-}
-function userMessage(content) {
-    return { type: 'user', message: { role: 'user', content } };
-}
-// eslint-disable-next-line @typescript-eslint/require-await -- async generator required by SDK interface
-async function* makePrompt(text) {
-    yield userMessage(text);
-}
-export async function detectSnapshotVersion(options) {
-    const { cwd, latestReleaseTag, verbose } = options;
-    if (verbose) {
-        logInfo(`Detecting snapshot version ahead of ${latestReleaseTag}...`);
-    }
-    let lastAssistant = '';
-    let detection = null;
-    for await (const message of query({
-        prompt: makePrompt(buildSnapshotDetectionPrompt(latestReleaseTag)),
-        options: {
-            systemPrompt: {
-                type: 'preset',
-                preset: 'claude_code',
-            },
-            model: DEFAULT_MODEL,
-            maxTurns: 10,
-            permissionMode: 'bypassPermissions',
-            cwd,
-        },
-    })) {
-        if (message.type === 'assistant' && message.message?.content) {
-            for (const content of message.message.content) {
-                if (content.type === 'text') {
-                    lastAssistant += `${content.text}\n`;
-                    logDebug(content.text, verbose);
-                }
-            }
-        }
-        if (message.type === 'result') {
-            const text = ('result' in message ? message.result : '') || lastAssistant;
-            try {
-                detection = parseSnapshotDetection(text);
-            }
-            catch (err) {
-                if (verbose) {
-                    logDebug(`Snapshot detection parse error: ${err instanceof Error ? err.message : String(err)}`, verbose);
-                }
-            }
-        }
-    }
-    if (!detection) {
-        return {
-            snapshot_tag: null,
-            source: null,
-            reasoning: 'Could not parse detection response',
-        };
-    }
-    // Validate the proposed tag before returning.
-    if (detection.snapshot_tag !== null &&
-        !isPlausibleSnapshotTag(detection.snapshot_tag, latestReleaseTag)) {
-        if (verbose) {
-            logInfo(`Rejecting implausible snapshot tag: ${JSON.stringify(detection.snapshot_tag)}`);
-        }
-        return {
-            ...detection,
-            snapshot_tag: null,
-        };
-    }
-    return detection;
-}

package/dist/phases/run-sheet/agent.d.ts

@@ -1,49 +0,0 @@
-/**
- * Run-sheet generation via the Claude Agent SDK.
- *
- * The agent is handed the product's cloned repo (checked out at the
- * release ref) plus release metadata and a free-form template, and is
- * asked to produce the final run sheet Markdown. Unlike the previous
- * placeholder-based renderer, the template here is a structural guide
- * — it may contain no placeholders at all. The agent reads the diff
- * and source to decide what each section should say.
- */
-export interface AgentReleaseContext {
-    tag: string;
-    name: string | null;
-    body: string | null;
-    url: string | null;
-    published_at: string | null;
-    previous_tag: string | null;
-    previous_published_at: string | null;
-}
-export interface AgentProductContext {
-    name: string;
-    github_repository_full_name: string | null;
-}
-export interface RunSheetAgentInput {
-    product: AgentProductContext;
-    release: AgentReleaseContext;
-    template: string;
-    repoDir: string | null;
-    isDraft: boolean;
-    draftBaseRef: string | null;
-    verbose?: boolean;
-}
-export interface RunSheetAgentResult {
-    content: string;
-    turns: number;
-    model: string;
-    subtype: string;
-    error: string | null;
-}
-/** Exported for unit tests; not part of the public CLI surface. */
-export declare function buildUserPrompt(input: RunSheetAgentInput): string;
-/**
- * Strip a single Markdown code fence wrapping the entire response.
- * Defensive: the prompt forbids it, but models still occasionally do it.
- *
- * Exported for unit tests.
- */
-export declare function stripWrappingFence(text: string): string;
-export declare function generateRunSheetWithAgent(input: RunSheetAgentInput): Promise<RunSheetAgentResult>;

package/dist/phases/run-sheet/agent.js

@@ -1,156 +0,0 @@
-/**
- * Run-sheet generation via the Claude Agent SDK.
- *
- * The agent is handed the product's cloned repo (checked out at the
- * release ref) plus release metadata and a free-form template, and is
- * asked to produce the final run sheet Markdown. Unlike the previous
- * placeholder-based renderer, the template here is a structural guide
- * — it may contain no placeholders at all. The agent reads the diff
- * and source to decide what each section should say.
- */
-import { query } from '@anthropic-ai/claude-agent-sdk';
-import { DEFAULT_MODEL } from '../../constants.js';
-import { logError, logInfo } from '../../utils/logger.js';
-// Dropped from the agent's tool surface entirely so it cannot mutate the
-// cloned repo or anything else on disk. Bash stays available — we further
-// constrain it to read-only commands via the system prompt.
-const DISALLOWED_TOOLS = ['Edit', 'Write', 'NotebookEdit'];
-const SYSTEM_PROMPT = `You are generating a release run sheet for a software product.
-
-A run sheet is a release-readiness document: it summarises what is in the release, what operators need to do to ship it safely, and what to verify after rollout. You will receive product/release metadata and a TEMPLATE that describes the desired structure. The template is authoritative guidance — match its headings, section order, tone, and level of detail. It may be free-form prose with no placeholders or variable references at all.
-
-You have READ-ONLY access to the product's git repository, already cloned and checked out at the release ref (or the default branch for drafts), via the Bash, Read, Grep, and Glob tools. Use them to ground your output in real code:
-- \`git --no-pager log --no-decorate --pretty=format:"%h %s (%an)" <previous_ref>..HEAD\` to enumerate commits in the release
-- \`git --no-pager diff --stat <previous_ref>..HEAD\` for the files-changed summary
-- \`git --no-pager diff <previous_ref>..HEAD -- <path>\` to inspect specific changes when writing a section
-- \`git --no-pager show <sha>\` to inspect an individual commit
-- README / CHANGELOG / package manifests for product-level context
-
-Bash safety rules (strict):
-- Use \`git --no-pager ...\` for every git invocation so output never paginates.
-- ONLY run read-only commands. Allowed: \`git log\`, \`git diff\`, \`git show\`, \`git status\`, \`git rev-parse\`, \`git ls-files\`, \`git config --get\`, \`cat\`, \`head\`, \`tail\`, \`wc\`, \`ls\`. Forbidden: anything that mutates state — \`git push\`, \`git commit\`, \`git reset\`, \`git checkout\`, \`git fetch\`, \`git pull\`, \`git clean\`, \`git config <set>\`, \`rm\`, \`mv\`, \`cp\`, \`chmod\`, \`curl\`, \`wget\`, package managers, build commands.
-- Prefer Read/Grep/Glob over Bash for plain file inspection.
-
-Output rules:
-1. Output ONLY the final run-sheet Markdown. No preamble ("Here is..."), no trailing commentary, no wrapping code fence around the whole document.
-2. Follow the structure of the TEMPLATE exactly — same section headings in the same order. If the template is free-form prose, infer sensible sections from it.
-3. Ground every claim in the repo. Do not invent issues, APIs, or risks that are not evidenced by the diff or code.
-4. If the release is marked DRAFT, include a short "Draft" note near the top explaining the tag is not yet cut.
-5. Prefer concise bullet points over long paragraphs for actionable items. Aim for under 600 lines of Markdown total — be specific, not exhaustive.
-6. If the diff is empty or there is no previous ref to compare against, state that plainly rather than fabricating content.`;
-function userMessage(content) {
-    return { type: 'user', message: { role: 'user', content } };
-}
-// eslint-disable-next-line @typescript-eslint/require-await -- async generator required by SDK interface
-async function* makePrompt(text) {
-    yield userMessage(text);
-}
-/** Exported for unit tests; not part of the public CLI surface. */
-export function buildUserPrompt(input) {
-    const { product, release, template, isDraft, draftBaseRef } = input;
-    const baseRef = release.previous_tag ?? '(none — no previous release)';
-    const headRef = isDraft && draftBaseRef ? draftBaseRef : release.tag;
-    const draftLine = isDraft
-        ? `DRAFT: true — the tag \`${release.tag}\` has not been cut on GitHub yet; the working tree is the default branch \`${draftBaseRef ?? 'HEAD'}\`.`
-        : 'DRAFT: false';
-    const metadata = [
-        `Product: ${product.name}`,
-        `Repository: ${product.github_repository_full_name ?? '(unknown)'}`,
-        `Release tag: ${release.tag}`,
-        `Release name: ${release.name ?? release.tag}`,
-        `Previous tag: ${release.previous_tag ?? '(none)'}`,
-        `Published at: ${release.published_at ?? '(unpublished)'}`,
-        `Previous published at: ${release.previous_published_at ?? '(n/a)'}`,
-        `Release URL: ${release.url ?? '(n/a)'}`,
-        draftLine,
-        `Compare range: ${baseRef}..${headRef}`,
-    ].join('\n');
-    const body = release.body?.trim()
-        ? `\n\n--- RELEASE NOTES (from GitHub release body) ---\n${release.body.trim()}`
-        : '';
-    return `Here is the context for the release you are writing a run sheet for.
-
---- METADATA ---
-${metadata}${body}
-
---- TEMPLATE (follow its structure; it may contain no placeholders) ---
-${template}
-
---- INSTRUCTIONS ---
-Inspect the repo (it is your current working directory) and produce the final run sheet in Markdown. Output only the Markdown — no preamble, no wrapping fence.`;
-}
-/**
- * Strip a single Markdown code fence wrapping the entire response.
- * Defensive: the prompt forbids it, but models still occasionally do it.
- *
- * Exported for unit tests.
- */
-export function stripWrappingFence(text) {
-    const trimmed = text.trim();
-    const fence = trimmed.match(/^```(?:markdown|md)?\s*\n([\s\S]*?)\n```\s*$/);
-    return fence ? fence[1].trim() : trimmed;
-}
-function summariseToolUse(name, input, turn) {
-    const i = (input ?? {});
-    const descRaw = i.description ?? i.command ?? 'Running...';
-    const desc = typeof descRaw === 'string' ? descRaw : 'Running...';
-    return `[Turn ${turn}] ${name}: ${desc.slice(0, 160)}`;
-}
-export async function generateRunSheetWithAgent(input) {
-    const { repoDir } = input;
-    let assistantText = '';
-    let resultText = '';
-    let turns = 0;
-    let subtype = 'unknown';
-    let error = null;
-    logInfo('Connecting to Claude Agent SDK for run-sheet generation...');
-    const userPrompt = buildUserPrompt(input);
-    for await (const message of query({
-        prompt: makePrompt(userPrompt),
-        options: {
-            systemPrompt: {
-                type: 'preset',
-                preset: 'claude_code',
-                append: SYSTEM_PROMPT,
-            },
-            model: DEFAULT_MODEL,
-            permissionMode: 'bypassPermissions',
-            disallowedTools: DISALLOWED_TOOLS,
-            ...(repoDir ? { cwd: repoDir } : {}),
-        },
-    })) {
-        if (message.type === 'assistant' && message.message?.content) {
-            turns++;
-            for (const content of message.message.content) {
-                if (content.type === 'text') {
-                    assistantText += `${content.text}\n`;
-                }
-                else if (content.type === 'tool_use') {
-                    // Always emit tool-use lines (not gated on verbose) so the
-                    // desktop CliTerminal shows live progress instead of going
-                    // silent for the duration of the agent run.
-                    logInfo(summariseToolUse(content.name, content.input, turns));
-                }
-            }
-        }
-        if (message.type === 'result') {
-            subtype = message.subtype;
-            resultText = ('result' in message ? (message.result ?? '') : '') || '';
-            if (message.subtype !== 'success') {
-                error = `Agent finished with subtype=${message.subtype}`;
-                logError(`Run-sheet agent incomplete: ${message.subtype}`);
-            }
-        }
-    }
-    const raw = resultText.trim() || assistantText.trim();
-    if (!raw) {
-        throw new Error(`Run-sheet agent produced no output${error ? ` (${error})` : ''}`);
-    }
-    return {
-        content: stripWrappingFence(raw),
-        turns,
-        model: DEFAULT_MODEL,
-        subtype,
-        error,
-    };
-}

package/dist/phases/run-sheet/index.d.ts

@@ -1,57 +0,0 @@
-/**
- * Run-sheet generation for a release.
- *
- * Given a release, fetches the product's `run_sheet_template`, clones the
- * repo at the release tag (reusing the workspace layout used by
- * smoke-test), and hands the template + repo to the Claude Agent SDK
- * which reads the diff and produces the run sheet Markdown. The result
- * is upserted to the `run_sheets` table.
- *
- * Release tags are immutable, so if an existing run sheet has the same
- * template_snapshot + tag and no clone error, we short-circuit without
- * re-cloning. Pass `{ force: true }` to regenerate anyway.
- */
-import { type RunSheet } from '../../api/run-sheets.js';
-export interface RunSheetOptions {
-    releaseId: string;
-    force?: boolean;
-    verbose?: boolean;
-}
-export interface RunSheetResult {
-    status: 'success' | 'error' | 'cached';
-    releaseId: string;
-    releaseTag?: string;
-    summary: string;
-    runSheetId?: string;
-    cloneError?: string | null;
-    isDraft?: boolean;
-    agentTurns?: number;
-    model?: string;
-}
-/**
- * Atomic-create a `.lock` file alongside the workspace dir. Returns
- * true if we acquired the lock, false if another CLI instance holds a
- * fresh one. Stale locks (> LOCK_STALE_MS old) are stolen via a single
- * unlink + create pair; concurrent stealers race fairly via O_EXCL on
- * the second create.
- */
-/** Exported for unit tests; not part of the public CLI surface. */
-export declare function tryAcquireFileLock(lockPath: string): boolean;
-/** Exported for unit tests; not part of the public CLI surface. */
-export declare function releaseFileLock(lockPath: string): void;
-/**
- * Delete `run-sheet-*` workspaces that are both:
- *   - not currently locked (lock file missing or stale), AND
- *   - older than WORKSPACE_MAX_AGE_MS by mtime.
- *
- * Best-effort: any error on a single entry is logged and skipped so a
- * corrupt dir doesn't block the current generation.
- *
- * Exported for unit tests.
- */
-export declare function pruneStaleRunSheetWorkspaces(workspaceRoot: string, now?: number, maxAgeMs?: number): {
-    removed: string[];
-};
-/** Exported for unit tests; not part of the public CLI surface. */
-export declare function runSheetIsFresh(existing: RunSheet | null, template: string, tag: string): boolean;
-export declare function runRunSheet(options: RunSheetOptions): Promise<RunSheetResult>;