@decibelsystems/tools 2.0.0

package/dist/projectRegistry.js

@@ -0,0 +1,374 @@
+// ============================================================================
+// Project Registry
+// ============================================================================
+// Maps project IDs/aliases to their filesystem paths.
+// Supports multiple resolution strategies:
+//   1. Registry file (~/.decibel/projects.json or DECIBEL_REGISTRY_PATH)
+//   2. Environment variable (DECIBEL_PROJECT_ROOT for single project)
+//   3. Dynamic discovery (walking up from cwd)
+// ============================================================================
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+import { log } from './config.js';
+// ES module equivalent of __dirname
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// ============================================================================
+// Registry Loading
+// ============================================================================
+/**
+ * Get the path to the registry file.
+ * Default: projects.json in the same directory as this MCP tool.
+ */
+function getRegistryPath() {
+    if (process.env.DECIBEL_REGISTRY_PATH) {
+        return process.env.DECIBEL_REGISTRY_PATH;
+    }
+    // Default: projects.json in the MCP repo root (sibling to src/)
+    // __dirname at runtime is dist/, so go up one level
+    const mcpRoot = path.resolve(__dirname, '..');
+    return path.join(mcpRoot, 'projects.json');
+}
+/**
+ * Load the project registry from disk
+ */
+function loadRegistry() {
+    const registryPath = getRegistryPath();
+    if (!fs.existsSync(registryPath)) {
+        log(`ProjectRegistry: No registry file at ${registryPath}`);
+        return { version: 1, projects: [] };
+    }
+    try {
+        const content = fs.readFileSync(registryPath, 'utf-8');
+        const data = JSON.parse(content);
+        log(`ProjectRegistry: Loaded ${data.projects.length} projects from ${registryPath}`);
+        return data;
+    }
+    catch (err) {
+        log(`ProjectRegistry: Failed to load registry: ${err}`);
+        return { version: 1, projects: [] };
+    }
+}
+/**
+ * Save the project registry to disk
+ */
+function saveRegistry(registry) {
+    const registryPath = getRegistryPath();
+    const dir = path.dirname(registryPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(registryPath, JSON.stringify(registry, null, 2));
+    log(`ProjectRegistry: Saved ${registry.projects.length} projects to ${registryPath}`);
+}
+// ============================================================================
+// Discovery Helpers
+// ============================================================================
+/**
+ * Walk up directory tree looking for a .decibel folder
+ */
+function findDecibelDir(start) {
+    let current = path.resolve(start);
+    while (true) {
+        const candidate = path.join(current, '.decibel');
+        if (fs.existsSync(candidate) && fs.statSync(candidate).isDirectory()) {
+            return current; // Return the project root, not the .decibel folder
+        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    return undefined;
+}
+/**
+ * Validate that a path contains a .decibel folder
+ */
+function hasDecibelFolder(projectPath) {
+    const decibelPath = path.join(projectPath, '.decibel');
+    return fs.existsSync(decibelPath) && fs.statSync(decibelPath).isDirectory();
+}
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Resolve a project ID or alias to its filesystem path.
+ *
+ * Resolution order:
+ * 1. Check registry for exact ID match
+ * 2. Check registry for alias match
+ * 3. Check DECIBEL_PROJECT_ROOT env var (if ID matches basename)
+ * 4. Check if ID is an absolute path with .decibel
+ * 5. Walk up from cwd looking for .decibel (if ID matches discovered project)
+ *
+ * @param projectId - Project ID, alias, or path
+ * @returns Absolute path to the project root
+ * @throws Error if project cannot be resolved
+ */
+export function resolveProject(projectId) {
+    const registry = loadRegistry();
+    // Strategy 1: Exact ID match in registry
+    const exactMatch = registry.projects.find((p) => p.id === projectId);
+    if (exactMatch) {
+        if (!hasDecibelFolder(exactMatch.path)) {
+            throw new Error(`Project "${projectId}" registered at ${exactMatch.path} but .decibel folder not found. ` +
+                `Update the registry or run 'decibel init' in that directory.`);
+        }
+        log(`ProjectRegistry: Resolved "${projectId}" via exact ID match`);
+        return exactMatch;
+    }
+    // Strategy 2: Alias match in registry
+    const aliasMatch = registry.projects.find((p) => p.aliases?.includes(projectId));
+    if (aliasMatch) {
+        if (!hasDecibelFolder(aliasMatch.path)) {
+            throw new Error(`Project "${projectId}" (alias for "${aliasMatch.id}") registered at ${aliasMatch.path} ` +
+                `but .decibel folder not found.`);
+        }
+        log(`ProjectRegistry: Resolved "${projectId}" via alias -> "${aliasMatch.id}"`);
+        return aliasMatch;
+    }
+    // Strategy 3: DECIBEL_PROJECT_ROOT env var
+    const envRoot = process.env.DECIBEL_PROJECT_ROOT;
+    if (envRoot && path.basename(envRoot) === projectId) {
+        if (hasDecibelFolder(envRoot)) {
+            log(`ProjectRegistry: Resolved "${projectId}" via DECIBEL_PROJECT_ROOT`);
+            return { id: projectId, path: envRoot };
+        }
+    }
+    // Strategy 4: Absolute path with .decibel
+    if (path.isAbsolute(projectId) && hasDecibelFolder(projectId)) {
+        log(`ProjectRegistry: Resolved "${projectId}" as absolute path`);
+        return { id: path.basename(projectId), path: projectId };
+    }
+    // Strategy 5: Discover from cwd (exact basename match)
+    const discoveredRoot = findDecibelDir(process.cwd());
+    if (discoveredRoot && path.basename(discoveredRoot) === projectId) {
+        log(`ProjectRegistry: Resolved "${projectId}" via cwd discovery`);
+        return { id: projectId, path: discoveredRoot };
+    }
+    // Strategy 6: If DECIBEL_PROJECT_ROOT is set and has .decibel, use it as fallback
+    // This allows tests and scripts to set a project root and use any projectId as a label
+    if (envRoot && hasDecibelFolder(envRoot)) {
+        log(`ProjectRegistry: Resolved "${projectId}" via DECIBEL_PROJECT_ROOT fallback (treating as label)`);
+        return { id: projectId, path: envRoot };
+    }
+    // Strategy 7: If we discovered a project from cwd but ID didn't match, use it anyway
+    // This prevents hard failures when Claude sends a slightly wrong project ID
+    if (discoveredRoot) {
+        const discoveredId = path.basename(discoveredRoot);
+        log(`ProjectRegistry: Resolved "${projectId}" via cwd fallback (actual project: "${discoveredId}")`);
+        return { id: discoveredId, path: discoveredRoot };
+    }
+    // Build helpful error message
+    const registeredIds = registry.projects.map((p) => p.id);
+    const allAliases = registry.projects.flatMap((p) => p.aliases || []);
+    const suggestions = [...registeredIds, ...allAliases].filter(Boolean);
+    let errorMsg = `PROJECT_NOT_FOUND: "${projectId}".`;
+    if (suggestions.length > 0) {
+        errorMsg += ` Registered projects: ${suggestions.join(', ')}.`;
+    }
+    errorMsg += ` To fix: use the project_init tool with the absolute path to your project, or registry_add if .decibel/ already exists.`;
+    throw new Error(errorMsg);
+}
+/**
+ * List all registered projects
+ */
+export function listProjects() {
+    const registry = loadRegistry();
+    return registry.projects;
+}
+/**
+ * Register a new project or update an existing one
+ */
+export function registerProject(entry) {
+    const registry = loadRegistry();
+    // Validate path exists and has .decibel
+    if (!fs.existsSync(entry.path)) {
+        throw new Error(`Path does not exist: ${entry.path}`);
+    }
+    if (!hasDecibelFolder(entry.path)) {
+        throw new Error(`No .decibel folder found at ${entry.path}. ` +
+            `Initialize with 'decibel init' first.`);
+    }
+    // Normalize path
+    entry.path = path.resolve(entry.path);
+    // Check for duplicate ID
+    const existingIdx = registry.projects.findIndex((p) => p.id === entry.id);
+    if (existingIdx >= 0) {
+        // Update existing
+        registry.projects[existingIdx] = entry;
+        log(`ProjectRegistry: Updated project "${entry.id}"`);
+    }
+    else {
+        // Add new
+        registry.projects.push(entry);
+        log(`ProjectRegistry: Added project "${entry.id}"`);
+    }
+    saveRegistry(registry);
+}
+/**
+ * Remove a project from the registry
+ */
+export function unregisterProject(projectId) {
+    const registry = loadRegistry();
+    const beforeCount = registry.projects.length;
+    registry.projects = registry.projects.filter((p) => p.id !== projectId);
+    if (registry.projects.length < beforeCount) {
+        saveRegistry(registry);
+        log(`ProjectRegistry: Removed project "${projectId}"`);
+        return true;
+    }
+    return false;
+}
+/**
+ * Add an alias to an existing project
+ */
+export function addProjectAlias(projectId, alias) {
+    const registry = loadRegistry();
+    const project = registry.projects.find((p) => p.id === projectId);
+    if (!project) {
+        throw new Error(`Project not found: ${projectId}`);
+    }
+    project.aliases = project.aliases || [];
+    if (!project.aliases.includes(alias)) {
+        project.aliases.push(alias);
+        saveRegistry(registry);
+        log(`ProjectRegistry: Added alias "${alias}" to project "${projectId}"`);
+    }
+}
+/**
+ * Get the registry file path (for display/debugging)
+ */
+export function getRegistryFilePath() {
+    return getRegistryPath();
+}
+/**
+ * Get the default project.
+ * Resolution order:
+ * 1. Project explicitly marked as default
+ * 2. DECIBEL_DEFAULT_PROJECT env var
+ * 3. If only one project registered, use it
+ * 4. Discover from cwd
+ *
+ * @returns The default project entry or undefined if none can be determined
+ */
+export function getDefaultProject() {
+    const registry = loadRegistry();
+    // Strategy 1: Explicitly marked default
+    const explicitDefault = registry.projects.find((p) => p.default === true);
+    if (explicitDefault && hasDecibelFolder(explicitDefault.path)) {
+        log(`ProjectRegistry: Using explicit default project "${explicitDefault.id}"`);
+        return explicitDefault;
+    }
+    // Strategy 2: DECIBEL_DEFAULT_PROJECT env var
+    const envDefault = process.env.DECIBEL_DEFAULT_PROJECT;
+    if (envDefault) {
+        const envMatch = registry.projects.find((p) => p.id === envDefault || p.aliases?.includes(envDefault));
+        if (envMatch && hasDecibelFolder(envMatch.path)) {
+            log(`ProjectRegistry: Using DECIBEL_DEFAULT_PROJECT "${envMatch.id}"`);
+            return envMatch;
+        }
+    }
+    // Strategy 3: If only one project, use it
+    const validProjects = registry.projects.filter((p) => hasDecibelFolder(p.path));
+    if (validProjects.length === 1) {
+        log(`ProjectRegistry: Using only registered project "${validProjects[0].id}" as default`);
+        return validProjects[0];
+    }
+    // Strategy 4: Discover from cwd
+    const discoveredRoot = findDecibelDir(process.cwd());
+    if (discoveredRoot) {
+        const discoveredId = path.basename(discoveredRoot);
+        // Check if it matches a registered project
+        const registeredMatch = registry.projects.find((p) => p.id === discoveredId);
+        if (registeredMatch) {
+            log(`ProjectRegistry: Using cwd-discovered project "${registeredMatch.id}" as default`);
+            return registeredMatch;
+        }
+        // Return an ad-hoc entry for the discovered project
+        log(`ProjectRegistry: Using cwd-discovered unregistered project "${discoveredId}" as default`);
+        return { id: discoveredId, path: discoveredRoot };
+    }
+    log(`ProjectRegistry: No default project could be determined`);
+    return undefined;
+}
+/**
+ * Set a project as the default
+ */
+export function setDefaultProject(projectId) {
+    const registry = loadRegistry();
+    const project = registry.projects.find((p) => p.id === projectId);
+    if (!project) {
+        throw new Error(`Project not found: ${projectId}`);
+    }
+    // Clear existing defaults
+    for (const p of registry.projects) {
+        p.default = false;
+    }
+    // Set new default
+    project.default = true;
+    saveRegistry(registry);
+    log(`ProjectRegistry: Set "${projectId}" as default project`);
+}
+// ============================================================================
+// Input Normalization Helpers
+// ============================================================================
+/**
+ * Normalize projectId from various input formats.
+ * Handles both camelCase (projectId) and snake_case (project_id).
+ * This allows tools to accept inputs from Claude regardless of which format it uses.
+ */
+export function normalizeProjectId(input) {
+    return input.projectId || input.project_id;
+}
+/**
+ * Resolve project and return useful paths.
+ * This is the primary helper for tools to get project paths.
+ *
+ * @param projectId - Project ID, alias, or path (optional, uses default if not provided)
+ * @returns Resolved project paths
+ * @throws Error if project cannot be resolved
+ */
+export function resolveProjectPaths(projectId) {
+    let project;
+    if (projectId) {
+        project = resolveProject(projectId);
+    }
+    else {
+        const defaultProject = getDefaultProject();
+        if (!defaultProject) {
+            const registry = loadRegistry();
+            const registered = registry.projects.map(p => p.id);
+            let msg = 'No project specified and no default project found.';
+            if (registered.length > 0) {
+                msg += ` Registered projects: ${registered.join(', ')}. Pass one as project_id.`;
+            }
+            else {
+                msg += ` No projects registered. Use the project_init tool to initialize a project, or registry_add to register an existing .decibel/ directory.`;
+            }
+            throw new Error(msg);
+        }
+        project = defaultProject;
+    }
+    const decibelPath = path.join(project.path, '.decibel');
+    return {
+        id: project.id,
+        projectPath: project.path,
+        decibelPath,
+        subPath: (...segments) => path.join(decibelPath, ...segments),
+    };
+}
+/**
+ * Validate that a write path is within the project's .decibel folder.
+ * Call this before any file write to prevent escaping project boundaries.
+ */
+export function validateWritePath(targetPath, resolved) {
+    const normalized = path.normalize(targetPath);
+    if (!normalized.startsWith(resolved.decibelPath)) {
+        throw new Error(`SECURITY: Write path ${targetPath} is outside project .decibel folder. ` +
+            `Expected path under: ${resolved.decibelPath}`);
+    }
+}
+//# sourceMappingURL=projectRegistry.js.map

package/dist/projectRegistry.js.map

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

package/dist/sentinelIssues.d.ts

@@ -0,0 +1,65 @@
+export type IssueStatus = 'open' | 'in_progress' | 'done' | 'blocked';
+export type IssuePriority = 'low' | 'medium' | 'high';
+export interface SentinelIssue {
+    id: string;
+    title: string;
+    project: string;
+    status: IssueStatus;
+    priority?: IssuePriority;
+    epicId?: string;
+    tags?: string[];
+    created_at?: string;
+    updated_at?: string;
+    description?: string;
+    [key: string]: unknown;
+}
+export interface CreateIssueInput {
+    projectId: string;
+    title: string;
+    description?: string;
+    epicId?: string;
+    priority?: IssuePriority;
+    tags?: string[];
+}
+export interface CreateIssueOutput extends SentinelIssue {
+    filePath: string;
+}
+/**
+ * List all issues for a project
+ * Reads from both .decibel/ and decibel/ paths, deduping by filename
+ */
+export declare function listIssuesForProject(projectId: string): Promise<SentinelIssue[]>;
+/**
+ * Create a new issue for a project
+ */
+export declare function createIssue(input: CreateIssueInput): Promise<CreateIssueOutput>;
+/**
+ * Get a single issue by ID (e.g., "ISS-0005") with full content
+ */
+export declare function getIssueById(projectId: string, issueId: string): Promise<SentinelIssue | null>;
+export interface UpdateIssueInput {
+    projectId: string;
+    issueId: string;
+    status?: IssueStatus;
+    priority?: IssuePriority;
+    tags?: string[];
+    note?: string;
+}
+export interface UpdateIssueOutput extends SentinelIssue {
+    filePath: string;
+    changes: string[];
+}
+/**
+ * Update an existing issue — status, priority, tags, and/or append a note.
+ * Reads the YAML file, applies changes, writes back.
+ */
+export declare function updateIssue(input: UpdateIssueInput): Promise<UpdateIssueOutput>;
+/**
+ * Filter issues by status
+ */
+export declare function filterByStatus(issues: SentinelIssue[], status: IssueStatus): SentinelIssue[];
+/**
+ * Filter issues by epic ID
+ */
+export declare function filterByEpicId(issues: SentinelIssue[], epicId: string): SentinelIssue[];
+//# sourceMappingURL=sentinelIssues.d.ts.map

package/dist/sentinelIssues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentinelIssues.d.ts","sourceRoot":"","sources":["../src/sentinelIssues.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,aAAa,GAAG,MAAM,GAAG,SAAS,CAAC;AACtE,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEtD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAoFD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,EAAE,CAAC,CAgE1B;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,iBAAiB,CAAC,CA4E5B;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAI/B;AAMD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAqF5B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,aAAa,EAAE,EACvB,MAAM,EAAE,WAAW,GAClB,aAAa,EAAE,CAEjB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,aAAa,EAAE,EACvB,MAAM,EAAE,MAAM,GACb,aAAa,EAAE,CAEjB"}