scaffold-engine 0.1.0

package/tools/cli.cjs

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+const path = require('path');
+const { spawnSync } = require('child_process');
+const { initProject, parseArgs: parseInitArgs } = require('./init-project.cjs');
+
+const argv = process.argv.slice(2);
+const command = argv[0] || 'help';
+const subArgs = argv.slice(1);
+
+const commandMap = {
+  analyze: 'analyze-requirement.cjs',
+  run: 'run-requirement.cjs',
+  'draft:create': 'create-draft.cjs',
+  'draft:patch': 'patch-draft.cjs',
+  'draft:validate': 'validate-draft.cjs',
+  'draft:generate': 'generate-draft.cjs',
+  'model:validate': 'validate-model.cjs',
+  'model:generate': 'generate-module.cjs',
+  'verify:patterns': 'verify-patterns.cjs',
+};
+
+try {
+  if (command === 'init') {
+    const result = initProject(parseInitArgs(subArgs));
+    console.log(JSON.stringify(result, null, 2));
+    process.exit(0);
+  }
+
+  if (command === 'help' || !commandMap[command]) {
+    printHelp();
+    process.exit(command === 'help' ? 0 : 1);
+  }
+
+  const scriptPath = path.join(__dirname, commandMap[command]);
+  const result = spawnSync(process.execPath, [scriptPath, ...subArgs], {
+    cwd: process.cwd(),
+    stdio: 'inherit',
+  });
+  process.exit(result.status ?? 1);
+} catch (error) {
+  console.error(`\n❌ scaffold-engine 执行失败: ${error.message}`);
+  process.exit(1);
+}
+
+function printHelp() {
+  console.log(`scaffold-engine commands:
+
+  scaffold-engine init [--project-root <path>] [--force] [--no-cursor-rule]
+  scaffold-engine analyze <requirement> [--config <path>]
+  scaffold-engine run <requirement> [--config <path>]
+  scaffold-engine draft:create <requirement> [--config <path>]
+  scaffold-engine draft:patch --draft <draft-id|path> --patch <patch-file>
+  scaffold-engine draft:validate <draft-id|path> [--config <path>]
+  scaffold-engine draft:generate <draft-id|path> [--config <path>] [--dry-run]
+  scaffold-engine model:validate <spec-file>
+  scaffold-engine model:generate <spec-file> [--config <path>] [--dry-run]
+  scaffold-engine verify:patterns
+`);
+}

package/tools/create-draft.cjs

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+const { analyzeRequirement, parseArgs, readRequirementText } = require('./analyze-requirement.cjs');
+const { createDraft, saveDraft } = require('./lib/draft-toolkit.cjs');
+const { loadRuntimeConfig } = require('./lib/model-toolkit.cjs');
+
+const options = parseArgs(process.argv.slice(2));
+
+try {
+  const runtimeConfig = loadRuntimeConfig({ configPath: options.configPath });
+  const requirementText = readRequirementText(options);
+  const analysis = analyzeRequirement(requirementText, { configPath: options.configPath });
+  const draft = createDraft(requirementText, analysis);
+  const savedDraft = saveDraft(draft, { draftRoot: runtimeConfig.drafts.rootDir });
+  console.log(JSON.stringify(savedDraft, null, 2));
+} catch (error) {
+  console.error(`\n❌ Draft 创建失败: ${error.message}`);
+  process.exit(1);
+}

package/tools/engine.cjs

@@ -0,0 +1,47 @@
+const {
+  analyzeRequirement,
+  parseArgs,
+  readRequirementText,
+  renderMarkdown,
+  writeSuggestedSpec,
+} = require('./analyze-requirement.cjs');
+const {
+  createDraft,
+  generateDraft,
+  getDefaultDraftRoot,
+  loadDraft,
+  loadDraftSchema,
+  patchDraft,
+  resolveDraftReference,
+  saveDraft,
+  validateDraft,
+} = require('./lib/draft-toolkit.cjs');
+const {
+  loadSpec,
+  loadRuntimeConfig,
+  readJson,
+  resolveScaffoldPath,
+  validateModelFile,
+} = require('./lib/model-toolkit.cjs');
+
+module.exports = {
+  analyzeRequirement,
+  createDraft,
+  patchDraft,
+  validateDraft,
+  generateDraft,
+  getDefaultDraftRoot,
+  loadDraft,
+  resolveDraftReference,
+  saveDraft,
+  parseArgs,
+  readRequirementText,
+  renderMarkdown,
+  writeSuggestedSpec,
+  loadDraftSchema,
+  loadSpec,
+  loadRuntimeConfig,
+  readJson,
+  resolveScaffoldPath,
+  validateModelFile,
+};

package/tools/generate-draft.cjs

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+const { generateDraft, loadDraft, saveDraft } = require('./lib/draft-toolkit.cjs');
+const { loadRuntimeConfig } = require('./lib/model-toolkit.cjs');
+
+const args = process.argv.slice(2);
+const draftReference = args.find((item) => !item.startsWith('--'));
+const dryRun = args.includes('--dry-run');
+const configPath = readArgValue(args, '--config');
+
+try {
+  const runtimeConfig = loadRuntimeConfig({ configPath });
+  if (!draftReference) {
+    throw new Error('请提供 draft 引用，例如: node ./tools/generate-draft.cjs <draft-path|draft-id>');
+  }
+  const draft = loadDraft(draftReference, { draftRoot: runtimeConfig.drafts.rootDir });
+  const nextDraft = generateDraft(draft, { dryRun, force: true, configPath });
+  const savedDraft = saveDraft(nextDraft, {
+    draftRoot: draft.storage?.draftRoot || runtimeConfig.drafts.rootDir,
+    fileName: draft.storage?.fileName,
+  });
+  console.log(JSON.stringify(savedDraft, null, 2));
+} catch (error) {
+  console.error(`\n❌ Draft 生成失败: ${error.message}`);
+  process.exit(1);
+}
+
+function readArgValue(argv, flag) {
+  const index = argv.indexOf(flag);
+  if (index === -1) {
+    return '';
+  }
+  return argv[index + 1] || '';
+}