coding-agent-harness 1.0.2 → 1.0.5

package/templates/dashboard/assets/i18n.js

@@ -4,9 +4,11 @@ window.HarnessI18n = {
     "projectCockpit": "Console",
     "overview": "Overview",
     "taskIndex": "Task Index",
-    "reviewQueue": "Review Queue",
+    "reviewQueue": "Lifecycle Queue Workbench",
     "moduleView": "Modules",
     "readiness": "Readiness",
+    "snapshotStatus": "Snapshot status",
+    "snapshot": "Snapshot",
     "tasks": "Tasks",
     "blockers": "Blockers",
     "advice": "Advice",
@@ -23,6 +25,7 @@ window.HarnessI18n = {
     "missingBriefs": "tasks still need human visibility briefs.",
     "reviewAdvice": "Continue, but keep adoption advice visible.",
     "noBlockers": "No blockers in this snapshot.",
+    "snapshotNotValidated": "Snapshot only; run validated status before release decisions.",
     "firstLook": "First look",
     "projectFlow": "Project Flow",
     "projectProgress": "Project Progress",
@@ -77,12 +80,6 @@ window.HarnessI18n = {
     "moduleTasks": "Module Tasks",
     "noModuleTasks": "No module tasks.",
     "migration": "Migration",
-    "migrationSnapshot": "Migration Snapshot",
-    "taskPreset": "Task preset",
-    "targetLevel": "Target level",
-    "achievedLevel": "Achieved level",
-    "strictDeferred": "Strict deferred",
-    "evidenceBundle": "Evidence bundle",
     "migrationSummary": "Migration Attention",
     "migrationWorkbench": "Migration Workbench",
     "aggregateMigrationView": "aggregate migration view",
@@ -138,6 +135,7 @@ window.HarnessI18n = {
     "state_pass": "pass",
     "state_warn": "warn",
     "state_fail": "fail",
+    "state_snapshot": "snapshot",
     "state_in_progress": "in progress",
     "state_planned": "planned",
     "state_review": "review",
@@ -174,20 +172,39 @@ window.HarnessI18n = {
     "layout": "View Layout",
     "layoutList": "List View",
     "layoutGrid": "Grid View",
+    "sortByTime": "Time order",
+    "sortNewest": "Newest first",
+    "sortOldest": "Oldest first",
+    "activeBriefCount": "{count} briefs · {order}",
+    "copyTaskName": "Copy task folder name",
+    "copyTaskNameShort": "Copy",
+    "copyTaskNameSuccess": "Copied",
+    "copyTaskNameFailed": "Failed",
     "legacyState": "Task state",
     "lifecycleState": "Lifecycle",
     "reviewStatus": "Review",
-    "closeoutStatus": "Closeout",
+    "sedimentationStatus": "Sedimentation",
+    "closeoutStatus": "Finalization",
+    "lifecycleQueues": "Lifecycle queues",
+    "queueReasons": "Queue reasons",
     "state_closing": "closing",
     "state_closed": "closed",
     "state_ready": "ready",
     "state_in_review": "in review",
     "state_review-blocked": "review blocked",
+    "state_closed-review-pending": "closed, review pending",
     "state_missing": "missing",
     "state_required": "required",
-    "state_reviewed-unconfirmed": "reviewed",
+    "state_agent-reviewed": "agent reviewed",
     "state_confirmed": "confirmed",
     "state_blocked-open-findings": "blocked findings",
+    "state_not-in-queue": "not in queue",
+    "state_needs-material": "needs material",
+    "state_ready-to-confirm": "ready to confirm",
+    "state_closed-debt": "closed debt",
+    "state_missing-materials": "missing materials",
+    "state_soft-deleted-superseded": "soft-deleted / superseded",
+    "state_finalized": "finalized",
     "reviewActions": "Review Actions",
     "reviewWorkspace": "Review Workspace",
     "openReviewWorkspace": "Open Review Workspace",
@@ -197,14 +214,52 @@ window.HarnessI18n = {
     "documentMissing": "Document missing from this snapshot.",
     "staticReadOnly": "Static snapshot is read-only",
     "staticReadOnlyDetail": "Use the dynamic workbench to submit review or governance actions.",
-    "reviewQueueSubtitle": "Only tasks currently in the execution Review stage appear here. Closeout is tracked separately.",
+    "reviewQueueSubtitle": "Routes tasks by lifecycle queue so review work, repairs, blockers, lessons, finalized records, and superseded history stay separate.",
+    "reviewQueueTabs": "Lifecycle queues",
+    "queueReview": "Review",
+    "queueReviewDesc": "Only tasks whose taskQueues include review. These are ready for human review confirmation.",
+    "queueMissingMaterials": "Missing Materials",
+    "queueMissingMaterialsDesc": "Tasks missing review submissions, walkthroughs, lesson decisions, or other required materials.",
+    "queueBlocked": "Blocked",
+    "queueBlockedDesc": "Tasks with open blocking findings or state conflicts that prevent confirmation.",
+    "queueLessons": "Lessons",
+    "queueLessonsDesc": "Tasks with lesson candidates or promotion work that still needs governance routing.",
+    "queueConfirmedFinalized": "Confirmed / Finalized",
+    "queueConfirmedFinalizedDesc": "Human-confirmed tasks and finalized records kept for audit and closeout follow-through.",
+    "queueSoftDeletedSuperseded": "Soft-deleted / Superseded",
+    "queueSoftDeletedSupersededDesc": "Historical tasks with tombstones, replacements, merges, archives, or abandoned state.",
+    "reasonFilter": "Reason filter",
+    "allReasons": "All reasons",
+    "reason": "Reason",
+    "sortBy": "Sort by",
+    "sortQueuePriority": "Queue priority",
+    "sortTaskId": "Task ID",
+    "reviewSubmitted": "Review submitted",
+    "materialsReady": "Materials ready",
+    "yes": "Yes",
+    "no": "No",
+    "copyRepairPrompt": "Copy repair prompt",
+    "copyRepairPromptSuccess": "Prompt copied",
+    "copyLessonPrompt": "Copy lesson prompt",
+    "createLessonTask": "Create sedimentation task",
+    "openFollowUpTask": "Open follow-up task",
+    "lessonSedimentationActions": "Sedimentation actions",
+    "lessonWorkbenchRequired": "Creation is available in the dynamic workbench. The prompt can still be copied from this snapshot.",
+    "moreLessonCandidates": "+{count} more candidates in full workspace",
+    "lessonTaskCreating": "Creating task...",
+    "lessonTaskCreated": "Task created",
+    "lessonTaskCreateFailed": "Lesson task creation failed",
+    "noQueueTasks": "No tasks in this lifecycle queue.",
     "reviewReady": "Ready",
+    "reviewNeedsMaterial": "Needs material",
+    "reviewClosedDebt": "Closed debt",
     "reviewBlockedQueue": "Blocked",
     "reviewConfirmedQueue": "Confirmed",
     "noReviewTasks": "No tasks are currently in review.",
     "reviewAlreadyConfirmed": "Human review is already confirmed.",
     "reviewBlocked": "Close P0-P2 open or release-blocking findings before confirming.",
     "reviewWalkthroughRequired": "Add and link a walkthrough in Closeout SSoT before confirming human review.",
+    "reviewQueueRequired": "This task is not in the canonical Review queue.",
     "reviewWorkbenchReady": "Confirm the human review when the evidence and findings are checked.",
     "reviewConfirmChecklist": "I checked the walkthrough, task review evidence, and open findings.",
     "confirmReviewComplete": "Confirm Human Review",
@@ -212,16 +267,83 @@ window.HarnessI18n = {
     "reviewConfirmTextMismatch": "Type the task id shown in the input hint.",
     "reviewSubmitting": "Submitting review confirmation...",
     "reviewCompleteSuccess": "Review confirmed. Reloading snapshot...",
-    "reviewCompleteFailed": "Review confirmation failed"
+    "reviewCompleteFailed": "Review confirmation failed",
+    "presetCatalog": "Presets",
+    "presetCatalogSubtitle": "Manage project, user, and bundled task method packages. Precedence is project first, then user, then bundled.",
+    "presetSearch": "Search presets",
+    "presetSearchPlaceholder": "Search id, purpose, kind, source, or path",
+    "presetSourceFilter": "Preset source filter",
+    "allPresets": "All",
+    "presetSourceProject": "Project",
+    "presetSourceUser": "User",
+    "presetSourceBuiltin": "Builtin",
+    "presetSource_project": "Project",
+    "presetSource_user": "User",
+    "presetSource_builtin": "Builtin",
+    "presetEffective": "Effective",
+    "presetShadowed": "Shadowed",
+    "presetSources": "Preset Sources",
+    "presetSourcesHint": "Roots are read in precedence order. Higher layers override lower layers with the same id.",
+    "presetPriorityTitle": "Preset precedence",
+    "presetCollection": "Preset collection",
+    "presetCollectionHint": "Select a preset to inspect its manifest and actions.",
+    "presetLayerStack": "Layer stack for this id",
+    "presetLayerStackHint": "Project presets override user presets. User presets override bundled presets.",
+    "presetContextActions": "Selected preset actions",
+    "presetCheckHint": "Validate the currently selected preset manifest.",
+    "presetShadowedActionHint": "This layer is shadowed. CLI check and inspect commands resolve the effective preset by id, so they are disabled here.",
+    "presetCheckSelected": "Check selected preset",
+    "presetUninstallSelected": "Uninstall selected layer",
+    "presetUninstallHint": "Scope is locked to the selected project or user layer.",
+    "presetBuiltinImmutable": "Bundled presets are package defaults and cannot be uninstalled.",
+    "presetImportTitle": "Import preset",
+    "presetImportHint": "Install a local folder, .zip archive, or bundled preset id into a project or user layer.",
+    "presetRestoreBundled": "Restore bundled presets",
+    "presetRestoreBundledHint": "Copies bundled presets into the selected local layer. CLI name: preset seed.",
+    "presetCommandsEffectiveOnly": "CLI inspect/check commands resolve the effective preset by id. This shadowed layer is shown for comparison only.",
+    "noPresets": "No presets found.",
+    "version": "Version",
+    "manifestVersion": "Manifest version",
+    "manifestPath": "Manifest path",
+    "source": "Source",
+    "scope": "Scope",
+    "taskKind": "Task kind",
+    "budgets": "Budgets",
+    "inputs": "Inputs",
+    "writeScopes": "Write scopes",
+    "requiredReads": "Required reads",
+    "presetActions": "Preset Actions",
+    "presetWorkbenchRequired": "Use the dynamic workbench to manage presets. Static snapshots are read-only.",
+    "presetCheck": "Check preset",
+    "presetInstall": "Install preset",
+    "presetSeed": "Restore bundled presets",
+    "presetUninstall": "Uninstall preset",
+    "presetInstallSourcePlaceholder": "Local folder, .zip, or bundled preset id",
+    "forceOverwrite": "Force overwrite",
+    "confirmPresetId": "Confirm preset id",
+    "copyPresetId": "Copy preset ID",
+    "copyIdShort": "Copy ID",
+    "copyCommand": "Copy command",
+    "useSelectedId": "Use selected ID",
+    "presetConfirmRequired": "Use the selected ID before uninstalling.",
+    "presetActionRunning": "Running preset action",
+    "presetActionSuccess": "Preset action completed",
+    "presetActionFailed": "Preset action failed",
+    "created": "created",
+    "skipped": "skipped",
+    "removed": "removed",
+    "notInstalled": "not installed"
   },
   "zh": {
     "eyebrow": "Coding Agent Harness 控制台",
     "projectCockpit": "控制台",
     "overview": "总览",
     "taskIndex": "任务索引",
-    "reviewQueue": "审查队列",
+    "reviewQueue": "生命周期队列工作台",
     "moduleView": "模块",
     "readiness": "发布状态",
+    "snapshotStatus": "快照状态",
+    "snapshot": "快照",
     "tasks": "任务",
     "blockers": "阻塞",
     "advice": "建议",
@@ -238,6 +360,7 @@ window.HarnessI18n = {
     "missingBriefs": "个任务缺少给人看的 brief。",
     "reviewAdvice": "可以继续，但升级建议必须保持可见。",
     "noBlockers": "当前快照没有阻塞项。",
+    "snapshotNotValidated": "这里只是快照；发布决策前请运行完整验证状态。",
     "firstLook": "第一眼",
     "projectFlow": "项目流程图",
     "projectProgress": "项目进度",
@@ -292,12 +415,6 @@ window.HarnessI18n = {
     "moduleTasks": "模块任务",
     "noModuleTasks": "没有模块任务。",
     "migration": "迁移",
-    "migrationSnapshot": "迁移快照",
-    "taskPreset": "任务 preset",
-    "targetLevel": "目标等级",
-    "achievedLevel": "实际完成等级",
-    "strictDeferred": "Strict deferred",
-    "evidenceBundle": "证据包",
     "migrationSummary": "迁移关注项",
     "migrationWorkbench": "迁移工作台",
     "aggregateMigrationView": "聚合迁移视图",
@@ -346,6 +463,7 @@ window.HarnessI18n = {
     "state_pass": "通过",
     "state_warn": "警告",
     "state_fail": "失败",
+    "state_snapshot": "快照",
     "state_in_progress": "进行中",
     "state_planned": "计划中",
     "state_review": "审查中",
@@ -389,20 +507,39 @@ window.HarnessI18n = {
     "layout": "展示布局",
     "layoutList": "列表布局",
     "layoutGrid": "网格布局",
+    "sortByTime": "时间排序",
+    "sortNewest": "最新优先",
+    "sortOldest": "最早优先",
+    "activeBriefCount": "{count} 个 Brief · {order}",
+    "copyTaskName": "复制任务文件夹名",
+    "copyTaskNameShort": "复制",
+    "copyTaskNameSuccess": "已复制",
+    "copyTaskNameFailed": "失败",
     "legacyState": "任务状态",
     "lifecycleState": "生命周期",
     "reviewStatus": "审查状态",
-    "closeoutStatus": "收口状态",
-    "state_closing": "收口中",
+    "sedimentationStatus": "沉淀状态",
+    "closeoutStatus": "结项状态",
+    "lifecycleQueues": "生命周期队列",
+    "queueReasons": "队列原因",
+    "state_closing": "结项中",
     "state_closed": "已关闭",
     "state_ready": "就绪",
     "state_in_review": "审查中",
     "state_review-blocked": "审查阻塞",
+    "state_closed-review-pending": "已结项待人审",
     "state_missing": "缺失",
     "state_required": "待审查",
-    "state_reviewed-unconfirmed": "已审未确认",
+    "state_agent-reviewed": "Agent 自查",
     "state_confirmed": "已确认",
     "state_blocked-open-findings": "发现阻塞",
+    "state_not-in-queue": "不在队列",
+    "state_needs-material": "材料不齐",
+    "state_ready-to-confirm": "可确认",
+    "state_closed-debt": "结项待确认",
+    "state_missing-materials": "材料不齐",
+    "state_soft-deleted-superseded": "软删除 / 已替代",
+    "state_finalized": "已最终结项",
     "reviewActions": "审查操作",
     "reviewWorkspace": "审查工作台",
     "openReviewWorkspace": "打开审查工作台",
@@ -412,14 +549,52 @@ window.HarnessI18n = {
     "documentMissing": "当前快照中没有这个文档。",
     "staticReadOnly": "静态快照只读",
     "staticReadOnlyDetail": "需要提交审查或治理动作时，请使用动态 workbench。",
-    "reviewQueueSubtitle": "这里只显示当前处在执行审查阶段的任务；收口状态单独跟踪。",
+    "reviewQueueSubtitle": "按生命周期队列拆分审查、材料修复、阻塞、教训沉淀、已确认结项和已替代历史任务。",
+    "reviewQueueTabs": "生命周期队列",
+    "queueReview": "Review",
+    "queueReviewDesc": "只显示 taskQueues 包含 review 的任务，这些任务等待人工审查确认。",
+    "queueMissingMaterials": "Missing Materials",
+    "queueMissingMaterialsDesc": "缺少审查提交、Walkthrough、lesson 判定或其他必需材料的任务。",
+    "queueBlocked": "Blocked",
+    "queueBlockedDesc": "存在开放阻塞发现或状态冲突，当前不能确认审查的任务。",
+    "queueLessons": "Lessons",
+    "queueLessonsDesc": "还有 lesson candidate 或 promotion 治理动作需要处理的任务。",
+    "queueConfirmedFinalized": "Confirmed / Finalized",
+    "queueConfirmedFinalizedDesc": "已经人工确认或最终结项的任务，用于审计和结项追踪。",
+    "queueSoftDeletedSuperseded": "Soft-deleted / Superseded",
+    "queueSoftDeletedSupersededDesc": "带 tombstone、替代、合并、归档或废弃状态的历史任务。",
+    "reasonFilter": "原因筛选",
+    "allReasons": "全部原因",
+    "reason": "原因",
+    "sortBy": "排序",
+    "sortQueuePriority": "队列优先级",
+    "sortTaskId": "任务 ID",
+    "reviewSubmitted": "已提交审查",
+    "materialsReady": "材料就绪",
+    "yes": "是",
+    "no": "否",
+    "copyRepairPrompt": "复制修复提示",
+    "copyRepairPromptSuccess": "已复制提示",
+    "copyLessonPrompt": "复制沉淀提示",
+    "createLessonTask": "创建沉淀任务",
+    "openFollowUpTask": "打开后续任务",
+    "lessonSedimentationActions": "沉淀操作",
+    "lessonWorkbenchRequired": "创建任务需要使用动态 workbench；当前快照仍可复制沉淀提示。",
+    "moreLessonCandidates": "还有 {count} 个候选，请进详情查看",
+    "lessonTaskCreating": "正在创建任务...",
+    "lessonTaskCreated": "任务已创建",
+    "lessonTaskCreateFailed": "沉淀任务创建失败",
+    "noQueueTasks": "这个生命周期队列暂无任务。",
     "reviewReady": "待确认",
+    "reviewNeedsMaterial": "材料不齐",
+    "reviewClosedDebt": "收口待确认",
     "reviewBlockedQueue": "阻塞",
     "reviewConfirmedQueue": "已确认",
     "noReviewTasks": "当前没有处在审查阶段的任务。",
     "reviewAlreadyConfirmed": "人工审查已经确认。",
     "reviewBlocked": "先关闭 P0-P2 开放项或阻塞发布的发现，再确认审查。",
     "reviewWalkthroughRequired": "先在 Closeout SSoT 中补充并链接 Walkthrough，再确认人工审查。",
+    "reviewQueueRequired": "这个任务不在 canonical Review 队列中。",
     "reviewWorkbenchReady": "确认前请核对审查证据与开放发现。",
     "reviewConfirmChecklist": "我已核对 Walkthrough、任务审查证据和开放发现。",
     "confirmReviewComplete": "确认人工审查",
@@ -427,6 +602,71 @@ window.HarnessI18n = {
     "reviewConfirmTextMismatch": "请输入提示中的任务 ID。",
     "reviewSubmitting": "正在提交审查确认...",
     "reviewCompleteSuccess": "审查已确认，正在刷新快照...",
-    "reviewCompleteFailed": "审查确认失败"
+    "reviewCompleteFailed": "审查确认失败",
+    "presetCatalog": "Preset",
+    "presetCatalogSubtitle": "管理项目级、用户级和内置任务方法包。优先级是项目级、用户级、内置。",
+    "presetSearch": "搜索 preset",
+    "presetSearchPlaceholder": "搜索 ID、用途、类型、来源或路径",
+    "presetSourceFilter": "Preset 来源筛选",
+    "allPresets": "全部",
+    "presetSourceProject": "项目级",
+    "presetSourceUser": "用户级",
+    "presetSourceBuiltin": "内置",
+    "presetSource_project": "项目级",
+    "presetSource_user": "用户级",
+    "presetSource_builtin": "内置",
+    "presetEffective": "生效",
+    "presetShadowed": "被覆盖",
+    "presetSources": "Preset 来源",
+    "presetSourcesHint": "系统按优先级读取来源；同名时高优先级会覆盖低优先级。",
+    "presetPriorityTitle": "Preset 优先级",
+    "presetCollection": "Preset 列表",
+    "presetCollectionHint": "选择一个 preset，查看 manifest 详情和可用操作。",
+    "presetLayerStack": "同名层级",
+    "presetLayerStackHint": "项目级覆盖用户级，用户级覆盖内置。",
+    "presetContextActions": "当前 preset 操作",
+    "presetCheckHint": "校验当前选中的 preset manifest。",
+    "presetShadowedActionHint": "当前层级已被覆盖。CLI 检查和详情命令会按 ID 解析到生效 preset，因此这里禁用。",
+    "presetCheckSelected": "检查当前 preset",
+    "presetUninstallSelected": "卸载当前层级",
+    "presetUninstallHint": "范围会锁定到当前选中的项目级或用户级层。",
+    "presetBuiltinImmutable": "内置 preset 是包默认内容，不能卸载。",
+    "presetImportTitle": "导入 preset",
+    "presetImportHint": "把本地文件夹、.zip 压缩包或内置 preset ID 安装到项目级或用户级。",
+    "presetRestoreBundled": "恢复内置 preset",
+    "presetRestoreBundledHint": "把包内置 presets 写入选中的本地层级。CLI 名称是 preset seed。",
+    "presetCommandsEffectiveOnly": "CLI 详情/检查命令会按 ID 解析到生效 preset；当前被覆盖层只用于对比查看。",
+    "noPresets": "没有找到 preset。",
+    "version": "版本",
+    "manifestVersion": "Manifest 版本",
+    "manifestPath": "Manifest 路径",
+    "source": "来源",
+    "scope": "范围",
+    "taskKind": "任务类型",
+    "budgets": "预算",
+    "inputs": "输入项",
+    "writeScopes": "写入范围",
+    "requiredReads": "必读引用",
+    "presetActions": "Preset 操作",
+    "presetWorkbenchRequired": "管理 preset 需要使用动态 workbench；静态快照只读。",
+    "presetCheck": "检查 preset",
+    "presetInstall": "安装 preset",
+    "presetSeed": "恢复内置 preset",
+    "presetUninstall": "卸载 preset",
+    "presetInstallSourcePlaceholder": "本机文件夹、.zip 或内置 preset ID",
+    "forceOverwrite": "强制覆盖",
+    "confirmPresetId": "确认 preset ID",
+    "copyPresetId": "复制 preset ID",
+    "copyIdShort": "复制 ID",
+    "copyCommand": "复制命令",
+    "useSelectedId": "使用当前 ID",
+    "presetConfirmRequired": "卸载前请先使用当前 ID 完成确认。",
+    "presetActionRunning": "正在执行 preset 操作",
+    "presetActionSuccess": "Preset 操作完成",
+    "presetActionFailed": "Preset 操作失败",
+    "created": "已创建",
+    "skipped": "已跳过",
+    "removed": "已移除",
+    "notInstalled": "未安装"
   }
 };

package/templates/ledger/Harness-Ledger.md

@@ -2,38 +2,26 @@
 
 ## Purpose
 
-Track whether each meaningful task kept the harness contract intact: planning, scope control, SSoT updates, regression evidence, review, walkthrough, lessons, and reference routing.
+Generated canonical task lifecycle index. Humans should use the Dashboard for current status; agents should use `task-list`, `task-index`, or this generated ledger for low-cost lookup.
 
-## Status Legend
+This file is not a hand-written work log. Do not edit lifecycle rows manually. Update task-local facts (`task_plan.md`, `progress.md`, `review.md`, `lesson_candidates.md`, closeout / walkthrough evidence), then run `harness governance rebuild --archive --apply`.
 
-| Status | Meaning | Required Next Step |
-| --- | --- | --- |
-| proposed | Work is identified but not accepted into active execution. | Assign an owner or reject with a reason. |
-| planned | Scope, owner, and expected evidence are known. | Start execution or update schedule. |
-| active | Work is in progress. | Keep task plan and evidence current. |
-| review | Implementation is complete and waiting for review or verification. | Complete review and regression gates. |
-| blocked | Work cannot proceed without a decision or dependency. | Record blocker owner and unblock condition. |
-| closed | Work is complete and closeout evidence exists. | Archive only when no longer operationally useful. |
-| archived | Entry is historical and no longer part of active coordination. | Keep a pointer to the archive location. |
+Repo Governance / CI-CD changes remain routed through their reference standards and task evidence. Regression gates, delivery sequencing, cadence rules, closeout contracts, and module ownership remain in their dedicated governance files until explicitly replaced by equivalent scanner-supported facts.
 
 ## Active Ledger
 
-| ID | Task or Change | Owner | Status | Plan | Feature or Delivery SSoT | Regression Evidence | Review Evidence | Walkthrough | Lessons Check | Residual | Updated |
+| ID | Scope | Module | Task | State | Queues | Plan | Review | Lessons Check | Closeout | Residual | Updated |
 | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
-| HL-YYYY-MM-DD-001 | Short operational title | owner | planned | docs/09-PLANNING/TASKS/.../task_plan.md | F-000 or D-000 | RG-000 or n/a | review.md or n/a | pending | pending | none | YYYY-MM-DD |
+| HL-YYYY-MM-DD-001 | task | none | Short operational title | planned | none | docs/09-PLANNING/TASKS/.../task_plan.md | pending | pending | pending | none | YYYY-MM-DD |
 
-## Routing Rules
+## Field Rules
 
-1. Create or update one ledger row for every non-trivial feature, refactor, release, harness update, or multi-agent handoff.
-2. Link to durable files and commands. Do not rely on chat history as evidence.
-3. If a task changes product behavior, route it through Feature SSoT or Delivery SSoT.
-4. If a task changes regression expectations, route it through Regression SSoT and Cadence Ledger.
-5. If a task changes agent process, documentation standards, or repeatable checks, route it through Lessons SSoT.
-6. A row can move to `closed` only when the walkthrough, regression evidence, review disposition, and lessons check are recorded.
+- `Scope`: `task` for root planning tasks, `module` for module-local tasks.
+- `Module`: module key, or `none`.
+- `Queues`: scanner-derived lifecycle queues; query with `harness task-list --queue`.
+- `Review`, `Lessons Check`, `Closeout`, and `Residual`: scanner-derived summaries and routes. Detailed evidence stays in task-local files.
+- `Updated`: generation date, not a manual edit timestamp.
 
-## Archive Rules
+## Legacy Tables
 
-- Keep active, blocked, review, and recently closed rows in this file.
-- Move old closed rows to `docs/01-GOVERNANCE/archive/` or the project archive path when they no longer affect current coordination.
-- Preserve the ledger ID, final status, closeout link, and archive date in any archive entry.
-- Never delete a row to hide skipped verification, `accepted-risk`, or unresolved review feedback.
+`Feature-SSoT.md` and `Private-Feature-SSoT.md` are legacy task lifecycle projections. Current Harness versions archive them during `harness governance rebuild --archive --apply` and do not regenerate them.

package/templates/lessons/lesson-arch-process-change.md

@@ -39,7 +39,7 @@ Describe the recurring architecture, ownership, phase-gate, or operating-process
 ## Acceptance Criteria
 
 - The new rule has a durable home in a reference, template, checker, or project operating model.
-- The Lessons SSoT row links this detail doc and the applied change.
+- This promoted lesson detail doc links the applied change and the closeout record.
 - Existing active tasks know whether the new rule applies immediately or only to future work.
 
 ## Disposition

package/templates/lessons/lesson-new-doc.md

@@ -43,7 +43,7 @@ Describe the missing reference document, template, checklist, or operating guide
 
 - The new document exists at the target path and is linked from the relevant index or entrypoint.
 - The document contains operational rules, not background essay content.
-- The Lessons SSoT row links this detail doc and the new document.
+- This promoted lesson detail doc links the new document and the closeout record.
 
 ## Disposition
 

package/templates/lessons/lesson-ref-change.md

@@ -37,7 +37,7 @@ ref-change
 ## Acceptance Criteria
 
 - The target reference, template, or checker is updated.
-- The update is linked from Lessons SSoT.
+- The update is linked from this promoted lesson detail doc and the closeout record.
 - Any active task affected by the rule has a migration or no-impact note.
 
 ## Disposition

package/templates/planning/INDEX.md

@@ -0,0 +1,87 @@
+# {{TASK_TITLE}} - Task Package Index
+
+Task Contract: harness-task/v1
+
+## Task Identity
+
+| Field | Value |
+| --- | --- |
+| Task ID | `{{TASK_ID}}` |
+| Budget | `{{TASK_BUDGET}}` |
+| Preset | `{{TASK_PRESET}}` |
+| Module | `{{TASK_MODULE}}` |
+| Long-running | `{{TASK_LONG_RUNNING}}` |
+| Created | {{DATE}} |
+
+## Task Audit Metadata
+
+| Field | Value |
+| --- | --- |
+| Created By | {{TASK_AUDIT_CREATED_BY}} |
+| Created At | {{TASK_AUDIT_CREATED_AT}} |
+| Command Shape | {{TASK_AUDIT_COMMAND_SHAPE}} |
+| Budget | {{TASK_AUDIT_BUDGET}} |
+| Template Source | {{TASK_AUDIT_TEMPLATE_SOURCE}} |
+| Task Creator | {{TASK_AUDIT_TASK_CREATOR}} |
+| Task Creator Source | {{TASK_AUDIT_TASK_CREATOR_SOURCE}} |
+| Human Review Status | {{TASK_AUDIT_HUMAN_REVIEW_STATUS}} |
+| Confirmation ID | {{TASK_AUDIT_CONFIRMATION_ID}} |
+| Confirmed At | {{TASK_AUDIT_CONFIRMED_AT}} |
+| Reviewer | {{TASK_AUDIT_REVIEWER}} |
+| Reviewer Email | {{TASK_AUDIT_REVIEWER_EMAIL}} |
+| Confirm Text | {{TASK_AUDIT_CONFIRM_TEXT}} |
+| Evidence Checked | {{TASK_AUDIT_EVIDENCE_CHECKED}} |
+| Review Commit SHA | {{TASK_AUDIT_REVIEW_COMMIT_SHA}} |
+| Audit Source | {{TASK_AUDIT_AUDIT_SOURCE}} |
+| Audit Status | {{TASK_AUDIT_AUDIT_STATUS}} |
+| Exception Reason | {{TASK_AUDIT_EXCEPTION_REASON}} |
+| Message | {{TASK_AUDIT_MESSAGE}} |
+| Migration Status | {{TASK_AUDIT_MIGRATION_STATUS}} |
+| Migrated From | {{TASK_AUDIT_MIGRATED_FROM}} |
+| Legacy Extra Fields | {{TASK_AUDIT_LEGACY_EXTRA_FIELDS}} |
+| Migration Notes | {{TASK_AUDIT_MIGRATION_NOTES}} |
+
+## Core Contract Files
+
+| File | Purpose |
+| --- | --- |
+| `brief.md` | Human-readable task summary and context entry. |
+| `task_plan.md` | Current task goal, scope, selected budget, acceptance, and operating decisions. |
+| `visual_map.md` | Phase map, evidence status, next lifecycle commands, and supporting diagrams. |
+| `progress.md` | Execution log, verification evidence, decisions, and handoff notes. |
+
+## Standard Task Files
+
+These files exist for standard and complex tasks.
+
+| File | Purpose |
+| --- | --- |
+| `execution_strategy.md` | Execution mode, ownership, conflict control, and evidence strategy. |
+| `findings.md` | Findings, research notes, accepted risks, and unresolved questions. |
+| `lesson_candidates.md` | Task-local lesson candidate decisions before closeout. |
+| `review.md` | Agent review submission, adversarial review, findings, evidence, and routing. |
+
+## Optional Indexes
+
+| Index | Purpose |
+| --- | --- |
+| `references/INDEX.md` | References and preset-provided required reads. |
+| `artifacts/INDEX.md` | Generated outputs, evidence bundles, screenshots, reports, and command artifacts. |
+
+## Preset Summary
+
+This section is system-rendered. Presets may not add custom root-level files or arbitrary root `INDEX.md` content.
+
+| Field | Value |
+| --- | --- |
+| Preset | `{{TASK_PRESET}}` |
+| Preset Version | `{{TASK_PRESET_VERSION}}` |
+| Evidence Bundle | `{{TASK_EVIDENCE_BUNDLE}}` |
+| Resource Indexes | `references/INDEX.md`; `artifacts/INDEX.md` |
+
+## Update Rules
+
+- Update status and decisions in `progress.md`.
+- Keep task-specific goals and acceptance in `task_plan.md`.
+- Put large command output, screenshots, reports, and generated files in `artifacts/INDEX.md`.
+- Put source material, external links, and preset required reads in `references/INDEX.md`.

package/templates/planning/brief.md

@@ -24,7 +24,7 @@ State the user-visible or project-visible result this task must deliver.
 
 - Owner: coordinator
 - Lifecycle state: not_started
-- Required files: `task_plan.md`, `execution_strategy.md`, `visual_map.md`, `progress.md`, `findings.md`, `review.md`
+- Required files: `INDEX.md`, `task_plan.md`, `execution_strategy.md`, `visual_map.md`, `progress.md`, `findings.md`, `review.md`
 - Required closeout: verification evidence recorded in `progress.md`
 
 ## First Next Step

package/templates/planning/execution_strategy.md

@@ -4,6 +4,37 @@
 
 [Describe the execution approach, including why this operating model fits the risk and scope.]
 
+## Subagent Authorization
+
+Read this section at the start of the task and report the current authorization state before delegating.
+This is an audit record, not an execution sandbox.
+
+| Role | Status | Permission | Authorized By | Authorized At | Scope | Worktree / Branch | Reuse |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| reviewer subagent | allowed by default | read-only | harness task policy | task creation | current task review | n/a | allowed within this task |
+| worker subagent | not authorized | write only after user approval | pending | pending | pending | pending | allowed only within approved task/scope |
+
+## Subagent Delegation Decision
+
+At task start, the coordinator must make this decision from the user's goal, even if the user never mentions subagents.
+Do not expect the user to know what a subagent or worker is. If delegation would help, explain the benefit in plain language and ask for permission once.
+It is fine to say "subagent" or "worker" to the user; the important rule is that the agent must not wait for the user to ask for them.
+If the task is clearly split into independent slices, decide `ask-user` before implementation. If exact file paths are still unknown, first identify the paths, then immediately ask for the independent execution helper authorization.
+
+| Question | Decision | Reason | Next Action |
+| --- | --- | --- | --- |
+| Should a reviewer subagent be used? | yes / no | [why reviewer review helps or is unnecessary] | If yes, call a read-only reviewer without asking for extra permission. |
+| Would a worker subagent materially help? | no / ask-user / already-authorized | [parallel slice, independent implementation, focused investigation, or not useful] | If ask-user, ask directly: "This task is suitable for a worker subagent. Do you authorize me to assign one worker subagent to modify only [scope] in [worktree/branch] while I coordinate and review the result?" |
+
+## User Authorization Decision
+
+If the worker decision above is `ask-user`, implementation is blocked until this table records the user's answer.
+Allowed resolved states are `authorized`, `denied`, or `not-needed`. Do not leave this as `pending` after choosing `ask-user`.
+
+| Gate | State | Decided By | Decided At | Scope | Worktree / Branch | Notes |
+| --- | --- | --- | --- | --- | --- | --- |
+| worker subagent | pending | pending | pending | pending | pending | Fill only after directly asking the user. |
+
 ## Operating Model
 
 - Model: solo / team / split-repo / program / waterfall / kanban / module-parallel