@cleocode/contracts 2026.5.95 → 2026.5.97

package/dist/operations/worktree.d.ts

@@ -143,6 +143,25 @@ export interface CreateWorktreeOptions {
      * @task T1927
      */
     forceReset?: boolean;
+    /**
+     * Sparse-checkout scope pattern (T9807). When set, `createWorktree` runs
+     * `git sparse-checkout init --cone` followed by
+     * `git sparse-checkout set <spawnScope>` after `git worktree add` completes,
+     * limiting the worktree's checked-out tree to paths matching `<spawnScope>`.
+     *
+     * Exposed on `cleo orchestrate spawn` as the `--scope` flag so callers can
+     * request a lean worktree containing only the paths relevant to a task
+     * (e.g. `packages/cleo` to contain a CLI-only fix).
+     *
+     * Cone mode (`--cone`) is used for maximum checkout performance — the scope
+     * string must be a directory prefix, not an arbitrary glob.
+     *
+     * Failures are silently swallowed (best-effort) — the worktree is returned
+     * in full-checkout mode when sparse-checkout setup fails.
+     *
+     * @task T9807
+     */
+    spawnScope?: string;
 }
 /**
  * Result of a successful worktree creation.
@@ -225,6 +244,14 @@ export interface DestroyWorktreeOptions {
     force?: boolean;
     /** Declarative hooks to run during destruction lifecycle. */
     hooks?: WorktreeHook[];
+    /**
+     * Free-form reason string appended to the lifecycle audit log (T9805).
+     *
+     * Examples: `'pr-merged'`, `'manual'`, `'idle-timeout'`.
+     *
+     * @default 'manual'
+     */
+    reason?: string;
 }
 /**
  * Result of a worktree destroy operation.
@@ -298,6 +325,16 @@ export interface PruneWorktreesOptions {
      * @default true
      */
     gitPrune?: boolean;
+    /**
+     * Abandonment-timeout threshold in days (T9805 AC2).
+     *
+     * When set, worktrees whose branch has had no commits for at least this many
+     * days AND which have no open PR associated are eligible for pruning, even
+     * if their task ID is not in a known-stale set.
+     *
+     * @default undefined — disabled; no idle-age check is performed.
+     */
+    idleDays?: number;
 }
 /**
  * Result of a prune operation.
@@ -337,6 +374,20 @@ export interface PruneWorktreesResult {
  * @task T9546
  */
 export type WorktreeStatusCategory = 'active' | 'stale' | 'merged' | 'orphan' | 'locked';
+/**
+ * Source classifier for a worktree entry.
+ *
+ * - `cleo-spawn`   — Created by `cleo orchestrate spawn` via the canonical XDG path.
+ * - `claude-agent` — Created by Claude Code Agent `isolation:worktree` dispatch (T9804).
+ * - `manual`       — Created directly via `git worktree add` without CLEO CLI involvement.
+ * - `adopted`      — Registered via `cleo worktree adopt` from an unknown origin.
+ *
+ * The `source` field enables downstream consumers (prune, dashboard, sentient daemon)
+ * to apply different policies per origin without re-querying git.
+ *
+ * @task T9804
+ */
+export type WorktreeSource = 'cleo-spawn' | 'claude-agent' | 'manual' | 'adopted';
 /**
  * A single structured worktree entry with full status classification.
  *
@@ -346,6 +397,7 @@ export type WorktreeStatusCategory = 'active' | 'stale' | 'merged' | 'orphan' |
  * sentient daemon) can act on without re-querying git.
  *
  * @task T9546
+ * @task T9804 — added `source` field for multi-source listing
  */
 export interface WorktreeInfo {
     /** Absolute path to the worktree directory. */
@@ -368,6 +420,22 @@ export interface WorktreeInfo {
     owningTaskStatus: string | null;
     /** Mutually-exclusive status category — see {@link WorktreeStatusCategory}. */
     statusCategory: WorktreeStatusCategory;
+    /**
+     * Origin of this worktree entry.
+     *
+     * - `cleo-spawn`   — Canonical XDG worktree created by `cleo orchestrate spawn`.
+     * - `claude-agent` — Created by Claude Code Agent `isolation:worktree` (T9804).
+     * - `manual`       — Created via direct `git worktree add`.
+     * - `adopted`      — Registered via `cleo worktree adopt`.
+     *
+     * For backward-compatibility this field defaults to `cleo-spawn` for entries
+     * that originated from `git worktree list --porcelain` and are NOT present in
+     * the sentinel index.
+     *
+     * @task T9804
+     * @default 'cleo-spawn'
+     */
+    source: WorktreeSource;
 }
 /**
  * Options for the structured worktree listing operation.
@@ -406,6 +474,9 @@ export interface ListWorktreesResult {
 /**
  * Canonical action recorded in `.cleo/audit/worktree-lifecycle.jsonl`.
  *
+ * - `create` — worktree was created via `cleo orchestrate spawn` (T9805).
+ * - `destroy` — worktree was explicitly destroyed (PR-merged cleanup or manual) (T9805).
+ * - `adopt` — an existing worktree directory was attached to a new task ID (T9805).
  * - `prune` — orphaned/merged worktree was removed.
  * - `prune-skip` — orphan was detected but skipped (user said N, or had uncommitted changes).
  * - `force-unlock` — git index.lock removed + `git worktree unlock` ran.
@@ -415,11 +486,15 @@ export interface ListWorktreesResult {
  *                       `--resolve manual`; no automatic merge attempted (T9548).
  * - `complete-conflict` — auto-merge attempted but failed (e.g. rebase/merge conflict);
  *                          worktree was preserved for manual resolution (T9548).
+ * - `adopt` — externally-created worktree (e.g. Claude Code Agent `isolation:worktree`)
+ *             registered in the CLEO SSoT via `cleo worktree adopt` (T9804).
  *
  * @task T9547
  * @task T9548
+ * @task T9804
+ * @task T9805
  */
-export type WorktreeLifecycleAction = 'prune' | 'prune-skip' | 'force-unlock' | 'complete' | 'complete-skip' | 'complete-manual' | 'complete-conflict';
+export type WorktreeLifecycleAction = 'create' | 'destroy' | 'adopt' | 'prune' | 'prune-skip' | 'force-unlock' | 'complete' | 'complete-skip' | 'complete-manual' | 'complete-conflict' | 'adopt';
 /**
  * One append-only entry written to `.cleo/audit/worktree-lifecycle.jsonl` by
  * the prune + force-unlock commands.
@@ -574,4 +649,66 @@ export interface ForceUnlockWorktreeResult {
     /** Error message when no worktree could be located or all actions failed. */
     error?: string;
 }
+/**
+ * Options for {@link adoptWorktree} — the SDK primitive behind
+ * `cleo worktree adopt <path>`.
+ *
+ * @task T9804
+ */
+export interface AdoptWorktreeOpts {
+    /**
+     * Absolute path to the worktree directory to adopt.
+     *
+     * Typically a path under `.claude/worktrees/<sessionId>/` for Claude Code
+     * Agent `isolation:worktree` spawns, but any valid worktree path is accepted.
+     */
+    worktreePath: string;
+    /**
+     * Absolute path to the project root. Used to resolve the sentinel index
+     * and the audit-log file.
+     *
+     * @default process.cwd()
+     */
+    projectRoot?: string;
+    /**
+     * Source classification for this worktree.
+     *
+     * @default 'claude-agent'
+     */
+    source?: WorktreeSource;
+    /**
+     * Task ID to associate with this worktree. When not supplied the function
+     * attempts to extract it from the branch name following the `task/T####`
+     * convention, then falls back to null.
+     */
+    taskId?: string | null;
+    /** Override actor name written to the audit log and sentinel index. */
+    actor?: string;
+    /** Optional override for the audit-log file path (testing). */
+    auditLogPath?: string;
+    /** Optional override for the sentinel index path (testing). */
+    sentinelIndexPath?: string;
+}
+/**
+ * Result of a successful `cleo worktree adopt` operation.
+ *
+ * @task T9804
+ */
+export interface AdoptWorktreeResult {
+    /** Absolute path of the adopted worktree. */
+    path: string;
+    /** Branch name extracted from the worktree `.git` gitlink. */
+    branch: string;
+    /** Task ID associated with the worktree (null if not determinable). */
+    taskId: string | null;
+    /** Source classification applied to this entry. */
+    source: WorktreeSource;
+    /**
+     * Whether this was a new adoption (`true`) or an idempotent re-adopt
+     * of an already-registered worktree (`false`).
+     */
+    isNew: boolean;
+    /** ISO-8601 timestamp when the sentinel entry was written. */
+    adoptedAt: string;
+}
 //# sourceMappingURL=worktree.d.ts.map

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/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<{