@peasant-labs/schema 0.1.0-rc6 → 0.1.0-rc9

package/README.md

@@ -22,13 +22,23 @@ same closed-set shape as Go (`Role.User`, `AllRoles`, `isRole`) without
 maintaining a handwritten second contract. The retired `@peasant-labs/types`
 package must not receive new wire definitions.
 
+The generated root Zod schemas enforce the wire's structural shape and selected
+generator-owned local cross-field invariants, including association evidence and
+annotation target rules. The Go `Validate` methods remain authoritative at the
+trust boundary for payload-context and cross-object relationships. TypeScript
+consumer adapters remain responsible for any post-parse semantic handling.
+
 `ProjectHash` is a nominal string identity matching Go's validated newtype.
 Construct values with `newProjectHash`, narrow unknown wire values with
 `isProjectHash`, or assert a trust boundary with `validateProjectHash`.
 
-This package is not published yet. Its development version is
-`0.0.0-development`; a published package version will follow the schema module
-release tag, not an individual OpenAPI document version.
+This package is published to npm as `@peasant-labs/schema`. The committed
+`package.json` in this directory stays `0.0.0-development` + `private: true` as
+a local safety; the schema module's release pipeline stamps the real version
+from the module release tag (not an individual OpenAPI document version) and
+publishes at release time, so every published version corresponds to a tagged
+schema module release. An `-rcN` tag publishes under the npm dist-tag `next`; a
+final `vX.Y.Z` publishes under `latest`.
 
 ```ts
 import {

package/dist/fixtures/timeline.d.ts

@@ -1,22 +1,53 @@
-import type { CommitRef, SessionID, TimelineSessionRef } from "../index.js";
+import type { CommitRef, RewrittenCommit, SessionAssociation, SessionID, TimelineSessionRef } from "../index.js";
 import type { Case } from "../testcase.js";
 export type TimelineFixtureSessionInput = Omit<TimelineSessionRef, "harness"> & {
     harness: string;
 };
-export type TimelineFixtureCommitInput = Omit<CommitRef, "sessionIds"> & {
+export interface TimelineFixtureEvidenceObservation {
+    kind: string;
+    recordedCommitHash?: string;
+    touchedFilePath?: string;
+    branchName?: string;
+    windowStartMs?: number;
+    windowEndMs?: number;
+}
+export type TimelineFixtureAssociationInput = Omit<SessionAssociation, "conclusion" | "confidence" | "evidence"> & {
+    conclusion: string;
+    confidence: string;
+    evidence: TimelineFixtureEvidenceObservation[] | null;
+};
+export type TimelineFixtureCommitInput = Omit<CommitRef, "sessionIds" | "associations"> & {
     sessionIds: SessionID[] | null;
+    associations: TimelineFixtureAssociationInput[] | null;
 };
+export type TimelineFixtureRepairKind = "set_session_binding_true" | "replace_successor_association";
+export interface TimelineFixtureSetSessionBindingRepair {
+    kind: "set_session_binding_true";
+    sessionId: SessionID;
+    postMutationValid: boolean;
+}
+export interface TimelineFixtureReplaceSuccessorAssociationRepair {
+    kind: "replace_successor_association";
+    ghostHash: string;
+    successorHash: string;
+    associationId: SessionAssociation["id"];
+    postMutationValid: boolean;
+}
+export type TimelineFixtureRepair = TimelineFixtureSetSessionBindingRepair | TimelineFixtureReplaceSuccessorAssociationRepair;
 export interface TimelineFixtureInput {
     sessions: TimelineFixtureSessionInput[];
     commits: TimelineFixtureCommitInput[];
+    rewrittenCommits?: RewrittenCommit[];
 }
 export interface TimelineFixtureExpected {
     errorContains?: string;
+    repair?: TimelineFixtureRepair;
 }
 export type TimelineFixtureCase = Case<TimelineFixtureInput, TimelineFixtureExpected> & {
     family: string;
 };
 export interface TimelineFixtureCorpus {
     cases: TimelineFixtureCase[];
+    successorAssociationMirrorCases: TimelineFixtureCase[];
 }
 export declare function loadTimelineFixtures(): TimelineFixtureCorpus;