@generacy-ai/generacy 0.3.4 → 0.5.0

package/dist/cli/commands/cockpit/resolver.js

@@ -0,0 +1,117 @@
+/**
+ * Cockpit resolver — parses issue arguments and resolves them to a live
+ * `{ ref, repo, gh }` bundle:
+ *
+ *   - `IssueRef`               — owner/repo/number/nwo
+ *   - `parseIssueRef(input)`   — @internal; strict qualified-forms parser
+ *                                (owner/repo#N and URL only). Cockpit callers
+ *                                MUST go through `resolveIssueContext`.
+ *   - `resolveIssueContext(x)` — gates bare numbers via cwd-origin inference,
+ *                                delegates qualified forms to `parseIssueRef`,
+ *                                and returns a live `{ ref, repo, gh }` bundle.
+ *
+ * Errors are loud (`parse issue: <reason>`) so callers can prefix
+ * `Error: cockpit <verb>: ` per cli-surface.md.
+ */
+import { GhCliWrapper, nodeChildProcessRunner, } from '@generacy-ai/cockpit';
+const OWNER_REPO_HASH = /^([^/\s]+)\/([^/\s#]+)#(\d+)$/;
+const ISSUE_URL = /^https?:\/\/github\.com\/([^/\s]+)\/([^/\s]+)\/(?:issues|pull)\/(\d+)(?:[/?#].*)?$/;
+const BARE_NUMBER = /^\d+$/;
+function fail(reason) {
+    throw new Error(`parse issue: ${reason}`);
+}
+function makeRef(owner, repo, number) {
+    if (!owner || owner.includes('/') || /\s/.test(owner)) {
+        fail(`invalid owner "${owner}"`);
+    }
+    if (!repo || repo.includes('/') || /\s/.test(repo)) {
+        fail(`invalid repo "${repo}"`);
+    }
+    if (!Number.isInteger(number) || number <= 0) {
+        fail(`issue number must be a positive integer, got "${number}"`);
+    }
+    return { owner, repo, number, nwo: `${owner}/${repo}` };
+}
+/**
+ * @internal — cockpit callers MUST use `resolveIssueContext` instead. This
+ * function is exported only for its unit tests. Enforced by ESLint
+ * `no-restricted-imports` (see `.eslintrc.json`). See #850.
+ *
+ * Strict qualified-forms parser. Accepts:
+ *   - `owner/repo#123`
+ *   - `https://github.com/owner/repo/issues/123`
+ *   - `https://github.com/owner/repo/pull/123`
+ *
+ * Bare numbers ("123") fall through to the `unrecognized issue ref` throw —
+ * they are NOT a special case here. The bare-number remedy (cwd-origin
+ * inference) lives in `resolveIssueContext`.
+ */
+export function parseIssueRef(input) {
+    const trimmed = input.trim();
+    if (trimmed === '') {
+        fail('issue argument is required');
+    }
+    const ownerRepoHash = OWNER_REPO_HASH.exec(trimmed);
+    if (ownerRepoHash) {
+        const [, owner, repo, num] = ownerRepoHash;
+        return makeRef(owner, repo, Number.parseInt(num, 10));
+    }
+    const url = ISSUE_URL.exec(trimmed);
+    if (url) {
+        const [, owner, repo, num] = url;
+        return makeRef(owner, repo, Number.parseInt(num, 10));
+    }
+    fail(`unrecognized issue ref "${input}". ` +
+        `Use <n>, <owner>/<repo>#<n>, or https://github.com/<owner>/<repo>/issues/<n>.`);
+}
+async function inferRepoFromGitOrigin(runner, cwd) {
+    const result = await runner('git', ['remote', 'get-url', 'origin'], cwd != null ? { cwd } : {});
+    if (result.exitCode !== 0) {
+        fail(`could not infer owner/repo: 'git remote get-url origin' failed ` +
+            `(exit ${result.exitCode}): ${result.stderr.trim()}`);
+    }
+    const url = result.stdout.trim();
+    const match = /github\.com[/:]([^/]+)\/([^/.]+?)(?:\.git)?\/?$/.exec(url);
+    if (!match || !match[1] || !match[2]) {
+        fail(`could not infer owner/repo from git origin URL: ${url}`);
+    }
+    return `${match[1]}/${match[2]}`;
+}
+/**
+ * Resolve an issue argument to a full `{ ref, repo, gh }` bundle.
+ *
+ * Strategy:
+ *   1. Bare numbers ("123"): resolve owner/repo from `input.repo` or cwd git
+ *      origin inference, then build the ref directly via `makeRef`.
+ *   2. Qualified forms (`owner/repo#N`, URLs): delegate to `parseIssueRef`.
+ *
+ * The `input.repo` override exists for programmatic callers; the `context`
+ * verb intentionally does not expose it as a CLI flag (spec Q5 → A).
+ */
+export async function resolveIssueContext(input) {
+    const runner = input.runner ?? nodeChildProcessRunner;
+    const trimmed = input.issue.trim();
+    if (BARE_NUMBER.test(trimmed)) {
+        const number = Number.parseInt(trimmed, 10);
+        let repoNwo;
+        try {
+            repoNwo = input.repo ?? (await inferRepoFromGitOrigin(runner, input.cwd));
+        }
+        catch (err) {
+            const innerReason = err.message.replace(/^parse issue: /, '');
+            throw new Error(`parse issue: bare issue number "${trimmed}" is not accepted here. ` +
+                `Accepted: <owner>/<repo>#${trimmed}, a full issue URL, or a bare number inside a ` +
+                `checkout with a resolvable GitHub origin. ` +
+                `(cwd-origin inference failed: ${innerReason})`);
+        }
+        const parts = repoNwo.split('/');
+        if (parts.length !== 2 || !parts[0] || !parts[1]) {
+            fail(`inferred repo "${repoNwo}" is not in <owner>/<repo> form`);
+        }
+        const ref = makeRef(parts[0], parts[1], number);
+        return { ref, repo: ref.nwo, gh: new GhCliWrapper(runner) };
+    }
+    const ref = parseIssueRef(input.issue);
+    return { ref, repo: ref.nwo, gh: new GhCliWrapper(runner) };
+}
+//# sourceMappingURL=resolver.js.map

package/dist/cli/commands/cockpit/resolver.js.map

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

package/dist/cli/commands/cockpit/resume.d.ts

@@ -0,0 +1,38 @@
+/**
+ * `generacy cockpit resume <issue>` — re-arm a failed phase in place.
+ *
+ * Engine-owned label surgery: on an issue carrying `failed:<phase>` (with or
+ * without `agent:error`), applies the additions `waiting-for:<preceding-gate>`
+ * + `completed:<preceding-gate>` + `agent:paused` FIRST, then removes
+ * `failed:<phase>` plus defensive `agent:error` / `phase:<phase>` when
+ * present. The terminal on-issue state is byte-identical to a
+ * naturally-paused-then-completed gate — the label monitor's next poll emits
+ * a resume event, and the worker's `PhaseResolver.resolveFromContinue` walks
+ * the preserved `completed:<earlier-phase>` chain to pick `<phase>` as the
+ * start phase.
+ *
+ * Side effects (in order):
+ *   1. gh addLabels [waiting-for:<G>, completed:<G>, agent:paused]
+ *   2. gh removeLabels [failed:<phase>, ...conditional]
+ *
+ * Idempotent (FR-003): no `failed:*` → no-op with single-line stdout, exit 0.
+ * Refuses (FR-004) with evidence and zero mutations when the state is
+ * ambiguous or non-re-armable. No `--force` in v1 (parity with `advance`).
+ */
+import { Command } from 'commander';
+import { loadCockpitConfig, type CommandRunner, type GhWrapper } from '@generacy-ai/cockpit';
+export interface ResumeCommandDeps {
+    runner?: CommandRunner;
+    gh?: GhWrapper;
+    loadConfig?: typeof loadCockpitConfig;
+    env?: NodeJS.ProcessEnv;
+    now?: () => Date;
+    stdout?: (line: string) => void;
+    stderr?: (line: string) => void;
+}
+export interface ResumeOptions {
+    workflow?: string;
+}
+export declare function resumeCommand(deps?: ResumeCommandDeps): Command;
+export declare function runResume(issue: string | undefined, opts: ResumeOptions, deps: ResumeCommandDeps): Promise<void>;
+//# sourceMappingURL=resume.d.ts.map

package/dist/cli/commands/cockpit/resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/cockpit/resume.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,iBAAiB,EACjB,KAAK,aAAa,EAClB,KAAK,SAAS,EACf,MAAM,sBAAsB,CAAC;AAO9B,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,EAAE,CAAC,EAAE,SAAS,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,iBAAiB,CAAC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAwFD,wBAAgB,aAAa,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAmBnE;AAED,wBAAsB,SAAS,CAC7B,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,IAAI,CAAC,CA2Ff"}

package/dist/cli/commands/cockpit/resume.js

@@ -0,0 +1,167 @@
+/**
+ * `generacy cockpit resume <issue>` — re-arm a failed phase in place.
+ *
+ * Engine-owned label surgery: on an issue carrying `failed:<phase>` (with or
+ * without `agent:error`), applies the additions `waiting-for:<preceding-gate>`
+ * + `completed:<preceding-gate>` + `agent:paused` FIRST, then removes
+ * `failed:<phase>` plus defensive `agent:error` / `phase:<phase>` when
+ * present. The terminal on-issue state is byte-identical to a
+ * naturally-paused-then-completed gate — the label monitor's next poll emits
+ * a resume event, and the worker's `PhaseResolver.resolveFromContinue` walks
+ * the preserved `completed:<earlier-phase>` chain to pick `<phase>` as the
+ * start phase.
+ *
+ * Side effects (in order):
+ *   1. gh addLabels [waiting-for:<G>, completed:<G>, agent:paused]
+ *   2. gh removeLabels [failed:<phase>, ...conditional]
+ *
+ * Idempotent (FR-003): no `failed:*` → no-op with single-line stdout, exit 0.
+ * Refuses (FR-004) with evidence and zero mutations when the state is
+ * ambiguous or non-re-armable. No `--force` in v1 (parity with `advance`).
+ */
+import { Command } from 'commander';
+import { loadCockpitConfig, } from '@generacy-ai/cockpit';
+import { getLogger } from '../../utils/logger.js';
+import { resolveIssueContext } from './resolver.js';
+import { resolvePrecedingGate } from './gate-vocabulary.js';
+import { CockpitExit, isCockpitExit } from './exit.js';
+const KNOWN_PHASES = [
+    'specify',
+    'clarify',
+    'plan',
+    'tasks',
+    'implement',
+    'validate',
+];
+function isKnownPhase(candidate) {
+    return KNOWN_PHASES.includes(candidate);
+}
+function resolveWorkflowFromLabels(labels) {
+    const workflowLabel = labels.find((l) => l.startsWith('workflow:'));
+    if (workflowLabel) {
+        return workflowLabel.slice('workflow:'.length);
+    }
+    return 'speckit-feature';
+}
+function classify(labels, workflowOverride) {
+    const failedLabels = labels.filter((l) => l.startsWith('failed:')).sort();
+    if (failedLabels.length === 0) {
+        return { kind: 'no-op' };
+    }
+    if (failedLabels.length > 1) {
+        return { kind: 'refuse-multiple-failed', failedLabels };
+    }
+    const failedLabel = failedLabels[0];
+    const phaseSuffix = failedLabel.slice('failed:'.length);
+    if (!isKnownPhase(phaseSuffix)) {
+        return { kind: 'refuse-unknown-phase', failedLabel, phaseSuffix };
+    }
+    const failedPhase = phaseSuffix;
+    const workflowName = workflowOverride ?? resolveWorkflowFromLabels(labels);
+    const gateResult = resolvePrecedingGate(failedPhase, workflowName);
+    if (gateResult.kind === 'no-preceding-gate') {
+        return { kind: 'refuse-no-preceding-gate', failedPhase, workflowName };
+    }
+    const gate = gateResult.gate;
+    const conflictingWaiting = labels.find((l) => l.startsWith('waiting-for:') && l !== gate.waitingLabel);
+    if (conflictingWaiting) {
+        return {
+            kind: 'refuse-conflicting-waiting',
+            failedPhase,
+            conflictingLabel: conflictingWaiting,
+            expectedLabel: gate.waitingLabel,
+        };
+    }
+    const labelsToAdd = [gate.waitingLabel, gate.completedLabel, 'agent:paused'];
+    const labelsToRemove = [failedLabel];
+    if (labels.includes('agent:error'))
+        labelsToRemove.push('agent:error');
+    const phaseLabel = `phase:${failedPhase}`;
+    if (labels.includes(phaseLabel))
+        labelsToRemove.push(phaseLabel);
+    return { kind: 'happy-path', failedPhase, gate, labelsToAdd, labelsToRemove };
+}
+export function resumeCommand(deps = {}) {
+    const cmd = new Command('resume');
+    cmd
+        .description('Re-arm a failed phase in place so the next poll re-runs it.')
+        .argument('[issue]', 'Issue ref — <number>, <owner>/<repo>#<n>, or full URL.')
+        .option('--workflow <name>', 'Workflow name override (defaults to the issue\'s workflow:<name> label).')
+        .action(async (issue, opts) => {
+        try {
+            await runResume(issue, opts, deps);
+        }
+        catch (err) {
+            if (isCockpitExit(err)) {
+                const stderr = deps.stderr ?? ((line) => process.stderr.write(`${line}\n`));
+                stderr(err.message);
+                process.exit(err.code);
+            }
+            throw err;
+        }
+    });
+    return cmd;
+}
+export async function runResume(issue, opts, deps) {
+    const log = getLogger();
+    const print = deps.stdout ?? ((line) => process.stdout.write(`${line}\n`));
+    if (issue == null || issue.trim() === '') {
+        throw new CockpitExit(2, 'Error: cockpit resume: missing required argument <issue>');
+    }
+    const loaded = await (deps.loadConfig ?? loadCockpitConfig)({});
+    for (const w of loaded.warnings)
+        log.warn(w);
+    let ref;
+    let gh;
+    try {
+        const resolvedCtx = await resolveIssueContext({ issue, runner: deps.runner });
+        ref = resolvedCtx.ref;
+        gh = deps.gh ?? resolvedCtx.gh;
+    }
+    catch (err) {
+        throw new CockpitExit(2, `Error: cockpit resume: ${err.message}`);
+    }
+    let labels;
+    try {
+        labels = (await gh.fetchIssueLabels(ref.nwo, ref.number)).labels;
+    }
+    catch (err) {
+        throw new CockpitExit(1, `Error: cockpit resume: gh issue view: ${err.message}`);
+    }
+    const decision = classify(labels, opts.workflow);
+    switch (decision.kind) {
+        case 'no-op':
+            print(`issue ${ref.nwo}#${ref.number} is not in a failed state (no failed:<phase> label); nothing to re-arm`);
+            return;
+        case 'refuse-multiple-failed':
+            throw new CockpitExit(3, `Error: cockpit resume: refusing to resume: multiple failed:* labels present: [${decision.failedLabels.join(', ')}]`);
+        case 'refuse-unknown-phase':
+            throw new CockpitExit(3, `Error: cockpit resume: refusing to resume: unknown phase "${decision.phaseSuffix}" in label "${decision.failedLabel}"`);
+        case 'refuse-no-preceding-gate':
+            throw new CockpitExit(3, `Error: cockpit resume: refusing to resume: phase "${decision.failedPhase}" has no preceding gate; ` +
+                `use \`process:${decision.workflowName}\` label to re-queue from the beginning instead`);
+        case 'refuse-conflicting-waiting':
+            throw new CockpitExit(3, `Error: cockpit resume: refusing to resume: conflicting ${decision.conflictingLabel} already present; ` +
+                `derived preceding-gate is ${decision.expectedLabel.slice('waiting-for:'.length)}`);
+        case 'happy-path': {
+            try {
+                await gh.addLabels(ref.nwo, ref.number, decision.labelsToAdd);
+            }
+            catch (err) {
+                throw new CockpitExit(1, `Error: cockpit resume: gh issue edit (add ${decision.labelsToAdd.join(',')}): ${err.message}`);
+            }
+            try {
+                await gh.removeLabels(ref.nwo, ref.number, decision.labelsToRemove);
+            }
+            catch (err) {
+                throw new CockpitExit(1, `Error: cockpit resume: gh issue edit (remove ${decision.labelsToRemove.join(',')}): ${err.message}`);
+            }
+            print(`resumed ${ref.nwo}#${ref.number}: re-armed phase=${decision.failedPhase} ` +
+                `via preceding-gate=${decision.gate.name}; ` +
+                `added=[${decision.labelsToAdd.join(',')}] ` +
+                `removed=[${decision.labelsToRemove.join(',')}]`);
+            return;
+        }
+    }
+}
+//# sourceMappingURL=resume.js.map

package/dist/cli/commands/cockpit/resume.js.map

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

package/dist/cli/commands/cockpit/scope/errors.d.ts

@@ -0,0 +1,21 @@
+import type { IssueRef } from '@generacy-ai/cockpit';
+export declare class ScopeContendedError extends Error {
+    readonly code: "SCOPE_ADD_CONTENDED";
+    readonly attempts: number;
+    readonly ref: IssueRef;
+    readonly mutation: 'add' | 'remove';
+    readonly scope: {
+        repo: string;
+        number: number;
+    };
+    constructor(opts: {
+        attempts: number;
+        ref: IssueRef;
+        mutation: 'add' | 'remove';
+        scope: {
+            repo: string;
+            number: number;
+        };
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/cli/commands/cockpit/scope/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/scope/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,EAAG,qBAAqB,CAAU;IAC/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,KAAK,GAAG,QAAQ,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;gBAErC,IAAI,EAAE;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,GAAG,EAAE,QAAQ,CAAC;QACd,QAAQ,EAAE,KAAK,GAAG,QAAQ,CAAC;QAC3B,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;KACzC;CAWF"}

package/dist/cli/commands/cockpit/scope/errors.js

@@ -0,0 +1,17 @@
+export class ScopeContendedError extends Error {
+    code = 'SCOPE_ADD_CONTENDED';
+    attempts;
+    ref;
+    mutation;
+    scope;
+    constructor(opts) {
+        super(`SCOPE_ADD_CONTENDED: ${opts.mutation} ${opts.ref.repo}#${opts.ref.number} on ` +
+            `${opts.scope.repo}#${opts.scope.number} exhausted retry budget after ${opts.attempts} attempts`);
+        this.name = 'ScopeContendedError';
+        this.attempts = opts.attempts;
+        this.ref = opts.ref;
+        this.mutation = opts.mutation;
+        this.scope = opts.scope;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/cli/commands/cockpit/scope/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/scope/errors.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,IAAI,GAAG,qBAA8B,CAAC;IACtC,QAAQ,CAAS;IACjB,GAAG,CAAW;IACd,QAAQ,CAAmB;IAC3B,KAAK,CAAmC;IAEjD,YAAY,IAKX;QACC,KAAK,CACH,wBAAwB,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,MAAM;YAC7E,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,iCAAiC,IAAI,CAAC,QAAQ,WAAW,CACnG,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1B,CAAC;CACF"}

package/dist/cli/commands/cockpit/scope/retry.d.ts

@@ -0,0 +1,24 @@
+import type { GhWrapper, IssueRef } from '@generacy-ai/cockpit';
+import { type BodyShape, type ScopeMutation } from './writer.js';
+export interface WriteScopeOptions {
+    gh: GhWrapper;
+    scope: IssueRef;
+    mutation: ScopeMutation;
+    maxAttempts?: number;
+    backoffMs?: number[];
+    sleep?: (ms: number) => Promise<void>;
+}
+export interface WriteScopeResult {
+    noop: boolean;
+    attempts: number;
+    finalBody: string;
+    shape: BodyShape;
+}
+/**
+ * Read-modify-write-verify loop for concurrent-safe scope body mutations.
+ * `applyScopeMutation` is idempotent, so a competing writer that already
+ * applied our mutation causes the next retry to short-circuit as noop.
+ * Terminal exhaustion throws `ScopeContendedError`.
+ */
+export declare function writeScopeWithRetry(opts: WriteScopeOptions): Promise<WriteScopeResult>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/cli/commands/cockpit/scope/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/scope/retry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhE,OAAO,EAAsB,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAErF,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,SAAS,CAAC;IACd,KAAK,EAAE,QAAQ,CAAC;IAChB,QAAQ,EAAE,aAAa,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,CAAC;CAClB;AASD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,gBAAgB,CAAC,CA4C3B"}

package/dist/cli/commands/cockpit/scope/retry.js

@@ -0,0 +1,52 @@
+import { ScopeContendedError } from './errors.js';
+import { applyScopeMutation } from './writer.js';
+const DEFAULT_MAX_ATTEMPTS = 5;
+const DEFAULT_BACKOFF_MS = [100, 250, 500, 1000, 2000];
+function defaultSleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Read-modify-write-verify loop for concurrent-safe scope body mutations.
+ * `applyScopeMutation` is idempotent, so a competing writer that already
+ * applied our mutation causes the next retry to short-circuit as noop.
+ * Terminal exhaustion throws `ScopeContendedError`.
+ */
+export async function writeScopeWithRetry(opts) {
+    const maxAttempts = opts.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;
+    const backoffMs = opts.backoffMs ?? DEFAULT_BACKOFF_MS;
+    const sleep = opts.sleep ?? defaultSleep;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        const issue = await opts.gh.getIssue(opts.scope.repo, opts.scope.number);
+        const body = issue.body ?? '';
+        const result = applyScopeMutation(body, opts.mutation);
+        if (result.noop) {
+            return {
+                noop: true,
+                attempts: attempt,
+                finalBody: body,
+                shape: result.shape,
+            };
+        }
+        await opts.gh.updateIssueBody(opts.scope.repo, opts.scope.number, result.body);
+        const readback = await opts.gh.getIssue(opts.scope.repo, opts.scope.number);
+        const verifyBody = readback.body ?? '';
+        if (verifyBody === result.body) {
+            return {
+                noop: false,
+                attempts: attempt,
+                finalBody: verifyBody,
+                shape: result.shape,
+            };
+        }
+        if (attempt < maxAttempts) {
+            await sleep(backoffMs[attempt - 1]);
+        }
+    }
+    throw new ScopeContendedError({
+        attempts: maxAttempts,
+        ref: opts.mutation.ref,
+        mutation: opts.mutation.kind,
+        scope: opts.scope,
+    });
+}
+//# sourceMappingURL=retry.js.map

package/dist/cli/commands/cockpit/scope/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/scope/retry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAsC,MAAM,aAAa,CAAC;AAkBrF,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAC/B,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAEvD,SAAS,YAAY,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAuB;IAEvB,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,oBAAoB,CAAC;IAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,kBAAkB,CAAC;IACvD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,YAAY,CAAC;IAEzC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACxD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACzE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEvD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,OAAO;gBACL,IAAI,EAAE,IAAI;gBACV,QAAQ,EAAE,OAAO;gBACjB,SAAS,EAAE,IAAI;gBACf,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAE/E,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC5E,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;QAEvC,IAAI,UAAU,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;YAC/B,OAAO;gBACL,IAAI,EAAE,KAAK;gBACX,QAAQ,EAAE,OAAO;gBACjB,SAAS,EAAE,UAAU;gBACrB,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,GAAG,WAAW,EAAE,CAAC;YAC1B,MAAM,KAAK,CAAC,SAAS,CAAC,OAAO,GAAG,CAAC,CAAE,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,MAAM,IAAI,mBAAmB,CAAC;QAC5B,QAAQ,EAAE,WAAW;QACrB,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG;QACtB,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;QAC5B,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/commands/cockpit/scope/writer.d.ts

@@ -0,0 +1,21 @@
+import type { IssueRef } from '@generacy-ai/cockpit';
+export type BodyShape = 'phased' | 'flat';
+export type ScopeMutation = {
+    kind: 'add';
+    ref: IssueRef;
+} | {
+    kind: 'remove';
+    ref: IssueRef;
+};
+export interface ScopeWriteResult {
+    noop: boolean;
+    body: string;
+    shape: BodyShape;
+}
+export declare function detectShape(body: string): BodyShape;
+/**
+ * Pure body writer. Applies the mutation according to shape rules described
+ * in contracts/scope-writer.md. Idempotent in both directions.
+ */
+export declare function applyScopeMutation(body: string, mutation: ScopeMutation): ScopeWriteResult;
+//# sourceMappingURL=writer.d.ts.map

package/dist/cli/commands/cockpit/scope/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/scope/writer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE1C,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,QAAQ,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEtC,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;CAClB;AAiBD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAMnD;AA4GD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,aAAa,GACtB,gBAAgB,CAoBlB"}

package/dist/cli/commands/cockpit/scope/writer.js

@@ -0,0 +1,141 @@
+import { parseRef } from '@generacy-ai/cockpit';
+// Byte-exact against parseEpicBody's HEADING_L3_RE (invariant I-1).
+const HEADING_L3_RE = /^###\s+/;
+const AD_HOC_HEADING_RE = /^##\s+ad-hoc\s*$/i;
+const HEADING_L2_RE = /^##\s+/;
+const HEADING_L1_RE = /^#\s+/;
+const TASK_LIST_RE = /^\s*-\s*\[[ xX]\]\s+(.+?)\s*$/;
+function refKey(ref) {
+    return `${ref.repo}#${ref.number}`;
+}
+function formatRefLine(ref) {
+    return `- [ ] ${ref.repo}#${ref.number}`;
+}
+export function detectShape(body) {
+    const lines = body.split(/\r?\n/);
+    for (const line of lines) {
+        if (HEADING_L3_RE.test(line))
+            return 'phased';
+    }
+    return 'flat';
+}
+function lineMatchesRef(line, ref) {
+    const m = TASK_LIST_RE.exec(line);
+    if (m == null)
+        return false;
+    const refText = m[1].trim();
+    const refToken = refText.split(/\s+/)[0];
+    const parsed = parseRef(refToken);
+    if (parsed == null)
+        return false;
+    return parsed.repo === ref.repo && parsed.number === ref.number;
+}
+function bodyContainsRef(body, ref) {
+    const lines = body.split(/\r?\n/);
+    return lines.some((l) => lineMatchesRef(l, ref));
+}
+function joinLines(lines) {
+    return lines.join('\n');
+}
+function ensureTrailingNewline(body) {
+    return body.endsWith('\n') ? body : body + '\n';
+}
+// Section boundary: a heading at level <= 2 (## or #), or another ## Ad-hoc,
+// terminates the Ad-hoc section. #### and #####+ do not terminate (they're
+// subsections of the Ad-hoc section).
+function isAdhocSectionBoundary(line) {
+    return HEADING_L1_RE.test(line) || HEADING_L2_RE.test(line);
+}
+function findAdhocRange(lines) {
+    for (let i = 0; i < lines.length; i++) {
+        if (AD_HOC_HEADING_RE.test(lines[i])) {
+            let end = lines.length;
+            for (let j = i + 1; j < lines.length; j++) {
+                if (isAdhocSectionBoundary(lines[j])) {
+                    end = j;
+                    break;
+                }
+            }
+            return { headingIdx: i, endIdx: end };
+        }
+    }
+    return null;
+}
+function findLastTaskListInRange(lines, startIdx, endIdx) {
+    for (let i = endIdx - 1; i > startIdx; i--) {
+        if (TASK_LIST_RE.test(lines[i]))
+            return i;
+    }
+    return -1;
+}
+function addToPhased(body, ref) {
+    // Strip trailing newline so split('\n') doesn't produce a phantom empty
+    // element that scrambles insertion positions. Reattach on the way out.
+    const hadTrailingNewline = body.endsWith('\n');
+    const workBody = hadTrailingNewline ? body.slice(0, -1) : body;
+    const lines = workBody.length === 0 ? [] : workBody.split('\n');
+    const range = findAdhocRange(lines);
+    const newLine = formatRefLine(ref);
+    let outLines;
+    if (range != null) {
+        const lastTask = findLastTaskListInRange(lines, range.headingIdx, range.endIdx);
+        if (lastTask >= 0) {
+            outLines = [...lines.slice(0, lastTask + 1), newLine, ...lines.slice(lastTask + 1)];
+        }
+        else {
+            const insertAt = range.headingIdx + 1;
+            const next = lines[insertAt];
+            if (next == null) {
+                outLines = [...lines, '', newLine];
+            }
+            else if (next.trim() === '') {
+                outLines = [...lines.slice(0, insertAt + 1), newLine, ...lines.slice(insertAt + 1)];
+            }
+            else {
+                outLines = [...lines.slice(0, insertAt), '', newLine, '', ...lines.slice(insertAt)];
+            }
+        }
+    }
+    else {
+        outLines = [...lines, '', '## Ad-hoc', '', newLine];
+    }
+    const joined = joinLines(outLines);
+    return hadTrailingNewline ? joined + '\n' : joined;
+}
+function addToFlat(body, ref) {
+    const newLine = formatRefLine(ref);
+    if (body.length === 0)
+        return `${newLine}\n`;
+    const withNewline = ensureTrailingNewline(body);
+    return `${withNewline}${newLine}\n`;
+}
+function removeMatchingLine(body, ref) {
+    const lines = body.split('\n');
+    const idx = lines.findIndex((l) => lineMatchesRef(l, ref));
+    if (idx < 0)
+        return body;
+    return joinLines([...lines.slice(0, idx), ...lines.slice(idx + 1)]);
+}
+/**
+ * Pure body writer. Applies the mutation according to shape rules described
+ * in contracts/scope-writer.md. Idempotent in both directions.
+ */
+export function applyScopeMutation(body, mutation) {
+    const shape = detectShape(body);
+    if (mutation.kind === 'add') {
+        if (bodyContainsRef(body, mutation.ref)) {
+            return { noop: true, body, shape };
+        }
+        const next = shape === 'phased'
+            ? addToPhased(body, mutation.ref)
+            : addToFlat(body, mutation.ref);
+        return { noop: false, body: next, shape };
+    }
+    // remove
+    if (!bodyContainsRef(body, mutation.ref)) {
+        return { noop: true, body, shape };
+    }
+    const next = removeMatchingLine(body, mutation.ref);
+    return { noop: false, body: next, shape };
+}
+//# sourceMappingURL=writer.js.map