studiograph 1.1.2 → 1.2.0-beta.1

package/dist/cli/commands/update.js

@@ -0,0 +1,155 @@
+/**
+ * studiograph update
+ *
+ * Self-update command that checks for and installs the latest version
+ * from GitHub releases or npm registry.
+ */
+import { Command } from 'commander';
+import { intro, outro, spinner, confirm, log } from '@clack/prompts';
+import { execSync, spawnSync } from 'child_process';
+import { readFileSync } from 'fs';
+import { join } from 'path';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+// Get current CLI version
+function getCurrentVersion() {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
+    const pkgPath = join(__dirname, '../../../package.json');
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+    return pkg.version;
+}
+// Check npm for latest version
+async function getLatestNpmVersion() {
+    try {
+        const result = execSync('npm view studiograph version', {
+            encoding: 'utf-8',
+            stdio: 'pipe',
+        });
+        return result.trim();
+    }
+    catch {
+        return null;
+    }
+}
+// Compare semantic versions
+function compareVersions(v1, v2) {
+    const parts1 = v1.split('.').map(Number);
+    const parts2 = v2.split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        if (parts1[i] > parts2[i])
+            return 1;
+        if (parts1[i] < parts2[i])
+            return -1;
+    }
+    return 0;
+}
+// Detect package manager
+function detectPackageManager() {
+    // Check if we're installed globally
+    try {
+        const globalPath = execSync('which studiograph', { encoding: 'utf-8' }).trim();
+        if (globalPath.includes('/.yarn/'))
+            return 'yarn';
+        if (globalPath.includes('/.pnpm/'))
+            return 'pnpm';
+        return 'npm';
+    }
+    catch {
+        return 'npm';
+    }
+}
+// Update via package manager
+function updateViaPM(pm) {
+    const commands = {
+        npm: ['npm', 'install', '-g', 'studiograph@latest'],
+        yarn: ['yarn', 'global', 'add', 'studiograph@latest'],
+        pnpm: ['pnpm', 'add', '-g', 'studiograph@latest'],
+    };
+    try {
+        const result = spawnSync(commands[pm][0], commands[pm].slice(1), {
+            stdio: 'inherit',
+            shell: true,
+        });
+        return result.status === 0;
+    }
+    catch {
+        return false;
+    }
+}
+export const updateCommand = new Command('update')
+    .description('Check for and install the latest version of Studiograph')
+    .option('--check', 'Check for updates without installing')
+    .option('--force', 'Force reinstall current version')
+    .action(async (options) => {
+    intro('Studiograph Update');
+    const s = spinner();
+    s.start('Checking for updates...');
+    const currentVersion = getCurrentVersion();
+    const latestVersion = await getLatestNpmVersion();
+    if (!latestVersion) {
+        s.stop('Could not check for updates');
+        log.error('Failed to fetch latest version from npm registry');
+        outro('Update check failed. Try again later or update manually with:');
+        console.log('  npm install -g studiograph@latest');
+        process.exit(1);
+    }
+    s.stop();
+    const comparison = compareVersions(latestVersion, currentVersion);
+    if (comparison === 0 && !options.force) {
+        log.success(`You're already on the latest version (v${currentVersion})`);
+        outro('No update needed');
+        return;
+    }
+    if (comparison < 0) {
+        log.warn(`You're on v${currentVersion}, which is newer than npm (v${latestVersion})`);
+        log.info('You may be using a development version');
+        outro('No update needed');
+        return;
+    }
+    // Update available
+    log.info(`Current version: v${currentVersion}`);
+    log.success(`Latest version:  v${latestVersion}`);
+    if (options.check) {
+        outro('Update available. Run `studiograph update` to install');
+        return;
+    }
+    // Confirm update
+    const shouldUpdate = await confirm({
+        message: `Update to v${latestVersion}?`,
+        initialValue: true,
+    });
+    if (typeof shouldUpdate === 'symbol' || !shouldUpdate) {
+        outro('Update cancelled');
+        return;
+    }
+    // Detect package manager
+    const pm = detectPackageManager();
+    log.info(`Detected package manager: ${pm}`);
+    // Perform update
+    const updateSpinner = spinner();
+    updateSpinner.start(`Installing v${latestVersion} via ${pm}...`);
+    const success = updateViaPM(pm);
+    if (success) {
+        updateSpinner.stop(`✓ Updated to v${latestVersion}`);
+        // Verify new version
+        const newVersion = getCurrentVersion();
+        if (newVersion === latestVersion) {
+            log.success('Update completed successfully!');
+            outro(`Studiograph is now at v${newVersion}`);
+        }
+        else {
+            log.warn('Update may have succeeded, but version check shows unexpected result');
+            log.info('Try running `studiograph --version` to verify');
+            outro('Update completed');
+        }
+    }
+    else {
+        updateSpinner.stop('Update failed');
+        log.error('Failed to install update via package manager');
+        outro('You can try updating manually with:');
+        console.log(`  ${pm} ${pm === 'npm' ? 'install -g' : 'global add'} studiograph@latest`);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=update.js.map

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

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

package/dist/cli/index.js

@@ -8,26 +8,137 @@ import { Command } from 'commander';
 import { initCommand } from './commands/init.js';
 import { startCommand } from './commands/start.js';
 import { joinCommand } from './commands/join.js';
+import { cloneCommand } from './commands/clone.js';
 import { authCommand } from './commands/auth.js';
 import { membersCommand } from './commands/members.js';
 import { pullCommand, pushCommand } from './commands/sync.js';
 import { serveCommand } from './commands/serve.js';
 import { r2Command } from './commands/r2.js';
+import { appCommand } from './commands/app.js';
+import { deployCommand } from './commands/deploy.js';
+import { mcpCommand } from './commands/mcp.js';
+import { connectorCommand } from './commands/connector.js';
+import { sourceCommand } from './commands/source.js';
+import { syncEntitiesCommand } from './commands/sync-entities.js';
+import { enrichCommand } from './commands/enrich.js';
+import { reviewCommand } from './commands/review.js';
+import { commitCommand } from './commands/commit.js';
+import { indexCommand } from './commands/index.js';
+import { configCommand } from './commands/config.js';
+import { lintCommand } from './commands/lint.js';
+import { updateCommand } from './commands/update.js';
+import { provisionCommand } from './commands/provision.js';
+import { resetCommand } from './commands/reset.js';
+import { graphragCommand } from './commands/graphrag.js';
+import { orphansCommand } from './commands/orphans.js';
 const program = new Command();
 program
     .name('studiograph')
     .description('Team-based AI agent platform with Git-backed knowledge graphs')
     .version('1.0.0');
-// Register commands
+// Configure custom help to show grouped commands
+program.configureHelp({
+    sortSubcommands: false,
+    // Override the command list formatter to show grouped commands
+    formatHelp: (cmd, helper) => {
+        const termWidth = helper.padWidth(cmd, helper);
+        const helpWidth = helper.helpWidth || 80;
+        const itemIndentWidth = 2;
+        const itemSeparatorWidth = 2;
+        const formatItem = (term, description) => {
+            const pad = ' '.repeat(Math.max(0, termWidth - term.length + itemSeparatorWidth));
+            return `${' '.repeat(itemIndentWidth)}${term}${pad}${description}`;
+        };
+        const sections = [
+            `Usage: ${helper.commandUsage(cmd)}`,
+            '',
+            helper.commandDescription(cmd),
+            '',
+            'Options:',
+            ...cmd.options.map(opt => formatItem(helper.optionTerm(opt), helper.optionDescription(opt))),
+            formatItem('-h, --help', 'display help for command'),
+            '',
+            'Getting Started:',
+            formatItem('init <team-name> [dir]', 'Initialize a new workspace'),
+            formatItem('join <url> [dir]', 'Join an existing workspace'),
+            formatItem('clone <url> [dir]', 'Clone workspace with full admin setup'),
+            formatItem('auth', 'Manage GitHub authentication'),
+            '',
+            'Daily Workflow:',
+            formatItem('start', 'Start the AI agent'),
+            formatItem('pull', 'Pull latest changes'),
+            formatItem('push', 'Push local commits'),
+            '',
+            'Workspace Management:',
+            formatItem('provision', 'Push workspace to GitHub'),
+            formatItem('members', 'Manage team members'),
+            formatItem('index', 'Index for search'),
+            formatItem('lint', 'Check entity completeness'),
+            formatItem('config', 'Manage configuration'),
+            '',
+            'Server & Deployment:',
+            formatItem('serve', 'Start HTTP server'),
+            formatItem('deploy', 'Deploy to hosting platform'),
+            '',
+            'Data Sync:',
+            formatItem('source', 'Manage sync sources'),
+            formatItem('sync', 'Sync entities from external sources'),
+            formatItem('enrich', 'Enrich entities with context'),
+            formatItem('graphrag', 'Knowledge graph for cross-document context'),
+            formatItem('review', 'Review entity changes'),
+            formatItem('commit', 'Git commit entity changes'),
+            formatItem('graphrag', 'LightRAG knowledge graph'),
+            '',
+            'Integrations & Extensions:',
+            formatItem('mcp', 'Claude Desktop integration'),
+            formatItem('connector', 'Third-party integrations'),
+            formatItem('app', 'Manage app plugins'),
+            formatItem('r2', 'Cloudflare R2 assets'),
+            '',
+            'Maintenance:',
+            formatItem('reset', 'Reset workspace (remove entity data)'),
+            formatItem('update', 'Update Studiograph CLI'),
+            formatItem('help [command]', 'Display help for command'),
+        ];
+        return sections.join('\n');
+    },
+});
+// Register commands in grouped order
+// Getting Started
 program.addCommand(initCommand);
-program.addCommand(startCommand);
 program.addCommand(joinCommand);
+program.addCommand(cloneCommand);
 program.addCommand(authCommand);
-program.addCommand(membersCommand);
+// Daily Workflow
+program.addCommand(startCommand);
 program.addCommand(pullCommand);
 program.addCommand(pushCommand);
+// Workspace Management
+program.addCommand(provisionCommand);
+program.addCommand(membersCommand);
+program.addCommand(indexCommand);
+program.addCommand(lintCommand);
+program.addCommand(orphansCommand);
+program.addCommand(configCommand);
+// Server & Deployment
 program.addCommand(serveCommand);
+program.addCommand(deployCommand);
+// Data Sync
+program.addCommand(sourceCommand);
+program.addCommand(syncEntitiesCommand);
+program.addCommand(enrichCommand);
+program.addCommand(graphragCommand);
+program.addCommand(reviewCommand);
+program.addCommand(commitCommand);
+program.addCommand(graphragCommand);
+// Integrations & Extensions
+program.addCommand(mcpCommand);
+program.addCommand(connectorCommand);
+program.addCommand(appCommand);
 program.addCommand(r2Command);
+// Maintenance
+program.addCommand(resetCommand);
+program.addCommand(updateCommand);
 // Parse arguments
 program.parse();
 //# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,aAAa,CAAC;KACnB,WAAW,CAAC,+DAA+D,CAAC;KAC5E,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,oBAAoB;AACpB,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AAE9B,kBAAkB;AAClB,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/cli/scaffolding.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Example entity scaffolding for new workspaces
+ *
+ * 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, distributed across repos
+ * matching the fluid folder model.
+ */
+import { Workspace } from '../core/workspace.js';
+export declare function scaffoldExampleEntities(workspace: Workspace, teamName: string): Promise<void>;

package/dist/cli/scaffolding.js

@@ -0,0 +1,302 @@
+/**
+ * Example entity scaffolding for new workspaces
+ *
+ * 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, 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';
+/** Repos scaffolded during init — one per entity type */
+const STARTER_REPOS = [
+    { name: 'projects', type: RepoType.PROJECT, description: 'Client projects and engagements' },
+    { name: 'clients', type: RepoType.PROJECT, description: 'Client organizations' },
+    { name: 'people', type: RepoType.PROJECT, description: 'Contacts and team members' },
+    { name: 'meetings', type: RepoType.PROJECT, description: 'Meeting notes' },
+];
+function buildEntities(now) {
+    const shared = {
+        created_by: 'studiograph',
+        updated_by: 'studiograph',
+        created_at: now,
+        updated_at: now,
+        tags: ['example'],
+    };
+    return [
+        {
+            repo: 'clients',
+            entityType: 'client',
+            entityId: 'meridian-health',
+            frontmatter: {
+                entity_type: 'client',
+                entity_id: 'meridian-health',
+                ...shared,
+                name: 'Meridian Health',
+                type: 'corporate',
+                status: 'active',
+                industry: 'Healthcare',
+                contacts: ['[[sarah-chen]]'],
+                projects: ['[[meridian-rebrand]]'],
+            },
+            content: `# Meridian Health
+
+Regional healthcare network with 12 hospitals across the Midwest. Engaged us for a comprehensive brand refresh following their merger with Lakeside Medical Group.
+
+## Relationship History
+
+- **2025-Q4** — Initial outreach via referral from [[sarah-chen]]
+- **2026-Q1** — Discovery workshops and brand audit
+- **2026-Q1** — Kicked off [[meridian-rebrand]]
+
+## Key Contacts
+
+- [[sarah-chen]] — VP of Marketing, primary stakeholder
+`,
+        },
+        {
+            repo: 'people',
+            entityType: 'person',
+            entityId: 'sarah-chen',
+            frontmatter: {
+                entity_type: 'person',
+                entity_id: 'sarah-chen',
+                ...shared,
+                name: 'Sarah Chen',
+                role: 'VP of Marketing',
+                status: 'client',
+                organization: '[[meridian-health]]',
+                projects: ['[[meridian-rebrand]]'],
+            },
+            content: `# Sarah Chen
+
+VP of Marketing at [[meridian-health]]. Primary stakeholder for the [[meridian-rebrand]] engagement.
+
+## Notes
+
+- Prefers async communication (email/Slack over calls)
+- Strong opinions on accessibility — ensure all deliverables meet WCAG 2.1 AA
+- Previously led rebrand at Cedar Health (2023)
+`,
+        },
+        {
+            repo: 'projects',
+            entityType: 'project',
+            entityId: 'meridian-rebrand',
+            frontmatter: {
+                entity_type: 'project',
+                entity_id: 'meridian-rebrand',
+                ...shared,
+                name: 'Meridian Health Brand Refresh',
+                client: '[[meridian-health]]',
+                status: 'active',
+                start_date: '2026-02-10',
+                team: ['[[sarah-chen]]'],
+            },
+            content: `# Meridian Health Brand Refresh
+
+Comprehensive brand identity refresh for [[meridian-health]] following their merger with Lakeside Medical Group. The goal is to create a unified brand that honors both organizations' heritage while signaling a forward-looking, patient-centered vision.
+
+## Objectives
+
+1. Unified visual identity across all 12 hospital locations
+2. Updated brand guidelines and asset library
+3. Digital-first brand system (web, app, social)
+
+## Key Decisions
+
+- [[dec-2026-001]] — Adopt evolutionary brand refresh (not revolutionary)
+
+## Timeline
+
+- **Feb 2026** — Discovery & audit (see [[2026-02-10-kickoff]])
+- **Mar 2026** — Concept development
+- **Apr 2026** — Refinement & testing
+- **May 2026** — Final delivery & rollout planning
+`,
+        },
+        {
+            repo: 'meetings',
+            entityType: 'meeting',
+            entityId: '2026-02-10-kickoff',
+            frontmatter: {
+                entity_type: 'meeting',
+                entity_id: '2026-02-10-kickoff',
+                ...shared,
+                name: 'Meridian Rebrand Kickoff',
+                date: '2026-02-10',
+                attendees: ['[[sarah-chen]]'],
+                related_projects: ['[[meridian-rebrand]]'],
+            },
+            content: `# Meridian Rebrand Kickoff
+
+Kickoff meeting for the [[meridian-rebrand]] project with [[sarah-chen]] and the Meridian marketing team.
+
+## Agenda
+
+1. Introductions and project overview
+2. Brand audit findings review
+3. Timeline and milestones
+4. Decision on brand refresh approach
+
+## Discussion Notes
+
+- Meridian team emphasized the importance of retaining trust signals from both legacy brands
+- Patient research shows strong emotional attachment to the Lakeside "caring hands" motif
+- Board has approved budget for full rollout by Q3 2026
+
+## Decisions Made
+
+- [[dec-2026-001]] — Agreed to pursue an evolutionary refresh rather than a complete rebrand
+
+## Action Items
+
+- [ ] Share brand audit deck with Meridian team
+- [ ] Schedule stakeholder interviews (week of Feb 17)
+- [ ] Draft creative brief by Feb 14
+`,
+        },
+        {
+            repo: 'projects',
+            entityType: 'decision',
+            entityId: 'dec-2026-001',
+            frontmatter: {
+                entity_type: 'decision',
+                entity_id: 'dec-2026-001',
+                ...shared,
+                id: 'DEC-2026-001',
+                title: 'Adopt evolutionary brand refresh',
+                date: '2026-02-10',
+                status: 'accepted',
+                decision_makers: ['[[sarah-chen]]'],
+                stakeholders: ['[[meridian-health]]'],
+            },
+            content: `# DEC-2026-001: Adopt Evolutionary Brand Refresh
+
+## Context
+
+Following the merger of [[meridian-health]] and Lakeside Medical Group, the combined organization needs a unified brand identity. The core question: should we build an entirely new brand from scratch, or evolve the existing Meridian identity?
+
+## Alternatives Considered
+
+1. **Revolutionary rebrand** — entirely new name, logo, and visual system
+2. **Evolutionary refresh** — retain Meridian name and core equity, modernize visual system, incorporate Lakeside heritage elements
+3. **Dual-brand** — maintain both brands with a shared parent identity
+
+## Decision
+
+Option 2: Evolutionary refresh. Retain the Meridian Health name and update the visual identity to reflect the merged organization's expanded scope and values.
+
+## Rationale
+
+- Patient research shows 78% brand recognition for "Meridian" in core markets
+- Revolutionary rebrand estimated at 2x the budget and timeline
+- Lakeside heritage can be honored through visual motifs without a name change
+
+## Consequences
+
+- **Positive:** Preserves brand equity, faster rollout, lower risk
+- **Negative:** Some Lakeside staff may feel underrepresented; requires careful internal communications
+`,
+        },
+    ];
+}
+function buildOnboardingGuide(teamName) {
+    return `# Welcome to ${teamName}
+
+This workspace is powered by **Studiograph** — a knowledge graph for creative teams. Your team's knowledge is stored as Markdown files with YAML frontmatter, connected by \`[[wikilinks]]\`.
+
+## How It Works
+
+Every piece of knowledge is an **entity** — a Markdown file with structured metadata:
+
+\`\`\`markdown
+---
+entity_type: project
+entity_id: my-project
+name: "My Project"
+status: active
+created_at: 2026-02-20T00:00:00.000Z
+updated_at: 2026-02-20T00:00:00.000Z
+created_by: your-name
+updated_by: your-name
+---
+
+# My Project
+
+Project details here. Link to other entities with [[wikilinks]].
+\`\`\`
+
+## Entity Types
+
+| Type | Purpose | Example |
+|------|---------|---------|
+| \`client\` | Client organizations | Meridian Health |
+| \`project\` | Engagements & initiatives | Brand refresh |
+| \`person\` | Contacts & team members | Sarah Chen |
+| \`meeting\` | Meeting notes & action items | Kickoff meeting |
+| \`decision\` | Structured decision records | DEC-2026-001 |
+| \`proposal\` | Client proposals & SOWs | — |
+| \`deliverable\` | Scoped outputs & artifacts | — |
+| \`brief\` | Project briefs | — |
+
+## Common Commands
+
+\`\`\`bash
+studiograph start              # Start an interactive AI session
+studiograph search "query"     # Search across all repos
+studiograph list               # List entities in a repo
+studiograph get <entity-id>    # View a specific entity
+\`\`\`
+
+## Explore the Examples
+
+Example entities are tagged \`example\` and distributed across repos:
+
+- \`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/dec-2026-001/main.md\` — a structured decision record
+- \`meetings/2026-02-10-kickoff/main.md\` — a meeting with notes and action items
+
+Notice how \`[[wikilinks]]\` connect everything into a navigable graph across repos.
+
+## Cleaning Up Examples
+
+When you're ready to remove the example entities, delete the folders tagged \`example\`:
+
+\`\`\`bash
+rm -rf clients/meridian-health projects/meridian-rebrand projects/dec-2026-001
+rm -rf people/sarah-chen meetings/2026-02-10-kickoff
+\`\`\`
+`;
+}
+export async function scaffoldExampleEntities(workspace, teamName) {
+    const workspacePath = workspace.getWorkspacePath();
+    // Register starter repos
+    for (const repo of STARTER_REPOS) {
+        await workspace.registerRepo({
+            name: repo.name,
+            type: repo.type,
+            description: repo.description,
+        });
+    }
+    // Write example entities into their respective repos
+    const md = new MarkdownService();
+    const now = new Date().toISOString();
+    const entities = buildEntities(now);
+    for (const entity of entities) {
+        const filePath = join(workspacePath, entity.repo, entity.entityId, 'main.md');
+        md.writeFile(filePath, {
+            frontmatter: entity.frontmatter,
+            content: entity.content,
+            wikilinks: [],
+        });
+    }
+    // Write STUDIOGRAPH.md to workspace root
+    const guidePath = join(workspacePath, 'STUDIOGRAPH.md');
+    writeFileSync(guidePath, buildOnboardingGuide(teamName), 'utf-8');
+}
+//# sourceMappingURL=scaffolding.js.map

package/dist/cli/scaffolding.js.map

@@ -0,0 +1 @@
+{"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>;