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

package/dist/internal/generated/enums.gen.d.ts

@@ -3,9 +3,12 @@ import { type AnnotationDatatype as AnnotationDatatypeContract } from "./contrac
 import { type AnnotationPushStatus as AnnotationPushStatusContract } from "./contract/zod.gen.js";
 import { type AnnotationStatus as AnnotationStatusContract } from "./contract/zod.gen.js";
 import { type AnnotatorKind as AnnotatorKindContract } from "./contract/zod.gen.js";
+import { type AssociationConclusion as AssociationConclusionContract } from "./contract/zod.gen.js";
+import { type AssociationEvidenceKind as AssociationEvidenceKindContract } from "./contract/zod.gen.js";
 import { type BuiltinCommand as BuiltinCommandContract } from "./contract/zod.gen.js";
 import { type ChangeBinding as ChangeBindingContract } from "./contract/zod.gen.js";
 import { type ChannelTopic as ChannelTopicContract } from "./contract/zod.gen.js";
+import { type Confidence as ConfidenceContract } from "./contract/zod.gen.js";
 import { type ContentKind as ContentKindContract } from "./contract/zod.gen.js";
 import { type DecayLevel as DecayLevelContract } from "./contract/zod.gen.js";
 import { type DiffLineKind as DiffLineKindContract } from "./contract/zod.gen.js";
@@ -13,10 +16,16 @@ import { type EdgeViolationKind as EdgeViolationKindContract } from "./contract/
 import { type EntryType as EntryTypeContract } from "./contract/zod.gen.js";
 import { type FileChangeStatus as FileChangeStatusContract } from "./contract/zod.gen.js";
 import { type Harness as HarnessContract } from "./contract/zod.gen.js";
+import { type InsightKind as InsightKindContract } from "./contract/zod.gen.js";
+import { type InsightProvenance as InsightProvenanceContract } from "./contract/zod.gen.js";
 import { type InteractionType as InteractionTypeContract } from "./contract/zod.gen.js";
 import { type License as LicenseContract } from "./contract/zod.gen.js";
 import { type MapNodeKind as MapNodeKindContract } from "./contract/zod.gen.js";
 import { type MessageType as MessageTypeContract } from "./contract/zod.gen.js";
+import { type ReadAttributionState as ReadAttributionStateContract } from "./contract/zod.gen.js";
+import { type ReadStateGrade as ReadStateGradeContract } from "./contract/zod.gen.js";
+import { type RewriteMethod as RewriteMethodContract } from "./contract/zod.gen.js";
+import { type RewriteResolution as RewriteResolutionContract } from "./contract/zod.gen.js";
 import { type Role as RoleContract } from "./contract/zod.gen.js";
 import { type ScaleKind as ScaleKindContract } from "./contract/zod.gen.js";
 import { type SessionOutcome as SessionOutcomeContract } from "./contract/zod.gen.js";
@@ -70,6 +79,22 @@ export declare const AnnotatorKind: Readonly<{
 }>;
 export declare const AllAnnotatorKinds: readonly AnnotatorKind[];
 export declare function isAnnotatorKind(value: unknown): value is AnnotatorKind;
+export type AssociationConclusion = AssociationConclusionContract;
+export declare const AssociationConclusion: Readonly<{
+    readonly Confirmed: "candidate" | "confirmed";
+    readonly Candidate: "candidate" | "confirmed";
+}>;
+export declare const AllAssociationConclusions: readonly AssociationConclusion[];
+export declare function isAssociationConclusion(value: unknown): value is AssociationConclusion;
+export type AssociationEvidenceKind = AssociationEvidenceKindContract;
+export declare const AssociationEvidenceKind: Readonly<{
+    readonly RecordedCommit: "recorded_commit" | "touched_file" | "branch_membership" | "time_window";
+    readonly TouchedFile: "recorded_commit" | "touched_file" | "branch_membership" | "time_window";
+    readonly BranchMembership: "recorded_commit" | "touched_file" | "branch_membership" | "time_window";
+    readonly TimeWindow: "recorded_commit" | "touched_file" | "branch_membership" | "time_window";
+}>;
+export declare const AllAssociationEvidenceKinds: readonly AssociationEvidenceKind[];
+export declare function isAssociationEvidenceKind(value: unknown): value is AssociationEvidenceKind;
 export type BuiltinCommand = BuiltinCommandContract;
 export declare const BuiltinCommand: Readonly<{
     readonly Exit: "new" | "clear" | "resume" | "exit" | "compact" | "config" | "model" | "usage" | "cost" | "context" | "plugin" | "permissions" | "login" | "plan" | "fast" | "voice" | "todos" | "reload-plugins" | "sandbox" | "statusline" | "upgrade" | "extra-usage" | "rate-limit-options" | "privacy-settings" | "help" | "commands";
@@ -120,6 +145,14 @@ export declare const ChannelTopic: Readonly<{
 }>;
 export declare const AllChannelTopics: readonly ChannelTopic[];
 export declare function isChannelTopic(value: unknown): value is ChannelTopic;
+export type Confidence = ConfidenceContract;
+export declare const Confidence: Readonly<{
+    readonly High: "high" | "low" | "medium";
+    readonly Medium: "high" | "low" | "medium";
+    readonly Low: "high" | "low" | "medium";
+}>;
+export declare const AllConfidences: readonly Confidence[];
+export declare function isConfidence(value: unknown): value is Confidence;
 export type ContentKind = ContentKindContract;
 export declare const ContentKind: Readonly<{
     readonly SessionDetail: "session_detail";
@@ -187,6 +220,22 @@ export declare const Harness: Readonly<{
  */
 export declare const AllHarnesses: readonly Harness[];
 export declare function isHarness(value: unknown): value is Harness;
+export type InsightKind = InsightKindContract;
+export declare const InsightKind: Readonly<{
+    readonly Decision: "decision" | "friction" | "unusual" | "retry_loop";
+    readonly Friction: "decision" | "friction" | "unusual" | "retry_loop";
+    readonly Unusual: "decision" | "friction" | "unusual" | "retry_loop";
+    readonly RetryLoop: "decision" | "friction" | "unusual" | "retry_loop";
+}>;
+export declare const AllInsightKinds: readonly InsightKind[];
+export declare function isInsightKind(value: unknown): value is InsightKind;
+export type InsightProvenance = InsightProvenanceContract;
+export declare const InsightProvenance: Readonly<{
+    readonly Mechanical: "mechanical" | "mined";
+    readonly Mined: "mechanical" | "mined";
+}>;
+export declare const AllInsightProvenances: readonly InsightProvenance[];
+export declare function isInsightProvenance(value: unknown): value is InsightProvenance;
 export type InteractionType = InteractionTypeContract;
 export declare const InteractionType: Readonly<{
     readonly Mentioned: "mentioned" | "read" | "discussed" | "questioned";
@@ -228,6 +277,42 @@ export declare const MessageType: Readonly<{
 }>;
 export declare const AllMessageTypes: readonly MessageType[];
 export declare function isMessageType(value: unknown): value is MessageType;
+export type ReadAttributionState = ReadAttributionStateContract;
+export declare const ReadAttributionState: Readonly<{
+    readonly Complete: "complete" | "partial" | "unavailable";
+    readonly Partial: "complete" | "partial" | "unavailable";
+    readonly Unavailable: "complete" | "partial" | "unavailable";
+}>;
+export declare const AllReadAttributionStates: readonly ReadAttributionState[];
+export declare function isReadAttributionState(value: unknown): value is ReadAttributionState;
+export type ReadStateGrade = ReadStateGradeContract;
+export declare const ReadStateGrade: Readonly<{
+    readonly None: "none" | "viewed" | "reviewed" | "reviewed_in_detail";
+    readonly Viewed: "none" | "viewed" | "reviewed" | "reviewed_in_detail";
+    readonly Reviewed: "none" | "viewed" | "reviewed" | "reviewed_in_detail";
+    readonly ReviewedInDetail: "none" | "viewed" | "reviewed" | "reviewed_in_detail";
+}>;
+export declare const AllReadStateGrades: readonly ReadStateGrade[];
+export declare function isReadStateGrade(value: unknown): value is ReadStateGrade;
+export type RewriteMethod = RewriteMethodContract;
+export declare const RewriteMethod: Readonly<{
+    readonly Hash: "none" | "hash" | "patch_id" | "author_identity" | "message_embedded" | "temporal";
+    readonly PatchID: "none" | "hash" | "patch_id" | "author_identity" | "message_embedded" | "temporal";
+    readonly AuthorIdentity: "none" | "hash" | "patch_id" | "author_identity" | "message_embedded" | "temporal";
+    readonly MessageEmbedded: "none" | "hash" | "patch_id" | "author_identity" | "message_embedded" | "temporal";
+    readonly Temporal: "none" | "hash" | "patch_id" | "author_identity" | "message_embedded" | "temporal";
+    readonly None: "none" | "hash" | "patch_id" | "author_identity" | "message_embedded" | "temporal";
+}>;
+export declare const AllRewriteMethods: readonly RewriteMethod[];
+export declare function isRewriteMethod(value: unknown): value is RewriteMethod;
+export type RewriteResolution = RewriteResolutionContract;
+export declare const RewriteResolution: Readonly<{
+    readonly Live: "live" | "rewritten" | "unresolved";
+    readonly Rewritten: "live" | "rewritten" | "unresolved";
+    readonly Unresolved: "live" | "rewritten" | "unresolved";
+}>;
+export declare const AllRewriteResolutions: readonly RewriteResolution[];
+export declare function isRewriteResolution(value: unknown): value is RewriteResolution;
 export type Role = RoleContract;
 export declare const Role: Readonly<{
     readonly User: "user" | "system" | "assistant" | "tool";
@@ -272,10 +357,12 @@ export declare const AllStopReasons: readonly StopReason[];
 export declare function isStopReason(value: unknown): value is StopReason;
 export type TargetKind = TargetKindContract;
 export declare const TargetKind: Readonly<{
-    readonly Session: "session" | "annotation" | "project" | "entry";
-    readonly Entry: "session" | "annotation" | "project" | "entry";
-    readonly Annotation: "session" | "annotation" | "project" | "entry";
-    readonly Project: "session" | "annotation" | "project" | "entry";
+    readonly Session: "session" | "annotation" | "project" | "entry" | "file_version" | "association";
+    readonly Entry: "session" | "annotation" | "project" | "entry" | "file_version" | "association";
+    readonly Annotation: "session" | "annotation" | "project" | "entry" | "file_version" | "association";
+    readonly Project: "session" | "annotation" | "project" | "entry" | "file_version" | "association";
+    readonly FileVersion: "session" | "annotation" | "project" | "entry" | "file_version" | "association";
+    readonly Association: "session" | "annotation" | "project" | "entry" | "file_version" | "association";
 }>;
 export declare const AllTargetKinds: readonly TargetKind[];
 export declare function isTargetKind(value: unknown): value is TargetKind;

package/dist/internal/generated/enums.gen.js

@@ -4,9 +4,12 @@ import { zAnnotationDatatype } from "./contract/zod.gen.js";
 import { zAnnotationPushStatus } from "./contract/zod.gen.js";
 import { zAnnotationStatus } from "./contract/zod.gen.js";
 import { zAnnotatorKind } from "./contract/zod.gen.js";
+import { zAssociationConclusion } from "./contract/zod.gen.js";
+import { zAssociationEvidenceKind } from "./contract/zod.gen.js";
 import { zBuiltinCommand } from "./contract/zod.gen.js";
 import { zChangeBinding } from "./contract/zod.gen.js";
 import { zChannelTopic } from "./contract/zod.gen.js";
+import { zConfidence } from "./contract/zod.gen.js";
 import { zContentKind } from "./contract/zod.gen.js";
 import { zDecayLevel } from "./contract/zod.gen.js";
 import { zDiffLineKind } from "./contract/zod.gen.js";
@@ -14,10 +17,16 @@ import { zEdgeViolationKind } from "./contract/zod.gen.js";
 import { zEntryType } from "./contract/zod.gen.js";
 import { zFileChangeStatus } from "./contract/zod.gen.js";
 import { zHarness } from "./contract/zod.gen.js";
+import { zInsightKind } from "./contract/zod.gen.js";
+import { zInsightProvenance } from "./contract/zod.gen.js";
 import { zInteractionType } from "./contract/zod.gen.js";
 import { zLicense } from "./contract/zod.gen.js";
 import { zMapNodeKind } from "./contract/zod.gen.js";
 import { zMessageType } from "./contract/zod.gen.js";
+import { zReadAttributionState } from "./contract/zod.gen.js";
+import { zReadStateGrade } from "./contract/zod.gen.js";
+import { zRewriteMethod } from "./contract/zod.gen.js";
+import { zRewriteResolution } from "./contract/zod.gen.js";
 import { zRole } from "./contract/zod.gen.js";
 import { zScaleKind } from "./contract/zod.gen.js";
 import { zSessionOutcome } from "./contract/zod.gen.js";
@@ -76,6 +85,24 @@ export const AllAnnotatorKinds = Object.freeze([AnnotatorKind.Human, AnnotatorKi
 export function isAnnotatorKind(value) {
     return zAnnotatorKind.safeParse(value).success;
 }
+export const AssociationConclusion = Object.freeze({
+    Confirmed: zAssociationConclusion.parse("confirmed"),
+    Candidate: zAssociationConclusion.parse("candidate"),
+});
+export const AllAssociationConclusions = Object.freeze([AssociationConclusion.Confirmed, AssociationConclusion.Candidate]);
+export function isAssociationConclusion(value) {
+    return zAssociationConclusion.safeParse(value).success;
+}
+export const AssociationEvidenceKind = Object.freeze({
+    RecordedCommit: zAssociationEvidenceKind.parse("recorded_commit"),
+    TouchedFile: zAssociationEvidenceKind.parse("touched_file"),
+    BranchMembership: zAssociationEvidenceKind.parse("branch_membership"),
+    TimeWindow: zAssociationEvidenceKind.parse("time_window"),
+});
+export const AllAssociationEvidenceKinds = Object.freeze([AssociationEvidenceKind.RecordedCommit, AssociationEvidenceKind.TouchedFile, AssociationEvidenceKind.BranchMembership, AssociationEvidenceKind.TimeWindow]);
+export function isAssociationEvidenceKind(value) {
+    return zAssociationEvidenceKind.safeParse(value).success;
+}
 export const BuiltinCommand = Object.freeze({
     Exit: zBuiltinCommand.parse("exit"),
     Compact: zBuiltinCommand.parse("compact"),
@@ -129,6 +156,15 @@ export const AllChannelTopics = Object.freeze([ChannelTopic.Dashboard, ChannelTo
 export function isChannelTopic(value) {
     return zChannelTopic.safeParse(value).success;
 }
+export const Confidence = Object.freeze({
+    High: zConfidence.parse("high"),
+    Medium: zConfidence.parse("medium"),
+    Low: zConfidence.parse("low"),
+});
+export const AllConfidences = Object.freeze([Confidence.High, Confidence.Medium, Confidence.Low]);
+export function isConfidence(value) {
+    return zConfidence.safeParse(value).success;
+}
 export const ContentKind = Object.freeze({
     SessionDetail: zContentKind.parse("session_detail"),
 });
@@ -203,6 +239,24 @@ export const AllHarnesses = Object.freeze([Harness.ClaudeCode, Harness.GeminiCLI
 export function isHarness(value) {
     return zHarness.safeParse(value).success;
 }
+export const InsightKind = Object.freeze({
+    Decision: zInsightKind.parse("decision"),
+    Friction: zInsightKind.parse("friction"),
+    Unusual: zInsightKind.parse("unusual"),
+    RetryLoop: zInsightKind.parse("retry_loop"),
+});
+export const AllInsightKinds = Object.freeze([InsightKind.Decision, InsightKind.Friction, InsightKind.Unusual, InsightKind.RetryLoop]);
+export function isInsightKind(value) {
+    return zInsightKind.safeParse(value).success;
+}
+export const InsightProvenance = Object.freeze({
+    Mechanical: zInsightProvenance.parse("mechanical"),
+    Mined: zInsightProvenance.parse("mined"),
+});
+export const AllInsightProvenances = Object.freeze([InsightProvenance.Mechanical, InsightProvenance.Mined]);
+export function isInsightProvenance(value) {
+    return zInsightProvenance.safeParse(value).success;
+}
 export const InteractionType = Object.freeze({
     Mentioned: zInteractionType.parse("mentioned"),
     Read: zInteractionType.parse("read"),
@@ -248,6 +302,46 @@ export const AllMessageTypes = Object.freeze([MessageType.Subscribe, MessageType
 export function isMessageType(value) {
     return zMessageType.safeParse(value).success;
 }
+export const ReadAttributionState = Object.freeze({
+    Complete: zReadAttributionState.parse("complete"),
+    Partial: zReadAttributionState.parse("partial"),
+    Unavailable: zReadAttributionState.parse("unavailable"),
+});
+export const AllReadAttributionStates = Object.freeze([ReadAttributionState.Complete, ReadAttributionState.Partial, ReadAttributionState.Unavailable]);
+export function isReadAttributionState(value) {
+    return zReadAttributionState.safeParse(value).success;
+}
+export const ReadStateGrade = Object.freeze({
+    None: zReadStateGrade.parse("none"),
+    Viewed: zReadStateGrade.parse("viewed"),
+    Reviewed: zReadStateGrade.parse("reviewed"),
+    ReviewedInDetail: zReadStateGrade.parse("reviewed_in_detail"),
+});
+export const AllReadStateGrades = Object.freeze([ReadStateGrade.None, ReadStateGrade.Viewed, ReadStateGrade.Reviewed, ReadStateGrade.ReviewedInDetail]);
+export function isReadStateGrade(value) {
+    return zReadStateGrade.safeParse(value).success;
+}
+export const RewriteMethod = Object.freeze({
+    Hash: zRewriteMethod.parse("hash"),
+    PatchID: zRewriteMethod.parse("patch_id"),
+    AuthorIdentity: zRewriteMethod.parse("author_identity"),
+    MessageEmbedded: zRewriteMethod.parse("message_embedded"),
+    Temporal: zRewriteMethod.parse("temporal"),
+    None: zRewriteMethod.parse("none"),
+});
+export const AllRewriteMethods = Object.freeze([RewriteMethod.Hash, RewriteMethod.PatchID, RewriteMethod.AuthorIdentity, RewriteMethod.MessageEmbedded, RewriteMethod.Temporal, RewriteMethod.None]);
+export function isRewriteMethod(value) {
+    return zRewriteMethod.safeParse(value).success;
+}
+export const RewriteResolution = Object.freeze({
+    Live: zRewriteResolution.parse("live"),
+    Rewritten: zRewriteResolution.parse("rewritten"),
+    Unresolved: zRewriteResolution.parse("unresolved"),
+});
+export const AllRewriteResolutions = Object.freeze([RewriteResolution.Live, RewriteResolution.Rewritten, RewriteResolution.Unresolved]);
+export function isRewriteResolution(value) {
+    return zRewriteResolution.safeParse(value).success;
+}
 export const Role = Object.freeze({
     User: zRole.parse("user"),
     Assistant: zRole.parse("assistant"),
@@ -300,8 +394,10 @@ export const TargetKind = Object.freeze({
     Entry: zTargetKind.parse("entry"),
     Annotation: zTargetKind.parse("annotation"),
     Project: zTargetKind.parse("project"),
+    FileVersion: zTargetKind.parse("file_version"),
+    Association: zTargetKind.parse("association"),
 });
-export const AllTargetKinds = Object.freeze([TargetKind.Session, TargetKind.Entry, TargetKind.Annotation, TargetKind.Project]);
+export const AllTargetKinds = Object.freeze([TargetKind.Session, TargetKind.Entry, TargetKind.Annotation, TargetKind.Project, TargetKind.FileVersion, TargetKind.Association]);
 export function isTargetKind(value) {
     return zTargetKind.safeParse(value).success;
 }

package/dist/internal/generated/local-api.d.ts

@@ -326,6 +326,31 @@ export interface components {
          * @enum {string}
          */
         SchemaAnnotatorKind: Schema.AnnotatorKind;
+        /**
+         * Association Conclusion
+         * @description Producer-supplied conclusion for a session-to-commit association: confirmed or candidate
+         * @example confirmed
+         * @example candidate
+         * @enum {string}
+         */
+        SchemaAssociationConclusion: Schema.AssociationConclusion;
+        /**
+         * Association Evidence Kind
+         * @description Atomic observation supporting a session-to-commit association
+         * @example recorded_commit
+         * @example touched_file
+         * @example branch_membership
+         * @example time_window
+         * @enum {string}
+         */
+        SchemaAssociationEvidenceKind: Schema.AssociationEvidenceKind;
+        SchemaAssociationEvidenceObservation: Schema.AssociationEvidenceObservation;
+        /**
+         * Association ID
+         * @description Opaque durable Peasant identifier for one session-to-commit association
+         * @example assoc-20260726:session-a:commit-1
+         */
+        SchemaAssociationID: Schema.AssociationID;
         /**
          * Change Binding
          * @description Strength of the evidence connecting a recorded session to a code change
@@ -354,6 +379,15 @@ export interface components {
         SchemaChannelTopic: Schema.ChannelTopic;
         SchemaChildSessionRef: Schema.ChildSessionRef;
         SchemaCommitRef: Schema.CommitRef;
+        /**
+         * Confidence
+         * @description Strength of evidence behind a derived relationship: high, medium, or low
+         * @example high
+         * @example medium
+         * @example low
+         * @enum {string}
+         */
+        SchemaConfidence: Schema.Confidence;
         SchemaCreateAnnotationRequest: Schema.CreateAnnotationRequest;
         SchemaCreateAnnotationResponse: Schema.CreateAnnotationResponse;
         SchemaDayStats: Schema.DayStats;
@@ -399,6 +433,26 @@ export interface components {
         SchemaFileChangeStatus: Schema.FileChangeStatus;
         SchemaFrictionCluster: Schema.FrictionCluster;
         SchemaHealthResponse: Schema.HealthResponse;
+        SchemaInsightClassification: Schema.InsightClassification;
+        SchemaInsightEvidence: Schema.InsightEvidence;
+        /**
+         * Insight Kind
+         * @description What a SessionInsight observed: a decision, friction, an unusual rate elevation, or a retry loop
+         * @example decision
+         * @example friction
+         * @example unusual
+         * @example retry_loop
+         * @enum {string}
+         */
+        SchemaInsightKind: Schema.InsightKind;
+        /**
+         * Insight Provenance
+         * @description How a SessionInsight was produced: mechanical (rule-derived) or mined
+         * @example mechanical
+         * @example mined
+         * @enum {string}
+         */
+        SchemaInsightProvenance: Schema.InsightProvenance;
         SchemaMapEdge: Schema.MapEdge;
         SchemaMapGraphPayload: Schema.MapGraphPayload;
         SchemaMapNode: Schema.MapNode;
@@ -443,7 +497,48 @@ export interface components {
         SchemaProjectTasksPayload: Schema.ProjectTasksPayload;
         SchemaProvenance: Schema.Provenance;
         SchemaQualitySession: Schema.QualitySession;
+        /**
+         * Read Attribution State
+         * @description Whether per-file read attribution is recoverable for a node's editing sessions: complete, partial, or unavailable
+         * @example complete
+         * @example partial
+         * @example unavailable
+         * @enum {string}
+         */
+        SchemaReadAttributionState: Schema.ReadAttributionState;
+        /**
+         * Read State Grade
+         * @description Ordinal explicit read-state act: none, viewed, reviewed, or reviewed_in_detail
+         * @example none
+         * @example viewed
+         * @example reviewed
+         * @example reviewed_in_detail
+         * @enum {string}
+         */
+        SchemaReadStateGrade: Schema.ReadStateGrade;
         SchemaReviewListPayload: Schema.ReviewListPayload;
+        /**
+         * Rewrite Method
+         * @description Mechanism the resolver used to map a ghost commit to its successor
+         * @example hash
+         * @example patch_id
+         * @example author_identity
+         * @example message_embedded
+         * @example temporal
+         * @example none
+         * @enum {string}
+         */
+        SchemaRewriteMethod: Schema.RewriteMethod;
+        /**
+         * Rewrite Resolution
+         * @description Whether a ledger-observed commit hash is live, was rewritten, or could not be resolved
+         * @example live
+         * @example rewritten
+         * @example unresolved
+         * @enum {string}
+         */
+        SchemaRewriteResolution: Schema.RewriteResolution;
+        SchemaRewrittenCommit: Schema.RewrittenCommit;
         /**
          * Role
          * @description Sender role of a message turn
@@ -463,6 +558,7 @@ export interface components {
         SchemaScaleKind: Schema.ScaleKind;
         SchemaSearchPayload: Schema.SearchPayload;
         SchemaSearchResult: Schema.SearchResult;
+        SchemaSessionAssociation: Schema.SessionAssociation;
         SchemaSessionDetailPayload: Schema.SessionDetailPayload;
         /**
          * Session ID
@@ -474,6 +570,7 @@ export interface components {
          * @example sess_3cd91f52effeXd3QAJ54jOyzv5
          */
         SchemaSessionID: Schema.SessionID;
+        SchemaSessionInsight: Schema.SessionInsight;
         /**
          * Session Outcome
          * @description Resolution status of the session
@@ -497,9 +594,11 @@ export interface components {
         SchemaStopReason: Schema.StopReason;
         /**
          * Target Kind
-         * @description What is being annotated: session-level, entry-level (turn/tool call), meta-annotation, or project-level
+         * @description What is being annotated: session-level, entry-level (turn/tool call), meta-annotation, project-level, a specific file version (content-hash keyed read-state receipt), or a durable session-to-commit association
          * @example session
          * @example entry
+         * @example file_version
+         * @example association
          * @enum {string}
          */
         SchemaTargetKind: Schema.TargetKind;

package/dist/internal/generated/public-contract.gen.d.ts

@@ -1,2 +1,2 @@
-export { zActivityEdge, zAnnotationAxis, zAnnotationDatatype, zAnnotationEntryTarget, zAnnotationManifestResponse, zAnnotationPushStatus, zAnnotationPushResult, zAnnotationPushResponse, zAnnotationStatus, zAnnotatorKind, zAnnotatorSummary, zBatchCreateAnnotationsErrorResponse, zBatchCreateAnnotationsResponse, zBuiltinCommand, zCLILoginQuery, zChangeBinding, zChangeSummary, zChannelTopic, zChannelSubscription, zChildSessionRef, zCommitInfo, zContentKind, zContractVersion, zCreateAnnotationRequest, zBatchCreateAnnotationsRequest, zCreateAnnotationResponse, zDashboardPayload, zDayStats, zDecayLevel, zDiagnosticEntry, zDiagnosticsInfo, zDiffLineKind, zDiffLine, zDiffHunk, zEdgeViolationKind, zEdgeViolation, zEntryType, zExchangeCodeRequest, zExchangeCodeResponse, zFileChangeStatus, zChangeDiffPayload, zFileChange, zFileFamiliarity, zFrictionCluster, zGitContext, zHarness, zHealthResponse, zHostSlug, zInteractionType, zLicense, zMapEdge, zMapNodeKind, zMapNode, zMapSlice, zMessageType, zClientMessage, zMockConfigResponse, zModelID, zModelInfo, zProjectHash, zMapGraphPayload, zProjectContext, zProjectResolutionPayload, zProjectSummary, zProjectSummariesPayload, zProvenance, zPublishResponse, zRedactionInfo, zReviewSuggestion, zRole, zScaleKind, zSchemaVersionResponse, zSearchResult, zSearchPayload, zServerMessage, zSessionID, zCommitRef, zSessionIdentity, zSessionOutcome, zQualityMetrics, zSessionScorecard, zSessionStats, zSessionSummary, zSessionsPayload, zShutdownResponse, zSourceFormat, zSourceInfo, zStopReason, zSubagentRef, zTargetKind, zAnnotationPushItem, zAnnotationPushRequest, zAnnotationSummary, zAnnotationsPayload, zPullAnnotation, zQualitySession, zQualityPayload, zTaskSummary, zChangeSession, zMapNodeDetailPayload, zProjectTasksPayload, zTimelineSessionRef, zReviewListPayload, zTimestampInfo, zToolCallKind, zSessionEntry, zPublishRequest, zToolCallDetail, zTranscriptID, zPullSkipGateItem, zPullSkipGateRequest, zPullSkipGateResult, zPullSkipGateResponse, zTrendsPayload, zTurnDetail, zSessionDetailPayload, zTranscriptContent, zTypeOrigin, zUnifiedMetadata, zUnusualSignal, zChangeDetailPayload, zValueDomainKind, zValueDomain, zAnnotationTypeSummary, zTaxonomyFamilyNode, zTaxonomyNode, zVisibility, zPullTranscriptInfo, zPullListResponse, zWalkthroughStep, zWalkthroughTrail, zFamiliarityPayload } from "./contract/zod.gen.js";
-export type { ActivityEdge, AnnotationEntryTarget, AnnotationManifestResponse, AnnotationPushResult, AnnotationPushResponse, AnnotatorSummary, BatchCreateAnnotationsErrorResponse, BatchCreateAnnotationsResponse, CLILoginQuery, ChangeSummary, ChannelSubscription, ChildSessionRef, CommitInfo, ContractVersion, CreateAnnotationRequest, BatchCreateAnnotationsRequest, CreateAnnotationResponse, DashboardPayload, DayStats, DiagnosticEntry, DiagnosticsInfo, DiffLine, DiffHunk, EdgeViolation, ExchangeCodeRequest, ExchangeCodeResponse, ChangeDiffPayload, FileChange, FileFamiliarity, FrictionCluster, GitContext, HealthResponse, HostSlug, MapEdge, MapNode, MapSlice, ClientMessage, MockConfigResponse, ModelID, ModelInfo, ProjectHash, MapGraphPayload, ProjectContext, ProjectResolutionPayload, ProjectSummary, ProjectSummariesPayload, Provenance, PublishResponse, RedactionInfo, ReviewSuggestion, SchemaVersionResponse, SearchResult, SearchPayload, ServerMessage, SessionID, CommitRef, SessionIdentity, QualityMetrics, SessionScorecard, SessionStats, SessionSummary, SessionsPayload, ShutdownResponse, SourceInfo, SubagentRef, AnnotationPushItem, AnnotationPushRequest, AnnotationSummary, AnnotationsPayload, PullAnnotation, QualitySession, QualityPayload, TaskSummary, ChangeSession, MapNodeDetailPayload, ProjectTasksPayload, TimelineSessionRef, ReviewListPayload, TimestampInfo, SessionEntry, PublishRequest, ToolCallDetail, TranscriptID, PullSkipGateItem, PullSkipGateRequest, PullSkipGateResult, PullSkipGateResponse, TrendsPayload, TurnDetail, SessionDetailPayload, TranscriptContent, UnifiedMetadata, UnusualSignal, ChangeDetailPayload, ValueDomain, AnnotationTypeSummary, TaxonomyFamilyNode, TaxonomyNode, PullTranscriptInfo, PullListResponse, WalkthroughStep, WalkthroughTrail, FamiliarityPayload } from "./contract/zod.gen.js";
+export { zActivityEdge, zAnnotationAxis, zAnnotationDatatype, zAnnotationEntryTarget, zAnnotationManifestResponse, zAnnotationPushStatus, zAnnotationPushResult, zAnnotationPushResponse, zAnnotationStatus, zAnnotatorKind, zAnnotatorSummary, zAssociationConclusion, zAssociationEvidenceKind, zAssociationEvidenceObservation, zAssociationID, zBatchCreateAnnotationsErrorResponse, zBatchCreateAnnotationsResponse, zBuiltinCommand, zCLILoginQuery, zChangeBinding, zChangeSummary, zChannelTopic, zChannelSubscription, zChildSessionRef, zCommitInfo, zConfidence, zContentKind, zContractVersion, zCreateAnnotationRequest, zBatchCreateAnnotationsRequest, zCreateAnnotationResponse, zDashboardPayload, zDayStats, zDecayLevel, zDiagnosticEntry, zDiagnosticsInfo, zDiffLineKind, zDiffLine, zDiffHunk, zEdgeViolationKind, zEdgeViolation, zEntryType, zExchangeCodeRequest, zExchangeCodeResponse, zFileChangeStatus, zChangeDiffPayload, zFileChange, zFileFamiliarity, zFrictionCluster, zHarness, zHealthResponse, zHostSlug, zInsightClassification, zInsightKind, zInsightProvenance, zInteractionType, zLicense, zMapEdge, zMapNodeKind, zMessageType, zClientMessage, zMockConfigResponse, zModelID, zModelInfo, zProjectHash, zProjectContext, zProjectResolutionPayload, zProjectSummary, zProjectSummariesPayload, zProvenance, zPublishResponse, zPublishedAssociation, zGitContext, zReadAttributionState, zReadStateGrade, zMapNode, zMapGraphPayload, zMapSlice, zRedactionInfo, zReviewSuggestion, zRewriteMethod, zRewriteResolution, zRole, zScaleKind, zSchemaVersionResponse, zSearchResult, zSearchPayload, zServerMessage, zSessionID, zInsightEvidence, zSessionAssociation, zCommitRef, zRewrittenCommit, zSessionIdentity, zSessionInsight, zSessionOutcome, zQualityMetrics, zSessionScorecard, zSessionStats, zSessionSummary, zSessionsPayload, zShutdownResponse, zSourceFormat, zSourceInfo, zStopReason, zSubagentRef, zTargetKind, zAnnotationPushItem, zAnnotationPushRequest, zAnnotationSummary, zAnnotationsPayload, zPullAnnotation, zQualitySession, zQualityPayload, zTaskSummary, zChangeSession, zMapNodeDetailPayload, zProjectTasksPayload, zTimelineSessionRef, zReviewListPayload, zTimestampInfo, zToolCallKind, zSessionEntry, zPublishRequest, zToolCallDetail, zTranscriptID, zPullSkipGateItem, zPullSkipGateRequest, zPullSkipGateResult, zPullSkipGateResponse, zTrendsPayload, zTurnDetail, zSessionDetailPayload, zTranscriptContent, zTypeOrigin, zUnifiedMetadata, zUnusualSignal, zChangeDetailPayload, zValueDomainKind, zValueDomain, zAnnotationTypeSummary, zTaxonomyFamilyNode, zTaxonomyNode, zVisibility, zPullTranscriptInfo, zPullListResponse, zWalkthroughStep, zWalkthroughTrail, zFamiliarityPayload } from "./contract/zod.gen.js";
+export type { ActivityEdge, AnnotationEntryTarget, AnnotationManifestResponse, AnnotationPushResult, AnnotationPushResponse, AnnotatorSummary, AssociationEvidenceObservation, AssociationID, BatchCreateAnnotationsErrorResponse, BatchCreateAnnotationsResponse, CLILoginQuery, ChangeSummary, ChannelSubscription, ChildSessionRef, CommitInfo, ContractVersion, CreateAnnotationRequest, BatchCreateAnnotationsRequest, CreateAnnotationResponse, DashboardPayload, DayStats, DiagnosticEntry, DiagnosticsInfo, DiffLine, DiffHunk, EdgeViolation, ExchangeCodeRequest, ExchangeCodeResponse, ChangeDiffPayload, FileChange, FileFamiliarity, FrictionCluster, HealthResponse, HostSlug, InsightClassification, MapEdge, ClientMessage, MockConfigResponse, ModelID, ModelInfo, ProjectHash, ProjectContext, ProjectResolutionPayload, ProjectSummary, ProjectSummariesPayload, Provenance, PublishResponse, PublishedAssociation, GitContext, MapNode, MapGraphPayload, MapSlice, RedactionInfo, ReviewSuggestion, SchemaVersionResponse, SearchResult, SearchPayload, ServerMessage, SessionID, InsightEvidence, SessionAssociation, CommitRef, RewrittenCommit, SessionIdentity, SessionInsight, QualityMetrics, SessionScorecard, SessionStats, SessionSummary, SessionsPayload, ShutdownResponse, SourceInfo, SubagentRef, AnnotationPushItem, AnnotationPushRequest, AnnotationSummary, AnnotationsPayload, PullAnnotation, QualitySession, QualityPayload, TaskSummary, ChangeSession, MapNodeDetailPayload, ProjectTasksPayload, TimelineSessionRef, ReviewListPayload, TimestampInfo, SessionEntry, PublishRequest, ToolCallDetail, TranscriptID, PullSkipGateItem, PullSkipGateRequest, PullSkipGateResult, PullSkipGateResponse, TrendsPayload, TurnDetail, SessionDetailPayload, TranscriptContent, UnifiedMetadata, UnusualSignal, ChangeDetailPayload, ValueDomain, AnnotationTypeSummary, TaxonomyFamilyNode, TaxonomyNode, PullTranscriptInfo, PullListResponse, WalkthroughStep, WalkthroughTrail, FamiliarityPayload } from "./contract/zod.gen.js";

package/dist/internal/generated/public-contract.gen.js

@@ -1,2 +1,2 @@
 // Code generated from the canonical Go/OpenAPI contract. DO NOT EDIT.
-export { zActivityEdge, zAnnotationAxis, zAnnotationDatatype, zAnnotationEntryTarget, zAnnotationManifestResponse, zAnnotationPushStatus, zAnnotationPushResult, zAnnotationPushResponse, zAnnotationStatus, zAnnotatorKind, zAnnotatorSummary, zBatchCreateAnnotationsErrorResponse, zBatchCreateAnnotationsResponse, zBuiltinCommand, zCLILoginQuery, zChangeBinding, zChangeSummary, zChannelTopic, zChannelSubscription, zChildSessionRef, zCommitInfo, zContentKind, zContractVersion, zCreateAnnotationRequest, zBatchCreateAnnotationsRequest, zCreateAnnotationResponse, zDashboardPayload, zDayStats, zDecayLevel, zDiagnosticEntry, zDiagnosticsInfo, zDiffLineKind, zDiffLine, zDiffHunk, zEdgeViolationKind, zEdgeViolation, zEntryType, zExchangeCodeRequest, zExchangeCodeResponse, zFileChangeStatus, zChangeDiffPayload, zFileChange, zFileFamiliarity, zFrictionCluster, zGitContext, zHarness, zHealthResponse, zHostSlug, zInteractionType, zLicense, zMapEdge, zMapNodeKind, zMapNode, zMapSlice, zMessageType, zClientMessage, zMockConfigResponse, zModelID, zModelInfo, zProjectHash, zMapGraphPayload, zProjectContext, zProjectResolutionPayload, zProjectSummary, zProjectSummariesPayload, zProvenance, zPublishResponse, zRedactionInfo, zReviewSuggestion, zRole, zScaleKind, zSchemaVersionResponse, zSearchResult, zSearchPayload, zServerMessage, zSessionID, zCommitRef, zSessionIdentity, zSessionOutcome, zQualityMetrics, zSessionScorecard, zSessionStats, zSessionSummary, zSessionsPayload, zShutdownResponse, zSourceFormat, zSourceInfo, zStopReason, zSubagentRef, zTargetKind, zAnnotationPushItem, zAnnotationPushRequest, zAnnotationSummary, zAnnotationsPayload, zPullAnnotation, zQualitySession, zQualityPayload, zTaskSummary, zChangeSession, zMapNodeDetailPayload, zProjectTasksPayload, zTimelineSessionRef, zReviewListPayload, zTimestampInfo, zToolCallKind, zSessionEntry, zPublishRequest, zToolCallDetail, zTranscriptID, zPullSkipGateItem, zPullSkipGateRequest, zPullSkipGateResult, zPullSkipGateResponse, zTrendsPayload, zTurnDetail, zSessionDetailPayload, zTranscriptContent, zTypeOrigin, zUnifiedMetadata, zUnusualSignal, zChangeDetailPayload, zValueDomainKind, zValueDomain, zAnnotationTypeSummary, zTaxonomyFamilyNode, zTaxonomyNode, zVisibility, zPullTranscriptInfo, zPullListResponse, zWalkthroughStep, zWalkthroughTrail, zFamiliarityPayload } from "./contract/zod.gen.js";
+export { zActivityEdge, zAnnotationAxis, zAnnotationDatatype, zAnnotationEntryTarget, zAnnotationManifestResponse, zAnnotationPushStatus, zAnnotationPushResult, zAnnotationPushResponse, zAnnotationStatus, zAnnotatorKind, zAnnotatorSummary, zAssociationConclusion, zAssociationEvidenceKind, zAssociationEvidenceObservation, zAssociationID, zBatchCreateAnnotationsErrorResponse, zBatchCreateAnnotationsResponse, zBuiltinCommand, zCLILoginQuery, zChangeBinding, zChangeSummary, zChannelTopic, zChannelSubscription, zChildSessionRef, zCommitInfo, zConfidence, zContentKind, zContractVersion, zCreateAnnotationRequest, zBatchCreateAnnotationsRequest, zCreateAnnotationResponse, zDashboardPayload, zDayStats, zDecayLevel, zDiagnosticEntry, zDiagnosticsInfo, zDiffLineKind, zDiffLine, zDiffHunk, zEdgeViolationKind, zEdgeViolation, zEntryType, zExchangeCodeRequest, zExchangeCodeResponse, zFileChangeStatus, zChangeDiffPayload, zFileChange, zFileFamiliarity, zFrictionCluster, zHarness, zHealthResponse, zHostSlug, zInsightClassification, zInsightKind, zInsightProvenance, zInteractionType, zLicense, zMapEdge, zMapNodeKind, zMessageType, zClientMessage, zMockConfigResponse, zModelID, zModelInfo, zProjectHash, zProjectContext, zProjectResolutionPayload, zProjectSummary, zProjectSummariesPayload, zProvenance, zPublishResponse, zPublishedAssociation, zGitContext, zReadAttributionState, zReadStateGrade, zMapNode, zMapGraphPayload, zMapSlice, zRedactionInfo, zReviewSuggestion, zRewriteMethod, zRewriteResolution, zRole, zScaleKind, zSchemaVersionResponse, zSearchResult, zSearchPayload, zServerMessage, zSessionID, zInsightEvidence, zSessionAssociation, zCommitRef, zRewrittenCommit, zSessionIdentity, zSessionInsight, zSessionOutcome, zQualityMetrics, zSessionScorecard, zSessionStats, zSessionSummary, zSessionsPayload, zShutdownResponse, zSourceFormat, zSourceInfo, zStopReason, zSubagentRef, zTargetKind, zAnnotationPushItem, zAnnotationPushRequest, zAnnotationSummary, zAnnotationsPayload, zPullAnnotation, zQualitySession, zQualityPayload, zTaskSummary, zChangeSession, zMapNodeDetailPayload, zProjectTasksPayload, zTimelineSessionRef, zReviewListPayload, zTimestampInfo, zToolCallKind, zSessionEntry, zPublishRequest, zToolCallDetail, zTranscriptID, zPullSkipGateItem, zPullSkipGateRequest, zPullSkipGateResult, zPullSkipGateResponse, zTrendsPayload, zTurnDetail, zSessionDetailPayload, zTranscriptContent, zTypeOrigin, zUnifiedMetadata, zUnusualSignal, zChangeDetailPayload, zValueDomainKind, zValueDomain, zAnnotationTypeSummary, zTaxonomyFamilyNode, zTaxonomyNode, zVisibility, zPullTranscriptInfo, zPullListResponse, zWalkthroughStep, zWalkthroughTrail, zFamiliarityPayload } from "./contract/zod.gen.js";