@ikenga/contract 0.11.0 → 0.13.0

package/dist/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAE5D,gFAAgF;;YA/BhF,4DAA4D;;YAE5D,0DAA0D;;;;;;;;;QA+B1D;;;;;;WAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAaH,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAIxD,eAAO,MAAM,mBAAmB;IAC9B,qBAAqB;;IAErB,qBAAqB;;IAErB;;;;;OAKG;;IAEH,4EAA4E;;IAE5E,2EAA2E;;IAE3E;;;;OAIG;;IAEH;;;;;;;OAOG;;;;;;;;;;;;;;;;;;EAEH,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,mBAAmB;;IAE9B,wDAAwD;;;QAnCxD,qBAAqB;;QAErB,qBAAqB;;QAErB;;;;;WAKG;;QAEH,4EAA4E;;QAE5E,2EAA2E;;QAE3E;;;;WAIG;;QAEH;;;;;;;WAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUH,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAIhE;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,uBAAuB,EAAG,CAAU,CAAC;AAIlD;;;;GAIG;AACH,eAAO,MAAM,YAAY;IACvB,4DAA4D;;IAE5D,0DAA0D;;;;;;;;EAE1D,CAAC;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;EAGjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,gBAAgB;IAC3B,4BAA4B;;IAE5B,iDAAiD;;IAEjD,yEAAyE;;IAEzE,2DAA2D;;IAE3D,mFAAmF;;IAEnF,4DAA4D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAE5D,gFAAgF;;QA/BhF,4DAA4D;;QAE5D,0DAA0D;;;;;;;;;IA+B1D;;;;;;OAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEH,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,eAAe;;IAE1B,4DAA4D;;IAE5D,sDAAsD;;IAEtD,mDAAmD;;QA/BnD,4BAA4B;;QAE5B,iDAAiD;;QAEjD,yEAAyE;;QAEzE,2DAA2D;;QAE3D,mFAAmF;;QAEnF,4DAA4D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAE5D,gFAAgF;;YA/BhF,4DAA4D;;YAE5D,0DAA0D;;;;;;;;;QA+B1D;;;;;;WAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAaH,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAIxD,eAAO,MAAM,mBAAmB;IAC9B,qBAAqB;;IAErB,qBAAqB;;IAErB;;;;;OAKG;;IAEH,4EAA4E;;IAE5E,2EAA2E;;IAE3E;;;;OAIG;;IAEH;;;;;;;OAOG;;;;;;;;;;;;;;;;;;EAEH,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,mBAAmB;;IAE9B,wDAAwD;;;QAnCxD,qBAAqB;;QAErB,qBAAqB;;QAErB;;;;;WAKG;;QAEH,4EAA4E;;QAE5E,2EAA2E;;QAE3E;;;;WAIG;;QAEH;;;;;;;WAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUH,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAIhE;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/window.d.ts

@@ -0,0 +1,128 @@
+import { z } from 'zod';
+/** Envelope + descriptor wire version. Bumped on non-additive change. */
+export declare const WINDOW_CONTRACT_VERSION: 1;
+/**
+ * What a window is.
+ * - `primary`        — the original "main" window (full chrome).
+ * - `single-surface` — a thin detached window hosting one surface (Flavor C).
+ * - `pane-set`       — a torn-off pane group (Flavor A, Phase 2).
+ * - `workspace`      — a second full workspace window (Flavor B, Phase 3).
+ */
+export declare const WindowKindSchema: z.ZodEnum<["primary", "single-surface", "pane-set", "workspace"]>;
+export type WindowKind = z.infer<typeof WindowKindSchema>;
+export declare const WindowDescriptorSchema: z.ZodObject<{
+    /** OS window label. "main" for the primary; "detached-<n>" otherwise. */
+    label: z.ZodString;
+    kind: z.ZodEnum<["primary", "single-surface", "pane-set", "workspace"]>;
+    /** Surface/route ids the window's FE entry mounts. */
+    surface_set: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Project this window is bound to (Flavor B); null = follows primary. */
+    project_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    /**
+     * SQLite `layout_state` partition. A KEY-STRING suffix folded into
+     * `scopedKey()` (G-03) — NOT a new column. Usually equals `label`.
+     */
+    layout_key: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    kind: "primary" | "single-surface" | "pane-set" | "workspace";
+    label: string;
+    surface_set: string[];
+    project_id: string | null;
+    layout_key: string;
+}, {
+    kind: "primary" | "single-surface" | "pane-set" | "workspace";
+    label: string;
+    layout_key: string;
+    surface_set?: string[] | undefined;
+    project_id?: string | null | undefined;
+}>;
+export type WindowDescriptor = z.infer<typeof WindowDescriptorSchema>;
+/**
+ * Where a window event goes. The DEFAULT for streaming/data channels is
+ * `broadcast` (every window filters its own subscription); only the channels
+ * that race (see WINDOW_TARGETED_CHANNELS) carry `window` targeting.
+ */
+export declare const WindowEventTargetSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+    kind: z.ZodLiteral<"broadcast">;
+}, "strict", z.ZodTypeAny, {
+    kind: "broadcast";
+}, {
+    kind: "broadcast";
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"window">;
+    label: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    kind: "window";
+    label: string;
+}, {
+    kind: "window";
+    label: string;
+}>]>;
+export type WindowEventTarget = z.infer<typeof WindowEventTargetSchema>;
+/**
+ * The base shape every cross-window event rides. `payload` is opaque at the
+ * contract layer (each topic refines it); the envelope itself is what the
+ * registry + windows agree on.
+ */
+export declare const WindowEventEnvelopeSchema: z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    /** Channel name, e.g. "window://opened". */
+    topic: z.ZodString;
+    /** Emitting window label, or "core" for the Rust core. */
+    source_label: z.ZodString;
+    target: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"broadcast">;
+    }, "strict", z.ZodTypeAny, {
+        kind: "broadcast";
+    }, {
+        kind: "broadcast";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"window">;
+        label: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "window";
+        label: string;
+    }, {
+        kind: "window";
+        label: string;
+    }>]>;
+    payload: z.ZodUnknown;
+}, "strict", z.ZodTypeAny, {
+    v: 1;
+    topic: string;
+    source_label: string;
+    target: {
+        kind: "broadcast";
+    } | {
+        kind: "window";
+        label: string;
+    };
+    payload?: unknown;
+}, {
+    v: 1;
+    topic: string;
+    source_label: string;
+    target: {
+        kind: "broadcast";
+    } | {
+        kind: "window";
+        label: string;
+    };
+    payload?: unknown;
+}>;
+export type WindowEventEnvelope = z.infer<typeof WindowEventEnvelopeSchema>;
+/** Canonical window-lifecycle channels emitted by the Rust core. */
+export declare const WINDOW_TOPICS: {
+    readonly opened: "window://opened";
+    readonly closed: "window://closed";
+    readonly focusChanged: "window://focus-changed";
+};
+export type WindowTopic = (typeof WINDOW_TOPICS)[keyof typeof WINDOW_TOPICS];
+/**
+ * Channels that MUST be window-targeted (`emit_to`) rather than broadcast,
+ * because a broadcast races across windows (first-reply-wins / wrong-window).
+ * Everything not listed here stays broadcast + per-window topic filtering.
+ * (plans/multi-window 03-research-internal: the ~25-channel routing table.)
+ */
+export declare const WINDOW_TARGETED_CHANNELS: readonly ["screenshot://request", "screenshot://shortcut", "projects:active-changed"];
+//# sourceMappingURL=window.d.ts.map

package/dist/window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"window.d.ts","sourceRoot":"","sources":["../src/window.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,yEAAyE;AACzE,eAAO,MAAM,uBAAuB,EAAG,CAAU,CAAC;AAIlD;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,mEAK3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,sBAAsB;IAEjC,yEAAyE;;;IAGzE,sDAAsD;;IAEtD,0EAA0E;;IAE1E;;;OAGG;;;;;;;;;;;;;;EAGK,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAItE;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;IAGlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;GAIG;AACH,eAAO,MAAM,yBAAyB;;IAGpC,4CAA4C;;IAE5C,0DAA0D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKlD,CAAC;AACX,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,oEAAoE;AACpE,eAAO,MAAM,aAAa;;;;CAIhB,CAAC;AACX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE7E;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,uFAI3B,CAAC"}

package/dist/window.js

@@ -0,0 +1,86 @@
+// Multi-window contract — mirrors the Rust source-of-truth in
+// `royalti-io/ikenga` at `src-tauri/src/window/{descriptor,events}.rs`.
+//
+// This is the `G-WINDOW-MODEL` freeze-gate output (plans/multi-window WP-02).
+// It has TWO co-equal halves: the `WindowDescriptor` (what a window IS) and the
+// cross-window event envelope (how windows talk over the shared Rust core).
+// Both are imported by every downstream consumer (the window registry, the thin
+// detached FE entry, Flavor C). Field changes MUST be made in lockstep with the
+// Rust structs; bump WINDOW_CONTRACT_VERSION on any non-additive change.
+import { z } from 'zod';
+/** Envelope + descriptor wire version. Bumped on non-additive change. */
+export const WINDOW_CONTRACT_VERSION = 1;
+// ---------- WindowDescriptor ----------
+/**
+ * What a window is.
+ * - `primary`        — the original "main" window (full chrome).
+ * - `single-surface` — a thin detached window hosting one surface (Flavor C).
+ * - `pane-set`       — a torn-off pane group (Flavor A, Phase 2).
+ * - `workspace`      — a second full workspace window (Flavor B, Phase 3).
+ */
+export const WindowKindSchema = z.enum([
+    'primary',
+    'single-surface',
+    'pane-set',
+    'workspace',
+]);
+export const WindowDescriptorSchema = z
+    .object({
+    /** OS window label. "main" for the primary; "detached-<n>" otherwise. */
+    label: z.string().min(1),
+    kind: WindowKindSchema,
+    /** Surface/route ids the window's FE entry mounts. */
+    surface_set: z.array(z.string()).default([]),
+    /** Project this window is bound to (Flavor B); null = follows primary. */
+    project_id: z.string().nullable().default(null),
+    /**
+     * SQLite `layout_state` partition. A KEY-STRING suffix folded into
+     * `scopedKey()` (G-03) — NOT a new column. Usually equals `label`.
+     */
+    layout_key: z.string().min(1),
+})
+    .strict();
+// ---------- Cross-window event envelope ----------
+/**
+ * Where a window event goes. The DEFAULT for streaming/data channels is
+ * `broadcast` (every window filters its own subscription); only the channels
+ * that race (see WINDOW_TARGETED_CHANNELS) carry `window` targeting.
+ */
+export const WindowEventTargetSchema = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('broadcast') }).strict(),
+    z.object({ kind: z.literal('window'), label: z.string().min(1) }).strict(),
+]);
+/**
+ * The base shape every cross-window event rides. `payload` is opaque at the
+ * contract layer (each topic refines it); the envelope itself is what the
+ * registry + windows agree on.
+ */
+export const WindowEventEnvelopeSchema = z
+    .object({
+    v: z.literal(WINDOW_CONTRACT_VERSION),
+    /** Channel name, e.g. "window://opened". */
+    topic: z.string().min(1),
+    /** Emitting window label, or "core" for the Rust core. */
+    source_label: z.string().min(1),
+    target: WindowEventTargetSchema,
+    payload: z.unknown(),
+})
+    .strict();
+/** Canonical window-lifecycle channels emitted by the Rust core. */
+export const WINDOW_TOPICS = {
+    opened: 'window://opened',
+    closed: 'window://closed',
+    focusChanged: 'window://focus-changed',
+};
+/**
+ * Channels that MUST be window-targeted (`emit_to`) rather than broadcast,
+ * because a broadcast races across windows (first-reply-wins / wrong-window).
+ * Everything not listed here stays broadcast + per-window topic filtering.
+ * (plans/multi-window 03-research-internal: the ~25-channel routing table.)
+ */
+export const WINDOW_TARGETED_CHANNELS = [
+    'screenshot://request',
+    'screenshot://shortcut',
+    'projects:active-changed',
+];
+//# sourceMappingURL=window.js.map

package/dist/window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"window.js","sourceRoot":"","sources":["../src/window.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,wEAAwE;AACxE,EAAE;AACF,8EAA8E;AAC9E,gFAAgF;AAChF,4EAA4E;AAC5E,gFAAgF;AAChF,gFAAgF;AAChF,yEAAyE;AAEzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,yEAAyE;AACzE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAU,CAAC;AAElD,yCAAyC;AAEzC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC;IACtC,SAAS;IACT,gBAAgB;IAChB,UAAU;IACV,WAAW;CACX,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC;KACrC,MAAM,CAAC;IACP,yEAAyE;IACzE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,IAAI,EAAE,gBAAgB;IACtB,sDAAsD;IACtD,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC5C,0EAA0E;IAC1E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAC/C;;;OAGG;IACH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC7B,CAAC;KACD,MAAM,EAAE,CAAC;AAGX,oDAAoD;AAEpD;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACnE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;IACnD,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;CAC1E,CAAC,CAAC;AAGH;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC;KACxC,MAAM,CAAC;IACP,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC;IACrC,4CAA4C;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,0DAA0D;IAC1D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,MAAM,EAAE,uBAAuB;IAC/B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;CACpB,CAAC;KACD,MAAM,EAAE,CAAC;AAGX,oEAAoE;AACpE,MAAM,CAAC,MAAM,aAAa,GAAG;IAC5B,MAAM,EAAE,iBAAiB;IACzB,MAAM,EAAE,iBAAiB;IACzB,YAAY,EAAE,wBAAwB;CAC7B,CAAC;AAGX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACvC,sBAAsB;IACtB,uBAAuB;IACvB,yBAAyB;CAChB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ikenga/contract",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "description": "Shared contract for the Ikenga pkg system: manifest schema, RPC types, Engine interface, capability scopes.",
   "license": "Apache-2.0",
   "repository": {
@@ -55,6 +55,14 @@
     "./pa-actions": {
       "types": "./dist/pa-actions.d.ts",
       "import": "./dist/pa-actions.js"
+    },
+    "./window": {
+      "types": "./dist/window.d.ts",
+      "import": "./dist/window.js"
+    },
+    "./action-frontmatter": {
+      "types": "./dist/action-frontmatter.d.ts",
+      "import": "./dist/action-frontmatter.js"
     }
   },
   "files": [
@@ -86,7 +94,8 @@
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "tsx": "^4.21.0",
-    "typescript": "^5.4.0"
+    "typescript": "^5.4.0",
+    "yaml": "^1.10.3"
   },
   "publishConfig": {
     "access": "public"

package/src/action-frontmatter.test.ts

@@ -0,0 +1,219 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { readFileSync, readdirSync, existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+
+import YAML from 'yaml';
+
+import {
+  ActionFrontmatter,
+  CapabilityEnum,
+  DomainEnum,
+  RunBinding,
+  SetupSpec,
+  Trigger,
+  UxModeEnum,
+} from './action-frontmatter.js';
+
+// ─── unit: sub-schemas ──────────────────────────────────────────────────────
+
+test('DomainEnum: the eight domains + skill-core', () => {
+  for (const d of [
+    'tasks',
+    'mail',
+    'outbound',
+    'sales',
+    'finance',
+    'content',
+    'research',
+    'strategy',
+    'skill-core',
+  ]) {
+    assert.equal(DomainEnum.parse(d), d);
+  }
+  assert.throws(() => DomainEnum.parse('marketing'));
+});
+
+test('UxModeEnum: exactly the five modes', () => {
+  for (const m of ['confirm', 'silent', 'form', 'streaming', 'approve']) {
+    assert.equal(UxModeEnum.parse(m), m);
+  }
+  assert.throws(() => UxModeEnum.parse('modal'));
+});
+
+test('RunBinding: chat_prompt requires a non-empty prompt', () => {
+  const r = RunBinding.parse({ kind: 'chat_prompt', prompt: '# do the thing' });
+  assert.equal(r.kind, 'chat_prompt');
+  assert.throws(() => RunBinding.parse({ kind: 'chat_prompt', prompt: '' }));
+});
+
+test('RunBinding: sidecar defaults args to []', () => {
+  const r = RunBinding.parse({ kind: 'sidecar', sidecar_id: 'pa-x' });
+  assert.deepEqual(r.kind === 'sidecar' ? r.args : null, []);
+});
+
+test('Trigger: schedule needs a cron; unknown kind rejected', () => {
+  const t = Trigger.parse({ kind: 'schedule', cron: '30 */4 * * *', label: 'x' });
+  assert.equal(t.kind, 'schedule');
+  assert.throws(() => Trigger.parse({ kind: 'timer', every: '5m' }));
+});
+
+test('CapabilityEnum: closed set', () => {
+  for (const c of ['sqlite', 'mcp', 'sidecar', 'network', 'fs', 'secrets', 'chat']) {
+    assert.equal(CapabilityEnum.parse(c), c);
+  }
+  assert.throws(() => CapabilityEnum.parse('gpu'));
+});
+
+test('SetupSpec: template_version must be a positive int', () => {
+  const s = SetupSpec.parse({ mode: 'interview', template_version: 1 });
+  assert.equal(s.template_version, 1);
+  assert.throws(() => SetupSpec.parse({ mode: 'interview', template_version: 0 }));
+});
+
+// ─── unit: ActionFrontmatter refinements ────────────────────────────────────
+
+test('ActionFrontmatter: name must be kebab-case', () => {
+  const base = {
+    name: 'draft-reply',
+    description: 'x',
+    domain: 'mail',
+    ux_mode: 'approve',
+    run: { kind: 'chat_prompt', prompt: 'x' },
+  };
+  assert.equal(ActionFrontmatter.parse(base).name, 'draft-reply');
+  assert.throws(() => ActionFrontmatter.parse({ ...base, name: 'DraftReply' }));
+});
+
+test('ActionFrontmatter: .strict rejects unknown top-level keys', () => {
+  assert.throws(() =>
+    ActionFrontmatter.parse({
+      name: 'x',
+      description: 'x',
+      domain: 'mail',
+      ux_mode: 'approve',
+      run: { kind: 'chat_prompt', prompt: 'x' },
+      bogus: true,
+    }),
+  );
+});
+
+test('ActionFrontmatter: setup block only valid on the setup action', () => {
+  // Non-setup action carrying a setup block → rejected.
+  assert.throws(() =>
+    ActionFrontmatter.parse({
+      name: 'sweep',
+      description: 'x',
+      domain: 'tasks',
+      ux_mode: 'approve',
+      run: { kind: 'chat_prompt', prompt: 'x' },
+      setup: { mode: 'interview', template_version: 1 },
+    }),
+  );
+  // setup action missing its setup block → rejected.
+  assert.throws(() =>
+    ActionFrontmatter.parse({
+      name: 'setup',
+      description: 'x',
+      domain: 'skill-core',
+      ux_mode: 'streaming',
+      run: { kind: 'chat_prompt', prompt: 'x' },
+    }),
+  );
+  // setup action with its setup block → ok.
+  const ok = ActionFrontmatter.parse({
+    name: 'setup',
+    description: 'x',
+    domain: 'skill-core',
+    ux_mode: 'streaming',
+    run: { kind: 'chat_prompt', prompt: 'x' },
+    setup: { mode: 'ai_infer', template_version: 1, infer_sources: ['README.md'] },
+  });
+  assert.equal(ok.setup?.mode, 'ai_infer');
+});
+
+test('ActionFrontmatter: depends_on refuses non-skill-core targets', () => {
+  assert.throws(() =>
+    ActionFrontmatter.parse({
+      name: 'x',
+      description: 'x',
+      domain: 'mail',
+      ux_mode: 'approve',
+      run: { kind: 'chat_prompt', prompt: 'x' },
+      depends_on: ['mail'],
+    }),
+  );
+});
+
+// ─── conformance: parse every real installed action file ────────────────────
+
+/** Extract the YAML frontmatter block between the leading `---` fences.
+ *  Mirrors the Rust `extract_frontmatter` in skill_actions.rs. Returns null
+ *  when the file does not open with a `---` fence (prose-only skill docs). */
+function extractFrontmatter(body: string): string | null {
+  const src = body.replace(/^/, '');
+  const lines = src.split('\n');
+  if (lines[0]?.trim() !== '---') return null;
+  const close = lines.slice(1).findIndex((l) => l.replace(/\r$/, '').trim() === '---');
+  if (close === -1) return null;
+  return lines.slice(1, 1 + close).join('\n');
+}
+
+function collectActionFiles(): string[] {
+  const here = dirname(fileURLToPath(import.meta.url));
+  // contract/src → ikenga-pkgs/packages/skills (sibling repos under the workspace).
+  const skillsRoot = join(here, '..', '..', 'ikenga-pkgs', 'packages', 'skills');
+  if (!existsSync(skillsRoot)) return [];
+  const out: string[] = [];
+  for (const domain of readdirSync(skillsRoot, { withFileTypes: true })) {
+    if (!domain.isDirectory()) continue;
+    const skillsDir = join(skillsRoot, domain.name, 'skills');
+    if (!existsSync(skillsDir)) continue;
+    for (const skill of readdirSync(skillsDir, { withFileTypes: true })) {
+      if (!skill.isDirectory()) continue;
+      const actionsDir = join(skillsDir, skill.name, 'actions');
+      if (!existsSync(actionsDir)) continue;
+      for (const f of readdirSync(actionsDir)) {
+        if (f.endsWith('.md') && f.toLowerCase() !== 'readme.md') {
+          out.push(join(actionsDir, f));
+        }
+      }
+    }
+  }
+  return out.sort();
+}
+
+test('conformance: every real action file with frontmatter parses against ActionFrontmatter', () => {
+  const files = collectActionFiles();
+  // The real action files live in the SIBLING ikenga-pkgs repo, present when the
+  // workspace is checked out whole (local dev) but absent in this repo's isolated
+  // CI checkout. Skip cleanly there — the schema unit tests above already cover
+  // the contract; this is the cross-repo integration layer, best-effort.
+  if (files.length === 0) {
+    console.error('# skip: ikenga-pkgs sibling repo not present (isolated CI checkout)');
+    return;
+  }
+
+  let parsed = 0;
+  const failures: string[] = [];
+  for (const file of files) {
+    const fm = extractFrontmatter(readFileSync(file, 'utf8'));
+    if (fm === null) continue; // prose-only skill doc (groundwork/contribute) — not a structured action
+    const doc = YAML.parse(fm);
+    const res = ActionFrontmatter.safeParse(doc);
+    if (!res.success) {
+      failures.push(`${file}\n  ${JSON.stringify(res.error.issues, null, 2)}`);
+    } else {
+      parsed += 1;
+    }
+  }
+
+  assert.equal(
+    failures.length,
+    0,
+    `real action files failed the schema:\n${failures.join('\n')}`,
+  );
+  // Well above the "at least 3" bar — the full Atelier surface is ~32 structured actions.
+  assert.ok(parsed >= 3, `expected >= 3 structured action files, parsed ${parsed}`);
+});