@aligndottech/cli 0.48.0 → 0.50.0

package/dist/lib/llm-providers.js

@@ -0,0 +1,150 @@
+/**
+ * The providers `align ask` can write answers with, as data: their ids, labels, the env vars
+ * that carry their keys and models, endpoints and default models, and which ones a user can
+ * save a key for. Shared by local-llm.ts (resolution and preference), the config store, the
+ * launcher (which must not leak these variables to an agent) and the `align ai` / first-ask
+ * prompts, so there is one list rather than several that drift. Dependency-free on purpose.
+ */
+/**
+ * In the fixed fallback order (ALI-1284: Groq ahead of Gemini, so the free pairing has a real
+ * primary). A provider is only ever tried when the user has a key for it.
+ */
+export const NAMED_PROVIDERS = [
+    {
+        autoFromEnv: true,
+        id: 'anthropic', label: 'Anthropic', keyEnv: ['ANTHROPIC_API_KEY'], modelEnv: 'ALIGN_ANTHROPIC_MODEL',
+        defaultModel: 'claude-haiku-4-5-20251001', api: 'anthropic', keyUrl: 'https://console.anthropic.com/settings/keys',
+    },
+    {
+        autoFromEnv: true,
+        id: 'openai', label: 'OpenAI', keyEnv: ['OPENAI_API_KEY'], modelEnv: 'ALIGN_OPENAI_MODEL',
+        defaultModel: 'gpt-4o-mini', api: 'openai', endpoint: 'https://api.openai.com/v1/chat/completions',
+        keyUrl: 'https://platform.openai.com/api-keys',
+    },
+    {
+        autoFromEnv: true,
+        id: 'groq', label: 'Groq', keyEnv: ['GROQ_API_KEY'], modelEnv: 'ALIGN_GROQ_MODEL',
+        defaultModel: 'llama-3.1-8b-instant', api: 'openai', endpoint: 'https://api.groq.com/openai/v1/chat/completions',
+        keyUrl: 'https://console.groq.com/keys',
+    },
+    {
+        // ALI-1284: a Flash-Lite model, which is what the free pairing is sold as. Override with
+        // ALIGN_GEMINI_MODEL if Google retires it.
+        autoFromEnv: true,
+        id: 'gemini', label: 'Gemini', keyEnv: ['GEMINI_API_KEY', 'GOOGLE_API_KEY'], modelEnv: 'ALIGN_GEMINI_MODEL',
+        defaultModel: 'gemini-2.5-flash-lite', api: 'gemini', keyUrl: 'https://aistudio.google.com/apikey',
+    },
+    {
+        autoFromEnv: true,
+        id: 'mistral', label: 'Mistral', keyEnv: ['MISTRAL_API_KEY'], modelEnv: 'ALIGN_MISTRAL_MODEL',
+        defaultModel: 'mistral-small-latest', api: 'openai', endpoint: 'https://api.mistral.ai/v1/chat/completions',
+        keyUrl: 'https://console.mistral.ai/api-keys',
+    },
+    {
+        autoFromEnv: true,
+        id: 'grok', label: 'xAI', keyEnv: ['GROK_API_KEY', 'XAI_API_KEY'], modelEnv: 'ALIGN_GROK_MODEL',
+        defaultModel: 'grok-2-latest', api: 'openai', endpoint: 'https://api.x.ai/v1/chat/completions',
+        keyUrl: 'https://console.x.ai',
+    },
+    // ---- Appended after the original six, so they only run when the user has their key. ----
+    // Source for every env var name, base URL, API shape and model id below, unless a comment
+    // says otherwise: @earendil-works/pi-ai 0.87.1 (MIT), dist/env-api-keys.js and
+    // dist/providers/data/<id>.json. Default models are the cheapest current id that table lists
+    // for the provider, preferring a non-reasoning model where one is cheap (a reasoning model
+    // spends align's 1,024-token answer budget thinking).
+    openAi('deepseek', 'DeepSeek', ['DEEPSEEK_API_KEY'], 'https://api.deepseek.com/chat/completions', 'deepseek-flash', 'https://platform.deepseek.com/api_keys'),
+    // pi-ai lists the GLM Coding Plan endpoint (/api/coding/paas/v4). This is Z.ai's GENERAL
+    // endpoint, for an ordinary pay-as-you-go key - https://docs.z.ai/api-reference/introduction
+    // says the coding endpoint is only for Coding Plan subscribers.
+    openAi('zai', 'Z.ai (GLM)', ['ZAI_API_KEY'], 'https://api.z.ai/api/paas/v4/chat/completions', 'glm-5.3-flash', 'https://z.ai/manage-apikey/apikey-list'),
+    openAi('moonshotai', 'Moonshot (Kimi)', ['MOONSHOT_API_KEY'], 'https://api.moonshot.ai/v1/chat/completions', 'kimi-k2.6', 'https://platform.moonshot.ai/console/api-keys'),
+    openAi('cerebras', 'Cerebras', ['CEREBRAS_API_KEY'], 'https://api.cerebras.ai/v1/chat/completions', 'gpt-oss-120b', 'https://cloud.cerebras.ai'),
+    openAi('fireworks', 'Fireworks AI', ['FIREWORKS_API_KEY'], 'https://api.fireworks.ai/inference/v1/chat/completions', 'accounts/fireworks/models/glm-5p3-flash', 'https://app.fireworks.ai/settings/users/api-keys'),
+    openAi('together', 'Together AI', ['TOGETHER_API_KEY'], 'https://api.together.ai/v1/chat/completions', 'Qwen/Qwen2.5-7B-Instruct-Turbo', 'https://api.together.ai/settings/api-keys'),
+    openAi('nvidia', 'NVIDIA', ['NVIDIA_API_KEY'], 'https://integrate.api.nvidia.com/v1/chat/completions', 'google/gemma-3-12b-it', 'https://build.nvidia.com'),
+    openAi('huggingface', 'Hugging Face', ['HF_TOKEN'], 'https://router.huggingface.co/v1/chat/completions', 'meta-llama/Llama-3.1-8B-Instruct', 'https://huggingface.co/settings/tokens'),
+    openAi('baseten', 'Baseten', ['BASETEN_API_KEY'], 'https://inference.baseten.co/v1/chat/completions', 'deepseek-ai/DeepSeek-V4-Flash-0731', 'https://app.baseten.co/settings/api_keys'),
+    openAi('xiaomi', 'Xiaomi MiMo', ['XIAOMI_API_KEY'], 'https://api.xiaomimimo.com/v1/chat/completions', 'mimo-v2.5', 'https://platform.xiaomimimo.com'),
+    {
+        // Alibaba Model Studio: an ordinary Model Studio key (what the paste prompt's console link
+        // issues), at the international DashScope compatible-mode domain Alibaba documents as
+        // still valid - https://www.alibabacloud.com/help/en/model-studio/base-url - with
+        // qwen3.5-flash from https://www.alibabacloud.com/help/en/model-studio/qwen-api-via-openai-chat-completions.
+        id: 'qwen', label: 'Qwen (Alibaba Model Studio)', keyEnv: ['DASHSCOPE_API_KEY'], modelEnv: 'ALIGN_QWEN_MODEL',
+        defaultModel: 'qwen3.5-flash', api: 'openai',
+        endpoint: 'https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions',
+        keyUrl: 'https://modelstudio.console.alibabacloud.com',
+    },
+    // The Alibaba Token Plan: a different product on a different host; a key for one is
+    // rejected by the other. Env name, endpoint and model from pi-ai.
+    openAi('qwen-token-plan', 'Qwen Token Plan', ['QWEN_TOKEN_PLAN_API_KEY'], 'https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions', 'qwen3.6-flash', 'https://modelstudio.console.alibabacloud.com'),
+    // These three speak Anthropic Messages in pi-ai's table, so they reuse align's Anthropic
+    // adapter at their own base URL (POST <base>/v1/messages). UNVERIFIED: that each accepts the
+    // Anthropic-style `x-api-key` header rather than only a Bearer token - no live call was made.
+    anthropicAt('minimax', 'MiniMax', ['MINIMAX_API_KEY'], 'https://api.minimax.io/anthropic/v1/messages', 'MiniMax-M2.7', 'https://platform.minimax.io'),
+    anthropicAt('kimi-coding', 'Kimi Coding Plan', ['KIMI_API_KEY'], 'https://api.kimi.com/coding/v1/messages', 'kimi-for-coding', 'https://www.kimi.com/code'),
+    anthropicAt('vercel-ai-gateway', 'Vercel AI Gateway', ['AI_GATEWAY_API_KEY'], 'https://ai-gateway.vercel.sh/v1/messages', 'openai/gpt-4o-mini', 'https://vercel.com/dashboard/ai-gateway'),
+    // Not included: cloudflare-workers-ai (needs CLOUDFLARE_ACCOUNT_ID in the URL) and Azure
+    // OpenAI (a per-resource endpoint, deployment name and api-version) - neither fits a fixed
+    // endpoint. Both work today through ALIGN_LLM_BASE_URL.
+];
+function modelEnvFor(id) {
+    return `ALIGN_${id.toUpperCase().replace(/[^A-Z0-9]+/g, '_')}_MODEL`;
+}
+function openAi(id, label, keyEnv, endpoint, defaultModel, keyUrl) {
+    return { id, label, keyEnv, modelEnv: modelEnvFor(id), defaultModel, api: 'openai', endpoint, keyUrl };
+}
+function anthropicAt(id, label, keyEnv, endpoint, defaultModel, keyUrl) {
+    return { id, label, keyEnv, modelEnv: modelEnvFor(id), defaultModel, api: 'anthropic', endpoint, keyUrl };
+}
+export const OPENROUTER_BASE_URL = 'https://openrouter.ai/api/v1';
+export const OPENROUTER_DEFAULT_MODEL = 'openai/gpt-4o-mini';
+/** OpenRouter's own key variable (pi-ai's name) and align's model override for it. */
+export const OPENROUTER_KEY_ENV = 'OPENROUTER_API_KEY';
+export const OPENROUTER_MODEL_ENV = 'ALIGN_OPENROUTER_MODEL';
+/** Every id `ALIGN_LLM_PROVIDER` / `align ai --provider` accepts. */
+export const LLM_PROVIDER_IDS = [
+    ...NAMED_PROVIDERS.map((p) => p.id), 'openrouter', 'custom', 'ollama',
+];
+/**
+ * The providers a key can be saved for, in the order the key prompt lists them: the original
+ * seven first (OpenRouter third, as it always was), then the rest in table order.
+ */
+export const STORABLE_PROVIDERS = [
+    'anthropic', 'openai', 'openrouter', 'gemini', 'groq', 'mistral', 'grok',
+    ...NAMED_PROVIDERS.map((p) => p.id).filter((id) => !['anthropic', 'openai', 'gemini', 'groq', 'mistral', 'grok'].includes(id)),
+];
+export function namedProvider(id) {
+    return NAMED_PROVIDERS.find((p) => p.id === id);
+}
+export const PROVIDER_LABEL = {
+    ...Object.fromEntries(NAMED_PROVIDERS.map((p) => [p.id, p.label])),
+    openrouter: 'OpenRouter',
+    custom: 'Custom endpoint',
+    ollama: 'Ollama',
+};
+/** Where to get a key, shown beside the paste prompt. */
+export const PROVIDER_KEY_URL = {
+    ...Object.fromEntries(NAMED_PROVIDERS.map((p) => [p.id, p.keyUrl])),
+    openrouter: 'https://openrouter.ai/keys',
+};
+/**
+ * Every env variable that carries an align LLM credential, endpoint, model or preference. The
+ * launcher resets each one to the value the user's shell had when align started, so nothing
+ * align put into its own environment reaches a coding agent (a saved ANTHROPIC_API_KEY would
+ * switch Claude Code from a Max subscription to API billing).
+ */
+export const PROVIDER_ENV_VARS = [
+    ...NAMED_PROVIDERS.flatMap((p) => [...p.keyEnv, p.modelEnv]),
+    'ALIGN_LLM_BASE_URL', 'ALIGN_LLM_API_KEY', 'ALIGN_LLM_MODEL', 'ALIGN_LLM_PROVIDER', 'ALIGN_OLLAMA_MODEL',
+    OPENROUTER_KEY_ENV, OPENROUTER_MODEL_ENV,
+];
+const ALIASES = { xai: 'grok' };
+/** A user-typed provider id, normalised, or null when it names nothing we support. */
+export function parseProviderId(raw) {
+    const id = raw.trim().toLowerCase();
+    if (ALIASES[id])
+        return ALIASES[id];
+    return LLM_PROVIDER_IDS.includes(id) ? id : null;
+}
+//# sourceMappingURL=llm-providers.js.map

package/dist/lib/llm-providers.js.map

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

package/dist/lib/local-db-epoch.d.ts

@@ -0,0 +1,4 @@
+import type { DatabaseSync } from 'node:sqlite';
+export declare function rowSetEpoch(db: DatabaseSync): number;
+export declare function bumpRowSetEpoch(db: DatabaseSync): void;
+//# sourceMappingURL=local-db-epoch.d.ts.map

package/dist/lib/local-db-epoch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-db-epoch.d.ts","sourceRoot":"","sources":["../../src/lib/local-db-epoch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAehD,wBAAgB,WAAW,CAAC,EAAE,EAAE,YAAY,GAAG,MAAM,CAEpD;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAEtD"}

package/dist/lib/local-db-epoch.js

@@ -0,0 +1,19 @@
+/**
+ * A per-connection counter that goes up whenever a decision is deleted or re-id'd, or an
+ * embedding is deleted or replaced. A holder of a COPY of the graph's embeddings (the ingest
+ * matrix) remembers the value it built at and rebuilds when it moves, so staleness is
+ * impossible by construction: it does not depend on the holder knowing which code paths
+ * delete rows. Kept beside the connection and not in the schema, so it costs no migration.
+ *
+ * Every writer of those changes calls bumpRowSetEpoch: deleteDecisionWithDependents,
+ * absorbLoser, the open-time duplicate collapse, dropAll and setEmbedding over an existing
+ * row. local-db-row-set-epoch.test.ts has one test per path.
+ */
+const epochs = new WeakMap();
+export function rowSetEpoch(db) {
+    return epochs.get(db) ?? 0;
+}
+export function bumpRowSetEpoch(db) {
+    epochs.set(db, rowSetEpoch(db) + 1);
+}
+//# sourceMappingURL=local-db-epoch.js.map

package/dist/lib/local-db-epoch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-db-epoch.js","sourceRoot":"","sources":["../../src/lib/local-db-epoch.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,GAAG,IAAI,OAAO,EAAwB,CAAC;AAEnD,MAAM,UAAU,WAAW,CAAC,EAAgB;IAC1C,OAAO,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,EAAgB;IAC9C,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;AACtC,CAAC"}

package/dist/lib/local-db-migrate.d.ts

@@ -0,0 +1,85 @@
+import type { DatabaseSync } from 'node:sqlite';
+export declare const SCHEMA = "\nCREATE TABLE IF NOT EXISTS decisions (\n  id TEXT PRIMARY KEY,\n  title TEXT NOT NULL,\n  summary TEXT NOT NULL,\n  source_url TEXT,\n  platform TEXT NOT NULL DEFAULT 'cli',\n  created_at TEXT NOT NULL DEFAULT (datetime('now')),\n  repo TEXT,\n  decided_at TEXT,\n  decider_kind TEXT,\n  confirmed_by TEXT,\n  confirmed_at TEXT,\n  ratified_by TEXT,\n  ratified_at TEXT\n);\n\nCREATE TABLE IF NOT EXISTS decision_audit (\n  id TEXT PRIMARY KEY,\n  decision_id TEXT NOT NULL,\n  action TEXT NOT NULL,\n  actor TEXT,\n  detail TEXT,\n  created_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE TABLE IF NOT EXISTS decision_embeddings (\n  decision_id TEXT PRIMARY KEY REFERENCES decisions(id) ON DELETE CASCADE,\n  embedding BLOB NOT NULL,\n  model TEXT\n);\n\nCREATE TABLE IF NOT EXISTS decision_links (\n  id TEXT PRIMARY KEY,\n  source_id TEXT NOT NULL REFERENCES decisions(id) ON DELETE CASCADE,\n  target_id TEXT NOT NULL REFERENCES decisions(id) ON DELETE CASCADE,\n  relation TEXT NOT NULL,\n  confidence REAL NOT NULL DEFAULT 1.0,\n  created_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE TABLE IF NOT EXISTS decision_refs (\n  decision_id TEXT NOT NULL REFERENCES decisions(id) ON DELETE CASCADE,\n  ref TEXT NOT NULL,\n  platform TEXT NOT NULL,\n  PRIMARY KEY (decision_id, ref)\n);\n";
+/**
+ * Schema version this build expects. Bump when adding a step to `migrate`.
+ *
+ * Exported so a test can assert the migration WROTE the version it claims, without hardcoding
+ * the number - a test pinning a literal 1 had to be edited by this change rather than passing
+ * or failing on its own merits. A parity test also derives the highest `version <` branch in
+ * `migrate` from the source and compares it here, because forgetting the bump leaves the new
+ * branch running destructively on every open with nothing to stop it.
+ */
+export declare const SCHEMA_VERSION = 11;
+/** The title connector-core 0.5.0 gave every Slack thread whose root was deleted. The 0.6.0
+ *  fetcher titles such a thread from its first human message, or drops it; either way this
+ *  row is a duplicate-to-be under the (source_url, title) key, or noise. */
+export declare const SLACK_TOMBSTONE_TITLE = "This message was deleted.";
+/**
+ * One-time data migrations, tracked in SQLite's built-in `user_version`.
+ *
+ * 1. ALI-503: relabel the cosine-similarity links that were written as `conflicts_with`.
+ *    Every such row at version 0 is provably an artefact, because `insertLink` had exactly
+ *    one caller and it hardcoded that relation for any pair over 0.65 cosine. No classifier
+ *    verdict was ever persisted, so there is no earned row to damage.
+ *
+ * 2. A decision's `source_url` identifies it, and nothing enforced that: `insertDecision` minted
+ *    a fresh UUID per call, so re-importing the same commit added a second copy. The documented
+ *    first run does exactly that - `setup --local` seeds from git, then its own outro tells you
+ *    to run `align connect git` - so a graph goes from 2 decisions to 4 by following the tips.
+ *    Collapse the existing duplicates, then make them unrepresentable with a unique index.
+ *
+ * 3. ALI-798: add the `repo` column (missing on any graph that predates it) and backfill it
+ *    for every existing row from `source_url`, via the same `repoFromSourceUrl` the importer
+ *    now stamps new rows with - one reader of the URL shape, used for both. A row whose
+ *    source is not code (Jira, Slack, a bare capture) stays NULL, which is "unattributed",
+ *    not "wrong": `--repo` scoping always includes unattributed rows alongside the named
+ *    repo (see local-gateway-client.ts), so nothing existing becomes invisible.
+ *
+ * 4. ALI-829: add `decided_at` - when the decision was MADE, from the source's own
+ *    timestamp, as distinct from `created_at`, the minute this CLI imported it. Every one
+ *    of the 684 rows in the 2026-09-02 measurement carried the ingest minute and nothing
+ *    else, so "what changed since March" was unanswerable offline. No backfill, unlike
+ *    `repo`: a repo is derivable from a stored source_url, and a decision date is not
+ *    derivable from anything already in the row. A re-import fills it in; inventing one
+ *    from created_at would write the exact wrong fact this column exists to correct.
+ *
+ *    Same bump, second step: drop the Slack rows titled by a deleted root. The 0.6.0
+ *    fetcher titles a thread from its first human message, and the dedup key is
+ *    (source_url, title), so each of those rows would otherwise be re-inserted BESIDE its
+ *    tombstone twin on the next import (35 of 39 on the 2026-09-02 graph). The next import
+ *    recreates the real ones with real titles; the ones that were only bot output on a
+ *    deleted root do not come back, which is the point. Foreign keys are off in this
+ *    database (see step 2), so the dependent rows are deleted explicitly - including any
+ *    link a human adjudicated on such a row. That is a real loss, accepted: the row's
+ *    identity is changing under it, and the re-import classifies the retitled thread
+ *    afresh. Scoped to platform = 'slack': a git commit or a captured note that happens to
+ *    carry the same words is not a tombstone and is left alone.
+ *
+ * 5. ALI-831: add the decider/ratified columns (`decider_kind`, `confirmed_by`,
+ *    `confirmed_at`, `ratified_by`, `ratified_at`) so an agent-made decision can enter as a
+ *    CLAIM a human later stands behind, and the `decision_audit` table the human act is
+ *    recorded in. No backfill, on purpose: a row captured before the column reads as
+ *    'unknown', and stamping 'human' on it from its platform would be the retroactive
+ *    guess align-stack's migration 113 refuses. The columns are added here rather than only
+ *    in SCHEMA because CREATE TABLE IF NOT EXISTS never alters an existing table.
+ *
+ * 6. ALI-787: tag each embedding with the model that produced it (see LEGACY_EMBEDDING_MODEL).
+ *
+ * 7. L2: per-source sync state, `source_key` identity with a backed-up twin merge,
+ *    `detail_pending`, `enriched_at` (NULL on every existing row) and `local_judgements`.
+ *    See local-db-v7.ts.
+ *
+ * The version guard is load-bearing rather than tidiness. The same UPDATE run on every open
+ * is indistinguishable from this one today, and starts silently eating genuine conflicts the
+ * moment anything writes one.
+ */
+/**
+ * Remove a decision and everything hanging off it. Foreign keys are off in this database
+ * (see migrate, step 2), so the dependents are named explicitly rather than cascaded. One
+ * writer for the v4 tombstone sweep and the ingest-time twin removal (ALI-829).
+ */
+export declare function deleteDecisionWithDependents(db: DatabaseSync, id: string): void;
+/** The one downgrade guard: migrate() and every other writer of this file (the sync state, purge) call it. */
+export declare function assertSchemaSupported(version: number): void;
+export declare function migrate(db: DatabaseSync): void;
+//# sourceMappingURL=local-db-migrate.d.ts.map

package/dist/lib/local-db-migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-db-migrate.d.ts","sourceRoot":"","sources":["../../src/lib/local-db-migrate.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQhD,eAAO,MAAM,MAAM,oyCA+ClB,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC;;4EAE4E;AAC5E,eAAO,MAAM,qBAAqB,8BAA8B,CAAC;AAoBjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAO/E;AAED,8GAA8G;AAC9G,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAO3D;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAoS9C"}