multimodel-dev-os 3.1.0 → 3.2.0

package/src/catalog/loader.js

@@ -0,0 +1,117 @@
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { sourceRoot } from '../core/globals.js';
+import { parseYaml } from '../core/yaml.js';
+import { loadRegistrySources } from '../registry/sources.js';
+import { loadRegistryPolicy } from '../core/policy.js';
+import { validateRegistryUrl } from '../registry/validation.js';
+
+export function loadCatalog(options = {}) {
+  let catalog;
+  if (options.allSources) {
+    catalog = loadAllCatalogs(options);
+  } else if (options.source) {
+    catalog = loadCatalogFromSource(options.source, options);
+  } else {
+    const path = join(sourceRoot, '.ai', 'plugins', 'catalog.yaml');
+    try {
+      if (existsSync(path)) {
+        const reg = parseYaml(readFileSync(path, 'utf8'));
+        catalog = reg.catalog || { plugins: [] };
+      } else {
+        catalog = { plugins: [] };
+      }
+    } catch (e) {
+      catalog = { plugins: [] };
+    }
+    (catalog.plugins || []).forEach(p => { p._source = 'bundled'; });
+  }
+  return catalog;
+}
+
+export function loadCatalogFromSource(source, options = {}) {
+  if (!source || source === 'bundled') {
+    return loadCatalog();
+  } else if (source === 'local') {
+    const localPath = join(options.target || process.cwd(), '.ai', 'plugins', 'catalog.yaml');
+    try {
+      if (existsSync(localPath)) {
+        const reg = parseYaml(readFileSync(localPath, 'utf8'));
+        const catalog = reg.catalog || { plugins: [] };
+        (catalog.plugins || []).forEach(p => { p._source = 'local'; });
+        return catalog;
+      }
+    } catch (e) {}
+    return { plugins: [] };
+  } else if (source.startsWith('remote:')) {
+    const regName = source.substring(7);
+    const sources = loadRegistrySources();
+    const src = sources.find(s => s.name === regName);
+    if (src && src.type !== 'local') {
+      const policy = loadRegistryPolicy(options.target || process.cwd());
+      try {
+        validateRegistryUrl(src.url, policy);
+      } catch (err) {
+        console.error(`\x1b[31mError: Registry '${regName}' has an invalid URL: ${err.message}\x1b[0m`);
+        process.exit(1);
+      }
+    }
+    const cachePath = join(sourceRoot, '.ai', 'registry-cache', regName, 'catalog.yaml');
+    try {
+      if (existsSync(cachePath)) {
+        const reg = parseYaml(readFileSync(cachePath, 'utf8'));
+        const catalog = reg.catalog || { plugins: [] };
+        (catalog.plugins || []).forEach(p => { p._source = `remote:${regName}`; });
+        return catalog;
+      }
+    } catch (e) {}
+    return { plugins: [] };
+  }
+  return { plugins: [] };
+}
+
+export function loadAllCatalogs(options = {}) {
+  const sources = loadRegistrySources();
+  const policy = loadRegistryPolicy(options.target || process.cwd());
+  const allPlugins = [];
+
+  // Always include bundled
+  const bundled = loadCatalog();
+  (bundled.plugins || []).forEach(p => { p._source = 'bundled'; allPlugins.push(p); });
+
+  // Include local workspace catalog if different from bundled
+  const localPath = join(options.target || process.cwd(), '.ai', 'plugins', 'catalog.yaml');
+  if (existsSync(localPath)) {
+    try {
+      const localCat = parseYaml(readFileSync(localPath, 'utf8'));
+      const localPlugins = (localCat.catalog || {}).plugins || [];
+      localPlugins.forEach(p => {
+        if (!allPlugins.some(bp => bp.slug === p.slug)) {
+          p._source = 'local';
+          allPlugins.push(p);
+        }
+      });
+    } catch (e) {}
+  }
+
+  // Include remote caches if policy allows
+  if (policy.allow_remote_registries) {
+    sources.filter(s => s.type !== 'local' && s.enabled).forEach(s => {
+      const cachePath = join(sourceRoot, '.ai', 'registry-cache', s.name, 'catalog.yaml');
+      if (existsSync(cachePath)) {
+        try {
+          const remoteCat = parseYaml(readFileSync(cachePath, 'utf8'));
+          const remotePlugins = (remoteCat.catalog || {}).plugins || [];
+          remotePlugins.forEach(p => {
+            if (!allPlugins.some(bp => bp.slug === p.slug)) {
+              p._source = `remote:${s.name}`;
+              allPlugins.push(p);
+            }
+          });
+        } catch (e) {}
+      }
+    });
+  }
+
+  return { plugins: allPlugins };
+}

package/src/cli/args.js

@@ -0,0 +1,118 @@
+import { resolve } from 'path';
+
+export function parseArgs(args) {
+  const params = {
+    command: null,
+    target: process.cwd(),
+    template: 'general-app',
+    adapters: [],
+    caveman: false,
+    dryRun: false,
+    force: false,
+    help: false,
+    tokens: false,
+    modelPreset: null,
+    agent: null,
+    stack: null,
+    mobile: null,
+    aiApp: null,
+    json: false,
+    threshold: null,
+    registry: null,
+    allRegistries: false,
+    release: false,
+    type: 'unknown',
+    tags: '',
+    files: '',
+    title: null,
+    approved: false,
+    intelligence: false,
+    onboarding: false,
+    listActions: false,
+    category: null,
+    source: null,
+    allSources: false
+  };
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === '--target' || arg === '-t') {
+      params.target = resolve(args[++i]);
+    } else if (arg === '--template') {
+      params.template = args[++i];
+    } else if (arg === '--adapter' || arg === '-a') {
+      params.adapters.push(args[++i]);
+    } else if (arg === '--caveman') {
+      params.caveman = true;
+    } else if (arg === '--dry-run' || arg === '-d') {
+      params.dryRun = true;
+    } else if (arg === '--list-actions') {
+      params.listActions = true;
+    } else if (arg === '--force' || arg === '-f') {
+      params.force = true;
+    } else if (arg === '--help' || arg === '-h') {
+      params.help = true;
+    } else if (arg === '--tokens') {
+      params.tokens = true;
+    } else if (arg === '--all-registries') {
+      params.allRegistries = true;
+    } else if (arg === '--release') {
+      params.release = true;
+    } else if (arg === '--intelligence') {
+      params.intelligence = true;
+    } else if (arg === '--onboarding') {
+      params.onboarding = true;
+    } else if (arg === '--json') {
+      params.json = true;
+    } else if (arg === '--threshold') {
+      params.threshold = args[++i];
+    } else if (arg === '--registry') {
+      params.registry = args[++i];
+    } else if (arg === '--model-preset') {
+      params.modelPreset = args[++i];
+    } else if (arg === '--agent') {
+      params.agent = args[++i];
+    } else if (arg === '--stack') {
+      params.stack = args[++i];
+    } else if (arg === '--mobile') {
+      params.mobile = args[++i];
+    } else if (arg === '--type') {
+      params.type = args[++i];
+    } else if (arg === '--tags') {
+      params.tags = args[++i];
+    } else if (arg === '--files') {
+      params.files = args[++i];
+    } else if (arg === '--title') {
+      params.title = args[++i];
+    } else if (arg === '--approved') {
+      params.approved = true;
+    } else if (arg === '--category') {
+      params.category = args[++i];
+    } else if (arg === '--source') {
+      params.source = args[++i];
+    } else if (arg === '--all-sources') {
+      params.allSources = true;
+    } else if (!params.command && !arg.startsWith('-')) {
+      params.command = arg;
+    }
+  }
+  return params;
+}
+
+export function getPositionalArgs(args) {
+  const positionalArgs = [];
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === '--target' || arg === '-t' || arg === '--template' || arg === '--adapter' || arg === '-a' ||
+        arg === '--threshold' || arg === '--registry' || arg === '--model-preset' || arg === '--agent' ||
+        arg === '--stack' || arg === '--mobile' || arg === '--type' || arg === '--tags' || arg === '--files' ||
+        arg === '--title' || arg === '--category') {
+      i++; // skip next arg (its value)
+    } else if (arg.startsWith('-')) {
+      // it's a flag, skip
+    } else {
+      positionalArgs.push(arg);
+    }
+  }
+  return positionalArgs;
+}

package/src/cli/help.js

@@ -0,0 +1,60 @@
+import { version } from '../core/globals.js';
+
+export function showHelp() {
+  console.log(`\n🧠 \x1b[36mmultimodel-dev-os CLI v${version}\x1b[0m`);
+  console.log('====================================');
+  console.log('Usage: node bin/multimodel-dev-os.js <command> [options]\n');
+  console.log('Commands:');
+  console.log('  init              Initialize a project with configs and adapters');
+  console.log('  scan              Scan project structure and framework signals');
+  console.log('  status            Show compact dashboard summarizing repository intelligence state');
+  console.log('  dashboard         Launch the interactive terminal command center (alias: ui)');
+  console.log('  memory <subcmd>   Manage hash-compressed codebase memory (subcmd: build, refresh, diff)');
+  console.log('  feedback <subcmd> Manage developer feedback loops (subcmd: add, list, summarize)');
+  console.log('  improve <subcmd>  Manage codebase self-improvement proposals (subcmd: propose, review, status, validate, diff, apply, log)');
+  console.log('  workflow <subcmd> Orchestrate read-only development workflow pipelines (subcmd: list, show, plan, run)');
+  console.log('  handoff <subcmd>  Compile or print token-compressed agent session summaries (subcmd: build, show)');
+  console.log('  onboard <subcmd>  Safely integrate MultiModel Dev OS into existing repo (subcmd: analyze, recommend, plan, apply, status)');
+  console.log('  adapter <subcmd>  Manage and sync rule/settings files for IDE adapters (subcmd: status, diff, sync)');
+  console.log('  plugin <subcmd>   Manage declarative plugins (subcmd: list, show, validate, install, status)');
+  console.log('  catalog <subcmd>  Manage Workflow Marketplace & Plugin Catalog (subcmd: list, search, show, categories, recommend, install, status)');
+  console.log('  registry <subcmd> Manage trusted remote catalog registries (subcmd: list, add, remove, sync, status, verify, show, cache)');
+  console.log('  verify            Validate structural integrity of an existing project');
+  console.log('  templates         List all built-in template profiles with details');
+  console.log('  list-templates    Alias for templates command');
+  console.log('  show-template <t> Inspect detailed stack specifications of template <t>');
+  console.log('  doctor            Advisory checkup of project compatibility loops and ignored folders');
+  console.log('  validate          Strict validation checks to verify directory schema compliance');
+  console.log('  validate-template Validate registry keys and source folder files for template');
+  console.log('  validate-adapter  Validate registry keys and source assets for IDE adapter');
+  console.log('  validate-skill    Verify custom skill conforms to core prompt structure');
+  console.log('  models            List registered model aliases in the capabilities registry');
+  console.log('  show-model <m>    View specifications of model <m> in registry');
+  console.log('  providers         List configured AI provider API endpoints');
+  console.log('  route-model <tsk> Suggest optimal model mapping for task <tsk>');
+  console.log('  adapters          List IDE and terminal tool adapters');
+  console.log('  show-adapter <a>  Inspect config specifications of adapter <a>');
+  console.log('  skills            List active skills custom prompts in target workspace');
+  console.log('  show-skill <s>    View prompt contents of target workspace skill <s>\n');
+  console.log('Options:');
+  console.log('  -t, --target <path>     Target folder destination (default: current working directory)');
+  console.log('  --type <type>           Feedback classification (correction, preference, bug, etc.)');
+  console.log('  --tags <list>           Comma-separated descriptor tags for feedback');
+  console.log('  --files <list>          Comma-separated target files for feedback');
+  console.log('  --category <name>       Filter catalog plugins list by category');
+  console.log('  --source <src>          Catalog source filter: bundled, local, or remote:<name>');
+  console.log('  --all-sources           Include all enabled catalog sources in listings');
+  console.log('  --title <text>          Specifies title for codebase improvement proposal');
+  console.log('  --approved              Explicitly approve and execute proposal/onboarding/adapter sync writes');
+  console.log('  --template <name>       Template profile: nextjs-saas, expo-react-native-android, etc.');
+  console.log('  -a, --adapter <name>    Inject specific adapter: cursor, claude, vscode, gemini, etc.');
+  console.log('  --caveman               Use minimal-token templates (~79% fewer tokens)');
+  console.log('  --tokens                Run a deeper token-sink size analysis during doctor checkup');
+  console.log('  --intelligence          Run diagnostic checkup of repository intelligence config');
+  console.log('  --onboarding            Run diagnostic checkup of repository onboarding setup');
+  console.log('  --json                  Output raw JSON data for listing commands (models, adapters, templates)');
+  console.log('  --threshold <val>       Set custom size threshold for doctor tokens checks (e.g. 50KB)');
+  console.log('  --registry <path>       Override default registry (for templates/adapters list or check)');
+  console.log('  -d, --dry-run           Preview planned file actions without modifying the filesystem');
+  console.log('  -f, --force             Overwrite existing files without prompting\n');
+}