@cleocode/contracts 2026.10.8 → 2026.10.9

package/dist/operations/worktree.d.ts

@@ -13,6 +13,7 @@
  * @adr ADR-055
  * @adr ADR-062
  */
+import type { HookExecutor, HookOutcome } from '../project-hooks.js';
 /**
  * A declarative lifecycle hook definition for worktree events.
  *
@@ -23,6 +24,8 @@
  * @task T1161
  */
 export interface WorktreeHook {
+    /** Shared hook identity when legacy wiring duplicates a tracked project definition. */
+    projectHookId?: string;
     /** Shell command to run in the worktree dir (`/bin/sh -c` on POSIX, cmd.exe on Windows). */
     command: string;
     /**
@@ -213,6 +216,8 @@ export interface CreateWorktreeOptions {
     reason?: 'subagent' | 'experiment' | 'parallel-wave';
     /** Declarative hooks to run after creation. */
     hooks?: WorktreeHook[];
+    /** Optional shared project executor injected by CLEO; never imports core into worktree. */
+    projectHookExecutor?: HookExecutor;
     /**
      * When true, read `.cleo/worktree-include` from the project root and apply
      * any declared include patterns to the new worktree.
@@ -291,6 +296,52 @@ export interface CreateWorktreeOptions {
      * @task T12506
      */
     lockTtlMs?: number;
+    /**
+     * The git shim the caller installed for this worktree (T13522). Only when
+     * `installed` is the shim dir prepended to PATH and
+     * `CLEO_BRANCH_PROTECTION=strict` advertised; otherwise the env says
+     * `unavailable`, so nothing claims a fence that is not there.
+     *
+     * @task T13522
+     */
+    gitShim?: {
+        readonly dir: string;
+        readonly installed: boolean;
+    };
+    /**
+     * Provision without installing dependencies (`--no-install`, T13524). The
+     * result's `install` says so, with the command the worker runs instead.
+     *
+     * @task T13524
+     */
+    skipInstall?: boolean;
+    /**
+     * Admission for the dependency install (T13524): called before `pnpm install`
+     * runs; resolves to a release function once admitted, or `null` when the
+     * machine budget is busy, in which case the install is deferred to the
+     * worker rather than run outside the heavy-work queue. Absent: install
+     * unadmitted (legacy callers).
+     *
+     * @task T13524
+     */
+    admitInstall?: () => Promise<(() => Promise<void>) | null>;
+}
+/**
+ * What happened to a worktree's dependency install (T13524).
+ *
+ * @task T13524
+ */
+export interface WorktreeInstallOutcome {
+    /**
+     * `installed`/`failed`: it ran. `skipped`: `--no-install`. `deferred`: the
+     * machine budget was busy, so the worker installs. `not-needed`: no
+     * lockfile, already installed, or a re-attached worktree.
+     */
+    status: 'installed' | 'failed' | 'skipped' | 'deferred' | 'not-needed';
+    /** Why, for anything but `installed`. */
+    reason?: string;
+    /** The command the worker runs when the install did not happen here. */
+    command?: string;
 }
 /**
  * Result of a successful worktree creation.
@@ -338,6 +389,8 @@ export interface CreateWorktreeResult {
     preamble: string;
     /** Results of any post-create hooks that were executed. */
     hookResults: WorktreeHookResult[];
+    /** Results from activated project definitions for post-create. */
+    projectHookResults?: HookOutcome[];
     /** Include patterns that were applied (empty if none). */
     appliedPatterns: WorktreeIncludePattern[];
     /**
@@ -351,7 +404,15 @@ export interface CreateWorktreeResult {
         failedPaths: string[];
         /** Results of post-start hooks. */
         hookResults: WorktreeHookResult[];
+        /** Results from activated project definitions for post-start. */
+        projectHookResults?: HookOutcome[];
     };
+    /**
+     * The dependency install outcome (T13524).
+     *
+     * @task T13524
+     */
+    install?: WorktreeInstallOutcome;
 }
 /**
  * Options for destroying a worktree.

package/dist/operations/worktree.d.ts.map

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

package/dist/project-context.d.ts

@@ -63,6 +63,15 @@ export interface ProjectEvidenceContext {
      * CLEO's own installed hook files are always excluded (T13135, gh#1805).
      */
     scopeExcludes?: string[];
+    /**
+     * Globs of TRACKED files a harness rewrites while a run executes (a goal
+     * runtime's `run.json`, its ledger), left out of the evidence tree hash so
+     * the run cannot stale its own receipt; they stay tracked for history
+     * (T13554). Read from the default branch only. A glob that matches the
+     * project context, a `goal.yaml`, an oracle or a typed gate's input is
+     * refused (E_EVIDENCE_RUNTIME_PATH_PROTECTED). Default: none.
+     */
+    runtimePaths?: string[];
 }
 /**
  * A required check named in `release.prRequiredWorkflows`, optionally pinned to

package/dist/project-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-context.d.ts","sourceRoot":"","sources":["../src/project-context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"project-context.d.ts","sourceRoot":"","sources":["../src/project-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,6EAA6E;AAC7E,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,QAAQ,GACR,MAAM,GACN,IAAI,GACJ,MAAM,GACN,MAAM,GACN,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,KAAK,GACL,MAAM,GACN,KAAK,GACL,SAAS,CAAC;AAEd,+BAA+B;AAC/B,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,MAAM,GACN,OAAO,GACP,IAAI,GACJ,OAAO,GACP,OAAO,GACP,YAAY,GACZ,SAAS,GACT,KAAK,GACL,KAAK,GACL,KAAK,GACL,WAAW,GACX,MAAM,GACN,KAAK,GACL,QAAQ,GACR,SAAS,CAAC;AAEd,yDAAyD;AACzD,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,CAAC;AAE5F,2BAA2B;AAC3B,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,UAAU,GAAG,OAAO,CAAC;AAEvD;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE;QACT,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;QACd,8EAA8E;QAC9E,IAAI,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;YAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC;KAC5C,CAAC;IACF;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,4DAA4D;AAC5D,MAAM,WAAW,qBAAqB;IACpC,6EAA6E;IAC7E,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,sGAAsG;IACtG,mBAAmB,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,gBAAgB,CAAC,CAAC;CACxD;AAED,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,aAAa,CAAC;QAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB;;;;;;;WAOG;QACH,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB;;;WAGG;QACH,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC5B,WAAW,CAAC,EAAE;YACZ,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,WAAW,CAAC,EAAE,MAAM,CAAC;SACtB,CAAC;KACH,CAAC;IACF,KAAK,CAAC,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,WAAW,CAAC,EAAE;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,WAAW,CAAC,EAAE;QACZ,UAAU,CAAC,EAAE,oBAAoB,CAAC;QAClC,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;QAC1B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC;IACF,sCAAsC;IACtC,IAAI,CAAC,EAAE;QACL,oDAAoD;QACpD,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,4CAA4C;IAC5C,SAAS,CAAC,EAAE;QACV,oCAAoC;QACpC,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,uCAAuC;IACvC,KAAK,CAAC,EAAE;QACN,qDAAqD;QACrD,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,4EAA4E;IAC5E,eAAe,CAAC,EAAE;QAChB,sDAAsD;QACtD,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,sDAAsD;IACtD,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,sBAAsB,CAAC;CACnC;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/dist/project-hook-delivery.d.ts

@@ -0,0 +1,137 @@
+/** Provider delivery contracts; runtime installers live in adapters and CAAMP. */
+import { z } from 'zod';
+import type { HookJsonValue } from './heavy-command-hook.js';
+import type { HookInvocation } from './project-hooks.js';
+/** Parsed JSON object used by surgical managed writers. */
+export type HookConfigObject = {
+    readonly [key: string]: HookJsonValue;
+};
+/** One surgical edit; undefined removes exactly the addressed node. */
+export interface HookConfigEdit {
+    /** JSON property/index path. */
+    path: (string | number)[];
+    /** Replacement value, or undefined for removal. */
+    value?: HookJsonValue;
+    /** Append/insert an array element without replacing its siblings. */
+    insert?: boolean;
+}
+/** Receipt authorizing management of one exact config entry. */
+export declare const ProjectHookDeliveryReceiptSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    provider: z.ZodString;
+    configPath: z.ZodString;
+    entries: z.ZodArray<z.ZodObject<{
+        event: z.ZodString;
+        hash: z.ZodString;
+        command: z.ZodString;
+    }, z.core.$strict>>;
+    recordedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+/** Machine-local source and entry ownership receipt. */
+export type ProjectHookDeliveryReceipt = z.infer<typeof ProjectHookDeliveryReceiptSchema>;
+/** Entry-level provenance without printing commands that may contain secrets. */
+export interface ProjectHookEntryInspection {
+    /** Native provider event. */
+    event: string;
+    /** Index in the provider event's entry array. */
+    index: number;
+    /** Receipt proves project delivery ownership; other ownership remains unknown. */
+    owner: 'project' | 'unknown';
+    /** Generated entry is attributable only through its retained local receipt. */
+    provenance: 'cleo-receipt' | 'unknown';
+    /** Entry digest permits review without retaining its command text. */
+    hash: string;
+    /** Tracked source, only for receipt-owned project checks. */
+    source?: '.cleo/hooks.json';
+}
+/** Inspect/install result; a config file never proves native trust or live support. */
+export interface ProjectHookDeliveryResult {
+    /** Harness identifier. */
+    provider: string;
+    /** Observed local binary version, when discoverable. */
+    version?: string;
+    /** Safe resolved project-local destination, absent when unsupported. */
+    configPath?: string;
+    /** Delivery state. */
+    state: 'planned' | 'current' | 'installed' | 'conflict' | 'unsupported' | 'disabled' | 'missing';
+    /** Independent capability evidence. */
+    capability: 'verified' | 'documented' | 'unverified';
+    /** Native project/definition trust is never granted by CLEO. */
+    nativeTrust: 'unverified';
+    /** Receipt-backed provenance; legacy config provenance remains unknown. */
+    provenance: 'cleo-receipt' | 'unknown';
+    /** Sanitized actionable findings. */
+    diagnostics: string[];
+    /** Reviewed team-config integration aid when automatic local delivery is ineligible. */
+    integrationSnippet?: string;
+    /** Per-entry attribution, deliberately excluding raw config command strings. */
+    entries?: ProjectHookEntryInspection[];
+}
+/** SDK-owned utilities injected into provider delivery without a runtime SDK dependency. */
+export interface ProjectHookDeliveryServices {
+    /**
+     * Read bounded regular files through the canonical filesystem primitive.
+     * @remarks
+     * The caller supplies the SDK implementation, preserving special-file and racing-growth checks.
+     * @param path - Resolved file path selected by the delivery adapter.
+     * @param maxBytes - Maximum UTF-8 input size in bytes.
+     * @returns The file's text after its descriptor and allocation limit have been checked.
+     * @example
+     * ```typescript
+     * const readConfiguration = (services: ProjectHookDeliveryServices) =>
+     *   services.readTextFile('/repo/.codex/hooks.json', 262144);
+     * ```
+     */
+    readTextFile(path: string, maxBytes: number): Promise<string>;
+    /**
+     * Git discovery environment with ambient repository overrides removed.
+     * @defaultValue No implicit default; the caller supplies the snapshot.
+     */
+    gitEnvironment: Readonly<Record<string, string | undefined>>;
+}
+/** Explicit cold-path provider sync inputs. */
+export interface ProjectHookDeliveryOptions {
+    /** Canonical SDK utilities supplied by the caller through the contracts port. */
+    services: ProjectHookDeliveryServices;
+    /** Checkout root validated by the core context resolver. */
+    projectRoot: string;
+    /** Per-checkout Git-private receipt directory. */
+    stateDir: string;
+    /** Canonical agent events selected from the manifest. */
+    events: string[];
+    /** Activation was inspected fresh. */
+    enabled: boolean;
+    /** No files (including lock files) may be written in dry-run mode. */
+    dryRun: boolean;
+    /**
+     * Explicit provider selection; otherwise detect project-local configuration.
+     * @defaultValue Providers detected from local configuration and installed harness binaries.
+     */
+    providers?: string[];
+    /**
+     * Remove only receipt-owned, unmodified additions instead of synchronizing.
+     * @defaultValue false
+     */
+    rollback?: boolean;
+}
+/** Provider-normalized request awaiting checkout resolution by core. */
+export interface ProjectHookNativeRequest {
+    /** Actual triggering directory, independent of harness-specific environment variables. */
+    cwd: string;
+    /** Provider wire protocol. */
+    provider: string;
+    /** Optional native event name from the provider input. */
+    nativeEvent?: string;
+    /** Shared input fields before Git resolves projectRoot and gitCommonDir. */
+    input: Omit<HookInvocation, 'projectRoot' | 'gitCommonDir'>;
+}
+/** Native stdout/stderr and adapter exit code; never an approval rewrite. */
+export interface ProjectHookNativeResult {
+    /** Provider-format advisory output. */
+    stdout: string;
+    /** Safe current-invocation diagnostics. */
+    stderr: string;
+    /** Git verdict failure or zero for advisory/infra failure. */
+    exitCode: number;
+}
+//# sourceMappingURL=project-hook-delivery.d.ts.map

package/dist/project-hook-delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-hook-delivery.d.ts","sourceRoot":"","sources":["../src/project-hook-delivery.ts"],"names":[],"mappings":"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"}

package/dist/project-hook-delivery.js

@@ -0,0 +1,21 @@
+/** Provider delivery contracts; runtime installers live in adapters and CAAMP. */
+import { z } from 'zod';
+/** Receipt authorizing management of one exact config entry. */
+export const ProjectHookDeliveryReceiptSchema = z
+    .object({
+    schemaVersion: z.literal(1),
+    provider: z.string().min(1).max(128),
+    configPath: z.string().min(1).max(4096),
+    entries: z
+        .array(z
+        .object({
+        event: z.string().min(1).max(128),
+        hash: z.string().regex(/^[a-f0-9]{64}$/),
+        command: z.string().min(1).max(8192),
+    })
+        .strict())
+        .max(128),
+    recordedAt: z.iso.datetime(),
+})
+    .strict();
+//# sourceMappingURL=project-hook-delivery.js.map

package/dist/project-hook-delivery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-hook-delivery.js","sourceRoot":"","sources":["../src/project-hook-delivery.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAexB,gEAAgE;AAChE,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC;KAC9C,MAAM,CAAC;IACN,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACpC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;IACvC,OAAO,EAAE,CAAC;SACP,KAAK,CACJ,CAAC;SACE,MAAM,CAAC;QACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;QACjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC;QACxC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;KACrC,CAAC;SACD,MAAM,EAAE,CACZ;SACA,GAAG,CAAC,GAAG,CAAC;IACX,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE;CAC7B,CAAC;KACD,MAAM,EAAE,CAAC"}

package/dist/project-hooks.d.ts

@@ -0,0 +1,276 @@
+/** Project-owned checks shared by Git, harness and worktree adapters (T13343). */
+import { z } from 'zod';
+import type { HookJsonValue } from './heavy-command-hook.js';
+/** Invocation origin; CI has stricter failure handling than local adapters. */
+export declare const HookSourceSchema: z.ZodEnum<{
+    direct: "direct";
+    ci: "ci";
+    worktree: "worktree";
+    agent: "agent";
+    git: "git";
+}>;
+/** Shared invocation origin. */
+export type HookSource = z.infer<typeof HookSourceSchema>;
+/** A checkout-relative path; runtime validation also resolves symlinks. */
+export declare const ProjectHookPathSchema: z.ZodString;
+/** One project definition; CLEO IDs are reserved for shipped infrastructure. */
+export declare const ProjectHookDefinitionSchema: z.ZodObject<{
+    id: z.ZodString;
+    owner: z.ZodLiteral<"project">;
+    bindings: z.ZodArray<z.ZodObject<{
+        source: z.ZodEnum<{
+            direct: "direct";
+            ci: "ci";
+            worktree: "worktree";
+            agent: "agent";
+            git: "git";
+        }>;
+        event: z.ZodString;
+    }, z.core.$strict>>;
+    executable: z.ZodString;
+    handler: z.ZodString;
+    args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    dependencies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+    checkerErrorPolicy: z.ZodDefault<z.ZodEnum<{
+        warn: "warn";
+        block: "block";
+    }>>;
+}, z.core.$strict>;
+/** Validated project checker configuration. Handler is executable's first argument. */
+export type ProjectHookDefinition = z.infer<typeof ProjectHookDefinitionSchema>;
+/** Tracked single source of truth; array order defines execution order. */
+export declare const ProjectHooksManifestSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    hooks: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        owner: z.ZodLiteral<"project">;
+        bindings: z.ZodArray<z.ZodObject<{
+            source: z.ZodEnum<{
+                direct: "direct";
+                ci: "ci";
+                worktree: "worktree";
+                agent: "agent";
+                git: "git";
+            }>;
+            event: z.ZodString;
+        }, z.core.$strict>>;
+        executable: z.ZodString;
+        handler: z.ZodString;
+        args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        dependencies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        timeoutMs: z.ZodDefault<z.ZodNumber>;
+        checkerErrorPolicy: z.ZodDefault<z.ZodEnum<{
+            warn: "warn";
+            block: "block";
+        }>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+/** Validated tracked manifest. */
+export type ProjectHooksManifest = z.infer<typeof ProjectHooksManifestSchema>;
+/** Exact ref update supplied by Git pre-push, including zero object IDs. */
+export interface HookRefUpdate {
+    /** Local ref name or deletion marker. */
+    localRef: string;
+    /** Exact local object ID. */
+    localOid: string;
+    /** Remote ref name. */
+    remoteRef: string;
+    /** Previous remote object ID. */
+    remoteOid: string;
+}
+/** Native input normalized by the adapter; no harness environment is required. */
+export interface HookInvocation {
+    /** Protocol version. */
+    schemaVersion: 1;
+    /** Active checkout root, independently resolved through Git. */
+    projectRoot: string;
+    /** Git common directory, for attribution across linked checkouts. */
+    gitCommonDir: string;
+    /** Triggering adapter. */
+    source: HookSource;
+    /** Canonical event name. */
+    event: string;
+    /** Optional remote name and URL/path as Git supplies them. */
+    remote?: {
+        name: string;
+        location: string;
+    };
+    /** All pushed ref updates in original order. */
+    refs?: HookRefUpdate[];
+    /** Agent tool input, passed only to the checker and never persisted. */
+    toolInput?: HookJsonValue;
+    /** Optional worktree lifecycle identity. */
+    worktree?: {
+        taskId: string;
+        path: string;
+    };
+}
+/** Structured checker verdict written as one JSON object on stdout. */
+export declare const ProjectHookVerdictSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        pass: "pass";
+        warn: "warn";
+        skip: "skip";
+        block: "block";
+        "checker-error": "checker-error";
+    }>;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/** Project checker's portable stdout contract. */
+export type ProjectHookVerdict = z.infer<typeof ProjectHookVerdictSchema>;
+/** Distinct executor result classes. */
+export type HookOutcomeStatus = ProjectHookVerdict['status'] | 'timeout' | 'infrastructure-error';
+/** Sanitized result: arbitrary child output and inputs are deliberately absent. */
+export interface HookOutcome {
+    /** Project check ID, or CLEO infrastructure attribution. */
+    id: string;
+    /** Observed classification. */
+    status: HookOutcomeStatus;
+    /** Whether this adapter must prevent the operation. */
+    blocks: boolean;
+    /** Safe executor diagnostic code; child messages are not retained. */
+    code: string;
+    /** Project diagnostic for the current caller only; excluded from stored receipts. */
+    message?: string;
+    /** Child exit code; null when no normal exit occurred. */
+    exitCode: number | null;
+    /** Terminating signal, when present. */
+    signal: string | null;
+    /** Elapsed execution time in milliseconds. */
+    durationMs: number;
+}
+/** Dependency-injection port; worktree consumes this without importing core. */
+export interface HookExecutor {
+    /** Execute all matching activated definitions in manifest order. */
+    execute(invocation: HookInvocation): Promise<HookOutcome[]>;
+}
+/** Content hashes approved explicitly on this machine. */
+export declare const HookActivationSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectRoot: z.ZodString;
+    projectIdentity: z.ZodString;
+    manifestHash: z.ZodString;
+    files: z.ZodRecord<z.ZodString, z.ZodString>;
+    executables: z.ZodRecord<z.ZodString, z.ZodString>;
+    activatedAt: z.ZodString;
+}, z.core.$strict>;
+/** Activation record is local, excluded from Git and never replicated. */
+export type HookActivation = z.infer<typeof HookActivationSchema>;
+/** Local feature state; activation never confers native harness trust. */
+export declare const ProjectHooksLocalStateSchema: z.ZodObject<{
+    hooks: z.ZodObject<{
+        project: z.ZodObject<{
+            enabled: z.ZodBoolean;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    activation: z.ZodOptional<z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        projectRoot: z.ZodString;
+        projectIdentity: z.ZodString;
+        manifestHash: z.ZodString;
+        files: z.ZodRecord<z.ZodString, z.ZodString>;
+        executables: z.ZodRecord<z.ZodString, z.ZodString>;
+        activatedAt: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+/** Local activation settings stored independently of tracked project configuration. */
+export type ProjectHooksLocalState = z.infer<typeof ProjectHooksLocalStateSchema>;
+/** Bounded last execution metadata; contains no input or arbitrary output. */
+export interface HookExecutionReceipt {
+    /** Receipt format version. */
+    schemaVersion: 1;
+    /** Activated source digest. */
+    manifestHash: string;
+    /** Invocation origin. */
+    source: HookSource;
+    /** Event without payload. */
+    event: string;
+    /** Completion timestamp. */
+    recordedAt: string;
+    /** Sanitized outcomes. */
+    outcomes: HookOutcome[];
+}
+/** Validator for sanitized execution records, rejecting unexpected payload fields. */
+export declare const HookExecutionReceiptSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    manifestHash: z.ZodString;
+    source: z.ZodEnum<{
+        direct: "direct";
+        ci: "ci";
+        worktree: "worktree";
+        agent: "agent";
+        git: "git";
+    }>;
+    event: z.ZodString;
+    recordedAt: z.ZodString;
+    outcomes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodEnum<{
+            pass: "pass";
+            warn: "warn";
+            skip: "skip";
+            block: "block";
+            timeout: "timeout";
+            "checker-error": "checker-error";
+            "infrastructure-error": "infrastructure-error";
+        }>;
+        blocks: z.ZodBoolean;
+        code: z.ZodString;
+        exitCode: z.ZodNullable<z.ZodNumber>;
+        signal: z.ZodNullable<z.ZodString>;
+        durationMs: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+/** Checkout identity and machine-local receipt paths resolved by Git. */
+export interface ProjectHookContext {
+    /** Active checkout root. */
+    projectRoot: string;
+    /** Common Git directory. */
+    gitCommonDir: string;
+    /** Effective Git hook directory. */
+    hooksDir: string;
+    /** Per-checkout Git-private CLEO state directory. */
+    stateDir: string;
+}
+/** Resolved handler attribution without executing project code. */
+export interface ProjectHookResolution {
+    /** Project-owned definition identity. */
+    id: string;
+    /** Declared policy owner, separate from installer provenance. */
+    owner: 'project';
+    /** Manifest source path. */
+    sourceDefinition: string;
+    /** Whether Git currently tracks the manifest. */
+    sourceTracked: boolean;
+    /** Canonical handler path when it can be resolved safely. */
+    handlerPath?: string;
+    /** Canonical executable path when available. */
+    executablePath?: string;
+    /** Bounded diagnostic codes; contains no environment values. */
+    diagnostics: string[];
+}
+/** Read-only activation and ownership diagnostic. */
+export interface ProjectHookInspection {
+    /** Git-resolved paths. */
+    context: ProjectHookContext;
+    /** Validated source definitions. */
+    manifest: ProjectHooksManifest;
+    /** Definition attribution and resolved executable paths. */
+    resolvedHooks: ProjectHookResolution[];
+    /** Machine-local opt-in flag. */
+    enabled: boolean;
+    /** Activation is absent, fresh or drifted; `unreleased` while this build has not released hooks-v1 (T13557), whatever the receipt says. */
+    activation: 'disabled' | 'missing' | 'active' | 'drifted' | 'unreleased';
+    /** Safe assessment codes. */
+    diagnostics: string[];
+    /** Native harness trust cannot be inferred from files on disk. */
+    nativeTrust: 'unverified';
+    /** Native project trust is independent of CLEO activation. */
+    nativeProjectTrust: 'unverified';
+    /** Exact native hook-definition trust is independent of project trust. */
+    nativeHookTrust: 'unverified';
+    /** Last bounded execution record when valid. */
+    lastExecution?: HookExecutionReceipt;
+}
+//# sourceMappingURL=project-hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project-hooks.d.ts","sourceRoot":"","sources":["../src/project-hooks.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB;;;;;;EAAuD,CAAC;AACrF,gCAAgC;AAChC,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,2EAA2E;AAC3E,eAAO,MAAM,qBAAqB,aAW/B,CAAC;AACJ,gFAAgF;AAChF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;kBAkB7B,CAAC;AACZ,uFAAuF;AACvF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,2EAA2E;AAC3E,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;kBAoBnC,CAAC;AACL,kCAAkC;AAClC,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,4EAA4E;AAC5E,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AACD,kFAAkF;AAClF,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,aAAa,EAAE,CAAC,CAAC;IACjB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,YAAY,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,MAAM,EAAE,UAAU,CAAC;IACnB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,gDAAgD;IAChD,IAAI,CAAC,EAAE,aAAa,EAAE,CAAC;IACvB,wEAAwE;IACxE,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C;AACD,uEAAuE;AACvE,eAAO,MAAM,wBAAwB;;;;;;;;;kBAK1B,CAAC;AACZ,kDAAkD;AAClD,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,wCAAwC;AACxC,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,QAAQ,CAAC,GAAG,SAAS,GAAG,sBAAsB,CAAC;AAClG,mFAAmF;AACnF,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,+BAA+B;IAC/B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,uDAAuD;IACvD,MAAM,EAAE,OAAO,CAAC;IAChB,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,wCAAwC;IACxC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;CACpB;AACD,gFAAgF;AAChF,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,OAAO,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CAC7D;AACD,0DAA0D;AAC1D,eAAO,MAAM,oBAAoB;;;;;;;;kBAUtB,CAAC;AACZ,0EAA0E;AAC1E,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,0EAA0E;AAC1E,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;kBAK9B,CAAC;AACZ,uFAAuF;AACvF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,8EAA8E;AAC9E,MAAM,WAAW,oBAAoB;IACnC,8BAA8B;IAC9B,aAAa,EAAE,CAAC,CAAC;IACjB,+BAA+B;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AACD,sFAAsF;AACtF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA+B5B,CAAC;AACZ,yEAAyE;AACzE,MAAM,WAAW,kBAAkB;IACjC,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;CAClB;AACD,mEAAmE;AACnE,MAAM,WAAW,qBAAqB;IACpC,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,iEAAiE;IACjE,KAAK,EAAE,SAAS,CAAC;IACjB,4BAA4B;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,aAAa,EAAE,OAAO,CAAC;IACvB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AACD,qDAAqD;AACrD,MAAM,WAAW,qBAAqB;IACpC,0BAA0B;IAC1B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,oCAAoC;IACpC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,4DAA4D;IAC5D,aAAa,EAAE,qBAAqB,EAAE,CAAC;IACvC,iCAAiC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,2IAA2I;IAC3I,UAAU,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,CAAC;IACzE,6BAA6B;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,kEAAkE;IAClE,WAAW,EAAE,YAAY,CAAC;IAC1B,8DAA8D;IAC9D,kBAAkB,EAAE,YAAY,CAAC;IACjC,0EAA0E;IAC1E,eAAe,EAAE,YAAY,CAAC;IAC9B,gDAAgD;IAChD,aAAa,CAAC,EAAE,oBAAoB,CAAC;CACtC"}