@generacy-ai/generacy 0.3.4 → 0.4.0

package/dist/cli/commands/cockpit/watch/emit.d.ts

@@ -0,0 +1,58 @@
+import { z } from 'zod';
+import type { CockpitEvent } from './diff.js';
+export declare const CockpitEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"issue-transition">;
+    ts: z.ZodString;
+    repo: z.ZodString;
+    kind: z.ZodEnum<["issue", "pr"]>;
+    number: z.ZodNumber;
+    from: z.ZodUnion<[z.ZodEnum<["pending", "active", "waiting", "error", "terminal", "stage-complete", "unknown"]>, z.ZodNull]>;
+    to: z.ZodUnion<[z.ZodEnum<["pending", "active", "waiting", "error", "terminal", "stage-complete", "unknown"]>, z.ZodNull]>;
+    sourceLabel: z.ZodNullable<z.ZodString>;
+    url: z.ZodString;
+    event: z.ZodEnum<["label-change", "issue-closed", "pr-merged", "pr-closed", "pr-checks"]>;
+    labels: z.ZodArray<z.ZodString, "many">;
+    initial: z.ZodOptional<z.ZodLiteral<true>>;
+}, "strip", z.ZodTypeAny, {
+    number: number;
+    event: "label-change" | "issue-closed" | "pr-merged" | "pr-closed" | "pr-checks";
+    repo: string;
+    from: "error" | "pending" | "unknown" | "active" | "waiting" | "terminal" | "stage-complete" | null;
+    to: "error" | "pending" | "unknown" | "active" | "waiting" | "terminal" | "stage-complete" | null;
+    type: "issue-transition";
+    url: string;
+    sourceLabel: string | null;
+    labels: string[];
+    kind: "issue" | "pr";
+    ts: string;
+    initial?: true | undefined;
+}, {
+    number: number;
+    event: "label-change" | "issue-closed" | "pr-merged" | "pr-closed" | "pr-checks";
+    repo: string;
+    from: "error" | "pending" | "unknown" | "active" | "waiting" | "terminal" | "stage-complete" | null;
+    to: "error" | "pending" | "unknown" | "active" | "waiting" | "terminal" | "stage-complete" | null;
+    type: "issue-transition";
+    url: string;
+    sourceLabel: string | null;
+    labels: string[];
+    kind: "issue" | "pr";
+    ts: string;
+    initial?: true | undefined;
+}>;
+export type CockpitEventValidated = z.infer<typeof CockpitEventSchema>;
+export interface EmitOptions {
+    stdout?: {
+        write(chunk: string): boolean | void;
+    };
+    skipValidate?: boolean;
+}
+/**
+ * Emit one NDJSON-encoded line per CockpitEvent.
+ *
+ * Validation runs by default (dev-time defense). Writes via a single
+ * `process.stdout.write` (no `console.log` — that interleaves under high
+ * concurrency).
+ */
+export declare function emit(event: CockpitEvent, opts?: EmitOptions): void;
+//# sourceMappingURL=emit.d.ts.map

package/dist/cli/commands/cockpit/watch/emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/watch/emit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAa7B,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEvE,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAA;KAAE,CAAC;IAClD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,GAAE,WAAgB,GAAG,IAAI,CAKtE"}

package/dist/cli/commands/cockpit/watch/emit.js

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import { COCKPIT_STATES } from '@generacy-ai/cockpit';
+export const CockpitEventSchema = z.object({
+    type: z.literal('issue-transition'),
+    ts: z.string().datetime(),
+    repo: z.string().regex(/^[^/]+\/[^/]+$/),
+    kind: z.enum(['issue', 'pr']),
+    number: z.number().int().positive(),
+    from: z.union([z.enum(COCKPIT_STATES), z.null()]),
+    to: z.union([z.enum(COCKPIT_STATES), z.null()]),
+    sourceLabel: z.string().nullable(),
+    url: z.string().url(),
+    event: z.enum(['label-change', 'issue-closed', 'pr-merged', 'pr-closed', 'pr-checks']),
+    labels: z.array(z.string()),
+    initial: z.literal(true).optional(),
+});
+/**
+ * Emit one NDJSON-encoded line per CockpitEvent.
+ *
+ * Validation runs by default (dev-time defense). Writes via a single
+ * `process.stdout.write` (no `console.log` — that interleaves under high
+ * concurrency).
+ */
+export function emit(event, opts = {}) {
+    const out = opts.stdout ?? process.stdout;
+    const stamped = { ...event, type: 'issue-transition' };
+    const validated = opts.skipValidate === true ? stamped : CockpitEventSchema.parse(stamped);
+    out.write(`${JSON.stringify(validated)}\n`);
+}
+//# sourceMappingURL=emit.js.map

package/dist/cli/commands/cockpit/watch/emit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.js","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/watch/emit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC;IACnC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACnC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACjD,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACrB,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;IACtF,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC;AASH;;;;;;GAMG;AACH,MAAM,UAAU,IAAI,CAAC,KAAmB,EAAE,OAAoB,EAAE;IAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAC1C,MAAM,OAAO,GAAG,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,kBAA2B,EAAE,CAAC;IAChE,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3F,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AAC9C,CAAC"}

package/dist/cli/commands/cockpit/watch/poll-loop.d.ts

@@ -0,0 +1,29 @@
+import type { GhWrapper, IssueRef } from '@generacy-ai/cockpit';
+import { type CockpitEvent } from './diff.js';
+import { type SnapshotMap } from './snapshot.js';
+export interface PollDeps {
+    gh: GhWrapper;
+    /** Refs resolved from the epic body for this tick. */
+    refs: IssueRef[];
+    /** `owner/repo` of the epic itself — used only as the zero-refs fallback query target. */
+    epicOwnerRepo: string;
+    safetyCap?: number;
+    pageSize?: number;
+    logger?: {
+        warn: (msg: string) => void;
+    };
+    now?: () => string;
+}
+export interface PollResult {
+    curr: SnapshotMap;
+    events: CockpitEvent[];
+}
+/**
+ * Run one poll cycle: list issues per repo, classify, snapshot, fetch PR checks,
+ * derive PR lifecycle, compute transitions vs `prev`.
+ *
+ * Pure over its deps — all I/O goes through `deps.gh`. The shell (`watch.ts`)
+ * owns the loop, sleep, resolver call, and signal handling.
+ */
+export declare function runOnePoll(prev: SnapshotMap, deps: PollDeps): Promise<PollResult>;
+//# sourceMappingURL=poll-loop.d.ts.map

package/dist/cli/commands/cockpit/watch/poll-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll-loop.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/watch/poll-loop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EAET,QAAQ,EACT,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAElE,OAAO,EAML,KAAK,WAAW,EACjB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,SAAS,CAAC;IACd,sDAAsD;IACtD,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,0FAA0F;IAC1F,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC;IACzC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB;AA8BD;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,UAAU,CAAC,CAwCrB"}

package/dist/cli/commands/cockpit/watch/poll-loop.js

@@ -0,0 +1,81 @@
+import { classifyIssue } from '../shared/classify-issue.js';
+import { listAllIssues } from '../shared/pagination.js';
+import { rollup } from './check-rollup.js';
+import { computeTransitions } from './diff.js';
+import { derivePrLifecycle } from './pr-state.js';
+import { buildIssueSnapshot, buildPrSnapshot, snapshotKey, } from './snapshot.js';
+function isPullRequest(issue) {
+    if (issue.url != null && /\/pull\/\d+/.test(issue.url))
+        return true;
+    return issue.labels.includes('type:pr');
+}
+function queryForRepo(refs, repo) {
+    const numbers = refs.filter((r) => r.repo === repo).map((r) => r.number);
+    const nums = numbers.map((n) => String(n)).join(' ');
+    if (nums.length === 0) {
+        // Zero-result sentinel to keep the poll shape consistent.
+        return `repo:${repo} is:issue no:label cockpit-no-match-sentinel`;
+    }
+    return `repo:${repo} ${nums}`;
+}
+function reposFromRefs(refs, fallback) {
+    const seen = new Set();
+    const out = [];
+    for (const ref of refs) {
+        if (!seen.has(ref.repo)) {
+            seen.add(ref.repo);
+            out.push(ref.repo);
+        }
+    }
+    if (out.length === 0)
+        return [fallback];
+    return out;
+}
+/**
+ * Run one poll cycle: list issues per repo, classify, snapshot, fetch PR checks,
+ * derive PR lifecycle, compute transitions vs `prev`.
+ *
+ * Pure over its deps — all I/O goes through `deps.gh`. The shell (`watch.ts`)
+ * owns the loop, sleep, resolver call, and signal handling.
+ */
+export async function runOnePoll(prev, deps) {
+    const curr = new Map();
+    const repos = reposFromRefs(deps.refs, deps.epicOwnerRepo);
+    for (const repo of repos) {
+        const query = queryForRepo(deps.refs, repo);
+        const issues = await listAllIssues(deps.gh, query, {
+            ...(deps.safetyCap != null ? { safetyCap: deps.safetyCap } : {}),
+            ...(deps.pageSize != null ? { pageSize: deps.pageSize } : {}),
+            ...(deps.logger != null ? { logger: deps.logger } : {}),
+        });
+        for (const issue of issues) {
+            const classified = classifyIssue(issue.labels);
+            let snapshot;
+            if (isPullRequest(issue)) {
+                const key = snapshotKey(repo, 'pr', issue.number);
+                const prevSnap = prev.get(key);
+                const lifecycle = await derivePrLifecycle(repo, prevSnap, issue, {
+                    getPullRequest: deps.gh.getPullRequest.bind(deps.gh),
+                });
+                let checksResult;
+                try {
+                    checksResult = rollup(await deps.gh.getPullRequestCheckRuns(repo, issue.number));
+                }
+                catch {
+                    checksResult = 'error';
+                }
+                snapshot = buildPrSnapshot(repo, issue, classified, lifecycle, checksResult);
+                curr.set(key, snapshot);
+            }
+            else {
+                const key = snapshotKey(repo, 'issue', issue.number);
+                snapshot = buildIssueSnapshot(repo, issue, classified);
+                curr.set(key, snapshot);
+            }
+        }
+    }
+    const now = deps.now;
+    const events = now != null ? computeTransitions(prev, curr, now) : computeTransitions(prev, curr);
+    return { curr, events };
+}
+//# sourceMappingURL=poll-loop.js.map

package/dist/cli/commands/cockpit/watch/poll-loop.js.map

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

package/dist/cli/commands/cockpit/watch/pr-state.d.ts

@@ -0,0 +1,17 @@
+import type { GhWrapper, Issue } from '@generacy-ai/cockpit';
+import type { PrLifecycle, Snapshot } from './snapshot.js';
+export interface DerivePrLifecycleDeps {
+    getPullRequest: GhWrapper['getPullRequest'];
+}
+/**
+ * Derive the lifecycle of a PR (`open` | `closed` | `merged`).
+ *
+ * Plan D5: avoid an extra `gh pr view` call per cycle for stable PRs. Only call
+ * `getPullRequest` when:
+ *   - the previous snapshot was OPEN (or absent) AND the current issue state is
+ *     CLOSED — i.e. the PR just flipped to closed and we don't yet know if it
+ *     was merged.
+ * Otherwise reuse the prior lifecycle (or default 'open' if no prev).
+ */
+export declare function derivePrLifecycle(repo: string, prev: Snapshot | undefined, issue: Pick<Issue, 'number' | 'state'>, deps: DerivePrLifecycleDeps): Promise<PrLifecycle>;
+//# sourceMappingURL=pr-state.d.ts.map

package/dist/cli/commands/cockpit/watch/pr-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-state.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/watch/pr-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAsB,MAAM,sBAAsB,CAAC;AACjF,OAAO,KAAK,EAAE,WAAW,EAAc,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEvE,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,SAAS,CAAC,gBAAgB,CAAC,CAAC;CAC7C;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,QAAQ,GAAG,SAAS,EAC1B,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,EACtC,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,WAAW,CAAC,CAiBtB"}

package/dist/cli/commands/cockpit/watch/pr-state.js

@@ -0,0 +1,33 @@
+/**
+ * Derive the lifecycle of a PR (`open` | `closed` | `merged`).
+ *
+ * Plan D5: avoid an extra `gh pr view` call per cycle for stable PRs. Only call
+ * `getPullRequest` when:
+ *   - the previous snapshot was OPEN (or absent) AND the current issue state is
+ *     CLOSED — i.e. the PR just flipped to closed and we don't yet know if it
+ *     was merged.
+ * Otherwise reuse the prior lifecycle (or default 'open' if no prev).
+ */
+export async function derivePrLifecycle(repo, prev, issue, deps) {
+    const wasMerged = prev != null && prev.kind === 'pr' && prev.lifecycle === 'merged';
+    const wasClosed = prev != null && prev.kind === 'pr' && prev.lifecycle === 'closed';
+    if (issue.state === 'OPEN')
+        return 'open';
+    if (wasMerged)
+        return 'merged';
+    if (wasClosed)
+        return 'closed';
+    // Issue state flipped to CLOSED — disambiguate via getPullRequest.
+    let summary;
+    try {
+        summary = await deps.getPullRequest(repo, issue.number);
+    }
+    catch {
+        return 'closed';
+    }
+    if (summary.state === 'MERGED' || (summary.mergedAt != null && summary.mergedAt.length > 0)) {
+        return 'merged';
+    }
+    return 'closed';
+}
+//# sourceMappingURL=pr-state.js.map

package/dist/cli/commands/cockpit/watch/pr-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-state.js","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/watch/pr-state.ts"],"names":[],"mappings":"AAOA;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAY,EACZ,IAA0B,EAC1B,KAAsC,EACtC,IAA2B;IAE3B,MAAM,SAAS,GAAG,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC;IACpF,MAAM,SAAS,GAAG,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC;IACpF,IAAI,KAAK,CAAC,KAAK,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1C,IAAI,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC/B,IAAI,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC/B,mEAAmE;IACnE,IAAI,OAA2B,CAAC;IAChC,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;QAC5F,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/cli/commands/cockpit/watch/snapshot.d.ts

@@ -0,0 +1,33 @@
+import type { Issue } from '@generacy-ai/cockpit';
+import type { ClassifiedIssue } from '../shared/classify-issue.js';
+export type SnapshotKey = string;
+export type ChecksRollup = 'pending' | 'success' | 'failure' | 'none' | 'error';
+export type PrLifecycle = 'open' | 'closed' | 'merged';
+export interface IssueSnapshot {
+    kind: 'issue';
+    repo: string;
+    number: number;
+    url: string;
+    state: 'OPEN' | 'CLOSED';
+    stateReason: 'COMPLETED' | 'NOT_PLANNED' | null;
+    labels: string[];
+    classified: ClassifiedIssue;
+}
+export interface PrSnapshot {
+    kind: 'pr';
+    repo: string;
+    number: number;
+    url: string;
+    lifecycle: PrLifecycle;
+    state: 'OPEN' | 'CLOSED';
+    stateReason: 'COMPLETED' | 'NOT_PLANNED' | null;
+    labels: string[];
+    classified: ClassifiedIssue;
+    checksRollup: ChecksRollup;
+}
+export type Snapshot = IssueSnapshot | PrSnapshot;
+export type SnapshotMap = Map<SnapshotKey, Snapshot>;
+export declare function snapshotKey(repo: string, kind: 'issue' | 'pr', number: number): SnapshotKey;
+export declare function buildIssueSnapshot(repo: string, issue: Pick<Issue, 'number' | 'url' | 'state' | 'stateReason' | 'labels'>, classified: ClassifiedIssue): IssueSnapshot;
+export declare function buildPrSnapshot(repo: string, issue: Pick<Issue, 'number' | 'url' | 'state' | 'stateReason' | 'labels'>, classified: ClassifiedIssue, lifecycle: PrLifecycle, rollup: ChecksRollup): PrSnapshot;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/cli/commands/cockpit/watch/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/watch/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAEjC,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAChF,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzB,WAAW,EAAE,WAAW,GAAG,aAAa,GAAG,IAAI,CAAC;IAChD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,eAAe,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,WAAW,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzB,WAAW,EAAE,WAAW,GAAG,aAAa,GAAG,IAAI,CAAC;IAChD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,eAAe,CAAC;IAC5B,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,MAAM,MAAM,QAAQ,GAAG,aAAa,GAAG,UAAU,CAAC;AAClD,MAAM,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;AAErD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAE3F;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,aAAa,GAAG,QAAQ,CAAC,EACzE,UAAU,EAAE,eAAe,GAC1B,aAAa,CAWf;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,aAAa,GAAG,QAAQ,CAAC,EACzE,UAAU,EAAE,eAAe,EAC3B,SAAS,EAAE,WAAW,EACtB,MAAM,EAAE,YAAY,GACnB,UAAU,CAaZ"}

package/dist/cli/commands/cockpit/watch/snapshot.js

@@ -0,0 +1,30 @@
+export function snapshotKey(repo, kind, number) {
+    return `${repo}#${kind}#${number}`;
+}
+export function buildIssueSnapshot(repo, issue, classified) {
+    return {
+        kind: 'issue',
+        repo,
+        number: issue.number,
+        url: issue.url,
+        state: issue.state,
+        stateReason: issue.stateReason,
+        labels: [...issue.labels],
+        classified,
+    };
+}
+export function buildPrSnapshot(repo, issue, classified, lifecycle, rollup) {
+    return {
+        kind: 'pr',
+        repo,
+        number: issue.number,
+        url: issue.url,
+        state: issue.state,
+        stateReason: issue.stateReason,
+        lifecycle,
+        labels: [...issue.labels],
+        classified,
+        checksRollup: rollup,
+    };
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/cli/commands/cockpit/watch/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/watch/snapshot.ts"],"names":[],"mappings":"AAmCA,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,IAAoB,EAAE,MAAc;IAC5E,OAAO,GAAG,IAAI,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,KAAyE,EACzE,UAA2B;IAE3B,OAAO;QACL,IAAI,EAAE,OAAO;QACb,IAAI;QACJ,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;QACzB,UAAU;KACX,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,KAAyE,EACzE,UAA2B,EAC3B,SAAsB,EACtB,MAAoB;IAEpB,OAAO;QACL,IAAI,EAAE,IAAI;QACV,IAAI;QACJ,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,SAAS;QACT,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;QACzB,UAAU;QACV,YAAY,EAAE,MAAM;KACrB,CAAC;AACJ,CAAC"}

package/dist/cli/commands/cockpit/watch/stream-event.d.ts

@@ -0,0 +1,82 @@
+import { z } from 'zod';
+export declare const CockpitStreamEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"issue-transition">;
+    ts: z.ZodString;
+    repo: z.ZodString;
+    kind: z.ZodEnum<["issue", "pr"]>;
+    number: z.ZodNumber;
+    from: z.ZodUnion<[z.ZodEnum<["pending", "active", "waiting", "error", "terminal", "stage-complete", "unknown"]>, z.ZodNull]>;
+    to: z.ZodUnion<[z.ZodEnum<["pending", "active", "waiting", "error", "terminal", "stage-complete", "unknown"]>, z.ZodNull]>;
+    sourceLabel: z.ZodNullable<z.ZodString>;
+    url: z.ZodString;
+    event: z.ZodEnum<["label-change", "issue-closed", "pr-merged", "pr-closed", "pr-checks"]>;
+    labels: z.ZodArray<z.ZodString, "many">;
+    initial: z.ZodOptional<z.ZodLiteral<true>>;
+}, "strip", z.ZodTypeAny, {
+    number: number;
+    event: "label-change" | "issue-closed" | "pr-merged" | "pr-closed" | "pr-checks";
+    repo: string;
+    from: "error" | "pending" | "unknown" | "active" | "waiting" | "terminal" | "stage-complete" | null;
+    to: "error" | "pending" | "unknown" | "active" | "waiting" | "terminal" | "stage-complete" | null;
+    type: "issue-transition";
+    url: string;
+    sourceLabel: string | null;
+    labels: string[];
+    kind: "issue" | "pr";
+    ts: string;
+    initial?: true | undefined;
+}, {
+    number: number;
+    event: "label-change" | "issue-closed" | "pr-merged" | "pr-closed" | "pr-checks";
+    repo: string;
+    from: "error" | "pending" | "unknown" | "active" | "waiting" | "terminal" | "stage-complete" | null;
+    to: "error" | "pending" | "unknown" | "active" | "waiting" | "terminal" | "stage-complete" | null;
+    type: "issue-transition";
+    url: string;
+    sourceLabel: string | null;
+    labels: string[];
+    kind: "issue" | "pr";
+    ts: string;
+    initial?: true | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"phase-complete">;
+    phase: z.ZodString;
+    epicRepo: z.ZodString;
+    epicNumber: z.ZodNumber;
+    ts: z.ZodString;
+    initial: z.ZodOptional<z.ZodLiteral<true>>;
+}, "strict", z.ZodTypeAny, {
+    phase: string;
+    type: "phase-complete";
+    ts: string;
+    epicRepo: string;
+    epicNumber: number;
+    initial?: true | undefined;
+}, {
+    phase: string;
+    type: "phase-complete";
+    ts: string;
+    epicRepo: string;
+    epicNumber: number;
+    initial?: true | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"epic-complete">;
+    epicRepo: z.ZodString;
+    epicNumber: z.ZodNumber;
+    ts: z.ZodString;
+    initial: z.ZodOptional<z.ZodLiteral<true>>;
+}, "strict", z.ZodTypeAny, {
+    type: "epic-complete";
+    ts: string;
+    epicRepo: string;
+    epicNumber: number;
+    initial?: true | undefined;
+}, {
+    type: "epic-complete";
+    ts: string;
+    epicRepo: string;
+    epicNumber: number;
+    initial?: true | undefined;
+}>]>;
+export type CockpitStreamEvent = z.infer<typeof CockpitStreamEventSchema>;
+//# sourceMappingURL=stream-event.d.ts.map

package/dist/cli/commands/cockpit/watch/stream-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-event.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/watch/stream-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAInC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/cli/commands/cockpit/watch/stream-event.js

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+import { CockpitEventSchema } from './emit.js';
+import { PhaseCompleteEventSchema, EpicCompleteEventSchema } from './aggregate-emit.js';
+export const CockpitStreamEventSchema = z.discriminatedUnion('type', [
+    CockpitEventSchema,
+    PhaseCompleteEventSchema,
+    EpicCompleteEventSchema,
+]);
+//# sourceMappingURL=stream-event.js.map

package/dist/cli/commands/cockpit/watch/stream-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-event.js","sourceRoot":"","sources":["../../../../../src/cli/commands/cockpit/watch/stream-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAExF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACnE,kBAAkB;IAClB,wBAAwB;IACxB,uBAAuB;CACxB,CAAC,CAAC"}

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

@@ -0,0 +1,22 @@
+import { Command } from 'commander';
+import { type CommandRunner, type GhWrapper } from '@generacy-ai/cockpit';
+interface WatchOptions {
+    interval?: string;
+    safetyCap?: string;
+    exitOnEpicComplete?: boolean;
+}
+export interface WatchDeps {
+    gh?: GhWrapper;
+    runner?: CommandRunner;
+    logger?: {
+        warn: (msg: string) => void;
+    };
+    intervalOverride?: number;
+    onTick?: () => void;
+    /** Optional external abort — used by tests to stop the loop deterministically. */
+    abortSignal?: AbortSignal;
+}
+export declare function runWatch(epicRef: string | undefined, options: WatchOptions, deps?: WatchDeps): Promise<number>;
+export declare function watchCommand(): Command;
+export {};
+//# sourceMappingURL=watch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/cockpit/watch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,SAAS,EAEf,MAAM,sBAAsB,CAAC;AAY9B,UAAU,YAAY;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AA8CD,MAAM,WAAW,SAAS;IACxB,EAAE,CAAC,EAAE,SAAS,CAAC;IACf,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,kFAAkF;IAClF,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,YAAY,EACrB,IAAI,GAAE,SAAc,GACnB,OAAO,CAAC,MAAM,CAAC,CA4IjB;AAED,wBAAgB,YAAY,IAAI,OAAO,CActC"}