studiograph 1.1.1 → 1.1.3

package/dist/cli/commands/app.js

@@ -0,0 +1,167 @@
+/**
+ * studiograph app command
+ *
+ * Manages Studiograph app plugins — install, and in future: list, remove.
+ */
+import { Command } from 'commander';
+import { intro, outro, spinner, confirm, log } from '@clack/prompts';
+import { existsSync, mkdirSync, cpSync, readFileSync, writeFileSync, readdirSync } from 'fs';
+import { join, resolve } from 'path';
+import { execSync } from 'child_process';
+import { Workspace } from '../../core/workspace.js';
+export const appCommand = new Command('app')
+    .description('Manage Studiograph app plugins');
+appCommand
+    .command('install <source>')
+    .description('Install an app plugin from a local directory')
+    .option('--no-commit', 'Skip git commit after installing')
+    .option('--push', 'Push to remote after committing')
+    .action(async (source, options) => {
+    intro('Install App Plugin');
+    // Detect workspace from cwd
+    const workspacePath = process.cwd();
+    const workspace = new Workspace(workspacePath);
+    if (!workspace.isWorkspace()) {
+        outro('❌ Not a Studiograph workspace. Run from your workspace directory.');
+        process.exit(1);
+        return;
+    }
+    const sourceDir = resolve(source);
+    const manifestPath = join(sourceDir, 'app.json');
+    if (!existsSync(manifestPath)) {
+        outro(`❌ No app.json found in ${sourceDir}`);
+        process.exit(1);
+        return;
+    }
+    let manifest;
+    try {
+        manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));
+    }
+    catch {
+        outro(`❌ Could not parse app.json in ${sourceDir}`);
+        process.exit(1);
+        return;
+    }
+    if (!manifest.name || !manifest.plugin || !manifest.mountPath) {
+        outro('❌ app.json is missing required fields: name, plugin, mountPath');
+        process.exit(1);
+        return;
+    }
+    // Step 1: Build (if declared)
+    if (manifest.build) {
+        const buildSpinner = spinner();
+        buildSpinner.start(`Building ${manifest.name}...`);
+        try {
+            execSync(manifest.build, { cwd: sourceDir, stdio: 'pipe' });
+            buildSpinner.stop(`Built ${manifest.name}`);
+        }
+        catch (err) {
+            buildSpinner.stop('Build failed');
+            const stderr = err?.stderr?.toString() ?? '';
+            outro(`❌ Build command failed: ${manifest.build}\n${stderr}`);
+            process.exit(1);
+            return;
+        }
+    }
+    // Step 2: Copy files to .studiograph/apps/<name>/
+    const studiographDir = join(workspacePath, '.studiograph');
+    const destDir = join(studiographDir, 'apps', manifest.name);
+    mkdirSync(destDir, { recursive: true });
+    const installSpinner = spinner();
+    installSpinner.start(`Installing ${manifest.name}...`);
+    const installed = [];
+    // app.json
+    cpSync(manifestPath, join(destDir, 'app.json'));
+    installed.push('app.json');
+    // plugin file (normalise ./prefix)
+    const pluginRelPath = manifest.plugin.replace(/^\.\//, '');
+    const pluginSrc = join(sourceDir, pluginRelPath);
+    if (existsSync(pluginSrc)) {
+        cpSync(pluginSrc, join(destDir, 'plugin.js'));
+        installed.push('plugin.js');
+    }
+    else {
+        installSpinner.stop('');
+        outro(`❌ Plugin file not found: ${pluginSrc}`);
+        process.exit(1);
+        return;
+    }
+    // entity-types.json (optional)
+    if (manifest.entityTypes) {
+        const etSrc = join(sourceDir, manifest.entityTypes.replace(/^\.\//, ''));
+        if (existsSync(etSrc)) {
+            cpSync(etSrc, join(destDir, 'entity-types.json'));
+            installed.push('entity-types.json');
+        }
+    }
+    // skills/ (optional)
+    const skillsSrc = join(sourceDir, 'skills');
+    if (existsSync(skillsSrc)) {
+        cpSync(skillsSrc, join(destDir, 'skills'), { recursive: true });
+        const count = readdirSync(skillsSrc).length;
+        installed.push(`skills/ (${count} entries)`);
+    }
+    // tools/ (optional)
+    const toolsSrc = join(sourceDir, 'tools');
+    if (existsSync(toolsSrc)) {
+        cpSync(toolsSrc, join(destDir, 'tools'), { recursive: true });
+        const count = readdirSync(toolsSrc).length;
+        installed.push(`tools/ (${count} entries)`);
+    }
+    // theme/ — resolve source dir from themeDir field or ./theme/
+    const themeSrcDir = manifest.themeDir
+        ? join(sourceDir, manifest.themeDir.replace(/^\.\//, ''))
+        : join(sourceDir, 'theme');
+    if (existsSync(themeSrcDir)) {
+        const themeDest = join(destDir, 'theme');
+        const tokensDestPath = join(themeDest, 'tokens.json');
+        const existingTokens = existsSync(tokensDestPath)
+            ? readFileSync(tokensDestPath, 'utf-8')
+            : null;
+        cpSync(themeSrcDir, themeDest, { recursive: true });
+        // Restore tokens.json if it existed — never overwrite customised tokens
+        if (existingTokens !== null) {
+            writeFileSync(tokensDestPath, existingTokens);
+            log.info('tokens.json preserved (not overwritten)');
+        }
+        installed.push('theme/');
+    }
+    const versionLabel = manifest.version ? ` v${manifest.version}` : '';
+    installSpinner.stop(`Installed ${manifest.name}${versionLabel}`);
+    for (const item of installed) {
+        log.info(`  ✓ ${item}`);
+    }
+    // Step 3: Git commit in .studiograph/
+    if (options.commit !== false) {
+        const commitSpinner = spinner();
+        commitSpinner.start('Committing to config repo...');
+        try {
+            execSync(`git -C "${studiographDir}" add "apps/${manifest.name}/"`, { stdio: 'pipe' });
+            const commitMsg = `install ${manifest.name}${versionLabel}`;
+            execSync(`git -C "${studiographDir}" commit -m "${commitMsg}"`, { stdio: 'pipe' });
+            commitSpinner.stop('Committed to config repo');
+        }
+        catch {
+            commitSpinner.stop('Nothing to commit (already up to date)');
+        }
+    }
+    // Step 4: Push
+    let shouldPush = options.push ?? false;
+    if (!shouldPush && options.commit !== false) {
+        const answer = await confirm({ message: 'Push to remote?' });
+        shouldPush = answer === true;
+    }
+    if (shouldPush) {
+        const pushSpinner = spinner();
+        pushSpinner.start('Pushing...');
+        try {
+            execSync(`git -C "${studiographDir}" push`, { stdio: 'pipe' });
+            pushSpinner.stop('Pushed');
+        }
+        catch {
+            pushSpinner.stop('Push failed — run git push manually in .studiograph/');
+        }
+    }
+    outro(`✨ ${manifest.name} installed. Restart studiograph serve to apply.`);
+});
+//# sourceMappingURL=app.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../../src/cli/commands/app.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AAC7F,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAepD,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC;KACzC,WAAW,CAAC,gCAAgC,CAAC,CAAC;AAEjD,UAAU;KACP,OAAO,CAAC,kBAAkB,CAAC;KAC3B,WAAW,CAAC,8CAA8C,CAAC;KAC3D,MAAM,CAAC,aAAa,EAAE,kCAAkC,CAAC;KACzD,MAAM,CAAC,QAAQ,EAAE,iCAAiC,CAAC;KACnD,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,OAAO,EAAE,EAAE;IACxC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAE5B,4BAA4B;IAC5B,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IACpC,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,aAAa,CAAC,CAAC;IAE/C,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC;QAC7B,KAAK,CAAC,mEAAmE,CAAC,CAAC;QAC3E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,OAAO;IACT,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAEjD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,0BAA0B,SAAS,EAAE,CAAC,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,OAAO;IACT,CAAC;IAED,IAAI,QAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAgB,CAAC;IAC5E,CAAC;IAAC,MAAM,CAAC;QACP,KAAK,CAAC,iCAAiC,SAAS,EAAE,CAAC,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,OAAO;IACT,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QAC9D,KAAK,CAAC,gEAAgE,CAAC,CAAC;QACxE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,OAAO;IACT,CAAC;IAED,8BAA8B;IAC9B,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,YAAY,GAAG,OAAO,EAAE,CAAC;QAC/B,YAAY,CAAC,KAAK,CAAC,YAAY,QAAQ,CAAC,IAAI,KAAK,CAAC,CAAC;QACnD,IAAI,CAAC;YACH,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YAC5D,YAAY,CAAC,IAAI,CAAC,SAAS,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAClC,MAAM,MAAM,GAAG,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YAC7C,KAAK,CAAC,2BAA2B,QAAQ,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC,CAAC;YAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;IACH,CAAC;IAED,kDAAkD;IAClD,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5D,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAExC,MAAM,cAAc,GAAG,OAAO,EAAE,CAAC;IACjC,cAAc,CAAC,KAAK,CAAC,cAAc,QAAQ,CAAC,IAAI,KAAK,CAAC,CAAC;IAEvD,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,WAAW;IACX,MAAM,CAAC,YAAY,EAAE,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;IAChD,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAE3B,mCAAmC;IACnC,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACjD,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;QAC9C,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC9B,CAAC;SAAM,CAAC;QACN,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxB,KAAK,CAAC,4BAA4B,SAAS,EAAE,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,OAAO;IACT,CAAC;IAED,+BAA+B;IAC/B,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QACzE,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC;YAClD,SAAS,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,qBAAqB;IACrB,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC5C,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,MAAM,KAAK,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;QAC5C,SAAS,CAAC,IAAI,CAAC,YAAY,KAAK,WAAW,CAAC,CAAC;IAC/C,CAAC;IAED,oBAAoB;IACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC1C,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9D,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;QAC3C,SAAS,CAAC,IAAI,CAAC,WAAW,KAAK,WAAW,CAAC,CAAC;IAC9C,CAAC;IAED,8DAA8D;IAC9D,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ;QACnC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACzD,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAE7B,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACzC,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QACtD,MAAM,cAAc,GAAG,UAAU,CAAC,cAAc,CAAC;YAC/C,CAAC,CAAC,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC;YACvC,CAAC,CAAC,IAAI,CAAC;QAET,MAAM,CAAC,WAAW,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpD,wEAAwE;QACxE,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;YAC5B,aAAa,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;YAC9C,GAAG,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;QACtD,CAAC;QAED,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACrE,cAAc,CAAC,IAAI,CAAC,aAAa,QAAQ,CAAC,IAAI,GAAG,YAAY,EAAE,CAAC,CAAC;IACjE,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IAC1B,CAAC;IAED,sCAAsC;IACtC,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QAC7B,MAAM,aAAa,GAAG,OAAO,EAAE,CAAC;QAChC,aAAa,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACpD,IAAI,CAAC;YACH,QAAQ,CAAC,WAAW,cAAc,eAAe,QAAQ,CAAC,IAAI,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YACvF,MAAM,SAAS,GAAG,WAAW,QAAQ,CAAC,IAAI,GAAG,YAAY,EAAE,CAAC;YAC5D,QAAQ,CAAC,WAAW,cAAc,gBAAgB,SAAS,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YACnF,aAAa,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,aAAa,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,eAAe;IACf,IAAI,UAAU,GAAG,OAAO,CAAC,IAAI,IAAI,KAAK,CAAC;IACvC,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC,CAAC;QAC7D,UAAU,GAAG,MAAM,KAAK,IAAI,CAAC;IAC/B,CAAC;IAED,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,WAAW,GAAG,OAAO,EAAE,CAAC;QAC9B,WAAW,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAChC,IAAI,CAAC;YACH,QAAQ,CAAC,WAAW,cAAc,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YAC/D,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,WAAW,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,QAAQ,CAAC,IAAI,iDAAiD,CAAC,CAAC;AAC7E,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * studiograph config command
+ *
+ * Interactive configuration management for ~/.studiograph/user.json.
+ *
+ * Usage:
+ *   studiograph config                              # Interactive menu
+ *   studiograph config set model_provider anthropic # Direct set
+ *   studiograph config get model_provider           # Direct get
+ *   studiograph config list                         # Show all config
+ */
+import { Command } from 'commander';
+export declare const configCommand: Command;

package/dist/cli/commands/config.js

@@ -0,0 +1,276 @@
+/**
+ * studiograph config command
+ *
+ * Interactive configuration management for ~/.studiograph/user.json.
+ *
+ * Usage:
+ *   studiograph config                              # Interactive menu
+ *   studiograph config set model_provider anthropic # Direct set
+ *   studiograph config get model_provider           # Direct get
+ *   studiograph config list                         # Show all config
+ */
+import { Command } from 'commander';
+import { loadUserConfig, saveUserConfig } from '../../core/user-config.js';
+import { intro, outro, select, text, spinner } from '@clack/prompts';
+const ALLOWED_KEYS = new Set([
+    'model_provider',
+    'model_id',
+    'api_key',
+    'voyage_api_key',
+    'vector_db_path',
+]);
+const VALID_PROVIDERS = new Set([
+    'anthropic',
+    'openai',
+    'google',
+    'xai',
+    'groq',
+    'openrouter',
+]);
+// Model provider configurations (same as start.ts)
+const MODEL_PROVIDERS = {
+    anthropic: {
+        name: 'Anthropic (Claude)',
+        models: [
+            { id: 'claude-opus-4-6', name: 'Claude Opus 4.6', hint: 'Most capable' },
+            { id: 'claude-sonnet-4-5-20250929', name: 'Claude Sonnet 4.5', hint: 'Recommended' },
+            { id: 'claude-3-7-sonnet-20250219', name: 'Claude 3.7 Sonnet', hint: 'Faster' },
+            { id: 'claude-3-5-haiku-20241022', name: 'Claude 3.5 Haiku', hint: 'Fastest' },
+        ],
+        envVar: 'ANTHROPIC_API_KEY',
+    },
+    openai: {
+        name: 'OpenAI (GPT)',
+        models: [
+            { id: 'gpt-4o', name: 'GPT-4o', hint: 'Recommended' },
+            { id: 'gpt-4o-mini', name: 'GPT-4o Mini', hint: 'Faster and cheaper' },
+            { id: 'gpt-4-turbo', name: 'GPT-4 Turbo', hint: 'Previous generation' },
+        ],
+        envVar: 'OPENAI_API_KEY',
+    },
+    google: {
+        name: 'Google (Gemini)',
+        models: [
+            { id: 'gemini-2.0-flash-exp', name: 'Gemini 2.0 Flash', hint: 'Latest experimental' },
+            { id: 'gemini-1.5-pro', name: 'Gemini 1.5 Pro', hint: 'Most capable' },
+            { id: 'gemini-1.5-flash', name: 'Gemini 1.5 Flash', hint: 'Fast' },
+        ],
+        envVar: 'GOOGLE_API_KEY',
+    },
+    xai: {
+        name: 'xAI (Grok)',
+        models: [
+            { id: 'grok-2-1212', name: 'Grok 2', hint: 'Latest' },
+            { id: 'grok-2-vision-1212', name: 'Grok 2 Vision', hint: 'With vision' },
+        ],
+        envVar: 'XAI_API_KEY',
+    },
+    groq: {
+        name: 'Groq (Fast Inference)',
+        models: [
+            { id: 'llama-3.3-70b-versatile', name: 'Llama 3.3 70B', hint: 'Very fast' },
+            { id: 'mixtral-8x7b-32768', name: 'Mixtral 8x7B', hint: 'Fast and capable' },
+        ],
+        envVar: 'GROQ_API_KEY',
+    },
+    openrouter: {
+        name: 'OpenRouter',
+        models: [
+            { id: 'anthropic/claude-opus-4-6', name: 'Claude Opus 4.6', hint: 'Via OpenRouter' },
+            { id: 'openai/gpt-4o', name: 'GPT-4o', hint: 'Via OpenRouter' },
+            { id: 'meta-llama/llama-3.3-70b-instruct', name: 'Llama 3.3 70B', hint: 'Open source' },
+        ],
+        envVar: 'OPENROUTER_API_KEY',
+    },
+};
+export const configCommand = new Command('config')
+    .description('Manage user configuration (interactive or direct commands)')
+    .action(async () => {
+    // Interactive mode when called without subcommands
+    await runInteractiveConfig();
+});
+configCommand
+    .command('set <key> <value>')
+    .description('Set a config value in ~/.studiograph/user.json')
+    .action((key, value) => {
+    if (!ALLOWED_KEYS.has(key)) {
+        console.error(`❌ Unknown config key: ${key}`);
+        console.error(`   Supported keys: ${[...ALLOWED_KEYS].join(', ')}`);
+        process.exit(1);
+    }
+    if (key === 'model_provider' && !VALID_PROVIDERS.has(value)) {
+        console.error(`❌ Invalid provider: ${value}`);
+        console.error(`   Supported providers: ${[...VALID_PROVIDERS].join(', ')}`);
+        process.exit(1);
+    }
+    const config = loadUserConfig();
+    config[key] = value;
+    saveUserConfig(config);
+    console.log(`✓ Set ${key}`);
+});
+configCommand
+    .command('get <key>')
+    .description('Get a config value from ~/.studiograph/user.json')
+    .action((key) => {
+    const config = loadUserConfig();
+    const value = config[key];
+    if (value === undefined) {
+        console.log(`(not set)`);
+    }
+    else {
+        console.log(value);
+    }
+});
+configCommand
+    .command('list')
+    .description('Show all user configuration')
+    .action(() => {
+    const config = loadUserConfig();
+    console.log('\nUser Configuration (~/.studiograph/user.json):\n');
+    if (config.model_provider) {
+        console.log(`Model Provider: ${config.model_provider}`);
+    }
+    if (config.model_id) {
+        console.log(`Model ID:       ${config.model_id}`);
+    }
+    if (config.api_key) {
+        console.log(`API Key:        ${config.api_key.slice(0, 12)}...`);
+    }
+    if (config.voyage_api_key) {
+        console.log(`Voyage API Key: ${config.voyage_api_key.slice(0, 12)}...`);
+    }
+    if (config.vector_db_path) {
+        console.log(`Vector DB Path: ${config.vector_db_path}`);
+    }
+    if (!config.model_provider && !config.voyage_api_key && !config.vector_db_path) {
+        console.log('(no configuration set)');
+    }
+    console.log('');
+});
+async function runInteractiveConfig() {
+    intro('Configuration');
+    const config = loadUserConfig();
+    const category = await select({
+        message: 'What would you like to configure?',
+        options: [
+            { value: 'model', label: 'AI Model & API Key', hint: 'Change provider, model, or credentials' },
+            { value: 'vector', label: 'Vector Search', hint: 'Voyage API key and vector DB path' },
+            { value: 'view', label: 'View Current Config', hint: 'Show all settings' },
+            { value: 'exit', label: 'Exit', hint: '' },
+        ],
+    });
+    if (typeof category === 'symbol' || category === 'exit') {
+        outro('Cancelled');
+        return;
+    }
+    if (category === 'view') {
+        console.log('\n');
+        if (config.model_provider) {
+            const provider = MODEL_PROVIDERS[config.model_provider];
+            console.log(`AI Model:       ${provider?.name || config.model_provider}`);
+            console.log(`Model ID:       ${config.model_id || '(not set)'}`);
+            console.log(`API Key:        ${config.api_key ? config.api_key.slice(0, 12) + '...' : '(not set)'}`);
+        }
+        else {
+            console.log(`AI Model:       (not set)`);
+        }
+        console.log('');
+        console.log(`Voyage API Key: ${config.voyage_api_key ? config.voyage_api_key.slice(0, 12) + '...' : '(not set)'}`);
+        console.log(`Vector DB Path: ${config.vector_db_path || '(not set)'}`);
+        console.log('');
+        outro('Configuration displayed');
+        return;
+    }
+    if (category === 'model') {
+        // Model configuration
+        const providerChoice = await select({
+            message: 'Select AI provider:',
+            options: Object.entries(MODEL_PROVIDERS).map(([key, provider]) => ({
+                value: key,
+                label: provider.name,
+            })),
+        });
+        if (typeof providerChoice === 'symbol') {
+            outro('Cancelled');
+            return;
+        }
+        const provider = MODEL_PROVIDERS[providerChoice];
+        const modelChoice = await select({
+            message: `Select ${provider.name} model:`,
+            options: provider.models.map(m => ({
+                value: m.id,
+                label: m.name,
+                hint: m.hint,
+            })),
+        });
+        if (typeof modelChoice === 'symbol') {
+            outro('Cancelled');
+            return;
+        }
+        const apiKeyInput = await text({
+            message: `Enter your ${provider.name} API key:`,
+            placeholder: `${provider.envVar}`,
+            validate: (value) => {
+                if (!value || value.length < 10)
+                    return 'API key seems too short';
+            },
+        });
+        if (typeof apiKeyInput !== 'string') {
+            outro('Cancelled');
+            return;
+        }
+        const s = spinner();
+        s.start('Saving configuration...');
+        config.model_provider = providerChoice;
+        config.model_id = modelChoice;
+        config.api_key = apiKeyInput;
+        saveUserConfig(config);
+        s.stop('Configuration saved ✓');
+        outro(`Model configured: ${provider.name} - ${modelChoice}`);
+    }
+    else if (category === 'vector') {
+        // Vector search configuration
+        const vectorOption = await select({
+            message: 'Configure:',
+            options: [
+                { value: 'voyage_key', label: 'Voyage API Key', hint: 'For semantic search embeddings' },
+                { value: 'vector_path', label: 'Vector DB Path', hint: 'LanceDB storage location' },
+            ],
+        });
+        if (typeof vectorOption === 'symbol') {
+            outro('Cancelled');
+            return;
+        }
+        if (vectorOption === 'voyage_key') {
+            const keyInput = await text({
+                message: 'Enter your Voyage AI API key:',
+                placeholder: 'pa-...',
+                validate: (value) => {
+                    if (!value || value.length < 10)
+                        return 'API key seems too short';
+                },
+            });
+            if (typeof keyInput !== 'string') {
+                outro('Cancelled');
+                return;
+            }
+            config.voyage_api_key = keyInput;
+            saveUserConfig(config);
+            outro('Voyage API key saved ✓');
+        }
+        else {
+            const pathInput = await text({
+                message: 'Enter vector DB path:',
+                placeholder: '~/.studiograph/vector',
+            });
+            if (typeof pathInput !== 'string') {
+                outro('Cancelled');
+                return;
+            }
+            config.vector_db_path = pathInput;
+            saveUserConfig(config);
+            outro('Vector DB path saved ✓');
+        }
+    }
+}
+//# sourceMappingURL=config.js.map

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

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

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

@@ -0,0 +1,33 @@
+/**
+ * studiograph connector
+ *
+ * Manage MCP connectors — integrations with third-party MCP servers
+ * (Linear, Granola, Slack, etc.) that the Studiograph agent can query on demand.
+ *
+ * Connector configs are stored at ~/.studiograph/connectors/<name>.json
+ * (mode 0600 — tokens never leave your machine).
+ *
+ * Interactive setup (known connectors):
+ *   studiograph connector add slack
+ *   studiograph connector add linear
+ *
+ * Manual setup (any connector):
+ *   studiograph connector add linear \
+ *     --url https://mcp.linear.app/mcp \
+ *     --token lin_api_xxxx \
+ *     --description "Linear project management"
+ *
+ *   studiograph connector add granola \
+ *     --command node \
+ *     --args "/Users/you/mcp-servers/granola-mcp/dist/index.js" \
+ *     --description "Granola meeting notes"
+ *
+ *   studiograph connector list
+ *   studiograph connector remove linear
+ *
+ * Once added, the connector's tools are available to the agent as
+ * <name>__<tool> (e.g. "linear__search_issues", "granola__search_granola_notes").
+ * The agent discovers them automatically on the next `studiograph start`.
+ */
+import { Command } from 'commander';
+export declare const connectorCommand: Command;