@oscharko-dev/keiko-contracts 0.2.0

package/dist/workspace-ui.d.ts

@@ -0,0 +1,119 @@
+export interface WorkspaceUiRect {
+    readonly x: number;
+    readonly y: number;
+    readonly w: number;
+    readonly h: number;
+}
+export interface WorkspaceUiView {
+    readonly zoom: number;
+    readonly x: number;
+    readonly y: number;
+}
+export interface WorkspaceUiSelectionState {
+    readonly focusedWindowId: string | null;
+    readonly selectedWindowIds: readonly string[];
+}
+export type WorkspaceCommandAuthority = "user" | "user-confirm" | "agent-proposal" | "tool" | "model";
+export type WorkspaceCommandCategory = "workspace" | "window" | "selection" | "navigation" | "review" | "verification" | "evidence" | "model";
+export type WorkspaceKeyChordModifier = "cmd" | "ctrl" | "alt" | "shift";
+export interface WorkspaceKeyChord {
+    readonly key: string;
+    readonly mod: readonly WorkspaceKeyChordModifier[];
+}
+export interface WorkspaceCommandContext {
+    readonly userConfirmed: boolean;
+    readonly sourceObjectId?: string;
+}
+export interface WorkspaceCommand {
+    readonly id: string;
+    readonly label: string;
+    readonly category: WorkspaceCommandCategory;
+    readonly authority: WorkspaceCommandAuthority;
+    readonly shortcut?: WorkspaceKeyChord;
+    readonly disabled?: () => string | null;
+    readonly run: (ctx: WorkspaceCommandContext) => Promise<void> | void;
+}
+export interface WorkspaceUiWindowSnapshot {
+    readonly id: string;
+    readonly type: string;
+    readonly rect: WorkspaceUiRect;
+    readonly z: number;
+}
+export type WorkspaceUiAction = {
+    readonly kind: "ui.window.move";
+    readonly windowId: string;
+    readonly before: WorkspaceUiRect;
+    readonly after: WorkspaceUiRect;
+} | {
+    readonly kind: "ui.window.resize";
+    readonly windowId: string;
+    readonly before: WorkspaceUiRect;
+    readonly after: WorkspaceUiRect;
+} | {
+    readonly kind: "ui.window.zorder";
+    readonly windowId: string;
+    readonly before: number;
+    readonly after: number;
+} | {
+    readonly kind: "ui.window.close";
+    readonly windowId: string;
+    readonly windowSnapshot: WorkspaceUiWindowSnapshot;
+} | {
+    readonly kind: "ui.window.open";
+    readonly windowId: string;
+    readonly windowSnapshot: WorkspaceUiWindowSnapshot;
+} | {
+    readonly kind: "ui.workspace.pan";
+    readonly before: WorkspaceUiView;
+    readonly after: WorkspaceUiView;
+} | {
+    readonly kind: "ui.workspace.zoom";
+    readonly before: WorkspaceUiView;
+    readonly after: WorkspaceUiView;
+} | {
+    readonly kind: "ui.workspace.fit";
+    readonly before: WorkspaceUiView;
+    readonly after: WorkspaceUiView;
+} | {
+    readonly kind: "ui.panel.toggle";
+    readonly panel: string;
+    readonly before: boolean;
+    readonly after: boolean;
+} | {
+    readonly kind: "ui.selection.change";
+    readonly before: WorkspaceUiSelectionState;
+    readonly after: WorkspaceUiSelectionState;
+} | {
+    readonly kind: "ui.tab.switch";
+    readonly before: string;
+    readonly after: string;
+};
+export type WorkspaceUiActionKind = WorkspaceUiAction["kind"];
+type AssertUiPrefixed<K extends `ui.${string}`> = K;
+export type WorkspaceUiActionKindChecked = AssertUiPrefixed<WorkspaceUiActionKind>;
+export interface WorkspaceUndoStackApi {
+    readonly canUndo: boolean;
+    readonly canRedo: boolean;
+    readonly undoLabel: string | null;
+    readonly redoLabel: string | null;
+    push(action: WorkspaceUiAction): void;
+    undo(): void;
+    redo(): void;
+    clear(): void;
+}
+export interface WorkspaceKeyboardShortcutBinding {
+    readonly commandId: string;
+    readonly chord: WorkspaceKeyChord;
+}
+export interface WorkspaceKeyboardShortcutConflict {
+    readonly chord: WorkspaceKeyChord;
+    readonly commandIds: readonly string[];
+}
+export declare const WORKSPACE_RESERVED_CHORDS: readonly WorkspaceKeyChord[];
+export declare function workspaceActionLabel(action: WorkspaceUiAction): string;
+export declare function workspaceChordKey(chord: WorkspaceKeyChord): string;
+export declare function workspaceChordsEqual(a: WorkspaceKeyChord, b: WorkspaceKeyChord): boolean;
+export declare function isWorkspaceReservedChord(chord: WorkspaceKeyChord): boolean;
+export declare function workspaceInverseAction(action: WorkspaceUiAction): WorkspaceUiAction;
+export {};
+//# sourceMappingURL=workspace-ui.d.ts.map

package/dist/workspace-ui.d.ts.map

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

package/dist/workspace-ui.js

@@ -0,0 +1,105 @@
+// Epic #518 / Issue #527 — Workspace UI interaction substrate contracts.
+//
+// These types are consumed by the workspace UI (`@oscharko-dev/keiko-ui`)
+// and by the registration-time descriptor validator that #528 lands. They
+// have no runtime cost; they are the typed contract that makes the
+// workspace's command + undo + keyboard substrate reviewable.
+//
+// The Action union is the load-bearing guarantee for ADR-0028. It declares
+// constructors only for UI-state mutations. There is no Action variant for
+// evidence creation, applied patches, verification records, model calls,
+// tool execution, memory writes, workspace FS writes, or durable config
+// writes — so the undo stack cannot record or reverse those classes. The
+// refusal is compile-time, not runtime.
+//
+// File name `workspace-ui.ts` avoids a collision with the existing
+// `workspace.ts` that owns the `@oscharko-dev/keiko-workspace` package
+// types.
+export const WORKSPACE_RESERVED_CHORDS = [
+    { key: "t", mod: ["cmd"] },
+    { key: "t", mod: ["ctrl"] },
+    { key: "r", mod: ["cmd"] },
+    { key: "r", mod: ["ctrl"] },
+    { key: "n", mod: ["cmd", "shift"] },
+    { key: "n", mod: ["ctrl", "shift"] },
+    { key: "w", mod: ["cmd"] },
+    { key: "w", mod: ["ctrl"] },
+];
+// ─── Pure helpers ─────────────────────────────────────────────────────────
+// Exhaustive discriminated-union dispatch; one branch per WorkspaceUiAction kind
+// is the pattern the type system requires.
+// eslint-disable-next-line complexity
+export function workspaceActionLabel(action) {
+    switch (action.kind) {
+        case "ui.window.move":
+            return "Move window";
+        case "ui.window.resize":
+            return "Resize window";
+        case "ui.window.zorder":
+            return "Reorder window";
+        case "ui.window.close":
+            return "Close window";
+        case "ui.window.open":
+            return "Open window";
+        case "ui.workspace.pan":
+            return "Pan workspace";
+        case "ui.workspace.zoom":
+            return "Zoom workspace";
+        case "ui.workspace.fit":
+            return "Fit workspace to view";
+        case "ui.panel.toggle":
+            return `Toggle ${action.panel} panel`;
+        case "ui.selection.change":
+            return "Change selection";
+        case "ui.tab.switch":
+            return "Switch tab";
+    }
+}
+export function workspaceChordKey(chord) {
+    const sorted = [...chord.mod].sort();
+    return `${sorted.join("+")}|${chord.key.toLowerCase()}`;
+}
+export function workspaceChordsEqual(a, b) {
+    return workspaceChordKey(a) === workspaceChordKey(b);
+}
+export function isWorkspaceReservedChord(chord) {
+    for (const reserved of WORKSPACE_RESERVED_CHORDS) {
+        if (workspaceChordsEqual(chord, reserved))
+            return true;
+    }
+    return false;
+}
+// ─── Inverse-action helper for the undo stack ─────────────────────────────
+//
+// Pure function that computes the inverse of any ui.* action by swapping
+// before/after. Lives next to the contracts so consumers and tests share
+// the canonical inverse implementation.
+// Exhaustive discriminated-union dispatch; one branch per WorkspaceUiAction kind
+// is the pattern the type system requires.
+// eslint-disable-next-line complexity
+export function workspaceInverseAction(action) {
+    switch (action.kind) {
+        case "ui.window.move":
+            return { ...action, before: action.after, after: action.before };
+        case "ui.window.resize":
+            return { ...action, before: action.after, after: action.before };
+        case "ui.window.zorder":
+            return { ...action, before: action.after, after: action.before };
+        case "ui.window.close":
+            return { ...action, kind: "ui.window.open" };
+        case "ui.window.open":
+            return { ...action, kind: "ui.window.close" };
+        case "ui.workspace.pan":
+            return { ...action, before: action.after, after: action.before };
+        case "ui.workspace.zoom":
+            return { ...action, before: action.after, after: action.before };
+        case "ui.workspace.fit":
+            return { ...action, before: action.after, after: action.before };
+        case "ui.panel.toggle":
+            return { ...action, before: action.after, after: action.before };
+        case "ui.selection.change":
+            return { ...action, before: action.after, after: action.before };
+        case "ui.tab.switch":
+            return { ...action, before: action.after, after: action.before };
+    }
+}

package/dist/workspace.d.ts

@@ -0,0 +1,104 @@
+export type WorkspaceLanguage = "typescript" | "javascript";
+export type TestFramework = "vitest" | "jest" | "mocha" | "unknown";
+export interface WorkspaceInfo {
+    readonly root: string;
+    readonly name: string | undefined;
+    readonly version: string | undefined;
+    readonly testFramework: TestFramework;
+    readonly sourceDirs: readonly string[];
+    readonly testDirs: readonly string[];
+    readonly languages: readonly WorkspaceLanguage[];
+    readonly ignoreLines: readonly string[];
+}
+export interface DiscoveredFile {
+    readonly relativePath: string;
+    readonly sizeBytes: number;
+}
+export interface DiscoveryOptions {
+    readonly maxDepth: number;
+    readonly maxFiles: number;
+    readonly applyGitignore: boolean;
+}
+export declare const DEFAULT_DISCOVERY_OPTIONS: DiscoveryOptions;
+export interface DiscoveryStats {
+    readonly discovered: number;
+    readonly denied: number;
+    readonly ignored: number;
+}
+export interface ReadOptions {
+    readonly maxBytes: number;
+}
+export declare const DEFAULT_READ_OPTIONS: ReadOptions;
+export interface FileContent {
+    readonly relativePath: string;
+    readonly sizeBytes: number;
+    readonly text: string;
+    readonly truncated: boolean;
+}
+export type SelectionReason = "entrypoint" | "manifest" | "documentation" | "config" | "source" | "test";
+export declare const SELECTION_REASON_PRIORITY: readonly SelectionReason[];
+export interface ContextRequest {
+    readonly task: string | undefined;
+    readonly budgetBytes: number;
+    readonly maxBytesPerFile: number;
+    readonly discovery: DiscoveryOptions;
+}
+export declare const DEFAULT_CONTEXT_REQUEST: ContextRequest;
+export interface ContextEntry {
+    readonly path: string;
+    readonly sizeBytes: number;
+    readonly excerptBytes: number;
+    readonly selectionReason: SelectionReason;
+    readonly truncated: boolean;
+    readonly excerpt: string;
+}
+export interface ContextPack {
+    readonly workspaceRoot: string;
+    readonly totalCandidates: number;
+    readonly selected: readonly ContextEntry[];
+    readonly usedBytes: number;
+    readonly budgetBytes: number;
+    readonly droppedForBudget: number;
+}
+export interface ContextEntrySummary {
+    readonly path: string;
+    readonly sizeBytes: number;
+    readonly excerptBytes: number;
+    readonly selectionReason: SelectionReason;
+    readonly truncated: boolean;
+    readonly excerpt: string;
+}
+export interface ContextPackSummary {
+    readonly totalCandidates: number;
+    readonly usedBytes: number;
+    readonly budgetBytes: number;
+    readonly droppedForBudget: number;
+    readonly entries: readonly ContextEntrySummary[];
+}
+export interface WorkspaceSummary {
+    readonly root: string;
+    readonly name: string | undefined;
+    readonly version: string | undefined;
+    readonly testFramework: TestFramework;
+    readonly sourceDirs: readonly string[];
+    readonly testDirs: readonly string[];
+    readonly languages: readonly WorkspaceLanguage[];
+    readonly counts: DiscoveryStats;
+    readonly context: ContextPackSummary | undefined;
+}
+export interface AuditEntry {
+    readonly path: string;
+    readonly sizeBytes: number;
+    readonly excerptBytes: number;
+    readonly selectionReason: SelectionReason;
+    readonly truncated: boolean;
+}
+export interface AuditSummary {
+    readonly workspaceRoot: string;
+    readonly totalCandidates: number;
+    readonly usedBytes: number;
+    readonly budgetBytes: number;
+    readonly droppedForBudget: number;
+    readonly entries: readonly AuditEntry[];
+}
+//# sourceMappingURL=workspace.d.ts.map

package/dist/workspace.d.ts.map

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

package/dist/workspace.js

@@ -0,0 +1,27 @@
+// All workspace-layer interfaces and the frozen default tables. No runtime logic lives
+// here beyond the frozen constant tables the type layer must expose as values, mirroring
+// the ADR-0003/ADR-0004 `types.ts` precedent. `readonly` everywhere; optional props are
+// `| undefined` because exactOptionalPropertyTypes is on.
+export const DEFAULT_DISCOVERY_OPTIONS = {
+    maxDepth: 12,
+    maxFiles: 5_000,
+    applyGitignore: true,
+};
+export const DEFAULT_READ_OPTIONS = {
+    maxBytes: 262_144,
+};
+// Priority order used to rank candidates: lower index wins. Ties break on lexical path.
+export const SELECTION_REASON_PRIORITY = [
+    "entrypoint",
+    "manifest",
+    "documentation",
+    "config",
+    "source",
+    "test",
+];
+export const DEFAULT_CONTEXT_REQUEST = {
+    task: undefined,
+    budgetBytes: 65_536,
+    maxBytesPerFile: 8_192,
+    discovery: DEFAULT_DISCOVERY_OPTIONS,
+};

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@oscharko-dev/keiko-contracts",
+  "version": "0.2.0",
+  "type": "module",
+  "license": "Apache-2.0",
+  "description": "Internal workspace package: shared Keiko contracts. Not published independently.",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./unit-test-events": {
+      "types": "./dist/unit-test-events.d.ts",
+      "import": "./dist/unit-test-events.js"
+    },
+    "./bug-investigation-events": {
+      "types": "./dist/bug-investigation-events.d.ts",
+      "import": "./dist/bug-investigation-events.js"
+    },
+    "./connected-context": {
+      "types": "./dist/connected-context.d.ts",
+      "import": "./dist/connected-context.js"
+    },
+    "./text-safety": {
+      "types": "./dist/text-safety.d.ts",
+      "import": "./dist/text-safety.js"
+    },
+    "./verification-summary": {
+      "types": "./dist/verification-summary.d.ts",
+      "import": "./dist/verification-summary.js"
+    },
+    "./workflow-handoff": {
+      "types": "./dist/workflow-handoff.d.ts",
+      "import": "./dist/workflow-handoff.js"
+    },
+    "./evidence": {
+      "types": "./dist/evidence.d.ts",
+      "import": "./dist/evidence.js"
+    },
+    "./bff-wire": {
+      "types": "./dist/bff-wire.d.ts",
+      "import": "./dist/bff-wire.js"
+    },
+    "./memory": {
+      "types": "./dist/memory-barrel.d.ts",
+      "import": "./dist/memory-barrel.js"
+    },
+    "./memory-workflow-port": {
+      "types": "./dist/memory-workflow-port.d.ts",
+      "import": "./dist/memory-workflow-port.js"
+    },
+    "./memory-audit-events": {
+      "types": "./dist/memory-audit-events.d.ts",
+      "import": "./dist/memory-audit-events.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -b tsconfig.json",
+    "typecheck": "tsc -b tsconfig.json",
+    "test": "vitest run"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  }
+}