@cleocode/contracts 2026.10.21 → 2026.10.22-rc.ci.693

package/src/task.ts

@@ -333,6 +333,14 @@ export type EvidenceAtom =
        * edits the tree hash left out (T13554).
        */
       runtimeExcluded?: string[];
+      /**
+       * Untracked files outside every directory the change touches, which the
+       * binding did not judge as this change (T14000): another agent's work
+       * in a shared checkout. The tree hash includes them, so `cleo complete`
+       * and the superseded check refuse this atom as stale once any of them
+       * is tracked (committed into the change): the run never covered it.
+       */
+      untrackedSetAside?: string[];
     }
   | {
       /**
@@ -367,6 +375,8 @@ export type EvidenceAtom =
       configPaths?: string[];
       /** The change it checked is non-code only, so no typecheck is owed (T13745). */
       nonCodeChange?: boolean;
+      /** Untracked files set aside at bind time, as for `test-run` (T14000). */
+      untrackedSetAside?: string[];
     }
   | {
       kind: 'tool';
@@ -543,6 +553,13 @@ export type EvidenceAtom =
       prNumber: number;
       /** Merge commit SHA (full 40-char hex) — captured at validate time. */
       mergeCommitSha: string;
+      /**
+       * The PR's final head commit, when GitHub reported it (T14004). A run
+       * bound on this head (or a descendant) tested the PR's work, even when
+       * a squash merge left the merge commit unrelated to it. Absent on atoms
+       * recorded before T14004 and on component PRs.
+       */
+      headSha?: string;
       /** ISO 8601 timestamp when the PR was merged. */
       mergedAt: string;
       /** Number of `SUCCESS` checks across all required workflows. */
@@ -557,6 +574,8 @@ export type EvidenceAtom =
       changedPaths?: string[];
       /** Explicit task relationship established when this atom was accepted. */
       taskId?: string;
+      /** `owner/repo` the atom named (`pr:<owner>/<repo>#<n>`, T13912), lowercased. */
+      repo?: string;
       /**
        * Component PR this (integration) PR landed on the default branch
        * (T12671): the task is linked through it and its files are the change.
@@ -581,6 +600,8 @@ export type EvidenceAtom =
       kind: 'ci';
       /** PR number (positive integer). */
       prNumber: number;
+      /** `owner/repo` the atom named (`ci:<owner>/<repo>#<n>`, T13912), lowercased. */
+      repo?: string;
       /** Merge commit SHA (full 40-char hex) the checks ran on. */
       mergeCommitSha: string;
       /**