@decibelsystems/tools 2.0.0

package/dist/facades/definitions.js

@@ -0,0 +1,450 @@
+// ============================================================================
+// Facade Definitions — the complete registry of public-facing tool facades
+// ============================================================================
+// Each facade maps a module name + action enum to internal tool handlers.
+// Action names are snake_case. Internal tool names match the kernel's toolMap.
+//
+// To add a new action: add the entry to the relevant facade's `actions` map
+// and ensure the internal tool is registered in src/tools/index.ts.
+// ============================================================================
+// ============================================================================
+// Core Facades (always available)
+// ============================================================================
+export const coreFacades = [
+    {
+        name: 'sentinel',
+        description: 'Work tracking: epics, issues, test specs, code scanning. Actions: create_issue, read_issue, update_issue, close_issue, list_issues, log_epic, list_epics, read_epic, resolve_epic, list_epic_issues, create_test_spec, list_test_specs, compile_tests, audit_policies, scan, scan_data, scan_codebase, scan_config, scan_coverage, auto_link, link_commit, list_linked_commits',
+        compactDescription: 'Track epics, issues, test specs, and scan code',
+        microEligible: true,
+        tier: 'core',
+        actions: {
+            create_issue: 'sentinel_create_issue',
+            read_issue: 'sentinel_read_issue',
+            update_issue: 'sentinel_updateIssue',
+            close_issue: 'sentinel_close_issue',
+            list_issues: 'sentinel_list_repo_issues',
+            log_epic: 'sentinel_log_epic',
+            list_epics: 'sentinel_list_epics',
+            read_epic: 'sentinel_read_epic',
+            resolve_epic: 'sentinel_resolve_epic',
+            list_epic_issues: 'sentinel_list_epic_issues',
+            create_test_spec: 'sentinel_createTestSpec',
+            list_test_specs: 'sentinel_listTestSpecs',
+            compile_tests: 'sentinel_compileTests',
+            audit_policies: 'sentinel_auditPolicies',
+            scan: 'sentinel_scan',
+            scan_data: 'sentinel_scanData',
+            scan_codebase: 'sentinel_scan_codebase',
+            scan_config: 'sentinel_scan_config',
+            scan_coverage: 'sentinel_scan_coverage',
+            auto_link: 'sentinel_auto_link',
+            link_commit: 'sentinel_link_commit',
+            list_linked_commits: 'sentinel_list_linked_commits',
+        },
+    },
+    {
+        name: 'architect',
+        description: 'Architecture decisions & policies. Actions: create_adr, read_adr, list_adrs, create_policy, read_policy, list_policies, compile_oversight, record_arch_decision',
+        compactDescription: 'Record ADRs, policies, and architecture decisions',
+        microEligible: false,
+        tier: 'core',
+        actions: {
+            create_adr: 'architect_createAdr',
+            read_adr: 'architect_readAdr',
+            list_adrs: 'architect_listAdrs',
+            create_policy: 'architect_createPolicy',
+            read_policy: 'architect_read_policy',
+            list_policies: 'architect_listPolicies',
+            compile_oversight: 'architect_compileOversight',
+            record_arch_decision: 'architect_record_arch_decision',
+        },
+    },
+    {
+        name: 'dojo',
+        description: 'Feature incubation: wishes, proposals, experiments, benchmarks. Actions: add_wish, list_wishes, create_proposal, scaffold_experiment, run_experiment, read_artifact, read_results, can_graduate, list, projects, bench',
+        compactDescription: 'Incubate ideas with wishes, proposals, experiments',
+        microEligible: false,
+        tier: 'core',
+        actions: {
+            add_wish: 'dojo_add_wish',
+            list_wishes: 'dojo_list_wishes',
+            create_proposal: 'dojo_create_proposal',
+            scaffold_experiment: 'dojo_scaffold_experiment',
+            run_experiment: 'dojo_run_experiment',
+            read_artifact: 'dojo_read_artifact',
+            read_results: 'dojo_read_results',
+            can_graduate: 'dojo_can_graduate',
+            list: 'dojo_list',
+            projects: 'dojo_projects',
+            bench: 'dojo_bench',
+        },
+    },
+    {
+        name: 'designer',
+        description: 'Design decisions, critiques, tokens, lateral thinking. Actions: record_decision, list_principles, upsert_principle, crit, review_figma, sync_tokens, check_parity, lateral_session, lateral_apply, lateral_close, list_crits',
+        compactDescription: 'Design decisions, crits, and design tokens',
+        microEligible: false,
+        tier: 'core',
+        actions: {
+            record_decision: 'designer_record_design_decision',
+            list_principles: 'designer_list_principles',
+            upsert_principle: 'designer_upsert_principle',
+            crit: 'designer_crit',
+            review_figma: 'designer_review_figma',
+            sync_tokens: 'designer_sync_tokens',
+            check_parity: 'designer_check_parity',
+            lateral_session: 'designer_lateral_session',
+            lateral_apply: 'designer_lateral_apply',
+            lateral_close: 'designer_lateral_close',
+            list_crits: 'designer_list_crits',
+        },
+    },
+    {
+        name: 'git',
+        description: 'Git history, changes, and issue linking. Actions: log_recent, changed_files, find_removal, blame_context, tags, status, find_linked_issues',
+        compactDescription: 'Git history, diffs, and forensics',
+        microEligible: true,
+        tier: 'core',
+        actions: {
+            log_recent: 'git_log_recent',
+            changed_files: 'git_changed_files',
+            find_removal: 'git_find_removal',
+            blame_context: 'git_blame_context',
+            tags: 'git_tags',
+            status: 'git_status',
+            find_linked_issues: 'git_find_linked_issues',
+        },
+    },
+    {
+        name: 'workflow',
+        description: 'High-level composite operations. Actions: status, preflight, ship, investigate',
+        compactDescription: 'Status, preflight, ship, investigate',
+        microEligible: true,
+        tier: 'core',
+        actions: {
+            status: 'workflow_status',
+            preflight: 'workflow_preflight',
+            ship: 'workflow_ship',
+            investigate: 'workflow_investigate',
+        },
+    },
+    {
+        name: 'oracle',
+        description: 'Strategic planning, health scores, and recommendations. Actions: next_actions, portfolio_summary, hygiene_report, roadmap',
+        compactDescription: 'AI-powered priorities and project health',
+        microEligible: false,
+        tier: 'core',
+        actions: {
+            next_actions: 'oracle_next_actions',
+            portfolio_summary: 'oracle_portfolio_summary',
+            hygiene_report: 'oracle_hygiene_report',
+            roadmap: 'oracle_roadmap',
+        },
+    },
+    {
+        name: 'roadmap',
+        description: 'Objectives, milestones, and epic tracking. Actions: init, list, read, list_objectives, read_objective, link_epic, get_epic_context, get_health',
+        compactDescription: 'Manage roadmap objectives and milestones',
+        microEligible: false,
+        tier: 'core',
+        actions: {
+            init: 'roadmap_init',
+            list: 'roadmap_list',
+            read: 'roadmap_read',
+            list_objectives: 'roadmap_listObjectives',
+            read_objective: 'roadmap_read_objective',
+            link_epic: 'roadmap_linkEpic',
+            get_epic_context: 'roadmap_getEpicContext',
+            get_health: 'roadmap_getHealth',
+        },
+    },
+    {
+        name: 'vector',
+        description: 'Agent run tracking, drift detection, and prompt scoring. Actions: create_run, read_run, list_runs, log_event, complete_run, checkpoint, context_pack, assumptions, score_prompt, trace',
+        compactDescription: 'Track agent runs, events, and drift',
+        microEligible: false,
+        tier: 'core',
+        actions: {
+            create_run: 'vector_create_run',
+            read_run: 'vector_read_run',
+            list_runs: 'vector_list_runs',
+            log_event: 'vector_log_event',
+            complete_run: 'vector_complete_run',
+            checkpoint: 'vector_agent_checkpoint',
+            context_pack: 'vector_agent_context_pack',
+            assumptions: 'vector_agent_assumptions',
+            score_prompt: 'vector_score_prompt',
+            trace: 'vector_trace',
+        },
+    },
+    {
+        name: 'context',
+        description: 'Persistent memory: pinned facts, events, artifacts. Actions: list, pin, unpin, refresh, event_append, event_search, artifact_list, artifact_read',
+        compactDescription: 'Pin facts, log events, manage artifacts',
+        microEligible: true,
+        tier: 'core',
+        actions: {
+            list: 'decibel_context_list',
+            pin: 'decibel_context_pin',
+            unpin: 'decibel_context_unpin',
+            refresh: 'decibel_context_refresh',
+            event_append: 'decibel_event_append',
+            event_search: 'decibel_event_search',
+            artifact_list: 'decibel_artifact_list',
+            artifact_read: 'decibel_artifact_read',
+        },
+    },
+    {
+        name: 'auditor',
+        description: 'Code quality, health metrics, and refactor scoring. Actions: init, triage, refactor_score, naming_audit, log_health, health_dashboard, health_history',
+        compactDescription: 'Code quality audits and health metrics',
+        microEligible: false,
+        tier: 'core',
+        actions: {
+            init: 'auditor_init',
+            triage: 'auditor_triage',
+            refactor_score: 'auditor_refactor_score',
+            naming_audit: 'auditor_naming_audit',
+            log_health: 'auditor_log_health',
+            health_dashboard: 'auditor_health_dashboard',
+            health_history: 'auditor_health_history',
+        },
+    },
+    {
+        name: 'forecast',
+        description: 'Task estimation, decomposition, and capacity planning. Actions: parse, decompose, plan, record, calibration',
+        compactDescription: 'Estimate tasks and plan capacity',
+        microEligible: false,
+        tier: 'core',
+        actions: {
+            parse: 'forecast_parse',
+            decompose: 'forecast_decompose',
+            plan: 'forecast_plan',
+            record: 'forecast_record',
+            calibration: 'forecast_calibration',
+        },
+    },
+    {
+        name: 'velocity',
+        description: 'Productivity metrics, trends, and contributor stats. Actions: snapshot, list, trends, contributor, install_hook, uninstall_hook',
+        compactDescription: 'Track productivity and commit velocity',
+        microEligible: false,
+        tier: 'core',
+        actions: {
+            snapshot: 'velocity_snapshot',
+            list: 'velocity_list',
+            trends: 'velocity_trends',
+            contributor: 'velocity_contributor',
+            install_hook: 'velocity_install_hook',
+            uninstall_hook: 'velocity_uninstall_hook',
+        },
+    },
+    {
+        name: 'coordinator',
+        description: 'Multi-agent coordination: locking, heartbeat, logging, messaging. Actions: register, lock, unlock, status, heartbeat, log, send, inbox, ack',
+        compactDescription: 'Agent coordination, locking, and messaging',
+        microEligible: true,
+        tier: 'core',
+        actions: {
+            register: 'coord_register',
+            lock: 'coord_lock',
+            unlock: 'coord_unlock',
+            status: 'coord_status',
+            heartbeat: 'coord_heartbeat',
+            log: 'coord_log',
+            send: 'coord_send',
+            inbox: 'coord_inbox',
+            ack: 'coord_ack',
+        },
+    },
+    {
+        name: 'friction',
+        description: 'Track recurring pain points and workarounds. Actions: log, list, bump, resolve',
+        compactDescription: 'Log and track recurring pain points',
+        microEligible: false,
+        tier: 'core',
+        actions: {
+            log: 'friction_log',
+            list: 'friction_list',
+            bump: 'friction_bump',
+            resolve: 'friction_resolve',
+        },
+    },
+    {
+        name: 'registry',
+        description: 'Project discovery and management. Actions: add, remove, list, alias, resolve, init, snapshot, status',
+        compactDescription: 'Manage project registry and discovery',
+        microEligible: false,
+        tier: 'core',
+        actions: {
+            add: 'registry_add',
+            remove: 'registry_remove',
+            list: 'registry_list',
+            alias: 'registry_alias',
+            resolve: 'registry_resolve',
+            init: 'project_init',
+            snapshot: 'project_snapshot',
+            status: 'project_status',
+        },
+    },
+    {
+        name: 'feedback',
+        description: 'Submit and view tool feedback. Actions: submit, list',
+        compactDescription: 'Tool feedback',
+        microEligible: false,
+        tier: 'core',
+        actions: {
+            submit: 'feedback_submit',
+            list: 'feedback_list',
+        },
+    },
+    {
+        name: 'learnings',
+        description: 'Technical knowledge and lessons learned. Actions: append, list',
+        compactDescription: 'Record and recall learnings',
+        microEligible: false,
+        tier: 'core',
+        actions: {
+            append: 'learnings_append',
+            list: 'learnings_list',
+        },
+    },
+    {
+        name: 'provenance',
+        description: 'Audit trail for tool operations. Actions: list',
+        compactDescription: 'View audit trail',
+        microEligible: false,
+        tier: 'core',
+        actions: {
+            list: 'provenance_list',
+        },
+    },
+    {
+        name: 'bench',
+        description: 'Benchmark suites and comparison. Actions: run, compare',
+        compactDescription: 'Run and compare benchmarks',
+        microEligible: false,
+        tier: 'core',
+        actions: {
+            run: 'decibel_bench',
+            compare: 'decibel_bench_compare',
+        },
+    },
+    {
+        name: 'guardian',
+        description: 'Security scanning: dependency audits, secret detection, HTTP surface checks, config review. Actions: scan_deps, scan_secrets, scan_http, scan_config, report',
+        compactDescription: 'Security scanning and vulnerability detection',
+        microEligible: false,
+        tier: 'core',
+        actions: {
+            scan_deps: 'guardian_scan_deps',
+            scan_secrets: 'guardian_scan_secrets',
+            scan_http: 'guardian_scan_http',
+            scan_config: 'guardian_scan_config',
+            report: 'guardian_report',
+        },
+    },
+];
+// ============================================================================
+// Pro Facades (gated by DECIBEL_PRO)
+// ============================================================================
+export const proFacades = [
+    {
+        name: 'voice',
+        description: 'Voice inbox and command processing. Actions: inbox_add, inbox_list, inbox_process, inbox_sync, command',
+        compactDescription: 'Voice inbox and commands',
+        microEligible: false,
+        tier: 'pro',
+        actions: {
+            inbox_add: 'voice_inbox_add',
+            inbox_list: 'voice_inbox_list',
+            inbox_process: 'voice_inbox_process',
+            inbox_sync: 'voice_inbox_sync',
+            command: 'voice_command',
+        },
+    },
+    {
+        name: 'studio',
+        description: 'Creative asset generation: images, video, 3D. Actions: generate_image, get_image_status, create_artifact, update_artifact, list_artifacts, create_project, read_project, list_projects, list_tasks, list_jobs, claim_job, update_job, register_device, heartbeat, sync_events',
+        compactDescription: 'Generate images, video, and 3D assets',
+        microEligible: false,
+        tier: 'pro',
+        actions: {
+            generate_image: 'studio_generate_image',
+            get_image_status: 'studio_get_image_status',
+            create_artifact: 'studio_create_artifact',
+            update_artifact: 'studio_update_artifact',
+            list_artifacts: 'studio_list_artifacts',
+            create_project: 'studio_create_project',
+            read_project: 'studio_read_project',
+            list_projects: 'studio_list_projects',
+            list_tasks: 'studio_list_tasks',
+            list_jobs: 'studio_list_jobs',
+            claim_job: 'studio_claim_job',
+            update_job: 'studio_update_job',
+            register_device: 'studio_register_device',
+            heartbeat: 'studio_heartbeat',
+            sync_events: 'studio_sync_events',
+        },
+    },
+    {
+        name: 'corpus',
+        description: 'Pattern and playbook search across codebase. Actions: search, status',
+        compactDescription: 'Search patterns and playbooks',
+        microEligible: false,
+        tier: 'pro',
+        actions: {
+            search: 'corpus_search',
+            status: 'corpus_status',
+        },
+    },
+    {
+        name: 'agentic',
+        description: 'Agentic operations: render, lint, compile, evaluation. Actions: render, lint, compile_pack, golden_eval',
+        compactDescription: 'Render, lint, compile, evaluate',
+        microEligible: false,
+        tier: 'pro',
+        actions: {
+            render: 'agentic_render',
+            lint: 'agentic_lint',
+            compile_pack: 'agentic_compile_pack',
+            golden_eval: 'agentic_golden_eval',
+        },
+    },
+];
+// ============================================================================
+// App Facades (Decibel internal — gated by DECIBEL_APPS)
+// ============================================================================
+export const appFacades = [
+    {
+        name: 'senken',
+        description: 'Trade analysis: strategy summaries, giveback reports, grading. Actions: trade_summary, giveback_report, trade_review, list_overrides, apply_override',
+        compactDescription: 'Trading strategy analysis (Postgres)',
+        microEligible: false,
+        tier: 'apps',
+        actions: {
+            trade_summary: 'senken_trade_summary',
+            giveback_report: 'senken_giveback_report',
+            trade_review: 'senken_trade_review',
+            list_overrides: 'senken_list_overrides',
+            apply_override: 'senken_apply_override',
+        },
+    },
+    {
+        name: 'deck',
+        description: 'Trading card buylist search and price comparison. Actions: list, search, stores',
+        compactDescription: 'Card buylist search',
+        microEligible: false,
+        tier: 'apps',
+        actions: {
+            list: 'deck_buylist_list',
+            search: 'deck_buylist_search',
+            stores: 'deck_buylist_stores',
+        },
+    },
+];
+// ============================================================================
+// All Facades
+// ============================================================================
+export const allFacadeDefinitions = [...coreFacades, ...proFacades, ...appFacades];
+//# sourceMappingURL=definitions.js.map

package/dist/facades/definitions.js.map

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

package/dist/facades/index.d.ts

@@ -0,0 +1,27 @@
+export type { FacadeSpec, DetailTier, McpToolDefinition } from './types.js';
+export { coreFacades, proFacades, appFacades, allFacadeDefinitions } from './definitions.js';
+import type { FacadeSpec, DetailTier, McpToolDefinition } from './types.js';
+import type { ToolSpec } from '../tools/types.js';
+/**
+ * Build MCP tool definitions from facade specs.
+ * Each facade becomes one MCP tool with an `action` enum + flat params.
+ *
+ * When toolMap is provided, descriptions include per-action parameter signatures
+ * so LLMs know exactly what fields each action accepts.
+ */
+export declare function buildMcpDefinitions(facades: FacadeSpec[], tier?: DetailTier, toolMap?: Map<string, ToolSpec>): McpToolDefinition[];
+/**
+ * Build a reverse map: internal tool name → { facade, action }
+ * Used for backward compatibility — when someone calls "sentinel_create_issue"
+ * directly, the kernel can still route it.
+ */
+export declare function buildReverseMap(facades: FacadeSpec[]): Map<string, {
+    facade: string;
+    action: string;
+}>;
+/**
+ * Validate that all facade action mappings point to tools that exist
+ * in the kernel's tool map. Returns array of missing tool names.
+ */
+export declare function validateFacades(facades: FacadeSpec[], toolMap: Map<string, unknown>): string[];
+//# sourceMappingURL=index.d.ts.map

package/dist/facades/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/facades/index.ts"],"names":[],"mappings":"AAIA,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7F,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AA4DlD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,UAAU,EAAE,EACrB,IAAI,GAAE,UAAmB,EACzB,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,GAC9B,iBAAiB,EAAE,CA+BrB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,UAAU,EAAE,GACpB,GAAG,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAQjD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,UAAU,EAAE,EACrB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,EAAE,CAUV"}

package/dist/facades/index.js

@@ -0,0 +1,124 @@
+// ============================================================================
+// Facade Registry — public API for the facade system
+// ============================================================================
+export { coreFacades, proFacades, appFacades, allFacadeDefinitions } from './definitions.js';
+/**
+ * Build a compact signature string for one action from its internal tool schema.
+ * Example: "create_issue(severity: low|med|high|critical, title, details, epic_id?)"
+ */
+function buildActionSignature(actionName, tool) {
+    const schema = tool.definition.inputSchema;
+    const required = new Set(schema.required || []);
+    const parts = [];
+    for (const [name, prop] of Object.entries(schema.properties)) {
+        // Skip common implicit params — they're always optional and obvious
+        if (name === 'projectId' || name === 'project_id')
+            continue;
+        const p = prop;
+        const isRequired = required.has(name);
+        const isArray = p.type === 'array';
+        const hasEnum = Array.isArray(p.enum);
+        let sig = name;
+        if (isArray)
+            sig += '[]';
+        if (hasEnum)
+            sig += ': ' + p.enum.join('|');
+        if (!isRequired)
+            sig += '?';
+        parts.push(sig);
+    }
+    return `${actionName}(${parts.join(', ')})`;
+}
+/**
+ * Build a description with per-action parameter signatures.
+ * Looks up each action's internal tool to extract its inputSchema.
+ */
+function buildSignatureDescription(facade, toolMap) {
+    const lines = [];
+    // Keep the first sentence from the original description (the domain summary)
+    const dotIdx = facade.description.indexOf('.');
+    const summary = dotIdx > 0 ? facade.description.slice(0, dotIdx + 1) : facade.description;
+    lines.push(summary);
+    lines.push('Actions:');
+    for (const [actionName, internalName] of Object.entries(facade.actions)) {
+        const tool = toolMap.get(internalName);
+        if (tool) {
+            lines.push(`- ${buildActionSignature(actionName, tool)}`);
+        }
+        else {
+            // Fallback: just list the action name if tool not found
+            lines.push(`- ${actionName}()`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Build MCP tool definitions from facade specs.
+ * Each facade becomes one MCP tool with an `action` enum + flat params.
+ *
+ * When toolMap is provided, descriptions include per-action parameter signatures
+ * so LLMs know exactly what fields each action accepts.
+ */
+export function buildMcpDefinitions(facades, tier = 'full', toolMap) {
+    return facades
+        .filter(f => tier !== 'micro' || f.microEligible)
+        .map(f => {
+        // Build description: use signatures when toolMap available and tier is full
+        let description;
+        if (tier === 'compact') {
+            description = f.compactDescription;
+        }
+        else if (toolMap) {
+            description = buildSignatureDescription(f, toolMap);
+        }
+        else {
+            description = f.description;
+        }
+        return {
+            name: f.name,
+            description,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    action: {
+                        type: 'string',
+                        enum: Object.keys(f.actions),
+                        description: 'The operation to perform',
+                    },
+                },
+                required: ['action'],
+                additionalProperties: true,
+            },
+        };
+    });
+}
+/**
+ * Build a reverse map: internal tool name → { facade, action }
+ * Used for backward compatibility — when someone calls "sentinel_create_issue"
+ * directly, the kernel can still route it.
+ */
+export function buildReverseMap(facades) {
+    const map = new Map();
+    for (const f of facades) {
+        for (const [action, internalName] of Object.entries(f.actions)) {
+            map.set(internalName, { facade: f.name, action });
+        }
+    }
+    return map;
+}
+/**
+ * Validate that all facade action mappings point to tools that exist
+ * in the kernel's tool map. Returns array of missing tool names.
+ */
+export function validateFacades(facades, toolMap) {
+    const missing = [];
+    for (const f of facades) {
+        for (const [action, internalName] of Object.entries(f.actions)) {
+            if (!toolMap.has(internalName)) {
+                missing.push(`${f.name}.${action} → ${internalName}`);
+            }
+        }
+    }
+    return missing;
+}
+//# sourceMappingURL=index.js.map

package/dist/facades/index.js.map

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

package/dist/facades/types.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Facade specification — defines one MCP-visible tool that dispatches
+ * to multiple internal handlers based on the `action` parameter.
+ */
+export interface FacadeSpec {
+    /** MCP tool name (e.g. "sentinel", "architect") */
+    name: string;
+    /** Full description for capable models (Claude, GPT-4) */
+    description: string;
+    /** One-line description for mid-range SLMs (7-13B) */
+    compactDescription: string;
+    /** Whether to include in micro tier (tiny SLMs, edge, mobile) */
+    microEligible: boolean;
+    /** Availability tier: core (public), pro (DECIBEL_PRO), apps (DECIBEL_APPS — internal only) */
+    tier: 'core' | 'pro' | 'apps';
+    /**
+     * Action name → internal tool name mapping.
+     * Keys are the enum values the LLM sends (snake_case).
+     * Values are the internal tool names in the kernel's toolMap.
+     *
+     * Example: { "create_issue": "sentinel_create_issue", "list_epics": "sentinel_list_epics" }
+     */
+    actions: Record<string, string>;
+}
+/** Detail tier for tool descriptions */
+export type DetailTier = 'full' | 'compact' | 'micro';
+/** MCP tool definition shape (matches ToolSpec['definition']) */
+export interface McpToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+        additionalProperties?: boolean;
+    };
+}
+//# sourceMappingURL=types.d.ts.map