@decibelsystems/tools 2.0.0

package/dist/agentic/types.d.ts

@@ -0,0 +1,199 @@
+/**
+ * Agentic Pack Engine - Type Definitions
+ *
+ * Core invariant: Canonical payload is the truth. Renderers are only views.
+ * Renderers NEVER change meaning. They change compression, typography, and stance.
+ */
+export type AgentRole = 'Sensor' | 'Analyst' | 'Overmind' | 'Specialist';
+export type AgentStatus = 'OK' | 'DEGRADED' | 'BLOCKED' | 'ALERT';
+export type LoadLevel = 'GREEN' | 'YELLOW' | 'RED';
+export interface Evidence {
+    source: string;
+    value: unknown;
+    confidence?: number;
+    timestamp?: string;
+}
+export interface MissingData {
+    field: string;
+    reason: string;
+    severity: 'blocking' | 'degraded' | 'informational';
+}
+export interface Guardrail {
+    id: string;
+    description: string;
+    status: 'active' | 'triggered' | 'disabled';
+}
+export interface DissentSummary {
+    agent_id: string;
+    position: string;
+    confidence: number;
+}
+export interface PayloadMetadata {
+    pack_id: string;
+    pack_hash: string;
+    renderer_id?: string;
+    specialist_id?: string;
+    created_at: string;
+}
+export interface CanonicalPayload {
+    role: AgentRole;
+    status: AgentStatus;
+    load: LoadLevel;
+    summary: string;
+    evidence: Evidence[];
+    missing_data: MissingData[];
+    decision?: string;
+    guardrails?: Guardrail[];
+    dissent_summary?: DissentSummary[];
+    specialist_id?: string;
+    specialist_name?: string;
+    metadata: PayloadMetadata;
+}
+export type RenderTarget = 'plain' | 'markdown' | 'ansi';
+export interface RendererConstraints {
+    max_emoji_count?: number;
+    emoji_position?: 'header-only' | 'none' | 'anywhere';
+    max_lines?: number;
+    max_section_lines?: number;
+    required_sections?: string[];
+    banned_punctuation?: string[];
+    banned_words?: string[];
+}
+export interface RendererConfig {
+    id: string;
+    name: string;
+    description?: string;
+    template: string;
+    constraints: RendererConstraints;
+    ansi_styles?: Record<string, string>;
+}
+export interface RenderOutput {
+    rendered: string;
+    renderer_id: string;
+    target: RenderTarget;
+    warnings: string[];
+    metadata: {
+        line_count: number;
+        char_count: number;
+        emoji_count: number;
+    };
+}
+export type LintSeverity = 'error' | 'warning' | 'info';
+export interface LintViolation {
+    rule: string;
+    severity: LintSeverity;
+    message: string;
+    line?: number;
+    column?: number;
+    suggestion?: string;
+}
+export interface LintResult {
+    valid: boolean;
+    violations: LintViolation[];
+    renderer_id: string;
+    checked_at: string;
+}
+export interface AvatarConfig {
+    id: string;
+    name: string;
+    emoji?: string;
+    role: AgentRole;
+    description?: string;
+}
+export interface TaxonomyConfig {
+    roles: Record<AgentRole, {
+        emoji: string;
+        description: string;
+    }>;
+    statuses: Record<AgentStatus, {
+        emoji: string;
+        color: string;
+    }>;
+    loads: Record<LoadLevel, {
+        emoji: string;
+        color: string;
+    }>;
+}
+export interface ConsensusConfig {
+    quorum_threshold: number;
+    dissent_highlight_threshold: number;
+    max_pending_decisions: number;
+}
+export interface CompiledPack {
+    taxonomy: TaxonomyConfig;
+    renderers: Record<string, RendererConfig>;
+    consensus?: ConsensusConfig;
+    avatars: Record<string, AvatarConfig>;
+    ansi_styles?: Record<string, string>;
+}
+export interface CompileResult {
+    pack_id: string;
+    pack_hash: string;
+    compiled_at: string;
+    content: CompiledPack;
+    source_files: string[];
+}
+export interface GoldenCase {
+    name: string;
+    payload_file: string;
+    expected_outputs: Record<string, string>;
+}
+export interface GoldenTestResult {
+    case_name: string;
+    renderer_id: string;
+    passed: boolean;
+    expected_file: string;
+    actual?: string;
+    expected?: string;
+    diff?: string[];
+    lint_result?: LintResult;
+}
+export interface GoldenResult {
+    passed: boolean;
+    total_cases: number;
+    passed_cases: number;
+    failed_cases: number;
+    results: GoldenTestResult[];
+    run_at: string;
+}
+export interface CompilePackInput {
+    projectId?: string;
+}
+export interface CompilePackOutput {
+    status: 'compiled' | 'error';
+    result?: CompileResult;
+    error?: string;
+}
+export interface RenderInput {
+    projectId?: string;
+    payload: CanonicalPayload;
+    renderer_id: string;
+    target?: RenderTarget;
+}
+export interface RenderOutputResult {
+    status: 'rendered' | 'error';
+    result?: RenderOutput;
+    error?: string;
+}
+export interface LintInput {
+    projectId?: string;
+    rendered: string;
+    renderer_id: string;
+    payload?: CanonicalPayload;
+}
+export interface LintOutputResult {
+    status: 'linted' | 'error';
+    result?: LintResult;
+    error?: string;
+}
+export interface GoldenInput {
+    projectId?: string;
+    case_name?: string;
+    strict?: boolean;
+}
+export interface GoldenOutputResult {
+    status: 'executed' | 'error';
+    result?: GoldenResult;
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/agentic/types.js

@@ -0,0 +1,8 @@
+/**
+ * Agentic Pack Engine - Type Definitions
+ *
+ * Core invariant: Canonical payload is the truth. Renderers are only views.
+ * Renderers NEVER change meaning. They change compression, typography, and stance.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/agentic/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agentic/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/architectAdrs.d.ts

@@ -0,0 +1,32 @@
+export type AdrStatus = 'proposed' | 'accepted' | 'superseded' | 'deprecated';
+export interface AdrInput {
+    projectId: string;
+    title: string;
+    context: string;
+    decision: string;
+    consequences: string;
+    relatedIssues?: string[];
+    relatedEpics?: string[];
+}
+export interface AdrOutput {
+    id: string;
+    path: string;
+}
+/**
+ * Create a new project-level ADR
+ */
+export declare function createProjectAdr(input: AdrInput): Promise<AdrOutput>;
+/**
+ * List ADRs for a project (ID + title + status)
+ */
+export declare function listProjectAdrs(projectId: string): Promise<Array<{
+    id: string;
+    title: string;
+    status: string;
+    filename: string;
+}>>;
+/**
+ * Read a single ADR by ID (e.g., "ADR-0005") or partial match
+ */
+export declare function readProjectAdr(projectId: string, adrId: string): Promise<Record<string, unknown> | null>;
+//# sourceMappingURL=architectAdrs.d.ts.map

package/dist/architectAdrs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"architectAdrs.d.ts","sourceRoot":"","sources":["../src/architectAdrs.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,YAAY,CAAC;AAE9E,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAiFD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,CA2D1E;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IACtE,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC,CAqBF;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAazC"}

package/dist/architectAdrs.js

@@ -0,0 +1,162 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+import { log } from './config.js';
+import { getWritePath, getAllReadPaths, readFilesFromBothPaths } from './decibelPaths.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const ADRS_SUBPATH = 'architect/adrs';
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Slugify a title for use in filename
+ */
+function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '')
+        .substring(0, 50);
+}
+/**
+ * Extract numeric suffix from ADR ID (e.g., "ADR-0007" -> 7)
+ */
+function extractAdrNumber(id) {
+    const match = id.match(/^ADR-(\d+)$/i);
+    return match ? parseInt(match[1], 10) : 0;
+}
+/**
+ * Format ADR ID with zero-padding
+ */
+function formatAdrId(num) {
+    return `ADR-${num.toString().padStart(4, '0')}`;
+}
+/**
+ * Ensure directory exists
+ */
+async function ensureDir(dirPath) {
+    try {
+        await fs.mkdir(dirPath, { recursive: true });
+    }
+    catch {
+        // Directory already exists or other error
+    }
+}
+/**
+ * Get the next ADR number by scanning existing files in both paths
+ */
+async function getNextAdrNumber(projectId) {
+    let maxNum = 0;
+    // Check both .decibel/ and decibel/ paths
+    const readPaths = await getAllReadPaths(projectId, ADRS_SUBPATH);
+    for (const adrsDir of readPaths) {
+        try {
+            const files = await fs.readdir(adrsDir);
+            for (const file of files) {
+                if (!file.endsWith('.yml') && !file.endsWith('.yaml'))
+                    continue;
+                const match = file.match(/^ADR-(\d+)/i);
+                if (match) {
+                    const num = parseInt(match[1], 10);
+                    if (num > maxNum)
+                        maxNum = num;
+                }
+            }
+        }
+        catch {
+            // Directory doesn't exist, continue
+        }
+    }
+    return maxNum + 1;
+}
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Create a new project-level ADR
+ */
+export async function createProjectAdr(input) {
+    const { projectId, title, context, decision, consequences, relatedIssues, relatedEpics, } = input;
+    // Always write to .decibel/ (primary path)
+    const adrsDir = await getWritePath(projectId, ADRS_SUBPATH);
+    await ensureDir(adrsDir);
+    // Get next ADR number (checks both paths to avoid ID conflicts)
+    const nextNum = await getNextAdrNumber(projectId);
+    const id = formatAdrId(nextNum);
+    // Build filename
+    const slug = slugify(title);
+    const filename = `${id}-${slug}.yml`;
+    const filePath = path.join(adrsDir, filename);
+    // Build YAML content
+    const now = new Date().toISOString();
+    const yamlObj = {
+        id,
+        scope: 'project',
+        project: projectId,
+        title,
+        status: 'accepted',
+        created_at: now,
+        updated_at: now,
+        context,
+        decision,
+        consequences,
+    };
+    if (relatedIssues && relatedIssues.length > 0) {
+        yamlObj.related_issues = relatedIssues;
+    }
+    if (relatedEpics && relatedEpics.length > 0) {
+        yamlObj.related_epics = relatedEpics;
+    }
+    const yamlContent = stringifyYaml(yamlObj, {
+        lineWidth: 0, // Don't wrap lines
+    });
+    // Write file
+    await fs.writeFile(filePath, yamlContent, 'utf-8');
+    log(`architectAdrs: Created ADR at ${filePath}`);
+    return {
+        id,
+        path: filePath,
+    };
+}
+/**
+ * List ADRs for a project (ID + title + status)
+ */
+export async function listProjectAdrs(projectId) {
+    const files = await readFilesFromBothPaths(projectId, ADRS_SUBPATH, ['.yml', '.yaml']);
+    const adrs = [];
+    for (const { filePath } of files) {
+        try {
+            const content = await fs.readFile(filePath, 'utf-8');
+            const parsed = parseYaml(content);
+            adrs.push({
+                id: parsed.id ?? path.basename(filePath, path.extname(filePath)),
+                title: parsed.title ?? '(untitled)',
+                status: parsed.status ?? 'unknown',
+                filename: path.basename(filePath),
+            });
+        }
+        catch {
+            // Skip unparseable files
+        }
+    }
+    adrs.sort((a, b) => extractAdrNumber(a.id) - extractAdrNumber(b.id));
+    return adrs;
+}
+/**
+ * Read a single ADR by ID (e.g., "ADR-0005") or partial match
+ */
+export async function readProjectAdr(projectId, adrId) {
+    const files = await readFilesFromBothPaths(projectId, ADRS_SUBPATH, ['.yml', '.yaml']);
+    const normalizedId = adrId.toUpperCase();
+    for (const { filePath } of files) {
+        const basename = path.basename(filePath).toUpperCase();
+        if (basename.startsWith(normalizedId)) {
+            const content = await fs.readFile(filePath, 'utf-8');
+            return parseYaml(content);
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=architectAdrs.js.map

package/dist/architectAdrs.js.map

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

package/dist/client/facade-client.d.ts

@@ -0,0 +1,41 @@
+import { EventEmitter } from 'events';
+import type { FacadeClientConfig, BatchCall, BatchResult } from './types.js';
+export declare class FacadeClient {
+    private transport;
+    private config;
+    private connecting;
+    private log;
+    readonly events: EventEmitter<[never]>;
+    constructor(config: FacadeClientConfig);
+    /**
+     * Connect to the MCP server. Also called lazily on first call().
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect and clean up the child process / connection.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Call a facade action.
+     *
+     * @example
+     *   const epics = await client.call('sentinel', 'list_epics');
+     *   const issue = await client.call('sentinel', 'create_issue', { title: 'Fix login' });
+     */
+    call<T = unknown>(facade: string, action: string, params?: Record<string, unknown>): Promise<T>;
+    /**
+     * Batch multiple facade calls (max 20, parallel execution).
+     *
+     * For HTTP transport, uses the daemon's /batch endpoint directly.
+     * For stdio transport, runs calls in parallel via Promise.all.
+     */
+    batch(calls: BatchCall[]): Promise<BatchResult[]>;
+    /** Whether the client is currently connected */
+    get isConnected(): boolean;
+    /** Current transport mode for diagnostics */
+    get mode(): string;
+    private doConnect;
+    /** Get the HTTP transport if we're using one (for native /batch) */
+    private getHttpTransport;
+}
+//# sourceMappingURL=facade-client.d.ts.map

package/dist/client/facade-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facade-client.d.ts","sourceRoot":"","sources":["../../src/client/facade-client.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAU7E,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,UAAU,CAA8B;IAChD,OAAO,CAAC,GAAG,CAAwB;IAEnC,QAAQ,CAAC,MAAM,wBAAsB;gBAEzB,MAAM,EAAE,kBAAkB;IAYtC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAc9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC;;;;;;OAMG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC;IAyDb;;;;;OAKG;IACG,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAsEvD,gDAAgD;IAChD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,6CAA6C;IAC7C,IAAI,IAAI,IAAI,MAAM,CAOjB;YAMa,SAAS;IAmCvB,oEAAoE;IACpE,OAAO,CAAC,gBAAgB;CASzB"}