@ajvikram/relay 0.1.0

package/dist/format/schema.d.ts

@@ -0,0 +1,516 @@
+import { z } from 'zod';
+export declare const Platform: z.ZodEnum<["claude", "cursor", "copilot", "antigravity", "other"]>;
+export type Platform = z.infer<typeof Platform>;
+export declare const SessionStatus: z.ZodEnum<["in_progress", "blocked", "completed"]>;
+export type SessionStatus = z.infer<typeof SessionStatus>;
+export declare const Priority: z.ZodEnum<["immediate", "soon", "later"]>;
+export type Priority = z.infer<typeof Priority>;
+export declare const RepositorySchema: z.ZodObject<{
+    path: z.ZodString;
+    branch: z.ZodString;
+    head_commit: z.ZodString;
+    head_message: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    branch: string;
+    head_commit: string;
+    head_message?: string | undefined;
+}, {
+    path: string;
+    branch: string;
+    head_commit: string;
+    head_message?: string | undefined;
+}>;
+export type Repository = z.infer<typeof RepositorySchema>;
+export declare const SessionSchema: z.ZodObject<{
+    goal: z.ZodString;
+    status: z.ZodEnum<["in_progress", "blocked", "completed"]>;
+    token_exhausted: z.ZodDefault<z.ZodBoolean>;
+    duration_hint: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "in_progress" | "blocked" | "completed";
+    goal: string;
+    token_exhausted: boolean;
+    duration_hint?: string | undefined;
+}, {
+    status: "in_progress" | "blocked" | "completed";
+    goal: string;
+    token_exhausted?: boolean | undefined;
+    duration_hint?: string | undefined;
+}>;
+export type Session = z.infer<typeof SessionSchema>;
+export declare const DecisionSchema: z.ZodObject<{
+    what: z.ZodString;
+    why: z.ZodString;
+    evidence: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    what: string;
+    why: string;
+    evidence?: string | undefined;
+}, {
+    what: string;
+    why: string;
+    evidence?: string | undefined;
+}>;
+export type Decision = z.infer<typeof DecisionSchema>;
+export declare const FailedApproachSchema: z.ZodObject<{
+    approach: z.ZodString;
+    why_failed: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    approach: string;
+    why_failed: string;
+}, {
+    approach: string;
+    why_failed: string;
+}>;
+export type FailedApproach = z.infer<typeof FailedApproachSchema>;
+export declare const ModifiedFileSchema: z.ZodObject<{
+    path: z.ZodString;
+    status: z.ZodDefault<z.ZodEnum<["added", "modified", "deleted"]>>;
+    summary: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    status: "added" | "modified" | "deleted";
+    summary: string;
+}, {
+    path: string;
+    summary: string;
+    status?: "added" | "modified" | "deleted" | undefined;
+}>;
+export type ModifiedFile = z.infer<typeof ModifiedFileSchema>;
+export declare const NextStepSchema: z.ZodObject<{
+    task: z.ZodString;
+    context: z.ZodOptional<z.ZodString>;
+    priority: z.ZodDefault<z.ZodEnum<["immediate", "soon", "later"]>>;
+    file_hint: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    task: string;
+    priority: "immediate" | "soon" | "later";
+    context?: string | undefined;
+    file_hint?: string | undefined;
+}, {
+    task: string;
+    context?: string | undefined;
+    priority?: "immediate" | "soon" | "later" | undefined;
+    file_hint?: string | undefined;
+}>;
+export type NextStep = z.infer<typeof NextStepSchema>;
+export declare const HandoffSchema: z.ZodObject<{
+    /** Schema version — bump when making breaking changes to the format */
+    version: z.ZodDefault<z.ZodLiteral<"1">>;
+    /** ISO 8601 timestamp of when the handoff was created */
+    timestamp: z.ZodString;
+    /** Unique ID for this handoff (used in history filenames) */
+    id: z.ZodString;
+    /** The platform that generated this handoff */
+    source_platform: z.ZodDefault<z.ZodEnum<["claude", "cursor", "copilot", "antigravity", "other"]>>;
+    repository: z.ZodObject<{
+        path: z.ZodString;
+        branch: z.ZodString;
+        head_commit: z.ZodString;
+        head_message: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        branch: string;
+        head_commit: string;
+        head_message?: string | undefined;
+    }, {
+        path: string;
+        branch: string;
+        head_commit: string;
+        head_message?: string | undefined;
+    }>;
+    session: z.ZodObject<{
+        goal: z.ZodString;
+        status: z.ZodEnum<["in_progress", "blocked", "completed"]>;
+        token_exhausted: z.ZodDefault<z.ZodBoolean>;
+        duration_hint: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: "in_progress" | "blocked" | "completed";
+        goal: string;
+        token_exhausted: boolean;
+        duration_hint?: string | undefined;
+    }, {
+        status: "in_progress" | "blocked" | "completed";
+        goal: string;
+        token_exhausted?: boolean | undefined;
+        duration_hint?: string | undefined;
+    }>;
+    /** Key architectural/design decisions made during the session */
+    decisions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        what: z.ZodString;
+        why: z.ZodString;
+        evidence: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        what: string;
+        why: string;
+        evidence?: string | undefined;
+    }, {
+        what: string;
+        why: string;
+        evidence?: string | undefined;
+    }>, "many">>;
+    /** Hard constraints the next agent MUST NOT violate */
+    constraints: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Approaches that were tried and failed — prevents the next agent repeating mistakes */
+    failed_approaches: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        approach: z.ZodString;
+        why_failed: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        approach: string;
+        why_failed: string;
+    }, {
+        approach: string;
+        why_failed: string;
+    }>, "many">>;
+    /** Files that were modified, added, or deleted during the session */
+    files_modified: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        status: z.ZodDefault<z.ZodEnum<["added", "modified", "deleted"]>>;
+        summary: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        status: "added" | "modified" | "deleted";
+        summary: string;
+    }, {
+        path: string;
+        summary: string;
+        status?: "added" | "modified" | "deleted" | undefined;
+    }>, "many">>;
+    /** Ordered list of what the next agent should do */
+    next_steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        task: z.ZodString;
+        context: z.ZodOptional<z.ZodString>;
+        priority: z.ZodDefault<z.ZodEnum<["immediate", "soon", "later"]>>;
+        file_hint: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        task: string;
+        priority: "immediate" | "soon" | "later";
+        context?: string | undefined;
+        file_hint?: string | undefined;
+    }, {
+        task: string;
+        context?: string | undefined;
+        priority?: "immediate" | "soon" | "later" | undefined;
+        file_hint?: string | undefined;
+    }>, "many">>;
+    /** Raw git diff — included for reference, not primary context */
+    raw_diff: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    version: "1";
+    timestamp: string;
+    id: string;
+    source_platform: "claude" | "cursor" | "copilot" | "antigravity" | "other";
+    repository: {
+        path: string;
+        branch: string;
+        head_commit: string;
+        head_message?: string | undefined;
+    };
+    session: {
+        status: "in_progress" | "blocked" | "completed";
+        goal: string;
+        token_exhausted: boolean;
+        duration_hint?: string | undefined;
+    };
+    decisions: {
+        what: string;
+        why: string;
+        evidence?: string | undefined;
+    }[];
+    constraints: string[];
+    failed_approaches: {
+        approach: string;
+        why_failed: string;
+    }[];
+    files_modified: {
+        path: string;
+        status: "added" | "modified" | "deleted";
+        summary: string;
+    }[];
+    next_steps: {
+        task: string;
+        priority: "immediate" | "soon" | "later";
+        context?: string | undefined;
+        file_hint?: string | undefined;
+    }[];
+    raw_diff?: string | undefined;
+}, {
+    timestamp: string;
+    id: string;
+    repository: {
+        path: string;
+        branch: string;
+        head_commit: string;
+        head_message?: string | undefined;
+    };
+    session: {
+        status: "in_progress" | "blocked" | "completed";
+        goal: string;
+        token_exhausted?: boolean | undefined;
+        duration_hint?: string | undefined;
+    };
+    version?: "1" | undefined;
+    source_platform?: "claude" | "cursor" | "copilot" | "antigravity" | "other" | undefined;
+    decisions?: {
+        what: string;
+        why: string;
+        evidence?: string | undefined;
+    }[] | undefined;
+    constraints?: string[] | undefined;
+    failed_approaches?: {
+        approach: string;
+        why_failed: string;
+    }[] | undefined;
+    files_modified?: {
+        path: string;
+        summary: string;
+        status?: "added" | "modified" | "deleted" | undefined;
+    }[] | undefined;
+    next_steps?: {
+        task: string;
+        context?: string | undefined;
+        priority?: "immediate" | "soon" | "later" | undefined;
+        file_hint?: string | undefined;
+    }[] | undefined;
+    raw_diff?: string | undefined;
+}>;
+export type Handoff = z.infer<typeof HandoffSchema>;
+export declare const PartialHandoffSchema: z.ZodObject<{
+    version: z.ZodDefault<z.ZodLiteral<"1">>;
+    timestamp: z.ZodString;
+    id: z.ZodString;
+    source_platform: z.ZodDefault<z.ZodEnum<["claude", "cursor", "copilot", "antigravity", "other"]>>;
+    repository: z.ZodObject<{
+        path: z.ZodString;
+        branch: z.ZodString;
+        head_commit: z.ZodString;
+        head_message: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        branch: string;
+        head_commit: string;
+        head_message?: string | undefined;
+    }, {
+        path: string;
+        branch: string;
+        head_commit: string;
+        head_message?: string | undefined;
+    }>;
+    session: z.ZodObject<{
+        goal: z.ZodString;
+        status: z.ZodEnum<["in_progress", "blocked", "completed"]>;
+        token_exhausted: z.ZodDefault<z.ZodBoolean>;
+        duration_hint: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: "in_progress" | "blocked" | "completed";
+        goal: string;
+        token_exhausted: boolean;
+        duration_hint?: string | undefined;
+    }, {
+        status: "in_progress" | "blocked" | "completed";
+        goal: string;
+        token_exhausted?: boolean | undefined;
+        duration_hint?: string | undefined;
+    }>;
+    decisions: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodObject<{
+        what: z.ZodString;
+        why: z.ZodString;
+        evidence: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        what: string;
+        why: string;
+        evidence?: string | undefined;
+    }, {
+        what: string;
+        why: string;
+        evidence?: string | undefined;
+    }>, "many">>>;
+    constraints: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
+    failed_approaches: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodObject<{
+        approach: z.ZodString;
+        why_failed: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        approach: string;
+        why_failed: string;
+    }, {
+        approach: string;
+        why_failed: string;
+    }>, "many">>>;
+    files_modified: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        status: z.ZodDefault<z.ZodEnum<["added", "modified", "deleted"]>>;
+        summary: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        status: "added" | "modified" | "deleted";
+        summary: string;
+    }, {
+        path: string;
+        summary: string;
+        status?: "added" | "modified" | "deleted" | undefined;
+    }>, "many">>>;
+    next_steps: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodObject<{
+        task: z.ZodString;
+        context: z.ZodOptional<z.ZodString>;
+        priority: z.ZodDefault<z.ZodEnum<["immediate", "soon", "later"]>>;
+        file_hint: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        task: string;
+        priority: "immediate" | "soon" | "later";
+        context?: string | undefined;
+        file_hint?: string | undefined;
+    }, {
+        task: string;
+        context?: string | undefined;
+        priority?: "immediate" | "soon" | "later" | undefined;
+        file_hint?: string | undefined;
+    }>, "many">>>;
+    raw_diff: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    version: "1";
+    timestamp: string;
+    id: string;
+    source_platform: "claude" | "cursor" | "copilot" | "antigravity" | "other";
+    repository: {
+        path: string;
+        branch: string;
+        head_commit: string;
+        head_message?: string | undefined;
+    };
+    session: {
+        status: "in_progress" | "blocked" | "completed";
+        goal: string;
+        token_exhausted: boolean;
+        duration_hint?: string | undefined;
+    };
+    decisions?: {
+        what: string;
+        why: string;
+        evidence?: string | undefined;
+    }[] | undefined;
+    constraints?: string[] | undefined;
+    failed_approaches?: {
+        approach: string;
+        why_failed: string;
+    }[] | undefined;
+    files_modified?: {
+        path: string;
+        status: "added" | "modified" | "deleted";
+        summary: string;
+    }[] | undefined;
+    next_steps?: {
+        task: string;
+        priority: "immediate" | "soon" | "later";
+        context?: string | undefined;
+        file_hint?: string | undefined;
+    }[] | undefined;
+    raw_diff?: string | undefined;
+}, {
+    timestamp: string;
+    id: string;
+    repository: {
+        path: string;
+        branch: string;
+        head_commit: string;
+        head_message?: string | undefined;
+    };
+    session: {
+        status: "in_progress" | "blocked" | "completed";
+        goal: string;
+        token_exhausted?: boolean | undefined;
+        duration_hint?: string | undefined;
+    };
+    version?: "1" | undefined;
+    source_platform?: "claude" | "cursor" | "copilot" | "antigravity" | "other" | undefined;
+    decisions?: {
+        what: string;
+        why: string;
+        evidence?: string | undefined;
+    }[] | undefined;
+    constraints?: string[] | undefined;
+    failed_approaches?: {
+        approach: string;
+        why_failed: string;
+    }[] | undefined;
+    files_modified?: {
+        path: string;
+        summary: string;
+        status?: "added" | "modified" | "deleted" | undefined;
+    }[] | undefined;
+    next_steps?: {
+        task: string;
+        context?: string | undefined;
+        priority?: "immediate" | "soon" | "later" | undefined;
+        file_hint?: string | undefined;
+    }[] | undefined;
+    raw_diff?: string | undefined;
+}>;
+export type PartialHandoff = z.infer<typeof PartialHandoffSchema>;
+export declare const HistoryEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    source_platform: z.ZodEnum<["claude", "cursor", "copilot", "antigravity", "other"]>;
+    goal: z.ZodString;
+    status: z.ZodEnum<["in_progress", "blocked", "completed"]>;
+    file: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: "in_progress" | "blocked" | "completed";
+    goal: string;
+    timestamp: string;
+    id: string;
+    source_platform: "claude" | "cursor" | "copilot" | "antigravity" | "other";
+    file: string;
+}, {
+    status: "in_progress" | "blocked" | "completed";
+    goal: string;
+    timestamp: string;
+    id: string;
+    source_platform: "claude" | "cursor" | "copilot" | "antigravity" | "other";
+    file: string;
+}>;
+export type HistoryEntry = z.infer<typeof HistoryEntrySchema>;
+export declare const HistoryIndexSchema: z.ZodObject<{
+    entries: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        timestamp: z.ZodString;
+        source_platform: z.ZodEnum<["claude", "cursor", "copilot", "antigravity", "other"]>;
+        goal: z.ZodString;
+        status: z.ZodEnum<["in_progress", "blocked", "completed"]>;
+        file: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        status: "in_progress" | "blocked" | "completed";
+        goal: string;
+        timestamp: string;
+        id: string;
+        source_platform: "claude" | "cursor" | "copilot" | "antigravity" | "other";
+        file: string;
+    }, {
+        status: "in_progress" | "blocked" | "completed";
+        goal: string;
+        timestamp: string;
+        id: string;
+        source_platform: "claude" | "cursor" | "copilot" | "antigravity" | "other";
+        file: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    entries: {
+        status: "in_progress" | "blocked" | "completed";
+        goal: string;
+        timestamp: string;
+        id: string;
+        source_platform: "claude" | "cursor" | "copilot" | "antigravity" | "other";
+        file: string;
+    }[];
+}, {
+    entries: {
+        status: "in_progress" | "blocked" | "completed";
+        goal: string;
+        timestamp: string;
+        id: string;
+        source_platform: "claude" | "cursor" | "copilot" | "antigravity" | "other";
+        file: string;
+    }[];
+}>;
+export type HistoryIndex = z.infer<typeof HistoryIndexSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/format/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/format/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,QAAQ,oEAMnB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD,eAAO,MAAM,aAAa,oDAAkD,CAAC;AAC7E,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,eAAO,MAAM,QAAQ,2CAAyC,CAAC;AAC/D,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAIhD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;EAK3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;EAKxB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD,eAAO,MAAM,cAAc;;;;;;;;;;;;EAIzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,oBAAoB;;;;;;;;;EAG/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAI7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;EAKzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAItD,eAAO,MAAM,aAAa;IACxB,uEAAuE;;IAGvE,yDAAyD;;IAGzD,6DAA6D;;IAG7D,+CAA+C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAM/C,iEAAiE;;;;;;;;;;;;;;IAGjE,uDAAuD;;IAGvD,yFAAyF;;;;;;;;;;;IAGzF,qEAAqE;;;;;;;;;;;;;;IAGrE,oDAAoD;;;;;;;;;;;;;;;;;IAGpD,iEAAiE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEjE,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAIpD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAIlE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;EAO7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/format/schema.js

@@ -0,0 +1,90 @@
+import { z } from 'zod';
+// ─── Enums ────────────────────────────────────────────────────────────────────
+export const Platform = z.enum([
+    'claude',
+    'cursor',
+    'copilot',
+    'antigravity',
+    'other',
+]);
+export const SessionStatus = z.enum(['in_progress', 'blocked', 'completed']);
+export const Priority = z.enum(['immediate', 'soon', 'later']);
+// ─── Sub-schemas ──────────────────────────────────────────────────────────────
+export const RepositorySchema = z.object({
+    path: z.string().describe('Absolute path to the repository root'),
+    branch: z.string().describe('Current git branch name'),
+    head_commit: z.string().describe('Short SHA of HEAD commit'),
+    head_message: z.string().optional().describe('Commit message of HEAD'),
+});
+export const SessionSchema = z.object({
+    goal: z.string().describe('What the developer was trying to accomplish in this session'),
+    status: SessionStatus.describe('Current status of the work'),
+    token_exhausted: z.boolean().default(false).describe('Was this handoff triggered by hitting a token limit?'),
+    duration_hint: z.string().optional().describe('Rough estimate of time spent (e.g. "~2 hours")'),
+});
+export const DecisionSchema = z.object({
+    what: z.string().describe('What was decided'),
+    why: z.string().describe('Rationale for the decision'),
+    evidence: z.string().optional().describe('Commit hash, file path, or other reference'),
+});
+export const FailedApproachSchema = z.object({
+    approach: z.string().describe('What was tried'),
+    why_failed: z.string().describe('Why it did not work — be specific so the next agent does not repeat it'),
+});
+export const ModifiedFileSchema = z.object({
+    path: z.string().describe('Relative path from repo root'),
+    status: z.enum(['added', 'modified', 'deleted']).default('modified'),
+    summary: z.string().describe('Brief description of what changed and why'),
+});
+export const NextStepSchema = z.object({
+    task: z.string().describe('What to do next, written as a clear actionable instruction'),
+    context: z.string().optional().describe('Additional context the next agent will need'),
+    priority: Priority.default('immediate'),
+    file_hint: z.string().optional().describe('Specific file or location to look at first'),
+});
+// ─── Root Handoff Schema ──────────────────────────────────────────────────────
+export const HandoffSchema = z.object({
+    /** Schema version — bump when making breaking changes to the format */
+    version: z.literal('1').default('1'),
+    /** ISO 8601 timestamp of when the handoff was created */
+    timestamp: z.string().datetime(),
+    /** Unique ID for this handoff (used in history filenames) */
+    id: z.string(),
+    /** The platform that generated this handoff */
+    source_platform: Platform.default('other'),
+    repository: RepositorySchema,
+    session: SessionSchema,
+    /** Key architectural/design decisions made during the session */
+    decisions: z.array(DecisionSchema).default([]),
+    /** Hard constraints the next agent MUST NOT violate */
+    constraints: z.array(z.string()).default([]),
+    /** Approaches that were tried and failed — prevents the next agent repeating mistakes */
+    failed_approaches: z.array(FailedApproachSchema).default([]),
+    /** Files that were modified, added, or deleted during the session */
+    files_modified: z.array(ModifiedFileSchema).default([]),
+    /** Ordered list of what the next agent should do */
+    next_steps: z.array(NextStepSchema).default([]),
+    /** Raw git diff — included for reference, not primary context */
+    raw_diff: z.string().optional(),
+});
+// ─── Partial schema for in-progress saves ────────────────────────────────────
+export const PartialHandoffSchema = HandoffSchema.partial({
+    decisions: true,
+    constraints: true,
+    failed_approaches: true,
+    files_modified: true,
+    next_steps: true,
+});
+// ─── History entry (lightweight, stored in index) ─────────────────────────────
+export const HistoryEntrySchema = z.object({
+    id: z.string(),
+    timestamp: z.string().datetime(),
+    source_platform: Platform,
+    goal: z.string(),
+    status: SessionStatus,
+    file: z.string().describe('Filename in .relay/history/'),
+});
+export const HistoryIndexSchema = z.object({
+    entries: z.array(HistoryEntrySchema),
+});
+//# sourceMappingURL=schema.js.map

package/dist/format/schema.js.map

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

package/dist/format/template.d.ts

@@ -0,0 +1,44 @@
+import type { Handoff } from './schema.js';
+/**
+ * Returns a human-readable interactive template string used when running
+ * `relay save` in guided mode. This is shown to the user via inquirer prompts.
+ */
+export declare const PLATFORM_CHOICES: readonly [{
+    readonly name: "Claude / Claude Code";
+    readonly value: "claude";
+}, {
+    readonly name: "Cursor";
+    readonly value: "cursor";
+}, {
+    readonly name: "GitHub Copilot";
+    readonly value: "copilot";
+}, {
+    readonly name: "Antigravity";
+    readonly value: "antigravity";
+}, {
+    readonly name: "Other";
+    readonly value: "other";
+}];
+export declare const STATUS_CHOICES: readonly [{
+    readonly name: "🟡 In Progress — more work needed";
+    readonly value: "in_progress";
+}, {
+    readonly name: "🔴 Blocked — stuck, need help";
+    readonly value: "blocked";
+}, {
+    readonly name: "✅ Completed — wrapping up";
+    readonly value: "completed";
+}];
+export declare const PRIORITY_CHOICES: readonly [{
+    readonly name: "🔴 Immediate — do this first";
+    readonly value: "immediate";
+}, {
+    readonly name: "🟡 Soon — after immediate steps";
+    readonly value: "soon";
+}, {
+    readonly name: "🔵 Later — backlog";
+    readonly value: "later";
+}];
+export declare const AGENT_SAVE_PROMPT: string;
+export declare function getExampleHandoff(): Partial<Handoff>;
+//# sourceMappingURL=template.d.ts.map

package/dist/format/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/format/template.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;GAGG;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;EAMnB,CAAC;AAEX,eAAO,MAAM,cAAc;;;;;;;;;EAIjB,CAAC;AAEX,eAAO,MAAM,gBAAgB;;;;;;;;;EAInB,CAAC;AAIX,eAAO,MAAM,iBAAiB,QAoDtB,CAAC;AAIT,wBAAgB,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC,CAuDpD"}