@longtable/memory 0.1.9

package/README.md

@@ -0,0 +1,11 @@
+# @longtable/memory
+
+Memory contracts and helpers for LongTable research state.
+
+Current responsibilities:
+
+- explicit state storage
+- inferred hypothesis handling
+- open tension tracking
+- narrative trace handling
+- summary compaction contracts

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./state.js";
+export * from "./types.js";

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from "./state.js";
+export * from "./types.js";

package/dist/state.d.ts

@@ -0,0 +1,12 @@
+import type { ArtifactRecord, DecisionRecord, InferredHypothesis, InteractionMode, MemorySummary, NarrativeTrace, ResearchState } from "./types.js";
+export declare function createEmptyResearchState(): ResearchState;
+export declare function addInferredHypothesis(state: ResearchState, hypothesis: InferredHypothesis): ResearchState;
+export declare function promoteHypothesisToExplicitState(state: ResearchState, hypothesisText: string, explicitKey: string, explicitValue: unknown): ResearchState;
+export declare function rejectInferredHypothesis(state: ResearchState, hypothesisText: string): ResearchState;
+export declare function appendDecisionRecord(state: ResearchState, decision: DecisionRecord): ResearchState;
+export declare function recordArtifactProvenance(state: ResearchState, artifact: ArtifactRecord): ResearchState;
+export declare function appendNarrativeTrace(state: ResearchState, trace: NarrativeTrace): ResearchState;
+export declare function attachStudyContract(state: ResearchState, studyContract: ResearchState["studyContract"]): ResearchState;
+export declare function restoreWorkingState(state: ResearchState): ResearchState;
+export declare function summarizeForCheckpoint(state: ResearchState, mode: InteractionMode): MemorySummary;
+export declare function summarizeStateForMode(state: ResearchState, mode: InteractionMode): MemorySummary;

package/dist/state.js

@@ -0,0 +1,145 @@
+function clampConfidence(value) {
+    if (value < 0) {
+        return 0;
+    }
+    if (value > 1) {
+        return 1;
+    }
+    return value;
+}
+export function createEmptyResearchState() {
+    return {
+        explicitState: {},
+        workingState: {},
+        inferredHypotheses: [],
+        openTensions: [],
+        decisionLog: [],
+        artifactRecords: [],
+        narrativeTraces: []
+    };
+}
+export function addInferredHypothesis(state, hypothesis) {
+    return {
+        ...state,
+        inferredHypotheses: [
+            ...state.inferredHypotheses,
+            {
+                ...hypothesis,
+                confidence: clampConfidence(hypothesis.confidence)
+            }
+        ]
+    };
+}
+export function promoteHypothesisToExplicitState(state, hypothesisText, explicitKey, explicitValue) {
+    return {
+        explicitState: {
+            ...state.explicitState,
+            [explicitKey]: explicitValue
+        },
+        workingState: state.workingState,
+        inferredHypotheses: state.inferredHypotheses.map((entry) => entry.hypothesis === hypothesisText ? { ...entry, status: "confirmed" } : entry),
+        openTensions: state.openTensions,
+        decisionLog: state.decisionLog,
+        artifactRecords: state.artifactRecords,
+        narrativeTraces: state.narrativeTraces,
+        studyContract: state.studyContract
+    };
+}
+export function rejectInferredHypothesis(state, hypothesisText) {
+    return {
+        ...state,
+        inferredHypotheses: state.inferredHypotheses.map((entry) => entry.hypothesis === hypothesisText ? { ...entry, status: "rejected" } : entry)
+    };
+}
+export function appendDecisionRecord(state, decision) {
+    return {
+        ...state,
+        decisionLog: [...state.decisionLog, decision],
+        studyContract: state.studyContract
+            ? {
+                ...state.studyContract,
+                decisionRecordIds: [...state.studyContract.decisionRecordIds, decision.id]
+            }
+            : state.studyContract
+    };
+}
+export function recordArtifactProvenance(state, artifact) {
+    return {
+        ...state,
+        artifactRecords: [...state.artifactRecords, artifact]
+    };
+}
+export function appendNarrativeTrace(state, trace) {
+    return {
+        ...state,
+        narrativeTraces: [...state.narrativeTraces, trace]
+    };
+}
+export function attachStudyContract(state, studyContract) {
+    return {
+        ...state,
+        studyContract
+    };
+}
+export function restoreWorkingState(state) {
+    return {
+        explicitState: { ...state.explicitState },
+        workingState: { ...state.workingState },
+        inferredHypotheses: [...state.inferredHypotheses],
+        openTensions: [...state.openTensions],
+        decisionLog: [...state.decisionLog],
+        artifactRecords: [...state.artifactRecords],
+        narrativeTraces: [...state.narrativeTraces],
+        studyContract: state.studyContract
+            ? {
+                ...state.studyContract,
+                openTensions: [...state.studyContract.openTensions],
+                decisionRecordIds: [...state.studyContract.decisionRecordIds]
+            }
+            : undefined
+    };
+}
+export function summarizeForCheckpoint(state, mode) {
+    const summary = summarizeStateForMode(state, mode);
+    return {
+        ...summary,
+        decisionLog: mode === "commit" || mode === "submit"
+            ? state.decisionLog.slice(-5)
+            : state.decisionLog.slice(-2),
+        artifactRecords: mode === "submit"
+            ? state.artifactRecords.slice(-5)
+            : state.artifactRecords.slice(-2),
+        narrativeTraces: mode === "commit" || mode === "submit"
+            ? state.narrativeTraces.slice(-5)
+            : state.narrativeTraces.slice(-2)
+    };
+}
+export function summarizeStateForMode(state, mode) {
+    const baseSummary = {
+        explicitState: state.explicitState,
+        workingState: state.workingState,
+        inferredHypotheses: [],
+        openTensions: [],
+        decisionLog: [],
+        artifactRecords: [],
+        narrativeTraces: []
+    };
+    if (mode === "explore" || mode === "review" || mode === "draft") {
+        return baseSummary;
+    }
+    if (mode === "critique") {
+        return {
+            ...baseSummary,
+            inferredHypotheses: state.inferredHypotheses.filter((entry) => entry.status === "unconfirmed"),
+            narrativeTraces: state.narrativeTraces.filter((trace) => trace.visibility === "inferred")
+        };
+    }
+    return {
+        ...baseSummary,
+        inferredHypotheses: state.inferredHypotheses.filter((entry) => entry.status !== "rejected"),
+        openTensions: state.openTensions,
+        decisionLog: state.decisionLog.slice(-3),
+        artifactRecords: state.artifactRecords.slice(-3),
+        narrativeTraces: state.narrativeTraces.slice(-3)
+    };
+}

package/dist/types.d.ts

@@ -0,0 +1,11 @@
+import type { ArtifactRecord, DecisionRecord, InferredHypothesis, NarrativeTrace } from "@longtable/core";
+export interface MemorySummary {
+    explicitState: Record<string, unknown>;
+    workingState: Record<string, unknown>;
+    inferredHypotheses: InferredHypothesis[];
+    openTensions: string[];
+    decisionLog: DecisionRecord[];
+    artifactRecords: ArtifactRecord[];
+    narrativeTraces: NarrativeTrace[];
+}
+export type { ArtifactRecord, DecisionRecord, InferredHypothesis, InteractionMode, NarrativeTrace, ResearchState } from "@longtable/core";

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@longtable/memory",
+  "version": "0.1.9",
+  "private": false,
+  "description": "Memory contracts for LongTable explicit state, inferred hypotheses, and open tensions",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@longtable/core": "0.1.9"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0"
+  },
+  "keywords": [
+    "longtable",
+    "research",
+    "memory",
+    "state"
+  ],
+  "author": "Hosung You",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/HosungYou/LongTable.git"
+  },
+  "homepage": "https://github.com/HosungYou/LongTable#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}