faf-cli 4.4.4 → 5.0.0

package/dist/utils/memory-parser.js

@@ -0,0 +1,408 @@
+"use strict";
+/**
+ * MEMORY.md Parser — Claude Code Auto-Memory Interop
+ *
+ * Bidirectional interoperability between FAF and Claude Code's
+ * auto-memory system (~/.claude/projects/<id>/memory/MEMORY.md).
+ *
+ * Key difference from other targets: MEMORY.md lives OUTSIDE the
+ * project root, has a 200-line auto-load ceiling, and must MERGE
+ * (not overwrite) to preserve Claude's own notes.
+ *
+ * Path convention:
+ *   ~/.claude/projects/<project-id>/memory/MEMORY.md
+ *   project-id = absolute path with / replaced by -
+ *   e.g. /Users/wolfejam/FAF/cli → -Users-wolfejam-FAF-cli
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeProjectId = computeProjectId;
+exports.getGitRoot = getGitRoot;
+exports.resolveMemoryDir = resolveMemoryDir;
+exports.resolveMemoryPath = resolveMemoryPath;
+exports.parseMemoryMd = parseMemoryMd;
+exports.memoryExport = memoryExport;
+exports.memoryImport = memoryImport;
+exports.detectMemoryMd = detectMemoryMd;
+exports.getMemoryStatus = getMemoryStatus;
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+const child_process_1 = require("child_process");
+// ============================================================================
+// Path Resolution
+// ============================================================================
+/**
+ * Compute Claude Code project ID from an absolute path.
+ * Convention: /Users/wolfejam/FAF/cli → -Users-wolfejam-FAF-cli
+ */
+function computeProjectId(projectPath) {
+    // Normalize: resolve to absolute, remove trailing slash
+    const normalized = path_1.default.resolve(projectPath).replace(/\/+$/, '');
+    // Replace all / with -
+    return normalized.replace(/\//g, '-');
+}
+/**
+ * Get the git repository root for a directory.
+ * Returns null if not in a git repo.
+ */
+function getGitRoot(cwd) {
+    try {
+        const root = (0, child_process_1.execSync)('git rev-parse --show-toplevel', {
+            cwd: cwd || process.cwd(),
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        return root;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Resolve the memory directory for a project.
+ * → ~/.claude/projects/-Users-wolfejam-FAF-cli/memory/
+ */
+function resolveMemoryDir(projectPath) {
+    const home = process.env.HOME || process.env.USERPROFILE || '';
+    const configDir = process.env.CLAUDE_CONFIG_DIR || path_1.default.join(home, '.claude');
+    const projectId = computeProjectId(projectPath);
+    return path_1.default.join(configDir, 'projects', projectId, 'memory');
+}
+/**
+ * Resolve the full MEMORY.md path for a project.
+ * → ~/.claude/projects/-Users-wolfejam-FAF-cli/memory/MEMORY.md
+ */
+function resolveMemoryPath(projectPath) {
+    return path_1.default.join(resolveMemoryDir(projectPath), 'MEMORY.md');
+}
+// ============================================================================
+// Section Markers
+// ============================================================================
+const FAF_SECTION_START = '# Project Context (from project.faf)';
+const FAF_SECTION_END = '*This section is managed by tri-sync.';
+// ============================================================================
+// Parsing
+// ============================================================================
+/**
+ * Parse MEMORY.md into our section and Claude's notes.
+ */
+function parseMemoryMd(content) {
+    const normalized = content.replace(/^\uFEFF/, '').replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+    const lines = normalized.split('\n');
+    const startIdx = normalized.indexOf(FAF_SECTION_START);
+    const endIdx = normalized.indexOf(FAF_SECTION_END);
+    if (startIdx !== -1 && endIdx !== -1) {
+        // Find the end of our section (after the end marker line)
+        const endLineIdx = normalized.indexOf('\n', endIdx);
+        const endOfSection = endLineIdx !== -1 ? endLineIdx + 1 : normalized.length;
+        const fafSection = normalized.substring(startIdx, endOfSection);
+        const before = normalized.substring(0, startIdx);
+        const after = normalized.substring(endOfSection);
+        const claudeNotes = (before + after).trim();
+        return {
+            fafSection,
+            claudeNotes,
+            totalLines: lines.length,
+        };
+    }
+    return {
+        fafSection: null,
+        claudeNotes: normalized.trim(),
+        totalLines: lines.length,
+    };
+}
+// ============================================================================
+// Export: FAF → MEMORY.md
+// ============================================================================
+/**
+ * Generate the FAF section content from parsed .faf data.
+ * Kept deliberately concise — aims for 30-60 lines to leave room for Claude's notes.
+ */
+function generateFafSection(fafData) {
+    const lines = [];
+    lines.push(FAF_SECTION_START);
+    lines.push('');
+    // Quick Reference
+    const projectName = fafData.project?.name || fafData.name || 'Unknown';
+    const projectGoal = fafData.project?.goal || fafData.project?.description || fafData.ai_tldr?.project || '';
+    const projectType = fafData.project?.type || '';
+    const techStack = fafData.instant_context?.tech_stack || fafData.ai_tldr?.stack || '';
+    const mainLang = fafData.instant_context?.main_language || fafData.project?.main_language || '';
+    lines.push('## Quick Reference');
+    lines.push(`- **Name:** ${projectName}`);
+    if (projectGoal) {
+        lines.push(`- **Goal:** ${projectGoal}`);
+    }
+    if (projectType) {
+        lines.push(`- **App Type:** ${projectType}`);
+    }
+    if (techStack) {
+        lines.push(`- **Stack:** ${techStack}`);
+    }
+    if (mainLang) {
+        lines.push(`- **Main Language:** ${mainLang}`);
+    }
+    lines.push('');
+    // Tech Stack details
+    const stack = fafData.stack || {};
+    const hasStack = stack.frontend || stack.backend || stack.build || stack.runtime;
+    if (hasStack) {
+        lines.push('## Tech Stack');
+        if (stack.frontend) {
+            lines.push(`- Frontend: ${stack.frontend}`);
+        }
+        if (stack.backend) {
+            lines.push(`- Backend: ${stack.backend}`);
+        }
+        if (stack.build) {
+            lines.push(`- Build: ${stack.build}`);
+        }
+        if (stack.runtime) {
+            lines.push(`- Runtime: ${stack.runtime}`);
+        }
+        if (stack.package_manager) {
+            lines.push(`- Package Manager: ${stack.package_manager}`);
+        }
+        if (stack.database && stack.database !== 'None') {
+            lines.push(`- Database: ${stack.database}`);
+        }
+        lines.push('');
+    }
+    // Architecture / what building
+    const whatBuilding = fafData.instant_context?.what_building || fafData.human_context?.what || '';
+    const architecture = fafData.project?.architecture || [];
+    if (whatBuilding || architecture.length > 0) {
+        lines.push('## Key Architecture');
+        if (whatBuilding) {
+            lines.push(`- ${whatBuilding}`);
+        }
+        for (const item of architecture) {
+            lines.push(`- ${item}`);
+        }
+        lines.push('');
+    }
+    // Conventions (from warnings + preferences)
+    const warnings = fafData.ai_instructions?.warnings || [];
+    const codingStyle = fafData.project?.codingStyle || [];
+    const preferences = fafData.preferences || {};
+    const conventionItems = [...warnings, ...codingStyle];
+    if (preferences.quality_bar) {
+        conventionItems.push(`Quality bar: ${preferences.quality_bar}`);
+    }
+    if (preferences.testing) {
+        conventionItems.push(`Testing: ${preferences.testing}`);
+    }
+    if (preferences.commit_style) {
+        conventionItems.push(`Commit style: ${preferences.commit_style}`);
+    }
+    if (conventionItems.length > 0) {
+        lines.push('## Conventions');
+        for (const item of conventionItems) {
+            lines.push(`- ${item}`);
+        }
+        lines.push('');
+    }
+    // Build Commands
+    const howContext = fafData.human_context?.how || '';
+    const buildCommands = fafData.project?.buildCommands || [];
+    if (howContext || buildCommands.length > 0) {
+        lines.push('## Build Commands');
+        if (howContext) {
+            lines.push(`- ${howContext}`);
+        }
+        for (const cmd of buildCommands) {
+            lines.push(`- ${cmd}`);
+        }
+        lines.push('');
+    }
+    // Key Files
+    const keyFiles = fafData.instant_context?.key_files || fafData.key_files || [];
+    if (keyFiles.length > 0) {
+        lines.push('## Key Files');
+        for (const file of keyFiles) {
+            if (typeof file === 'string') {
+                lines.push(`- ${file}`);
+            }
+            else if (file.path) {
+                lines.push(`- ${file.path}${file.purpose ? ` — ${file.purpose}` : ''}`);
+            }
+        }
+        lines.push('');
+    }
+    // Footer
+    lines.push('---');
+    lines.push(`*Seeded from project.faf by faf-cli tri-sync — ${new Date().toISOString().split('T')[0]}*`);
+    lines.push(`${FAF_SECTION_END} Claude's own notes below are preserved.*`);
+    return lines.join('\n');
+}
+/**
+ * Export .faf data to MEMORY.md.
+ * Merge mode (default): replace only our section, preserve Claude's notes.
+ * Force mode: overwrite entire file.
+ */
+async function memoryExport(fafContent, outputPath, options) {
+    const warnings = [];
+    const fafSection = generateFafSection(fafContent);
+    const fafLines = fafSection.split('\n').length;
+    if (fafLines > 80) {
+        warnings.push(`FAF section is ${fafLines} lines — consider trimming to leave room for Claude's notes (200 line ceiling)`);
+    }
+    // Ensure directory exists
+    const dir = path_1.default.dirname(outputPath);
+    await fs_1.promises.mkdir(dir, { recursive: true });
+    if (options?.merge !== false) {
+        // Merge mode (default)
+        try {
+            const raw = await fs_1.promises.readFile(outputPath, 'utf-8');
+            // Normalize CRLF/CR to LF before string surgery (matches parseMemoryMd behavior)
+            const existing = raw.replace(/^\uFEFF/, '').replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+            const parsed = parseMemoryMd(existing);
+            let merged;
+            if (parsed.fafSection !== null) {
+                // Replace our section, preserve Claude's notes
+                const startIdx = existing.indexOf(FAF_SECTION_START);
+                const endIdx = existing.indexOf(FAF_SECTION_END);
+                const endLineIdx = existing.indexOf('\n', endIdx);
+                const endOfSection = endLineIdx !== -1 ? endLineIdx + 1 : existing.length;
+                const before = existing.substring(0, startIdx);
+                const after = existing.substring(endOfSection);
+                merged = `${before}${fafSection}\n${after}`;
+            }
+            else {
+                // Our section doesn't exist yet — prepend it
+                merged = `${fafSection}\n\n${existing}`;
+            }
+            const totalLines = merged.split('\n').length;
+            if (totalLines > 200) {
+                warnings.push(`Total MEMORY.md is ${totalLines} lines — exceeds 200-line auto-load ceiling. Lines 201+ will be silently truncated by Claude Code.`);
+            }
+            await fs_1.promises.writeFile(outputPath, merged);
+            return { success: true, filePath: outputPath, linesWritten: totalLines, warnings, merged: true };
+        }
+        catch {
+            // File doesn't exist — write fresh
+            await fs_1.promises.writeFile(outputPath, `${fafSection}\n`);
+            return { success: true, filePath: outputPath, linesWritten: fafLines, warnings, merged: false };
+        }
+    }
+    else {
+        // Force mode — overwrite entirely
+        await fs_1.promises.writeFile(outputPath, `${fafSection}\n`);
+        return { success: true, filePath: outputPath, linesWritten: fafLines, warnings, merged: false };
+    }
+}
+// ============================================================================
+// Import: MEMORY.md → FAF (harvest)
+// ============================================================================
+/**
+ * Import/harvest Claude's notes from MEMORY.md into structured data.
+ * Conservative: only extracts clearly structured entries.
+ */
+async function memoryImport(memoryPath) {
+    const warnings = [];
+    const harvested = {
+        patterns: [],
+        conventions: [],
+        keyFiles: [],
+        notes: [],
+    };
+    try {
+        await fs_1.promises.access(memoryPath);
+    }
+    catch {
+        return {
+            success: false,
+            warnings: [`MEMORY.md not found: ${memoryPath}`],
+            harvested,
+        };
+    }
+    const content = await fs_1.promises.readFile(memoryPath, 'utf-8');
+    const parsed = parseMemoryMd(content);
+    if (!parsed.claudeNotes || parsed.claudeNotes.trim().length === 0) {
+        warnings.push('No Claude notes found to harvest');
+        return { success: true, warnings, harvested };
+    }
+    // Parse Claude's notes section by section
+    const lines = parsed.claudeNotes.split('\n');
+    let currentSection = '';
+    for (const line of lines) {
+        // Track H2 sections
+        const h2Match = line.match(/^##\s+(.+)$/);
+        if (h2Match) {
+            currentSection = h2Match[1].trim().toLowerCase();
+            continue;
+        }
+        // Extract bullet points
+        const bulletMatch = line.match(/^[-*]\s+(.+)$/);
+        if (bulletMatch) {
+            const item = bulletMatch[1].trim();
+            if (currentSection.includes('pattern') || currentSection.includes('convention')) {
+                harvested.patterns.push(item);
+            }
+            else if (currentSection.includes('file') || currentSection.includes('path')) {
+                harvested.keyFiles.push(item);
+            }
+            else if (currentSection.includes('style') || currentSection.includes('rule')) {
+                harvested.conventions.push(item);
+            }
+            else {
+                harvested.notes.push(item);
+            }
+        }
+    }
+    const totalHarvested = harvested.patterns.length +
+        harvested.conventions.length +
+        harvested.keyFiles.length +
+        harvested.notes.length;
+    if (totalHarvested === 0) {
+        warnings.push('No structured entries found to harvest (Claude notes may be free-form prose)');
+    }
+    return { success: true, warnings, harvested };
+}
+// ============================================================================
+// Detection
+// ============================================================================
+/**
+ * Detect MEMORY.md at Claude's expected path for this project.
+ * Returns the path if found, null otherwise.
+ */
+async function detectMemoryMd(projectPath) {
+    const memoryPath = resolveMemoryPath(projectPath);
+    try {
+        await fs_1.promises.access(memoryPath);
+        return memoryPath;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get memory status for display.
+ */
+async function getMemoryStatus(projectPath) {
+    const memoryPath = resolveMemoryPath(projectPath);
+    const status = {
+        exists: false,
+        path: memoryPath,
+        totalLines: 0,
+        fafSectionLines: 0,
+        claudeNotesLines: 0,
+        hasFafSection: false,
+    };
+    try {
+        const content = await fs_1.promises.readFile(memoryPath, 'utf-8');
+        const parsed = parseMemoryMd(content);
+        status.exists = true;
+        status.totalLines = parsed.totalLines;
+        status.hasFafSection = parsed.fafSection !== null;
+        status.fafSectionLines = parsed.fafSection ? parsed.fafSection.split('\n').length : 0;
+        status.claudeNotesLines = parsed.claudeNotes ? parsed.claudeNotes.split('\n').filter((l) => l.trim()).length : 0;
+    }
+    catch {
+        // File doesn't exist
+    }
+    return status;
+}
+//# sourceMappingURL=memory-parser.js.map

package/dist/utils/memory-parser.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "faf-cli",
-  "version": "4.4.4",
+  "version": "5.0.0",
   "description": "The Persistent AI Context Standard • Foundation Layer for AI • IANA-Registered • Anthropic-Approved • project.faf = AI's foundation",
   "icon": "https://faf.one/orange-smiley.svg",
   "logo": "https://faf.one/orange-smiley.svg",

package/project.faf

@@ -1,19 +1,17 @@
 faf_version: 2.5.0
-generated: 2026-02-18T15:53:09.912Z
+generated: 2026-02-18T19:56:53.057Z
 ai_scoring_system: 2025-09-20
 ai_score: 83%
 ai_confidence: HIGH
 ai_value: 30_seconds_replaces_20_minutes_of_questions
 ai_tldr:
-  project: faf-cli - "The Persistent AI Context Standard • Foundation Layer for AI
-    • IANA-Registered • Anthropic-Approved • project.faf = AI's foundation"
+  project: faf-cli - "The Persistent AI Context Standard • Foundation Layer for AI • IANA-Registered • Anthropic-Approved • project.faf = AI's foundation"
   stack: CLI/TypeScript/TypeScript (tsc)/npm registry/Node.js
   quality_bar: production_ready
   current_focus: Production deployment preparation
   your_role: Build features with perfect context
 instant_context:
-  what_building: The Persistent AI Context Standard • Foundation Layer for AI •
-    IANA-Registered • Anthropic-Approved • project.faf = AI's foundation
+  what_building: The Persistent AI Context Standard • Foundation Layer for AI • IANA-Registered • Anthropic-Approved • project.faf = AI's foundation
   tech_stack: CLI/TypeScript/TypeScript (tsc)/npm registry/Node.js
   main_language: TypeScript
   deployment: npm registry
@@ -28,8 +26,7 @@ context_quality:
     - None - fully specified!
 project:
   name: faf-cli
-  goal: The Persistent AI Context Standard • Foundation Layer for AI •
-    IANA-Registered • Anthropic-Approved • project.faf = AI's foundation
+  goal: The Persistent AI Context Standard • Foundation Layer for AI • IANA-Registered • Anthropic-Approved • project.faf = AI's foundation
   main_language: TypeScript
   type: cli-ts
 ai_instructions:
@@ -67,7 +64,7 @@ preferences:
   documentation: as_needed
 state:
   phase: development
-  version: 4.4.4
+  version: 5.0.0
   focus: production_deployment
   status: green_flag
   next_milestone: npm_publication
@@ -93,16 +90,8 @@ tags:
   user_defined: null
 human_context:
   who: 🏎️⚡️_wolfejam.dev team
-  what: The Persistent AI Context Standard • Foundation Layer for AI •
-    IANA-Registered • Anthropic-Approved • project.faf = AI's foundation
-  why: To enable faf, turbo-cat, format-discovery, catalytic-converter,
-    ai-context, project-dna, context-mirroring, c-mirror, bi-sync, cli,
-    free-forever, podium, fast-af, claude, chatgpt, gemini, cursor, ai-tools,
-    developer-productivity, anti-faff, react, nextjs, next, svelte, sveltekit,
-    typescript, vite, n8n, workflow-automation, stack-detection,
-    framework-detection, react-tools, typescript-tools, integration-system, mcp,
-    model-context-protocol, mcp-server, persistent, persistent-context,
-    persistent-project-context, context-on-demand, ai-readiness
+  what: The Persistent AI Context Standard • Foundation Layer for AI • IANA-Registered • Anthropic-Approved • project.faf = AI's foundation
+  why: To enable faf, turbo-cat, format-discovery, catalytic-converter, ai-context, project-dna, context-mirroring, c-mirror, bi-sync, cli, free-forever, podium, fast-af, claude, chatgpt, gemini, cursor, ai-tools, developer-productivity, anti-faff, react, nextjs, next, svelte, sveltekit, typescript, vite, n8n, workflow-automation, stack-detection, framework-detection, react-tools, typescript-tools, integration-system, mcp, model-context-protocol, mcp-server, persistent, persistent-context, persistent-project-context, context-on-demand, ai-readiness
   where: npm registry + GitHub
   when: Production/Stable
   how: Test-driven development
@@ -132,6 +121,9 @@ gemini:
   notes: Native Gemini CLI integration via FAF
 faf_dna:
   birth_dna: 86
-  birth_certificate: FAF-2026-CLIX-KX17
-  birth_date: 2026-02-18T15:53:09.997Z
+  birth_certificate: FAF-2026-CLIX-KQPK
+  birth_date: 2026-02-18T19:56:53.125Z
   current_score: 86
+metadata:
+  last_claude_sync: 2026-03-02T03:42:51.027Z
+  bi_sync: active