maestro-flow 0.5.1 → 0.5.3

package/dist/src/tools/domain-loader.js

@@ -0,0 +1,295 @@
+/**
+ * Domain Loader — CRUD for .workflow/domain/glossary.json
+ *
+ * Provides read/write operations with file locking, auto-backup, mtime cache,
+ * and schema validation. All write operations go through GlossaryLock.
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync, copyFileSync, readdirSync, unlinkSync, statSync, } from 'node:fs';
+import { join } from 'node:path';
+import { validateGlossary, validateRelationships } from './domain-schema.js';
+// ============================================================================
+// Paths
+// ============================================================================
+function glossaryPath(workflowRoot) {
+    return join(workflowRoot, 'domain', 'glossary.json');
+}
+function domainDir(workflowRoot) {
+    return join(workflowRoot, 'domain');
+}
+// ============================================================================
+// File lock (cross-process)
+// ============================================================================
+const STALE_TIMEOUT_MS = 30_000;
+export class GlossaryLock {
+    lockPath;
+    held = false;
+    constructor(workflowRoot) {
+        this.lockPath = join(workflowRoot, 'domain', '.glossary.lock');
+    }
+    acquire() {
+        if (existsSync(this.lockPath)) {
+            try {
+                const content = readFileSync(this.lockPath, 'utf-8').trim();
+                const pid = parseInt(content, 10);
+                const lockAge = Date.now() - statSync(this.lockPath).mtimeMs;
+                if (lockAge < STALE_TIMEOUT_MS && !isNaN(pid) && isProcessAlive(pid)) {
+                    throw new Error(`glossary.json locked by PID ${pid}. Delete ${this.lockPath} if stale.`);
+                }
+            }
+            catch (e) {
+                if (e.message.includes('locked by PID'))
+                    throw e;
+            }
+            try {
+                unlinkSync(this.lockPath);
+            }
+            catch { /* already gone */ }
+        }
+        try {
+            writeFileSync(this.lockPath, String(process.pid), { flag: 'wx' });
+            this.held = true;
+        }
+        catch {
+            throw new Error(`Cannot acquire glossary lock: ${this.lockPath}`);
+        }
+    }
+    release() {
+        if (!this.held)
+            return;
+        try {
+            const content = readFileSync(this.lockPath, 'utf-8').trim();
+            if (parseInt(content, 10) === process.pid)
+                unlinkSync(this.lockPath);
+        }
+        catch { /* already gone */ }
+        this.held = false;
+    }
+    withLock(fn) {
+        this.acquire();
+        try {
+            return fn();
+        }
+        finally {
+            this.release();
+        }
+    }
+}
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ============================================================================
+// Backup
+// ============================================================================
+const MAX_BACKUPS = 10;
+function backupGlossary(workflowRoot) {
+    const gPath = glossaryPath(workflowRoot);
+    if (!existsSync(gPath))
+        return;
+    const backupDir = join(workflowRoot, 'domain', '.backups');
+    mkdirSync(backupDir, { recursive: true });
+    const ts = new Date().toISOString().replace(/[:\-T]/g, '').replace(/\..+/, '');
+    copyFileSync(gPath, join(backupDir, `glossary-${ts}.json`));
+    const backups = readdirSync(backupDir)
+        .filter(f => f.startsWith('glossary-') && f.endsWith('.json'))
+        .sort().reverse();
+    for (const old of backups.slice(MAX_BACKUPS)) {
+        try {
+            unlinkSync(join(backupDir, old));
+        }
+        catch { /* ignore */ }
+    }
+}
+// ============================================================================
+// Read (with cache)
+// ============================================================================
+const _glossaryCache = new Map();
+const CACHE_MAX_ENTRIES = 10;
+export function readGlossary(workflowRoot) {
+    const gPath = glossaryPath(workflowRoot);
+    if (!existsSync(gPath))
+        return { $schema: 'domain/1.0', terms: [] };
+    const raw = readFileSync(gPath, 'utf-8');
+    let data;
+    try {
+        data = JSON.parse(raw);
+    }
+    catch (e) {
+        throw new Error(`glossary.json invalid JSON: ${e.message}. Check file or restore from .backups/`);
+    }
+    const errors = validateGlossary(data);
+    if (errors.length > 0) {
+        const msg = errors.slice(0, 5).map(e => `${e.path}: ${e.message}`).join('; ');
+        throw new Error(`glossary.json validation failed: ${msg}`);
+    }
+    return data;
+}
+export function readGlossaryCached(workflowRoot) {
+    const gPath = glossaryPath(workflowRoot);
+    if (!existsSync(gPath))
+        return { $schema: 'domain/1.0', terms: [] };
+    const st = statSync(gPath);
+    const cached = _glossaryCache.get(gPath);
+    if (cached && cached.mtime === st.mtimeMs && cached.size === st.size)
+        return cached.data;
+    const data = readGlossary(workflowRoot);
+    if (_glossaryCache.size >= CACHE_MAX_ENTRIES) {
+        const oldest = _glossaryCache.keys().next().value;
+        if (oldest)
+            _glossaryCache.delete(oldest);
+    }
+    _glossaryCache.set(gPath, { mtime: st.mtimeMs, size: st.size, data });
+    return data;
+}
+function clearCache() {
+    _glossaryCache.clear();
+}
+// ============================================================================
+// Write (with lock + backup)
+// ============================================================================
+function writeGlossary(workflowRoot, glossary) {
+    const gPath = glossaryPath(workflowRoot);
+    mkdirSync(domainDir(workflowRoot), { recursive: true });
+    backupGlossary(workflowRoot);
+    writeFileSync(gPath, JSON.stringify(glossary, null, 2) + '\n', 'utf-8');
+    clearCache();
+}
+// ============================================================================
+// Safe load (for consumers that need empty-glossary safety)
+// ============================================================================
+export function loadGlossary(projectPath) {
+    const wRoot = join(projectPath, '.workflow');
+    const gPath = glossaryPath(wRoot);
+    if (!existsSync(gPath))
+        return { exists: false, glossary: null, activeTerms: [], isEmpty: true };
+    try {
+        const glossary = readGlossaryCached(wRoot);
+        if (!Array.isArray(glossary.terms))
+            return { exists: true, glossary, activeTerms: [], isEmpty: true };
+        const activeTerms = glossary.terms.filter(t => (t.status ?? 'active') === 'active');
+        return { exists: true, glossary, activeTerms, isEmpty: glossary.terms.length === 0 };
+    }
+    catch {
+        return { exists: true, glossary: null, activeTerms: [], isEmpty: true };
+    }
+}
+// ============================================================================
+// CRUD operations (all locked)
+// ============================================================================
+export function initDomain(workflowRoot, project) {
+    const dir = domainDir(workflowRoot);
+    mkdirSync(dir, { recursive: true });
+    mkdirSync(join(dir, 'concepts'), { recursive: true });
+    const gPath = glossaryPath(workflowRoot);
+    if (!existsSync(gPath)) {
+        const glossary = {
+            $schema: 'domain/1.0',
+            ...(project ? { project } : {}),
+            terms: [],
+        };
+        writeFileSync(gPath, JSON.stringify(glossary, null, 2) + '\n', 'utf-8');
+    }
+    return gPath;
+}
+export function addTerm(workflowRoot, term) {
+    const lock = new GlossaryLock(workflowRoot);
+    lock.withLock(() => {
+        const glossary = readGlossary(workflowRoot);
+        if (glossary.terms.some(t => t.id === term.id)) {
+            throw new Error(`Term "${term.id}" already exists. Use updateTerm instead.`);
+        }
+        glossary.terms.push(term);
+        writeGlossary(workflowRoot, glossary);
+    });
+}
+export function updateTerm(workflowRoot, termId, updates) {
+    const lock = new GlossaryLock(workflowRoot);
+    lock.withLock(() => {
+        const glossary = readGlossary(workflowRoot);
+        const idx = glossary.terms.findIndex(t => t.id === termId);
+        if (idx === -1)
+            throw new Error(`Term "${termId}" not found`);
+        glossary.terms[idx] = { ...glossary.terms[idx], ...updates };
+        writeGlossary(workflowRoot, glossary);
+    });
+}
+export function removeTerm(workflowRoot, termId) {
+    const warnings = [];
+    const lock = new GlossaryLock(workflowRoot);
+    lock.withLock(() => {
+        const glossary = readGlossary(workflowRoot);
+        const idx = glossary.terms.findIndex(t => t.id === termId);
+        if (idx === -1)
+            throw new Error(`Term "${termId}" not found`);
+        // Check for dangling spec references
+        const danglingRefs = checkDanglingSpecRefs(workflowRoot, termId);
+        if (danglingRefs.length > 0) {
+            warnings.push(`${danglingRefs.length} spec entries reference domain="${termId}":\n` +
+                danglingRefs.map(r => `  - ${r}`).join('\n'));
+        }
+        // Check for relationship references from other terms
+        const referencedBy = glossary.terms.filter(t => t.id !== termId && t.relationships?.includes(termId));
+        if (referencedBy.length > 0) {
+            warnings.push(`${referencedBy.length} terms reference "${termId}" in relationships: ` +
+                referencedBy.map(t => t.id).join(', '));
+        }
+        glossary.terms.splice(idx, 1);
+        writeGlossary(workflowRoot, glossary);
+    });
+    return { warnings };
+}
+export function deprecateTerm(workflowRoot, termId, reason, successorId) {
+    updateTerm(workflowRoot, termId, {
+        status: 'deprecated',
+        deprecated_info: {
+            reason,
+            ...(successorId ? { successor_id: successorId } : {}),
+            deprecated_at: new Date().toISOString(),
+        },
+    });
+}
+// ============================================================================
+// Validation helpers
+// ============================================================================
+export function validateGlossaryFile(workflowRoot) {
+    const gPath = glossaryPath(workflowRoot);
+    if (!existsSync(gPath))
+        return { errors: [{ path: '$', message: 'glossary.json not found' }], warnings: [] };
+    let data;
+    try {
+        data = JSON.parse(readFileSync(gPath, 'utf-8'));
+    }
+    catch (e) {
+        return { errors: [{ path: '$', message: `invalid JSON: ${e.message}` }], warnings: [] };
+    }
+    const errors = validateGlossary(data);
+    const terms = data.terms;
+    const warnings = Array.isArray(terms)
+        ? validateRelationships(terms)
+        : [];
+    return { errors, warnings };
+}
+// ============================================================================
+// Dangling spec reference check
+// ============================================================================
+function checkDanglingSpecRefs(workflowRoot, termId) {
+    const specsDir = join(workflowRoot, 'specs');
+    if (!existsSync(specsDir))
+        return [];
+    const refs = [];
+    const needle = `domain="${termId}"`;
+    for (const name of readdirSync(specsDir)) {
+        if (!name.endsWith('.md'))
+            continue;
+        const content = readFileSync(join(specsDir, name), 'utf-8');
+        if (content.includes(needle))
+            refs.push(name);
+    }
+    return refs;
+}
+//# sourceMappingURL=domain-loader.js.map

package/dist/src/tools/domain-loader.js.map

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

package/dist/src/tools/domain-matcher.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Domain Matcher — CJK-aware term matching for domain glossary injection
+ */
+import type { DomainTerm } from './domain-loader.js';
+export interface DomainTermMatch {
+    termId: string;
+    canonical: string;
+    definition: string;
+    matchedBy: 'canonical' | 'alias' | 'keyword';
+    matchedToken: string;
+}
+export interface MatchedTermSet {
+    directMatches: DomainTermMatch[];
+    propagatedIds: string[];
+}
+type MatchableTerm = Pick<DomainTerm, 'id' | 'canonical' | 'definition' | 'aliases' | 'keywords' | 'relationships'> & {
+    status?: string;
+    rewrite_hints?: Record<string, string>;
+};
+export declare function matchAlias(prompt: string, alias: string): boolean;
+export declare function matchDomainTerms(prompt: string, terms: MatchableTerm[]): MatchedTermSet;
+export declare function collectRewriteHints(matchedTermIds: string[], terms: MatchableTerm[]): Record<string, string>;
+export {};
+//# sourceMappingURL=domain-matcher.d.ts.map

package/dist/src/tools/domain-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-matcher.d.ts","sourceRoot":"","sources":["../../../src/tools/domain-matcher.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAMrD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;IAC7C,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,eAAe,EAAE,CAAC;IACjC,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,KAAK,aAAa,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,WAAW,GAAG,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,eAAe,CAAC,GAAG;IACpH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC,CAAC;AAoBF,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAejE;AAMD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,cAAc,CAqEvF;AAMD,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,MAAM,EAAE,EACxB,KAAK,EAAE,aAAa,EAAE,GACrB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAWxB"}

package/dist/src/tools/domain-matcher.js

@@ -0,0 +1,117 @@
+/**
+ * Domain Matcher — CJK-aware term matching for domain glossary injection
+ */
+// ============================================================================
+// CJK detection
+// ============================================================================
+const CJK_RANGE = /[一-鿿぀-ゟ゠-ヿ가-힯]/;
+function isCJK(char) {
+    return CJK_RANGE.test(char);
+}
+// ============================================================================
+// Core matching
+// ============================================================================
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+export function matchAlias(prompt, alias) {
+    if (!alias || alias.length === 0)
+        return false;
+    if (CJK_RANGE.test(alias)) {
+        // CJK has no word boundaries. Use length-based protection:
+        // - Reject single-char aliases (too generic)
+        // - ≥3 char aliases: direct includes() (specific enough)
+        // - 2 char aliases: includes() is acceptable — domain terms are proper
+        //   nouns and false positives are rare/benign (extra context injected)
+        if (alias.length < 2)
+            return false;
+        return prompt.includes(alias);
+    }
+    const re = new RegExp(`\\b${escapeRegExp(alias)}\\b`, 'i');
+    return re.test(prompt);
+}
+// ============================================================================
+// Batch matching with relationship propagation
+// ============================================================================
+export function matchDomainTerms(prompt, terms) {
+    const directMatches = [];
+    const matchedIds = new Set();
+    for (const term of terms) {
+        if ((term.status ?? 'active') !== 'active' && (term.status ?? 'active') !== 'deprecated')
+            continue;
+        let matched = false;
+        let matchedBy = 'canonical';
+        let matchedToken = '';
+        // 1. canonical match (case-insensitive)
+        if (matchAlias(prompt, term.canonical)) {
+            matched = true;
+            matchedBy = 'canonical';
+            matchedToken = term.canonical;
+        }
+        // 2. alias match
+        if (!matched) {
+            for (const alias of term.aliases) {
+                if (matchAlias(prompt, alias)) {
+                    matched = true;
+                    matchedBy = 'alias';
+                    matchedToken = alias;
+                    break;
+                }
+            }
+        }
+        // 3. keyword match (fuzzy — same logic but lower priority)
+        if (!matched) {
+            for (const kw of term.keywords ?? []) {
+                if (matchAlias(prompt, kw)) {
+                    matched = true;
+                    matchedBy = 'keyword';
+                    matchedToken = kw;
+                    break;
+                }
+            }
+        }
+        if (matched) {
+            matchedIds.add(term.id);
+            directMatches.push({
+                termId: term.id,
+                canonical: term.canonical,
+                definition: term.definition,
+                matchedBy,
+                matchedToken,
+            });
+        }
+    }
+    // 1-level relationship propagation (visited set prevents duplicates)
+    const propagatedIds = [];
+    const visited = new Set(matchedIds);
+    for (const match of directMatches) {
+        const term = terms.find(t => t.id === match.termId);
+        if (!term)
+            continue;
+        for (const relId of term.relationships ?? []) {
+            if (!visited.has(relId)) {
+                visited.add(relId);
+                propagatedIds.push(relId);
+            }
+        }
+    }
+    return { directMatches, propagatedIds };
+}
+// ============================================================================
+// Rewrite hints extraction
+// ============================================================================
+export function collectRewriteHints(matchedTermIds, terms) {
+    const hints = Object.create(null);
+    for (const id of matchedTermIds) {
+        const term = terms.find(t => t.id === id);
+        if (!term?.rewrite_hints)
+            continue;
+        for (const [k, v] of Object.entries(term.rewrite_hints)) {
+            if (k === '__proto__' || k === 'constructor' || k === 'prototype')
+                continue;
+            hints[k] = v;
+        }
+    }
+    return hints;
+}
+//# sourceMappingURL=domain-matcher.js.map

package/dist/src/tools/domain-matcher.js.map

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

package/dist/src/tools/domain-scanner.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Domain Scanner — extract domain term candidates from codebase
+ *
+ * Scans TypeScript/JS source for interface/type/enum/class declarations,
+ * JSDoc definitions, API routes, and README terms. Computes confidence
+ * scores and filters with a programming-term blacklist.
+ */
+export interface TermSource {
+    kind: 'interface' | 'type' | 'enum' | 'class' | 'const' | 'route' | 'doc' | 'upstream';
+    file: string;
+    line?: number;
+    definition?: string;
+}
+export interface TermCandidate {
+    term: string;
+    normalized: string;
+    sources: TermSource[];
+    frequency: number;
+    autoDefinition: string | null;
+    autoAliases: string[];
+    confidence: number;
+}
+export interface ScanOptions {
+    scope?: string;
+    recentDays?: number;
+    minFreq?: number;
+    limit?: number;
+    exclude?: string;
+}
+export declare function scanForDomainTerms(projectRoot: string, workflowRoot: string, opts?: ScanOptions): TermCandidate[];
+export declare function computeConfidence(candidate: TermCandidate): number;
+//# sourceMappingURL=domain-scanner.d.ts.map

package/dist/src/tools/domain-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-scanner.d.ts","sourceRoot":"","sources":["../../../src/tools/domain-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,UAAU,CAAC;IACvF,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAmCD,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,IAAI,GAAE,WAAgB,GACrB,aAAa,EAAE,CAkDjB;AAMD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,CAuBlE"}