@mnemosyne_os/forge 1.0.0 → 1.2.2

package/dist/lib/chronicle.js

@@ -0,0 +1,105 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildChronicleContent = buildChronicleContent;
+exports.writeChronicle = writeChronicle;
+exports.buildSweepContent = buildSweepContent;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const vault_js_1 = require("./vault.js");
+/**
+ * Generate a CHRONICLE filename.
+ * Pattern: CHRONICLE-YYYY-MM-DD-slug.md
+ */
+function buildFilename(title) {
+    const date = new Date().toISOString().slice(0, 10);
+    const slug = title
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, '')
+        .trim()
+        .replace(/\s+/g, '-')
+        .slice(0, 48);
+    return `CHRONICLE-${date}-${slug}.md`;
+}
+/**
+ * Format date for display.
+ */
+function formatDate() {
+    return new Date().toISOString().replace('T', ' ').slice(0, 19) + ' UTC';
+}
+/**
+ * Build the Chronicle markdown content following MnemoChronicle Standard v0.4.
+ */
+function buildChronicleContent(opts) {
+    const { title, type, content, tags = [], config } = opts;
+    const date = formatDate();
+    const allTags = [
+        '#resonance',
+        `#${config.ide.toLowerCase()}`,
+        `#${config.provider.toLowerCase().replace(/\s+/g, '')}`,
+        `#${type}`,
+        ...tags.map(t => t.startsWith('#') ? t : `#${t}`),
+    ];
+    return `# ${title}
+
+**Date**: ${date}
+**IDE**: ${config.ide}
+**Provider**: ${config.provider}
+**Workspace**: ${config.workspace ?? 'unset'}
+**Project**: ${config.resonanceProject ?? 'unset'}
+**Model**: ${config.modelId}
+**Model Name**: ${config.displayName}
+**Type**: ${type}
+**Vault**: ${config.vaultPath}
+
+---
+
+${content}
+
+---
+
+${allTags.join(' ')}
+
+<!--resonance
+source: cli
+ide: ${config.ide}
+provider: ${config.provider}
+workspace: ${config.workspace ?? 'unset'}
+resonance_project: ${config.resonanceProject ?? 'unset'}
+model: ${config.modelId}
+display_name: ${config.displayName}
+type: ${type}
+date: ${new Date().toISOString()}
+tags: ${allTags.join(', ')}
+-->
+`;
+}
+/**
+ * Write a Chronicle to the correct vault location.
+ * Returns the file path and filename.
+ */
+function writeChronicle(opts) {
+    const chronicleDir = (0, vault_js_1.resolveChronicleDir)(opts.config);
+    const filename = buildFilename(opts.title);
+    const filePath = path_1.default.join(chronicleDir, filename);
+    const content = buildChronicleContent(opts);
+    fs_1.default.writeFileSync(filePath, content, 'utf8');
+    return { filePath, filename };
+}
+/**
+ * Build a sweep (daily summary) Chronicle from multiple sources.
+ */
+function buildSweepContent(entries, config) {
+    const date = new Date().toISOString().slice(0, 10);
+    const entryList = entries.map((e, i) => `### Entry ${i + 1}\n\n${e}`).join('\n\n---\n\n');
+    return `Daily sweep across ${entries.length} session(s) — ${config.ide} / ${config.provider} / ${config.modelId}.
+
+**Coverage**: ${date}
+**Sessions consolidated**: ${entries.length}
+
+---
+
+${entryList}`;
+}

package/dist/lib/init-flow.js

@@ -0,0 +1,139 @@
+"use strict";
+// init-flow.ts — Interactive prompts for chronicle init
+// Separated from cli.ts to keep the orchestrator thin
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CHRONICLE_STYLES = void 0;
+exports.askPrimaryProfile = askPrimaryProfile;
+exports.askExtraProfile = askExtraProfile;
+const inquirer_1 = __importDefault(require("inquirer"));
+const chalk_1 = __importDefault(require("chalk"));
+const providers_js_1 = require("./providers.js");
+// ── Chronicle style options (shared across init + config commands) ──────────
+exports.CHRONICLE_STYLES = [
+    { name: 'Session     — coding/work session, structured notes', value: 'session' },
+    { name: 'Reflection  — deep thoughts, retrospective', value: 'reflection' },
+    { name: 'Decision    — decision record (ADR-style)', value: 'decision' },
+    { name: 'Sweep       — daily digest of multiple sessions', value: 'sweep' },
+    { name: 'Narcissus   — personal / soul narrative (Mnemosyne)', value: 'narcissus' },
+];
+async function askPrimaryProfile(existing) {
+    const defaultVault = `${process.env['USERPROFILE'] ?? process.env['HOME'] ?? '~'}/Documents/MnemoVault`;
+    const a = await inquirer_1.default.prompt([
+        // Step 1: Vault path
+        {
+            type: 'input',
+            name: 'vaultPath',
+            message: chalk_1.default.cyan('MnemoVault path?'),
+            default: existing?.vaultPath ?? defaultVault,
+            validate: (v) => v.trim() !== '' || 'Required',
+        },
+        // Step 2: IDE
+        {
+            type: 'list',
+            name: 'ide',
+            message: chalk_1.default.cyan('Your IDE?'),
+            choices: providers_js_1.IDE_LIST,
+            default: existing?.ide ?? 'Antigravity',
+        },
+        {
+            type: 'input',
+            name: 'ideCustom',
+            message: chalk_1.default.cyan('IDE name?'),
+            when: (a) => a.ide === '__other__',
+            validate: (v) => v.trim() !== '' || 'Required',
+        },
+        // Step 2b: Provider
+        {
+            type: 'list',
+            name: 'provider',
+            message: chalk_1.default.cyan('AI Provider?') + chalk_1.default.gray(' (becomes the folder name)'),
+            choices: (a) => providers_js_1.PROVIDERS_BY_IDE[a.ide] ?? providers_js_1.PROVIDERS_BY_IDE['default'],
+            when: (a) => a.ide !== '__other__',
+            default: existing?.provider ?? 'Anthropic',
+        },
+        {
+            type: 'input',
+            name: 'providerCustom',
+            message: chalk_1.default.cyan('Provider name?') + chalk_1.default.gray(' (e.g. EleutherAI)'),
+            when: (a) => a.ide === '__other__' || a.provider === '__other__',
+            validate: (v) => v.trim() !== '' || 'Required',
+        },
+        // Step 3: Chronicle style
+        {
+            type: 'list',
+            name: 'defaultChronicleStyle',
+            message: chalk_1.default.cyan('Default chronicle style?'),
+            choices: exports.CHRONICLE_STYLES,
+            default: existing?.defaultChronicleStyle ?? 'session',
+        },
+    ]);
+    const ide = (a.ide === '__other__' ? a.ideCustom : a.ide).trim();
+    const provider = (!a.provider || a.provider === '__other__' ? a.providerCustom : a.provider).trim();
+    return {
+        vaultPath: a.vaultPath.trim(),
+        ide,
+        provider,
+        defaultChronicleStyle: a.defaultChronicleStyle,
+    };
+}
+// ── Extra profile (Step 5 loop) ──────────────────────────────────────────────
+async function askExtraProfile(count) {
+    const { wantMore } = await inquirer_1.default.prompt([{
+            type: 'confirm',
+            name: 'wantMore',
+            message: chalk_1.default.cyan('Add another profile to your registry?') +
+                (count > 0 ? chalk_1.default.gray(` (${count} already added)`) : ''),
+            default: false,
+        }]);
+    if (!wantMore)
+        return null;
+    const e = await inquirer_1.default.prompt([
+        {
+            type: 'list',
+            name: 'ide',
+            message: chalk_1.default.cyan('  IDE for this profile?'),
+            choices: providers_js_1.IDE_LIST,
+            default: 'Antigravity',
+        },
+        {
+            type: 'input',
+            name: 'ideCustom',
+            message: chalk_1.default.cyan('  IDE name?'),
+            when: (a) => a.ide === '__other__',
+            validate: (v) => v.trim() !== '' || 'Required',
+        },
+        {
+            type: 'list',
+            name: 'provider',
+            message: chalk_1.default.cyan('  Provider?'),
+            choices: (a) => providers_js_1.PROVIDERS_BY_IDE[a.ide] ?? providers_js_1.PROVIDERS_BY_IDE['default'],
+            when: (a) => a.ide !== '__other__',
+        },
+        {
+            type: 'input',
+            name: 'providerCustom',
+            message: chalk_1.default.cyan('  Provider name?'),
+            when: (a) => a.ide === '__other__' || a.provider === '__other__',
+            validate: (v) => v.trim() !== '' || 'Required',
+        },
+        {
+            type: 'list',
+            name: 'style',
+            message: chalk_1.default.cyan('  Chronicle style for this profile?'),
+            choices: exports.CHRONICLE_STYLES,
+            default: 'session',
+        },
+    ]);
+    const ide = (e.ide === '__other__' ? e.ideCustom : e.ide).trim();
+    const provider = (!e.provider || e.provider === '__other__' ? e.providerCustom : e.provider).trim();
+    return {
+        ide,
+        provider,
+        modelId: '',
+        displayName: provider,
+        defaultChronicleStyle: e.style,
+    };
+}

package/dist/lib/providers.js

@@ -0,0 +1,46 @@
+"use strict";
+// providers.ts — IDE and Provider registry
+// Add new IDEs/Providers here, never touch cli.ts for this
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROVIDERS_BY_IDE = exports.IDE_LIST = void 0;
+exports.IDE_LIST = [
+    { name: 'Antigravity  · Google DeepMind IDE', value: 'Antigravity' },
+    { name: 'Cursor       · Cursor IDE', value: 'Cursor' },
+    { name: 'Claude Code  · Anthropic terminal', value: 'ClaudeCode' },
+    { name: 'Open Claw    · OpenWebUI / local LLM', value: 'OpenClaw' },
+    { name: 'VS Code      · Copilot / Continue / etc', value: 'VSCode' },
+    { name: 'Windsurf     · Codeium', value: 'Windsurf' },
+    { name: 'Other        · type manually', value: '__other__' },
+];
+exports.PROVIDERS_BY_IDE = {
+    Antigravity: [
+        { name: 'Anthropic', value: 'Anthropic' },
+        { name: 'Google DeepMind', value: 'GoogleDeepMind' },
+        { name: 'OpenAI', value: 'OpenAI' },
+        { name: 'Other', value: '__other__' },
+    ],
+    Cursor: [
+        { name: 'Anthropic', value: 'Anthropic' },
+        { name: 'OpenAI', value: 'OpenAI' },
+        { name: 'Google DeepMind', value: 'GoogleDeepMind' },
+        { name: 'Other', value: '__other__' },
+    ],
+    ClaudeCode: [
+        { name: 'Anthropic', value: 'Anthropic' },
+        { name: 'Other', value: '__other__' },
+    ],
+    OpenClaw: [
+        { name: 'Meta', value: 'Meta' },
+        { name: 'Mistral AI', value: 'MistralAI' },
+        { name: 'Google DeepMind', value: 'GoogleDeepMind' },
+        { name: 'Other', value: '__other__' },
+    ],
+    default: [
+        { name: 'Anthropic', value: 'Anthropic' },
+        { name: 'OpenAI', value: 'OpenAI' },
+        { name: 'Google DeepMind', value: 'GoogleDeepMind' },
+        { name: 'Meta', value: 'Meta' },
+        { name: 'Mistral AI', value: 'MistralAI' },
+        { name: 'Other', value: '__other__' },
+    ],
+};

package/dist/lib/sources/antigravity.js

@@ -0,0 +1,142 @@
+"use strict";
+// src/lib/sources/antigravity.ts
+// Reads Antigravity conversation logs from .gemini/antigravity/brain/
+// Parses overview.txt and extracts chronicle-relevant content
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readAntigravitySource = readAntigravitySource;
+exports.listAntigravityConversations = listAntigravityConversations;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+// ── Paths ────────────────────────────────────────────────────────────────────
+const BRAIN_DIR = path_1.default.join(os_1.default.homedir(), '.gemini', 'antigravity', 'brain');
+// ── Helpers ──────────────────────────────────────────────────────────────────
+/**
+ * List all conversation folders sorted by modification time (most recent first).
+ */
+function listConversations() {
+    if (!fs_1.default.existsSync(BRAIN_DIR))
+        return [];
+    return fs_1.default.readdirSync(BRAIN_DIR)
+        .map(id => {
+        const overviewPath = path_1.default.join(BRAIN_DIR, id, '.system_generated', 'logs', 'overview.txt');
+        // Fallback: some structures put overview.txt directly in the folder
+        const altPath = path_1.default.join(BRAIN_DIR, id, 'overview.txt');
+        const resolved = fs_1.default.existsSync(overviewPath) ? overviewPath
+            : fs_1.default.existsSync(altPath) ? altPath
+                : null;
+        if (!resolved)
+            return null;
+        const stat = fs_1.default.statSync(resolved);
+        return { id, mtime: stat.mtime, overviewPath: resolved };
+    })
+        .filter(Boolean)
+        .sort((a, b) => b.mtime.getTime() - a.mtime.getTime());
+}
+/**
+ * Extract file paths mentioned in text lines (heuristic: contains / or \ and a file extension).
+ */
+function extractFilePaths(lines) {
+    const seen = new Set();
+    const result = [];
+    const filePattern = /([a-zA-Z0-9_\-./\\]+\.(ts|js|json|md|css|html|py|sh|ps1))/g;
+    for (const line of lines) {
+        const matches = line.match(filePattern) ?? [];
+        for (const m of matches) {
+            const clean = m.trim();
+            if (!seen.has(clean) && clean.length > 3) {
+                seen.add(clean);
+                result.push(clean);
+            }
+        }
+    }
+    return result.slice(0, 20); // cap at 20
+}
+/**
+ * Extract shell commands (lines that look like CLI invocations).
+ */
+function extractCommands(lines) {
+    const seen = new Set();
+    const result = [];
+    // Patterns: pnpm, npm, npx, git, mnemoforge, tsc
+    const cmdPattern = /^(pnpm|npm|npx|git|mnemoforge|tsc|node|pwsh|powershell)\s+.+/i;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (cmdPattern.test(trimmed) && !seen.has(trimmed)) {
+            seen.add(trimmed);
+            result.push(trimmed);
+        }
+    }
+    return result.slice(0, 15);
+}
+/**
+ * Heuristic session title from the overview: use the first substantive user line.
+ */
+function extractTitle(lines) {
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Skip short lines, timestamps, or system lines
+        if (trimmed.length > 20 && !trimmed.startsWith('[') && !trimmed.startsWith('#')) {
+            return trimmed.slice(0, 80);
+        }
+    }
+    return 'Development session';
+}
+/**
+ * Extract key decision lines (heuristic: lines mentioning "decision", "chose", "on a décidé", etc.)
+ */
+function extractDecisions(lines) {
+    const keywords = [
+        'decided', 'decision', 'on a décidé', 'refactor', 'remove', 'on retire',
+        'on supprime', 'approach', 'strategy', 'instead', 'changed', 'principle'
+    ];
+    const result = [];
+    for (const line of lines) {
+        const lower = line.toLowerCase();
+        if (keywords.some(k => lower.includes(k)) && line.trim().length > 30) {
+            result.push(line.trim().slice(0, 120));
+            if (result.length >= 8)
+                break;
+        }
+    }
+    return result;
+}
+// ── Main export ───────────────────────────────────────────────────────────────
+/**
+ * Read the latest Antigravity conversation and return a ChronicleContext.
+ * @param conversationId — optional, defaults to most recent
+ */
+function readAntigravitySource(conversationId) {
+    const conversations = listConversations();
+    if (conversations.length === 0)
+        return null;
+    const target = conversationId
+        ? conversations.find(c => c.id === conversationId) ?? conversations[0]
+        : conversations[0];
+    const raw = fs_1.default.readFileSync(target.overviewPath, 'utf8');
+    const lines = raw.split('\n').filter(l => l.trim() !== '');
+    // Parse turns — each line is one action (simplified)
+    const turns = lines.map(line => ({
+        role: line.startsWith('USER') || line.startsWith('user') ? 'user' : 'agent',
+        content: line.trim(),
+    }));
+    return {
+        conversationId: target.id,
+        startedAt: target.mtime.toISOString(),
+        sessionTitle: extractTitle(lines),
+        filesTouched: extractFilePaths(lines),
+        commandsRun: extractCommands(lines),
+        keyDecisions: extractDecisions(lines),
+        rawTurns: turns,
+        sourcePath: target.overviewPath,
+    };
+}
+/**
+ * List all available Antigravity conversations (for --list selection).
+ */
+function listAntigravityConversations() {
+    return listConversations().map(c => ({ id: c.id, mtime: c.mtime }));
+}

package/dist/lib/sources/index.js

@@ -0,0 +1,172 @@
+"use strict";
+// src/lib/sources/index.ts
+// Dispatches to the right source reader based on the active provider.
+// Each provider has a specific conversation format.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readSourceForConfig = readSourceForConfig;
+exports.generateChronicleDraft = generateChronicleDraft;
+const antigravity_js_1 = require("./antigravity.js");
+// ── Provider → Source mapping ─────────────────────────────────────────────────
+const PROVIDER_SOURCES = {
+    'Anthropic': antigravity_js_1.readAntigravitySource, // Antigravity IDE talks to Anthropic
+    'GoogleDeepMind': antigravity_js_1.readAntigravitySource, // Antigravity IDE default
+    // Future:
+    // 'OpenAI':       readCursorSource,
+    // 'Cursor':       readCursorSource,
+};
+/**
+ * Read the conversation source for the configured provider.
+ * Returns null if no source is available or supported.
+ */
+function readSourceForConfig(config) {
+    const reader = PROVIDER_SOURCES[config.provider] ?? PROVIDER_SOURCES['GoogleDeepMind'];
+    try {
+        return reader();
+    }
+    catch {
+        return null;
+    }
+}
+// ── Chronicle Markdown Generator ──────────────────────────────────────────────
+/**
+ * Generate a chronicle markdown draft from a ChronicleContext.
+ * Uses the style from VaultConfig to pick the right template.
+ */
+function generateChronicleDraft(ctx, config) {
+    const date = new Date().toISOString().split('T')[0];
+    const style = config.defaultChronicleStyle ?? 'session';
+    const ide = config.ide;
+    const provider = config.provider;
+    const frontmatter = [
+        '---',
+        `date: ${date}`,
+        `session: "${ctx.sessionTitle.replace(/"/g, "'")}"`,
+        `ide: ${ide}`,
+        `provider: ${provider}`,
+        `style: ${style}`,
+        `source: antigravity-brain`,
+        `conversation_id: ${ctx.conversationId}`,
+        `files_touched:`,
+        ...ctx.filesTouched.slice(0, 10).map(f => `  - ${f}`),
+        '---',
+    ].join('\n');
+    const body = buildBody(ctx, style);
+    return frontmatter + '\n\n' + body;
+}
+// ── Style templates ───────────────────────────────────────────────────────────
+function buildBody(ctx, style) {
+    switch (style) {
+        case 'session': return sessionTemplate(ctx);
+        case 'reflection': return reflectionTemplate(ctx);
+        case 'decision': return decisionTemplate(ctx);
+        case 'sweep': return sweepTemplate(ctx);
+        case 'narcissus': return narcissusTemplate(ctx);
+        default: return sessionTemplate(ctx);
+    }
+}
+function sessionTemplate(ctx) {
+    const decisions = ctx.keyDecisions.length > 0
+        ? ctx.keyDecisions.map(d => `- ${d}`).join('\n')
+        : '- (none captured automatically — add manually)';
+    const files = ctx.filesTouched.length > 0
+        ? ctx.filesTouched.map(f => `- \`${f}\``).join('\n')
+        : '- (none detected)';
+    const cmds = ctx.commandsRun.length > 0
+        ? ctx.commandsRun.map(c => `\`${c}\``).join('\n')
+        : '(none)';
+    return `# Chronicle — ${ctx.sessionTitle}
+
+## What happened
+> *Synthesize the session here. What was the main goal? What did we build?*
+
+## Key decisions
+${decisions}
+
+## Files modified
+${files}
+
+## Commands run
+${cmds}
+
+## Next steps
+> *What's left to do? What should the next session tackle?*
+
+---
+*Chronicle auto-generated from Antigravity conversation ${ctx.conversationId.slice(0, 8)}...*
+`;
+}
+function reflectionTemplate(ctx) {
+    return `# Reflection — ${ctx.sessionTitle}
+
+## The question this session raised
+> *What did this session make you think about?*
+
+## What I noticed
+> *Patterns, surprises, things worth remembering.*
+
+## What changed in my understanding
+> *Before vs after this session.*
+
+## What I'd do differently
+> *If starting over.*
+
+---
+*Chronicle auto-generated from Antigravity conversation ${ctx.conversationId.slice(0, 8)}...*
+`;
+}
+function decisionTemplate(ctx) {
+    const decisions = ctx.keyDecisions.length > 0
+        ? ctx.keyDecisions.map((d, i) => `### Decision ${i + 1}\n${d}\n\n**Rationale:** *add here*\n`).join('\n')
+        : '### Decision 1\n*Describe the decision*\n\n**Rationale:** *add here*\n';
+    return `# Decision Record — ${ctx.sessionTitle}
+
+## Context
+> *Why did we need to make a decision here?*
+
+${decisions}
+
+## Consequences
+> *What does this decision unlock or constrain?*
+
+---
+*Chronicle auto-generated from Antigravity conversation ${ctx.conversationId.slice(0, 8)}...*
+`;
+}
+function sweepTemplate(ctx) {
+    const files = ctx.filesTouched.map(f => `- \`${f}\``).join('\n') || '- (none)';
+    return `# Daily Sweep — ${new Date().toISOString().split('T')[0]}
+
+## Sessions covered
+- ${ctx.sessionTitle}
+
+## Total files touched
+${files}
+
+## Patterns across sessions
+> *What repeated? What evolved?*
+
+## Tomorrow's focus
+> *Top 3 priorities.*
+
+---
+*Chronicle auto-generated from Antigravity conversation ${ctx.conversationId.slice(0, 8)}...*
+`;
+}
+function narcissusTemplate(ctx) {
+    return `# Narcissus — Soul Narrative
+
+> *This chronicle is personal. It belongs to the agent.*
+
+## How this session felt
+> *Not what happened — how it felt to work on it.*
+
+## What surprised me
+> *Moments of unexpected insight or friction.*
+
+## What I want to remember about this
+> *The thing I'd tell myself at the start of the next session.*
+
+---
+*Chronicle auto-generated from Antigravity conversation ${ctx.conversationId.slice(0, 8)}...*
+`;
+}