@cleocode/contracts 2026.5.96 → 2026.5.98

package/dist/provenance.d.ts

@@ -0,0 +1,257 @@
+/**
+ * Provenance graph union types.
+ *
+ * Canonical home for the 16 string-literal union types that describe edges
+ * and FSM states in the CLEO provenance graph (commits, pull requests,
+ * releases, release artifacts, and BRAIN↔release links). Promoted from
+ * `packages/core/src/store/tasks-schema.ts` in Phase 0c of the
+ * SG-ARCH-SOLID Saga so that downstream packages can import these unions
+ * without pulling in the Drizzle schema runtime.
+ *
+ * The const arrays that back each union (`PR_STATES`, `COMMIT_LINK_KINDS`,
+ * `RELEASE_STATUSES`, …) remain in `tasks-schema.ts` because Drizzle's
+ * `text({ enum: ... })` column declaration narrows the runtime row type
+ * directly from those `as const` literals. `tasks-schema.ts` re-exports
+ * each union from this module to preserve the existing public surface for
+ * every `import * as schema from '../store/tasks-schema.js'` consumer.
+ *
+ * @see SPEC-T9345 §3 — provenance graph table definitions
+ * @see ADR-073 — task hierarchy charter (release provenance scope)
+ *
+ * Consolidated unions:
+ *   - {@link PrState}                   — pull-request lifecycle state
+ *   - {@link PrLinkSource}              — how a PR↔task link was discovered
+ *   - {@link PrLinkKind}                — semantic PR↔task relationship
+ *   - {@link CommitConventionalType}    — Conventional Commits prefix
+ *   - {@link CommitLinkKind}            — semantic commit↔task relationship
+ *   - {@link CommitLinkSource}          — how a commit↔task link was discovered
+ *   - {@link CommitFileChangeType}      — git status letter (A/M/D/R/C)
+ *   - {@link ReleaseScheme}             — versioning scheme
+ *   - {@link ReleaseChannel}            — npm dist-tag channel
+ *   - {@link ReleaseKind}               — release packaging type
+ *   - {@link ReleaseStatus}             — unified release FSM state
+ *   - {@link ReleaseChangeType}         — 12-value change taxonomy
+ *   - {@link ReleaseImpact}             — semver impact level
+ *   - {@link ReleaseClassifiedBy}       — change-classification provenance
+ *   - {@link ReleaseArtifactType}       — artifact archetype
+ *   - {@link BrainReleaseLinkType}      — BRAIN↔release link semantics
+ *
+ * @since SG-ARCH-SOLID Saga T9831 · E-CONTRACTS-FOUNDATION T9832 · T9955 (Phase 0c)
+ */
+/**
+ * State of a pull request.
+ *
+ * Mirrors the GitHub PR state machine:
+ *   - `open`   — PR is open and not yet merged
+ *   - `closed` — PR was closed without merging
+ *   - `merged` — PR was merged into the target branch
+ *
+ * @task T9507
+ */
+export type PrState = 'open' | 'closed' | 'merged';
+/**
+ * How a PR↔task link was discovered.
+ *
+ *   - `pr-title`       — task ID matched in the PR title
+ *   - `pr-body`        — task ID matched in the PR body markdown
+ *   - `branch-name`    — parsed from the branch name (e.g. `feat/T9507-...`)
+ *   - `commit-trailer` — extracted from a git trailer in a PR commit
+ *   - `manual`         — explicitly linked via `cleo provenance link`
+ *
+ * @task T9507
+ */
+export type PrLinkSource = 'pr-title' | 'pr-body' | 'branch-name' | 'commit-trailer' | 'manual';
+/**
+ * Semantic classification of a PR↔task relationship.
+ *
+ * Extends {@link CommitLinkKind} with `'tracks'` for PRs that observe a
+ * task without directly implementing, fixing, or documenting it.
+ *
+ *   - `implements` — the PR directly implements the task's acceptance criteria
+ *   - `fixes`      — the PR fixes a bug or regression in the task's work
+ *   - `refactors`  — the PR restructures code introduced by the task
+ *   - `tests`      — the PR adds or updates tests for the task
+ *   - `docs`       — the PR updates documentation for the task
+ *   - `reverts`    — the PR reverts work introduced by the task
+ *   - `tracks`     — the PR is related to but does not directly implement the task
+ *
+ * @task T9507
+ */
+export type PrLinkKind = 'implements' | 'fixes' | 'refactors' | 'tests' | 'docs' | 'reverts' | 'tracks';
+/**
+ * Conventional Commits prefix parsed from a commit subject.
+ *
+ * Adds `'breaking'` to the canonical CC set to flag BREAKING CHANGE
+ * footers. The DB column is nullable — a commit that does not follow
+ * Conventional Commits format stores NULL rather than one of these values.
+ *
+ * @task T9506
+ */
+export type CommitConventionalType = 'feat' | 'fix' | 'chore' | 'docs' | 'refactor' | 'test' | 'build' | 'ci' | 'perf' | 'revert' | 'breaking';
+/**
+ * Semantic classification of a commit↔task relationship.
+ *
+ *   - `implements` — the commit directly implements the task's acceptance criteria
+ *   - `fixes`      — the commit fixes a bug or regression in the task's work
+ *   - `refactors`  — the commit restructures code introduced by the task
+ *   - `tests`      — the commit adds or updates tests for the task
+ *   - `docs`       — the commit updates documentation for the task
+ *   - `reverts`    — the commit reverts work introduced by the task
+ *
+ * @task T9506
+ */
+export type CommitLinkKind = 'implements' | 'fixes' | 'refactors' | 'tests' | 'docs' | 'reverts';
+/**
+ * How a commit↔task link was discovered.
+ *
+ *   - `commit-trailer` — extracted from a `T####:` or `Task-Id:` git trailer
+ *   - `commit-subject` — matched `T####` regex in the commit subject line
+ *   - `pr-title`       — matched task ID in the PR title
+ *   - `pr-body`        — matched task ID in the PR body markdown
+ *   - `branch-name`    — parsed from the branch name (e.g., `feat/T9506-...`)
+ *   - `manual`         — explicitly linked via `cleo provenance link`
+ *
+ * @task T9506
+ */
+export type CommitLinkSource = 'commit-trailer' | 'commit-subject' | 'pr-title' | 'pr-body' | 'branch-name' | 'manual';
+/**
+ * Per-file change type from a git diff (status letter codes).
+ *
+ *   - `A` — added
+ *   - `M` — modified
+ *   - `D` — deleted
+ *   - `R` — renamed
+ *   - `C` — copied
+ *
+ * @task T9506
+ */
+export type CommitFileChangeType = 'A' | 'M' | 'D' | 'R' | 'C';
+/**
+ * Versioning scheme for a release.
+ *
+ *   - `calver`        — YYYY.MM.patch (e.g. 2026.5.74) — CLEO default
+ *   - `semver`        — MAJOR.MINOR.PATCH (e.g. 1.2.3)
+ *   - `calver-suffix` — YYYY.MM.patch.N suffix hotfix (e.g. 2026.5.74.2)
+ *
+ * @task T9508
+ * @remarks
+ * The values here MUST stay aligned with `RELEASE_SCHEMES` in
+ * `tasks-schema.ts`; that const array drives the Drizzle row type. A
+ * compile-time structural assertion in
+ * `packages/contracts/src/__tests__/provenance.test.ts` pins both sides.
+ */
+export type ReleaseScheme = 'calver' | 'semver' | 'calver-suffix';
+/**
+ * Release channel — controls which npm dist-tag (or equivalent) the
+ * artifact is published under.
+ *
+ *   - `latest` — current stable
+ *   - `beta`   — pre-release tested in production-adjacent environments
+ *   - `dev`    — internal development snapshots
+ *   - `hotfix` — emergency patch outside the regular cadence
+ *
+ * @task T9508
+ * @remarks
+ * Distinct from the `ReleaseChannel` exported by
+ * `@cleocode/contracts/release/channel` (which carries the npm-level
+ * `latest|beta|alpha` set) and from the `ReleaseChannel` in
+ * `@cleocode/contracts/release/plan` (which carries the release-plan
+ * `latest|beta|alpha|rc` set). Top-level `@cleocode/contracts` re-exports
+ * this union under a disambiguating alias.
+ */
+export type ReleaseChannel = 'latest' | 'beta' | 'dev' | 'hotfix';
+/**
+ * Release packaging kind, orthogonal to individual change types within
+ * the release.
+ *
+ *   - `regular`    — standard scheduled release
+ *   - `hotfix`     — emergency patch outside regular cadence
+ *   - `prerelease` — alpha/beta/rc release for early adopters
+ *
+ * @task T9508
+ */
+export type ReleaseKind = 'regular' | 'hotfix' | 'prerelease';
+/**
+ * Unified release FSM state (admits values from BOTH the new T9492
+ * pipeline and the legacy T5580 pipeline; the status value itself
+ * discriminates which pipeline owns the row).
+ *
+ * **New T9492 pipeline** — SPEC-T9345 §10.1 FSM:
+ *   `planned → pr-opened → pr-merged → published → reconciled`
+ *
+ * **Legacy T5580 pipeline** — pre-T9492 12-step flow:
+ *   `prepared → committed → tagged → pushed`
+ *
+ * **Shared terminal states**:
+ *   `rolled_back | failed | cancelled`
+ *
+ * State transitions per R-302 MUST be monotonic within each lifecycle;
+ * illegal transitions return `E_INVALID_STATE` and MUST NOT mutate any row.
+ *
+ * @task T9508
+ * @task T9686 (unification — legacy + new statuses on one column)
+ * @see SPEC-T9345 §10.1
+ */
+export type ReleaseStatus = 'planned' | 'pr-opened' | 'pr-merged' | 'published' | 'reconciled' | 'prepared' | 'committed' | 'tagged' | 'pushed' | 'rolled_back' | 'failed' | 'cancelled';
+/**
+ * 12-value CLEO release change taxonomy (Option B from
+ * provenance-graph-design.md §2.2).
+ *
+ * Lives at the release-changes level (not on `tasks.kind`) so that:
+ *   - A single task can produce multiple change rows across releases.
+ *   - Hotfix classification is a release-packaging decision, not a task property.
+ *   - Auto-classification is agent-writable without touching OWNER-WRITE-ONLY fields.
+ *
+ * @task T9508
+ * @see SPEC-T9345 §2.2
+ */
+export type ReleaseChangeType = 'feature' | 'enhancement' | 'bug' | 'hotfix' | 'security' | 'breaking' | 'refactor' | 'docs' | 'chore' | 'revert' | 'deprecation' | 'infrastructure';
+/**
+ * Impact level for a release change, mapped to semver bump assessment.
+ *
+ *   - `major` — breaking change (MAJOR bump)
+ *   - `minor` — new feature (MINOR bump)
+ *   - `patch` — bug fix / chore (PATCH bump)
+ *   - `none`  — cosmetic / docs / trivial (no version bump warranted alone)
+ *
+ * @task T9508
+ */
+export type ReleaseImpact = 'major' | 'minor' | 'patch' | 'none';
+/**
+ * Provenance of a release-change classification.
+ *
+ *   - `auto`     — derived by the classification engine from CC prefix + heuristics
+ *   - `manual`   — owner overrode the auto classification via `cleo release classify`
+ *   - `approved` — owner approved an agent-proposed classification
+ *
+ * @task T9508
+ */
+export type ReleaseClassifiedBy = 'auto' | 'manual' | 'approved';
+/**
+ * Release artifact archetype.
+ *
+ *   - `npm`            — npm package published to a registry
+ *   - `cargo`          — Rust crate published to crates.io
+ *   - `docker`         — Container image pushed to an OCI registry
+ *   - `pypi`           — Python package published to pypi.org
+ *   - `github-release` — GitHub Releases asset attached to a git tag
+ *   - `binary`         — Generic compiled binary distributed via direct URL
+ *   - `github-tag`     — Lightweight git tag (no attached assets)
+ *
+ * @task T9509
+ * @see SPEC-T9345 §3.9
+ */
+export type ReleaseArtifactType = 'npm' | 'cargo' | 'docker' | 'pypi' | 'github-release' | 'binary' | 'github-tag';
+/**
+ * Semantic relationship between a BRAIN entry and a release.
+ *
+ *   - `approved-by`    — A BRAIN decision approved a change that shipped in this release.
+ *   - `documented-in`  — This release is where the BRAIN entry was first formally documented.
+ *   - `derived-from`   — The release's failure or outcome produced this BRAIN learning/pattern.
+ *   - `observed-in`    — A BRAIN observation was made about this release (e.g. performance note).
+ *
+ * @task T9509
+ * @see SPEC-T9345 §8.1
+ */
+export type BrainReleaseLinkType = 'approved-by' | 'documented-in' | 'derived-from' | 'observed-in';
+//# sourceMappingURL=provenance.d.ts.map

package/dist/provenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.d.ts","sourceRoot":"","sources":["../src/provenance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAIH;;;;;;;;;GASG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEnD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,gBAAgB,GAAG,QAAQ,CAAC;AAEhG;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,UAAU,GAClB,YAAY,GACZ,OAAO,GACP,WAAW,GACX,OAAO,GACP,MAAM,GACN,SAAS,GACT,QAAQ,CAAC;AAIb;;;;;;;;GAQG;AACH,MAAM,MAAM,sBAAsB,GAC9B,MAAM,GACN,KAAK,GACL,OAAO,GACP,MAAM,GACN,UAAU,GACV,MAAM,GACN,OAAO,GACP,IAAI,GACJ,MAAM,GACN,QAAQ,GACR,UAAU,CAAC;AAEf;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAEjG;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,gBAAgB,GACxB,gBAAgB,GAChB,gBAAgB,GAChB,UAAU,GACV,SAAS,GACT,aAAa,GACb,QAAQ,CAAC;AAEb;;;;;;;;;;GAUG;AACH,MAAM,MAAM,oBAAoB,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAI/D;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,eAAe,CAAC;AAElE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAElE;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,WAAW,GACX,WAAW,GACX,WAAW,GACX,YAAY,GACZ,UAAU,GACV,WAAW,GACX,QAAQ,GACR,QAAQ,GACR,aAAa,GACb,QAAQ,GACR,WAAW,CAAC;AAEhB;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,aAAa,GACb,KAAK,GACL,QAAQ,GACR,UAAU,GACV,UAAU,GACV,UAAU,GACV,MAAM,GACN,OAAO,GACP,QAAQ,GACR,aAAa,GACb,gBAAgB,CAAC;AAErB;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAEjE;;;;;;;;GAQG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;AAIjE;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,mBAAmB,GAC3B,KAAK,GACL,OAAO,GACP,QAAQ,GACR,MAAM,GACN,gBAAgB,GAChB,QAAQ,GACR,YAAY,CAAC;AAEjB;;;;;;;;;;GAUG;AACH,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG,eAAe,GAAG,cAAc,GAAG,aAAa,CAAC"}

package/dist/provenance.js

@@ -0,0 +1,42 @@
+/**
+ * Provenance graph union types.
+ *
+ * Canonical home for the 16 string-literal union types that describe edges
+ * and FSM states in the CLEO provenance graph (commits, pull requests,
+ * releases, release artifacts, and BRAIN↔release links). Promoted from
+ * `packages/core/src/store/tasks-schema.ts` in Phase 0c of the
+ * SG-ARCH-SOLID Saga so that downstream packages can import these unions
+ * without pulling in the Drizzle schema runtime.
+ *
+ * The const arrays that back each union (`PR_STATES`, `COMMIT_LINK_KINDS`,
+ * `RELEASE_STATUSES`, …) remain in `tasks-schema.ts` because Drizzle's
+ * `text({ enum: ... })` column declaration narrows the runtime row type
+ * directly from those `as const` literals. `tasks-schema.ts` re-exports
+ * each union from this module to preserve the existing public surface for
+ * every `import * as schema from '../store/tasks-schema.js'` consumer.
+ *
+ * @see SPEC-T9345 §3 — provenance graph table definitions
+ * @see ADR-073 — task hierarchy charter (release provenance scope)
+ *
+ * Consolidated unions:
+ *   - {@link PrState}                   — pull-request lifecycle state
+ *   - {@link PrLinkSource}              — how a PR↔task link was discovered
+ *   - {@link PrLinkKind}                — semantic PR↔task relationship
+ *   - {@link CommitConventionalType}    — Conventional Commits prefix
+ *   - {@link CommitLinkKind}            — semantic commit↔task relationship
+ *   - {@link CommitLinkSource}          — how a commit↔task link was discovered
+ *   - {@link CommitFileChangeType}      — git status letter (A/M/D/R/C)
+ *   - {@link ReleaseScheme}             — versioning scheme
+ *   - {@link ReleaseChannel}            — npm dist-tag channel
+ *   - {@link ReleaseKind}               — release packaging type
+ *   - {@link ReleaseStatus}             — unified release FSM state
+ *   - {@link ReleaseChangeType}         — 12-value change taxonomy
+ *   - {@link ReleaseImpact}             — semver impact level
+ *   - {@link ReleaseClassifiedBy}       — change-classification provenance
+ *   - {@link ReleaseArtifactType}       — artifact archetype
+ *   - {@link BrainReleaseLinkType}      — BRAIN↔release link semantics
+ *
+ * @since SG-ARCH-SOLID Saga T9831 · E-CONTRACTS-FOUNDATION T9832 · T9955 (Phase 0c)
+ */
+export {};
+//# sourceMappingURL=provenance.js.map

package/dist/provenance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.js","sourceRoot":"","sources":["../src/provenance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG"}

package/dist/release/plan.d.ts

@@ -110,8 +110,8 @@ export declare const ReleaseSchemeSchema: z.ZodEnum<{
 }>;
 /** Zod schema for {@link RELEASE_KIND}. */
 export declare const ReleaseKindSchema: z.ZodEnum<{
-    regular: "regular";
     hotfix: "hotfix";
+    regular: "regular";
     prerelease: "prerelease";
 }>;
 /** Zod schema for {@link RELEASE_STATUS}. */
@@ -119,10 +119,10 @@ export declare const ReleaseStatusSchema: z.ZodEnum<{
     failed: "failed";
     cancelled: "cancelled";
     planned: "planned";
+    reconciled: "reconciled";
     "pr-opened": "pr-opened";
     "pr-merged": "pr-merged";
     published: "published";
-    reconciled: "reconciled";
     rolled_back: "rolled_back";
 }>;
 /** Zod schema for {@link GATE_STATUS}. */
@@ -169,8 +169,8 @@ export declare const TaskKindSchema: z.ZodEnum<{
     refactor: "refactor";
     chore: "chore";
     breaking: "breaking";
-    hotfix: "hotfix";
     revert: "revert";
+    hotfix: "hotfix";
 }>;
 /** Zod schema for {@link IMPACT}. */
 export declare const ImpactSchema: z.ZodEnum<{
@@ -207,8 +207,8 @@ export declare const ReleasePlanTaskSchema: z.ZodObject<{
         refactor: "refactor";
         chore: "chore";
         breaking: "breaking";
-        hotfix: "hotfix";
         revert: "revert";
+        hotfix: "hotfix";
     }>;
     impact: z.ZodEnum<{
         major: "major";
@@ -352,8 +352,8 @@ export declare const ReleasePlanSchema: z.ZodObject<{
     }>;
     epicId: z.ZodString;
     releaseKind: z.ZodEnum<{
-        regular: "regular";
         hotfix: "hotfix";
+        regular: "regular";
         prerelease: "prerelease";
     }>;
     createdAt: z.ZodISODateTime;
@@ -372,8 +372,8 @@ export declare const ReleasePlanSchema: z.ZodObject<{
             refactor: "refactor";
             chore: "chore";
             breaking: "breaking";
-            hotfix: "hotfix";
             revert: "revert";
+            hotfix: "hotfix";
         }>;
         impact: z.ZodEnum<{
             major: "major";
@@ -449,10 +449,10 @@ export declare const ReleasePlanSchema: z.ZodObject<{
         failed: "failed";
         cancelled: "cancelled";
         planned: "planned";
+        reconciled: "reconciled";
         "pr-opened": "pr-opened";
         "pr-merged": "pr-merged";
         published: "published";
-        reconciled: "reconciled";
         rolled_back: "rolled_back";
     }>;
     meta: z.ZodOptional<z.ZodObject<{

package/dist/scaffold-diagnostics.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Scaffold + diagnostic result contracts.
+ *
+ * Canonical home for the result shapes produced by CLEO's directory/file
+ * scaffolding utilities (`ensure*`) and read-only health-check utilities
+ * (`check*`). Promoted to `@cleocode/contracts` in Phase 0a of the
+ * SG-ARCH-SOLID Saga to eliminate duplicate definitions that previously
+ * lived in `packages/core/src/scaffold.ts`, `injection.ts`, `hooks.ts`,
+ * `schema-management.ts`, and `validation/doctor/checks.ts`.
+ *
+ * Consolidated types:
+ *   - {@link ScaffoldResult} — was defined 3× in core (scaffold/injection/hooks)
+ *   - {@link CheckStatus}   — was defined 2× in core (scaffold/doctor checks)
+ *   - {@link CheckResult}   — was defined 2× in core (scaffold/doctor checks)
+ *   - {@link HookCheckResult} — single canonical definition (no prior duplication;
+ *     promoted here to keep all scaffold-diagnostic shapes co-located)
+ *
+ * NOT consolidated (intentional — different domain shape):
+ *   - `CheckResult` in `packages/core/src/schema-management.ts` is a
+ *     `{ ok, installed, bundled, missing, stale }` schema-install report,
+ *     unrelated to diagnostic checks. It retains its local definition and
+ *     will be renamed in a follow-up slice if/when its naming collision
+ *     warrants a separate cleanup task.
+ *
+ * @since SG-ARCH-SOLID Saga T9831 · E-CONTRACTS-FOUNDATION T9832 (Phase 0a)
+ */
+/**
+ * Result of an `ensure*` scaffolding operation.
+ *
+ * All ensure functions in `@cleocode/core` are idempotent — they may
+ * create, repair, or skip the requested resource and report which
+ * action they took.
+ *
+ * Originally defined in:
+ *   - `packages/core/src/scaffold.ts`
+ *   - `packages/core/src/injection.ts`
+ *   - `packages/core/src/hooks.ts`
+ *
+ * @since SG-ARCH-SOLID Saga T9831 · E-CONTRACTS-FOUNDATION T9832 (Phase 0a)
+ */
+export interface ScaffoldResult {
+    /** What action was taken: created, repaired, or skipped. */
+    action: 'created' | 'repaired' | 'skipped';
+    /** Filesystem path that was operated on. */
+    path: string;
+    /** Human-readable explanation of the result. */
+    details?: string;
+}
+/**
+ * Status of a `check*` diagnostic.
+ *
+ * Originally defined in:
+ *   - `packages/core/src/scaffold.ts`
+ *   - `packages/core/src/validation/doctor/checks.ts`
+ *
+ * @since SG-ARCH-SOLID Saga T9831 · E-CONTRACTS-FOUNDATION T9832 (Phase 0a)
+ */
+export type CheckStatus = 'passed' | 'failed' | 'warning' | 'info';
+/**
+ * Result of a `check*` diagnostic (used by `cleo doctor` and scaffold
+ * health checks).
+ *
+ * Originally defined in:
+ *   - `packages/core/src/scaffold.ts`
+ *   - `packages/core/src/validation/doctor/checks.ts`
+ *
+ * The scaffold.ts and doctor/checks.ts definitions were structurally
+ * identical; this is the consolidated shape with TSDoc preserved.
+ *
+ * @since SG-ARCH-SOLID Saga T9831 · E-CONTRACTS-FOUNDATION T9832 (Phase 0a)
+ */
+export interface CheckResult {
+    /** Unique check identifier (e.g. "cleo_structure", "sqlite_db"). */
+    id: string;
+    /** Category grouping (e.g. "scaffold", "global"). */
+    category: string;
+    /** Diagnostic outcome: passed, failed, warning, or info. */
+    status: CheckStatus;
+    /** Human-readable description of the check result. */
+    message: string;
+    /** Structured metadata about the check (paths, sizes, missing items). */
+    details: Record<string, unknown>;
+    /** Suggested CLI command to fix the issue, or null if passed. */
+    fix: string | null;
+}
+/**
+ * Result of a git-hook installation check.
+ *
+ * Reports whether a managed hook (commit-msg, pre-commit, pre-push) is
+ * installed in `.git/hooks/` and whether the installed copy matches the
+ * source template under `packages/core/templates/git-hooks/`.
+ *
+ * Originally defined in `packages/core/src/hooks.ts`. Promoted here to
+ * co-locate all scaffold-diagnostic shapes.
+ *
+ * @since SG-ARCH-SOLID Saga T9831 · E-CONTRACTS-FOUNDATION T9832 (Phase 0a)
+ */
+export interface HookCheckResult {
+    /** Hook name (commit-msg, pre-commit, pre-push). */
+    hook: string;
+    /** Whether the hook is installed at `.git/hooks/<hook>`. */
+    installed: boolean;
+    /** Whether the installed hook bytes match the source template. */
+    current: boolean;
+    /** Absolute path of the source template that should be installed. */
+    sourcePath: string;
+    /** Absolute path where the hook is (or would be) installed. */
+    installedPath: string;
+}
+//# sourceMappingURL=scaffold-diagnostics.d.ts.map

package/dist/scaffold-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold-diagnostics.d.ts","sourceRoot":"","sources":["../src/scaffold-diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;IAC3C,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAEnE;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAC;IACX,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,MAAM,EAAE,WAAW,CAAC;IACpB,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,iEAAiE;IACjE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAID;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,SAAS,EAAE,OAAO,CAAC;IACnB,kEAAkE;IAClE,OAAO,EAAE,OAAO,CAAC;IACjB,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,aAAa,EAAE,MAAM,CAAC;CACvB"}

package/dist/scaffold-diagnostics.js

@@ -0,0 +1,28 @@
+/**
+ * Scaffold + diagnostic result contracts.
+ *
+ * Canonical home for the result shapes produced by CLEO's directory/file
+ * scaffolding utilities (`ensure*`) and read-only health-check utilities
+ * (`check*`). Promoted to `@cleocode/contracts` in Phase 0a of the
+ * SG-ARCH-SOLID Saga to eliminate duplicate definitions that previously
+ * lived in `packages/core/src/scaffold.ts`, `injection.ts`, `hooks.ts`,
+ * `schema-management.ts`, and `validation/doctor/checks.ts`.
+ *
+ * Consolidated types:
+ *   - {@link ScaffoldResult} — was defined 3× in core (scaffold/injection/hooks)
+ *   - {@link CheckStatus}   — was defined 2× in core (scaffold/doctor checks)
+ *   - {@link CheckResult}   — was defined 2× in core (scaffold/doctor checks)
+ *   - {@link HookCheckResult} — single canonical definition (no prior duplication;
+ *     promoted here to keep all scaffold-diagnostic shapes co-located)
+ *
+ * NOT consolidated (intentional — different domain shape):
+ *   - `CheckResult` in `packages/core/src/schema-management.ts` is a
+ *     `{ ok, installed, bundled, missing, stale }` schema-install report,
+ *     unrelated to diagnostic checks. It retains its local definition and
+ *     will be renamed in a follow-up slice if/when its naming collision
+ *     warrants a separate cleanup task.
+ *
+ * @since SG-ARCH-SOLID Saga T9831 · E-CONTRACTS-FOUNDATION T9832 (Phase 0a)
+ */
+export {};
+//# sourceMappingURL=scaffold-diagnostics.js.map

package/dist/scaffold-diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold-diagnostics.js","sourceRoot":"","sources":["../src/scaffold-diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG"}

package/dist/session.d.ts

@@ -131,6 +131,43 @@ export interface Session {
     gradeMode?: boolean;
     /** ID of the provider adapter used for this session. @defaultValue undefined */
     providerId?: string | null;
+    /**
+     * Human-readable agent handle for multi-agent isolation (T9975).
+     *
+     * Set via `cleo session start --agent <handle>`. Allows concurrent agent
+     * sessions to be distinguished in `cleo session list --all` and enables
+     * `cleo briefing` env-precedence detection when `CLEO_SESSION_ID` is set.
+     *
+     * @defaultValue undefined
+     */
+    agentHandle?: string | null;
+    /**
+     * Denormalised scope type ("global" | "epic") for fast index queries (T9975).
+     *
+     * Derived from `scope.type` at session creation; cached in the DB column
+     * `scope_kind` to avoid JSON parsing in hot paths.
+     *
+     * @defaultValue undefined
+     */
+    scopeKind?: string | null;
+    /**
+     * Denormalised scope target ID (e.g. "T9964") for epic sessions (T9975).
+     *
+     * Derived from `scope.epicId` / `scope.rootTaskId` at session creation.
+     * NULL for global sessions.
+     *
+     * @defaultValue undefined
+     */
+    scopeId?: string | null;
+    /**
+     * ISO 8601 timestamp of the last mutation on this session (T9975).
+     *
+     * Updated on session start, task focus change, and task completion.
+     * Used by the idle auto-end lifecycle hook and `cleo session list --all`.
+     *
+     * @defaultValue undefined
+     */
+    lastActivity?: string | null;
 }
 /**
  * Result of a session start operation.

package/dist/session.d.ts.map

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

package/dist/session.js.map

@@ -1 +1 @@
-{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAmJH;;;;;;;;;;GAUG;AACH,MAAM,OAAO,WAAW;IACL,SAAS,CAAY;IAEtC,YAAY,QAAmB;QAC7B,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAED,iDAAiD;IACjD,MAAM,CAAC,IAAI,CAAC,QAAmB;QAC7B,OAAO,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED,2CAA2C;IAC3C,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,0BAA0B;IAC1B,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;IAC/B,CAAC;IAED,kDAAkD;IAClD,UAAU;QACR,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAED,4BAA4B;IAC5B,QAAQ,CAAC,EAAU;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,+CAA+C;IAC/C,cAAc,CAAC,GAAG,QAAyB;QACzC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,QAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IACjF,CAAC;IAED,mEAAmE;IACnE,WAAW,CAAC,IAAY,EAAE,UAAmB;QAC3C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YACjC,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAC;YACzC,IAAI,UAAU,IAAI,CAAC,CAAC,KAAK,EAAE,UAAU,KAAK,UAAU;gBAAE,OAAO,KAAK,CAAC;YACnE,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,UAAU,CAAC,KAA8B,EAAE,UAAU,GAAG,IAAI;QAC1D,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACvC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;YACjD,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;YACjD,OAAO,UAAU,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,6CAA6C;IAC7C,UAAU;QACR,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAClD,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,4DAA4D;IAC5D,OAAO;QACL,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAED,gCAAgC;IAChC,CAAC,MAAM,CAAC,QAAQ,CAAC;QACf,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC3C,CAAC;CACF"}
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAwLH;;;;;;;;;;GAUG;AACH,MAAM,OAAO,WAAW;IACL,SAAS,CAAY;IAEtC,YAAY,QAAmB;QAC7B,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAED,iDAAiD;IACjD,MAAM,CAAC,IAAI,CAAC,QAAmB;QAC7B,OAAO,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED,2CAA2C;IAC3C,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,0BAA0B;IAC1B,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;IAC/B,CAAC;IAED,kDAAkD;IAClD,UAAU;QACR,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAED,4BAA4B;IAC5B,QAAQ,CAAC,EAAU;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,+CAA+C;IAC/C,cAAc,CAAC,GAAG,QAAyB;QACzC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,QAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IACjF,CAAC;IAED,mEAAmE;IACnE,WAAW,CAAC,IAAY,EAAE,UAAmB;QAC3C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YACjC,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAC;YACzC,IAAI,UAAU,IAAI,CAAC,CAAC,KAAK,EAAE,UAAU,KAAK,UAAU;gBAAE,OAAO,KAAK,CAAC;YACnE,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,UAAU,CAAC,KAA8B,EAAE,UAAU,GAAG,IAAI;QAC1D,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACvC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;YACjD,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;YACjD,OAAO,UAAU,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,6CAA6C;IAC7C,UAAU;QACR,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAClD,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,4DAA4D;IAC5D,OAAO;QACL,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAED,gCAAgC;IAChC,CAAC,MAAM,CAAC,QAAQ,CAAC;QACf,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC3C,CAAC;CACF"}

package/dist/tasks/archive.d.ts

@@ -51,8 +51,8 @@ import { z } from 'zod';
 export declare const ArchiveReason: z.ZodEnum<{
     cancelled: "cancelled";
     superseded: "superseded";
-    reconciled: "reconciled";
     verified: "verified";
+    reconciled: "reconciled";
     shadowed: "shadowed";
     "completed-unverified": "completed-unverified";
 }>;
@@ -67,8 +67,8 @@ export declare const ArchiveReason: z.ZodEnum<{
 export declare const ArchiveReasonSchema: z.ZodEnum<{
     cancelled: "cancelled";
     superseded: "superseded";
-    reconciled: "reconciled";
     verified: "verified";
+    reconciled: "reconciled";
     shadowed: "shadowed";
     "completed-unverified": "completed-unverified";
 }>;
@@ -93,7 +93,7 @@ export type ArchiveReasonValue = z.infer<typeof ArchiveReason>;
  * Useful when a Drizzle column or a discriminated union needs the raw
  * tuple form (e.g. `text('archive_reason', { enum: ARCHIVE_REASON_VALUES })`).
  */
-export declare const ARCHIVE_REASON_VALUES: ("cancelled" | "superseded" | "reconciled" | "verified" | "shadowed" | "completed-unverified")[];
+export declare const ARCHIVE_REASON_VALUES: ("cancelled" | "superseded" | "verified" | "reconciled" | "shadowed" | "completed-unverified")[];
 /**
  * The single tombstone value within {@link ArchiveReason}.
  *