@hongmaple0820/med-scale-research-os 0.43.0

package/dist/orchestrator/WorkspaceManager.js

@@ -0,0 +1,257 @@
+// SCALE Orchestrator — Workspace Manager
+// 对齐 Symphony: git worktree isolation + lifecycle hooks + safety invariants
+// Path: <workspace.root>/<sanitized_issue_identifier>
+// Safety: agent cwd ⊆ workspace, workspace ⊆ root, name sanitation
+import { existsSync, mkdirSync, rmSync } from 'node:fs';
+import { join, resolve, normalize, basename } from 'node:path';
+import { execSync } from 'node:child_process';
+import { logger } from '../core/logger.js';
+// ---------------------------------------------------------------------------
+// Safety invariants (aligned with Symphony)
+// ---------------------------------------------------------------------------
+const ALLOWED_CHARS_RE = /^[A-Za-z0-9._-]+$/;
+function sanitizeName(name) {
+    // Replace any chars NOT in the allowlist with underscores
+    const sanitized = name.replace(/[^A-Za-z0-9._-]/g, '_');
+    if (!sanitized || sanitized.length > 64) {
+        return `ws-${Date.now().toString(36)}`;
+    }
+    return sanitized;
+}
+function assertSafety(workspacePath, root, expectedAgentCwd) {
+    const normalizedWs = normalize(resolve(workspacePath));
+    const normalizedRoot = normalize(resolve(root));
+    // Invariant 1: workspace path must be under configured root
+    if (!normalizedWs.startsWith(normalizedRoot)) {
+        throw new Error(`SAFETY: Workspace "${normalizedWs}" is outside root "${normalizedRoot}"`);
+    }
+    // Invariant 2: workspace name must pass sanitization
+    const name = basename(normalizedWs);
+    if (!ALLOWED_CHARS_RE.test(name)) {
+        throw new Error(`SAFETY: Workspace name "${name}" contains disallowed characters`);
+    }
+    // Invariant 3: if agent cwd is known, it must be inside workspace
+    if (expectedAgentCwd) {
+        const normalizedCwd = normalize(resolve(expectedAgentCwd));
+        if (!normalizedCwd.startsWith(normalizedWs)) {
+            throw new Error(`SAFETY: Agent cwd "${normalizedCwd}" is outside workspace "${normalizedWs}"`);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// WorkspaceManager
+// ---------------------------------------------------------------------------
+export class WorkspaceManager {
+    constructor(policy) {
+        this.workspaces = new Map();
+        this.policy = policy;
+    }
+    /**
+     * Create a git worktree for an issue.
+     */
+    create(issueId, baseBranch = 'master') {
+        const root = resolve(this.policy.workspace.root);
+        if (!existsSync(root))
+            mkdirSync(root, { recursive: true });
+        const safeId = sanitizeName(issueId);
+        const branch = `scale/${safeId}-${Date.now().toString(36)}`;
+        const wsPath = join(root, safeId);
+        // Safety check before creation
+        try {
+            assertSafety(wsPath, root);
+        }
+        catch (err) {
+            return { success: false, path: wsPath, branch, error: err.message };
+        }
+        // If worktree already exists, reuse it
+        if (existsSync(wsPath)) {
+            logger.info({ issueId, path: wsPath }, 'Worktree already exists, reusing');
+            const ws = this.workspaces.get(safeId);
+            if (ws)
+                return { success: true, path: wsPath, branch: ws.branch };
+            return { success: true, path: wsPath, branch };
+        }
+        try {
+            // Run lifecycle hook: after_create
+            if (this.policy.hooks.afterCreate) {
+                execSync(this.policy.hooks.afterCreate, {
+                    env: { ...process.env, SCALE_ISSUE_ID: issueId, SCALE_WORKSPACE: wsPath, SCALE_BRANCH: branch },
+                    timeout: 30000,
+                });
+            }
+            // Create git worktree
+            execSync(`git worktree add "${wsPath}" -b "${branch}"`, {
+                cwd: process.cwd(),
+                timeout: 30000,
+            });
+            const ws = {
+                id: safeId,
+                issueId,
+                branch,
+                path: wsPath,
+                createdAt: new Date().toISOString(),
+                lastActivityAt: new Date().toISOString(),
+                status: 'active',
+                turnsCompleted: 0,
+            };
+            this.workspaces.set(safeId, ws);
+            logger.info({ issueId, path: wsPath, branch }, 'Worktree created');
+            return { success: true, path: wsPath, branch };
+        }
+        catch (err) {
+            logger.error({ err, issueId, path: wsPath }, 'Failed to create worktree');
+            return { success: false, path: wsPath, branch, error: String(err) };
+        }
+    }
+    /**
+     * Run before agent dispatch.
+     */
+    beforeRun(issueId) {
+        const safeId = sanitizeName(issueId);
+        const ws = this.workspaces.get(safeId);
+        if (!ws)
+            return false;
+        try {
+            if (this.policy.hooks.beforeRun) {
+                execSync(this.policy.hooks.beforeRun, {
+                    env: { ...process.env, SCALE_ISSUE_ID: issueId, SCALE_WORKSPACE: ws.path },
+                    timeout: 10000,
+                });
+            }
+            ws.lastActivityAt = new Date().toISOString();
+            this.workspaces.set(safeId, ws);
+            return true;
+        }
+        catch (err) {
+            logger.warn({ err, issueId }, 'beforeRun hook failed');
+            return false;
+        }
+    }
+    /**
+     * Run after agent completes a turn.
+     */
+    afterRun(issueId) {
+        const safeId = sanitizeName(issueId);
+        const ws = this.workspaces.get(safeId);
+        if (!ws)
+            return;
+        ws.turnsCompleted++;
+        ws.lastActivityAt = new Date().toISOString();
+        if (this.policy.hooks.afterRun) {
+            try {
+                execSync(this.policy.hooks.afterRun, {
+                    env: { ...process.env, SCALE_ISSUE_ID: issueId, SCALE_WORKSPACE: ws.path, SCALE_TURN: String(ws.turnsCompleted) },
+                    timeout: 10000,
+                });
+            }
+            catch { /* best-effort */ }
+        }
+        this.workspaces.set(safeId, ws);
+    }
+    /**
+     * Clean up and remove a worktree.
+     */
+    remove(issueId, force = false) {
+        const safeId = sanitizeName(issueId);
+        const ws = this.workspaces.get(safeId);
+        if (!ws)
+            return false;
+        try {
+            if (this.policy.hooks.beforeRemove) {
+                execSync(this.policy.hooks.beforeRemove, {
+                    env: { ...process.env, SCALE_ISSUE_ID: issueId, SCALE_WORKSPACE: ws.path, SCALE_BRANCH: ws.branch },
+                    timeout: 10000,
+                });
+            }
+        }
+        catch { /* best effort */ }
+        try {
+            execSync(`git worktree remove "${ws.path}" ${force ? '--force' : ''}`, {
+                cwd: process.cwd(),
+                timeout: 15000,
+            });
+        }
+        catch {
+            // If git worktree remove fails, try manual cleanup
+            if (force) {
+                try {
+                    rmSync(ws.path, { recursive: true, force: true });
+                }
+                catch { /* ignore */ }
+            }
+            else {
+                return false;
+            }
+        }
+        this.workspaces.delete(safeId);
+        logger.info({ issueId, path: ws.path }, 'Worktree removed');
+        return true;
+    }
+    /**
+     * Remove worktrees in terminal state.
+     */
+    cleanupTerminal() {
+        let cleaned = 0;
+        for (const [id, ws] of this.workspaces) {
+            if (ws.status === 'terminal') {
+                if (this.remove(ws.issueId, true))
+                    cleaned++;
+            }
+        }
+        // Also clean old workspaces by age
+        const maxAgeMs = this.policy.workspace.maxWorkspaceAgeHours * 60 * 60 * 1000;
+        const now = Date.now();
+        for (const [id, ws] of this.workspaces) {
+            const age = now - new Date(ws.lastActivityAt).getTime();
+            if (age > maxAgeMs && ws.status === 'idle') {
+                ws.status = 'terminal';
+                if (this.remove(ws.issueId, true))
+                    cleaned++;
+            }
+        }
+        return cleaned;
+    }
+    /**
+     * Verify safety invariants for a workspace.
+     */
+    verifySafety(workspacePath, agentCwd) {
+        try {
+            assertSafety(workspacePath, this.policy.workspace.root, agentCwd);
+            return { safe: true, violations: [] };
+        }
+        catch (err) {
+            return { safe: false, violations: [err.message] };
+        }
+    }
+    /**
+     * Get all active workspaces.
+     */
+    listActive() {
+        return Array.from(this.workspaces.values()).filter(w => w.status !== 'terminal');
+    }
+    /**
+     * Get workspace count.
+     */
+    get activeCount() {
+        return this.listActive().length;
+    }
+    /**
+     * Check if we can create more workspaces.
+     */
+    get canCreate() {
+        return this.activeCount < this.policy.polling.maxParallelWorkspaces;
+    }
+    /**
+     * Mark a workspace as idle or terminal.
+     */
+    updateStatus(issueId, status) {
+        const safeId = sanitizeName(issueId);
+        const ws = this.workspaces.get(safeId);
+        if (ws) {
+            ws.status = status;
+            ws.lastActivityAt = new Date().toISOString();
+            this.workspaces.set(safeId, ws);
+        }
+    }
+}
+//# sourceMappingURL=WorkspaceManager.js.map

package/dist/orchestrator/WorkspaceManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceManager.js","sourceRoot":"","sources":["../../src/orchestrator/WorkspaceManager.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,4EAA4E;AAC5E,sDAAsD;AACtD,mEAAmE;AAEnE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAA+B,MAAM,SAAS,CAAA;AACpF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAsB1C,8EAA8E;AAC9E,4CAA4C;AAC5C,8EAA8E;AAE9E,MAAM,gBAAgB,GAAG,mBAAmB,CAAA;AAE5C,SAAS,YAAY,CAAC,IAAY;IAChC,0DAA0D;IAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAA;IACvD,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACxC,OAAO,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAA;IACxC,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,SAAS,YAAY,CAAC,aAAqB,EAAE,IAAY,EAAE,gBAAyB;IAClF,MAAM,YAAY,GAAG,SAAS,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAA;IACtD,MAAM,cAAc,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;IAE/C,4DAA4D;IAC5D,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,sBAAsB,YAAY,sBAAsB,cAAc,GAAG,CAAC,CAAA;IAC5F,CAAC;IAED,qDAAqD;IACrD,MAAM,IAAI,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAA;IACnC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,kCAAkC,CAAC,CAAA;IACpF,CAAC;IAED,kEAAkE;IAClE,IAAI,gBAAgB,EAAE,CAAC;QACrB,MAAM,aAAa,GAAG,SAAS,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAA;QAC1D,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,sBAAsB,aAAa,2BAA2B,YAAY,GAAG,CAAC,CAAA;QAChG,CAAC;IACH,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,MAAM,OAAO,gBAAgB;IAI3B,YAAY,MAA0B;QAH9B,eAAU,GAAgC,IAAI,GAAG,EAAE,CAAA;QAIzD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAe,EAAE,aAAqB,QAAQ;QACnD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;QAChD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAE3D,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAA;QACpC,MAAM,MAAM,GAAG,SAAS,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAA;QAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QAEjC,+BAA+B;QAC/B,IAAI,CAAC;YAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;QAAC,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YACnD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAA;QACrE,CAAC;QAED,uCAAuC;QACvC,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,kCAAkC,CAAC,CAAA;YAC1E,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;YACtC,IAAI,EAAE;gBAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAA;YACjE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;QAChD,CAAC;QAED,IAAI,CAAC;YACH,mCAAmC;YACnC,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;gBAClC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE;oBACtC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE;oBAC/F,OAAO,EAAE,KAAK;iBACf,CAAC,CAAA;YACJ,CAAC;YAED,sBAAsB;YACtB,QAAQ,CAAC,qBAAqB,MAAM,SAAS,MAAM,GAAG,EAAE;gBACtD,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;gBAClB,OAAO,EAAE,KAAK;aACf,CAAC,CAAA;YAEF,MAAM,EAAE,GAAmB;gBACzB,EAAE,EAAE,MAAM;gBACV,OAAO;gBACP,MAAM;gBACN,IAAI,EAAE,MAAM;gBACZ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,cAAc,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACxC,MAAM,EAAE,QAAQ;gBAChB,cAAc,EAAE,CAAC;aAClB,CAAA;YAED,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;YAC/B,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAA;YAClE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;QAChD,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,2BAA2B,CAAC,CAAA;YACzE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAA;QACrE,CAAC;IACH,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,OAAe;QACvB,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAA;QACpC,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QACtC,IAAI,CAAC,EAAE;YAAE,OAAO,KAAK,CAAA;QAErB,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;gBAChC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE;oBACpC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,EAAE,EAAE,CAAC,IAAI,EAAE;oBAC1E,OAAO,EAAE,KAAK;iBACf,CAAC,CAAA;YACJ,CAAC;YACD,EAAE,CAAC,cAAc,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;YAC5C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;YAC/B,OAAO,IAAI,CAAA;QACb,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,uBAAuB,CAAC,CAAA;YACtD,OAAO,KAAK,CAAA;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,OAAe;QACtB,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAA;QACpC,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QACtC,IAAI,CAAC,EAAE;YAAE,OAAM;QAEf,EAAE,CAAC,cAAc,EAAE,CAAA;QACnB,EAAE,CAAC,cAAc,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;QAE5C,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE;oBACnC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,EAAE,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,CAAC,cAAc,CAAC,EAAE;oBACjH,OAAO,EAAE,KAAK;iBACf,CAAC,CAAA;YACJ,CAAC;YAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;QAC/B,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IACjC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAe,EAAE,QAAiB,KAAK;QAC5C,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAA;QACpC,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QACtC,IAAI,CAAC,EAAE;YAAE,OAAO,KAAK,CAAA;QAErB,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;gBACnC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE;oBACvC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,EAAE,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,CAAC,MAAM,EAAE;oBACnG,OAAO,EAAE,KAAK;iBACf,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;QAE7B,IAAI,CAAC;YACH,QAAQ,CAAC,wBAAwB,EAAE,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE;gBACrE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;gBAClB,OAAO,EAAE,KAAK;aACf,CAAC,CAAA;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,mDAAmD;YACnD,IAAI,KAAK,EAAE,CAAC;gBACV,IAAI,CAAC;oBAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;YAClF,CAAC;iBAAM,CAAC;gBACN,OAAO,KAAK,CAAA;YACd,CAAC;QACH,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAC9B,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,kBAAkB,CAAC,CAAA;QAC3D,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;OAEG;IACH,eAAe;QACb,IAAI,OAAO,GAAG,CAAC,CAAA;QACf,KAAK,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACvC,IAAI,EAAE,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gBAC7B,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC;oBAAE,OAAO,EAAE,CAAA;YAC9C,CAAC;QACH,CAAC;QACD,mCAAmC;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,oBAAoB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;QAC5E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACtB,KAAK,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACvC,MAAM,GAAG,GAAG,GAAG,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,OAAO,EAAE,CAAA;YACvD,IAAI,GAAG,GAAG,QAAQ,IAAI,EAAE,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC3C,EAAE,CAAC,MAAM,GAAG,UAAU,CAAA;gBACtB,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC;oBAAE,OAAO,EAAE,CAAA;YAC9C,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,aAAqB,EAAE,QAAiB;QACnD,IAAI,CAAC;YACH,YAAY,CAAC,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;YACjE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,CAAA;QACvC,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAA;QACnD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAA;IAClF,CAAC;IAED;;OAEG;IACH,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,MAAM,CAAA;IACjC,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,qBAAqB,CAAA;IACrE,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,OAAe,EAAE,MAAgC;QAC5D,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAA;QACpC,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QACtC,IAAI,EAAE,EAAE,CAAC;YACP,EAAE,CAAC,MAAM,GAAG,MAAM,CAAA;YAClB,EAAE,CAAC,cAAc,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;YAC5C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;QACjC,CAAC;IACH,CAAC;CACF"}

package/dist/output/BrandThemeLoader.d.ts

@@ -0,0 +1,54 @@
+export interface BrandTheme {
+    name: string;
+    displayName: string;
+    colors: BrandColors;
+    typography: BrandTypography;
+    spacing: BrandSpacing;
+    radius: string;
+    shadows: BrandShadows;
+}
+export interface BrandColors {
+    primary: string;
+    primaryHover?: string;
+    secondary?: string;
+    accent?: string;
+    bg: string;
+    bgSurface: string;
+    bgElevated: string;
+    fg: string;
+    fgMuted: string;
+    border: string;
+    success?: string;
+    warning?: string;
+    danger?: string;
+}
+export interface BrandTypography {
+    fontFamily: string;
+    fontFamilyMono: string;
+    baseFontSize: string;
+    headingWeight: string;
+}
+export interface BrandSpacing {
+    unit: string;
+    sectionGap: string;
+    cardPadding: string;
+}
+export interface BrandShadows {
+    card: string;
+    elevated: string;
+}
+export declare class BrandThemeLoader {
+    private customBrandsDir?;
+    constructor(options?: {
+        brandsDir?: string;
+    });
+    loadBrand(brand: string): BrandTheme | null;
+    getCSSVariables(theme: BrandTheme): string;
+    getOverrideCSS(theme: BrandTheme): string;
+    listAvailableBrands(): string[];
+    hasBrand(brand: string): boolean;
+    private parseBrandDesignMD;
+    private extractColors;
+    private extractTitle;
+    private getAwesomeDesignDir;
+}

package/dist/output/BrandThemeLoader.js

@@ -0,0 +1,340 @@
+// SCALE Engine — Brand Theme Loader
+// Loads brand design specs from awesome-design-md and generates CSS variables
+// Integrates with npx getdesign for brand asset fetching
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+// ============================================================================
+// 2. Built-in brand presets
+// ============================================================================
+const BUILTIN_BRANDS = {
+    vercel: {
+        name: 'vercel',
+        displayName: 'Vercel',
+        colors: {
+            primary: '#000000',
+            primaryHover: '#333333',
+            secondary: '#666666',
+            accent: '#0070f3',
+            bg: '#000000',
+            bgSurface: '#111111',
+            bgElevated: '#222222',
+            fg: '#ededed',
+            fgMuted: '#888888',
+            border: '#333333',
+            success: '#0070f3',
+            warning: '#f5a623',
+            danger: '#ee0000',
+        },
+        typography: {
+            fontFamily: "'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif",
+            fontFamilyMono: "'SF Mono', 'Fira Code', monospace",
+            baseFontSize: '16px',
+            headingWeight: '700',
+        },
+        spacing: { unit: '8px', sectionGap: '2rem', cardPadding: '1.25rem' },
+        radius: '8px',
+        shadows: {
+            card: '0 2px 8px rgba(255,255,255,0.05)',
+            elevated: '0 8px 30px rgba(255,255,255,0.08)',
+        },
+    },
+    stripe: {
+        name: 'stripe',
+        displayName: 'Stripe',
+        colors: {
+            primary: '#635bff',
+            primaryHover: '#7a73ff',
+            secondary: '#0a2540',
+            accent: '#00d4aa',
+            bg: '#0a2540',
+            bgSurface: '#1a3a5c',
+            bgElevated: '#244b73',
+            fg: '#ffffff',
+            fgMuted: '#8898aa',
+            border: '#2e4a62',
+            success: '#00d4aa',
+            warning: '#ffbb00',
+            danger: '#ff5c5c',
+        },
+        typography: {
+            fontFamily: "'Inter', -apple-system, BlinkMacSystemFont, sans-serif",
+            fontFamilyMono: "'SF Mono', 'Fira Code', monospace",
+            baseFontSize: '16px',
+            headingWeight: '600',
+        },
+        spacing: { unit: '8px', sectionGap: '2rem', cardPadding: '1.5rem' },
+        radius: '6px',
+        shadows: {
+            card: '0 2px 4px rgba(0,0,0,0.2)',
+            elevated: '0 8px 24px rgba(0,0,0,0.3)',
+        },
+    },
+    notion: {
+        name: 'notion',
+        displayName: 'Notion',
+        colors: {
+            primary: '#2382e2',
+            primaryHover: '#1a6bc4',
+            secondary: '#37352f',
+            accent: '#eb5757',
+            bg: '#ffffff',
+            bgSurface: '#f7f6f3',
+            bgElevated: '#eeeeee',
+            fg: '#37352f',
+            fgMuted: '#787774',
+            border: '#e3e2de',
+            success: '#0f7b6c',
+            warning: '#d9730d',
+            danger: '#e03e3e',
+        },
+        typography: {
+            fontFamily: "'Inter', -apple-system, BlinkMacSystemFont, sans-serif",
+            fontFamilyMono: "'SF Mono', 'Consolas', monospace",
+            baseFontSize: '16px',
+            headingWeight: '600',
+        },
+        spacing: { unit: '8px', sectionGap: '1.5rem', cardPadding: '1rem' },
+        radius: '3px',
+        shadows: {
+            card: '0 1px 3px rgba(0,0,0,0.08)',
+            elevated: '0 4px 12px rgba(0,0,0,0.1)',
+        },
+    },
+    linear: {
+        name: 'linear',
+        displayName: 'Linear',
+        colors: {
+            primary: '#5e6ad2',
+            primaryHover: '#7b84e0',
+            secondary: '#171923',
+            accent: '#26b5ce',
+            bg: '#0d0f14',
+            bgSurface: '#161a24',
+            bgElevated: '#1e2330',
+            fg: '#e8eaed',
+            fgMuted: '#6b7280',
+            border: '#2a2f3e',
+            success: '#4ade80',
+            warning: '#fbbf24',
+            danger: '#f87171',
+        },
+        typography: {
+            fontFamily: "'Inter', -apple-system, BlinkMacSystemFont, sans-serif",
+            fontFamilyMono: "'JetBrains Mono', 'Fira Code', monospace",
+            baseFontSize: '14px',
+            headingWeight: '600',
+        },
+        spacing: { unit: '8px', sectionGap: '2rem', cardPadding: '1.25rem' },
+        radius: '6px',
+        shadows: {
+            card: '0 1px 2px rgba(0,0,0,0.2)',
+            elevated: '0 4px 16px rgba(0,0,0,0.3)',
+        },
+    },
+    github: {
+        name: 'github',
+        displayName: 'GitHub',
+        colors: {
+            primary: '#0969da',
+            primaryHover: '#0550ae',
+            secondary: '#24292f',
+            accent: '#8250df',
+            bg: '#0d1117',
+            bgSurface: '#161b22',
+            bgElevated: '#21262d',
+            fg: '#c9d1d9',
+            fgMuted: '#8b949e',
+            border: '#30363d',
+            success: '#3fb950',
+            warning: '#d29922',
+            danger: '#f85149',
+        },
+        typography: {
+            fontFamily: "-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif",
+            fontFamilyMono: "'SFMono-Regular', 'Consolas', 'Liberation Mono', monospace",
+            baseFontSize: '14px',
+            headingWeight: '600',
+        },
+        spacing: { unit: '8px', sectionGap: '1.5rem', cardPadding: '1rem' },
+        radius: '6px',
+        shadows: {
+            card: '0 1px 3px rgba(0,0,0,0.12)',
+            elevated: '0 8px 24px rgba(0,0,0,0.2)',
+        },
+    },
+};
+// ============================================================================
+// 3. BrandThemeLoader
+// ============================================================================
+export class BrandThemeLoader {
+    constructor(options) {
+        this.customBrandsDir = options?.brandsDir;
+    }
+    // Load a brand theme by name
+    loadBrand(brand) {
+        const normalized = brand.toLowerCase().trim();
+        // Check built-in brands first
+        if (BUILTIN_BRANDS[normalized]) {
+            return BUILTIN_BRANDS[normalized];
+        }
+        // Check custom brands directory
+        if (this.customBrandsDir) {
+            const brandPath = join(this.customBrandsDir, normalized, 'DESIGN.md');
+            if (existsSync(brandPath)) {
+                return this.parseBrandDesignMD(brandPath, normalized);
+            }
+        }
+        // Check awesome-design-md skill directory
+        const awesomeDir = this.getAwesomeDesignDir();
+        if (awesomeDir) {
+            const brandPath = join(awesomeDir, normalized, 'DESIGN.md');
+            if (existsSync(brandPath)) {
+                return this.parseBrandDesignMD(brandPath, normalized);
+            }
+        }
+        return null;
+    }
+    // Generate CSS variables from a brand theme
+    getCSSVariables(theme) {
+        return `
+    :root {
+      --brand-primary: ${theme.colors.primary};
+      --brand-primary-hover: ${theme.colors.primaryHover ?? theme.colors.primary};
+      --brand-secondary: ${theme.colors.secondary ?? theme.colors.fg};
+      --brand-accent: ${theme.colors.accent ?? theme.colors.primary};
+      --brand-bg: ${theme.colors.bg};
+      --brand-bg-surface: ${theme.colors.bgSurface};
+      --brand-bg-elevated: ${theme.colors.bgElevated};
+      --brand-fg: ${theme.colors.fg};
+      --brand-fg-muted: ${theme.colors.fgMuted};
+      --brand-border: ${theme.colors.border};
+      --brand-success: ${theme.colors.success ?? '#00ff88'};
+      --brand-warning: ${theme.colors.warning ?? '#ffaa00'};
+      --brand-danger: ${theme.colors.danger ?? '#ff4444'};
+      --brand-font: ${theme.typography.fontFamily};
+      --brand-font-mono: ${theme.typography.fontFamilyMono};
+      --brand-font-size: ${theme.typography.baseFontSize};
+      --brand-heading-weight: ${theme.typography.headingWeight};
+      --brand-radius: ${theme.radius};
+      --brand-shadow-card: ${theme.shadows.card};
+      --brand-shadow-elevated: ${theme.shadows.elevated};
+    }
+    `;
+    }
+    // Generate override CSS that replaces default variables with brand values
+    getOverrideCSS(theme) {
+        return `
+    :root {
+      --bg: ${theme.colors.bg};
+      --bg-surface: ${theme.colors.bgSurface};
+      --bg-elevated: ${theme.colors.bgElevated};
+      --fg: ${theme.colors.fg};
+      --fg-muted: ${theme.colors.fgMuted};
+      --border: ${theme.colors.border};
+      --accent: ${theme.colors.primary};
+      --accent-dim: ${theme.colors.primaryHover ?? theme.colors.primary};
+      --radius: ${theme.radius};
+    }
+    body { font-family: ${theme.typography.fontFamily}; font-size: ${theme.typography.baseFontSize}; }
+    h1, h2, h3 { font-weight: ${theme.typography.headingWeight}; }
+    `;
+    }
+    // List all available brand names
+    listAvailableBrands() {
+        const builtin = Object.keys(BUILTIN_BRANDS);
+        // Add custom brands from awesome-design-md
+        const awesomeDir = this.getAwesomeDesignDir();
+        if (awesomeDir && existsSync(awesomeDir)) {
+            try {
+                const dirs = readdirSync(awesomeDir, { withFileTypes: true })
+                    .filter(d => d.isDirectory())
+                    .map(d => d.name);
+                for (const d of dirs) {
+                    if (!builtin.includes(d))
+                        builtin.push(d);
+                }
+            }
+            catch {
+                // ignore read errors
+            }
+        }
+        return builtin.sort();
+    }
+    // Check if a brand exists
+    hasBrand(brand) {
+        return this.loadBrand(brand) !== null;
+    }
+    // === Internal: Parse DESIGN.md from awesome-design-md ===
+    parseBrandDesignMD(filePath, name) {
+        try {
+            const content = readFileSync(filePath, 'utf-8');
+            // Basic parsing — extract colors from markdown table or code blocks
+            const colors = this.extractColors(content);
+            if (!colors)
+                return null;
+            return {
+                name,
+                displayName: this.extractTitle(content) ?? name,
+                colors: {
+                    primary: colors.primary ?? '#0070f3',
+                    primaryHover: colors.primaryHover,
+                    secondary: colors.secondary,
+                    accent: colors.accent,
+                    bg: colors.bg ?? '#0f0f0f',
+                    bgSurface: colors.bgSurface ?? '#1a1a1a',
+                    bgElevated: colors.bgElevated ?? '#242424',
+                    fg: colors.fg ?? '#e0e0e0',
+                    fgMuted: colors.fgMuted ?? '#808080',
+                    border: colors.border ?? '#333',
+                    success: colors.success,
+                    warning: colors.warning,
+                    danger: colors.danger,
+                },
+                typography: {
+                    fontFamily: "'Inter', -apple-system, BlinkMacSystemFont, sans-serif",
+                    fontFamilyMono: "'SF Mono', 'Fira Code', monospace",
+                    baseFontSize: '16px',
+                    headingWeight: '600',
+                },
+                spacing: { unit: '8px', sectionGap: '2rem', cardPadding: '1.25rem' },
+                radius: '6px',
+                shadows: {
+                    card: '0 2px 8px rgba(0,0,0,0.2)',
+                    elevated: '0 8px 24px rgba(0,0,0,0.3)',
+                },
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    extractColors(content) {
+        const colors = {};
+        // Match hex colors in various formats
+        const hexPattern = /#([0-9a-fA-F]{6}|[0-9a-fA-F]{3})/g;
+        const matches = content.match(hexPattern);
+        if (!matches || matches.length === 0)
+            return null;
+        // First hex is often primary
+        colors.primary = matches[0];
+        if (matches.length > 1)
+            colors.bg = matches[1];
+        if (matches.length > 2)
+            colors.fg = matches[2];
+        return colors;
+    }
+    extractTitle(content) {
+        const titleMatch = content.match(/^#\s+(.+)$/m);
+        return titleMatch ? titleMatch[1].trim() : null;
+    }
+    getAwesomeDesignDir() {
+        // Check standard paths for awesome-design-md
+        const home = process.env.HOME ?? process.env.USERPROFILE ?? '';
+        const candidates = [
+            join(home, '.claude', 'skills', 'awesome-design-md'),
+            join(home, '.agents', 'skills', 'awesome-design-md'),
+        ];
+        return candidates.find(p => existsSync(p));
+    }
+}
+//# sourceMappingURL=BrandThemeLoader.js.map