studiograph 1.0.0

package/dist/cli/commands/join.js

@@ -0,0 +1,230 @@
+/**
+ * studiograph join command
+ *
+ * Joins an existing Studiograph workspace by cloning the .studiograph
+ * config repo, detecting the user's role, and cloning all accessible repos.
+ */
+import { Command } from 'commander';
+import { intro, select, confirm, outro, spinner, log } from '@clack/prompts';
+import { existsSync, mkdirSync } from 'fs';
+import { join, resolve } from 'path';
+import { Workspace } from '../../core/workspace.js';
+import { gitClone, getGitConfig } from '../../utils/git.js';
+import { loadToken, getGitHubUser } from '../../auth/github.js';
+import { runPreflight } from '../../utils/preflight.js';
+/**
+ * Attempt to identify a workspace member using the stored GitHub token.
+ * Returns the matching TeamMember, or undefined if not identified.
+ */
+export async function resolveIdentityFromToken(members) {
+    const stored = loadToken();
+    if (!stored)
+        return undefined;
+    try {
+        const ghUser = await getGitHubUser(stored.token);
+        return members.find(m => m.github_username === ghUser.login && m.active !== false);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Determine if a role can access a repo with the given access level.
+ * Mirrors the logic in WorkspaceManager.canAccessRepo().
+ */
+function canAccess(role, access) {
+    if (role === 'admin')
+        return true;
+    switch (access) {
+        case 'public': return true;
+        case 'team': return role === 'member';
+        case 'admin': return false;
+        case 'restricted': return false;
+        default: return false;
+    }
+}
+export const joinCommand = new Command('join')
+    .description('Join an existing Studiograph workspace')
+    .argument('<workspace-url>', 'GitHub URL to the .studiograph config repo')
+    .option('--dir <path>', 'Target directory for the workspace (default: current directory)')
+    .option('--github-username <username>', 'Your GitHub username (used to detect your role)')
+    .action(async (workspaceUrl, options) => {
+    intro('Join Studiograph Workspace');
+    const ready = runPreflight();
+    if (!ready) {
+        process.exit(1);
+        return;
+    }
+    try {
+        // Step 1: Resolve target directory
+        const targetDir = resolve(options.dir ?? process.cwd());
+        const studiographDir = join(targetDir, '.studiograph');
+        if (existsSync(studiographDir)) {
+            outro('❌ A .studiograph directory already exists here. Choose a different directory with --dir or remove the existing one.');
+            process.exit(1);
+            return;
+        }
+        mkdirSync(targetDir, { recursive: true });
+        // Step 2: Clone the .studiograph config repo
+        const cloneSpinner = spinner();
+        cloneSpinner.start('Cloning workspace configuration...');
+        try {
+            gitClone(workspaceUrl, studiographDir);
+            cloneSpinner.stop('Workspace configuration cloned');
+        }
+        catch {
+            cloneSpinner.stop('Failed');
+            outro(`❌ Could not clone ${workspaceUrl}. Check the URL and your access permissions.`);
+            process.exit(1);
+            return;
+        }
+        // Step 3: Load workspace config and team roster
+        const workspace = new Workspace(targetDir);
+        if (!workspace.isWorkspace()) {
+            outro('❌ The cloned repo does not appear to be a valid Studiograph workspace (missing workspace.json).');
+            process.exit(1);
+            return;
+        }
+        const config = workspace.loadConfig();
+        const members = workspace.loadMembers();
+        log.info(`Workspace: ${config.team_name}`);
+        log.info(`${config.repos.length} repositor${config.repos.length === 1 ? 'y' : 'ies'} in workspace`);
+        // Step 4: Identify the user
+        const githubUsernameFromOption = options.githubUsername;
+        let userMember;
+        // Try stored GitHub token (skip if --github-username was passed explicitly)
+        if (!githubUsernameFromOption) {
+            userMember = await resolveIdentityFromToken(members);
+            if (userMember) {
+                log.success(`Identified as ${userMember.name} (${userMember.role})`);
+            }
+        }
+        // Fall back to --github-username option or git config
+        if (!userMember) {
+            const githubUsername = githubUsernameFromOption ?? getGitConfig('github.user');
+            if (githubUsername) {
+                userMember = members.find(m => m.github_username === githubUsername && m.active !== false);
+                if (userMember) {
+                    log.success(`Identified as ${userMember.name} (${userMember.role})`);
+                }
+            }
+        }
+        if (!userMember) {
+            const activeMembers = members.filter(m => m.active !== false);
+            if (activeMembers.length > 0) {
+                const memberOptions = [
+                    ...activeMembers.map(m => ({
+                        value: m.id,
+                        label: `${m.name}`,
+                        hint: m.role,
+                    })),
+                    { value: '__guest__', label: "I'm not on the team yet", hint: 'guest access' },
+                ];
+                const selectedId = await select({
+                    message: 'Who are you? (used to determine which repos to clone)',
+                    options: memberOptions,
+                });
+                if (typeof selectedId === 'symbol') {
+                    outro('Cancelled');
+                    process.exit(0);
+                    return;
+                }
+                if (selectedId !== '__guest__') {
+                    userMember = activeMembers.find(m => m.id === selectedId);
+                }
+            }
+            else {
+                // No members defined yet — ask what role to assume
+                log.warn('No team roster found. Selecting a role here only determines which repos to attempt cloning — GitHub access controls what you can actually clone.');
+                const roleChoice = await select({
+                    message: 'Which repos should we attempt to clone?',
+                    options: [
+                        { value: 'admin', label: 'Admin', hint: 'attempt all repos (GitHub auth still applies)' },
+                        { value: 'member', label: 'Member', hint: 'attempt public + team repos' },
+                        { value: 'guest', label: 'Guest', hint: 'public repos only' },
+                    ],
+                });
+                if (typeof roleChoice === 'symbol') {
+                    outro('Cancelled');
+                    process.exit(0);
+                    return;
+                }
+                // Synthesize a temporary member with the chosen role
+                userMember = { id: 'local', name: 'Local User', email: '', role: roleChoice };
+            }
+        }
+        const userRole = userMember?.role ?? 'guest';
+        // Step 5: Determine accessible vs inaccessible repos
+        const accessibleRepos = config.repos.filter(r => canAccess(userRole, r.access));
+        const blockedRepos = config.repos.filter(r => !canAccess(userRole, r.access));
+        log.info(`${accessibleRepos.length} repositor${accessibleRepos.length === 1 ? 'y' : 'ies'} accessible with your role (${userRole})`);
+        if (blockedRepos.length > 0) {
+            log.warn(`${blockedRepos.length} repositor${blockedRepos.length === 1 ? 'y' : 'ies'} require higher access: ${blockedRepos.map(r => r.name).join(', ')}`);
+        }
+        if (accessibleRepos.length === 0) {
+            outro('No accessible repositories to clone. Contact a workspace admin to update your role.');
+            process.exit(0);
+            return;
+        }
+        // Confirm before cloning
+        const repoList = accessibleRepos.map(r => `  • ${r.name} (${r.access})`).join('\n');
+        const shouldProceed = await confirm({
+            message: `Clone these repos into ${targetDir}?\n${repoList}`,
+        });
+        if (!shouldProceed || typeof shouldProceed === 'symbol') {
+            outro('Cancelled');
+            process.exit(0);
+            return;
+        }
+        // Step 6: Clone accessible repos
+        let cloned = 0;
+        let skipped = 0;
+        let failed = 0;
+        for (const repo of accessibleRepos) {
+            if (!repo.github_url) {
+                log.warn(`Skipping ${repo.name}: no GitHub URL configured in workspace.json`);
+                skipped++;
+                continue;
+            }
+            const repoPath = join(targetDir, repo.path);
+            if (existsSync(repoPath)) {
+                log.warn(`Skipping ${repo.name}: directory already exists at ${repo.path}`);
+                skipped++;
+                continue;
+            }
+            const repoSpinner = spinner();
+            repoSpinner.start(`Cloning ${repo.name}...`);
+            try {
+                gitClone(repo.github_url, repoPath);
+                repoSpinner.stop(`Cloned ${repo.name}`);
+                cloned++;
+            }
+            catch {
+                repoSpinner.stop(`Failed to clone ${repo.name}`);
+                log.warn(`Could not clone ${repo.name}: check your GitHub access permissions`);
+                failed++;
+            }
+        }
+        // Step 7: Summary
+        const parts = [];
+        if (cloned > 0)
+            parts.push(`${cloned} cloned`);
+        if (skipped > 0)
+            parts.push(`${skipped} skipped`);
+        if (failed > 0)
+            parts.push(`${failed} failed`);
+        const summary = parts.join(', ');
+        const nextStep = `\ncd ${targetDir}\nstudiograph start`;
+        if (failed > 0) {
+            outro(`⚠️  Joined ${config.team_name} with issues (${summary}). Ask a workspace admin to verify your repo access.\n${nextStep}`);
+        }
+        else {
+            outro(`✨ Joined ${config.team_name} workspace (${summary})${nextStep}`);
+        }
+    }
+    catch (error) {
+        outro(`❌ Error: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=join.js.map

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

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

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

@@ -0,0 +1,11 @@
+/**
+ * studiograph members command
+ *
+ * Subcommands:
+ *   studiograph members list                              — list all team members
+ *   studiograph members add <github-username> --role <>  — add a member (admin only)
+ *   studiograph members remove <github-username>         — deactivate a member (admin only)
+ *   studiograph members role <github-username> <role>    — change a member's role (admin only)
+ */
+import { Command } from 'commander';
+export declare const membersCommand: Command;

package/dist/cli/commands/members.js

@@ -0,0 +1,230 @@
+/**
+ * studiograph members command
+ *
+ * Subcommands:
+ *   studiograph members list                              — list all team members
+ *   studiograph members add <github-username> --role <>  — add a member (admin only)
+ *   studiograph members remove <github-username>         — deactivate a member (admin only)
+ *   studiograph members role <github-username> <role>    — change a member's role (admin only)
+ */
+import { Command } from 'commander';
+import { outro, log, text } from '@clack/prompts';
+import { Workspace } from '../../core/workspace.js';
+import { loadToken, getGitHubUser } from '../../auth/github.js';
+const VALID_ROLES = ['admin', 'member', 'guest'];
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function requireWorkspace() {
+    const workspace = new Workspace();
+    if (!workspace.isWorkspace()) {
+        console.error('❌ Not a Studiograph workspace. Run `studiograph init` first.');
+        return null;
+    }
+    return workspace;
+}
+async function resolveCurrentUser(members) {
+    const stored = loadToken();
+    if (!stored)
+        return undefined;
+    try {
+        const ghUser = await getGitHubUser(stored.token);
+        return members.find(m => m.github_username === ghUser.login && m.active !== false);
+    }
+    catch {
+        return undefined;
+    }
+}
+function requireAdmin(currentUser) {
+    if (!currentUser) {
+        log.error('Could not identify you as a workspace member. Run `studiograph auth github` to authenticate.');
+        return false;
+    }
+    if (currentUser.role !== 'admin') {
+        log.error(`Only admins can manage team members. Your role is: ${currentUser.role}`);
+        return false;
+    }
+    return true;
+}
+function formatRole(role) {
+    const widths = { admin: 'admin ', member: 'member', guest: 'guest ' };
+    return widths[role] ?? role.padEnd(6);
+}
+// ─── list ────────────────────────────────────────────────────────────────────
+const listCommand = new Command('list')
+    .description('List all team members')
+    .action(async () => {
+    const workspace = requireWorkspace();
+    if (!workspace) {
+        process.exit(1);
+        return;
+    }
+    const members = workspace.loadMembers();
+    if (members.length === 0) {
+        log.info('No team members found.');
+        return;
+    }
+    const active = members.filter(m => m.active !== false);
+    const inactive = members.filter(m => m.active === false);
+    console.log('\nTeam Members\n');
+    console.log('  Name                          Role    GitHub Username     Joined');
+    console.log('  ' + '─'.repeat(72));
+    for (const m of active) {
+        const name = m.name.padEnd(30);
+        const role = formatRole(m.role);
+        const gh = (m.github_username ?? '—').padEnd(18);
+        const joined = m.joined_at ? m.joined_at.slice(0, 10) : '—';
+        console.log(`  ${name}  ${role}  ${gh}  ${joined}`);
+    }
+    if (inactive.length > 0) {
+        console.log(`\n  (${inactive.length} inactive member${inactive.length === 1 ? '' : 's'} not shown)`);
+    }
+    console.log('');
+});
+// ─── add ─────────────────────────────────────────────────────────────────────
+const addCommand = new Command('add')
+    .description('Add a new team member (admin only)')
+    .argument('<github-username>', "The new member's GitHub username")
+    .option('--role <role>', 'Role: admin, member, or guest (default: member)', 'member')
+    .option('--name <name>', 'Display name (prompted if omitted)')
+    .option('--email <email>', 'Email address (prompted if omitted)')
+    .action(async (githubUsername, options) => {
+    const workspace = requireWorkspace();
+    if (!workspace) {
+        process.exit(1);
+        return;
+    }
+    const members = workspace.loadMembers();
+    const currentUser = await resolveCurrentUser(members);
+    if (!requireAdmin(currentUser)) {
+        process.exit(1);
+        return;
+    }
+    // Validate role
+    const role = options.role;
+    if (!VALID_ROLES.includes(role)) {
+        log.error(`Invalid role "${role}". Must be one of: admin, member, guest`);
+        process.exit(1);
+        return;
+    }
+    // Check for duplicate
+    if (members.find(m => m.github_username === githubUsername)) {
+        log.error(`Member with GitHub username "${githubUsername}" already exists.`);
+        process.exit(1);
+        return;
+    }
+    // Resolve name
+    let name = options.name;
+    if (!name) {
+        const nameInput = await text({
+            message: 'Display name:',
+            placeholder: 'Alex Rivera',
+            validate: (v) => { if (!v?.trim())
+                return 'Name is required'; },
+        });
+        if (typeof nameInput !== 'string') {
+            outro('Cancelled');
+            process.exit(0);
+            return;
+        }
+        name = nameInput;
+    }
+    // Resolve email (optional)
+    let email = options.email;
+    if (!email) {
+        const emailInput = await text({
+            message: 'Email address (optional):',
+            placeholder: 'alex@example.com',
+        });
+        if (typeof emailInput === 'symbol') {
+            outro('Cancelled');
+            process.exit(0);
+            return;
+        }
+        email = emailInput ?? '';
+    }
+    const newMember = {
+        id: githubUsername,
+        name,
+        email,
+        role: role,
+        github_username: githubUsername,
+        joined_at: new Date().toISOString(),
+        active: true,
+    };
+    workspace.writeMembers([...members, newMember]);
+    log.success(`Added ${name} (@${githubUsername}) as ${role}`);
+});
+// ─── remove ──────────────────────────────────────────────────────────────────
+const removeCommand = new Command('remove')
+    .description('Remove a team member (admin only)')
+    .argument('<github-username>', "The member's GitHub username")
+    .action(async (githubUsername) => {
+    const workspace = requireWorkspace();
+    if (!workspace) {
+        process.exit(1);
+        return;
+    }
+    const members = workspace.loadMembers();
+    const currentUser = await resolveCurrentUser(members);
+    if (!requireAdmin(currentUser)) {
+        process.exit(1);
+        return;
+    }
+    const target = members.find(m => m.github_username === githubUsername);
+    if (!target) {
+        log.error(`No member found with GitHub username "${githubUsername}".`);
+        process.exit(1);
+        return;
+    }
+    if (target.active === false) {
+        log.warn(`${target.name} (@${githubUsername}) is already inactive.`);
+        return;
+    }
+    // Soft-delete: set active: false
+    const updated = members.map(m => m.github_username === githubUsername ? { ...m, active: false } : m);
+    workspace.writeMembers(updated);
+    log.success(`Removed ${target.name} (@${githubUsername}) from the team`);
+});
+// ─── role ─────────────────────────────────────────────────────────────────────
+const roleCommand = new Command('role')
+    .description("Change a member's role (admin only)")
+    .argument('<github-username>', "The member's GitHub username")
+    .argument('<role>', 'New role: admin, member, or guest')
+    .action(async (githubUsername, newRole) => {
+    const workspace = requireWorkspace();
+    if (!workspace) {
+        process.exit(1);
+        return;
+    }
+    const members = workspace.loadMembers();
+    const currentUser = await resolveCurrentUser(members);
+    if (!requireAdmin(currentUser)) {
+        process.exit(1);
+        return;
+    }
+    if (!VALID_ROLES.includes(newRole)) {
+        log.error(`Invalid role "${newRole}". Must be one of: admin, member, guest`);
+        process.exit(1);
+        return;
+    }
+    const target = members.find(m => m.github_username === githubUsername && m.active !== false);
+    if (!target) {
+        log.error(`No active member found with GitHub username "${githubUsername}".`);
+        process.exit(1);
+        return;
+    }
+    if (target.role === newRole) {
+        log.info(`${target.name} (@${githubUsername}) already has role: ${newRole}`);
+        return;
+    }
+    const updated = members.map(m => m.github_username === githubUsername ? { ...m, role: newRole } : m);
+    workspace.writeMembers(updated);
+    log.success(`Updated ${target.name} (@${githubUsername}): ${target.role} → ${newRole}`);
+});
+// ─── Export ──────────────────────────────────────────────────────────────────
+export const membersCommand = new Command('members')
+    .description('Manage team members')
+    .addCommand(listCommand)
+    .addCommand(addCommand)
+    .addCommand(removeCommand)
+    .addCommand(roleCommand);
+//# sourceMappingURL=members.js.map

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

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

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

@@ -0,0 +1,17 @@
+/**
+ * studiograph serve command
+ *
+ * Starts the Studiograph HTTP server, hosting:
+ *   - Graph API (read-only REST)
+ *   - Agent chat (POST /api/chat, GET /api/chat/stream)
+ *   - GitHub webhook (POST /webhooks/github)
+ *   - Installed app plugins (from .studiograph/apps/)
+ *
+ * Environment variables:
+ *   API_KEYS         — semicolon-separated bearer tokens (e.g. "key1;key2")
+ *   WEBHOOK_SECRET   — GitHub HMAC-SHA256 secret (optional)
+ *   PORT             — HTTP port (default 3000)
+ *   HOST             — Bind address (default 0.0.0.0)
+ */
+import { Command } from 'commander';
+export declare const serveCommand: Command;

package/dist/cli/commands/serve.js

@@ -0,0 +1,90 @@
+/**
+ * studiograph serve command
+ *
+ * Starts the Studiograph HTTP server, hosting:
+ *   - Graph API (read-only REST)
+ *   - Agent chat (POST /api/chat, GET /api/chat/stream)
+ *   - GitHub webhook (POST /webhooks/github)
+ *   - Installed app plugins (from .studiograph/apps/)
+ *
+ * Environment variables:
+ *   API_KEYS         — semicolon-separated bearer tokens (e.g. "key1;key2")
+ *   WEBHOOK_SECRET   — GitHub HMAC-SHA256 secret (optional)
+ *   PORT             — HTTP port (default 3000)
+ *   HOST             — Bind address (default 0.0.0.0)
+ */
+import { Command } from 'commander';
+import { join } from 'path';
+import { Workspace } from '../../core/workspace.js';
+import { WorkspaceManager } from '../../core/workspace-manager.js';
+import { loadUserConfig } from '../../core/user-config.js';
+import { runPreflight } from '../../utils/preflight.js';
+import { createServer } from '../../server/index.js';
+export const serveCommand = new Command('serve')
+    .description('Start the Studiograph HTTP server')
+    .option('-p, --port <port>', 'Port to listen on', '3000')
+    .option('-H, --host <host>', 'Host to bind to', '0.0.0.0')
+    .action(async (opts) => {
+    const workspace = new Workspace();
+    if (!workspace.isWorkspace()) {
+        console.error('Not a Studiograph workspace. Run `studiograph init` first.');
+        process.exit(1);
+    }
+    const ready = runPreflight();
+    if (!ready) {
+        process.exit(1);
+        return;
+    }
+    const config = workspace.loadConfig();
+    // Propagate API key from user config to env (orchestrator reads ANTHROPIC_API_KEY)
+    const userConfig = loadUserConfig();
+    if (userConfig.api_key && !process.env.ANTHROPIC_API_KEY) {
+        process.env.ANTHROPIC_API_KEY = userConfig.api_key;
+    }
+    // Build GitUser from workspace config
+    const gitUser = {
+        id: 'serve',
+        name: config.team_name || 'Studiograph Server',
+        email: 'noreply@studiograph.local',
+    };
+    // Admin user for WorkspaceManager (server has full access)
+    const serverUser = { ...gitUser, role: 'admin' };
+    const workspaceManager = new WorkspaceManager(process.cwd(), config, gitUser, serverUser);
+    // Read API keys from environment (semicolon-separated)
+    const apiKeysEnv = process.env.API_KEYS || '';
+    const apiKeys = apiKeysEnv
+        .split(';')
+        .map(k => k.trim())
+        .filter(k => k.length > 0);
+    if (apiKeys.length === 0) {
+        console.warn('Warning: No API_KEYS configured — server is open (dev mode)');
+    }
+    const webhookSecret = process.env.WEBHOOK_SECRET;
+    const port = parseInt(process.env.PORT || opts.port, 10);
+    const host = process.env.HOST || opts.host;
+    const appsDir = join(process.cwd(), '.studiograph', 'apps');
+    const server = await createServer({
+        workspaceManager,
+        workspacePath: process.cwd(),
+        workspaceConfig: config,
+        gitUser,
+        appsDir,
+        port,
+        host,
+        apiKeys,
+        webhookSecret,
+    });
+    await server.listen({ port, host });
+    console.log(`\nStudiograph server running at http://${host}:${port}`);
+    console.log('\nRoutes:');
+    console.log('  GET  /api/repos');
+    console.log('  GET  /api/repos/:repo/entities/:type');
+    console.log('  GET  /api/repos/:repo/entities/:type/:id');
+    console.log('  GET  /api/repos/:repo/search');
+    console.log('  GET  /api/search');
+    console.log('  POST /api/chat');
+    console.log('  GET  /api/chat/stream');
+    console.log('  POST /webhooks/github');
+    console.log('\nApp plugins loaded from:', appsDir);
+});
+//# sourceMappingURL=serve.js.map

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

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

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

@@ -0,0 +1,7 @@
+/**
+ * studiograph start command
+ *
+ * Launches the Studiograph agent chat interface with memory support
+ */
+import { Command } from 'commander';
+export declare const startCommand: Command;