@bububuger/spanory 0.1.16 → 0.1.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bububuger/spanory",
-  "version": "0.1.16",
+  "version": "0.1.19",
   "description": "Spanory CLI for cross-runtime agent observability",
   "license": "MIT",
   "type": "module",
@@ -10,21 +10,25 @@
     "directory": "packages/cli"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
   },
   "files": [
-    "dist"
+    "dist/index.js",
+    "dist/index.d.ts"
   ],
   "bin": {
     "spanory": "dist/index.js"
   },
   "scripts": {
-    "check": "tsc -p tsconfig.runtime.json --noEmit",
-    "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.runtime.json",
-    "test": "vitest run test/unit",
+    "check": "npm run --workspace @bububuger/core build && tsc -p tsconfig.runtime.json --noEmit",
+    "build:deps": "npm run --workspace @bububuger/core build && npm run --workspace @bububuger/otlp-core build && npm run --workspace @bububuger/backend-langfuse build",
+    "build": "npm run build:deps && node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.runtime.json && npx esbuild dist/index.js --bundle --platform=node --format=esm --target=node18 --external:node:* --external:commander --outfile=dist/index.bundle.js && node -e \"require('node:fs').renameSync('dist/index.bundle.js','dist/index.js')\" && chmod +x dist/index.js",
+    "test": "npm run build && vitest run test/unit",
     "test:bdd": "npm run build && vitest run test/bdd",
+    "pack:test-install": "bash test/pack-test-install.sh",
     "test:golden:update": "npm run build && node test/fixtures/golden/otlp/update-golden.mjs && node test/fixtures/golden/codex/update-golden.mjs",
-    "build:bundle": "npm run --workspace @bububuger/backend-langfuse build && npm run --workspace @bububuger/otlp-core build && npm run build && mkdir -p build && esbuild dist/index.js --bundle --platform=node --format=cjs --target=node18 --outfile=build/spanory.cjs",
+    "build:bundle": "npm run --workspace @bububuger/backend-langfuse build && npm run --workspace @bububuger/otlp-core build && npm run build && mkdir -p build && esbuild dist/index.js --bundle --platform=node --format=cjs --target=node18 --define:process.env.SPANORY_VERSION=\\\"$npm_package_version\\\" --outfile=build/spanory.cjs",
     "build:bin:macos-arm64": "npm run build:bundle && pkg build/spanory.cjs --targets node18-macos-arm64 --output ../../dist/spanory-macos-arm64",
     "build:bin:macos-x64": "npm run build:bundle && pkg build/spanory.cjs --targets node18-macos-x64 --output ../../dist/spanory-macos-x64",
     "build:bin:linux-x64": "npm run build:bundle && pkg build/spanory.cjs --targets node18-linux-x64 --output ../../dist/spanory-linux-x64",

package/dist/alert/evaluate.d.ts

@@ -1,3 +0,0 @@
-export declare function loadAlertRules(path: any): Promise<any>;
-export declare function evaluateRules(rules: any, sessions: any): any[];
-export declare function sendAlertWebhook(url: any, payload: any, headers?: {}): Promise<void>;

package/dist/alert/evaluate.js

@@ -1,197 +0,0 @@
-// @ts-nocheck
-import { readFile } from 'node:fs/promises';
-import { summarizeAgents, summarizeCache, summarizeCommands, summarizeMcp, summarizeSessions, summarizeTurnDiff, } from '../report/aggregate.js';
-function getMetricFromSessionRow(row, metric, refs = {}) {
-    const cacheRow = refs.cacheBySessionId?.get(row.sessionId);
-    const agentRow = refs.agentBySessionId?.get(row.sessionId);
-    const turnDiffRows = refs.turnDiffBySessionId?.get(row.sessionId) ?? [];
-    switch (metric) {
-        case 'events':
-            return row.events ?? 0;
-        case 'turns':
-            return row.turns ?? 0;
-        case 'usage.total':
-            return row.usage?.total ?? 0;
-        case 'usage.input':
-            return row.usage?.input ?? 0;
-        case 'usage.output':
-            return row.usage?.output ?? 0;
-        case 'cache.read':
-            return cacheRow?.cacheReadInputTokens ?? 0;
-        case 'cache.creation':
-            return cacheRow?.cacheCreationInputTokens ?? 0;
-        case 'cache.hit_rate':
-            return cacheRow?.cacheHitRate ?? 0;
-        case 'subagent.calls':
-            return agentRow?.agentTasks ?? 0;
-        case 'diff.char_delta.max':
-            return turnDiffRows.reduce((max, rowItem) => Math.max(max, Math.abs(Number(rowItem.charDelta ?? 0))), 0);
-        default:
-            return 0;
-    }
-}
-function getMetricFromAgentRow(row, metric) {
-    switch (metric) {
-        case 'agentTasks':
-            return row.agentTasks ?? 0;
-        case 'shellCommands':
-            return row.shellCommands ?? 0;
-        case 'mcpCalls':
-            return row.mcpCalls ?? 0;
-        case 'usage.total':
-            return row.usage?.total ?? 0;
-        default:
-            return 0;
-    }
-}
-function compare(value, op, threshold) {
-    if (op === 'gt')
-        return value > threshold;
-    if (op === 'gte')
-        return value >= threshold;
-    if (op === 'lt')
-        return value < threshold;
-    if (op === 'lte')
-        return value <= threshold;
-    if (op === 'eq')
-        return value === threshold;
-    throw new Error(`unsupported operator: ${op}`);
-}
-function evaluateSessionRule(rule, sessions) {
-    const rows = summarizeSessions(sessions);
-    const cacheBySessionId = new Map(summarizeCache(sessions).map((row) => [row.sessionId, row]));
-    const agentBySessionId = new Map(summarizeAgents(sessions).map((row) => [row.sessionId, row]));
-    const turnDiffBySessionId = new Map();
-    for (const row of summarizeTurnDiff(sessions)) {
-        const key = row.sessionId;
-        const list = turnDiffBySessionId.get(key) ?? [];
-        list.push(row);
-        turnDiffBySessionId.set(key, list);
-    }
-    const matched = rows
-        .map((row) => {
-        const value = getMetricFromSessionRow(row, rule.metric, {
-            cacheBySessionId,
-            agentBySessionId,
-            turnDiffBySessionId,
-        });
-        return { row, value };
-    })
-        .filter((x) => compare(x.value, rule.op, Number(rule.threshold)));
-    return matched.map((m) => ({
-        ruleId: rule.id,
-        severity: rule.severity ?? 'warning',
-        scope: 'session',
-        metric: rule.metric,
-        op: rule.op,
-        threshold: Number(rule.threshold),
-        value: m.value,
-        context: {
-            sessionId: m.row.sessionId,
-            projectId: m.row.projectId,
-            runtime: m.row.runtime,
-        },
-    }));
-}
-function evaluateAgentRule(rule, sessions) {
-    const rows = summarizeAgents(sessions);
-    const matched = rows
-        .map((row) => {
-        const value = getMetricFromAgentRow(row, rule.metric);
-        return { row, value };
-    })
-        .filter((x) => compare(x.value, rule.op, Number(rule.threshold)));
-    return matched.map((m) => ({
-        ruleId: rule.id,
-        severity: rule.severity ?? 'warning',
-        scope: 'agent',
-        metric: rule.metric,
-        op: rule.op,
-        threshold: Number(rule.threshold),
-        value: m.value,
-        context: {
-            sessionId: m.row.sessionId,
-            projectId: m.row.projectId,
-            runtime: m.row.runtime,
-        },
-    }));
-}
-function evaluateMcpRule(rule, sessions) {
-    const rows = summarizeMcp(sessions);
-    const matched = rows.filter((row) => compare(row.calls ?? 0, rule.op, Number(rule.threshold)));
-    return matched.map((row) => ({
-        ruleId: rule.id,
-        severity: rule.severity ?? 'warning',
-        scope: 'mcp',
-        metric: 'calls',
-        op: rule.op,
-        threshold: Number(rule.threshold),
-        value: row.calls,
-        context: {
-            server: row.server,
-        },
-    }));
-}
-function evaluateCommandRule(rule, sessions) {
-    const rows = summarizeCommands(sessions);
-    const matched = rows.filter((row) => compare(row.calls ?? 0, rule.op, Number(rule.threshold)));
-    return matched.map((row) => ({
-        ruleId: rule.id,
-        severity: rule.severity ?? 'warning',
-        scope: 'command',
-        metric: 'calls',
-        op: rule.op,
-        threshold: Number(rule.threshold),
-        value: row.calls,
-        context: {
-            command: row.command,
-        },
-    }));
-}
-export async function loadAlertRules(path) {
-    const raw = await readFile(path, 'utf-8');
-    const parsed = JSON.parse(raw);
-    if (!Array.isArray(parsed.rules)) {
-        throw new Error('rule file must be JSON with {"rules": [...]}');
-    }
-    return parsed.rules;
-}
-export function evaluateRules(rules, sessions) {
-    const alerts = [];
-    for (const rule of rules) {
-        if (!rule.id || !rule.scope || !rule.metric || !rule.op) {
-            throw new Error(`invalid rule: ${JSON.stringify(rule)}`);
-        }
-        if (rule.scope === 'session') {
-            alerts.push(...evaluateSessionRule(rule, sessions));
-            continue;
-        }
-        if (rule.scope === 'agent') {
-            alerts.push(...evaluateAgentRule(rule, sessions));
-            continue;
-        }
-        if (rule.scope === 'mcp') {
-            alerts.push(...evaluateMcpRule(rule, sessions));
-            continue;
-        }
-        if (rule.scope === 'command') {
-            alerts.push(...evaluateCommandRule(rule, sessions));
-            continue;
-        }
-        throw new Error(`unsupported rule scope: ${rule.scope}`);
-    }
-    return alerts;
-}
-export async function sendAlertWebhook(url, payload, headers = {}) {
-    const response = await fetch(url, {
-        method: 'POST',
-        headers: {
-            'content-type': 'application/json',
-            ...headers,
-        },
-        body: JSON.stringify(payload),
-    });
-    if (!response.ok) {
-        throw new Error(`webhook HTTP ${response.status}`);
-    }
-}

package/dist/env.d.ts

@@ -1,2 +0,0 @@
-export declare function parseSimpleDotEnv(raw: any): {};
-export declare function loadUserEnv(): Promise<void>;

package/dist/env.js

@@ -1,54 +0,0 @@
-// @ts-nocheck
-import path from 'node:path';
-import { readFile } from 'node:fs/promises';
-function resolveUserHome() {
-    return process.env.HOME || process.env.USERPROFILE || '';
-}
-export function parseSimpleDotEnv(raw) {
-    const out = {};
-    for (const line of String(raw).split('\n')) {
-        let s = line.trim();
-        if (!s || s.startsWith('#'))
-            continue;
-        if (s.startsWith('export ')) {
-            s = s.slice('export '.length).trim();
-        }
-        const idx = s.indexOf('=');
-        if (idx <= 0)
-            continue;
-        const key = s.slice(0, idx).trim();
-        if (!key)
-            continue;
-        let value = s.slice(idx + 1).trim();
-        const quoted = (value.startsWith('"') && value.endsWith('"'))
-            || (value.startsWith("'") && value.endsWith("'"));
-        if (quoted) {
-            value = value.slice(1, -1);
-        }
-        else {
-            const commentIdx = value.indexOf(' #');
-            if (commentIdx >= 0) {
-                value = value.slice(0, commentIdx).trimEnd();
-            }
-        }
-        out[key] = value;
-    }
-    return out;
-}
-export async function loadUserEnv() {
-    const home = resolveUserHome();
-    if (!home)
-        return;
-    const envPath = path.join(home, '.env');
-    try {
-        const raw = await readFile(envPath, 'utf-8');
-        const parsed = parseSimpleDotEnv(raw);
-        for (const [k, v] of Object.entries(parsed)) {
-            if (process.env[k] === undefined)
-                process.env[k] = v;
-        }
-    }
-    catch {
-        // ignore missing ~/.env
-    }
-}

package/dist/issue/state.d.ts

@@ -1,39 +0,0 @@
-export declare const ISSUE_STATUSES: readonly ["open", "in_progress", "blocked", "done"];
-export type IssueStatus = (typeof ISSUE_STATUSES)[number];
-export interface IssueItem {
-    id: string;
-    title: string;
-    source: string;
-    status: IssueStatus;
-    notes: string[];
-    createdAt: string;
-    updatedAt: string;
-    closedAt?: string;
-}
-export interface IssueState {
-    version: 1;
-    updatedAt: string;
-    issues: IssueItem[];
-}
-export interface PendingTodoItem {
-    id: string;
-    title: string;
-    source: string;
-}
-export declare function parsePendingTodoItems(todoContent: string, source?: string): PendingTodoItem[];
-export declare function syncIssueState(prev: IssueState, pending: PendingTodoItem[], now?: string): {
-    state: IssueState;
-    added: number;
-    reopened: number;
-    autoClosed: number;
-};
-export declare function setIssueStatus(prev: IssueState, input: {
-    id: string;
-    status: string;
-    note?: string;
-}, now?: string): IssueState;
-export declare function createEmptyIssueState(now?: string): IssueState;
-export declare function loadIssueState(filePath: string): Promise<IssueState>;
-export declare function saveIssueState(filePath: string, state: IssueState): Promise<void>;
-export declare function resolveIssueStatePath(input?: string): string;
-export declare function resolveTodoPath(input?: string): string;

package/dist/issue/state.js

@@ -1,151 +0,0 @@
-import { mkdir, readFile, writeFile } from 'node:fs/promises';
-import path from 'node:path';
-export const ISSUE_STATUSES = ['open', 'in_progress', 'blocked', 'done'];
-function nowIso(now) {
-    return now ?? new Date().toISOString();
-}
-function normalizeId(id) {
-    return String(id ?? '').trim();
-}
-function assertStatus(status) {
-    if (!ISSUE_STATUSES.includes(status)) {
-        throw new Error(`unsupported issue status: ${status}`);
-    }
-}
-function assertAllowedTransition(from, to) {
-    if (from === to)
-        return;
-    if (from === 'done' && to !== 'done') {
-        throw new Error('cannot transition issue from done to non-done status');
-    }
-}
-export function parsePendingTodoItems(todoContent, source = 'todo.md') {
-    const lines = String(todoContent ?? '').split(/\r?\n/);
-    const items = [];
-    for (const line of lines) {
-        const m = line.match(/^\s*-\s*\[\s\]\s+([A-Za-z0-9_-]+)\s+(.*)$/);
-        if (!m)
-            continue;
-        items.push({
-            id: normalizeId(m[1]),
-            title: m[2].trim(),
-            source,
-        });
-    }
-    return items;
-}
-export function syncIssueState(prev, pending, now) {
-    const timestamp = nowIso(now);
-    const byId = new Map(prev.issues.map((issue) => [issue.id, issue]));
-    const activeIds = new Set(pending.map((item) => item.id));
-    let added = 0;
-    let reopened = 0;
-    let autoClosed = 0;
-    for (const item of pending) {
-        const existing = byId.get(item.id);
-        if (!existing) {
-            byId.set(item.id, {
-                id: item.id,
-                title: item.title,
-                source: item.source,
-                status: 'open',
-                notes: ['synced from todo pending item'],
-                createdAt: timestamp,
-                updatedAt: timestamp,
-            });
-            added += 1;
-            continue;
-        }
-        existing.title = item.title;
-        existing.source = item.source;
-        existing.updatedAt = timestamp;
-        if (existing.status === 'done') {
-            existing.status = 'open';
-            existing.closedAt = undefined;
-            existing.notes.push('reopened by todo pending item');
-            reopened += 1;
-        }
-    }
-    for (const issue of byId.values()) {
-        if (issue.source !== 'todo.md')
-            continue;
-        if (activeIds.has(issue.id))
-            continue;
-        if (issue.status === 'done')
-            continue;
-        issue.status = 'done';
-        issue.updatedAt = timestamp;
-        issue.closedAt = timestamp;
-        issue.notes.push('auto-closed because todo item is no longer pending');
-        autoClosed += 1;
-    }
-    return {
-        state: {
-            version: 1,
-            updatedAt: timestamp,
-            issues: Array.from(byId.values()).sort((a, b) => a.id.localeCompare(b.id)),
-        },
-        added,
-        reopened,
-        autoClosed,
-    };
-}
-export function setIssueStatus(prev, input, now) {
-    const issueId = normalizeId(input.id);
-    const timestamp = nowIso(now);
-    assertStatus(input.status);
-    const issue = prev.issues.find((item) => item.id === issueId);
-    if (!issue)
-        throw new Error(`issue not found: ${issueId}`);
-    assertAllowedTransition(issue.status, input.status);
-    issue.status = input.status;
-    issue.updatedAt = timestamp;
-    if (input.status === 'done')
-        issue.closedAt = timestamp;
-    if (input.status !== 'done')
-        issue.closedAt = undefined;
-    if (input.note && input.note.trim())
-        issue.notes.push(input.note.trim());
-    return {
-        version: 1,
-        updatedAt: timestamp,
-        issues: prev.issues,
-    };
-}
-export function createEmptyIssueState(now) {
-    return {
-        version: 1,
-        updatedAt: nowIso(now),
-        issues: [],
-    };
-}
-export async function loadIssueState(filePath) {
-    try {
-        const raw = await readFile(filePath, 'utf-8');
-        const parsed = JSON.parse(raw);
-        if (!parsed || !Array.isArray(parsed.issues)) {
-            throw new Error('invalid issue state file');
-        }
-        return {
-            version: 1,
-            updatedAt: String(parsed.updatedAt ?? new Date(0).toISOString()),
-            issues: parsed.issues,
-        };
-    }
-    catch (error) {
-        if (error?.code === 'ENOENT') {
-            return createEmptyIssueState();
-        }
-        throw error;
-    }
-}
-export async function saveIssueState(filePath, state) {
-    await mkdir(path.dirname(filePath), { recursive: true });
-    await writeFile(filePath, `${JSON.stringify(state, null, 2)}\n`, 'utf-8');
-}
-export function resolveIssueStatePath(input) {
-    return input ? path.resolve(process.cwd(), input) : path.resolve(process.cwd(), 'docs/issues/state.json');
-}
-export function resolveTodoPath(input) {
-    return input ? path.resolve(process.cwd(), input) : path.resolve(process.cwd(), 'todo.md');
-}

package/dist/otlp.d.ts

@@ -1,5 +0,0 @@
-import { buildResource } from '../../otlp-core/dist/index.js';
-export { buildResource };
-export declare function parseHeaders(input: any): any;
-export declare function compileOtlp(events: any, resource: any): any;
-export declare function sendOtlp(endpoint: any, payload: any, headers?: {}): Promise<void>;

package/dist/otlp.js

@@ -1,12 +0,0 @@
-// @ts-nocheck
-import { buildResource, compileOtlpSpans, parseOtlpHeaders, sendOtlpHttp, } from '../../otlp-core/dist/index.js';
-export { buildResource };
-export function parseHeaders(input) {
-    return parseOtlpHeaders(input);
-}
-export function compileOtlp(events, resource) {
-    return compileOtlpSpans(events, resource);
-}
-export async function sendOtlp(endpoint, payload, headers = {}) {
-    await sendOtlpHttp(endpoint, payload, headers);
-}

package/dist/report/aggregate.d.ts

@@ -1,21 +0,0 @@
-export declare function loadExportedEvents(inputPath: any): Promise<any[]>;
-export declare function summarizeSessions(sessions: any): any;
-export declare function summarizeMcp(sessions: any): {
-    server: any;
-    calls: any;
-    sessions: any;
-}[];
-export declare function summarizeCommands(sessions: any): {
-    command: any;
-    calls: any;
-    sessions: any;
-}[];
-export declare function summarizeAgents(sessions: any): any[];
-export declare function summarizeCache(sessions: any): any;
-export declare function summarizeTools(sessions: any): {
-    category: any;
-    tool: any;
-    calls: any;
-    sessions: any;
-}[];
-export declare function summarizeTurnDiff(sessions: any): any[];