@jahanxu/code-flow 0.1.2 → 0.2.1

package/src/cli.js

@@ -6,9 +6,12 @@ const fs = require('fs');
 const path = require('path');
 const { spawnSync } = require('child_process');
 
+const pkg = require('../package.json');
+
 const usage = [
   'Usage: code-flow init',
-  '       code-flow --help'
+  '       code-flow -v | --version',
+  '       code-flow -h | --help'
 ].join('\n');
 
 function printUsage(stream) {
@@ -57,6 +60,21 @@ function copyDirRecursive(srcDir, destDir) {
   }
 }
 
+function collectFiles(dir, base) {
+  const results = [];
+  if (!fs.existsSync(dir)) return results;
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const rel = path.join(base, entry.name);
+    if (entry.isDirectory()) {
+      results.push(...collectFiles(path.join(dir, entry.name), rel));
+    } else if (entry.isFile()) {
+      results.push(rel);
+    }
+  }
+  return results;
+}
+
 function runInit() {
   ensurePython3();
 
@@ -65,27 +83,91 @@ function runInit() {
   const coreDir = path.join(baseDir, 'core');
   const adaptersDir = path.join(baseDir, 'adapters');
 
-  copyDirRecursive(path.join(coreDir, 'code-flow'), path.join(cwd, '.code-flow'));
-  copyFileIfMissing(path.join(adaptersDir, 'claude', 'CLAUDE.md'), path.join(cwd, 'CLAUDE.md'));
-  copyDirRecursive(path.join(adaptersDir, 'claude'), path.join(cwd, '.claude'));
+  const created = [];
+  const skipped = [];
+
+  // Track files before copy
+  const track = (srcDir, destDir, prefix) => {
+    if (!fs.existsSync(srcDir)) return;
+    const files = collectFiles(srcDir, '');
+    for (const rel of files) {
+      const dest = path.join(destDir, rel);
+      const label = path.join(prefix, rel);
+      if (fs.existsSync(dest)) {
+        skipped.push(label);
+      } else {
+        created.push(label);
+      }
+    }
+  };
+
+  track(path.join(coreDir, 'code-flow'), path.join(cwd, '.code-flow'), '.code-flow');
+  const claudeMdDest = path.join(cwd, 'CLAUDE.md');
+  if (fs.existsSync(claudeMdDest)) {
+    skipped.push('CLAUDE.md');
+  } else {
+    created.push('CLAUDE.md');
+  }
+  track(path.join(adaptersDir, 'claude', 'commands'), path.join(cwd, '.claude', 'commands'), '.claude/commands');
+  const settingsDest = path.join(cwd, '.claude', 'settings.local.json');
+  if (fs.existsSync(settingsDest)) {
+    skipped.push('.claude/settings.local.json');
+  } else {
+    created.push('.claude/settings.local.json');
+  }
 
-  const result = spawnSync(
-    'python3',
-    ['.code-flow/scripts/cf_init.py'],
-    { stdio: 'inherit', cwd }
-  );
+  // Perform copy
+  copyDirRecursive(path.join(coreDir, 'code-flow'), path.join(cwd, '.code-flow'));
+  copyFileIfMissing(path.join(adaptersDir, 'claude', 'CLAUDE.md'), claudeMdDest);
+  fs.mkdirSync(path.join(cwd, '.claude', 'commands'), { recursive: true });
+  copyDirRecursive(path.join(adaptersDir, 'claude', 'commands'), path.join(cwd, '.claude', 'commands'));
+  copyFileIfMissing(path.join(adaptersDir, 'claude', 'settings.local.json'), settingsDest);
+
+  // Clean up legacy .claude/skills/ if it exists
+  const legacySkills = path.join(cwd, '.claude', 'skills');
+  if (fs.existsSync(legacySkills)) {
+    fs.rmSync(legacySkills, { recursive: true });
+    process.stdout.write('Cleaned up legacy .claude/skills/\n');
+  }
 
-  if (result.error) {
-    process.stderr.write(`Error: ${result.error.message}\n`);
-    process.exit(1);
+  // Install pyyaml
+  const pip = spawnSync('python3', ['-m', 'pip', 'install', 'pyyaml'], {
+    stdio: 'ignore'
+  });
+  if (pip.error || pip.status !== 0) {
+    process.stderr.write('Warning: pyyaml install failed. Run manually: pip install pyyaml\n');
   }
 
-  process.exit(result.status ?? 0);
+  // Output summary
+  process.stdout.write('\ncode-flow initialized!\n\n');
+  if (created.length > 0) {
+    process.stdout.write('Created:\n');
+    for (const f of created) {
+      process.stdout.write(`  + ${f}\n`);
+    }
+  }
+  if (skipped.length > 0) {
+    process.stdout.write('Skipped (already exist):\n');
+    for (const f of skipped) {
+      process.stdout.write(`  - ${f}\n`);
+    }
+  }
+  process.stdout.write('\nNext steps:\n');
+  process.stdout.write('  1. Edit CLAUDE.md — fill in team/project info\n');
+  process.stdout.write('  2. Edit .code-flow/specs/ — fill in your coding standards\n');
+  process.stdout.write('  3. Run /project:cf-learn in Claude Code to auto-discover constraints\n');
+  process.exit(0);
 }
 
 const args = process.argv.slice(2);
 
-if (args.length === 1 && args[0] === '--help') {
+if (args.includes('-v') || args.includes('--version')) {
+  process.stdout.write(`${pkg.version}\n`);
+  process.exit(0);
+}
+
+if (args.includes('-h') || args.includes('--help')) {
+  process.stdout.write(`code-flow v${pkg.version}\n\n`);
   printUsage(process.stdout);
   process.exit(0);
 }

package/src/adapters/claude/skills/cf-init.md

@@ -1,13 +0,0 @@
-# cf-init
-
-初始化 code-flow 规范体系（目录、配置、spec、skill、hooks）。
-
-## Usage
-- `/cf-init`
-- `/cf-init frontend|backend|fullstack`
-
-## Command
-- `python3 .code-flow/scripts/cf_init.py [frontend|backend|fullstack]`
-
-## Notes
-- 依赖 Python 3.9+ 与 pyyaml（脚本会尝试自动安装）。

package/src/adapters/claude/skills/cf-inject.md

@@ -1,12 +0,0 @@
-# cf-inject
-
-手动注入指定领域或文件路径对应的规范（Hook 失败时回退）。
-
-## Usage
-- `/cf-inject frontend|backend`
-- `/cf-inject path/to/file.ext`
-- `/cf-inject --list-specs --domain=frontend`
-
-## Command
-- `python3 .code-flow/scripts/cf_inject.py [domain|file_path]`
-- `python3 .code-flow/scripts/cf_inject.py --list-specs --domain=frontend`

package/src/adapters/claude/skills/cf-learn.md

@@ -1,11 +0,0 @@
-# cf-learn
-
-将经验沉淀到对应规范的 Learnings 段落。
-
-## Usage
-- `/cf-learn --scope=global --content="..." `
-- `/cf-learn --scope=frontend --content="..." --file=frontend/component-specs.md`
-- `/cf-learn --scope=backend --content="..." --file=backend/logging.md`
-
-## Command
-- `python3 .code-flow/scripts/cf_learn.py --scope=global|frontend|backend --content=\"...\" [--file=spec] [--dry-run]`

package/src/adapters/claude/skills/cf-scan.md

@@ -1,12 +0,0 @@
-# cf-scan
-
-审计规范文件的 token 分布与问题提示。
-
-## Usage
-- `/cf-scan`
-- `/cf-scan --json`
-- `/cf-scan --only-issues`
-- `/cf-scan --limit=10`
-
-## Command
-- `python3 .code-flow/scripts/cf_scan.py [--json] [--only-issues] [--limit=N]`

package/src/adapters/claude/skills/cf-stats.md

@@ -1,11 +0,0 @@
-# cf-stats
-
-统计 L0/L1 规范 token 使用情况。
-
-## Usage
-- `/cf-stats`
-- `/cf-stats --human`
-- `/cf-stats --domain=frontend`
-
-## Command
-- `python3 .code-flow/scripts/cf_stats.py [--human] [--domain=frontend]`

package/src/adapters/claude/skills/cf-validate.md

@@ -1,12 +0,0 @@
-# cf-validate
-
-基于变更文件执行验证规则（类型检查/测试/lint）。
-
-## Usage
-- `/cf-validate`
-- `/cf-validate path/to/file.py`
-- `/cf-validate --files=src/a.ts,src/b.ts`
-- `/cf-validate --only-failed`
-
-## Command
-- `python3 .code-flow/scripts/cf_validate.py [file_path] [--files=...] [--only-failed] [--json-short] [--output=table]`