apero-kit-cli 1.5.0 → 1.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apero-kit-cli",
-  "version": "1.5.0",
+  "version": "1.7.0",
   "description": "CLI tool to scaffold AI agent projects with pre-configured kits (Claude, OpenCode, Codex)",
   "type": "module",
   "bin": {

package/src/commands/help.js

@@ -1,11 +1,5 @@
-import http from 'http';
-import { join } from 'path';
 import { exec } from 'child_process';
-import fs from 'fs-extra';
 import chalk from 'chalk';
-import { CLI_ROOT, TEMPLATES_DIR, resolveSource } from '../utils/paths.js';
-
-const PORT = 3457;
 
 // Bilingual content
 const i18n = {
@@ -1403,38 +1397,16 @@ function generateWorkflowsSection(t, lang) {
   `;
 }
 
+const HELP_URL = 'https://www.vividkit.dev/vi/guides/what-is-claudekit';
+
 /**
- * Help command - open browser with interactive documentation
+ * Help command - open VividKit documentation in browser
  */
 export async function helpCommand(options) {
-  const source = resolveSource(options.source);
-
-  console.log(chalk.cyan('\n📚 Starting help server...\n'));
-
-  const server = http.createServer((req, res) => {
-    const url = new URL(req.url, `http://localhost:${PORT}`);
-    const section = url.searchParams.get('section') || 'overview';
-    const lang = url.searchParams.get('lang') || 'vi';
-
-    const html = generateHelpPage(section, lang, source);
-    res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
-    res.end(html);
-  });
-
-  server.listen(PORT, () => {
-    const url = `http://localhost:${PORT}`;
-    console.log(chalk.green(`   Help server running at: ${url}`));
-    console.log(chalk.gray('   Press Ctrl+C to stop\n'));
-
-    // Open browser
-    const openCommand = process.platform === 'darwin' ? 'open' :
-                        process.platform === 'win32' ? 'start' : 'xdg-open';
-    exec(`${openCommand} ${url}`);
-  });
-
-  // Handle shutdown
-  process.on('SIGINT', () => {
-    console.log(chalk.yellow('\n👋 Help server stopped'));
-    process.exit(0);
-  });
+  console.log(chalk.cyan('\n📚 Opening VividKit documentation...\n'));
+  console.log(chalk.green(`   ${HELP_URL}\n`));
+
+  const openCommand = process.platform === 'darwin' ? 'open' :
+                      process.platform === 'win32' ? 'start' : 'xdg-open';
+  exec(`${openCommand} ${HELP_URL}`);
 }

package/src/utils/paths.js

@@ -1,7 +1,8 @@
 import { fileURLToPath } from 'url';
 import { dirname, join, resolve } from 'path';
-import { existsSync, statSync } from 'fs';
+import { existsSync, statSync, mkdirSync } from 'fs';
 import { execSync } from 'child_process';
+import { homedir } from 'os';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -12,6 +13,10 @@ export const CLI_ROOT = resolve(__dirname, '../..');
 // Embedded templates directory (inside CLI package)
 export const TEMPLATES_DIR = join(CLI_ROOT, 'templates');
 
+// Remote templates config
+const REMOTE_REPO_URL = 'https://github.com/Thanhnguyen6702/CK-Internal.git';
+const CACHE_DIR = join(homedir(), '.apero-kit', 'CK-Internal');
+
 // Target folder mappings
 export const TARGETS = {
   claude: '.claude',
@@ -19,6 +24,55 @@ export const TARGETS = {
   generic: '.agent'
 };
 
+/**
+ * Fetch or update remote templates from CK-Internal GitHub repo.
+ * Clones on first run, pulls on subsequent runs.
+ * Returns source object or null on failure.
+ */
+export function fetchRemoteTemplates() {
+  try {
+    const cacheParent = join(homedir(), '.apero-kit');
+    if (!existsSync(cacheParent)) {
+      mkdirSync(cacheParent, { recursive: true });
+    }
+
+    if (existsSync(join(CACHE_DIR, '.git'))) {
+      // Already cloned — pull latest
+      try {
+        execSync('git pull --ff-only', {
+          cwd: CACHE_DIR,
+          encoding: 'utf-8',
+          stdio: ['pipe', 'pipe', 'pipe'],
+          timeout: 30000
+        });
+      } catch {
+        // pull failed (offline, etc.) — use cached version
+      }
+    } else {
+      // First time — clone
+      execSync(`git clone --depth 1 "${REMOTE_REPO_URL}" "${CACHE_DIR}"`, {
+        encoding: 'utf-8',
+        stdio: ['pipe', 'pipe', 'pipe'],
+        timeout: 60000
+      });
+    }
+
+    const claudeDir = join(CACHE_DIR, '.claude');
+    if (existsSync(claudeDir) && statSync(claudeDir).isDirectory()) {
+      const agentsMd = join(CACHE_DIR, 'AGENTS.md');
+      return {
+        path: CACHE_DIR,
+        type: 'remote',
+        claudeDir,
+        agentsMd: existsSync(agentsMd) ? agentsMd : null
+      };
+    }
+  } catch {
+    // Clone failed (no network, etc.) — fall through
+  }
+  return null;
+}
+
 /**
  * Get embedded templates (bundled with CLI)
  */
@@ -177,19 +231,25 @@ export function resolveSource(sourceFlag) {
     return { error: `No .claude/ or .opencode/ found in: ${sourceFlag}` };
   }
 
-  // 2. Use embedded templates (bundled with CLI) - PREFERRED
+  // 2. Fetch from remote CK-Internal repo - PREFERRED
+  const remote = fetchRemoteTemplates();
+  if (remote) {
+    return remote;
+  }
+
+  // 3. Use embedded templates (bundled with CLI) - FALLBACK
   const embedded = getEmbeddedTemplates();
   if (embedded) {
     return embedded;
   }
 
-  // 3. Fallback: auto-detect in parent directories
+  // 4. Fallback: auto-detect in parent directories
   const found = findSource();
   if (found) {
     return found;
   }
 
   return {
-    error: 'No templates found. The CLI package may be corrupted. Try reinstalling: npm install -g apero-kit-cli'
+    error: 'No templates found. Check your network connection or try reinstalling: npm install -g apero-kit-cli'
   };
 }