studiograph 1.1.2 → 1.2.0-beta.1

package/dist/cli/commands/deploy.js

@@ -0,0 +1,153 @@
+/**
+ * studiograph deploy — guided deployment wizard
+ *
+ * Currently supports Railway. Additional targets (Render, Fly) can be added
+ * as subcommands following the same pattern.
+ *
+ * Usage:
+ *   studiograph deploy railway
+ */
+import { Command } from 'commander';
+import { intro, outro, text, confirm, log, spinner } from '@clack/prompts';
+import { randomBytes } from 'crypto';
+import { spawnSync } from 'child_process';
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { gitClone } from '../../utils/git.js';
+// ── helpers ──────────────────────────────────────────────────────────────────
+function openBrowser(url) {
+    const cmd = process.platform === 'darwin' ? 'open' : 'xdg-open';
+    spawnSync(cmd, [url], { stdio: 'ignore' });
+}
+function generateSecret() {
+    return randomBytes(20).toString('hex');
+}
+/** Inject a GitHub token into an https:// URL for authenticated clone. */
+function authedUrl(url, token) {
+    return url.startsWith('https://')
+        ? url.replace('https://', `https://${token}@`)
+        : url;
+}
+function readWorkspaceRepos(configRepoUrl, githubToken) {
+    // Clone to a temp path so we can read workspace.json
+    const tmpDir = `/tmp/studiograph-deploy-${Date.now()}`;
+    try {
+        gitClone(authedUrl(configRepoUrl, githubToken), tmpDir);
+        const jsonPath = join(tmpDir, 'workspace.json');
+        if (!existsSync(jsonPath))
+            return [];
+        const config = JSON.parse(readFileSync(jsonPath, 'utf-8'));
+        return (config.repos ?? []);
+    }
+    catch {
+        return [];
+    }
+}
+// ── deploy command group ──────────────────────────────────────────────────────
+export const deployCommand = new Command('deploy')
+    .description('Deploy Studiograph to a hosting platform');
+// ── studiograph deploy railway ────────────────────────────────────────────────
+deployCommand
+    .command('railway')
+    .description('Guided setup wizard for deploying Studiograph to Railway')
+    .action(async () => {
+    intro('Deploy Studiograph to Railway');
+    log.message('This wizard walks you through deploying Studiograph to Railway in four steps.\n' +
+        'You\'ll need a Railway account (railway.app) and your GitHub repos set up.\n');
+    // ── Step 1: GitHub token ──────────────────────────────────────────────
+    log.step('Step 1 of 4 — GitHub token');
+    log.message('Studiograph needs a GitHub fine-grained PAT to clone your private repos at startup.\n' +
+        'Opening GitHub → Settings → Developer Settings → Fine-grained personal access tokens...\n\n' +
+        '  Create a token with these permissions:\n' +
+        '    Repository access: All repositories (or select specific ones)\n' +
+        '    Permissions: Contents → Read-only\n');
+    openBrowser('https://github.com/settings/personal-access-tokens/new');
+    const githubToken = await text({
+        message: 'Paste your GitHub token',
+        placeholder: 'github_pat_...',
+        validate: (v) => v.trim() ? undefined : 'Required',
+    });
+    if (typeof githubToken === 'symbol') {
+        outro('Cancelled');
+        process.exit(0);
+    }
+    // ── Step 2: Configuration ─────────────────────────────────────────────
+    log.step('Step 2 of 4 — Workspace configuration');
+    const configRepoUrl = await text({
+        message: 'Config repo URL (your .studiograph GitHub repo)',
+        placeholder: 'https://github.com/your-org/.studiograph.git',
+        validate: (v) => v.trim() ? undefined : 'Required',
+    });
+    if (typeof configRepoUrl === 'symbol') {
+        outro('Cancelled');
+        process.exit(0);
+    }
+    const apiKeysInput = await text({
+        message: 'API keys for client access (comma-separated, leave blank to skip)',
+        placeholder: 'key1,key2',
+    });
+    if (typeof apiKeysInput === 'symbol') {
+        outro('Cancelled');
+        process.exit(0);
+    }
+    const apiKeys = (apiKeysInput || '')
+        .split(',')
+        .map(k => k.trim())
+        .filter(k => k.length > 0)
+        .join(';');
+    const webhookSecret = generateSecret();
+    // ── Step 3: Railway setup ─────────────────────────────────────────────
+    log.step('Step 3 of 4 — Railway project setup');
+    log.message('Opening Railway — create a new project from this GitHub repo.\n');
+    openBrowser('https://railway.app/new');
+    log.message('In your Railway project:\n\n' +
+        '  1. Add a persistent volume and mount it at /workspace\n\n' +
+        '  2. Set the start command:\n' +
+        '       studiograph serve\n\n' +
+        '  3. Set these environment variables:\n\n' +
+        `     STUDIOGRAPH_CONFIG_REPO = ${configRepoUrl}\n` +
+        `     GITHUB_TOKEN            = ${githubToken}\n` +
+        (apiKeys ? `     API_KEYS                = ${apiKeys}\n` : '') +
+        `     WEBHOOK_SECRET          = ${webhookSecret}\n` +
+        '     PORT                    = 3001\n');
+    await confirm({ message: 'Done setting up Railway? Press Enter to continue.' });
+    // ── Step 4: GitHub webhooks ───────────────────────────────────────────
+    log.step('Step 4 of 4 — GitHub webhooks');
+    log.message('Reading your workspace repos to generate webhook URLs...');
+    const s = spinner();
+    s.start('Cloning config repo to read workspace.json...');
+    const repos = readWorkspaceRepos(configRepoUrl, githubToken.trim());
+    s.stop(repos.length > 0 ? `Found ${repos.length} repos` : 'Could not read repos — enter your Railway URL manually');
+    const railwayUrl = await text({
+        message: 'Your Railway app URL',
+        placeholder: 'https://your-app.up.railway.app',
+        validate: (v) => v.trim() ? undefined : 'Required',
+    });
+    if (typeof railwayUrl === 'symbol') {
+        outro('Cancelled');
+        process.exit(0);
+    }
+    const webhookUrl = `${railwayUrl.replace(/\/$/, '')}/webhooks/github`;
+    log.message('Add a webhook to each GitHub repo in your workspace:\n\n' +
+        `  Payload URL:  ${webhookUrl}\n` +
+        `  Content type: application/json\n` +
+        `  Secret:       ${webhookSecret}\n` +
+        '  Events:       Just the push event\n\n' +
+        'Repos to configure:\n' +
+        (repos.length > 0
+            ? repos
+                .filter(r => r.github_url)
+                .map(r => `  • ${r.github_url}`)
+                .join('\n')
+            : '  (add webhooks to all repos in your workspace)'));
+    log.message('\nFor each repo, go to:\n' +
+        '  GitHub repo → Settings → Webhooks → Add webhook');
+    openBrowser('https://github.com');
+    await confirm({ message: 'Webhooks configured? Press Enter to finish.' });
+    outro(`✨ All done!\n\n` +
+        `  Server:   ${railwayUrl}\n` +
+        `  Graph API: ${railwayUrl}/api/repos\n\n` +
+        'On Railway\'s next deploy, Studiograph will bootstrap automatically:\n' +
+        'clone your config repo, clone your workspace repos, and start serving.');
+});
+//# sourceMappingURL=deploy.js.map

package/dist/cli/commands/deploy.js.map

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

package/dist/cli/commands/enrich.d.ts

@@ -0,0 +1,11 @@
+/**
+ * studiograph enrich
+ *
+ * Enrich existing entities with cross-source context via LLM.
+ *
+ *   studiograph enrich              — run enrichment, write in-place
+ *   studiograph enrich commit       — git commit across affected repos
+ *   studiograph enrich abort        — git checkout -- . across repos
+ */
+import { Command } from 'commander';
+export declare const enrichCommand: Command;

package/dist/cli/commands/enrich.js

@@ -0,0 +1,135 @@
+/**
+ * studiograph enrich
+ *
+ * Enrich existing entities with cross-source context via LLM.
+ *
+ *   studiograph enrich              — run enrichment, write in-place
+ *   studiograph enrich commit       — git commit across affected repos
+ *   studiograph enrich abort        — git checkout -- . across repos
+ */
+import { Command } from 'commander';
+import { execSync } from 'child_process';
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { Workspace } from '../../core/workspace.js';
+import { runEnrichment } from '../../services/sync/enrichment.js';
+import { runReview } from './review.js';
+export const enrichCommand = new Command('enrich')
+    .description('Enrich entities with cross-source context');
+// ── enrich (run) ─────────────────────────────────────────────────────────────
+enrichCommand
+    .command('run', { isDefault: true })
+    .description('Run LLM enrichment on entities with low completeness')
+    .option('--entity-types <types...>', 'Only enrich specific entity types')
+    .option('--dry-run', 'Preview without writing changes')
+    .option('--min-refs <n>', 'Minimum context references required', '2')
+    .option('--max-completeness <n>', 'Maximum completeness to qualify', '0.6')
+    .action(async (opts) => {
+    const workspace = new Workspace(process.cwd());
+    if (!workspace.isWorkspace()) {
+        console.error('Not in a Studiograph workspace.');
+        process.exit(1);
+    }
+    try {
+        const config = await workspace.loadConfig();
+        const result = await runEnrichment({
+            workspacePath: process.cwd(),
+            entityTypes: opts.entityTypes,
+            dryRun: opts.dryRun,
+            minRefs: parseInt(opts.minRefs ?? '2', 10),
+            maxCompleteness: parseFloat(opts.maxCompleteness ?? '0.6'),
+            schemaExtensions: config.schema_extensions,
+        }, (msg) => console.log(msg));
+        console.log(`\nDone: ${result.enriched} enriched, ${result.skipped} skipped, ${result.errors.length} errors`);
+        if (result.enriched > 0 && !opts.dryRun) {
+            console.log('\nNext: studiograph review         (inspect changes)');
+            console.log('Then: studiograph commit         (git commit)');
+            console.log('Or:   studiograph enrich abort   (discard changes)');
+        }
+    }
+    catch (err) {
+        console.error('Enrichment failed:', err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+});
+// ── enrich commit (deprecated) ───────────────────────────────────────────────
+enrichCommand
+    .command('commit')
+    .description('Git commit enrichment changes across repos (deprecated: use studiograph commit)')
+    .action(async () => {
+    console.log('Note: "enrich commit" is deprecated. Use "studiograph commit" instead.\n');
+    const workspace = new Workspace(process.cwd());
+    if (!workspace.isWorkspace()) {
+        console.error('Not in a Studiograph workspace.');
+        process.exit(1);
+    }
+    try {
+        const config = await workspace.loadConfig();
+        const repos = config.repos ?? [];
+        for (const repo of repos) {
+            const repoPath = join(process.cwd(), repo.path);
+            if (!existsSync(repoPath))
+                continue;
+            try {
+                // Check for changes
+                const status = execSync('git status --porcelain', { cwd: repoPath, encoding: 'utf-8' }).trim();
+                if (!status)
+                    continue;
+                execSync('git add -A', { cwd: repoPath });
+                execSync('git commit -m "Enrich entities with cross-source context"', { cwd: repoPath });
+                console.log(`Committed changes in ${repo.name}`);
+            }
+            catch {
+                // skip repos without git or without changes
+            }
+        }
+        console.log('Enrichment changes committed.');
+    }
+    catch (err) {
+        console.error('Commit failed:', err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+});
+// ── enrich abort ─────────────────────────────────────────────────────────────
+enrichCommand
+    .command('abort')
+    .description('Discard enrichment changes')
+    .action(async () => {
+    const workspace = new Workspace(process.cwd());
+    if (!workspace.isWorkspace()) {
+        console.error('Not in a Studiograph workspace.');
+        process.exit(1);
+    }
+    try {
+        const config = await workspace.loadConfig();
+        const repos = config.repos ?? [];
+        for (const repo of repos) {
+            const repoPath = join(process.cwd(), repo.path);
+            if (!existsSync(repoPath))
+                continue;
+            try {
+                execSync('git checkout -- .', { cwd: repoPath });
+                console.log(`Reverted changes in ${repo.name}`);
+            }
+            catch {
+                // skip repos without git
+            }
+        }
+        console.log('Enrichment changes discarded.');
+    }
+    catch (err) {
+        console.error('Abort failed:', err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+});
+// ── enrich review (delegates to top-level review command) ───────────────────
+enrichCommand
+    .command('review')
+    .description('Review entity changes (alias for studiograph review)')
+    .option('--type <entity_type>', 'Show colored diff for an entity type')
+    .option('--file <path>', 'Show colored diff for a specific file')
+    .option('--committed', 'Review last commit instead of uncommitted changes')
+    .action(async (opts) => {
+    await runReview(opts);
+});
+//# sourceMappingURL=enrich.js.map

package/dist/cli/commands/enrich.js.map

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

package/dist/cli/commands/graphrag.d.ts

@@ -0,0 +1,12 @@
+/**
+ * studiograph graphrag
+ *
+ * Manage the in-process knowledge graph for cross-document entity context.
+ *
+ *   studiograph graphrag setup          — enable GraphRAG
+ *   studiograph graphrag index <path>   — index a directory of markdown files
+ *   studiograph graphrag status         — show graph stats
+ *   studiograph graphrag query <name>   — look up an entity and its neighbors
+ */
+import { Command } from 'commander';
+export declare const graphragCommand: Command;

package/dist/cli/commands/graphrag.js

@@ -0,0 +1,122 @@
+/**
+ * studiograph graphrag
+ *
+ * Manage the in-process knowledge graph for cross-document entity context.
+ *
+ *   studiograph graphrag setup          — enable GraphRAG
+ *   studiograph graphrag index <path>   — index a directory of markdown files
+ *   studiograph graphrag status         — show graph stats
+ *   studiograph graphrag query <name>   — look up an entity and its neighbors
+ */
+import { Command } from 'commander';
+import { loadGraphRAGConfig, saveGraphRAGConfig, } from '../../services/sync/graphrag-config.js';
+import { indexIntoGraphRAG } from '../../services/sync/graphrag-indexer.js';
+import { GraphRAGClient } from '../../services/sync/graphrag-client.js';
+export const graphragCommand = new Command('graphrag')
+    .description('Manage the knowledge graph for cross-document context');
+// ── setup ───────────────────────────────────────────────────────────────────
+graphragCommand
+    .command('setup')
+    .description('Enable GraphRAG and configure graph path')
+    .option('--graph-path <path>', 'Custom path for graph.json')
+    .action(async (opts) => {
+    const config = loadGraphRAGConfig();
+    config.enabled = true;
+    if (opts.graphPath) {
+        config.graph_path = opts.graphPath;
+    }
+    saveGraphRAGConfig(config);
+    console.log('GraphRAG enabled.');
+    console.log(`Graph path: ${config.graph_path}`);
+    console.log('\nNext: studiograph graphrag index <path>');
+});
+// ── index ───────────────────────────────────────────────────────────────────
+graphragCommand
+    .command('index <path>')
+    .description('Index markdown files from a directory into the knowledge graph')
+    .option('--incremental', 'Merge into existing graph instead of replacing')
+    .action(async (sourcePath, opts) => {
+    const config = loadGraphRAGConfig();
+    if (!config.enabled) {
+        console.error('GraphRAG is not enabled. Run: studiograph graphrag setup');
+        process.exit(1);
+    }
+    try {
+        const result = await indexIntoGraphRAG({
+            sourcePath,
+            config,
+            incremental: opts.incremental,
+            onProgress: (msg) => console.log(msg),
+        });
+        console.log(`\nDone: ${result.files_processed} files → ${result.entities_extracted} entities, ${result.relationships_extracted} relationships`);
+    }
+    catch (err) {
+        console.error('Indexing failed:', err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+});
+// ── status ──────────────────────────────────────────────────────────────────
+graphragCommand
+    .command('status')
+    .description('Show knowledge graph stats')
+    .action(async () => {
+    const config = loadGraphRAGConfig();
+    console.log(`Enabled: ${config.enabled}`);
+    console.log(`Graph path: ${config.graph_path}`);
+    if (!config.enabled)
+        return;
+    try {
+        const client = new GraphRAGClient(config);
+        const stats = client.getStats();
+        console.log(`\nNodes: ${stats.nodes}`);
+        console.log(`Edges: ${stats.edges}`);
+        if (stats.types.length > 0) {
+            console.log(`Entity types: ${stats.types.join(', ')}`);
+        }
+        if (config.last_indexed) {
+            console.log(`Last indexed: ${config.last_indexed}`);
+        }
+        if (config.files_indexed) {
+            console.log(`Files indexed: ${config.files_indexed}`);
+        }
+    }
+    catch (err) {
+        console.error('Could not load graph:', err instanceof Error ? err.message : String(err));
+    }
+});
+// ── query ───────────────────────────────────────────────────────────────────
+graphragCommand
+    .command('query <name>')
+    .description('Look up an entity and show its neighbors')
+    .action(async (name) => {
+    const config = loadGraphRAGConfig();
+    if (!config.enabled) {
+        console.error('GraphRAG is not enabled. Run: studiograph graphrag setup');
+        process.exit(1);
+    }
+    const client = new GraphRAGClient(config);
+    const result = client.queryNode(name);
+    if (!result) {
+        console.log(`No entity found matching "${name}"`);
+        return;
+    }
+    console.log(`\n${result.node.name} (${result.node.type})`);
+    if (result.node.description) {
+        console.log(`  ${result.node.description}`);
+    }
+    if (result.neighbors.length > 0) {
+        console.log(`\nNeighbors (${result.neighbors.length}):`);
+        for (const n of result.neighbors) {
+            const desc = n.description ? ` — ${n.description}` : '';
+            console.log(`  ${n.name} (${n.type})${desc}`);
+        }
+    }
+    if (result.edges.length > 0) {
+        console.log(`\nRelationships (${result.edges.length}):`);
+        for (const e of result.edges) {
+            const desc = e.description ? `: ${e.description}` : '';
+            console.log(`  ${e.source} → ${e.target}${desc}`);
+        }
+    }
+});
+//# sourceMappingURL=graphrag.js.map

package/dist/cli/commands/graphrag.js.map

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

package/dist/cli/commands/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * studiograph index command
+ *
+ * Bulk-indexes all entities across the workspace into LanceDB.
+ * On first run, optionally prompts for a Voyage AI API key to enable
+ * semantic search (Tier 2). Without a key, FTS-only indexing still runs.
+ *
+ * Safe to re-run — uses upsert, not insert.
+ *
+ * Usage:
+ *   studiograph index              # index all repos
+ *   studiograph index --repo raa   # single repo only
+ */
+import { Command } from 'commander';
+export declare const indexCommand: Command;

package/dist/cli/commands/index.js

@@ -0,0 +1,117 @@
+/**
+ * studiograph index command
+ *
+ * Bulk-indexes all entities across the workspace into LanceDB.
+ * On first run, optionally prompts for a Voyage AI API key to enable
+ * semantic search (Tier 2). Without a key, FTS-only indexing still runs.
+ *
+ * Safe to re-run — uses upsert, not insert.
+ *
+ * Usage:
+ *   studiograph index              # index all repos
+ *   studiograph index --repo raa   # single repo only
+ */
+import { Command } from 'commander';
+import { join } from 'path';
+import { homedir } from 'os';
+import { select, text, spinner, log, outro } from '@clack/prompts';
+import { Workspace } from '../../core/workspace.js';
+import { loadUserConfig, saveUserConfig } from '../../core/user-config.js';
+import { VectorService } from '../../services/vector-service.js';
+import { BaseGraphManager } from '../../core/graph.js';
+export const indexCommand = new Command('index')
+    .description('Index workspace entities for search (FTS + optional semantic search)')
+    .option('--repo <name>', 'Index a single repo only')
+    .action(async (opts) => {
+    const workspace = new Workspace();
+    if (!workspace.isWorkspace()) {
+        console.error('❌ Not a Studiograph workspace. Run `studiograph init` first.');
+        process.exit(1);
+    }
+    const config = await workspace.loadConfig();
+    const userConfig = loadUserConfig();
+    // First-run: prompt for Voyage AI key if not configured
+    if (!userConfig.voyage_api_key) {
+        const choice = await select({
+            message: 'Enable semantic search? (optional — requires a Voyage AI API key)',
+            options: [
+                {
+                    value: 'skip',
+                    label: 'Skip — use keyword/FTS search only',
+                    hint: 'Free, no setup required',
+                },
+                {
+                    value: 'voyage',
+                    label: 'Enable semantic search',
+                    hint: 'Voyage AI key required — get one at voyageai.com',
+                },
+            ],
+        });
+        if (typeof choice === 'symbol') {
+            outro('Cancelled');
+            process.exit(0);
+        }
+        if (choice === 'voyage') {
+            const keyInput = await text({
+                message: 'Enter your Voyage AI API key:',
+                placeholder: 'pa-...',
+                validate: (value) => {
+                    if (!value || value.length < 10)
+                        return 'Key seems too short';
+                },
+            });
+            if (typeof keyInput !== 'string') {
+                outro('Cancelled');
+                process.exit(0);
+            }
+            userConfig.voyage_api_key = keyInput;
+            saveUserConfig(userConfig);
+            log.success('Voyage AI key saved');
+        }
+    }
+    const dbPath = userConfig.vector_db_path || join(homedir(), '.studiograph', 'vector');
+    const vectorService = new VectorService(dbPath, userConfig.voyage_api_key);
+    await vectorService.init();
+    const repos = opts.repo
+        ? config.repos.filter(r => r.name === opts.repo)
+        : config.repos;
+    if (opts.repo && repos.length === 0) {
+        console.error(`❌ Repo "${opts.repo}" not found in workspace`);
+        process.exit(1);
+    }
+    const s = spinner();
+    let totalIndexed = 0;
+    let totalWithVectors = 0;
+    for (const repo of repos) {
+        const repoPath = join(workspace.getWorkspacePath(), repo.path);
+        s.start(`Indexing ${repo.name}...`);
+        try {
+            const graph = new BaseGraphManager({
+                repoPath,
+                repoName: repo.name,
+                gitUser: { id: 'index', name: 'index', email: 'index@studiograph.local' },
+            });
+            const entities = graph.list();
+            if (entities.length === 0) {
+                s.stop(`${repo.name}: no entities`);
+                vectorService.setLastIndexedTime(repo.name);
+                continue;
+            }
+            s.message(`Indexing ${repo.name}: ${entities.length} entities...`);
+            await vectorService.upsertMany(repo.name, entities);
+            vectorService.setLastIndexedTime(repo.name);
+            const withVectors = userConfig.voyage_api_key ? entities.length : 0;
+            totalIndexed += entities.length;
+            totalWithVectors += withVectors;
+            s.stop(`${repo.name}: indexed ${entities.length} entities`);
+        }
+        catch (err) {
+            s.stop(`${repo.name}: failed — ${err instanceof Error ? err.message : 'unknown error'}`);
+        }
+    }
+    const vectorNote = userConfig.voyage_api_key
+        ? ` (${totalWithVectors} with semantic vectors)`
+        : ' (FTS only — add voyage_api_key to enable semantic search)';
+    outro(`✓ Indexed ${totalIndexed} entities across ${repos.length} repo${repos.length === 1 ? '' : 's'}${vectorNote}`);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/commands/index.js.map

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