@red-codes/agentguard 1.0.0

package/dist/policy/pack-loader.js

@@ -0,0 +1,138 @@
+// Policy pack loader — resolves, loads, validates, and merges policy packs.
+// Supports local directory packs and npm-style package references.
+//
+// A policy pack is a YAML or JSON policy file that can be referenced via the
+// `extends` key in a policy definition. Packs are loaded and their rules are
+// merged with the local policy, with local rules taking precedence.
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve, join } from 'node:path';
+import { loadYamlPolicy } from './yaml-loader.js';
+import { validatePolicy } from './loader.js';
+/** Candidate filenames when resolving a pack directory */
+const PACK_MANIFEST_CANDIDATES = [
+    'agentguard-pack.yaml',
+    'agentguard-pack.yml',
+    'agentguard-pack.json',
+    'agentguard.yaml',
+    'agentguard.yml',
+];
+/**
+ * Resolve a single pack reference to an absolute file path.
+ *
+ * Supports three reference styles:
+ * 1. Relative path — `"./packs/strict"` or `"./packs/strict.yaml"`
+ * 2. Absolute path — `"/home/user/packs/strict.yaml"`
+ * 3. npm package — `"@agentguard/security-pack"` resolved from node_modules
+ */
+export function resolvePackPath(ref, baseDir) {
+    // 1. Direct file reference (relative or absolute)
+    const directPath = resolve(baseDir, ref);
+    if (existsSync(directPath)) {
+        // If it's a file, use it directly
+        if (directPath.endsWith('.yaml') ||
+            directPath.endsWith('.yml') ||
+            directPath.endsWith('.json')) {
+            return directPath;
+        }
+        // If it's a directory, look for manifest files
+        for (const candidate of PACK_MANIFEST_CANDIDATES) {
+            const candidatePath = join(directPath, candidate);
+            if (existsSync(candidatePath)) {
+                return candidatePath;
+            }
+        }
+    }
+    // Try with common extensions if the direct path didn't work
+    for (const ext of ['.yaml', '.yml', '.json']) {
+        const withExt = directPath + ext;
+        if (existsSync(withExt)) {
+            return withExt;
+        }
+    }
+    // 2. npm package reference — search node_modules
+    const nodeModulesPath = join(baseDir, 'node_modules', ref);
+    if (existsSync(nodeModulesPath)) {
+        for (const candidate of PACK_MANIFEST_CANDIDATES) {
+            const candidatePath = join(nodeModulesPath, candidate);
+            if (existsSync(candidatePath)) {
+                return candidatePath;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Load a single policy pack from a resolved file path.
+ */
+export function loadPackFile(filePath) {
+    const content = readFileSync(filePath, 'utf8');
+    if (filePath.endsWith('.yaml') || filePath.endsWith('.yml')) {
+        return loadYamlPolicy(content, `pack:${filePath}`);
+    }
+    try {
+        const parsed = JSON.parse(content);
+        const result = validatePolicy(parsed);
+        if (!result.valid) {
+            return null;
+        }
+        return {
+            id: parsed.id || `pack:${filePath}`,
+            name: parsed.name || 'JSON Pack',
+            description: parsed.description,
+            rules: parsed.rules,
+            severity: parsed.severity ?? 3,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Resolve and load all policy packs from an `extends` list.
+ *
+ * @param extends_ - Array of pack references (paths or npm package names)
+ * @param baseDir  - Directory to resolve relative paths from
+ * @returns Loaded pack policies and any errors encountered
+ */
+export function resolveExtends(extends_, baseDir) {
+    const policies = [];
+    const errors = [];
+    const seenIds = new Set();
+    for (const ref of extends_) {
+        const resolvedPath = resolvePackPath(ref, baseDir);
+        if (!resolvedPath) {
+            errors.push(`Pack not found: "${ref}" (searched from ${baseDir})`);
+            continue;
+        }
+        const pack = loadPackFile(resolvedPath);
+        if (!pack) {
+            errors.push(`Failed to load pack: "${ref}" (${resolvedPath})`);
+            continue;
+        }
+        if (seenIds.has(pack.id)) {
+            errors.push(`Duplicate pack ID: "${pack.id}" from "${ref}"`);
+            continue;
+        }
+        seenIds.add(pack.id);
+        policies.push(pack);
+    }
+    return { policies, errors };
+}
+/**
+ * Merge pack policies with a local policy.
+ *
+ * Precedence: local rules override pack rules. Within packs, earlier entries
+ * in the `extends` list take precedence over later entries.
+ *
+ * The merge strategy is:
+ * 1. Collect all rules from packs (in extends order)
+ * 2. Append local rules (which take precedence during evaluation since
+ *    the evaluator checks deny rules first, then allow rules)
+ * 3. Return a single merged policy array
+ */
+export function mergePolicies(localPolicy, packPolicies) {
+    // Pack policies come first (lower precedence in evaluation order)
+    // Local policy comes last (highest precedence)
+    return [...packPolicies, localPolicy];
+}
+//# sourceMappingURL=pack-loader.js.map

package/dist/policy/pack-loader.js.map

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

package/dist/policy/yaml-loader.d.ts

@@ -0,0 +1,23 @@
+import type { LoadedPolicy } from './evaluator.js';
+export interface YamlPolicyDef {
+    id?: string;
+    name?: string;
+    description?: string;
+    severity?: number;
+    extends?: string[];
+    rules?: YamlRule[];
+}
+interface YamlRule {
+    action?: string;
+    effect?: string;
+    target?: string;
+    branches?: string[];
+    reason?: string;
+    limit?: number;
+    requireTests?: boolean;
+}
+export declare function parseYamlPolicy(yaml: string): YamlPolicyDef;
+export declare function loadYamlPolicy(yaml: string, defaultId?: string): LoadedPolicy;
+export declare function loadYamlPolicies(yaml: string): LoadedPolicy[];
+export {};
+//# sourceMappingURL=yaml-loader.d.ts.map

package/dist/policy/yaml-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-loader.d.ts","sourceRoot":"","sources":["../../src/policy/yaml-loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAc,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE/D,MAAM,WAAW,aAAa;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;CACpB;AAED,UAAU,QAAQ;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAkCD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CA2H3D;AAgED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,YAAY,CAU7E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CAE7D"}

package/dist/policy/yaml-loader.js

@@ -0,0 +1,222 @@
+// YAML policy loader — parses simple YAML policy files into LoadedPolicy format.
+// Supports the subset of YAML needed for AgentGuard policy definitions.
+// No external dependencies — minimal line-based parser for constrained format.
+function trimQuotes(s) {
+    if ((s.startsWith('"') && s.endsWith('"')) || (s.startsWith("'") && s.endsWith("'"))) {
+        return s.slice(1, -1);
+    }
+    return s;
+}
+function parseValue(raw) {
+    const s = raw.trim();
+    if (s === 'true')
+        return true;
+    if (s === 'false')
+        return false;
+    if (s === 'null' || s === '~')
+        return '';
+    if (/^-?\d+$/.test(s))
+        return parseInt(s, 10);
+    if (/^-?\d+\.\d+$/.test(s))
+        return parseFloat(s);
+    return trimQuotes(s);
+}
+function parseInlineArray(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed.startsWith('[') || !trimmed.endsWith(']'))
+        return [];
+    const inner = trimmed.slice(1, -1);
+    return inner
+        .split(',')
+        .map((s) => trimQuotes(s.trim()))
+        .filter((s) => s.length > 0);
+}
+function indentLevel(line) {
+    const match = line.match(/^(\s*)/);
+    return match ? match[1].length : 0;
+}
+export function parseYamlPolicy(yaml) {
+    const lines = yaml.split('\n');
+    const result = {};
+    const rules = [];
+    let currentRule = null;
+    let inRules = false;
+    let inBranches = false;
+    let inExtends = false;
+    for (const rawLine of lines) {
+        const line = rawLine.replace(/\r$/, '');
+        // Skip blank lines and comments
+        if (!line.trim() || line.trim().startsWith('#'))
+            continue;
+        const indent = indentLevel(line);
+        const trimmed = line.trim();
+        // Top-level keys (indent 0)
+        if (indent === 0) {
+            inRules = false;
+            inBranches = false;
+            inExtends = false;
+            if (currentRule) {
+                rules.push(currentRule);
+                currentRule = null;
+            }
+            const colonIdx = trimmed.indexOf(':');
+            if (colonIdx === -1)
+                continue;
+            const key = trimmed.slice(0, colonIdx).trim();
+            const val = trimmed.slice(colonIdx + 1).trim();
+            switch (key) {
+                case 'id':
+                    result.id = trimQuotes(val);
+                    break;
+                case 'name':
+                    result.name = trimQuotes(val);
+                    break;
+                case 'description':
+                    result.description = trimQuotes(val);
+                    break;
+                case 'severity':
+                    result.severity = parseInt(val, 10);
+                    break;
+                case 'extends':
+                    if (val) {
+                        // Inline array: extends: ["@agentguard/security-pack", "./custom"]
+                        const arr = parseInlineArray(val);
+                        if (arr.length > 0) {
+                            result.extends = arr;
+                        }
+                    }
+                    else {
+                        // Multi-line array follows
+                        inExtends = true;
+                        result.extends = [];
+                    }
+                    break;
+                case 'rules':
+                    inRules = true;
+                    break;
+            }
+            continue;
+        }
+        // Inside extends array (multi-line)
+        if (inExtends && trimmed.startsWith('- ')) {
+            result.extends = result.extends || [];
+            result.extends.push(trimQuotes(trimmed.slice(2).trim()));
+            continue;
+        }
+        // Inside rules array
+        if (inRules) {
+            // New rule entry (- action: ...)
+            if (trimmed.startsWith('- ')) {
+                if (currentRule)
+                    rules.push(currentRule);
+                currentRule = {};
+                inBranches = false;
+                const rest = trimmed.slice(2).trim();
+                const colonIdx = rest.indexOf(':');
+                if (colonIdx !== -1) {
+                    const key = rest.slice(0, colonIdx).trim();
+                    const val = rest.slice(colonIdx + 1).trim();
+                    applyRuleField(currentRule, key, val);
+                }
+                continue;
+            }
+            // Continuation of branches array
+            if (inBranches && trimmed.startsWith('- ') && currentRule) {
+                currentRule.branches = currentRule.branches || [];
+                currentRule.branches.push(trimQuotes(trimmed.slice(2).trim()));
+                continue;
+            }
+            // Rule property
+            if (currentRule) {
+                inBranches = false;
+                const colonIdx = trimmed.indexOf(':');
+                if (colonIdx !== -1) {
+                    const key = trimmed.slice(0, colonIdx).trim();
+                    const val = trimmed.slice(colonIdx + 1).trim();
+                    if (key === 'branches' && !val) {
+                        inBranches = true;
+                        currentRule.branches = [];
+                        continue;
+                    }
+                    applyRuleField(currentRule, key, val);
+                }
+            }
+        }
+    }
+    if (currentRule)
+        rules.push(currentRule);
+    if (rules.length > 0)
+        result.rules = rules;
+    return result;
+}
+function applyRuleField(rule, key, val) {
+    switch (key) {
+        case 'action':
+            rule.action = trimQuotes(val);
+            break;
+        case 'effect':
+            rule.effect = trimQuotes(val);
+            break;
+        case 'target':
+            rule.target = trimQuotes(val);
+            break;
+        case 'reason':
+            rule.reason = trimQuotes(val);
+            break;
+        case 'limit': {
+            const n = parseValue(val);
+            if (typeof n === 'number')
+                rule.limit = n;
+            break;
+        }
+        case 'requireTests':
+            rule.requireTests = val === 'true';
+            break;
+        case 'branches': {
+            const arr = parseInlineArray(val);
+            if (arr.length > 0)
+                rule.branches = arr;
+            break;
+        }
+    }
+}
+function convertRule(yamlRule) {
+    const conditions = {};
+    let hasConditions = false;
+    if (yamlRule.target) {
+        conditions.scope = [yamlRule.target];
+        hasConditions = true;
+    }
+    if (yamlRule.branches) {
+        conditions.branches = yamlRule.branches;
+        hasConditions = true;
+    }
+    if (yamlRule.limit !== undefined) {
+        conditions.limit = yamlRule.limit;
+        hasConditions = true;
+    }
+    if (yamlRule.requireTests !== undefined) {
+        conditions.requireTests = yamlRule.requireTests;
+        hasConditions = true;
+    }
+    return {
+        action: yamlRule.action || '*',
+        effect: yamlRule.effect || 'deny',
+        conditions: hasConditions ? conditions : undefined,
+        reason: yamlRule.reason,
+    };
+}
+export function loadYamlPolicy(yaml, defaultId) {
+    const def = parseYamlPolicy(yaml);
+    return {
+        id: def.id || defaultId || 'yaml-policy',
+        name: def.name || 'YAML Policy',
+        description: def.description,
+        rules: (def.rules || []).map(convertRule),
+        severity: def.severity ?? 3,
+    };
+}
+export function loadYamlPolicies(yaml) {
+    return [loadYamlPolicy(yaml)];
+}
+//# sourceMappingURL=yaml-loader.js.map

package/dist/policy/yaml-loader.js.map

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

package/dist/renderers/index.d.ts

@@ -0,0 +1,6 @@
+export type { GovernanceRenderer, RendererConfig, RunSummary } from './types.js';
+export { createRendererRegistry } from './registry.js';
+export type { RendererRegistry } from './registry.js';
+export { createTuiRenderer } from './tui-renderer.js';
+export type { TuiRendererOptions } from './tui-renderer.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/renderers/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/renderers/index.js

@@ -0,0 +1,4 @@
+// Renderer plugin system — re-exports for public API.
+export { createRendererRegistry } from './registry.js';
+export { createTuiRenderer } from './tui-renderer.js';
+//# sourceMappingURL=index.js.map

package/dist/renderers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/renderers/index.ts"],"names":[],"mappings":"AAAA,sDAAsD;AAItD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAGvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/renderers/registry.d.ts

@@ -0,0 +1,39 @@
+import type { GovernanceRenderer, RendererConfig, RunSummary } from './types.js';
+import type { KernelResult } from '../kernel/kernel.js';
+import type { MonitorDecision } from '../kernel/monitor.js';
+import type { GovernanceDecisionRecord } from '../kernel/decisions/types.js';
+import type { SimulationResult } from '../kernel/simulation/types.js';
+export interface RendererRegistry {
+    /** Register a renderer. Throws if a renderer with the same ID already exists. */
+    register(renderer: GovernanceRenderer): void;
+    /** Unregister a renderer by ID. Calls dispose() if available. Returns true if found. */
+    unregister(id: string): boolean;
+    /** Get a registered renderer by ID */
+    get(id: string): GovernanceRenderer | undefined;
+    /** List all registered renderer IDs */
+    list(): string[];
+    /** Number of registered renderers */
+    count(): number;
+    /** Dispatch: run started */
+    notifyRunStarted(config: RendererConfig): void;
+    /** Dispatch: action result */
+    notifyActionResult(result: KernelResult): void;
+    /** Dispatch: monitor status */
+    notifyMonitorStatus(decision: MonitorDecision): void;
+    /** Dispatch: simulation completed */
+    notifySimulation(simulation: SimulationResult): void;
+    /** Dispatch: decision record */
+    notifyDecisionRecord(record: GovernanceDecisionRecord): void;
+    /** Dispatch: run ended */
+    notifyRunEnded(summary: RunSummary): void;
+    /** Dispose all renderers and clear the registry */
+    disposeAll(): void;
+}
+/**
+ * Create a new renderer registry.
+ *
+ * Renderers are dispatched in registration order.
+ * Errors in one renderer do not prevent other renderers from receiving events.
+ */
+export declare function createRendererRegistry(): RendererRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/renderers/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/renderers/registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAE7C,wFAAwF;IACxF,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAEhC,sCAAsC;IACtC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAAC;IAEhD,uCAAuC;IACvC,IAAI,IAAI,MAAM,EAAE,CAAC;IAEjB,qCAAqC;IACrC,KAAK,IAAI,MAAM,CAAC;IAEhB,4BAA4B;IAC5B,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAE/C,8BAA8B;IAC9B,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAE/C,+BAA+B;IAC/B,mBAAmB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;IAErD,qCAAqC;IACrC,gBAAgB,CAAC,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAErD,gCAAgC;IAChC,oBAAoB,CAAC,MAAM,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAE7D,0BAA0B;IAC1B,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAE1C,mDAAmD;IACnD,UAAU,IAAI,IAAI,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAkGzD"}

package/dist/renderers/registry.js

@@ -0,0 +1,97 @@
+// Renderer registry — manages multiple governance renderers.
+// Dispatches lifecycle events to all registered renderers.
+/**
+ * Create a new renderer registry.
+ *
+ * Renderers are dispatched in registration order.
+ * Errors in one renderer do not prevent other renderers from receiving events.
+ */
+export function createRendererRegistry() {
+    const renderers = new Map();
+    const safeCall = (fn) => {
+        try {
+            fn();
+        }
+        catch {
+            // Renderer errors are non-fatal — isolate failures
+        }
+    };
+    return {
+        register(renderer) {
+            if (renderers.has(renderer.id)) {
+                throw new Error(`Renderer already registered: "${renderer.id}"`);
+            }
+            renderers.set(renderer.id, renderer);
+        },
+        unregister(id) {
+            const renderer = renderers.get(id);
+            if (!renderer)
+                return false;
+            if (renderer.dispose) {
+                safeCall(() => renderer.dispose());
+            }
+            renderers.delete(id);
+            return true;
+        },
+        get(id) {
+            return renderers.get(id);
+        },
+        list() {
+            return [...renderers.keys()];
+        },
+        count() {
+            return renderers.size;
+        },
+        notifyRunStarted(config) {
+            for (const renderer of renderers.values()) {
+                if (renderer.onRunStarted) {
+                    safeCall(() => renderer.onRunStarted(config));
+                }
+            }
+        },
+        notifyActionResult(result) {
+            for (const renderer of renderers.values()) {
+                if (renderer.onActionResult) {
+                    safeCall(() => renderer.onActionResult(result));
+                }
+            }
+        },
+        notifyMonitorStatus(decision) {
+            for (const renderer of renderers.values()) {
+                if (renderer.onMonitorStatus) {
+                    safeCall(() => renderer.onMonitorStatus(decision));
+                }
+            }
+        },
+        notifySimulation(simulation) {
+            for (const renderer of renderers.values()) {
+                if (renderer.onSimulation) {
+                    safeCall(() => renderer.onSimulation(simulation));
+                }
+            }
+        },
+        notifyDecisionRecord(record) {
+            for (const renderer of renderers.values()) {
+                if (renderer.onDecisionRecord) {
+                    safeCall(() => renderer.onDecisionRecord(record));
+                }
+            }
+        },
+        notifyRunEnded(summary) {
+            for (const renderer of renderers.values()) {
+                if (renderer.onRunEnded) {
+                    safeCall(() => renderer.onRunEnded(summary));
+                }
+            }
+        },
+        disposeAll() {
+            for (const renderer of renderers.values()) {
+                if (renderer.dispose) {
+                    safeCall(() => renderer.dispose());
+                }
+            }
+            renderers.clear();
+        },
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/renderers/registry.js.map

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

package/dist/renderers/tui-renderer.d.ts

@@ -0,0 +1,18 @@
+import type { GovernanceRenderer } from './types.js';
+export interface TuiRendererOptions {
+    /** Output stream — defaults to process.stderr */
+    output?: {
+        write(s: string): boolean;
+    };
+    /** Show verbose output (decision records, reasons) */
+    verbose?: boolean;
+}
+/**
+ * Create a TUI governance renderer.
+ *
+ * This is the reference implementation of GovernanceRenderer. It adapts
+ * the existing tui.ts render functions into the plugin interface, writing
+ * ANSI-colored output to the configured stream (stderr by default).
+ */
+export declare function createTuiRenderer(options?: TuiRendererOptions): GovernanceRenderer;
+//# sourceMappingURL=tui-renderer.d.ts.map

package/dist/renderers/tui-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-renderer.d.ts","sourceRoot":"","sources":["../../src/renderers/tui-renderer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAA8B,MAAM,YAAY,CAAC;AAajF,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACvC,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,kBAAkB,CAwDtF"}

package/dist/renderers/tui-renderer.js

@@ -0,0 +1,57 @@
+// TUI governance renderer — wraps the existing tui.ts render functions
+// into a GovernanceRenderer plugin. Writes ANSI-colored output to a stream.
+import { renderBanner, renderKernelResult, renderMonitorStatus, renderDecisionRecord, renderSimulation, } from '../cli/tui.js';
+/**
+ * Create a TUI governance renderer.
+ *
+ * This is the reference implementation of GovernanceRenderer. It adapts
+ * the existing tui.ts render functions into the plugin interface, writing
+ * ANSI-colored output to the configured stream (stderr by default).
+ */
+export function createTuiRenderer(options = {}) {
+    const output = options.output ?? process.stderr;
+    const verbose = options.verbose ?? false;
+    return {
+        id: 'tui',
+        name: 'Terminal UI Renderer',
+        onRunStarted(config) {
+            output.write(renderBanner({
+                policyName: config.policyName,
+                invariantCount: config.invariantCount,
+                verbose: config.verbose ?? verbose,
+            }));
+            output.write(`  \x1b[2mrun: ${config.runId}\x1b[0m\n`);
+            if (config.simulatorCount && config.simulatorCount > 0) {
+                output.write(`  \x1b[2msimulators: ${config.simulatorCount} active\x1b[0m\n`);
+            }
+            output.write('\n');
+        },
+        onActionResult(result) {
+            output.write(renderKernelResult(result, verbose) + '\n');
+            if (result.decision.violations.length > 0 || !result.allowed) {
+                output.write(renderMonitorStatus(result.decision) + '\n');
+            }
+        },
+        onMonitorStatus(decision) {
+            output.write(renderMonitorStatus(decision) + '\n');
+        },
+        onSimulation(simulation) {
+            output.write(renderSimulation(simulation) + '\n');
+        },
+        onDecisionRecord(record) {
+            if (verbose) {
+                output.write(renderDecisionRecord(record) + '\n');
+            }
+        },
+        onRunEnded(summary) {
+            const lines = [];
+            lines.push('');
+            lines.push(`  \x1b[1m\x1b[36mRun Complete\x1b[0m \x1b[2m${summary.runId}\x1b[0m`);
+            lines.push(`  \x1b[2mactions: ${summary.totalActions} | allowed: ${summary.allowed} | denied: ${summary.denied} | violations: ${summary.violations}\x1b[0m`);
+            lines.push(`  \x1b[2mduration: ${summary.durationMs}ms\x1b[0m`);
+            lines.push('');
+            output.write(lines.join('\n'));
+        },
+    };
+}
+//# sourceMappingURL=tui-renderer.js.map