@deposition.cloud/memory 1.0.2

package/README.md

@@ -0,0 +1,30 @@
+# memory
+
+Reusable governance memory and thought-management utilities.
+
+## Package
+
+This repo publishes `@deposition.cloud/memory`.
+
+It extracts the generic memory and thought-stream mechanics from governance repos so they can be reused across public and private overlays without copying implementation details.
+
+## Included
+
+- Current-thought lifecycle helpers
+- Archived-thought listing
+- Memory vigor checks
+- Memory compaction prompt generation
+
+## Development
+
+```bash
+pnpm install
+pnpm test
+pnpm build
+```
+
+## Release
+
+The release pipeline follows the same GitLab CI and `semantic-release` shape used by `deposition.cloud/libs/folksonomy`.
+
+Conventional commits on `main` drive versioning and publishing.

package/dist/current-thoughts.d.ts

@@ -0,0 +1,11 @@
+export interface CurrentThoughtsResult {
+    action: 'exists' | 'initialized';
+    currentThoughtsPath: string;
+}
+export interface CurrentThoughtsSnapshot {
+    snapshotPath: string;
+    currentThoughtsPath: string;
+}
+export declare function createCurrentThoughtsTemplate(startedAt?: string): string;
+export declare function initializeCurrentThoughts(thoughtsDir: string, startedAt?: string): CurrentThoughtsResult;
+export declare function snapshotCurrentThoughts(thoughtsDir: string, timestamp?: string): CurrentThoughtsSnapshot;

package/dist/current-thoughts.js

@@ -0,0 +1,67 @@
+import fs from 'node:fs';
+import path from 'node:path';
+export function createCurrentThoughtsTemplate(startedAt = 'pending') {
+    return `# Current Thoughts
+
+## Session
+
+- started_at: ${startedAt}
+- topic: pending
+- keywords: []
+
+## Context
+
+<What governance change or question is being worked on?>
+
+## Working Notes
+
+- 
+
+## Promotion Candidates
+
+- ADR:
+- Codex:
+- Registry:
+- Template:
+
+## Verification
+
+- 
+`;
+}
+export function initializeCurrentThoughts(thoughtsDir, startedAt = new Date().toISOString()) {
+    const currentThoughtsPath = path.join(thoughtsDir, 'current-thoughts.md');
+    fs.mkdirSync(thoughtsDir, { recursive: true });
+    if (fs.existsSync(currentThoughtsPath)) {
+        const existing = fs.readFileSync(currentThoughtsPath, 'utf8');
+        if (existing.trim() !== '') {
+            return {
+                action: 'exists',
+                currentThoughtsPath
+            };
+        }
+    }
+    fs.writeFileSync(currentThoughtsPath, createCurrentThoughtsTemplate(startedAt));
+    return {
+        action: 'initialized',
+        currentThoughtsPath
+    };
+}
+export function snapshotCurrentThoughts(thoughtsDir, timestamp = new Date().toISOString().replaceAll(':', '-')) {
+    const currentThoughtsPath = path.join(thoughtsDir, 'current-thoughts.md');
+    if (!fs.existsSync(currentThoughtsPath)) {
+        throw new Error(`No current thoughts file found at ${currentThoughtsPath}`);
+    }
+    const current = fs.readFileSync(currentThoughtsPath, 'utf8').trim();
+    if (current === '') {
+        throw new Error('Current thoughts file is empty.');
+    }
+    const snapshotPath = path.join(thoughtsDir, `thought-${timestamp}.md`);
+    fs.writeFileSync(snapshotPath, `${current}\n`);
+    fs.writeFileSync(currentThoughtsPath, createCurrentThoughtsTemplate());
+    return {
+        snapshotPath,
+        currentThoughtsPath
+    };
+}
+//# sourceMappingURL=current-thoughts.js.map

package/dist/current-thoughts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"current-thoughts.js","sourceRoot":"","sources":["../src/current-thoughts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAY5B,MAAM,UAAU,6BAA6B,CAAC,SAAS,GAAG,SAAS;IACjE,OAAO;;;;gBAIO,SAAS;;;;;;;;;;;;;;;;;;;;;;CAsBxB,CAAA;AACD,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,WAAmB,EACnB,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;IAEpC,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,qBAAqB,CAAC,CAAA;IACzE,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAE9C,IAAI,EAAE,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACvC,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAA;QAC7D,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC3B,OAAO;gBACL,MAAM,EAAE,QAAQ;gBAChB,mBAAmB;aACpB,CAAA;QACH,CAAC;IACH,CAAC;IAED,EAAE,CAAC,aAAa,CAAC,mBAAmB,EAAE,6BAA6B,CAAC,SAAS,CAAC,CAAC,CAAA;IAE/E,OAAO;QACL,MAAM,EAAE,aAAa;QACrB,mBAAmB;KACpB,CAAA;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,WAAmB,EACnB,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC;IAEzD,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,qBAAqB,CAAC,CAAA;IAEzE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,qCAAqC,mBAAmB,EAAE,CAAC,CAAA;IAC7E,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAA;IACnE,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;IACpD,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,SAAS,KAAK,CAAC,CAAA;IACtE,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE,GAAG,OAAO,IAAI,CAAC,CAAA;IAC9C,EAAE,CAAC,aAAa,CAAC,mBAAmB,EAAE,6BAA6B,EAAE,CAAC,CAAA;IAEtE,OAAO;QACL,YAAY;QACZ,mBAAmB;KACpB,CAAA;AACH,CAAC"}

package/dist/current-thoughts.test.d.ts

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

package/dist/current-thoughts.test.js

@@ -0,0 +1,54 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+import { createCurrentThoughtsTemplate, initializeCurrentThoughts, snapshotCurrentThoughts } from './current-thoughts.js';
+const tempDirs = [];
+function makeTempDir() {
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'governance-memory-thoughts-'));
+    tempDirs.push(dir);
+    return dir;
+}
+afterEach(() => {
+    while (tempDirs.length > 0) {
+        fs.rmSync(tempDirs.pop(), { recursive: true, force: true });
+    }
+});
+describe('current thought utilities', () => {
+    it('creates a template with the provided timestamp', () => {
+        const template = createCurrentThoughtsTemplate('2026-03-22T00:00:00.000Z');
+        expect(template).toMatch(/started_at: 2026-03-22T00:00:00.000Z/);
+        expect(template).toMatch(/Promotion Candidates/);
+    });
+    it('initializes current thoughts in an empty directory', () => {
+        const thoughtsDir = makeTempDir();
+        const result = initializeCurrentThoughts(thoughtsDir, '2026-03-22T00:00:00.000Z');
+        expect(result.action).toBe('initialized');
+        expect(fs.existsSync(result.currentThoughtsPath)).toBe(true);
+    });
+    it('does not overwrite a non-empty current thoughts file', () => {
+        const thoughtsDir = makeTempDir();
+        const currentThoughtsPath = path.join(thoughtsDir, 'current-thoughts.md');
+        fs.mkdirSync(thoughtsDir, { recursive: true });
+        fs.writeFileSync(currentThoughtsPath, '# Existing\n');
+        const result = initializeCurrentThoughts(thoughtsDir);
+        expect(result.action).toBe('exists');
+        expect(fs.readFileSync(currentThoughtsPath, 'utf8')).toBe('# Existing\n');
+    });
+    it('snapshots current thoughts and resets the working file', () => {
+        const thoughtsDir = makeTempDir();
+        fs.mkdirSync(thoughtsDir, { recursive: true });
+        fs.writeFileSync(path.join(thoughtsDir, 'current-thoughts.md'), '# Current\n');
+        const result = snapshotCurrentThoughts(thoughtsDir, '2026-03-22T00-00-00.000Z');
+        const snapshot = fs.readFileSync(result.snapshotPath, 'utf8');
+        const current = fs.readFileSync(result.currentThoughtsPath, 'utf8');
+        expect(snapshot).toMatch(/^# Current/);
+        expect(result.snapshotPath).toMatch(/thought-2026-03-22T00-00-00.000Z\.md$/);
+        expect(current).toMatch(/# Current Thoughts/);
+    });
+    it('throws when no current thoughts file exists', () => {
+        const thoughtsDir = makeTempDir();
+        expect(() => snapshotCurrentThoughts(thoughtsDir, '2026-03-22T00-00-00.000Z')).toThrow(/No current thoughts file found/);
+    });
+});
+//# sourceMappingURL=current-thoughts.test.js.map

package/dist/current-thoughts.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"current-thoughts.test.js","sourceRoot":"","sources":["../src/current-thoughts.test.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './current-thoughts.js';
+export * from './memory.js';

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './current-thoughts.js';
+export * from './memory.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,aAAa,CAAA"}

package/dist/memory.d.ts

@@ -0,0 +1,21 @@
+export declare const VIGOR_THRESHOLDS: {
+    readonly greenMax: 8;
+    readonly yellowMax: 14;
+    readonly redMin: 15;
+};
+export interface MemoryVigor {
+    status: 'GREEN' | 'YELLOW' | 'RED';
+    count: number;
+    archivedThoughts: string[];
+    exitCode: 0 | 1;
+}
+export interface MemoryCompactionPromptOptions {
+    thoughtsDir: string;
+    monthlyDir: string;
+    patternsDir: string;
+    now?: Date;
+}
+export declare function listArchivedThoughts(thoughtsDir: string): string[];
+export declare function getMemoryVigor(thoughtsDir: string): MemoryVigor;
+export declare function formatMemoryVigor(vigor: MemoryVigor): string;
+export declare function createMemoryCompactionPrompt({ thoughtsDir, monthlyDir, patternsDir, now }: MemoryCompactionPromptOptions): string;

package/dist/memory.js

@@ -0,0 +1,72 @@
+import fs from 'node:fs';
+import path from 'node:path';
+export const VIGOR_THRESHOLDS = {
+    greenMax: 8,
+    yellowMax: 14,
+    redMin: 15
+};
+export function listArchivedThoughts(thoughtsDir) {
+    const entries = fs.existsSync(thoughtsDir)
+        ? fs.readdirSync(thoughtsDir, { withFileTypes: true })
+        : [];
+    return entries
+        .filter((entry) => entry.isFile() && /^thought-.*\.md$/.test(entry.name))
+        .map((entry) => entry.name)
+        .sort();
+}
+export function getMemoryVigor(thoughtsDir) {
+    const archivedThoughts = listArchivedThoughts(thoughtsDir);
+    const count = archivedThoughts.length;
+    if (count >= VIGOR_THRESHOLDS.redMin) {
+        return { status: 'RED', count, archivedThoughts, exitCode: 1 };
+    }
+    if (count > VIGOR_THRESHOLDS.greenMax) {
+        return { status: 'YELLOW', count, archivedThoughts, exitCode: 0 };
+    }
+    return { status: 'GREEN', count, archivedThoughts, exitCode: 0 };
+}
+export function formatMemoryVigor(vigor) {
+    const lines = [
+        `Memory vigor: ${vigor.status}`,
+        `- archived_thoughts: ${vigor.count}`,
+        `- thresholds: GREEN <= ${VIGOR_THRESHOLDS.greenMax}, YELLOW 9-14, RED >= ${VIGOR_THRESHOLDS.redMin}`
+    ];
+    if (vigor.status !== 'GREEN') {
+        lines.push('Recommendation: run `pnpm memory:compact` and promote durable reasoning.');
+    }
+    return lines.join('\n');
+}
+export function createMemoryCompactionPrompt({ thoughtsDir, monthlyDir, patternsDir, now = new Date() }) {
+    const archivedThoughts = listArchivedThoughts(thoughtsDir);
+    const currentMonth = now.toISOString().slice(0, 7);
+    const monthlyPath = path.join(monthlyDir, `${currentMonth}.md`);
+    const lines = [
+        '# Memory Compaction Prompt',
+        '',
+        'Use this prompt to compact governance memory.',
+        '',
+        '## Inputs',
+        '',
+        `- Thoughts directory: ${thoughtsDir}`,
+        `- Monthly synthesis target: ${monthlyPath}`,
+        `- Patterns directory: ${patternsDir}`,
+        `- Archived thought files: ${archivedThoughts.length}`,
+        '',
+        '## Actions',
+        '',
+        '1. Read the most relevant recent thought snapshots.',
+        '2. Update the monthly synthesis with durable developments.',
+        '3. Promote repeatable standards into docs/patterns/ or .agents/codex/.',
+        '4. Keep thoughts as episodic memory, not canonical law.',
+        '5. Re-run `pnpm memory:vigor` after compaction.',
+        ''
+    ];
+    if (archivedThoughts.length > 0) {
+        lines.push('## Recent Thoughts', '');
+        for (const thought of archivedThoughts.slice(-10)) {
+            lines.push(`- ${thought}`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

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

package/dist/memory.test.d.ts

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

package/dist/memory.test.js

@@ -0,0 +1,80 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+import { createMemoryCompactionPrompt, formatMemoryVigor, getMemoryVigor, listArchivedThoughts } from './memory.js';
+const tempDirs = [];
+function makeTempDir() {
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'governance-memory-'));
+    tempDirs.push(dir);
+    return dir;
+}
+afterEach(() => {
+    while (tempDirs.length > 0) {
+        fs.rmSync(tempDirs.pop(), { recursive: true, force: true });
+    }
+});
+describe('memory utilities', () => {
+    it('lists only archived thought snapshots', () => {
+        const dir = makeTempDir();
+        fs.writeFileSync(path.join(dir, 'thought-1.md'), 'a');
+        fs.writeFileSync(path.join(dir, 'thought-2.md'), 'b');
+        fs.writeFileSync(path.join(dir, 'current-thoughts.md'), 'working');
+        fs.writeFileSync(path.join(dir, 'notes.md'), 'ignore');
+        expect(listArchivedThoughts(dir)).toEqual(['thought-1.md', 'thought-2.md']);
+    });
+    it('returns GREEN at eight or fewer archived thoughts', () => {
+        const dir = makeTempDir();
+        for (let i = 0; i < 8; i += 1) {
+            fs.writeFileSync(path.join(dir, `thought-${i}.md`), 'x');
+        }
+        const vigor = getMemoryVigor(dir);
+        expect(vigor.status).toBe('GREEN');
+        expect(vigor.exitCode).toBe(0);
+    });
+    it('returns YELLOW between nine and fourteen archived thoughts', () => {
+        const dir = makeTempDir();
+        for (let i = 0; i < 9; i += 1) {
+            fs.writeFileSync(path.join(dir, `thought-${i}.md`), 'x');
+        }
+        const vigor = getMemoryVigor(dir);
+        expect(vigor.status).toBe('YELLOW');
+        expect(vigor.exitCode).toBe(0);
+    });
+    it('returns RED at fifteen or more archived thoughts', () => {
+        const dir = makeTempDir();
+        for (let i = 0; i < 15; i += 1) {
+            fs.writeFileSync(path.join(dir, `thought-${i}.md`), 'x');
+        }
+        const vigor = getMemoryVigor(dir);
+        expect(vigor.status).toBe('RED');
+        expect(vigor.exitCode).toBe(1);
+    });
+    it('formats a recommendation for non-green vigor', () => {
+        const output = formatMemoryVigor({
+            status: 'YELLOW',
+            count: 10,
+            archivedThoughts: [],
+            exitCode: 0
+        });
+        expect(output).toMatch(/Memory vigor: YELLOW/);
+        expect(output).toMatch(/Recommendation: run `pnpm memory:compact`/);
+    });
+    it('builds a compaction prompt with recent thoughts', () => {
+        const thoughtsDir = makeTempDir();
+        const monthlyDir = makeTempDir();
+        const patternsDir = makeTempDir();
+        fs.writeFileSync(path.join(thoughtsDir, 'thought-a.md'), 'a');
+        fs.writeFileSync(path.join(thoughtsDir, 'thought-b.md'), 'b');
+        const prompt = createMemoryCompactionPrompt({
+            thoughtsDir,
+            monthlyDir,
+            patternsDir,
+            now: new Date('2026-03-22T00:00:00.000Z')
+        });
+        expect(prompt).toMatch(/Monthly synthesis target: .*2026-03\.md/);
+        expect(prompt).toMatch(/thought-a\.md/);
+        expect(prompt).toMatch(/thought-b\.md/);
+    });
+});
+//# sourceMappingURL=memory.test.js.map

package/dist/memory.test.js.map

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

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@deposition.cloud/memory",
+  "version": "1.0.2",
+  "description": "Reusable governance memory and thought-management utilities",
+  "type": "module",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@gitlab.com/deposition.cloud/libs/governance/memory.git"
+  },
+  "author": "reply@deposition.cloud",
+  "license": "Hippocratic",
+  "bugs": {
+    "url": "https://gitlab.com/deposition.cloud/libs/governance/memory/issues"
+  },
+  "homepage": "https://gitlab.com/deposition.cloud/libs/governance/memory#readme",
+  "dependencies": {
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/npm": "^12.0.2",
+    "@semantic-release/release-notes-generator": "^14.1.0",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/gitlab": "^13.2.5",
+    "@types/node": "^22.15.24",
+    "only-allow": "^1.2.1",
+    "semantic-release": "^24.2.5",
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3",
+    "vitest": "^3.1.4"
+  },
+  "devDependencies": {
+    "@semantic-release/exec": "^7.1.0"
+  },
+  "scripts": {
+    "preinstall": "npx -y only-allow pnpm || (echo 'Use pnpm only'; exit 1)",
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "release": "tsx ./node_modules/.bin/semantic-release"
+  }
+}