studiograph 1.0.0

package/dist/core/workspace-manager.js

@@ -0,0 +1,432 @@
+/**
+ * Workspace Manager
+ *
+ * Coordinates multiple repository graph managers.
+ * Provides cross-repo search, wikilink validation, and unified operations.
+ */
+import { join } from 'path';
+import { existsSync, readdirSync } from 'fs';
+import { BaseGraphManager } from './graph.js';
+import { PermissionError } from './types.js';
+import { ENTITY_SCHEMAS } from './validation.js';
+export class WorkspaceManager {
+    workspacePath;
+    config;
+    graphs;
+    gitUser;
+    user;
+    constructor(workspacePath, config, gitUser, user) {
+        this.workspacePath = workspacePath;
+        this.config = config;
+        this.gitUser = gitUser;
+        this.user = user;
+        this.graphs = new Map();
+        // Initialize graph managers for all repos
+        this.initializeGraphs();
+    }
+    /**
+     * Initialize graph managers for all configured repos
+     */
+    initializeGraphs() {
+        for (const repo of this.config.repos) {
+            const repoPath = join(this.workspacePath, repo.path);
+            if (!existsSync(repoPath)) {
+                console.warn(`Repository path does not exist: ${repoPath} (skipping)`);
+                continue;
+            }
+            // Determine asset config
+            let assetConfig;
+            if (this.config.r2_config?.account_id && this.config.r2_config?.bucket) {
+                // Use R2 for production - map snake_case to camelCase
+                assetConfig = {
+                    storage: 'r2',
+                    r2Config: {
+                        accountId: this.config.r2_config.account_id,
+                        bucket: this.config.r2_config.bucket,
+                        publicUrl: this.config.r2_config.public_url,
+                        accessKeyId: this.config.r2_config.access_key_id,
+                        secretAccessKey: this.config.r2_config.secret_access_key,
+                    },
+                };
+            }
+            else {
+                // Use local storage for development
+                assetConfig = {
+                    storage: 'local',
+                    localPath: join(this.workspacePath, '.studiograph', 'assets'),
+                };
+            }
+            // Create graph manager
+            const graph = new BaseGraphManager({
+                repoPath,
+                assetConfig,
+                gitUser: this.gitUser,
+            });
+            this.graphs.set(repo.name, graph);
+        }
+    }
+    /**
+     * Check if user has access to a repository
+     */
+    canAccessRepo(repoName) {
+        const repoConfig = this.getRepoConfig(repoName);
+        if (!repoConfig) {
+            return false;
+        }
+        const userRole = this.user.role || 'guest';
+        const repoAccess = repoConfig.access || 'team';
+        // Admin users can access all repos
+        if (userRole === 'admin') {
+            return true;
+        }
+        // Check access based on repo access level
+        switch (repoAccess) {
+            case 'public':
+                return true; // All users can access public repos
+            case 'team':
+                return userRole === 'member'; // admin already returned true above
+            case 'admin':
+                return false; // only admins can access, and they already returned true above
+            case 'restricted':
+                return false; // only admins can access, and they already returned true above
+            default:
+                return false;
+        }
+    }
+    /**
+     * Get graph manager for a specific repo
+     * @throws PermissionError if user lacks access to repo
+     */
+    getGraph(repoName) {
+        if (!this.canAccessRepo(repoName)) {
+            throw new PermissionError(`Access denied to repository: ${repoName}`);
+        }
+        const graph = this.graphs.get(repoName);
+        if (!graph) {
+            throw new Error(`Repository not found: ${repoName}`);
+        }
+        return graph;
+    }
+    /**
+     * Get all repository names (filtered by user access)
+     */
+    getRepoNames() {
+        return Array.from(this.graphs.keys()).filter(repoName => this.canAccessRepo(repoName));
+    }
+    /**
+     * Get repository configuration
+     */
+    getRepoConfig(repoName) {
+        return this.config.repos.find(r => r.name === repoName);
+    }
+    /**
+     * Get all repository configurations (filtered by user access)
+     */
+    getAllRepoConfigs() {
+        return this.config.repos.filter(repo => this.canAccessRepo(repo.name));
+    }
+    /**
+     * Search across all repositories (filtered by user access)
+     */
+    search(options) {
+        const results = [];
+        // Determine which repos to search (filter by access)
+        const requestedRepos = options.repoNames || this.getRepoNames();
+        const reposToSearch = requestedRepos.filter(repoName => this.canAccessRepo(repoName));
+        for (const repoName of reposToSearch) {
+            const graph = this.graphs.get(repoName);
+            if (!graph) {
+                continue;
+            }
+            try {
+                const entities = graph.search(options);
+                // Add repo name to each result
+                for (const entity of entities) {
+                    results.push({
+                        ...entity,
+                        repoName,
+                    });
+                }
+            }
+            catch (error) {
+                console.warn(`Error searching repo ${repoName}:`, error);
+            }
+        }
+        // Apply global limit if specified
+        if (options.limit && options.limit > 0) {
+            return results.slice(0, options.limit);
+        }
+        return results;
+    }
+    /**
+     * List entities across all repositories (filtered by user access)
+     */
+    list(entityType, limit) {
+        const results = [];
+        for (const [repoName, graph] of this.graphs) {
+            // Skip repos the user can't access
+            if (!this.canAccessRepo(repoName)) {
+                continue;
+            }
+            try {
+                const entities = graph.list(entityType);
+                for (const entity of entities) {
+                    results.push({
+                        ...entity,
+                        repoName,
+                    });
+                }
+            }
+            catch (error) {
+                console.warn(`Error listing entities in repo ${repoName}:`, error);
+            }
+        }
+        // Apply limit
+        if (limit && limit > 0) {
+            return results.slice(0, limit);
+        }
+        return results;
+    }
+    /**
+     * Find entity across all repositories (filtered by user access)
+     */
+    findEntity(entityType, entityId) {
+        for (const [repoName, graph] of this.graphs) {
+            // Skip repos the user can't access
+            if (!this.canAccessRepo(repoName)) {
+                continue;
+            }
+            try {
+                const entity = graph.get(entityType, entityId);
+                return {
+                    ...entity,
+                    repoName,
+                };
+            }
+            catch {
+                // Entity not found in this repo, continue searching
+            }
+        }
+        return null;
+    }
+    /**
+     * Validate wikilinks across all repositories (filtered by user access)
+     * @throws PermissionError if user lacks access to source repo
+     */
+    validateWikilinks(repoName, entityType, entityId) {
+        const graph = this.getGraph(repoName); // Checks access
+        const entity = graph.get(entityType, entityId);
+        const valid = [];
+        const broken = [];
+        const crossRepo = [];
+        const inaccessible = [];
+        for (const link of entity.document.wikilinks) {
+            let foundInSameRepo = false;
+            let foundInOtherRepo = false;
+            // First, check in the same repo
+            // Try all entity types since wikilinks don't specify type
+            const allTypes = Object.keys(ENTITY_SCHEMAS);
+            for (const searchType of allTypes) {
+                try {
+                    graph.get(searchType, link);
+                    foundInSameRepo = true;
+                    valid.push(link);
+                    break;
+                }
+                catch {
+                    // Not this type, continue
+                }
+            }
+            // If not found in same repo, search other repos (only accessible ones)
+            if (!foundInSameRepo) {
+                // First pass: Search accessible repos
+                for (const [otherRepoName, otherGraph] of this.graphs) {
+                    if (otherRepoName === repoName) {
+                        continue; // Already checked this repo
+                    }
+                    // Skip repos the user can't access (check them in second pass)
+                    if (!this.canAccessRepo(otherRepoName)) {
+                        continue;
+                    }
+                    for (const searchType of allTypes) {
+                        try {
+                            otherGraph.get(searchType, link);
+                            crossRepo.push({ link, repo: otherRepoName });
+                            foundInOtherRepo = true;
+                            break;
+                        }
+                        catch {
+                            // Not this type, continue
+                        }
+                    }
+                    if (foundInOtherRepo) {
+                        break; // Found it, stop searching repos
+                    }
+                }
+                // If not found in accessible repos, check inaccessible repos
+                if (!foundInOtherRepo) {
+                    let foundInInaccessibleRepo = false;
+                    for (const [otherRepoName, otherGraph] of this.graphs) {
+                        if (otherRepoName === repoName) {
+                            continue; // Already checked this repo
+                        }
+                        // Only check repos the user can't access
+                        if (this.canAccessRepo(otherRepoName)) {
+                            continue; // Already checked in first pass
+                        }
+                        for (const searchType of allTypes) {
+                            try {
+                                otherGraph.get(searchType, link);
+                                const repoConfig = this.getRepoConfig(otherRepoName);
+                                inaccessible.push({
+                                    link,
+                                    repo: otherRepoName,
+                                    requiredAccess: repoConfig?.access || 'team',
+                                });
+                                foundInInaccessibleRepo = true;
+                                break;
+                            }
+                            catch {
+                                // Not this type, continue
+                            }
+                        }
+                        if (foundInInaccessibleRepo) {
+                            break; // Found it, stop searching repos
+                        }
+                    }
+                    // Only mark as broken if not found anywhere (including inaccessible repos)
+                    if (!foundInInaccessibleRepo) {
+                        broken.push(link);
+                    }
+                }
+            }
+        }
+        return { valid, broken, crossRepo, inaccessible };
+    }
+    /**
+     * Get entities related to a given entity (cross-repo, filtered by user access)
+     * @throws PermissionError if user lacks access to source repo
+     */
+    getRelated(repoName, entityType, entityId) {
+        const graph = this.getGraph(repoName); // Checks access
+        const entity = graph.get(entityType, entityId);
+        const results = [];
+        // Search for wikilinked entities across all repos (only accessible ones)
+        for (const link of entity.document.wikilinks) {
+            for (const [searchRepoName, searchGraph] of this.graphs) {
+                // Skip repos the user can't access
+                if (!this.canAccessRepo(searchRepoName)) {
+                    continue;
+                }
+                try {
+                    // Try to find entity in this repo
+                    const allTypes = Object.keys(ENTITY_SCHEMAS);
+                    for (const searchType of allTypes) {
+                        try {
+                            const linkedEntity = searchGraph.get(searchType, link);
+                            results.push({
+                                ...linkedEntity,
+                                repoName: searchRepoName,
+                            });
+                            break; // Found it, stop searching types
+                        }
+                        catch {
+                            // Not this type, continue
+                        }
+                    }
+                }
+                catch {
+                    // Entity not found in this repo
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * Get backlinks across all repositories (filtered by user access)
+     */
+    getBacklinks(repoName, entityType, entityId) {
+        const results = [];
+        for (const [searchRepoName, searchGraph] of this.graphs) {
+            // Skip repos the user can't access
+            if (!this.canAccessRepo(searchRepoName)) {
+                continue;
+            }
+            try {
+                const backlinks = searchGraph.getBacklinks(entityType, entityId);
+                for (const backlink of backlinks) {
+                    results.push({
+                        ...backlink,
+                        repoName: searchRepoName,
+                    });
+                }
+            }
+            catch (error) {
+                console.warn(`Error getting backlinks from repo ${searchRepoName}:`, error);
+            }
+        }
+        return results;
+    }
+    /**
+     * Get workspace summary statistics (filtered by user access)
+     */
+    getSummary() {
+        const summary = {
+            totalRepos: 0,
+            totalEntities: 0,
+            entitiesByType: {},
+            entitiesByRepo: {},
+        };
+        for (const [repoName, graph] of this.graphs) {
+            // Skip repos the user can't access
+            if (!this.canAccessRepo(repoName)) {
+                continue;
+            }
+            summary.totalRepos++;
+            const entities = graph.list();
+            summary.totalEntities += entities.length;
+            summary.entitiesByRepo[repoName] = entities.length;
+            for (const entity of entities) {
+                const type = entity.entityType;
+                summary.entitiesByType[type] = (summary.entitiesByType[type] || 0) + 1;
+            }
+        }
+        return summary;
+    }
+    /**
+     * Discover repos in workspace (find .studiograph marker files)
+     */
+    static discoverRepos(workspacePath) {
+        const discovered = [];
+        if (!existsSync(workspacePath)) {
+            return discovered;
+        }
+        // Scan immediate subdirectories
+        const entries = readdirSync(workspacePath, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory()) {
+                continue;
+            }
+            const entryPath = join(workspacePath, entry.name);
+            const markerPath = join(entryPath, '.studiograph');
+            // Check for .studiograph marker directory
+            if (existsSync(markerPath)) {
+                // Infer type from directory name patterns
+                let type = 'shared-resource'; // Default
+                if (entry.name.includes('project') || entry.name.match(/^[a-z]+-[a-z]+$/)) {
+                    type = 'project';
+                }
+                else if (['accounting', 'hr', 'marketing', 'new-business', 'planning'].includes(entry.name)) {
+                    type = 'function';
+                }
+                discovered.push({
+                    name: entry.name,
+                    path: entry.name,
+                    type,
+                });
+            }
+        }
+        return discovered;
+    }
+}
+//# sourceMappingURL=workspace-manager.js.map

package/dist/core/workspace-manager.js.map

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

package/dist/core/workspace.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Workspace management for Studiograph
+ *
+ * A workspace is a directory with .studiograph/ folder
+ * Similar to how Git works with .git/
+ */
+import { WorkspaceConfig, RepoConfig, RepoConfigInput } from './types.js';
+/**
+ * Team member definition from team/members.json
+ */
+export interface TeamMember {
+    id: string;
+    name: string;
+    email: string;
+    role: 'admin' | 'member' | 'guest';
+    github_username?: string;
+    joined_at?: string;
+    active?: boolean;
+}
+export declare class Workspace {
+    private workspacePath;
+    private configPath;
+    private jsonConfigPath;
+    private membersPath;
+    private config;
+    constructor(workspacePath?: string);
+    /**
+     * Check if current directory is a Studiograph workspace
+     * Supports both workspace.json (new) and config.yml (legacy)
+     */
+    isWorkspace(): boolean;
+    /**
+     * Initialize new workspace in current directory
+     */
+    init(teamName: string): void;
+    /**
+     * Load workspace config
+     * Reads workspace.json (new format) or falls back to config.yml (legacy)
+     */
+    loadConfig(): WorkspaceConfig;
+    /**
+     * Write workspace config as workspace.json
+     */
+    writeConfig(config: WorkspaceConfig): void;
+    /**
+     * Load team members from team/members.json
+     */
+    loadMembers(): TeamMember[];
+    /**
+     * Write team members to team/members.json
+     */
+    writeMembers(members: TeamMember[]): void;
+    /**
+     * Get the GitHub org stored in workspace.json
+     */
+    getGitHubOrg(): string | undefined;
+    /**
+     * Set the GitHub org in workspace.json
+     */
+    setGitHubOrg(org: string): void;
+    /**
+     * Update model configuration.
+     *
+     * Provider and model ID are written to user config (~/.studiograph/user.json)
+     * so they are personal and never committed to the shared workspace repo.
+     * The API key is also written only to user config — it is never stored in
+     * workspace.json.
+     */
+    setModelConfig(provider: string, modelId: string, apiKey?: string): void;
+    /**
+     * Generate README content for a repo
+     */
+    private generateRepoReadme;
+    /**
+     * Get guidance text for a repo type
+     */
+    private getRepoTypeGuidance;
+    /**
+     * Register a new repo in the workspace
+     */
+    registerRepo(repo: RepoConfigInput): RepoConfig;
+    /**
+     * Get all registered repos
+     */
+    getRepos(): RepoConfig[];
+    /**
+     * Get repo by name
+     */
+    getRepo(name: string): RepoConfig | undefined;
+    /**
+     * Get absolute path to repo
+     */
+    getRepoPath(repoName: string): string;
+    /**
+     * Get workspace root path
+     */
+    getWorkspacePath(): string;
+    /**
+     * Find workspace root by walking up directory tree
+     * (like git does with .git/)
+     */
+    static findWorkspaceRoot(startPath?: string): string | null;
+}