@generacy-ai/generacy 0.3.4 → 0.5.0

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

@@ -0,0 +1,90 @@
+/**
+ * `generacy cockpit context <issue>` — classify the issue's current
+ * `waiting-for:*` gate and emit the bundle that gate needs. Single JSON line
+ * on stdout.
+ *
+ * Gates and bundle shapes are defined in
+ * `specs/807-epic-generacy-ai-tetrad/contracts/*.schema.json`.
+ *
+ * Exit codes (per FR-004):
+ *   0 — bundle emitted
+ *   1 — gh IO failure
+ *   2 — ref-parse failure (bare number without inferrable origin, etc.)
+ *   3 — gate refusal (no waiting-for:*, completed:validate, unsupported gate,
+ *       PR-scoped gate with no resolvable PR)
+ */
+import { Command } from 'commander';
+import { type CommandRunner, type GhWrapper } from '@generacy-ai/cockpit';
+type ArtifactPathsGate = 'waiting-for:spec-review' | 'waiting-for:plan-review' | 'waiting-for:tasks-review';
+export interface ArtifactOutput {
+    path: string;
+    body: string;
+}
+export interface ClarificationCommentOutput {
+    body: string;
+    author: string;
+    createdAt: string;
+    url: string;
+}
+export interface CodeReferencesOutput {
+    prUrl: string;
+    touchedFiles: string[];
+    diffPatch: string;
+}
+export interface ClarificationBundle {
+    issue: string;
+    gate: 'waiting-for:clarification';
+    clarificationComment: ClarificationCommentOutput | null;
+    spec: ArtifactOutput | null;
+    plan: ArtifactOutput | null;
+    codeReferences: CodeReferencesOutput | null;
+}
+export interface ImplementationReviewBundle {
+    issue: string;
+    gate: 'waiting-for:implementation-review';
+    pr: {
+        number: number;
+        title: string;
+        url: string;
+        base: string;
+        head: string;
+        body: string;
+        author: string | null;
+        state: 'OPEN' | 'CLOSED' | 'MERGED';
+        draft: boolean;
+    };
+    diff: string;
+    diffTruncated: boolean;
+    checks: Array<{
+        name: string;
+        state: 'SUCCESS' | 'FAILURE' | 'PENDING' | 'NEUTRAL' | 'SKIPPED' | 'CANCELLED';
+        conclusion?: string;
+        url?: string;
+    }>;
+}
+export interface ArtifactPathsBundle {
+    issue: string;
+    gate: ArtifactPathsGate;
+    artifacts: {
+        spec: ArtifactOutput | null;
+        plan: ArtifactOutput | null;
+        tasks: ArtifactOutput | null;
+    };
+}
+export type ContextBundle = ClarificationBundle | ImplementationReviewBundle | ArtifactPathsBundle;
+export interface ContextCommandDeps {
+    runner?: CommandRunner;
+    gh?: GhWrapper;
+    /** Override `git branch --show-current`. */
+    getBranch?: () => Promise<string>;
+    /** Repo root for `specs/<branch>/…` lookup; defaults to `process.cwd()`. */
+    cwd?: string;
+    /** Base branch for the `git diff` fallback; defaults to `develop`. */
+    baseBranch?: string;
+    stdout?: (line: string) => void;
+    stderr?: (line: string) => void;
+}
+export declare function contextCommand(deps?: ContextCommandDeps): Command;
+export declare function runContext(issueArg: string, deps?: ContextCommandDeps): Promise<ContextBundle>;
+export {};
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/cockpit/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,SAAS,EACf,MAAM,sBAAsB,CAAC;AAM9B,KAAK,iBAAiB,GAClB,yBAAyB,GACzB,yBAAyB,GACzB,0BAA0B,CAAC;AAE/B,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,2BAA2B,CAAC;IAClC,oBAAoB,EAAE,0BAA0B,GAAG,IAAI,CAAC;IACxD,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,mCAAmC,CAAC;IAC1C,EAAE,EAAE;QACF,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;QACpC,KAAK,EAAE,OAAO,CAAC;KAChB,CAAC;IACF,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;QAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,EAAE;QACT,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;QAC5B,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;QAC5B,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;KAC9B,CAAC;CACH;AAED,MAAM,MAAM,aAAa,GACrB,mBAAmB,GACnB,0BAA0B,GAC1B,mBAAmB,CAAC;AAExB,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,EAAE,CAAC,EAAE,SAAS,CAAC;IACf,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,4EAA4E;IAC5E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAWD,wBAAgB,cAAc,CAAC,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAoBrE;AAED,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,aAAa,CAAC,CA0DxB"}

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

@@ -0,0 +1,280 @@
+/**
+ * `generacy cockpit context <issue>` — classify the issue's current
+ * `waiting-for:*` gate and emit the bundle that gate needs. Single JSON line
+ * on stdout.
+ *
+ * Gates and bundle shapes are defined in
+ * `specs/807-epic-generacy-ai-tetrad/contracts/*.schema.json`.
+ *
+ * Exit codes (per FR-004):
+ *   0 — bundle emitted
+ *   1 — gh IO failure
+ *   2 — ref-parse failure (bare number without inferrable origin, etc.)
+ *   3 — gate refusal (no waiting-for:*, completed:validate, unsupported gate,
+ *       PR-scoped gate with no resolvable PR)
+ */
+import { Command } from 'commander';
+import { readFile, readdir, stat } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { WAITING_PIPELINE_ORDER, nodeChildProcessRunner, } from '@generacy-ai/cockpit';
+import { resolveIssueContext } from './resolver.js';
+import { findClarificationComment } from './clarification-comment-finder.js';
+import { buildReviewContextPayload } from './shared/review-context-json.js';
+import { CockpitExit, isCockpitExit } from './exit.js';
+const CLARIFICATION_GATE = 'waiting-for:clarification';
+const IMPLEMENTATION_REVIEW_GATE = 'waiting-for:implementation-review';
+const ARTIFACT_PATH_GATES = [
+    'waiting-for:spec-review',
+    'waiting-for:plan-review',
+    'waiting-for:tasks-review',
+];
+const COMPLETED_VALIDATE = 'completed:validate';
+export function contextCommand(deps = {}) {
+    const cmd = new Command('context');
+    cmd
+        .description('Classify the issue gate and emit the bundle that gate needs (single JSON line on stdout).')
+        .argument('<issue>', 'Issue ref — <owner>/<repo>#<n> or full URL.')
+        .action(async (issue) => {
+        try {
+            await runContext(issue, 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 runContext(issueArg, deps = {}) {
+    const print = deps.stdout ?? ((line) => process.stdout.write(`${line}\n`));
+    const runner = deps.runner ?? nodeChildProcessRunner;
+    let ref;
+    let gh;
+    try {
+        const resolvedCtx = await resolveIssueContext({ issue: issueArg, runner: deps.runner });
+        ref = resolvedCtx.ref;
+        gh = deps.gh ?? resolvedCtx.gh;
+    }
+    catch (err) {
+        throw new CockpitExit(2, `Error: cockpit context: ${err.message}`);
+    }
+    let labels;
+    try {
+        labels = (await gh.fetchIssueLabels(ref.nwo, ref.number)).labels;
+    }
+    catch (err) {
+        throw new CockpitExit(1, `Error: cockpit context: gh issue view: ${err.message}`);
+    }
+    if (labels.includes(COMPLETED_VALIDATE)) {
+        throw new CockpitExit(3, `Error: cockpit context: gate refusal: issue ${ref.nwo}#${ref.number} carries ` +
+            `completed:validate — use \`cockpit merge\``);
+    }
+    const gate = firstWaitingGate(labels);
+    if (gate == null) {
+        throw new CockpitExit(3, `Error: cockpit context: gate refusal: no waiting-for:* label on ${ref.nwo}#${ref.number} ` +
+            `(labels: ${labels.length === 0 ? '<none>' : labels.join(', ')})`);
+    }
+    const issueRepr = `${ref.nwo}#${ref.number}`;
+    let bundle;
+    if (gate === CLARIFICATION_GATE) {
+        bundle = await buildClarificationBundle(ref, issueRepr, gh, runner, deps);
+    }
+    else if (gate === IMPLEMENTATION_REVIEW_GATE) {
+        bundle = await buildImplementationReviewBundle(ref, issueRepr, gh);
+    }
+    else if (ARTIFACT_PATH_GATES.includes(gate)) {
+        bundle = await buildArtifactPathsBundle(ref, issueRepr, gate, deps);
+    }
+    else {
+        throw new CockpitExit(3, `Error: cockpit context: gate refusal: unsupported gate "${gate}" on ${issueRepr}`);
+    }
+    print(JSON.stringify(bundle));
+    return bundle;
+}
+function firstWaitingGate(labels) {
+    for (const listed of WAITING_PIPELINE_ORDER) {
+        if (labels.includes(listed))
+            return listed;
+    }
+    for (const label of labels) {
+        if (label.startsWith('waiting-for:'))
+            return label;
+    }
+    return null;
+}
+async function buildClarificationBundle(ref, issueRepr, gh, runner, deps) {
+    let comment;
+    try {
+        comment = await findClarificationComment(gh, ref.nwo, ref.number);
+    }
+    catch (err) {
+        throw new CockpitExit(1, `Error: cockpit context: clarification lookup: ${err.message}`);
+    }
+    const branch = await (deps.getBranch ?? defaultGetBranch(runner))();
+    const cwd = deps.cwd ?? process.cwd();
+    const { spec, plan } = await readSpecArtifacts(cwd, branch, ref.number);
+    const codeReferences = await buildCodeReferences(ref.nwo, branch, deps.baseBranch ?? 'develop', gh);
+    return {
+        issue: issueRepr,
+        gate: 'waiting-for:clarification',
+        clarificationComment: comment
+            ? {
+                body: comment.body,
+                author: comment.author,
+                createdAt: comment.createdAt,
+                url: comment.url,
+            }
+            : null,
+        spec,
+        plan,
+        codeReferences,
+    };
+}
+async function buildImplementationReviewBundle(ref, issueRepr, gh) {
+    let resolution;
+    try {
+        resolution = await gh.resolveIssueToPRRef(ref.nwo, ref.number);
+    }
+    catch (err) {
+        throw new CockpitExit(1, `Error: cockpit context: gh pr resolve: ${err.message}`);
+    }
+    if (resolution.kind === 'pr-is-draft') {
+        const nums = resolution.candidates.map((c) => `#${c.number}`).join(', ');
+        throw new CockpitExit(3, `Error: cockpit context: gate refusal: issue ${issueRepr} at ` +
+            `${IMPLEMENTATION_REVIEW_GATE} but linked PR(s) are drafts ` +
+            `(via ${resolution.linkMethod}): ${nums}`);
+    }
+    if (resolution.kind === 'ambiguous') {
+        const nums = resolution.candidates.map((c) => `#${c.number}`).join(', ');
+        throw new CockpitExit(3, `Error: cockpit context: gate refusal: issue ${issueRepr} at ` +
+            `${IMPLEMENTATION_REVIEW_GATE} but multiple PRs match ` +
+            `via ${resolution.linkMethod}: ${nums}`);
+    }
+    if (resolution.kind === 'unresolved') {
+        throw new CockpitExit(3, `Error: cockpit context: gate refusal: issue ${issueRepr} at ` +
+            `${IMPLEMENTATION_REVIEW_GATE} but no linked PR resolved`);
+    }
+    if (resolution.kind === 'pr-number') {
+        throw new CockpitExit(3, `Error: cockpit context: gate refusal: ${issueRepr} is a pull request; ` +
+            `pass the issue number (e.g. the issue whose closing PR is #${ref.number}).`);
+    }
+    const prRef = resolution.ref;
+    // Exhaustiveness guard — a new kind on PullRequestRefResolution surfaces here at build time.
+    const _exhaustive = resolution.kind;
+    void _exhaustive;
+    let pr, checks;
+    try {
+        [pr, checks] = await Promise.all([
+            gh.getPullRequestDetail(ref.nwo, prRef.number),
+            gh.getPullRequestCheckRuns(ref.nwo, prRef.number),
+        ]);
+    }
+    catch (err) {
+        throw new CockpitExit(1, `Error: cockpit context: gh pr detail: ${err.message}`);
+    }
+    const payload = buildReviewContextPayload({ pr, checks });
+    return {
+        issue: issueRepr,
+        gate: 'waiting-for:implementation-review',
+        pr: payload.pr,
+        diff: payload.diff,
+        diffTruncated: payload.diffTruncated,
+        checks: payload.checks,
+    };
+}
+async function buildArtifactPathsBundle(ref, issueRepr, gate, deps) {
+    const runner = deps.runner ?? nodeChildProcessRunner;
+    const branch = await (deps.getBranch ?? defaultGetBranch(runner))();
+    const cwd = deps.cwd ?? process.cwd();
+    const specDir = await findSpecDir(cwd, branch, ref.number);
+    const artifacts = specDir == null
+        ? { spec: null, plan: null, tasks: null }
+        : {
+            spec: await readArtifact(join(specDir, 'spec.md')),
+            plan: await readArtifact(join(specDir, 'plan.md')),
+            tasks: await readArtifact(join(specDir, 'tasks.md')),
+        };
+    return { issue: issueRepr, gate, artifacts };
+}
+async function buildCodeReferences(repo, branch, baseBranch, gh) {
+    if (branch === '' || branch === baseBranch)
+        return null;
+    const pr = await gh.findOpenPrForBranch(repo, branch);
+    if (pr == null)
+        return null;
+    let touchedFiles = [];
+    let diffPatch = '';
+    try {
+        touchedFiles = await gh.prDiffNames(repo, pr.number);
+    }
+    catch {
+        touchedFiles = [];
+    }
+    try {
+        diffPatch = await gh.prDiffPatch(repo, pr.number);
+    }
+    catch {
+        diffPatch = '';
+    }
+    return { prUrl: pr.url, touchedFiles, diffPatch };
+}
+async function readSpecArtifacts(cwd, branch, issueNumber) {
+    const specDir = await findSpecDir(cwd, branch, issueNumber);
+    if (specDir == null)
+        return { spec: null, plan: null };
+    return {
+        spec: await readArtifact(join(specDir, 'spec.md')),
+        plan: await readArtifact(join(specDir, 'plan.md')),
+    };
+}
+async function findSpecDir(cwd, branch, issueNumber) {
+    const specsRoot = resolve(cwd, 'specs');
+    if (branch !== '' && existsSync(join(specsRoot, branch))) {
+        return join(specsRoot, branch);
+    }
+    try {
+        const stats = await stat(specsRoot);
+        if (!stats.isDirectory())
+            return null;
+    }
+    catch {
+        return null;
+    }
+    const prefix = `${issueNumber}-`;
+    let entries;
+    try {
+        entries = await readdir(specsRoot);
+    }
+    catch {
+        return null;
+    }
+    for (const entry of entries) {
+        if (entry.startsWith(prefix)) {
+            return join(specsRoot, entry);
+        }
+    }
+    return null;
+}
+async function readArtifact(path) {
+    try {
+        const body = await readFile(path, 'utf-8');
+        return { path, body };
+    }
+    catch {
+        return null;
+    }
+}
+function defaultGetBranch(runner) {
+    return async () => {
+        const res = await runner('git', ['branch', '--show-current']);
+        if (res.exitCode !== 0)
+            return '';
+        return res.stdout.trim();
+    };
+}
+//# sourceMappingURL=context.js.map

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * Exit-code carrier for the cockpit verbs. The Commander action handler
+ * catches `CockpitExit` and translates it to `process.exit(code)` after
+ * writing the message to stderr. Tests intercept by catching the thrown
+ * error directly — no `process.exit` needed.
+ */
+export declare class CockpitExit extends Error {
+    readonly code: number;
+    constructor(code: number, message: string);
+}
+export declare function isCockpitExit(err: unknown): err is CockpitExit;
+//# sourceMappingURL=exit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exit.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/cockpit/exit.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBACV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,WAAW,CAE9D"}

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

@@ -0,0 +1,18 @@
+/**
+ * Exit-code carrier for the cockpit verbs. The Commander action handler
+ * catches `CockpitExit` and translates it to `process.exit(code)` after
+ * writing the message to stderr. Tests intercept by catching the thrown
+ * error directly — no `process.exit` needed.
+ */
+export class CockpitExit extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'CockpitExit';
+    }
+}
+export function isCockpitExit(err) {
+    return err instanceof Error && err.name === 'CockpitExit';
+}
+//# sourceMappingURL=exit.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exit.js","sourceRoot":"","sources":["../../../../src/cli/commands/cockpit/exit.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,IAAI,CAAS;IACtB,YAAY,IAAY,EAAE,OAAe;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,OAAO,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,aAAa,CAAC;AAC5D,CAAC"}

package/dist/cli/commands/cockpit/gate-vocabulary.d.ts

@@ -0,0 +1,48 @@
+import { type WorkflowPhase } from '@generacy-ai/orchestrator';
+export interface GateDefinition {
+    /** Gate name (e.g. "clarification", "plan-review"). */
+    name: string;
+    /** Full label name "waiting-for:<name>". */
+    waitingLabel: string;
+    /** Full label name "completed:<name>". */
+    completedLabel: string;
+}
+export declare const GATES: ReadonlyMap<string, GateDefinition>;
+/** List gate names in `WORKFLOW_LABELS` order — stable for `--help-gates`. */
+export declare function listGates(): string[];
+/**
+ * A gate whose completion causes the resolver to pick the failed phase as
+ * `startPhase`. Returned by `resolvePrecedingGate`.
+ */
+export interface PrecedingGate {
+    /** Gate name — e.g. "implementation-review", "tasks-review". */
+    name: string;
+    /** Full label name "waiting-for:<name>". */
+    waitingLabel: string;
+    /** Full label name "completed:<name>". */
+    completedLabel: string;
+    /** The phase this gate belongs to (from GATE_MAPPING[name].phase). */
+    sourcePhase: WorkflowPhase;
+    /** True when sourcePhase === the phase being re-entered (documented tie-break). */
+    isSelfLoop: boolean;
+}
+export type ResolvePrecedingGateResult = {
+    kind: 'found';
+    gate: PrecedingGate;
+} | {
+    kind: 'no-preceding-gate';
+    targetPhase: WorkflowPhase;
+};
+/**
+ * Resolve the preceding gate for a failed phase.
+ *
+ * Algorithm (deterministic; mirrors `PhaseResolver.getEffectiveGateMapping`):
+ *  1. Build effective mapping = GATE_MAPPING overlaid with WORKFLOW_GATE_MAPPING[workflowName].
+ *  2. Filter entries where `resumeFrom === phase`.
+ *  3. If empty: return `no-preceding-gate`.
+ *  4. Partition into `crossPhase` (gatePhase !== phase) and `selfLoop`.
+ *  5. If crossPhase non-empty: pick nearest predecessor by PHASE_SEQUENCE.indexOf descending.
+ *  6. Otherwise: pick the first selfLoop entry in stable Object.entries order.
+ */
+export declare function resolvePrecedingGate(phase: WorkflowPhase, workflowName?: string): ResolvePrecedingGateResult;
+//# sourceMappingURL=gate-vocabulary.d.ts.map

package/dist/cli/commands/cockpit/gate-vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-vocabulary.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/cockpit/gate-vocabulary.ts"],"names":[],"mappings":"AAgBA,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,cAAc,EAAE,MAAM,CAAC;CACxB;AAuBD,eAAO,MAAM,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAgB,CAAC;AAEvE,8EAA8E;AAC9E,wBAAgB,SAAS,IAAI,MAAM,EAAE,CAEpC;AAID;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,cAAc,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,WAAW,EAAE,aAAa,CAAC;IAC3B,mFAAmF;IACnF,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,0BAA0B,GAClC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,aAAa,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,WAAW,EAAE,aAAa,CAAA;CAAE,CAAC;AAE9D;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,YAAY,CAAC,EAAE,MAAM,GACpB,0BAA0B,CA8C5B"}

package/dist/cli/commands/cockpit/gate-vocabulary.js

@@ -0,0 +1,96 @@
+/**
+ * Gate vocabulary derived from `WORKFLOW_LABELS`.
+ *
+ * A gate is any `waiting-for:<x>` label that has a matching `completed:<x>` partner.
+ * Labels with only one side of the pair are NOT valid gates.
+ *
+ * This is the single source of truth for `--gate <name>` validation in `cockpit advance`,
+ * and for `--help-gates` output. Per SC-005, no other file in `cockpit/` may hard-code a
+ * `completed:` literal list.
+ *
+ * Also exposes `resolvePrecedingGate(phase, workflowName?)` — the inverse view of
+ * `GATE_MAPPING` keyed by `resumeFrom` — used by `cockpit resume` (#891) to
+ * derive the gate whose completion causes the resolver to pick `<phase>` as
+ * `startPhase`.
+ */
+import { WORKFLOW_LABELS } from '@generacy-ai/workflow-engine';
+import { GATE_MAPPING, WORKFLOW_GATE_MAPPING, PHASE_SEQUENCE, } from '@generacy-ai/orchestrator';
+function buildGates() {
+    const gates = new Map();
+    const completedNames = new Set();
+    for (const label of WORKFLOW_LABELS) {
+        if (label.name.startsWith('completed:')) {
+            completedNames.add(label.name.slice('completed:'.length));
+        }
+    }
+    for (const label of WORKFLOW_LABELS) {
+        if (!label.name.startsWith('waiting-for:'))
+            continue;
+        const name = label.name.slice('waiting-for:'.length);
+        if (!completedNames.has(name))
+            continue;
+        gates.set(name, {
+            name,
+            waitingLabel: `waiting-for:${name}`,
+            completedLabel: `completed:${name}`,
+        });
+    }
+    return gates;
+}
+export const GATES = buildGates();
+/** List gate names in `WORKFLOW_LABELS` order — stable for `--help-gates`. */
+export function listGates() {
+    return Array.from(GATES.keys());
+}
+/**
+ * Resolve the preceding gate for a failed phase.
+ *
+ * Algorithm (deterministic; mirrors `PhaseResolver.getEffectiveGateMapping`):
+ *  1. Build effective mapping = GATE_MAPPING overlaid with WORKFLOW_GATE_MAPPING[workflowName].
+ *  2. Filter entries where `resumeFrom === phase`.
+ *  3. If empty: return `no-preceding-gate`.
+ *  4. Partition into `crossPhase` (gatePhase !== phase) and `selfLoop`.
+ *  5. If crossPhase non-empty: pick nearest predecessor by PHASE_SEQUENCE.indexOf descending.
+ *  6. Otherwise: pick the first selfLoop entry in stable Object.entries order.
+ */
+export function resolvePrecedingGate(phase, workflowName) {
+    const effective = workflowName && WORKFLOW_GATE_MAPPING[workflowName]
+        ? { ...GATE_MAPPING, ...WORKFLOW_GATE_MAPPING[workflowName] }
+        : GATE_MAPPING;
+    const candidates = [];
+    for (const [gateName, entry] of Object.entries(effective)) {
+        if (entry.resumeFrom === phase) {
+            candidates.push({ name: gateName, sourcePhase: entry.phase });
+        }
+    }
+    if (candidates.length === 0) {
+        return { kind: 'no-preceding-gate', targetPhase: phase };
+    }
+    const crossPhase = candidates.filter((c) => c.sourcePhase !== phase);
+    if (crossPhase.length > 0) {
+        crossPhase.sort((a, b) => PHASE_SEQUENCE.indexOf(b.sourcePhase) - PHASE_SEQUENCE.indexOf(a.sourcePhase));
+        const winner = crossPhase[0];
+        return {
+            kind: 'found',
+            gate: {
+                name: winner.name,
+                waitingLabel: `waiting-for:${winner.name}`,
+                completedLabel: `completed:${winner.name}`,
+                sourcePhase: winner.sourcePhase,
+                isSelfLoop: false,
+            },
+        };
+    }
+    const selfLoop = candidates[0];
+    return {
+        kind: 'found',
+        gate: {
+            name: selfLoop.name,
+            waitingLabel: `waiting-for:${selfLoop.name}`,
+            completedLabel: `completed:${selfLoop.name}`,
+            sourcePhase: selfLoop.sourcePhase,
+            isSelfLoop: true,
+        },
+    };
+}
+//# sourceMappingURL=gate-vocabulary.js.map

package/dist/cli/commands/cockpit/gate-vocabulary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-vocabulary.js","sourceRoot":"","sources":["../../../../src/cli/commands/cockpit/gate-vocabulary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,cAAc,GAEf,MAAM,2BAA2B,CAAC;AAWnC,SAAS,UAAU;IACjB,MAAM,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IAChD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;QACpC,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACxC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;QACpC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;YAAE,SAAS;QACrD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QACrD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QACxC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE;YACd,IAAI;YACJ,YAAY,EAAE,eAAe,IAAI,EAAE;YACnC,cAAc,EAAE,aAAa,IAAI,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,MAAM,KAAK,GAAwC,UAAU,EAAE,CAAC;AAEvE,8EAA8E;AAC9E,MAAM,UAAU,SAAS;IACvB,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;AAClC,CAAC;AAyBD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAoB,EACpB,YAAqB;IAErB,MAAM,SAAS,GACb,YAAY,IAAI,qBAAqB,CAAC,YAAY,CAAC;QACjD,CAAC,CAAC,EAAE,GAAG,YAAY,EAAE,GAAG,qBAAqB,CAAC,YAAY,CAAC,EAAE;QAC7D,CAAC,CAAC,YAAY,CAAC;IAEnB,MAAM,UAAU,GAAmD,EAAE,CAAC;IACtE,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1D,IAAI,KAAK,CAAC,UAAU,KAAK,KAAK,EAAE,CAAC;YAC/B,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAC3D,CAAC;IAED,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,KAAK,CAAC,CAAC;IACrE,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,UAAU,CAAC,IAAI,CACb,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CACxF,CAAC;QACF,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAE,CAAC;QAC9B,OAAO;YACL,IAAI,EAAE,OAAO;YACb,IAAI,EAAE;gBACJ,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,YAAY,EAAE,eAAe,MAAM,CAAC,IAAI,EAAE;gBAC1C,cAAc,EAAE,aAAa,MAAM,CAAC,IAAI,EAAE;gBAC1C,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,UAAU,EAAE,KAAK;aAClB;SACF,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAE,CAAC;IAChC,OAAO;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,YAAY,EAAE,eAAe,QAAQ,CAAC,IAAI,EAAE;YAC5C,cAAc,EAAE,aAAa,QAAQ,CAAC,IAAI,EAAE;YAC5C,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,UAAU,EAAE,IAAI;SACjB;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,20 @@
+/**
+ * `generacy cockpit` command group.
+ *
+ * Observability verbs (read-only) for Generacy epics and repos:
+ *   - watch    — poll an epic's issues/PRs and emit cockpit events on state changes
+ *   - status   — render a grouped, colorized table of the epic's current state
+ *
+ * Single-issue verbs that inspect and drive workflow state for one issue:
+ *   - context  — classify the current waiting-for:* gate and emit its bundle
+ *   - advance  — manually advance a waiting gate (flip waiting-for → completed)
+ *   - resume   — re-arm a failed phase in place (clears failed:*, restores the
+ *                preceding gate's waiting-for/completed pair + agent:paused)
+ *
+ * Epic merge/review verbs:
+ *   - merge    — merge a PR once its required checks are green
+ *   - queue    — enqueue eligible refs under a phase heading to the cluster pipeline
+ */
+import { Command } from 'commander';
+export declare function cockpitCommand(): Command;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/cockpit/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,wBAAgB,cAAc,IAAI,OAAO,CAexC"}

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

@@ -0,0 +1,42 @@
+/**
+ * `generacy cockpit` command group.
+ *
+ * Observability verbs (read-only) for Generacy epics and repos:
+ *   - watch    — poll an epic's issues/PRs and emit cockpit events on state changes
+ *   - status   — render a grouped, colorized table of the epic's current state
+ *
+ * Single-issue verbs that inspect and drive workflow state for one issue:
+ *   - context  — classify the current waiting-for:* gate and emit its bundle
+ *   - advance  — manually advance a waiting gate (flip waiting-for → completed)
+ *   - resume   — re-arm a failed phase in place (clears failed:*, restores the
+ *                preceding gate's waiting-for/completed pair + agent:paused)
+ *
+ * Epic merge/review verbs:
+ *   - merge    — merge a PR once its required checks are green
+ *   - queue    — enqueue eligible refs under a phase heading to the cluster pipeline
+ */
+import { Command } from 'commander';
+import { watchCommand } from './watch.js';
+import { statusCommand } from './status.js';
+import { advanceCommand } from './advance.js';
+import { contextCommand } from './context.js';
+import { cockpitMergeCommand } from './merge.js';
+import { queueCommand } from './queue.js';
+import { resumeCommand } from './resume.js';
+import { scopeCommand } from './scope.js';
+import { cockpitMcpCommand } from './mcp/index.js';
+export function cockpitCommand() {
+    const command = new Command('cockpit');
+    command.description('Cockpit — inspect and drive workflow state for Generacy epics and issues.');
+    command.addCommand(watchCommand());
+    command.addCommand(statusCommand());
+    command.addCommand(advanceCommand());
+    command.addCommand(contextCommand());
+    command.addCommand(cockpitMergeCommand());
+    command.addCommand(queueCommand());
+    command.addCommand(resumeCommand());
+    command.addCommand(scopeCommand());
+    command.addCommand(cockpitMcpCommand());
+    return command;
+}
+//# sourceMappingURL=index.js.map