@fractary/codex-cli 0.3.1 → 0.4.0

package/README.md

@@ -42,7 +42,7 @@ Options:
 **Example:**
 ```bash
 fractary-codex init
-# Creates .fractary/codex.yaml and .codex-cache/
+# Creates .fractary/codex/config.yaml and .fractary/codex/cache/
 ```
 
 ### `fetch` - Fetch Documents
@@ -234,11 +234,11 @@ Options:
 
 ## Configuration
 
-Codex uses `.fractary/codex.yaml` for configuration:
+Codex uses `.fractary/codex/config.yaml` for configuration:
 
 ```yaml
 organization: myorg
-cacheDir: .codex-cache
+cacheDir: .fractary/codex/cache
 
 storage:
   - type: github
@@ -328,16 +328,6 @@ All commands use lazy-loading to avoid SDK initialization overhead for simple op
 
 MIT
 
-## Documentation
-
-- [Command Reference](../docs/guides/command-reference.md) - Complete command reference for all interfaces
-- [API Reference](../docs/guides/api-reference.md) - Complete API documentation
-- [CLI Integration Guide](../docs/guides/cli-integration.md) - How to integrate into CLI applications
-- [Configuration Guide](../docs/guides/configuration.md) - Configuration reference
-- [Naming Conventions](../docs/guides/naming-conventions.md) - Naming standards across all interfaces
-- [MCP Migration Guide](../docs/guides/mcp-migration-guide.md) - Migrating to new MCP tool names
-- [Troubleshooting](../docs/guides/troubleshooting.md) - Common issues and solutions
-
 ## Links
 
 - [GitHub Repository](https://github.com/fractary/codex)

package/dist/cli.cjs

@@ -90,7 +90,7 @@ async function migrateConfig(legacyConfigPath, options) {
       organization: legacy.organization || legacy.organizationSlug || "default"
     };
     if (legacy.cache) {
-      yamlConfig.cacheDir = legacy.cache.directory || ".codex-cache";
+      yamlConfig.cacheDir = legacy.cache.directory || ".fractary/codex/cache";
     }
     if (legacy.storage?.providers) {
       yamlConfig.storage = [];
@@ -199,7 +199,7 @@ async function writeYamlConfig(config, outputPath) {
 function getDefaultYamlConfig(organization) {
   return {
     organization,
-    cacheDir: ".codex-cache",
+    cacheDir: ".fractary/codex/cache",
     storage: [
       {
         type: "local",
@@ -767,24 +767,18 @@ function initCommand() {
         console.log(chalk8__default.default.dim(`Organization: ${chalk8__default.default.cyan(org)}
 `));
       }
-      const configDir = path3__namespace.join(process.cwd(), ".fractary");
-      const configPath = path3__namespace.join(configDir, "codex.yaml");
+      const configDir = path3__namespace.join(process.cwd(), ".fractary", "codex");
+      const configPath = path3__namespace.join(configDir, "config.yaml");
       const configExists = await fileExists(configPath);
-      const legacyConfigPath = path3__namespace.join(process.cwd(), ".fractary", "plugins", "codex", "config.json");
-      const legacyExists = await fileExists(legacyConfigPath);
       if (configExists && !options.force) {
-        console.log(chalk8__default.default.yellow("\u26A0 Configuration already exists at .fractary/codex.yaml"));
+        console.log(chalk8__default.default.yellow("\u26A0 Configuration already exists at .fractary/codex/config.yaml"));
         console.log(chalk8__default.default.dim("Use --force to overwrite"));
         process.exit(1);
       }
-      if (legacyExists && !configExists) {
-        console.log(chalk8__default.default.yellow("\u26A0 Legacy configuration detected at .fractary/plugins/codex/config.json"));
-        console.log(chalk8__default.default.dim('Run "fractary codex migrate" to upgrade to YAML format\n'));
-      }
       console.log("Creating directory structure...");
       const dirs = [
-        ".fractary",
-        ".codex-cache"
+        ".fractary/codex",
+        ".fractary/codex/cache"
       ];
       for (const dir of dirs) {
         await fs__namespace.mkdir(path3__namespace.join(process.cwd(), dir), { recursive: true });
@@ -796,12 +790,12 @@ function initCommand() {
         config.mcp.enabled = true;
       }
       await writeYamlConfig(config, configPath);
-      console.log(chalk8__default.default.green("\u2713"), chalk8__default.default.dim(".fractary/codex.yaml"));
-      console.log(chalk8__default.default.green("\n\u2713 Codex v3.0 initialized successfully!\n"));
+      console.log(chalk8__default.default.green("\u2713"), chalk8__default.default.dim(".fractary/codex/config.yaml"));
+      console.log(chalk8__default.default.green("\n\u2713 Codex v4.0 initialized successfully!\n"));
       console.log(chalk8__default.default.bold("Configuration:"));
       console.log(chalk8__default.default.dim(`  Organization: ${org}`));
-      console.log(chalk8__default.default.dim(`  Cache: .codex-cache/`));
-      console.log(chalk8__default.default.dim(`  Config: .fractary/codex.yaml`));
+      console.log(chalk8__default.default.dim(`  Cache: .fractary/codex/cache/`));
+      console.log(chalk8__default.default.dim(`  Config: .fractary/codex/config.yaml`));
       if (options.mcp) {
         console.log(chalk8__default.default.dim(`  MCP Server: Enabled (port 3000)`));
       }
@@ -811,13 +805,9 @@ function initCommand() {
       console.log(chalk8__default.default.dim("  - HTTP endpoint"));
       console.log(chalk8__default.default.bold("\nNext steps:"));
       console.log(chalk8__default.default.dim('  1. Set your GitHub token: export GITHUB_TOKEN="your_token"'));
-      console.log(chalk8__default.default.dim("  2. Edit .fractary/codex.yaml to configure storage providers"));
+      console.log(chalk8__default.default.dim("  2. Edit .fractary/codex/config.yaml to configure storage providers"));
       console.log(chalk8__default.default.dim("  3. Fetch a document: fractary codex fetch codex://org/project/path"));
       console.log(chalk8__default.default.dim("  4. Check cache: fractary codex cache list"));
-      if (legacyExists) {
-        console.log(chalk8__default.default.yellow("\n\u26A0 Legacy config detected:"));
-        console.log(chalk8__default.default.dim('  Run "fractary codex migrate" to convert your existing config'));
-      }
     } catch (error) {
       console.error(chalk8__default.default.red("Error:"), error.message);
       process.exit(1);
@@ -1450,7 +1440,7 @@ function syncCommand() {
       let projectName = name;
       if (!projectName) {
         const detected = detectCurrentProject();
-        projectName = detected.project || null;
+        projectName = detected.project || void 0;
       }
       if (!projectName) {
         console.error(chalk8__default.default.red("Error:"), "Could not determine project name.");
@@ -1473,7 +1463,7 @@ function syncCommand() {
         config: config.sync,
         manifestPath: path3__namespace.join(process.cwd(), ".fractary", ".codex-sync-manifest.json")
       });
-      const defaultPatterns = config.sync?.include || [
+      const defaultPatterns = [
         "docs/**/*.md",
         "specs/**/*.md",
         ".fractary/standards/**",
@@ -1508,13 +1498,36 @@ function syncCommand() {
         include: includePatterns,
         exclude: excludePatterns
       };
-      const plan = await syncManager.createPlan(
-        config.organization,
-        projectName,
-        sourceDir,
-        targetFiles,
-        syncOptions
-      );
+      let plan;
+      let routingScan;
+      if (direction === "from-codex") {
+        const codexRepoPath = config.cacheDir || path3__namespace.join(process.cwd(), ".fractary", "codex-cache");
+        if (options.json) {
+          console.log(JSON.stringify({
+            info: "Routing-aware sync: scanning entire codex repository for files targeting this project",
+            codexPath: codexRepoPath
+          }, null, 2));
+        } else {
+          console.log(chalk8__default.default.blue("\u2139 Using routing-aware sync"));
+          console.log(chalk8__default.default.dim("  Scanning entire codex for files routing to this project...\n"));
+        }
+        const planWithRouting = await syncManager.createRoutingAwarePlan(
+          config.organization,
+          projectName,
+          codexRepoPath,
+          syncOptions
+        );
+        plan = planWithRouting;
+        routingScan = planWithRouting.routingScan;
+      } else {
+        plan = await syncManager.createPlan(
+          config.organization,
+          projectName,
+          sourceDir,
+          targetFiles,
+          syncOptions
+        );
+      }
       if (plan.totalFiles === 0) {
         if (options.json) {
           console.log(JSON.stringify({
@@ -1577,6 +1590,20 @@ function syncCommand() {
       if (plan.estimatedTime) {
         console.log(`  Est. time:    ${chalk8__default.default.dim(formatDuration(plan.estimatedTime))}`);
       }
+      if (routingScan) {
+        console.log("");
+        console.log(chalk8__default.default.bold("Routing Statistics\n"));
+        console.log(`  Scanned:      ${chalk8__default.default.cyan(routingScan.stats.totalScanned.toString())} files`);
+        console.log(`  Matched:      ${chalk8__default.default.cyan(routingScan.stats.totalMatched.toString())} files`);
+        console.log(`  Source projects: ${chalk8__default.default.cyan(routingScan.stats.sourceProjects.length.toString())}`);
+        if (routingScan.stats.sourceProjects.length > 0) {
+          console.log(chalk8__default.default.dim(`    ${routingScan.stats.sourceProjects.slice(0, 5).join(", ")}`));
+          if (routingScan.stats.sourceProjects.length > 5) {
+            console.log(chalk8__default.default.dim(`    ... and ${routingScan.stats.sourceProjects.length - 5} more`));
+          }
+        }
+        console.log(`  Scan time:    ${chalk8__default.default.dim(formatDuration(routingScan.stats.durationMs))}`);
+      }
       console.log("");
       if (plan.conflicts.length > 0) {
         console.log(chalk8__default.default.yellow(`\u26A0 ${plan.conflicts.length} conflicts detected:`));