@generacy-ai/generacy 0.3.3 → 0.4.0

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":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,iBAAiB,GAGlB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAiB,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAsB,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAgBvD,MAAM,YAAY,GAA6B;IAC7C,SAAS;IACT,SAAS;IACT,MAAM;IACN,OAAO;IACP,WAAW;IACX,UAAU;CACX,CAAC;AAEF,SAAS,YAAY,CAAC,SAAiB;IACrC,OAAQ,YAAkC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AACjE,CAAC;AAqBD,SAAS,yBAAyB,CAAC,MAAgB;IACjD,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;IACpE,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,SAAS,QAAQ,CAAC,MAAgB,EAAE,gBAAyB;IAC3D,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAE1E,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,IAAI,EAAE,wBAAwB,EAAE,YAAY,EAAE,CAAC;IAC1D,CAAC;IAED,MAAM,WAAW,GAAG,YAAY,CAAC,CAAC,CAAE,CAAC;IACrC,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,IAAI,EAAE,sBAAsB,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;IACpE,CAAC;IACD,MAAM,WAAW,GAAG,WAAW,CAAC;IAEhC,MAAM,YAAY,GAAG,gBAAgB,IAAI,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAC3E,MAAM,UAAU,GAAG,oBAAoB,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACnE,IAAI,UAAU,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;QAC5C,OAAO,EAAE,IAAI,EAAE,0BAA0B,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC;IACzE,CAAC;IACD,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;IAE7B,MAAM,kBAAkB,GAAG,MAAM,CAAC,IAAI,CACpC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,YAAY,CAC/D,CAAC;IACF,IAAI,kBAAkB,EAAE,CAAC;QACvB,OAAO;YACL,IAAI,EAAE,4BAA4B;YAClC,WAAW;YACX,gBAAgB,EAAE,kBAAkB;YACpC,aAAa,EAAE,IAAI,CAAC,YAAY;SACjC,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;IAC7E,MAAM,cAAc,GAAG,CAAC,WAAW,CAAC,CAAC;IACrC,IAAI,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC;QAAE,cAAc,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,SAAS,WAAW,EAAE,CAAC;IAC1C,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAEjE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAA0B,EAAE;IACxD,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClC,GAAG;SACA,WAAW,CAAC,6DAA6D,CAAC;SAC1E,QAAQ,CAAC,SAAS,EAAE,wDAAwD,CAAC;SAC7E,MAAM,CAAC,mBAAmB,EAAE,0EAA0E,CAAC;SACvG,MAAM,CAAC,KAAK,EAAE,KAAyB,EAAE,IAAmB,EAAE,EAAE;QAC/D,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC;gBAC5E,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACpB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACzB,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;IACL,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,KAAyB,EACzB,IAAmB,EACnB,IAAuB;IAEvB,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC;IAE3E,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACzC,MAAM,IAAI,WAAW,CAAC,CAAC,EAAE,0DAA0D,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC;IAChE,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ;QAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAE7C,IAAI,GAAa,CAAC;IAClB,IAAI,EAAa,CAAC;IAClB,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,mBAAmB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9E,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC;QACtB,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,WAAW,CAAC,EAAE,CAAC;IACjC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,WAAW,CAAC,CAAC,EAAE,0BAA2B,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED,IAAI,MAAgB,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IACnE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,WAAW,CAAC,CAAC,EAAE,yCAA0C,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEjD,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,OAAO;YACV,KAAK,CACH,SAAS,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,wEAAwE,CACvG,CAAC;YACF,OAAO;QAET,KAAK,wBAAwB;YAC3B,MAAM,IAAI,WAAW,CACnB,CAAC,EACD,iFAAiF,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACrH,CAAC;QAEJ,KAAK,sBAAsB;YACzB,MAAM,IAAI,WAAW,CACnB,CAAC,EACD,6DAA6D,QAAQ,CAAC,WAAW,eAAe,QAAQ,CAAC,WAAW,GAAG,CACxH,CAAC;QAEJ,KAAK,0BAA0B;YAC7B,MAAM,IAAI,WAAW,CACnB,CAAC,EACD,qDAAqD,QAAQ,CAAC,WAAW,2BAA2B;gBAClG,iBAAiB,QAAQ,CAAC,YAAY,iDAAiD,CAC1F,CAAC;QAEJ,KAAK,4BAA4B;YAC/B,MAAM,IAAI,WAAW,CACnB,CAAC,EACD,0DAA0D,QAAQ,CAAC,gBAAgB,oBAAoB;gBACrG,6BAA6B,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CACrF,CAAC;QAEJ,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;YAChE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,IAAI,WAAW,CACnB,CAAC,EACD,6CAA6C,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,MAAO,GAAa,CAAC,OAAO,EAAE,CAC1G,CAAC;YACJ,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;YACtE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,IAAI,WAAW,CACnB,CAAC,EACD,gDAAgD,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,MAAO,GAAa,CAAC,OAAO,EAAE,CAChH,CAAC;YACJ,CAAC;YAED,KAAK,CACH,WAAW,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,oBAAoB,QAAQ,CAAC,WAAW,GAAG;gBACzE,sBAAsB,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI;gBAC5C,UAAU,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI;gBAC5C,YAAY,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CACnD,CAAC;YACF,OAAO;QACT,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/cli/commands/cockpit/shared/classify-issue.d.ts

@@ -0,0 +1,12 @@
+import type { CockpitState } from '@generacy-ai/cockpit';
+export interface ClassifiedIssue {
+    state: CockpitState;
+    sourceLabel: string;
+    labels: string[];
+}
+/**
+ * Thin wrapper over `classify(labels)` — always returns `{ state, sourceLabel, labels }`
+ * with `labels` preserved alongside the classification.
+ */
+export declare function classifyIssue(labels: string[]): ClassifiedIssue;
+//# sourceMappingURL=classify-issue.d.ts.map

package/dist/cli/commands/cockpit/shared/classify-issue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify-issue.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/shared/classify-issue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,eAAe,CAG/D"}

package/dist/cli/commands/cockpit/shared/classify-issue.js

@@ -0,0 +1,10 @@
+import { classify } from '@generacy-ai/cockpit';
+/**
+ * Thin wrapper over `classify(labels)` — always returns `{ state, sourceLabel, labels }`
+ * with `labels` preserved alongside the classification.
+ */
+export function classifyIssue(labels) {
+    const { state, sourceLabel } = classify(labels);
+    return { state, sourceLabel, labels: [...labels] };
+}
+//# sourceMappingURL=classify-issue.js.map

package/dist/cli/commands/cockpit/shared/classify-issue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify-issue.js","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/shared/classify-issue.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAQhD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,MAAgB;IAC5C,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC;AACrD,CAAC"}

package/dist/cli/commands/cockpit/shared/failing-check-json.d.ts

@@ -0,0 +1,53 @@
+import type { LinkMethod, PrCandidate } from '@generacy-ai/cockpit';
+import type { FailingCheck } from './required-checks.js';
+export type { LinkMethod, PrCandidate } from '@generacy-ai/cockpit';
+export type RedReason = 'checks-failing' | 'missing-label' | 'unresolved' | 'pr-is-draft' | 'ambiguous-resolution' | 'pr-flag-linkage-refused' | 'pr-flag-closed-unmerged' | 'pr-number';
+/** FR-006a — sub-kind for `pr-flag-linkage-refused` refusals. */
+export type PrFlagLinkageKind = 'empty-refs' | 'mismatch';
+export interface IssueRefWithState {
+    owner: string;
+    repo: string;
+    number: number;
+    state?: 'OPEN' | 'CLOSED';
+    stateReason?: string | null;
+}
+export interface FailingCheckPayload {
+    status: 'red';
+    reason: RedReason;
+    pr: {
+        number: number;
+        url: string;
+        linkMethod?: LinkMethod;
+    } | null;
+    candidates?: PrCandidate[];
+    linkMethod?: LinkMethod;
+    failingChecks: FailingCheck[];
+    issue?: IssueRefWithState;
+    /** FR-006a — sub-kind for `pr-flag-linkage-refused` refusals. */
+    kind?: PrFlagLinkageKind;
+    /** Human-readable remediation string for pr-flag refusals. */
+    message?: string;
+    /** #928 — human-readable remediation string for `reason: 'pr-number'`. */
+    hint?: string;
+}
+export interface BuildFailingCheckInput {
+    reason: RedReason;
+    pr: {
+        number: number;
+        url: string;
+        linkMethod?: LinkMethod;
+    } | null;
+    candidates?: PrCandidate[];
+    linkMethod?: LinkMethod;
+    failingChecks?: FailingCheck[];
+    issue?: IssueRefWithState;
+    /** Only for `pr-flag-linkage-refused`. */
+    kind?: PrFlagLinkageKind;
+    /** Only for `pr-flag-linkage-refused` and `pr-flag-closed-unmerged`. */
+    message?: string;
+    /** #928 — required for `reason: 'pr-number'`. Guidance copy for the caller. */
+    hint?: string;
+}
+export declare function buildFailingCheckPayload(input: BuildFailingCheckInput): FailingCheckPayload;
+export declare function serializeFailingCheckJson(payload: FailingCheckPayload): string;
+//# sourceMappingURL=failing-check-json.d.ts.map

package/dist/cli/commands/cockpit/shared/failing-check-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failing-check-json.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/shared/failing-check-json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEpE,MAAM,MAAM,SAAS,GACjB,gBAAgB,GAChB,eAAe,GACf,YAAY,GACZ,aAAa,GACb,sBAAsB,GACtB,yBAAyB,GACzB,yBAAyB,GACzB,WAAW,CAAC;AAEhB,iEAAiE;AACjE,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,UAAU,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,KAAK,CAAC;IACd,MAAM,EAAE,SAAS,CAAC;IAClB,EAAE,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,UAAU,CAAA;KAAE,GAAG,IAAI,CAAC;IACpE,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,iEAAiE;IACjE,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,SAAS,CAAC;IAClB,EAAE,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,UAAU,CAAA;KAAE,GAAG,IAAI,CAAC;IACpE,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAC/B,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,0CAA0C;IAC1C,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,sBAAsB,GAC5B,mBAAmB,CA2OrB;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,mBAAmB,GAC3B,MAAM,CAER"}

package/dist/cli/commands/cockpit/shared/failing-check-json.js

@@ -0,0 +1,170 @@
+export function buildFailingCheckPayload(input) {
+    const { reason, pr, candidates, linkMethod, failingChecks = [], issue, kind, message, hint } = input;
+    if (issue !== undefined) {
+        // I-6: state and stateReason are paired — if state is set, stateReason
+        // must also be present (may be null). Guards against callers accidentally
+        // dropping stateReason when they intend to carry state.
+        const hasState = 'state' in issue;
+        const hasStateReason = 'stateReason' in issue;
+        if (hasState !== hasStateReason) {
+            throw new Error("FailingCheckPayload invariant I-6: issue.state and issue.stateReason must be set together");
+        }
+    }
+    const applyIssue = (payload) => issue === undefined ? payload : { ...payload, issue };
+    // I-10/I-11: `candidates` and top-level `linkMethod` MUST NOT be set for
+    // single-PR reasons.
+    const isSinglePrReason = reason === 'unresolved' ||
+        reason === 'missing-label' ||
+        reason === 'checks-failing' ||
+        reason === 'pr-flag-linkage-refused' ||
+        reason === 'pr-flag-closed-unmerged' ||
+        reason === 'pr-number';
+    if (isSinglePrReason && candidates !== undefined) {
+        throw new Error(`FailingCheckPayload invariant I-10: candidates MUST NOT be set for reason='${reason}'`);
+    }
+    if (isSinglePrReason && linkMethod !== undefined) {
+        throw new Error(`FailingCheckPayload invariant I-11: top-level linkMethod MUST NOT be set for reason='${reason}'`);
+    }
+    if (reason === 'unresolved') {
+        if (failingChecks.length !== 0) {
+            throw new Error("FailingCheckPayload invariant: reason='unresolved' must have empty failingChecks");
+        }
+        return applyIssue({ status: 'red', reason, pr, failingChecks: [] });
+    }
+    if (reason === 'missing-label') {
+        if (pr == null) {
+            throw new Error("FailingCheckPayload invariant: reason='missing-label' requires non-null pr");
+        }
+        if (pr.linkMethod === undefined) {
+            throw new Error("FailingCheckPayload invariant I-9: reason='missing-label' requires pr.linkMethod to be set");
+        }
+        if (failingChecks.length !== 0) {
+            throw new Error("FailingCheckPayload invariant: reason='missing-label' must have empty failingChecks");
+        }
+        return applyIssue({ status: 'red', reason, pr, failingChecks: [] });
+    }
+    if (reason === 'checks-failing') {
+        if (pr == null) {
+            throw new Error("FailingCheckPayload invariant: reason='checks-failing' requires non-null pr");
+        }
+        if (pr.linkMethod === undefined) {
+            throw new Error("FailingCheckPayload invariant I-9: reason='checks-failing' requires pr.linkMethod to be set");
+        }
+        if (failingChecks.length === 0) {
+            throw new Error("FailingCheckPayload invariant: reason='checks-failing' requires non-empty failingChecks");
+        }
+        return applyIssue({ status: 'red', reason, pr, failingChecks });
+    }
+    if (reason === 'pr-is-draft') {
+        if (pr !== null) {
+            throw new Error("FailingCheckPayload invariant I-7: reason='pr-is-draft' requires pr === null");
+        }
+        if (!candidates || candidates.length < 1) {
+            throw new Error("FailingCheckPayload invariant I-7: reason='pr-is-draft' requires candidates.length >= 1");
+        }
+        if (candidates.some((c) => c.isDraft !== true)) {
+            throw new Error("FailingCheckPayload invariant I-7: reason='pr-is-draft' requires every candidate.isDraft === true");
+        }
+        if (linkMethod === undefined) {
+            throw new Error("FailingCheckPayload invariant I-7: reason='pr-is-draft' requires top-level linkMethod");
+        }
+        if (failingChecks.length !== 0) {
+            throw new Error("FailingCheckPayload invariant I-7: reason='pr-is-draft' must have empty failingChecks");
+        }
+        return applyIssue({
+            status: 'red',
+            reason,
+            pr: null,
+            candidates,
+            linkMethod,
+            failingChecks: [],
+        });
+    }
+    if (reason === 'ambiguous-resolution') {
+        if (pr !== null) {
+            throw new Error("FailingCheckPayload invariant I-8: reason='ambiguous-resolution' requires pr === null");
+        }
+        if (!candidates || candidates.length < 2) {
+            throw new Error("FailingCheckPayload invariant I-8: reason='ambiguous-resolution' requires candidates.length >= 2");
+        }
+        if (candidates.some((c) => c.isDraft !== false)) {
+            throw new Error("FailingCheckPayload invariant I-8: reason='ambiguous-resolution' requires every candidate.isDraft === false");
+        }
+        if (linkMethod === undefined) {
+            throw new Error("FailingCheckPayload invariant I-8: reason='ambiguous-resolution' requires top-level linkMethod");
+        }
+        if (failingChecks.length !== 0) {
+            throw new Error("FailingCheckPayload invariant I-8: reason='ambiguous-resolution' must have empty failingChecks");
+        }
+        return applyIssue({
+            status: 'red',
+            reason,
+            pr: null,
+            candidates,
+            linkMethod,
+            failingChecks: [],
+        });
+    }
+    if (reason === 'pr-flag-linkage-refused') {
+        if (pr == null) {
+            throw new Error("FailingCheckPayload invariant: reason='pr-flag-linkage-refused' requires non-null pr");
+        }
+        if (kind !== 'empty-refs' && kind !== 'mismatch') {
+            throw new Error("FailingCheckPayload invariant: reason='pr-flag-linkage-refused' requires kind ∈ { 'empty-refs' | 'mismatch' }");
+        }
+        if (failingChecks.length !== 0) {
+            throw new Error("FailingCheckPayload invariant: reason='pr-flag-linkage-refused' must have empty failingChecks");
+        }
+        const base = {
+            status: 'red',
+            reason,
+            pr,
+            failingChecks: [],
+            kind,
+        };
+        if (message !== undefined)
+            base.message = message;
+        return applyIssue(base);
+    }
+    if (reason === 'pr-number') {
+        // #928 — the caller's `<issue>` argument is itself a PR node.
+        if (pr !== null) {
+            throw new Error("FailingCheckPayload invariant: reason='pr-number' requires pr === null");
+        }
+        if (typeof hint !== 'string' || hint.length === 0) {
+            throw new Error("FailingCheckPayload invariant: reason='pr-number' requires a non-empty hint");
+        }
+        if (failingChecks.length !== 0) {
+            throw new Error("FailingCheckPayload invariant: reason='pr-number' must have empty failingChecks");
+        }
+        return applyIssue({
+            status: 'red',
+            reason,
+            pr: null,
+            failingChecks: [],
+            hint,
+        });
+    }
+    if (reason === 'pr-flag-closed-unmerged') {
+        if (pr == null) {
+            throw new Error("FailingCheckPayload invariant: reason='pr-flag-closed-unmerged' requires non-null pr");
+        }
+        if (failingChecks.length !== 0) {
+            throw new Error("FailingCheckPayload invariant: reason='pr-flag-closed-unmerged' must have empty failingChecks");
+        }
+        const base = {
+            status: 'red',
+            reason,
+            pr,
+            failingChecks: [],
+        };
+        if (message !== undefined)
+            base.message = message;
+        return applyIssue(base);
+    }
+    throw new Error(`FailingCheckPayload: unknown reason ${reason}`);
+}
+export function serializeFailingCheckJson(payload) {
+    return JSON.stringify(payload) + '\n';
+}
+//# sourceMappingURL=failing-check-json.js.map

package/dist/cli/commands/cockpit/shared/failing-check-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failing-check-json.js","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/shared/failing-check-json.ts"],"names":[],"mappings":"AAyDA,MAAM,UAAU,wBAAwB,CACtC,KAA6B;IAE7B,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IAErG,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,uEAAuE;QACvE,0EAA0E;QAC1E,wDAAwD;QACxD,MAAM,QAAQ,GAAG,OAAO,IAAI,KAAK,CAAC;QAClC,MAAM,cAAc,GAAG,aAAa,IAAI,KAAK,CAAC;QAC9C,IAAI,QAAQ,KAAK,cAAc,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,2FAA2F,CAC5F,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,CACjB,OAA4B,EACP,EAAE,CACvB,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,CAAC;IAExD,yEAAyE;IACzE,qBAAqB;IACrB,MAAM,gBAAgB,GACpB,MAAM,KAAK,YAAY;QACvB,MAAM,KAAK,eAAe;QAC1B,MAAM,KAAK,gBAAgB;QAC3B,MAAM,KAAK,yBAAyB;QACpC,MAAM,KAAK,yBAAyB;QACpC,MAAM,KAAK,WAAW,CAAC;IACzB,IAAI,gBAAgB,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CACb,8EAA8E,MAAM,GAAG,CACxF,CAAC;IACJ,CAAC;IACD,IAAI,gBAAgB,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CACb,wFAAwF,MAAM,GAAG,CAClG,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,KAAK,YAAY,EAAE,CAAC;QAC5B,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CACb,kFAAkF,CACnF,CAAC;QACJ,CAAC;QACD,OAAO,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,IAAI,MAAM,KAAK,eAAe,EAAE,CAAC;QAC/B,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,4EAA4E,CAC7E,CAAC;QACJ,CAAC;QACD,IAAI,EAAE,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,4FAA4F,CAC7F,CAAC;QACJ,CAAC;QACD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CACb,qFAAqF,CACtF,CAAC;QACJ,CAAC;QACD,OAAO,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,IAAI,MAAM,KAAK,gBAAgB,EAAE,CAAC;QAChC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,6EAA6E,CAC9E,CAAC;QACJ,CAAC;QACD,IAAI,EAAE,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,6FAA6F,CAC9F,CAAC;QACJ,CAAC;QACD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CACb,yFAAyF,CAC1F,CAAC;QACJ,CAAC;QACD,OAAO,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,IAAI,MAAM,KAAK,aAAa,EAAE,CAAC;QAC7B,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CACb,yFAAyF,CAC1F,CAAC;QACJ,CAAC;QACD,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CACb,mGAAmG,CACpG,CAAC;QACJ,CAAC;QACD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,uFAAuF,CACxF,CAAC;QACJ,CAAC;QACD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CACb,uFAAuF,CACxF,CAAC;QACJ,CAAC;QACD,OAAO,UAAU,CAAC;YAChB,MAAM,EAAE,KAAK;YACb,MAAM;YACN,EAAE,EAAE,IAAI;YACR,UAAU;YACV,UAAU;YACV,aAAa,EAAE,EAAE;SAClB,CAAC,CAAC;IACL,CAAC;IAED,IAAI,MAAM,KAAK,sBAAsB,EAAE,CAAC;QACtC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,uFAAuF,CACxF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CACb,kGAAkG,CACnG,CAAC;QACJ,CAAC;QACD,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CACb,6GAA6G,CAC9G,CAAC;QACJ,CAAC;QACD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,gGAAgG,CACjG,CAAC;QACJ,CAAC;QACD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CACb,gGAAgG,CACjG,CAAC;QACJ,CAAC;QACD,OAAO,UAAU,CAAC;YAChB,MAAM,EAAE,KAAK;YACb,MAAM;YACN,EAAE,EAAE,IAAI;YACR,UAAU;YACV,UAAU;YACV,aAAa,EAAE,EAAE;SAClB,CAAC,CAAC;IACL,CAAC;IAED,IAAI,MAAM,KAAK,yBAAyB,EAAE,CAAC;QACzC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,sFAAsF,CACvF,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YACjD,MAAM,IAAI,KAAK,CACb,+GAA+G,CAChH,CAAC;QACJ,CAAC;QACD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CACb,+FAA+F,CAChG,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAwB;YAChC,MAAM,EAAE,KAAK;YACb,MAAM;YACN,EAAE;YACF,aAAa,EAAE,EAAE;YACjB,IAAI;SACL,CAAC;QACF,IAAI,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAClD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;QAC3B,8DAA8D;QAC9D,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,wEAAwE,CACzE,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CACb,6EAA6E,CAC9E,CAAC;QACJ,CAAC;QACD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAC;QACJ,CAAC;QACD,OAAO,UAAU,CAAC;YAChB,MAAM,EAAE,KAAK;YACb,MAAM;YACN,EAAE,EAAE,IAAI;YACR,aAAa,EAAE,EAAE;YACjB,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAED,IAAI,MAAM,KAAK,yBAAyB,EAAE,CAAC;QACzC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,sFAAsF,CACvF,CAAC;QACJ,CAAC;QACD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CACb,+FAA+F,CAChG,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAwB;YAChC,MAAM,EAAE,KAAK;YACb,MAAM;YACN,EAAE;YACF,aAAa,EAAE,EAAE;SAClB,CAAC;QACF,IAAI,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAClD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,uCAAuC,MAAgB,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,OAA4B;IAE5B,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;AACxC,CAAC"}

package/dist/cli/commands/cockpit/shared/identity.d.ts

@@ -0,0 +1,54 @@
+/**
+ * `resolveCockpitIdentity` — resolve the GitHub identity used by cockpit
+ * subcommands (queue, advance), mirroring `packages/orchestrator/src/services/
+ * identity.ts` precedence so App-credentialed clusters don't 403 on `gh api user`.
+ *
+ * Precedence (first non-null / non-empty / non-throwing tier wins):
+ *   1a. `flag`                        — `--assignee <login>` CLI flag
+ *   1b. `configAssignee`              — `cockpit.assignee` in `.generacy/config.yaml`
+ *   2a. `env.CLUSTER_GITHUB_USERNAME` — cluster-wide env
+ *   2b. `env.GH_USERNAME`             — cluster-wide env (wizard-delivered)
+ *   3.  `gh.getCurrentUser()`         — `gh api user`
+ *
+ * Two modes:
+ *   - `required` — throws `LoudIdentityError` naming all four knobs on all-miss.
+ *   - `optional` — logs a warning naming all four knobs and returns
+ *     `{ login: undefined, source: 'none' }`.
+ */
+import type { GhWrapper } from '@generacy-ai/cockpit';
+export type IdentitySource = 'flag' | 'config' | 'CLUSTER_GITHUB_USERNAME' | 'GH_USERNAME' | 'gh-api' | 'none';
+export interface ResolveCockpitIdentityInput {
+    flag?: string;
+    configAssignee?: string;
+    gh: Pick<GhWrapper, 'getCurrentUser'>;
+    logger: {
+        warn(msg: string): void;
+        info?(msg: string): void;
+    };
+    verb: string;
+    mode: 'required' | 'optional';
+    env?: NodeJS.ProcessEnv;
+}
+export type ResolveCockpitIdentityResult = {
+    login: string;
+    source: Exclude<IdentitySource, 'none'>;
+} | {
+    login: undefined;
+    source: 'none';
+};
+export declare class LoudIdentityError extends Error {
+    readonly code: "IDENTITY_UNRESOLVED";
+    readonly verb: string;
+    constructor(verb: string, message: string);
+}
+export declare function resolveCockpitIdentity(input: ResolveCockpitIdentityInput & {
+    mode: 'required';
+}): Promise<{
+    login: string;
+    source: Exclude<IdentitySource, 'none'>;
+}>;
+export declare function resolveCockpitIdentity(input: ResolveCockpitIdentityInput & {
+    mode: 'optional';
+}): Promise<ResolveCockpitIdentityResult>;
+export declare function resolveCockpitIdentity(input: ResolveCockpitIdentityInput): Promise<ResolveCockpitIdentityResult>;
+//# sourceMappingURL=identity.d.ts.map

package/dist/cli/commands/cockpit/shared/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/shared/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,QAAQ,GACR,yBAAyB,GACzB,aAAa,GACb,QAAQ,GACR,MAAM,CAAC;AAEX,MAAM,WAAW,2BAA2B;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;IACtC,MAAM,EAAE;QAAE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,UAAU,CAAC;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,MAAM,MAAM,4BAA4B,GACpC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC,CAAA;CAAE,GAC1D;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAG,qBAAqB,CAAU;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBACV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C;AAkBD,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,2BAA2B,GAAG;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACxD,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,CAAC;AACvE,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,2BAA2B,GAAG;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACxD,OAAO,CAAC,4BAA4B,CAAC,CAAC;AACzC,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,4BAA4B,CAAC,CAAC"}

package/dist/cli/commands/cockpit/shared/identity.js

@@ -0,0 +1,65 @@
+export class LoudIdentityError extends Error {
+    code = 'IDENTITY_UNRESOLVED';
+    verb;
+    constructor(verb, message) {
+        super(message);
+        this.name = 'LoudIdentityError';
+        this.verb = verb;
+    }
+}
+function buildFourKnobMessage(verb) {
+    return (`cockpit ${verb}: unable to resolve GitHub identity.\n` +
+        'Set one of the following:\n' +
+        '  --assignee <login>                        (flag, per-invocation)\n' +
+        '  cockpit.assignee in .generacy/config.yaml (per-repo)\n' +
+        '  CLUSTER_GITHUB_USERNAME                   (env, cluster-wide)\n' +
+        '  GH_USERNAME                               (env, cluster-wide)\n' +
+        'Or authenticate `gh` for a user-token (gh auth login) so `gh api user` can resolve.');
+}
+function nonEmpty(v) {
+    return typeof v === 'string' && v.length > 0;
+}
+export async function resolveCockpitIdentity(input) {
+    const env = input.env ?? process.env;
+    const { flag, configAssignee, gh, logger, verb, mode } = input;
+    if (nonEmpty(flag)) {
+        logger.info?.(`cockpit ${verb}: identity resolved from --assignee flag (${flag})`);
+        return { login: flag, source: 'flag' };
+    }
+    if (nonEmpty(configAssignee)) {
+        logger.info?.(`cockpit ${verb}: identity resolved from cockpit.assignee config (${configAssignee})`);
+        return { login: configAssignee, source: 'config' };
+    }
+    const clusterEnv = env['CLUSTER_GITHUB_USERNAME'];
+    if (nonEmpty(clusterEnv)) {
+        logger.info?.(`cockpit ${verb}: identity resolved from CLUSTER_GITHUB_USERNAME (${clusterEnv})`);
+        return { login: clusterEnv, source: 'CLUSTER_GITHUB_USERNAME' };
+    }
+    const ghEnv = env['GH_USERNAME'];
+    if (nonEmpty(ghEnv)) {
+        logger.info?.(`cockpit ${verb}: identity resolved from GH_USERNAME (${ghEnv})`);
+        return { login: ghEnv, source: 'GH_USERNAME' };
+    }
+    try {
+        const login = await gh.getCurrentUser();
+        if (nonEmpty(login)) {
+            logger.info?.(`cockpit ${verb}: identity resolved from gh api user (${login})`);
+            return { login, source: 'gh-api' };
+        }
+    }
+    catch (err) {
+        if (mode === 'optional') {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.info?.(`cockpit ${verb}: gh api user failed: ${msg}`);
+        }
+        // Fall through to the four-knob failure branch. The individual error is
+        // not surfaced in the loud message — the four knobs are the actionable fix.
+    }
+    const message = buildFourKnobMessage(verb);
+    if (mode === 'required') {
+        throw new LoudIdentityError(verb, message);
+    }
+    logger.warn(`warning: ${message}`);
+    return { login: undefined, source: 'none' };
+}
+//# sourceMappingURL=identity.js.map

package/dist/cli/commands/cockpit/shared/identity.js.map

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

package/dist/cli/commands/cockpit/shared/is-done-snapshot.d.ts

@@ -0,0 +1,16 @@
+import type { Snapshot } from '../watch/snapshot.js';
+/**
+ * Issue state: closed dominates any label-derived actionability tier.
+ *
+ * A closed issue carrying `completed:validate` (or any other actionable-label
+ * residue) is done, not actionable. This helper is the single decision
+ * surface: both `isActionableSnapshot` (watch) and the status renderer route
+ * through it. If you need to expand actionability tiers, extend
+ * `isActionableSnapshot` — do not add a second done-gate.
+ *
+ * The predicate reads raw `snap.state`, NOT `snap.classified.state`. The
+ * classified `'terminal'` tier is exactly the label residue this fix stops
+ * trusting; reading it would perpetuate the bug pattern (#873).
+ */
+export declare function isDoneSnapshot(snap: Snapshot): boolean;
+//# sourceMappingURL=is-done-snapshot.d.ts.map