@gadmin2n/cli 0.0.176 → 0.0.177

package/actions/update.action.js

@@ -52,7 +52,8 @@ function formatMaterializeError(schematicsVersion, err) {
  * ------------------------------------------------------------------ */
 /**
  * Shallow-clone the remote .claude context repo into a temp dir and return
- * the absolute path to the `.claude` subfolder. Returns null on failure
+ * the absolute path to the `.claude` subfolder plus the repo-root `CLAUDE.md`
+ * path (when present). Returns null on failure
  * (e.g. no network, repo private, credentials missing, etc.).
  */
 function fetchClaudeContextRepo(repoUrl, branch) {
@@ -66,6 +67,10 @@ function fetchClaudeContextRepo(repoUrl, branch) {
             fs.rmSync(tmpDir, { recursive: true, force: true });
             return null;
         }
+        const rootClaudeMdSrc = path.join(tmpDir, 'CLAUDE.md');
+        const rootClaudeMd = fs.existsSync(rootClaudeMdSrc)
+            ? rootClaudeMdSrc
+            : null;
         // Caller is responsible for cleaning up the parent tmpDir.
         // We return the inner path; we stash the parent on a property so caller
         // can clean it. To keep things simple, register a process exit cleanup
@@ -78,7 +83,7 @@ function fetchClaudeContextRepo(repoUrl, branch) {
                 // ignore
             }
         });
-        return claudeSrc;
+        return { claudeDir: claudeSrc, rootClaudeMd };
     }
     catch (err) {
         fs.rmSync(tmpDir, { recursive: true, force: true });
@@ -198,12 +203,13 @@ function syncClaudeContext(instanceDir, dryRun, source) {
         console.info(chalk.bold('  Sync .claude context'));
         console.info(chalk.bold('═══════════════════════════════════════════════════'));
         console.info(`${chalk.gray('Source: ')} ${source.repo} (${source.branch}) :: ${CLAUDE_SOURCE_SUBDIR}/`);
-        console.info(`${chalk.gray('Targets:')} ${CLAUDE_TARGET_DIRS.map((d) => `${d}/`).join(', ')}\n`);
+        console.info(`${chalk.gray('Targets:')} ${CLAUDE_TARGET_DIRS.map((d) => `${d}/`).join(', ')}, AGENTS.md\n`);
         if (dryRun) {
             console.info(chalk.gray('(dry-run — no files written. The real run would:'));
             console.info(chalk.gray(`   1. git clone ${source.repo} --branch ${source.branch} --depth 1  (into tmp dir)`));
             console.info(chalk.gray(`   2. Copy <tmp>/${CLAUDE_SOURCE_SUBDIR}/** → each target dir, OVERWRITING same-named files`));
-            console.info(chalk.gray('   3. Files only present in target dirs (instance-only) are kept untouched)\n'));
+            console.info(chalk.gray('   3. Copy <tmp>/CLAUDE.md → project root AGENTS.md (overwriting if present)'));
+            console.info(chalk.gray('   4. Files only present in target dirs (instance-only) are kept untouched)\n'));
             return;
         }
         // Real run: warn the user that same-named files will be overwritten before
@@ -212,14 +218,14 @@ function syncClaudeContext(instanceDir, dryRun, source) {
         // visible so changes to the local copy aren't silently clobbered.
         console.info(chalk.yellow('⚠️  Same-named files in target dirs will be overwritten by the remote version.'));
         console.info(chalk.gray('   Instance-only files (only present locally) are kept untouched.\n'));
-        const claudeSrc = fetchClaudeContextRepo(source.repo, source.branch);
-        if (!claudeSrc) {
+        const fetched = fetchClaudeContextRepo(source.repo, source.branch);
+        if (!fetched) {
             return;
         }
         for (const targetName of CLAUDE_TARGET_DIRS) {
             const destDir = path.join(instanceDir, targetName);
             fs.mkdirSync(destDir, { recursive: true });
-            const { added, updated } = copyTreeOverwrite(claudeSrc, destDir);
+            const { added, updated } = copyTreeOverwrite(fetched.claudeDir, destDir);
             const summary = [];
             if (added > 0)
                 summary.push(`${added} added`);
@@ -229,6 +235,13 @@ function syncClaudeContext(instanceDir, dryRun, source) {
                 summary.push('no files');
             console.info(`   ${chalk.cyan(targetName + '/')}  ${summary.join(' | ')}`);
         }
+        // Sync repo-root CLAUDE.md into the project root as AGENTS.md.
+        if (fetched.rootClaudeMd) {
+            const agentsDest = path.join(instanceDir, 'AGENTS.md');
+            const agentsExisted = fs.existsSync(agentsDest);
+            fs.copyFileSync(fetched.rootClaudeMd, agentsDest);
+            console.info(`   ${chalk.cyan('AGENTS.md')}  ${agentsExisted ? 'overwritten' : 'added'} (from CLAUDE.md)`);
+        }
         console.info();
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gadmin2n/cli",
-  "version": "0.0.176",
+  "version": "0.0.177",
   "description": "Gadmin - modern, fast, powerful node.js web framework (@cli)",
   "publishConfig": {
     "access": "public"