cc-devflow 4.2.0 → 4.4.1

package/lib/harness/planner.js

@@ -1,141 +0,0 @@
-/**
- * [INPUT]: 依赖 store 读取 TASKS.md 与输出路径，依赖 schemas 校验 manifest。
- * [OUTPUT]: 对外提供 TASKS.md → task-manifest.json 的解析与生成能力。
- * [POS]: harness 计划编排层，被 operations/plan 直接调用。
- * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
- */
-
-const {
-  nowIso,
-  readText,
-  readJson,
-  writeJson,
-  exists,
-  getTaskManifestPath,
-  getTasksMarkdownPath
-} = require('./store');
-const { parseManifest } = require('./schemas');
-
-const TASK_LINE = /^- \[( |x|X)\]\s+(T\d{3})\s*(.*)$/;
-const TRAILING_PATHS = /\(([^)]+)\)\s*$/;
-const DEPENDS_TAG = /dependsOn:([A-Za-z0-9_,-]+)/i;
-
-function normalizeTitle(rawTitle) {
-  return rawTitle
-    .replace(/\[P\]/g, '')
-    .replace(DEPENDS_TAG, '')
-    .trim();
-}
-
-function parseTouches(rawTail) {
-  const match = rawTail.match(TRAILING_PATHS);
-  if (!match) {
-    return [];
-  }
-
-  return match[1]
-    .split(',')
-    .map((item) => item.trim())
-    .filter(Boolean);
-}
-
-function parseDependsOn(rawTail, fallbackDependsOn, isParallel) {
-  const explicit = rawTail.match(DEPENDS_TAG);
-  if (explicit) {
-    return explicit[1]
-      .split(',')
-      .map((item) => item.trim())
-      .filter(Boolean);
-  }
-
-  if (isParallel || !fallbackDependsOn) {
-    return [];
-  }
-
-  return [fallbackDependsOn];
-}
-
-function parseTasksMarkdown(content) {
-  const lines = content.split(/\r?\n/);
-  const tasks = [];
-  let previousTaskId = null;
-
-  for (const line of lines) {
-    const match = line.match(TASK_LINE);
-    if (!match) {
-      continue;
-    }
-
-    const [, doneMark, taskId, tail] = match;
-    const isParallel = /\[P\]/.test(tail);
-    const touches = parseTouches(tail);
-    const dependsOn = parseDependsOn(tail, previousTaskId, isParallel);
-    const title = normalizeTitle(tail).replace(TRAILING_PATHS, '').trim() || `Task ${taskId}`;
-
-    tasks.push({
-      id: taskId,
-      title,
-      dependsOn,
-      touches,
-      run: [`echo "[TASK ${taskId}] ${title}"`],
-      checks: [],
-      status: doneMark.toLowerCase() === 'x' ? 'passed' : 'pending',
-      attempts: 0,
-      maxRetries: 1
-    });
-
-    previousTaskId = taskId;
-  }
-
-  return tasks;
-}
-
-function buildDefaultTasks(changeId) {
-  return [
-    {
-      id: 'T001',
-      title: `Bootstrap ${changeId}`,
-      dependsOn: [],
-      touches: [],
-      run: [`echo "[TASK T001] Bootstrap ${changeId}"`],
-      checks: [],
-      status: 'pending',
-      attempts: 0,
-      maxRetries: 1
-    }
-  ];
-}
-
-async function createTaskManifest({ repoRoot, changeId, goal, overwrite = false }) {
-  const manifestPath = getTaskManifestPath(repoRoot, changeId);
-
-  if (!overwrite && (await exists(manifestPath))) {
-    const existing = await readJson(manifestPath);
-    return parseManifest(existing);
-  }
-
-  const tasksPath = getTasksMarkdownPath(repoRoot, changeId);
-  const hasTasksFile = await exists(tasksPath);
-  const rawTasks = hasTasksFile ? parseTasksMarkdown(await readText(tasksPath)) : [];
-  const tasks = rawTasks.length > 0 ? rawTasks : buildDefaultTasks(changeId);
-
-  const manifest = parseManifest({
-    changeId,
-    goal: goal || `Deliver ${changeId} safely with auditable checkpoints.`,
-    createdAt: nowIso(),
-    updatedAt: nowIso(),
-    tasks,
-    metadata: {
-      source: hasTasksFile ? 'TASKS.md' : 'default',
-      generatedBy: 'harness:plan'
-    }
-  });
-
-  await writeJson(manifestPath, manifest);
-  return manifest;
-}
-
-module.exports = {
-  parseTasksMarkdown,
-  createTaskManifest
-};

package/lib/harness/schemas.js

@@ -1,108 +0,0 @@
-/**
- * [INPUT]: 依赖 zod 进行运行时 schema 校验，依赖调用方提供 manifest/report/checkpoint 原始对象。
- * [OUTPUT]: 对外提供 Manifest/Task/ReportCard/Checkpoint schema 与 parse 校验函数。
- * [POS]: harness 内核的类型边界层，被 planner/dispatcher/verifier/release 复用。
- * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
- */
-
-const { z } = require('zod');
-
-const CHANGE_ID_PATTERN = /^(REQ|BUG)-\d+$/;
-const TASK_ID_PATTERN = /^[A-Z][A-Z0-9_-]{1,31}$/;
-
-const ChangeIdSchema = z.string().regex(CHANGE_ID_PATTERN, 'Invalid changeId format');
-
-const TaskStatusSchema = z.enum(['pending', 'running', 'passed', 'failed', 'skipped']);
-
-const TaskSchema = z.object({
-  id: z.string().regex(TASK_ID_PATTERN, 'Invalid task id'),
-  title: z.string().min(1, 'Task title is required'),
-  dependsOn: z.array(z.string().regex(TASK_ID_PATTERN)).default([]),
-  touches: z.array(z.string().min(1)).default([]),
-  run: z.array(z.string().min(1)).min(1, 'At least one run command is required'),
-  checks: z.array(z.string().min(1)).default([]),
-  status: TaskStatusSchema.default('pending'),
-  attempts: z.number().int().min(0).default(0),
-  maxRetries: z.number().int().min(0).default(1),
-  lastError: z.string().optional()
-});
-
-const ManifestSchema = z.object({
-  changeId: ChangeIdSchema,
-  goal: z.string().min(1).default('Deliver planned requirement changes safely.'),
-  createdAt: z.string().datetime(),
-  updatedAt: z.string().datetime(),
-  tasks: z.array(TaskSchema),
-  metadata: z.object({
-    source: z.enum(['TASKS.md', 'default']).default('default'),
-    generatedBy: z.string().min(1).default('harness:plan')
-  }).default({ source: 'default', generatedBy: 'harness:plan' })
-});
-
-const CheckpointSchema = z.object({
-  changeId: ChangeIdSchema,
-  taskId: z.string().regex(TASK_ID_PATTERN),
-  sessionId: z.string().min(1),
-  status: TaskStatusSchema,
-  summary: z.string().min(1),
-  timestamp: z.string().datetime(),
-  attempt: z.number().int().min(0).default(0)
-});
-
-const GateResultSchema = z.object({
-  name: z.string().min(1),
-  status: z.enum(['pass', 'fail', 'skipped']),
-  command: z.string().min(1),
-  durationMs: z.number().int().min(0),
-  details: z.string().default('')
-});
-
-const ReportCardSchema = z.object({
-  changeId: ChangeIdSchema,
-  overall: z.enum(['pass', 'fail']),
-  quickGates: z.array(GateResultSchema),
-  strictGates: z.array(GateResultSchema),
-  review: z.object({
-    status: z.enum(['pass', 'fail', 'skipped']),
-    details: z.string().default('')
-  }),
-  blockingFindings: z.array(z.string()),
-  timestamp: z.string().datetime()
-});
-
-function parseWithSchema(schema, input, label) {
-  const parsed = schema.safeParse(input);
-  if (parsed.success) {
-    return parsed.data;
-  }
-
-  const issues = parsed.error.issues
-    .map((issue) => `${issue.path.join('.') || '<root>'}: ${issue.message}`)
-    .join('; ');
-  throw new Error(`${label} validation failed: ${issues}`);
-}
-
-function parseManifest(input) {
-  return parseWithSchema(ManifestSchema, input, 'Manifest');
-}
-
-function parseCheckpoint(input) {
-  return parseWithSchema(CheckpointSchema, input, 'Checkpoint');
-}
-
-function parseReportCard(input) {
-  return parseWithSchema(ReportCardSchema, input, 'ReportCard');
-}
-
-module.exports = {
-  ChangeIdSchema,
-  TaskSchema,
-  TaskStatusSchema,
-  ManifestSchema,
-  CheckpointSchema,
-  GateResultSchema,
-  ReportCardSchema,
-  parseManifest,
-  parseCheckpoint,
-  parseReportCard
-};