@cleocode/core 2026.3.57 → 2026.3.59

package/src/tasks/update.ts

@@ -9,6 +9,7 @@ import type { Task, TaskPriority, TaskSize, TaskStatus, TaskType } from '@cleoco
 import { ExitCode } from '@cleocode/contracts';
 import { loadConfig } from '../config.js';
 import { CleoError } from '../errors.js';
+import { requireActiveSession } from '../sessions/session-enforcement.js';
 import type { DataAccessor } from '../store/data-accessor.js';
 import { getAccessor } from '../store/data-accessor.js';
 import {
@@ -20,7 +21,14 @@ import {
   validateTitle,
 } from './add.js';
 import { completeTask } from './complete.js';
+import { createAcceptanceEnforcement } from './enforcement.js';
+import {
+  findEpicAncestor,
+  validateChildStageCeiling,
+  validateEpicStageAdvancement,
+} from './epic-enforcement.js';
 import { resolveHierarchyPolicy } from './hierarchy-policy.js';
+import { validatePipelineTransition } from './pipeline-stage.js';
 
 const NON_STATUS_DONE_FIELDS: Array<keyof Omit<UpdateTaskOptions, 'taskId' | 'status'>> = [
   'title',
@@ -41,6 +49,7 @@ const NON_STATUS_DONE_FIELDS: Array<keyof Omit<UpdateTaskOptions, 'taskId' | 'st
   'blockedBy',
   'parentId',
   'noAutoComplete',
+  'pipelineStage',
 ];
 
 function hasNonStatusDoneFields(options: UpdateTaskOptions): boolean {
@@ -69,6 +78,8 @@ export interface UpdateTaskOptions {
   blockedBy?: string;
   parentId?: string | null;
   noAutoComplete?: boolean;
+  /** RCASD-IVTR+C pipeline stage transition target. Must be >= current stage. @task T060 */
+  pipelineStage?: string;
 }
 
 /** Result of updating a task. */
@@ -93,6 +104,9 @@ export async function updateTask(
       fix: `Use 'cleo find "${options.taskId}"' to search`,
     });
   }
+
+  await requireActiveSession('tasks.update', cwd);
+
   const changes: string[] = [];
   const now = new Date().toISOString();
 
@@ -114,6 +128,17 @@ export async function updateTask(
     );
   }
 
+  // Enforce Acceptance Criteria on Update
+  const enforcement = await createAcceptanceEnforcement(cwd);
+  const updateValidation = enforcement.validateUpdate(task, { acceptance: options.acceptance });
+  if (!updateValidation.valid) {
+    throw new CleoError(
+      updateValidation.exitCode ?? ExitCode.VALIDATION_ERROR,
+      updateValidation.error!,
+      { fix: updateValidation.fix },
+    );
+  }
+
   // Update fields
   if (options.title !== undefined) {
     validateTitle(options.title);
@@ -230,6 +255,43 @@ export async function updateTask(
     changes.push('noAutoComplete');
   }
 
+  // Pipeline stage transition — forward-only (T060)
+  if (options.pipelineStage !== undefined) {
+    validatePipelineTransition(task.pipelineStage, options.pipelineStage);
+
+    // Epic stage advancement gate (T062): block advancement if children are in-flight
+    // at the current stage.
+    if (task.type === 'epic' && task.pipelineStage) {
+      await validateEpicStageAdvancement(
+        {
+          epicId: task.id,
+          currentStage: task.pipelineStage,
+          newStage: options.pipelineStage,
+        },
+        acc,
+        cwd,
+      );
+    }
+
+    // Child stage ceiling (T062): non-epic tasks cannot advance past their epic ancestor.
+    if (task.type !== 'epic') {
+      const epicAncestor = task.parentId ? await findEpicAncestor(task.parentId, acc) : null;
+      // Also check if the direct parent is an epic
+      const directParent = task.parentId ? await acc.loadSingleTask(task.parentId) : null;
+      const epicToCheck = directParent?.type === 'epic' ? directParent : epicAncestor;
+      if (epicToCheck) {
+        await validateChildStageCeiling(
+          { childStage: options.pipelineStage, epicId: epicToCheck.id },
+          acc,
+          cwd,
+        );
+      }
+    }
+
+    task.pipelineStage = options.pipelineStage;
+    changes.push('pipelineStage');
+  }
+
   // Handle parentId change (reparent) using targeted queries
   // Supports: parentId="T001" to set parent, parentId=null or parentId="" to promote to root
   if (options.parentId !== undefined) {

package/templates/config.template.json

@@ -16,48 +16,46 @@
     "autoArchiveOnComplete": false
   },
 
-  "logging": {
+  "enforcement": {
+    "acceptance": {
+      "mode": "block",
+      "requiredForPriorities": ["critical", "high", "medium", "low"],
+      "minimumCriteria": 3
+    },
+    "session": {
+      "requiredForMutate": true
+    },
+    "pipeline": {
+      "bindTasksToStage": true
+    }
+  },
+
+  "verification": {
     "enabled": true,
-    "retentionDays": 30,
-    "level": "standard",
-    "logSessionEvents": true
+    "requiredForTypes": ["epic", "task", "subtask"],
+    "autoInitialize": true,
+    "maxRounds": 5,
+    "requiredGates": ["implemented", "testsPassed", "qaPassed"],
+    "autoSetImplementedOnComplete": true,
+    "requireForParentAutoComplete": true,
+    "allowManualOverride": true
   },
 
-  "validation": {
-    "strictMode": false,
-    "checksumEnabled": true,
-    "enforceAcceptance": true,
-    "requireDescription": false,
-    "maxActiveTasks": 1,
-    "validateDependencies": true,
-    "detectCircularDeps": true
+  "lifecycle": {
+    "mode": "strict"
   },
 
-  "defaults": {
-    "priority": "medium",
-    "phase": "core",
-    "labels": []
+  "hierarchy": {
+    "maxDepth": 3,
+    "maxSiblings": 0
   },
 
-  "session": {
-    "requireSession": true,
-    "requireSessionNote": true,
-    "requireNotesOnComplete": true,
-    "warnOnNoFocus": true,
-    "allowNestedSessions": true,
-    "allowParallelAgents": true,
-    "autoStartSession": true,
-    "autoDiscoveryOnStart": true,
-    "sessionTimeoutHours": 72
+  "defaults": {
+    "priority": "medium"
   },
 
-  "multiSession": {
-    "enabled": true,
-    "maxConcurrentSessions": 5,
-    "maxActiveTasksPerScope": 1,
-    "scopeValidation": "strict",
-    "allowNestedScopes": true,
-    "allowScopeOverlap": false
+  "session": {
+    "enforcement": "strict"
   },
 
   "release": {
@@ -70,43 +68,12 @@
     }
   },
 
-  "display": {
-    "showArchiveCount": true,
-    "showLogSummary": true,
-    "warnStaleDays": 30
-  },
-
   "output": {
     "defaultFormat": "text",
     "showColor": true,
     "showUnicode": true,
     "showProgressBars": true,
-    "csvDelimiter": ",",
-    "dateFormat": "iso8601",
-    "showCompactTitles": false,
-    "maxTitleLength": 80
-  },
-
-  "cli": {
-    "aliases": {
-      "ls": "list",
-      "done": "complete",
-      "new": "add",
-      "edit": "update",
-      "rm": "archive",
-      "check": "validate"
-    },
-    "plugins": {
-      "enabled": true,
-      "directories": ["~/.cleo/plugins", "./.cleo/plugins"],
-      "autoDiscover": true
-    },
-    "debug": {
-      "enabled": true,
-      "validateMappings": true,
-      "checksumVerify": true,
-      "showTimings": false
-    }
+    "dateFormat": "iso8601"
   },
 
   "backup": {
@@ -119,17 +86,8 @@
     "safetyRetentionDays": 7
   },
 
-  "cancellation": {
-    "cascadeConfirmThreshold": 10,
-    "requireReason": true,
-    "daysUntilArchive": 3,
-    "allowCascade": true,
-    "defaultChildStrategy": "block"
-  },
-
   "contextAlerts": {
     "enabled": true,
-    "minThreshold": "warning",
     "triggerCommands": ["complete", "start", "stop", "add", "session"],
     "suppressDuration": 0
   },
@@ -138,50 +96,15 @@
     "contextThresholds": {
       "warning": 70,
       "critical": 80
-    },
-    "autoStopOnCritical": true,
-    "hitlSummaryOnPause": true
+    }
   },
 
   "agentOutputs": {
     "directory": ".cleo/agent-outputs",
-    "manifestFile": "MANIFEST.jsonl",
-    "archiveDir": "archive",
-    "archiveDays": 30
+    "manifestFile": "MANIFEST.jsonl"
   },
 
   "retention": {
-    "maxArchivedSessions": 100,
-    "autoArchiveEndedAfterDays": 30,
-    "autoDeleteArchivedAfterDays": 90,
-    "contextStateRetentionDays": 7,
-    "cleanupOnSessionEnd": true,
-    "dryRunByDefault": true,
-    "maxSessionsInMemory": 100,
     "autoEndActiveAfterDays": 7
-  },
-
-  "project": {
-    "status": {
-      "health": "unknown",
-      "lastCheck": null,
-      "schemaVersions": {
-        "todo": "{{SCHEMA_VERSION_TODO}}",
-        "config": "{{SCHEMA_VERSION_CONFIG}}",
-        "archive": "{{SCHEMA_VERSION_ARCHIVE}}",
-        "log": "{{SCHEMA_VERSION_LOG}}"
-      },
-      "validation": {
-        "lastValidated": null,
-        "passed": false,
-        "errors": [],
-        "warnings": []
-      },
-      "injection": {
-        "CLAUDE.md": "not_found",
-        "AGENTS.md": "not_found",
-        "GEMINI.md": "not_found"
-      }
-    }
   }
 }

package/templates/global-config.template.json

@@ -6,51 +6,35 @@
     "showColor": true,
     "showUnicode": true,
     "showProgressBars": true,
-    "dateFormat": "iso8601",
-    "showCompactTitles": false,
-    "maxTitleLength": 80
+    "dateFormat": "iso8601"
   },
-  "display": {
-    "showArchiveCount": true,
-    "showLogSummary": true,
-    "warnStaleDays": 30
-  },
-  "cli": {
-    "aliases": {
-      "ls": "list",
-      "done": "complete",
-      "new": "add",
-      "edit": "update",
-      "rm": "archive",
-      "check": "validate",
-      "tags": "labels",
-      "overview": "dash"
+  "enforcement": {
+    "acceptance": {
+      "mode": "block",
+      "requiredForPriorities": ["critical", "high", "medium", "low"],
+      "minimumCriteria": 3
     },
-    "plugins": {
-      "enabled": true,
-      "directories": [
-        "~/.cleo/plugins",
-        "./.cleo/plugins"
-      ],
-      "autoDiscover": true
+    "session": {
+      "requiredForMutate": true
     },
-    "debug": {
-      "enabled": false,
-      "validateMappings": true,
-      "checksumVerify": true,
-      "showTimings": false
+    "pipeline": {
+      "bindTasksToStage": true
     }
   },
-  "defaults": {
-    "priority": "medium",
-    "labels": []
-  },
-  "multiSession": {
+  "verification": {
     "enabled": true,
-    "maxConcurrentSessions": 5,
-    "maxActiveTasksPerScope": 1,
-    "scopeValidation": "strict",
-    "allowNestedScopes": true,
-    "allowScopeOverlap": false
+    "requiredForTypes": ["epic", "task", "subtask"],
+    "autoInitialize": true,
+    "maxRounds": 5,
+    "requiredGates": ["implemented", "testsPassed", "qaPassed"],
+    "autoSetImplementedOnComplete": true,
+    "requireForParentAutoComplete": true,
+    "allowManualOverride": true
+  },
+  "lifecycle": {
+    "mode": "strict"
+  },
+  "defaults": {
+    "priority": "medium"
   }
 }