decibel-tools-mcp 1.0.0

package/dist/projectRegistry.js

@@ -0,0 +1,362 @@
+// ============================================================================
+// 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
+    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 };
+    }
+    // Build helpful error message with project_init hint
+    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(', ')}.`;
+    }
+    if (discoveredRoot) {
+        errorMsg += ` Current directory is in project "${path.basename(discoveredRoot)}".`;
+    }
+    errorMsg += ` HINT: Run project_init with the path to create and register a new 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) {
+            throw new Error('No project specified and no default project found. ' +
+                'Either specify projectId or register a project with the registry.');
+        }
+        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,44 @@
+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>;
+/**
+ * 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,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"}

package/dist/sentinelIssues.js

@@ -0,0 +1,213 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { parse as parseYaml, parseAllDocuments, stringify as stringifyYaml } from 'yaml';
+import { log } from './config.js';
+import { getWritePath, readFilesFromBothPaths } from './decibelPaths.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const ISSUES_SUBPATH = 'sentinel/issues';
+// ============================================================================
+// 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 issue ID (e.g., "ISS-0007" -> 7)
+ */
+function extractIssueNumber(id) {
+    const match = id.match(/^ISS-(\d+)$/i);
+    return match ? parseInt(match[1], 10) : 0;
+}
+/**
+ * Format issue ID with zero-padding
+ */
+function formatIssueId(num) {
+    return `ISS-${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
+    }
+}
+/**
+ * Safely parse YAML content that might contain multiple documents (frontmatter format).
+ * Returns the first document's contents, or throws if no valid document found.
+ */
+function safeParseYaml(content) {
+    // First, try simple parse (most common case)
+    try {
+        return parseYaml(content);
+    }
+    catch (err) {
+        // Check if error is about multiple documents
+        const message = err instanceof Error ? err.message : String(err);
+        if (!message.includes('multiple documents')) {
+            throw err;
+        }
+    }
+    // Handle multi-document YAML (frontmatter format with --- delimiters)
+    const docs = parseAllDocuments(content);
+    if (docs.length === 0) {
+        throw new Error('No YAML documents found');
+    }
+    // Return the first document (usually the frontmatter)
+    const firstDoc = docs[0].toJSON();
+    if (typeof firstDoc !== 'object' || firstDoc === null) {
+        throw new Error('First YAML document is not an object');
+    }
+    return firstDoc;
+}
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * List all issues for a project
+ * Reads from both .decibel/ and decibel/ paths, deduping by filename
+ */
+export async function listIssuesForProject(projectId) {
+    const issues = [];
+    const seenIds = new Set();
+    // Read from both .decibel/ and decibel/ paths
+    const files = await readFilesFromBothPaths(projectId, ISSUES_SUBPATH);
+    if (files.length === 0) {
+        log(`sentinelIssues: No issues found for project: ${projectId}`);
+        return [];
+    }
+    for (const { filePath, source } of files) {
+        try {
+            const content = await fs.readFile(filePath, 'utf-8');
+            const parsed = safeParseYaml(content);
+            // Validate required fields
+            const id = parsed.id;
+            const title = parsed.title;
+            if (!id || !title) {
+                log(`sentinelIssues: Skipping ${filePath} - missing id or title`);
+                continue;
+            }
+            // Skip duplicates (primary takes precedence)
+            if (seenIds.has(id)) {
+                log(`sentinelIssues: Skipping duplicate ${id} from ${source} path`);
+                continue;
+            }
+            seenIds.add(id);
+            const issue = {
+                id,
+                title,
+                project: parsed.project || projectId,
+                status: parsed.status || 'open',
+                priority: parsed.priority,
+                epicId: parsed.epic_id || parsed.epicId,
+                tags: parsed.tags,
+                created_at: parsed.created_at,
+                updated_at: parsed.updated_at,
+                description: parsed.description,
+            };
+            // Copy any extra fields
+            for (const key of Object.keys(parsed)) {
+                if (!(key in issue)) {
+                    issue[key] = parsed[key];
+                }
+            }
+            issues.push(issue);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            log(`sentinelIssues: Failed to parse ${filePath}: ${message}`);
+        }
+    }
+    // Sort by ID (newest first)
+    issues.sort((a, b) => extractIssueNumber(b.id) - extractIssueNumber(a.id));
+    return issues;
+}
+/**
+ * Create a new issue for a project
+ */
+export async function createIssue(input) {
+    const { projectId, title, description, epicId, priority, tags } = input;
+    // Always write to .decibel/ (primary path)
+    const issuesDir = await getWritePath(projectId, ISSUES_SUBPATH);
+    await ensureDir(issuesDir);
+    // Find next issue number
+    const existingIssues = await listIssuesForProject(projectId);
+    const maxNum = existingIssues.reduce((max, issue) => Math.max(max, extractIssueNumber(issue.id)), 0);
+    const newNum = maxNum + 1;
+    const newId = formatIssueId(newNum);
+    // Build filename
+    const slug = slugify(title);
+    const filename = `${newId}-${slug}.yml`;
+    const filePath = path.join(issuesDir, filename);
+    // Build issue object
+    const now = new Date().toISOString();
+    const issue = {
+        id: newId,
+        title,
+        project: projectId,
+        status: 'open',
+        priority: priority || 'medium',
+        tags: tags || [],
+        created_at: now,
+        updated_at: now,
+    };
+    if (epicId) {
+        issue.epicId = epicId;
+    }
+    if (description) {
+        issue.description = description;
+    }
+    // Build YAML content
+    // Use a specific field order for cleaner output
+    const yamlObj = {
+        id: issue.id,
+        title: issue.title,
+        project: issue.project,
+        status: issue.status,
+        priority: issue.priority,
+    };
+    if (epicId) {
+        yamlObj.epic_id = epicId;
+    }
+    yamlObj.tags = issue.tags;
+    yamlObj.created_at = issue.created_at;
+    yamlObj.updated_at = issue.updated_at;
+    if (description) {
+        yamlObj.description = description;
+    }
+    const yamlContent = stringifyYaml(yamlObj, {
+        lineWidth: 0, // Don't wrap lines
+    });
+    // Write file
+    await fs.writeFile(filePath, yamlContent, 'utf-8');
+    log(`sentinelIssues: Created issue at ${filePath}`);
+    return {
+        ...issue,
+        filePath,
+    };
+}
+/**
+ * Filter issues by status
+ */
+export function filterByStatus(issues, status) {
+    return issues.filter((issue) => issue.status === status);
+}
+/**
+ * Filter issues by epic ID
+ */
+export function filterByEpicId(issues, epicId) {
+    return issues.filter((issue) => issue.epicId === epicId);
+}
+//# sourceMappingURL=sentinelIssues.js.map

package/dist/sentinelIssues.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":""}