feat: 1.0.0-rc.0 surface reconciliation (Branch A)

.changeset/config.json

@@ -6,5 +6,5 @@
   "access": "public",
   "baseBranch": "main",
   "updateInternalDependencies": "patch",
-  "ignore": ["@loop-engine/inspector", "@loop-engine/playground", "@loop-engine/dsl"]
+  "ignore": ["@loop-engine/adapter-postgres", "@loop-engine/adapter-kafka"]
 }

.changeset/pre.json

@@ -0,0 +1,54 @@
+{
+  "mode": "pre",
+  "tag": "rc",
+  "initialVersions": {
+    "@loop-engine/inspector": "0.1.0",
+    "@loop-engine/playground": "0.1.0",
+    "@loop-engine/actors": "0.1.5",
+    "@loop-engine/adapter-anthropic": "0.1.6",
+    "@loop-engine/adapter-commerce-gateway": "0.1.6",
+    "@loop-engine/adapter-gemini": "0.1.7",
+    "@loop-engine/adapter-grok": "0.1.8",
+    "@loop-engine/adapter-memory": "0.1.6",
+    "@loop-engine/adapter-openai": "0.1.6",
+    "@loop-engine/adapter-openclaw": "0.1.8",
+    "@loop-engine/adapter-pagerduty": "0.1.5",
+    "@loop-engine/adapter-perplexity": "0.1.0",
+    "@loop-engine/adapter-vercel-ai": "0.1.6",
+    "@loop-engine/adapter-http": "0.1.6",
+    "@loop-engine/adapter-kafka": "0.1.7",
+    "@loop-engine/adapter-postgres": "0.2.0",
+    "@loop-engine/core": "0.1.5",
+    "@loop-engine/events": "0.1.5",
+    "@loop-engine/guards": "0.1.5",
+    "@loop-engine/loop-definition": "0.1.0",
+    "@loop-engine/observability": "0.1.6",
+    "@loop-engine/registry-client": "0.1.8",
+    "@loop-engine/runtime": "0.1.5",
+    "@loop-engine/sdk": "0.2.0",
+    "@loop-engine/signals": "0.1.5",
+    "@loop-engine/ui-devtools": "0.1.6"
+  },
+  "changesets": [
+    "sr-001-engine-naming",
+    "sr-002-loopstore-collapse",
+    "sr-003-tooladapter-rename",
+    "sr-004-drop-runtime-prefix",
+    "sr-005-list-cancel-fail-open-loops",
+    "sr-006-actor-adapter-archetype",
+    "sr-007-can-actor-execute-transition",
+    "sr-008-system-actor-type",
+    "sr-009-outcome-correlation-id-schemas",
+    "sr-010-loop-definition-schema-rewrite",
+    "sr-011-loopbuilder-aliasing-collapse",
+    "sr-012-id-factory-functions",
+    "sr-013a-redact-pii-evidence-rename",
+    "sr-013b-ai-adapters-onto-actor-adapter",
+    "sr-014-builtin-guard-set",
+    "sr-015-sdk-barrel-hygiene",
+    "sr-016-adapter-postgres-production",
+    "sr-017-adapter-kafka-subscribe-stub",
+    "sr-018-phase-a6-example-alignment",
+    "sr-019-phase-a7-verification"
+  ]
+}

.changeset/sr-001-engine-naming.md

@@ -0,0 +1,62 @@
+---
+"@loop-engine/core": major
+"@loop-engine/runtime": major
+"@loop-engine/sdk": major
+"@loop-engine/actors": major
+"@loop-engine/guards": major
+"@loop-engine/loop-definition": major
+"@loop-engine/events": major
+"@loop-engine/signals": major
+"@loop-engine/observability": major
+"@loop-engine/registry-client": major
+"@loop-engine/ui-devtools": major
+"@loop-engine/adapter-memory": major
+"@loop-engine/adapter-vercel-ai": major
+"@loop-engine/adapter-perplexity": major
+"@loop-engine/adapter-anthropic": major
+"@loop-engine/adapter-openai": major
+"@loop-engine/adapter-gemini": major
+"@loop-engine/adapter-grok": major
+"@loop-engine/adapter-http": major
+"@loop-engine/adapter-openclaw": major
+"@loop-engine/adapter-pagerduty": major
+"@loop-engine/adapter-commerce-gateway": major
+---
+## SR-001 · D-07 · Engine class & method naming
+
+**Renames (no aliases, no dual names):**
+
+- runtime class `LoopSystem` → `LoopEngine`
+- runtime factory `createLoopSystem` → `createLoopEngine`
+- runtime options `LoopSystemOptions` → `LoopEngineOptions`
+- engine method `startLoop` → `start`
+- engine method `getLoop` → `getState`
+
+**Intentionally preserved (not breaking):**
+
+- SDK aggregate factory `createLoopSystem` keeps its name (this is the
+  intentional product name for the auto-wired aggregate, not an alias
+  to the runtime — the runtime factory is `createLoopEngine`).
+- `LoopStorageAdapter.getLoop` (D-11 territory; lands in SR-002).
+
+**Migration:**
+
+```diff
+- import { LoopSystem, createLoopSystem } from "@loop-engine/runtime";
++ import { LoopEngine, createLoopEngine } from "@loop-engine/runtime";
+
+- const system: LoopSystem = createLoopSystem({...});
++ const engine: LoopEngine = createLoopEngine({...});
+
+- await system.startLoop({...});
++ await engine.start({...});
+
+- await system.getLoop(aggregateId);
++ await engine.getState(aggregateId);
+```
+
+SDK consumers do **not** need to change `createLoopSystem` from
+`@loop-engine/sdk`; that name is preserved. SDK consumers do need to
+update the engine method call shape if they reach into the returned
+`engine` object: `system.engine.startLoop(...)` becomes
+`system.engine.start(...)`.

.changeset/sr-002-loopstore-collapse.md

@@ -0,0 +1,89 @@
+---
+"@loop-engine/core": major
+"@loop-engine/runtime": major
+"@loop-engine/sdk": major
+"@loop-engine/actors": major
+"@loop-engine/guards": major
+"@loop-engine/loop-definition": major
+"@loop-engine/events": major
+"@loop-engine/signals": major
+"@loop-engine/observability": major
+"@loop-engine/registry-client": major
+"@loop-engine/ui-devtools": major
+"@loop-engine/adapter-memory": major
+"@loop-engine/adapter-vercel-ai": major
+"@loop-engine/adapter-perplexity": major
+"@loop-engine/adapter-anthropic": major
+"@loop-engine/adapter-openai": major
+"@loop-engine/adapter-gemini": major
+"@loop-engine/adapter-grok": major
+"@loop-engine/adapter-http": major
+"@loop-engine/adapter-openclaw": major
+"@loop-engine/adapter-pagerduty": major
+"@loop-engine/adapter-commerce-gateway": major
+---
+## SR-002 · D-11 · LoopStore collapse and rename
+
+**Interface rename + structural collapse (6 methods → 5):**
+
+- runtime interface `LoopStorageAdapter` → `LoopStore`
+- adapter class `MemoryLoopStorageAdapter` → `MemoryStore`
+- adapter factory `createMemoryLoopStorageAdapter` → `memoryStore`
+- adapter factory `postgresStorageAdapter` removed (consolidated into
+  the canonical `postgresStore`)
+- SDK option key `storage` → `store` (both `CreateLoopSystemOptions`
+  and the `createLoopSystem` return shape)
+
+**Method renames + collapse:**
+
+| Before | After | Operation |
+|---|---|---|
+| `getLoop` | `getInstance` | rename |
+| `createLoop` | `saveInstance` | collapse with `updateLoop` |
+| `updateLoop` | `saveInstance` | collapse with `createLoop` |
+| `appendTransition` | `saveTransitionRecord` | rename |
+| `getTransitions` | `getTransitionHistory` | rename |
+| `listOpenLoops` | `listOpenInstances` | rename |
+
+`createLoop` + `updateLoop` collapse into a single `saveInstance` method
+with upsert semantics. The `MemoryStore` adapter implements this as a
+single `Map.set`. The `postgresStore` adapter implements it as
+`INSERT ... ON CONFLICT (aggregate_id) DO UPDATE SET ...`.
+
+**Migration:**
+
+```diff
+- import { MemoryLoopStorageAdapter, createMemoryLoopStorageAdapter } from "@loop-engine/adapter-memory";
++ import { MemoryStore, memoryStore } from "@loop-engine/adapter-memory";
+
+- import type { LoopStorageAdapter } from "@loop-engine/runtime";
++ import type { LoopStore } from "@loop-engine/runtime";
+
+- const adapter = createMemoryLoopStorageAdapter();
++ const store = memoryStore();
+
+- await createLoopSystem({ loops, storage: adapter });
++ await createLoopSystem({ loops, store });
+
+- const { engine, storage } = await createLoopSystem({...});
++ const { engine, store } = await createLoopSystem({...});
+
+- await storage.getLoop(aggregateId);
++ await store.getInstance(aggregateId);
+
+- await storage.createLoop(instance);  // or updateLoop
++ await store.saveInstance(instance);
+
+- await storage.appendTransition(record);
++ await store.saveTransitionRecord(record);
+
+- await storage.getTransitions(aggregateId);
++ await store.getTransitionHistory(aggregateId);
+
+- await storage.listOpenLoops(loopId);
++ await store.listOpenInstances(loopId);
+```
+
+Custom adapters that implement the interface must update method names
+and collapse `createLoop` + `updateLoop` into a single `saveInstance`
+upsert. There is no aliasing; all consumers must migrate.

.changeset/sr-003-tooladapter-rename.md

@@ -0,0 +1,65 @@
+---
+"@loop-engine/core": major
+"@loop-engine/runtime": major
+"@loop-engine/sdk": major
+"@loop-engine/actors": major
+"@loop-engine/guards": major
+"@loop-engine/loop-definition": major
+"@loop-engine/events": major
+"@loop-engine/signals": major
+"@loop-engine/observability": major
+"@loop-engine/registry-client": major
+"@loop-engine/ui-devtools": major
+"@loop-engine/adapter-memory": major
+"@loop-engine/adapter-vercel-ai": major
+"@loop-engine/adapter-perplexity": major
+"@loop-engine/adapter-anthropic": major
+"@loop-engine/adapter-openai": major
+"@loop-engine/adapter-gemini": major
+"@loop-engine/adapter-grok": major
+"@loop-engine/adapter-http": major
+"@loop-engine/adapter-openclaw": major
+"@loop-engine/adapter-pagerduty": major
+"@loop-engine/adapter-commerce-gateway": major
+---
+## SR-003 · D-13 · LLMAdapter → ToolAdapter (narrow rename)
+
+**Interface rename (no alias):**
+
+- `@loop-engine/core` interface `LLMAdapter` → `ToolAdapter`
+- source file `packages/core/src/llmAdapter.ts` →
+  `packages/core/src/toolAdapter.ts` (git mv; history preserved)
+
+**Implementer update (the lone in-tree implementer):**
+
+- `@loop-engine/adapter-perplexity` `PerplexityAdapter` now
+  declares `implements ToolAdapter`
+
+**Out of scope for this row (intentionally):**
+
+The four other AI provider adapters — `@loop-engine/adapter-anthropic`,
+`@loop-engine/adapter-openai`, `@loop-engine/adapter-gemini`,
+`@loop-engine/adapter-grok`, `@loop-engine/adapter-vercel-ai` — do
+**not** implement `LLMAdapter` today; each carries a bespoke
+`*ActorAdapter` shape. They re-home onto the new `ActorAdapter`
+archetype (a separate, distinct interface) in Phase A.3 — not onto
+`ToolAdapter`. Per D-13 the two archetypes carry different intents:
+`ToolAdapter` is for grounded-tool calls (text-in / text-out + evidence);
+`ActorAdapter` is for autonomous decision-making actors.
+
+**Migration:**
+
+```diff
+- import type { LLMAdapter } from "@loop-engine/core";
++ import type { ToolAdapter } from "@loop-engine/core";
+
+- class MyAdapter implements LLMAdapter { ... }
++ class MyAdapter implements ToolAdapter { ... }
+```
+
+The `invoke()`, `guardEvidence()`, and optional `stream()` methods
+are unchanged in signature; only the interface name renames.
+Consumers that only depend on `@loop-engine/adapter-perplexity`
+(rather than implementing the interface themselves) need no code
+changes — the package's public exports do not include
+`LLMAdapter`/`ToolAdapter` directly.

.changeset/sr-004-drop-runtime-prefix.md

@@ -0,0 +1,76 @@
+---
+"@loop-engine/core": major
+"@loop-engine/runtime": major
+"@loop-engine/sdk": major
+"@loop-engine/actors": major
+"@loop-engine/guards": major
+"@loop-engine/loop-definition": major
+"@loop-engine/events": major
+"@loop-engine/signals": major
+"@loop-engine/observability": major
+"@loop-engine/registry-client": major
+"@loop-engine/ui-devtools": major
+"@loop-engine/adapter-memory": major
+"@loop-engine/adapter-vercel-ai": major
+"@loop-engine/adapter-perplexity": major
+"@loop-engine/adapter-anthropic": major
+"@loop-engine/adapter-openai": major
+"@loop-engine/adapter-gemini": major
+"@loop-engine/adapter-grok": major
+"@loop-engine/adapter-http": major
+"@loop-engine/adapter-openclaw": major
+"@loop-engine/adapter-pagerduty": major
+"@loop-engine/adapter-commerce-gateway": major
+---
+## SR-004 · MECHANICAL 8.5 · Drop `Runtime` prefix from primitive types
+
+**Renames + relocation (no aliases, no dual names):**
+
+- runtime interface `RuntimeLoopInstance` → `LoopInstance`
+- runtime interface `RuntimeTransitionRecord` → `TransitionRecord`
+- both interfaces relocate from `@loop-engine/runtime` to
+  `@loop-engine/core` (new file `packages/core/src/loopInstance.ts`)
+  so they appear on the core public surface
+
+**Attribution:** sanctioned by `MECHANICAL 8.5`; implied by D-07's
+"no dual names anywhere" clause and the spec draft's use of the
+post-rename names. Not enumerated explicitly in D-07's resolution
+log text (per F-PB-04).
+
+**Surface diff:**
+
+| Package | Before | After |
+|---|---|---|
+| `@loop-engine/core` | — | exports `LoopInstance`, `TransitionRecord` |
+| `@loop-engine/runtime` | exports `RuntimeLoopInstance`, `RuntimeTransitionRecord` | removed |
+| `@loop-engine/sdk` | re-exports `Runtime*` from `@loop-engine/runtime` | re-exports new names from `@loop-engine/core` via existing `export *` barrel |
+
+**Internal referrers updated** (import path migrates from
+`@loop-engine/runtime` to `@loop-engine/core` for the type-only
+imports):
+
+- `@loop-engine/runtime` (engine.ts + interfaces.ts + engine.test.ts)
+- `@loop-engine/observability` (timeline.ts, replay.ts, metrics.ts +
+  observability.test.ts)
+- `@loop-engine/adapter-memory`
+- `@loop-engine/adapter-postgres`
+- `@loop-engine/sdk` (drops explicit `RuntimeLoopInstance` /
+  `RuntimeTransitionRecord` re-export; new names propagate via
+  the existing `export * from "@loop-engine/core"`)
+
+**Migration:**
+
+```diff
+- import type { RuntimeLoopInstance, RuntimeTransitionRecord } from "@loop-engine/runtime";
++ import type { LoopInstance, TransitionRecord } from "@loop-engine/core";
+
+- function process(instance: RuntimeLoopInstance, history: RuntimeTransitionRecord[]): void { ... }
++ function process(instance: LoopInstance, history: TransitionRecord[]): void { ... }
+```
+
+SDK consumers reading from `@loop-engine/sdk` can either keep that
+import path (the new names propagate via the barrel) or migrate
+directly to `@loop-engine/core`.
+
+`LoopStore` and other interfaces using these types kept their
+parameter and return types in lockstep — no runtime behavior change.