maestro-flow 0.3.23 → 0.3.25

package/dashboard/dist-server/src/config/paths.d.ts

@@ -6,6 +6,7 @@ export declare const paths: {
     readonly data: string;
     readonly logs: string;
     readonly cliHistory: string;
+    readonly skillConfig: string;
     readonly project: (root: string) => {
         root: string;
         workflow: string;

package/dashboard/dist-server/src/config/paths.js

@@ -10,6 +10,7 @@ export const paths = {
     data: join(MAESTRO_HOME, 'data'),
     logs: join(MAESTRO_HOME, 'logs'),
     cliHistory: join(MAESTRO_HOME, 'cli-history'),
+    skillConfig: join(MAESTRO_HOME, 'skill-config.json'),
     project(root) {
         return {
             root: resolve(root),

package/dashboard/dist-server/src/config/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../../src/config/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEhD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;AAE7E,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC;IACzC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC;IAClC,UAAU,EAAE,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC;IAC5C,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC;IAChC,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC;IAChC,UAAU,EAAE,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC;IAE7C,OAAO,CAAC,IAAY;QAClB,OAAO;YACL,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC;YACnB,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC;YACjC,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC;SACnC,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,GAAG,IAAc;QACtB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;IACH,CAAC;CACO,CAAC"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../../src/config/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEhD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;AAE7E,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC;IACzC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC;IAClC,UAAU,EAAE,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC;IAC5C,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC;IAChC,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC;IAChC,UAAU,EAAE,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC;IAC7C,WAAW,EAAE,IAAI,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAEpD,OAAO,CAAC,IAAY;QAClB,OAAO;YACL,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC;YACnB,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC;YACjC,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC;SACnC,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,GAAG,IAAc;QACtB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;IACH,CAAC;CACO,CAAC"}

package/dashboard/dist-server/src/tools/spec-entry-parser.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Spec Entry Parser
+ *
+ * Parses `<spec-entry>` closed-tag blocks from spec markdown files.
+ * Supports dual-format: new `<spec-entry>` tags + legacy heading-based entries.
+ */
+export interface SpecEntryParsed {
+    category: string;
+    keywords: string[];
+    date: string;
+    source?: string;
+    title: string;
+    content: string;
+    lineStart: number;
+    lineEnd: number;
+}
+export interface ParseResult {
+    entries: SpecEntryParsed[];
+    legacy: LegacyEntry[];
+    errors: ParseError[];
+}
+export interface LegacyEntry {
+    title: string;
+    content: string;
+    lineStart: number;
+}
+export interface ParseError {
+    line: number;
+    message: string;
+}
+export declare const VALID_CATEGORIES: readonly ["coding", "arch", "quality", "debug", "test", "review", "learning"];
+export type ValidCategory = (typeof VALID_CATEGORIES)[number];
+/**
+ * Parse spec file content into structured entries.
+ * Returns new-format `<spec-entry>` entries, legacy heading entries, and any errors.
+ */
+export declare function parseSpecEntries(content: string): ParseResult;
+/**
+ * Validate a single parsed entry. Returns array of error messages (empty = valid).
+ */
+export declare function validateSpecEntry(entry: SpecEntryParsed): string[];
+/**
+ * Validate that entry category matches the expected file category.
+ */
+export declare function validateCategoryMatch(entry: SpecEntryParsed, fileCategory: string): string | null;
+/**
+ * Format parsed entries for display output.
+ * Strips `<spec-entry>` tags, shows clean content.
+ * If keyword provided, highlights matched entries.
+ */
+export declare function formatSpecEntries(entries: SpecEntryParsed[], keyword?: string): string;
+/**
+ * Format a single entry for writing to a spec file.
+ */
+export declare function formatNewEntry(category: string, keywords: string[], date: string, title: string, content: string, source?: string): string;

package/dashboard/dist-server/src/tools/spec-entry-parser.js

@@ -0,0 +1,222 @@
+/**
+ * Spec Entry Parser
+ *
+ * Parses `<spec-entry>` closed-tag blocks from spec markdown files.
+ * Supports dual-format: new `<spec-entry>` tags + legacy heading-based entries.
+ */
+// ============================================================================
+// Valid categories (shared with spec-loader)
+// ============================================================================
+export const VALID_CATEGORIES = ['coding', 'arch', 'quality', 'debug', 'test', 'review', 'learning'];
+// ============================================================================
+// Core regex
+// ============================================================================
+/** Matches `<spec-entry ...attributes...>...content...</spec-entry>` across lines */
+const SPEC_ENTRY_RE = /<spec-entry\s+([^>]+)>([\s\S]*?)<\/spec-entry>/g;
+/** Extracts key="value" attribute pairs */
+const ATTR_RE = /([\w-]+)="([^"]*)"/g;
+/** Matches ### heading inside entry content */
+const HEADING_RE = /^###\s+(.+)$/m;
+/** Legacy format: ### [category] [date] title  OR  ### [date] type: title */
+const LEGACY_HEADING_RE = /^###\s+(?:\[[\w-]+\]\s+)?\[(\d{4}-\d{2}-\d{2}(?:\s[\d:]+)?)\]\s*(.+)$/;
+/** Date validation */
+const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+// ============================================================================
+// Parser
+// ============================================================================
+/**
+ * Parse spec file content into structured entries.
+ * Returns new-format `<spec-entry>` entries, legacy heading entries, and any errors.
+ */
+export function parseSpecEntries(content) {
+    const entries = [];
+    const errors = [];
+    // Track which character ranges are consumed by <spec-entry> blocks
+    const consumed = [];
+    // Pass 1: Extract <spec-entry> blocks
+    let match;
+    SPEC_ENTRY_RE.lastIndex = 0;
+    while ((match = SPEC_ENTRY_RE.exec(content)) !== null) {
+        const attrStr = match[1];
+        const body = match[2];
+        const blockStart = match.index;
+        const blockEnd = blockStart + match[0].length;
+        const lineStart = lineNumber(content, blockStart);
+        const lineEnd = lineNumber(content, blockEnd);
+        consumed.push({ start: blockStart, end: blockEnd });
+        // Parse attributes
+        const attrs = parseAttributes(attrStr);
+        // Extract title from first ### heading
+        const titleMatch = body.match(HEADING_RE);
+        const title = titleMatch ? titleMatch[1].trim() : '';
+        // Validate and build entry
+        const entry = {
+            category: attrs.category ?? '',
+            keywords: attrs.keywords ? attrs.keywords.split(',').map(k => k.trim().toLowerCase()).filter(Boolean) : [],
+            date: attrs.date ?? '',
+            source: attrs.source,
+            title,
+            content: body.trim(),
+            lineStart,
+            lineEnd,
+        };
+        entries.push(entry);
+        // Collect validation errors
+        const validationErrors = validateSpecEntry(entry);
+        for (const msg of validationErrors) {
+            errors.push({ line: lineStart, message: msg });
+        }
+    }
+    // Pass 2: Extract legacy entries from remaining text
+    const legacy = parseLegacyEntries(content, consumed);
+    return { entries, legacy, errors };
+}
+// ============================================================================
+// Validation
+// ============================================================================
+/**
+ * Validate a single parsed entry. Returns array of error messages (empty = valid).
+ */
+export function validateSpecEntry(entry) {
+    const errors = [];
+    if (!entry.category) {
+        errors.push('Missing required attribute: category');
+    }
+    else if (!VALID_CATEGORIES.includes(entry.category)) {
+        errors.push(`Invalid category "${entry.category}". Must be one of: ${VALID_CATEGORIES.join(', ')}`);
+    }
+    if (entry.keywords.length === 0) {
+        errors.push('Missing required attribute: keywords (need at least 1)');
+    }
+    if (!entry.date) {
+        errors.push('Missing required attribute: date');
+    }
+    else if (!DATE_RE.test(entry.date)) {
+        errors.push(`Invalid date format "${entry.date}". Expected YYYY-MM-DD`);
+    }
+    return errors;
+}
+/**
+ * Validate that entry category matches the expected file category.
+ */
+export function validateCategoryMatch(entry, fileCategory) {
+    if (entry.category && entry.category !== fileCategory) {
+        return `Entry category "${entry.category}" does not match file category "${fileCategory}"`;
+    }
+    return null;
+}
+// ============================================================================
+// Formatting
+// ============================================================================
+/**
+ * Format parsed entries for display output.
+ * Strips `<spec-entry>` tags, shows clean content.
+ * If keyword provided, highlights matched entries.
+ */
+export function formatSpecEntries(entries, keyword) {
+    const filtered = keyword
+        ? entries.filter(e => e.keywords.includes(keyword.toLowerCase()))
+        : entries;
+    if (filtered.length === 0)
+        return '';
+    return filtered.map(formatEntryClean).join('\n\n---\n\n');
+}
+/**
+ * Format a single parsed entry as clean markdown with metadata line.
+ *
+ * Input content:  `### Title\n\nBody`
+ * Output:         `### Title\n> category · kw1, kw2 · date · source\n\nBody`
+ */
+function formatEntryClean(e) {
+    const meta = [];
+    if (e.category)
+        meta.push(e.category);
+    if (e.keywords.length > 0)
+        meta.push(e.keywords.join(', '));
+    if (e.date)
+        meta.push(e.date);
+    if (e.source)
+        meta.push(e.source);
+    if (meta.length === 0)
+        return e.content;
+    const metaLine = `> ${meta.join(' \u00b7 ')}`;
+    // Inject after first ### heading line
+    const idx = e.content.indexOf('\n');
+    if (idx !== -1 && e.content.trimStart().startsWith('###')) {
+        return e.content.slice(0, idx) + '\n' + metaLine + e.content.slice(idx);
+    }
+    return metaLine + '\n\n' + e.content;
+}
+/**
+ * Format a single entry for writing to a spec file.
+ */
+export function formatNewEntry(category, keywords, date, title, content, source) {
+    const kwStr = keywords.map(k => k.toLowerCase().trim()).filter(Boolean).join(',');
+    const sourceAttr = source ? ` source="${source}"` : '';
+    return `<spec-entry category="${category}" keywords="${kwStr}" date="${date}"${sourceAttr}>\n\n### ${title}\n\n${content}\n\n</spec-entry>`;
+}
+// ============================================================================
+// Internal helpers
+// ============================================================================
+function parseAttributes(attrStr) {
+    const attrs = {};
+    let m;
+    ATTR_RE.lastIndex = 0;
+    while ((m = ATTR_RE.exec(attrStr)) !== null) {
+        attrs[m[1]] = m[2];
+    }
+    return attrs;
+}
+function lineNumber(content, charIndex) {
+    let line = 1;
+    for (let i = 0; i < charIndex && i < content.length; i++) {
+        if (content[i] === '\n')
+            line++;
+    }
+    return line;
+}
+/**
+ * Parse legacy heading-based entries from text not consumed by <spec-entry> blocks.
+ */
+function parseLegacyEntries(content, consumed) {
+    const lines = content.split('\n');
+    const legacy = [];
+    let currentOffset = 0;
+    // Build a set of line numbers that are inside <spec-entry> blocks
+    const consumedLines = new Set();
+    for (const range of consumed) {
+        const startLine = lineNumber(content, range.start);
+        const endLine = lineNumber(content, range.end);
+        for (let i = startLine; i <= endLine; i++) {
+            consumedLines.add(i);
+        }
+    }
+    let current = null;
+    for (let i = 0; i < lines.length; i++) {
+        const lineNum = i + 1;
+        if (consumedLines.has(lineNum))
+            continue;
+        const line = lines[i];
+        const m = line.match(LEGACY_HEADING_RE);
+        if (m) {
+            if (current) {
+                const body = current.bodyLines.join('\n').trim();
+                if (body) {
+                    legacy.push({ title: current.title, content: `### ${current.title}\n\n${body}`, lineStart: current.lineStart });
+                }
+            }
+            current = { title: m[2].trim(), bodyLines: [], lineStart: lineNum };
+        }
+        else if (current) {
+            current.bodyLines.push(line);
+        }
+    }
+    if (current) {
+        const body = current.bodyLines.join('\n').trim();
+        if (body) {
+            legacy.push({ title: current.title, content: `### ${current.title}\n\n${body}`, lineStart: current.lineStart });
+        }
+    }
+    return legacy;
+}
+//# sourceMappingURL=spec-entry-parser.js.map

package/dashboard/dist-server/src/tools/spec-entry-parser.js.map

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

package/dashboard/dist-server/src/tools/spec-loader.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Spec Loader (simplified)
+ *
+ * Filename-based category routing. No frontmatter dependency.
+ * Reads .workflow/specs/*.md, filters by category via static mapping,
+ * returns concatenated content.
+ */
+export type SpecCategory = 'coding' | 'arch' | 'quality' | 'debug' | 'test' | 'review' | 'learning';
+export type SpecScope = 'project' | 'global' | 'team' | 'personal';
+export interface SpecLoadResult {
+    content: string;
+    matchedSpecs: string[];
+    totalLoaded: number;
+}
+export declare const CATEGORY_MAP: Record<string, SpecCategory>;
+export declare const TEAM_SPECS_DIR = ".workflow/collab/specs";
+/**
+ * Resolve the directory for a given spec scope.
+ *
+ * | scope      | directory                           |
+ * |------------|-------------------------------------|
+ * | project    | .workflow/specs/                    |
+ * | global     | ~/.maestro/specs/                   |
+ * | team       | .workflow/collab/specs/              |
+ * | personal   | .workflow/collab/specs/{uid}/        |
+ */
+export declare function resolveSpecDir(projectPath: string, scope: SpecScope, uid?: string): string;
+/**
+ * Load spec files from one or more directories.
+ *
+ * Layer scanning order (lowest → highest priority):
+ *   0. ~/.maestro/specs/             (global — when `scope` includes global)
+ *   1. .workflow/specs/              (baseline)
+ *   2. .workflow/collab/specs/       (team shared — when `uid` is provided)
+ *   3. .workflow/collab/specs/{uid}/ (personal — when `uid` is provided)
+ *
+ * Content from later layers is appended (never replaces earlier content).
+ * Each layer's content is prefixed with a header for clarity.
+ *
+ * @param scope   Controls which extra layers to include beyond baseline.
+ *                - 'project': baseline only (default)
+ *                - 'global': global + baseline
+ *                - 'team': baseline + team shared
+ *                - 'personal': baseline + team shared + personal (requires uid)
+ *                - undefined: same as 'project'; uid alone still triggers team+personal for backward compat
+ */
+export interface LoadSpecsOptions {
+    /** Override global specs directory (for testing). Defaults to ~/.maestro/specs/ */
+    globalDir?: string;
+}
+export declare function loadSpecs(projectPath: string, category?: SpecCategory, uid?: string, keyword?: string, scope?: SpecScope, options?: LoadSpecsOptions): SpecLoadResult;

package/dashboard/dist-server/src/tools/spec-loader.js

@@ -0,0 +1,267 @@
+/**
+ * Spec Loader (simplified)
+ *
+ * Filename-based category routing. No frontmatter dependency.
+ * Reads .workflow/specs/*.md, filters by category via static mapping,
+ * returns concatenated content.
+ */
+import { readFileSync, existsSync, readdirSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { parseSpecEntries, formatSpecEntries } from './spec-entry-parser.js';
+import { paths } from '../config/paths.js';
+// ============================================================================
+// Filename → Category mapping (single source of truth)
+// ============================================================================
+export const CATEGORY_MAP = {
+    'coding-conventions.md': 'coding',
+    'architecture-constraints.md': 'arch',
+    'quality-rules.md': 'quality',
+    'debug-notes.md': 'debug',
+    'test-conventions.md': 'test',
+    'review-standards.md': 'review',
+    'learnings.md': 'learning',
+};
+const SPECS_DIR = '.workflow/specs';
+export const TEAM_SPECS_DIR = '.workflow/collab/specs';
+/** Layer labels used as section headers when multi-directory scanning is active. */
+const LAYER_LABELS = {
+    global: '# Global Specs',
+    baseline: '# Baseline Specs',
+    team: '# Team Specs',
+    // personal label is dynamic — includes uid
+};
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Resolve the directory for a given spec scope.
+ *
+ * | scope      | directory                           |
+ * |------------|-------------------------------------|
+ * | project    | .workflow/specs/                    |
+ * | global     | ~/.maestro/specs/                   |
+ * | team       | .workflow/collab/specs/              |
+ * | personal   | .workflow/collab/specs/{uid}/        |
+ */
+export function resolveSpecDir(projectPath, scope, uid) {
+    switch (scope) {
+        case 'global': return paths.specs;
+        case 'team': return join(projectPath, TEAM_SPECS_DIR);
+        case 'personal': {
+            if (!uid)
+                throw new Error('personal scope requires uid');
+            return join(projectPath, TEAM_SPECS_DIR, uid);
+        }
+        case 'project':
+        default: return join(projectPath, SPECS_DIR);
+    }
+}
+export function loadSpecs(projectPath, category, uid, keyword, scope, options) {
+    const globalDir = options?.globalDir ?? paths.specs;
+    // Build ordered list of (directory, label) pairs to scan
+    const layers = buildLayers(projectPath, uid, scope, globalDir);
+    // Auto-init baseline and global layers.
+    // Team/personal are per-user — auto-creating them for arbitrary uids is wrong.
+    autoInitSeeds(join(projectPath, SPECS_DIR));
+    autoInitSeeds(globalDir);
+    // First pass: collect results per layer (skip empty)
+    const layerResults = [];
+    for (const { dir, label } of layers) {
+        const { sections, matched } = loadFromDir(dir, category, keyword);
+        if (sections.length > 0) {
+            layerResults.push({ label, sections, matched });
+        }
+    }
+    // Only show layer headers when multiple layers have actual content
+    const multiLayer = layerResults.length > 1;
+    const allSections = [];
+    const allMatched = [];
+    let totalCount = 0;
+    for (const { label, sections, matched } of layerResults) {
+        if (multiLayer) {
+            allSections.push(`${label}\n\n${sections.join('\n\n---\n\n')}`);
+        }
+        else {
+            allSections.push(...sections);
+        }
+        allMatched.push(...matched);
+        totalCount += matched.length;
+    }
+    return {
+        content: allSections.length > 0
+            ? `# Project Specs (${totalCount} loaded)\n\n${allSections.join('\n\n---\n\n')}`
+            : '',
+        matchedSpecs: allMatched,
+        totalLoaded: totalCount,
+    };
+}
+function buildLayers(projectPath, uid, scope, globalDir) {
+    const layers = [];
+    // Global layer — always included as lowest priority
+    layers.push({ dir: globalDir ?? paths.specs, label: LAYER_LABELS.global });
+    // Baseline — always included
+    layers.push({
+        dir: join(projectPath, SPECS_DIR),
+        label: LAYER_LABELS.baseline,
+    });
+    // Team + personal layers
+    // Activated by scope='team'|'personal', or by uid (backward compat)
+    if (scope === 'team' || scope === 'personal' || uid) {
+        layers.push({ dir: join(projectPath, TEAM_SPECS_DIR), label: LAYER_LABELS.team });
+        if (uid) {
+            layers.push({ dir: join(projectPath, TEAM_SPECS_DIR, uid), label: `# Personal Specs (${uid})` });
+        }
+    }
+    return layers;
+}
+/**
+ * Load spec files from a single directory. Returns empty arrays if the
+ * directory does not exist or is unreadable.
+ */
+function loadFromDir(specsDir, category, keyword) {
+    if (!existsSync(specsDir))
+        return { sections: [], matched: [] };
+    let files;
+    try {
+        files = readdirSync(specsDir).filter(f => f.endsWith('.md'));
+    }
+    catch {
+        return { sections: [], matched: [] };
+    }
+    const sections = [];
+    const matched = [];
+    for (const file of files) {
+        if (!shouldInclude(file, category))
+            continue;
+        const filePath = join(specsDir, file);
+        let raw;
+        try {
+            raw = readFileSync(filePath, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        const body = stripFrontmatter(raw).trim();
+        if (!body)
+            continue;
+        const formatted = formatFileContent(body, keyword);
+        if (formatted) {
+            sections.push(formatted);
+            matched.push(file);
+        }
+    }
+    return { sections, matched };
+}
+// ============================================================================
+// Internal
+// ============================================================================
+function shouldInclude(filename, category) {
+    // No category filter → load all
+    if (!category)
+        return true;
+    const cat = CATEGORY_MAP[filename];
+    if (cat)
+        return cat === category;
+    // Unknown files: include only when no category filter
+    return false;
+}
+/**
+ * Parse file body, strip <spec-entry> tags, format clean output with metadata.
+ * When keyword is provided, only return matching entries.
+ * Falls back to raw body for files with no structured entries.
+ */
+function formatFileContent(body, keyword) {
+    const { entries, legacy } = parseSpecEntries(body);
+    // No structured entries → pass through raw body (or keyword-grep it)
+    if (entries.length === 0 && legacy.length === 0) {
+        if (keyword) {
+            return body.toLowerCase().includes(keyword.toLowerCase()) ? body : null;
+        }
+        return body;
+    }
+    const parts = [];
+    if (keyword) {
+        const kw = keyword.toLowerCase();
+        const matchedEntries = entries.filter(e => e.keywords.includes(kw));
+        if (matchedEntries.length > 0)
+            parts.push(formatSpecEntries(matchedEntries));
+        for (const leg of legacy) {
+            if (leg.content.toLowerCase().includes(kw))
+                parts.push(leg.content);
+        }
+    }
+    else {
+        if (entries.length > 0)
+            parts.push(formatSpecEntries(entries));
+        for (const leg of legacy)
+            parts.push(leg.content);
+    }
+    return parts.length > 0 ? parts.join('\n\n---\n\n') : null;
+}
+function stripFrontmatter(raw) {
+    const trimmed = raw.trimStart();
+    if (!trimmed.startsWith('---'))
+        return raw;
+    const endIdx = trimmed.indexOf('\n---', 3);
+    if (endIdx === -1)
+        return raw;
+    return trimmed.substring(endIdx + 4).trim();
+}
+// ============================================================================
+// Auto-init seed files
+// ============================================================================
+/** Directories already checked this process — skip re-checking. */
+const autoInitChecked = new Set();
+/** Minimal seed files (filename + header). */
+const AUTO_INIT_SEEDS = [
+    ['coding-conventions.md', '# Coding Conventions\n\n## Entries\n\n'],
+    ['architecture-constraints.md', '# Architecture Constraints\n\n## Entries\n\n'],
+    ['learnings.md', '# Learnings\n\n## Entries\n\n'],
+    ['quality-rules.md', '# Quality Rules\n\n## Entries\n\n'],
+    ['debug-notes.md', '# Debug Notes\n\n## Entries\n\n'],
+    ['test-conventions.md', '# Test Conventions\n\n## Entries\n\n'],
+    ['review-standards.md', '# Review Standards\n\n## Entries\n\n'],
+];
+/**
+ * Auto-create a specs directory with seed files if it does not exist.
+ * Applies to every layer (global, baseline, team, personal).
+ *
+ * For project-local dirs: only runs when `.workflow/` already exists
+ * (i.e. the project is maestro-managed).
+ * For global (`~/.maestro/specs/`): always creates — the home dir exists by definition.
+ *
+ * Synchronous, per-directory dedup, best-effort — never throws.
+ */
+function autoInitSeeds(specsDir) {
+    if (autoInitChecked.has(specsDir))
+        return;
+    autoInitChecked.add(specsDir);
+    if (existsSync(specsDir))
+        return;
+    // For project-local paths, only auto-init when .workflow/ already exists.
+    // Global path (under ~/.maestro/) always qualifies.
+    const isGlobal = specsDir === paths.specs;
+    if (!isGlobal) {
+        // Walk up to check if .workflow/ parent exists
+        // specsDir patterns: <project>/.workflow/specs, <project>/.workflow/collab/specs[/<uid>]
+        const workflowIdx = specsDir.replace(/\\/g, '/').indexOf('.workflow/');
+        if (workflowIdx !== -1) {
+            const workflowDir = specsDir.substring(0, workflowIdx + '.workflow'.length);
+            if (!existsSync(workflowDir))
+                return;
+        }
+    }
+    try {
+        mkdirSync(specsDir, { recursive: true });
+        for (const [filename, content] of AUTO_INIT_SEEDS) {
+            const filePath = join(specsDir, filename);
+            if (!existsSync(filePath)) {
+                writeFileSync(filePath, content, 'utf-8');
+            }
+        }
+    }
+    catch {
+        // Best-effort — don't block loading
+    }
+}
+//# sourceMappingURL=spec-loader.js.map

package/dashboard/dist-server/src/tools/spec-loader.js.map

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

package/dist/src/agents/cli-agent-runner.d.ts

@@ -43,6 +43,8 @@ export interface CliRunOptions {
     settingsFile?: string;
     /** Base tool name for aliases — used to resolve agent type when tool is an alias */
     baseTool?: string;
+    /** Delegate role — maps to spec categories for targeted spec injection */
+    role?: string;
 }
 export declare function generateCliExecId(tool: string): string;
 export declare class CliAgentRunner {