ai-native-core 0.2.1 → 0.2.3

package/adapters/react-spa/immutable-rules.md

@@ -33,8 +33,10 @@
 
 ## SDD 流程（不可变）
 
+- 完整流程：explore（复杂需求推荐）→ propose → confirm → apply
 - 禁止跳过 spec 阶段直接写实现代码
 - 禁止 design.md 缺少 ASCII 页面骨架图
+- 复杂需求（新模块、架构变更）应先 explore 再 propose，禁止跳过 explore 直接 propose
 
 ## 技术栈一致性（不可变）
 

package/config/ai-native.config.toml

@@ -18,6 +18,8 @@ description = ""
 # =============================================================================
 [stack]
 # 适配器 ID，决定默认模板和规则
+# 单栈：adapter = "react-spa"
+# 多栈（monorepo）：adapter = ["react-spa", "backend-java"]
 # 可选值：react-spa | nextjs | vue | backend-go | backend-python | backend-java
 adapter = "react-spa"
 
@@ -104,9 +106,14 @@ paradigm_detection = true
 # SDD 门禁（Spec-Driven Development）
 # =============================================================================
 [sdd]
+# 完整流程：explore（可选）→ propose → confirm → apply
 # 是否强制 spec-before-code
 enforced = true
 
+# 复杂需求是否推荐先 explore（探索需求、澄清边界）
+# 设为 true 时，AI 会在 propose 前主动建议 explore
+recommend_explore = true
+
 # 是否要求 design.md 包含 ASCII wireframe
 require_ascii_wireframe = true
 
@@ -130,6 +137,11 @@ manifest = ".ai-native/memory/MANIFEST.yaml"
 # 记忆文件输出目录
 output_dir = ".ai-native/memory/"
 
+# 自定义架构规则（覆盖适配器内置规则）
+# 如果此文件存在，蒸馏时优先使用；框架内置规则作为 fallback
+# 格式与 adapters/{stack}/immutable-rules.md 相同
+# custom_rules = ".ai-native/custom-rules.md"
+
 # LLM provider（用于蒸馏）：openai | anthropic | local
 # 如果不配置，使用 AI Agent 当前会话的模型
 # llm_provider = "anthropic"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-native-core",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "让任何项目拥有 AI Native 开发能力的运行时框架",
   "keywords": [
     "ai-native",

package/src/commands/accept.js

@@ -32,6 +32,21 @@ function run(args) {
     return { pass: fs.existsSync(p), detail: fs.existsSync(p) ? 'initialized' : 'NOT INITIALIZED' };
   }, results);
 
+  // Phase 1.5 — SDD check
+  const sddTool = config.sdd?.tool || config.ai_tools?.sdd_tool;
+  if (sddTool && sddTool !== 'none') {
+    console.log('Phase 1.5 — SDD 门禁');
+    check('sdd-tool-configured', () => {
+      const dir = path.join(root, 'openspec', 'changes');
+      const ok = fs.existsSync(dir) && fs.readdirSync(dir).length > 0;
+      return { pass: ok || sddTool !== 'openspec', detail: sddTool + (ok ? ' ✓' : ' (spec 目录为空)') };
+    }, results);
+    check('sdd-gate', () => {
+      const enforced = config.sdd?.enforced !== false;
+      return { pass: enforced, detail: enforced ? 'enforced' : '⚠ disabled' };
+    }, results);
+  }
+
   // Phase 2
   console.log('Phase 2 — 代码质量');
   check('lint', () => tryExec('pnpm lint || npm run lint || true', root), results);

package/src/commands/init.js

@@ -1,62 +1,123 @@
-// ai-native init
+// ai-native init — interactive mode when no --stack provided
 
 const fs = require('fs');
 const path = require('path');
+const readline = require('readline');
 
 const VALID_STACKS = ['react-spa', 'nextjs', 'vue', 'backend-go', 'backend-python', 'backend-java'];
 
 function run(args) {
   const idx = args.indexOf('--stack');
-  const stack = idx >= 0 ? args[idx + 1] : 'react-spa';
+  const isForce = args.includes('--force');
 
-  if (!VALID_STACKS.includes(stack)) {
-    console.error(`Invalid stack: ${stack}. Valid: ${VALID_STACKS.join(', ')}`);
-    process.exit(1);
+  if (idx >= 0) {
+    const stackArg = args[idx + 1];
+    const stacks = stackArg.split(',').map(s => s.trim());
+    for (const s of stacks) {
+      if (!VALID_STACKS.includes(s)) {
+        console.error(`Invalid: ${s}. Valid: ${VALID_STACKS.join(', ')}`);
+        process.exit(1);
+      }
+    }
+    doInit(stacks, isForce);
+  } else {
+    interactiveInit(isForce);
   }
+}
 
-  const root = process.cwd();
-  const dirs = [
-    '.ai-native/memory', '.ai-native/hooks', '.ai-native/reports',
-    'docs/.ai-native/memory', 'docs/decisions'
-  ];
+function interactiveInit(isForce) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const answers = {};
+  const ask = (q, d) => new Promise(r => rl.question(`${q} [${d}]: `, a => r(a.trim() || d)));
+
+  (async () => {
+    console.log('\n✨ AI Native Core — 交互式初始化\n');
+
+    const type = await ask('项目类型 (frontend/backend/fullstack/cli)', 'frontend');
+    answers.type = type;
+    const stacks = [];
+
+    if (type === 'frontend' || type === 'fullstack') {
+      const fw = await ask('前端框架 (react/vue/nextjs)', 'react');
+      stacks.push({ react: 'react-spa', vue: 'vue', nextjs: 'nextjs' }[fw] || 'react-spa');
+      answers.css = await ask('CSS (tailwind-v4/tailwind-v3/css-modules/none)', 'tailwind-v4');
+      answers.ui = await ask('UI 组件库 (shadcn/radix/mui/antd/none)', 'shadcn');
+      answers.ts = await ask('TypeScript? (yes/no)', 'yes');
+    }
+    if (type === 'backend' || type === 'fullstack') {
+      const lang = await ask('后端语言 (java/go/python)', 'java');
+      stacks.push({ java: 'backend-java', go: 'backend-go', python: 'backend-python' }[lang] || 'backend-java');
+      if (type === 'backend') answers.ts = await ask('TypeScript? (yes/no)', 'no');
+    }
+    if (type === 'cli') answers.ts = await ask('TypeScript? (yes/no)', 'yes');
+
+    answers.pm = await ask('包管理器 (pnpm/npm/yarn)', 'pnpm');
+
+    if (type === 'backend') {
+      const lang = stacks[0].replace('backend-', '');
+      answers.test = { java: 'junit', go: 'go-test', python: 'pytest' }[lang];
+    } else {
+      answers.test = await ask('测试框架 (vitest/jest/junit)', 'vitest');
+    }
 
-  console.log(`[ai-native] Initializing with stack: ${stack}\n`);
+    rl.close();
 
+    console.log(`\n📋 预览:`);
+    console.log(`  类型: ${type}  |  适配器: ${stacks.join(', ')}`);
+    console.log(`  包管理: ${answers.pm}  |  测试: ${answers.test}  |  TS: ${answers.ts}`);
+    if (answers.css) console.log(`  CSS: ${answers.css}  |  UI: ${answers.ui}`);
+
+    const rl2 = readline.createInterface({ input: process.stdin, output: process.stdout });
+    const confirm = await new Promise(r => rl2.question('\n确认? (yes/no) [yes]: ', a => { rl2.close(); r(a.trim() || 'yes'); }));
+    if (confirm !== 'yes' && confirm !== 'y') { console.log('已取消'); process.exit(0); }
+
+    doInit(stacks, isForce, answers);
+  })();
+}
+
+function doInit(stacks, isForce, answers = {}) {
+  const root = process.cwd();
+  const dirs = ['.ai-native/memory', '.ai-native/hooks', '.ai-native/reports', 'docs/.ai-native/memory', 'docs/decisions'];
+
+  console.log(`\n[ai-native] Initializing...\n`);
   dirs.forEach(d => {
     const full = path.join(root, d);
-    if (!fs.existsSync(full)) {
-      fs.mkdirSync(full, { recursive: true });
-      console.log(`  created: ${d}`);
-    }
+    if (!fs.existsSync(full)) { fs.mkdirSync(full, { recursive: true }); console.log(`  created: ${d}`); }
   });
 
-  // Copy config
   const copyFile = (srcRel, dstRel, transform) => {
     const src = path.join(__dirname, '..', '..', srcRel);
     const dst = path.join(root, dstRel);
-    if (fs.existsSync(dst)) { console.log(`  exists: ${dstRel} (skipped)`); return; }
+    if (fs.existsSync(dst) && !isForce) { console.log(`  exists: ${dstRel} (skipped)`); return; }
     if (!fs.existsSync(src)) return;
-    let content = fs.readFileSync(src, 'utf-8');
-    if (transform) content = transform(content);
-    fs.writeFileSync(dst, content);
+    let c = fs.readFileSync(src, 'utf-8');
+    if (transform) c = transform(c);
+    fs.writeFileSync(dst, c);
     console.log(`  created: ${dstRel}`);
   };
 
-  copyFile('config/ai-native.config.toml', '.ai-native/config.toml',
-    c => c.replace(/adapter = "react-spa"/, `adapter = "${stack}"`));
+  copyFile('config/ai-native.config.toml', '.ai-native/config.toml', c => {
+    c = c.replace(/adapter = "react-spa"/, stacks.length > 1
+      ? `adapter = [${stacks.map(s => `"${s}"`).join(', ')}]`
+      : `adapter = "${stacks[0]}"`);
+    if (answers.pm) c = c.replace(/package_manager = "pnpm"/, `package_manager = "${answers.pm}"`);
+    if (answers.css) c = c.replace(/css = "tailwind-v4"/, `css = "${answers.css}"`);
+    if (answers.ui) c = c.replace(/ui_library = "shadcn"/, `ui_library = "${answers.ui}"`);
+    if (answers.test) c = c.replace(/test_framework = "vitest"/, `test_framework = "${answers.test}"`);
+    if (answers.ts) c = c.replace(/typescript = true/, `typescript = ${answers.ts === 'yes'}`);
+    return c;
+  });
+
   copyFile('config/acceptance.yaml', '.ai-native/acceptance.yaml');
   copyFile('config/memory-manifest.yaml', '.ai-native/memory/MANIFEST.yaml');
 
-  const selfUpdate = path.join(root, 'docs', 'self-update.md');
-  if (!fs.existsSync(selfUpdate)) {
-    fs.writeFileSync(selfUpdate, '# AI Native 范式变更日志\n\n记录范式文件的系统性变更。\n每次范式变更检测后由 AI 追加。\n\n---\n');
-    console.log('  created: docs/self-update.md');
-  }
+  const su = path.join(root, 'docs', 'self-update.md');
+  if (!fs.existsSync(su)) fs.writeFileSync(su, '# AI Native 范式变更日志\n\n记录范式文件的系统性变更。\n\n---\n');
 
   console.log('\n[ai-native] Done. Next:');
-  console.log('  1. Edit .ai-native/config.toml');
-  console.log('  2. Run ai-native sync');
-  console.log('  3. Run ai-native hooks install');
+  console.log('  1. ai-native sync');
+  console.log('  2. ai-native hooks install');
+  console.log('  3. ai-native accept');
 }
 
 module.exports = { run };

package/src/commands/sync.js

@@ -49,8 +49,25 @@ function run(args) {
     return;
   }
 
-  // Load adapter rules
-  const builtin = loadAdapterRules(config.stack?.adapter || 'react-spa');
+  // Load rules: custom > adapter builtin
+  const adapters = Array.isArray(config.stack?.adapter)
+    ? config.stack.adapter
+    : [config.stack?.adapter || 'react-spa'];
+
+  let builtin = mergeAdapterRules(adapters);
+
+  // Check for project-level custom rules (overrides adapter)
+  const customPath = config.distiller?.custom_rules;
+  if (customPath) {
+    const fullCustomPath = path.join(root, customPath);
+    if (fs.existsSync(fullCustomPath)) {
+      const customRules = loadAdapterRules(fullCustomPath);
+      if (Object.keys(customRules).length > 0) {
+        console.log(`[ai-native] Using custom rules: ${customPath}`);
+        builtin = customRules; // Override entirely
+      }
+    }
+  }
 
   // Process
   const factors = targetFactor ? manifest.factors.filter(f => f.name === targetFactor) : manifest.factors;
@@ -116,4 +133,17 @@ ${builtinContent || '\n- (蒸馏引擎将在完整实现中从源文件提取因
 `;
 }
 
+function mergeAdapterRules(adapters) {
+  const merged = {};
+  for (const name of adapters) {
+    const rules = loadAdapterRules(name);
+    for (const [key, content] of Object.entries(rules)) {
+      if (content) {
+        merged[key] = (merged[key] || '') + '\n' + content;
+      }
+    }
+  }
+  return merged;
+}
+
 module.exports = { run };