@fractary/codex-cli 0.10.13 → 0.10.14

package/dist/cli.js

@@ -4,7 +4,7 @@ import { dirname, join } from 'path';
 import { fileURLToPath } from 'url';
 import * as fs from 'fs/promises';
 import * as yaml2 from 'js-yaml';
-import { readCodexConfig, expandEnvVarsInConfig, expandEnvVars, parseSize, parseDuration, ValidationError, PermissionDeniedError, ConfigurationError, CodexError } from '@fractary/codex';
+import { readCodexConfig, CONFIG_SCHEMA_VERSION, expandEnvVarsInConfig, expandEnvVars, parseSize, parseDuration, ValidationError, PermissionDeniedError, ConfigurationError, CodexError } from '@fractary/codex';
 import * as os from 'os';
 import { spawn } from 'child_process';
 import { Command } from 'commander';
@@ -790,7 +790,7 @@ function getDefaultUnifiedConfig(organization, project, codexRepo) {
   const sanitizedProject = sanitizeForS3BucketName(project);
   return {
     file: {
-      schema_version: "2.0",
+      schema_version: CONFIG_SCHEMA_VERSION,
       sources: {
         specs: {
           type: "s3",
@@ -827,11 +827,16 @@ function getDefaultUnifiedConfig(organization, project, codexRepo) {
       }
     },
     codex: {
-      schema_version: "2.0",
+      schema_version: CONFIG_SCHEMA_VERSION,
       organization,
       project,
       codex_repo: codexRepo,
-      dependencies: {}
+      remotes: {
+        // The codex repository - uses same token as git operations
+        [`${organization}/${codexRepo}`]: {
+          token: "${GITHUB_TOKEN}"
+        }
+      }
     }
   };
 }
@@ -862,7 +867,7 @@ function mergeUnifiedConfigs(existing, updates) {
   const merged = {};
   if (updates.file || existing.file) {
     merged.file = {
-      schema_version: updates.file?.schema_version || existing.file?.schema_version || "2.0",
+      schema_version: updates.file?.schema_version || existing.file?.schema_version || CONFIG_SCHEMA_VERSION,
       sources: {
         ...existing.file?.sources || {},
         ...updates.file?.sources || {}
@@ -871,13 +876,13 @@ function mergeUnifiedConfigs(existing, updates) {
   }
   if (updates.codex || existing.codex) {
     merged.codex = {
-      schema_version: updates.codex?.schema_version || existing.codex?.schema_version || "2.0",
+      schema_version: updates.codex?.schema_version || existing.codex?.schema_version || CONFIG_SCHEMA_VERSION,
       organization: updates.codex?.organization || existing.codex?.organization || "default",
       project: updates.codex?.project || existing.codex?.project || "default",
       codex_repo: updates.codex?.codex_repo || existing.codex?.codex_repo || "",
-      dependencies: {
-        ...existing.codex?.dependencies || {},
-        ...updates.codex?.dependencies || {}
+      remotes: {
+        ...existing.codex?.remotes || {},
+        ...updates.codex?.remotes || {}
       }
     };
   }
@@ -1091,9 +1096,64 @@ async function fileExists(filePath) {
     return false;
   }
 }
+async function installMcpServer(projectRoot, configPath = ".fractary/config.yaml", options = {}) {
+  const mcpJsonPath = path5.join(projectRoot, ".mcp.json");
+  const { backup = true } = options;
+  let existingConfig = { mcpServers: {} };
+  let backupPath;
+  let migrated = false;
+  if (await fileExists(mcpJsonPath)) {
+    try {
+      const content = await fs.readFile(mcpJsonPath, "utf-8");
+      existingConfig = JSON.parse(content);
+      if (backup) {
+        const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "").slice(0, 18);
+        const suffix = Math.random().toString(36).substring(2, 6);
+        backupPath = `${mcpJsonPath}.backup.${timestamp}-${suffix}`;
+        await fs.writeFile(backupPath, content);
+      }
+    } catch {
+      console.log(chalk7.yellow("\u26A0 Warning: .mcp.json contains invalid JSON, starting fresh"));
+      existingConfig = { mcpServers: {} };
+    }
+  }
+  if (!existingConfig.mcpServers) {
+    existingConfig.mcpServers = {};
+  }
+  const existing = existingConfig.mcpServers["fractary-codex"];
+  if (existing) {
+    const existingCommand = existing.command;
+    const existingArgs = existing.args || [];
+    if (existingCommand === "npx" && existingArgs.includes("@fractary/codex-mcp")) {
+      return {
+        installed: false,
+        migrated: false,
+        alreadyInstalled: true,
+        backupPath
+      };
+    }
+    if (existingCommand === "node" || existingArgs.includes("@fractary/codex")) {
+      migrated = true;
+    }
+  }
+  existingConfig.mcpServers["fractary-codex"] = {
+    command: "npx",
+    args: ["-y", "@fractary/codex-mcp", "--config", configPath]
+  };
+  await fs.writeFile(
+    mcpJsonPath,
+    JSON.stringify(existingConfig, null, 2) + "\n"
+  );
+  return {
+    installed: true,
+    migrated,
+    alreadyInstalled: false,
+    backupPath
+  };
+}
 function initCommand() {
   const cmd = new Command("init");
-  cmd.description("Initialize unified Fractary configuration (.fractary/config.yaml)").option("--org <slug>", 'Organization slug (e.g., "fractary")').option("--project <name>", "Project name (default: derived from directory)").option("--codex-repo <name>", 'Codex repository name (e.g., "codex.fractary.com")').option("--force", "Overwrite existing configuration").action(async (options) => {
+  cmd.description("Initialize unified Fractary configuration (.fractary/config.yaml)").option("--org <slug>", 'Organization slug (e.g., "fractary")').option("--project <name>", "Project name (default: derived from directory)").option("--codex-repo <name>", 'Codex repository name (e.g., "codex.fractary.com")').option("--force", "Overwrite existing configuration").option("--no-mcp", "Skip MCP server installation").action(async (options) => {
     try {
       console.log(chalk7.blue("Initializing unified Fractary configuration...\n"));
       let org = options.org;
@@ -1205,6 +1265,20 @@ function initCommand() {
       } else if (result.merged) {
         console.log(chalk7.green("\u2713"), chalk7.dim(".fractary/config.yaml (merged with existing)"));
       }
+      if (options.mcp !== false) {
+        console.log("\nConfiguring MCP server...");
+        const mcpResult = await installMcpServer(process.cwd(), ".fractary/config.yaml");
+        if (mcpResult.alreadyInstalled) {
+          console.log(chalk7.green("\u2713"), chalk7.dim(".mcp.json (already configured)"));
+        } else if (mcpResult.migrated) {
+          console.log(chalk7.green("\u2713"), chalk7.dim(".mcp.json (migrated from old format)"));
+          if (mcpResult.backupPath) {
+            console.log(chalk7.dim(`  Backup: ${path5.basename(mcpResult.backupPath)}`));
+          }
+        } else if (mcpResult.installed) {
+          console.log(chalk7.green("\u2713"), chalk7.dim(".mcp.json (created)"));
+        }
+      }
       console.log(chalk7.green("\n\u2713 Unified configuration initialized successfully!\n"));
       console.log(chalk7.bold("Configuration:"));
       console.log(chalk7.dim(`  Organization: ${org}`));
@@ -1216,18 +1290,19 @@ function initCommand() {
       console.log(chalk7.dim("  - logs: .fractary/logs/ \u2192 S3"));
       console.log(chalk7.bold("\nCodex plugin:"));
       console.log(chalk7.dim("  - Cache: .fractary/codex/cache/"));
-      console.log(chalk7.dim("  - Dependencies: (none configured)"));
+      console.log(chalk7.dim("  - MCP Server: @fractary/codex-mcp (via npx)"));
+      console.log(chalk7.dim("  - Remotes: codex repo configured"));
       console.log(chalk7.bold("\nGit Authentication:"));
       console.log(chalk7.dim("  Codex sync uses your existing git credentials."));
       console.log(chalk7.dim("  Ensure you have access to the codex repository:"));
       console.log(chalk7.dim(`    gh repo view ${org}/${codexRepo}`));
       console.log(chalk7.dim("  Or set GITHUB_TOKEN environment variable."));
       console.log(chalk7.bold("\nNext steps:"));
-      console.log(chalk7.dim("  1. Verify codex repository access: gh repo view " + org + "/" + codexRepo));
-      console.log(chalk7.dim("  2. Configure AWS credentials for S3 access (if using file plugin)"));
-      console.log(chalk7.dim("  3. Edit .fractary/config.yaml to add external project dependencies"));
-      console.log(chalk7.dim("  4. Access current project files: codex://specs/SPEC-001.md"));
-      console.log(chalk7.dim("  5. Access external projects: codex://org/project/docs/README.md"));
+      console.log(chalk7.dim("  1. Restart Claude Code to load the MCP server"));
+      console.log(chalk7.dim("  2. Verify codex repository access: gh repo view " + org + "/" + codexRepo));
+      console.log(chalk7.dim("  3. Configure AWS credentials for S3 access (if using file plugin)"));
+      console.log(chalk7.dim("  4. Edit .fractary/config.yaml to add external project remotes"));
+      console.log(chalk7.dim("  5. Reference docs via codex:// URIs (auto-fetched by MCP)"));
     } catch (error) {
       console.error(chalk7.red("Error:"), error.message);
       process.exit(1);