@brad-frost-web/eddie-brain 0.32.0

package/dist/pipeline/tool-handler.js

@@ -0,0 +1,392 @@
+/**
+ * ToolHandler — Executes eddie-brain tools without MCP transport
+ *
+ * Replicates the dispatch logic from mcp/server.ts but calls
+ * KnowledgeGraph/TokenValidator/NamingValidator/HealthScorer directly.
+ * Returns plain strings instead of MCP content objects.
+ */
+import { resolve } from 'path';
+import { readFile } from 'fs/promises';
+import { existsSync } from 'fs';
+import { TokenValidator, NamingValidator, SlotContractValidator, HealthScorer } from '../analyze/index.js';
+import { DEFAULT_CONFIG } from '../types.js';
+/**
+ * Optional MCP client for design-systems tools.
+ * Set via setDesignSystemsMcp() before running the pipeline.
+ */
+let designSystemsMcpHandler = null;
+export function setDesignSystemsMcpHandler(handler) {
+    designSystemsMcpHandler = handler;
+}
+/**
+ * Execute an eddie-brain tool call and return the result as a string.
+ */
+export async function executeToolCall(toolName, toolInput, knowledgeGraph, rootDir) {
+    switch (toolName) {
+        case 'eddie_get_component':
+            return handleGetComponent(toolInput, knowledgeGraph);
+        case 'eddie_get_token':
+            return handleGetToken(toolInput, knowledgeGraph);
+        case 'eddie_validate_file':
+            return handleValidateFile(toolInput, knowledgeGraph, rootDir);
+        case 'eddie_check_health':
+            return handleCheckHealth(toolInput, knowledgeGraph, rootDir);
+        case 'eddie_compose_recipe':
+            return handleComposeRecipe(toolInput, knowledgeGraph);
+        case 'eddie_get_relationships':
+            return handleGetRelationships(toolInput, knowledgeGraph);
+        case 'eddie_search':
+            return handleSearch(toolInput, knowledgeGraph);
+        case 'eddie_suggest_fix':
+            return handleSuggestFix(toolInput);
+        case 'eddie_read_file':
+            return handleReadFile(toolInput, rootDir);
+        case 'ds_search_design_knowledge':
+        case 'ds_search_chunks':
+        case 'ds_browse_by_category':
+            return handleDesignSystemsTool(toolName, toolInput);
+        default:
+            return JSON.stringify({ error: `Unknown tool: ${toolName}` });
+    }
+}
+/**
+ * Build Anthropic API tool definitions for the specified tools.
+ */
+export function buildToolDefinitions(tools) {
+    return tools.map(tool => TOOL_DEFINITIONS[tool]).filter(Boolean);
+}
+// =============================================================================
+// Tool Implementations
+// =============================================================================
+async function handleGetComponent(input, kg) {
+    const name = input.name;
+    const tagName = name.startsWith('ed-') ? name : `ed-${name}`;
+    const component = kg.componentIndex.getComponent(tagName);
+    if (!component) {
+        const all = kg.componentIndex.getAll();
+        const matches = all.filter(c => c.tagName.includes(name) || c.displayName.toLowerCase().includes(name.toLowerCase()));
+        if (matches.length > 0) {
+            return JSON.stringify({
+                error: `Component "${tagName}" not found. Did you mean one of these?`,
+                suggestions: matches.map(m => ({ tagName: m.tagName, displayName: m.displayName, intent: m.intent })),
+            }, null, 2);
+        }
+        return JSON.stringify({ error: `Component "${tagName}" not found in Eddie.` });
+    }
+    return JSON.stringify(component, null, 2);
+}
+async function handleGetToken(input, kg) {
+    const name = input.name;
+    const token = kg.tokenTaxonomy.getToken(name);
+    if (!token) {
+        const all = kg.tokenTaxonomy.getAll();
+        const matches = all.filter(t => t.name.includes(name)).slice(0, 10);
+        return JSON.stringify({
+            error: `Token "${name}" not found.`,
+            suggestions: matches.map(m => ({ name: m.name, tier: m.tier, category: m.category, value: m.value })),
+        }, null, 2);
+    }
+    return JSON.stringify(token, null, 2);
+}
+async function handleValidateFile(input, kg, rootDir) {
+    const path = input.path;
+    const filePath = resolve(rootDir, path);
+    const issues = [];
+    const tokenValidator = new TokenValidator();
+    const tokenIssues = await tokenValidator.validateFile(filePath, kg.tokenTaxonomy);
+    issues.push(...tokenIssues);
+    const namingValidator = new NamingValidator();
+    const namingIssues = await namingValidator.validateFile(filePath);
+    issues.push(...namingIssues);
+    const slotValidator = new SlotContractValidator(kg.componentIndex);
+    const slotIssues = await slotValidator.validateFile(filePath);
+    issues.push(...slotIssues);
+    return JSON.stringify({
+        file: path,
+        issueCount: issues.length,
+        issues: issues.map(i => ({
+            severity: i.severity,
+            message: i.message,
+            line: i.line,
+            actual: i.actual,
+            expected: i.expected,
+            autoFixable: i.autoFixable,
+            suggestion: i.suggestion,
+        })),
+    }, null, 2);
+}
+async function handleCheckHealth(input, kg, rootDir) {
+    const component = input.component;
+    const config = { ...DEFAULT_CONFIG, rootDir };
+    if (component) {
+        const scorer = new HealthScorer(kg, config);
+        const scores = await scorer.scoreComponent(component);
+        return JSON.stringify({ type: 'component', component, scores }, null, 2);
+    }
+    return JSON.stringify({ type: 'system', summary: kg.getSummary() }, null, 2);
+}
+async function handleComposeRecipe(input, kg) {
+    const intent = input.intent;
+    const terms = intent.toLowerCase().split(/\s+/);
+    const recipes = kg.relationshipMap
+        .getAll()
+        .filter(r => terms.some(t => r.intent.toLowerCase().includes(t)) ||
+        terms.some(t => r.name.toLowerCase().includes(t)));
+    const components = kg.componentIndex
+        .getAll()
+        .filter(c => terms.some(t => c.intent.toLowerCase().includes(t)) ||
+        terms.some(t => c.tagName.includes(t)) ||
+        terms.some(t => c.displayName.toLowerCase().includes(t)))
+        .slice(0, 15);
+    return JSON.stringify({
+        query: intent,
+        recipes: recipes.map(r => ({
+            name: r.name, intent: r.intent, status: r.status, components: r.components, rules: r.rules,
+        })),
+        relevantComponents: components.map(c => ({
+            tagName: c.tagName, intent: c.intent, properties: c.properties.map(p => p.name), slots: c.slots.map(s => s.name),
+        })),
+    }, null, 2);
+}
+async function handleGetRelationships(input, kg) {
+    const component = input.component;
+    const tagName = component.startsWith('ed-') ? component : `ed-${component}`;
+    const recipes = kg.relationshipMap.findRecipesFor(tagName);
+    const entry = kg.componentIndex.getComponent(tagName);
+    return JSON.stringify({
+        component: tagName,
+        composesWith: entry?.composesWith ?? [],
+        childComponents: entry?.childComponents ?? [],
+        parentComponent: entry?.parentComponent ?? null,
+        recipes: recipes.map(r => ({
+            name: r.name, intent: r.intent, status: r.status, components: r.components,
+        })),
+    }, null, 2);
+}
+async function handleSearch(input, kg) {
+    const query = input.query;
+    const results = kg.search(query);
+    return JSON.stringify({
+        query,
+        components: results.components.slice(0, 10).map(c => ({
+            tagName: c.tagName, intent: c.intent, atomicLevel: c.atomicLevel,
+        })),
+        recipes: results.recipes.slice(0, 5).map(r => ({
+            name: r.name, intent: r.intent, status: r.status,
+        })),
+    }, null, 2);
+}
+async function handleSuggestFix(input) {
+    const issueType = input.issue_type;
+    const file = input.file;
+    const line = input.line;
+    const suggestions = {
+        'token-raw-hex': 'Replace the raw hex color with an Eddie token. Use --ed-theme-color-* tokens.',
+        'token-raw-px': 'Replace raw pixel value with --ed-spacing-* token.',
+        'token-wrong-tier': 'Use semantic (tier 2) tokens (--ed-theme-*) instead of definition (tier 1) tokens.',
+        'token-intent-mismatch': 'The token category does not match the CSS property.',
+        'token-deprecated': 'This token is deprecated. Search for its replacement.',
+        'naming-unclassed': 'Add a BEM class: ed-c-{component}__{element}.',
+        'naming-invalid-prefix': 'Class names must start with: ed-c-, ed-l-, ed-u-, ed-r-, or is-/has-.',
+        'naming-bad-bem': 'Use BEM format: ed-c-block__element--modifier.',
+    };
+    return JSON.stringify({
+        issue_type: issueType,
+        file,
+        line: line ?? 'unknown',
+        suggestion: suggestions[issueType] ?? 'Review docs/CODE_GUIDELINES.md for conventions.',
+        references: [
+            'docs/CODE_GUIDELINES.md',
+            'docs/TOKENS.md',
+            'docs/THEMING.md',
+        ],
+    }, null, 2);
+}
+async function handleReadFile(input, rootDir) {
+    const path = input.path;
+    // Resolve relative to rootDir, but also allow absolute paths within the repo
+    const filePath = path.startsWith('/') ? path : resolve(rootDir, path);
+    // Safety: only allow reading within the repo
+    const resolvedRoot = resolve(rootDir);
+    if (!filePath.startsWith(resolvedRoot)) {
+        return JSON.stringify({ error: 'Path is outside the repository.' });
+    }
+    if (!existsSync(filePath)) {
+        return JSON.stringify({ error: `File not found: ${path}` });
+    }
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        // Truncate very large files
+        const maxChars = 15000;
+        const truncated = content.length > maxChars;
+        return JSON.stringify({
+            path,
+            content: truncated ? content.slice(0, maxChars) : content,
+            truncated,
+            totalLength: content.length,
+        }, null, 2);
+    }
+    catch (err) {
+        return JSON.stringify({ error: `Failed to read: ${err instanceof Error ? err.message : String(err)}` });
+    }
+}
+async function handleDesignSystemsTool(toolName, input) {
+    if (!designSystemsMcpHandler) {
+        return JSON.stringify({
+            error: 'Design systems MCP not connected. Results unavailable.',
+            fallback: 'Proceed using Eddie knowledge graph and code guidelines only.',
+        });
+    }
+    try {
+        return await designSystemsMcpHandler(toolName, input);
+    }
+    catch (err) {
+        return JSON.stringify({
+            error: `Design systems tool failed: ${err instanceof Error ? err.message : String(err)}`,
+            fallback: 'Proceed using Eddie knowledge graph and code guidelines only.',
+        });
+    }
+}
+// =============================================================================
+// Tool Definitions for Anthropic API
+// =============================================================================
+const TOOL_DEFINITIONS = {
+    eddie_get_component: {
+        name: 'eddie_get_component',
+        description: 'Look up an Eddie component by name. Returns properties, slots, events, intent, guidelines.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'Component name (e.g. "button", "ed-button")' },
+            },
+            required: ['name'],
+        },
+    },
+    eddie_get_token: {
+        name: 'eddie_get_token',
+        description: 'Look up a design token. Returns value, tier, category, intent.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'Token name (e.g. "--ed-theme-color-background-default")' },
+            },
+            required: ['name'],
+        },
+    },
+    eddie_validate_file: {
+        name: 'eddie_validate_file',
+        description: 'Validate a file for token and naming violations. Run on .ts or .scss files.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Path to the file to validate' },
+            },
+            required: ['path'],
+        },
+    },
+    eddie_check_health: {
+        name: 'eddie_check_health',
+        description: 'Run health scoring on the Eddie design system or a specific component.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                component: { type: 'string', description: 'Optional: specific component to score (e.g. "ed-button")' },
+            },
+            required: [],
+        },
+    },
+    eddie_compose_recipe: {
+        name: 'eddie_compose_recipe',
+        description: 'Find composition recipes for a UI intent. Returns which components to combine.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                intent: { type: 'string', description: 'Natural language description of the UI pattern' },
+            },
+            required: ['intent'],
+        },
+    },
+    eddie_get_relationships: {
+        name: 'eddie_get_relationships',
+        description: 'Get composition recipes involving a specific component.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                component: { type: 'string', description: 'Component name (e.g. "ed-button")' },
+            },
+            required: ['component'],
+        },
+    },
+    eddie_search: {
+        name: 'eddie_search',
+        description: 'Search across all Eddie components, tokens, and recipes.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: 'Search query (e.g. "form input", "accent color")' },
+            },
+            required: ['query'],
+        },
+    },
+    eddie_suggest_fix: {
+        name: 'eddie_suggest_fix',
+        description: 'Get a suggested fix for a validation issue.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                issue_type: { type: 'string', description: 'Issue type (e.g. "token-raw-hex")' },
+                file: { type: 'string', description: 'File path' },
+                line: { type: 'number', description: 'Line number' },
+            },
+            required: ['issue_type', 'file'],
+        },
+    },
+    eddie_read_file: {
+        name: 'eddie_read_file',
+        description: 'Read the contents of a file in the Eddie monorepo. Use this to read existing component source code (.ts, .scss, .stories.ts), documentation (docs/*.md), or any other file. Paths are relative to the repo root.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'File path relative to repo root (e.g. "packages/eddie-web-components/components/badge/badge.ts", "docs/CODE_GUIDELINES.md")' },
+            },
+            required: ['path'],
+        },
+    },
+    ds_search_design_knowledge: {
+        name: 'ds_search_design_knowledge',
+        description: 'Search design system best practices from major design systems (Material, Spectrum, Carbon, Polaris, etc.). Use this to research how other design systems handle similar components, patterns, and conventions.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: 'Search query (e.g. "badge component best practices", "size variants")' },
+                category: { type: 'string', description: 'Optional category filter', enum: ['figma', 'tokens', 'components', 'documentation', 'workflow', 'governance', 'accessibility', 'tools', 'case-studies', 'foundations'] },
+                limit: { type: 'number', description: 'Max results (default 15)' },
+            },
+            required: ['query'],
+        },
+    },
+    ds_search_chunks: {
+        name: 'ds_search_chunks',
+        description: 'Search detailed content chunks from design system knowledge base for specific implementation guidance.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: 'Search query for specific design system content' },
+                limit: { type: 'number', description: 'Max chunks to return (default 8)' },
+            },
+            required: ['query'],
+        },
+    },
+    ds_browse_by_category: {
+        name: 'ds_browse_by_category',
+        description: 'Browse all design system knowledge entries in a category.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                category: { type: 'string', description: 'Category to browse', enum: ['figma', 'tokens', 'components', 'documentation', 'workflow', 'governance', 'accessibility', 'tools', 'case-studies', 'foundations'] },
+            },
+            required: ['category'],
+        },
+    },
+};
+//# sourceMappingURL=tool-handler.js.map

package/dist/pipeline/tool-handler.js.map

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

package/dist/pipeline/types.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Pipeline Types — Artifacts, agent configuration, and pipeline state
+ *
+ * These types define the contract between the 8 agents in the component
+ * generation pipeline. Each agent consumes input artifacts and produces
+ * output artifacts, mediated by the orchestrator.
+ */
+import type { HealthIssue, LearningEntry } from '../types.js';
+/** Names of structured artifacts that flow between agents */
+export type ArtifactName = 'brief.md' | 'component-rules.md' | 'architecture.md' | 'component.ts' | 'component.scss' | 'component.stories.ts';
+/** A single pipeline artifact */
+export interface PipelineArtifact {
+    name: ArtifactName | string;
+    content: string;
+    /** Which agent produced this */
+    producedBy: AgentId;
+    /** When it was produced */
+    timestamp: string;
+    /** Version (incremented on each agent revision) */
+    version: number;
+}
+/** Agent identifiers matching the 8 pipeline agents */
+export type AgentId = 'spec-analyst' | 'library-researcher' | 'component-architect' | 'code-writer' | 'accessibility-auditor' | 'story-author' | 'code-reviewer' | 'quality-gate';
+/** Pipeline phase */
+export type PipelinePhase = 'understand' | 'build' | 'verify';
+/** Which eddie-brain tools an agent is allowed to call */
+export type EddieTool = 'eddie_get_component' | 'eddie_get_token' | 'eddie_validate_file' | 'eddie_check_health' | 'eddie_compose_recipe' | 'eddie_get_relationships' | 'eddie_search' | 'eddie_suggest_fix' | 'eddie_read_file' | 'ds_search_design_knowledge' | 'ds_search_chunks' | 'ds_browse_by_category';
+/** Static configuration for a single agent */
+export interface AgentConfig {
+    id: AgentId;
+    name: string;
+    phase: PipelinePhase;
+    /** System prompt template. Uses {{artifactName}} for substitution. */
+    systemPrompt: string;
+    /** Which artifacts this agent reads */
+    inputArtifacts: Array<ArtifactName | string>;
+    /** Which artifacts this agent produces */
+    outputArtifacts: Array<ArtifactName | string>;
+    /** Which Eddie MCP tools this agent may call */
+    tools: EddieTool[];
+    /** Maximum iterations for this agent's fix loop */
+    maxIterations: number;
+    /** If true, pipeline pauses for human review after this agent */
+    hasConversationalGate: boolean;
+}
+/** Push-back severity from Agent 3's conversational gate */
+export type PushBackLevel = 'BLOCKING' | 'OVERRIDE' | 'SUGGESTION';
+/** A push-back item from the component architect */
+export interface PushBackItem {
+    level: PushBackLevel;
+    category: string;
+    message: string;
+    /** What the architect recommends instead */
+    recommendation: string;
+}
+/** Record of a single iteration within an agent's fix loop */
+export interface IterationRecord {
+    iteration: number;
+    timestamp: string;
+    /** Health score or issue count at this iteration */
+    score: number;
+    /** Delta from previous iteration */
+    delta: number;
+    /** Issues found at this iteration */
+    issues: HealthIssue[];
+    /** Whether the agent stopped due to diminishing returns */
+    stoppedEarly: boolean;
+}
+/** Summary of an agent's iteration history */
+export interface IterationSummary {
+    agentId: AgentId;
+    totalIterations: number;
+    maxIterations: number;
+    startScore: number;
+    endScore: number;
+    totalImprovement: number;
+    stoppedEarly: boolean;
+    records: IterationRecord[];
+}
+/** Status of a single agent run */
+export type AgentStatus = 'pending' | 'running' | 'gated' | 'completed' | 'failed' | 'skipped';
+/** Runtime state for one agent in the pipeline */
+export interface AgentState {
+    agentId: AgentId;
+    status: AgentStatus;
+    startedAt: string | null;
+    completedAt: string | null;
+    iterations: IterationSummary | null;
+    pushBacks: PushBackItem[];
+    /** Any error that caused failure */
+    error: string | null;
+}
+/** Overall pipeline status */
+export type PipelineStatus = 'idle' | 'running' | 'gated' | 'completed' | 'failed';
+/** Full pipeline state, serializable to disk */
+export interface PipelineState {
+    id: string;
+    status: PipelineStatus;
+    /** The original brief text */
+    brief: string;
+    /** Target component name (e.g., "ed-progress-bar") */
+    componentName: string;
+    /** Current phase */
+    currentPhase: PipelinePhase;
+    /** Current agent */
+    currentAgent: AgentId | null;
+    /** State per agent */
+    agents: Record<AgentId, AgentState>;
+    /** All artifacts produced so far */
+    artifacts: Record<string, PipelineArtifact>;
+    /** Timestamps */
+    startedAt: string;
+    completedAt: string | null;
+    /** Learning entries to record at the end */
+    learnings: LearningEntry[];
+}
+/** Configuration for running a pipeline */
+export interface PipelineConfig {
+    /** Anthropic API key */
+    apiKey: string;
+    /** Model to use */
+    model: string;
+    /** Path to Eddie monorepo root */
+    rootDir: string;
+    /** Where to write output files */
+    outputDir: string;
+    /** Whether to pause at conversational gates */
+    interactive: boolean;
+    /** Override iteration budgets per agent */
+    iterationBudgets?: Partial<Record<AgentId, number>>;
+    /** Minimum improvement percentage to continue iterating (default: 2) */
+    diminishingReturnsThreshold: number;
+}
+/** Default pipeline config (API key must be provided) */
+export declare const DEFAULT_PIPELINE_CONFIG: Omit<PipelineConfig, 'apiKey'>;
+/** Result of running a single agent */
+export interface AgentRunResult {
+    artifacts: PipelineArtifact[];
+    iterations: IterationRecord[];
+    toolCallCount: number;
+    pushBacks: PushBackItem[];
+    error: string | null;
+}
+/** The ordered sequence of agents in the pipeline */
+export declare const PIPELINE_AGENT_ORDER: AgentId[];
+//# sourceMappingURL=types.d.ts.map

package/dist/pipeline/types.d.ts.map

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

package/dist/pipeline/types.js

@@ -0,0 +1,27 @@
+/**
+ * Pipeline Types — Artifacts, agent configuration, and pipeline state
+ *
+ * These types define the contract between the 8 agents in the component
+ * generation pipeline. Each agent consumes input artifacts and produces
+ * output artifacts, mediated by the orchestrator.
+ */
+/** Default pipeline config (API key must be provided) */
+export const DEFAULT_PIPELINE_CONFIG = {
+    model: 'claude-sonnet-4-20250514',
+    rootDir: '.',
+    outputDir: './pipeline-output',
+    interactive: true,
+    diminishingReturnsThreshold: 2,
+};
+/** The ordered sequence of agents in the pipeline */
+export const PIPELINE_AGENT_ORDER = [
+    'spec-analyst',
+    'library-researcher',
+    'component-architect',
+    'code-writer',
+    'accessibility-auditor',
+    'story-author',
+    'code-reviewer',
+    'quality-gate',
+];
+//# sourceMappingURL=types.js.map

package/dist/pipeline/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pipeline/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkMH,yDAAyD;AACzD,MAAM,CAAC,MAAM,uBAAuB,GAAmC;IACrE,KAAK,EAAE,0BAA0B;IACjC,OAAO,EAAE,GAAG;IACZ,SAAS,EAAE,mBAAmB;IAC9B,WAAW,EAAE,IAAI;IACjB,2BAA2B,EAAE,CAAC;CAC/B,CAAC;AAeF,qDAAqD;AACrD,MAAM,CAAC,MAAM,oBAAoB,GAAc;IAC7C,cAAc;IACd,oBAAoB;IACpB,qBAAqB;IACrB,aAAa;IACb,uBAAuB;IACvB,cAAc;IACd,eAAe;IACf,cAAc;CACf,CAAC"}

package/dist/plan/action-types.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Action Type Utilities — Constants and helpers for action planning
+ */
+import { PlannedAction, RiskLevel } from '../types.js';
+/**
+ * Map signal types to their default risk levels
+ */
+export declare const ACTION_RISK_MAP: Record<string, RiskLevel>;
+/**
+ * Get default risk level for a signal type
+ */
+export declare function getDefaultRiskForSignal(signalType: string): RiskLevel;
+/**
+ * Generate human-readable description of a planned action
+ */
+export declare function describeAction(action: PlannedAction): string;
+/**
+ * Check if an action can be automatically executed without human approval
+ *
+ * Auto-executable actions:
+ * - suggest: no, needs review
+ * - notify: yes, just information
+ * - draft_pr: no, needs review
+ * - create_pr: no, needs review
+ * - auto_fix: yes, but recorded
+ * - auto_merge: yes, but recorded
+ * - update_docs: yes, but recorded
+ * - escalate: no, by definition requires human
+ */
+export declare function canAutoExecute(action: PlannedAction): boolean;
+//# sourceMappingURL=action-types.d.ts.map

package/dist/plan/action-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-types.d.ts","sourceRoot":"","sources":["../../src/plan/action-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAc,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAWrD,CAAC;AAEF;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAErE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAgC5D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAqB7D"}