@memoarchitect/tools 0.4.4

package/packages/tools/lib/operations/project-snapshot.js

@@ -0,0 +1,103 @@
+import { readdirSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { buildMemoModel } from '../model/builder.js';
+import { compileWithConfiguredTool } from '../model/toolchain.js';
+import { computeCompleteness } from '../completeness/tracker.js';
+import { deriveModelViews } from '../model/view-deriver.js';
+import { findConfigFile } from '../model/config-loader.js';
+import { loadOntologyRegistries } from '../model/ontology-loader.js';
+import { parseFiles } from '../model/parser-utils.js';
+import { validateModel } from '../validator/rule-engine.js';
+import { modelToDTO } from '../model/semantic.js';
+import { loadAndResolveConfig } from '../server/config-resolver.js';
+function findSysmlFiles(dir) {
+    const files = [];
+    try {
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+            const full = resolve(dir, entry.name);
+            if (entry.isDirectory() && entry.name !== 'node_modules' && entry.name !== '.memo') {
+                files.push(...findSysmlFiles(full));
+            }
+            else if (entry.name.endsWith('.sysml')) {
+                files.push(full);
+            }
+        }
+    }
+    catch {
+        // Ignore unreadable directories.
+    }
+    return files;
+}
+/** Build the immutable data payload consumed by exports and Architect. */
+export async function buildProjectSnapshot(projectRoot = process.cwd()) {
+    const cwd = resolve(projectRoot);
+    const configPath = findConfigFile(cwd);
+    if (!configPath) {
+        throw new Error('No memo config found. Run `memo init` first.');
+    }
+    const config = loadAndResolveConfig(configPath);
+    const compiler = compileWithConfiguredTool(config, cwd, configPath);
+    let ontologyRegistries;
+    try {
+        const loadResult = await loadOntologyRegistries(configPath);
+        if (loadResult.fileCount > 0)
+            ontologyRegistries = loadResult.registries;
+    }
+    catch {
+        // Snapshot generation remains available with reduced kind resolution.
+    }
+    const { documents, errors } = await parseFiles(findSysmlFiles(cwd), `${cwd}/`);
+    const semanticModel = buildMemoModel(documents, config, errors, ontologyRegistries);
+    const validation = validateModel(semanticModel);
+    const completeness = computeCompleteness(semanticModel, validation, config);
+    const viewpoints = config.viewpoints?.map(vp => ({
+        id: vp.id,
+        label: vp.label,
+        visibleKinds: vp.visibleKinds,
+        visibleRelationships: vp.visibleRelationships,
+        visibleLayers: vp.visibleLayers,
+    })) ?? [];
+    const architectureLayers = config.architectureLayers?.map(layer => ({
+        id: layer.id,
+        label: layer.label,
+        color: layer.color,
+    }));
+    const diagrams = [];
+    for (const [layerId, layerElements] of semanticModel.elementsByLayer.entries()) {
+        if (layerElements.length === 0)
+            continue;
+        const label = layerId.charAt(0).toUpperCase() + layerId.slice(1);
+        diagrams.push({
+            id: `diag-layer-${layerId}`,
+            name: `${label} Layer`,
+            diagramType: 'bdd',
+            viewKind: 'general',
+            viewpointId: '__model',
+            auto: true,
+            description: `${label} architecture layer — ${layerElements.length} elements`,
+            elementIds: layerElements.map(element => element.id),
+        });
+    }
+    const derivedViews = deriveModelViews(semanticModel, ontologyRegistries?.kindRegistry);
+    viewpoints.push(...derivedViews.viewpoints);
+    diagrams.push(...derivedViews.diagrams);
+    return {
+        projectRoot: cwd,
+        configPath,
+        config,
+        model: modelToDTO(semanticModel, { viewpoints, architectureLayers, diagrams }),
+        validation,
+        completeness,
+        compiler,
+    };
+}
+/** Serialize data for an inline script without permitting script termination. */
+export function serializeForInlineScript(value) {
+    return JSON.stringify(value)
+        .replace(/&/g, '\\u0026')
+        .replace(/</g, '\\u003c')
+        .replace(/>/g, '\\u003e')
+        .replace(/\u2028/g, '\\u2028')
+        .replace(/\u2029/g, '\\u2029');
+}
+//# sourceMappingURL=project-snapshot.js.map

package/packages/tools/lib/operations/project-snapshot.js.map

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

package/packages/tools/lib/plugin/index.d.ts

@@ -0,0 +1,5 @@
+export * from './plugin-types.js';
+export * from './plugin-registry.js';
+export * from './plugin-loader.js';
+export * from './plugin-scaffold.js';
+//# sourceMappingURL=index.d.ts.map

package/packages/tools/lib/plugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAMA,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC"}

package/packages/tools/lib/plugin/index.js

@@ -0,0 +1,10 @@
+// ─── Plugin Module ───────────────────────────────────────────────────────────
+//
+// M78: Plugin system for custom export formats, analysis tools, validation
+// rules, and content generators. Inspired by EventCatalog's generator pattern.
+// ─────────────────────────────────────────────────────────────────────────────
+export * from './plugin-types.js';
+export * from './plugin-registry.js';
+export * from './plugin-loader.js';
+export * from './plugin-scaffold.js';
+//# sourceMappingURL=index.js.map

package/packages/tools/lib/plugin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,EAAE;AACF,2EAA2E;AAC3E,+EAA+E;AAC/E,gFAAgF;AAEhF,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC"}

package/packages/tools/lib/plugin/plugin-loader.d.ts

@@ -0,0 +1,26 @@
+import type { MemoPlugin, PluginEntry, PluginManifest } from './plugin-types.js';
+import { PluginRegistry } from './plugin-registry.js';
+/** Result of loading plugins */
+export interface PluginLoadResult {
+    /** Successfully loaded plugins */
+    loaded: MemoPlugin[];
+    /** Errors encountered during loading */
+    errors: Array<{
+        module: string;
+        error: string;
+    }>;
+}
+/**
+ * Load plugins from an array of plugin entries (from config).
+ * Returns loaded plugins and any errors.
+ */
+export declare function loadPlugins(entries: PluginEntry[], projectDir: string, registry?: PluginRegistry): Promise<PluginLoadResult>;
+/**
+ * Load a plugin manifest from a directory.
+ */
+export declare function loadPluginManifest(pluginDir: string): PluginManifest | undefined;
+/**
+ * Load plugin entries from a memo.plugins.yaml file.
+ */
+export declare function loadPluginConfig(projectDir: string): PluginEntry[];
+//# sourceMappingURL=plugin-loader.d.ts.map

package/packages/tools/lib/plugin/plugin-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-loader.d.ts","sourceRoot":"","sources":["../../src/plugin/plugin-loader.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,gCAAgC;AAChC,MAAM,WAAW,gBAAgB;IAC7B,kCAAkC;IAClC,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,wCAAwC;IACxC,MAAM,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC7B,OAAO,EAAE,WAAW,EAAE,EACtB,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,cAAc,GAC1B,OAAO,CAAC,gBAAgB,CAAC,CAsB3B;AA+DD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAYhF;AA4BD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,EAAE,CAWlE"}

package/packages/tools/lib/plugin/plugin-loader.js

@@ -0,0 +1,216 @@
+// ─── MEMO Plugin Loader ──────────────────────────────────────────────────────
+//
+// Loads plugins from npm packages or local files. Follows EventCatalog's
+// convention: plugins are modules that export a default plugin object or
+// a factory function.
+//
+// Module resolution:
+//   - Local path (starts with . or /): resolved relative to project dir
+//   - npm package: resolved via Node.js module resolution
+//
+// Plugin module contract:
+//   export default: MemoPlugin | ((options?) => MemoPlugin)
+// ─────────────────────────────────────────────────────────────────────────────
+import { resolve, join } from 'node:path';
+import { existsSync, readFileSync } from 'node:fs';
+/**
+ * Load plugins from an array of plugin entries (from config).
+ * Returns loaded plugins and any errors.
+ */
+export async function loadPlugins(entries, projectDir, registry) {
+    const loaded = [];
+    const errors = [];
+    for (const entry of entries) {
+        if (entry.enabled === false)
+            continue;
+        try {
+            const plugin = await loadSinglePlugin(entry, projectDir);
+            loaded.push(plugin);
+            if (registry) {
+                registry.register(plugin);
+            }
+        }
+        catch (err) {
+            errors.push({
+                module: entry.module,
+                error: err.message || String(err),
+            });
+        }
+    }
+    return { loaded, errors };
+}
+/**
+ * Load a single plugin from a module path.
+ */
+async function loadSinglePlugin(entry, projectDir) {
+    const modulePath = resolveModulePath(entry.module, projectDir);
+    // Dynamic import
+    let mod;
+    try {
+        mod = await import(modulePath);
+    }
+    catch (err) {
+        throw new Error(`Failed to import plugin module "${entry.module}": ${err.message}`);
+    }
+    // Resolve the plugin from the module export
+    const exported = mod.default || mod;
+    let plugin;
+    if (typeof exported === 'function') {
+        // Factory function: (options?) => MemoPlugin
+        plugin = exported(entry.options || {});
+    }
+    else if (typeof exported === 'object' && exported.id && exported.type) {
+        // Direct plugin object
+        plugin = exported;
+    }
+    else {
+        throw new Error(`Plugin module "${entry.module}" must export a MemoPlugin object or a factory function. ` +
+            `Got: ${typeof exported}`);
+    }
+    // Validate minimal shape
+    if (!plugin.id || !plugin.type || !plugin.name || !plugin.version) {
+        throw new Error(`Plugin from "${entry.module}" is missing required fields (id, type, name, version). ` +
+            `Got: id=${plugin.id}, type=${plugin.type}, name=${plugin.name}, version=${plugin.version}`);
+    }
+    return plugin;
+}
+/**
+ * Resolve a module path to an importable URL/path.
+ */
+function resolveModulePath(moduleName, projectDir) {
+    // Local path: starts with . or /
+    if (moduleName.startsWith('.') || moduleName.startsWith('/')) {
+        const absolute = resolve(projectDir, moduleName);
+        // Check for .js, .ts, .mjs variants
+        for (const ext of ['', '.js', '.mjs', '/index.js', '/index.mjs']) {
+            const candidate = absolute + ext;
+            if (existsSync(candidate))
+                return candidate;
+        }
+        return absolute; // Let import() fail with a clear error
+    }
+    // npm package — return as-is for Node.js resolution
+    return moduleName;
+}
+/**
+ * Load a plugin manifest from a directory.
+ */
+export function loadPluginManifest(pluginDir) {
+    const manifestPath = join(pluginDir, 'memo.plugin.yaml');
+    if (!existsSync(manifestPath))
+        return undefined;
+    try {
+        // Use dynamic import for yaml to avoid circular deps
+        const content = readFileSync(manifestPath, 'utf-8');
+        // Simple YAML parsing for manifest (key: value format)
+        return parseSimpleYaml(content);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Parse simple flat YAML (enough for plugin manifests) */
+function parseSimpleYaml(content) {
+    const result = {};
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const colonIdx = trimmed.indexOf(':');
+        if (colonIdx === -1)
+            continue;
+        const key = trimmed.slice(0, colonIdx).trim();
+        let value = trimmed.slice(colonIdx + 1).trim();
+        // Remove quotes
+        if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        // Handle arrays (simple inline format: [a, b, c])
+        if (value.startsWith('[') && value.endsWith(']')) {
+            value = value.slice(1, -1).split(',').map((s) => s.trim().replace(/^["']|["']$/g, ''));
+        }
+        // Handle booleans
+        if (value === 'true')
+            value = true;
+        else if (value === 'false')
+            value = false;
+        result[key] = value;
+    }
+    return result;
+}
+/**
+ * Load plugin entries from a memo.plugins.yaml file.
+ */
+export function loadPluginConfig(projectDir) {
+    const configPath = join(projectDir, 'memo.plugins.yaml');
+    if (!existsSync(configPath))
+        return [];
+    try {
+        const content = readFileSync(configPath, 'utf-8');
+        // Parse YAML plugin entries
+        return parsePluginEntries(content);
+    }
+    catch {
+        return [];
+    }
+}
+/** Parse plugin entries from YAML content */
+function parsePluginEntries(content) {
+    const entries = [];
+    const lines = content.split('\n');
+    let currentEntry = null;
+    let inOptions = false;
+    let options = {};
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        // New plugin entry (starts with - module:)
+        if (trimmed.startsWith('- module:')) {
+            if (currentEntry?.module) {
+                entries.push({
+                    module: currentEntry.module,
+                    options: Object.keys(options).length > 0 ? options : undefined,
+                    enabled: currentEntry.enabled,
+                });
+            }
+            currentEntry = { module: trimmed.slice('- module:'.length).trim().replace(/^["']|["']$/g, '') };
+            inOptions = false;
+            options = {};
+            continue;
+        }
+        if (!currentEntry)
+            continue;
+        if (trimmed.startsWith('enabled:')) {
+            currentEntry.enabled = trimmed.slice('enabled:'.length).trim() !== 'false';
+        }
+        else if (trimmed === 'options:') {
+            inOptions = true;
+        }
+        else if (inOptions && trimmed.includes(':')) {
+            const colonIdx = trimmed.indexOf(':');
+            const key = trimmed.slice(0, colonIdx).trim();
+            let value = trimmed.slice(colonIdx + 1).trim();
+            if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+                value = value.slice(1, -1);
+            }
+            if (value === 'true')
+                value = true;
+            else if (value === 'false')
+                value = false;
+            else if (!isNaN(Number(value)) && value !== '')
+                value = Number(value);
+            options[key] = value;
+        }
+    }
+    // Push last entry
+    if (currentEntry?.module) {
+        entries.push({
+            module: currentEntry.module,
+            options: Object.keys(options).length > 0 ? options : undefined,
+            enabled: currentEntry.enabled,
+        });
+    }
+    return entries;
+}
+//# sourceMappingURL=plugin-loader.js.map

package/packages/tools/lib/plugin/plugin-loader.js.map

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

package/packages/tools/lib/plugin/plugin-registry.d.ts

@@ -0,0 +1,49 @@
+import type { MemoPlugin, PluginType, ExportPlugin, AnalysisPlugin, ValidationPlugin, GeneratorPlugin, PluginContext, AnalysisResult, ExportResult } from './plugin-types.js';
+import type { DhfDocument } from '../dhf/document-ir.js';
+import type { Violation } from '../validator/types.js';
+/** Plugin registry — manages all registered plugins */
+export declare class PluginRegistry {
+    private plugins;
+    /** Number of registered plugins */
+    get size(): number;
+    /** Register a plugin. Overwrites any existing plugin with the same ID. */
+    register(plugin: MemoPlugin): void;
+    /** Unregister a plugin by ID */
+    unregister(id: string): boolean;
+    /** Get a plugin by ID */
+    get(id: string): MemoPlugin | undefined;
+    /** Get a typed plugin by ID */
+    getExport(id: string): ExportPlugin | undefined;
+    getAnalysis(id: string): AnalysisPlugin | undefined;
+    getValidation(id: string): ValidationPlugin | undefined;
+    getGenerator(id: string): GeneratorPlugin | undefined;
+    /** List all plugins, optionally filtered by type */
+    list(type?: PluginType): MemoPlugin[];
+    /** List export plugins */
+    listExports(): ExportPlugin[];
+    /** List analysis plugins */
+    listAnalysis(): AnalysisPlugin[];
+    /** List validation plugins */
+    listValidation(): ValidationPlugin[];
+    /** List generator plugins */
+    listGenerators(): GeneratorPlugin[];
+    /** Check if a plugin is registered */
+    has(id: string): boolean;
+    /** Clear all registered plugins */
+    clear(): void;
+    /** Run an export plugin by ID */
+    runExport(id: string, doc: DhfDocument, ctx: PluginContext, options?: Record<string, unknown>): Promise<ExportResult>;
+    /** Run an analysis plugin by ID */
+    runAnalysis(id: string, ctx: PluginContext, options?: Record<string, unknown>): Promise<AnalysisResult>;
+    /** Run a validation plugin by ID, returns violations */
+    runValidation(id: string, ctx: PluginContext, options?: Record<string, unknown>): Promise<Violation[]>;
+    /** Run all validation plugins, returns combined violations */
+    runAllValidation(ctx: PluginContext, options?: Record<string, unknown>): Promise<Violation[]>;
+    /** Run a generator plugin by ID */
+    runGenerator(id: string, ctx: PluginContext, options?: Record<string, unknown>): Promise<void>;
+    /** Run all generator plugins in sequence */
+    runAllGenerators(ctx: PluginContext, options?: Record<string, unknown>): Promise<string[]>;
+}
+/** Global plugin registry instance */
+export declare const globalPluginRegistry: PluginRegistry;
+//# sourceMappingURL=plugin-registry.d.ts.map

package/packages/tools/lib/plugin/plugin-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-registry.d.ts","sourceRoot":"","sources":["../../src/plugin/plugin-registry.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACR,UAAU,EACV,UAAU,EACV,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,cAAc,EACd,YAAY,EACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,uDAAuD;AACvD,qBAAa,cAAc;IACvB,OAAO,CAAC,OAAO,CAAiC;IAEhD,mCAAmC;IACnC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAIlC,gCAAgC;IAChC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI/B,yBAAyB;IACzB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIvC,+BAA+B;IAC/B,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAK/C,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAKnD,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAKvD,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAKrD,oDAAoD;IACpD,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,UAAU,EAAE;IAKrC,0BAA0B;IAC1B,WAAW,IAAI,YAAY,EAAE;IAI7B,4BAA4B;IAC5B,YAAY,IAAI,cAAc,EAAE;IAIhC,8BAA8B;IAC9B,cAAc,IAAI,gBAAgB,EAAE;IAIpC,6BAA6B;IAC7B,cAAc,IAAI,eAAe,EAAE;IAInC,sCAAsC;IACtC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB,mCAAmC;IACnC,KAAK,IAAI,IAAI;IAMb,iCAAiC;IAC3B,SAAS,CACX,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,aAAa,EAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,YAAY,CAAC;IAMxB,mCAAmC;IAC7B,WAAW,CACb,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,aAAa,EAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,cAAc,CAAC;IAM1B,wDAAwD;IAClD,aAAa,CACf,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,aAAa,EAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,SAAS,EAAE,CAAC;IAMvB,8DAA8D;IACxD,gBAAgB,CAClB,GAAG,EAAE,aAAa,EAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,SAAS,EAAE,CAAC;IASvB,mCAAmC;IAC7B,YAAY,CACd,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,aAAa,EAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,IAAI,CAAC;IAMhB,4CAA4C;IACtC,gBAAgB,CAClB,GAAG,EAAE,aAAa,EAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,MAAM,EAAE,CAAC;CAQvB;AAED,sCAAsC;AACtC,eAAO,MAAM,oBAAoB,gBAAuB,CAAC"}

package/packages/tools/lib/plugin/plugin-registry.js

@@ -0,0 +1,121 @@
+// ─── MEMO Plugin Registry ────────────────────────────────────────────────────
+//
+// Central registry for all MEMO plugins. Supports registration, lookup by
+// ID or type, and lifecycle management (initialize/cleanup).
+// ─────────────────────────────────────────────────────────────────────────────
+/** Plugin registry — manages all registered plugins */
+export class PluginRegistry {
+    plugins = new Map();
+    /** Number of registered plugins */
+    get size() {
+        return this.plugins.size;
+    }
+    /** Register a plugin. Overwrites any existing plugin with the same ID. */
+    register(plugin) {
+        this.plugins.set(plugin.id, plugin);
+    }
+    /** Unregister a plugin by ID */
+    unregister(id) {
+        return this.plugins.delete(id);
+    }
+    /** Get a plugin by ID */
+    get(id) {
+        return this.plugins.get(id);
+    }
+    /** Get a typed plugin by ID */
+    getExport(id) {
+        const p = this.plugins.get(id);
+        return p?.type === 'export' ? p : undefined;
+    }
+    getAnalysis(id) {
+        const p = this.plugins.get(id);
+        return p?.type === 'analysis' ? p : undefined;
+    }
+    getValidation(id) {
+        const p = this.plugins.get(id);
+        return p?.type === 'validation' ? p : undefined;
+    }
+    getGenerator(id) {
+        const p = this.plugins.get(id);
+        return p?.type === 'generator' ? p : undefined;
+    }
+    /** List all plugins, optionally filtered by type */
+    list(type) {
+        const all = Array.from(this.plugins.values());
+        return type ? all.filter(p => p.type === type) : all;
+    }
+    /** List export plugins */
+    listExports() {
+        return this.list('export');
+    }
+    /** List analysis plugins */
+    listAnalysis() {
+        return this.list('analysis');
+    }
+    /** List validation plugins */
+    listValidation() {
+        return this.list('validation');
+    }
+    /** List generator plugins */
+    listGenerators() {
+        return this.list('generator');
+    }
+    /** Check if a plugin is registered */
+    has(id) {
+        return this.plugins.has(id);
+    }
+    /** Clear all registered plugins */
+    clear() {
+        this.plugins.clear();
+    }
+    // ─── Convenience execution methods ──────────────────────────────────
+    /** Run an export plugin by ID */
+    async runExport(id, doc, ctx, options) {
+        const plugin = this.getExport(id);
+        if (!plugin)
+            throw new Error(`Export plugin not found: ${id}`);
+        return plugin.render(doc, ctx, options);
+    }
+    /** Run an analysis plugin by ID */
+    async runAnalysis(id, ctx, options) {
+        const plugin = this.getAnalysis(id);
+        if (!plugin)
+            throw new Error(`Analysis plugin not found: ${id}`);
+        return plugin.analyse(ctx, options);
+    }
+    /** Run a validation plugin by ID, returns violations */
+    async runValidation(id, ctx, options) {
+        const plugin = this.getValidation(id);
+        if (!plugin)
+            throw new Error(`Validation plugin not found: ${id}`);
+        return plugin.validate(ctx, options);
+    }
+    /** Run all validation plugins, returns combined violations */
+    async runAllValidation(ctx, options) {
+        const violations = [];
+        for (const plugin of this.listValidation()) {
+            const results = await plugin.validate(ctx, options);
+            violations.push(...results);
+        }
+        return violations;
+    }
+    /** Run a generator plugin by ID */
+    async runGenerator(id, ctx, options) {
+        const plugin = this.getGenerator(id);
+        if (!plugin)
+            throw new Error(`Generator plugin not found: ${id}`);
+        return plugin.generate(ctx, options);
+    }
+    /** Run all generator plugins in sequence */
+    async runAllGenerators(ctx, options) {
+        const ran = [];
+        for (const plugin of this.listGenerators()) {
+            await plugin.generate(ctx, options);
+            ran.push(plugin.id);
+        }
+        return ran;
+    }
+}
+/** Global plugin registry instance */
+export const globalPluginRegistry = new PluginRegistry();
+//# sourceMappingURL=plugin-registry.js.map

package/packages/tools/lib/plugin/plugin-registry.js.map

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

package/packages/tools/lib/plugin/plugin-scaffold.d.ts

@@ -0,0 +1,17 @@
+import type { PluginType } from './plugin-types.js';
+/** Options for scaffolding a plugin */
+export interface ScaffoldOptions {
+    name: string;
+    type: PluginType;
+    description?: string;
+    author?: string;
+    license?: string;
+}
+/** A scaffolded file */
+export interface ScaffoldFile {
+    path: string;
+    content: string;
+}
+/** Generate scaffold files for a new plugin */
+export declare function scaffoldPlugin(options: ScaffoldOptions): ScaffoldFile[];
+//# sourceMappingURL=plugin-scaffold.d.ts.map

package/packages/tools/lib/plugin/plugin-scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-scaffold.d.ts","sourceRoot":"","sources":["../../src/plugin/plugin-scaffold.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,uCAAuC;AACvC,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAwB;AACxB,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,+CAA+C;AAC/C,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,YAAY,EAAE,CAmFvE"}