@aligndottech/cli 0.34.1 → 0.36.0

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/dist/lib/token-estimate.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Chars per token, measured (2026-09-03 research doc) with Anthropic's count_tokens against a
+ * rendered decision corpus: 2.56 on 4.7+ models, 3.43 on older ones. The SMALLER ratio is the
+ * conservative one - it estimates MORE tokens per char - so Phase 0 uses it for every family.
+ * Never chars/4: that under-counts our corpus by ~36% and the under-count is silent.
+ * The per-family table is ALI-852.
+ */
+export declare const CHARS_PER_TOKEN = 2.56;
+export declare const ESTIMATE_MARGIN = 1.1;
+/** Conservative token estimate for a string: rounds UP, and adds a 10% margin on top. */
+export declare function estimateTokens(text: string): number;
+/**
+ * The char budget that fits `tokens`, inverse of estimateTokens. Rounds DOWN, so a caller
+ * that slices text to `charsForTokens(n)` characters never re-estimates above `n`.
+ */
+export declare function charsForTokens(tokens: number): number;
+//# sourceMappingURL=token-estimate.d.ts.map

package/dist/lib/token-estimate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimate.d.ts","sourceRoot":"","sources":["../../src/lib/token-estimate.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,OAAO,CAAC;AACpC,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,yFAAyF;AACzF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/lib/token-estimate.js

@@ -0,0 +1,24 @@
+// ALI-845 Phase 0: no token-estimation helper existed anywhere in the CLI, so every
+// prompt was assembled by concatenating decision text with no cap. This is the
+// conservative estimator for that phase - a real per-family table is ALI-852's job.
+/**
+ * Chars per token, measured (2026-09-03 research doc) with Anthropic's count_tokens against a
+ * rendered decision corpus: 2.56 on 4.7+ models, 3.43 on older ones. The SMALLER ratio is the
+ * conservative one - it estimates MORE tokens per char - so Phase 0 uses it for every family.
+ * Never chars/4: that under-counts our corpus by ~36% and the under-count is silent.
+ * The per-family table is ALI-852.
+ */
+export const CHARS_PER_TOKEN = 2.56;
+export const ESTIMATE_MARGIN = 1.1;
+/** Conservative token estimate for a string: rounds UP, and adds a 10% margin on top. */
+export function estimateTokens(text) {
+    return Math.ceil((text.length / CHARS_PER_TOKEN) * ESTIMATE_MARGIN);
+}
+/**
+ * The char budget that fits `tokens`, inverse of estimateTokens. Rounds DOWN, so a caller
+ * that slices text to `charsForTokens(n)` characters never re-estimates above `n`.
+ */
+export function charsForTokens(tokens) {
+    return Math.floor((tokens * CHARS_PER_TOKEN) / ESTIMATE_MARGIN);
+}
+//# sourceMappingURL=token-estimate.js.map

package/dist/lib/token-estimate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimate.js","sourceRoot":"","sources":["../../src/lib/token-estimate.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,+EAA+E;AAC/E,oFAAoF;AAEpF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC;AACpC,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC;AAEnC,yFAAyF;AACzF,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC,GAAG,eAAe,CAAC,CAAC;AACtE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,eAAe,CAAC,GAAG,eAAe,CAAC,CAAC;AAClE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aligndottech/cli",
-  "version": "0.34.1",
+  "version": "0.36.0",
   "mcpName": "io.github.aligndottech/cli",
   "type": "module",
   "description": "Align CLI - capture decisions, check alignment, and manage connectors",
@@ -65,6 +65,15 @@
   "optionalDependencies": {
     "@huggingface/transformers": "^4.2.0"
   },
+  "overrides": {
+    "hono": "4.13.7",
+    "@hono/node-server": "1.19.17",
+    "undici": "6.28.1",
+    "fast-uri": "3.1.7",
+    "ip-address": "10.7.0",
+    "qs": "6.16.0",
+    "body-parser": "2.3.0"
+  },
   "engines": {
     "node": ">=22.16"
   },