@ifsoul/core 0.3.0 → 0.4.0

package/README.md

@@ -8,24 +8,18 @@ This repository contains no game, website, React UI, Clerk authentication or
 managed deployment. The public [SDK](https://github.com/openifsoul/sdk) owns
 bounded host bridges; public [App](https://github.com/openifsoul/app) owns
 self-hostable composition and the local laboratory. Private Website and Cloud
-compose these public artifacts. See [repository ownership](https://github.com/openifsoul/core/blob/main/docs/decisions/0014-repository-product-split.md).
+compose these public artifacts. See [repository ownership](https://github.com/openifsoul/core/blob/main/docs/architecture.md).
 
-## Build and check locally
+## Install
 
-Use Node.js within the manifest's engine range and pnpm 10.15.0:
+Use Node.js 22.18–24 and an ESM project:
 
 ```sh
-pnpm install --frozen-lockfile
-pnpm check
-pnpm build
-pnpm pack:core
+npm install @ifsoul/core@0.4.0
 ```
 
-`@ifsoul/core@0.3.0` builds ESM and TypeScript declarations. It has not
-been published to npm. Consumers install a reviewed pinned local tarball; no
-sibling/private repository or account is needed. [Development](https://github.com/openifsoul/core/blob/main/docs/development.md)
-describes validation; [deployment policy](https://github.com/openifsoul/core/blob/main/docs/deployment.md) prohibits automatic
-remote execution.
+The package includes compiled JavaScript and TypeScript declarations. Import the
+explicit module you need:
 
 ```ts
 import { validateDocument } from "@ifsoul/core/protocol";
@@ -41,30 +35,30 @@ connections confer no control authority.
 
 ## Contracts and limits
 
-The [current contracts](specs/current/README.md) use IfSoul 0.3.0. Frozen
-v0.1/v0.2 schemas and ModelProvider examples remain explicit historical inputs.
-Current format families share the release identifier but retain different shapes
-and exact validators. See [compatibility](https://github.com/openifsoul/core/blob/main/docs/compatibility.md),
-[runtime API](https://github.com/openifsoul/core/blob/main/docs/runtime-api.md), [architecture](https://github.com/openifsoul/core/blob/main/docs/architecture.md),
-[security](https://github.com/openifsoul/core/blob/main/docs/security.md), [contribution](https://github.com/openifsoul/core/blob/main/CONTRIBUTING.md), and
-[versioning](https://github.com/openifsoul/core/blob/main/docs/versioning.md).
+The [current contracts](specs/current/README.md) use IfSoul 0.4.0. See
+[compatibility](https://github.com/openifsoul/core/blob/main/docs/compatibility.md)
+for identifiers and validation, and the
+[runtime API](https://github.com/openifsoul/core/blob/main/docs/runtime-api.md)
+for integration details. Matching release identifiers do not make different
+format families interchangeable.
 
-This remains experimental: tests do not prove production readiness, universal
-game interoperability, permanent memory portability or model equivalence.
+Trusted configurable provider/runtime budgets are separate from model token
+context, permissions and host authority. See
+[resource budgets](https://github.com/openifsoul/core/blob/main/docs/resource-budgets.md)
+and [security](https://github.com/openifsoul/core/blob/main/docs/security.md).
+Relationship interpretation and revision are model-dependent. Current validation
+and persistence checks do not establish reliable semantic reassessment.
 
-Trusted configurable provider/runtime budgets preserve legacy defaults and remain separate from model token context, permission and host authority. See [resource budgets](https://github.com/openifsoul/core/blob/main/docs/resource-budgets.md).
+## Develop locally
 
-## Current release and compatibility
+Clone this repository and use pnpm 10.15.0:
 
-The current coordinated release is **IfSoul 0.3.0**. Package, current-format and
-artifact identifiers share this release. Historical formats remain explicit
-compatibility inputs; matching release numbers do not make different format
-families interchangeable. See [compatibility](https://github.com/openifsoul/core/blob/main/docs/compatibility.md).
-Registry publication and deployment are separate authorized release actions.
-
-## npm publication status
+```sh
+pnpm install --frozen-lockfile
+pnpm check
+pnpm build
+```
 
-The first public npm release is being prepared; it has not been published.
-The [publication preparation](docs/npm-publishing.md) records the account/scope,
-exact-archive and separate approval gates. Existing reviewed tarball distribution
-remains supported until a real registry release is verified.
+See [development](https://github.com/openifsoul/core/blob/main/docs/development.md),
+[architecture](https://github.com/openifsoul/core/blob/main/docs/architecture.md)
+and [contribution](https://github.com/openifsoul/core/blob/main/CONTRIBUTING.md).

package/dist/packages/memory/src/sql.js

@@ -27,13 +27,62 @@ export function createSQLMemory(db, closeOwner = () => { }) {
         try {
             return action();
         }
-        catch {
+        catch (error) {
+            if (error instanceof CommitFailure)
+                return failure(error.code, error.message);
             return failure("storage", "Memory operation failed.");
         }
     };
+    const productKinds = new Set([
+        "character-instance",
+        "character-template",
+        "environment-profile",
+        "context-report",
+        "plan-proposal",
+        "plan-decision",
+        "task-report",
+        "plan-cancel-request",
+        "plan-cancel-result",
+        "conversation-request",
+        "conversation-response",
+        "conversation-delivery",
+        "memory-event",
+        "working-context",
+        "memory-episode",
+        "memory-fact",
+        "memory-relationship",
+        "intent-checkpoint",
+        "archive-manifest",
+        "provider-capabilities",
+        "model-request",
+        "model-response",
+        "model-error",
+    ]);
+    const stored = (text, kind) => {
+        const value = JSON.parse(text);
+        if (kind && !validateDocument(value, kind))
+            throw new CommitFailure("unsupported", "Stored document format is unsupported; no migration or reset was performed.");
+        // Journals may nest protocol/provider envelopes. They are not silently adapted.
+        const rejectObsolete = (node) => {
+            if (!node || typeof node !== "object")
+                return;
+            const object = node;
+            if (typeof object.kind === "string" &&
+                productKinds.has(object.kind) &&
+                typeof object.schemaVersion === "string" &&
+                object.schemaVersion !== "0.4.0")
+                throw new CommitFailure("unsupported", "Stored document format is unsupported; no migration or reset was performed.");
+            for (const child of Object.values(object))
+                rejectObsolete(child);
+        };
+        rejectObsolete(value);
+        return value;
+    };
     const read = (table, id) => {
         const row = db.prepare(`SELECT document FROM ${table} WHERE id=?`).get(id);
-        return row ? JSON.parse(row.document) : undefined;
+        return row
+            ? stored(row.document, table === "characters" ? "character-instance" : undefined)
+            : undefined;
     };
     let pruning;
     const port = {
@@ -55,7 +104,7 @@ export function createSQLMemory(db, closeOwner = () => { }) {
             return success(db
                 .prepare("SELECT document FROM characters ORDER BY id LIMIT ?")
                 .all(limit)
-                .map((row) => JSON.parse(row.document)));
+                .map((row) => stored(row.document, "character-instance")));
         }),
         getCharacter: (id) => guarded(() => success(read("characters", id))),
         getExchange: (id) => guarded(() => success(read("exchanges", id))),
@@ -120,7 +169,7 @@ export function createSQLMemory(db, closeOwner = () => { }) {
                                 .prepare("SELECT document FROM events WHERE id=?")
                                 .get(id);
                             const old = row &&
-                                JSON.parse(String(row.document));
+                                stored(String(row.document), "memory-event");
                             if (!old ||
                                 old.characterId !== retention.characterId ||
                                 old.environmentId !== retention.environmentId ||
@@ -215,7 +264,7 @@ export function createSQLMemory(db, closeOwner = () => { }) {
                 if (size + bytes > query.maxBytes)
                     continue;
                 size += bytes;
-                selected.push(JSON.parse(row.document));
+                selected.push(stored(row.document, "memory-event"));
             }
             return success(selected.reverse());
         }),