@chenguangyao/devflow-kit 0.1.43

package/src/cli/commands/new.js

@@ -0,0 +1,202 @@
+'use strict';
+const log = require('../../utils/log.js');
+const change = require('../../core/change.js');
+const config = require('../../core/config.js');
+const state = require('../../core/state.js');
+const routing = require('../../core/project-routing.js');
+const checkpoint = require('../../core/checkpoint.js');
+const workflowInit = require('../../core/workflow-init.js');
+const templates = require('../../templates/index.js');
+const { printWorkflowSelectionGuidance } = require('./_helpers.js');
+
+async function run({ positional = [], flags = {}, cwd }) {
+  const root = cwd || process.cwd();
+  const slugInput = positional[0];
+  if (!slugInput) {
+    log.error('usage: devflow new <slug>');
+    process.exitCode = 2;
+    return;
+  }
+  const projectRouting = await resolvePreCreateProjectRouting(root, flags, 'new', slugInput);
+  const branchRoot = projectRouting && projectRouting.slugBranchSource ? projectRouting.slugBranchSource : root;
+  const slug = change.withCurrentBranchSlug(branchRoot, slugInput);
+  const title = flags.title || slugInput;
+  const micro = flags.micro === true || flags.mode === 'micro' || flags.level === 'L0';
+  const level = micro ? 'L0' : (flags.level || 'L2');
+
+  const { dir, state: st } = await change.create(root, {
+    slug,
+    title,
+    level,
+    source: { type: 'manual', ref: 'devflow new' },
+  });
+  if (projectRouting) {
+    st.projectRouting = projectRouting;
+    st.projects = projectRouting.recommended;
+    await routing.writeProjectRootsArtifact(root, slug, projectRouting, { source: 'new' });
+    state.logEvent(st, 'project routing selected', {
+      source: 'new',
+      status: projectRouting.status,
+      projects: st.projects.length,
+    });
+    await state.write(root, slug, st);
+  }
+  log.ok(`created change: ${slug}`);
+  log.dim(`  ${dir}`);
+
+  if (micro) {
+    st.mode = 'micro';
+    state.setPhase(st, 'intake', 'completed');
+    markSkipped(st, 'requirement', 'micro mode');
+    markSkipped(st, 'design', 'micro mode');
+    markSkipped(st, 'archive', 'micro mode');
+    state.setPhase(st, 'plan', 'in_progress');
+    await change.writeArtifact(root, slug, 'plan.md', microPlan({ slug, title }));
+    state.logEvent(st, 'micro mode initialized', { level: 'L0', nextPhase: 'plan' });
+    await state.write(root, slug, st);
+    log.ok(`plan: ${dir}/plan.md`);
+    const draftResult = await createEntryWorkflowDraft(root, slug, { recipe: 'micro', reason: 'micro mode' });
+    if (draftResult) {
+      printWorkflowSelectionGuidance(slug);
+    }
+    return;
+  }
+
+  // Always create proposal.md from template (drafted from brainstorm)
+  const tpl = await templates.load('proposal.md');
+  const body = templates.render(tpl, {
+    slug,
+    title,
+    level,
+    source: 'manual',
+    sourceType: 'manual',
+    sourceRef: '(无外部输入,brainstorm 起步)',
+    summary: '这是手动创建的需求入口，尚未关联外部材料。后续在 requirement 阶段确认范围、验收口径和涉及项目。',
+    date: new Date().toISOString().slice(0, 10),
+  });
+  await change.writeArtifact(root, slug, 'proposal.md', body);
+  log.ok(`proposal: ${dir}/proposal.md`);
+  await ensureProblemCardCheckpoint(root, slug, {
+    title,
+    level,
+    source: 'manual',
+    projectRouting,
+    summary: 'proposal.md 已创建；请先补齐问题背景、目标、范围和验收口径。',
+  });
+
+  log.raw('');
+  log.dim('next: brainstorm in your IDE (use the devflow-brainstorm SKILL), then resolve the problem_card checkpoint.');
+  const draftResult = await createEntryWorkflowDraft(root, slug);
+  if (draftResult) {
+    printWorkflowSelectionGuidance(slug);
+  }
+}
+
+function markSkipped(st, phase, reason) {
+  st.phases = st.phases || {};
+  st.phases[phase] = st.phases[phase] || {};
+  st.phases[phase].status = 'skipped';
+  st.phases[phase].reason = reason;
+  st.phases[phase].ts = new Date().toISOString();
+}
+
+function microPlan({ slug, title }) {
+  const date = new Date().toISOString().slice(0, 10);
+  return [
+    `# Plan: ${title || slug}`,
+    '',
+    `> L0 micro plan, created ${date}. Keep this to 1-3 lines before apply.`,
+    '',
+    '1. 明确这次极简改动的文件、行为和验证命令。',
+    '2. apply 阶段只允许单文件、无 DDL、无接口契约变化；超出范围必须升级到 L1。',
+    '3. 完成后至少生成 `reports/test-report.md#unit`，再进入 review / verify / deliver。',
+    '',
+  ].join('\n');
+}
+
+async function resolvePreCreateProjectRouting(root, flags, source, query) {
+  const roots = parseRoots(flags.projectRoot || flags['project-root']);
+  if (roots.length) return routing.explicitProjectRouting(roots, { source });
+  if (flags['no-project-routing'] || flags.noProjectRouting) return null;
+
+  const searchRoots = parseRoots(flags.searchRoot || flags['search-root'] || flags.projectsRoot || root);
+  const result = await routing.routeProjects({
+    searchRoots,
+    query,
+    maxDepth: parseInt(flags.projectDepth || flags['project-depth'] || '3', 10),
+    topK: parseInt(flags.projectTopK || flags['project-top-k'] || '5', 10),
+  });
+  if (!result.recommended.length) return null;
+  return {
+    status: 'recommended',
+    source,
+    searchRoots: result.searchRoots,
+    queryTerms: routing.extractTerms(query).slice(0, 20),
+    candidates: result.candidates,
+    recommended: result.recommended,
+    slugBranchSource: result.recommended[0].root,
+  };
+}
+
+function parseRoots(value) {
+  return String(value || '')
+    .split(',')
+    .map((s) => s.trim())
+    .filter(Boolean);
+}
+
+async function ensureProblemCardCheckpoint(root, slug, details) {
+  const st = await state.read(root, slug);
+  if (checkpoint.latestPendingByType(st, 'problem_card')) return null;
+  if (checkpoint.hasResolvedDecision(st, 'problem_card', 'accept')) return null;
+
+  const projectNames = details.projectRouting && details.projectRouting.recommended && details.projectRouting.recommended.length
+    ? details.projectRouting.recommended.map((p) => `${p.name}:${p.role || 'candidate'}`).join(', ')
+    : '未确认';
+  const cp = checkpoint.addCheckpoint(st, {
+    type: 'problem_card',
+    phase: 'intake',
+    summary: `${details.title || slug}；level=${details.level || st.level || 'L2'}；projects=${projectNames}`,
+    question: '是否接受当前问题卡、复杂度分级和项目范围，并进入 requirement？',
+    options: [
+      { id: 'accept', label: '接受并进入需求分析', command: 'devflow checkpoint resolve --id=<checkpoint-id> --decision=accept' },
+      { id: 'revise', label: '继续补充问题卡', command: '编辑 proposal.md，必要时重跑 devflow new/ingest --project-root=...' },
+    ],
+    nextAction: 'devflow checkpoint resolve --id=<checkpoint-id> --decision=accept',
+    evidence: ['proposal.md'],
+    risks: ['未确认问题卡时直接 requirement，容易把错误范围带入后续设计和实现。'],
+  });
+  cp.options = cp.options.map((opt) => opt.id === 'accept'
+    ? { ...opt, command: `devflow checkpoint resolve --id=${cp.id} --decision=accept` }
+    : opt);
+  cp.nextAction = `devflow checkpoint resolve --id=${cp.id} --decision=accept`;
+  state.logEvent(st, 'checkpoint.add', { id: cp.id, type: cp.type, phase: cp.phase });
+  await state.write(root, slug, st);
+  log.raw('');
+  log.raw(checkpoint.renderNextStepCard(cp));
+  return cp;
+}
+
+async function createEntryWorkflowDraft(root, slug, opts = {}) {
+  try {
+    const cfg = (await config.read(root)) || {};
+    const st = await state.read(root, slug);
+    const result = workflowInit.draftRecommendedWorkflow(root, st, cfg, {
+      recipe: opts.recipe,
+      reason: opts.reason,
+      auto: true,
+    });
+    await state.write(root, slug, st);
+    if (result.created && result.recipe) {
+      log.ok(`workflow draft: ${result.recipe.label} (${result.recipe.id})`);
+    }
+    return result;
+  } catch (e) {
+    log.warn(`workflow draft not created: ${e.message}`);
+    log.dim(`workflow: devflow flow recommend --slug=${slug}`);
+    log.dim(`          devflow flow draft --slug=${slug}${opts.recipe ? ` --recipe=${opts.recipe}` : ''}`);
+    return null;
+  }
+}
+
+module.exports = { run };

package/src/cli/commands/plan.js

@@ -0,0 +1,49 @@
+'use strict';
+const log = require('../../utils/log.js');
+const state = require('../../core/state.js');
+const checkpoint = require('../../core/checkpoint.js');
+const helpers = require('./_helpers.js');
+
+async function run({ flags = {}, positional = [], cwd }) {
+  const root = cwd || process.cwd();
+  const slug = await helpers.resolveSlug(root, flags, positional);
+  if (!slug) { process.exitCode = 1; return; }
+  const st = await helpers.loadStateOrFail(root, slug);
+  if (!st) { process.exitCode = 1; return; }
+  if (helpers.blockWorkflowStep(root, st, slug, 'plan', 'plan')) return;
+
+  await helpers.writePhaseArtifact(root, slug, st, 'plan.md', 'plan.md', {});
+  if (st.mode !== 'micro') {
+    state.setPhase(st, 'design', 'completed');
+  }
+  state.setPhase(st, 'plan', 'in_progress');
+  if (!checkpoint.latestPendingByType(st, 'plan_review')) {
+    const cp = checkpoint.addCheckpoint(st, {
+      type: 'plan_review',
+      phase: 'plan',
+      summary: 'plan.md 已生成或待完善，请先审查任务拆分、范围和执行模式',
+      question: '是否接受当前 plan，并允许进入 apply？',
+      options: [
+        { id: 'accept', label: '接受计划', command: 'devflow checkpoint resolve --id=<checkpoint-id> --decision=accept' },
+        { id: 'revise', label: '修改计划', command: '编辑 plan.md 后重新运行 devflow plan 或直接更新 checkpoint' },
+      ],
+      nextAction: 'devflow checkpoint resolve --id=<checkpoint-id> --decision=accept',
+    });
+    cp.options = cp.options.map((opt) => opt.id === 'accept'
+      ? { ...opt, command: `devflow checkpoint resolve --id=${cp.id} --decision=accept` }
+      : opt);
+    cp.nextAction = `devflow checkpoint resolve --id=${cp.id} --decision=accept`;
+    state.logEvent(st, 'checkpoint.add', { id: cp.id, type: cp.type, phase: cp.phase });
+  }
+  helpers.completeWorkflowStep(st, 'plan');
+  state.logEvent(st, 'plan scaffold');
+  await state.write(root, slug, st);
+  const pending = checkpoint.latestPendingByType(st, 'plan_review');
+  log.dim('next: review plan.md before apply');
+  if (pending) {
+    log.raw('');
+    log.raw(checkpoint.renderNextStepCard(pending));
+  }
+}
+
+module.exports = { run };

package/src/cli/commands/propose.js

@@ -0,0 +1,27 @@
+'use strict';
+const log = require('../../utils/log.js');
+const state = require('../../core/state.js');
+const helpers = require('./_helpers.js');
+
+async function run({ flags = {}, positional = [], cwd }) {
+  const root = cwd || process.cwd();
+  const slug = await helpers.resolveSlug(root, flags, positional);
+  if (!slug) { process.exitCode = 1; return; }
+  const st = await helpers.loadStateOrFail(root, slug);
+  if (!st) { process.exitCode = 1; return; }
+
+  await helpers.writePhaseArtifact(root, slug, st, 'proposal.md', 'proposal.md', {
+    level: st.level,
+    source: (st.source && st.source.ref) || 'manual',
+    sourceType: (st.source && st.source.type) || 'manual',
+    sourceRef: (st.source && st.source.ref) || '',
+    summary: '',
+  });
+  state.setPhase(st, 'intake', 'completed');
+  state.setPhase(st, 'requirement', 'in_progress');
+  state.logEvent(st, 'propose');
+  await state.write(root, slug, st);
+  log.dim('next: devflow requirement');
+}
+
+module.exports = { run };