Consolidate heliosApp into HeliosLab with truthful gates

.airlock/workflows/main.yml

@@ -0,0 +1,45 @@
+# Airlock workflow configuration
+# Documentation: https://github.com/airlock-hq/airlock
+
+name: Main Pipeline
+
+on:
+  push:
+    branches: ['**']
+
+jobs:
+  default:
+    name: Lint, Test & Deploy
+    steps:
+      # Rebase onto upstream to handle drift
+      - name: rebase
+        uses: airlock-hq/airlock/defaults/rebase@main
+
+      # Run linters and formatters, auto-fix issues
+      - name: lint
+        uses: airlock-hq/airlock/defaults/lint@main
+
+      # Commit auto-fix patches and lock the worktree
+      - name: freeze
+        run: airlock exec freeze
+
+      # Generate PR title and description from the diff
+      - name: describe
+        uses: airlock-hq/airlock/defaults/describe@main
+
+      # Update documentation to reflect changes
+      - name: document
+        uses: airlock-hq/airlock/defaults/document@main
+
+      # Run tests
+      - name: test
+        uses: airlock-hq/airlock/defaults/test@main
+
+      # Push changes to upstream (pauses for user approval first)
+      - name: push
+        uses: airlock-hq/airlock/defaults/push@main
+        require-approval: true
+
+      # Create pull/merge request
+      - name: create-pr
+        uses: airlock-hq/airlock/defaults/create-pr@main

.archive/biome.json

@@ -0,0 +1,67 @@
+{
+	"$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
+	"files": {
+		"ignore": [
+			"node_modules/**",
+			"docs/.vitepress/dist/**",
+			"docs/.generated/**",
+			".worktrees/**",
+			"kitty-specs/**",
+			"docs/sessions/**"
+		]
+	},
+	"formatter": {
+		"enabled": true,
+		"lineWidth": 100,
+		"indentStyle": "space",
+		"indentWidth": 2
+	},
+	"linter": {
+		"enabled": true,
+		"rules": {
+			"recommended": true,
+			"correctness": {
+				"noUnusedImports": "error",
+				"useImportExtensions": "off"
+			},
+			"style": {
+				"useNamingConvention": "off",
+				"noDefaultExport": "off",
+				"useFilenamingConvention": "off",
+				"useBlockStatements": "off"
+			},
+			"suspicious": {
+				"noConsole": "off",
+				"noConsoleLog": "off"
+			}
+		}
+	},
+	"javascript": {
+		"formatter": {
+			"arrowParentheses": "asNeeded",
+			"bracketSameLine": false,
+			"bracketSpacing": true,
+			"jsxQuoteStyle": "double",
+			"quoteProperties": "asNeeded",
+			"semicolons": "always",
+			"trailingComma": "es5"
+		}
+	},
+	"overrides": [
+		{
+			"include": ["apps/desktop/src/runtime_client.ts"],
+			"linter": {
+				"rules": {
+					"style": {
+						"useNamingConvention": "off"
+					}
+				}
+			}
+		}
+	],
+	"json": {
+		"formatter": {
+			"trailingCommas": "none"
+		}
+	}
+}

.archive/kitty-specs/001-colab-agent-terminal-control-plane/contracts/orchestration-envelope.schema.json

@@ -51,6 +51,9 @@
 				"lane.create",
 				"lane.attach",
 				"lane.cleanup",
+				"boundary.local.dispatch",
+				"boundary.tool.dispatch",
+				"boundary.a2a.dispatch",
 				null
 			]
 		},
@@ -60,12 +63,18 @@
 				"workspace.opened",
 				"project.ready",
 				"session.created",
+				"session.restore.started",
+				"session.restore.completed",
 				"session.attach.started",
 				"session.attached",
 				"session.attach.failed",
 				"session.restore.started",
 				"session.restore.completed",
 				"session.terminated",
+				"lane.attach.started",
+				"lane.attach.failed",
+				"lane.cleanup.started",
+				"lane.cleanup.failed",
 				"terminal.spawn.started",
 				"terminal.spawned",
 				"terminal.spawn.failed",
@@ -88,23 +97,12 @@
 				"lane.attached",
 				"lane.cleaned",
 				"harness.status.changed",
+				"boundary.local.dispatched",
+				"boundary.tool.dispatched",
+				"boundary.a2a.delegated",
+				"boundary.dispatch.failed",
 				"audit.recorded",
 				"diagnostics.metric",
-				"orphan.detection.cycle_completed",
-				"orphan.detection.resource_found",
-				"recovery.stage.changed",
-				"recovery.crash.detected",
-				"recovery.safemode.entered",
-				"recovery.safemode.exited",
-				"recovery.orphans.cleaned",
-				"recovery.session.restored",
-				"recovery.session.failed",
-				"secrets.credential.created",
-				"secrets.credential.accessed",
-				"secrets.credential.rotated",
-				"secrets.credential.revoked",
-				"secrets.redaction.applied",
-				"secrets.protected_path.accessed",
 				null
 			]
 		},
@@ -185,6 +183,46 @@
 				"required": ["correlation_id", "workspace_id", "lane_id", "session_id"]
 			}
 		},
+		{
+			"if": {
+				"properties": {
+					"type": { "const": "event" },
+					"topic": { "const": "lane.attach.started" }
+				},
+				"required": ["type", "topic"]
+			},
+			"then": { "required": ["workspace_id", "lane_id", "correlation_id"] }
+		},
+		{
+			"if": {
+				"properties": {
+					"type": { "const": "event" },
+					"topic": { "const": "lane.attach.failed" }
+				},
+				"required": ["type", "topic"]
+			},
+			"then": { "required": ["workspace_id", "lane_id", "correlation_id"] }
+		},
+		{
+			"if": {
+				"properties": {
+					"type": { "const": "event" },
+					"topic": { "const": "lane.cleanup.started" }
+				},
+				"required": ["type", "topic"]
+			},
+			"then": { "required": ["workspace_id", "lane_id", "correlation_id"] }
+		},
+		{
+			"if": {
+				"properties": {
+					"type": { "const": "event" },
+					"topic": { "const": "lane.cleanup.failed" }
+				},
+				"required": ["type", "topic"]
+			},
+			"then": { "required": ["workspace_id", "lane_id", "correlation_id"] }
+		},
 		{
 			"if": {
 				"properties": {
@@ -251,6 +289,30 @@
 				"required": ["correlation_id", "workspace_id", "lane_id", "session_id"]
 			}
 		},
+		{
+			"if": {
+				"properties": {
+					"type": { "const": "event" },
+					"topic": { "const": "session.terminate.started" }
+				},
+				"required": ["type", "topic"]
+			},
+			"then": {
+				"required": ["workspace_id", "lane_id", "session_id", "correlation_id"]
+			}
+		},
+		{
+			"if": {
+				"properties": {
+					"type": { "const": "event" },
+					"topic": { "const": "session.terminate.failed" }
+				},
+				"required": ["type", "topic"]
+			},
+			"then": {
+				"required": ["workspace_id", "lane_id", "session_id", "correlation_id"]
+			}
+		},
 		{
 			"if": {
 				"properties": {

.archive/kitty-specs/001-colab-agent-terminal-control-plane/contracts/protocol-parity-matrix.json

@@ -522,141 +522,6 @@
 			],
 			"runtime_refs": ["apps/runtime/src/protocol/topics.ts"],
 			"task_ids": ["T026", "T045"]
-		},
-		{
-			"name": "orphan.detection.cycle_completed",
-			"status": "implemented",
-			"contract_refs": [
-				"contracts/control-plane.openapi.yaml#x-formal-event-families.orphan"
-			],
-			"runtime_refs": ["apps/runtime/src/protocol/topics.ts"],
-			"task_ids": ["T001", "T045"]
-		},
-		{
-			"name": "orphan.detection.resource_found",
-			"status": "implemented",
-			"contract_refs": [
-				"contracts/control-plane.openapi.yaml#x-formal-event-families.orphan"
-			],
-			"runtime_refs": ["apps/runtime/src/protocol/topics.ts"],
-			"task_ids": ["T001", "T045"]
-		},
-		{
-			"name": "recovery.stage.changed",
-			"status": "implemented",
-			"contract_refs": [
-				"contracts/control-plane.openapi.yaml#x-formal-event-families.recovery"
-			],
-			"runtime_refs": ["apps/runtime/src/protocol/topics.ts"],
-			"task_ids": ["T001", "T045"]
-		},
-		{
-			"name": "recovery.crash.detected",
-			"status": "implemented",
-			"contract_refs": [
-				"contracts/control-plane.openapi.yaml#x-formal-event-families.recovery"
-			],
-			"runtime_refs": ["apps/runtime/src/protocol/topics.ts"],
-			"task_ids": ["T001", "T045"]
-		},
-		{
-			"name": "recovery.safemode.entered",
-			"status": "implemented",
-			"contract_refs": [
-				"contracts/control-plane.openapi.yaml#x-formal-event-families.recovery"
-			],
-			"runtime_refs": ["apps/runtime/src/protocol/topics.ts"],
-			"task_ids": ["T001", "T045"]
-		},
-		{
-			"name": "recovery.safemode.exited",
-			"status": "implemented",
-			"contract_refs": [
-				"contracts/control-plane.openapi.yaml#x-formal-event-families.recovery"
-			],
-			"runtime_refs": ["apps/runtime/src/protocol/topics.ts"],
-			"task_ids": ["T001", "T045"]
-		},
-		{
-			"name": "recovery.orphans.cleaned",
-			"status": "implemented",
-			"contract_refs": [
-				"contracts/control-plane.openapi.yaml#x-formal-event-families.recovery"
-			],
-			"runtime_refs": ["apps/runtime/src/protocol/topics.ts"],
-			"task_ids": ["T001", "T045"]
-		},
-		{
-			"name": "recovery.session.restored",
-			"status": "implemented",
-			"contract_refs": [
-				"contracts/control-plane.openapi.yaml#x-formal-event-families.recovery"
-			],
-			"runtime_refs": ["apps/runtime/src/protocol/topics.ts"],
-			"task_ids": ["T001", "T045"]
-		},
-		{
-			"name": "recovery.session.failed",
-			"status": "implemented",
-			"contract_refs": [
-				"contracts/control-plane.openapi.yaml#x-formal-event-families.recovery"
-			],
-			"runtime_refs": ["apps/runtime/src/protocol/topics.ts"],
-			"task_ids": ["T001", "T045"]
-		},
-		{
-			"name": "secrets.credential.created",
-			"status": "implemented",
-			"contract_refs": [
-				"contracts/control-plane.openapi.yaml#x-formal-event-families.secrets"
-			],
-			"runtime_refs": ["apps/runtime/src/protocol/topics.ts"],
-			"task_ids": ["T001", "T045"]
-		},
-		{
-			"name": "secrets.credential.accessed",
-			"status": "implemented",
-			"contract_refs": [
-				"contracts/control-plane.openapi.yaml#x-formal-event-families.secrets"
-			],
-			"runtime_refs": ["apps/runtime/src/protocol/topics.ts"],
-			"task_ids": ["T001", "T045"]
-		},
-		{
-			"name": "secrets.credential.rotated",
-			"status": "implemented",
-			"contract_refs": [
-				"contracts/control-plane.openapi.yaml#x-formal-event-families.secrets"
-			],
-			"runtime_refs": ["apps/runtime/src/protocol/topics.ts"],
-			"task_ids": ["T001", "T045"]
-		},
-		{
-			"name": "secrets.credential.revoked",
-			"status": "implemented",
-			"contract_refs": [
-				"contracts/control-plane.openapi.yaml#x-formal-event-families.secrets"
-			],
-			"runtime_refs": ["apps/runtime/src/protocol/topics.ts"],
-			"task_ids": ["T001", "T045"]
-		},
-		{
-			"name": "secrets.redaction.applied",
-			"status": "implemented",
-			"contract_refs": [
-				"contracts/control-plane.openapi.yaml#x-formal-event-families.secrets"
-			],
-			"runtime_refs": ["apps/runtime/src/protocol/topics.ts"],
-			"task_ids": ["T001", "T045"]
-		},
-		{
-			"name": "secrets.protected_path.accessed",
-			"status": "implemented",
-			"contract_refs": [
-				"contracts/control-plane.openapi.yaml#x-formal-event-families.secrets"
-			],
-			"runtime_refs": ["apps/runtime/src/protocol/topics.ts"],
-			"task_ids": ["T001", "T045"]
 		}
 	]
 }