@pyxmate/memory 0.17.6 → 0.18.0

package/dist/{chunk-PUDKYGQI.mjs → chunk-B7HQUO7I.mjs}

@@ -1,6 +1,6 @@
 import {
   MemoryClient
-} from "./chunk-55E3V44T.mjs";
+} from "./chunk-EBBULSES.mjs";
 
 // ../dashboard/src/aggregations/consolidation-analytics.ts
 function analyzeConsolidationLog(entries) {

package/dist/{chunk-55E3V44T.mjs → chunk-EBBULSES.mjs}

@@ -513,6 +513,10 @@ var MemoryClient = class {
       throw error;
     }
   }
+  async lint(options) {
+    const qs = options?.limit ? `?limit=${encodeURIComponent(String(options.limit))}` : "";
+    return this.fetchApi(`/api/memory/lint${qs}`, { method: "GET" });
+  }
   async runDecay() {
     const result = await this.fetchApi("/api/memory/decay", {
       method: "POST"

package/dist/dashboard.mjs

@@ -11,8 +11,8 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-PUDKYGQI.mjs";
-import "./chunk-55E3V44T.mjs";
+} from "./chunk-B7HQUO7I.mjs";
+import "./chunk-EBBULSES.mjs";
 export {
   DashboardClient,
   Poller,

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { StoreInput as StoreInput$1, MemoryEntry as MemoryEntry$1, MemorySearchParams as MemorySearchParams$1, MemorySearchResult as MemorySearchResult$1, MemoryType as MemoryType$1, PrincipalContext as PrincipalContext$1, MemoryStats as MemoryStats$1, ExtractedImageMeta as ExtractedImageMeta$1, IngestEntity as IngestEntity$1, IngestRelationship as IngestRelationship$1, IngestEvent as IngestEvent$1, GraphNode as GraphNode$1, GraphTraversalResult as GraphTraversalResult$1 } from '@pyx-memory/shared';
+import { StoreInput as StoreInput$1, MemoryEntry as MemoryEntry$1, MemorySearchParams as MemorySearchParams$1, MemorySearchResult as MemorySearchResult$1, MemoryType as MemoryType$1, PrincipalContext as PrincipalContext$1, MemoryStats as MemoryStats$1, WikiLintReport as WikiLintReport$1, ExtractedImageMeta as ExtractedImageMeta$1, IngestEntity as IngestEntity$1, IngestRelationship as IngestRelationship$1, IngestEvent as IngestEvent$1, GraphNode as GraphNode$1, GraphTraversalResult as GraphTraversalResult$1 } from '@pyx-memory/shared';
 
 /** Parameters for paginated entry listing. */
 interface MemoryListParams {
@@ -78,6 +78,14 @@ interface ExtendedMemoryInterface extends MemoryInterface {
     forget(id: string, reason?: string): Promise<boolean>;
     /** Summarize a session's memories into a long-term entry. */
     summarizeSession(sessionId: string): Promise<MemoryEntry$1 | null>;
+    /**
+     * Read-only memory-wide lint report (v0.18.0 Karpathy-wiki Item B):
+     * orphans, decay candidates, stale entries, dedup candidates. Pure
+     * projection — no writes.
+     */
+    lint(options?: {
+        limit?: number;
+    }): Promise<WikiLintReport$1>;
     /** Run decay on all entries, archiving those below threshold. */
     runDecay(): Promise<number>;
     /** Reindex the FTS5 full-text search index. */
@@ -245,6 +253,9 @@ declare class MemoryClient implements ExtendedMemoryInterface {
     consolidate(): Promise<ConsolidationRunResult>;
     forget(id: string, reason?: string): Promise<boolean>;
     summarizeSession(sessionId: string): Promise<MemoryEntry$1 | null>;
+    lint(options?: {
+        limit?: number;
+    }): Promise<WikiLintReport$1>;
     runDecay(): Promise<number>;
     reindex(): Promise<void>;
     clearGraph(): Promise<number>;
@@ -579,6 +590,24 @@ interface GraphTraversalResult {
         relationshipIds: string[];
     }>;
 }
+/**
+ * Memory.lint() report shape — Karpathy-wiki Item B (v0.18.0).
+ * Read-only projection composed from signals every owning module
+ * already exposes. Lives in shared so the HTTP client can hold the
+ * same type as core without re-declaring it.
+ */
+interface WikiLintReport {
+    orphans: GraphNode[];
+    decayCandidates: MemoryEntry[];
+    staleSyntheses: Array<{
+        entry: MemoryEntry;
+        reason: string;
+    }>;
+    dedupCandidates: Array<{
+        hash: string;
+        entryIds: string[];
+    }>;
+}
 
 /** Metadata for a single image extracted from a PDF. */
 interface ExtractedImageMeta {
@@ -845,4 +874,4 @@ interface PrincipalContext {
 /** Sentinel tenant ID used in single-tenant deployments. */
 declare const SINGLE_TENANT_ID = "_single";
 
-export { type AgentId, type ApiResponse, type ConsolidationRunResult, DEFAULTS, EmbeddingProviderName, type EnrichmentCallbacks, type ExtendedMemoryInterface, type GraphFailureMode, type GraphNode, type GraphRelationship, type GraphTraversalResult, type IngestEntity, type IngestErrorEvent, type IngestEvent, type IngestFileOptions, type IngestHeartbeatEvent, type IngestProgressEvent, type IngestRelationship, type IngestResultEvent, type IngestStage, type IngestionResult, MemoryClient, type MemoryClientOptions, type MemoryEntry, type MemoryIngestRequest, type MemoryInterface, type MemoryListParams, type MemoryListResult, type MemorySearchParams, type MemorySearchResult, MemoryServerError, type MemoryStats, MemoryType, type MoveEntriesFilter, MoveFailureReason, type MoveResult, type MoveTarget, NamespaceIsolation, type PrincipalContext, RAGStrategy, SINGLE_TENANT_ID, SensitivityLevel, type StoreInput, StoreTarget, type TemporalQueryFilters, type TenantScopeOptions, type Timestamp, VectorProvider };
+export { type AgentId, type ApiResponse, type ConsolidationRunResult, DEFAULTS, EmbeddingProviderName, type EnrichmentCallbacks, type ExtendedMemoryInterface, type GraphFailureMode, type GraphNode, type GraphRelationship, type GraphTraversalResult, type IngestEntity, type IngestErrorEvent, type IngestEvent, type IngestFileOptions, type IngestHeartbeatEvent, type IngestProgressEvent, type IngestRelationship, type IngestResultEvent, type IngestStage, type IngestionResult, MemoryClient, type MemoryClientOptions, type MemoryEntry, type MemoryIngestRequest, type MemoryInterface, type MemoryListParams, type MemoryListResult, type MemorySearchParams, type MemorySearchResult, MemoryServerError, type MemoryStats, MemoryType, type MoveEntriesFilter, MoveFailureReason, type MoveResult, type MoveTarget, NamespaceIsolation, type PrincipalContext, RAGStrategy, SINGLE_TENANT_ID, SensitivityLevel, type StoreInput, StoreTarget, type TemporalQueryFilters, type TenantScopeOptions, type Timestamp, VectorProvider, type WikiLintReport };

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import {
   MemoryClient,
   MemoryServerError
-} from "./chunk-55E3V44T.mjs";
+} from "./chunk-EBBULSES.mjs";
 
 // ../shared/src/constants/defaults.ts
 var DEFAULTS = {

package/dist/react.mjs

@@ -11,8 +11,8 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-PUDKYGQI.mjs";
-import "./chunk-55E3V44T.mjs";
+} from "./chunk-B7HQUO7I.mjs";
+import "./chunk-EBBULSES.mjs";
 
 // ../dashboard/src/hooks/use-consolidation-log.ts
 import { useCallback as useCallback2, useMemo } from "react";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pyxmate/memory",
-  "version": "0.17.6",
+  "version": "0.18.0",
   "type": "module",
   "description": "SDK for pyx-memory — Memory as a Service for AI agents",
   "license": "MIT",