instar 0.28.83 → 0.28.84

package/dist/core/types.js

@@ -17,4 +17,12 @@ export const SOUL_SECTION_TRUST = {
     'core-values': 'collaborative',
     'growth-edge': 'collaborative',
 };
+/** Per-entity cap; overridable up to MAX_EVIDENCE_CAP_PER_ENTITY via config. */
+export const DEFAULT_EVIDENCE_CAP_PER_ENTITY = 50;
+/** Hard upper bound on per-entity evidence cap. */
+export const MAX_EVIDENCE_CAP_PER_ENTITY = 500;
+/** Hard cap on `note` field bytes. */
+export const MAX_EVIDENCE_NOTE_BYTES = 500;
+/** Bound for traversal of `kind:'supersedes-evidence'` chains. */
+export const MAX_SUPERSEDES_DEPTH = 32;
 //# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAg6BH;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA8C;IAC3E,cAAc,EAAE,UAAU;IAC1B,gBAAgB,EAAE,eAAe;IACjC,mBAAmB,EAAE,UAAU;IAC/B,aAAa,EAAE,eAAe;IAC9B,aAAa,EAAE,eAAe;IAC9B,aAAa,EAAE,eAAe;CAC/B,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAg6BH;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA8C;IAC3E,cAAc,EAAE,UAAU;IAC1B,gBAAgB,EAAE,eAAe;IACjC,mBAAmB,EAAE,UAAU;IAC/B,aAAa,EAAE,eAAe;IAC9B,aAAa,EAAE,eAAe;IAC9B,aAAa,EAAE,eAAe;CAC/B,CAAC;AA2vDF,gFAAgF;AAChF,MAAM,CAAC,MAAM,+BAA+B,GAAG,EAAE,CAAC;AAClD,mDAAmD;AACnD,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAC;AAC/C,sCAAsC;AACtC,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAC3C,kEAAkE;AAClE,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC"}

package/dist/memory/EvidenceRenderer.d.ts

@@ -0,0 +1,64 @@
+/**
+ * EvidenceRenderer — single privacy-enforcement helper for MemoryEntity
+ * evidence rendering.
+ *
+ * Per WikiClaim spec § Storage and Privacy (line 315) and § Risks line 356,
+ * "the renderer is the privacy-enforcement boundary, not the storage layer."
+ * The storage layer already filters at read time via `getEvidence` /
+ * `getEntityWithEvidence` / `findCitations`, but any downstream code path
+ * that touches an already-loaded `MemoryEntity.evidence` array must pipe
+ * through this helper instead of inlining the comparison — that way the
+ * filter rule lives in exactly ONE place and Phase 4 HTTP / dashboard /
+ * threadline render callsites can never accidentally leak.
+ *
+ * The helper enforces:
+ *   1. Entity-level visibility — if the entity's `privacyScope` exceeds the
+ *      viewer's scope, the entity itself is hidden (returns null).
+ *   2. Evidence-level visibility — each evidence row's `privacyTier` (or
+ *      `undefined`, which inherits the entity scope) is checked against
+ *      the viewer scope; restricted rows are dropped.
+ *
+ * Spec citations:
+ *   - § Storage and Privacy line 315: renderer is the enforcement boundary
+ *   - § Risks line 356: "render every privacyScope × privacyTier
+ *     combination" cross-product test asserts no leak
+ *   - § Storage and Privacy line 316: inverse-query privacy filter
+ */
+import type { MemoryEntity, MemoryEvidence, EvidencePrivacyTier, PrivacyScopeType } from '../core/types.js';
+/** True iff entity at `itemScope` is visible to a viewer at `viewerScope`. */
+export declare function isEntityVisibleAtScope(itemScope: PrivacyScopeType | undefined, viewerScope: PrivacyScopeType): boolean;
+/**
+ * True iff an evidence row tagged `evidenceTier` is visible to `viewerScope`.
+ * `undefined` evidenceTier inherits the entity's scope — by the time this
+ * helper is called the entity-level filter has already accepted the entity,
+ * so undefined tiers pass through. (Mirrors SemanticMemory's `getEvidence`
+ * read-time filter.)
+ */
+export declare function isEvidenceVisibleAtScope(evidenceTier: EvidencePrivacyTier | undefined, viewerScope: PrivacyScopeType): boolean;
+/**
+ * Filter an entity for a viewer. Returns:
+ *  - `null` if the entity's own `privacyScope` is wider than the viewer's
+ *    scope (entity itself is hidden).
+ *  - A shallow clone with `evidence` filtered to only rows visible at the
+ *    viewer's scope. The `evidence` field is preserved as `[]` if all rows
+ *    are filtered out and as `undefined` if the input didn't have one
+ *    loaded (matches the lazy-load contract in MemoryEntity).
+ *
+ * SAFETY: never mutates the input entity. Callers can pass the same entity
+ * to multiple viewers without cross-contamination.
+ */
+export declare function renderEvidenceForScope(entity: MemoryEntity, viewerScope: PrivacyScopeType): (MemoryEntity & {
+    evidence?: MemoryEvidence[];
+}) | null;
+/**
+ * Filter a bare evidence array for a viewer scope. Used when the consumer
+ * has evidence in hand without the parent entity (e.g., a separate evidence
+ * panel that received a pre-loaded array).
+ *
+ * NOTE: this skips the entity-level visibility check. Use `renderEvidenceForScope`
+ * whenever the entity is available. This helper exists for the narrow
+ * `findCitations`-derived flow where the entity was already filtered and
+ * only its evidence array is being trimmed.
+ */
+export declare function filterEvidenceArrayForScope(evidence: readonly MemoryEvidence[], viewerScope: PrivacyScopeType): MemoryEvidence[];
+//# sourceMappingURL=EvidenceRenderer.d.ts.map

package/dist/memory/EvidenceRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EvidenceRenderer.d.ts","sourceRoot":"","sources":["../../src/memory/EvidenceRenderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AA4C1B,8EAA8E;AAC9E,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,gBAAgB,GAAG,SAAS,EACvC,WAAW,EAAE,gBAAgB,GAC5B,OAAO,CAGT;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,mBAAmB,GAAG,SAAS,EAC7C,WAAW,EAAE,gBAAgB,GAC5B,OAAO,CAGT;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,YAAY,EACpB,WAAW,EAAE,gBAAgB,GAC5B,CAAC,YAAY,GAAG;IAAE,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAA;CAAE,CAAC,GAAG,IAAI,CAYzD;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,SAAS,cAAc,EAAE,EACnC,WAAW,EAAE,gBAAgB,GAC5B,cAAc,EAAE,CAElB"}

package/dist/memory/EvidenceRenderer.js

@@ -0,0 +1,119 @@
+/**
+ * EvidenceRenderer — single privacy-enforcement helper for MemoryEntity
+ * evidence rendering.
+ *
+ * Per WikiClaim spec § Storage and Privacy (line 315) and § Risks line 356,
+ * "the renderer is the privacy-enforcement boundary, not the storage layer."
+ * The storage layer already filters at read time via `getEvidence` /
+ * `getEntityWithEvidence` / `findCitations`, but any downstream code path
+ * that touches an already-loaded `MemoryEntity.evidence` array must pipe
+ * through this helper instead of inlining the comparison — that way the
+ * filter rule lives in exactly ONE place and Phase 4 HTTP / dashboard /
+ * threadline render callsites can never accidentally leak.
+ *
+ * The helper enforces:
+ *   1. Entity-level visibility — if the entity's `privacyScope` exceeds the
+ *      viewer's scope, the entity itself is hidden (returns null).
+ *   2. Evidence-level visibility — each evidence row's `privacyTier` (or
+ *      `undefined`, which inherits the entity scope) is checked against
+ *      the viewer scope; restricted rows are dropped.
+ *
+ * Spec citations:
+ *   - § Storage and Privacy line 315: renderer is the enforcement boundary
+ *   - § Risks line 356: "render every privacyScope × privacyTier
+ *     combination" cross-product test asserts no leak
+ *   - § Storage and Privacy line 316: inverse-query privacy filter
+ */
+/**
+ * Entity-level privacy ordering. `private` > `shared-topic` > `shared-project`.
+ * A viewer at higher tier sees their tier and everything below.
+ *
+ * Mirrors `ENTITY_SCOPE_ORDER` in SemanticMemory.ts — kept colocated rather
+ * than imported to keep the renderer side-effect-free and avoid pulling
+ * better-sqlite3 into render contexts that don't need it (e.g., HTTP
+ * response shapers).
+ */
+const ENTITY_SCOPE_ORDER = {
+    'shared-project': 0,
+    'shared-topic': 1,
+    'private': 2,
+};
+/**
+ * Evidence-level privacy ordering. Wider vocabulary than entity scope:
+ * adds `public` (more permissive than shared-project) and `sensitive`
+ * (more restrictive than private). Per spec § Schema Changes line 136.
+ */
+const EVIDENCE_TIER_ORDER = {
+    'public': 0,
+    'shared-project': 1,
+    'private': 2,
+    'sensitive': 3,
+};
+/** Map an entity-vocabulary scope onto the evidence-tier scale. */
+function entityScopeToTierOrdinal(scope) {
+    switch (scope) {
+        case 'shared-project':
+            return EVIDENCE_TIER_ORDER['shared-project'];
+        case 'shared-topic':
+            // Conservative-map: 'shared-topic' is absent from the evidence
+            // vocabulary; treat it like 'private' so wider tiers cannot be
+            // attached to topic-scope entities.
+            return EVIDENCE_TIER_ORDER['private'];
+        case 'private':
+            return EVIDENCE_TIER_ORDER['private'];
+    }
+}
+/** True iff entity at `itemScope` is visible to a viewer at `viewerScope`. */
+export function isEntityVisibleAtScope(itemScope, viewerScope) {
+    const item = itemScope ?? 'shared-project';
+    return ENTITY_SCOPE_ORDER[viewerScope] >= ENTITY_SCOPE_ORDER[item];
+}
+/**
+ * True iff an evidence row tagged `evidenceTier` is visible to `viewerScope`.
+ * `undefined` evidenceTier inherits the entity's scope — by the time this
+ * helper is called the entity-level filter has already accepted the entity,
+ * so undefined tiers pass through. (Mirrors SemanticMemory's `getEvidence`
+ * read-time filter.)
+ */
+export function isEvidenceVisibleAtScope(evidenceTier, viewerScope) {
+    if (evidenceTier === undefined)
+        return true;
+    return entityScopeToTierOrdinal(viewerScope) >= EVIDENCE_TIER_ORDER[evidenceTier];
+}
+/**
+ * Filter an entity for a viewer. Returns:
+ *  - `null` if the entity's own `privacyScope` is wider than the viewer's
+ *    scope (entity itself is hidden).
+ *  - A shallow clone with `evidence` filtered to only rows visible at the
+ *    viewer's scope. The `evidence` field is preserved as `[]` if all rows
+ *    are filtered out and as `undefined` if the input didn't have one
+ *    loaded (matches the lazy-load contract in MemoryEntity).
+ *
+ * SAFETY: never mutates the input entity. Callers can pass the same entity
+ * to multiple viewers without cross-contamination.
+ */
+export function renderEvidenceForScope(entity, viewerScope) {
+    if (!isEntityVisibleAtScope(entity.privacyScope, viewerScope)) {
+        return null;
+    }
+    if (entity.evidence === undefined) {
+        // Lazy: caller didn't load evidence; pass through unchanged.
+        return { ...entity };
+    }
+    const filtered = entity.evidence.filter((ev) => isEvidenceVisibleAtScope(ev.privacyTier, viewerScope));
+    return { ...entity, evidence: filtered };
+}
+/**
+ * Filter a bare evidence array for a viewer scope. Used when the consumer
+ * has evidence in hand without the parent entity (e.g., a separate evidence
+ * panel that received a pre-loaded array).
+ *
+ * NOTE: this skips the entity-level visibility check. Use `renderEvidenceForScope`
+ * whenever the entity is available. This helper exists for the narrow
+ * `findCitations`-derived flow where the entity was already filtered and
+ * only its evidence array is being trimmed.
+ */
+export function filterEvidenceArrayForScope(evidence, viewerScope) {
+    return evidence.filter((ev) => isEvidenceVisibleAtScope(ev.privacyTier, viewerScope));
+}
+//# sourceMappingURL=EvidenceRenderer.js.map

package/dist/memory/EvidenceRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EvidenceRenderer.js","sourceRoot":"","sources":["../../src/memory/EvidenceRenderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AASH;;;;;;;;GAQG;AACH,MAAM,kBAAkB,GAAqC;IAC3D,gBAAgB,EAAE,CAAC;IACnB,cAAc,EAAE,CAAC;IACjB,SAAS,EAAE,CAAC;CACb,CAAC;AAEF;;;;GAIG;AACH,MAAM,mBAAmB,GAAwC;IAC/D,QAAQ,EAAE,CAAC;IACX,gBAAgB,EAAE,CAAC;IACnB,SAAS,EAAE,CAAC;IACZ,WAAW,EAAE,CAAC;CACf,CAAC;AAEF,mEAAmE;AACnE,SAAS,wBAAwB,CAAC,KAAuB;IACvD,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,gBAAgB;YACnB,OAAO,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;QAC/C,KAAK,cAAc;YACjB,+DAA+D;YAC/D,+DAA+D;YAC/D,oCAAoC;YACpC,OAAO,mBAAmB,CAAC,SAAS,CAAC,CAAC;QACxC,KAAK,SAAS;YACZ,OAAO,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,sBAAsB,CACpC,SAAuC,EACvC,WAA6B;IAE7B,MAAM,IAAI,GAAG,SAAS,IAAI,gBAAgB,CAAC;IAC3C,OAAO,kBAAkB,CAAC,WAAW,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;AACrE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,YAA6C,EAC7C,WAA6B;IAE7B,IAAI,YAAY,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5C,OAAO,wBAAwB,CAAC,WAAW,CAAC,IAAI,mBAAmB,CAAC,YAAY,CAAC,CAAC;AACpF,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAoB,EACpB,WAA6B;IAE7B,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,YAAY,EAAE,WAAW,CAAC,EAAE,CAAC;QAC9D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAClC,6DAA6D;QAC7D,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC;IACvB,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAC7C,wBAAwB,CAAC,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC,CACtD,CAAC;IACF,OAAO,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAC3C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,2BAA2B,CACzC,QAAmC,EACnC,WAA6B;IAE7B,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,wBAAwB,CAAC,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;AACxF,CAAC"}

package/dist/memory/SemanticMemory.d.ts

@@ -17,7 +17,7 @@
  *
  * Uses the same better-sqlite3 pattern as MemoryIndex and TopicMemory.
  */
-import type { MemoryEntity, MemoryEdge, ScoredEntity, ConnectedEntity, DecayReport, ImportReport, SemanticMemoryStats, SemanticMemoryConfig, SemanticSearchOptions, ExploreOptions, EntityType, RelationType } from '../core/types.js';
+import type { MemoryEntity, MemoryEdge, ScoredEntity, ConnectedEntity, DecayReport, ImportReport, SemanticMemoryStats, SemanticMemoryConfig, SemanticSearchOptions, ExploreOptions, EntityType, RelationType, MemoryEvidence, MemoryEvidenceKind, EvidenceProducerId } from '../core/types.js';
 import type { PrivacyScopeType } from '../core/types.js';
 import type { EmbeddingProvider } from './EmbeddingProvider.js';
 export declare class SemanticMemory {
@@ -29,6 +29,12 @@ export declare class SemanticMemory {
     private jsonlPath;
     /** Set after corruption auto-recovery — caller should reimport from JSONL */
     private _needsRebuild;
+    /** When true, `remember()` skips its own JSONL append (the wrapping
+     *  `rememberWithEvidence` will emit a consolidated action instead). */
+    private _suppressRememberJournal;
+    /** Last full entity payload captured by `remember()` — read by
+     *  `rememberWithEvidence` to build a full-fidelity JSONL action. */
+    private _lastRememberedEntity;
     constructor(config: SemanticMemoryConfig);
     /**
      * Whether hybrid vector search is active (sqlite-vec loaded + embeddings table created).
@@ -124,6 +130,57 @@ export declare class SemanticMemory {
      * Delete an entity and all its edges.
      */
     forget(id: string, _reason?: string): void;
+    /**
+     * Atomic create-with-evidence. Equivalent to `remember()` followed by
+     * `addEvidence()`, but in one better-sqlite3 transaction so a producer
+     * crash mid-call cannot leave an orphan entity.
+     */
+    rememberWithEvidence(input: Parameters<typeof this.remember>[0], evidence: MemoryEvidence[], producer: EvidenceProducerId): string;
+    /**
+     * Append one or more evidence entries to an existing entity. When called
+     * with an array, all rows are inserted inside a single better-sqlite3
+     * transaction so a partial-write crash cannot leave half the rows landed.
+     */
+    addEvidence(entityId: string, evidence: MemoryEvidence | MemoryEvidence[], producer: EvidenceProducerId): void;
+    /**
+     * Read evidence for an entity, filtered by viewer scope. Producers may
+     * have written `privacyTier` more restrictive than the entity's own
+     * `privacyScope`; we filter at read time so the renderer is the single
+     * privacy-enforcement point.
+     */
+    getEvidence(entityId: string, viewerScope: PrivacyScopeType): MemoryEvidence[];
+    /**
+     * Inverse query: which entities cite this `(kind, sourceId)`? Filtered by
+     * BOTH the entity's own privacyScope AND the citing evidence row's
+     * privacyTier — per spec § Storage and Privacy line 316, no leak via
+     * inverse query at any (viewerScope × evidence tier × entity scope)
+     * combination.
+     */
+    findCitations(ref: {
+        kind: MemoryEvidenceKind;
+        sourceId: string;
+    }, viewerScope: PrivacyScopeType): MemoryEntity[];
+    /**
+     * Eager variant of `recall()` (without `connections`). Returns the entity
+     * with its evidence array attached, viewer-scope filtered.
+     */
+    getEntityWithEvidence(entityId: string, viewerScope: PrivacyScopeType): (MemoryEntity & {
+        evidence: MemoryEvidence[];
+    }) | null;
+    private evidenceCapPerEntity;
+    private assertProducerKindsAllowed;
+    private insertEvidenceRows;
+    private assertEvidenceShape;
+    /**
+     * Bounded defenses for `kind:'supersedes-evidence'`:
+     * 1. The supersedes-evidence row's `sourceId` MUST NOT equal the entity's
+     *    own id — that's a self-loop with no useful semantics.
+     * 2. The total count of supersedes-evidence rows on this entity MUST stay
+     *    under MAX_SUPERSEDES_DEPTH. This bounds chain length without
+     *    requiring a parent-pointer column (the spec leaves the chain shape
+     *    underspecified; bounding count is the conservative defense).
+     */
+    private assertSupersedesAcyclic;
     /**
      * Get all entities owned by a specific user.
      * Used for GDPR data export (/mydata).
@@ -261,4 +318,7 @@ export declare class SemanticMemory {
     }): string;
     private getConnections;
 }
+export declare class EvidencePolicyError extends Error {
+    constructor(message: string);
+}
 //# sourceMappingURL=SemanticMemory.d.ts.map

package/dist/memory/SemanticMemory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SemanticMemory.d.ts","sourceRoot":"","sources":["../../src/memory/SemanticMemory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SemanticMemory.d.ts","sourceRoot":"","sources":["../../src/memory/SemanticMemory.ts"],"names":[],"mappings":"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"}