maestro-flow 0.5.31 → 0.5.33

package/dashboard/dist-server/src/core/overlay/types.js

@@ -0,0 +1,17 @@
+// ---------------------------------------------------------------------------
+// Overlay types — shared shapes for overlay loading, patching, and tracking.
+// ---------------------------------------------------------------------------
+/** XML-tagged sections recognised in command and skill files. */
+export const KNOWN_SECTIONS = [
+    'purpose',
+    'required_reading',
+    'deferred_reading',
+    'context',
+    'execution',
+    'error_codes',
+    'success_criteria',
+];
+/** Reserved target name for overlays that inject into CLAUDE.md via tag-injector. */
+export const CLAUDE_MD_TARGET = '_claude-md';
+export const OVERLAY_MANIFEST_VERSION = '1.0';
+//# sourceMappingURL=types.js.map

package/dashboard/dist-server/src/core/overlay/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/core/overlay/types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,6EAA6E;AAC7E,8EAA8E;AAO9E,iEAAiE;AACjE,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,SAAS;IACT,kBAAkB;IAClB,kBAAkB;IAClB,SAAS;IACT,WAAW;IACX,aAAa;IACb,kBAAkB;CACV,CAAC;AAEX,qFAAqF;AACrF,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAY,CAAC;AAyD7C,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAc,CAAC"}

package/dashboard/dist-server/src/core/tag-injector.d.ts

@@ -0,0 +1,71 @@
+import { type Manifest } from './manifest.js';
+/** Default section name when none specified (backward compat). */
+export declare const DEFAULT_SECTION = "core";
+export declare function markerStart(section: string): string;
+export declare function markerEnd(section: string): string;
+/**
+ * Detect whether the text contains markers for a specific section.
+ */
+export declare function hasSection(text: string, section: string): boolean;
+/**
+ * Detect whether the text contains any maestro markers at all.
+ */
+export declare function hasAnyMarkers(text: string): boolean;
+/**
+ * Compute bidirectional line-level similarity (Jaccard-like).
+ * Returns 0..1 where 1 = existing and source have identical line sets.
+ * Uses intersection / union to avoid false positives when one is a superset.
+ */
+export declare function computeSimilarity(existing: string, source: string): number;
+export type MigrateAction = 'created' | 'updated' | 'migrated' | 'injected';
+export interface MigrateResult {
+    /** What action was taken */
+    action: MigrateAction;
+    /** Final file content */
+    content: string;
+    /** Warning message for user (legacy content needs manual cleanup) */
+    warning?: string;
+}
+/**
+ * Migrate legacy or update existing doc file content with section-based tag injection.
+ *
+ * Handles scenarios:
+ * 1. No existing file        → create with markers (`created`)
+ * 2. Has this section        → replace between markers (`updated`)
+ * 3. Legacy ≥99% similar (core section only, no markers at all) → replace entire content (`migrated`)
+ * 4. Legacy ≥80% similar (core section only) → inject + warn (`injected` + warning)
+ * 5. Otherwise               → append markers normally (`injected`)
+ */
+export declare function migrateAndInject(existingContent: string, sourceContent: string, targetPath: string, section?: string): MigrateResult;
+/**
+ * Inject or update content for a specific section.
+ *
+ * - If section markers exist, replaces everything between them.
+ * - If no section markers, appends section block at the end.
+ * - If the file is empty/missing, creates with section block.
+ *
+ * Returns the updated text.
+ */
+export declare function injectContent(existingContent: string, content: string, section?: string): string;
+/**
+ * Remove a specific section's markers and content.
+ * Returns the cleaned text, or the original text if section not found.
+ */
+export declare function removeContent(text: string, section?: string): string;
+/**
+ * Remove ALL maestro sections from text.
+ * Also cleans up any orphaned markers (start without matching end).
+ */
+export declare function removeAllSections(text: string): string;
+export interface CopyStats {
+    files: number;
+    dirs: number;
+    skipped: number;
+}
+/**
+ * Inject source content into a target doc file using sectioned markers.
+ * Handles legacy migration with similarity detection.
+ *
+ * Returns migration result with optional warning.
+ */
+export declare function injectDocFile(src: string, dest: string, stats: CopyStats, manifest: Manifest, section?: string): MigrateResult;

package/dashboard/dist-server/src/core/tag-injector.js

@@ -0,0 +1,228 @@
+// ---------------------------------------------------------------------------
+// Tag Injector — injects/updates/removes content in doc files using
+// HTML comment markers with section attributes for non-destructive,
+// idempotent, multi-section installation.
+//
+// Marker format:
+//   <!-- maestro:start section="core" -->
+//   ...injected content...
+//   <!-- maestro:end section="core" -->
+//
+//   <!-- maestro:start section="chinese" -->
+//   ...chinese response content...
+//   <!-- maestro:end section="chinese" -->
+// ---------------------------------------------------------------------------
+import { existsSync, mkdirSync, readFileSync, writeFileSync, } from 'node:fs';
+import { dirname } from 'node:path';
+import { addFile, addDir, } from './manifest.js';
+/** Default section name when none specified (backward compat). */
+export const DEFAULT_SECTION = 'core';
+export function markerStart(section) {
+    return `<!-- maestro:start section="${section}" -->`;
+}
+export function markerEnd(section) {
+    return `<!-- maestro:end section="${section}" -->`;
+}
+function startRe(section) {
+    return new RegExp(`^<!-- maestro:start section="${escapeRe(section)}" -->$`, 'm');
+}
+function endRe(section) {
+    return new RegExp(`^<!-- maestro:end section="${escapeRe(section)}" -->$`, 'm');
+}
+/** Match any maestro section marker (for generic detection). */
+const ANY_START_RE = /^<!-- maestro:start section="[^"]*" -->$/m;
+function escapeRe(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Detect whether the text contains markers for a specific section.
+ */
+export function hasSection(text, section) {
+    return startRe(section).test(text) && endRe(section).test(text);
+}
+/**
+ * Detect whether the text contains any maestro markers at all.
+ */
+export function hasAnyMarkers(text) {
+    return ANY_START_RE.test(text);
+}
+// ---------------------------------------------------------------------------
+// Legacy migration — similarity detection
+// ---------------------------------------------------------------------------
+/** Normalize text for comparison: trim lines, collapse blanks, lowercase. */
+function normalizeForCompare(text) {
+    return text
+        .replace(/\r\n/g, '\n')
+        .split('\n')
+        .map(l => l.trim())
+        .filter(l => l.length > 0)
+        .map(l => l.toLowerCase());
+}
+/**
+ * Compute bidirectional line-level similarity (Jaccard-like).
+ * Returns 0..1 where 1 = existing and source have identical line sets.
+ * Uses intersection / union to avoid false positives when one is a superset.
+ */
+export function computeSimilarity(existing, source) {
+    const existingLines = normalizeForCompare(existing);
+    const sourceLines = normalizeForCompare(source);
+    if (sourceLines.length === 0 && existingLines.length === 0)
+        return 1;
+    if (sourceLines.length === 0 || existingLines.length === 0)
+        return 0;
+    const existingSet = new Set(existingLines);
+    const sourceSet = new Set(sourceLines);
+    const intersection = sourceLines.filter(l => existingSet.has(l)).length;
+    const union = new Set([...existingLines, ...sourceLines]).size;
+    return intersection / union;
+}
+/**
+ * Migrate legacy or update existing doc file content with section-based tag injection.
+ *
+ * Handles scenarios:
+ * 1. No existing file        → create with markers (`created`)
+ * 2. Has this section        → replace between markers (`updated`)
+ * 3. Legacy ≥99% similar (core section only, no markers at all) → replace entire content (`migrated`)
+ * 4. Legacy ≥80% similar (core section only) → inject + warn (`injected` + warning)
+ * 5. Otherwise               → append markers normally (`injected`)
+ */
+export function migrateAndInject(existingContent, sourceContent, targetPath, section = DEFAULT_SECTION) {
+    const trimmedSource = sourceContent.replace(/\r\n/g, '\n').replace(/\n+$/, '');
+    const block = `${markerStart(section)}\n${trimmedSource}\n${markerEnd(section)}`;
+    // Case 1: no existing file
+    if (!existingContent || existingContent.trim() === '') {
+        return { action: 'created', content: block + '\n' };
+    }
+    const text = existingContent.replace(/\r\n/g, '\n');
+    // Case 2: already has this section — just update
+    if (hasSection(text, section)) {
+        return { action: 'updated', content: injectContent(text, sourceContent, section) };
+    }
+    // If file already has other maestro sections, just append this new section
+    if (hasAnyMarkers(text)) {
+        const normalized = text.replace(/\n+$/, '');
+        return { action: 'injected', content: normalized + '\n\n' + block + '\n' };
+    }
+    // Case 3-5: legacy file without any markers — check similarity (only for core section)
+    if (section === DEFAULT_SECTION) {
+        // Exact content match → safe to wrap entirely in markers
+        const normExisting = normalizeForCompare(text);
+        const normSource = normalizeForCompare(sourceContent);
+        const isExactMatch = normExisting.length === normSource.length &&
+            normExisting.every((line, i) => line === normSource[i]);
+        if (isExactMatch) {
+            return { action: 'migrated', content: block + '\n' };
+        }
+        // Check how much of the source is present in existing (one-directional)
+        const existingSet = new Set(normExisting);
+        const matched = normSource.filter(l => existingSet.has(l)).length;
+        const forwardSimilarity = normSource.length > 0 ? matched / normSource.length : 0;
+        if (forwardSimilarity >= 0.8) {
+            const normalized = text.replace(/\n+$/, '');
+            return {
+                action: 'injected',
+                content: normalized + '\n\n' + block + '\n',
+                warning: `${targetPath}: legacy maestro content detected (${Math.round(forwardSimilarity * 100)}% match). ` +
+                    `New content injected with markers. Please manually remove the old untagged content above the ${markerStart(section)} marker.`,
+            };
+        }
+    }
+    // Case 5: just append
+    const normalized = text.replace(/\n+$/, '');
+    return { action: 'injected', content: normalized + '\n\n' + block + '\n' };
+}
+/**
+ * Inject or update content for a specific section.
+ *
+ * - If section markers exist, replaces everything between them.
+ * - If no section markers, appends section block at the end.
+ * - If the file is empty/missing, creates with section block.
+ *
+ * Returns the updated text.
+ */
+export function injectContent(existingContent, content, section = DEFAULT_SECTION) {
+    const trimmedContent = content.replace(/\r\n/g, '\n').replace(/\n+$/, '');
+    const block = `${markerStart(section)}\n${trimmedContent}\n${markerEnd(section)}`;
+    if (!existingContent || existingContent.trim() === '') {
+        return block + '\n';
+    }
+    const text = existingContent.replace(/\r\n/g, '\n');
+    if (hasSection(text, section)) {
+        const start = markerStart(section);
+        const end = markerEnd(section);
+        const startIdx = text.indexOf(start);
+        const endIdx = text.indexOf(end);
+        if (startIdx === -1 || endIdx === -1) {
+            return text + '\n\n' + block + '\n';
+        }
+        const before = text.slice(0, startIdx);
+        const after = text.slice(endIdx + end.length);
+        return before + block + after;
+    }
+    // No section markers — append with a blank line separator
+    const normalized = text.replace(/\n+$/, '');
+    return normalized + '\n\n' + block + '\n';
+}
+/**
+ * Remove a specific section's markers and content.
+ * Returns the cleaned text, or the original text if section not found.
+ */
+export function removeContent(text, section = DEFAULT_SECTION) {
+    if (!hasSection(text, section))
+        return text;
+    const normalized = text.replace(/\r\n/g, '\n');
+    const start = markerStart(section);
+    const end = markerEnd(section);
+    const startIdx = normalized.indexOf(start);
+    const endIdx = normalized.indexOf(end);
+    if (startIdx === -1 || endIdx === -1)
+        return text;
+    const before = normalized.slice(0, startIdx);
+    const after = normalized.slice(endIdx + end.length);
+    // Clean up extra blank lines at the junction
+    const result = (before.replace(/\n+$/, '') + after.replace(/^\n+/, '\n')).replace(/\n+$/, '');
+    return result ? result + '\n' : '';
+}
+/**
+ * Remove ALL maestro sections from text.
+ * Also cleans up any orphaned markers (start without matching end).
+ */
+export function removeAllSections(text) {
+    const sectionRe = /<!-- maestro:start section="([^"]*)" -->/g;
+    let result = text;
+    let match;
+    // Collect all section names
+    const sections = [];
+    while ((match = sectionRe.exec(text)) !== null) {
+        sections.push(match[1]);
+    }
+    // Remove each complete section
+    for (const s of sections) {
+        result = removeContent(result, s);
+    }
+    // Clean up orphaned start markers (no matching end)
+    result = result.replace(/^<!-- maestro:start section="[^"]*" -->\n?/gm, '');
+    return result;
+}
+/**
+ * Inject source content into a target doc file using sectioned markers.
+ * Handles legacy migration with similarity detection.
+ *
+ * Returns migration result with optional warning.
+ */
+export function injectDocFile(src, dest, stats, manifest, section) {
+    const destDir = dirname(dest);
+    if (!existsSync(destDir)) {
+        mkdirSync(destDir, { recursive: true });
+        stats.dirs++;
+        addDir(manifest, destDir);
+    }
+    const sourceContent = readFileSync(src, 'utf-8');
+    const existingContent = existsSync(dest) ? readFileSync(dest, 'utf-8') : '';
+    const result = migrateAndInject(existingContent, sourceContent, dest, section);
+    writeFileSync(dest, result.content, 'utf-8');
+    stats.files++;
+    addFile(manifest, dest);
+    return result;
+}
+//# sourceMappingURL=tag-injector.js.map

package/dashboard/dist-server/src/core/tag-injector.js.map

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

package/dashboard/dist-server/src/core/toggle.d.ts

@@ -0,0 +1,12 @@
+export type ToggleState = 'on' | 'off' | 'available';
+export interface ToggleItem {
+    name: string;
+    type: 'command' | 'skill' | 'agent';
+    state: ToggleState;
+    sourcePath: string;
+    targetActive: string;
+    targetDisabled: string;
+}
+export declare function scanToggleItems(pkgRoot: string, targetBase: string): ToggleItem[];
+export declare function applyToggle(item: ToggleItem, pkgRoot: string): boolean;
+export declare function updateManifestDisabledItems(scope: 'global' | 'project', targetPath: string, disabledNames: string[]): void;

package/dashboard/dist-server/src/core/toggle.js

@@ -0,0 +1,159 @@
+// ---------------------------------------------------------------------------
+// Toggle — enable/disable individual commands, skills, and agents.
+//
+// Three-state model:
+//   on        = installed & enabled
+//   off       = installed & disabled (.md → .md.disabled)
+//   available = in source, not yet installed
+// ---------------------------------------------------------------------------
+import { join, dirname } from 'node:path';
+import { existsSync, mkdirSync, readdirSync, statSync, copyFileSync, cpSync, writeFileSync, renameSync, } from 'node:fs';
+import { findManifest, manifestFile } from './manifest.js';
+// ---------------------------------------------------------------------------
+// Scan — merge source (available) and target (on/off) into unified list
+// ---------------------------------------------------------------------------
+export function scanToggleItems(pkgRoot, targetBase) {
+    const items = new Map();
+    const addSource = (dir, targetDir, type, isSkill) => {
+        if (!existsSync(dir))
+            return;
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+            if (isSkill) {
+                if (!entry.isDirectory() || entry.name.startsWith('_') || entry.name.startsWith('.'))
+                    continue;
+                if (!existsSync(join(dir, entry.name, 'SKILL.md')))
+                    continue;
+                const key = `${type}:${entry.name}`;
+                items.set(key, {
+                    name: entry.name, type, state: 'available',
+                    sourcePath: join(dir, entry.name),
+                    targetActive: join(targetDir, entry.name, 'SKILL.md'),
+                    targetDisabled: join(targetDir, entry.name, 'SKILL.md.disabled'),
+                });
+            }
+            else {
+                if (!entry.isFile() || !entry.name.endsWith('.md'))
+                    continue;
+                const name = entry.name.replace('.md', '');
+                const key = `${type}:${name}`;
+                items.set(key, {
+                    name, type, state: 'available',
+                    sourcePath: join(dir, entry.name),
+                    targetActive: join(targetDir, entry.name),
+                    targetDisabled: join(targetDir, `${entry.name}.disabled`),
+                });
+            }
+        }
+    };
+    const markTarget = (dir, type, isSkill) => {
+        if (!existsSync(dir))
+            return;
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+            if (isSkill) {
+                if (!entry.isDirectory())
+                    continue;
+                const key = `${type}:${entry.name}`;
+                const hasActive = existsSync(join(dir, entry.name, 'SKILL.md'));
+                const hasDisabled = existsSync(join(dir, entry.name, 'SKILL.md.disabled'));
+                if (hasActive || hasDisabled) {
+                    const existing = items.get(key);
+                    const state = hasActive ? 'on' : 'off';
+                    if (existing) {
+                        existing.state = state;
+                    }
+                    else {
+                        items.set(key, {
+                            name: entry.name, type, state,
+                            sourcePath: '',
+                            targetActive: join(dir, entry.name, 'SKILL.md'),
+                            targetDisabled: join(dir, entry.name, 'SKILL.md.disabled'),
+                        });
+                    }
+                }
+            }
+            else {
+                if (!entry.isFile())
+                    continue;
+                const isDisabled = entry.name.endsWith('.md.disabled');
+                const isMd = entry.name.endsWith('.md') && !isDisabled;
+                if (!isMd && !isDisabled)
+                    continue;
+                const name = isDisabled ? entry.name.replace('.md.disabled', '') : entry.name.replace('.md', '');
+                const key = `${type}:${name}`;
+                const state = isMd ? 'on' : 'off';
+                const existing = items.get(key);
+                if (existing) {
+                    if (existing.state !== 'on')
+                        existing.state = state;
+                }
+                else {
+                    items.set(key, {
+                        name, type, state,
+                        sourcePath: '',
+                        targetActive: join(dir, `${name}.md`),
+                        targetDisabled: join(dir, `${name}.md.disabled`),
+                    });
+                }
+            }
+        }
+    };
+    const srcClaude = join(pkgRoot, '.claude');
+    const tgtClaude = join(targetBase, '.claude');
+    addSource(join(srcClaude, 'commands'), join(tgtClaude, 'commands'), 'command', false);
+    addSource(join(srcClaude, 'skills'), join(tgtClaude, 'skills'), 'skill', true);
+    addSource(join(srcClaude, 'agents'), join(tgtClaude, 'agents'), 'agent', false);
+    markTarget(join(tgtClaude, 'commands'), 'command', false);
+    markTarget(join(tgtClaude, 'skills'), 'skill', true);
+    markTarget(join(tgtClaude, 'agents'), 'agent', false);
+    const srcCodex = join(pkgRoot, '.codex');
+    const tgtCodex = join(targetBase, '.codex');
+    addSource(join(srcCodex, 'skills'), join(tgtCodex, 'skills'), 'skill', true);
+    addSource(join(srcCodex, 'agents'), join(tgtCodex, 'agents'), 'agent', false);
+    markTarget(join(tgtCodex, 'skills'), 'skill', true);
+    markTarget(join(tgtCodex, 'agents'), 'agent', false);
+    return [...items.values()].sort((a, b) => a.type.localeCompare(b.type) || a.name.localeCompare(b.name));
+}
+// ---------------------------------------------------------------------------
+// Apply — execute state transition on filesystem
+// ---------------------------------------------------------------------------
+export function applyToggle(item, pkgRoot) {
+    if (item.state === 'on') {
+        if (existsSync(item.targetActive)) {
+            renameSync(item.targetActive, item.targetDisabled);
+            return true;
+        }
+    }
+    else if (item.state === 'off') {
+        if (existsSync(item.targetDisabled)) {
+            renameSync(item.targetDisabled, item.targetActive);
+            return true;
+        }
+    }
+    else {
+        if (!item.sourcePath)
+            return false;
+        const targetDir = dirname(item.targetActive);
+        if (!existsSync(targetDir))
+            mkdirSync(targetDir, { recursive: true });
+        const srcStat = statSync(item.sourcePath);
+        if (srcStat.isDirectory()) {
+            cpSync(item.sourcePath, targetDir, { recursive: true });
+        }
+        else {
+            copyFileSync(item.sourcePath, item.targetActive);
+        }
+        return true;
+    }
+    return false;
+}
+// ---------------------------------------------------------------------------
+// Manifest integration — persist disabled-item list
+// ---------------------------------------------------------------------------
+export function updateManifestDisabledItems(scope, targetPath, disabledNames) {
+    const manifest = findManifest(scope, targetPath);
+    if (!manifest)
+        return;
+    manifest.disabledItems = disabledNames;
+    writeFileSync(manifestFile(manifest.id), JSON.stringify(manifest, null, 2), 'utf-8');
+}
+//# sourceMappingURL=toggle.js.map

package/dashboard/dist-server/src/core/toggle.js.map

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

package/dashboard/dist-server/src/graph/kg/credibility.d.ts

@@ -0,0 +1,36 @@
+import type Database from 'better-sqlite3';
+export interface CredibilityRow {
+    node_id: string;
+    content_hash: string;
+    search_hits: number;
+    consumption_count: number;
+    last_hit_at: number | null;
+    last_consumed_at: number | null;
+    content_changed_at: number;
+    created_at: number;
+}
+export interface CredibilityConfig {
+    floor: number;
+    ceiling: number;
+    warningThreshold: number;
+    halfLives: Record<string, number>;
+}
+declare const DEFAULT_CONFIG: CredibilityConfig;
+export declare const CREDIBILITY_MIGRATION_SQL = "\nCREATE TABLE IF NOT EXISTS credibility (\n    node_id             TEXT PRIMARY KEY,\n    content_hash        TEXT NOT NULL,\n    search_hits         INTEGER NOT NULL DEFAULT 0,\n    consumption_count   INTEGER NOT NULL DEFAULT 0,\n    last_hit_at         INTEGER,\n    last_consumed_at    INTEGER,\n    content_changed_at  INTEGER NOT NULL,\n    created_at          INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_credibility_search_hits ON credibility(search_hits);\nCREATE INDEX IF NOT EXISTS idx_credibility_content_changed ON credibility(content_changed_at);\n";
+export declare function computeDecayFactor(ageDays: number, nodeType: string, config?: CredibilityConfig): number;
+export declare function computeCredibilityFactor(row: CredibilityRow | null, nodeType: string, nowMs?: number, config?: CredibilityConfig): number;
+export declare function isLowCredibility(factor: number, config?: CredibilityConfig): boolean;
+export declare function contentHash(body: string): string;
+export declare class CredibilityStore {
+    private db;
+    constructor(db: Database.Database);
+    upsert(nodeId: string, hash: string, nowMs?: number): void;
+    get(nodeId: string): CredibilityRow | null;
+    getMany(nodeIds: string[]): Map<string, CredibilityRow>;
+    getAll(): CredibilityRow[];
+    incrementSearchHits(nodeIds: string[], nowMs?: number): void;
+    incrementConsumption(nodeId: string, nowMs?: number): void;
+    cleanOrphans(): number;
+}
+export declare function wikiIdToNodeId(wikiId: string): string | null;
+export { DEFAULT_CONFIG as CREDIBILITY_DEFAULT_CONFIG };