modular-studio 0.2.0

package/dist-server/server/services/teamRunner.js

@@ -0,0 +1,76 @@
+import { runAgent } from './agentRunner.js';
+function deduplicateFacts(facts) {
+    const seen = new Map();
+    for (const fact of facts) {
+        const existing = seen.get(fact.key);
+        if (!existing || existing.confidence < fact.confidence) {
+            seen.set(fact.key, fact);
+        }
+    }
+    return Array.from(seen.values());
+}
+export async function runTeam(config, onProgress) {
+    const start = Date.now();
+    const sharedFacts = [...(config.initialFacts ?? [])];
+    try {
+        // Build agent configs — each gets its own or shared system prompt + optional role overlay
+        const agentConfigs = config.agents.map((agent) => {
+            let systemPrompt = agent.systemPrompt || config.systemPrompt;
+            if (agent.rolePrompt) {
+                systemPrompt += `\n\n## Your Role\n${agent.rolePrompt}`;
+            }
+            if (agent.repoUrl) {
+                systemPrompt += `\n\n## Repository\nYou are working on: ${agent.repoUrl}`;
+            }
+            return {
+                agentId: agent.agentId,
+                name: agent.name,
+                systemPrompt,
+                task: config.task,
+                providerId: agent.providerId || config.providerId,
+                model: agent.model || config.model,
+                teamFacts: [...sharedFacts],
+                maxTurns: agent.maxTurns ?? 10,
+                tools: config.tools,
+            };
+        });
+        // Run all agents in parallel
+        const results = await Promise.allSettled(agentConfigs.map((agent) => runAgent(agent, onProgress)));
+        const agentResults = results.map((r, i) => {
+            if (r.status === 'fulfilled')
+                return r.value;
+            return {
+                agentId: config.agents[i].agentId,
+                output: '',
+                facts: [],
+                turns: 0,
+                tokens: { input: 0, output: 0 },
+                durationMs: 0,
+                status: 'error',
+                error: r.reason instanceof Error ? r.reason.message : String(r.reason),
+            };
+        });
+        // Merge all extracted facts into shared pool
+        const allFacts = agentResults.flatMap((r) => r.facts);
+        const mergedFacts = deduplicateFacts([...sharedFacts, ...allFacts]);
+        const hasErrors = agentResults.some((r) => r.status === 'error');
+        const allErrors = agentResults.every((r) => r.status === 'error');
+        return {
+            teamId: config.teamId,
+            agentResults,
+            sharedFacts: mergedFacts,
+            durationMs: Date.now() - start,
+            status: allErrors ? 'error' : hasErrors ? 'partial' : 'completed',
+        };
+    }
+    catch (err) {
+        return {
+            teamId: config.teamId,
+            agentResults: [],
+            sharedFacts,
+            durationMs: Date.now() - start,
+            status: 'error',
+        };
+    }
+}
+//# sourceMappingURL=teamRunner.js.map

package/dist-server/server/services/teamRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teamRunner.js","sourceRoot":"","sources":["../../../server/services/teamRunner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAyC5C,SAAS,gBAAgB,CAAC,KAAsB;IAC9C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YACvD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAqB,EAAE,UAA6B;IAChF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,WAAW,GAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC;IAEtE,IAAI,CAAC;QACH,0FAA0F;QAC1F,MAAM,YAAY,GAAqB,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACjE,IAAI,YAAY,GAAG,KAAK,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,CAAC;YAC7D,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACrB,YAAY,IAAI,qBAAqB,KAAK,CAAC,UAAU,EAAE,CAAC;YAC1D,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBAClB,YAAY,IAAI,0CAA0C,KAAK,CAAC,OAAO,EAAE,CAAC;YAC5E,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,YAAY;gBACZ,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU;gBACjD,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK;gBAClC,SAAS,EAAE,CAAC,GAAG,WAAW,CAAC;gBAC3B,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE;gBAC9B,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,6BAA6B;QAC7B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CACzD,CAAC;QAEF,MAAM,YAAY,GAAqB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAC1D,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW;gBAAE,OAAO,CAAC,CAAC,KAAK,CAAC;YAC7C,OAAO;gBACL,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO;gBACjC,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,EAAE;gBACT,KAAK,EAAE,CAAC;gBACR,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;gBAC/B,UAAU,EAAE,CAAC;gBACb,MAAM,EAAE,OAAgB;gBACxB,KAAK,EAAE,CAAC,CAAC,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;aACvE,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,6CAA6C;QAC7C,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACtD,MAAM,WAAW,GAAG,gBAAgB,CAAC,CAAC,GAAG,WAAW,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC;QAEpE,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC;QACjE,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC;QAElE,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,YAAY;YACZ,WAAW,EAAE,WAAW;YACxB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;YAC9B,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW;SAClE,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,YAAY,EAAE,EAAE;YAChB,WAAW;YACX,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;YAC9B,MAAM,EAAE,OAAO;SAChB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist-server/server/services/worktreeManager.d.ts

@@ -0,0 +1,27 @@
+export interface WorktreeRequest {
+    repoUrl: string;
+    baseRef?: string;
+    teamId: string;
+    agentId: string;
+}
+export interface WorktreeResult {
+    bareRepoPath: string;
+    worktreePath: string;
+    branch: string;
+    baseRef: string;
+}
+export interface WorktreeStatus {
+    worktreePath: string;
+    branch: string;
+    baseBranch: string;
+    ahead: number;
+    behind: number;
+    headSha: string;
+    headMessage: string;
+}
+export declare function prepareAgentWorktree(request: WorktreeRequest): WorktreeResult;
+export declare function getWorktreeStatus(worktreePath: string, branch: string, baseBranch?: string): WorktreeStatus;
+export declare function rebaseWorktree(worktreePath: string, branch: string, baseBranch?: string): WorktreeStatus;
+export declare function mergeWorktreeIntoBase(worktreePath: string, branch: string, baseBranch?: string): WorktreeStatus;
+export declare function listTeamWorktrees(teamId: string): string[];
+//# sourceMappingURL=worktreeManager.d.ts.map

package/dist-server/server/services/worktreeManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktreeManager.d.ts","sourceRoot":"","sources":["../../../server/services/worktreeManager.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AA4CD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CA4B7E;AAWD,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,cAAc,CAQ3G;AAED,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,cAAc,CAMxG;AAED,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,cAAc,CAM/G;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAM1D"}

package/dist-server/server/services/worktreeManager.js

@@ -0,0 +1,107 @@
+import { execSync } from 'node:child_process';
+import { existsSync, mkdirSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+const ROOT = join(tmpdir(), 'modular-worktrees');
+const BARE_ROOT = join(ROOT, 'bare');
+const TREE_ROOT = join(ROOT, 'trees');
+function safeSlug(value) {
+    return value.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/(^-|-$)/g, '');
+}
+function normalizeGitUrl(url) {
+    return url.endsWith('.git') ? url : `${url}.git`;
+}
+function parseRepoKey(url) {
+    const cleaned = url.replace(/\.git$/, '');
+    const parts = cleaned.split('/');
+    const owner = parts[parts.length - 2] || 'unknown';
+    const repo = parts[parts.length - 1] || 'repo';
+    return `${safeSlug(owner)}--${safeSlug(repo)}`;
+}
+function ensureDirs() {
+    mkdirSync(BARE_ROOT, { recursive: true });
+    mkdirSync(TREE_ROOT, { recursive: true });
+}
+function run(command) {
+    execSync(command, { stdio: 'pipe', timeout: 120_000 });
+}
+function runText(command) {
+    return execSync(command, { stdio: 'pipe', timeout: 120_000 }).toString().trim();
+}
+function branchExists(gitDir, branch) {
+    try {
+        run(`git --git-dir="${gitDir}" show-ref --verify --quiet "refs/heads/${branch}"`);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function prepareAgentWorktree(request) {
+    ensureDirs();
+    const repoKey = parseRepoKey(request.repoUrl);
+    const remoteUrl = normalizeGitUrl(request.repoUrl);
+    const bareRepoPath = join(BARE_ROOT, `${repoKey}.git`);
+    const baseRef = request.baseRef || 'origin/HEAD';
+    const branch = `agent/${safeSlug(request.teamId)}-${safeSlug(request.agentId)}`;
+    const worktreePath = join(TREE_ROOT, `${repoKey}--${safeSlug(request.teamId)}--${safeSlug(request.agentId)}`);
+    if (!existsSync(bareRepoPath)) {
+        run(`git clone --bare "${remoteUrl}" "${bareRepoPath}"`);
+    }
+    else {
+        run(`git --git-dir="${bareRepoPath}" fetch --all --prune`);
+    }
+    if (!existsSync(worktreePath)) {
+        const baseArg = baseRef.startsWith('origin/') ? baseRef : `origin/${baseRef}`;
+        if (!branchExists(bareRepoPath, branch)) {
+            run(`git --git-dir="${bareRepoPath}" worktree add "${worktreePath}" -b "${branch}" "${baseArg}"`);
+        }
+        else {
+            run(`git --git-dir="${bareRepoPath}" worktree add "${worktreePath}" "${branch}"`);
+        }
+    }
+    else {
+        run(`git -C "${worktreePath}" checkout "${branch}"`);
+    }
+    return { bareRepoPath, worktreePath, branch, baseRef };
+}
+function resolveBaseBranch(worktreePath) {
+    try {
+        const originHead = runText(`git -C "${worktreePath}" symbolic-ref --short refs/remotes/origin/HEAD`);
+        return originHead.replace('origin/', '');
+    }
+    catch {
+        return 'master';
+    }
+}
+export function getWorktreeStatus(worktreePath, branch, baseBranch) {
+    const base = baseBranch || resolveBaseBranch(worktreePath);
+    const counts = runText(`git -C "${worktreePath}" rev-list --left-right --count origin/${base}...${branch}`).split(/\s+/);
+    const behind = Number(counts[0] || '0');
+    const ahead = Number(counts[1] || '0');
+    const headSha = runText(`git -C "${worktreePath}" rev-parse --short HEAD`);
+    const headMessage = runText(`git -C "${worktreePath}" log -1 --pretty=%s`);
+    return { worktreePath, branch, baseBranch: base, ahead, behind, headSha, headMessage };
+}
+export function rebaseWorktree(worktreePath, branch, baseBranch) {
+    const base = baseBranch || resolveBaseBranch(worktreePath);
+    run(`git -C "${worktreePath}" fetch --all --prune`);
+    run(`git -C "${worktreePath}" checkout "${branch}"`);
+    run(`git -C "${worktreePath}" rebase "origin/${base}"`);
+    return getWorktreeStatus(worktreePath, branch, base);
+}
+export function mergeWorktreeIntoBase(worktreePath, branch, baseBranch) {
+    const base = baseBranch || resolveBaseBranch(worktreePath);
+    run(`git -C "${worktreePath}" fetch --all --prune`);
+    run(`git -C "${worktreePath}" checkout "${base}"`);
+    run(`git -C "${worktreePath}" merge --no-ff "${branch}"`);
+    return getWorktreeStatus(worktreePath, branch, base);
+}
+export function listTeamWorktrees(teamId) {
+    ensureDirs();
+    const teamSlug = safeSlug(teamId);
+    return readdirSync(TREE_ROOT)
+        .filter((name) => name.includes(`--${teamSlug}--`))
+        .map((name) => join(TREE_ROOT, name));
+}
+//# sourceMappingURL=worktreeManager.js.map

package/dist-server/server/services/worktreeManager.js.map

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

package/dist-server/server/types.d.ts

@@ -0,0 +1,30 @@
+export interface ProviderConfig {
+    id: string;
+    name: string;
+    type: 'openai' | 'anthropic' | 'openrouter' | 'google' | 'custom';
+    apiKey: string;
+    baseUrl: string;
+    accessToken?: string;
+    authMethod?: 'claude-agent-sdk';
+}
+export interface McpServerConfig {
+    id: string;
+    name: string;
+    type?: 'stdio' | 'sse' | 'http' | 'streamable-http';
+    command: string;
+    args: string[];
+    env: Record<string, string>;
+    autoConnect?: boolean;
+    url?: string;
+    headers?: Record<string, string>;
+}
+export interface AppConfig {
+    providers: ProviderConfig[];
+    mcpServers: McpServerConfig[];
+}
+export interface ApiResponse<T = unknown> {
+    status: 'ok' | 'error';
+    data?: T;
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist-server/server/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../server/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,WAAW,GAAG,YAAY,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,kBAAkB,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,iBAAiB,CAAC;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,UAAU,EAAE,eAAe,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist-server/server/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist-server/server/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../server/types.ts"],"names":[],"mappings":""}

package/dist-server/server/utils/pathSecurity.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Path Security Utilities
+ *
+ * Shared utilities for validating file paths across the application
+ */
+/**
+ * Load allowed directories from configuration
+ */
+export declare function loadAllowedDirs(): string[];
+/**
+ * Check if a target path is safe to access
+ *
+ * @param targetPath Path to validate
+ * @param allowedDirs Array of allowed parent directories
+ * @returns true if path is safe, false otherwise
+ */
+export declare function isPathSafe(targetPath: string, allowedDirs: string[]): boolean;
+/**
+ * Validate a file path and throw an error if not safe
+ *
+ * @param filePath Path to validate
+ * @param allowedDirs Optional array of allowed directories (loads from config if not provided)
+ * @throws Error if path is not safe
+ */
+export declare function validateFilePath(filePath: string, allowedDirs?: string[]): void;
+/**
+ * Validate multiple file paths
+ *
+ * @param filePaths Array of paths to validate
+ * @param allowedDirs Optional array of allowed directories (loads from config if not provided)
+ * @throws Error if any path is not safe
+ */
+export declare function validateFilePaths(filePaths: string[], allowedDirs?: string[]): void;
+//# sourceMappingURL=pathSecurity.d.ts.map

package/dist-server/server/utils/pathSecurity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathSecurity.d.ts","sourceRoot":"","sources":["../../../server/utils/pathSecurity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAc1C;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAY7E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAM/E;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAQnF"}

package/dist-server/server/utils/pathSecurity.js

@@ -0,0 +1,78 @@
+/**
+ * Path Security Utilities
+ *
+ * Shared utilities for validating file paths across the application
+ */
+import { resolve } from 'node:path';
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const CONFIG_DIR = join(homedir(), '.modular-studio');
+const CONFIG_PATH = join(CONFIG_DIR, 'config.json');
+/**
+ * Load allowed directories from configuration
+ */
+export function loadAllowedDirs() {
+    try {
+        if (existsSync(CONFIG_PATH)) {
+            const raw = readFileSync(CONFIG_PATH, 'utf-8');
+            const cfg = JSON.parse(raw);
+            if (Array.isArray(cfg.allowedDirs) && cfg.allowedDirs.length > 0) {
+                return cfg.allowedDirs.map((d) => resolve(d));
+            }
+        }
+    }
+    catch {
+        // ignore
+    }
+    // Default: current working directory + user home directory
+    return [resolve(process.cwd()), resolve(homedir())];
+}
+/**
+ * Check if a target path is safe to access
+ *
+ * @param targetPath Path to validate
+ * @param allowedDirs Array of allowed parent directories
+ * @returns true if path is safe, false otherwise
+ */
+export function isPathSafe(targetPath, allowedDirs) {
+    // Reject path traversal attempts
+    if (targetPath.includes('..'))
+        return false;
+    // SECURITY FIX: Reject null byte attacks
+    if (targetPath.includes('\0'))
+        return false;
+    // Resolve to absolute path and normalize case for comparison
+    const resolved = resolve(targetPath).toLowerCase();
+    // Check if path starts with any allowed directory
+    return allowedDirs.some((dir) => resolved.startsWith(dir.toLowerCase()));
+}
+/**
+ * Validate a file path and throw an error if not safe
+ *
+ * @param filePath Path to validate
+ * @param allowedDirs Optional array of allowed directories (loads from config if not provided)
+ * @throws Error if path is not safe
+ */
+export function validateFilePath(filePath, allowedDirs) {
+    const dirs = allowedDirs ?? loadAllowedDirs();
+    if (!isPathSafe(filePath, dirs)) {
+        throw new Error(`Access denied: path outside allowed directories`);
+    }
+}
+/**
+ * Validate multiple file paths
+ *
+ * @param filePaths Array of paths to validate
+ * @param allowedDirs Optional array of allowed directories (loads from config if not provided)
+ * @throws Error if any path is not safe
+ */
+export function validateFilePaths(filePaths, allowedDirs) {
+    const dirs = allowedDirs ?? loadAllowedDirs();
+    for (const filePath of filePaths) {
+        if (!isPathSafe(filePath, dirs)) {
+            throw new Error(`Access denied: path outside allowed directories: ${filePath}`);
+        }
+    }
+}
+//# sourceMappingURL=pathSecurity.js.map

package/dist-server/server/utils/pathSecurity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathSecurity.js","sourceRoot":"","sources":["../../../server/utils/pathSecurity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,iBAAiB,CAAC,CAAC;AACtD,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAMpD;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC;QACH,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAoB,CAAC;YAC/C,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjE,OAAO,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;IACD,2DAA2D;IAC3D,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,UAAkB,EAAE,WAAqB;IAClE,iCAAiC;IACjC,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAE5C,yCAAyC;IACzC,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAE5C,6DAA6D;IAC7D,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;IAEnD,kDAAkD;IAClD,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,WAAsB;IACvE,MAAM,IAAI,GAAG,WAAW,IAAI,eAAe,EAAE,CAAC;IAE9C,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAmB,EAAE,WAAsB;IAC3E,MAAM,IAAI,GAAG,WAAW,IAAI,eAAe,EAAE,CAAC;IAE9C,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,oDAAoD,QAAQ,EAAE,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist-server/src/services/budgetAllocator.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Budget Allocator - Epistemic Budget Allocation Engine
+ *
+ * Allocates token budgets across knowledge sources based on epistemic weight
+ * and content characteristics. Ensures higher-priority knowledge types get
+ * proportionally more tokens while respecting minimum floors.
+ */
+import type { KnowledgeType } from '../store/knowledgeBase.js';
+export declare const TYPE_WEIGHTS: Record<KnowledgeType, number>;
+export declare const MIN_BUDGET_FLOOR = 0.03;
+export declare const DEPTH_MULTIPLIERS: Record<number, number>;
+export interface BudgetSource {
+    name: string;
+    knowledgeType: KnowledgeType;
+    rawTokens: number;
+    depthMultiplier?: number;
+}
+export interface BudgetAllocation {
+    name: string;
+    knowledgeType: KnowledgeType;
+    allocatedTokens: number;
+    weight: number;
+    cappedBySize: boolean;
+}
+/**
+ * Allocate token budgets across sources using epistemic weighting.
+ *
+ * Algorithm:
+ * 1. Group sources by knowledge type
+ * 2. Calculate raw weight = TYPE_WEIGHTS[type] / count(same type) * (depthMultiplier || 1.0)
+ * 3. Apply minimum budget floor: max(rawWeight, MIN_BUDGET_FLOOR)
+ * 4. Normalize weights to sum = 1.0
+ * 5. Calculate allocatedTokens = weight * totalBudget
+ * 6. Cap by actual content size - redistribute excess (max 3 rounds)
+ */
+export declare function allocateBudgets(sources: BudgetSource[], totalBudget: number): BudgetAllocation[];
+//# sourceMappingURL=budgetAllocator.d.ts.map

package/dist-server/src/services/budgetAllocator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budgetAllocator.d.ts","sourceRoot":"","sources":["../../../src/services/budgetAllocator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAG/D,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAO7C,CAAC;AAGX,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAGrC,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAM3C,CAAC;AAEX,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,aAAa,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,aAAa,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,YAAY,EAAE,EACvB,WAAW,EAAE,MAAM,GAClB,gBAAgB,EAAE,CAyFpB"}

package/dist-server/src/services/budgetAllocator.js

@@ -0,0 +1,120 @@
+/**
+ * Budget Allocator - Epistemic Budget Allocation Engine
+ *
+ * Allocates token budgets across knowledge sources based on epistemic weight
+ * and content characteristics. Ensures higher-priority knowledge types get
+ * proportionally more tokens while respecting minimum floors.
+ */
+// Epistemic weights by knowledge type (must sum to 1.0)
+export const TYPE_WEIGHTS = {
+    'ground-truth': 0.30,
+    'guideline': 0.15,
+    'framework': 0.15,
+    'evidence': 0.20,
+    'signal': 0.12,
+    'hypothesis': 0.08,
+};
+// Minimum budget floor as percentage of total budget
+export const MIN_BUDGET_FLOOR = 0.03;
+// Depth multipliers for content at different tree depths
+export const DEPTH_MULTIPLIERS = {
+    0: 1.5, // Full depth - most important
+    1: 1.2, // Detail depth
+    2: 1.0, // Summary depth - baseline
+    3: 0.6, // Headlines depth
+    4: 0.2, // Mention depth - least important
+};
+/**
+ * Allocate token budgets across sources using epistemic weighting.
+ *
+ * Algorithm:
+ * 1. Group sources by knowledge type
+ * 2. Calculate raw weight = TYPE_WEIGHTS[type] / count(same type) * (depthMultiplier || 1.0)
+ * 3. Apply minimum budget floor: max(rawWeight, MIN_BUDGET_FLOOR)
+ * 4. Normalize weights to sum = 1.0
+ * 5. Calculate allocatedTokens = weight * totalBudget
+ * 6. Cap by actual content size - redistribute excess (max 3 rounds)
+ */
+export function allocateBudgets(sources, totalBudget) {
+    if (sources.length === 0)
+        return [];
+    if (totalBudget <= 0)
+        return sources.map(s => ({
+            name: s.name,
+            knowledgeType: s.knowledgeType,
+            allocatedTokens: 0,
+            weight: 0,
+            cappedBySize: false,
+        }));
+    // 1. Group sources by knowledge type
+    const typeGroups = new Map();
+    for (const source of sources) {
+        if (!typeGroups.has(source.knowledgeType)) {
+            typeGroups.set(source.knowledgeType, []);
+        }
+        typeGroups.get(source.knowledgeType).push(source);
+    }
+    // 2. Calculate raw weights
+    const allocations = [];
+    for (const [type, groupSources] of typeGroups) {
+        const typeWeight = TYPE_WEIGHTS[type];
+        const groupSize = groupSources.length;
+        for (const source of groupSources) {
+            const depthMultiplier = source.depthMultiplier ?? 1.0;
+            const rawWeight = (typeWeight / groupSize) * depthMultiplier;
+            // 3. Apply minimum budget floor
+            const flooredWeight = Math.max(rawWeight, MIN_BUDGET_FLOOR);
+            allocations.push({
+                name: source.name,
+                knowledgeType: source.knowledgeType,
+                allocatedTokens: 0, // Will be calculated after normalization
+                weight: flooredWeight,
+                cappedBySize: false,
+            });
+        }
+    }
+    // 4. Normalize weights to sum = 1.0
+    const totalWeight = allocations.reduce((sum, a) => sum + a.weight, 0);
+    if (totalWeight > 0) {
+        for (const allocation of allocations) {
+            allocation.weight = allocation.weight / totalWeight;
+        }
+    }
+    // 5. Initial budget allocation
+    for (const allocation of allocations) {
+        allocation.allocatedTokens = Math.round(allocation.weight * totalBudget);
+    }
+    // 6. Cap by content size and redistribute excess (max 3 rounds)
+    const sourceMap = new Map(sources.map(s => [s.name, s]));
+    for (let round = 0; round < 3; round++) {
+        let totalExcess = 0;
+        const uncappedAllocations = [];
+        // Find excess from capped sources
+        for (const allocation of allocations) {
+            const source = sourceMap.get(allocation.name);
+            if (allocation.allocatedTokens > source.rawTokens) {
+                totalExcess += allocation.allocatedTokens - source.rawTokens;
+                allocation.allocatedTokens = source.rawTokens;
+                allocation.cappedBySize = true;
+            }
+            else if (!allocation.cappedBySize) {
+                uncappedAllocations.push(allocation);
+            }
+        }
+        // Redistribute excess to uncapped sources
+        if (totalExcess > 0 && uncappedAllocations.length > 0) {
+            const totalUncappedWeight = uncappedAllocations.reduce((sum, a) => sum + a.weight, 0);
+            if (totalUncappedWeight > 0) {
+                for (const allocation of uncappedAllocations) {
+                    const redistribution = Math.round((allocation.weight / totalUncappedWeight) * totalExcess);
+                    allocation.allocatedTokens += redistribution;
+                }
+            }
+        }
+        else {
+            break; // No more redistribution needed
+        }
+    }
+    return allocations;
+}
+//# sourceMappingURL=budgetAllocator.js.map

package/dist-server/src/services/budgetAllocator.js.map

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

package/dist-server/src/services/contradictionDetector.d.ts

@@ -0,0 +1,18 @@
+import { type KnowledgeType } from '../store/knowledgeBase.js';
+interface SourceBlock {
+    name: string;
+    type: KnowledgeType;
+    content: string;
+}
+interface ContradictionResult {
+    sources: SourceBlock[];
+    annotations: string[];
+    contradictionsFound: number;
+}
+/**
+ * Resolves contradictions between sources by prioritizing higher-authority sources
+ * For same entities appearing in multiple sources with different types
+ */
+export declare function resolveContradictions(sources: SourceBlock[]): ContradictionResult;
+export {};
+//# sourceMappingURL=contradictionDetector.d.ts.map

package/dist-server/src/services/contradictionDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contradictionDetector.d.ts","sourceRoot":"","sources":["../../../src/services/contradictionDetector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,mBAAmB;IAC3B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAiCD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,mBAAmB,CAoGjF"}