@generacy-ai/generacy 0.5.0 → 0.6.0

package/dist/cli/commands/cockpit/clarification-answer-marker.d.ts

@@ -0,0 +1,8 @@
+export interface ClarificationAnswerMarker {
+    batch: number;
+    answers: Record<number, string>;
+    actor?: string;
+    ts: string;
+}
+export declare function formatClarificationAnswerComment(marker: ClarificationAnswerMarker): string;
+//# sourceMappingURL=clarification-answer-marker.d.ts.map

package/dist/cli/commands/cockpit/clarification-answer-marker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clarification-answer-marker.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/cockpit/clarification-answer-marker.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,yBAAyB,GAChC,MAAM,CAmBR"}

package/dist/cli/commands/cockpit/clarification-answer-marker.js

@@ -0,0 +1,76 @@
+/**
+ * #958 — `formatClarificationAnswerComment` renders the marker-stamped answer
+ * comment posted by `cockpit_relay_clarify_answers`. Mirrors the deterministic
+ * validation pattern in `manual-advance-marker.ts`.
+ *
+ * The header line matches `commentCarriesAnswerMarker` in
+ * `packages/orchestrator/src/worker/clarification-markers.ts` — this is the
+ * sole writer of the `<!-- generacy-clarification-answers:<batch> -->`
+ * prefix. Agents never free-write it.
+ *
+ * Inputs are regex-validated before interpolation so a malformed `batch`,
+ * `actor`, or `ts` cannot inject markdown/HTML into the marker body.
+ */
+import { PENDING_ANSWER_LITERAL } from '@generacy-ai/workflow-engine';
+const ACTOR_REGEX = /^[A-Za-z0-9-]+$/;
+export function formatClarificationAnswerComment(marker) {
+    validate(marker);
+    const { batch, answers, actor, ts } = marker;
+    const hasActor = typeof actor === 'string' && actor.length > 0;
+    const header = hasActor
+        ? `<!-- generacy-clarification-answers:${batch} actor=${actor} ts=${ts} -->`
+        : `<!-- generacy-clarification-answers:${batch} ts=${ts} -->`;
+    const orderedKeys = Object.keys(answers)
+        .map((k) => Number(k))
+        .sort((a, b) => a - b);
+    const answerLines = orderedKeys.map((n) => `Q${n}: ${answers[n]}`);
+    return [
+        header,
+        '',
+        `## Answers — batch ${batch}`,
+        '',
+        ...answerLines,
+        '',
+    ].join('\n');
+}
+function validate(marker) {
+    if (!Number.isInteger(marker.batch) || marker.batch < 0) {
+        throw new Error(`formatClarificationAnswerComment: batch must be a non-negative integer (got ${String(marker.batch)})`);
+    }
+    if (typeof marker.actor === 'string' && marker.actor.length > 0) {
+        if (!ACTOR_REGEX.test(marker.actor)) {
+            throw new Error(`formatClarificationAnswerComment: invalid actor login "${marker.actor}"`);
+        }
+    }
+    if (typeof marker.ts !== 'string' || marker.ts === '') {
+        throw new Error('formatClarificationAnswerComment: ts must be a non-empty ISO-8601 string');
+    }
+    const parsed = new Date(marker.ts);
+    if (Number.isNaN(parsed.getTime()) || parsed.toISOString() !== marker.ts) {
+        throw new Error(`formatClarificationAnswerComment: ts "${marker.ts}" is not round-trip ISO-8601`);
+    }
+    if (marker.answers == null || typeof marker.answers !== 'object') {
+        throw new Error('formatClarificationAnswerComment: answers must be a Record<number, string>');
+    }
+    const keys = Object.keys(marker.answers);
+    if (keys.length === 0) {
+        throw new Error('formatClarificationAnswerComment: answers map is empty');
+    }
+    for (const key of keys) {
+        const n = Number(key);
+        if (!Number.isInteger(n) || n <= 0) {
+            throw new Error(`formatClarificationAnswerComment: answer key "${key}" is not a positive integer`);
+        }
+        const value = marker.answers[n];
+        if (typeof value !== 'string' || value.length === 0) {
+            throw new Error(`formatClarificationAnswerComment: answer for Q${n} is empty`);
+        }
+    }
+    // Reference the shared pending literal so the import stays live (per
+    // data-model.md §"Cross-package import strategy" — divergence between the
+    // parser's canonical value and cockpit's rendered surface is structurally
+    // impossible). The stamped body never renders the literal itself; the tool
+    // refuses empty values above.
+    void PENDING_ANSWER_LITERAL;
+}
+//# sourceMappingURL=clarification-answer-marker.js.map

package/dist/cli/commands/cockpit/clarification-answer-marker.js.map

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

package/dist/cli/commands/cockpit/clarification-comment-finder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clarification-comment-finder.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/cockpit/clarification-comment-finder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAUpE,wBAAsB,wBAAwB,CAC5C,EAAE,EAAE,SAAS,EACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA0B9B"}
+{"version":3,"file":"clarification-comment-finder.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/cockpit/clarification-comment-finder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAuCpE,wBAAsB,wBAAwB,CAC5C,EAAE,EAAE,SAAS,EACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA0B9B"}

package/dist/cli/commands/cockpit/clarification-comment-finder.js

@@ -1,4 +1,32 @@
 const WAITING_CLARIFICATION = 'waiting-for:clarification';
+const STAGE_STATUS_REJECT_PREFIXES = [
+    '<!-- generacy-stage:planning',
+    '<!-- generacy-stage:specification',
+    '<!-- generacy-stage:implementation',
+    '<!-- speckit-stage:planning',
+    '<!-- speckit-stage:specification',
+    '<!-- speckit-stage:implementation',
+];
+const CLARIFICATION_STAGE_OVERRIDE_PREFIXES = [
+    '<!-- generacy-stage:clarification',
+    '<!-- generacy-stage:clarification-batch-',
+];
+function isStageStatusComment(body) {
+    const lines = body.split('\n');
+    for (const line of lines) {
+        for (const prefix of CLARIFICATION_STAGE_OVERRIDE_PREFIXES) {
+            if (line.startsWith(prefix))
+                return false;
+        }
+    }
+    for (const line of lines) {
+        for (const prefix of STAGE_STATUS_REJECT_PREFIXES) {
+            if (line.startsWith(prefix))
+                return true;
+        }
+    }
+    return false;
+}
 export async function findClarificationComment(gh, repo, number) {
     const timeline = (await gh.fetchIssueTimeline(repo, number));
     let latestLabelTs = null;
@@ -22,9 +50,11 @@ export async function findClarificationComment(gh, repo, number) {
     const sorted = [...comments].sort((a, b) => Date.parse(a.createdAt) - Date.parse(b.createdAt));
     for (const c of sorted) {
         const ct = Date.parse(c.createdAt);
-        if (!Number.isNaN(ct) && ct >= labelTime) {
-            return c;
-        }
+        if (Number.isNaN(ct) || ct < labelTime)
+            continue;
+        if (isStageStatusComment(c.body))
+            continue;
+        return c;
     }
     return null;
 }

package/dist/cli/commands/cockpit/clarification-comment-finder.js.map

@@ -1 +1 @@
-{"version":3,"file":"clarification-comment-finder.js","sourceRoot":"","sources":["../../../../src/cli/commands/cockpit/clarification-comment-finder.ts"],"names":[],"mappings":"AAYA,MAAM,qBAAqB,GAAG,2BAA2B,CAAC;AAQ1D,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,EAAa,EACb,IAAY,EACZ,MAAc;IAEd,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAyB,CAAC;IAErF,IAAI,aAAa,GAAkB,IAAI,CAAC;IACxC,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;YAAE,SAAS;QACxC,IAAI,KAAK,CAAC,KAAK,EAAE,IAAI,KAAK,qBAAqB;YAAE,SAAS;QAC1D,IAAI,KAAK,CAAC,UAAU,IAAI,IAAI;YAAE,SAAS;QACvC,IAAI,aAAa,IAAI,IAAI,IAAI,KAAK,CAAC,UAAU,GAAG,aAAa,EAAE,CAAC;YAC9D,aAAa,GAAG,KAAK,CAAC,UAAU,CAAC;QACnC,CAAC;IACH,CAAC;IAED,IAAI,aAAa,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IACvC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAC5C,IAAI,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAEzC,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAC/F,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,SAAS,EAAE,CAAC;YACzC,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"clarification-comment-finder.js","sourceRoot":"","sources":["../../../../src/cli/commands/cockpit/clarification-comment-finder.ts"],"names":[],"mappings":"AAYA,MAAM,qBAAqB,GAAG,2BAA2B,CAAC;AAE1D,MAAM,4BAA4B,GAAsB;IACtD,8BAA8B;IAC9B,mCAAmC;IACnC,oCAAoC;IACpC,6BAA6B;IAC7B,kCAAkC;IAClC,mCAAmC;CAC3B,CAAC;AAEX,MAAM,qCAAqC,GAAsB;IAC/D,mCAAmC;IACnC,0CAA0C;CAClC,CAAC;AAEX,SAAS,oBAAoB,CAAC,IAAY;IACxC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,MAAM,IAAI,qCAAqC,EAAE,CAAC;YAC3D,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;gBAAE,OAAO,KAAK,CAAC;QAC5C,CAAC;IACH,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,MAAM,IAAI,4BAA4B,EAAE,CAAC;YAClD,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC3C,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAQD,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,EAAa,EACb,IAAY,EACZ,MAAc;IAEd,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAyB,CAAC;IAErF,IAAI,aAAa,GAAkB,IAAI,CAAC;IACxC,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;YAAE,SAAS;QACxC,IAAI,KAAK,CAAC,KAAK,EAAE,IAAI,KAAK,qBAAqB;YAAE,SAAS;QAC1D,IAAI,KAAK,CAAC,UAAU,IAAI,IAAI;YAAE,SAAS;QACvC,IAAI,aAAa,IAAI,IAAI,IAAI,KAAK,CAAC,UAAU,GAAG,aAAa,EAAE,CAAC;YAC9D,aAAa,GAAG,KAAK,CAAC,UAAU,CAAC;QACnC,CAAC;IACH,CAAC;IAED,IAAI,aAAa,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IACvC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAC5C,IAAI,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAEzC,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAC/F,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACnC,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,SAAS;YAAE,SAAS;QACjD,IAAI,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,SAAS;QAC3C,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/cli/commands/cockpit/clarify-relay.d.ts

@@ -0,0 +1,38 @@
+/**
+ * #958 — `runClarifyRelay` — deterministic answer-relay path for cockpit's
+ * clarify skill. Replaces the freehand `gh issue comment` invocation that
+ * caused #958's answer-side lottery (four different agent-invented markers
+ * observed on #5/#6/#7/#8 in one run).
+ *
+ * The tool posts a marker-stamped comment (via `formatClarificationAnswerComment`)
+ * and applies `completed:clarification`. Idempotent: a second call with the
+ * same batch is a no-op (`action: 'already-relayed'`).
+ *
+ * MUST NOT rewrite `clarifications.md` locally. MUST NOT remove
+ * `waiting-for:clarification` (the worker owns that on resume).
+ */
+import { loadCockpitConfig, type CommandRunner, type GhWrapper } from '@generacy-ai/cockpit';
+import { type IssueRef } from './resolver.js';
+export interface ClarifyRelayInput {
+    issue: string;
+    batch: number;
+    answers: Record<number, string>;
+    actor?: string;
+}
+export interface ClarifyRelayResult {
+    ref: IssueRef;
+    batch: number;
+    action: 'relayed' | 'already-relayed';
+    completedLabel: 'completed:clarification';
+    commentUrl?: string;
+    noop?: true;
+}
+export interface ClarifyRelayDeps {
+    runner?: CommandRunner;
+    gh?: GhWrapper;
+    loadConfig?: typeof loadCockpitConfig;
+    env?: NodeJS.ProcessEnv;
+    now?: () => Date;
+}
+export declare function runClarifyRelay(input: ClarifyRelayInput, deps?: ClarifyRelayDeps): Promise<ClarifyRelayResult>;
+//# sourceMappingURL=clarify-relay.d.ts.map

package/dist/cli/commands/cockpit/clarify-relay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clarify-relay.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/cockpit/clarify-relay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EACL,iBAAiB,EACjB,KAAK,aAAa,EAClB,KAAK,SAAS,EACf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAuB,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAKnE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,QAAQ,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,GAAG,iBAAiB,CAAC;IACtC,cAAc,EAAE,yBAAyB,CAAC;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAC/B,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;CAClB;AAiBD,wBAAsB,eAAe,CACnC,KAAK,EAAE,iBAAiB,EACxB,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CAkG7B"}

package/dist/cli/commands/cockpit/clarify-relay.js

@@ -0,0 +1,120 @@
+/**
+ * #958 — `runClarifyRelay` — deterministic answer-relay path for cockpit's
+ * clarify skill. Replaces the freehand `gh issue comment` invocation that
+ * caused #958's answer-side lottery (four different agent-invented markers
+ * observed on #5/#6/#7/#8 in one run).
+ *
+ * The tool posts a marker-stamped comment (via `formatClarificationAnswerComment`)
+ * and applies `completed:clarification`. Idempotent: a second call with the
+ * same batch is a no-op (`action: 'already-relayed'`).
+ *
+ * MUST NOT rewrite `clarifications.md` locally. MUST NOT remove
+ * `waiting-for:clarification` (the worker owns that on resume).
+ */
+import { loadCockpitConfig, } from '@generacy-ai/cockpit';
+import { getLogger } from '../../utils/logger.js';
+import { resolveIssueContext } from './resolver.js';
+import { CockpitExit } from './exit.js';
+import { resolveCockpitIdentity } from './shared/identity.js';
+import { formatClarificationAnswerComment } from './clarification-answer-marker.js';
+const COMPLETED_LABEL = 'completed:clarification';
+/**
+ * Detect a prior stamped answer comment for the same batch. The marker header
+ * carries the batch as the first attribute (`:<batch>`) — any comment whose
+ * body starts a line with `<!-- generacy-clarification-answers:<batch>` matches.
+ */
+function hasPriorMarkerForBatch(body, batch) {
+    const prefix = `<!-- generacy-clarification-answers:${batch}`;
+    for (const line of body.split('\n')) {
+        if (line.startsWith(prefix))
+            return true;
+    }
+    return false;
+}
+export async function runClarifyRelay(input, deps = {}) {
+    const log = getLogger();
+    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: input.issue,
+            ...(deps.runner != null ? { runner: deps.runner } : {}),
+        });
+        ref = resolvedCtx.ref;
+        gh = deps.gh ?? resolvedCtx.gh;
+    }
+    catch (err) {
+        throw new CockpitExit(2, `Error: cockpit clarify-relay: ${err.message}`);
+    }
+    // Resolve actor (optional). An unresolvable identity leaves the actor attr
+    // off the marker header — the marker match rule is prefix-based so this is
+    // a cosmetic degradation, not a functional one.
+    const identityInput = {
+        flag: undefined,
+        configAssignee: loaded.config.assignee,
+        gh,
+        logger: log,
+        verb: 'clarify-relay',
+        mode: 'optional',
+        ...(deps.env != null ? { env: deps.env } : {}),
+    };
+    const identity = await resolveCockpitIdentity(identityInput);
+    const actor = input.actor ?? identity.login;
+    // Idempotence — a comment carrying this batch's marker means we already
+    // relayed. Return no-op without re-posting or re-labelling.
+    let existingComments;
+    try {
+        existingComments = await gh.fetchIssueComments(ref.nwo, ref.number);
+    }
+    catch (err) {
+        throw new CockpitExit(1, `Error: cockpit clarify-relay: gh issue view (fetch comments): ${err.message}`);
+    }
+    const alreadyRelayed = existingComments.some((c) => hasPriorMarkerForBatch(c.body, input.batch));
+    if (alreadyRelayed) {
+        return {
+            ref,
+            batch: input.batch,
+            action: 'already-relayed',
+            completedLabel: COMPLETED_LABEL,
+            noop: true,
+        };
+    }
+    const ts = (deps.now ?? (() => new Date()))().toISOString();
+    let body;
+    try {
+        body = formatClarificationAnswerComment({
+            batch: input.batch,
+            answers: input.answers,
+            ...(actor != null ? { actor } : {}),
+            ts,
+        });
+    }
+    catch (err) {
+        throw new CockpitExit(2, `Error: cockpit clarify-relay: ${err.message}`);
+    }
+    let commentUrl;
+    try {
+        commentUrl = (await gh.postIssueComment(ref.nwo, ref.number, body)).url;
+    }
+    catch (err) {
+        throw new CockpitExit(1, `Error: cockpit clarify-relay: gh issue comment: ${err.message}`);
+    }
+    try {
+        await gh.addLabel(ref.nwo, ref.number, COMPLETED_LABEL);
+    }
+    catch (err) {
+        throw new CockpitExit(1, `Error: cockpit clarify-relay: gh issue edit (add ${COMPLETED_LABEL}): ${err.message}` +
+            ` (comment posted: ${commentUrl})`);
+    }
+    return {
+        ref,
+        batch: input.batch,
+        action: 'relayed',
+        completedLabel: COMPLETED_LABEL,
+        commentUrl,
+    };
+}
+//# sourceMappingURL=clarify-relay.js.map

package/dist/cli/commands/cockpit/clarify-relay.js.map

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

package/dist/cli/commands/cockpit/doorbell/aggregate-on-demand.d.ts

@@ -0,0 +1,43 @@
+/**
+ * `maybeRefreshAggregate` — Q4=A on-demand aggregate refresh. Recomputes
+ * `phase-complete` / `epic-complete` events only when the current webhook
+ * payload could plausibly change an aggregate state (completed:* label,
+ * issue.closed, pull_request.closed). Zero GraphQL cost on non-completion
+ * payloads.
+ *
+ * Contract: `specs/978-summary-generacy-cockpit/contracts/aggregate-on-demand.md`.
+ */
+import { type GhWrapper, type ResolvedEpic } from '@generacy-ai/cockpit';
+import { type AggregateState } from '../watch/aggregate.js';
+import type { AggregateEvent } from '../watch/aggregate-emit.js';
+import type { SnapshotMap } from '../watch/snapshot.js';
+export type AggregateTrigger = {
+    kind: 'completed-label';
+    label: string;
+} | {
+    kind: 'issue-closed';
+} | {
+    kind: 'pr-closed';
+} | null;
+export interface AggregateRefreshInput {
+    trigger: AggregateTrigger;
+    epicRef: string;
+    epicRepo: string;
+    epicNumber: number;
+    prevAgg: AggregateState;
+    prev: SnapshotMap;
+    currentResolved: ResolvedEpic | null;
+    gh: GhWrapper;
+    logger: {
+        warn: (msg: string) => void;
+    };
+    now: () => string;
+}
+export interface AggregateRefreshOutput {
+    events: AggregateEvent[];
+    nextAgg: AggregateState;
+    nextPrev: SnapshotMap;
+    nextResolved: ResolvedEpic | null;
+}
+export declare function maybeRefreshAggregate(input: AggregateRefreshInput): Promise<AggregateRefreshOutput>;
+//# sourceMappingURL=aggregate-on-demand.d.ts.map

package/dist/cli/commands/cockpit/doorbell/aggregate-on-demand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate-on-demand.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/doorbell/aggregate-on-demand.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAe,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEtF,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB,IAAI,CAAC;AAET,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,WAAW,CAAC;IAClB,eAAe,EAAE,YAAY,GAAG,IAAI,CAAC;IACrC,EAAE,EAAE,SAAS,CAAC;IACd,MAAM,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC;IACxC,GAAG,EAAE,MAAM,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,WAAW,CAAC;IACtB,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;CACnC;AAWD,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,sBAAsB,CAAC,CA2DjC"}

package/dist/cli/commands/cockpit/doorbell/aggregate-on-demand.js

@@ -0,0 +1,72 @@
+/**
+ * `maybeRefreshAggregate` — Q4=A on-demand aggregate refresh. Recomputes
+ * `phase-complete` / `epic-complete` events only when the current webhook
+ * payload could plausibly change an aggregate state (completed:* label,
+ * issue.closed, pull_request.closed). Zero GraphQL cost on non-completion
+ * payloads.
+ *
+ * Contract: `specs/978-summary-generacy-cockpit/contracts/aggregate-on-demand.md`.
+ */
+import { resolveEpic } from '@generacy-ai/cockpit';
+import { runOnePoll } from '../watch/poll-loop.js';
+import { computeAggregateEvents } from '../watch/aggregate.js';
+function identity(input) {
+    return {
+        events: [],
+        nextAgg: input.prevAgg,
+        nextPrev: input.prev,
+        nextResolved: input.currentResolved,
+    };
+}
+export async function maybeRefreshAggregate(input) {
+    if (input.trigger == null)
+        return identity(input);
+    let resolved = input.currentResolved;
+    if (resolved == null) {
+        try {
+            resolved = await resolveEpic({
+                epicRef: input.epicRef,
+                gh: input.gh,
+                logger: input.logger,
+            });
+        }
+        catch (err) {
+            input.logger.warn(`cockpit doorbell: aggregate resolveEpic failed: ${err instanceof Error ? err.message : String(err)}`);
+            return identity(input);
+        }
+    }
+    let pollResult;
+    try {
+        pollResult = await runOnePoll(input.prev, {
+            gh: input.gh,
+            refs: resolved.parsed.allRefs,
+            epicOwnerRepo: resolved.epic.repo,
+            logger: input.logger,
+        });
+    }
+    catch (err) {
+        input.logger.warn(`cockpit doorbell: aggregate runOnePoll failed: ${err instanceof Error ? err.message : String(err)}`);
+        return {
+            events: [],
+            nextAgg: input.prevAgg,
+            nextPrev: input.prev,
+            nextResolved: resolved,
+        };
+    }
+    const aggregate = computeAggregateEvents({
+        curr: pollResult.curr,
+        parsed: resolved.parsed,
+        epicRepo: input.epicRepo,
+        epicNumber: input.epicNumber,
+        prevState: input.prevAgg,
+        initial: false,
+        now: input.now,
+    });
+    return {
+        events: aggregate.events,
+        nextAgg: aggregate.nextState,
+        nextPrev: pollResult.curr,
+        nextResolved: resolved,
+    };
+}
+//# sourceMappingURL=aggregate-on-demand.js.map

package/dist/cli/commands/cockpit/doorbell/aggregate-on-demand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate-on-demand.js","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/doorbell/aggregate-on-demand.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,WAAW,EAAqC,MAAM,sBAAsB,CAAC;AACtF,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAuB,MAAM,uBAAuB,CAAC;AA8BpF,SAAS,QAAQ,CAAC,KAA4B;IAC5C,OAAO;QACL,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,KAAK,CAAC,IAAI;QACpB,YAAY,EAAE,KAAK,CAAC,eAAe;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAA4B;IAE5B,IAAI,KAAK,CAAC,OAAO,IAAI,IAAI;QAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;IAElD,IAAI,QAAQ,GAAwB,KAAK,CAAC,eAAe,CAAC;IAC1D,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,WAAW,CAAC;gBAC3B,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,MAAM,EAAE,KAAK,CAAC,MAAM;aACrB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,CAAC,MAAM,CAAC,IAAI,CACf,mDACE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CACjD,EAAE,CACH,CAAC;YACF,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,IAAI,UAAiC,CAAC;IACtC,IAAI,CAAC;QACH,UAAU,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE;YACxC,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO;YAC7B,aAAa,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI;YACjC,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,KAAK,CAAC,MAAM,CAAC,IAAI,CACf,kDACE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CACjD,EAAE,CACH,CAAC;QACF,OAAO;YACL,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,QAAQ,EAAE,KAAK,CAAC,IAAI;YACpB,YAAY,EAAE,QAAQ;SACvB,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,sBAAsB,CAAC;QACvC,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,SAAS,EAAE,KAAK,CAAC,OAAO;QACxB,OAAO,EAAE,KAAK;QACd,GAAG,EAAE,KAAK,CAAC,GAAG;KACf,CAAC,CAAC;IAEH,OAAO;QACL,MAAM,EAAE,SAAS,CAAC,MAAM;QACxB,OAAO,EAAE,SAAS,CAAC,SAAS;QAC5B,QAAQ,EAAE,UAAU,CAAC,IAAI;QACzB,YAAY,EAAE,QAAQ;KACvB,CAAC;AACJ,CAAC"}

package/dist/cli/commands/cockpit/doorbell/channel-discovery.d.ts

@@ -0,0 +1,37 @@
+/**
+ * `discoverChannelUrl` — resolves the smee.io channel URL for the doorbell to
+ * consume. Four-stage lookup: env override → workspace walk-up →
+ * absolute workspace-mirror path → cluster-internal fallback. Never throws;
+ * malformed input logs a warning and returns null.
+ *
+ * Contract: `specs/980-summary-978-shipped-working/contracts/channel-discovery.md`.
+ */
+import type { PathLike } from 'node:fs';
+export declare const DEFAULT_CHANNEL_FILE_PATH = "/var/lib/generacy/smee-channel";
+export declare const DEFAULT_WORKSPACE_MIRROR_PATH = "/workspaces/.generacy/cockpit/smee-channel";
+export declare const SMEE_URL_PATTERN: RegExp;
+export type ChannelSource = 'env' | 'workspace-walkup' | 'workspace-absolute' | 'file';
+export interface ChannelDiscoveryResult {
+    url: string;
+    source: ChannelSource;
+}
+interface ReadFileFn {
+    (path: PathLike, encoding: BufferEncoding): Promise<string>;
+}
+export interface ChannelDiscoveryInput {
+    env: NodeJS.ProcessEnv;
+    channelFilePath: string;
+    fs: {
+        readFile: ReadFileFn;
+    };
+    logger?: {
+        warn?: (msg: string) => void;
+    };
+    /** Starting directory for walk-up scan. Defaults to `process.cwd()`. */
+    cwd?: string;
+    /** Absolute fallback if walk-up produces no hit. */
+    workspaceMirrorPath?: string;
+}
+export declare function discoverChannelUrl(input: ChannelDiscoveryInput): Promise<ChannelDiscoveryResult | null>;
+export {};
+//# sourceMappingURL=channel-discovery.d.ts.map

package/dist/cli/commands/cockpit/doorbell/channel-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-discovery.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/doorbell/channel-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGxC,eAAO,MAAM,yBAAyB,mCAAmC,CAAC;AAC1E,eAAO,MAAM,6BAA6B,+CACI,CAAC;AAI/C,eAAO,MAAM,gBAAgB,QAAyC,CAAC;AAEvE,MAAM,MAAM,aAAa,GACrB,KAAK,GACL,kBAAkB,GAClB,oBAAoB,GACpB,MAAM,CAAC;AAEX,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,aAAa,CAAC;CACvB;AAED,UAAU,UAAU;IAClB,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,EAAE,EAAE;QAAE,QAAQ,EAAE,UAAU,CAAA;KAAE,CAAC;IAC7B,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC;IAC1C,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAyCD,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAmFxC"}

package/dist/cli/commands/cockpit/doorbell/channel-discovery.js

@@ -0,0 +1,92 @@
+import { dirname, join, parse as parsePath } from 'node:path';
+export const DEFAULT_CHANNEL_FILE_PATH = '/var/lib/generacy/smee-channel';
+export const DEFAULT_WORKSPACE_MIRROR_PATH = '/workspaces/.generacy/cockpit/smee-channel';
+// Copied verbatim from packages/orchestrator/src/services/smee-channel-resolver.ts:27
+// to avoid an orchestrator import in the CLI.
+export const SMEE_URL_PATTERN = /^https:\/\/smee\.io\/[A-Za-z0-9_-]+$/;
+const ENV_KEY = 'COCKPIT_DOORBELL_SMEE_URL';
+const WALKUP_SUFFIX = join('.generacy', 'cockpit', 'smee-channel');
+function warn(input, msg) {
+    input.logger?.warn?.(msg);
+}
+function isEnoent(err) {
+    if (err == null || typeof err !== 'object')
+        return false;
+    const code = err.code;
+    return code === 'ENOENT';
+}
+function errMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+async function tryReadUrl(input, path, onNonEnoentError, onMalformed) {
+    let raw;
+    try {
+        raw = await input.fs.readFile(path, 'utf-8');
+    }
+    catch (err) {
+        if (isEnoent(err))
+            return null;
+        onNonEnoentError(errMessage(err));
+        return null;
+    }
+    const trimmed = raw.trim();
+    if (SMEE_URL_PATTERN.test(trimmed)) {
+        return trimmed;
+    }
+    onMalformed(trimmed);
+    return null;
+}
+export async function discoverChannelUrl(input) {
+    // Stage 1: env override.
+    const envRaw = input.env[ENV_KEY];
+    const envPresent = envRaw != null && envRaw !== '';
+    if (envPresent) {
+        if (SMEE_URL_PATTERN.test(envRaw)) {
+            return { url: envRaw, source: 'env' };
+        }
+        warn(input, `cockpit doorbell: ${ENV_KEY} does not match smee URL pattern; falling through to channel file`);
+    }
+    // Stage 2: walk-up scan starting at cwd.
+    const startCwd = input.cwd ?? process.cwd();
+    const root = parsePath(startCwd).root;
+    let dir = startCwd;
+    // Bound the walk: worst case ~few dozen hops, so no infinite-loop guard beyond
+    // the root check is required — path.dirname eventually stabilizes at root.
+    for (;;) {
+        const candidate = join(dir, WALKUP_SUFFIX);
+        const url = await tryReadUrl(input, candidate, (msg) => warn(input, `cockpit doorbell: walk-up read failed at ${dir}: ${msg}`), () => warn(input, `cockpit doorbell: channel content at ${candidate} does not match smee URL pattern`));
+        if (url != null) {
+            return { url, source: 'workspace-walkup' };
+        }
+        if (dir === root)
+            break;
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    // Stage 3: absolute workspace mirror path.
+    const mirrorPath = input.workspaceMirrorPath ?? DEFAULT_WORKSPACE_MIRROR_PATH;
+    const mirrorUrl = await tryReadUrl(input, mirrorPath, (msg) => warn(input, `cockpit doorbell: failed to read workspace mirror at ${mirrorPath}: ${msg}`), () => warn(input, `cockpit doorbell: channel content at ${mirrorPath} does not match smee URL pattern`));
+    if (mirrorUrl != null) {
+        return { url: mirrorUrl, source: 'workspace-absolute' };
+    }
+    // Stage 4: cluster-internal channel file.
+    let raw;
+    try {
+        raw = await input.fs.readFile(input.channelFilePath, 'utf-8');
+    }
+    catch (err) {
+        if (isEnoent(err))
+            return null;
+        warn(input, `cockpit doorbell: failed to read channel file ${input.channelFilePath}: ${errMessage(err)}`);
+        return null;
+    }
+    const trimmed = raw.trim();
+    if (SMEE_URL_PATTERN.test(trimmed)) {
+        return { url: trimmed, source: 'file' };
+    }
+    warn(input, `cockpit doorbell: channel file ${input.channelFilePath} content does not match smee URL pattern`);
+    return null;
+}
+//# sourceMappingURL=channel-discovery.js.map

package/dist/cli/commands/cockpit/doorbell/channel-discovery.js.map

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