@cleocode/core 2026.9.7 → 2026.9.9

package/dist/tasks/req.js

@@ -8,6 +8,7 @@
  * @epic T760
  * @task T782
  */
+import { isDeepStrictEqual } from 'node:util';
 import { acceptanceGateSchema, ExitCode } from '@cleocode/contracts';
 import { CleoError } from '../errors.js';
 import { getTaskAccessor } from '../store/data-accessor.js';
@@ -27,16 +28,14 @@ async function loadTask(accessor, taskId) {
     }
     return task;
 }
-async function persistAcceptanceProjection(accessor, taskId, acceptance, updatedAt) {
-    await accessor.transaction(async (tx) => {
-        await tx.updateTaskFields(taskId, {
-            acceptanceJson: JSON.stringify(acceptance),
-            updatedAt,
-        });
-        const existing = await tx.getAcRows(taskId);
-        const plan = planAcUpdate(taskId, existing, acceptance);
-        await applyAcPlan(tx, taskId, plan);
+async function persistAcceptanceProjection(tx, taskId, acceptance, updatedAt) {
+    await tx.updateTaskFields(taskId, {
+        acceptanceJson: JSON.stringify(acceptance),
+        updatedAt,
     });
+    const existing = await tx.getAcRows(taskId);
+    const plan = planAcUpdate(taskId, existing, acceptance);
+    await applyAcPlan(tx, taskId, plan);
 }
 /**
  * Classify a free-text acceptance string into a gate proposal using heuristics.
@@ -119,48 +118,70 @@ function heuristicClassify(text, reqId) {
 /**
  * Add a typed `AcceptanceGate` (with a REQ-ID) to a task's acceptance array.
  *
- * Validates the gate JSON against the Zod schema before writing. Rejects
- * duplicate REQ-IDs within the same task.
+ * @remarks
+ * Validates before opening storage. Reading existing acceptance, checking REQ-ID
+ * uniqueness and persisting the task/AC projection share one transaction, so
+ * competing appends cannot overwrite each other. This records a gate; it does
+ * not execute it or record passing verification evidence.
+ *
+ * @returns The committed acceptance array and its owning task identity.
+ * @example
+ * ```typescript
+ * const gate: AcceptanceGate = {
+ *   kind: 'test', command: 'node', args: ['verify.mjs'], expect: 'exit0',
+ *   req: 'PARTNER-121', description: 'Task-specific checks pass',
+ * };
+ * await reqAdd(projectRoot, 'T121', gate, undefined);
+ * ```
  *
  * @param projectRoot - Absolute path to project root
  * @param taskId - Target task ID
- * @param gate - Parsed `AcceptanceGate` object (already validated)
+ * @param gate - Typed gate; runtime schema validation also applies to SDK callers
  * @param accessor - Optional pre-created accessor (for testing)
  *
- * @throws {CleoError} E_NOT_FOUND when the task does not exist
- * @throws {CleoError} E_VALIDATION when the REQ-ID already exists on the task
+ * @throws CleoError E_NOT_FOUND when the task does not exist
+ * @throws CleoError E_VALIDATION when the REQ-ID already exists on the task
  *
  * @task T782
  */
 export async function reqAdd(projectRoot, taskId, gate, accessor) {
+    const validated = validateGate(gate);
     const acc = accessor ?? (await getTaskAccessor(projectRoot));
-    const task = await loadTask(acc, taskId);
-    const existing = (task.acceptance ?? []);
-    // Check REQ-ID uniqueness
-    if (gate.req) {
-        const dup = existing.find((item) => typeof item === 'object' && item.req === gate.req);
-        if (dup) {
-            throw new CleoError(ExitCode.VALIDATION_ERROR, `REQ-ID "${gate.req}" already exists on task ${taskId}`, {
-                fix: `Choose a unique REQ-ID or remove the existing gate with 'cleo req list ${taskId}'`,
-            });
+    return acc.transaction(async (tx) => {
+        const task = await loadTask(acc, taskId);
+        const existing = (task.acceptance ?? []);
+        // Check REQ-ID uniqueness
+        if (validated.req) {
+            const dup = existing.find((item) => typeof item === 'object' && item.req === validated.req);
+            if (dup) {
+                throw new CleoError(ExitCode.VALIDATION_ERROR, `REQ-ID "${validated.req}" already exists on task ${taskId}`, {
+                    fix: `Choose a unique REQ-ID or remove the existing gate with 'cleo req list ${taskId}'`,
+                });
+            }
         }
-    }
-    const updated = [...existing, gate];
-    await persistAcceptanceProjection(acc, taskId, updated, new Date().toISOString());
-    return { task: { id: taskId, acceptance: updated } };
+        const updated = [...existing, validated];
+        await persistAcceptanceProjection(tx, taskId, updated, new Date().toISOString());
+        return { task: { id: taskId, acceptance: updated } };
+    });
 }
 /**
  * List all REQ-ID–addressed acceptance gates on a task.
  *
- * Free-text strings (legacy) in the acceptance array are skipped because
- * they have no REQ-ID. Only structured `AcceptanceGate` items with a `req`
- * field are returned.
+ * @remarks
+ * Free-text strings are skipped because they have no REQ-ID. This summary does
+ * not execute gates or establish verification; full payloads remain on the task.
+ *
+ * @returns Requirement identity, index, kind and description for each named gate.
+ * @example
+ * ```typescript
+ * const { gates } = await reqList(projectRoot, 'T121', undefined);
+ * ```
  *
  * @param projectRoot - Absolute path to project root
  * @param taskId - Target task ID
  * @param accessor - Optional pre-created accessor (for testing)
  *
- * @throws {CleoError} E_NOT_FOUND when the task does not exist
+ * @throws CleoError E_NOT_FOUND when the task does not exist
  *
  * @task T782
  */
@@ -188,60 +209,76 @@ export async function reqList(projectRoot, taskId, accessor) {
  * Heuristic migrator: reads free-text acceptance strings and proposes typed
  * `AcceptanceGate` replacements.
  *
+ * @remarks
  * Without `apply: true` only proposals are returned. With `apply: true` the
  * matched strings are replaced in the task's acceptance array and the updated
  * array is persisted.
  *
  * Auto-generated REQ-IDs use the pattern `MIGRATED-001`, `MIGRATED-002`, etc.
- * Strings that already contain a structured gate (object items) are skipped.
+ * Existing structured gates and their requirement identities are preserved.
+ * Apply plans and persists under one transaction; preview does not write.
+ *
+ * @returns Proposed replacements and, when applied, the committed replacement count.
+ * @example
+ * ```typescript
+ * const preview = await reqMigrate(projectRoot, 'T121', false, undefined);
+ * ```
  *
  * @param projectRoot - Absolute path to project root
  * @param taskId - Target task ID
  * @param apply - When true, writes the proposals back to the task
  * @param accessor - Optional pre-created accessor (for testing)
  *
- * @throws {CleoError} E_NOT_FOUND when the task does not exist
+ * @throws CleoError E_NOT_FOUND when the task does not exist
  *
  * @task T782
  */
 export async function reqMigrate(projectRoot, taskId, apply, accessor) {
     const acc = accessor ?? (await getTaskAccessor(projectRoot));
-    const task = await loadTask(acc, taskId);
-    const acceptance = (task.acceptance ?? []);
-    const proposals = [];
-    let counter = 1;
-    // Collect free-text indices only
-    for (let i = 0; i < acceptance.length; i++) {
-        const item = acceptance[i];
-        if (typeof item !== 'string')
-            continue; // skip existing gates
-        const reqId = `MIGRATED-${String(counter).padStart(3, '0')}`;
-        counter++;
-        const proposed = heuristicClassify(item, reqId);
-        proposals.push({
-            index: i,
-            original: item,
-            proposed,
-            reqId: proposed ? reqId : null,
-            heuristic: proposed ? proposed.kind : null,
+    const migrate = async (tx) => {
+        const task = await loadTask(acc, taskId);
+        const acceptance = (task.acceptance ?? []);
+        const proposals = [];
+        let counter = 1;
+        const usedRequirements = new Set(acceptance.flatMap((item) => (typeof item === 'object' && item.req ? [item.req] : [])));
+        // Collect free-text indices only
+        for (let i = 0; i < acceptance.length; i++) {
+            const item = acceptance[i];
+            if (typeof item !== 'string')
+                continue; // skip existing gates
+            let reqId;
+            do {
+                reqId = `MIGRATED-${String(counter++).padStart(3, '0')}`;
+            } while (usedRequirements.has(reqId));
+            usedRequirements.add(reqId);
+            const classified = heuristicClassify(item, reqId);
+            const proposed = classified ? validateGate(classified) : null;
+            proposals.push({
+                index: i,
+                original: item,
+                proposed,
+                reqId: proposed ? reqId : null,
+                heuristic: proposed ? proposed.kind : null,
+            });
+        }
+        if (!tx) {
+            return { proposals };
+        }
+        // Apply: replace matched strings with their proposed gates
+        // Unmatched strings (where proposed is null) are left as-is
+        const updated = acceptance.map((item, i) => {
+            const proposal = proposals.find((p) => p.index === i);
+            if (proposal?.proposed)
+                return proposal.proposed;
+            return item;
         });
-    }
-    if (!apply) {
-        return { proposals };
-    }
-    // Apply: replace matched strings with their proposed gates
-    // Unmatched strings (where proposed is null) are left as-is
-    const updated = acceptance.map((item, i) => {
-        const proposal = proposals.find((p) => p.index === i);
-        if (proposal?.proposed)
-            return proposal.proposed;
-        return item;
-    });
-    await persistAcceptanceProjection(acc, taskId, updated, new Date().toISOString());
-    return {
-        proposals,
-        applied: proposals.filter((p) => p.proposed !== null).length,
+        await persistAcceptanceProjection(tx, taskId, updated, new Date().toISOString());
+        return {
+            proposals,
+            applied: proposals.filter((p) => p.proposed !== null).length,
+        };
     };
+    return apply ? acc.transaction(migrate) : migrate();
 }
 /**
  * Validate a raw JSON string against the `acceptanceGateSchema` Zod schema.
@@ -249,9 +286,19 @@ export async function reqMigrate(projectRoot, taskId, apply, accessor) {
  * Returns the parsed `AcceptanceGate` on success or throws a `CleoError`
  * with exit code `E_VALIDATION` on failure.
  *
+ * @remarks
+ * Uses the same schema boundary as direct SDK writes and rejects unsupported
+ * fields, including nested fields that the schema would otherwise strip.
+ *
+ * @returns The validated gate without executing its command.
+ * @example
+ * ```typescript
+ * const raw = '{"kind":"manual","description":"Review","prompt":"Approve?"}';
+ * const gate = parseGateJson(raw);
+ * ```
  * @param raw - Raw JSON string from `--gate` CLI flag
  *
- * @throws {CleoError} E_VALIDATION when JSON is malformed or schema invalid
+ * @throws CleoError E_VALIDATION when JSON is malformed or schema invalid
  *
  * @task T782
  */
@@ -265,13 +312,22 @@ export function parseGateJson(raw) {
             fix: 'Wrap the gate JSON in single quotes, e.g. --gate \'{"kind":"test","command":"pnpm test","expect":"pass","description":"Tests pass"}\'',
         });
     }
-    const result = acceptanceGateSchema.safeParse(parsed);
+    return validateGate(parsed);
+}
+/** Validate the canonical schema without silently dropping unsupported gate fields. */
+function validateGate(gate) {
+    const result = acceptanceGateSchema.safeParse(gate);
     if (!result.success) {
         const issues = result.error.issues.map((e) => `${e.path.join('.')}: ${e.message}`).join('; ');
         throw new CleoError(ExitCode.VALIDATION_ERROR, `Gate JSON failed schema validation: ${issues}`, {
             fix: 'Check AcceptanceGate schema: kind, description, and kind-specific required fields',
         });
     }
+    if (!isDeepStrictEqual(gate, result.data)) {
+        throw new CleoError(ExitCode.VALIDATION_ERROR, 'Gate includes unsupported fields', {
+            fix: 'Use only fields supported by the canonical AcceptanceGate schema; unsupported nested fields are also rejected.',
+        });
+    }
     return result.data;
 }
 //# sourceMappingURL=req.js.map

package/dist/tasks/req.js.map

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

package/dist/tasks/session-scope.d.ts

@@ -19,7 +19,7 @@
  * @adr ADR-058
  * @adr ADR-051
  */
-import type { TaskRecord } from '@cleocode/contracts';
+import type { TaskRecord, TasksAddParams } from '@cleocode/contracts';
 import { type EngineResult } from '../engine-result.js';
 /**
  * Where a resolved parent came from.
@@ -81,36 +81,7 @@ export declare function resolveParentFromSession(projectRoot: string, params: {
  * @task T1568
  * @epic T1566
  */
-export declare function addTaskWithSessionScope(projectRoot: string, params: {
-    title: string;
-    description?: string;
-    parent?: string;
-    depends?: string[];
-    priority?: string;
-    labels?: string[];
-    type?: string;
-    phase?: string;
-    size?: string;
-    acceptance?: string[];
-    notes?: string;
-    files?: string[];
-    dryRun?: boolean;
-    parentSearch?: string;
-    /**
-     * Set by the CLI when it already inferred the parent from the session's
-     * `current` pointer, so core does not re-derive provenance it cannot see.
-     * @task T12136
-     */
-    parentSource?: 'explicit' | 'session-inference';
-    kind?: string;
-    scope?: string;
-    severity?: string;
-    /**
-     * Bypass the BRAIN duplicate-detection rejection guard (T1633).
-     * Audited to `.cleo/audit/duplicate-bypass.jsonl`.
-     */
-    forceDuplicate?: boolean;
-}): Promise<EngineResult<{
+export declare function addTaskWithSessionScope(projectRoot: string, params: TasksAddParams): Promise<EngineResult<{
     task: TaskRecord;
     duplicate: boolean;
     dryRun?: boolean;
@@ -120,6 +91,10 @@ export declare function addTaskWithSessionScope(projectRoot: string, params: {
      * parent (PM-Core V2 design-point 5). @saga T10538
      */
     reopenedAncestors?: string[];
+    autoDecomposed?: {
+        childId: string;
+        movedAcceptance: string[];
+    };
     /**
      * Present when the parent was NOT a plain explicit argument — an inference
      * fired, was declined as stale, or the session lookup failed.

package/dist/tasks/session-scope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-scope.d.ts","sourceRoot":"","sources":["../../src/tasks/session-scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAGV,UAAU,EAKX,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,KAAK,YAAY,EAA8B,MAAM,qBAAqB,CAAC;AAQpF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,eAAe,GAAG,mBAAmB,CAAC;AAE9E,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC/B,kEAAkE;IAClE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,8CAA8C;IAC9C,YAAY,EAAE,YAAY,CAAC;IAC3B;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oFAAoF;IACpF,KAAK,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;CAC7B;AAeD;;;;;;;;;;;;GAYG;AACH,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE;IACN,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GACA,OAAO,CAAC,gBAAgB,CAAC,CAmF3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE;IACN,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,YAAY,CAAC,EAAE,UAAU,GAAG,mBAAmB,CAAC;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,GACA,OAAO,CACR,YAAY,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B;;;;;;;;;;OAUG;IACH,eAAe,CAAC,EAAE;QAAE,YAAY,EAAE,YAAY,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAChE,CAAC,CACH,CAqEA"}
+{"version":3,"file":"session-scope.d.ts","sourceRoot":"","sources":["../../src/tasks/session-scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,KAAK,YAAY,EAA8B,MAAM,qBAAqB,CAAC;AAQpF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,eAAe,GAAG,mBAAmB,CAAC;AAE9E,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC/B,kEAAkE;IAClE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,8CAA8C;IAC9C,YAAY,EAAE,YAAY,CAAC;IAC3B;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oFAAoF;IACpF,KAAK,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;CAC7B;AAeD;;;;;;;;;;;;GAYG;AACH,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE;IACN,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GACA,OAAO,CAAC,gBAAgB,CAAC,CAmF3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,GACrB,OAAO,CACR,YAAY,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,cAAc,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAChE;;;;;;;;;;OAUG;IACH,eAAe,CAAC,EAAE;QAAE,YAAY,EAAE,YAAY,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAChE,CAAC,CACH,CAwDA"}

package/dist/tasks/session-scope.js

@@ -23,7 +23,7 @@ import { engineError, engineSuccess } from '../engine-result.js';
 import { cleoErrorToEngineResult } from '../errors-to-engine.js';
 import { getTaskAccessor } from '../store/data-accessor.js';
 import { getActiveSession } from '../store/session-store.js';
-import { addTask } from './add.js';
+import { addTask, toTaskAddOptions } from './add.js';
 import { taskToRecord } from './engine-converters.js';
 import { findTasks } from './find.js';
 /**
@@ -146,28 +146,13 @@ export async function addTaskWithSessionScope(projectRoot, params) {
         }
         const accessor = await getTaskAccessor(projectRoot);
         const result = await addTask({
-            title: params.title,
-            description: params.description,
+            ...toTaskAddOptions(params),
             parentId: resolvedParent,
             // T12136: so `E_CLEO_DEPTH_EXCEEDED` can say the parent was inherited
             // rather than named. The CLI may already have decided this upstream.
             parentSource: params.parentSource === 'session-inference' || parentSource === 'session-inference'
                 ? 'session-inference'
                 : 'explicit',
-            depends: params.depends,
-            priority: params.priority || 'medium',
-            labels: params.labels,
-            type: params.type || undefined,
-            phase: params.phase,
-            size: params.size,
-            acceptance: params.acceptance,
-            notes: params.notes,
-            files: params.files,
-            dryRun: params.dryRun,
-            kind: params.kind,
-            scope: params.scope,
-            severity: params.severity,
-            forceDuplicate: params.forceDuplicate,
         }, projectRoot, accessor);
         return engineSuccess({
             task: taskToRecord(result.task),
@@ -177,6 +162,7 @@ export async function addTaskWithSessionScope(projectRoot, params) {
             ...(inferenceNote ? { parentInference: { parentSource, note: inferenceNote } } : {}),
             ...(result.warnings?.length && { warnings: result.warnings }),
             // T10538 / design-point 5 — surface the ancestor reopen to the caller.
+            ...(result.autoDecomposed && { autoDecomposed: result.autoDecomposed }),
             ...(result.reopenedAncestors?.length && {
                 reopenedAncestors: result.reopenedAncestors,
             }),

package/dist/tasks/session-scope.js.map

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

package/dist/tasks/severity-attestation.d.ts

@@ -11,6 +11,8 @@
  *
  * Signed attestation lines are appended to
  * `.cleo/audit/severity-attestation.jsonl` (one JSON object per line).  The
+ * Task mutations persist signed assertions atomically in the task audit instead.
+ * Standalone JSONL assertions do not prove a task mutation committed. The
  * previous path `.cleo/audit/bug-severity.jsonl` was bug-command-specific;
  * callers that still write to the old path will see a one-time deprecation
  * notice emitted to stderr — migration to the new path is separate cleanup.
@@ -19,13 +21,13 @@
  *
  * If `.cleo/config.json` declares an `ownerPubkeys` array, only identities
  * whose Ed25519 public key (hex) appears in that list may assert a severity.
- * Signers outside the allowlist receive an error with `code: 'E_OWNER_ONLY'`.
+ * Signers outside the allowlist receive a permission error naming `E_OWNER_ONLY`.
  * When the allowlist is absent or empty, any identity may sign (opt-in policy).
  *
  * @task T9071
  * @adr ADR-054 (draft)
  */
-import type { SeverityAttestation } from '@cleocode/contracts';
+import { type SeverityAttestation, type SignedSeverityAttestation } from '@cleocode/contracts';
 export type { SeverityAttestation };
 /**
  * Audit log path for severity attestations.
@@ -45,11 +47,16 @@ export declare const SEVERITY_ATTESTATION_AUDIT_FILE = "severity-attestation.jso
  */
 export declare const LEGACY_BUG_SEVERITY_AUDIT_FILE = "bug-severity.jsonl";
 /**
- * Load the owner-pubkey allowlist from `.cleo/config.json`. Returns an empty
- * array when the file is missing, malformed, or does not declare the field.
+ * Read the project's opt-in severity signer allowlist.
  *
- * @param cwd - Optional working directory override (defaults to `process.cwd()`).
- * @internal
+ * @param cwd - Explicit project root, otherwise the current project.
+ * @returns Authorized keys; absent config or an absent/empty field returns an empty list.
+ * @throws CleoError when configured authority cannot be read or validated.
+ * @remarks An unreadable or malformed authority is not permission for every signer.
+ * @example
+ * ```ts
+ * const owners = await loadOwnerPubkeys(projectRoot);
+ * ```
  */
 export declare function loadOwnerPubkeys(cwd?: string): Promise<string[]>;
 /**
@@ -78,17 +85,15 @@ export interface AppendSeverityAttestationOptions {
  * Append a signed severity attestation to
  * `.cleo/audit/severity-attestation.jsonl`.
  *
- * Throws a shaped error with `code: 'E_OWNER_ONLY'` when the signer's pubkey
+ * Throws a permission error naming `E_OWNER_ONLY` when the signer's pubkey
  * is not in the configured `ownerPubkeys` allowlist (allowlist enforcement is
  * only active when the list is non-empty).
  *
- * @param taskId  - Task ID, if already assigned at attestation time.
  * @param record  - Attestation fields (excluding `signerPub` which is derived
  *                  from the local CLEO identity).
  * @param options - Optional overrides (e.g. `cwd`).
  *
- * @throws `Error` with `code: 'E_OWNER_ONLY'` when the allowlist rejects the
- *   signer.
+ * @throws CleoError with permission exit code when the allowlist rejects the signer.
  *
  * @example
  * ```ts
@@ -103,4 +108,28 @@ export interface AppendSeverityAttestationOptions {
  * ```
  */
 export declare function appendSignedSeverityAttestation(record: Omit<SeverityAttestation, 'signerPub'>, options?: AppendSeverityAttestationOptions): Promise<void>;
+/**
+ * Authorize and sign a severity assertion without appending a filesystem log.
+ *
+ * Task mutations persist this result in their task transaction, binding the
+ * signature to the assigned task ID. The established owner allowlist is opt-in:
+ * absent or empty lists permit the local identity; nonempty lists restrict it.
+ *
+ * @param record - Assertion to bind to the project identity.
+ * @param options - Explicit project used for both identity and owner policy.
+ * @returns Signed assertion ready for atomic audit persistence.
+ * @remarks Preparation creates no committed task evidence; persist in the task transaction.
+ * Restricted authority never provisions an unknown signer. With opt-in unrestricted
+ * authority, first-use key provisioning is independent persistent project setup;
+ * a later task rollback does not delete or roll back that signing identity.
+ * @example
+ * ```ts
+ * const assertion = await prepareSignedSeverityAttestation({
+ *   timestamp: new Date().toISOString(), taskId: 'T001',
+ *   title: 'Restore service', severity: 'P1',
+ * }, { cwd: projectRoot });
+ * ```
+ * @throws CleoError with permission exit code when the signer is not allowed.
+ */
+export declare function prepareSignedSeverityAttestation(record: Omit<SeverityAttestation, 'signerPub'>, options?: AppendSeverityAttestationOptions): Promise<SignedSeverityAttestation>;
 //# sourceMappingURL=severity-attestation.d.ts.map

package/dist/tasks/severity-attestation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"severity-attestation.d.ts","sourceRoot":"","sources":["../../src/tasks/severity-attestation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAMH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAI/D,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC;;;;;;;;GAQG;AACH,eAAO,MAAM,+BAA+B,+BAA+B,CAAC;AAE5E;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,uBAAuB,CAAC;AAMnE;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBtE;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAO5E;AAMD;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,+BAA+B,CACnD,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,WAAW,CAAC,EAC9C,OAAO,CAAC,EAAE,gCAAgC,GACzC,OAAO,CAAC,IAAI,CAAC,CAqBf"}
+{"version":3,"file":"severity-attestation.d.ts","sourceRoot":"","sources":["../../src/tasks/severity-attestation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAKH,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC/B,MAAM,qBAAqB,CAAC;AAM7B,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC;;;;;;;;GAQG;AACH,eAAO,MAAM,+BAA+B,+BAA+B,CAAC;AAE5E;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,uBAAuB,CAAC;AAUnE;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsBtE;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAO5E;AAMD;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,+BAA+B,CACnD,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,WAAW,CAAC,EAC9C,OAAO,CAAC,EAAE,gCAAgC,GACzC,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,gCAAgC,CACpD,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,WAAW,CAAC,EAC9C,OAAO,CAAC,EAAE,gCAAgC,GACzC,OAAO,CAAC,yBAAyB,CAAC,CAapC"}