decibel-tools-mcp 1.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,19 @@
+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>;
+//# 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"}

package/dist/architectAdrs.js

@@ -0,0 +1,123 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { stringify as stringifyYaml } from 'yaml';
+import { log } from './config.js';
+import { getWritePath, getAllReadPaths } 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,
+    };
+}
+//# 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/config.d.ts

@@ -0,0 +1,8 @@
+export interface Config {
+    env: string;
+    org: string;
+    rootDir: string;
+}
+export declare function getConfig(): Config;
+export declare function log(message: string, ...args: unknown[]): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,SAAS,IAAI,MAAM,CAQlC;AAED,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAK7D"}

package/dist/config.js

@@ -0,0 +1,19 @@
+import path from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+export function getConfig() {
+    const projectRoot = path.resolve(__dirname, '..');
+    return {
+        env: process.env.DECIBEL_ENV || 'dev',
+        org: process.env.DECIBEL_ORG || 'mediareason',
+        rootDir: process.env.DECIBEL_MCP_ROOT || path.join(projectRoot, 'data'),
+    };
+}
+export function log(message, ...args) {
+    const config = getConfig();
+    if (config.env === 'dev') {
+        console.error(`[decibel-mcp] ${message}`, ...args);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAQ3C,MAAM,UAAU,SAAS;IACvB,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAElD,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,KAAK;QACrC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,aAAa;QAC7C,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC;KACxE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,GAAG,IAAe;IACrD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,IAAI,MAAM,CAAC,GAAG,KAAK,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,KAAK,CAAC,iBAAiB,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IACrD,CAAC;AACH,CAAC"}

package/dist/dataRoot.d.ts

@@ -0,0 +1,45 @@
+export type DataDomain = 'sentinel-issues' | 'sentinel-epics' | 'architect-project' | 'architect-global' | 'designer-project' | 'designer-global' | 'friction-global' | 'learnings-project' | 'learnings-global';
+export interface ResolvePathOptions {
+    /**
+     * If true (default), throws an error when a project-local domain
+     * cannot resolve to a .decibel/ folder. Set to false to allow
+     * fallback to global paths (legacy behavior).
+     */
+    requireProject?: boolean;
+}
+/**
+ * Resolve the appropriate data path for a given domain.
+ *
+ * Project-local domains (use .decibel/ if available):
+ * - sentinel-issues, sentinel-epics
+ * - architect-project, designer-project, learnings-project
+ *
+ * Global domains (always use DECIBEL_MCP_ROOT or ~/.decibel):
+ * - architect-global, designer-global, learnings-global
+ * - friction-global
+ *
+ * @param domain - The data domain to resolve
+ * @param projectHint - Optional project path hint
+ * @param options - Resolution options
+ * @param options.requireProject - If true (default), throws error when project-local
+ *   domain cannot be resolved to a .decibel/ folder. Set to false for legacy fallback.
+ */
+export declare function resolvePath(domain: DataDomain, projectHint?: string, options?: ResolvePathOptions): string;
+/**
+ * Check if project-local .decibel/ exists
+ */
+export declare function hasProjectLocal(projectHint?: string): boolean;
+/**
+ * Get current project name (from .decibel/ location or env)
+ * Returns undefined if no project can be resolved
+ */
+export declare function getProjectName(projectHint?: string): string | undefined;
+/**
+ * Initialize .decibel/ structure in a project directory
+ */
+export declare function initProjectDecibel(projectRoot: string): void;
+/**
+ * Ensure a directory exists before writing
+ */
+export declare function ensureDir(dirPath: string): void;
+//# sourceMappingURL=dataRoot.d.ts.map

package/dist/dataRoot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataRoot.d.ts","sourceRoot":"","sources":["../src/dataRoot.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,UAAU,GAClB,iBAAiB,GACjB,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,GAClB,iBAAiB,GACjB,iBAAiB,GACjB,mBAAmB,GACnB,kBAAkB,CAAC;AAiBvB,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AA6ED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,UAAU,EAClB,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,MAAM,CAmER;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAG7D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGvE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CA2B5D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI/C"}

package/dist/dataRoot.js

@@ -0,0 +1,201 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { log } from './config.js';
+/** Domains that require a project-local .decibel/ folder */
+const PROJECT_LOCAL_DOMAINS = [
+    'sentinel-issues',
+    'sentinel-epics',
+    'architect-project',
+    'designer-project',
+    'learnings-project',
+];
+// ============================================================================
+// Path Resolution
+// ============================================================================
+/**
+ * Walk up directory tree looking for a .decibel folder
+ */
+function findUpDir(start, target) {
+    let current = path.resolve(start);
+    while (true) {
+        const candidate = path.join(current, target);
+        if (fs.existsSync(candidate) && fs.statSync(candidate).isDirectory()) {
+            return candidate;
+        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    return undefined;
+}
+/**
+ * Infer project name from the directory containing .decibel/
+ */
+function inferProjectName(decibelRoot) {
+    // .decibel/ is inside project root, so go up one level
+    const projectDir = path.dirname(decibelRoot);
+    return path.basename(projectDir);
+}
+/**
+ * Get both project-local and global roots
+ */
+function getRoots(projectHint) {
+    const projectRoot = projectHint ||
+        process.env.DECIBEL_PROJECT_ROOT ||
+        process.cwd();
+    const projectDecibelRoot = findUpDir(projectRoot, '.decibel');
+    const globalRoot = process.env.DECIBEL_MCP_ROOT ||
+        path.join(os.homedir(), '.decibel');
+    // Ensure global root exists
+    if (!fs.existsSync(globalRoot)) {
+        fs.mkdirSync(globalRoot, { recursive: true });
+        log(`DataRoot: Created global root at ${globalRoot}`);
+    }
+    // Only set projectName if we have a valid source
+    const projectName = projectDecibelRoot
+        ? inferProjectName(projectDecibelRoot)
+        : process.env.DECIBEL_PROJECT_ID; // No fallback to 'unknown_project'
+    return { projectDecibelRoot, projectName, globalRoot };
+}
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Helper to throw a consistent project resolution error
+ */
+function throwProjectResolutionError(domain, projectHint) {
+    const hintInfo = projectHint ? ` (hint: ${projectHint})` : '';
+    throw new Error(`Cannot resolve project path for domain "${domain}"${hintInfo}. ` +
+        `No .decibel/ folder found. Either run from a project directory, ` +
+        `set DECIBEL_PROJECT_ROOT environment variable, or use resolveProject() ` +
+        `from projectRegistry.ts first.`);
+}
+/**
+ * Resolve the appropriate data path for a given domain.
+ *
+ * Project-local domains (use .decibel/ if available):
+ * - sentinel-issues, sentinel-epics
+ * - architect-project, designer-project, learnings-project
+ *
+ * Global domains (always use DECIBEL_MCP_ROOT or ~/.decibel):
+ * - architect-global, designer-global, learnings-global
+ * - friction-global
+ *
+ * @param domain - The data domain to resolve
+ * @param projectHint - Optional project path hint
+ * @param options - Resolution options
+ * @param options.requireProject - If true (default), throws error when project-local
+ *   domain cannot be resolved to a .decibel/ folder. Set to false for legacy fallback.
+ */
+export function resolvePath(domain, projectHint, options) {
+    const { projectDecibelRoot, projectName, globalRoot } = getRoots(projectHint);
+    const requireProject = options?.requireProject !== false; // Default true
+    switch (domain) {
+        // ========== Sentinel (project-local required) ==========
+        case 'sentinel-issues':
+            if (projectDecibelRoot) {
+                return path.join(projectDecibelRoot, 'sentinel', 'issues');
+            }
+            if (requireProject) {
+                throwProjectResolutionError(domain, projectHint);
+            }
+            return path.join(globalRoot, 'sentinel', projectName || 'unknown_project', 'issues');
+        case 'sentinel-epics':
+            if (projectDecibelRoot) {
+                return path.join(projectDecibelRoot, 'sentinel', 'epics');
+            }
+            if (requireProject) {
+                throwProjectResolutionError(domain, projectHint);
+            }
+            return path.join(globalRoot, 'sentinel', projectName || 'unknown_project', 'epics');
+        // ========== Architect ==========
+        case 'architect-project':
+            if (projectDecibelRoot) {
+                return path.join(projectDecibelRoot, 'architect', 'adrs');
+            }
+            if (requireProject) {
+                throwProjectResolutionError(domain, projectHint);
+            }
+            return path.join(globalRoot, 'architect', projectName || 'unknown_project');
+        case 'architect-global':
+            return path.join(globalRoot, 'architect', 'adrs');
+        // ========== Designer ==========
+        case 'designer-project':
+            if (projectDecibelRoot) {
+                return path.join(projectDecibelRoot, 'designer');
+            }
+            if (requireProject) {
+                throwProjectResolutionError(domain, projectHint);
+            }
+            return path.join(globalRoot, 'designer', projectName || 'unknown_project');
+        case 'designer-global':
+            return path.join(globalRoot, 'designer', 'global');
+        // ========== Learnings ==========
+        case 'learnings-project':
+            if (projectDecibelRoot) {
+                return path.join(projectDecibelRoot, 'learnings');
+            }
+            if (requireProject) {
+                throwProjectResolutionError(domain, projectHint);
+            }
+            return path.join(globalRoot, 'learnings', projectName || 'unknown_project');
+        case 'learnings-global':
+            return path.join(globalRoot, 'learnings', 'global');
+        // ========== Friction (always global) ==========
+        case 'friction-global':
+            return path.join(globalRoot, 'friction');
+    }
+}
+/**
+ * Check if project-local .decibel/ exists
+ */
+export function hasProjectLocal(projectHint) {
+    const { projectDecibelRoot } = getRoots(projectHint);
+    return !!projectDecibelRoot;
+}
+/**
+ * Get current project name (from .decibel/ location or env)
+ * Returns undefined if no project can be resolved
+ */
+export function getProjectName(projectHint) {
+    const { projectName } = getRoots(projectHint);
+    return projectName;
+}
+/**
+ * Initialize .decibel/ structure in a project directory
+ */
+export function initProjectDecibel(projectRoot) {
+    const decibelRoot = path.join(projectRoot, '.decibel');
+    const dirs = [
+        path.join(decibelRoot, 'sentinel', 'issues'),
+        path.join(decibelRoot, 'sentinel', 'epics'),
+        path.join(decibelRoot, 'architect', 'adrs'),
+        path.join(decibelRoot, 'designer'),
+        path.join(decibelRoot, 'learnings'),
+    ];
+    for (const dir of dirs) {
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+            log(`DataRoot: Created ${dir}`);
+        }
+    }
+    // Create a .gitkeep in each to ensure empty dirs are tracked
+    for (const dir of dirs) {
+        const gitkeep = path.join(dir, '.gitkeep');
+        if (!fs.existsSync(gitkeep)) {
+            fs.writeFileSync(gitkeep, '');
+        }
+    }
+    log(`DataRoot: Initialized .decibel/ in ${projectRoot}`);
+}
+/**
+ * Ensure a directory exists before writing
+ */
+export function ensureDir(dirPath) {
+    if (!fs.existsSync(dirPath)) {
+        fs.mkdirSync(dirPath, { recursive: true });
+    }
+}
+//# sourceMappingURL=dataRoot.js.map