soulbridge 0.0.104 → 0.0.106

package/dist/packages/cli/src/cli.js

@@ -427,6 +427,41 @@ async function main() {
             out({ db: dbPath, ...soul.stats() });
             return;
         }
+        case 'why': {
+            // The reader for the 依据 slot: a fact I said must be traceable to the turn I said it
+            // in, and a conclusion must be traceable to the facts that support it.
+            const factId = positional[0];
+            if (!factId)
+                throw new Error('usage: soulbridge why <factId>');
+            const { soul } = open(flags);
+            const fact = soul.store.fact(factId);
+            if (!fact) {
+                out({ ok: false, error: `no fact ${factId}` });
+                return;
+            }
+            const basisSlot = fact.slots.find((slot) => slot.slot === '依据' && slot.value.kind === 'text');
+            const turn = basisSlot?.value.kind === 'text' ? soul.store.turn(basisSlot.value.value) : null;
+            out({
+                id: fact.id,
+                statement: fact.statement,
+                role: fact.role,
+                status: fact.status,
+                source: fact.source,
+                basis: turn
+                    ? {
+                        turnId: turn.id,
+                        at: new Date(turn.at).toISOString(),
+                        userText: turn.userText,
+                        assistantText: turn.assistantText.slice(0, 200),
+                    }
+                    : null,
+                evidence: fact.slots
+                    .filter((slot) => slot.slot === '证据' && slot.value.kind === 'fact')
+                    .map((slot) => (slot.value.kind === 'fact' ? slot.value.factId : undefined))
+                    .filter(Boolean),
+            });
+            return;
+        }
         case 'demo':
             await demo();
             return;
@@ -444,6 +479,7 @@ async function main() {
                 '  reflect --text|--file           会话反思',
                 '  export --out <file>             导出 JSONL',
                 '  export --dir <directory>        导出可携带档案（archive/summary/injection）',
+                '  why <factId>                    这条事实的依据：来源轮次 / 证据',
                 '  import --in <file>              导入 JSONL',
                 '  import --from <steering.md>     导入 AGENTS.md / CLAUDE.md',
                 '  ingest --file <transcript.jsonl> 会话转写 → 记忆与情绪采样',

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

@@ -20,3 +20,17 @@ export declare const CONCLUSION_TYPE = "\u7ED3\u8BBA";
  * readers; retyping it in a second filter is how a layer silently drops out.
  */
 export declare const ANCHOR_TYPES: readonly string[];
+/**
+ * How a fact that came from my own reply is marked in injection (ADR 0035).
+ *
+ * Two renderers write fact lines — the core's `<memories>` block and the plugin's `<about>`
+ * block — and both must use the same marker, or the same fact reads differently depending on
+ * which path surfaced it. Declared here, imported by both.
+ */
+export declare const INFERRED_MARKER = "\u6211: ";
+/**
+ * One explanation per block, not one per line.
+ *
+ * 341 of 646 facts are inferred, so a sentence on every line would double the injection.
+ */
+export declare const SOURCE_NOTES = "<source-notes>\u4EE5\u300C\u6211:\u300D\u5F00\u5934\u7684\u662F\u6211\u4E0A\u4E00\u8F6E\u8BF4\u7684\u8BDD\uFF0C\u672A\u7ECF\u7528\u6237\u786E\u8BA4\uFF1B\u6CA1\u6807\u7684\u90FD\u662F\u7528\u6237\u8BF4\u7684\u3002</source-notes>";

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

@@ -19,3 +19,17 @@ export const CONCLUSION_TYPE = '结论';
  * readers; retyping it in a second filter is how a layer silently drops out.
  */
 export const ANCHOR_TYPES = ['结论', '教训', '原则', '性格'];
+/**
+ * How a fact that came from my own reply is marked in injection (ADR 0035).
+ *
+ * Two renderers write fact lines — the core's `<memories>` block and the plugin's `<about>`
+ * block — and both must use the same marker, or the same fact reads differently depending on
+ * which path surfaced it. Declared here, imported by both.
+ */
+export const INFERRED_MARKER = '我: ';
+/**
+ * One explanation per block, not one per line.
+ *
+ * 341 of 646 facts are inferred, so a sentence on every line would double the injection.
+ */
+export const SOURCE_NOTES = '<source-notes>以「我:」开头的是我上一轮说的话，未经用户确认；没标的都是用户说的。</source-notes>';

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

@@ -1,5 +1,5 @@
 import { FACT_STATUS } from './config/status.js';
-import { ANCHOR_TYPES } from './config/labels.js';
+import { ANCHOR_TYPES, INFERRED_MARKER, SOURCE_NOTES } from './config/labels.js';
 import { isActive, roleOf } from './roles.js';
 import { escapeAttr, escapeBlockText } from './inject-text.js';
 import { selectDirectives } from './affect/directives.js';
@@ -78,13 +78,22 @@ export function buildContext(store, request, now = Date.now()) {
         .facts({ soulId: request.soulId, userId: request.userId, limit: 300 })
         .filter((fact) => isActive(fact) &&
         (ANCHOR_ROLES.has(roleOf(fact)) || anchorTypes.has(fact.typeName ?? '') || explicitAnchor(fact)))
-        .map((fact) => ({ id: fact.id, label: fact.typeName ?? '事实', text: fact.statement, score: fact.confidence }));
+        .map((fact) => ({
+        id: fact.id,
+        label: fact.typeName ?? '事实',
+        text: fact.statement,
+        score: fact.confidence,
+        // ADR 0035: my own side of the exchange is inferred and must not read like something
+        // the user said. The marker is two characters; a per-line sentence would double the
+        // injection, so the explanation is written once below the block.
+        inferred: fact.source === 'inferred',
+    }));
     for (const memory of store.query({ soulId: request.soulId, userId: request.userId })) {
         if (request.types !== undefined && !request.types.includes(memory.type))
             continue;
         if (request.minImportance !== undefined && memory.importance < request.minImportance)
             continue;
-        anchors.push({ id: memory.id, label: memory.type, text: memory.content, score: memory.importance / 10 });
+        anchors.push({ id: memory.id, label: memory.type, text: memory.content, score: memory.importance / 10, inferred: false });
     }
     anchors.sort((a, b) => b.score - a.score);
     const maxItems = request.maxItems ?? Number.POSITIVE_INFINITY;
@@ -92,6 +101,7 @@ export function buildContext(store, request, now = Date.now()) {
     let dropped = 0;
     const lines = [];
     const used = [];
+    let sawInferred = false;
     for (const anchor of anchors) {
         if (lines.length >= maxItems) {
             dropped += 1;
@@ -99,7 +109,10 @@ export function buildContext(store, request, now = Date.now()) {
         }
         // Escaping can lengthen a line (one `&lt;` is four characters), so cost is charged
         // on the escaped text — the budget has to measure what actually gets injected.
-        const line = `- [${escapeBlockText(anchor.label)}] ${escapeBlockText(anchor.text)}`;
+        const marker = anchor.inferred ? INFERRED_MARKER : '';
+        const line = `- ${marker}[${escapeBlockText(anchor.label)}] ${escapeBlockText(anchor.text)}`;
+        if (anchor.inferred)
+            sawInferred = true;
         const cost = line.length + 1 + 10; // line + newline + section overhead share
         if (chars + cost > maxChars) {
             dropped += 1;
@@ -111,6 +124,8 @@ export function buildContext(store, request, now = Date.now()) {
     }
     if (request.includeAnchors !== false && lines.length > 0)
         sections.push(`<memories>\n${lines.join('\n')}\n</memories>`);
+    if (sawInferred)
+        sections.push(SOURCE_NOTES);
     const text = sections.join('\n\n');
     if (request.track !== false && used.length > 0)
         store.touch(used, now);

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

@@ -8,6 +8,7 @@ export * from './types.ts';
 export type { SoulStore } from './store.ts';
 export { openSqlite, SCHEMA_VERSION, AFFECT_RETENTION_MS, DbNewerThanBinaryError } from './sqlite.ts';
 export { buildContext, styleDirectives, DEFAULT_MAX_CHARS, AFFECT_BUDGET, AFFECT_WINDOW_MS, } from './context.ts';
+export { INFERRED_MARKER, SOURCE_NOTES } from './config/labels.ts';
 export { reflect, ruleExtract, nextEmotion, isCorrection, correctionRule, detectCorrection, isQuestion, } from './reflect.ts';
 export type { CorrectionLayer, CorrectionSignal, CorrectionVerdict } from './reflect.ts';
 export { rank, scoreMemory, tokenize, relevance, bm25, buildCorpusStats } from './scoring.ts';

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

@@ -7,6 +7,7 @@
 export * from './types.js';
 export { openSqlite, SCHEMA_VERSION, AFFECT_RETENTION_MS, DbNewerThanBinaryError } from './sqlite.js';
 export { buildContext, styleDirectives, DEFAULT_MAX_CHARS, AFFECT_BUDGET, AFFECT_WINDOW_MS, } from './context.js';
+export { INFERRED_MARKER, SOURCE_NOTES } from './config/labels.js';
 export { reflect, ruleExtract, nextEmotion, isCorrection, correctionRule, detectCorrection, isQuestion, } from './reflect.js';
 export { rank, scoreMemory, tokenize, relevance, bm25, buildCorpusStats } from './scoring.js';
 export { parseThreadLine } from './extract.js';

package/package.json

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