studiograph 1.1.3 → 1.2.0-beta.10

package/dist/cli/scaffolding.js

@@ -3,13 +3,18 @@
  *
  * Creates a connected set of example entities during `studiograph init`
  * to demonstrate the knowledge graph pattern — a client, project, person,
- * meeting, and decision all wikilinked together.
+ * meeting, and decision all wikilinked together, distributed across repos
+ * matching the fluid folder model.
  */
 import { join } from 'path';
 import { writeFileSync } from 'fs';
-import { RepoType } from '../core/types.js';
 import { MarkdownService } from '../services/markdown.js';
-const REPO_NAME = 'example-project';
+const ENTITY_REPO_MAP = {
+    client: 'clients',
+    person: 'people',
+    project: 'projects',
+    meeting: 'meetings',
+};
 function buildEntities(now) {
     const shared = {
         created_by: 'studiograph',
@@ -20,6 +25,7 @@ function buildEntities(now) {
     };
     return [
         {
+            repo: 'clients',
             entityType: 'client',
             entityId: 'meridian-health',
             frontmatter: {
@@ -49,6 +55,7 @@ Regional healthcare network with 12 hospitals across the Midwest. Engaged us for
 `,
         },
         {
+            repo: 'people',
             entityType: 'person',
             entityId: 'sarah-chen',
             frontmatter: {
@@ -73,6 +80,7 @@ VP of Marketing at [[meridian-health]]. Primary stakeholder for the [[meridian-r
 `,
         },
         {
+            repo: 'projects',
             entityType: 'project',
             entityId: 'meridian-rebrand',
             frontmatter: {
@@ -108,6 +116,7 @@ Comprehensive brand identity refresh for [[meridian-health]] following their mer
 `,
         },
         {
+            repo: 'meetings',
             entityType: 'meeting',
             entityId: '2026-02-10-kickoff',
             frontmatter: {
@@ -148,6 +157,7 @@ Kickoff meeting for the [[meridian-rebrand]] project with [[sarah-chen]] and the
 `,
         },
         {
+            repo: 'projects',
             entityType: 'decision',
             entityId: 'dec-2026-001',
             frontmatter: {
@@ -241,40 +251,45 @@ studiograph get <entity-id>    # View a specific entity
 
 ## Explore the Examples
 
-Check out the \`example-project/\` repo to see how entities connect:
+Check out the example entities across your repos:
 
-- \`example-project/client/meridian-health.md\` — a client organization
-- \`example-project/person/sarah-chen.md\` — a contact linked to the client
-- \`example-project/project/meridian-rebrand.md\` — a project linking client, person, and decisions
-- \`example-project/meeting/2026-02-10-kickoff.md\` — a meeting with notes and action items
-- \`example-project/decision/dec-2026-001.md\` — a structured decision record
+- \`clients/meridian-health/main.md\` — a client organization
+- \`people/sarah-chen/main.md\` — a contact linked to the client
+- \`projects/meridian-rebrand/main.md\` — a project linking client, person, and decisions
+- \`projects/meridian-rebrand/decisions/dec-2026-001.md\` — a decision as sub-content of the project
+- \`meetings/2026-02-10-kickoff/main.md\` — a meeting with notes and action items
 
-Notice how \`[[wikilinks]]\` connect everything into a navigable graph.
+Notice how \`[[wikilinks]]\` connect everything into a navigable graph across repos.
 
 ## Cleaning Up Examples
 
-When you're ready to remove the example entities:
+When you're ready to remove the example entities, search for the \`example\` tag and delete the folders:
 
 \`\`\`bash
-studiograph config repo remove example-project
-rm -rf example-project/
+studiograph search --tag example    # Find all example entities
+rm -rf clients/meridian-health/
+rm -rf people/sarah-chen/
+rm -rf projects/meridian-rebrand/   # Also removes the decision sub-content
+rm -rf meetings/2026-02-10-kickoff/
 \`\`\`
 `;
 }
 export async function scaffoldExampleEntities(workspace, teamName) {
-    const repoPath = join(workspace.getWorkspacePath(), REPO_NAME);
-    // Register the example-project repo
-    await workspace.registerRepo({
-        name: REPO_NAME,
-        type: RepoType.PROJECT,
-        description: 'Example entities demonstrating the knowledge graph pattern (safe to delete)',
-    });
-    // Write example entities
+    const workspacePath = workspace.getWorkspacePath();
     const md = new MarkdownService();
     const now = new Date().toISOString();
     const entities = buildEntities(now);
     for (const entity of entities) {
-        const filePath = join(repoPath, entity.entityType, `${entity.entityId}.md`);
+        const repo = ENTITY_REPO_MAP[entity.entityType];
+        let filePath;
+        if (repo) {
+            // Standard entity — entity folder with main.md inside the repo
+            filePath = join(workspacePath, repo, entity.entityId, 'main.md');
+        }
+        else {
+            // Decision — sub-content inside the project entity folder
+            filePath = join(workspacePath, 'projects', 'meridian-rebrand', 'decisions', `${entity.entityId}.md`);
+        }
         md.writeFile(filePath, {
             frontmatter: entity.frontmatter,
             content: entity.content,
@@ -282,7 +297,7 @@ export async function scaffoldExampleEntities(workspace, teamName) {
         });
     }
     // Write STUDIOGRAPH.md to workspace root
-    const guidePath = join(workspace.getWorkspacePath(), 'STUDIOGRAPH.md');
+    const guidePath = join(workspacePath, 'STUDIOGRAPH.md');
     writeFileSync(guidePath, buildOnboardingGuide(teamName), 'utf-8');
 }
 //# sourceMappingURL=scaffolding.js.map

package/dist/cli/scaffolding.js.map

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

package/dist/cli/setup-wizard.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shared setup wizard helpers for join/clone commands.
+ *
+ * Reusable interactive prompts for:
+ * - GitHub PAT authentication
+ * - LLM provider configuration
+ * - Connector configuration for sync sources
+ */
+/**
+ * Prompt for GitHub PAT if not authenticated.
+ * Returns the stored auth (existing or newly created).
+ */
+export declare function promptGitHubAuthIfNeeded(): Promise<{
+    token: string;
+    user: {
+        login: string;
+        name: string;
+        email: string;
+    };
+}>;
+/**
+ * Prompt for LLM provider setup if not configured.
+ * Checks user config and env vars. Skips if already set.
+ */
+export declare function promptLLMSetupIfNeeded(): Promise<void>;
+/**
+ * Detect sync sources in the workspace and prompt for missing connectors.
+ * Only prompts for connectors that have a known definition.
+ */
+export declare function promptConnectorSetup(workspacePath: string): Promise<number>;

package/dist/cli/setup-wizard.js

@@ -0,0 +1,244 @@
+/**
+ * Shared setup wizard helpers for join/clone commands.
+ *
+ * Reusable interactive prompts for:
+ * - GitHub PAT authentication
+ * - LLM provider configuration
+ * - Connector configuration for sync sources
+ */
+import { confirm, select, password, note, log, isCancel } from '@clack/prompts';
+import { loadToken, promptForPAT, storeToken, getGitHubUser } from '../auth/github.js';
+import { loadUserConfig, saveUserConfig } from '../core/user-config.js';
+import { ConnectorManager } from '../mcp/connector-manager.js';
+import { CONNECTOR_DEFINITIONS } from '../mcp/connectors/definitions.js';
+import { SourceConfigManager } from '../services/sync/source-config.js';
+import { text } from '@clack/prompts';
+const MODEL_PROVIDERS = {
+    anthropic: {
+        name: 'Anthropic (Claude)',
+        models: [
+            { id: 'claude-sonnet-4-5-20250929', name: 'Claude Sonnet 4.5', hint: 'Recommended' },
+            { id: 'claude-opus-4-6', name: 'Claude Opus 4.6', hint: 'Most capable' },
+            { 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' },
+        ],
+        envVar: 'OPENAI_API_KEY',
+    },
+    google: {
+        name: 'Google (Gemini)',
+        models: [
+            { id: 'gemini-2.0-flash-exp', name: 'Gemini 2.0 Flash', hint: 'Latest' },
+            { id: 'gemini-1.5-pro', name: 'Gemini 1.5 Pro', hint: 'Most capable' },
+        ],
+        envVar: 'GOOGLE_API_KEY',
+    },
+    xai: {
+        name: 'xAI (Grok)',
+        models: [
+            { id: 'grok-2-1212', name: 'Grok 2', hint: 'Latest' },
+        ],
+        envVar: 'XAI_API_KEY',
+    },
+    groq: {
+        name: 'Groq (Fast Inference)',
+        models: [
+            { id: 'llama-3.3-70b-versatile', name: 'Llama 3.3 70B', hint: 'Very fast' },
+        ],
+        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' },
+        ],
+        envVar: 'OPENROUTER_API_KEY',
+    },
+};
+/**
+ * Prompt for GitHub PAT if not authenticated.
+ * Returns the stored auth (existing or newly created).
+ */
+export async function promptGitHubAuthIfNeeded() {
+    const stored = loadToken();
+    if (stored) {
+        if (stored.user.login === '_env') {
+            log.success('GitHub auth configured (via environment variable)');
+        }
+        else {
+            log.success(`GitHub auth configured (${stored.user.login})`);
+        }
+        return stored;
+    }
+    log.info('No GitHub token found. Let\'s set one up.');
+    const token = await promptForPAT();
+    const user = await getGitHubUser(token);
+    storeToken(token, user);
+    log.success(`Authenticated as ${user.login}`);
+    return { token, user };
+}
+/**
+ * Prompt for LLM provider setup if not configured.
+ * Checks user config and env vars. Skips if already set.
+ */
+export async function promptLLMSetupIfNeeded() {
+    const userConfig = loadUserConfig();
+    // Check if already configured via user config
+    if (userConfig.api_key) {
+        const providerName = userConfig.model_provider
+            ? MODEL_PROVIDERS[userConfig.model_provider]?.name ?? userConfig.model_provider
+            : 'configured';
+        log.success(`AI model configured (${providerName})`);
+        return;
+    }
+    // Check common env vars
+    const envProviders = [
+        { key: 'ANTHROPIC_API_KEY', name: 'Anthropic' },
+        { key: 'OPENAI_API_KEY', name: 'OpenAI' },
+        { key: 'GOOGLE_API_KEY', name: 'Google' },
+        { key: 'XAI_API_KEY', name: 'xAI' },
+        { key: 'GROQ_API_KEY', name: 'Groq' },
+        { key: 'OPENROUTER_API_KEY', name: 'OpenRouter' },
+    ];
+    for (const { key, name } of envProviders) {
+        if (process.env[key]) {
+            log.success(`AI model configured (${name} via ${key})`);
+            return;
+        }
+    }
+    // Prompt for setup
+    const wantSetup = await confirm({
+        message: 'Set up an AI model? (required for `studiograph start`)',
+        initialValue: true,
+    });
+    if (!wantSetup || typeof wantSetup === 'symbol') {
+        log.info('Skipped. Run `studiograph config` later to set up.');
+        return;
+    }
+    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') {
+        log.info('Skipped. Run `studiograph config` later to set up.');
+        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') {
+        log.info('Skipped. Run `studiograph config` later to set up.');
+        return;
+    }
+    const apiKeyInput = await password({
+        message: `Enter your ${provider.name} API key:`,
+        validate: (value) => {
+            if (!value || value.trim().length < 10)
+                return 'API key seems too short';
+        },
+    });
+    if (isCancel(apiKeyInput)) {
+        log.info('Skipped. Run `studiograph config` later to set up.');
+        return;
+    }
+    userConfig.model_provider = providerChoice;
+    userConfig.model_id = modelChoice;
+    userConfig.api_key = apiKeyInput.trim();
+    saveUserConfig(userConfig);
+    log.success(`AI model configured: ${provider.name} — ${modelChoice}`);
+}
+/**
+ * Detect sync sources in the workspace and prompt for missing connectors.
+ * Only prompts for connectors that have a known definition.
+ */
+export async function promptConnectorSetup(workspacePath) {
+    const sourceManager = new SourceConfigManager(workspacePath);
+    const sources = sourceManager.getAll();
+    if (sources.length === 0) {
+        return 0;
+    }
+    // Find unique connector names referenced by enabled sources
+    const referencedConnectors = [...new Set(sources.filter(s => s.enabled).map(s => s.connector))];
+    const existingConnectors = ConnectorManager.loadConfigs();
+    const existingNames = new Set(existingConnectors.map(c => c.name));
+    const missingConnectors = referencedConnectors.filter(name => !existingNames.has(name));
+    if (missingConnectors.length === 0) {
+        log.success(`All ${referencedConnectors.length} sync connector(s) already configured`);
+        return 0;
+    }
+    log.info(`This workspace syncs from ${sources.length} source(s). ${missingConnectors.length} connector(s) need setup.`);
+    let configured = 0;
+    for (const connectorName of missingConnectors) {
+        const def = CONNECTOR_DEFINITIONS[connectorName];
+        if (!def) {
+            log.warn(`Connector "${connectorName}" has no built-in definition. Set up manually: studiograph connector add ${connectorName}`);
+            continue;
+        }
+        const wantSetup = await confirm({
+            message: `Set up ${def.label} connector?`,
+            initialValue: true,
+        });
+        if (!wantSetup || typeof wantSetup === 'symbol') {
+            log.info(`Skipped. Run \`studiograph connector add ${connectorName}\` later.`);
+            continue;
+        }
+        if (def.docsUrl) {
+            note(def.docsUrl, `${def.label} docs`);
+        }
+        const config = {
+            name: def.name,
+            description: def.description,
+            type: def.type,
+            ...(def.type === 'stdio'
+                ? { command: def.command, args: def.args }
+                : { url: def.url }),
+        };
+        let cancelled = false;
+        for (const field of def.credentialFields) {
+            const promptOpts = {
+                message: field.label,
+                placeholder: field.placeholder,
+                validate: field.required
+                    ? (v) => (!v?.trim() ? `${field.label} is required` : undefined)
+                    : undefined,
+            };
+            const value = field.secret ? await password(promptOpts) : await text(promptOpts);
+            if (isCancel(value)) {
+                log.info(`Skipped. Run \`studiograph connector add ${connectorName}\` later.`);
+                cancelled = true;
+                break;
+            }
+            const key = field.key;
+            if (key.startsWith('env.')) {
+                const envKey = key.slice(4);
+                config.env = { ...(config.env ?? {}), [envKey]: value };
+            }
+            else {
+                config[key] = value;
+            }
+        }
+        if (!cancelled) {
+            ConnectorManager.saveConfig(config);
+            log.success(`${def.label} connector saved`);
+            configured++;
+        }
+    }
+    return configured;
+}
+//# sourceMappingURL=setup-wizard.js.map

package/dist/cli/setup-wizard.js.map

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

package/dist/cli/sync-review-interactive.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Interactive review UI for `studiograph sync review`.
+ *
+ * Uses @clack/prompts for file selection and action menus,
+ * and sync-colors for colored diff output.
+ */
+export interface ChangedFile {
+    path: string;
+    relativePath: string;
+    repoName: string;
+    repoPath: string;
+    entityType: string;
+    entityId: string;
+    status: 'A' | 'M' | 'D';
+}
+export interface ReviewContext {
+    workspacePath: string;
+    repos: Array<{
+        name: string;
+        path: string;
+    }>;
+    committed: boolean;
+}
+export type DiffMode = 'uncommitted' | 'committed' | 'none';
+export declare function detectDiffMode(workspacePath: string, repos: Array<{
+    name: string;
+    path: string;
+}>): DiffMode;
+export declare function collectChangedFiles(ctx: ReviewContext): ChangedFile[];
+export declare function getFileDiff(file: ChangedFile, committed: boolean): string;
+export declare function runInteractiveReview(ctx: ReviewContext): Promise<void>;