studiograph 1.0.0

package/dist/services/markdown.js

@@ -0,0 +1,338 @@
+/**
+ * Markdown service for Studiograph
+ *
+ * Handles parsing and writing markdown files with YAML frontmatter,
+ * extracting wikilinks, and validating relationships.
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'fs';
+import { dirname, join } from 'path';
+import matter from 'gray-matter';
+import { glob } from 'glob';
+export class MarkdownService {
+    /**
+     * Parse markdown file from path
+     */
+    parseFile(filePath) {
+        if (!existsSync(filePath)) {
+            throw new Error(`File not found: ${filePath}`);
+        }
+        const fileContent = readFileSync(filePath, 'utf-8');
+        return this.parseContent(fileContent);
+    }
+    /**
+     * Parse markdown content string
+     */
+    parseContent(content) {
+        const { data, content: markdownContent } = matter(content);
+        // Extract wikilinks from content
+        const wikilinks = this.extractWikilinks(markdownContent, data);
+        return {
+            frontmatter: data,
+            content: markdownContent,
+            wikilinks: [...new Set(wikilinks)], // Dedupe
+        };
+    }
+    /**
+     * Extract wikilinks from markdown content and frontmatter
+     */
+    extractWikilinks(content, frontmatter) {
+        const wikilinks = [];
+        // Extract from content: [[entity-id]] or [[entity-id|Display Name]]
+        const wikilinkRegex = /\[\[([^\]|]+)(?:\|[^\]]+)?\]\]/g;
+        let match;
+        while ((match = wikilinkRegex.exec(content)) !== null) {
+            wikilinks.push(match[1]);
+        }
+        // Extract from frontmatter (check string values and arrays)
+        this.extractWikilinksFromObject(frontmatter, wikilinks);
+        return wikilinks;
+    }
+    /**
+     * Recursively extract wikilinks from object (frontmatter)
+     */
+    extractWikilinksFromObject(obj, wikilinks) {
+        if (!obj || typeof obj !== 'object') {
+            return;
+        }
+        if (Array.isArray(obj)) {
+            obj.forEach(item => {
+                if (typeof item === 'string') {
+                    const match = item.match(/\[\[([^\]|]+)(?:\|[^\]]+)?\]\]/);
+                    if (match) {
+                        wikilinks.push(match[1]);
+                    }
+                }
+                else {
+                    this.extractWikilinksFromObject(item, wikilinks);
+                }
+            });
+        }
+        else {
+            Object.values(obj).forEach(value => {
+                if (typeof value === 'string') {
+                    const match = value.match(/\[\[([^\]|]+)(?:\|[^\]]+)?\]\]/);
+                    if (match) {
+                        wikilinks.push(match[1]);
+                    }
+                }
+                else {
+                    this.extractWikilinksFromObject(value, wikilinks);
+                }
+            });
+        }
+    }
+    /**
+     * Write markdown file with frontmatter
+     */
+    writeFile(filePath, doc) {
+        const { frontmatter, content } = doc;
+        // Generate markdown with frontmatter
+        const output = matter.stringify(content, frontmatter);
+        // Ensure directory exists
+        const dir = dirname(filePath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        // Write file
+        writeFileSync(filePath, output, 'utf-8');
+    }
+    /**
+     * Write markdown content from separate frontmatter and content
+     */
+    write(filePath, frontmatter, content) {
+        this.writeFile(filePath, { frontmatter, content, wikilinks: [] });
+    }
+    /**
+     * Validate wikilinks against a repo or set of repos
+     */
+    validateWikilinks(wikilinks, searchPaths) {
+        const valid = [];
+        const broken = [];
+        for (const link of wikilinks) {
+            // Try to find the entity file
+            const found = this.findEntity(link, searchPaths);
+            if (found) {
+                valid.push(link);
+            }
+            else {
+                broken.push(link);
+            }
+        }
+        return { valid, broken };
+    }
+    /**
+     * Find entity file by entity ID across multiple search paths
+     */
+    findEntity(entityId, searchPaths) {
+        // Clean entity ID (remove repo prefix if present)
+        // Format: [[repo/entity-id]] or [[entity-id]]
+        const parts = entityId.split('/');
+        const cleanId = parts.length === 2 ? parts[1] : parts[0];
+        // Search for {entityId}.md in all search paths
+        for (const searchPath of searchPaths) {
+            if (!existsSync(searchPath)) {
+                continue;
+            }
+            // Try direct match first (faster)
+            const directPath = join(searchPath, `${cleanId}.md`);
+            if (existsSync(directPath)) {
+                return directPath;
+            }
+            // Search recursively
+            const pattern = `**/${cleanId}.md`;
+            const files = glob.sync(pattern, {
+                cwd: searchPath,
+                absolute: true,
+                nodir: true,
+            });
+            if (files.length > 0) {
+                return files[0]; // Return first match
+            }
+        }
+        return null;
+    }
+    /**
+     * Find all entities of a given type in a directory
+     */
+    findEntitiesByType(searchPath, entityType) {
+        if (!existsSync(searchPath)) {
+            return [];
+        }
+        const files = [];
+        // Recursively search for markdown files
+        const pattern = '**/*.md';
+        const allFiles = glob.sync(pattern, {
+            cwd: searchPath,
+            absolute: true,
+            nodir: true,
+        });
+        // Filter by entity type in frontmatter
+        for (const file of allFiles) {
+            try {
+                const doc = this.parseFile(file);
+                if (doc.frontmatter.entity_type === entityType) {
+                    files.push(file);
+                }
+            }
+            catch {
+                // Skip files that can't be parsed
+                continue;
+            }
+        }
+        return files;
+    }
+    /**
+     * Find all markdown files in a directory (recursive)
+     */
+    findAllEntities(searchPath) {
+        if (!existsSync(searchPath)) {
+            return [];
+        }
+        const pattern = '**/*.md';
+        return glob.sync(pattern, {
+            cwd: searchPath,
+            absolute: true,
+            nodir: true,
+        });
+    }
+    /**
+     * Search entities by content or frontmatter
+     */
+    search(searchPaths, query, options = {}) {
+        const { entityType, caseSensitive = false, searchContent = true, searchFrontmatter = true, limit = 100, } = options;
+        const results = [];
+        const pattern = caseSensitive ? query : query.toLowerCase();
+        // Search all paths
+        for (const searchPath of searchPaths) {
+            if (!existsSync(searchPath)) {
+                continue;
+            }
+            const files = this.findAllEntities(searchPath);
+            for (const file of files) {
+                if (results.length >= limit) {
+                    break;
+                }
+                try {
+                    const doc = this.parseFile(file);
+                    // Filter by entity type if specified
+                    if (entityType && doc.frontmatter.entity_type !== entityType) {
+                        continue;
+                    }
+                    // Search frontmatter
+                    let found = false;
+                    if (searchFrontmatter) {
+                        const frontmatterStr = JSON.stringify(doc.frontmatter);
+                        const searchStr = caseSensitive ? frontmatterStr : frontmatterStr.toLowerCase();
+                        if (searchStr.includes(pattern)) {
+                            found = true;
+                        }
+                    }
+                    // Search content
+                    if (!found && searchContent) {
+                        const searchStr = caseSensitive ? doc.content : doc.content.toLowerCase();
+                        if (searchStr.includes(pattern)) {
+                            found = true;
+                        }
+                    }
+                    if (found) {
+                        results.push(doc);
+                    }
+                }
+                catch {
+                    // Skip files that can't be parsed
+                    continue;
+                }
+            }
+            if (results.length >= limit) {
+                break;
+            }
+        }
+        return results;
+    }
+    /**
+     * Get entity relationships (entities that link to this entity)
+     */
+    findBacklinks(entityId, searchPaths) {
+        const backlinks = [];
+        for (const searchPath of searchPaths) {
+            if (!existsSync(searchPath)) {
+                continue;
+            }
+            const files = this.findAllEntities(searchPath);
+            for (const file of files) {
+                try {
+                    const doc = this.parseFile(file);
+                    // Check if this document links to the target entity
+                    const linksToTarget = doc.wikilinks.some(link => {
+                        const cleanLink = link.split('/').pop() || link;
+                        return cleanLink === entityId;
+                    });
+                    if (linksToTarget) {
+                        backlinks.push({ file, doc });
+                    }
+                }
+                catch {
+                    // Skip files that can't be parsed
+                    continue;
+                }
+            }
+        }
+        return backlinks;
+    }
+    /**
+     * Update wikilinks in a file (useful for refactoring entity IDs)
+     */
+    updateWikilinks(filePath, oldEntityId, newEntityId) {
+        if (!existsSync(filePath)) {
+            throw new Error(`File not found: ${filePath}`);
+        }
+        const doc = this.parseFile(filePath);
+        // Update content
+        let updatedContent = doc.content;
+        const wikilinkPattern = new RegExp(`\\[\\[${escapeRegex(oldEntityId)}(\\|[^\\]]+)?\\]\\]`, 'g');
+        updatedContent = updatedContent.replace(wikilinkPattern, `[[${newEntityId}$1]]`);
+        // Update frontmatter (recursively)
+        const updatedFrontmatter = this.updateWikilinksInObject(doc.frontmatter, oldEntityId, newEntityId);
+        // Write back
+        this.writeFile(filePath, {
+            frontmatter: updatedFrontmatter,
+            content: updatedContent,
+            wikilinks: [],
+        });
+    }
+    /**
+     * Recursively update wikilinks in an object (frontmatter)
+     */
+    updateWikilinksInObject(obj, oldEntityId, newEntityId) {
+        if (!obj || typeof obj !== 'object') {
+            return obj;
+        }
+        if (Array.isArray(obj)) {
+            return obj.map(item => {
+                if (typeof item === 'string') {
+                    const wikilinkPattern = new RegExp(`\\[\\[${escapeRegex(oldEntityId)}(\\|[^\\]]+)?\\]\\]`, 'g');
+                    return item.replace(wikilinkPattern, `[[${newEntityId}$1]]`);
+                }
+                return this.updateWikilinksInObject(item, oldEntityId, newEntityId);
+            });
+        }
+        const updated = {};
+        for (const [key, value] of Object.entries(obj)) {
+            if (typeof value === 'string') {
+                const wikilinkPattern = new RegExp(`\\[\\[${escapeRegex(oldEntityId)}(\\|[^\\]]+)?\\]\\]`, 'g');
+                updated[key] = value.replace(wikilinkPattern, `[[${newEntityId}$1]]`);
+            }
+            else {
+                updated[key] = this.updateWikilinksInObject(value, oldEntityId, newEntityId);
+            }
+        }
+        return updated;
+    }
+}
+/**
+ * Escape special regex characters
+ */
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=markdown.js.map

package/dist/services/markdown.js.map

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

package/dist/services/memory-service.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Memory service for Studiograph
+ *
+ * Manages daily memory files similar to OpenClaw:
+ * - memory/YYYY-MM-DD.md for each day
+ * - Loads today + yesterday at session start
+ * - Appends conversation context throughout the day
+ */
+export interface MemoryEntry {
+    timestamp: Date;
+    type: 'conversation' | 'note' | 'decision';
+    content: string;
+    metadata?: Record<string, any>;
+}
+export declare class MemoryService {
+    private workspacePath;
+    private memoryDir;
+    constructor(workspacePath: string);
+    /**
+     * Ensure memory directory exists
+     */
+    private ensureMemoryDir;
+    /**
+     * Get daily memory file path for a given date
+     */
+    private getDailyMemoryPath;
+    /**
+     * Format timestamp for memory entry
+     */
+    private formatTimestamp;
+    /**
+     * Write entry to today's memory file
+     */
+    writeMemory(entry: MemoryEntry): void;
+    /**
+     * Read memory for a specific date
+     */
+    readMemory(date: Date): string | null;
+    /**
+     * Read today's memory
+     */
+    readToday(): string | null;
+    /**
+     * Read yesterday's memory
+     */
+    readYesterday(): string | null;
+    /**
+     * Load recent memory (today + yesterday)
+     */
+    loadRecentMemory(): string;
+    /**
+     * List all memory files
+     */
+    listMemoryFiles(): string[];
+    /**
+     * Search memory files for a keyword
+     */
+    searchMemory(keyword: string, limit?: number): Array<{
+        date: string;
+        snippet: string;
+    }>;
+    /**
+     * Save session summary to memory
+     */
+    saveSessionSummary(summary: string, metadata?: Record<string, any>): void;
+    /**
+     * Save a note to memory
+     */
+    saveNote(note: string, metadata?: Record<string, any>): void;
+    /**
+     * Save a decision to memory
+     */
+    saveDecision(decision: string, metadata?: Record<string, any>): void;
+}

package/dist/services/memory-service.js

@@ -0,0 +1,183 @@
+/**
+ * Memory service for Studiograph
+ *
+ * Manages daily memory files similar to OpenClaw:
+ * - memory/YYYY-MM-DD.md for each day
+ * - Loads today + yesterday at session start
+ * - Appends conversation context throughout the day
+ */
+import { existsSync, mkdirSync, readFileSync, appendFileSync, writeFileSync, readdirSync } from 'fs';
+import { join } from 'path';
+export class MemoryService {
+    workspacePath;
+    memoryDir;
+    constructor(workspacePath) {
+        this.workspacePath = workspacePath;
+        this.memoryDir = join(workspacePath, '.studiograph', 'memory');
+        this.ensureMemoryDir();
+    }
+    /**
+     * Ensure memory directory exists
+     */
+    ensureMemoryDir() {
+        if (!existsSync(this.memoryDir)) {
+            mkdirSync(this.memoryDir, { recursive: true });
+        }
+    }
+    /**
+     * Get daily memory file path for a given date
+     */
+    getDailyMemoryPath(date) {
+        const dateStr = date.toISOString().split('T')[0]; // YYYY-MM-DD
+        return join(this.memoryDir, `${dateStr}.md`);
+    }
+    /**
+     * Format timestamp for memory entry
+     */
+    formatTimestamp(date) {
+        return date.toISOString().replace('T', ' ').split('.')[0] + ' UTC';
+    }
+    /**
+     * Write entry to today's memory file
+     */
+    writeMemory(entry) {
+        const memoryPath = this.getDailyMemoryPath(entry.timestamp);
+        const timestamp = this.formatTimestamp(entry.timestamp);
+        // Format entry as markdown
+        const lines = [
+            `## ${timestamp} - ${entry.type}`,
+            '',
+            entry.content,
+            '',
+        ];
+        // Add metadata if present
+        if (entry.metadata) {
+            lines.push('**Metadata:**');
+            for (const [key, value] of Object.entries(entry.metadata)) {
+                lines.push(`- **${key}**: ${value}`);
+            }
+            lines.push('');
+        }
+        lines.push('---', '');
+        const entryText = lines.join('\n');
+        // Append to file (or create if doesn't exist)
+        if (!existsSync(memoryPath)) {
+            const header = `# Memory - ${entry.timestamp.toISOString().split('T')[0]}\n\n`;
+            writeFileSync(memoryPath, header + entryText, 'utf-8');
+        }
+        else {
+            appendFileSync(memoryPath, entryText, 'utf-8');
+        }
+    }
+    /**
+     * Read memory for a specific date
+     */
+    readMemory(date) {
+        const memoryPath = this.getDailyMemoryPath(date);
+        if (!existsSync(memoryPath)) {
+            return null;
+        }
+        return readFileSync(memoryPath, 'utf-8');
+    }
+    /**
+     * Read today's memory
+     */
+    readToday() {
+        return this.readMemory(new Date());
+    }
+    /**
+     * Read yesterday's memory
+     */
+    readYesterday() {
+        const yesterday = new Date();
+        yesterday.setDate(yesterday.getDate() - 1);
+        return this.readMemory(yesterday);
+    }
+    /**
+     * Load recent memory (today + yesterday)
+     */
+    loadRecentMemory() {
+        const parts = [];
+        const yesterday = this.readYesterday();
+        if (yesterday) {
+            parts.push('# Yesterday\n', yesterday, '\n');
+        }
+        const today = this.readToday();
+        if (today) {
+            parts.push('# Today\n', today, '\n');
+        }
+        if (parts.length === 0) {
+            return '# No recent memory\n\nNo memory entries from today or yesterday.';
+        }
+        return parts.join('\n');
+    }
+    /**
+     * List all memory files
+     */
+    listMemoryFiles() {
+        if (!existsSync(this.memoryDir)) {
+            return [];
+        }
+        return readdirSync(this.memoryDir)
+            .filter(file => file.endsWith('.md'))
+            .sort()
+            .reverse(); // Most recent first
+    }
+    /**
+     * Search memory files for a keyword
+     */
+    searchMemory(keyword, limit = 10) {
+        const files = this.listMemoryFiles().slice(0, limit);
+        const results = [];
+        for (const file of files) {
+            const filePath = join(this.memoryDir, file);
+            const content = readFileSync(filePath, 'utf-8');
+            if (content.toLowerCase().includes(keyword.toLowerCase())) {
+                // Extract snippet around keyword
+                const lines = content.split('\n');
+                const matchingLines = lines.filter(line => line.toLowerCase().includes(keyword.toLowerCase()));
+                if (matchingLines.length > 0) {
+                    results.push({
+                        date: file.replace('.md', ''),
+                        snippet: matchingLines.slice(0, 3).join('\n'),
+                    });
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * Save session summary to memory
+     */
+    saveSessionSummary(summary, metadata) {
+        this.writeMemory({
+            timestamp: new Date(),
+            type: 'conversation',
+            content: summary,
+            metadata,
+        });
+    }
+    /**
+     * Save a note to memory
+     */
+    saveNote(note, metadata) {
+        this.writeMemory({
+            timestamp: new Date(),
+            type: 'note',
+            content: note,
+            metadata,
+        });
+    }
+    /**
+     * Save a decision to memory
+     */
+    saveDecision(decision, metadata) {
+        this.writeMemory({
+            timestamp: new Date(),
+            type: 'decision',
+            content: decision,
+            metadata,
+        });
+    }
+}
+//# sourceMappingURL=memory-service.js.map

package/dist/services/memory-service.js.map

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

package/dist/utils/git.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Thin wrappers around git shell operations.
+ * Extracted so tests can mock them without mocking the built-in child_process.
+ */
+export type PullResult = 'updated' | 'up-to-date' | 'conflict';
+export type PushResult = 'pushed' | 'nothing-to-push';
+/**
+ * Pull the latest changes in a local git repo.
+ * Returns 'updated', 'up-to-date', or 'conflict'.
+ * Throws on hard errors (no remote, auth failure, etc.).
+ */
+export declare function gitPull(repoPath: string): PullResult;
+/**
+ * Push local commits in a git repo to its remote.
+ * Returns 'pushed' or 'nothing-to-push'.
+ * Throws on errors (no remote, auth failure, etc.).
+ */
+export declare function gitPush(repoPath: string): PushResult;
+/**
+ * Clone a remote repository to a local path.
+ * Throws if the git command fails.
+ */
+export declare function gitClone(remoteUrl: string, localPath: string): void;
+/**
+ * Read a git config value.
+ * Returns undefined if the key is not set.
+ */
+export declare function getGitConfig(key: string): string | undefined;