nlm-memory 0.20.1 → 0.21.12

package/dist/ports/spawn-child.js

@@ -0,0 +1,10 @@
+/**
+ * ChildHandle/SpawnChild — injected child-process port for job supervision.
+ *
+ * Real adapter (daemon composition root) wraps child_process.spawn with a
+ * line-buffered stdout/stderr reader; tests substitute a fake that lets
+ * them drive onLine/onExit directly, no real child_process involved.
+ * First consumer: core/jobs/job-supervisor.ts.
+ */
+export {};
+//# sourceMappingURL=spawn-child.js.map

package/dist/ports/spawn-child.js.map

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

package/dist/ports/storage.d.ts

@@ -9,11 +9,13 @@
 import type { CodeExemplarStore } from "./code-exemplar-store.js";
 import type { EntityStore } from "./entity-store.js";
 import type { FactStore } from "./fact-store.js";
+import type { LearnerStore } from "./learner-store.js";
 import type { SessionStore } from "./session-store.js";
 import type { SignalStore } from "./signal-store.js";
 import type { WorkstreamStore } from "./workstream-store.js";
 import type { SourceRegistryPort } from "../core/sources/source-registry.js";
 import type { ProviderRegistryPort } from "../core/providers/provider-registry.js";
+import type { TeamTokenStorePort } from "../core/tenancy/team-token-store.js";
 export interface Storage {
     readonly facts: FactStore;
     readonly sessions: SessionStore;
@@ -21,10 +23,14 @@ export interface Storage {
     readonly exemplars: CodeExemplarStore;
     readonly workstreams: WorkstreamStore;
     readonly entities: EntityStore;
+    /** Learner evidence (Gnos-style concept tracking; spec 2026-10-06). */
+    readonly learners: LearnerStore;
     /** Transcript-source registry (claude-code/hermes/webhook/…). */
     readonly sources: SourceRegistryPort;
     /** LLM-provider registry (ollama/deepseek/openai/…). */
     readonly providers: ProviderRegistryPort;
+    /** Bearer-token -> team resolution (the tenancy registry itself). */
+    readonly teamTokens: TeamTokenStorePort;
     /** Apply migrations / install extensions. Idempotent. */
     init(): Promise<void>;
     /** Release the underlying connection or pool. */

package/dist/ports/transcript-adapter.d.ts

@@ -53,4 +53,15 @@ export interface TranscriptAdapter {
     discover(options?: DiscoverOptions): Promise<ReadonlyArray<string>>;
     /** Parse one transcript into a SessionChunk, or null if it's empty/garbage. */
     parseSession(path: string): Promise<SessionChunk | null>;
+    /**
+     * For adapters whose discovered sources are not files (rows in a runtime's
+     * own database). scanOnce uses it in place of statSync: `mtimeMs` drives
+     * the idle gate, `size` is a change marker compared against adapter_state.
+     * Null means the source is gone.
+     */
+    stat?(source: string): SourceStat | null;
+}
+export interface SourceStat {
+    readonly mtimeMs: number;
+    readonly size: number;
 }

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,20 +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/net.d.ts

@@ -0,0 +1,3 @@
+/** Single source of truth for the daemon's default port. A hook and the
+ *  daemon disagreeing on this default silently splits the system. */
+export declare const DEFAULT_NLM_PORT = "3940";

package/dist/shared/net.js

@@ -0,0 +1,4 @@
+/** Single source of truth for the daemon's default port. A hook and the
+ *  daemon disagreeing on this default silently splits the system. */
+export const DEFAULT_NLM_PORT = "3940";
+//# sourceMappingURL=net.js.map

package/dist/shared/net.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"net.js","sourceRoot":"","sources":["../../src/shared/net.ts"],"names":[],"mappings":"AAAA;qEACqE;AACrE,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC"}

package/dist/shared/types.d.ts

@@ -42,6 +42,33 @@ export interface Session {
     readonly classifierProvider?: string | null;
     readonly classifierModel?: string | null;
     readonly classifierConfidence?: number | null;
+    /**
+     * Subagent persona slug for claude-code subagent sessions (e.g. "code-reviewer"),
+     * "orchestrator" for top-level claude-code sessions, or the runtime name for
+     * every other adapter. NULL when not derivable. Populated by getById; absent
+     * on bulk reads. See docs/superpowers/plans/2026-07-21-352-phase2-tierb.md.
+     */
+    readonly agentPersona?: string | null;
+    /**
+     * RUNTIME parent session id (join key against `sessions.runtime_session_id`,
+     * not the internal `sessions.id`) for claude-code subagent sessions; NULL
+     * for top-level or non-claude-code sessions. Populated by getById; absent
+     * on bulk reads.
+     */
+    readonly parentSessionId?: string | null;
+    /**
+     * Majority model across assistant messages in the transcript (claude-code
+     * jsonl only, v1). NULL when not derivable (missing/unreadable transcript,
+     * non-claude-code kind). Populated by getById; absent on bulk reads. See
+     * docs/superpowers/plans/2026-07-21-352-phase2-tierb.md.
+     */
+    readonly primaryModel?: string | null;
+    /** Sum of input_tokens + output_tokens across assistant messages. Same
+     *  derivability/absence contract as primaryModel. */
+    readonly totalTokens?: number | null;
+    /** Slug of the first Skill-tool invocation in the transcript, or NULL.
+     *  Same derivability/absence contract as primaryModel. */
+    readonly skill?: string | null;
 }
 /**
  * Supersedence-relation edge kinds in `session_edges.kind`.
@@ -91,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
@@ -154,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.
@@ -241,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;
@@ -248,6 +297,10 @@ export interface FactHistoryChain {
 }
 export type SignalKind = "gate" | "eval" | "review" | "test";
 export type SignalOutcome = "pass" | "fail" | "fix" | "exhausted";
+/** Canonical outcome vocabulary as a runtime array: the single source of truth
+ *  for both ingest validation (`ingest-signal.ts`) and any boundary (e.g. the
+ *  MCP `report_outcome` tool) that needs to enumerate/validate the set. */
+export declare const SIGNAL_OUTCOMES: readonly ["pass", "fail", "fix", "exhausted"];
 /** Producer-side payload. `install_scope` and `id` are stamped server-side. */
 export interface SignalInput {
     readonly v?: number;
@@ -274,6 +327,7 @@ export interface Signal {
     readonly step: string | null;
     readonly detail: Record<string, unknown> | null;
     readonly sessionId: string | null;
+    readonly scope: string | null;
     readonly ts: string;
     readonly createdAt: string;
 }
@@ -292,6 +346,7 @@ export interface CodeExemplarInput {
     readonly outcome: CodeExemplarOutcome;
     readonly gitSha: string | null;
     readonly survived: 0 | 1 | null;
+    readonly scope: string | null;
     readonly ts: string;
 }
 /** Stored exemplar. */

package/dist/shared/types.js

@@ -2,5 +2,8 @@
  * Shared domain types crossed by core, http, mcp, and ui layers.
  * No runtime behavior here — types only.
  */
-export {};
+/** Canonical outcome vocabulary as a runtime array: the single source of truth
+ *  for both ingest validation (`ingest-signal.ts`) and any boundary (e.g. the
+ *  MCP `report_outcome` tool) that needs to enumerate/validate the set. */
+export const SIGNAL_OUTCOMES = ["pass", "fail", "fix", "exhausted"];
 //# sourceMappingURL=types.js.map

package/dist/shared/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}
+{"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"}