@cleocode/core 2026.10.27 → 2026.11.1-canary.10

package/dist/hooks/handlers/file-hooks.d.ts

@@ -20,4 +20,3 @@ import type { NotificationPayload } from '../types.js';
  * Converts absolute paths to project-relative paths.
  */
 export declare function handleFileChange(projectRoot: string, payload: NotificationPayload): Promise<void>;
-//# sourceMappingURL=file-hooks.d.ts.map

package/dist/hooks/handlers/handler-helpers.d.ts

@@ -58,4 +58,3 @@ export declare function isNoProjectError(err: unknown): boolean;
  * @param projectRoot - Absolute path to the project root directory.
  */
 export declare function isAutoCaptureEnabled(projectRoot: string): Promise<boolean>;
-//# sourceMappingURL=handler-helpers.d.ts.map

package/dist/hooks/handlers/index.d.ts

@@ -28,4 +28,3 @@ export { handleSessionEnd, handleSessionEndJournal, handleSessionStart, } from '
 export { handleToolComplete, handleToolStart } from './task-hooks.js';
 export { handleWatchdogStart, handleWatchdogStop } from './watchdog-hooks.js';
 export { handleWorkPromptSubmit, handleWorkResponseComplete } from './work-capture-hooks.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/hooks/handlers/intelligence-hooks.d.ts

@@ -23,4 +23,3 @@ import type { PreToolUsePayload } from '../types.js';
  * Best-effort: any error is silently swallowed.
  */
 export declare function handleTaskStartIntelligence(projectRoot: string, payload: PreToolUsePayload): Promise<void>;
-//# sourceMappingURL=intelligence-hooks.d.ts.map

package/dist/hooks/handlers/memory-bridge-refresh.d.ts

@@ -17,4 +17,3 @@
  * @param projectRoot - Absolute path to the project root directory.
  */
 export declare function maybeRefreshMemoryBridge(projectRoot: string): Promise<void>;
-//# sourceMappingURL=memory-bridge-refresh.d.ts.map

package/dist/hooks/handlers/notification-hooks.d.ts

@@ -28,4 +28,3 @@ import type { NotificationPayload } from '../types.js';
  * @task T166
  */
 export declare function handleSystemNotification(projectRoot: string, payload: NotificationPayload): Promise<void>;
-//# sourceMappingURL=notification-hooks.d.ts.map

package/dist/hooks/handlers/precompact.d.ts

@@ -127,4 +127,3 @@ export declare const PRECOMPACT_FLUSH_HOOK_PRIORITY = 110;
  * best-effort regardless of transport.
  */
 export declare function precompactHookRegistryAdapter(projectRoot: string, payload: PreCompactPayload): Promise<void>;
-//# sourceMappingURL=precompact.d.ts.map

package/dist/hooks/handlers/session-hooks.d.ts

@@ -22,9 +22,10 @@
  *       Runs after reflector so it is the last scheduled operation. Records the
  *       session JSONL path so `cleo transcript scan --pending` can list queued work.
  * T1263: Append session journal entry at priority 2 (last in pipeline).
- *        Absorbs T1262 session-end hook: calls scanBrainNoise and embeds
- *        doctorSummary in each session_end journal entry.
  *        MUST use `await` (not setImmediate) — process exits after this hook.
+ *        T14120: it no longer runs scanBrainNoise (the T1262 absorption): the
+ *        scan's whole-graph query held session end for ~120 s on a 1.4 GB
+ *        store to fill `doctorSummary`, which nothing reads.
  */
 import type { SessionEndPayload, SessionStartPayload } from '../types.js';
 /**
@@ -108,8 +109,8 @@ export declare function handleSessionEndTranscriptSchedule(projectRoot: string,
 /**
  * Handle SessionEnd — append a session journal entry to `.cleo/session-journals/`.
  *
- * T1263 PSYCHE E6: Writes a `session_end` JSONL entry capturing session metadata
- * and the compact result of `scanBrainNoise` (T1262 absorption).
+ * T1263 PSYCHE E6: Writes a `session_end` JSONL entry capturing session metadata.
+ * It runs no brain scan (T14120: the scan held session end for ~120 s).
  *
  * **MUST use synchronous `await`** — this hook runs at priority 2, immediately
  * before process.exit. Using `setImmediate` here would silently drop the write.
@@ -120,4 +121,3 @@ export declare function handleSessionEndTranscriptSchedule(projectRoot: string,
  * have finished first).
  */
 export declare function handleSessionEndJournal(projectRoot: string, payload: SessionEndPayload): Promise<void>;
-//# sourceMappingURL=session-hooks.d.ts.map

package/dist/hooks/handlers/session-hooks.js

@@ -22,9 +22,10 @@
  *       Runs after reflector so it is the last scheduled operation. Records the
  *       session JSONL path so `cleo transcript scan --pending` can list queued work.
  * T1263: Append session journal entry at priority 2 (last in pipeline).
- *        Absorbs T1262 session-end hook: calls scanBrainNoise and embeds
- *        doctorSummary in each session_end journal entry.
  *        MUST use `await` (not setImmediate) — process exits after this hook.
+ *        T14120: it no longer runs scanBrainNoise (the T1262 absorption): the
+ *        scan's whole-graph query held session end for ~120 s on a 1.4 GB
+ *        store to fill `doctorSummary`, which nothing reads.
  */
 import { hooks } from '../registry.js';
 import { maybeRefreshMemoryBridge } from './memory-bridge-refresh.js';
@@ -206,8 +207,8 @@ export async function handleSessionEndTranscriptSchedule(projectRoot, payload) {
 /**
  * Handle SessionEnd — append a session journal entry to `.cleo/session-journals/`.
  *
- * T1263 PSYCHE E6: Writes a `session_end` JSONL entry capturing session metadata
- * and the compact result of `scanBrainNoise` (T1262 absorption).
+ * T1263 PSYCHE E6: Writes a `session_end` JSONL entry capturing session metadata.
+ * It runs no brain scan (T14120: the scan held session end for ~120 s).
  *
  * **MUST use synchronous `await`** — this hook runs at priority 2, immediately
  * before process.exit. Using `setImmediate` here would silently drop the write.
@@ -221,21 +222,6 @@ export async function handleSessionEndJournal(projectRoot, payload) {
     try {
         const { SESSION_JOURNAL_SCHEMA_VERSION } = await import('@cleocode/contracts/session-journal.js');
         const { appendSessionJournalEntry } = await import('../../sessions/session-journal.js');
-        // Run brain-noise scan (T1262 absorption) — best-effort
-        let doctorSummary;
-        try {
-            const { scanBrainNoise } = await import('../../memory/brain-doctor.js');
-            const scanResult = await scanBrainNoise(projectRoot);
-            doctorSummary = {
-                isClean: scanResult.isClean,
-                findingsCount: scanResult.findings.length,
-                patterns: scanResult.findings.map((f) => f.pattern),
-                totalScanned: scanResult.totalScanned,
-            };
-        }
-        catch {
-            // scanBrainNoise failures must never block journal write
-        }
         // Detect agent identifier from environment
         const agentIdentifier = process.env.CLEO_AGENT_ID ?? process.env.CLAUDE_CODE_AGENT_ID ?? undefined;
         await appendSessionJournalEntry(projectRoot, {
@@ -247,7 +233,6 @@ export async function handleSessionEndJournal(projectRoot, payload) {
             providerId: payload.providerId,
             duration: payload.duration,
             tasksCompleted: payload.tasksCompleted,
-            ...(doctorSummary !== undefined ? { doctorSummary } : {}),
         });
     }
     catch {
@@ -308,7 +293,6 @@ hooks.register({
 });
 // Priority 2 — T1263: append session journal entry LAST in the pipeline.
 // MUST use await (not setImmediate) — process exits after this hook fires.
-// Absorbs T1262 session-end doctor integration: embeds scanBrainNoise result.
 hooks.register({
     id: 'journal-session-end',
     event: 'SessionEnd',

package/dist/hooks/handlers/session-hooks.js.map

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

package/dist/hooks/handlers/task-hooks.d.ts

@@ -22,4 +22,3 @@ export declare function handleToolStart(_projectRoot: string, _payload: PreToolU
  * @param _payload - Completion payload retained for the hook interface.
  */
 export declare function handleToolComplete(projectRoot: string, _payload: PostToolUsePayload): Promise<void>;
-//# sourceMappingURL=task-hooks.d.ts.map

package/dist/hooks/handlers/watchdog-hooks.d.ts

@@ -46,4 +46,3 @@ export declare function handleWatchdogStart(projectRoot: string, _payload: Sessi
  * @param _payload - SessionEnd payload (unused).
  */
 export declare function handleWatchdogStop(projectRoot: string, _payload: SessionEndPayload): Promise<void>;
-//# sourceMappingURL=watchdog-hooks.d.ts.map

package/dist/hooks/handlers/work-capture-hooks.d.ts

@@ -37,4 +37,3 @@ export declare function handleWorkPromptSubmit(projectRoot: string, payload: Pro
  * @param payload     - ResponseComplete event payload
  */
 export declare function handleWorkResponseComplete(projectRoot: string, payload: ResponseCompletePayload): Promise<void>;
-//# sourceMappingURL=work-capture-hooks.d.ts.map

package/dist/hooks/index.d.ts

@@ -14,4 +14,3 @@ export type { PayloadValidationResult } from './payload-schemas.js';
 export { HookPayloadSchema, OnAgentCompletePayloadSchema, OnAgentSpawnPayloadSchema, OnCascadeStartPayloadSchema, OnErrorPayloadSchema, OnFileChangePayloadSchema, OnPatrolPayloadSchema, OnPromptSubmitPayloadSchema, OnResponseCompletePayloadSchema, OnSessionEndPayloadSchema, OnSessionStartPayloadSchema, OnToolCompletePayloadSchema, OnToolStartPayloadSchema, OnWorkAvailablePayloadSchema, validatePayload, } from './payload-schemas.js';
 export { HookRegistry, hooks } from './registry.js';
 export type * from './types.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/hooks/payload-schemas.d.ts

@@ -377,4 +377,3 @@ export interface PayloadValidationResult {
  * @returns Validation result with any error messages
  */
 export declare function validatePayload(event: HookEvent, payload: unknown): PayloadValidationResult;
-//# sourceMappingURL=payload-schemas.d.ts.map

package/dist/hooks/project-runner.d.ts

@@ -12,4 +12,3 @@ export declare function createProjectHookExecutor(activationRoot: string): HookE
  * @returns The matching record, or undefined when absent, malformed or mismatched.
  */
 export declare function readLastProjectHookExecution(cwd: string, binding?: ProjectHookBinding): Promise<HookExecutionReceipt | undefined>;
-//# sourceMappingURL=project-runner.d.ts.map

package/dist/hooks/project-state.d.ts

@@ -53,4 +53,3 @@ export declare function activateProjectHooks(cwd: string): Promise<ProjectHooksL
 export declare function disableProjectHooks(cwd: string): Promise<void>;
 /** Match a project's binding without treating shell command text as a Git operation. */
 export declare function matchesProjectHook(hook: Pick<ProjectHookDefinition, 'bindings'>, source: string, event: string): boolean;
-//# sourceMappingURL=project-state.d.ts.map

package/dist/hooks/provider-hooks.d.ts

@@ -50,4 +50,3 @@ export declare function toCanonicalHookEvent(nativeEvent: string, providerId: st
 export declare function providerSupportsHookEvent(event: CanonicalHookEvent, providerId: string): boolean;
 export type { CanonicalHookEvent as ProviderHookEvent, HookEvent };
 export { getCommonHookEvents, getProvidersByHookEvent, supportsHook, toCanonical, toNative };
-//# sourceMappingURL=provider-hooks.d.ts.map

package/dist/hooks/registry.d.ts

@@ -128,4 +128,3 @@ export declare class HookRegistry {
  * Use this instance for all hook operations throughout the application.
  */
 export declare const hooks: HookRegistry;
-//# sourceMappingURL=registry.d.ts.map

package/dist/hooks/release-gate.d.ts

@@ -71,4 +71,3 @@ export declare function hookReleaseManifest(): HookReleaseManifest;
  * @returns `true` when project hooks may run.
  */
 export declare function hooksV1Released(opts?: HooksV1ReleaseOptions): boolean;
-//# sourceMappingURL=release-gate.d.ts.map

package/dist/hooks/types.d.ts

@@ -449,4 +449,3 @@ export interface HookEventPayloadMap {
  * @task T12071
  */
 export type HookPayloadFor<E extends HookEvent> = E extends keyof HookEventPayloadMap ? HookEventPayloadMap[E] : HookPayload;
-//# sourceMappingURL=types.d.ts.map

package/dist/hooks.d.ts

@@ -1,14 +1,16 @@
-import type { GitHookInstallOptions } from '@cleocode/contracts/git-hooks.js';
+import { type GitHookInstallOptions } from '@cleocode/contracts/git-hooks.js';
 import type { HookCheckResult, ScaffoldResult } from '@cleocode/contracts/scaffold-diagnostics';
 export type { HookCheckResult, ScaffoldResult } from '@cleocode/contracts/scaffold-diagnostics';
 /** Compatibility options; force never permits replacing foreign/customized hooks. */
 export type EnsureGitHooksOptions = GitHookInstallOptions;
 /** Canonical shipped hook set shared with the installer. */
-export declare const MANAGED_HOOKS: readonly ["commit-msg", "pre-commit", "pre-push", "post-merge"];
+export declare const MANAGED_HOOKS: readonly ["commit-msg", "pre-commit", "pre-push", "post-merge", "post-commit", "post-checkout", "post-rewrite"];
 /** One shipped Git hook name. */
 export type ManagedHook = (typeof MANAGED_HOOKS)[number];
 /** Install all managed hooks through the canonical ownership-aware installer. */
 export declare function ensureGitHooks(projectRoot: string, opts?: EnsureGitHooksOptions): Promise<ScaffoldResult>;
-/** Inspect all hooks at the location Git actually executes, including worktrees. */
+/**
+ * Inspect all hooks at the location Git actually executes, including
+ * worktrees. The NEXUS refresh hooks are expected only while they are on.
+ */
 export declare function checkGitHooks(projectRoot: string): Promise<HookCheckResult[]>;
-//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.js

@@ -1,7 +1,8 @@
 /** Shared Git hook management wrappers for init, upgrade and health. */
 import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
-import { CLEO_HOOK_NAMES, defaultTemplatesDir, installCleoHooks, resolveGitDir, resolveHooksDir, } from './git/hooks-install.js';
+import { NEXUS_GIT_HOOK_NAMES } from '@cleocode/contracts/git-hooks.js';
+import { CLEO_HOOK_NAMES, defaultTemplatesDir, installCleoHooks, isNexusAutoReindexEnabled, resolveGitDir, resolveHooksDir, } from './git/hooks-install.js';
 /** Canonical shipped hook set shared with the installer. */
 export const MANAGED_HOOKS = CLEO_HOOK_NAMES;
 /** Install all managed hooks through the canonical ownership-aware installer. */
@@ -31,14 +32,21 @@ export async function ensureGitHooks(projectRoot, opts) {
         };
     }
 }
-/** Inspect all hooks at the location Git actually executes, including worktrees. */
+/**
+ * Inspect all hooks at the location Git actually executes, including
+ * worktrees. The NEXUS refresh hooks are expected only while they are on.
+ */
 export async function checkGitHooks(projectRoot) {
     const gitDir = resolveGitDir(projectRoot);
     const hooksDir = gitDir
         ? resolveHooksDir(projectRoot, gitDir)
         : join(projectRoot, '.git', 'hooks');
     const templates = defaultTemplatesDir();
-    return MANAGED_HOOKS.map((hook) => {
+    const nexusOn = !gitDir || isNexusAutoReindexEnabled(projectRoot);
+    const expected = nexusOn
+        ? MANAGED_HOOKS
+        : MANAGED_HOOKS.filter((hook) => !NEXUS_GIT_HOOK_NAMES.includes(hook));
+    return expected.map((hook) => {
         const sourcePath = join(templates, hook);
         const installedPath = join(hooksDir, hook);
         const installed = existsSync(installedPath);

package/dist/hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAKhC,4DAA4D;AAC5D,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC;AAI7C,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,WAAmB,EACnB,IAA4B;IAE5B,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC;QAC7B,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,yDAAyD;SACnE,CAAC;IACJ,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACzD,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO;aAC7B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,KAAK,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;aACrD,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;YACvD,IAAI,EAAE,MAAM,CAAC,QAAQ;YACrB,OAAO,EAAE,aAAa,MAAM,CAAC,SAAS,CAAC,MAAM,aAAa,SAAS,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;SAC9F,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,iCAAiC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;SAC7F,CAAC;IACJ,CAAC;AACH,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,WAAmB;IACrD,MAAM,MAAM,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,MAAM;QACrB,CAAC,CAAC,eAAe,CAAC,WAAW,EAAE,MAAM,CAAC;QACtC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,mBAAmB,EAAE,CAAC;IACxC,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAChC,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACzC,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;QAC5C,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC;YACH,OAAO;gBACL,SAAS,IAAI,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAC1F,CAAC;QAAC,MAAM,CAAC;YACP,6CAA6C;QAC/C,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC;IACjE,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"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"}

package/dist/hygiene/census.d.ts

@@ -0,0 +1,239 @@
+/**
+ * The machine-wide worktree census (T14275, durability plan S3 / C-F3).
+ *
+ * The worktree root (`<cleoHome>/worktrees/<projectHash>/…`) is per machine,
+ * but every other cleanup path resolves one project's hash directory, so the
+ * worktrees of projects never run from their root (other repositories,
+ * deleted ones, scratch clones) were never swept: 484 had accumulated. The
+ * CI cleanup workflow ran where no worktree exists and swallowed every error.
+ *
+ * The census walks every project hash directory and every registered project's
+ * git worktree registry (including unadopted external worktrees):
+ *
+ * - a directory whose hash matches a registered project (the nexus registry)
+ *   is classified by that project's {@link listWorktrees}: the disposal proof
+ *   decides `redundant`, `keep` (with the failing clause) or `unknown`, and
+ *   an open task or a fresh worktree is `active` (T14274);
+ * - a directory no registered project owns, and any directory git does not
+ *   list as a worktree, is reported `unknown`, report only.
+ *
+ * The CLI reports by default. `--apply` removes only `redundant` terminal
+ * worktrees of the allowed projects (current project unless `--all-projects`);
+ * automatic completion and scheduled cleanup opt in explicitly, each re-proved by
+ * `disposeWorktree` with the task's evidence. Every run writes one census
+ * record (counts, apparent bytes, bytes reclaimed, the free-space delta and
+ * every kept worktree with its reason) under `<cleoHome>/hygiene/census/`.
+ *
+ * One census runs at a time per machine (a heartbeat lock), and the lazy spawn
+ * claims at most one run per project per 24 h; it never starts in CI, under vitest, or in
+ * a process git started (T14189).
+ *
+ * @task T14275
+ */
+import { type SpawnOptions } from 'node:child_process';
+import type { WorktreeStatusCategory } from '@cleocode/contracts';
+/** The lazy census runs at most this often per project. */
+export declare const CENSUS_INTERVAL_MS: number;
+/** One worktree directory the census found. */
+export interface CensusRow {
+    /** The registered project that owns it, or `null` when none does. */
+    project: string | null;
+    /** The hash directory it sits in. */
+    projectHash: string;
+    /** The worktree directory. */
+    path: string;
+    /** Its task, when known. */
+    taskId: string | null;
+    /** The disposal-proof category (T14274); `unknown` for anything not proven. */
+    category: WorktreeStatusCategory;
+    /** For `keep` and `unknown`: why. */
+    keepReason?: string;
+    /** Apparent size (the sum of file sizes, as `du --apparent-size`), in bytes. */
+    apparentBytes: number;
+    /** The branch is retained after removal. */
+    branch?: string;
+    /** Last recorded activity, used to order eligible worktrees oldest first. */
+    lastActivity?: string;
+    /** Task state at discovery; only done and cancelled tasks are removal candidates. */
+    taskStatus?: string | null;
+    /** Selected by the TTL and retained-size budget, including in a dry run. */
+    selected?: boolean;
+    /** Set when `--apply` removed it. */
+    removed?: boolean;
+}
+/** The record one census run writes. */
+export interface CensusRecord {
+    /** Record format version. */
+    schemaVersion: 1;
+    /** `report` reads only; `apply` removed proven-redundant worktrees. */
+    mode: 'report' | 'apply';
+    /** ISO time the run started. */
+    startedAt: string;
+    /** ISO time the run finished. */
+    finishedAt: string;
+    /** The machine's worktree root. */
+    machineRoot: string;
+    /** Projects `--apply` was allowed to act on. */
+    applyProjects: string[];
+    /** Worktrees per category. */
+    counts: Record<WorktreeStatusCategory, number>;
+    /** Apparent bytes of every worktree found. */
+    apparentBytes: number;
+    /** Apparent bytes of the worktrees removed. */
+    reclaimedApparentBytes: number;
+    /** Free bytes on the root's filesystem before and after, and the delta (apply only). */
+    dfFreeBefore: number | null;
+    dfFreeAfter: number | null;
+    dfDelta: number | null;
+    /** Every worktree not removed and not active, with its reason. */
+    kept: Array<{
+        path: string;
+        category: WorktreeStatusCategory;
+        keepReason: string;
+    }>;
+    /** Every worktree found. */
+    rows: CensusRow[];
+    /** True when the wall-clock budget ran out: rows and bytes are a lower bound. */
+    partial: boolean;
+    /** Minimum idle age of eligible worktrees, in days. */
+    ttlDays?: number;
+    /** Target retained apparent bytes; safety and TTL may prevent reaching it. */
+    maxBytes?: number;
+    /** Registered projects that could not be assessed; never eligible for removal. */
+    projectErrors?: Array<{
+        project: string;
+        error: string;
+    }>;
+}
+/** Options of {@link runWorktreeCensus}. */
+export interface WorktreeCensusOptions {
+    /** Remove proven-redundant worktrees (default: report only). */
+    apply?: boolean;
+    /** Projects `apply` may act on (default: none; the CLI passes the current project). */
+    applyProjects?: readonly string[];
+    /** Explicitly allow removal in every registered project. */
+    allProjects?: boolean;
+    /** Minimum idle age in days (default: zero); a budget never overrides it. */
+    ttlDays?: number;
+    /** Stop removing once retained apparent bytes reach this budget (default: zero). */
+    maxBytes?: number;
+    /** Explicitly allow merged ignored build output to be regenerated; never force-archive. */
+    exemptRegenerable?: boolean;
+    /** Registered project roots (default: read from the nexus registry). */
+    projects?: readonly string[];
+    /** Where the record is written (default: `<cleoHome>/hygiene/census`). */
+    recordDir?: string;
+    /** The worktree root (default: the machine's). */
+    machineRoot?: string;
+    /** Wall-clock deadline (ms epoch): past it the walk stops and the record is `partial`. */
+    deadline?: number;
+}
+/**
+ * Apparent size of a tree: the sum of `lstat` sizes, symlinks never followed;
+ * 0 when unreadable. Stops early (an undercount) once `deadline` passes.
+ */
+export declare function apparentBytes(path: string, deadline?: number): number;
+/**
+ * Registered project roots from the nexus registry; `[]` when it cannot be read.
+ *
+ * @param load - The registry listing (default: `nexusList`; tests stub it).
+ * @param onError - Capture missing registry coverage in the census receipt.
+ * @returns Each registered project's path.
+ * @internal Exported for tests.
+ */
+export declare function registeredProjects(load?: () => Promise<ReadonlyArray<{
+    path: string;
+}>>, onError?: (message: string) => void): Promise<string[]>;
+/**
+ * Run the census once, under the machine's census lock.
+ *
+ * @param opts - Apply or report, the projects apply may touch, overrides for tests.
+ * @returns The record and where it was written, or why it was skipped.
+ * @task T14275
+ */
+export declare function runWorktreeCensus(opts?: WorktreeCensusOptions): Promise<{
+    record: CensusRecord;
+    recordPath: string;
+} | {
+    skipped: string;
+}>;
+/** The lazy census child's wall-clock budget: past it, a partial record and exit. */
+export declare const LAZY_CENSUS_BUDGET_MS: number;
+/**
+ * Whether a live census holds the lock (its heartbeat is fresh).
+ *
+ * @param dir - The census directory (tests).
+ * @param now - Current time (ms).
+ * @returns True while another census runs.
+ */
+export declare function censusLockHeld(dir?: string, now?: number): boolean;
+/**
+ * Start the daily report-only census in a detached child (T14275), unless a
+ * live census holds the lock or today's run is already claimed. The child has
+ * no stdin, writes stdout and stderr to `<dir>/census.log`, runs at background
+ * priority, stops at {@link LAZY_CENSUS_BUDGET_MS} with a partial record, and
+ * exits. Callers check {@link censusSpawnAllowed} first.
+ *
+ * @param env - The child's environment (git hook variables already stripped).
+ * @param deps - `spawn`, `dir` and `now` (tests).
+ * @returns Why nothing started, or `null` when the child started.
+ * @task T14275
+ */
+export declare function startLazyCensus(env: NodeJS.ProcessEnv, deps?: {
+    spawn?: (command: string, args: string[], options: SpawnOptions) => {
+        unref(): void;
+    };
+    dir?: string;
+    now?: number;
+    /** Canonical project root: each project has its own daily claim. */
+    projectRoot?: string;
+}): string | null;
+/**
+ * The lazy census child's body (T14275): background CPU priority, a
+ * {@link LAZY_CENSUS_BUDGET_MS} wall-clock budget (a partial record past it),
+ * and a hard exit shortly after the budget so a hung `git` can never keep the
+ * process alive. The lock is released on every exit path.
+ *
+ * @param dir - The census directory.
+ * @param projectRoot - The project captured by the scheduling caller.
+ * @task T14275
+ */
+export declare function runLazyCensus(dir?: string, projectRoot?: string): Promise<void>;
+/**
+ * Whether a read command may start the lazy census: never in CI, under vitest,
+ * or in a process git started (T14189: a hook carries GIT_EXEC_PATH,
+ * GIT_INDEX_FILE or GIT_DIR).
+ *
+ * @param env - The environment.
+ * @returns True when a detached census may be spawned.
+ * @task T14275
+ */
+export declare function censusSpawnAllowed(env: NodeJS.ProcessEnv): boolean;
+/**
+ * Claim today's lazy census, atomically: one caller per project per interval,
+ * or one machine-wide report when no project is supplied.
+ *
+ * @param now - Current time (ms).
+ * @param dir - The census directory (tests).
+ * @param projectRoot - The canonical project root whose daily run is claimed.
+ * @returns True when this caller should start the census.
+ * @task T14275
+ */
+export declare function claimCensus(now?: number, dir?: string, projectRoot?: string): boolean;
+/**
+ * The newest census record, or `null` when none was written.
+ *
+ * @param dir - The census directory (tests).
+ * @returns The record from `latest.json`.
+ * @task T14275
+ */
+export declare function readLatestCensus(dir?: string): CensusRecord | null;
+/**
+ * The briefing's one census line (T14275): how many worktrees the last census
+ * kept and their apparent size, or `null` when it kept none (or never ran).
+ *
+ * @param dir - The census directory (tests).
+ * @returns e.g. "12 worktrees (3.4 GB) kept: run `cleo hygiene census --report`".
+ * @task T14275
+ */
+export declare function censusBriefingLine(dir?: string): string | null;