feat(rules): add codingbuddy init CLI for project setup

packages/rules/__tests__/init/detect-stack.test.js

@@ -0,0 +1,120 @@
+const { describe, it, beforeEach, afterEach } = require('node:test');
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const path = require('node:path');
+const os = require('node:os');
+
+const { detectStack } = require('../../lib/init/detect-stack');
+
+describe('detectStack', () => {
+  let tmpDir;
+
+  beforeEach(() => {
+    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'cb-test-'));
+  });
+
+  afterEach(() => {
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+  });
+
+  it('detects Node.js project from package.json', () => {
+    fs.writeFileSync(
+      path.join(tmpDir, 'package.json'),
+      JSON.stringify({ name: 'my-app', dependencies: { express: '^4.0.0' } })
+    );
+    const result = detectStack(tmpDir);
+    assert.equal(result.runtime, 'node');
+    assert.ok(result.frameworks.includes('express'));
+  });
+
+  it('detects React project', () => {
+    fs.writeFileSync(
+      path.join(tmpDir, 'package.json'),
+      JSON.stringify({ dependencies: { react: '^18.0.0', 'react-dom': '^18.0.0' } })
+    );
+    const result = detectStack(tmpDir);
+    assert.equal(result.runtime, 'node');
+    assert.ok(result.frameworks.includes('react'));
+    assert.equal(result.category, 'frontend');
+  });
+
+  it('detects Next.js project', () => {
+    fs.writeFileSync(
+      path.join(tmpDir, 'package.json'),
+      JSON.stringify({ dependencies: { next: '^14.0.0', react: '^18.0.0' } })
+    );
+    const result = detectStack(tmpDir);
+    assert.ok(result.frameworks.includes('next'));
+    assert.equal(result.category, 'fullstack');
+  });
+
+  it('detects NestJS backend project', () => {
+    fs.writeFileSync(
+      path.join(tmpDir, 'package.json'),
+      JSON.stringify({ dependencies: { '@nestjs/core': '^10.0.0' } })
+    );
+    const result = detectStack(tmpDir);
+    assert.ok(result.frameworks.includes('nestjs'));
+    assert.equal(result.category, 'backend');
+  });
+
+  it('detects Python project from pyproject.toml', () => {
+    fs.writeFileSync(path.join(tmpDir, 'pyproject.toml'), '[project]\nname = "myapp"\n');
+    const result = detectStack(tmpDir);
+    assert.equal(result.runtime, 'python');
+    assert.equal(result.category, 'backend');
+  });
+
+  it('detects Django in pyproject.toml', () => {
+    fs.writeFileSync(
+      path.join(tmpDir, 'pyproject.toml'),
+      '[project]\ndependencies = ["django>=4.0"]\n'
+    );
+    const result = detectStack(tmpDir);
+    assert.equal(result.runtime, 'python');
+    assert.ok(result.frameworks.includes('django'));
+  });
+
+  it('detects Go project from go.mod', () => {
+    fs.writeFileSync(path.join(tmpDir, 'go.mod'), 'module example.com/myapp\n\ngo 1.21\n');
+    const result = detectStack(tmpDir);
+    assert.equal(result.runtime, 'go');
+    assert.equal(result.category, 'backend');
+  });
+
+  it('detects Rust project from Cargo.toml', () => {
+    fs.writeFileSync(
+      path.join(tmpDir, 'Cargo.toml'),
+      '[package]\nname = "myapp"\nversion = "0.1.0"\n'
+    );
+    const result = detectStack(tmpDir);
+    assert.equal(result.runtime, 'rust');
+    assert.equal(result.category, 'backend');
+  });
+
+  it('returns unknown for empty directory', () => {
+    const result = detectStack(tmpDir);
+    assert.equal(result.runtime, 'unknown');
+    assert.deepEqual(result.frameworks, []);
+    assert.equal(result.category, 'unknown');
+  });
+
+  it('detects TypeScript usage', () => {
+    fs.writeFileSync(
+      path.join(tmpDir, 'package.json'),
+      JSON.stringify({ devDependencies: { typescript: '^5.0.0' } })
+    );
+    const result = detectStack(tmpDir);
+    assert.equal(result.language, 'typescript');
+  });
+
+  it('detects Vue.js frontend project', () => {
+    fs.writeFileSync(
+      path.join(tmpDir, 'package.json'),
+      JSON.stringify({ dependencies: { vue: '^3.0.0' } })
+    );
+    const result = detectStack(tmpDir);
+    assert.ok(result.frameworks.includes('vue'));
+    assert.equal(result.category, 'frontend');
+  });
+});

packages/rules/__tests__/init/generate-config.test.js

@@ -0,0 +1,77 @@
+const { describe, it, beforeEach, afterEach } = require('node:test');
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const path = require('node:path');
+const os = require('node:os');
+
+const { generateConfig } = require('../../lib/init/generate-config');
+
+describe('generateConfig', () => {
+  let tmpDir;
+
+  beforeEach(() => {
+    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'cb-cfg-'));
+  });
+
+  afterEach(() => {
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+  });
+
+  it('creates codingbuddy.config.json with defaults', () => {
+    const options = {
+      language: 'en',
+      primaryAgent: 'software-engineer',
+      techStack: { runtime: 'node', language: 'typescript', frameworks: ['next'], category: 'fullstack' },
+    };
+    generateConfig(tmpDir, options);
+
+    const configPath = path.join(tmpDir, 'codingbuddy.config.json');
+    assert.ok(fs.existsSync(configPath));
+
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+    assert.equal(config.language, 'en');
+    assert.equal(config.primaryAgent, 'software-engineer');
+    assert.equal(config.techStack.runtime, 'node');
+  });
+
+  it('includes all required fields', () => {
+    generateConfig(tmpDir, {
+      language: 'ko',
+      primaryAgent: 'backend-developer',
+      techStack: { runtime: 'python', language: 'python', frameworks: ['django'], category: 'backend' },
+    });
+
+    const config = JSON.parse(fs.readFileSync(path.join(tmpDir, 'codingbuddy.config.json'), 'utf-8'));
+    assert.ok('language' in config);
+    assert.ok('primaryAgent' in config);
+    assert.ok('techStack' in config);
+    assert.ok('version' in config);
+  });
+
+  it('does not overwrite existing config', () => {
+    const configPath = path.join(tmpDir, 'codingbuddy.config.json');
+    fs.writeFileSync(configPath, JSON.stringify({ language: 'ja', custom: true }));
+
+    const result = generateConfig(tmpDir, {
+      language: 'en',
+      primaryAgent: 'software-engineer',
+      techStack: { runtime: 'node', language: 'javascript', frameworks: [], category: 'backend' },
+    });
+
+    assert.equal(result.skipped, true);
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+    assert.equal(config.language, 'ja');
+    assert.equal(config.custom, true);
+  });
+
+  it('writes formatted JSON', () => {
+    generateConfig(tmpDir, {
+      language: 'en',
+      primaryAgent: 'frontend-developer',
+      techStack: { runtime: 'node', language: 'typescript', frameworks: ['react'], category: 'frontend' },
+    });
+
+    const raw = fs.readFileSync(path.join(tmpDir, 'codingbuddy.config.json'), 'utf-8');
+    assert.ok(raw.includes('\n'), 'should be formatted with newlines');
+  });
+});

packages/rules/__tests__/init/scaffold.test.js

@@ -0,0 +1,59 @@
+const { describe, it, beforeEach, afterEach } = require('node:test');
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const path = require('node:path');
+const os = require('node:os');
+
+const { scaffold } = require('../../lib/init/scaffold');
+
+describe('scaffold', () => {
+  let tmpDir;
+  const rulesSource = path.resolve(__dirname, '../../.ai-rules');
+
+  beforeEach(() => {
+    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'cb-scaffold-'));
+  });
+
+  afterEach(() => {
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+  });
+
+  it('creates .ai-rules directory in target', () => {
+    scaffold(tmpDir, { source: rulesSource });
+    assert.ok(fs.existsSync(path.join(tmpDir, '.ai-rules')));
+  });
+
+  it('copies rules/ directory', () => {
+    scaffold(tmpDir, { source: rulesSource });
+    assert.ok(fs.existsSync(path.join(tmpDir, '.ai-rules', 'rules')));
+    assert.ok(fs.existsSync(path.join(tmpDir, '.ai-rules', 'rules', 'core.md')));
+  });
+
+  it('copies agents/ directory', () => {
+    scaffold(tmpDir, { source: rulesSource });
+    assert.ok(fs.existsSync(path.join(tmpDir, '.ai-rules', 'agents')));
+  });
+
+  it('copies README.md', () => {
+    scaffold(tmpDir, { source: rulesSource });
+    assert.ok(fs.existsSync(path.join(tmpDir, '.ai-rules', 'README.md')));
+  });
+
+  it('does not overwrite existing .ai-rules', () => {
+    const existingDir = path.join(tmpDir, '.ai-rules');
+    fs.mkdirSync(existingDir);
+    fs.writeFileSync(path.join(existingDir, 'custom.md'), 'my rules');
+
+    const result = scaffold(tmpDir, { source: rulesSource });
+    assert.equal(result.skipped, true);
+    assert.ok(fs.existsSync(path.join(existingDir, 'custom.md')));
+  });
+
+  it('returns list of copied directories', () => {
+    const result = scaffold(tmpDir, { source: rulesSource });
+    assert.equal(result.skipped, false);
+    assert.ok(result.dirs.length > 0);
+    assert.ok(result.dirs.includes('rules'));
+    assert.ok(result.dirs.includes('agents'));
+  });
+});

packages/rules/__tests__/init/suggest-agent.test.js

@@ -0,0 +1,56 @@
+const { describe, it } = require('node:test');
+const assert = require('node:assert/strict');
+
+const { suggestAgent } = require('../../lib/init/suggest-agent');
+
+describe('suggestAgent', () => {
+  it('suggests frontend-developer for React projects', () => {
+    const result = suggestAgent({ runtime: 'node', category: 'frontend', frameworks: ['react'] });
+    assert.equal(result, 'frontend-developer');
+  });
+
+  it('suggests frontend-developer for Vue projects', () => {
+    const result = suggestAgent({ runtime: 'node', category: 'frontend', frameworks: ['vue'] });
+    assert.equal(result, 'frontend-developer');
+  });
+
+  it('suggests software-engineer for Next.js fullstack', () => {
+    const result = suggestAgent({ runtime: 'node', category: 'fullstack', frameworks: ['next', 'react'] });
+    assert.equal(result, 'software-engineer');
+  });
+
+  it('suggests backend-developer for NestJS', () => {
+    const result = suggestAgent({ runtime: 'node', category: 'backend', frameworks: ['nestjs'] });
+    assert.equal(result, 'backend-developer');
+  });
+
+  it('suggests backend-developer for Python', () => {
+    const result = suggestAgent({ runtime: 'python', category: 'backend', frameworks: ['django'] });
+    assert.equal(result, 'backend-developer');
+  });
+
+  it('suggests backend-developer for Go', () => {
+    const result = suggestAgent({ runtime: 'go', category: 'backend', frameworks: [] });
+    assert.equal(result, 'backend-developer');
+  });
+
+  it('suggests systems-developer for Rust', () => {
+    const result = suggestAgent({ runtime: 'rust', category: 'backend', frameworks: [] });
+    assert.equal(result, 'systems-developer');
+  });
+
+  it('suggests mobile-developer for React Native', () => {
+    const result = suggestAgent({ runtime: 'node', category: 'mobile', frameworks: ['react-native'] });
+    assert.equal(result, 'mobile-developer');
+  });
+
+  it('suggests software-engineer for unknown stack', () => {
+    const result = suggestAgent({ runtime: 'unknown', category: 'unknown', frameworks: [] });
+    assert.equal(result, 'software-engineer');
+  });
+
+  it('suggests data-scientist for Python with jupyter/pandas', () => {
+    const result = suggestAgent({ runtime: 'python', category: 'backend', frameworks: ['pandas'] });
+    assert.equal(result, 'data-scientist');
+  });
+});

packages/rules/bin/cli.js

@@ -139,11 +139,11 @@ function validate() {
 }
 
 function init() {
-  console.log(
-    'codingbuddy init is not yet implemented.\n' +
-      'See https://github.com/JeremyDev87/codingbuddy/issues/813 for progress.',
-  );
-  process.exit(0);
+  const { run } = require('../lib/init');
+  run().catch((err) => {
+    console.error('Error:', err.message);
+    process.exit(1);
+  });
 }
 
 // --- Main ---