oh-my-codex-cli 0.1.0

package/src/catalog/manifest.json

@@ -0,0 +1,542 @@
+{
+  "schemaVersion": 1,
+  "catalogVersion": "2026-02-23",
+  "skills": [
+    {
+      "name": "agent-kb",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "aireview",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "analyze",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "architect-planner",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "auto-mbti",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "autopilot",
+      "category": "execution",
+      "status": "active",
+      "core": true
+    },
+    {
+      "name": "backend-patterns",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "bdd-generator",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "brainstorming",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "build-fix",
+      "category": "shortcut",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "cancel",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "checkpoint",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "code-review",
+      "category": "shortcut",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "coding-standards",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "conductor",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "consensus",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "content-research-writer",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "debug-analysis",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "deepinit",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "deepsearch",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "doctor",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "drawio",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "e2e",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "ecomode",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "electron-driver",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "eval",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "eval-harness",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "evolve",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "frontend-design",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "frontend-patterns",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "frontend-ui-ux",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "git-master",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "help",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "iterative-retrieval",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "local-skills-setup",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "log-analyzer",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "mcp-setup",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "multi-model-research",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "note",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "omc-setup",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "orchestrate",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "patent-workflow",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "pattern-recognition",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "pipeline",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "plan",
+      "category": "planning",
+      "status": "active",
+      "core": true
+    },
+    {
+      "name": "planning-methodology",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "planning-with-files",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "project-analyze",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "project-session-manager",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "quality-check",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "quality-validation",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "ralph",
+      "category": "execution",
+      "status": "active",
+      "core": true
+    },
+    {
+      "name": "ralph-init",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "ralplan",
+      "category": "planning",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "refactor-clean",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "release",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "research",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "research-methodology",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "review",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "security-review",
+      "category": "shortcut",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "setup-pm",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "skill",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "skill-create",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "skill-debugger",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "skill-development",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "skill-doc-generator",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "skill-quality-analyzer",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "skill-tester",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "start-dev",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "swarm",
+      "category": "execution",
+      "status": "active",
+      "core": true
+    },
+    {
+      "name": "task-kb-lookup",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "task-kb-record",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "tdd",
+      "category": "shortcut",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "tdd-generator",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "tdd-workflow",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "test-coverage",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "thinkdeep",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "ui-ux-pro-max",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "ultrapilot",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "ultraqa",
+      "category": "execution",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "ultrawork",
+      "category": "execution",
+      "status": "active",
+      "core": true
+    },
+    {
+      "name": "update-codemaps",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "update-docs",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "verification-loop",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "verify",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    },
+    {
+      "name": "writer-memory",
+      "category": "utility",
+      "status": "active",
+      "core": false
+    }
+  ],
+  "agents": [
+    {
+      "name": "architect",
+      "category": "role",
+      "status": "active",
+      "core": true
+    },
+    {
+      "name": "executor",
+      "category": "role",
+      "status": "active",
+      "core": true
+    },
+    {
+      "name": "planner",
+      "category": "role",
+      "status": "active",
+      "core": true
+    }
+  ]
+}

package/src/catalog/reader.js

@@ -0,0 +1,43 @@
+const fs = require('fs');
+const path = require('path');
+const { validateCatalogManifest, summarizeCatalogCounts } = require('./schema');
+
+function resolveManifestPath(root) {
+  const candidates = [
+    path.join(root, 'templates', 'catalog-manifest.json'),
+    path.join(root, 'src', 'catalog', 'manifest.json'),
+  ];
+
+  for (const file of candidates) {
+    if (fs.existsSync(file)) return file;
+  }
+  return null;
+}
+
+function readCatalogManifest(root) {
+  const manifestPath = resolveManifestPath(root);
+  if (!manifestPath) throw new Error('catalog_manifest_missing');
+  const raw = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+  return validateCatalogManifest(raw);
+}
+
+function tryReadCatalogManifest(root) {
+  try {
+    return readCatalogManifest(root);
+  } catch {
+    return null;
+  }
+}
+
+function getCatalogHeadlineCounts(root) {
+  const manifest = tryReadCatalogManifest(root);
+  if (!manifest) return null;
+  const counts = summarizeCatalogCounts(manifest);
+  return { prompts: counts.promptCount, skills: counts.skillCount };
+}
+
+module.exports = {
+  readCatalogManifest,
+  tryReadCatalogManifest,
+  getCatalogHeadlineCounts,
+};

package/src/catalog/schema.js

@@ -0,0 +1,79 @@
+const REQUIRED_CORE_SKILLS = new Set(['autopilot', 'ralph', 'ultrawork', 'swarm', 'plan']);
+const STATUSES = new Set(['active', 'alias', 'merged', 'deprecated', 'internal']);
+
+function assertString(value, field) {
+  if (typeof value !== 'string' || value.trim() === '') {
+    throw new Error(`catalog_manifest_invalid:${field}`);
+  }
+}
+
+function validateCatalogManifest(input) {
+  if (!input || typeof input !== 'object') throw new Error('catalog_manifest_invalid:root');
+  if (!Array.isArray(input.skills)) throw new Error('catalog_manifest_invalid:skills');
+  if (!Array.isArray(input.agents)) throw new Error('catalog_manifest_invalid:agents');
+
+  const seen = new Set();
+  const skills = input.skills.map((entry, index) => {
+    if (!entry || typeof entry !== 'object') throw new Error(`catalog_manifest_invalid:skills[${index}]`);
+    assertString(entry.name, `skills[${index}].name`);
+    const status = entry.status || 'active';
+    if (!STATUSES.has(status)) {
+      throw new Error(`catalog_manifest_invalid:skills[${index}].status`);
+    }
+    if (seen.has(entry.name)) throw new Error(`catalog_manifest_invalid:duplicate_skill:${entry.name}`);
+    seen.add(entry.name);
+
+    return {
+      name: entry.name,
+      category: entry.category || 'utility',
+      status,
+      canonical: typeof entry.canonical === 'string' ? entry.canonical : undefined,
+      core: entry.core === true,
+    };
+  });
+
+  for (const coreSkill of REQUIRED_CORE_SKILLS) {
+    const found = skills.find((skill) => skill.name === coreSkill && skill.status === 'active');
+    if (!found) throw new Error(`catalog_manifest_invalid:missing_core_skill:${coreSkill}`);
+  }
+
+  const agentSeen = new Set();
+  const agents = input.agents.map((entry, index) => {
+    if (!entry || typeof entry !== 'object') throw new Error(`catalog_manifest_invalid:agents[${index}]`);
+    assertString(entry.name, `agents[${index}].name`);
+    const status = entry.status || 'active';
+    if (!STATUSES.has(status)) {
+      throw new Error(`catalog_manifest_invalid:agents[${index}].status`);
+    }
+    if (agentSeen.has(entry.name)) throw new Error(`catalog_manifest_invalid:duplicate_agent:${entry.name}`);
+    agentSeen.add(entry.name);
+    return {
+      name: entry.name,
+      category: entry.category || 'role',
+      status,
+      canonical: typeof entry.canonical === 'string' ? entry.canonical : undefined,
+      core: entry.core === true,
+    };
+  });
+
+  return {
+    schemaVersion: Number(input.schemaVersion || 1),
+    catalogVersion: String(input.catalogVersion || '0.1.0'),
+    skills,
+    agents,
+  };
+}
+
+function summarizeCatalogCounts(manifest) {
+  return {
+    skillCount: manifest.skills.length,
+    promptCount: manifest.agents.length,
+    activeSkillCount: manifest.skills.filter((skill) => skill.status === 'active').length,
+    activeAgentCount: manifest.agents.filter((agent) => agent.status === 'active').length,
+  };
+}
+
+module.exports = {
+  validateCatalogManifest,
+  summarizeCatalogCounts,
+};