@generacy-ai/cockpit 0.6.0 → 0.7.0

package/README.md

@@ -78,6 +78,154 @@ cockpit:
   owner: alice   # optional; defaults to `gh auth status` login
 ```
 
+## Gates protocol (Cockpit Remote Gates epic, P2 mirror-doc)
+
+**Audience**: engineers implementing the P2 cloud-side fake-cluster tests in
+`generacy-ai/generacy-cloud`. This section pins the wire shapes exchanged
+between the cluster-side integration harness (`packages/orchestrator/src/__tests__/cockpit-gates-integration.integration.test.ts`)
+and the fake relay peer, so the cloud side can emit and expect the exact
+same bytes without cross-repo copy-paste.
+
+**Single-source the shapes**: build every wire body through the fixture
+builders exported from `@generacy-ai/cockpit` so cluster and cloud stay
+byte-identical — never hand-inline a literal:
+
+```ts
+import {
+  gateOpenFixture,   // POST /cockpit/gates body           → GateOpenSchema
+  gateAckFixture,    // POST /cockpit/gates/:id/ack body    → GateAckSchema
+  answerLineFixture, // POST /cockpit/answers body + tail   → GateAnswerEnvelopeSchema (+ scope)
+  DEFAULT_WIRE_SCOPE,   // { owner, repo, number }
+  DEFAULT_WIRE_EPIC_REF // "owner/repo#number"
+} from '@generacy-ai/cockpit';
+```
+
+### Wire framing
+
+All messages are JSON-encoded WebSocket text frames matching
+`RelayMessageSchema` from `@generacy-ai/cluster-relay`. No custom framing,
+no compression, no TLS in tests (fake peer is `ws://127.0.0.1:<port>`).
+
+### Cluster → Cloud
+
+**Gate-open event** (emitted when a `POST /cockpit/gates` succeeds). The
+route echoes the validated `GateOpen` envelope as `data` verbatim — the
+`kind` discriminator lives at the top of `data`, not nested under a `gate`
+key:
+
+```jsonc
+{
+  "type": "event",
+  "event": "cluster.cockpit",
+  "timestamp": "2026-07-21T12:34:56.789Z",
+  "data": {
+    "kind": "gate-open",
+    "gateId": "g_…",
+    "generation": 0,
+    "scope": { "owner": "generacy-ai", "repo": "generacy", "number": 1024 },
+    "openedAt": "2026-07-21T12:00:00.000Z"
+    // …plus any passthrough keys (e.g. `payload`) — GateOpenSchema is .passthrough()
+  }
+}
+```
+
+**Gate-ack event** (emitted when a `POST /cockpit/gates/:id/ack` succeeds).
+`data` is the validated `GateAck` envelope; the route injects the path `:id`
+as `gateId`:
+
+```jsonc
+{
+  "type": "event",
+  "event": "cluster.cockpit",
+  "timestamp": "…",
+  "data": {
+    "kind": "gate-ack",
+    "gateId": "g_…",
+    "generation": 0,
+    "outcome": "answered",
+    "ackedAt": "2026-07-21T12:05:01.000Z"
+    // …plus any passthrough keys (e.g. `answer`)
+  }
+}
+```
+
+Both events use `data.kind` (`"gate-open"` | `"gate-ack"`) as the
+discriminator on the `cluster.cockpit` channel.
+
+### Cloud → Cluster
+
+**Answer down-path** — the cloud injects operator-authored answers into the
+cluster via an `api_request` frame that the orchestrator proxies to its
+`POST /cockpit/answers` route:
+
+```jsonc
+{
+  "type": "api_request",
+  "correlationId": "<uuid v4>",
+  "method": "POST",
+  "path": "/cockpit/answers",
+  "headers": { "content-type": "application/json" },
+  "body": {
+    "kind": "gate-answer",
+    "deliveryId": "dlv_…",   // dedup key — the writer keeps one file line per deliveryId
+    "gateId": "g_…",
+    "generation": 0,
+    "answeredAt": "2026-07-21T12:05:00.000Z",
+    "answer": { /* operator's choice */ },
+    "scope": { "owner": "generacy-ai", "repo": "generacy", "number": 1024 }
+    // `answeredBy` optional
+  }
+}
+```
+
+> **Seam pinned by the harness**: the answers route validates
+> `GateAnswerEnvelopeSchema` (which does not require `scope`), but the doorbell
+> tailer validates `GateAnswerLineSchema` (which does). A body **without**
+> `scope` is written to the answers file yet silently dropped by the doorbell.
+> `answerLineFixture()` carries `scope` so the single wire shape satisfies both
+> ends — mirror it exactly.
+
+Response frame (200 on happy path, `{ accepted, deduped }`; 4xx on validation
+error):
+
+```jsonc
+{
+  "type": "api_response",
+  "correlationId": "<same as request>",
+  "status": 200,
+  "body": { "accepted": true, "deduped": false }
+}
+```
+
+### Connection lifecycle
+
+1. Orchestrator dials `wss://…/relay` (or `ws://127.0.0.1:<port>` in tests).
+2. Orchestrator sends a `handshake` frame carrying its cluster metadata.
+3. Peer responds with a `heartbeat` frame — this transitions the client from
+   `authenticating → connected`. (Fake peer mirrors this pattern; see
+   `packages/cluster-relay/tests/relay.test.ts:93-100`.)
+4. Steady state: `event` / `api_request` / `api_response` frames in both
+   directions, `heartbeat` at the configured interval.
+
+### Retain-and-replay across disconnect
+
+When the peer disconnects while a `cluster.cockpit` event is pending, the
+orchestrator retains the event and replays it on the next successful
+connection. Mirror of the `cluster.vscode-tunnel` pattern in
+`packages/orchestrator/src/routes/retained-tunnel-event.ts`.
+
+Assertion pattern (harness scenario S1b): `disconnect → POST /cockpit/gates
+→ reconnect → assert peer sees the event exactly once on the new socket`.
+
+### Further reading
+
+- Harness invocation and troubleshooting:
+  [`specs/1024-part-cockpit-remote-gates/quickstart.md`](../../specs/1024-part-cockpit-remote-gates/quickstart.md).
+- Fake-peer wire contract in full:
+  [`specs/1024-part-cockpit-remote-gates/contracts/fake-peer-protocol.md`](../../specs/1024-part-cockpit-remote-gates/contracts/fake-peer-protocol.md).
+- 8-scenario catalog:
+  [`specs/1024-part-cockpit-remote-gates/contracts/scenario-catalog.md`](../../specs/1024-part-cockpit-remote-gates/contracts/scenario-catalog.md).
+
 ## References
 
 - Spec: [`specs/806-epic-generacy-ai-tetrad/spec.md`](../../specs/806-epic-generacy-ai-tetrad/spec.md)

package/dist/gates/clarification-hash.d.ts

@@ -0,0 +1,33 @@
+/**
+ * A single question in a clarification-gate answer set.
+ *
+ * The canonical hash projects to only `questionNumber` + `questionText` —
+ * extra fields (e.g. drafted answers, timestamps) are stripped and MUST NOT
+ * influence gate identity. Same round of asks → same generation.
+ */
+export interface ClarificationQuestion {
+    questionNumber: number;
+    questionText: string;
+}
+export interface ComputeClarificationAnswerSetHashInput {
+    questions: readonly ClarificationQuestion[];
+}
+/**
+ * Canonical answer-set hash for a `clarification`-gate `generation` (#1038).
+ *
+ * Algorithm (locked by SC-002 — MUST match agency sweep byte-for-byte):
+ *   1. Sort ascending by `questionNumber`.
+ *   2. Project to exactly `{ questionNumber, questionText }` (drop any extra
+ *      fields — this is the mechanical enforcement of "question identity
+ *      only; drafted/pending answers excluded" per spec Q1 → A).
+ *   3. `JSON.stringify` the projected array.
+ *   4. `sha256` the canonical string.
+ *   5. Return the first 12 hex characters (48 bits — collision-safe for the
+ *      population; keeps `gateKey` short in logs).
+ *
+ * Consumers pass the returned string as the `batchId` argument to
+ * `deriveClarificationGeneration({ batchId })`. Both the agency-side sweep
+ * and the cluster-side live path MUST go through this helper.
+ */
+export declare function computeClarificationAnswerSetHash(input: ComputeClarificationAnswerSetHashInput): string;
+//# sourceMappingURL=clarification-hash.d.ts.map

package/dist/gates/clarification-hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clarification-hash.d.ts","sourceRoot":"","sources":["../../src/gates/clarification-hash.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sCAAsC;IACrD,SAAS,EAAE,SAAS,qBAAqB,EAAE,CAAC;CAC7C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,sCAAsC,GAC5C,MAAM,CASR"}

package/dist/gates/clarification-hash.js

@@ -0,0 +1,27 @@
+import { createHash } from 'node:crypto';
+/**
+ * Canonical answer-set hash for a `clarification`-gate `generation` (#1038).
+ *
+ * Algorithm (locked by SC-002 — MUST match agency sweep byte-for-byte):
+ *   1. Sort ascending by `questionNumber`.
+ *   2. Project to exactly `{ questionNumber, questionText }` (drop any extra
+ *      fields — this is the mechanical enforcement of "question identity
+ *      only; drafted/pending answers excluded" per spec Q1 → A).
+ *   3. `JSON.stringify` the projected array.
+ *   4. `sha256` the canonical string.
+ *   5. Return the first 12 hex characters (48 bits — collision-safe for the
+ *      population; keeps `gateKey` short in logs).
+ *
+ * Consumers pass the returned string as the `batchId` argument to
+ * `deriveClarificationGeneration({ batchId })`. Both the agency-side sweep
+ * and the cluster-side live path MUST go through this helper.
+ */
+export function computeClarificationAnswerSetHash(input) {
+    const sorted = [...input.questions].sort((a, b) => a.questionNumber - b.questionNumber);
+    const canonical = JSON.stringify(sorted.map((q) => ({
+        questionNumber: q.questionNumber,
+        questionText: q.questionText,
+    })));
+    return createHash('sha256').update(canonical, 'utf8').digest('hex').slice(0, 12);
+}
+//# sourceMappingURL=clarification-hash.js.map

package/dist/gates/clarification-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clarification-hash.js","sourceRoot":"","sources":["../../src/gates/clarification-hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAkBzC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,iCAAiC,CAC/C,KAA6C;IAE7C,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,cAAc,CAAC,CAAC;IACxF,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAC9B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACjB,cAAc,EAAE,CAAC,CAAC,cAAc;QAChC,YAAY,EAAE,CAAC,CAAC,YAAY;KAC7B,CAAC,CAAC,CACJ,CAAC;IACF,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACnF,CAAC"}

package/dist/gates/fixtures.d.ts

@@ -0,0 +1,15 @@
+import { type GateAnswer, type GateOpen, type GateOutcome, type GateType } from './schema.js';
+import type { ClarificationQuestion } from './clarification-hash.js';
+export declare const VALID_FIXTURES: Record<GateType, GateOpen>;
+export declare const VALID_ANSWER_FIXTURES: Record<GateType, GateAnswer>;
+export declare const VALID_ACK_FIXTURES: Record<'applied' | 'superseded' | 'failed', GateOutcome>;
+export declare const MALFORMED_FIXTURES: Record<string, unknown>;
+export interface ClarificationAnswerSetFixture {
+    readonly questions: readonly ClarificationQuestion[];
+}
+export declare const CLARIFICATION_ANSWER_SET_FIXTURES: Readonly<{
+    readonly singleQuestion: ClarificationAnswerSetFixture;
+    readonly threeQuestions: ClarificationAnswerSetFixture;
+    readonly unicode: ClarificationAnswerSetFixture;
+}>;
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/gates/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/gates/fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,QAAQ,EACd,MAAM,aAAa,CAAC;AAYrB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAmErE,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,QAAQ,EAAE,QAAQ,CASrD,CAAC;AAyCF,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,QAAQ,EAAE,UAAU,CAS9D,CAAC;AAOF,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,SAAS,GAAG,YAAY,GAAG,QAAQ,EAAE,WAAW,CAqBvF,CAAC;AAqBF,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAgDtD,CAAC;AAOF,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,SAAS,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACtD;AAED,eAAO,MAAM,iCAAiC;6BAKtC,6BAA6B;6BAQ7B,6BAA6B;sBAa7B,6BAA6B;EAC1B,CAAC"}

package/dist/gates/fixtures.js

@@ -0,0 +1,227 @@
+import { GateAnswerSchema, GateOpenSchema, GateOutcomeSchema, deriveGateId, deriveGateKey, } from './schema.js';
+import { issueRefToString } from './schemas.js';
+import { deriveArtifactReviewGeneration, deriveClarificationGeneration, deriveEscalationGeneration, deriveFilingGeneration, deriveImplementationReviewGeneration, deriveManualValidationGeneration, derivePhaseQueueGeneration, deriveScopeDrainedGeneration, } from './generation.js';
+const EPIC_REF = { owner: 'generacy-ai', repo: 'generacy', number: 1000 };
+const ISSUE_REF = { owner: 'generacy-ai', repo: 'generacy', number: 1020 };
+const TRACKING_REF = { owner: 'generacy-ai', repo: 'generacy', number: 900 };
+const EPIC_REF_STR = issueRefToString(EPIC_REF);
+const ISSUE_REF_STR = issueRefToString(ISSUE_REF);
+const SESSION_ID = 'sess-abc123def456';
+const ASKED_AT = '2026-07-21T12:00:00.000Z';
+const ANSWERED_AT = '2026-07-21T12:05:00.000Z';
+const OUTCOME_AT = '2026-07-21T12:05:01.000Z';
+const ACTOR = {
+    userId: 'user-1',
+    email: 'operator@example.com',
+    displayName: 'Operator One',
+};
+const DEFAULT_OPTIONS = [
+    { id: 'opt-a', label: 'Approve', description: 'Approve and proceed' },
+    { id: 'opt-b', label: 'Reject', description: 'Reject and halt', recommended: true },
+];
+const GENERATIONS = {
+    clarification: deriveClarificationGeneration({ batchId: 'batch-abc123' }),
+    'artifact-review': deriveArtifactReviewGeneration({ kind: 'spec-review', headSha: 'abc1234' }),
+    'implementation-review': deriveImplementationReviewGeneration({ headSha: 'def5678' }),
+    'manual-validation': deriveManualValidationGeneration({ phaseNumber: 2 }),
+    escalation: deriveEscalationGeneration({
+        subtype: 'stalled',
+        labelOrState: 'agent:error',
+        counter: 1,
+    }),
+    'phase-queue': derivePhaseQueueGeneration({ phaseNumber: 3 }),
+    filing: deriveFilingGeneration({ draftHash: 'feedbeef1234' }),
+    'scope-drained': deriveScopeDrainedGeneration({ trackingIssueRef: TRACKING_REF, counter: 1 }),
+};
+// phase-queue is the sole per-issue exception: its wire `issueRef` slot carries
+// the EPIC ref, not a child issue (see the auto.md UI-mode gate-mapping table).
+function issueRefFor(gateType) {
+    return gateType === 'phase-queue' ? EPIC_REF_STR : ISSUE_REF_STR;
+}
+function buildRecord(gateType) {
+    const generation = GENERATIONS[gateType];
+    const issueRef = issueRefFor(gateType);
+    const gateKey = deriveGateKey(issueRef, gateType, generation);
+    const gateId = deriveGateId(gateKey);
+    return {
+        type: 'gate-open',
+        gateId,
+        gateKey,
+        gateType,
+        epicRef: EPIC_REF_STR,
+        issueRef,
+        issueTitle: `Issue #${ISSUE_REF.number}: cockpit remote gates`,
+        issueUrl: `https://github.com/${ISSUE_REF.owner}/${ISSUE_REF.repo}/issues/${ISSUE_REF.number}`,
+        title: `${gateType} gate`,
+        body: `Please review the ${gateType} gate.`,
+        options: DEFAULT_OPTIONS.map((o) => ({ ...o })),
+        allowFreeText: true,
+        sessionId: SESSION_ID,
+        askedAt: ASKED_AT,
+    };
+}
+export const VALID_FIXTURES = {
+    clarification: buildRecord('clarification'),
+    'artifact-review': buildRecord('artifact-review'),
+    'implementation-review': buildRecord('implementation-review'),
+    'manual-validation': buildRecord('manual-validation'),
+    escalation: buildRecord('escalation'),
+    'phase-queue': buildRecord('phase-queue'),
+    filing: buildRecord('filing'),
+    'scope-drained': buildRecord('scope-drained'),
+};
+// Assert every valid fixture parses at module load — fixture drift fails the build,
+// not a test run.
+for (const gateType of Object.keys(VALID_FIXTURES)) {
+    GateOpenSchema.parse(VALID_FIXTURES[gateType]);
+}
+// optionId XOR free-text is NOT enforced on the wire (the cloud sends the unused
+// side as an explicit null); every fixture therefore carries both fields.
+const ANSWER_SPECS = {
+    clarification: { optionId: 'opt-a', freeText: null },
+    'artifact-review': { optionId: null, freeText: 'approve with concerns' },
+    'implementation-review': { optionId: 'opt-a', freeText: null },
+    'manual-validation': { optionId: null, freeText: 'verified manually on 2026-07-21' },
+    escalation: { optionId: 'opt-a', freeText: null },
+    'phase-queue': { optionId: null, freeText: 'proceed with next phase' },
+    filing: { optionId: 'opt-a', freeText: null },
+    'scope-drained': { optionId: null, freeText: 'confirmed scope drained' },
+};
+function buildAnswer(gateType) {
+    const record = VALID_FIXTURES[gateType];
+    const spec = ANSWER_SPECS[gateType];
+    return {
+        type: 'gate-answer',
+        gateId: record.gateId,
+        gateKey: record.gateKey,
+        optionId: spec.optionId,
+        freeText: spec.freeText,
+        actor: { ...ACTOR },
+        answeredAt: ANSWERED_AT,
+        deliveryId: `delivery-${gateType}-1`,
+    };
+}
+export const VALID_ANSWER_FIXTURES = {
+    clarification: buildAnswer('clarification'),
+    'artifact-review': buildAnswer('artifact-review'),
+    'implementation-review': buildAnswer('implementation-review'),
+    'manual-validation': buildAnswer('manual-validation'),
+    escalation: buildAnswer('escalation'),
+    'phase-queue': buildAnswer('phase-queue'),
+    filing: buildAnswer('filing'),
+    'scope-drained': buildAnswer('scope-drained'),
+};
+for (const gateType of Object.keys(VALID_ANSWER_FIXTURES)) {
+    GateAnswerSchema.parse(VALID_ANSWER_FIXTURES[gateType]);
+}
+// gate-outcome (the ACK) fixtures — one per closed outcome enum value.
+export const VALID_ACK_FIXTURES = {
+    applied: {
+        type: 'gate-outcome',
+        gateId: VALID_FIXTURES.clarification.gateId,
+        outcome: 'applied',
+        at: OUTCOME_AT,
+    },
+    superseded: {
+        type: 'gate-outcome',
+        gateId: VALID_FIXTURES['artifact-review'].gateId,
+        outcome: 'superseded',
+        detail: 'A newer answer arrived first',
+        at: OUTCOME_AT,
+    },
+    failed: {
+        type: 'gate-outcome',
+        gateId: VALID_FIXTURES.escalation.gateId,
+        outcome: 'failed',
+        detail: 'Label mutation returned 422',
+        at: OUTCOME_AT,
+    },
+};
+for (const key of Object.keys(VALID_ACK_FIXTURES)) {
+    GateOutcomeSchema.parse(VALID_ACK_FIXTURES[key]);
+}
+const BASE_RECORD_UNKNOWN = VALID_FIXTURES.clarification;
+const BASE_ANSWER_UNKNOWN = VALID_ANSWER_FIXTURES.clarification;
+function withoutKey(obj, key) {
+    const clone = { ...obj };
+    delete clone[key];
+    return clone;
+}
+export const MALFORMED_FIXTURES = {
+    // Wrong up-path discriminator (must be the 'gate-open' literal).
+    'wrong-type-literal': {
+        ...BASE_RECORD_UNKNOWN,
+        type: 'gate-ack',
+    },
+    // Option missing its required `id` (description is OPTIONAL in the frozen shape).
+    'option-missing-id': {
+        ...BASE_RECORD_UNKNOWN,
+        options: [{ label: 'Approve' }],
+    },
+    // allowFreeText is a REQUIRED boolean — a non-boolean must reject.
+    'allow-free-text-non-boolean': {
+        ...BASE_RECORD_UNKNOWN,
+        allowFreeText: 'yes',
+    },
+    // gateId is pinned to exactly 24 chars.
+    'empty-gate-id': {
+        ...BASE_RECORD_UNKNOWN,
+        gateId: '',
+    },
+    'wrong-length-gate-id': {
+        ...BASE_RECORD_UNKNOWN,
+        gateId: '0123456789abcdef0123', // 20 chars
+    },
+    'unknown-gate-type': {
+        ...BASE_RECORD_UNKNOWN,
+        gateType: 'not-a-real-gate-type',
+    },
+    'invalid-issue-url': {
+        ...BASE_RECORD_UNKNOWN,
+        issueUrl: 'not-a-url',
+    },
+    'naive-timestamp': {
+        ...BASE_RECORD_UNKNOWN,
+        askedAt: 'Tue Jul 21 2026 12:00:00 GMT+0000',
+    },
+    'record-missing-title': withoutKey(BASE_RECORD_UNKNOWN, 'title'),
+    // Down-path: actor.email must be a valid email OR null; a malformed string rejects.
+    'answer-invalid-email': {
+        ...BASE_ANSWER_UNKNOWN,
+        actor: { ...ACTOR, email: 'not-an-email' },
+    },
+    // Down-path: wrong discriminator (must be the 'gate-answer' literal).
+    'answer-wrong-type-literal': {
+        ...BASE_ANSWER_UNKNOWN,
+        type: 'gate-open',
+    },
+};
+export const CLARIFICATION_ANSWER_SET_FIXTURES = Object.freeze({
+    singleQuestion: Object.freeze({
+        questions: Object.freeze([
+            Object.freeze({ questionNumber: 1, questionText: 'Which auth method?' }),
+        ]),
+    }),
+    // Deliberately out-of-order to prove sort determinism (SC-002).
+    threeQuestions: Object.freeze({
+        questions: Object.freeze([
+            Object.freeze({ questionNumber: 3, questionText: 'Timezone?' }),
+            Object.freeze({ questionNumber: 1, questionText: 'Which auth method?' }),
+            Object.freeze({ questionNumber: 2, questionText: 'Which DB?' }),
+        ]),
+    }),
+    // Non-ASCII bytes to exercise UTF-8 canonicalization end to end.
+    unicode: Object.freeze({
+        questions: Object.freeze([
+            Object.freeze({
+                questionNumber: 1,
+                questionText: 'Préférence pour l’heure locale? 🌍',
+            }),
+            Object.freeze({
+                questionNumber: 2,
+                questionText: '中文文本 — 数据库偏好?',
+            }),
+        ]),
+    }),
+});
+//# sourceMappingURL=fixtures.js.map

package/dist/gates/fixtures.js.map

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

package/dist/gates/gate-id.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Back-compat shim. Canonical gateKey/gateId derivation now lives in
+ * `./schema.ts` — the single source. Prefer importing `deriveGateKey` /
+ * `deriveGateId` from `./schema.js` (or the package index).
+ *
+ * NOTE the signature moved: `deriveGateKey(issueRef: string, gateType, generation)`
+ * now takes the FLAT `owner/repo#N` ref string, not an object. Use
+ * `issueRefToString` (schemas.ts) to convert an object ref first.
+ */
+export { deriveGateKey, deriveGateId } from './schema.js';
+//# sourceMappingURL=gate-id.d.ts.map

package/dist/gates/gate-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-id.d.ts","sourceRoot":"","sources":["../../src/gates/gate-id.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/gates/gate-id.js

@@ -0,0 +1,11 @@
+/**
+ * Back-compat shim. Canonical gateKey/gateId derivation now lives in
+ * `./schema.ts` — the single source. Prefer importing `deriveGateKey` /
+ * `deriveGateId` from `./schema.js` (or the package index).
+ *
+ * NOTE the signature moved: `deriveGateKey(issueRef: string, gateType, generation)`
+ * now takes the FLAT `owner/repo#N` ref string, not an object. Use
+ * `issueRefToString` (schemas.ts) to convert an object ref first.
+ */
+export { deriveGateKey, deriveGateId } from './schema.js';
+//# sourceMappingURL=gate-id.js.map

package/dist/gates/gate-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-id.js","sourceRoot":"","sources":["../../src/gates/gate-id.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/gates/generation.d.ts

@@ -0,0 +1,39 @@
+import type { IssueRef } from './schemas.js';
+import type { ArtifactReviewKind } from './types.js';
+export interface ClarificationGenerationInput {
+    batchId: string;
+}
+export declare function deriveClarificationGeneration(input: ClarificationGenerationInput): string;
+export interface ArtifactReviewGenerationInput {
+    kind: ArtifactReviewKind;
+    headSha: string;
+}
+export declare function deriveArtifactReviewGeneration(input: ArtifactReviewGenerationInput): string;
+export interface ImplementationReviewGenerationInput {
+    headSha: string;
+}
+export declare function deriveImplementationReviewGeneration(input: ImplementationReviewGenerationInput): string;
+export interface ManualValidationGenerationInput {
+    phaseNumber: number;
+}
+export declare function deriveManualValidationGeneration(input: ManualValidationGenerationInput): string;
+export interface EscalationGenerationInput {
+    subtype: string;
+    labelOrState: string;
+    counter: number;
+}
+export declare function deriveEscalationGeneration(input: EscalationGenerationInput): string;
+export interface PhaseQueueGenerationInput {
+    phaseNumber: number;
+}
+export declare function derivePhaseQueueGeneration(input: PhaseQueueGenerationInput): string;
+export interface FilingGenerationInput {
+    draftHash: string;
+}
+export declare function deriveFilingGeneration(input: FilingGenerationInput): string;
+export interface ScopeDrainedGenerationInput {
+    trackingIssueRef: IssueRef;
+    counter: number;
+}
+export declare function deriveScopeDrainedGeneration(input: ScopeDrainedGenerationInput): string;
+//# sourceMappingURL=generation.d.ts.map

package/dist/gates/generation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation.d.ts","sourceRoot":"","sources":["../../src/gates/generation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIrD,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,4BAA4B,GAAG,MAAM,CAEzF;AAED,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AACD,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,6BAA6B,GAAG,MAAM,CAE3F;AAED,MAAM,WAAW,mCAAmC;IAClD,OAAO,EAAE,MAAM,CAAC;CACjB;AACD,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,mCAAmC,GACzC,MAAM,CAER;AAED,MAAM,WAAW,+BAA+B;IAC9C,WAAW,EAAE,MAAM,CAAC;CACrB;AACD,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,+BAA+B,GACrC,MAAM,CAER;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AACD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,yBAAyB,GAAG,MAAM,CAEnF;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAC;CACrB;AACD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,yBAAyB,GAAG,MAAM,CAEnF;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AACD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAE3E;AAED,MAAM,WAAW,2BAA2B;IAC1C,gBAAgB,EAAE,QAAQ,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AACD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,2BAA2B,GAAG,MAAM,CAGvF"}

package/dist/gates/generation.js

@@ -0,0 +1,31 @@
+// #1038 — the canonical `batchId` construction path is
+// `computeClarificationAnswerSetHash` in ./clarification-hash.ts. This helper's
+// signature is intentionally unchanged (additive, not breaking); consumers on
+// the sweep and live paths call the hash helper first and pass its 12-hex
+// output as `batchId` to keep sweep-derived and live-derived gateIds coalesced.
+export function deriveClarificationGeneration(input) {
+    return input.batchId;
+}
+export function deriveArtifactReviewGeneration(input) {
+    return `${input.kind}:${input.headSha}`;
+}
+export function deriveImplementationReviewGeneration(input) {
+    return input.headSha;
+}
+export function deriveManualValidationGeneration(input) {
+    return String(input.phaseNumber);
+}
+export function deriveEscalationGeneration(input) {
+    return `${input.subtype}:${input.labelOrState}:${input.counter}`;
+}
+export function derivePhaseQueueGeneration(input) {
+    return String(input.phaseNumber);
+}
+export function deriveFilingGeneration(input) {
+    return input.draftHash;
+}
+export function deriveScopeDrainedGeneration(input) {
+    const { trackingIssueRef, counter } = input;
+    return `${trackingIssueRef.owner}/${trackingIssueRef.repo}#${trackingIssueRef.number}:${counter}`;
+}
+//# sourceMappingURL=generation.js.map

package/dist/gates/generation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation.js","sourceRoot":"","sources":["../../src/gates/generation.ts"],"names":[],"mappings":"AAQA,uDAAuD;AACvD,gFAAgF;AAChF,8EAA8E;AAC9E,0EAA0E;AAC1E,gFAAgF;AAChF,MAAM,UAAU,6BAA6B,CAAC,KAAmC;IAC/E,OAAO,KAAK,CAAC,OAAO,CAAC;AACvB,CAAC;AAMD,MAAM,UAAU,8BAA8B,CAAC,KAAoC;IACjF,OAAO,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;AAC1C,CAAC;AAKD,MAAM,UAAU,oCAAoC,CAClD,KAA0C;IAE1C,OAAO,KAAK,CAAC,OAAO,CAAC;AACvB,CAAC;AAKD,MAAM,UAAU,gCAAgC,CAC9C,KAAsC;IAEtC,OAAO,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AACnC,CAAC;AAOD,MAAM,UAAU,0BAA0B,CAAC,KAAgC;IACzE,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;AACnE,CAAC;AAKD,MAAM,UAAU,0BAA0B,CAAC,KAAgC;IACzE,OAAO,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AACnC,CAAC;AAKD,MAAM,UAAU,sBAAsB,CAAC,KAA4B;IACjE,OAAO,KAAK,CAAC,SAAS,CAAC;AACzB,CAAC;AAMD,MAAM,UAAU,4BAA4B,CAAC,KAAkC;IAC7E,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IAC5C,OAAO,GAAG,gBAAgB,CAAC,KAAK,IAAI,gBAAgB,CAAC,IAAI,IAAI,gBAAgB,CAAC,MAAM,IAAI,OAAO,EAAE,CAAC;AACpG,CAAC"}

package/dist/gates/index.d.ts

@@ -0,0 +1,10 @@
+export { GateOpenSchema, GateOutcomeSchema, GateAnswerSchema, type GateOpen, type GateOutcome, type GateAnswer, GateTypeSchema, GateOptionSchema, type GateType, type GateOption, deriveGateKey, deriveGateId, } from './schema.js';
+/** The 8 gate-type values as a readonly tuple (single source: GateTypeSchema). */
+export declare const GATE_TYPES: ["clarification", "artifact-review", "implementation-review", "manual-validation", "escalation", "phase-queue", "filing", "scope-drained"];
+export { IssueRefSchema, issueRefToString, type IssueRef, } from './schemas.js';
+export { ArtifactReviewKindSchema, ARTIFACT_REVIEW_KINDS, type ArtifactReviewKind, } from './types.js';
+export { deriveClarificationGeneration, deriveArtifactReviewGeneration, deriveImplementationReviewGeneration, deriveManualValidationGeneration, deriveEscalationGeneration, derivePhaseQueueGeneration, deriveFilingGeneration, deriveScopeDrainedGeneration, type ClarificationGenerationInput, type ArtifactReviewGenerationInput, type ImplementationReviewGenerationInput, type ManualValidationGenerationInput, type EscalationGenerationInput, type PhaseQueueGenerationInput, type FilingGenerationInput, type ScopeDrainedGenerationInput, } from './generation.js';
+export { computeClarificationAnswerSetHash, type ClarificationQuestion, type ComputeClarificationAnswerSetHashInput, } from './clarification-hash.js';
+export { VALID_FIXTURES, MALFORMED_FIXTURES, VALID_ANSWER_FIXTURES, VALID_ACK_FIXTURES, CLARIFICATION_ANSWER_SET_FIXTURES, type ClarificationAnswerSetFixture, } from './fixtures.js';
+export { gateOpenFixture, gateOutcomeFixture, answerLineFixture, DEFAULT_WIRE_SCOPE, DEFAULT_WIRE_EPIC_REF, type WireScope, type GateOpenFixtureOverrides, type GateOutcomeFixtureOverrides, type AnswerLineFixtureOverrides, } from './wire-fixtures.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/gates/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/gates/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,UAAU,EAEf,cAAc,EACd,gBAAgB,EAChB,KAAK,QAAQ,EACb,KAAK,UAAU,EAEf,aAAa,EACb,YAAY,GACb,MAAM,aAAa,CAAC;AAIrB,kFAAkF;AAClF,eAAO,MAAM,UAAU,4IAAyB,CAAC;AAEjD,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,KAAK,QAAQ,GACd,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,6BAA6B,EAC7B,8BAA8B,EAC9B,oCAAoC,EACpC,gCAAgC,EAChC,0BAA0B,EAC1B,0BAA0B,EAC1B,sBAAsB,EACtB,4BAA4B,EAC5B,KAAK,4BAA4B,EACjC,KAAK,6BAA6B,EAClC,KAAK,mCAAmC,EACxC,KAAK,+BAA+B,EACpC,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,GACjC,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,iCAAiC,EACjC,KAAK,qBAAqB,EAC1B,KAAK,sCAAsC,GAC5C,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,iCAAiC,EACjC,KAAK,6BAA6B,GACnC,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,SAAS,EACd,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,GAChC,MAAM,oBAAoB,CAAC"}

package/dist/gates/index.js

@@ -0,0 +1,19 @@
+// Canonical cockpit gate wire contract — single source is ./schema.ts.
+// See tetrad-development/docs/cockpit-remote-gates-plan.md § "Wire contracts".
+export { 
+// Wire shapes (the frozen contract, Shapes 1/2/3)
+GateOpenSchema, GateOutcomeSchema, GateAnswerSchema, 
+// Enum + option
+GateTypeSchema, GateOptionSchema, 
+// gateKey/gateId derivation
+deriveGateKey, deriveGateId, } from './schema.js';
+import { GateTypeSchema } from './schema.js';
+/** The 8 gate-type values as a readonly tuple (single source: GateTypeSchema). */
+export const GATE_TYPES = GateTypeSchema.options;
+export { IssueRefSchema, issueRefToString, } from './schemas.js';
+export { ArtifactReviewKindSchema, ARTIFACT_REVIEW_KINDS, } from './types.js';
+export { deriveClarificationGeneration, deriveArtifactReviewGeneration, deriveImplementationReviewGeneration, deriveManualValidationGeneration, deriveEscalationGeneration, derivePhaseQueueGeneration, deriveFilingGeneration, deriveScopeDrainedGeneration, } from './generation.js';
+export { computeClarificationAnswerSetHash, } from './clarification-hash.js';
+export { VALID_FIXTURES, MALFORMED_FIXTURES, VALID_ANSWER_FIXTURES, VALID_ACK_FIXTURES, CLARIFICATION_ANSWER_SET_FIXTURES, } from './fixtures.js';
+export { gateOpenFixture, gateOutcomeFixture, answerLineFixture, DEFAULT_WIRE_SCOPE, DEFAULT_WIRE_EPIC_REF, } from './wire-fixtures.js';
+//# sourceMappingURL=index.js.map

package/dist/gates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/gates/index.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,+EAA+E;AAE/E,OAAO;AACL,kDAAkD;AAClD,cAAc,EACd,iBAAiB,EACjB,gBAAgB;AAIhB,gBAAgB;AAChB,cAAc,EACd,gBAAgB;AAGhB,4BAA4B;AAC5B,aAAa,EACb,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,kFAAkF;AAClF,MAAM,CAAC,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC;AAEjD,OAAO,EACL,cAAc,EACd,gBAAgB,GAEjB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,wBAAwB,EACxB,qBAAqB,GAEtB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,6BAA6B,EAC7B,8BAA8B,EAC9B,oCAAoC,EACpC,gCAAgC,EAChC,0BAA0B,EAC1B,0BAA0B,EAC1B,sBAAsB,EACtB,4BAA4B,GAS7B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,iCAAiC,GAGlC,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,iCAAiC,GAElC,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,GAKtB,MAAM,oBAAoB,CAAC"}