cc-devflow 4.5.11 → 4.5.12

package/lib/compiler/resource-copier.js

@@ -428,6 +428,7 @@ async function mirrorDirectoryRecursive(sourceDir, targetDir, options = {}) {
 
   if (!dryRun) {
     await fs.promises.mkdir(targetDir, { recursive: true, mode: 0o755 });
+    await pruneMirroredDirectoryRecursive(sourceDir, targetDir, options);
   }
 
   for (const entry of entries) {
@@ -473,6 +474,34 @@ async function mirrorDirectoryRecursive(sourceDir, targetDir, options = {}) {
   return result;
 }
 
+async function pruneMirroredDirectoryRecursive(sourceDir, targetDir, options = {}) {
+  const { verbose = false } = options;
+
+  if (!fs.existsSync(targetDir)) {
+    return;
+  }
+
+  const targetEntries = await fs.promises.readdir(targetDir, { withFileTypes: true });
+  await Promise.all(
+    targetEntries.map(async (entry) => {
+      const sourcePath = path.join(sourceDir, entry.name);
+      const targetPath = path.join(targetDir, entry.name);
+
+      if (!fs.existsSync(sourcePath)) {
+        await fs.promises.rm(targetPath, { recursive: true, force: true });
+        if (verbose) {
+          console.log(`Pruned stale skill file: ${path.relative(process.cwd(), targetPath)}`);
+        }
+        return;
+      }
+
+      if (entry.isDirectory()) {
+        await pruneMirroredDirectoryRecursive(sourcePath, targetPath, options);
+      }
+    })
+  );
+}
+
 // ============================================================
 // clearResourceCache - 清除资源缓存（用于测试）
 // ============================================================

package/lib/skill-runtime/__tests__/archive-change.test.js

@@ -61,13 +61,13 @@ describe('restoreChange', () => {
     const repoRoot = makeTempRepo();
     const archivedDir = path.join(repoRoot, 'devflow', 'changes', 'archive', '2026-04', 'REQ-002-restored');
     fs.mkdirSync(archivedDir, { recursive: true });
-    fs.writeFileSync(path.join(archivedDir, 'tasks.md'), '- [ ] task');
+    fs.writeFileSync(path.join(archivedDir, 'task.md'), '- [ ] task');
 
     const result = restoreChange(repoRoot, archivedDir);
 
     expect(result.changeKey).toBe('REQ-002-restored');
     expect(fs.existsSync(result.restored)).toBe(true);
-    expect(fs.existsSync(path.join(result.restored, 'tasks.md'))).toBe(true);
+    expect(fs.existsSync(path.join(result.restored, 'task.md'))).toBe(true);
     expect(fs.existsSync(archivedDir)).toBe(false);
 
     fs.rmSync(repoRoot, { recursive: true, force: true });

package/lib/skill-runtime/__tests__/benchmark-skills.test.js

@@ -1,6 +1,6 @@
 /**
  * [INPUT]: 依赖 scripts/benchmark-skills.js 导出的 runBenchmarkSkills 和临时 skill fixture。
- * [OUTPUT]: 验证 benchmark:skills 对 SKILL.md 入口体积执行 byte/line 预算。
+ * [OUTPUT]: 验证 benchmark:skills 对 SKILL.md 入口体积执行 byte/line advisory 预算。
  * [POS]: skill 入口瘦身基准的 Red/Green 证据。
  * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
  */
@@ -78,12 +78,12 @@ describe('benchmark:skills', () => {
     });
   });
 
-  test('exits 1 when cc-plan grows past the byte budget', () => {
+  test('reports advisory failure without blocking when cc-plan grows past the byte budget', () => {
     writeSkill(repoRoot, 'cc-plan', skillBody({ filler: 'x'.repeat(17000) }));
 
     const result = runBenchmarkSkills(repoRoot);
 
-    expect(result.code).toBe(1);
+    expect(result.code).toBe(0);
     expect(result.rows[0]).toMatchObject({
       skill: 'cc-plan',
       correctness_pass: false,

package/lib/skill-runtime/__tests__/cli-bootstrap.integration.test.js

@@ -108,7 +108,8 @@ describe('cc-devflow cli distribution bootstrap', () => {
 
     expect(skillContent).not.toContain('<!-- CC-DEVFLOW OUTPUT POLICY START -->');
     expect(skillContent).not.toContain('文档语言: zh-CN');
-    expect(skillContent).toContain('cc-devflow config resolve --format policy');
+    expect(skillContent).toContain('resolve-cc-devflow.sh');
+    expect(skillContent).toContain('bash "$DEVFLOW" config resolve --format policy');
     expect(fs.readFileSync(path.join(customSkillDir, 'SKILL.md'), 'utf8')).toBe('# Custom Skill\n');
   });
 
@@ -177,7 +178,10 @@ describe('cc-devflow cli distribution bootstrap', () => {
     expect(runCli(['init', '--dir', repoRoot], repoRoot).status).toBe(0);
 
     const targetSkill = path.join(repoRoot, '.claude', 'skills', 'cc-roadmap', 'SKILL.md');
+    const staleManagedFile = path.join(repoRoot, '.claude', 'skills', 'cc-act', 'assets', 'STALE.md');
+    fs.mkdirSync(path.dirname(staleManagedFile), { recursive: true });
     fs.writeFileSync(targetSkill, '# local override\n');
+    fs.writeFileSync(staleManagedFile, '# stale\n');
 
     const result = runCli(['init', '--dir', repoRoot, '--force'], repoRoot);
     expect(result.status).toBe(0);
@@ -186,10 +190,14 @@ describe('cc-devflow cli distribution bootstrap', () => {
       fs.readFileSync(path.join(TEMPLATE_ROOT, 'skills', 'cc-roadmap', 'SKILL.md'), 'utf8')
     );
     expect(fs.existsSync(`${targetSkill}.new`)).toBe(false);
+    expect(fs.existsSync(staleManagedFile)).toBe(false);
   });
 
   test('adapt mirrors public skills into .codex/skills for Codex', () => {
     expect(runCli(['init', '--dir', repoRoot], repoRoot).status).toBe(0);
+    const staleCodexAsset = path.join(repoRoot, '.codex', 'skills', 'cc-act', 'assets', 'STALE.md');
+    fs.mkdirSync(path.dirname(staleCodexAsset), { recursive: true });
+    fs.writeFileSync(staleCodexAsset, '# stale\n');
 
     const result = runCli(['adapt', '--cwd', repoRoot, '--platform', 'codex'], repoRoot);
     expect(result.status).toBe(0);
@@ -202,6 +210,7 @@ describe('cc-devflow cli distribution bootstrap', () => {
     expect(fs.existsSync(path.join(repoRoot, '.codex', 'skills', 'cc-review', 'SKILL.md'))).toBe(true);
     expect(fs.existsSync(path.join(repoRoot, '.codex', 'skills', 'cc-check', 'SKILL.md'))).toBe(true);
     expect(fs.existsSync(path.join(repoRoot, '.codex', 'skills', 'cc-act', 'SKILL.md'))).toBe(true);
+    expect(fs.existsSync(staleCodexAsset)).toBe(false);
 
     const codexInvestigateSkill = fs.readFileSync(
       path.join(repoRoot, '.codex', 'skills', 'cc-investigate', 'SKILL.md'),
@@ -217,9 +226,9 @@ describe('cc-devflow cli distribution bootstrap', () => {
     expect(codexDoSkill.data.writes).toEqual(
       expect.arrayContaining([
         expect.objectContaining({
-          path: 'devflow/changes/<change-key>/execution/tasks/<task-id>/events.jsonl',
+          path: 'devflow/changes/<change-key>/task.md',
           durability: 'durable',
-          required: false
+          required: true
         })
       ])
     );
@@ -277,7 +286,8 @@ describe('cc-devflow cli distribution bootstrap', () => {
     );
     expect(codexPlanSkill).not.toContain('<!-- CC-DEVFLOW OUTPUT POLICY START -->');
     expect(codexPlanSkill).not.toContain('文档语言: zh-CN');
-    expect(codexPlanSkill).toContain('cc-devflow config resolve --format policy');
+    expect(codexPlanSkill).toContain('resolve-cc-devflow.sh');
+    expect(codexPlanSkill).toContain('bash "$DEVFLOW" config resolve --format policy');
   });
 
   test('adapt preserves pre-existing non-public Codex skills and does not mirror new private ones', () => {

package/lib/skill-runtime/errors.js

@@ -1,6 +1,6 @@
 /**
  * [INPUT]: 接收 runtime/query/compiler 边界抛出的错误或失败字段。
- * [OUTPUT]: 生成可序列化 named error，保留 artifact refs 与 rescue action。
+ * [OUTPUT]: 生成可序列化 named error，保留 refs 与 rescue action。
  * [POS]: skill runtime 的失败语义层，避免用 null/false/string 表达可恢复失败。
  * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
  */
@@ -10,7 +10,7 @@ class SkillRuntimeError extends Error {
     super(message);
     this.name = name;
     this.artifactRefs = options.artifactRefs || [];
-    this.rescueAction = options.rescueAction || 'inspect-runtime-artifacts';
+    this.rescueAction = options.rescueAction || 'inspect-task-md-and-git-history';
     this.details = options.details || {};
   }
 }
@@ -27,7 +27,7 @@ function serializeError(error, fallbackName = 'SkillRuntimeError') {
     name,
     message,
     artifactRefs: error?.artifactRefs || [],
-    rescueAction: error?.rescueAction || 'inspect-runtime-artifacts',
+    rescueAction: error?.rescueAction || 'inspect-task-md-and-git-history',
     details: error?.details || {}
   };
 }

package/lib/skill-runtime/index.js

@@ -1,44 +1,26 @@
 /**
- * [INPUT]: 依赖 skill runtime 各模块。
- * [OUTPUT]: 统一导出 schema/store/planner/query 与 operations 入口。
- * [POS]: skill runtime 模块聚合出口，被内部测试与脚本使用。
+ * [INPUT]: 依赖 skill runtime 基础模块。
+ * [OUTPUT]: 统一导出 config/path/store/query helpers。
+ * [POS]: skill runtime 模块聚合出口，只保留 CLI 仍需的轻量能力。
  * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
  */
 
 const store = require('./store');
-const schemas = require('./schemas');
-const planner = require('./planner');
 const query = require('./query');
 const queryRegistry = require('./query-registry');
 const errors = require('./errors');
 const trace = require('./trace');
-const readiness = require('./readiness');
-const intent = require('./intent');
-const artifacts = require('./artifacts');
-const lifecycle = require('./lifecycle');
-const teamState = require('./team-state');
-const delegation = require('./delegation');
 const paths = require('./paths');
 const config = require('./config');
-const worker = require('./operations/worker');
-const workerRun = require('./operations/worker-run');
+const archiveChange = require('./archive-change');
 
 module.exports = {
   ...store,
-  ...schemas,
-  ...planner,
   ...query,
   ...queryRegistry,
   ...errors,
   ...trace,
-  ...readiness,
-  ...artifacts,
-  ...intent,
-  ...lifecycle,
-  ...teamState,
-  ...delegation,
   ...paths,
   ...config,
-  ...worker,
-  ...workerRun
+  ...archiveChange
 };

package/lib/skill-runtime/paths.js

@@ -1,6 +1,6 @@
 /**
- * [INPUT]: 依赖 fs/path，接收 repoRoot/changeId/taskId/workerId 等定位参数。
- * [OUTPUT]: 对外提供 devflow canonical layout 的唯一路径解析能力。
+ * [INPUT]: 依赖 fs/path，接收 repoRoot/changeId 等定位参数。
+ * [OUTPUT]: 对外提供 devflow canonical change layout 的唯一路径解析能力。
  * [POS]: skill runtime 的路径真相源，完整 change key 才是目录身份。
  * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
  */
@@ -70,10 +70,6 @@ function getChangesRoot(repoRoot) {
   return path.join(getDevflowRoot(repoRoot), 'changes');
 }
 
-function getWorkspacesRoot(repoRoot) {
-  return path.join(getDevflowRoot(repoRoot), 'workspaces');
-}
-
 function listChangeKeys(repoRoot) {
   const changesRoot = getChangesRoot(repoRoot);
   if (!fs.existsSync(changesRoot)) {
@@ -196,56 +192,15 @@ function nextChangeKey(repoRoot, prefix, description) {
 function getChangePaths(repoRoot, changeId, options = {}) {
   const changeKey = resolveChangeKey(repoRoot, changeId, options);
   const changeDir = path.join(getChangesRoot(repoRoot), changeKey);
-  const metaDir = path.join(changeDir, 'meta');
-  const planningDir = path.join(changeDir, 'planning');
-  const executionDir = path.join(changeDir, 'execution');
-  const reviewDir = path.join(changeDir, 'review');
   const handoffDir = path.join(changeDir, 'handoff');
 
   return {
     changeId,
     changeKey,
     changeDir,
-    metaDir,
-    planningDir,
-    executionDir,
-    reviewDir,
     handoffDir,
-    tasksDir: path.join(executionDir, 'tasks'),
-    workersDir: path.join(executionDir, 'workers'),
-    workspacesDir: path.join(getWorkspacesRoot(repoRoot), changeKey)
-  };
-}
-
-function getTaskPaths(repoRoot, changeId, taskId, options = {}) {
-  const change = getChangePaths(repoRoot, changeId, options);
-  const taskDir = path.join(change.tasksDir, taskId);
-
-  return {
-    ...change,
-    taskId,
-    taskDir,
-    eventsPath: path.join(taskDir, 'events.jsonl')
-  };
-}
-
-function getWorkerPaths(repoRoot, changeId, workerId, options = {}) {
-  const change = getChangePaths(repoRoot, changeId, options);
-  const workspacePath = path.join(change.workspacesDir, workerId);
-  const workerDir = path.join(workspacePath, '.runtime');
-
-  return {
-    ...change,
-    workerId,
-    workerDir,
-    sharedRuntimeDir: path.join(change.workspacesDir, '.runtime'),
-    assignmentPath: path.join(workerDir, 'assignment.md'),
-    promptPath: path.join(workerDir, 'prompt.md'),
-    launchPath: path.join(workerDir, 'launch.md'),
-    statePath: path.join(workerDir, 'state.md'),
-    journalPath: path.join(workerDir, 'journal.md'),
-    sessionLogPath: path.join(workerDir, 'session.log'),
-    workspacePath
+    taskPath: path.join(changeDir, 'task.md'),
+    prBriefPath: path.join(handoffDir, 'pr-brief.md')
   };
 }
 
@@ -256,11 +211,9 @@ module.exports = {
   getChangeSlug,
   getDevflowRoot,
   getChangesRoot,
-  getWorkspacesRoot,
   nextChangeKey,
   resolveChangeKey,
   buildChangeKey,
   getChangePaths,
-  getTaskPaths,
-  getWorkerPaths
+  assertChangeId
 };

package/lib/skill-runtime/query-registry.js

@@ -1,7 +1,7 @@
 /**
  * [INPUT]: 接收 query id、repoRoot/changeId 与只读 handler registry。
- * [OUTPUT]: 返回 typed query result：ok/data 或 named error，并附 operational trace。
- * [POS]: skill runtime 的查询分发表，只读派生已有 artifact，不承载 workflow 语义。
+ * [OUTPUT]: 返回 typed query result：ok/data 或 named error，并附 trace。
+ * [POS]: skill runtime 的查询分发表，只读派生 task.md 与 Git 语义。
  * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
  */
 
@@ -59,7 +59,7 @@ function createQueryRegistry(entries) {
           `Missing required query artifact: ${missingRefs.join(', ')}`,
           {
             artifactRefs: missingRefs,
-            rescueAction: 'create required workflow artifacts before running this query'
+            rescueAction: 'create task.md before running this query'
           }
         );
       }
@@ -84,7 +84,7 @@ function createQueryRegistry(entries) {
           event: `query.${queryId}.failed`,
           changeId: context.changeId,
           artifactRefs,
-          nextAction: error.rescueAction || 'inspect-workflow-artifacts'
+          nextAction: error.rescueAction || 'inspect-task-md-and-git-history'
         })
       };
     }

package/lib/skill-runtime/query.js

@@ -1,238 +1,126 @@
 /**
- * [INPUT]: 依赖 store/artifacts/lifecycle 读取 requirement 工件，接收 repoRoot、changeId 和可选 changeKey。
- * [OUTPUT]: 对外提供 typed query registry 与兼容查询函数，附 named error 和 trace shape。
- * [POS]: skill runtime 的薄查询兼容层，只读 artifact 与共享 lifecycle 语义，不再自带流程推导副本。
+ * [INPUT]: 依赖 task.md、handoff/pr-brief.md 与 Git 状态。
+ * [OUTPUT]: 提供 Git-first workflow-context 查询，不读取流程 JSON。
+ * [POS]: cc-devflow CLI 的只读上下文层；Git 是历史真相，task.md 是任务真相。
  * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
  */
 
-const {
-  getRuntimeStatePath,
-  getTaskManifestPath,
-  getReportCardPath,
-  exists,
-  readJson
-} = require('./store');
-const { getIntentPrBriefPath } = require('./artifacts');
-const { deriveManifestExecutionState } = require('./planner');
-const {
-  getApprovalState,
-  deriveLifecycleStage,
-  deriveTaskProgress,
-  isTaskCompletedStatus
-} = require('./lifecycle');
+const fs = require('fs');
+const path = require('path');
+const { spawnSync } = require('child_process');
 const { createQueryRegistry } = require('./query-registry');
-const { namedError } = require('./errors');
-const { deriveShipReadiness } = require('./readiness');
-const {
-  getWorkflowContext,
-  getWorkflowContextArtifactRefs,
-  getWorkflowContextRequiredArtifactRefs
-} = require('./workflow-context');
-
-async function readQueryArtifact(filePath, { required = true } = {}) {
-  try {
-    const value = await readJson(filePath, null);
-
-    if (required && value === null) {
-      throw namedError(
-        'MissingQueryArtifactError',
-        `Missing required query artifact: ${filePath}`,
-        {
-          artifactRefs: [filePath],
-          rescueAction: 'create required workflow artifacts before running this query'
-        }
-      );
-    }
-
-    return value;
-  } catch (error) {
-    if (error.name === 'MissingQueryArtifactError') {
-      throw error;
-    }
+const { getChangePaths } = require('./paths');
+const { createTrace } = require('./trace');
 
-    throw namedError(
-      'InvalidQueryArtifactError',
-      `Invalid query artifact ${filePath}: ${error.message}`,
-      {
-        artifactRefs: [filePath],
-        rescueAction: 'repair or regenerate the invalid workflow artifact before running this query',
-        details: {
-          cause: error.name || 'Error'
-        }
-      }
-    );
-  }
+function readTextIfExists(filePath) {
+  return fs.existsSync(filePath) ? fs.readFileSync(filePath, 'utf8') : null;
 }
 
-/**
- * 获取任务进度统计
- * @param {string} repoRoot - 仓库根目录
- * @param {string} changeId - 需求 ID
- * @returns {Promise<Object>} 进度统计对象
- */
-async function getProgress(repoRoot, changeId, options = {}) {
-  const manifestPath = getTaskManifestPath(repoRoot, changeId, options);
-  const manifest = await readQueryArtifact(manifestPath);
-  return deriveTaskProgress(manifest.tasks || []);
-}
+function runGit(repoRoot, args) {
+  const result = spawnSync('git', args, {
+    cwd: repoRoot,
+    encoding: 'utf8'
+  });
 
-/**
- * 获取下一个待执行的任务
- * @param {string} repoRoot - 仓库根目录
- * @param {string} changeId - 需求 ID
- * @returns {Promise<Object|null>} 下一个任务对象或 null
- */
-async function getNextTask(repoRoot, changeId, options = {}) {
-  const manifestPath = getTaskManifestPath(repoRoot, changeId, options);
-  const manifest = await readQueryArtifact(manifestPath);
-  const executionState = deriveManifestExecutionState(manifest.tasks || []);
-  const activePhase = executionState.activePhase;
-  const completedIds = new Set(
-    (manifest.tasks || [])
-      .filter((task) => isTaskCompletedStatus(task.status))
-      .map((task) => task.id)
-  );
-  const currentTaskId = manifest.currentTaskId ?? executionState.currentTaskId;
-
-  if (currentTaskId) {
-    const currentTask = manifest.tasks.find((task) => task.id === currentTaskId);
-    if (currentTask && currentTask.status === 'pending') {
-      return currentTask;
-    }
+  if (result.status !== 0) {
+    return null;
   }
 
-  const nextTask = (manifest.tasks || []).find((task) => {
-    if (task.status !== 'pending') {
-      return false;
-    }
+  return result.stdout.trim();
+}
 
-    if (activePhase !== null && activePhase !== undefined && (task.phase || 1) !== activePhase) {
-      return false;
-    }
+function parseTaskSummary(markdown) {
+  const lines = String(markdown || '').split(/\r?\n/);
+  const tasks = [];
 
-    return (task.dependsOn || []).every((depId) => completedIds.has(depId));
-  });
+  for (const line of lines) {
+    const match = line.match(/^\s*-\s+\[( |x|X)\]\s+((?:T\d+|[A-Z]+-\d+)[^:\n]*)(?::\s*)?(.*)$/);
+    if (!match) continue;
 
-  return nextTask || null;
-}
+    tasks.push({
+      id: match[2].trim().split(/\s+/)[0],
+      title: (match[3] || match[2]).trim(),
+      status: match[1].toLowerCase() === 'x' ? 'done' : 'pending'
+    });
+  }
 
-/**
- * 获取完整的聚合状态视图
- * @param {string} repoRoot - 仓库根目录
- * @param {string} changeId - 需求 ID
- * @returns {Promise<Object>} 完整状态对象
- */
-async function getFullState(repoRoot, changeId, options = {}) {
-  const statePath = getRuntimeStatePath(repoRoot, changeId, options);
-  const reportPath = getReportCardPath(repoRoot, changeId, options);
-  const prBriefPath = getIntentPrBriefPath(repoRoot, changeId, options);
-
-  const [state, manifest, hasPrBrief] = await Promise.all([
-    readQueryArtifact(statePath),
-    readQueryArtifact(getTaskManifestPath(repoRoot, changeId, options)),
-    exists(prBriefPath)
-  ]);
-  const progress = await getProgress(repoRoot, changeId, options);
-  const nextTask = await getNextTask(repoRoot, changeId, options);
-  const report = await readQueryArtifact(reportPath, { required: false });
+  const completed = tasks.filter((task) => task.status === 'done').length;
+  const next = tasks.find((task) => task.status === 'pending') || null;
 
   return {
-    lifecycle: {
-      changeId: state.changeId,
-      goal: state.goal,
-      status: state.status,
-      initializedAt: state.initializedAt,
-      plannedAt: state.plannedAt,
-      verifiedAt: state.verifiedAt,
-      releasedAt: state.releasedAt,
-      updatedAt: state.updatedAt,
-      stage: deriveLifecycleStage({ state, manifest, report, hasPrBrief }),
-      approval: getApprovalState(state, manifest)
-    },
-    progress,
-    nextTask,
-    delivery: {
-      prBriefPath: hasPrBrief ? prBriefPath : null
-    },
-    quality: report ? {
-      overall: report.overall,
-      verdict: report.verdict || (report.overall === 'pass' ? 'pass' : 'fail'),
-      reviewStatus: report.review?.status || 'skipped',
-      reviewFindings: (report.review?.findings || []).length,
-      blockingFindings: report.blockingFindings,
-      timestamp: report.timestamp
-    } : null
+    total: tasks.length,
+    completed,
+    pending: tasks.length - completed,
+    next
   };
 }
 
-async function getShipReadiness(repoRoot, changeId, options = {}) {
-  const reportPath = getReportCardPath(repoRoot, changeId, options);
-  const report = await readJson(reportPath, null);
-
-  if (!report) {
-    throw namedError(
-      'MissingReportCardError',
-      `Missing report card for ${changeId}`,
-      {
-        artifactRefs: [reportPath],
-        rescueAction: 'run cc-check and create review/report-card.json before cc-act'
-      }
-    );
-  }
+function getWorkflowContextArtifactRefs(repoRoot, changeId, options = {}) {
+  const change = getChangePaths(repoRoot, changeId, options);
+  return [
+    path.join(change.changeDir, 'task.md'),
+    path.join(change.handoffDir, 'pr-brief.md')
+  ];
+}
 
-  return deriveShipReadiness(report, { reportPath });
+function getWorkflowContextRequiredArtifactRefs(repoRoot, changeId, options = {}) {
+  const change = getChangePaths(repoRoot, changeId, options);
+  return [path.join(change.changeDir, 'task.md')];
 }
 
-function queryArtifactRefs(repoRoot, changeId, names, options = {}) {
-  const refs = {
-    manifest: getTaskManifestPath(repoRoot, changeId, options),
-    state: getRuntimeStatePath(repoRoot, changeId, options),
-    report: getReportCardPath(repoRoot, changeId, options),
-    prBrief: getIntentPrBriefPath(repoRoot, changeId, options)
-  };
+async function getWorkflowContext(repoRoot, changeId, options = {}) {
+  const change = getChangePaths(repoRoot, changeId, options);
+  const taskPath = path.join(change.changeDir, 'task.md');
+  const prBriefPath = path.join(change.handoffDir, 'pr-brief.md');
+  const taskMarkdown = readTextIfExists(taskPath) || '';
+  const taskSummary = parseTaskSummary(taskMarkdown);
 
-  return names.map((name) => refs[name]).filter(Boolean);
+  const branch = runGit(repoRoot, ['branch', '--show-current']) || '';
+  const head = runGit(repoRoot, ['rev-parse', '--short', 'HEAD']) || '';
+  const status = runGit(repoRoot, ['status', '--short']) || '';
+  const recentCommits = runGit(repoRoot, ['log', '--oneline', '-5']) || '';
+
+  return {
+    changeId,
+    changeKey: change.changeKey,
+    nextAction: {
+      skill: taskSummary.next ? 'cc-do' : 'cc-check',
+      taskId: taskSummary.next ? taskSummary.next.id : null
+    },
+    files: {
+      task: taskPath,
+      prBrief: fs.existsSync(prBriefPath) ? prBriefPath : null
+    },
+    taskSummary,
+    git: {
+      branch,
+      head,
+      dirty: status.length > 0,
+      status: status ? status.split(/\r?\n/) : [],
+      recentCommits: recentCommits ? recentCommits.split(/\r?\n/) : []
+    }
+  };
 }
 
 const registry = createQueryRegistry([
-  {
-    id: 'progress',
-    artifactRefs: ({ repoRoot, changeId, changeKey }) => queryArtifactRefs(repoRoot, changeId, ['manifest'], { changeKey }),
-    requiredArtifactRefs: ({ repoRoot, changeId, changeKey }) => queryArtifactRefs(repoRoot, changeId, ['manifest'], { changeKey }),
-    handler: ({ repoRoot, changeId, changeKey }) => getProgress(repoRoot, changeId, { changeKey })
-  },
-  {
-    id: 'next-task',
-    artifactRefs: ({ repoRoot, changeId, changeKey }) => queryArtifactRefs(repoRoot, changeId, ['manifest'], { changeKey }),
-    requiredArtifactRefs: ({ repoRoot, changeId, changeKey }) => queryArtifactRefs(repoRoot, changeId, ['manifest'], { changeKey }),
-    handler: ({ repoRoot, changeId, changeKey }) => getNextTask(repoRoot, changeId, { changeKey })
-  },
-  {
-    id: 'full-state',
-    artifactRefs: ({ repoRoot, changeId, changeKey }) => queryArtifactRefs(repoRoot, changeId, ['state', 'manifest', 'report', 'prBrief'], { changeKey }),
-    requiredArtifactRefs: ({ repoRoot, changeId, changeKey }) => queryArtifactRefs(repoRoot, changeId, ['state', 'manifest'], { changeKey }),
-    handler: ({ repoRoot, changeId, changeKey }) => getFullState(repoRoot, changeId, { changeKey })
-  },
-  {
-    id: 'ship-readiness',
-    artifactRefs: ({ repoRoot, changeId, changeKey }) => queryArtifactRefs(repoRoot, changeId, ['report'], { changeKey }),
-    handler: ({ repoRoot, changeId, changeKey }) => getShipReadiness(repoRoot, changeId, { changeKey })
-  },
   {
     id: 'workflow-context',
-    artifactRefs: ({ repoRoot, changeId, changeKey }) => getWorkflowContextArtifactRefs(repoRoot, changeId, { changeKey }),
-    requiredArtifactRefs: ({ repoRoot, changeId, changeKey }) => getWorkflowContextRequiredArtifactRefs(repoRoot, changeId, { changeKey }),
-    nextAction: 'read-compact-workflow-context',
+    artifactRefs: ({ repoRoot, changeId, changeKey }) => (
+      getWorkflowContextArtifactRefs(repoRoot, changeId, { changeKey })
+    ),
+    requiredArtifactRefs: ({ repoRoot, changeId, changeKey }) => (
+      getWorkflowContextRequiredArtifactRefs(repoRoot, changeId, { changeKey })
+    ),
+    nextAction: 'read-task-md-and-git-history',
     handler: ({ repoRoot, changeId, changeKey }) => getWorkflowContext(repoRoot, changeId, { changeKey })
   }
 ]);
 
 module.exports = {
-  getProgress,
-  getNextTask,
-  getFullState,
-  getShipReadiness,
   getWorkflowContext,
+  getWorkflowContextArtifactRefs,
+  getWorkflowContextRequiredArtifactRefs,
   listQueryIds: registry.listQueryIds,
-  runQuery: registry.runQuery
+  runQuery: registry.runQuery,
+  createTrace
 };