@cleocode/core 2026.9.7 → 2026.9.9

package/dist/audit/reconstruct.d.ts

@@ -1,50 +1,20 @@
-/**
- * Audit lineage reconstruction — SDK primitive.
- *
- * Promotes git-log + release-tag lineage reconstruction to a first-class
- * SDK verb. Git IS the immutable hash-chained ledger; this module mines it
- * to produce a structured {@link ReconstructResult} consumed by T1216 audit tasks.
- *
- * No `.jsonl` sidecar is emitted — git's DAG is the source of truth (per
- * FP peer note, T1322 council verdict 2026-04-24).
- *
- * Security: all git subprocess calls use `execFileSync` with strict `argv`
- * arrays — no shell interpolation or user-controlled string concatenation
- * in the command string.
- *
- * @task T1322
- * @epic T1216
- */
 import type { ReconstructResult } from '@cleocode/contracts';
+import type { ReconstructOptions } from '@cleocode/contracts/audit';
 /**
- * Reconstruct the git-backed lineage for a task and its inferred children.
- *
- * This is the first-class SDK verb for audit lineage reconstruction (T1322).
- * It queries git directly and returns a fully-typed {@link ReconstructResult}
- * that T1216 audit tasks consume for their 4-outcome verdict.
- *
- * **Algorithm**:
- * 1. Find direct commits whose message references `taskId`.
- * 2. Infer child ID range from commit-message mining and numeric adjacency.
- * 3. Find child commits for each inferred child ID.
- * 4. Collect all release tags containing any direct or child commit.
- * 5. Compute first/last timestamps across the full commit set.
- *
- * @param taskId - The task ID to reconstruct (e.g. `"T991"`).
- * @param repoRoot - Absolute path to the git repository. Defaults to `process.cwd()`.
- * @returns A fully-typed {@link ReconstructResult} with all git-derived lineage data.
- *
+ * Reconstruct exact task references and containing tags from bounded local Git reads.
+ * @param taskId - Exact uppercase task token (for example T994), never a grep substring.
+ * @param repoRoot - Explicit repository root, otherwise the captured caller scope or cwd.
+ * @param options - Optional limits which cannot extend an inherited execution deadline.
+ * @returns Existing lineage fields plus mandatory assessment coverage on every new result.
+ * @remarks Reads commit messages and parents once, then propagates ancestry in topological
+ * order. Git failures, truncated output, shallow history and cancellation are explicit.
+ * No remote fetch or writes occur. Numeric child inference is retained for compatibility
+ * and is not proof of task ownership. CPU stages yield cooperatively; this is not preemption.
  * @example
  * ```ts
- * import { reconstructLineage } from '@cleocode/core/audit/reconstruct.js';
- *
- * const result = await reconstructLineage('T991');
- * console.log(result.releaseTags.map(t => t.tag));
- * // → ['v2026.4.98', 'v2026.4.99', ...]
+ * const lineage = await reconstructLineage('T994', '/project', {});
+ * if (lineage.assessment?.coverage !== 'current') return;
  * ```
- *
- * @task T1322
- * @epic T1216
  */
-export declare function reconstructLineage(taskId: string, repoRoot?: string): Promise<ReconstructResult>;
+export declare function reconstructLineage(taskId: string, repoRoot?: string, options?: ReconstructOptions): Promise<ReconstructResult>;
 //# sourceMappingURL=reconstruct.d.ts.map

package/dist/audit/reconstruct.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reconstruct.d.ts","sourceRoot":"","sources":["../../src/audit/reconstruct.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAe,iBAAiB,EAAmB,MAAM,qBAAqB,CAAC;AAmO3F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,CAAC,CAsE5B"}
+{"version":3,"file":"reconstruct.d.ts","sourceRoot":"","sources":["../../src/audit/reconstruct.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAe,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,KAAK,EAAyB,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAM3F;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAqT5B"}