@manifesto-ai/skills 0.2.1 → 0.2.2

package/SKILL.md

@@ -11,9 +11,9 @@ You are working on a Manifesto-based project. These rules are non-negotiable.
 
 This skills pack follows the current implementation in this repo.
 
-- `@manifesto-ai/world` is still the active code target for world/governance/lineage behavior.
-- `@manifesto-ai/governance` and `@manifesto-ai/lineage` are currently split-design docs, not code packages to target for implementation work here.
-- When docs describe future structure that is not implemented yet, prefer existing package exports and source files.
+- `@manifesto-ai/world` is the canonical governed composition package and exact consumer-facing facade.
+- `@manifesto-ai/governance` and `@manifesto-ai/lineage` are implemented code packages and own their protocol-layer behavior.
+- For governed work, prefer top-level `@manifesto-ai/world` for composition and import split-native packages directly only when the task is intentionally limited to governance or lineage.
 
 ## Absolute Rules
 

package/knowledge/architecture.md

@@ -1,7 +1,7 @@
 # Manifesto Architecture
 
-> Source: `packages/core/docs/core-SPEC.md`, `packages/host/docs/host-SPEC.md`, `packages/sdk/docs/sdk-SPEC-v1.0.0.md`, current `packages/world/src/*`
-> Last synced: 2026-03-28
+> Source: `packages/core/docs/core-SPEC.md`, `packages/host/docs/host-SPEC.md`, `packages/sdk/docs/sdk-SPEC-v2.0.0.md`, current `packages/world/src/*`
+> Last synced: 2026-03-31
 
 ## Rules
 
@@ -42,14 +42,12 @@ SDK-style app
 Governed path
   Actor submits IntentInstance
     -> World
-    -> HostExecutor
+    -> WorldExecutor
     -> Host
     -> Core
     -> new World state + lineage records
 ```
 
-The separate `@manifesto-ai/governance` and `@manifesto-ai/lineage` packages are not implemented code targets in this repo yet. They currently exist as split-design documentation only.
-
 ## Package Sovereignty
 
 | Package | Responsibility | MUST NOT |
@@ -59,19 +57,14 @@ The separate `@manifesto-ai/governance` and `@manifesto-ai/lineage` packages are
 | **World** | Proposal lifecycle, authority evaluation, lineage DAG, persistence, governance event emission | Import `@manifesto-ai/host` directly, compute semantic meaning, apply Core patches itself |
 | **SDK** | Public app entrypoint (`createManifesto`), typed effect registration, `dispatchAsync`, typed patch helpers, selected re-exports | Invent semantics outside Core/Host/World public contracts |
 
-## Current `world` Note
-
-In this repo's implementation, `@manifesto-ai/world` is still the active monolithic package for:
+## Current Governed Structure
 
-- actor registry
-- proposal queue and state machine
-- authority handlers and evaluation
-- lineage DAG helpers
-- persistence interfaces and in-memory store
-- governance event emission
-- `HostExecutor` boundary
+In this repo's implementation:
 
-ADR-014 split docs are useful for future direction, but not the current implementation baseline for code changes.
+- `@manifesto-ai/world` is the exact consumer-facing governed facade
+- `@manifesto-ai/governance` is the current governance protocol package
+- `@manifesto-ai/lineage` is the current continuity protocol package
+- top-level `@manifesto-ai/world` re-exports the split-native surfaces needed for explicit composition
 
 ## Snapshot Structure
 
@@ -82,7 +75,6 @@ type Snapshot = {
   system: {
     status: "idle" | "computing" | "pending" | "error";
     lastError: ErrorValue | null;
-    errors: ErrorValue[];
     pendingRequirements: Requirement[];
     currentAction: string | null;
   };
@@ -120,7 +112,7 @@ Each `compute()` call is complete and independent. Continuity lives in the snaps
 - **Determinism**: Core can be tested without mocks.
 - **Auditability**: World records proposal and decision lineage.
 - **Portability**: Host remains the execution seam.
-- **Clarity**: SDK is the public app-facing layer, while World is optional governance/orchestration around Host.
+- **Clarity**: SDK is the public app-facing direct-dispatch layer, while World is the explicit governed composition layer around Host.
 
 ## Cross-References
 

package/knowledge/llm/LLM-INDEX.md

@@ -23,15 +23,25 @@ When implementation and future-design docs diverge, use the implemented package
 - `packages/host/src/index.ts`
 
 ### World
-- `packages/world/src/index.ts`
-- `packages/world/src/world.ts`
+- `packages/world/docs/world-facade-spec-v1.0.0.md`
 - `packages/world/docs/VERSION-INDEX.md`
-- `packages/world/docs/world-SPEC.md`
+- `packages/world/src/index.ts`
+- `packages/world/src/facade/index.ts`
+
+Note: top-level `@manifesto-ai/world` is the exact governed facade in the current repo.
+
+### Governance
+- `packages/governance/docs/governance-SPEC-1.0.0v.md`
+- `packages/governance/docs/VERSION-INDEX.md`
+- `packages/governance/src/index.ts`
 
-Note: current repo code still implements world concerns in `@manifesto-ai/world`.
+### Lineage
+- `packages/lineage/docs/lineage-SPEC-1.0.1v.md`
+- `packages/lineage/docs/VERSION-INDEX.md`
+- `packages/lineage/src/index.ts`
 
 ### SDK
-- `packages/sdk/docs/sdk-SPEC-v1.0.0.md`
+- `packages/sdk/docs/sdk-SPEC-v2.0.0.md`
 - `packages/sdk/docs/VERSION-INDEX.md`
 - `packages/sdk/src/index.ts`
 - `packages/sdk/src/types.ts`
@@ -48,15 +58,14 @@ Note: current repo code still implements world concerns in `@manifesto-ai/world`
 
 ## Future-split / design-only references
 
-These are useful design docs, but they are not backed by separate code packages in this repo yet:
+These are useful next-major drafts, but they are not the default coding target unless a task explicitly targets them:
 
-- `packages/governance/docs/governance-SPEC-1.0.0v.md`
-- `packages/governance/docs/VERSION-INDEX.md`
-- `packages/lineage/docs/lineage-SPEC-1.0.1v.md`
-- `packages/lineage/docs/VERSION-INDEX.md`
-- `packages/world/docs/world-facade-spec-v1.0.0.md`
+- `packages/sdk/docs/sdk-SPEC-v3.0.0-draft.md`
+- `packages/governance/docs/governance-SPEC-2.0.0v.md`
+- `packages/lineage/docs/lineage-SPEC-2.0.0v.md`
+- `packages/world/docs/world-facade-spec-v2.0.0.md`
 
-Use them for ADR-014 direction, not as the primary basis for current code changes.
+Use them for next-major direction, not as the primary basis for current code changes.
 
 ## ADRs
 

package/knowledge/llm/LLM-NORMS.md

@@ -42,12 +42,12 @@ This is a compact summary of high-salience rules. For exact wording, defer to th
 
 ## Current implementation note
 
-- In this repo, `@manifesto-ai/world` is still the active implementation target for world/governance/lineage behavior.
-- `@manifesto-ai/governance` and `@manifesto-ai/lineage` exist as split-design documentation, not implemented code packages.
-- For coding tasks, prefer the current exported surface in `packages/world/src/*` over future split docs.
+- In this repo, top-level `@manifesto-ai/world` is the exact consumer-facing governed facade.
+- `@manifesto-ai/governance` and `@manifesto-ai/lineage` are implemented code packages and own their protocol-layer behavior.
+- For consumer-facing governed work, prefer current `@manifesto-ai/world` exports and adapter subpaths. Import split-native packages directly only when the task is intentionally scoped to governance or lineage.
 
 ## Guidance for LLM use
 
 - Do not infer behavior not stated in SPEC, FDR, ADR, or current exported code.
-- When docs and code differ because a future split is not implemented yet, call that out explicitly.
+- When current and next-major docs differ, call that out explicitly and prefer the current exported surface unless the task targets a draft.
 - Prefer current package exports and source layout for implementation guidance.

package/knowledge/packages/core.md

@@ -18,6 +18,8 @@ interface ManifestoCore {
   applySystemDelta(snapshot, delta): Snapshot;
   validate(schema): ValidationResult;
   explain(schema, snapshot, path): ExplainResult;
+  isActionAvailable(schema, snapshot, actionName): boolean;
+  getAvailableActions(schema, snapshot): readonly string[];
 }
 ```
 
@@ -41,7 +43,6 @@ type Snapshot = {
   system: {
     status: "idle" | "computing" | "pending" | "error";
     lastError: ErrorValue | null;
-    errors: ErrorValue[];
     pendingRequirements: Requirement[];
     currentAction: string | null;
   };
@@ -82,9 +83,8 @@ type SystemDelta = {
   status?: SystemState["status"];
   currentAction?: string | null;
   lastError?: ErrorValue | null;
-  appendErrors: ErrorValue[];
-  addRequirements: Requirement[];
-  removeRequirementIds: string[];
+  addRequirements?: readonly Requirement[];
+  removeRequirementIds?: readonly string[];
 };
 ```
 
@@ -93,6 +93,8 @@ type SystemDelta = {
 - `createSnapshot`
 - `createIntent`
 - `createCore`
+- `isActionAvailable`
+- `getAvailableActions`
 - schema and evaluator re-exports
 
 ## Notes
@@ -100,3 +102,4 @@ type SystemDelta = {
 - Core owns semantic meaning and validation.
 - Host owns execution.
 - World owns governance and proposal flow around execution.
+- Current Core v4 keeps `lastError` as the sole current error surface.

package/knowledge/packages/host.md

@@ -8,7 +8,7 @@ Host executes effects, applies patches, orchestrates the compute loop, and fulfi
 
 ## Public API
 
-### `createHost(schema, effectHandlers, options?): ManifestoHost`
+### `createHost(schema, options?): ManifestoHost`
 
 ```typescript
 const host = createHost(schema, effectHandlers, {
@@ -68,4 +68,5 @@ SDK wraps this Host-level contract into the simpler `(params, ctx)` developer-fa
 ## Notes
 
 - Host is the execution seam between Core and the outside world.
-- `@manifesto-ai/world` defines a `HostExecutor` boundary so World does not import Host directly.
+- Host-facing Snapshot references follow the current Core v4 shape and no longer include accumulated `system.errors`.
+- `@manifesto-ai/world` defines a `WorldExecutor` boundary so World does not import Host directly.

package/knowledge/packages/sdk.md

@@ -7,12 +7,13 @@
 SDK owns the public app-facing surface:
 
 - `createManifesto()`
+- availability query convenience methods on `ManifestoInstance`
 - `dispatchAsync()`
 - `defineOps()`
 - SDK error types
 - selected re-exports from Core, Host, and World
 
-In the current implementation, `createManifesto()` composes Core, Host, and Compiler directly. The package also depends on `@manifesto-ai/world` and re-exports `WorldStore` helpers, but `createManifesto()` itself is not a World orchestrator.
+In the current implementation, `createManifesto()` composes Core, Host, and Compiler directly. The package also depends on `@manifesto-ai/world` and re-exports only a thin governed surface, but `createManifesto()` itself is not a World orchestrator.
 
 ## Dependencies
 
@@ -63,6 +64,8 @@ interface ManifestoInstance<T = unknown> {
     event: K,
     handler: (payload: ManifestoEventMap<T>[K]) => void,
   ): Unsubscribe;
+  isActionAvailable(actionName: string): boolean;
+  getAvailableActions(): readonly string[];
   getSnapshot(): Snapshot<T>;
   dispose(): void;
 }
@@ -118,7 +121,7 @@ Payloads are event-specific through `ManifestoEventMap<T>`.
 
 - From Core: `createIntent`, `createSnapshot`, `createCore`, core types
 - From Host: `HostResult`, `HostOptions`
-- From World: `WorldStore`, `createMemoryWorldStore`
+- From World: `createWorld` plus the thin governed type surface needed for explicit composition
 
 ## Errors
 
@@ -127,3 +130,9 @@ Payloads are event-specific through `ManifestoEventMap<T>`.
 - `DisposedError`
 - `CompileError`
 - `DispatchRejectedError`
+
+## Notes
+
+- SDK `Snapshot<T>` transparently follows the current Core Snapshot shape.
+- `getSnapshot()` no longer exposes accumulated `system.errors`.
+- `isActionAvailable()` and `getAvailableActions()` delegate to Core against the current snapshot.

package/knowledge/packages/world.md

@@ -1,20 +1,16 @@
 # @manifesto-ai/world
 
-> Current monolithic World Protocol implementation in this repo.
+> Canonical governed composition surface for Manifesto.
 
 ## Role
 
-In the current codebase, `@manifesto-ai/world` is the active implementation target for:
+Top-level `@manifesto-ai/world` is the exact consumer-facing facade for:
 
-- actor registration and authority bindings
-- proposal submission and lifecycle
-- authority evaluation, including HITL and policy rules
-- lineage DAG helpers
-- world persistence interfaces and in-memory storage
-- governance event emission
-- `HostExecutor` boundary definition
-
-Future split docs for `@manifesto-ai/governance` and `@manifesto-ai/lineage` exist, but those packages are not implemented as code in this repo yet.
+- `createWorld()` and `WorldRuntime`
+- the `GovernedWorldStore` contract and seal transaction seam
+- the world-owned execution boundary (`WorldExecutor`)
+- split-native lineage and governance service re-exports
+- intent-instance helpers and governed bootstrap wiring
 
 ## Dependencies
 
@@ -23,82 +19,51 @@ Future split docs for `@manifesto-ai/governance` and `@manifesto-ai/lineage` exi
 
 ## Public API
 
-### `createManifestoWorld(config): ManifestoWorld`
+### `createWorld(config): WorldInstance`
 
 ```typescript
-interface ManifestoWorldConfig {
-  schemaHash: string;
-  executor?: HostExecutor;
-  store?: WorldStore;
-  onHITLRequired?: HITLNotificationCallback;
-  customEvaluators?: Record<string, CustomConditionEvaluator>;
-  eventSink?: WorldEventSink;
-  executionKeyPolicy?: ExecutionKeyPolicy;
+interface WorldConfig {
+  store: GovernedWorldStore;
+  lineage: LineageService;
+  governance: GovernanceService;
+  eventDispatcher: GovernanceEventDispatcher;
+  executor: WorldExecutor;
 }
 ```
 
-### `ManifestoWorld`
+### `WorldInstance`
 
 ```typescript
-class ManifestoWorld {
-  registerActor(actor: ActorRef, policy: AuthorityPolicy): void;
-  updateActorBinding(actorId: string, policy: AuthorityPolicy): void;
-  getActorBinding(actorId: string): ActorAuthorityBinding | null;
-  getRegisteredActors(): ActorRef[];
-  onHITLRequired(handler: HITLNotificationCallback): () => void;
-
-  createGenesis(initialSnapshot: Snapshot): Promise<World>;
-  switchBranch(newBaseWorld: WorldId): Promise<void>;
-  get epoch(): number;
-
-  submitProposal(
-    actorId: string,
-    intent: IntentInstance,
-    baseWorld: WorldId,
-    trace?: ProposalTrace,
-  ): Promise<ProposalResult>;
-
-  processHITLDecision(
-    proposalId: string,
-    decision: "approved" | "rejected",
-    reasoning?: string,
-    approvedScope?: IntentScope | null,
-  ): Promise<ProposalResult>;
-
-  getWorld(worldId: WorldId): Promise<World | null>;
-  getSnapshot(worldId: WorldId): Promise<Snapshot | null>;
-  getGenesis(): Promise<World | null>;
-  getProposal(proposalId: string): Promise<Proposal | null>;
-  getEvaluatingProposals(): Promise<Proposal[]>;
-  getDecision(decisionId: string): Promise<DecisionRecord | null>;
-  getDecisionByProposal(proposalId: string): Promise<DecisionRecord | null>;
-  getLineage(): WorldLineage;
+interface WorldInstance {
+  store: GovernedWorldStore;
+  lineage: LineageService;
+  governance: GovernanceService;
+  coordinator: WorldCoordinator;
+  runtime: WorldRuntime;
 }
 ```
 
-### `ProposalResult`
+### `WorldRuntime`
 
 ```typescript
-type ProposalResult = {
-  proposal: Proposal;
-  decision?: DecisionRecord;
-  resultWorld?: World;
-  error?: WorldError;
-};
+interface WorldRuntime {
+  executeApprovedProposal(input: ExecuteApprovedProposalInput): Promise<WorldRuntimeCompletion>;
+  resumeExecutingProposal(input: ResumeExecutingProposalInput): Promise<WorldRuntimeCompletion>;
+}
 ```
 
-### `HostExecutor`
+### `WorldExecutor`
 
 World defines its own execution seam and does not import `@manifesto-ai/host` directly:
 
 ```typescript
-interface HostExecutor {
+interface WorldExecutor {
   execute(
     key: ExecutionKey,
-    baseSnapshot: Snapshot,
+    snapshot: Snapshot,
     intent: Intent,
-    opts?: HostExecutionOptions,
-  ): Promise<HostExecutionResult>;
+    opts?: WorldExecutionOptions,
+  ): Promise<WorldExecutionResult>;
 
   abort?(key: ExecutionKey): void;
 }
@@ -106,16 +71,21 @@ interface HostExecutor {
 
 ## Stores, Helpers, and Re-exports
 
-Key currently implemented exports include:
+Top-level exports include:
+
+- `createWorld`
+- `createLineageService`
+- `createGovernanceService`
+- `createGovernanceEventDispatcher`
+- `createIntentInstance`, `createIntentInstanceSync`
+- split-native lineage and governance types
+- the facade-owned `GovernedWorldStore`, `WorldCoordinator`, and `WorldRuntime` types
 
-- `WorldStore`, `createMemoryWorldStore`
-- `createExecutionKey`, `defaultExecutionKeyPolicy`
-- actor registry helpers
-- proposal queue helpers
-- authority handlers and evaluator
-- lineage helpers
-- world event types and `createNoopWorldEventSink`
-- factories such as `createGenesisWorld`, `createWorldFromExecution`, `createIntentInstance`
+Concrete store adapters live on subpaths:
+
+- `@manifesto-ai/world/in-memory`
+- `@manifesto-ai/world/indexeddb`
+- `@manifesto-ai/world/sqlite`
 
 ## Event Model
 
@@ -130,9 +100,8 @@ Current world implementation emits governance-oriented events such as:
 - `world:created`
 - `world:forked`
 
-## Current vs Future Structure
-
-- **Current code target**: `@manifesto-ai/world`
-- **Future design references**: `@manifesto-ai/governance`, `@manifesto-ai/lineage`, `world-facade-spec-v1.0.0`
+## Current Structure
 
-If you are changing code in this repo today, start from `packages/world/src/index.ts` and `packages/world/src/world.ts`.
+- Use top-level `@manifesto-ai/world` for consumer-facing governed composition.
+- Use `@manifesto-ai/governance` or `@manifesto-ai/lineage` directly only when the task is intentionally scoped to one protocol layer.
+- Use adapter subpaths only when you need a concrete store implementation.

package/knowledge/spec-index.md

@@ -1,7 +1,7 @@
 # SPEC Index
 
 > Source: `./llm/LLM-INDEX.md`
-> Last synced: 2026-03-28
+> Last synced: 2026-03-31
 
 ## Normative Hierarchy
 
@@ -11,7 +11,7 @@
 4. **Code**
 5. **README**
 
-When documents conflict, prefer the higher-ranked source. When docs describe future package splits that are not implemented in code yet, use current package exports and source layout for coding tasks.
+When documents conflict, prefer the higher-ranked source. When current and next-major docs diverge, use the current exported package surface for coding tasks unless the task explicitly targets a draft.
 
 ## Current Code-Writing Baseline
 
@@ -19,36 +19,52 @@ When documents conflict, prefer the higher-ranked source. When docs describe fut
 
 - `packages/core/docs/core-SPEC.md`
 - `packages/core/docs/VERSION-INDEX.md`
+- `packages/core/src/index.ts`
 
-Use for: constitution, snapshot structure, patch semantics, validation, `SystemDelta`.
+Use for: constitution, current Snapshot shape, patch semantics, validation, `SystemDelta`, and availability query API.
 
 ### Host
 
 - `packages/host/docs/host-SPEC.md`
 - `packages/host/docs/VERSION-INDEX.md`
+- `packages/host/src/index.ts`
 
-Use for: effect handler contract, requirement lifecycle, execution model, Host/Core boundary.
+Use for: effect handler contract, requirement lifecycle, execution model, and Host/Core boundary.
 
 ### World
 
-- `packages/world/src/index.ts`
-- `packages/world/src/world.ts`
+- `packages/world/docs/world-facade-spec-v1.0.0.md`
 - `packages/world/docs/VERSION-INDEX.md`
-- `packages/world/docs/world-SPEC.md`
+- `packages/world/src/index.ts`
+- `packages/world/src/facade/index.ts`
 
-Use for: actual implemented `@manifesto-ai/world` API, proposal flow, authority evaluation, persistence, event emission, lineage helpers.
+Use for: top-level governed composition, `createWorld()`, `WorldRuntime`, store contract, and the exact facade-owned execution boundary.
 
-Important: current repo code still targets monolithic `@manifesto-ai/world`. Treat governance/lineage split docs as design context unless you are explicitly editing docs.
+### Governance
+
+- `packages/governance/docs/governance-SPEC-1.0.0v.md`
+- `packages/governance/docs/VERSION-INDEX.md`
+- `packages/governance/src/index.ts`
+
+Use for: proposal lifecycle, authority evaluation, governance events, and proposal persistence semantics.
+
+### Lineage
+
+- `packages/lineage/docs/lineage-SPEC-1.0.1v.md`
+- `packages/lineage/docs/VERSION-INDEX.md`
+- `packages/lineage/src/index.ts`
+
+Use for: world identity, seal attempts, branch/head/tip rules, restore, replay, and continuity persistence.
 
 ### SDK
 
-- `packages/sdk/docs/sdk-SPEC-v1.0.0.md`
+- `packages/sdk/docs/sdk-SPEC-v2.0.0.md`
 - `packages/sdk/docs/VERSION-INDEX.md`
 - `packages/sdk/src/index.ts`
 - `packages/sdk/src/types.ts`
 - `packages/sdk/src/create-manifesto.ts`
 
-Use for: `createManifesto()`, `ManifestoConfig`, `ManifestoInstance`, `dispatchAsync`, typed events, typed patch helpers.
+Use for: `createManifesto()`, `ManifestoConfig`, `ManifestoInstance`, availability queries, `dispatchAsync`, typed events, and typed patch helpers.
 
 ### Compiler
 
@@ -65,23 +81,24 @@ Use for: MEL syntax, compiler public API, bundler integrations, compile diagnost
 
 Use for: code generation plugin contracts.
 
-## Design / Future-Split References
+## Next-Major Draft References
 
-These docs are real, but they are not the current code-writing target for implementation work in this repo:
+These docs are real, but they are not the current code-writing target unless the task explicitly targets a draft:
 
-- `packages/governance/docs/VERSION-INDEX.md`
-- `packages/governance/docs/governance-SPEC-1.0.0v.md`
-- `packages/lineage/docs/VERSION-INDEX.md`
-- `packages/lineage/docs/lineage-SPEC-1.0.1v.md`
-- `packages/world/docs/world-facade-spec-v1.0.0.md`
+- `packages/sdk/docs/sdk-SPEC-v3.0.0-draft.md`
+- `packages/governance/docs/governance-SPEC-2.0.0v.md`
+- `packages/lineage/docs/lineage-SPEC-2.0.0v.md`
+- `packages/world/docs/world-facade-spec-v2.0.0.md`
 
-Use them to understand ADR-014 direction and package split intent. Do not treat them as proof that separate `@manifesto-ai/governance` or `@manifesto-ai/lineage` code packages are implemented here.
+Use them to understand projected next-major changes. Do not let them override current package exports unless the task is explicitly about the draft.
 
 ## Global ADRs Worth Loading
 
 - ADR-002: `onceIntent` + `$mel` namespace
 - ADR-010: protocol-first SDK reconstruction
 - ADR-014: split world protocol design direction
+- ADR-015: current Snapshot error-history removal
+- ADR-016: next-major lineage/governance/world epoch direction
 
 ## Quick Lookup
 
@@ -89,11 +106,12 @@ Use them to understand ADR-014 direction and package split intent. Do not treat
 |----------------------|-------|
 | Snapshot structure | `packages/core/docs/core-SPEC.md` |
 | `patches` + `systemDelta` contract | `packages/core/docs/core-SPEC.md`, `packages/core/src/schema/result.ts` |
+| Availability query API | `packages/core/docs/core-SPEC.md`, `packages/core/src/core/action-availability.ts`, `packages/sdk/src/create-manifesto.ts` |
 | Effect handler contract | `packages/host/docs/host-SPEC.md`, `packages/sdk/src/types.ts` |
 | SDK instance API | `packages/sdk/src/types.ts`, `packages/sdk/src/create-manifesto.ts` |
 | `dispatchAsync` | `packages/sdk/src/dispatch-async.ts` |
-| Current World implementation surface | `packages/world/src/index.ts`, `packages/world/src/world.ts` |
-| World docs and transition context | `packages/world/docs/VERSION-INDEX.md` |
-| Governance / lineage split direction | `packages/governance/docs/VERSION-INDEX.md`, `packages/lineage/docs/VERSION-INDEX.md` |
+| Current governed facade surface | `packages/world/src/index.ts`, `packages/world/src/facade/index.ts`, `packages/world/docs/world-facade-spec-v1.0.0.md` |
+| Governance package surface | `packages/governance/src/index.ts`, `packages/governance/docs/VERSION-INDEX.md` |
+| Lineage package surface | `packages/lineage/src/index.ts`, `packages/lineage/docs/VERSION-INDEX.md` |
 | MEL syntax | `packages/compiler/docs/SPEC-v0.7.0.md` |
 | Compiler public API | `packages/compiler/src/index.ts` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@manifesto-ai/skills",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "LLM knowledge pack for Manifesto with Codex and Claude Code integration guidance",
   "license": "MIT",
   "type": "module",

package/tracking/source-map.json

@@ -1,26 +1,26 @@
 {
   "version": "0.4.0",
-  "lastChecked": "2026-03-28",
+  "lastChecked": "2026-03-31",
   "mappings": [
     {
       "skill": "SKILL.md",
       "sources": [
         { "path": "CLAUDE.md", "version": "1.0", "sections": ["§1", "§2", "§3", "§11"] },
-        { "path": "packages/core/docs/core-SPEC.md", "version": "3.0.0", "sections": ["§3"] },
-        { "path": "packages/host/docs/host-SPEC.md", "version": "3.0.0", "sections": ["§4", "§7"] },
-        { "path": "packages/world/src/world.ts", "version": "2.5.0" }
+        { "path": "packages/core/docs/core-SPEC.md", "version": "4.0.0", "sections": ["§3"] },
+        { "path": "packages/host/docs/host-SPEC.md", "version": "4.0.0", "sections": ["§4", "§7"] },
+        { "path": "packages/world/src/facade/index.ts", "version": "2.6.0" }
       ],
-      "lastSynced": "2026-03-28"
+      "lastSynced": "2026-03-31"
     },
     {
       "skill": "knowledge/architecture.md",
       "sources": [
-        { "path": "packages/core/docs/core-SPEC.md", "version": "3.0.0", "sections": ["§3", "§13", "§16"] },
-        { "path": "packages/host/docs/host-SPEC.md", "version": "3.0.0", "sections": ["§4", "§7", "§9"] },
-        { "path": "packages/sdk/src/create-manifesto.ts", "version": "2.1.0" },
-        { "path": "packages/world/src/world.ts", "version": "2.5.0" }
+        { "path": "packages/core/docs/core-SPEC.md", "version": "4.0.0", "sections": ["§3", "§13", "§16"] },
+        { "path": "packages/host/docs/host-SPEC.md", "version": "4.0.0", "sections": ["§4", "§7", "§9"] },
+        { "path": "packages/sdk/src/create-manifesto.ts", "version": "2.2.0" },
+        { "path": "packages/world/src/facade/index.ts", "version": "2.6.0" }
       ],
-      "lastSynced": "2026-03-28"
+      "lastSynced": "2026-03-31"
     },
     {
       "skill": "knowledge/mel-patterns.md",
@@ -33,27 +33,27 @@
     {
       "skill": "knowledge/effect-patterns.md",
       "sources": [
-        { "path": "packages/host/docs/host-SPEC.md", "version": "3.0.0", "sections": ["§7", "§8", "§9"] },
-        { "path": "packages/sdk/src/types.ts", "version": "2.1.0" },
-        { "path": "packages/sdk/src/create-manifesto.ts", "version": "2.1.0" }
+        { "path": "packages/host/docs/host-SPEC.md", "version": "4.0.0", "sections": ["§7", "§8", "§9"] },
+        { "path": "packages/sdk/src/types.ts", "version": "2.2.0" },
+        { "path": "packages/sdk/src/create-manifesto.ts", "version": "2.2.0" }
       ],
-      "lastSynced": "2026-03-28"
+      "lastSynced": "2026-03-31"
     },
     {
       "skill": "knowledge/patch-rules.md",
       "sources": [
-        { "path": "packages/core/docs/core-SPEC.md", "version": "3.0.0", "sections": ["§8", "§13", "§14"] },
+        { "path": "packages/core/docs/core-SPEC.md", "version": "4.0.0", "sections": ["§8", "§13", "§14"] },
         { "path": "packages/core/src/schema/patch.ts", "version": "2.7.1" },
         { "path": "packages/core/src/core/apply.ts", "version": "2.7.1" }
       ],
-      "lastSynced": "2026-03-28"
+      "lastSynced": "2026-03-31"
     },
     {
       "skill": "knowledge/antipatterns.md",
       "sources": [
         { "path": "CLAUDE.md", "version": "1.0", "sections": ["§10"] },
-        { "path": "packages/core/docs/core-SPEC.md", "version": "3.0.0" },
-        { "path": "packages/world/src/world.ts", "version": "2.5.0" }
+        { "path": "packages/core/docs/core-SPEC.md", "version": "4.0.0" },
+        { "path": "packages/world/src/facade/index.ts", "version": "2.6.0" }
       ],
       "note": "Accumulated from real usage feedback and constitutional violations.",
       "lastSynced": "2026-02-09"
@@ -63,46 +63,46 @@
       "sources": [
         { "path": "skills/knowledge/llm/LLM-INDEX.md", "version": "0.4.0" }
       ],
-      "lastSynced": "2026-03-28"
+      "lastSynced": "2026-03-31"
     },
     {
       "skill": "knowledge/packages/core.md",
       "sources": [
         { "path": "packages/core/package.json", "version": "2.7.1" },
         { "path": "packages/core/src/index.ts", "version": "2.7.1" },
-        { "path": "packages/core/docs/core-SPEC.md", "version": "3.0.0" }
+        { "path": "packages/core/docs/core-SPEC.md", "version": "4.0.0" }
       ],
-      "lastSynced": "2026-03-28"
+      "lastSynced": "2026-03-31"
     },
     {
       "skill": "knowledge/packages/host.md",
       "sources": [
-        { "path": "packages/host/package.json", "version": "2.3.5" },
-        { "path": "packages/host/src/index.ts", "version": "2.3.5" },
-        { "path": "packages/host/docs/host-SPEC.md", "version": "3.0.0" }
+        { "path": "packages/host/package.json", "version": "2.4.0" },
+        { "path": "packages/host/src/index.ts", "version": "2.4.0" },
+        { "path": "packages/host/docs/host-SPEC.md", "version": "4.0.0" }
       ],
-      "lastSynced": "2026-03-28"
+      "lastSynced": "2026-03-31"
     },
     {
       "skill": "knowledge/packages/world.md",
       "sources": [
-        { "path": "packages/world/package.json", "version": "2.5.0" },
-        { "path": "packages/world/src/index.ts", "version": "2.5.0" },
-        { "path": "packages/world/src/world.ts", "version": "2.5.0" },
+        { "path": "packages/world/package.json", "version": "2.6.0" },
+        { "path": "packages/world/src/index.ts", "version": "2.6.0" },
+        { "path": "packages/world/src/facade/index.ts", "version": "2.6.0" },
         { "path": "packages/world/docs/VERSION-INDEX.md", "version": "2026-03-28" }
       ],
-      "lastSynced": "2026-03-28"
+      "lastSynced": "2026-03-31"
     },
     {
       "skill": "knowledge/packages/sdk.md",
       "sources": [
-        { "path": "packages/sdk/package.json", "version": "2.1.0" },
-        { "path": "packages/sdk/src/index.ts", "version": "2.1.0" },
-        { "path": "packages/sdk/src/types.ts", "version": "2.1.0" },
-        { "path": "packages/sdk/src/create-manifesto.ts", "version": "2.1.0" },
-        { "path": "packages/sdk/docs/sdk-SPEC-v1.0.0.md", "version": "1.0.0" }
+        { "path": "packages/sdk/package.json", "version": "2.2.0" },
+        { "path": "packages/sdk/src/index.ts", "version": "2.2.0" },
+        { "path": "packages/sdk/src/types.ts", "version": "2.2.0" },
+        { "path": "packages/sdk/src/create-manifesto.ts", "version": "2.2.0" },
+        { "path": "packages/sdk/docs/sdk-SPEC-v2.0.0.md", "version": "2.0.0" }
       ],
-      "lastSynced": "2026-03-28"
+      "lastSynced": "2026-03-31"
     },
     {
       "skill": "knowledge/packages/compiler.md",