chore(ci): clear Boss Loops post-publish cleanup gates (LOOP-CLEANUP-01..03)

- runtime-core: fix seam-era test typings (RuntimeIdentity role/source, branded StateId fixtures)
- registry-client: vendor registry-loop v0 spec into docs/specs; fix repo-root resolution (was monorepo depth)
- runtime-db: vitest --passWithNoTests for the intentionally test-less package

Author: betterdataco

docs/specs/loop-registry-api-v0.md

@@ -0,0 +1,65 @@
+# Loop Registry API v0
+
+Base URL: `https://registry.loopengine.dev`
+
+Versioning strategy:
+
+- API path versioning (`/v0`)
+- Additive changes allowed in v0
+- Breaking changes require `/v1`
+
+Core resources:
+
+- `LoopSummary`
+- `LoopVersionSummary`
+- `LoopArtifact`
+
+Error envelope:
+
+```json
+{
+  "error": {
+    "code": "INVALID_REQUEST",
+    "message": "Human-readable message",
+    "details": {}
+  }
+}
+```
+
+Valid error codes:
+
+- `INVALID_REQUEST`
+- `LOOP_NOT_FOUND`
+- `VERSION_NOT_FOUND`
+- `VERSION_ALREADY_EXISTS`
+- `INVALID_LOOP_DEFINITION`
+- `INTEGRITY_MISMATCH`
+- `UNAUTHORIZED`
+- `FORBIDDEN`
+- `RATE_LIMITED`
+- `INTERNAL_ERROR`
+
+Endpoints:
+
+- `GET /v0/health`
+- `GET /v0/loops`
+- `GET /v0/loops/{loopId}`
+- `GET /v0/loops/{loopId}/versions`
+- `GET /v0/loops/{loopId}/versions/{version}`
+- `POST /v0/resolve`
+- `POST /v0/publisher/loops/{loopId}/versions`
+- `POST /v0/publisher/loops/{loopId}/versions/{version}/deprecate`
+- `POST /v0/publisher/loops/{loopId}/versions/{version}/withdraw`
+- `GET /v0/schemas/canonicalization`
+
+Integrity:
+
+- Canonicalize definition JSON by recursively sorting keys.
+- Serialize as compact UTF-8 JSON.
+- Compute SHA-256 over canonical JSON.
+
+Rate limits:
+
+- Public read: `100/min` per IP
+- Resolve: `60/min` per IP
+- Publisher writes: `20/min` per bearer token

packages/registry-client/src/__tests__/registry-loop-v0-contract.test.ts

@@ -9,7 +9,7 @@ import { fileURLToPath } from "node:url";
 import { describe, expect, it, vi } from "vitest";
 import { v0Registry } from "../adapters/v0";
 
-const REPO_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../../../..");
+const REPO_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../../..");
 const REGISTRY_SPEC = path.join(REPO_ROOT, "docs/specs/loop-registry-api-v0.md");
 
 describe("registry-loop v0 contract (SDK client)", () => {

packages/runtime-core/src/__tests__/loop-execution.test.ts

@@ -32,6 +32,8 @@ const identity = (tenantId = TENANT): RuntimeIdentity => ({
   tenantId,
   apiKeyId: "key-1",
   actorId: "user:demo",
+  role: "API_KEY",
+  source: "api",
 });
 
 function buildInstance(overrides: Partial<PersistedLoopInstance> = {}): PersistedLoopInstance {

packages/runtime-core/src/__tests__/oss-traced-loop-system.test.ts

@@ -2,6 +2,7 @@
 // Copyright (c) Better Data, Inc.
 
 import { describe, expect, it, vi } from "vitest";
+import { stateId } from "@loop-engine/sdk";
 import type { LoopEngine, TransitionParams, TransitionResult } from "@loop-engine/runtime";
 import type { TraceRecord, TraceStore } from "@loop-engine/observability";
 
@@ -35,8 +36,8 @@ describe("createOssTracedLoopSystem — sequence allocation", () => {
 
     const engine = makeEngine({
       status: "executed",
-      toState: "APPROVED",
-      fromState: "OPEN",
+      toState: stateId("APPROVED"),
+      fromState: stateId("OPEN"),
     });
     const traced = createOssTracedLoopSystem(engine, traceStore, {
       loopId: "loop.demo",
@@ -67,8 +68,8 @@ describe("createOssTracedLoopSystem — sequence allocation", () => {
 
     const engine = makeEngine({
       status: "executed",
-      toState: "APPROVED",
-      fromState: "OPEN",
+      toState: stateId("APPROVED"),
+      fromState: stateId("OPEN"),
     });
     const traced = createOssTracedLoopSystem(engine, traceStore, {
       loopId: "loop.demo",

packages/runtime-db/package.json

@@ -45,7 +45,7 @@
   "scripts": {
     "build": "pnpm db:generate && tsc",
     "typecheck": "pnpm db:generate && tsc --noEmit",
-    "test": "vitest run",
+    "test": "vitest run --passWithNoTests",
     "db:generate": "node ./scripts/run-prisma.mjs generate",
     "db:push": "node ./scripts/run-prisma.mjs db push",
     "db:migrate": "node ./scripts/run-prisma.mjs migrate deploy"