@decibelsystems/tools 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Decibel Systems
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,342 @@
+# @decibel/tools
+
+MCP server for project intelligence. 26 facade tools (170+ internal handlers) across 20 domains: work tracking, architecture, experiments, design, git forensics, agent coordination, and more.
+
+Tested with Claude Desktop, Claude Code, and Cursor. [Learn more →](https://decibel.systems/tools)
+
+<a href="https://github.com/decibelsystems/decibel-tools-mcp#cursor">
+  <img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Add to Cursor" height="32" />
+</a>
+
+> **Note:** The one-click Cursor install only works on GitHub. [Click here](https://github.com/decibelsystems/decibel-tools-mcp#cursor) or see manual setup below.
+
+## What It Does
+
+| Domain | Purpose | Example Tools |
+|--------|---------|---------------|
+| **Sentinel** | Work tracking | `sentinel_create_issue`, `sentinel_log_epic`, `sentinel_list_epics` |
+| **Dojo** | AI incubator | `dojo_add_wish`, `dojo_create_proposal`, `dojo_run_experiment` |
+| **Architect** | Decisions | `architect_createAdr`, `architect_createPolicy` |
+| **Roadmap** | Strategy | `roadmap_get`, `roadmap_getHealth`, `roadmap_linkEpic` |
+| **Oracle** | Recommendations | `oracle_next_actions`, `oracle_roadmap` |
+| **Designer** | Design decisions | `designer_record_design_decision`, `designer_crit` |
+| **Friction** | Pain points | `friction_log`, `friction_bump`, `friction_resolve` |
+| **Learnings** | Knowledge base | `learnings_append`, `learnings_list` |
+| **Context** | AI memory | `decibel_context_pin`, `decibel_context_refresh` |
+| **Registry** | Project management | `project_init`, `registry_list`, `registry_add` |
+| **Agentic** | Config compilation | `agentic_compile_pack`, `agentic_render` |
+| **Provenance** | Audit trail | `provenance_list` |
+
+## Quick Start
+
+```bash
+# Install globally
+npm install -g @decibel/tools
+
+# Or run directly with npx
+npx @decibel/tools
+```
+
+## Platform Setup
+
+### Cursor
+
+Add to `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "decibel-tools": {
+      "command": "npx",
+      "args": ["-y", "@decibel/tools"]
+    }
+  }
+}
+```
+
+### Claude Code
+
+Add to `.mcp.json` in your project root or `~/.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "decibel-tools": {
+      "command": "npx",
+      "args": ["-y", "@decibel/tools"]
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):
+
+```json
+{
+  "mcpServers": {
+    "decibel-tools": {
+      "command": "npx",
+      "args": ["-y", "@decibel/tools"]
+    }
+  }
+}
+```
+
+---
+
+## Tools Reference
+
+### Sentinel (16 tools)
+*Work tracking: issues, epics, test specs*
+
+| Tool | Description |
+|------|-------------|
+| `sentinel_create_issue` | Create a tracked issue with severity (low/med/high/critical) |
+| `sentinel_close_issue` | Close an issue with resolution note |
+| `sentinel_list_repo_issues` | List issues for a project, optionally filtered by status |
+| `sentinel_listIssues` | List issues with filtering by epic or status |
+| `sentinel_createIssue` | Create issue (YAML format with auto-generated ID) |
+| `sentinel_log_epic` | Create a new epic (large feature) record |
+| `sentinel_list_epics` | List all epics with optional filters |
+| `sentinel_get_epic` | Get details of a specific epic |
+| `sentinel_get_epic_issues` | Get all issues linked to an epic |
+| `sentinel_resolve_epic` | Fuzzy search for epics by name or keyword |
+| `sentinel_scan` | Scan project data for validation, orphans, stale items |
+| `sentinel_scanData` | Scan using Python Sentinel Data Inspector |
+| `sentinel_createTestSpec` | Create a test specification atom |
+| `sentinel_listTestSpecs` | List all test specifications |
+| `sentinel_compileTests` | Compile test specs into documentation |
+| `sentinel_auditPolicies` | Audit policy compliance and freshness |
+
+### Dojo (10 tools)
+*AI Feature Incubator: wishes, proposals, experiments*
+
+| Tool | Description |
+|------|-------------|
+| `dojo_add_wish` | Add a capability wish (what, why, inputs, outputs) |
+| `dojo_list_wishes` | List wishes from the wishlist |
+| `dojo_create_proposal` | Create a proposal for a feature or capability |
+| `dojo_scaffold_experiment` | Create experiment skeleton from a proposal |
+| `dojo_list` | List proposals, experiments, and wishes |
+| `dojo_run_experiment` | Run an experiment in sandbox mode |
+| `dojo_get_results` | Get results from a previous experiment run |
+| `dojo_read_artifact` | Read artifact file from experiment results |
+| `dojo_can_graduate` | Check if experiment can graduate to real tool |
+| `dojo_projects` | List available projects for Dojo operations |
+
+### Architect (6 tools)
+*Architecture decisions and policies*
+
+| Tool | Description |
+|------|-------------|
+| `architect_record_arch_decision` | Record an ADR (markdown format) |
+| `architect_createAdr` | Create ADR (YAML format with auto ID) |
+| `architect_createPolicy` | Create a policy with rules and enforcement |
+| `architect_listPolicies` | List all policies, filter by severity/tags |
+| `architect_getPolicy` | Get details of a specific policy |
+| `architect_compileOversight` | Compile policies into documentation |
+
+### Roadmap (6 tools)
+*Strategic planning and health tracking*
+
+| Tool | Description |
+|------|-------------|
+| `roadmap_get` | Get full roadmap (objectives, themes, milestones) |
+| `roadmap_list` | List epics with roadmap context and health scores |
+| `roadmap_getEpicContext` | Get strategic context for a specific epic |
+| `roadmap_getHealth` | Get epics with low health scores needing attention |
+| `roadmap_linkEpic` | Link epic to theme, milestone, objectives |
+| `roadmap_init` | Initialize a new roadmap.yaml scaffold |
+
+### Oracle (2 tools)
+*AI-powered recommendations*
+
+| Tool | Description |
+|------|-------------|
+| `oracle_next_actions` | Get recommended next actions for a project |
+| `oracle_roadmap` | Evaluate roadmap progress against milestones |
+
+### Designer (7 tools)
+*Design decisions, Figma integration, and creative feedback*
+
+| Tool | Description |
+|------|-------------|
+| `designer_record_design_decision` | Record a design decision |
+| `designer_crit` | Log early creative feedback (gut reactions, hunches) |
+| `designer_list_crits` | List crit observations, filter by area/sentiment |
+| `designer_sync_tokens` | Sync design tokens from Figma variables |
+| `designer_review_figma` | Review Figma component against design principles |
+| `designer_upsert_principle` | Create or update a design principle |
+| `designer_list_principles` | List design principles, filter by category |
+
+### Friction (4 tools)
+*Track recurring pain points*
+
+| Tool | Description |
+|------|-------------|
+| `friction_log` | Log a friction point (context, description, impact) |
+| `friction_list` | List friction points sorted by impact/signal |
+| `friction_resolve` | Mark friction as resolved with solution reference |
+| `friction_bump` | Bump signal count when encountering same friction |
+
+### Learnings (2 tools)
+*Living knowledge documents*
+
+| Tool | Description |
+|------|-------------|
+| `learnings_append` | Append entry to project's learnings document |
+| `learnings_list` | List entries, filter by category |
+
+### Context (8 tools)
+*AI memory: pinned facts, events, artifacts*
+
+| Tool | Description |
+|------|-------------|
+| `decibel_context_refresh` | Compile full context pack for AI memory |
+| `decibel_context_pin` | Pin a fact to persistent memory |
+| `decibel_context_unpin` | Remove a pinned fact |
+| `decibel_context_list` | List all pinned facts |
+| `decibel_event_append` | Append event to activity journal |
+| `decibel_event_search` | Search events in journal |
+| `decibel_artifact_list` | List artifacts for a run |
+| `decibel_artifact_read` | Read artifact content |
+
+### Registry (7 tools)
+*Project discovery and management*
+
+| Tool | Description |
+|------|-------------|
+| `project_init` | Initialize .decibel/ folder in a project |
+| `project_status` | Check project status and available tools |
+| `registry_list` | List all registered projects |
+| `registry_add` | Register a project in the registry |
+| `registry_remove` | Remove project from registry |
+| `registry_alias` | Add alias to a project |
+| `registry_resolve` | Test resolution of project ID/alias |
+
+### Agentic (4 tools)
+*Configuration compilation and rendering*
+
+| Tool | Description |
+|------|-------------|
+| `agentic_compile_pack` | Compile config into versioned, hashed pack |
+| `agentic_render` | Transform payload into rendered text |
+| `agentic_lint` | Validate output against renderer constraints |
+| `agentic_golden_eval` | Run golden eval regression tests |
+
+### Provenance (1 tool)
+*Audit trail*
+
+| Tool | Description |
+|------|-------------|
+| `provenance_list` | List provenance events for artifact/actor |
+
+---
+
+## Data Storage
+
+Data is stored in project-local `.decibel/` folders:
+
+```
+{project}/
+└── .decibel/
+    ├── sentinel/
+    │   ├── issues/      # ISS-{nnnn}.yml
+    │   └── epics/       # EPIC-{nnnn}.yml
+    ├── architect/
+    │   ├── adrs/        # ADR-{nnnn}.yml
+    │   └── policies/    # POL-{nnnn}.yaml
+    ├── dojo/
+    │   ├── proposals/   # DOJO-PROP-{nnnn}.yml
+    │   ├── experiments/ # DOJO-EXP-{nnnn}/
+    │   └── wishes/      # WISH-{nnnn}.yml
+    ├── designer/        # Design decisions
+    ├── friction/        # Pain point logs
+    ├── learnings/       # Knowledge documents
+    ├── context/         # Pinned facts, events
+    └── voice/inbox/     # Voice messages
+```
+
+## Configuration
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `DECIBEL_ENV` | `dev` | Environment (dev, staging, prod) |
+| `DECIBEL_ORG` | `mediareason` | Organization name |
+| `DECIBEL_MCP_ROOT` | `~/.decibel` | Global data storage root |
+
+Optional for cloud features:
+- `SUPABASE_URL` - Supabase project URL
+- `SUPABASE_SERVICE_KEY` - Supabase service role key
+- `OPENAI_API_KEY` - For image generation
+- `FIGMA_ACCESS_TOKEN` - For Figma integration (designer_sync_tokens, designer_review_figma)
+
+## Usage Examples
+
+### Example 1: Initialize a Project and Create an Epic
+
+```
+User: "Initialize decibel for this project and create an epic for user authentication"
+
+AI uses: project_init → sentinel_log_epic
+
+Result: Creates .decibel/ folder structure and EPIC-0001.yml for "User Authentication"
+```
+
+### Example 2: Track Work with Issues Linked to Epics
+
+```
+User: "Create issues for the auth epic: login form, password reset, and session management"
+
+AI uses: sentinel_resolve_epic → sentinel_createIssue (×3)
+
+Result: Creates ISS-0001, ISS-0002, ISS-0003 all linked to EPIC-0001
+```
+
+### Example 3: Record Architecture Decisions
+
+```
+User: "We decided to use JWT tokens instead of sessions. Document this ADR."
+
+AI uses: architect_createAdr
+
+Result: Creates ADR-0001.yml with context, decision, and consequences
+```
+
+### Example 4: AI Feature Incubation (Dojo)
+
+```
+User: "I wish we had a tool that detects rate limit patterns in logs"
+
+AI uses: dojo_add_wish → dojo_create_proposal → dojo_scaffold_experiment
+
+Result: WISH-0001.yml → DOJO-PROP-0001.yml → DOJO-EXP-0001/ with entrypoint ready to implement
+```
+
+### Example 5: Get Recommended Next Actions
+
+```
+User: "What should I work on next?"
+
+AI uses: oracle_next_actions
+
+Result: Prioritized list based on stale issues, epic health, pending experiments
+```
+
+## Privacy Policy
+
+**Local Storage Only**: All project data is stored locally in `.decibel/` folders within your project directories. No data is sent to external servers by default.
+
+**Optional Cloud Integrations**: Some tools optionally connect to external services when you explicitly configure API keys:
+- **Figma API** (`designer_sync_tokens`, `designer_review_figma`) - requires `FIGMA_ACCESS_TOKEN`
+- **Supabase** (voice inbox sync) - requires `SUPABASE_URL` and `SUPABASE_SERVICE_KEY`
+
+These optional integrations are clearly marked with `openWorldHint: true` in their tool annotations.
+
+**No Telemetry**: This MCP server does not collect telemetry, usage analytics, or any form of tracking data.
+
+## License
+
+MIT - [Decibel Systems](https://decibel.systems)

package/dist/agentic/compiler.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Agentic Pack Compiler
+ *
+ * Compiles agentic configuration files into a versioned, hashed pack.
+ * Reads from .decibel/architect/agentic/ and outputs compiled_agentic_pack.json
+ */
+import { ResolvedProjectPaths } from '../projectRegistry.js';
+import { CompileResult, CompilePackInput, CompilePackOutput } from './types.js';
+/**
+ * Compile agentic pack from project configuration
+ */
+export declare function compilePack(input: CompilePackInput): Promise<CompilePackOutput>;
+/**
+ * Load a previously compiled pack
+ */
+export declare function loadCompiledPack(resolved: ResolvedProjectPaths): Promise<CompileResult | null>;
+/**
+ * Get or compile pack (compile if not exists or outdated)
+ */
+export declare function getOrCompilePack(resolved: ResolvedProjectPaths): Promise<CompileResult>;
+//# sourceMappingURL=compiler.d.ts.map

package/dist/agentic/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../src/agentic/compiler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,EAAuB,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElF,OAAO,EAEL,aAAa,EAKb,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AA0MpB;;GAEG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA2CrF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAQpG;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,aAAa,CAAC,CAcxB"}

package/dist/agentic/compiler.js

@@ -0,0 +1,267 @@
+/**
+ * Agentic Pack Compiler
+ *
+ * Compiles agentic configuration files into a versioned, hashed pack.
+ * Reads from .decibel/architect/agentic/ and outputs compiled_agentic_pack.json
+ */
+import fs from 'fs/promises';
+import path from 'path';
+import crypto from 'crypto';
+import yaml from 'yaml';
+import { log } from '../config.js';
+import { resolveProjectPaths } from '../projectRegistry.js';
+import { ensureDir } from '../dataRoot.js';
+// ============================================================================
+// Default Configurations
+// ============================================================================
+const DEFAULT_TAXONOMY = {
+    roles: {
+        Sensor: { emoji: '👁️', description: 'Data collection and observation' },
+        Analyst: { emoji: '🧠', description: 'Pattern recognition and analysis' },
+        Overmind: { emoji: '🎯', description: 'Decision making and coordination' },
+        Specialist: { emoji: '🔧', description: 'Domain-specific expertise' },
+    },
+    statuses: {
+        OK: { emoji: '✓', color: 'green' },
+        DEGRADED: { emoji: '⚠️', color: 'yellow' },
+        BLOCKED: { emoji: '🛑', color: 'red' },
+        ALERT: { emoji: '🚨', color: 'magenta' },
+    },
+    loads: {
+        GREEN: { emoji: '🟢', color: 'green' },
+        YELLOW: { emoji: '🟡', color: 'yellow' },
+        RED: { emoji: '🔴', color: 'red' },
+    },
+};
+const DEFAULT_RENDERER = {
+    id: 'default',
+    name: 'Default Renderer',
+    description: 'Basic text output with minimal formatting',
+    template: `{{role_emoji}} {{role}} | {{status}} | Load: {{load}}
+
+{{summary}}
+
+{{#evidence}}
+Evidence:
+{{#items}}
+- {{source}}: {{value}}
+{{/items}}
+{{/evidence}}
+
+{{#missing_data}}
+Missing Data:
+{{#items}}
+- {{field}}: {{reason}}
+{{/items}}
+{{/missing_data}}
+
+{{#decision}}
+Decision: {{decision}}
+{{/decision}}`,
+    constraints: {
+        max_emoji_count: 5,
+        emoji_position: 'header-only',
+        max_lines: 50,
+        banned_words: ['amazing', 'incredible', 'revolutionary', 'game-changing'],
+        banned_punctuation: ['!'],
+    },
+};
+const DEFAULT_CONSENSUS = {
+    quorum_threshold: 0.67,
+    dissent_highlight_threshold: 0.3,
+    max_pending_decisions: 10,
+};
+// ============================================================================
+// YAML Loading Helpers
+// ============================================================================
+async function loadYamlFile(filePath) {
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        return yaml.parse(content);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return null;
+        }
+        throw error;
+    }
+}
+async function loadYamlDir(dirPath) {
+    const result = {};
+    try {
+        const files = await fs.readdir(dirPath);
+        for (const file of files) {
+            if (file.endsWith('.yaml') || file.endsWith('.yml')) {
+                const filePath = path.join(dirPath, file);
+                const content = await loadYamlFile(filePath);
+                if (content) {
+                    const id = path.basename(file, path.extname(file));
+                    result[id] = content;
+                }
+            }
+        }
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT') {
+            throw error;
+        }
+    }
+    return result;
+}
+// ============================================================================
+// Pack Compiler
+// ============================================================================
+async function loadPackConfigs(agenticDir) {
+    const sourceFiles = [];
+    // Load taxonomy
+    const taxonomyPath = path.join(agenticDir, 'taxonomy.yaml');
+    const taxonomy = (await loadYamlFile(taxonomyPath)) || DEFAULT_TAXONOMY;
+    if (await fileExists(taxonomyPath))
+        sourceFiles.push(taxonomyPath);
+    // Load renderers
+    const renderersPath = path.join(agenticDir, 'renderers.yaml');
+    let renderers = { default: DEFAULT_RENDERER };
+    const loadedRenderers = await loadYamlFile(renderersPath);
+    if (loadedRenderers) {
+        renderers = { ...renderers, ...loadedRenderers };
+        sourceFiles.push(renderersPath);
+    }
+    // Also load from renderers/ directory
+    const renderersDir = path.join(agenticDir, 'renderers');
+    const dirRenderers = await loadYamlDir(renderersDir);
+    for (const [id, config] of Object.entries(dirRenderers)) {
+        renderers[id] = { ...config, id };
+        sourceFiles.push(path.join(renderersDir, `${id}.yaml`));
+    }
+    // Load consensus
+    const consensusPath = path.join(agenticDir, 'consensus.yaml');
+    const consensus = (await loadYamlFile(consensusPath)) || DEFAULT_CONSENSUS;
+    if (await fileExists(consensusPath))
+        sourceFiles.push(consensusPath);
+    // Load ANSI styles
+    const ansiStylesPath = path.join(agenticDir, 'ansi_styles.yaml');
+    const ansiStyles = await loadYamlFile(ansiStylesPath);
+    if (await fileExists(ansiStylesPath))
+        sourceFiles.push(ansiStylesPath);
+    // Load avatars
+    const avatarsDir = path.join(agenticDir, 'avatars');
+    const avatars = await loadYamlDir(avatarsDir);
+    for (const file of Object.keys(avatars)) {
+        sourceFiles.push(path.join(avatarsDir, `${file}.yaml`));
+    }
+    // Load pack overrides
+    const packsDir = path.join(agenticDir, 'packs');
+    const packs = await loadYamlDir(packsDir);
+    for (const [packId, packConfig] of Object.entries(packs)) {
+        // Merge pack-specific overrides
+        if (packConfig.renderers) {
+            renderers = { ...renderers, ...packConfig.renderers };
+        }
+        if (packConfig.avatars) {
+            Object.assign(avatars, packConfig.avatars);
+        }
+        sourceFiles.push(path.join(packsDir, `${packId}.yaml`));
+    }
+    return {
+        pack: {
+            taxonomy,
+            renderers,
+            consensus,
+            avatars,
+            ansi_styles: ansiStyles || undefined,
+        },
+        sourceFiles,
+    };
+}
+async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function computePackHash(pack) {
+    const content = JSON.stringify(pack, Object.keys(pack).sort());
+    return crypto.createHash('sha256').update(content).digest('hex').substring(0, 12);
+}
+function generatePackId() {
+    const timestamp = new Date().toISOString().replace(/[-:]/g, '').split('.')[0];
+    const random = Math.random().toString(36).substring(2, 6);
+    return `pack-${timestamp}-${random}`;
+}
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Compile agentic pack from project configuration
+ */
+export async function compilePack(input) {
+    try {
+        const resolved = resolveProjectPaths(input.projectId);
+        const agenticDir = resolved.subPath('architect', 'agentic');
+        log(`agentic-compiler: Compiling pack from ${agenticDir}`);
+        // Load all configs
+        const { pack, sourceFiles } = await loadPackConfigs(agenticDir);
+        // Generate pack ID and hash
+        const packId = generatePackId();
+        const packHash = computePackHash(pack);
+        const result = {
+            pack_id: packId,
+            pack_hash: packHash,
+            compiled_at: new Date().toISOString(),
+            content: pack,
+            source_files: sourceFiles,
+        };
+        // Write compiled pack to output
+        const outputDir = resolved.subPath('architect', 'agentic', 'compiled');
+        ensureDir(outputDir);
+        const outputPath = path.join(outputDir, 'compiled_agentic_pack.json');
+        await fs.writeFile(outputPath, JSON.stringify(result, null, 2), 'utf-8');
+        log(`agentic-compiler: Pack compiled successfully (${packHash})`);
+        log(`agentic-compiler: Output written to ${outputPath}`);
+        return {
+            status: 'compiled',
+            result,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        log(`agentic-compiler: Error compiling pack: ${message}`);
+        return {
+            status: 'error',
+            error: message,
+        };
+    }
+}
+/**
+ * Load a previously compiled pack
+ */
+export async function loadCompiledPack(resolved) {
+    const outputPath = resolved.subPath('architect', 'agentic', 'compiled', 'compiled_agentic_pack.json');
+    try {
+        const content = await fs.readFile(outputPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get or compile pack (compile if not exists or outdated)
+ */
+export async function getOrCompilePack(resolved) {
+    // Try to load existing
+    const existing = await loadCompiledPack(resolved);
+    if (existing) {
+        return existing;
+    }
+    // Compile new
+    const result = await compilePack({ projectId: resolved.id });
+    if (result.status === 'error' || !result.result) {
+        throw new Error(result.error || 'Failed to compile pack');
+    }
+    return result.result;
+}
+//# sourceMappingURL=compiler.js.map

package/dist/agentic/compiler.js.map

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