nlm-memory 0.21.0 → 0.21.13

package/dist/ports/wiki-writer.d.ts

@@ -0,0 +1,19 @@
+/**
+ * WikiWriter — the projection's only IO seam.
+ *
+ * Core wiki modules never touch node:fs; they emit rendered strings and this
+ * port persists them. Tests substitute MemoryWikiWriter so the idempotence
+ * contract is verified without a disk.
+ *
+ * Paths are relative to a writer-owned root. An implementation must reject a
+ * path that escapes it.
+ */
+export interface WikiWriter {
+    write(relPath: string, content: string): Promise<void>;
+    /** Current content, or null when absent. Reconcile compares against this to
+     *  skip byte-identical files, which is what makes a repeat run free. */
+    read(relPath: string): Promise<string | null>;
+    remove(relPath: string): Promise<void>;
+    /** Markdown files currently present, relative paths, sentinel excluded. */
+    list(): Promise<ReadonlyArray<string>>;
+}

package/dist/ports/wiki-writer.js

@@ -0,0 +1,12 @@
+/**
+ * WikiWriter — the projection's only IO seam.
+ *
+ * Core wiki modules never touch node:fs; they emit rendered strings and this
+ * port persists them. Tests substitute MemoryWikiWriter so the idempotence
+ * contract is verified without a disk.
+ *
+ * Paths are relative to a writer-owned root. An implementation must reject a
+ * path that escapes it.
+ */
+export {};
+//# sourceMappingURL=wiki-writer.js.map

package/dist/ports/wiki-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-writer.js","sourceRoot":"","sources":["../../src/ports/wiki-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/ports/workstream-store.d.ts

@@ -1,21 +1,28 @@
 import type { Workstream } from "../core/workstream/model.js";
+/**
+ * Tenancy (program spec §4, M2 plan Wave B4): every method takes `tenantId`
+ * as its non-optional first parameter. `workstreams` and `workstream_entities`
+ * are both STAMP tables. Reads/mutations never cross tenants — merge,
+ * rebind, and candidatesByEntityOverlap all resolve and act within one
+ * tenant only.
+ */
 export interface WorkstreamStore {
-    create(input: {
+    create(tenantId: string, input: {
         id: string;
         label: string;
         scope: string | null;
     }): Promise<Workstream>;
-    getById(id: string): Promise<Workstream | null>;
-    findByNormalizedLabel(normalizedLabel: string): Promise<Workstream | null>;
-    listAll(): Promise<ReadonlyArray<Workstream>>;
-    touchLastSession(id: string, atIso: string): Promise<void>;
-    setLabel(id: string, label: string): Promise<void>;
-    setStatus(id: string, status: import("../core/workstream/model.js").WorkstreamStatus): Promise<void>;
-    /** Supersede fromId into intoId: set merged_into + status="merged", union entities, clear from's entity rows. */
-    merge(fromId: string, intoId: string): Promise<void>;
-    upsertEntities(workstreamId: string, entities: ReadonlyArray<string>): Promise<void>;
-    entitiesFor(workstreamIds: ReadonlyArray<string>): Promise<Map<string, string[]>>;
-    candidatesByEntityOverlap(entities: ReadonlyArray<string>, limit: number): Promise<ReadonlyArray<{
+    getById(tenantId: string, id: string): Promise<Workstream | null>;
+    findByNormalizedLabel(tenantId: string, normalizedLabel: string): Promise<Workstream | null>;
+    listAll(tenantId: string): Promise<ReadonlyArray<Workstream>>;
+    touchLastSession(tenantId: string, id: string, atIso: string): Promise<void>;
+    setLabel(tenantId: string, id: string, label: string): Promise<void>;
+    setStatus(tenantId: string, id: string, status: import("../core/workstream/model.js").WorkstreamStatus): Promise<void>;
+    /** Supersede fromId into intoId: set merged_into + status="merged", union entities, clear from's entity rows. Both ids must resolve within tenantId. */
+    merge(tenantId: string, fromId: string, intoId: string): Promise<void>;
+    upsertEntities(tenantId: string, workstreamId: string, entities: ReadonlyArray<string>): Promise<void>;
+    entitiesFor(tenantId: string, workstreamIds: ReadonlyArray<string>): Promise<Map<string, string[]>>;
+    candidatesByEntityOverlap(tenantId: string, entities: ReadonlyArray<string>, limit: number): Promise<ReadonlyArray<{
         workstreamId: string;
         entities: string[];
     }>>;

package/dist/shared/types.d.ts

@@ -118,6 +118,14 @@ export interface RecallQuery {
      * set this true to inject code examples into the pointer block.
      */
     readonly withRelatedExemplars?: boolean;
+    /**
+     * If true, RecallService attaches a `relatedConcepts` array of learner
+     * concept statuses for enrollments bound to the top hits' workstreams.
+     * Defaults to true for the HTTP hook caller; other callers opt in via
+     * `?withConcepts=true`. Disable globally via NLM_HOOK_INJECT_CONCEPTS=false.
+     * Spec 2026-10-06 (learner evidence).
+     */
+    readonly withRelatedConcepts?: boolean;
     /**
      * If true, superseded sessions are included in recall results, down-ranked
      * and carrying a `supersededBy` pointer to their successor. Replaced
@@ -181,6 +189,13 @@ export interface RecallResult {
      * alongside session pointers and facts.
      */
     readonly relatedExemplars?: ReadonlyArray<RelatedExemplar>;
+    /**
+     * Optional learner-concept rows for enrollments bound to the top hits'
+     * workstreams. Present only when the caller requested
+     * `withRelatedConcepts`. The pointer-block formatter renders these as a
+     * "Learning state" section. Spec 2026-10-06 (learner evidence).
+     */
+    readonly relatedConcepts?: ReadonlyArray<RelatedConcept>;
 }
 /**
  * Fact — a single normalized claim derived from a session.
@@ -268,6 +283,13 @@ export interface RelatedFact {
     readonly value: string;
     readonly corroborationCount: number;
 }
+export interface RelatedConcept {
+    readonly concept: string;
+    readonly status: "exposed" | "practicing" | "demonstrated" | "retained";
+    readonly attemptCount: number;
+    /** Owning enrollment's latest next_step (shared across its concepts). */
+    readonly nextStep: string | null;
+}
 export interface FactHistoryChain {
     readonly subject: string;
     readonly predicate: string;

package/dist/shared/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4SH;;2EAE2E;AAC3E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,CAA6C,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmUH;;2EAE2E;AAC3E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,CAA6C,CAAC"}

package/dist/shared/version.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The running build's own version, for stamping into telemetry.
+ *
+ * Exists so a hook can report which build actually executed. "The hook fired"
+ * and "the current hook fired" are different claims, and only the second one
+ * catches an install pointing at a stale `dist/` — see
+ * core/digest/hook-version-parity.ts.
+ */
+export declare const NLM_VERSION: string;

package/dist/shared/version.js

@@ -0,0 +1,11 @@
+/**
+ * The running build's own version, for stamping into telemetry.
+ *
+ * Exists so a hook can report which build actually executed. "The hook fired"
+ * and "the current hook fired" are different claims, and only the second one
+ * catches an install pointing at a stale `dist/` — see
+ * core/digest/hook-version-parity.ts.
+ */
+import pkg from "../../package.json" with { type: "json" };
+export const NLM_VERSION = pkg.version;
+//# sourceMappingURL=version.js.map

package/dist/shared/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/shared/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,GAAG,MAAM,oBAAoB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAE3D,MAAM,CAAC,MAAM,WAAW,GAAW,GAAG,CAAC,OAAO,CAAC"}