maestro-flow 0.1.0

package/dist/tools/read-file.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Read File Tool - Single file precise reading with optional line pagination
+ *
+ * Features:
+ * - Read a single file with full content
+ * - Line-based pagination with offset/limit
+ * - Binary file detection
+ */
+import type { ToolSchema, CcwToolResult } from '../types/tool-schema.js';
+import { type ReadResult } from '../utils/file-reader.js';
+export declare const schema: ToolSchema;
+export declare function handler(params: Record<string, unknown>): Promise<CcwToolResult<ReadResult>>;
+//# sourceMappingURL=read-file.d.ts.map

package/dist/tools/read-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.d.ts","sourceRoot":"","sources":["../../src/tools/read-file.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAIzE,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,yBAAyB,CAAC;AAUjC,eAAO,MAAM,MAAM,EAAE,UA8BpB,CAAC;AAEF,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CA+CjG"}

package/dist/tools/read-file.js

@@ -0,0 +1,91 @@
+/**
+ * Read File Tool - Single file precise reading with optional line pagination
+ *
+ * Features:
+ * - Read a single file with full content
+ * - Line-based pagination with offset/limit
+ * - Binary file detection
+ */
+import { z } from 'zod';
+import { existsSync, statSync } from 'fs';
+import { relative } from 'path';
+import { validatePath, getProjectRoot } from '../utils/path-validator.js';
+import { MAX_CONTENT_LENGTH, readFileContent, } from '../utils/file-reader.js';
+const ParamsSchema = z.object({
+    path: z.string().describe('Single file path to read'),
+    offset: z.number().min(0).optional().describe('Line offset to start reading from (0-based)'),
+    limit: z.number().min(1).optional().describe('Number of lines to read'),
+});
+export const schema = {
+    name: 'read_file',
+    description: `Read a single file with optional line-based pagination.
+
+Usage:
+  read_file(path="file.ts")                        # Full content
+  read_file(path="file.ts", offset=100, limit=50)  # Lines 100-149 (0-based)
+
+Supports both absolute and relative paths. Relative paths are resolved from project root.
+Use offset/limit for large file pagination.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            path: {
+                type: 'string',
+                description: 'Single file path to read',
+            },
+            offset: {
+                type: 'number',
+                description: 'Line offset to start reading from (0-based)',
+                minimum: 0,
+            },
+            limit: {
+                type: 'number',
+                description: 'Number of lines to read',
+                minimum: 1,
+            },
+        },
+        required: ['path'],
+    },
+};
+export async function handler(params) {
+    const parsed = ParamsSchema.safeParse(params);
+    if (!parsed.success) {
+        return { success: false, error: `Invalid params: ${parsed.error.message}` };
+    }
+    const { path: filePath, offset, limit } = parsed.data;
+    const cwd = getProjectRoot();
+    const resolvedPath = await validatePath(filePath);
+    if (!existsSync(resolvedPath)) {
+        return { success: false, error: `File not found: ${filePath}` };
+    }
+    const stat = statSync(resolvedPath);
+    if (!stat.isFile()) {
+        return { success: false, error: `Not a file: ${filePath}. Use read_many_files for directories.` };
+    }
+    const { content, truncated, totalLines, lineRange } = readFileContent(resolvedPath, {
+        maxLength: MAX_CONTENT_LENGTH,
+        offset,
+        limit,
+    });
+    const entry = {
+        path: relative(cwd, resolvedPath) || filePath,
+        size: stat.size,
+        content,
+        truncated,
+        totalLines,
+        lineRange,
+    };
+    let message = `Read 1 file`;
+    if (lineRange) {
+        message += ` [lines ${lineRange.start}-${lineRange.end} of ${totalLines}]`;
+    }
+    return {
+        success: true,
+        result: {
+            files: [entry],
+            totalFiles: 1,
+            message,
+        },
+    };
+}
+//# sourceMappingURL=read-file.js.map

package/dist/tools/read-file.js.map

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

package/dist/tools/read-many-files.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Read Many Files Tool - Multi-file batch reading with directory traversal and content search
+ *
+ * Features:
+ * - Read multiple files at once
+ * - Read all files in a directory (with depth control)
+ * - Filter files by glob pattern
+ * - Content search with regex
+ * - Compact output format
+ */
+import type { ToolSchema, CcwToolResult } from '../types/tool-schema.js';
+import { type ReadResult } from '../utils/file-reader.js';
+export declare const schema: ToolSchema;
+export declare function handler(params: Record<string, unknown>): Promise<CcwToolResult<ReadResult>>;
+//# sourceMappingURL=read-many-files.d.ts.map

package/dist/tools/read-many-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-many-files.d.ts","sourceRoot":"","sources":["../../src/tools/read-many-files.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAIzE,OAAO,EASL,KAAK,UAAU,EAChB,MAAM,yBAAyB,CAAC;AAajC,eAAO,MAAM,MAAM,EAAE,UA+CpB,CAAC;AAEF,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CA0HjG"}

package/dist/tools/read-many-files.js

@@ -0,0 +1,187 @@
+/**
+ * Read Many Files Tool - Multi-file batch reading with directory traversal and content search
+ *
+ * Features:
+ * - Read multiple files at once
+ * - Read all files in a directory (with depth control)
+ * - Filter files by glob pattern
+ * - Content search with regex
+ * - Compact output format
+ */
+import { z } from 'zod';
+import { existsSync, statSync } from 'fs';
+import { relative } from 'path';
+import { validatePath, getProjectRoot } from '../utils/path-validator.js';
+import { MAX_CONTENT_LENGTH, MAX_FILES, MAX_TOTAL_CONTENT, collectFiles, matchesPattern, readFileContent, findMatches, } from '../utils/file-reader.js';
+const ParamsSchema = z.object({
+    paths: z.union([z.string(), z.array(z.string())]).describe('File path(s) or directory'),
+    pattern: z.string().optional().describe('Glob pattern to filter files (e.g., "*.ts", "**/*.js")'),
+    contentPattern: z.string().optional().describe('Regex to search within file content'),
+    maxDepth: z.number().default(3).describe('Max directory depth to traverse'),
+    includeContent: z.boolean().default(true).describe('Include file content in result'),
+    maxFiles: z.number().default(MAX_FILES).describe('Max number of files to return'),
+});
+export const schema = {
+    name: 'read_many_files',
+    description: `Read multiple files, directories, or search file content with regex.
+
+Usage:
+  read_many_files(paths=["a.ts", "b.ts"])                  # Multiple files
+  read_many_files(paths="src/", pattern="*.ts")             # Directory with glob filter
+  read_many_files(paths="src/", contentPattern="TODO")      # Search content with regex
+  read_many_files(paths="src/", pattern="*.ts", includeContent=false)  # List files only
+
+Supports both absolute and relative paths. Relative paths are resolved from project root.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            paths: {
+                oneOf: [
+                    { type: 'string', description: 'Single file or directory path' },
+                    { type: 'array', items: { type: 'string' }, description: 'Array of file paths' },
+                ],
+                description: 'File path(s) or directory to read',
+            },
+            pattern: {
+                type: 'string',
+                description: 'Glob pattern to filter files (e.g., "*.ts", "*.{js,ts}")',
+            },
+            contentPattern: {
+                type: 'string',
+                description: 'Regex pattern to search within file content',
+            },
+            maxDepth: {
+                type: 'number',
+                description: 'Max directory depth to traverse (default: 3)',
+                default: 3,
+            },
+            includeContent: {
+                type: 'boolean',
+                description: 'Include file content in result (default: true)',
+                default: true,
+            },
+            maxFiles: {
+                type: 'number',
+                description: `Max number of files to return (default: ${MAX_FILES})`,
+                default: MAX_FILES,
+            },
+        },
+        required: ['paths'],
+    },
+};
+export async function handler(params) {
+    const parsed = ParamsSchema.safeParse(params);
+    if (!parsed.success) {
+        return { success: false, error: `Invalid params: ${parsed.error.message}` };
+    }
+    const { paths, pattern, contentPattern, maxDepth, includeContent, maxFiles } = parsed.data;
+    const cwd = getProjectRoot();
+    // Normalize paths to array
+    let inputPaths;
+    if (Array.isArray(paths)) {
+        inputPaths = paths;
+    }
+    else if (typeof paths === 'string') {
+        const trimmed = paths.trim();
+        if (trimmed.startsWith('[') && trimmed.endsWith(']')) {
+            try {
+                const parsed = JSON.parse(trimmed);
+                if (Array.isArray(parsed)) {
+                    inputPaths = parsed;
+                }
+                else {
+                    inputPaths = [paths];
+                }
+            }
+            catch {
+                inputPaths = [paths];
+            }
+        }
+        else {
+            inputPaths = [paths];
+        }
+    }
+    else {
+        inputPaths = [String(paths)];
+    }
+    const allFiles = [];
+    for (const inputPath of inputPaths) {
+        const resolvedPath = await validatePath(inputPath);
+        if (!existsSync(resolvedPath)) {
+            continue;
+        }
+        const stat = statSync(resolvedPath);
+        if (stat.isDirectory()) {
+            const dirFiles = collectFiles(resolvedPath, pattern, maxDepth);
+            allFiles.push(...dirFiles);
+        }
+        else if (stat.isFile()) {
+            if (!pattern || matchesPattern(relative(cwd, resolvedPath), pattern)) {
+                allFiles.push(resolvedPath);
+            }
+        }
+    }
+    const limitedFiles = allFiles.slice(0, maxFiles);
+    const totalFiles = allFiles.length;
+    const files = [];
+    let totalContent = 0;
+    for (const filePath of limitedFiles) {
+        if (totalContent >= MAX_TOTAL_CONTENT)
+            break;
+        const stat = statSync(filePath);
+        const entry = {
+            path: relative(cwd, filePath) || filePath,
+            size: stat.size,
+        };
+        if (includeContent) {
+            const remainingSpace = MAX_TOTAL_CONTENT - totalContent;
+            const maxLen = Math.min(MAX_CONTENT_LENGTH, remainingSpace);
+            const { content, truncated, totalLines, lineRange } = readFileContent(filePath, { maxLength: maxLen });
+            if (contentPattern) {
+                const matches = findMatches(content, contentPattern);
+                if (matches === null) {
+                    entry.content = content;
+                    entry.truncated = truncated;
+                    entry.totalLines = totalLines;
+                    entry.lineRange = lineRange;
+                    totalContent += content.length;
+                }
+                else if (matches.length > 0) {
+                    entry.matches = matches;
+                    entry.content = content;
+                    entry.truncated = truncated;
+                    entry.totalLines = totalLines;
+                    entry.lineRange = lineRange;
+                    totalContent += content.length;
+                }
+                else {
+                    continue;
+                }
+            }
+            else {
+                entry.content = content;
+                entry.truncated = truncated;
+                entry.totalLines = totalLines;
+                entry.lineRange = lineRange;
+                totalContent += content.length;
+            }
+        }
+        files.push(entry);
+    }
+    let message = `Read ${files.length} file(s)`;
+    if (totalFiles > maxFiles) {
+        message += ` (showing ${maxFiles} of ${totalFiles})`;
+    }
+    if (contentPattern) {
+        message += ` matching "${contentPattern}"`;
+    }
+    return {
+        success: true,
+        result: {
+            files,
+            totalFiles,
+            message,
+        },
+    };
+}
+//# sourceMappingURL=read-many-files.js.map

package/dist/tools/read-many-files.js.map

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

package/dist/tools/spec-index-builder.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Spec Index Builder
+ *
+ * Scans .workflow/specs/*.md files, parses YAML frontmatter,
+ * and builds/caches index at .workflow/.spec-index/specs.index.json.
+ *
+ * Frontmatter Schema:
+ * ---
+ * title: "Document Title"
+ * readMode: required | optional
+ * priority: critical | high | medium | low
+ * category: general | exploration | planning | execution | debug | test | review | validation
+ * keywords: [auth, security]
+ * ---
+ */
+export declare const SPEC_CATEGORIES: readonly ["general", "exploration", "planning", "execution", "debug", "test", "review", "validation"];
+export type SpecCategory = typeof SPEC_CATEGORIES[number];
+export interface SpecFrontmatter {
+    title: string;
+    readMode: 'required' | 'optional';
+    priority: 'critical' | 'high' | 'medium' | 'low';
+    category: SpecCategory;
+    keywords: string[];
+}
+export interface SpecIndexEntry {
+    title: string;
+    file: string;
+    category: SpecCategory;
+    keywords: string[];
+    readMode: 'required' | 'optional';
+    priority: 'critical' | 'high' | 'medium' | 'low';
+    contentLength: number;
+}
+export interface SpecIndex {
+    entries: SpecIndexEntry[];
+    built_at: string;
+}
+/**
+ * Get the specs directory path.
+ */
+export declare function getSpecsDir(projectPath: string): string;
+/**
+ * Build the spec index by scanning .workflow/specs/*.md.
+ */
+export declare function buildSpecIndex(projectPath: string): SpecIndex;
+/**
+ * Read cached index from disk.
+ */
+export declare function readCachedIndex(projectPath: string): SpecIndex | null;
+/**
+ * Write index to cache file.
+ */
+export declare function writeIndexCache(projectPath: string, index: SpecIndex): void;
+/**
+ * Get spec index with cache-first strategy.
+ */
+export declare function getSpecIndex(projectPath: string, forceRebuild?: boolean): SpecIndex;
+//# sourceMappingURL=spec-index-builder.d.ts.map

package/dist/tools/spec-index-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-index-builder.d.ts","sourceRoot":"","sources":["../../src/tools/spec-index-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AASH,eAAO,MAAM,eAAe,uGAAwG,CAAC;AACrI,MAAM,MAAM,YAAY,GAAG,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;AAE1D,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,UAAU,GAAG,UAAU,CAAC;IAClC,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACjD,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,UAAU,GAAG,UAAU,CAAC;IAClC,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACjD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAgGD;;GAEG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAwB7D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAcrE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAM3E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,UAAQ,GAAG,SAAS,CASjF"}

package/dist/tools/spec-index-builder.js

@@ -0,0 +1,211 @@
+/**
+ * Spec Index Builder
+ *
+ * Scans .workflow/specs/*.md files, parses YAML frontmatter,
+ * and builds/caches index at .workflow/.spec-index/specs.index.json.
+ *
+ * Frontmatter Schema:
+ * ---
+ * title: "Document Title"
+ * readMode: required | optional
+ * priority: critical | high | medium | low
+ * category: general | exploration | planning | execution | debug | test | review | validation
+ * keywords: [auth, security]
+ * ---
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync } from 'node:fs';
+import { join, extname, basename, relative } from 'node:path';
+// ============================================================================
+// Types
+// ============================================================================
+export const SPEC_CATEGORIES = ['general', 'exploration', 'planning', 'execution', 'debug', 'test', 'review', 'validation'];
+// ============================================================================
+// Constants
+// ============================================================================
+const SPECS_DIR = '.workflow/specs';
+const INDEX_DIR = '.workflow/.spec-index';
+const INDEX_FILE = 'specs.index.json';
+const VALID_READ_MODES = ['required', 'optional'];
+const VALID_PRIORITIES = ['critical', 'high', 'medium', 'low'];
+/**
+ * Parse YAML frontmatter from markdown content.
+ * Handles simple key: value and key: [array] syntax.
+ */
+function parseFrontmatter(raw) {
+    const trimmed = raw.trimStart();
+    if (!trimmed.startsWith('---')) {
+        return { data: {}, content: raw };
+    }
+    const endIdx = trimmed.indexOf('\n---', 3);
+    if (endIdx === -1) {
+        return { data: {}, content: raw };
+    }
+    const yamlBlock = trimmed.substring(3, endIdx).trim();
+    const content = trimmed.substring(endIdx + 4).trim();
+    const data = {};
+    let currentKey = '';
+    let arrayItems = null;
+    for (const line of yamlBlock.split('\n')) {
+        const trimLine = line.trim();
+        // Array item: "  - value"
+        if (trimLine.startsWith('- ') && arrayItems !== null) {
+            arrayItems.push(trimLine.substring(2).trim());
+            continue;
+        }
+        // Flush previous array
+        if (arrayItems !== null && currentKey) {
+            data[currentKey] = arrayItems;
+            arrayItems = null;
+        }
+        // Key-value pair
+        const colonIdx = trimLine.indexOf(':');
+        if (colonIdx === -1)
+            continue;
+        const key = trimLine.substring(0, colonIdx).trim();
+        const value = trimLine.substring(colonIdx + 1).trim();
+        currentKey = key;
+        if (value === '' || value === '[]') {
+            // Array will follow on next lines, or empty array
+            arrayItems = [];
+        }
+        else if (value.startsWith('[') && value.endsWith(']')) {
+            // Inline array: [a, b, c]
+            data[key] = value
+                .slice(1, -1)
+                .split(',')
+                .map(s => s.trim().replace(/^["']|["']$/g, ''))
+                .filter(s => s.length > 0);
+        }
+        else {
+            // Scalar value — strip quotes
+            data[key] = value.replace(/^["']|["']$/g, '');
+        }
+    }
+    // Flush trailing array
+    if (arrayItems !== null && currentKey) {
+        data[currentKey] = arrayItems;
+    }
+    return { data, content };
+}
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Get the specs directory path.
+ */
+export function getSpecsDir(projectPath) {
+    return join(projectPath, SPECS_DIR);
+}
+/**
+ * Build the spec index by scanning .workflow/specs/*.md.
+ */
+export function buildSpecIndex(projectPath) {
+    const specsDir = getSpecsDir(projectPath);
+    const entries = [];
+    if (!existsSync(specsDir)) {
+        return { entries, built_at: new Date().toISOString() };
+    }
+    let files;
+    try {
+        files = readdirSync(specsDir).filter(f => extname(f).toLowerCase() === '.md');
+    }
+    catch {
+        return { entries, built_at: new Date().toISOString() };
+    }
+    for (const file of files) {
+        const filePath = join(specsDir, file);
+        const entry = parseSpecFile(filePath, projectPath);
+        if (entry) {
+            entries.push(entry);
+        }
+    }
+    return { entries, built_at: new Date().toISOString() };
+}
+/**
+ * Read cached index from disk.
+ */
+export function readCachedIndex(projectPath) {
+    const indexPath = join(projectPath, INDEX_DIR, INDEX_FILE);
+    if (!existsSync(indexPath))
+        return null;
+    try {
+        const content = readFileSync(indexPath, 'utf-8');
+        const parsed = JSON.parse(content);
+        if (parsed && Array.isArray(parsed.entries) && typeof parsed.built_at === 'string') {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write index to cache file.
+ */
+export function writeIndexCache(projectPath, index) {
+    const indexDir = join(projectPath, INDEX_DIR);
+    if (!existsSync(indexDir)) {
+        mkdirSync(indexDir, { recursive: true });
+    }
+    writeFileSync(join(indexDir, INDEX_FILE), JSON.stringify(index, null, 2), 'utf-8');
+}
+/**
+ * Get spec index with cache-first strategy.
+ */
+export function getSpecIndex(projectPath, forceRebuild = false) {
+    if (!forceRebuild) {
+        const cached = readCachedIndex(projectPath);
+        if (cached)
+            return cached;
+    }
+    const index = buildSpecIndex(projectPath);
+    writeIndexCache(projectPath, index);
+    return index;
+}
+// ============================================================================
+// Internal
+// ============================================================================
+function parseSpecFile(filePath, projectPath) {
+    let raw;
+    try {
+        raw = readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+    const { data, content } = parseFrontmatter(raw);
+    const title = typeof data.title === 'string' && data.title.trim()
+        ? data.title.trim()
+        : basename(filePath, extname(filePath));
+    const rawReadMode = typeof data.readMode === 'string' ? data.readMode : null;
+    const readMode = rawReadMode && VALID_READ_MODES.includes(rawReadMode)
+        ? rawReadMode
+        : 'optional';
+    const rawPriority = typeof data.priority === 'string' ? data.priority : null;
+    const priority = rawPriority && VALID_PRIORITIES.includes(rawPriority)
+        ? rawPriority
+        : 'medium';
+    const rawCategory = typeof data.category === 'string' ? data.category : null;
+    const category = rawCategory && SPEC_CATEGORIES.includes(rawCategory)
+        ? rawCategory
+        : 'general';
+    let keywords = [];
+    if (Array.isArray(data.keywords)) {
+        keywords = data.keywords.filter((k) => typeof k === 'string').map(s => s.trim()).filter(s => s.length > 0);
+    }
+    else if (typeof data.keywords === 'string') {
+        keywords = data.keywords.split(',').map(s => s.trim()).filter(s => s.length > 0);
+    }
+    const relPath = relative(projectPath, filePath).replace(/\\/g, '/');
+    return {
+        title,
+        file: relPath,
+        category,
+        keywords,
+        readMode,
+        priority,
+        contentLength: content.length,
+    };
+}
+//# sourceMappingURL=spec-index-builder.js.map

package/dist/tools/spec-index-builder.js.map

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

package/dist/tools/spec-init.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Spec Init
+ *
+ * Initialize .workflow/specs/ directory with frontmatter-enabled seed documents.
+ * Idempotent: skips existing files, only creates missing ones.
+ */
+export interface InitResult {
+    created: string[];
+    skipped: string[];
+    directories: string[];
+}
+/**
+ * Initialize the spec system directory structure and seed documents.
+ * Idempotent: creates directories if missing, writes seed files only when absent.
+ */
+export declare function initSpecSystem(projectPath: string): InitResult;
+//# sourceMappingURL=spec-init.d.ts.map

package/dist/tools/spec-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-init.d.ts","sourceRoot":"","sources":["../../src/tools/spec-init.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAwMD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CA0B9D"}