maestro-flow 0.3.22 → 0.3.23

package/dist/src/core/manifest.js

@@ -6,6 +6,7 @@
 import { join } from 'node:path';
 import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, unlinkSync, rmSync, } from 'node:fs';
 import { paths } from '../config/paths.js';
+import { hasAnyMarkers, removeAllSections } from './tag-injector.js';
 // ---------------------------------------------------------------------------
 // Paths
 // ---------------------------------------------------------------------------
@@ -107,56 +108,40 @@ export function deleteManifest(manifest) {
 // ---------------------------------------------------------------------------
 /** Files to preserve even during cleanup. */
 const PRESERVE = new Set(['settings.json', 'settings.local.json']);
-/** Files that should have maestro content removed instead of being deleted entirely. */
-const CONTENT_MANAGED = new Set(['CLAUDE.md']);
-/** Maestro-specific line patterns in CLAUDE.md */
-const MAESTRO_LINE_PATTERNS = [
-    /^#\s*Maestro\s*$/i,
-    /maestro/i,
-    /~\/\.maestro\//,
-    /mcp__ide__getDiagnostics/,
-    /cli-tools\.json/,
-];
+/** Files that should have maestro content removed via tag injection instead of being deleted entirely. */
+const CONTENT_MANAGED = new Set(['CLAUDE.md', 'AGENTS.md']);
 /**
- * Remove maestro-added content from CLAUDE.md instead of deleting the file.
+ * Remove maestro-injected content from a doc file using `<!-- maestro:start/end -->` markers.
  *
- * Strategy:
- * - Read source CLAUDE.md content that was installed by maestro
- * - Compare with existing file to determine if it's maestro-only or mixed
- * - If file matches maestro source content → safe to delete
- * - If file has user additions → remove only maestro-originated lines
+ * - If the file has markers, removes only the marked section.
+ * - If nothing remains after removal, deletes the file entirely.
+ * - Returns true if any content was removed.
  */
-function cleanClaudeMd(filePath) {
+function cleanInjectedDoc(filePath) {
     if (!existsSync(filePath))
         return false;
     const content = readFileSync(filePath, 'utf-8');
-    const lines = content.split('\n');
-    // Filter out lines that are maestro-specific
-    const filteredLines = lines.filter(line => {
-        const trimmed = line.trim();
-        if (trimmed.length === 0)
-            return true; // keep blank lines
-        return !MAESTRO_LINE_PATTERNS.some(p => p.test(trimmed));
-    });
-    // Check if remaining content is empty (only whitespace/blank lines)
-    const meaningful = filteredLines.filter(l => l.trim().length > 0);
-    if (meaningful.length === 0) {
-        // File only had maestro content — safe to delete
+    if (!hasAnyMarkers(content)) {
+        // No markers — this is a legacy install or user-only file, delete entirely
         unlinkSync(filePath);
         return true;
     }
-    // If nothing was actually removed, leave as-is
-    if (filteredLines.length === lines.length)
-        return false;
-    // Has user content — write back without maestro lines
-    const cleaned = filteredLines
-        .join('\n')
-        .replace(/\n{3,}/g, '\n\n')
-        .trimEnd() + '\n';
+    const cleaned = removeAllSections(content);
+    if (!cleaned || cleaned.trim() === '') {
+        // Nothing left after removing all maestro sections — delete the file
+        unlinkSync(filePath);
+        return true;
+    }
+    // User content remains — write back without maestro sections
     writeFileSync(filePath, cleaned, 'utf-8');
     return true;
 }
-export function cleanManifestFiles(manifest) {
+/**
+ * @param skipContentManaged If true, skip CONTENT_MANAGED files (CLAUDE.md, AGENTS.md).
+ *   Use during re-install — tag injection updates in-place, so no cleanup needed.
+ *   Default false (full cleanup, used by uninstall).
+ */
+export function cleanManifestFiles(manifest, opts) {
     let removed = 0;
     let skipped = 0;
     // Remove files first (deepest paths first)
@@ -169,10 +154,14 @@ export function cleanManifestFiles(manifest) {
             skipped++;
             continue;
         }
-        // Content-managed files: remove added content instead of deleting
+        // Content-managed files: skip during re-install, clean during uninstall
         if (CONTENT_MANAGED.has(name)) {
+            if (opts?.skipContentManaged) {
+                skipped++;
+                continue;
+            }
             try {
-                if (cleanClaudeMd(entry.path))
+                if (cleanInjectedDoc(entry.path))
                     removed++;
             }
             catch { /* skip */ }

package/dist/src/core/manifest.js.map

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

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

@@ -0,0 +1,72 @@
+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;
+//# sourceMappingURL=tag-injector.d.ts.map

package/dist/src/core/tag-injector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag-injector.d.ts","sourceRoot":"","sources":["../../../src/core/tag-injector.ts"],"names":[],"mappings":"AAsBA,OAAO,EAGL,KAAK,QAAQ,EACd,MAAM,eAAe,CAAC;AAEvB,kEAAkE;AAClE,eAAO,MAAM,eAAe,SAAS,CAAC;AAEtC,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD;AAiBD;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAgBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAY1E;AAED,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAE5E,MAAM,WAAW,aAAa;IAC5B,4BAA4B;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,MAAwB,GAChC,aAAa,CAsDf;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,MAAwB,GAChC,MAAM,CA0BR;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAAwB,GAAG,MAAM,CAgBrF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoBtD;AAMD,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,aAAa,CAgBf"}

package/dist/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/dist/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/dist/src/index.d.ts

@@ -4,5 +4,9 @@ export { loadConfig, saveConfig } from './config/index.js';
 export { paths } from './config/paths.js';
 export { createManifest, addFile, addDir, saveManifest, findManifest, getAllManifests, deleteManifest, cleanManifestFiles, } from './core/manifest.js';
 export type { Manifest, ManifestEntry } from './core/manifest.js';
+export { migrateAndInject, injectContent, injectDocFile, removeContent, removeAllSections, hasSection, hasAnyMarkers, } from './core/tag-injector.js';
+export type { MigrateResult, MigrateAction, CopyStats } from './core/tag-injector.js';
+export { COMPONENT_DEFS } from './core/component-defs.js';
+export type { ComponentDef } from './core/component-defs.js';
 export type * from './types/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EACL,cAAc,EACd,OAAO,EACP,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,cAAc,EACd,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAClE,mBAAmB,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EACL,cAAc,EACd,OAAO,EACP,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,cAAc,EACd,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,aAAa,GACd,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,mBAAmB,kBAAkB,CAAC"}

package/dist/src/index.js

@@ -3,4 +3,6 @@ export { ExtensionLoader } from './core/extension-loader.js';
 export { loadConfig, saveConfig } from './config/index.js';
 export { paths } from './config/paths.js';
 export { createManifest, addFile, addDir, saveManifest, findManifest, getAllManifests, deleteManifest, cleanManifestFiles, } from './core/manifest.js';
+export { migrateAndInject, injectContent, injectDocFile, removeContent, removeAllSections, hasSection, hasAnyMarkers, } from './core/tag-injector.js';
+export { COMPONENT_DEFS } from './core/component-defs.js';
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EACL,cAAc,EACd,OAAO,EACP,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,cAAc,EACd,kBAAkB,GACnB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EACL,cAAc,EACd,OAAO,EACP,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,cAAc,EACd,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,aAAa,GACd,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../src/cli.ts","../src/index.ts","../src/agents/cli-agent-runner.ts","../src/agents/cli-history-store.ts","../src/agents/dashboard-bridge.ts","../src/agents/parallel-cli-runner.ts","../src/agents/terminal-adapter.ts","../src/agents/terminal-backend.ts","../src/async/delegate-broker-client.ts","../src/async/delegate-broker.ts","../src/async/delegate-control.ts","../src/async/index.ts","../src/brainstorm-visualize/frame.ts","../src/brainstorm-visualize/server.ts","../src/commands/brainstorm-visualize.ts","../src/commands/cli.ts","../src/commands/collab.ts","../src/commands/coordinate.ts","../src/commands/delegate.ts","../src/commands/ext.ts","../src/commands/hooks.ts","../src/commands/install-backend.ts","../src/commands/install.ts","../src/commands/knowhow.ts","../src/commands/launcher.ts","../src/commands/msg.ts","../src/commands/overlay.ts","../src/commands/run.ts","../src/commands/serve.ts","../src/commands/spec.ts","../src/commands/stop.ts","../src/commands/tool.ts","../src/commands/uninstall.ts","../src/commands/update.ts","../src/commands/view.ts","../src/commands/wiki.ts","../src/commands/install-ui/backupconfig.tsx","../src/commands/install-ui/blueprintpreview.logic.ts","../src/commands/install-ui/blueprintpreview.tsx","../src/commands/install-ui/componentgrid.logic.ts","../src/commands/install-ui/componentgrid.tsx","../src/commands/install-ui/configpanel.tsx","../src/commands/install-ui/cyberitem.tsx","../src/commands/install-ui/cyberdeckblueprint.tsx","../src/commands/install-ui/executionview.tsx","../src/commands/install-ui/gradientheader.tsx","../src/commands/install-ui/hooksconfig.tsx","../src/commands/install-ui/installconfirm.tsx","../src/commands/install-ui/installexecution.tsx","../src/commands/install-ui/installflow.tsx","../src/commands/install-ui/installhub.tsx","../src/commands/install-ui/installresult.tsx","../src/commands/install-ui/mcpconfig.tsx","../src/commands/install-ui/resultdashboard.tsx","../src/commands/install-ui/reviewpanel.tsx","../src/commands/install-ui/shortcutfooter.tsx","../src/commands/install-ui/statuslineconfig.tsx","../src/commands/install-ui/stepselector.tsx","../src/commands/install-ui/index.ts","../src/commands/install-ui/types.ts","../src/commands/overlay-ui/overlaylist.tsx","../src/commands/overlay-ui/index.ts","../src/commands/uninstall-ui/uninstallflow.tsx","../src/commands/uninstall-ui/index.ts","../src/config/cli-tools-config.ts","../src/config/index.ts","../src/config/paths.ts","../src/config/template-discovery.ts","../src/coordinator/cli-executor.ts","../src/coordinator/coordinate-broker-adapter.ts","../src/coordinator/expr-evaluator.ts","../src/coordinator/graph-loader.ts","../src/coordinator/graph-types.ts","../src/coordinator/graph-walker.ts","../src/coordinator/index.ts","../src/coordinator/intent-router.ts","../src/coordinator/llm-decider.ts","../src/coordinator/output-parser.ts","../src/coordinator/parallel-executor.ts","../src/coordinator/prompt-assembler.ts","../src/coordinator/step-analyzer.ts","../src/core/component-defs.ts","../src/core/extension-loader.ts","../src/core/manifest.ts","../src/core/tag-injector.ts","../src/core/tool-registry.ts","../src/core/overlay/applier.ts","../src/core/overlay/loader.ts","../src/core/overlay/patcher.ts","../src/core/overlay/section-parser.ts","../src/core/overlay/types.ts","../src/db/connection-pool.ts","../src/db/index.ts","../src/db/tenant-migrator.ts","../src/db/tenant-schema.ts","../src/db/schema/core/index.ts","../src/db/schema/core/organizations.ts","../src/db/schema/core/permissions.ts","../src/db/schema/core/refresh-tokens.ts","../src/db/schema/core/users.ts","../src/hooks/auto-mode.ts","../src/hooks/constants.ts","../src/hooks/context-budget.ts","../src/hooks/context-monitor.ts","../src/hooks/coordinator-tracker.ts","../src/hooks/delegate-monitor.ts","../src/hooks/hook-engine.ts","../src/hooks/hook-manager.ts","../src/hooks/index.ts","../src/hooks/keyword-spec-injector.ts","../src/hooks/preflight-core.ts","../src/hooks/session-context.ts","../src/hooks/skill-context.ts","../src/hooks/spec-bridge.ts","../src/hooks/spec-injector.ts","../src/hooks/statusline.ts","../src/hooks/team-monitor.ts","../src/hooks/workflow-hooks.ts","../src/hooks/workspace.ts","../src/hooks/__tests__/statusline-visual-test.ts","../src/hooks/guards/index.ts","../src/hooks/guards/preflight-guard.ts","../src/hooks/guards/prompt-guard.ts","../src/hooks/guards/spec-validator.ts","../src/hooks/guards/workflow-guard.ts","../src/hooks/plugins/index.ts","../src/hooks/plugins/spec-injection-plugin.ts","../src/hooks/plugins/telemetry-plugin.ts","../src/i18n/detect.ts","../src/i18n/index.ts","../src/i18n/types.ts","../src/i18n/locales/en.ts","../src/i18n/locales/zh.ts","../src/mcp/delegate-channel-relay.ts","../src/mcp/server.ts","../src/middleware/auth.ts","../src/middleware/permission.ts","../src/middleware/rate-limit.ts","../src/middleware/tenant.ts","../src/middleware/validation.ts","../src/migrations/_template.ts","../src/migrations/index.ts","../src/migrations/run.ts","../src/migrations/v1-to-v2.ts","../src/routes/auth.ts","../src/routes/members.ts","../src/routes/organizations.ts","../src/services/auth.service.ts","../src/services/password.service.ts","../src/services/rbac.service.ts","../src/services/token.service.ts","../src/team/phase-orchestrator.ts","../src/team/phase-types.ts","../src/tools/collab-adapter.ts","../src/tools/edit-file.ts","../src/tools/index.ts","../src/tools/merge-validator.ts","../src/tools/namespace-guard.ts","../src/tools/phase-gate-evaluator.ts","../src/tools/read-file.ts","../src/tools/read-many-files.ts","../src/tools/spec-entry-parser.ts","../src/tools/spec-init.ts","../src/tools/spec-keyword-index.ts","../src/tools/spec-loader.ts","../src/tools/store-knowhow.ts","../src/tools/team-activity.ts","../src/tools/team-agents.ts","../src/tools/team-mailbox.ts","../src/tools/team-members.ts","../src/tools/team-msg.ts","../src/tools/team-tasks-mcp.ts","../src/tools/team-tasks.ts","../src/tools/transition-recorder.ts","../src/tools/write-file.ts","../src/types/hono.d.ts","../src/types/index.ts","../src/types/tool-schema.ts","../src/utils/cli-format.ts","../src/utils/file-reader.ts","../src/utils/get-version.ts","../src/utils/jsonl-log.ts","../src/utils/migration-registry.ts","../src/utils/path-validator.ts","../src/utils/state-schema.ts","../shared/agent-types.ts"],"version":"5.9.3"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "maestro-flow",
-  "version": "0.3.22",
+  "version": "0.3.23",
   "description": "Workflow orchestration CLI with MCP endpoint support and extensible architecture",
   "type": "module",
   "imports": {

package/templates/cli/prompts/workflow-skill-conflict-patterns.txt

@@ -77,7 +77,7 @@ MODE: analysis
 CONTEXT: @.workflow/.archives/*/IMPL_PLAN.md @.workflow/.archives/manifest.json
 EXPECTED: Conflict patterns with frequency and resolution
 CONSTRAINTS: analysis=READ-ONLY
-" --to gemini --mode analysis --rule workflow-skill-aggregation --cd .workflow/.archives
+" --role analyze --mode analysis --rule workflow-skill-aggregation --cd .workflow/.archives
 ```
 
 **Pattern Grouping**:

package/templates/cli/prompts/workflow-skill-lessons-learned.txt

@@ -73,7 +73,7 @@ MODE: analysis
 CONTEXT: @.workflow/.archives/manifest.json
 EXPECTED: Aggregated lessons with frequency counts
 CONSTRAINTS: analysis=READ-ONLY
-" --to gemini --mode analysis --rule workflow-skill-aggregation --cd .workflow/.archives
+" --role analyze --mode analysis --rule workflow-skill-aggregation --cd .workflow/.archives
 ```
 
 **Severity Classification**:

package/templates/search-tools.md

@@ -17,7 +17,7 @@ Semantic Search → Grep (pattern) → Glob (files) → CLI (deep analysis)
 | Find by intent/behavior | Semantic search tool (see above) |
 | Known identifier/regex | `Grep` |
 | Find files by name/ext | `Glob` |
-| Complex cross-file reasoning | `maestro delegate --to gemini --mode analysis` |
+| Complex cross-file reasoning | `maestro delegate --role analyze --mode analysis` |
 | Read identified file | `Read` |
 
 ## Fallback

package/templates/workflows/specs/node-catalog.md

@@ -128,7 +128,7 @@ Deliver: [specify expected output format]
 | `testing` | skill | `quality-test` |
 | `review` | skill | `quality-review` |
 | `brainstorm` | skill | `maestro-brainstorm` |
-| `analysis` | cli | `maestro delegate --to gemini --mode analysis` |
+| `analysis` | cli | `maestro delegate --role analyze --mode analysis` |
 | `spec` | skill | `maestro-spec-generate` |
 | `refactor` | skill | `quality-refactor` |
 | `integration-test` | skill | `quality-integration-test` |

package/workflows/brainstorm.md

@@ -432,7 +432,7 @@ Execute analysis for ONE specified role with optional interactive context gather
 - Enhancements applied (EP-IDs)
 - Complexity score and review status
 - Next:
-  Skill({ skill: "maestro-spec-generate", args: "--from-brainstorm {sessionId}" })  — Generate full spec package
+  Skill({ skill: "maestro-roadmap", args: "--mode full --from-brainstorm {sessionId}" })  — Generate full spec package
   Skill({ skill: "maestro-analyze", args: "{topic}" })   — Evaluate feasibility + lock decisions
   Skill({ skill: "maestro-analyze", args: "{phase} -q" })   — Quick decision extraction only
   Skill({ skill: "maestro-plan", args: "{phase}" })       — Plan directly (if scope is clear)

package/{.claude/CLAUDE.md → workflows/claude-instructions.md}

@@ -1,26 +1,25 @@
-# Maestro
-
-Workflow orchestration CLI with MCP endpoint support and extensible architecture.
-
-- **Coding Philosophy**: @~/.maestro/workflows/coding-philosophy.md
-
-## Delegate & CLI
-
-- **Delegate Usage**: @~/.maestro/workflows/delegate-usage.md
-- **CLI Endpoints Config**: @~/.maestro/cli-tools.json
-
-**Strictly follow the cli-tools.json configuration**
-
-Available CLI endpoints are dynamically defined by the config file
-
-## Code Diagnostics
-
-- **Prefer `mcp__ide__getDiagnostics`** for code error checking over shell-based TypeScript compilation
-
-## Knowledge Capture
-
-- **Spec writes** → always `<spec-entry>` closed-tag format with `category`, `keywords`, `date`, `source`. Never raw Markdown. Route through `spec-add` when possible.
-- **Capture signal** → when execution surfaces non-obvious knowledge (plan deviation, retry pattern, root cause, constraint violation), ask user once whether to persist it. Match category to content: decisions→`arch`, pitfalls→`debug`/`learning`, patterns→`coding`, rules→`quality`.
-- **Promotion** → at milestone close, scan learnings for repeated keywords (≥2 entries) and offer to graduate them into formal conventions.
-- **Traceability** → every entry needs a source anchor: `file:line`, `INS-{id}`, commit, or phase path.
-
+# Maestro
+
+Workflow orchestration CLI with MCP endpoint support and extensible architecture.
+
+- **Coding Philosophy**: @~/.maestro/workflows/coding-philosophy.md
+
+## Delegate & CLI
+
+- **Delegate Usage**: @~/.maestro/workflows/delegate-usage.md
+- **CLI Endpoints Config**: @~/.maestro/cli-tools.json
+
+**Strictly follow the cli-tools.json configuration**
+
+Available CLI endpoints are dynamically defined by the config file
+
+## Code Diagnostics
+
+- **Prefer `mcp__ide__getDiagnostics`** for code error checking over shell-based TypeScript compilation
+
+## Knowledge Capture
+
+- **Spec writes** → always `<spec-entry>` closed-tag format with `category`, `keywords`, `date`, `source`. Never raw Markdown. Route through `spec-add` when possible.
+- **Capture signal** → when execution surfaces non-obvious knowledge (plan deviation, retry pattern, root cause, constraint violation), ask user once whether to persist it. Match category to content: decisions→`arch`, pitfalls→`debug`/`learning`, patterns→`coding`, rules→`quality`.
+- **Promotion** → at milestone close, scan learnings for repeated keywords (≥2 entries) and offer to graduate them into formal conventions.
+- **Traceability** → every entry needs a source anchor: `file:line`, `INS-{id}`, commit, or phase path.