soulbridge 0.0.98 → 0.0.101

package/LICENSE

@@ -1,202 +1,202 @@
-
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright 2023 The Sigstore Authors
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2023 The Sigstore Authors
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

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.98",
+  "version": "0.0.101",
   "description": "A personality layer for any agent: continuity, forgetting, and growth across tools.",
   "license": "Apache-2.0",
   "type": "module",
@@ -52,7 +52,7 @@
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "npm run build && npm test",
     "sync:prompts": "node scripts/sync-prompts.mjs",
-    "prepare": "node scripts/install-hooks.mjs"
+    "setup": "node scripts/install-hooks.mjs"
   },
   "devDependencies": {
     "@types/node": "^26.6.5",

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

@@ -1,28 +0,0 @@
-/**
- * The profile dimension vocabulary, declared once.
- *
- * A dimension is a noun we ship to two model stages and to the merge parser: the
- * classifier decides which lens a lesson belongs to, the merge decides which lens a
- * line belongs to, and the parser rejects anything else. Those three must agree, so
- * the names AND their admission criteria live here and nowhere else — prompts render
- * this, they do not retype it.
- *
- * The definitions are borrowed from measurement traditions on purpose:
- * 价值观 ← Schwartz; 人际关系 ← interpersonal circumplex (warmth × dominance);
- * 生活兴趣 ← RIASEC; 情绪 ← core affect. 边界 has no taxonomy — it quotes the words.
- * These are admission criteria for a sentence, not a personality theory.
- */
-export declare const PROFILE_DIMENSIONS: readonly ['价值观', '工作方式', '沟通偏好', '情绪', '人际关系', '生活兴趣', '边界'];
-export type ProfileDimension = (typeof PROFILE_DIMENSIONS)[number];
-/** What counts as a line in each dimension, and what does not. */
-export declare const PROFILE_DIMENSION_DEFINITIONS: Record<ProfileDimension, string>;
-export declare function isProfileDimension(value: unknown): value is ProfileDimension;
-/**
- * Render the definitions block both prompts embed.
- *
- * Generated from the declaration above so a new dimension cannot be added to the
- * vocabulary without appearing in the prompt (and vice versa).
- */
-export declare function renderDimensionDefinitions(): string;
-/** The "维度=价值观|工作方式|…" line, generated rather than retyped. */
-export declare function dimensionChoices(): string;

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

@@ -1,53 +0,0 @@
-/**
- * The profile dimension vocabulary, declared once.
- *
- * A dimension is a noun we ship to two model stages and to the merge parser: the
- * classifier decides which lens a lesson belongs to, the merge decides which lens a
- * line belongs to, and the parser rejects anything else. Those three must agree, so
- * the names AND their admission criteria live here and nowhere else — prompts render
- * this, they do not retype it.
- *
- * The definitions are borrowed from measurement traditions on purpose:
- * 价值观 ← Schwartz; 人际关系 ← interpersonal circumplex (warmth × dominance);
- * 生活兴趣 ← RIASEC; 情绪 ← core affect. 边界 has no taxonomy — it quotes the words.
- * These are admission criteria for a sentence, not a personality theory.
- */
-export const PROFILE_DIMENSIONS = [
-    '价值观',
-    '工作方式',
-    '沟通偏好',
-    '情绪',
-    '人际关系',
-    '生活兴趣',
-    '边界',
-];
-/** What counts as a line in each dimension, and what does not. */
-export const PROFILE_DIMENSION_DEFINITIONS = {
-    价值观: '超越具体情境、值得追求的目标（Schwartz）。"想把事做对"算；"这个接口用 POST"不算。',
-    工作方式: '面对任务时的稳定做法。"先验证再动手"算；"这次改了 A 文件"不算。',
-    沟通偏好: '希望信息以什么形式、什么节奏出现。"整轮对话当整体"算。',
-    情绪: '对具体事件的感受与强度。"被反复确认会烦"算；"今天天气"不算。',
-    人际关系: '与特定人的位置和距离（温暖 × 支配）。"她最近压力大"算。',
-    生活兴趣: '自愿投入时间的事。"喜欢爬山"算。',
-    边界: '明确说过的"不要"。没有公认分类学，必须贴着原话，不许概括。',
-};
-export function isProfileDimension(value) {
-    return typeof value === 'string' && PROFILE_DIMENSIONS.includes(value);
-}
-/**
- * Render the definitions block both prompts embed.
- *
- * Generated from the declaration above so a new dimension cannot be added to the
- * vocabulary without appearing in the prompt (and vice versa).
- */
-export function renderDimensionDefinitions() {
-    const lines = PROFILE_DIMENSIONS.map((dimension) => `- ${dimension}：${PROFILE_DIMENSION_DEFINITIONS[dimension]}`);
-    return `<dimensions>
-每个维度是什么，决定什么算一条、什么不算：
-${lines.join('\n')}
-</dimensions>`;
-}
-/** The "维度=价值观|工作方式|…" line, generated rather than retyped. */
-export function dimensionChoices() {
-    return `维度=${PROFILE_DIMENSIONS.join('|')}`;
-}