maestro-flow 0.1.3 → 0.2.0

package/dist/src/core/overlay/applier.d.ts

@@ -0,0 +1,73 @@
+import { type OverlayManifest } from './types.js';
+export declare function loadOverlayManifest(scope: 'global' | 'project', targetBase: string): OverlayManifest | null;
+export declare function deleteOverlayManifest(scope: 'global' | 'project', targetBase: string): void;
+export interface ApplyOptions {
+    /** Root dir where `.claude/commands/` lives (homedir for global, project dir for project). */
+    targetBase: string;
+    scope: 'global' | 'project';
+    /** Directory containing overlay JSON files (usually `~/.maestro/overlays/`). */
+    overlayDir: string;
+    /** Optional logger; defaults to console.error. */
+    logger?: (msg: string) => void;
+}
+export interface ApplyReport {
+    manifest: OverlayManifest;
+    manifestPath: string;
+    overlaysLoaded: number;
+    overlaysApplied: number;
+    filesChanged: number;
+    filesUnchanged: number;
+    loadErrors: {
+        path: string;
+        errors: string[];
+    }[];
+    skipped: {
+        overlay: string;
+        target: string;
+        reason: string;
+    }[];
+}
+export declare function applyOverlays(opts: ApplyOptions): ApplyReport;
+export interface RemoveResult {
+    targetsCleaned: number;
+    filesChanged: number;
+}
+/**
+ * Remove all marker blocks for the given overlay name from every target
+ * command file recorded in the overlay manifest. Updates the manifest.
+ */
+export declare function removeOverlayFromTargets(overlayName: string, scope: 'global' | 'project', targetBase: string): RemoveResult;
+export declare function ensureOverlayDir(overlayDir: string): void;
+export interface ExportResult {
+    /** Source overlay file inside overlayDir. */
+    source: string;
+    /** Destination path the file was written to. */
+    dest: string;
+    overlayName: string;
+}
+/**
+ * Export an overlay by name from `overlayDir` to `outPath`.
+ *
+ * - If `outPath` is a directory, writes `<name>.json` inside it.
+ * - If `outPath` is a file path, writes verbatim (overwriting if present).
+ * - Throws if the overlay name is not found in `overlayDir`.
+ */
+export declare function exportOverlayFile(overlayDir: string, name: string, outPath: string): ExportResult;
+export interface ImportResult {
+    /** Source file the caller provided. */
+    source: string;
+    /** Destination path inside `overlayDir`. */
+    dest: string;
+    overlayName: string;
+    /** True if the destination already existed and was overwritten. */
+    overwritten: boolean;
+}
+/**
+ * Import an overlay JSON file into `overlayDir`. Validates before copy and
+ * throws if the file is not a valid overlay. Returns the destination path.
+ *
+ * Does not auto-apply — callers that want immediate effect should invoke
+ * `applyOverlays` afterwards.
+ */
+export declare function importOverlayFile(srcPath: string, overlayDir: string): ImportResult;
+//# sourceMappingURL=applier.d.ts.map

package/dist/src/core/overlay/applier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applier.d.ts","sourceRoot":"","sources":["../../../../src/core/overlay/applier.ts"],"names":[],"mappings":"AAyBA,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,YAAY,CAAC;AAiBpB,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,QAAQ,GAAG,SAAS,EAC3B,UAAU,EAAE,MAAM,GACjB,eAAe,GAAG,IAAI,CAQxB;AAUD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,QAAQ,GAAG,SAAS,EAC3B,UAAU,EAAE,MAAM,GACjB,IAAI,CAGN;AAMD,MAAM,WAAW,YAAY;IAC3B,8FAA8F;IAC9F,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,gFAAgF;IAChF,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,eAAe,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IACjD,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAChE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,WAAW,CAqG7D;AAMD,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,QAAQ,GAAG,SAAS,EAC3B,UAAU,EAAE,MAAM,GACjB,YAAY,CAyBd;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAKzD;AAMD,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,YAAY,CAmCd;AAED,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,YAAY,CA4Bd"}

package/dist/src/core/overlay/applier.js

@@ -0,0 +1,248 @@
+// ---------------------------------------------------------------------------
+// Applier — filesystem orchestration for overlay apply/remove.
+//
+// Reads overlays from `overlayDir`, applies each enabled overlay to its
+// declared targets under `<targetBase>/.claude/commands/`, and writes an
+// overlay manifest to `~/.maestro/manifests/overlays-<scope>.json`.
+//
+// Idempotent: re-running with no overlay changes produces byte-identical
+// output. Safe to call from install flow or standalone.
+// ---------------------------------------------------------------------------
+import { existsSync, mkdirSync, readFileSync, writeFileSync, readdirSync, unlinkSync, copyFileSync, statSync, } from 'node:fs';
+import { join, dirname, resolve } from 'node:path';
+import { paths } from '../../config/paths.js';
+import { loadAllOverlays, loadOverlay } from './loader.js';
+import { applyOverlay, removeOverlay as stripMarkers } from './patcher.js';
+import { OVERLAY_MANIFEST_VERSION, } from './types.js';
+// ---------------------------------------------------------------------------
+// Manifest persistence
+// ---------------------------------------------------------------------------
+function overlayManifestDir() {
+    return join(paths.home, 'manifests');
+}
+function overlayManifestPath(scope, targetBase) {
+    const safe = scope === 'global'
+        ? 'global'
+        : `project-${targetBase.replace(/[:\\/]+/g, '_')}`;
+    return join(overlayManifestDir(), `overlays-${safe}.json`);
+}
+export function loadOverlayManifest(scope, targetBase) {
+    const fp = overlayManifestPath(scope, targetBase);
+    if (!existsSync(fp))
+        return null;
+    try {
+        return JSON.parse(readFileSync(fp, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+function saveOverlayManifest(manifest) {
+    const dir = overlayManifestDir();
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    const fp = overlayManifestPath(manifest.scope, manifest.targetBase);
+    writeFileSync(fp, JSON.stringify(manifest, null, 2), 'utf-8');
+    return fp;
+}
+export function deleteOverlayManifest(scope, targetBase) {
+    const fp = overlayManifestPath(scope, targetBase);
+    if (existsSync(fp))
+        unlinkSync(fp);
+}
+export function applyOverlays(opts) {
+    const log = opts.logger ?? ((msg) => console.error(msg));
+    const commandsDir = join(opts.targetBase, '.claude', 'commands');
+    const { overlays, errors: loadErrors } = loadAllOverlays(opts.overlayDir);
+    const enabledOverlays = overlays.filter((o) => o.meta.enabled !== false);
+    const skipped = [];
+    const appliedOverlays = [];
+    let filesChanged = 0;
+    let filesUnchanged = 0;
+    // Group patches by target so each target file is read and written once
+    // per applyOverlays invocation.
+    const byTarget = new Map();
+    for (const overlay of enabledOverlays) {
+        for (const target of overlay.meta.targets) {
+            const cmdPath = join(commandsDir, `${target}.md`);
+            const disabledPath = cmdPath + '.disabled';
+            if (!existsSync(cmdPath)) {
+                if (existsSync(disabledPath)) {
+                    skipped.push({ overlay: overlay.meta.name, target, reason: 'disabled' });
+                }
+                else {
+                    skipped.push({ overlay: overlay.meta.name, target, reason: 'missing' });
+                }
+                continue;
+            }
+            const list = byTarget.get(cmdPath) ?? [];
+            list.push({ overlay, cmdPath });
+            byTarget.set(cmdPath, list);
+        }
+    }
+    // Track applied targets per overlay for manifest
+    const appliedByOverlay = new Map();
+    for (const overlay of enabledOverlays) {
+        appliedByOverlay.set(overlay.meta.name, {
+            overlayName: overlay.meta.name,
+            overlayHash: overlay.hash,
+            targets: [],
+        });
+    }
+    for (const [cmdPath, entries] of byTarget) {
+        let text = readFileSync(cmdPath, 'utf-8');
+        const originalText = text;
+        const appliedHere = [];
+        for (const { overlay } of entries) {
+            const result = applyOverlay(text, overlay, cmdPath.split(/[\\/]/).pop()?.replace(/\.md$/, '') ?? '', cmdPath);
+            text = result.text;
+            if (result.applied.markerIds.length > 0) {
+                appliedHere.push(result.applied);
+                appliedByOverlay.get(overlay.meta.name).targets.push(result.applied);
+            }
+        }
+        if (text !== originalText) {
+            writeFileSync(cmdPath, text, 'utf-8');
+            filesChanged++;
+        }
+        else {
+            filesUnchanged++;
+        }
+    }
+    for (const [, ao] of appliedByOverlay) {
+        if (ao.targets.length > 0)
+            appliedOverlays.push(ao);
+    }
+    const manifest = {
+        version: OVERLAY_MANIFEST_VERSION,
+        scope: opts.scope,
+        targetBase: opts.targetBase,
+        installedAt: new Date().toISOString(),
+        appliedOverlays,
+    };
+    const manifestPath = saveOverlayManifest(manifest);
+    if (loadErrors.length > 0) {
+        log(`  Overlay load errors: ${loadErrors.length}`);
+        for (const { path, errors } of loadErrors) {
+            log(`    ${path}: ${errors.join('; ')}`);
+        }
+    }
+    return {
+        manifest,
+        manifestPath,
+        overlaysLoaded: overlays.length,
+        overlaysApplied: appliedOverlays.length,
+        filesChanged,
+        filesUnchanged,
+        loadErrors,
+        skipped,
+    };
+}
+/**
+ * Remove all marker blocks for the given overlay name from every target
+ * command file recorded in the overlay manifest. Updates the manifest.
+ */
+export function removeOverlayFromTargets(overlayName, scope, targetBase) {
+    const manifest = loadOverlayManifest(scope, targetBase);
+    if (!manifest)
+        return { targetsCleaned: 0, filesChanged: 0 };
+    const entry = manifest.appliedOverlays.find((o) => o.overlayName === overlayName);
+    if (!entry)
+        return { targetsCleaned: 0, filesChanged: 0 };
+    let filesChanged = 0;
+    for (const tgt of entry.targets) {
+        if (!existsSync(tgt.commandPath))
+            continue;
+        const text = readFileSync(tgt.commandPath, 'utf-8');
+        const { text: cleaned } = stripMarkers(text, overlayName);
+        if (cleaned !== text) {
+            writeFileSync(tgt.commandPath, cleaned, 'utf-8');
+            filesChanged++;
+        }
+    }
+    // Update manifest
+    manifest.appliedOverlays = manifest.appliedOverlays.filter((o) => o.overlayName !== overlayName);
+    saveOverlayManifest(manifest);
+    return { targetsCleaned: entry.targets.length, filesChanged };
+}
+export function ensureOverlayDir(overlayDir) {
+    if (!existsSync(overlayDir))
+        mkdirSync(overlayDir, { recursive: true });
+    // Ensure docs subdir for overlay-referenced docs
+    const docsDir = join(overlayDir, 'docs');
+    if (!existsSync(docsDir))
+        mkdirSync(docsDir, { recursive: true });
+}
+/**
+ * Export an overlay by name from `overlayDir` to `outPath`.
+ *
+ * - If `outPath` is a directory, writes `<name>.json` inside it.
+ * - If `outPath` is a file path, writes verbatim (overwriting if present).
+ * - Throws if the overlay name is not found in `overlayDir`.
+ */
+export function exportOverlayFile(overlayDir, name, outPath) {
+    if (!existsSync(overlayDir)) {
+        throw new Error(`Overlay directory not found: ${overlayDir}`);
+    }
+    // Scan overlayDir (top-level only) for an overlay whose parsed name matches.
+    let source = null;
+    for (const entry of readdirSync(overlayDir)) {
+        if (!entry.endsWith('.json') || entry.startsWith('_'))
+            continue;
+        const fp = join(overlayDir, entry);
+        try {
+            const ov = loadOverlay(fp);
+            if (ov.meta.name === name) {
+                source = fp;
+                break;
+            }
+        }
+        catch {
+            // Skip unparseable files
+        }
+    }
+    if (!source) {
+        throw new Error(`Overlay not found: ${name} (searched ${overlayDir})`);
+    }
+    let dest = resolve(outPath);
+    if (existsSync(dest) && statSync(dest).isDirectory()) {
+        dest = join(dest, `${name}.json`);
+    }
+    const destDir = dirname(dest);
+    if (!existsSync(destDir))
+        mkdirSync(destDir, { recursive: true });
+    copyFileSync(source, dest);
+    return { source, dest, overlayName: name };
+}
+/**
+ * Import an overlay JSON file into `overlayDir`. Validates before copy and
+ * throws if the file is not a valid overlay. Returns the destination path.
+ *
+ * Does not auto-apply — callers that want immediate effect should invoke
+ * `applyOverlays` afterwards.
+ */
+export function importOverlayFile(srcPath, overlayDir) {
+    const source = resolve(srcPath);
+    if (!existsSync(source)) {
+        throw new Error(`File not found: ${source}`);
+    }
+    if (!statSync(source).isFile()) {
+        throw new Error(`Not a file: ${source}`);
+    }
+    // Validate (throws OverlayLoadError on failure).
+    const overlay = loadOverlay(source);
+    ensureOverlayDir(overlayDir);
+    // Use the overlay's declared name as filename for consistency on disk.
+    const dest = join(overlayDir, `${overlay.meta.name}.json`);
+    const overwritten = existsSync(dest) && resolve(dest) !== source;
+    if (resolve(dest) !== source) {
+        copyFileSync(source, dest);
+    }
+    return {
+        source,
+        dest,
+        overlayName: overlay.meta.name,
+        overwritten,
+    };
+}
+//# sourceMappingURL=applier.js.map

package/dist/src/core/overlay/applier.js.map

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

package/dist/src/core/overlay/loader.d.ts

@@ -0,0 +1,26 @@
+import { type OverlayFile } from './types.js';
+export declare class OverlayLoadError extends Error {
+    readonly filePath: string;
+    readonly errors: string[];
+    constructor(filePath: string, errors: string[]);
+}
+export declare function loadOverlay(filePath: string): OverlayFile;
+/** Returns a list of validation error strings. Empty = valid. */
+export declare function validateOverlayMeta(input: unknown): string[];
+export interface LoadAllResult {
+    overlays: OverlayFile[];
+    errors: {
+        path: string;
+        errors: string[];
+    }[];
+}
+/**
+ * Load all valid top-level overlay JSON files from `dir`.
+ * Ignores subdirectories (docs/, _shipped/ etc), files starting with `_`,
+ * and non-.json files. Returns both successful overlays and collected errors
+ * so callers can report them without throwing.
+ *
+ * Sorted by (priority ?? 50) asc, then name asc.
+ */
+export declare function loadAllOverlays(dir: string): LoadAllResult;
+//# sourceMappingURL=loader.d.ts.map

package/dist/src/core/overlay/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../../src/core/overlay/loader.ts"],"names":[],"mappings":"AAyBA,OAAO,EAEL,KAAK,WAAW,EAIjB,MAAM,YAAY,CAAC;AAKpB,qBAAa,gBAAiB,SAAQ,KAAK;aAEvB,QAAQ,EAAE,MAAM;aAChB,MAAM,EAAE,MAAM,EAAE;gBADhB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EAAE;CAKnC;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAwBzD;AAED,iEAAiE;AACjE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAwD5D;AAiCD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;CAC9C;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAwC1D"}

package/dist/src/core/overlay/loader.js

@@ -0,0 +1,199 @@
+// ---------------------------------------------------------------------------
+// Loader — reads overlay files from disk and validates them.
+//
+// Overlay file format: JSON at `~/.maestro/overlays/<name>.json`
+//
+// Example:
+//   {
+//     "name": "cli-verify-after-execute",
+//     "description": "Add CLI verification after execute",
+//     "targets": ["maestro-execute", "maestro-plan"],
+//     "priority": 50,
+//     "enabled": true,
+//     "patches": [
+//       {
+//         "section": "execution",
+//         "mode": "append",
+//         "content": "## CLI Verification\nRun `ccw cli ...`"
+//       }
+//     ]
+//   }
+// ---------------------------------------------------------------------------
+import { readdirSync, readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { createHash } from 'node:crypto';
+import { KNOWN_SECTIONS, } from './types.js';
+const VALID_MODES = ['append', 'prepend', 'replace', 'new-section'];
+const NAME_RE = /^[a-z0-9][a-z0-9-_]*$/;
+export class OverlayLoadError extends Error {
+    filePath;
+    errors;
+    constructor(filePath, errors) {
+        super(`Overlay load error in ${filePath}:\n  - ${errors.join('\n  - ')}`);
+        this.filePath = filePath;
+        this.errors = errors;
+        this.name = 'OverlayLoadError';
+    }
+}
+export function loadOverlay(filePath) {
+    const raw = readFileSync(filePath, 'utf-8');
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new OverlayLoadError(filePath, [`invalid JSON: ${msg}`]);
+    }
+    const errors = validateOverlayMeta(parsed);
+    if (errors.length > 0) {
+        throw new OverlayLoadError(filePath, errors);
+    }
+    const meta = parsed;
+    const hash = createHash('sha256').update(raw).digest('hex').slice(0, 8);
+    return {
+        meta,
+        sourcePath: filePath,
+        raw,
+        hash,
+    };
+}
+/** Returns a list of validation error strings. Empty = valid. */
+export function validateOverlayMeta(input) {
+    const errors = [];
+    if (!input || typeof input !== 'object') {
+        return ['overlay must be a JSON object'];
+    }
+    const obj = input;
+    if (typeof obj.name !== 'string' || !NAME_RE.test(obj.name)) {
+        errors.push('`name` must match /^[a-z0-9][a-z0-9-_]*$/');
+    }
+    if (obj.description !== undefined && typeof obj.description !== 'string') {
+        errors.push('`description` must be a string');
+    }
+    if (!Array.isArray(obj.targets) || obj.targets.length === 0) {
+        errors.push('`targets` must be a non-empty string array');
+    }
+    else {
+        for (const t of obj.targets) {
+            if (typeof t !== 'string' || !t.trim()) {
+                errors.push(`invalid target entry: ${JSON.stringify(t)}`);
+            }
+        }
+    }
+    if (obj.priority !== undefined && typeof obj.priority !== 'number') {
+        errors.push('`priority` must be a number');
+    }
+    if (obj.enabled !== undefined && typeof obj.enabled !== 'boolean') {
+        errors.push('`enabled` must be a boolean');
+    }
+    if (obj.scope !== undefined &&
+        obj.scope !== 'global' &&
+        obj.scope !== 'project' &&
+        obj.scope !== 'any') {
+        errors.push('`scope` must be one of: global | project | any');
+    }
+    if (obj.docs !== undefined) {
+        if (!Array.isArray(obj.docs)) {
+            errors.push('`docs` must be a string array');
+        }
+        else {
+            for (const d of obj.docs) {
+                if (typeof d !== 'string') {
+                    errors.push(`invalid docs entry: ${JSON.stringify(d)}`);
+                }
+            }
+        }
+    }
+    if (!Array.isArray(obj.patches) || obj.patches.length === 0) {
+        errors.push('`patches` must be a non-empty array');
+    }
+    else {
+        obj.patches.forEach((p, idx) => {
+            errors.push(...validatePatch(p, idx));
+        });
+    }
+    return errors;
+}
+function validatePatch(input, idx) {
+    const errs = [];
+    const prefix = `patches[${idx}]`;
+    if (!input || typeof input !== 'object') {
+        return [`${prefix}: must be an object`];
+    }
+    const p = input;
+    if (typeof p.section !== 'string' || !p.section.trim()) {
+        errs.push(`${prefix}.section must be a non-empty string`);
+    }
+    if (typeof p.mode !== 'string' || !VALID_MODES.includes(p.mode)) {
+        errs.push(`${prefix}.mode must be one of: ${VALID_MODES.join(' | ')}`);
+    }
+    if (typeof p.content !== 'string') {
+        errs.push(`${prefix}.content must be a string`);
+    }
+    if (p.mode === 'new-section') {
+        if (p.afterSection !== undefined && typeof p.afterSection !== 'string') {
+            errs.push(`${prefix}.afterSection must be a string if provided`);
+        }
+    }
+    else if (typeof p.section === 'string') {
+        // For existing-section modes, the section should be a known tag.
+        if (!KNOWN_SECTIONS.includes(p.section)) {
+            errs.push(`${prefix}.section "${p.section}" is not a known section (${KNOWN_SECTIONS.join(', ')})`);
+        }
+    }
+    return errs;
+}
+/**
+ * Load all valid top-level overlay JSON files from `dir`.
+ * Ignores subdirectories (docs/, _shipped/ etc), files starting with `_`,
+ * and non-.json files. Returns both successful overlays and collected errors
+ * so callers can report them without throwing.
+ *
+ * Sorted by (priority ?? 50) asc, then name asc.
+ */
+export function loadAllOverlays(dir) {
+    const result = { overlays: [], errors: [] };
+    if (!existsSync(dir))
+        return result;
+    const seenNames = new Set();
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        if (!entry.isFile())
+            continue;
+        if (!entry.name.endsWith('.json'))
+            continue;
+        if (entry.name.startsWith('_'))
+            continue;
+        const fp = join(dir, entry.name);
+        try {
+            const overlay = loadOverlay(fp);
+            if (seenNames.has(overlay.meta.name)) {
+                result.errors.push({
+                    path: fp,
+                    errors: [`duplicate overlay name: ${overlay.meta.name}`],
+                });
+                continue;
+            }
+            seenNames.add(overlay.meta.name);
+            result.overlays.push(overlay);
+        }
+        catch (err) {
+            if (err instanceof OverlayLoadError) {
+                result.errors.push({ path: err.filePath, errors: err.errors });
+            }
+            else {
+                const msg = err instanceof Error ? err.message : String(err);
+                result.errors.push({ path: fp, errors: [msg] });
+            }
+        }
+    }
+    result.overlays.sort((a, b) => {
+        const pa = a.meta.priority ?? 50;
+        const pb = b.meta.priority ?? 50;
+        if (pa !== pb)
+            return pa - pb;
+        return a.meta.name.localeCompare(b.meta.name);
+    });
+    return result;
+}
+//# sourceMappingURL=loader.js.map

package/dist/src/core/overlay/loader.js.map

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

package/dist/src/core/overlay/patcher.d.ts

@@ -0,0 +1,26 @@
+import type { AppliedTarget, OverlayFile } from './types.js';
+export declare function shortHash(input: string): string;
+export interface ApplyResult {
+    text: string;
+    applied: AppliedTarget;
+    /** True if the output is byte-identical to the input. */
+    unchanged: boolean;
+}
+/**
+ * Apply all of an overlay's patches to the target file content.
+ *
+ * The file is reparsed after each marker edit so subsequent patches see
+ * the updated line indices.
+ */
+export declare function applyOverlay(text: string, overlay: OverlayFile, commandName: string, commandPath: string): ApplyResult;
+/**
+ * Remove every marker block for a given overlay name from the text.
+ * Returns the cleaned text and the patch indices that were removed.
+ */
+export declare function removeOverlay(text: string, overlayName: string): {
+    text: string;
+    removed: number[];
+};
+/** Detect whether `text` already contains markers for this overlay name. */
+export declare function hasMarkers(text: string, overlayName: string): boolean;
+//# sourceMappingURL=patcher.d.ts.map

package/dist/src/core/overlay/patcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patcher.d.ts","sourceRoot":"","sources":["../../../../src/core/overlay/patcher.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EAEZ,MAAM,YAAY,CAAC;AAEpB,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AA4GD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,aAAa,CAAC;IACvB,yDAAyD;IACzD,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,WAAW,EACpB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,WAAW,CAqCb;AA8ED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAcrC;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAKrE"}