auden 0.1.0-alpha.2

package/dist/usage/extract.js

@@ -0,0 +1,200 @@
+import { readFile, readdir } from 'node:fs/promises';
+import { basename, dirname, extname, join } from 'node:path';
+import { inferProviderFromModel } from './providers.js';
+/** Same SKILL.md identification idiom as `rules/discover.ts`'s `isSkillMd`. */
+function isSkillMdPath(path) {
+    return basename(path).toLowerCase() === 'skill.md';
+}
+function asRecord(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return null;
+    }
+    return value;
+}
+/**
+ * Detects a skill-load signal in one assistant message's content blocks
+ * (docs/plans/token-cost-tracking-plan.md §13.2): either an explicit `Skill`
+ * tool_use (input.skill names the skill), or a file-read tool_use whose path
+ * targets a `SKILL.md` (skill name = its parent directory). Only the first
+ * signal in a message is used — a message that requests two skill loads at
+ * once is a rare edge case not worth the double-counting risk of attributing
+ * the next message's usage to both.
+ */
+function detectSkillLoadSignal(message) {
+    const content = message.content;
+    if (!Array.isArray(content)) {
+        return null;
+    }
+    for (const block of content) {
+        const blockRecord = asRecord(block);
+        if (!blockRecord || blockRecord.type !== 'tool_use') {
+            continue;
+        }
+        const toolName = typeof blockRecord.name === 'string' ? blockRecord.name : null;
+        const input = asRecord(blockRecord.input);
+        if (toolName === 'Skill') {
+            const skillName = typeof input?.skill === 'string' ? input.skill : null;
+            if (skillName) {
+                return skillName;
+            }
+            continue;
+        }
+        const path = typeof input?.file_path === 'string'
+            ? input.file_path
+            : typeof input?.path === 'string'
+                ? input.path
+                : null;
+        if (path && isSkillMdPath(path)) {
+            return basename(dirname(path));
+        }
+    }
+    return null;
+}
+function toNonNegativeInt(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value >= 0
+        ? Math.floor(value)
+        : 0;
+}
+async function collectJsonlFiles(dir) {
+    const entries = await readdir(dir, { withFileTypes: true });
+    const files = await Promise.all(entries.map(async (entry) => {
+        const fullPath = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            return collectJsonlFiles(fullPath);
+        }
+        return extname(entry.name) === '.jsonl' ? [fullPath] : [];
+    }));
+    return files.flat().sort();
+}
+async function readJsonlRecords(path) {
+    const raw = await readFile(path, 'utf8');
+    return raw
+        .split('\n')
+        .map((line) => line.trim())
+        .filter(Boolean)
+        .flatMap((line) => {
+        try {
+            return [JSON.parse(line)];
+        }
+        catch {
+            return [];
+        }
+    });
+}
+/**
+ * Extracts per-session, per-model token usage from Claude Code JSONL
+ * transcripts (docs/plans/token-cost-tracking-plan.md §5.1), plus per-skill
+ * Tier-1 "load overhead" usage (§13.3): when an assistant message requests a
+ * `Skill` tool or reads a `SKILL.md`, the *next* assistant message's usage is
+ * the first-load cost of that skill (v1 approximation — see §13.3's caching
+ * nuance). Reads only `usage`/`model`/`sessionId` and tool_use `name`/`input`
+ * off assistant messages — never message text.
+ *
+ * Each message carries its own (non-cumulative) usage, so we sum every
+ * assistant message's usage per (session, model). Messages are deduped by
+ * their id so re-reading a transcript that grew since the last sync does not
+ * double-count lines already summed.
+ */
+export async function extractRunUsage(options) {
+    if (!options?.transcriptsDir) {
+        return { runUsage: [], skillUsage: [] };
+    }
+    const files = await collectJsonlFiles(options.transcriptsDir).catch(() => []);
+    const sessionUsage = new Map();
+    const sessionSkillUsage = new Map();
+    const pendingSkillLoads = new Map();
+    const seenMessageIds = new Set();
+    for (const file of files) {
+        const fallbackSessionId = basename(file, extname(file));
+        const records = await readJsonlRecords(file);
+        for (const recordValue of records) {
+            const record = asRecord(recordValue);
+            if (!record || record.type !== 'assistant') {
+                continue;
+            }
+            const message = asRecord(record.message);
+            if (!message) {
+                continue;
+            }
+            const usage = asRecord(message.usage);
+            if (!usage) {
+                continue;
+            }
+            const model = typeof message.model === 'string' ? message.model : null;
+            if (!model) {
+                continue;
+            }
+            const messageId = typeof message.id === 'string'
+                ? message.id
+                : typeof record.uuid === 'string'
+                    ? record.uuid
+                    : null;
+            if (messageId) {
+                if (seenMessageIds.has(messageId)) {
+                    continue;
+                }
+                seenMessageIds.add(messageId);
+            }
+            const sessionId = typeof record.sessionId === 'string' && record.sessionId.length > 0
+                ? record.sessionId
+                : fallbackSessionId;
+            const modelMap = sessionUsage.get(sessionId) ?? new Map();
+            sessionUsage.set(sessionId, modelMap);
+            const existing = modelMap.get(model) ?? {
+                model,
+                provider: inferProviderFromModel(model),
+                inputTokens: 0,
+                outputTokens: 0,
+                cacheReadTokens: 0,
+                cacheWriteTokens: 0,
+            };
+            modelMap.set(model, {
+                ...existing,
+                inputTokens: existing.inputTokens + toNonNegativeInt(usage.input_tokens),
+                outputTokens: existing.outputTokens + toNonNegativeInt(usage.output_tokens),
+                cacheReadTokens: (existing.cacheReadTokens ?? 0) +
+                    toNonNegativeInt(usage.cache_read_input_tokens),
+                cacheWriteTokens: (existing.cacheWriteTokens ?? 0) +
+                    toNonNegativeInt(usage.cache_creation_input_tokens),
+            });
+            // Attribute this message's usage to a skill load requested by the
+            // *previous* assistant message, if any — this message is the first turn
+            // to see that skill's content in context. Must run before detecting a
+            // new signal below, so a message that both closes one load and opens
+            // another handles both correctly.
+            const pendingSkillName = pendingSkillLoads.get(sessionId);
+            if (pendingSkillName) {
+                pendingSkillLoads.delete(sessionId);
+                const skillMap = sessionSkillUsage.get(sessionId) ?? new Map();
+                sessionSkillUsage.set(sessionId, skillMap);
+                const skillKey = `${pendingSkillName}::${model}`;
+                const existingSkillUsage = skillMap.get(skillKey) ?? {
+                    skillName: pendingSkillName,
+                    model,
+                    inputTokens: 0,
+                    cacheWriteTokens: 0,
+                };
+                skillMap.set(skillKey, {
+                    ...existingSkillUsage,
+                    inputTokens: existingSkillUsage.inputTokens + toNonNegativeInt(usage.input_tokens),
+                    cacheWriteTokens: (existingSkillUsage.cacheWriteTokens ?? 0) +
+                        toNonNegativeInt(usage.cache_creation_input_tokens),
+                });
+            }
+            const skillLoadSignal = detectSkillLoadSignal(message);
+            if (skillLoadSignal) {
+                pendingSkillLoads.set(sessionId, skillLoadSignal);
+            }
+        }
+    }
+    const runUsage = Array.from(sessionUsage.entries()).map(([sessionId, modelMap]) => ({
+        sessionId,
+        usage: Array.from(modelMap.values()),
+    }));
+    const skillUsage = Array.from(sessionSkillUsage.entries()).map(([sessionId, skillMap]) => ({
+        sessionId,
+        usage: Array.from(skillMap.values()),
+    }));
+    return { runUsage, skillUsage };
+}
+//# sourceMappingURL=extract.js.map

package/dist/usage/extract.js.map

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

package/dist/usage/providers.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Infers a model's API provider from its id prefix
+ * (docs/plans/token-cost-tracking-plan.md §8: "derive `provider` from model id
+ * prefix when the transcript doesn't state it"). Returns `undefined` rather
+ * than guessing wrong for an id we don't recognize.
+ */
+export declare function inferProviderFromModel(model: string): string | undefined;
+//# sourceMappingURL=providers.d.ts.map

package/dist/usage/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../src/usage/providers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAiBxE"}

package/dist/usage/providers.js

@@ -0,0 +1,23 @@
+/**
+ * Infers a model's API provider from its id prefix
+ * (docs/plans/token-cost-tracking-plan.md §8: "derive `provider` from model id
+ * prefix when the transcript doesn't state it"). Returns `undefined` rather
+ * than guessing wrong for an id we don't recognize.
+ */
+export function inferProviderFromModel(model) {
+    if (model.startsWith('claude-') || model.startsWith('anthropic/')) {
+        return 'anthropic';
+    }
+    if (model.startsWith('gpt-') ||
+        model.startsWith('o1-') ||
+        model.startsWith('o3-') ||
+        model.startsWith('o4-') ||
+        model.startsWith('openai/')) {
+        return 'openai';
+    }
+    if (model.startsWith('gemini-') || model.startsWith('google/')) {
+        return 'google';
+    }
+    return undefined;
+}
+//# sourceMappingURL=providers.js.map

package/dist/usage/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../src/usage/providers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,IAAI,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAClE,OAAO,WAAW,CAAA;IACpB,CAAC;IACD,IACE,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC;QACxB,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC;QACvB,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC;QACvB,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC;QACvB,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,EAC3B,CAAC;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/D,OAAO,QAAQ,CAAA;IACjB,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC"}

package/dist/verdict-queue.d.ts

@@ -0,0 +1,50 @@
+import type { DashboardSyncAction } from '@auden.to/protocol';
+export type VerdictQueueResult = {
+    actions: DashboardSyncAction[];
+    filePaths: string[];
+    /**
+     * Files that were read in full but whose content is not a valid queued
+     * verdict (bad JSON or failing schema). They will never become valid, so the
+     * caller deletes them instead of re-warning about them on every run. Files
+     * that only failed to read (transient I/O, permissions) are omitted — they
+     * are left in place to retry next time.
+     */
+    invalidFilePaths: string[];
+};
+/**
+ * Read all valid queued verdict files from `dir`.
+ * Returns the mapped sync actions, the absolute paths of the files that
+ * produced them (so the caller can delete them after a successful sync), and
+ * the paths of files whose content is permanently invalid (so the caller can
+ * clean them up instead of re-warning about them on every run).
+ */
+export declare function readVerdictQueue(dir: string): Promise<VerdictQueueResult>;
+/**
+ * Hard cap on pending queued verdicts. Bounds disk growth if the dashboard is
+ * unreachable for a long stretch — nothing else limited how many `auden
+ * verdict record` calls could pile up in `~/.auden/queue` while an outage
+ * lasts. Past the cap, the oldest entries are evicted to make room for new
+ * ones: a long enough outage loses old verdicts rather than filling the disk.
+ */
+export declare const MAX_QUEUED_VERDICTS = 5000;
+export type EnforceQueueCapResult = {
+    /** Number of oldest queue files deleted to get back under the cap. */
+    evicted: number;
+};
+/**
+ * Trim `dir` down to `maxEntries` queued verdict files. No-op when the
+ * directory is missing or already within the cap — that check is a cheap
+ * `readdir` with no file reads, since it runs on every `auden verdict
+ * record` call and the common case is nowhere near the cap.
+ *
+ * Once over the cap, permanently-invalid entries (bad JSON or failing
+ * schema — the same classification `readVerdictQueue` uses) are evicted
+ * first regardless of age: they can never be synced, so deleting them costs
+ * nothing, whereas evicting a still-syncable verdict is real data loss.
+ * Only once invalid entries are exhausted does eviction fall back to the
+ * oldest valid verdicts (by file mtime). Best-effort throughout: a file that
+ * fails to delete is left in place rather than throwing — eviction is
+ * housekeeping, not the operation the caller is actually trying to perform.
+ */
+export declare function enforceVerdictQueueCap(dir: string, maxEntries?: number): Promise<EnforceQueueCapResult>;
+//# sourceMappingURL=verdict-queue.d.ts.map

package/dist/verdict-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verdict-queue.d.ts","sourceRoot":"","sources":["../src/verdict-queue.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAc7D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,mBAAmB,EAAE,CAAA;IAC9B,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB;;;;;;OAMG;IACH,gBAAgB,EAAE,MAAM,EAAE,CAAA;CAC3B,CAAA;AAaD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAgD/E;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,OAAO,CAAA;AAEvC,MAAM,MAAM,qBAAqB,GAAG;IAClC,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,EACX,UAAU,GAAE,MAA4B,GACvC,OAAO,CAAC,qBAAqB,CAAC,CAsChC"}

package/dist/verdict-queue.js

@@ -0,0 +1,131 @@
+import { readFile, readdir, stat, unlink } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { VerdictSchema } from '@auden.to/protocol';
+import * as v from 'valibot';
+const QueuedVerdictSchema = v.object({
+    id: v.string(),
+    sessionId: v.string(),
+    actionType: v.string(),
+    summary: v.string(),
+    verdict: VerdictSchema,
+    timestamp: v.string(),
+});
+function toSyncAction(entry) {
+    return {
+        id: entry.id,
+        sessionId: entry.sessionId,
+        actionType: entry.actionType,
+        summary: entry.summary,
+        verdict: entry.verdict,
+        metadata: { recordedAt: entry.timestamp },
+    };
+}
+/**
+ * Read all valid queued verdict files from `dir`.
+ * Returns the mapped sync actions, the absolute paths of the files that
+ * produced them (so the caller can delete them after a successful sync), and
+ * the paths of files whose content is permanently invalid (so the caller can
+ * clean them up instead of re-warning about them on every run).
+ */
+export async function readVerdictQueue(dir) {
+    const actions = [];
+    const filePaths = [];
+    const invalidFilePaths = [];
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true, encoding: 'utf8' });
+    }
+    catch {
+        return { actions, filePaths, invalidFilePaths };
+    }
+    const jsonFiles = entries.filter((d) => d.isFile() && d.name.endsWith('.json'));
+    for (const dirent of jsonFiles) {
+        // dirent.parentPath was added in Node 21.4; dirent.path is the equivalent
+        // property available in Node 20. Fall back to dir as a safety net.
+        const absPath = resolve(dirent.parentPath ?? dirent.path ?? dir, dirent.name);
+        let raw;
+        try {
+            raw = await readFile(absPath, 'utf8');
+        }
+        catch (err) {
+            // ENOENT is a harmless readdir/read race (the file was removed between
+            // the listing and the read) — stay silent and retry next run. Any other
+            // read failure (permissions, I/O) is a real queue file we can neither
+            // sync nor safely delete, so surface it rather than black-holing it: it
+            // would otherwise show as neither pending nor invalid anywhere.
+            if (err?.code !== 'ENOENT') {
+                console.warn(`  warning: could not read queue file ${absPath}: ${err?.message}`);
+            }
+            continue;
+        }
+        try {
+            const parsed = v.parse(QueuedVerdictSchema, JSON.parse(raw));
+            actions.push(toSyncAction(parsed));
+            filePaths.push(absPath);
+        }
+        catch {
+            // Read in full but the content is not a valid queued verdict — it will
+            // never become valid, so mark it for cleanup by the caller.
+            invalidFilePaths.push(absPath);
+        }
+    }
+    return { actions, filePaths, invalidFilePaths };
+}
+/**
+ * Hard cap on pending queued verdicts. Bounds disk growth if the dashboard is
+ * unreachable for a long stretch — nothing else limited how many `auden
+ * verdict record` calls could pile up in `~/.auden/queue` while an outage
+ * lasts. Past the cap, the oldest entries are evicted to make room for new
+ * ones: a long enough outage loses old verdicts rather than filling the disk.
+ */
+export const MAX_QUEUED_VERDICTS = 5000;
+/**
+ * Trim `dir` down to `maxEntries` queued verdict files. No-op when the
+ * directory is missing or already within the cap — that check is a cheap
+ * `readdir` with no file reads, since it runs on every `auden verdict
+ * record` call and the common case is nowhere near the cap.
+ *
+ * Once over the cap, permanently-invalid entries (bad JSON or failing
+ * schema — the same classification `readVerdictQueue` uses) are evicted
+ * first regardless of age: they can never be synced, so deleting them costs
+ * nothing, whereas evicting a still-syncable verdict is real data loss.
+ * Only once invalid entries are exhausted does eviction fall back to the
+ * oldest valid verdicts (by file mtime). Best-effort throughout: a file that
+ * fails to delete is left in place rather than throwing — eviction is
+ * housekeeping, not the operation the caller is actually trying to perform.
+ */
+export async function enforceVerdictQueueCap(dir, maxEntries = MAX_QUEUED_VERDICTS) {
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true, encoding: 'utf8' });
+    }
+    catch {
+        return { evicted: 0 };
+    }
+    const jsonFiles = entries.filter((d) => d.isFile() && d.name.endsWith('.json'));
+    if (jsonFiles.length <= maxEntries)
+        return { evicted: 0 };
+    const { filePaths: validPaths, invalidFilePaths } = await readVerdictQueue(dir);
+    let overflow = validPaths.length + invalidFilePaths.length - maxEntries;
+    if (overflow <= 0)
+        return { evicted: 0 };
+    let evicted = 0;
+    const invalidToEvict = invalidFilePaths.slice(0, overflow);
+    if (invalidToEvict.length > 0) {
+        const results = await Promise.allSettled(invalidToEvict.map((p) => unlink(p)));
+        evicted += results.filter((r) => r.status === 'fulfilled').length;
+        overflow -= invalidToEvict.length;
+    }
+    if (overflow > 0) {
+        const withMtime = await Promise.all(validPaths.map(async (absPath) => {
+            const info = await stat(absPath).catch(() => null);
+            return { absPath, mtimeMs: info?.mtimeMs ?? 0 };
+        }));
+        withMtime.sort((a, b) => a.mtimeMs - b.mtimeMs);
+        const validToEvict = withMtime.slice(0, overflow);
+        const results = await Promise.allSettled(validToEvict.map((f) => unlink(f.absPath)));
+        evicted += results.filter((r) => r.status === 'fulfilled').length;
+    }
+    return { evicted };
+}
+//# sourceMappingURL=verdict-queue.js.map

package/dist/verdict-queue.js.map

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

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "auden",
+  "version": "0.1.0-alpha.2",
+  "private": false,
+  "description": "Local-first CLI for Auden — evaluates AI coding agent actions against your guides on-device and syncs verdicts to your dashboard.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "auden": "./dist/bin.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/.tsbuildinfo",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/auden-to/auden.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://app.auden.to",
+  "keywords": [
+    "ai",
+    "agents",
+    "claude-code",
+    "agent-guidance",
+    "evaluation",
+    "cli"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": false
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.json && node -e \"require('node:fs').chmodSync('dist/bin.js', 0o755)\"",
+    "dev": "tsc --project tsconfig.json --watch",
+    "typecheck": "tsc --project tsconfig.json --noEmit",
+    "lint": "oxlint",
+    "lint:fix": "oxfmt && oxlint --fix",
+    "format": "oxfmt",
+    "format:check": "oxfmt --check",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@auden.to/eval-core": "0.1.0-alpha.2",
+    "@auden.to/projections": "0.1.0-alpha.2",
+    "@auden.to/protocol": "0.1.0-alpha.2",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "citty": "^0.1.6",
+    "diff": "^9.0.0"
+  },
+  "overrides": {
+    "fast-uri": "3.1.4"
+  },
+  "devDependencies": {
+    "@types/diff": "^8.0.0",
+    "@types/node": "^20.0.0",
+    "typescript": "*"
+  }
+}