@generacy-ai/generacy 0.5.0 → 0.7.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

@@ -1,13 +1,3 @@
-/**
- * `findClarificationComment` — implements AD-3 / D-R1:
- *
- *  1. Walk `gh api repos/{o}/{r}/issues/{n}/timeline` for the most-recent event
- *     `event === 'labeled'` with `label.name === 'waiting-for:clarification'`.
- *  2. Take its `created_at` timestamp.
- *  3. Fetch `gh issue view --json comments` and return the first comment whose
- *     `createdAt >= labelEventTs`.
- *  4. Return `null` if no qualifying comment exists.
- */
 import type { GhWrapper, IssueComment } from '@generacy-ai/cockpit';
 export declare function findClarificationComment(gh: GhWrapper, repo: string, number: number): Promise<IssueComment | null>;
 //# sourceMappingURL=clarification-comment-finder.d.ts.map

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":"AAYA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAwCpE,wBAAsB,wBAAwB,CAC5C,EAAE,EAAE,SAAS,EACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAyC9B"}

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

@@ -1,5 +1,57 @@
+/**
+ * `findClarificationComment` — marker-first / timeline-fallback strategy (#995).
+ *
+ * Primary path: return the latest-by-`createdAt` non-stage-status comment
+ * carrying a `CLARIFICATION_QUESTION_MARKERS` prefix at column 0. This survives
+ * `waiting-for:clarification` re-application (requeue / boot-resume / restart)
+ * that jumps the label timestamp past every question comment.
+ *
+ * Fallback path: today's most-recent-`labeled` + at-or-after scan, preserved
+ * verbatim for legacy marker-less batches. Emits one `warn` per invocation.
+ */
+import { matchClarificationQuestionMarker } from '@generacy-ai/orchestrator';
+import { getLogger } from '../../utils/logger.js';
 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 comments = await gh.fetchIssueComments(repo, number);
+    // Marker-first pass: survives waiting-for:clarification re-application that
+    // would otherwise strand the question comment behind the label event.
+    const markerHits = comments
+        .filter((c) => matchClarificationQuestionMarker(c.body) !== undefined)
+        .filter((c) => !isStageStatusComment(c.body))
+        .sort((a, b) => Date.parse(b.createdAt) - Date.parse(a.createdAt));
+    if (markerHits.length > 0)
+        return markerHits[0] ?? null;
+    const [owner, repoName] = repo.split('/', 2);
+    getLogger().warn({ owner, repo: repoName, issue: number }, `marker-less clarification comment; poster should be updated — issue=${repo}#${number}`);
     const timeline = (await gh.fetchIssueTimeline(repo, number));
     let latestLabelTs = null;
     for (const event of timeline) {
@@ -18,13 +70,14 @@ export async function findClarificationComment(gh, repo, number) {
     const labelTime = Date.parse(latestLabelTs);
     if (Number.isNaN(labelTime))
         return null;
-    const comments = await gh.fetchIssueComments(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":"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"}

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,103 @@
+/**
+ * `discoverChannelUrl` — resolves the smee.io channel URL for the doorbell to
+ * consume. Five-stage lookup: env override → webhook-config (via `gh api
+ * /hooks`) → workspace walk-up → absolute workspace-mirror path →
+ * cluster-internal fallback. Never throws; malformed input logs a warning and
+ * returns null.
+ *
+ * Contract: `specs/988-summary-cockpit-auto-doorbell/contracts/channel-discovery.md`.
+ */
+import type { PathLike } from 'node:fs';
+import { z } from 'zod';
+import type { CommandRunner } from '@generacy-ai/cockpit';
+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 DEFAULT_WEBHOOK_CONFIG_TIMEOUT_MS = 5000;
+export declare const SMEE_URL_PATTERN: RegExp;
+export type ChannelSource = 'env' | 'webhook-config' | '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;
+    /**
+     * Pre-parsed target repos for the webhook-config stage, primary-first.
+     * The caller (`doorbell.ts`) derives this via `resolveWebhookTargets`.
+     * When absent or empty, the webhook-config stage is skipped.
+     */
+    targets?: Array<{
+        owner: string;
+        repo: string;
+    }>;
+    /**
+     * Command runner used to invoke `gh api …/hooks`. When absent, the
+     * webhook-config stage is skipped even if `targets` is non-empty.
+     */
+    runner?: CommandRunner;
+    /**
+     * Per-call timeout for the `gh api …/hooks` invocation. Default 5000ms
+     * (spec FR-009). Exposed for tests.
+     */
+    webhookConfigTimeoutMs?: number;
+}
+export declare const SmeeHookSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    active: z.ZodBoolean;
+    config: z.ZodObject<{
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+    }, {
+        url: string;
+    }>;
+    updated_at: z.ZodString;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodNumber;
+    active: z.ZodBoolean;
+    config: z.ZodObject<{
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+    }, {
+        url: string;
+    }>;
+    updated_at: z.ZodString;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodNumber;
+    active: z.ZodBoolean;
+    config: z.ZodObject<{
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+    }, {
+        url: string;
+    }>;
+    updated_at: z.ZodString;
+}, z.ZodTypeAny, "passthrough">>;
+export type SmeeHook = z.infer<typeof SmeeHookSchema>;
+/**
+ * Pure tie-break for `/hooks` payloads (FR-005).
+ * 1. Keep only `active === true`.
+ * 2. Keep only entries whose `config.url` matches `SMEE_URL_PATTERN`.
+ * 3. Sort by `Date.parse(updated_at)` desc; `NaN` sorts last (`-Infinity`).
+ * 4. Return the first entry or `null`.
+ */
+export declare function pickSmeeHook(hooks: SmeeHook[]): SmeeHook | null;
+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;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,eAAO,MAAM,yBAAyB,mCAAmC,CAAC;AAC1E,eAAO,MAAM,6BAA6B,+CACI,CAAC;AAC/C,eAAO,MAAM,iCAAiC,OAAQ,CAAC;AAIvD,eAAO,MAAM,gBAAgB,QAAyC,CAAC;AAEvE,MAAM,MAAM,aAAa,GACrB,KAAK,GACL,gBAAgB,GAChB,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;IAC7B;;;;OAIG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD;;;OAGG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAOX,CAAC;AAEjB,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,GAAG,IAAI,CAU/D;AAoGD,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CA0FxC"}