soulbridge 0.0.100 → 0.0.101

package/dist/packages/core/src/config/status.d.ts

@@ -1,24 +1,24 @@
 /**
  * Fact lifecycle vocabulary — declared once, imported everywhere.
  *
- * "superseded" used to be typed out in three files, so renaming it would have left
- * one filter silently admitting retired facts. Config modules hold data only; the
- * decoding (SQL binding, filters, prompts) lives in the code that imports this.
+ * These four replaced none/open/kept/broken/superseded. The older set mixed "what kind of
+ * fact" with "how far it has come", so every reader had to remember which values counted as
+ * live. The four below are the only ones written now: `raw` is the exchange itself,
+ * `candidate` is held but not injected, `active` is in use, `retracted` is kept for the
+ * record and read by nothing.
  *
- * Values match the column defaults in sqlite.ts; changing one is a schema migration,
- * not a rename.
+ * Values match the column defaults in sqlite.ts; changing one is a schema migration, not a
+ * rename.
  */
 export declare const FACT_STATUS: {
-    /** Written, no lifecycle decision yet. */
-    readonly none: 'none';
-    /** Being worked on (promises, plans). */
-    readonly open: 'open';
-    /** Held. */
-    readonly kept: 'kept';
-    /** Broken (a promise that did not happen). */
-    readonly broken: 'broken';
-    /** Replaced by another fact; kept for the record, never injected. */
-    readonly superseded: 'superseded';
+    /** The exchange itself; not a distilled fact. */
+    readonly raw: 'raw';
+    /** Held, not injected: unverified inference or an unconfirmed rule. */
+    readonly candidate: 'candidate';
+    /** In use: retrieval, rules, profile, evidence. */
+    readonly active: 'active';
+    /** Replaced or withdrawn; kept for the audit trail, injected nowhere. */
+    readonly retracted: 'retracted';
 };
 export type FactStatus = (typeof FACT_STATUS)[keyof typeof FACT_STATUS];
 /** Where a fact came from, in the trust sense (not a type). */

package/dist/packages/core/src/config/status.js

@@ -1,24 +1,24 @@
 /**
  * Fact lifecycle vocabulary — declared once, imported everywhere.
  *
- * "superseded" used to be typed out in three files, so renaming it would have left
- * one filter silently admitting retired facts. Config modules hold data only; the
- * decoding (SQL binding, filters, prompts) lives in the code that imports this.
+ * These four replaced none/open/kept/broken/superseded. The older set mixed "what kind of
+ * fact" with "how far it has come", so every reader had to remember which values counted as
+ * live. The four below are the only ones written now: `raw` is the exchange itself,
+ * `candidate` is held but not injected, `active` is in use, `retracted` is kept for the
+ * record and read by nothing.
  *
- * Values match the column defaults in sqlite.ts; changing one is a schema migration,
- * not a rename.
+ * Values match the column defaults in sqlite.ts; changing one is a schema migration, not a
+ * rename.
  */
 export const FACT_STATUS = {
-    /** Written, no lifecycle decision yet. */
-    none: 'none',
-    /** Being worked on (promises, plans). */
-    open: 'open',
-    /** Held. */
-    kept: 'kept',
-    /** Broken (a promise that did not happen). */
-    broken: 'broken',
-    /** Replaced by another fact; kept for the record, never injected. */
-    superseded: 'superseded',
+    /** The exchange itself; not a distilled fact. */
+    raw: 'raw',
+    /** Held, not injected: unverified inference or an unconfirmed rule. */
+    candidate: 'candidate',
+    /** In use: retrieval, rules, profile, evidence. */
+    active: 'active',
+    /** Replaced or withdrawn; kept for the audit trail, injected nowhere. */
+    retracted: 'retracted',
 };
 /** Where a fact came from, in the trust sense (not a type). */
 export const FACT_SOURCE = {

package/dist/packages/core/src/index.js

@@ -557,7 +557,7 @@ export class Soul {
                 // lost, and "the fact changed" is never claimed without a real predecessor.
                 const target = operation.targetId ? this.store.fact(operation.targetId) : null;
                 const sameScope = target && target.soulId === this.soulId && target.userId === this.userId;
-                if (target && sameScope && target.status !== 'superseded') {
+                if (target && sameScope && isActive(target)) {
                     this.store.supersedeFact(target.id, written.id);
                 }
                 else {

package/dist/packages/core/src/roles.d.ts

@@ -1,18 +1,17 @@
 /**
  * The two decisions every reader used to make for itself, in one place.
  *
- * During the rebuild the `facts` table changes shape in a way that cannot be flipped at once:
- *   - `role` is a new closed field; old rows have none, and their role lives in the Chinese
- *     `type_name` label;
- *   - `status` moves from none/superseded to raw/candidate/active/retracted, but old rows keep
- *     their old values until the migration runs.
+ * `role` says what a fact is for; `status` says how far it has come. Both used to be read by
+ * matching Chinese type labels and status strings at each call site, which is how one filter
+ * ended up admitting retired facts after a rename.
  *
- * If each call site guessed, they would guess differently — the exact failure mode that made
- * "规则/画像/待修" both a type and a state. So: one decoder, used everywhere, written to accept
- * both vocabularies until the fallback is deleted in the contract step.
+ * This is the contract step: the dual-vocabulary fallback is gone. The migration normalises
+ * old rows (none/open/kept → active, broken/superseded → retracted) and the writer always
+ * stores a role, so a reader sees exactly one vocabulary.
  */
 import type { Fact } from './types.ts';
 import type { FactRole } from './types.ts';
-export declare function roleOf(fact: Pick<Fact, 'role' | 'typeName'>): FactRole;
+/** Rows written before the role column existed cannot appear after the migration. */
+export declare function roleOf(fact: Pick<Fact, 'role'>): FactRole;
 export declare function isActive(fact: Pick<Fact, 'status'>): boolean;
 export declare function isRetracted(fact: Pick<Fact, 'status'>): boolean;

package/dist/packages/core/src/roles.js

@@ -1,17 +1,11 @@
-import { FACT_STATE_MIGRATION, LEGACY_ROLE_BY_TYPE } from './config/domains.js';
 import { FACT_STATUS } from './config/status.js';
-const LEGACY_ROLES = LEGACY_ROLE_BY_TYPE;
-/** Old and new status values that mean "this is in use". */
-const ACTIVE_STATES = new Set(['active', 'none', 'kept', 'open']);
+/** Rows written before the role column existed cannot appear after the migration. */
 export function roleOf(fact) {
-    if (fact.role)
-        return fact.role;
-    return LEGACY_ROLES[fact.typeName ?? ''] ?? 'observation';
+    return fact.role ?? 'observation';
 }
 export function isActive(fact) {
-    return ACTIVE_STATES.has(String(fact.status));
+    return String(fact.status) === FACT_STATUS.active;
 }
 export function isRetracted(fact) {
-    const mapped = FACT_STATE_MIGRATION[String(fact.status)] ?? String(fact.status);
-    return mapped === 'retracted' || String(fact.status) === FACT_STATUS.superseded;
+    return String(fact.status) === FACT_STATUS.retracted;
 }

package/dist/packages/core/src/sqlite.d.ts

@@ -1,6 +1,6 @@
 import { DatabaseSync } from 'node:sqlite';
 import type { SoulStore } from './store.ts';
-export declare const SCHEMA_VERSION = 9;
+export declare const SCHEMA_VERSION = 10;
 export declare const AFFECT_RETENTION_MS: number;
 export declare class DbNewerThanBinaryError extends Error {
     readonly code = "DB_NEWER_THAN_BINARY";
@@ -13,6 +13,7 @@ export declare class DbNewerThanBinaryError extends Error {
  * old table stays as a read-only legacy copy.
  */
 /** v6 → v7: turn threads (a topic's turns need not be adjacent) plus turns.thread_id. */
+export declare function upgradeToV10(db: DatabaseSync): void;
 export declare function upgradeToV9(db: DatabaseSync): void;
 export declare function upgradeToV8(db: DatabaseSync): void;
 export declare function upgradeToV7(db: DatabaseSync): void;

package/dist/packages/core/src/sqlite.js

@@ -12,7 +12,7 @@ import { DEFAULT_EMOTION } from './types.js';
 import { FACT_STATUS, MEMORY_STATUS } from './config/status.js';
 import { LEGACY_ROLE_BY_TYPE } from './config/domains.js';
 import { bm25, buildCorpusStats, tokenize } from './scoring.js';
-export const SCHEMA_VERSION = 9;
+export const SCHEMA_VERSION = 10;
 /** How many recent pairs are considered before scoring. Bounded so recall stays O(candidates). */
 const RECALL_CANDIDATES = 500;
 export const AFFECT_RETENTION_MS = 30 * 24 * 60 * 60 * 1000;
@@ -175,7 +175,7 @@ CREATE TABLE IF NOT EXISTS facts (
   at_end         INTEGER,
   at_precision   TEXT NOT NULL DEFAULT 'unknown',
   place_id       TEXT,
-  status         TEXT NOT NULL DEFAULT 'none',
+  status         TEXT NOT NULL DEFAULT 'active',
   confidence     REAL NOT NULL DEFAULT 1,
   source         TEXT NOT NULL DEFAULT 'experienced',
   source_turn_id TEXT,
@@ -299,6 +299,12 @@ function upgradeToV3(db) {
  * old table stays as a read-only legacy copy.
  */
 /** v6 → v7: turn threads (a topic's turns need not be adjacent) plus turns.thread_id. */
+export function upgradeToV10(db) {
+    // The four-state vocabulary (config/status.ts). Everything written under the old names
+    // becomes one of the two states the code now reads; after this the fallbacks are gone.
+    db.exec("UPDATE facts SET status = 'active' WHERE status IN ('none','open','kept')");
+    db.exec("UPDATE facts SET status = 'retracted' WHERE status IN ('broken','superseded')");
+}
 export function upgradeToV9(db) {
     // Time became locatability (ADR 0032): a fact may be known to exist without a
     // date, and that is a value — unknown — not a reason to discard it.
@@ -442,8 +448,8 @@ export function openSqlite(file) {
                 upgradeToV7(db);
             if (version < 8)
                 upgradeToV8(db);
-            if (version < 9)
-                upgradeToV9(db);
+            if (version < 10)
+                upgradeToV10(db);
             // v6 adds tables only; SCHEMA creates them on every open, nothing to copy.
             setVersion(db, SCHEMA_VERSION);
             db.exec('COMMIT');
@@ -827,7 +833,7 @@ export function openSqlite(file) {
         },
         supersedeFact(oldId, newId) {
             withRetry(() => db
-                .prepare(`UPDATE facts SET status = '${FACT_STATUS.superseded}', superseded_by = ? WHERE id = ?`)
+                .prepare(`UPDATE facts SET status = '${FACT_STATUS.retracted}', superseded_by = ? WHERE id = ?`)
                 .run(newId, oldId));
         },
         /* ---------------- gaps ---------------- */
@@ -1083,7 +1089,7 @@ export function openSqlite(file) {
                 .prepare(`SELECT DISTINCT f.* FROM facts f
            JOIN fact_slots s ON s.fact_id = f.id AND s.value_type = 'entity'
            JOIN entities e ON e.id = s.entity_id
-           WHERE f.soul_id = ? AND f.user_id = ? AND f.status != '${FACT_STATUS.superseded}'
+           WHERE f.soul_id = ? AND f.user_id = ? AND f.status = '${FACT_STATUS.active}'
              AND (e.name = ? OR e.aliases LIKE ?)
              AND (? IS NULL OR f.statement LIKE ? OR COALESCE(f.type_name, '') LIKE ?)
            ORDER BY COALESCE(f.at, f.created_at) DESC

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "soulbridge",
-  "version": "0.0.100",
+  "version": "0.0.101",
   "description": "A personality layer for any agent: continuity, forgetting, and growth across tools.",
   "license": "Apache-2.0",
   "type": "module",