studiograph 1.0.0

package/dist/services/git.js

@@ -0,0 +1,306 @@
+/**
+ * Git service for Studiograph
+ *
+ * Handles Git operations with transaction-based commits,
+ * proper user attribution, and security.
+ */
+import { execSync } from 'child_process';
+import { existsSync, statSync } from 'fs';
+import { join } from 'path';
+export class GitService {
+    repoPath;
+    constructor(repoPath) {
+        this.repoPath = repoPath;
+        this.ensureValidPath();
+        this.initializeIfNeeded();
+    }
+    /**
+     * Ensure the repo path exists and is a directory
+     */
+    ensureValidPath() {
+        if (!existsSync(this.repoPath)) {
+            throw new Error(`Repository path does not exist: ${this.repoPath}`);
+        }
+        const stats = statSync(this.repoPath);
+        if (!stats.isDirectory()) {
+            throw new Error(`Repository path is not a directory: ${this.repoPath}`);
+        }
+    }
+    /**
+     * Initialize Git repository if not already initialized
+     */
+    initializeIfNeeded() {
+        const gitDir = join(this.repoPath, '.git');
+        if (!existsSync(gitDir)) {
+            try {
+                execSync('git init', { cwd: this.repoPath, stdio: 'pipe' });
+                // Set default branch to main
+                execSync('git branch -M main', { cwd: this.repoPath, stdio: 'pipe' });
+                // Create initial .gitignore if it doesn't exist
+                const gitignorePath = join(this.repoPath, '.gitignore');
+                if (!existsSync(gitignorePath)) {
+                    execSync('echo ".DS_Store\n*.tmp\n*.log" > .gitignore', {
+                        cwd: this.repoPath,
+                        stdio: 'pipe'
+                    });
+                }
+            }
+            catch (error) {
+                throw new Error(`Failed to initialize Git repository: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            }
+        }
+    }
+    /**
+     * Check if repository has any commits
+     */
+    hasCommits() {
+        try {
+            execSync('git rev-parse HEAD', { cwd: this.repoPath, stdio: 'pipe' });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get current branch name
+     */
+    getCurrentBranch() {
+        try {
+            return execSync('git rev-parse --abbrev-ref HEAD', {
+                cwd: this.repoPath,
+                encoding: 'utf-8',
+            }).trim();
+        }
+        catch (error) {
+            throw new Error(`Failed to get current branch: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Create a transaction for batched commits
+     */
+    createTransaction() {
+        return new GitTransaction(this.repoPath);
+    }
+    /**
+     * Get commit history
+     */
+    getHistory(limit = 10) {
+        if (!this.hasCommits()) {
+            return [];
+        }
+        try {
+            const output = execSync(`git log --pretty=format:"%H|%an|%ae|%at|%s" -n ${limit}`, { cwd: this.repoPath, encoding: 'utf-8' });
+            if (!output) {
+                return [];
+            }
+            return output.split('\n').map(line => {
+                const [hash, name, email, timestamp, message] = line.split('|');
+                return {
+                    hash,
+                    author: { name, email },
+                    timestamp: parseInt(timestamp) * 1000, // Convert to milliseconds
+                    message
+                };
+            });
+        }
+        catch (error) {
+            throw new Error(`Failed to get commit history: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Get file history for a specific file
+     */
+    getFileHistory(filePath, limit = 10) {
+        if (!this.hasCommits()) {
+            return [];
+        }
+        try {
+            const output = execSync(`git log --pretty=format:"%H|%an|%ae|%at|%s" -n ${limit} -- ${escapeShellArg(filePath)}`, { cwd: this.repoPath, encoding: 'utf-8' });
+            if (!output) {
+                return [];
+            }
+            return output.split('\n').map(line => {
+                const [hash, name, email, timestamp, message] = line.split('|');
+                return {
+                    hash,
+                    author: { name, email },
+                    timestamp: parseInt(timestamp) * 1000,
+                    message
+                };
+            });
+        }
+        catch (error) {
+            throw new Error(`Failed to get file history: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Get current status (modified, added, deleted files)
+     */
+    getStatus() {
+        try {
+            const output = execSync('git status --porcelain', {
+                cwd: this.repoPath,
+                encoding: 'utf-8',
+            });
+            const modified = [];
+            const added = [];
+            const deleted = [];
+            const untracked = [];
+            output.split('\n').forEach(line => {
+                if (!line)
+                    return;
+                const status = line.substring(0, 2);
+                const file = line.substring(3);
+                if (status === ' M' || status === 'M ') {
+                    modified.push(file);
+                }
+                else if (status === 'A ') {
+                    added.push(file);
+                }
+                else if (status === ' D' || status === 'D ') {
+                    deleted.push(file);
+                }
+                else if (status === '??') {
+                    untracked.push(file);
+                }
+            });
+            return { modified, added, deleted, untracked };
+        }
+        catch (error) {
+            throw new Error(`Failed to get status: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Check if there are uncommitted changes
+     */
+    hasUncommittedChanges() {
+        const status = this.getStatus();
+        return (status.modified.length > 0 ||
+            status.added.length > 0 ||
+            status.deleted.length > 0 ||
+            status.untracked.length > 0);
+    }
+}
+/**
+ * Transaction class for batched Git commits
+ */
+export class GitTransaction {
+    repoPath;
+    changes = [];
+    constructor(repoPath) {
+        this.repoPath = repoPath;
+    }
+    /**
+     * Add a change to this transaction
+     */
+    add(change) {
+        this.changes.push(change);
+    }
+    /**
+     * Get all changes in this transaction
+     */
+    getChanges() {
+        return [...this.changes];
+    }
+    /**
+     * Commit all changes in this transaction
+     */
+    async commit(user, message) {
+        if (this.changes.length === 0) {
+            throw new Error('No changes to commit');
+        }
+        // Generate message if not provided
+        const commitMessage = message || this.generateMessage();
+        // Stage all changes
+        try {
+            execSync('git add -A', { cwd: this.repoPath, stdio: 'pipe' });
+        }
+        catch (error) {
+            throw new Error(`Failed to stage changes: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+        // Check if there are actual changes staged
+        try {
+            execSync('git diff --staged --quiet', { cwd: this.repoPath, stdio: 'pipe' });
+            // No changes staged
+            console.warn('No actual changes to commit (files may be unchanged)');
+            this.changes = [];
+            return;
+        }
+        catch {
+            // Changes exist, proceed with commit
+        }
+        // Commit with proper attribution and escaping
+        const escapedMessage = escapeShellArg(commitMessage);
+        const authorString = `${user.name} <${user.email}>`;
+        const escapedAuthor = escapeShellArg(authorString);
+        try {
+            execSync(`git commit -m ${escapedMessage} --author=${escapedAuthor}`, { cwd: this.repoPath, stdio: 'pipe' });
+        }
+        catch (error) {
+            throw new Error(`Failed to commit changes: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+        // Clear changes after successful commit
+        this.changes = [];
+    }
+    /**
+     * Generate commit message from changes
+     */
+    generateMessage() {
+        const creates = this.changes.filter(c => c.operation === 'create');
+        const updates = this.changes.filter(c => c.operation === 'update');
+        const deletes = this.changes.filter(c => c.operation === 'delete');
+        const parts = [];
+        if (creates.length > 0) {
+            const entityTypes = [...new Set(creates.map(c => c.entityType))];
+            if (entityTypes.length === 1 && creates.length === 1) {
+                parts.push(`Create ${creates[0].entityType}: ${creates[0].entityId}`);
+            }
+            else {
+                parts.push(`Create ${creates.length} ${creates.length === 1 ? 'entity' : 'entities'}`);
+            }
+        }
+        if (updates.length > 0) {
+            const entityTypes = [...new Set(updates.map(c => c.entityType))];
+            if (entityTypes.length === 1 && updates.length === 1) {
+                parts.push(`Update ${updates[0].entityType}: ${updates[0].entityId}`);
+            }
+            else {
+                parts.push(`Update ${updates.length} ${updates.length === 1 ? 'entity' : 'entities'}`);
+            }
+        }
+        if (deletes.length > 0) {
+            const entityTypes = [...new Set(deletes.map(c => c.entityType))];
+            if (entityTypes.length === 1 && deletes.length === 1) {
+                parts.push(`Delete ${deletes[0].entityType}: ${deletes[0].entityId}`);
+            }
+            else {
+                parts.push(`Delete ${deletes.length} ${deletes.length === 1 ? 'entity' : 'entities'}`);
+            }
+        }
+        return parts.join(', ');
+    }
+    /**
+     * Rollback all changes (git reset)
+     */
+    async rollback() {
+        try {
+            execSync('git reset --hard HEAD', { cwd: this.repoPath, stdio: 'pipe' });
+            execSync('git clean -fd', { cwd: this.repoPath, stdio: 'pipe' });
+            this.changes = [];
+        }
+        catch (error) {
+            throw new Error(`Failed to rollback changes: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+}
+/**
+ * Escape shell arguments to prevent command injection
+ */
+function escapeShellArg(arg) {
+    // Replace double quotes with escaped double quotes
+    const escaped = arg.replace(/"/g, '\\"');
+    // Wrap in double quotes
+    return `"${escaped}"`;
+}
+//# sourceMappingURL=git.js.map

package/dist/services/git.js.map

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

package/dist/services/github-provisioner.d.ts

@@ -0,0 +1,30 @@
+/**
+ * GitHub repository provisioner
+ *
+ * Creates GitHub repos for each repo in a workspace config and pushes
+ * local content to them. Called from the `init` command when the user
+ * opts into GitHub provisioning.
+ */
+import { Octokit } from '@octokit/rest';
+import { WorkspaceConfig } from '../core/types.js';
+/**
+ * Provision all repos in a workspace on GitHub, then push local content.
+ * Updates github_url in workspace.json for each repo created.
+ */
+export declare function provisionWorkspace(options: {
+    octokit: Octokit;
+    org: string;
+    workspacePath: string;
+    config: WorkspaceConfig;
+    onProgress?: (message: string) => void;
+}): Promise<WorkspaceConfig>;
+/**
+ * Create a GitHub repository in the given org.
+ * Returns the clone URL (HTTPS).
+ */
+export declare function createGitHubRepo(octokit: Octokit, org: string, name: string, isPrivate: boolean, description?: string): Promise<string>;
+/**
+ * Initialize a local directory as a git repo, add a remote, and push.
+ * If already a git repo, just adds the remote and pushes.
+ */
+export declare function initAndPush(localPath: string, remoteUrl: string): void;

package/dist/services/github-provisioner.js

@@ -0,0 +1,89 @@
+/**
+ * GitHub repository provisioner
+ *
+ * Creates GitHub repos for each repo in a workspace config and pushes
+ * local content to them. Called from the `init` command when the user
+ * opts into GitHub provisioning.
+ */
+import { execSync } from 'child_process';
+import { join } from 'path';
+/**
+ * Provision all repos in a workspace on GitHub, then push local content.
+ * Updates github_url in workspace.json for each repo created.
+ */
+export async function provisionWorkspace(options) {
+    const { octokit, org, workspacePath, config, onProgress } = options;
+    const updatedConfig = {
+        ...config,
+        repos: [...config.repos],
+    };
+    for (let i = 0; i < updatedConfig.repos.length; i++) {
+        const repo = updatedConfig.repos[i];
+        const isPublic = repo.access === 'public';
+        const repoFullName = `${org}/${repo.name}`;
+        onProgress?.(`Creating ${repoFullName}...`);
+        const cloneUrl = await createGitHubRepo(octokit, org, repo.name, !isPublic, repo.description);
+        const localPath = join(workspacePath, repo.path);
+        onProgress?.(`Pushing ${repo.name}...`);
+        initAndPush(localPath, cloneUrl);
+        updatedConfig.repos[i] = { ...repo, github_url: cloneUrl };
+    }
+    return updatedConfig;
+}
+/**
+ * Create a GitHub repository in the given org.
+ * Returns the clone URL (HTTPS).
+ */
+export async function createGitHubRepo(octokit, org, name, isPrivate, description) {
+    try {
+        const { data } = await octokit.rest.repos.createInOrg({
+            org,
+            name,
+            private: isPrivate,
+            description: description ?? '',
+            auto_init: false,
+        });
+        return data.clone_url;
+    }
+    catch (err) {
+        // 422 = repo already exists — fetch and use the existing one
+        if (err?.status === 422) {
+            const { data } = await octokit.rest.repos.get({ owner: org, repo: name });
+            return data.clone_url;
+        }
+        throw err;
+    }
+}
+/**
+ * Initialize a local directory as a git repo, add a remote, and push.
+ * If already a git repo, just adds the remote and pushes.
+ */
+export function initAndPush(localPath, remoteUrl) {
+    const run = (cmd) => execSync(cmd, { cwd: localPath, stdio: 'pipe' });
+    try {
+        run('git rev-parse --git-dir');
+    }
+    catch {
+        run('git init');
+        run('git checkout -b main');
+    }
+    // Remove existing origin if present, then add fresh
+    try {
+        run('git remote remove origin');
+    }
+    catch {
+        // No existing remote — that's fine
+    }
+    run(`git remote add origin ${remoteUrl}`);
+    run('git add .');
+    // Only commit if there is something to commit
+    try {
+        run('git diff --cached --quiet');
+        // Nothing staged — nothing to commit, just push any existing commits
+    }
+    catch {
+        run('git commit -m "Initial commit"');
+    }
+    run('git push -u origin main --force');
+}
+//# sourceMappingURL=github-provisioner.js.map

package/dist/services/github-provisioner.js.map

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

package/dist/services/markdown.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Markdown service for Studiograph
+ *
+ * Handles parsing and writing markdown files with YAML frontmatter,
+ * extracting wikilinks, and validating relationships.
+ */
+export interface MarkdownDocument {
+    frontmatter: Record<string, any>;
+    content: string;
+    wikilinks: string[];
+}
+export interface WikilinkValidation {
+    valid: string[];
+    broken: string[];
+}
+export declare class MarkdownService {
+    /**
+     * Parse markdown file from path
+     */
+    parseFile(filePath: string): MarkdownDocument;
+    /**
+     * Parse markdown content string
+     */
+    parseContent(content: string): MarkdownDocument;
+    /**
+     * Extract wikilinks from markdown content and frontmatter
+     */
+    extractWikilinks(content: string, frontmatter: Record<string, any>): string[];
+    /**
+     * Recursively extract wikilinks from object (frontmatter)
+     */
+    private extractWikilinksFromObject;
+    /**
+     * Write markdown file with frontmatter
+     */
+    writeFile(filePath: string, doc: MarkdownDocument): void;
+    /**
+     * Write markdown content from separate frontmatter and content
+     */
+    write(filePath: string, frontmatter: Record<string, any>, content: string): void;
+    /**
+     * Validate wikilinks against a repo or set of repos
+     */
+    validateWikilinks(wikilinks: string[], searchPaths: string[]): WikilinkValidation;
+    /**
+     * Find entity file by entity ID across multiple search paths
+     */
+    findEntity(entityId: string, searchPaths: string[]): string | null;
+    /**
+     * Find all entities of a given type in a directory
+     */
+    findEntitiesByType(searchPath: string, entityType: string): string[];
+    /**
+     * Find all markdown files in a directory (recursive)
+     */
+    findAllEntities(searchPath: string): string[];
+    /**
+     * Search entities by content or frontmatter
+     */
+    search(searchPaths: string[], query: string, options?: {
+        entityType?: string;
+        caseSensitive?: boolean;
+        searchContent?: boolean;
+        searchFrontmatter?: boolean;
+        limit?: number;
+    }): MarkdownDocument[];
+    /**
+     * Get entity relationships (entities that link to this entity)
+     */
+    findBacklinks(entityId: string, searchPaths: string[]): Array<{
+        file: string;
+        doc: MarkdownDocument;
+    }>;
+    /**
+     * Update wikilinks in a file (useful for refactoring entity IDs)
+     */
+    updateWikilinks(filePath: string, oldEntityId: string, newEntityId: string): void;
+    /**
+     * Recursively update wikilinks in an object (frontmatter)
+     */
+    private updateWikilinksInObject;
+}