@aligndottech/cli 0.34.1 → 0.35.0

package/dist/lib/sessions/fs-scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-scan.js","sourceRoot":"","sources":["../../../src/lib/sessions/fs-scan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,OAAe;IAC9D,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QACnD,CAAC;aAAM,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;wCACwC;AACxC,MAAM,UAAU,eAAe,CAAC,KAAe;IAC7C,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AAC9E,CAAC"}

package/dist/lib/sessions/registry.d.ts

@@ -0,0 +1,11 @@
+import type { SessionAdapter } from './types.js';
+export declare const ADAPTERS: SessionAdapter[];
+export interface DetectedAgent {
+    adapter: SessionAdapter;
+    files: string[];
+}
+/** `align import sessions`' auto-detect: every agent that has actually left session data
+ *  for this project. An agent with zero files is "never run here" - the normal case for
+ *  five of six adapters on any one machine - so it is silently excluded, not reported. */
+export declare function detectAgents(cwd: string, adapters?: SessionAdapter[]): DetectedAgent[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/lib/sessions/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/lib/sessions/registry.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,QAAQ,EAAE,cAAc,EAEpC,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;0FAE0F;AAC1F,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,GAAE,cAAc,EAAa,GAAG,aAAa,EAAE,CAOhG"}

package/dist/lib/sessions/registry.js

@@ -0,0 +1,22 @@
+import { claudeCodeAdapter } from './adapters/claude-code.js';
+import { codexAdapter } from './adapters/codex.js';
+import { cursorAdapter } from './adapters/cursor.js';
+import { geminiCliAdapter } from './adapters/gemini-cli.js';
+import { opencodeAdapter } from './adapters/opencode.js';
+import { piAdapter } from './adapters/pi.js';
+export const ADAPTERS = [
+    claudeCodeAdapter, codexAdapter, cursorAdapter, geminiCliAdapter, opencodeAdapter, piAdapter,
+];
+/** `align import sessions`' auto-detect: every agent that has actually left session data
+ *  for this project. An agent with zero files is "never run here" - the normal case for
+ *  five of six adapters on any one machine - so it is silently excluded, not reported. */
+export function detectAgents(cwd, adapters = ADAPTERS) {
+    const found = [];
+    for (const adapter of adapters) {
+        const files = adapter.locateSessionFiles(cwd);
+        if (files.length > 0)
+            found.push({ adapter, files });
+    }
+    return found;
+}
+//# sourceMappingURL=registry.js.map

package/dist/lib/sessions/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/lib/sessions/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG7C,MAAM,CAAC,MAAM,QAAQ,GAAqB;IACxC,iBAAiB,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS;CAC7F,CAAC;AAOF;;0FAE0F;AAC1F,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,WAA6B,QAAQ;IAC7E,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;QAC9C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/lib/sessions/source-url.d.ts

@@ -0,0 +1,10 @@
+import type { AgentName } from './types.js';
+/** ALI-808 shared contract: the agent name lives in the scheme, `platform` stays the single
+ *  value `agent-session` everywhere else. */
+export declare function buildSessionSourceUrl(agent: AgentName, sessionId: string, messageId: string): string;
+export declare function parseSessionSourceUrl(url: string): {
+    agent: AgentName;
+    sessionId: string;
+    messageId: string;
+} | null;
+//# sourceMappingURL=source-url.d.ts.map

package/dist/lib/sessions/source-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-url.d.ts","sourceRoot":"","sources":["../../../src/lib/sessions/source-url.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI5C;6CAC6C;AAC7C,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEpG;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAWpH"}

package/dist/lib/sessions/source-url.js

@@ -0,0 +1,20 @@
+const AGENTS = ['claude-code', 'codex', 'cursor', 'gemini-cli', 'opencode', 'pi'];
+/** ALI-808 shared contract: the agent name lives in the scheme, `platform` stays the single
+ *  value `agent-session` everywhere else. */
+export function buildSessionSourceUrl(agent, sessionId, messageId) {
+    return `${agent}-session://${sessionId}/${messageId}`;
+}
+export function parseSessionSourceUrl(url) {
+    for (const agent of AGENTS) {
+        const prefix = `${agent}-session://`;
+        if (url.startsWith(prefix)) {
+            const rest = url.slice(prefix.length);
+            const slash = rest.indexOf('/');
+            if (slash === -1)
+                return null;
+            return { agent, sessionId: rest.slice(0, slash), messageId: rest.slice(slash + 1) };
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=source-url.js.map

package/dist/lib/sessions/source-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-url.js","sourceRoot":"","sources":["../../../src/lib/sessions/source-url.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAAyB,CAAC,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;AAExG;6CAC6C;AAC7C,MAAM,UAAU,qBAAqB,CAAC,KAAgB,EAAE,SAAiB,EAAE,SAAiB;IAC1F,OAAO,GAAG,KAAK,cAAc,SAAS,IAAI,SAAS,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,GAAG,KAAK,aAAa,CAAC;QACrC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACtC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAChC,IAAI,KAAK,KAAK,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC9B,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;QACtF,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/lib/sessions/types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * ALI-808: the canonical shape every per-agent adapter parses into, so extraction (Pass A,
+ * and eventually ALI-809's Pass B) never learns which agent it is reading - the same
+ * `normalizeHookPayload` pattern used for the destructive-command guard (ALI-357/#1953) and
+ * the pre-edit conflict check (align-cli#86), both cited in the ALI-608 addendum.
+ */
+/** The six agents named in the ALI-808 shared contract. Not every adapter parses content yet
+ *  (see `fixtureVerified` on SessionAdapter) - the name is reserved even where the reader
+ *  is not, because it is also the scheme host in a session's source_url. */
+export type AgentName = 'claude-code' | 'codex' | 'cursor' | 'gemini-cli' | 'opencode' | 'pi';
+export interface SessionToolCall {
+    id: string;
+    name: string;
+    arguments: unknown;
+}
+export interface SessionTurn {
+    role: 'user' | 'assistant';
+    /** The turn's own text, own words - never a tool result or a system reminder. Empty
+     *  string, not absent, when a turn is tool-calls-only (keeps every consumer's access
+     *  uniform rather than optional-chaining everywhere). */
+    text: string;
+    toolCalls: SessionToolCall[];
+    /** Keyed by SessionToolCall.id, when the transcript records a result for it. A missing
+     *  key means "no result recorded", not "empty result" - the two are different facts
+     *  (a cancelled tool call vs. one that returned nothing). */
+    toolResults: Record<string, string>;
+    /** ISO-8601, or null when the source did not carry one for this turn. */
+    timestamp: string | null;
+}
+export interface CanonicalSession {
+    agent: AgentName;
+    sessionId: string;
+    /** The working directory the agent was running in, when the source records one. */
+    cwd: string | null;
+    turns: SessionTurn[];
+}
+export interface SessionAdapter {
+    agent: AgentName;
+    /** True only when a real captured session backs this adapter's fixture (the ALI-808
+     *  shared-contract gate: "the gate is the fixture, not the agent name"). False means
+     *  `parseSession` is intentionally unimplemented - see fixtures/sessions/README.md for
+     *  which agents and why. */
+    fixtureVerified: boolean;
+    /** Session files for the given project directory, newest first. Never throws on a
+     *  missing/unreadable agent data directory - that is "this agent has no local data
+     *  here", not an error, and every caller (detectAgents, the import command) treats an
+     *  empty array as the normal "not installed / never used here" case. */
+    locateSessionFiles(cwd: string): string[];
+    /** Parses one session file. Returns null for a file that does not belong to this agent's
+     *  format (defensive - locateSessionFiles should not hand it one, but a caller passing an
+     *  arbitrary path must get an honest null rather than a throw). Throws
+     *  SessionFormatUnverifiedError for an adapter with fixtureVerified === false. */
+    parseSession(filePath: string): CanonicalSession | null;
+}
+/** Thrown by an unverified adapter's parseSession, instead of guessing at a format nobody
+ *  has confirmed against a real session (verification.md: a plausible construction is not
+ *  data). Naming the fixtures README in the message is deliberate - it is the one place
+ *  that explains why and what unblocks it. */
+export declare class SessionFormatUnverifiedError extends Error {
+    constructor(agent: AgentName);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/sessions/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/sessions/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;4EAE4E;AAC5E,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,IAAI,CAAC;AAE9F,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B;;6DAEyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B;;iEAE6D;IAC7D,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,yEAAyE;IACzE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,SAAS,CAAC;IACjB;;;gCAG4B;IAC5B,eAAe,EAAE,OAAO,CAAC;IACzB;;;4EAGwE;IACxE,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1C;;;sFAGkF;IAClF,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAAC;CACzD;AAED;;;8CAG8C;AAC9C,qBAAa,4BAA6B,SAAQ,KAAK;gBACzC,KAAK,EAAE,SAAS;CAQ7B"}

package/dist/lib/sessions/types.js

@@ -0,0 +1,19 @@
+/**
+ * ALI-808: the canonical shape every per-agent adapter parses into, so extraction (Pass A,
+ * and eventually ALI-809's Pass B) never learns which agent it is reading - the same
+ * `normalizeHookPayload` pattern used for the destructive-command guard (ALI-357/#1953) and
+ * the pre-edit conflict check (align-cli#86), both cited in the ALI-608 addendum.
+ */
+/** Thrown by an unverified adapter's parseSession, instead of guessing at a format nobody
+ *  has confirmed against a real session (verification.md: a plausible construction is not
+ *  data). Naming the fixtures README in the message is deliberate - it is the one place
+ *  that explains why and what unblocks it. */
+export class SessionFormatUnverifiedError extends Error {
+    constructor(agent) {
+        super(`${agent}'s session format is not fixture-verified yet (no real captured session was ` +
+            `available - see src/__tests__/fixtures/sessions/README.md). Capture a real session and ` +
+            `add it as a fixture before parsing this agent's data.`);
+        this.name = 'SessionFormatUnverifiedError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/lib/sessions/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/sessions/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuDH;;;8CAG8C;AAC9C,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IACrD,YAAY,KAAgB;QAC1B,KAAK,CACH,GAAG,KAAK,8EAA8E;YACtF,yFAAyF;YACzF,uDAAuD,CACxD,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aligndottech/cli",
-  "version": "0.34.1",
+  "version": "0.35.0",
   "mcpName": "io.github.aligndottech/cli",
   "type": "module",
   "description": "Align CLI - capture decisions, check alignment, and manage connectors",