@unpolarize/code-sessions-schema 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -211,6 +211,17 @@ declare const SessionSchema: z.ZodObject<{
     }>>;
     title: z.ZodOptional<z.ZodString>;
     labels: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** lineage when this session was forked from another at a turn ("git for sessions") */
+    forked_from: z.ZodOptional<z.ZodObject<{
+        session_id: z.ZodString;
+        turn_index: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        session_id: string;
+        turn_index: number;
+    }, {
+        session_id: string;
+        turn_index: number;
+    }>>;
     native_ref: z.ZodObject<{
         format: z.ZodString;
         uuid: z.ZodString;
@@ -244,6 +255,10 @@ declare const SessionSchema: z.ZodObject<{
     started_at?: string | undefined;
     ended_at?: string | undefined;
     title?: string | undefined;
+    forked_from?: {
+        session_id: string;
+        turn_index: number;
+    } | undefined;
 }, {
     schema: "session-store/session@1";
     session_id: string;
@@ -267,7 +282,13 @@ declare const SessionSchema: z.ZodObject<{
     } | undefined;
     title?: string | undefined;
     labels?: string[] | undefined;
+    forked_from?: {
+        session_id: string;
+        turn_index: number;
+    } | undefined;
 }>;
+/** What the session was about — the user's intent behind the prompt(s). */
+declare const INTENTS: readonly ["feature", "bugfix", "refactor", "research", "docs", "ops", "review", "chore", "other"];
 declare const SIGNAL_KINDS: readonly ["stuck-loop", "error-recovery", "high-cost-turn", "long-session", "affect-negative", "affect-positive", "tool-heavy", "other"];
 declare const SignalSchema: z.ZodObject<{
     kind: z.ZodEnum<["stuck-loop", "error-recovery", "high-cost-turn", "long-session", "affect-negative", "affect-positive", "tool-heavy", "other"]>;
@@ -275,12 +296,12 @@ declare const SignalSchema: z.ZodObject<{
     turn_index: z.ZodOptional<z.ZodNumber>;
     note: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
-    kind: "stuck-loop" | "error-recovery" | "high-cost-turn" | "long-session" | "affect-negative" | "affect-positive" | "tool-heavy" | "other";
+    kind: "other" | "stuck-loop" | "error-recovery" | "high-cost-turn" | "long-session" | "affect-negative" | "affect-positive" | "tool-heavy";
     severity: "info" | "warn" | "critical";
     turn_index?: number | undefined;
     note?: string | undefined;
 }, {
-    kind: "stuck-loop" | "error-recovery" | "high-cost-turn" | "long-session" | "affect-negative" | "affect-positive" | "tool-heavy" | "other";
+    kind: "other" | "stuck-loop" | "error-recovery" | "high-cost-turn" | "long-session" | "affect-negative" | "affect-positive" | "tool-heavy";
     turn_index?: number | undefined;
     severity?: "info" | "warn" | "critical" | undefined;
     note?: string | undefined;
@@ -293,19 +314,23 @@ declare const InsightsSchema: z.ZodObject<{
     generated_at: z.ZodString;
     provider: z.ZodString;
     topic: z.ZodOptional<z.ZodString>;
+    /** what the session was about (feature/bugfix/research/…) */
+    intent: z.ZodOptional<z.ZodEnum<["feature", "bugfix", "refactor", "research", "docs", "ops", "review", "chore", "other"]>>;
     tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** project ids the session touched (derived from edited file paths) */
+    projects: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     signals: z.ZodDefault<z.ZodArray<z.ZodObject<{
         kind: z.ZodEnum<["stuck-loop", "error-recovery", "high-cost-turn", "long-session", "affect-negative", "affect-positive", "tool-heavy", "other"]>;
         severity: z.ZodDefault<z.ZodEnum<["info", "warn", "critical"]>>;
         turn_index: z.ZodOptional<z.ZodNumber>;
         note: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
-        kind: "stuck-loop" | "error-recovery" | "high-cost-turn" | "long-session" | "affect-negative" | "affect-positive" | "tool-heavy" | "other";
+        kind: "other" | "stuck-loop" | "error-recovery" | "high-cost-turn" | "long-session" | "affect-negative" | "affect-positive" | "tool-heavy";
         severity: "info" | "warn" | "critical";
         turn_index?: number | undefined;
         note?: string | undefined;
     }, {
-        kind: "stuck-loop" | "error-recovery" | "high-cost-turn" | "long-session" | "affect-negative" | "affect-positive" | "tool-heavy" | "other";
+        kind: "other" | "stuck-loop" | "error-recovery" | "high-cost-turn" | "long-session" | "affect-negative" | "affect-positive" | "tool-heavy";
         turn_index?: number | undefined;
         severity?: "info" | "warn" | "critical" | undefined;
         note?: string | undefined;
@@ -318,13 +343,15 @@ declare const InsightsSchema: z.ZodObject<{
     generated_at: string;
     provider: string;
     tags: string[];
+    projects: string[];
     signals: {
-        kind: "stuck-loop" | "error-recovery" | "high-cost-turn" | "long-session" | "affect-negative" | "affect-positive" | "tool-heavy" | "other";
+        kind: "other" | "stuck-loop" | "error-recovery" | "high-cost-turn" | "long-session" | "affect-negative" | "affect-positive" | "tool-heavy";
         severity: "info" | "warn" | "critical";
         turn_index?: number | undefined;
         note?: string | undefined;
     }[];
     topic?: string | undefined;
+    intent?: "feature" | "bugfix" | "refactor" | "research" | "docs" | "ops" | "review" | "chore" | "other" | undefined;
     summary?: string | undefined;
 }, {
     schema: "session-store/insights@1";
@@ -333,9 +360,11 @@ declare const InsightsSchema: z.ZodObject<{
     generated_at: string;
     provider: string;
     topic?: string | undefined;
+    intent?: "feature" | "bugfix" | "refactor" | "research" | "docs" | "ops" | "review" | "chore" | "other" | undefined;
     tags?: string[] | undefined;
+    projects?: string[] | undefined;
     signals?: {
-        kind: "stuck-loop" | "error-recovery" | "high-cost-turn" | "long-session" | "affect-negative" | "affect-positive" | "tool-heavy" | "other";
+        kind: "other" | "stuck-loop" | "error-recovery" | "high-cost-turn" | "long-session" | "affect-negative" | "affect-positive" | "tool-heavy";
         turn_index?: number | undefined;
         severity?: "info" | "warn" | "critical" | undefined;
         note?: string | undefined;
@@ -353,6 +382,7 @@ type Insights = z.infer<typeof InsightsSchema>;
 type AgentKind = (typeof AGENTS)[number];
 type Role = (typeof ROLES)[number];
 type SignalKind = (typeof SIGNAL_KINDS)[number];
+type Intent = (typeof INTENTS)[number];
 declare const SCHEMA_VERSIONS: {
     readonly turn: "session-store/turn@1";
     readonly session: "session-store/session@1";
@@ -470,6 +500,10 @@ declare const parseSession: (data: unknown) => {
     started_at?: string | undefined;
     ended_at?: string | undefined;
     title?: string | undefined;
+    forked_from?: {
+        session_id: string;
+        turn_index: number;
+    } | undefined;
 };
 declare const parseInsights: (data: unknown) => {
     schema: "session-store/insights@1";
@@ -478,13 +512,15 @@ declare const parseInsights: (data: unknown) => {
     generated_at: string;
     provider: string;
     tags: string[];
+    projects: string[];
     signals: {
-        kind: "stuck-loop" | "error-recovery" | "high-cost-turn" | "long-session" | "affect-negative" | "affect-positive" | "tool-heavy" | "other";
+        kind: "other" | "stuck-loop" | "error-recovery" | "high-cost-turn" | "long-session" | "affect-negative" | "affect-positive" | "tool-heavy";
         severity: "info" | "warn" | "critical";
         turn_index?: number | undefined;
         note?: string | undefined;
     }[];
     topic?: string | undefined;
+    intent?: "feature" | "bugfix" | "refactor" | "research" | "docs" | "ops" | "review" | "chore" | "other" | undefined;
     summary?: string | undefined;
 };
 /** Non-throwing validation. */
@@ -566,6 +602,10 @@ declare const safeParseSession: (data: unknown) => zod.SafeParseReturnType<{
     } | undefined;
     title?: string | undefined;
     labels?: string[] | undefined;
+    forked_from?: {
+        session_id: string;
+        turn_index: number;
+    } | undefined;
 }, {
     schema: "session-store/session@1";
     session_id: string;
@@ -589,6 +629,10 @@ declare const safeParseSession: (data: unknown) => zod.SafeParseReturnType<{
     started_at?: string | undefined;
     ended_at?: string | undefined;
     title?: string | undefined;
+    forked_from?: {
+        session_id: string;
+        turn_index: number;
+    } | undefined;
 }>;
 declare const safeParseInsights: (data: unknown) => zod.SafeParseReturnType<{
     schema: "session-store/insights@1";
@@ -597,9 +641,11 @@ declare const safeParseInsights: (data: unknown) => zod.SafeParseReturnType<{
     generated_at: string;
     provider: string;
     topic?: string | undefined;
+    intent?: "feature" | "bugfix" | "refactor" | "research" | "docs" | "ops" | "review" | "chore" | "other" | undefined;
     tags?: string[] | undefined;
+    projects?: string[] | undefined;
     signals?: {
-        kind: "stuck-loop" | "error-recovery" | "high-cost-turn" | "long-session" | "affect-negative" | "affect-positive" | "tool-heavy" | "other";
+        kind: "other" | "stuck-loop" | "error-recovery" | "high-cost-turn" | "long-session" | "affect-negative" | "affect-positive" | "tool-heavy";
         turn_index?: number | undefined;
         severity?: "info" | "warn" | "critical" | undefined;
         note?: string | undefined;
@@ -612,14 +658,16 @@ declare const safeParseInsights: (data: unknown) => zod.SafeParseReturnType<{
     generated_at: string;
     provider: string;
     tags: string[];
+    projects: string[];
     signals: {
-        kind: "stuck-loop" | "error-recovery" | "high-cost-turn" | "long-session" | "affect-negative" | "affect-positive" | "tool-heavy" | "other";
+        kind: "other" | "stuck-loop" | "error-recovery" | "high-cost-turn" | "long-session" | "affect-negative" | "affect-positive" | "tool-heavy";
         severity: "info" | "warn" | "critical";
         turn_index?: number | undefined;
         note?: string | undefined;
     }[];
     topic?: string | undefined;
+    intent?: "feature" | "bugfix" | "refactor" | "research" | "docs" | "ops" | "review" | "chore" | "other" | undefined;
     summary?: string | undefined;
 }>;
 
-export { AGENTS, type AgentKind, type BuildTurnContext, type ClaudeSessionMeta, type Insights, InsightsSchema, NativeRefSchema, type NormalizedEvent, ROLES, type Role, SCHEMA_VERSIONS, SIGNAL_KINDS, type SessionEnvelope, SessionSchema, type Signal, type SignalKind, SignalSchema, type Telemetry, TelemetrySchema, type ToolCall, ToolCallSchema, type Totals, TotalsSchema, type Turn, TurnSchema, type Usage, UsageSchema, buildTurn, extractClaudeSessionMeta, insightsJsonSchema, normalizeClaudeEvent, normalizeClaudeLines, parseInsights, parseSession, parseTurn, safeParseInsights, safeParseSession, safeParseTurn, sessionJsonSchema, turnJsonSchema };
+export { AGENTS, type AgentKind, type BuildTurnContext, type ClaudeSessionMeta, INTENTS, type Insights, InsightsSchema, type Intent, NativeRefSchema, type NormalizedEvent, ROLES, type Role, SCHEMA_VERSIONS, SIGNAL_KINDS, type SessionEnvelope, SessionSchema, type Signal, type SignalKind, SignalSchema, type Telemetry, TelemetrySchema, type ToolCall, ToolCallSchema, type Totals, TotalsSchema, type Turn, TurnSchema, type Usage, UsageSchema, buildTurn, extractClaudeSessionMeta, insightsJsonSchema, normalizeClaudeEvent, normalizeClaudeLines, parseInsights, parseSession, parseTurn, safeParseInsights, safeParseSession, safeParseTurn, sessionJsonSchema, turnJsonSchema };

package/dist/index.js

@@ -60,8 +60,21 @@ var SessionSchema = z.object({
   totals: TotalsSchema.default({}),
   title: z.string().optional(),
   labels: z.array(z.string()).default([]),
+  /** lineage when this session was forked from another at a turn ("git for sessions") */
+  forked_from: z.object({ session_id: z.string(), turn_index: z.number().int().nonnegative() }).strict().optional(),
   native_ref: NativeRefSchema
 }).strict();
+var INTENTS = [
+  "feature",
+  "bugfix",
+  "refactor",
+  "research",
+  "docs",
+  "ops",
+  "review",
+  "chore",
+  "other"
+];
 var SIGNAL_KINDS = [
   "stuck-loop",
   "error-recovery",
@@ -85,7 +98,11 @@ var InsightsSchema = z.object({
   generated_at: z.string(),
   provider: z.string(),
   topic: z.string().optional(),
+  /** what the session was about (feature/bugfix/research/…) */
+  intent: z.enum(INTENTS).optional(),
   tags: z.array(z.string()).default([]),
+  /** project ids the session touched (derived from edited file paths) */
+  projects: z.array(z.string()).default([]),
   signals: z.array(SignalSchema).default([]),
   summary: z.string().optional()
 }).strict();
@@ -249,6 +266,7 @@ var safeParseSession = (data) => SessionSchema.safeParse(data);
 var safeParseInsights = (data) => InsightsSchema.safeParse(data);
 export {
   AGENTS,
+  INTENTS,
   InsightsSchema,
   NativeRefSchema,
   ROLES,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unpolarize/code-sessions-schema",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Canonical wire schema for cross-agent session records (turns, envelopes, insights)",
   "license": "MIT",
   "type": "module",
@@ -13,9 +13,18 @@
       "default": "./src/index.ts"
     }
   },
-  "files": ["dist", "src"],
-  "publishConfig": { "access": "public" },
-  "repository": { "type": "git", "url": "git+https://github.com/unpolarize/code-sessions.git", "directory": "packages/schema" },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/unpolarize/code-sessions.git",
+    "directory": "packages/schema"
+  },
   "scripts": {
     "build": "tsup src/index.ts --format esm --dts --clean --out-dir dist"
   },

package/src/schemas.ts

@@ -90,10 +90,28 @@ export const SessionSchema = z
     totals: TotalsSchema.default({}),
     title: z.string().optional(),
     labels: z.array(z.string()).default([]),
+    /** lineage when this session was forked from another at a turn ("git for sessions") */
+    forked_from: z
+      .object({ session_id: z.string(), turn_index: z.number().int().nonnegative() })
+      .strict()
+      .optional(),
     native_ref: NativeRefSchema,
   })
   .strict();
 
+/** What the session was about — the user's intent behind the prompt(s). */
+export const INTENTS = [
+  'feature',
+  'bugfix',
+  'refactor',
+  'research',
+  'docs',
+  'ops',
+  'review',
+  'chore',
+  'other',
+] as const;
+
 export const SIGNAL_KINDS = [
   'stuck-loop',
   'error-recovery',
@@ -123,7 +141,11 @@ export const InsightsSchema = z
     generated_at: z.string(),
     provider: z.string(),
     topic: z.string().optional(),
+    /** what the session was about (feature/bugfix/research/…) */
+    intent: z.enum(INTENTS).optional(),
     tags: z.array(z.string()).default([]),
+    /** project ids the session touched (derived from edited file paths) */
+    projects: z.array(z.string()).default([]),
     signals: z.array(SignalSchema).default([]),
     summary: z.string().optional(),
   })
@@ -140,6 +162,7 @@ export type Insights = z.infer<typeof InsightsSchema>;
 export type AgentKind = (typeof AGENTS)[number];
 export type Role = (typeof ROLES)[number];
 export type SignalKind = (typeof SIGNAL_KINDS)[number];
+export type Intent = (typeof INTENTS)[number];
 
 export const SCHEMA_VERSIONS = {
   turn: 'session-store/turn@1',