@cleocode/core 2026.9.21 → 2026.9.23

package/dist/tasks/ranking-audit.js

@@ -0,0 +1,193 @@
+/**
+ * Ranking-input audit trail (T12693, owner decision D11161).
+ *
+ * Agents may write a task's ranking inputs — priority, severity, kind and
+ * depends — directly, but every such change records WHO (actor), in WHICH
+ * session, WHY (optional reason) and the values before and after, as one
+ * `ranking_changed` row in the task audit log, written in the same
+ * transaction as the change. `cleo history ranking <id>` lists them and
+ * `cleo history revert <entryId>` undoes one.
+ *
+ * @task T12693
+ */
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError } from '../errors.js';
+import { resolveAgentIdFromEnv, resolveSessionIdFromEnv } from '../sessions/session-id.js';
+import { getTaskAccessor } from '../store/data-accessor.js';
+/** The audit action a ranking change is recorded under. */
+export const RANKING_CHANGED_ACTION = 'ranking_changed';
+/** Fields the ranking sort reads (D11161). */
+export const RANKING_FIELDS = ['priority', 'severity', 'kind', 'depends'];
+/**
+ * A task's ranking inputs.
+ *
+ * @param task - The task.
+ * @returns The snapshot (depends sorted, so order changes are not changes).
+ * @task T12693
+ */
+export function rankingSnapshot(task) {
+    return {
+        priority: task.priority ?? null,
+        severity: task.severity ?? null,
+        kind: task.kind ?? null,
+        depends: [...(task.depends ?? [])].sort(),
+    };
+}
+/**
+ * The ranking fields that differ between two snapshots.
+ *
+ * @param before - Snapshot before the change.
+ * @param after - Snapshot after it.
+ * @returns Changed fields, in {@link RANKING_FIELDS} order.
+ * @task T12693
+ */
+export function rankingDiff(before, after) {
+    return RANKING_FIELDS.filter((field) => field === 'depends'
+        ? before.depends.join('\0') !== after.depends.join('\0')
+        : before[field] !== after[field]);
+}
+/**
+ * The actor and session a change is attributed to: the agent id
+ * (`CLEO_AGENT_ID`, else `human`) and the caller's session (env first, then
+ * the bound session).
+ *
+ * @param cwd - Project root.
+ * @returns The actor and session.
+ * @task T12693
+ */
+export async function resolveRankingActor(cwd) {
+    let sessionId = resolveSessionIdFromEnv();
+    if (!sessionId) {
+        try {
+            const { resolveBoundSessionId } = await import('../store/session-store.js');
+            sessionId = (await resolveBoundSessionId(cwd)) ?? null;
+        }
+        catch {
+            sessionId = null;
+        }
+    }
+    return { actor: resolveAgentIdFromEnv() ?? 'human', sessionId };
+}
+/**
+ * The audit-log entry for one ranking change, or null when nothing ranking
+ * related changed. Only the changed fields are stored before and after.
+ *
+ * @param input - Task, snapshots, attribution and why.
+ * @returns The `appendLog` entry, or null.
+ * @task T12693
+ */
+export function rankingAuditEntry(input) {
+    const fields = rankingDiff(input.before, input.after);
+    if (fields.length === 0)
+        return null;
+    const pick = (snap) => Object.fromEntries(fields.map((f) => [f, snap[f]]));
+    return {
+        id: `log-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`,
+        timestamp: new Date().toISOString(),
+        action: RANKING_CHANGED_ACTION,
+        taskId: input.taskId,
+        actor: input.actor.actor,
+        sessionId: input.actor.sessionId,
+        details: {
+            fields,
+            reason: input.reason?.trim() ? input.reason.trim() : null,
+            source: input.source,
+        },
+        before: pick(input.before),
+        after: pick(input.after),
+    };
+}
+function parseRow(row) {
+    const json = (text, fallback) => {
+        try {
+            return text ? JSON.parse(text) : fallback;
+        }
+        catch {
+            return fallback;
+        }
+    };
+    const details = json(row.detailsJson, {});
+    return {
+        id: row.id,
+        taskId: row.taskId,
+        timestamp: row.timestamp,
+        actor: row.actor,
+        sessionId: row.sessionId ?? null,
+        reason: details.reason ?? null,
+        source: details.source ?? null,
+        fields: details.fields ?? [],
+        before: json(row.beforeJson, {}),
+        after: json(row.afterJson, {}),
+    };
+}
+/**
+ * Who changed a task's ranking inputs, when, and why — newest first.
+ *
+ * @param taskId - Task.
+ * @param cwd - Project root.
+ * @param limit - Maximum rows (default 50).
+ * @returns The recorded changes.
+ * @task T12693
+ */
+export async function listRankingHistory(taskId, cwd, limit = 50) {
+    const accessor = await getTaskAccessor(cwd);
+    const rows = await accessor.queryAuditLog({
+        taskIds: [taskId],
+        actions: [RANKING_CHANGED_ACTION],
+        limit,
+    });
+    return rows.map(parseRow);
+}
+/**
+ * Undo one recorded ranking change: set each field it changed back to its
+ * value before, as a new audited change (source `revert`). Refused when a
+ * field has changed again since, so a later decision is never silently lost —
+ * unless `force`.
+ *
+ * @param entryId - The `ranking_changed` audit row id.
+ * @param opts - Why (recorded), and `force` to revert over later changes.
+ * @param cwd - Project root.
+ * @returns The task id, the reverted fields and the new audit row id.
+ * @throws {CleoError} When the entry is not a ranking change, or a field
+ *   changed since and `force` is not set.
+ * @task T12693
+ */
+export async function revertRankingChange(entryId, opts = {}, cwd) {
+    const accessor = await getTaskAccessor(cwd);
+    const [row] = await accessor.queryAuditLog({ ids: [entryId], actions: [RANKING_CHANGED_ACTION] });
+    if (!row) {
+        throw new CleoError(ExitCode.NOT_FOUND, `No ranking change ${entryId}`, {
+            fix: 'cleo history ranking <taskId>  # lists ranking changes with their ids',
+        });
+    }
+    const change = parseRow(row);
+    const task = await accessor.loadSingleTask(change.taskId);
+    if (!task) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Task ${change.taskId} no longer exists`);
+    }
+    const current = rankingSnapshot(task);
+    const moved = change.fields.filter((field) => {
+        const now = current[field];
+        const then = change.after[field];
+        return field === 'depends'
+            ? [...now].sort().join('\0') !==
+                [...(then ?? [])].sort().join('\0')
+            : now !== (then ?? null);
+    });
+    if (moved.length > 0 && !opts.force) {
+        throw new CleoError(ExitCode.VALIDATION_ERROR, `${change.taskId}'s ${moved.join(', ')} changed again after ${entryId}; reverting would discard that later change`, { fix: `cleo history ranking ${change.taskId}  # or re-run with --force` });
+    }
+    const { updateTask } = await import('./update.js');
+    const back = change.before;
+    await updateTask({
+        taskId: change.taskId,
+        ...(change.fields.includes('priority') && back.priority ? { priority: back.priority } : {}),
+        ...(change.fields.includes('severity') ? { severity: back.severity ?? null } : {}),
+        ...(change.fields.includes('kind') && back.kind ? { kind: back.kind } : {}),
+        ...(change.fields.includes('depends') ? { depends: back.depends ?? [] } : {}),
+        reason: `revert ${entryId}${opts.reason?.trim() ? `: ${opts.reason.trim()}` : ''}`,
+        rankingSource: 'revert',
+    }, cwd, accessor);
+    return { taskId: change.taskId, fields: change.fields, revertedTo: back };
+}
+//# sourceMappingURL=ranking-audit.js.map

package/dist/tasks/ranking-audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking-audit.js","sourceRoot":"","sources":["../../src/tasks/ranking-audit.ts"],"names":[],"mappings":"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"}

package/dist/tasks/task-analyze.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-analyze.d.ts","sourceRoot":"","sources":["../../src/tasks/task-analyze.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGpE,sDAAsD;AACtD,KAAK,UAAU,GAAG,IAAI,CAAC;AAEvB,gEAAgE;AAChE,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;CAChB;AAQD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAChC,OAAO,GAAE,GAAG,CAAC,MAAM,CAAa,GAC/B,MAAM,CAaR;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9B,OAAO,CAAC,kBAAkB,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAqFrD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GACzB,OAAO,CAAC;IACT,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CA8DD"}
+{"version":3,"file":"task-analyze.d.ts","sourceRoot":"","sources":["../../src/tasks/task-analyze.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAKpE,sDAAsD;AACtD,KAAK,UAAU,GAAG,IAAI,CAAC;AAEvB,gEAAgE;AAChE,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;CAChB;AAQD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAChC,OAAO,GAAE,GAAG,CAAC,MAAM,CAAa,GAC/B,MAAM,CAaR;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9B,OAAO,CAAC,kBAAkB,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAqErD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GACzB,OAAO,CAAC;IACT,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CA8DD"}

package/dist/tasks/task-analyze.js

@@ -4,6 +4,8 @@
  * @epic T9834
  */
 import { getTaskAccessor } from '../store/data-accessor.js';
+import { computeLeverage } from '../task-tools/score-task-priority.js';
+import { rankForAnalysis } from './analyze.js';
 async function loadAllTasks(projectRoot) {
     const accessor = await getTaskAccessor(projectRoot);
     const { tasks } = await accessor.queryTasks({});
@@ -54,44 +56,29 @@ export function measureDependencyDepth(taskId, taskMap, visited = new Set()) {
  * @task T4790
  */
 export async function coreTaskAnalyze(projectRoot, taskId, params) {
-    const allTasks = await loadAllTasks(projectRoot);
+    const accessor = await getTaskAccessor(projectRoot);
+    const { tasks: allTasks } = await accessor.queryTasks({});
     const effectiveTierLimit = params?.tierLimit ?? 10;
     const tasks = taskId
         ? allTasks.filter((t) => t.id === taskId || t.parentId === taskId)
         : allTasks;
-    const blocksMap = {};
-    for (const task of tasks) {
-        if (task.depends) {
-            for (const dep of task.depends) {
-                if (!blocksMap[dep])
-                    blocksMap[dep] = [];
-                blocksMap[dep].push(task.id);
-            }
-        }
-    }
-    const leverageMap = {};
-    for (const task of tasks) {
-        leverageMap[task.id] = (blocksMap[task.id] ?? []).length;
-    }
-    const actionable = tasks.filter((t) => t.status === 'pending' || t.status === 'active');
+    // Open tasks each task unblocks — the same leverage the shared scorer uses (T12661).
+    const openDependents = computeLeverage(tasks);
     const blocked = tasks.filter((t) => t.status === 'blocked');
     const bottlenecks = tasks
-        .filter((t) => (blocksMap[t.id]?.length ?? 0) > 0 && t.status !== 'done')
-        .map((t) => ({ id: t.id, title: t.title, blocksCount: blocksMap[t.id].length }))
-        .sort((a, b) => b.blocksCount - a.blocksCount)
+        .filter((t) => (openDependents.get(t.id) ?? 0) > 0 && t.status !== 'done')
+        .map((t) => ({ id: t.id, title: t.title, blocksCount: openDependents.get(t.id) ?? 0 }))
+        .sort((a, b) => b.blocksCount - a.blocksCount || a.id.localeCompare(b.id))
         .slice(0, 5);
-    const scored = actionable.map((t) => ({
-        id: t.id,
-        title: t.title,
-        leverage: leverageMap[t.id] ?? 0,
-        priority: t.priority,
-    }));
-    scored.sort((a, b) => {
-        const priorityWeight = { critical: 100, high: 50, medium: 20, low: 5 };
-        const aScore = (priorityWeight[a.priority ?? 'medium'] ?? 20) + a.leverage * 10;
-        const bScore = (priorityWeight[b.priority ?? 'medium'] ?? 20) + b.leverage * 10;
-        return bScore - aScore;
+    // T12661: the same ranking as `cleo next` and the briefing (ready candidates,
+    // current phase, BRAIN patterns, shared scorer), scoped to `taskId` when given.
+    const { ranked: scored } = await rankForAnalysis(accessor, allTasks, {
+        projectRoot,
+        ...(taskId ? { scopeTaskIds: new Set(tasks.map((t) => t.id)) } : {}),
     });
+    // The metric keeps its meaning (pending + active); the tiers above rank only
+    // the READY subset, exactly as `cleo next` does.
+    const actionable = tasks.filter((t) => t.status === 'pending' || t.status === 'active');
     const critical = scored.filter((t) => t.priority === 'critical');
     const high = scored.filter((t) => t.priority === 'high');
     const normal = scored.filter((t) => t.priority !== 'critical' && t.priority !== 'high');
@@ -100,10 +87,10 @@ export async function coreTaskAnalyze(projectRoot, taskId, params) {
             id: scored[0].id,
             title: scored[0].title,
             leverage: scored[0].leverage,
-            reason: 'Highest combined priority and leverage score',
+            reason: 'Top of the shared task ranking — the same order as `cleo next`',
         }
         : null;
-    const totalLeverage = Object.values(leverageMap).reduce((s, v) => s + v, 0);
+    const totalLeverage = [...openDependents.values()].reduce((s, v) => s + v, 0);
     const avgLeverage = tasks.length > 0 ? Math.round((totalLeverage / tasks.length) * 100) / 100 : 0;
     return {
         recommended,

package/dist/tasks/task-analyze.js.map

@@ -1 +1 @@
-{"version":3,"file":"task-analyze.js","sourceRoot":"","sources":["../../src/tasks/task-analyze.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"task-analyze.js","sourceRoot":"","sources":["../../src/tasks/task-analyze.ts"],"names":[],"mappings":"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"}

package/dist/tasks/task-next.d.ts

@@ -3,6 +3,9 @@
  * @task T10064
  * @epic T9834
  */
+import type { Task } from '@cleocode/contracts';
+import type { DataAccessor } from '../store/data-accessor.js';
+import { type RankedTask } from '../task-tools/score-task-priority.js';
 /**
  * Suggest next task to work on based on priority, phase, age, and deps.
  *
@@ -10,11 +13,18 @@
  * @param params - Optional scoring configuration
  * @param params.count - Number of suggestions to return (default: 1)
  * @param params.explain - When true, include scoring reasons in each suggestion
+ * @param params.brain - Brain pattern scoring (default true). A one-line
+ *   "next ready task" hint (stale `cleo current`, a completion's
+ *   `nextSuggested`) passes false: no brain store is opened (T12689).
  * @returns Ranked suggestions with scores and the total number of eligible candidates
  *
  * @remarks
- * Scoring considers priority weight, current phase alignment, dependency readiness,
- * task age, and brain success/failure pattern matches. Results are sorted descending by score.
+ * Ranks through the shared {@link scoreTask} (via {@link rankReadyTasks}):
+ * the lexicographic D11161 key — priority band, then attested severity (an
+ * unset severity is unknown; nothing is imputed from `kind`), then a bounded
+ * tiebreak (dependency readiness, phase alignment, leverage, age), then
+ * `createdAt`, then id. BRAIN patterns are informational factors only.
+ * `explain` returns every factor. The briefing's `nextTasks` uses the same ranking (T12661).
  * Candidates retain the active query population; a separate canonical lookup
  * resolves explicit dependencies, including archived records. Missing/cancelled
  * prerequisites block selection, and required dependency-read failures propagate.
@@ -32,6 +42,7 @@
 export declare function coreTaskNext(projectRoot: string, params?: {
     count?: number;
     explain?: boolean;
+    brain?: boolean;
 }): Promise<{
     suggestions: Array<{
         id: string;
@@ -43,4 +54,39 @@ export declare function coreTaskNext(projectRoot: string, params?: {
     }>;
     totalCandidates: number;
 }>;
+/**
+ * The phase that earns the phase-alignment bonus: the caller's session focus
+ * phase, else the project's current phase. `cleo next` and the briefing both
+ * resolve it here so they rank identically (T12661).
+ *
+ * @param accessor - Task data accessor.
+ * @returns The phase slug, or null.
+ * @task T12661
+ */
+export declare function resolveRankingPhase(accessor: DataAccessor): Promise<string | null>;
+/**
+ * Rank every READY task — pending, not cancelled, all dependencies satisfied
+ * under the canonical lookup (archived dependencies included) — through the
+ * shared {@link scoreTask}. The single ranking behind `cleo next` and the
+ * briefing's `nextTasks` (T12661).
+ *
+ * @param accessor - Task data accessor (for dependency records outside `allTasks`).
+ * @param allTasks - The active task population.
+ * @param opts - Current phase, optional id scope, `nowMs`, and `projectRoot`
+ *   to attach BRAIN success/failure patterns as informational factors
+ *   (best-effort; they are not part of the order).
+ * @returns Ranked candidates, how many there were, and the leverage map used.
+ * @task T12661
+ */
+export declare function rankReadyTasks(accessor: DataAccessor, allTasks: readonly Task[], opts: {
+    currentPhase: string | null;
+    scopeTaskIds?: ReadonlySet<string>;
+    projectRoot?: string;
+    /** Clock for the age tiebreak; one instant for the whole ranking. */
+    nowMs?: number;
+}): Promise<{
+    ranked: RankedTask<Task>[];
+    totalCandidates: number;
+    leverage: ReadonlyMap<string, number>;
+}>;
 //# sourceMappingURL=task-next.d.ts.map

package/dist/tasks/task-next.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-next.d.ts","sourceRoot":"","sources":["../../src/tasks/task-next.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgCH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7C,OAAO,CAAC;IACT,WAAW,EAAE,KAAK,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC,CAAC;IACH,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC,CAwGD"}
+{"version":3,"file":"task-next.d.ts","sourceRoot":"","sources":["../../src/tasks/task-next.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAiC,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAG/E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,EAGL,KAAK,UAAU,EAEhB,MAAM,sCAAsC,CAAC;AAI9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9D,OAAO,CAAC;IACT,WAAW,EAAE,KAAK,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC,CAAC;IACH,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC,CAsBD;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOxF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,SAAS,IAAI,EAAE,EACzB,IAAI,EAAE;IACJ,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACA,OAAO,CAAC;IACT,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC,CAAC,CAkCD"}

package/dist/tasks/task-next.js

@@ -3,32 +3,12 @@
  * @task T10064
  * @epic T9834
  */
+import { readFocusState } from '../sessions/focus-state-store.js';
+import { resolveSessionIdFromEnv } from '../sessions/session-id.js';
 import { getTaskAccessor } from '../store/data-accessor.js';
+import { computeLeverage, formatScoreFactor, rankTasks, } from '../task-tools/score-task-priority.js';
 import { loadReadinessDependencyLookup } from './dependency-check.js';
 import { depsReady } from './deps-ready.js';
-const PRIORITY_SCORE = {
-    critical: 100,
-    high: 75,
-    medium: 50,
-    low: 25,
-};
-/**
- * Severity-axis score bumps (T9905 unified urgency surface).
- *
- * Severity is orthogonal to priority — a task can have `priority='medium'` and
- * `severity='P0'` (e.g. a freshly-filed P0 incident before triage promotes its
- * priority). Without a severity boost the P0 work sits below an unrelated
- * `priority='high'` task in the `next` ranking, which inverts the operator's
- * expectations. The bump is conservative (P0 = +30, P1 = +15) so that
- * `priority='critical'` (+100) still wins all ties, but a P0/P1 row decisively
- * outranks any `priority='medium'` peer with no severity set.
- *
- * @task T9905
- */
-const SEVERITY_SCORE = {
-    P0: 30,
-    P1: 15,
-};
 /**
  * Suggest next task to work on based on priority, phase, age, and deps.
  *
@@ -36,11 +16,18 @@ const SEVERITY_SCORE = {
  * @param params - Optional scoring configuration
  * @param params.count - Number of suggestions to return (default: 1)
  * @param params.explain - When true, include scoring reasons in each suggestion
+ * @param params.brain - Brain pattern scoring (default true). A one-line
+ *   "next ready task" hint (stale `cleo current`, a completion's
+ *   `nextSuggested`) passes false: no brain store is opened (T12689).
  * @returns Ranked suggestions with scores and the total number of eligible candidates
  *
  * @remarks
- * Scoring considers priority weight, current phase alignment, dependency readiness,
- * task age, and brain success/failure pattern matches. Results are sorted descending by score.
+ * Ranks through the shared {@link scoreTask} (via {@link rankReadyTasks}):
+ * the lexicographic D11161 key — priority band, then attested severity (an
+ * unset severity is unknown; nothing is imputed from `kind`), then a bounded
+ * tiebreak (dependency readiness, phase alignment, leverage, age), then
+ * `createdAt`, then id. BRAIN patterns are informational factors only.
+ * `explain` returns every factor. The briefing's `nextTasks` uses the same ranking (T12661).
  * Candidates retain the active query population; a separate canonical lookup
  * resolves explicit dependencies, including archived records. Missing/cancelled
  * prerequisites block selection, and required dependency-read failures propagate.
@@ -58,89 +45,84 @@ const SEVERITY_SCORE = {
 export async function coreTaskNext(projectRoot, params) {
     const accessor = await getTaskAccessor(projectRoot);
     const { tasks: allTasks } = await accessor.queryTasks({});
-    const dependencyLookup = await loadReadinessDependencyLookup(allTasks, accessor);
-    const projectMeta = await accessor.getMetaValue('project_meta');
-    const currentPhase = projectMeta?.currentPhase ?? null;
-    const candidates = allTasks.filter((t) => t.status === 'pending' && !t.cancelledAt && depsReady(t.depends, dependencyLookup));
-    if (candidates.length === 0) {
-        return { suggestions: [], totalCandidates: 0 };
-    }
-    const scored = candidates
-        .map((task) => {
-        const reasons = [];
-        let score = 0;
-        score += PRIORITY_SCORE[task.priority] ?? 50;
-        reasons.push(`priority: ${task.priority} (+${PRIORITY_SCORE[task.priority] ?? 50})`);
-        // T9905: severity axis boost — orthogonal to priority.
-        const severityKey = task.severity ?? '';
-        const severityBump = SEVERITY_SCORE[severityKey];
-        if (severityBump !== undefined) {
-            score += severityBump;
-            reasons.push(`severity: ${severityKey} (+${severityBump})`);
-        }
-        if (currentPhase && task.phase === currentPhase) {
-            score += 20;
-            reasons.push(`phase alignment: ${currentPhase} (+20)`);
-        }
-        if (depsReady(task.depends, dependencyLookup)) {
-            score += 10;
-            reasons.push('all dependencies satisfied (+10)');
-        }
-        if (task.createdAt) {
-            const ageMs = Date.now() - new Date(task.createdAt).getTime();
-            const ageDays = ageMs / (1000 * 60 * 60 * 24);
-            if (ageDays > 7) {
-                const ageBonus = Math.min(15, Math.floor(ageDays / 7));
-                score += ageBonus;
-                reasons.push(`age: ${Math.floor(ageDays)} days (+${ageBonus})`);
-            }
-        }
-        return { task, score, reasons };
-    })
-        .sort((a, b) => b.score - a.score);
-    // Brain pattern scoring (best-effort)
-    try {
-        const { searchPatterns } = await import('../memory/patterns.js');
-        const [successPatterns, failurePatterns] = await Promise.all([
-            searchPatterns(projectRoot, { type: 'success', limit: 20 }),
-            searchPatterns(projectRoot, { type: 'failure', limit: 20 }),
-        ]);
-        if (successPatterns.length > 0 || failurePatterns.length > 0) {
-            for (const item of scored) {
-                const titleLower = item.task.title.toLowerCase();
-                const labels = (item.task.labels ?? []).map((l) => l.toLowerCase());
-                const matchText = [titleLower, ...labels].join(' ');
-                for (const sp of successPatterns) {
-                    if (matchText.includes(sp.pattern.toLowerCase())) {
-                        item.score += 10;
-                        item.reasons.push(`brain: success pattern match "${sp.pattern}" (+10)`);
-                        break;
-                    }
-                }
-                for (const fp of failurePatterns) {
-                    if (matchText.includes(fp.pattern.toLowerCase())) {
-                        item.score -= 5;
-                        item.reasons.push(`brain: failure pattern match "${fp.pattern}" (-5)`);
-                        break;
-                    }
-                }
-            }
-            scored.sort((a, b) => b.score - a.score);
-        }
-    }
-    catch {
-        // Brain pattern scoring is best-effort
-    }
-    const count = Math.min(params?.count || 1, scored.length);
+    const { ranked, totalCandidates } = await rankReadyTasks(accessor, allTasks, {
+        currentPhase: await resolveRankingPhase(accessor),
+        // T12689: a one-line hint (`brain: false`) opens no brain store.
+        ...(params?.brain !== false && { projectRoot }),
+    });
+    const count = Math.min(params?.count || 1, ranked.length);
     const explain = params?.explain ?? false;
-    const suggestions = scored.slice(0, count).map(({ task, score, reasons }) => ({
+    const suggestions = ranked.slice(0, count).map(({ task, score, factors }) => ({
         id: task.id,
         title: task.title,
         priority: task.priority,
         phase: task.phase ?? null,
         score,
-        ...(explain && { reasons }),
+        ...(explain && { reasons: factors.map(formatScoreFactor) }),
     }));
-    return { suggestions, totalCandidates: candidates.length };
+    return { suggestions, totalCandidates };
+}
+/**
+ * The phase that earns the phase-alignment bonus: the caller's session focus
+ * phase, else the project's current phase. `cleo next` and the briefing both
+ * resolve it here so they rank identically (T12661).
+ *
+ * @param accessor - Task data accessor.
+ * @returns The phase slug, or null.
+ * @task T12661
+ */
+export async function resolveRankingPhase(accessor) {
+    // Only the focus PHASE is read here, never the task pointer, so the stale-
+    // pointer check in readLiveFocus (and its task load) does not apply.
+    const focus = await readFocusState(accessor, resolveSessionIdFromEnv());
+    if (focus?.currentPhase)
+        return focus.currentPhase;
+    const projectMeta = await accessor.getMetaValue('project_meta');
+    return projectMeta?.currentPhase ?? null;
+}
+/**
+ * Rank every READY task — pending, not cancelled, all dependencies satisfied
+ * under the canonical lookup (archived dependencies included) — through the
+ * shared {@link scoreTask}. The single ranking behind `cleo next` and the
+ * briefing's `nextTasks` (T12661).
+ *
+ * @param accessor - Task data accessor (for dependency records outside `allTasks`).
+ * @param allTasks - The active task population.
+ * @param opts - Current phase, optional id scope, `nowMs`, and `projectRoot`
+ *   to attach BRAIN success/failure patterns as informational factors
+ *   (best-effort; they are not part of the order).
+ * @returns Ranked candidates, how many there were, and the leverage map used.
+ * @task T12661
+ */
+export async function rankReadyTasks(accessor, allTasks, opts) {
+    const dependencyLookup = await loadReadinessDependencyLookup(allTasks, accessor);
+    const candidates = allTasks.filter((t) => t.status === 'pending' &&
+        !t.cancelledAt &&
+        (!opts.scopeTaskIds || opts.scopeTaskIds.has(t.id)) &&
+        depsReady(t.depends, dependencyLookup));
+    const leverage = computeLeverage(allTasks);
+    if (candidates.length === 0)
+        return { ranked: [], totalCandidates: 0, leverage };
+    const ctx = {
+        currentPhase: opts.currentPhase,
+        nowMs: opts.nowMs ?? Date.now(),
+        taskStatuses: new Map([...dependencyLookup.values()].map((task) => [task.id, task.status])),
+        leverage,
+    };
+    if (opts.projectRoot) {
+        try {
+            const { searchPatterns } = await import('../memory/patterns.js');
+            const [success, failure] = await Promise.all([
+                searchPatterns(opts.projectRoot, { type: 'success', limit: 20 }),
+                searchPatterns(opts.projectRoot, { type: 'failure', limit: 20 }),
+            ]);
+            ctx.successPatterns = success;
+            ctx.failurePatterns = failure;
+        }
+        catch {
+            // Brain pattern scoring is best-effort
+        }
+    }
+    return { ranked: rankTasks(candidates, ctx), totalCandidates: candidates.length, leverage };
 }
 //# sourceMappingURL=task-next.js.map