@ericsanchezok/synergy-workbench 0.0.0-stage → 3.1.0

package/dist/stats/storage.js

@@ -0,0 +1,86 @@
+import { Storage } from "@ericsanchezok/synergy-harness/storage/storage";
+import { StoragePath } from "@ericsanchezok/synergy-harness/storage/path";
+export var StatsStorage;
+(function (StatsStorage) {
+    async function getWatermark() {
+        try {
+            return await Storage.read(StoragePath.statsWatermark());
+        }
+        catch (e) {
+            if (e instanceof Storage.NotFoundError)
+                return undefined;
+            throw e;
+        }
+    }
+    StatsStorage.getWatermark = getWatermark;
+    async function setWatermark(watermark) {
+        await Storage.write(StoragePath.statsWatermark(), watermark);
+    }
+    StatsStorage.setWatermark = setWatermark;
+    async function getDigest(sessionID) {
+        try {
+            return await Storage.read(StoragePath.statsDigest(sessionID));
+        }
+        catch (e) {
+            if (e instanceof Storage.NotFoundError)
+                return undefined;
+            throw e;
+        }
+    }
+    StatsStorage.getDigest = getDigest;
+    async function setDigest(digest) {
+        await Storage.write(StoragePath.statsDigest(digest.sessionID), digest);
+    }
+    StatsStorage.setDigest = setDigest;
+    async function removeDigest(sessionID) {
+        await Storage.remove(StoragePath.statsDigest(sessionID));
+    }
+    StatsStorage.removeDigest = removeDigest;
+    async function listDigestIDs() {
+        return Storage.scan(StoragePath.statsDigestsRoot());
+    }
+    StatsStorage.listDigestIDs = listDigestIDs;
+    async function getAllDigests() {
+        const ids = await listDigestIDs();
+        if (ids.length === 0)
+            return [];
+        const keys = ids.map((id) => StoragePath.statsDigest(id));
+        const results = await Storage.readMany(keys);
+        return results.filter((d) => d !== undefined);
+    }
+    StatsStorage.getAllDigests = getAllDigests;
+    async function getDailyBucket(day) {
+        try {
+            return await Storage.read(StoragePath.statsDaily(day));
+        }
+        catch (e) {
+            if (e instanceof Storage.NotFoundError)
+                return undefined;
+            throw e;
+        }
+    }
+    StatsStorage.getDailyBucket = getDailyBucket;
+    async function setDailyBucket(day, bucket) {
+        await Storage.write(StoragePath.statsDaily(day), bucket);
+    }
+    StatsStorage.setDailyBucket = setDailyBucket;
+    async function listDailyKeys() {
+        return Storage.scan(StoragePath.statsDailyRoot());
+    }
+    StatsStorage.listDailyKeys = listDailyKeys;
+    async function getSnapshot() {
+        try {
+            return await Storage.read(StoragePath.statsSnapshot());
+        }
+        catch (e) {
+            if (e instanceof Storage.NotFoundError)
+                return undefined;
+            throw e;
+        }
+    }
+    StatsStorage.getSnapshot = getSnapshot;
+    async function setSnapshot(snapshot) {
+        await Storage.write(StoragePath.statsSnapshot(), snapshot);
+    }
+    StatsStorage.setSnapshot = setSnapshot;
+})(StatsStorage || (StatsStorage = {}));

package/dist/stats/types.js

@@ -0,0 +1,267 @@
+import z from "zod";
+import { RolloutAccounting } from "@ericsanchezok/synergy-harness/session/rollout/accounting";
+import { ExecutionPresentation } from "../execution/presentation.js";
+// ---------------------------------------------------------------------------
+// Shared primitives
+// ---------------------------------------------------------------------------
+export const TokenBreakdown = z.object({
+    input: z.number(),
+    output: z.number(),
+    reasoning: z.number(),
+    cache: z.object({
+        read: z.number(),
+        write: z.number(),
+    }),
+});
+// ---------------------------------------------------------------------------
+// Dimension 1 — Overview
+// ---------------------------------------------------------------------------
+export const OverviewStats = z.object({
+    totalSessions: z.number(),
+    activeSessions: z.number(),
+    archivedSessions: z.number(),
+    totalMessages: z.number(),
+    totalTurns: z.number(),
+    totalDays: z.number(),
+    longestStreak: z.number(),
+    currentStreak: z.number(),
+    projectCount: z.number(),
+});
+// ---------------------------------------------------------------------------
+// Dimension 2 — Tokens & Cost
+// ---------------------------------------------------------------------------
+export const TokenCostStats = z.object({
+    tokens: TokenBreakdown,
+    cost: z.number(),
+    accounting: RolloutAccounting.Summary.optional(),
+    costPresentation: ExecutionPresentation.Cost.optional(),
+    cacheHitRate: z.number(),
+    avgCostPerTurn: z.number(),
+    avgTokensPerTurn: z.number(),
+    dailyCost: z.number(),
+    dailyTokens: z.number(),
+});
+// ---------------------------------------------------------------------------
+// Dimension 3 — By Model  (providerID/modelID → usage)
+// ---------------------------------------------------------------------------
+export const ModelUsage = z.object({
+    providerID: z.string(),
+    modelID: z.string(),
+    messages: z.number(),
+    turns: z.number(),
+    tokens: TokenBreakdown,
+    cost: z.number(),
+    accounting: RolloutAccounting.Summary.optional(),
+    avgResponseMs: z.number(),
+});
+export const ModelStats = z.object({
+    models: z.array(ModelUsage),
+});
+// ---------------------------------------------------------------------------
+// Dimension 4 — By Agent
+// ---------------------------------------------------------------------------
+export const AgentUsage = z.object({
+    agent: z.string(),
+    messages: z.number(),
+    sessions: z.number(),
+    tokens: TokenBreakdown,
+    cost: z.number(),
+    accounting: RolloutAccounting.Summary.optional(),
+    subagentInvocations: z.number(),
+});
+export const AgentStats = z.object({
+    agents: z.array(AgentUsage),
+    totalSubagentCalls: z.number(),
+});
+// ---------------------------------------------------------------------------
+// Dimension 5 — By Tool
+// ---------------------------------------------------------------------------
+export const ToolUsage = z.object({
+    tool: z.string(),
+    calls: z.number(),
+    successes: z.number(),
+    errors: z.number(),
+    avgDurationMs: z.number(),
+});
+export const ToolStats = z.object({
+    tools: z.array(ToolUsage),
+});
+// ---------------------------------------------------------------------------
+// Dimension 6 — Code Changes
+// ---------------------------------------------------------------------------
+export const CodeChangeStats = z.object({
+    totalAdditions: z.number(),
+    totalDeletions: z.number(),
+    totalFiles: z.number(),
+    netLines: z.number(),
+    dailyAdditions: z.number(),
+    dailyDeletions: z.number(),
+});
+// ---------------------------------------------------------------------------
+// Dimension 7 — Session Lifecycle
+// ---------------------------------------------------------------------------
+export const SessionLifecycleStats = z.object({
+    pinnedCount: z.number(),
+    avgTurnsPerSession: z.number(),
+    medianTurnsPerSession: z.number(),
+    compactionCount: z.number(),
+    retryCount: z.number(),
+    errorCount: z.number(),
+    errorRate: z.number(),
+    /** Bucketed session duration: short (<5min), medium (5-30min), long (>30min) */
+    durationBuckets: z.object({
+        short: z.number(),
+        medium: z.number(),
+        long: z.number(),
+    }),
+});
+// ---------------------------------------------------------------------------
+// Dimension 8 — By Channel / Endpoint
+// ---------------------------------------------------------------------------
+export const ChannelUsage = z.object({
+    channel: z.string(),
+    sessions: z.number(),
+    messages: z.number(),
+});
+export const ChannelStats = z.object({
+    channels: z.array(ChannelUsage),
+    interactiveSessions: z.number(),
+    unattendedSessions: z.number(),
+});
+// ---------------------------------------------------------------------------
+// Dimension 9 — Time Series (per-day bucket)
+// ---------------------------------------------------------------------------
+export const DailyBucket = z.object({
+    day: z.string(),
+    sessions: z.number(),
+    turns: z.number(),
+    tokens: TokenBreakdown,
+    cost: z.number(),
+    accounting: RolloutAccounting.Summary.optional(),
+    additions: z.number(),
+    deletions: z.number(),
+    files: z.number(),
+    toolCalls: z.number(),
+    errors: z.number(),
+});
+export const HourlyBucket = z.object({
+    hour: z.string(),
+    turns: z.number(),
+});
+export const TimeSeriesStats = z.object({
+    days: z.array(DailyBucket),
+    hours: z.array(HourlyBucket),
+    /** Hour-of-day activity: 24-element array, each = turn count */
+    hourlyActivity: z.array(z.number()),
+});
+// ---------------------------------------------------------------------------
+// Composite — Full Stats Snapshot
+// ---------------------------------------------------------------------------
+export const StatsSnapshot = z.object({
+    overview: OverviewStats,
+    tokenCost: TokenCostStats,
+    models: ModelStats,
+    agents: AgentStats,
+    tools: ToolStats,
+    codeChanges: CodeChangeStats,
+    lifecycle: SessionLifecycleStats,
+    channels: ChannelStats,
+    timeSeries: TimeSeriesStats,
+    /** Timestamp when this snapshot was computed */
+    computedAt: z.number(),
+    /** Watermark: latest session.updated we scanned up to */
+    watermark: z.number(),
+});
+// ---------------------------------------------------------------------------
+// Per-Session Digest (intermediate product for incremental aggregation)
+// ---------------------------------------------------------------------------
+export const SessionDigest = z.object({
+    sessionID: z.string(),
+    scopeID: z.string(),
+    created: z.number(),
+    updated: z.number(),
+    rolloutRevision: z.number().int().nonnegative().optional(),
+    archived: z.number().optional(),
+    pinned: z.boolean(),
+    parentID: z.string().optional(),
+    endpoint: z
+        .object({
+        kind: z.string(),
+        type: z.string().optional(),
+    })
+        .optional(),
+    interaction: z
+        .object({
+        mode: z.string(),
+        source: z.string().optional(),
+    })
+        .optional(),
+    turns: z.number(),
+    messages: z.number(),
+    tokens: TokenBreakdown,
+    cost: z.number(),
+    accounting: RolloutAccounting.Summary.optional(),
+    /** model key (providerID/modelID) → { messages, tokens, cost, totalResponseMs } */
+    modelUsage: z.record(z.string(), z.object({
+        messages: z.number(),
+        tokens: TokenBreakdown,
+        cost: z.number(),
+        accounting: RolloutAccounting.Summary.optional(),
+        totalResponseMs: z.number(),
+    })),
+    /** agent → { messages, tokens, cost } */
+    agentUsage: z.record(z.string(), z.object({
+        messages: z.number(),
+        tokens: TokenBreakdown,
+        cost: z.number(),
+        accounting: RolloutAccounting.Summary.optional(),
+    })),
+    /** tool → { calls, successes, errors, totalDurationMs } */
+    toolUsage: z.record(z.string(), z.object({
+        calls: z.number(),
+        successes: z.number(),
+        errors: z.number(),
+        totalDurationMs: z.number(),
+        timedSamples: z.number().int().nonnegative().optional(),
+    })),
+    /** YYYY-MM-DDTHH → turn count */
+    hourlyTurns: z.record(z.string(), z.number()),
+    additions: z.number(),
+    deletions: z.number(),
+    files: z.number(),
+    compactionCount: z.number(),
+    retryCount: z.number(),
+    errorCount: z.number(),
+    /** Duration in ms (updated - created) */
+    durationMs: z.number(),
+});
+export const OperationDigest = SessionDigest.pick({
+    scopeID: true,
+    created: true,
+    updated: true,
+    tokens: true,
+    cost: true,
+    accounting: true,
+    modelUsage: true,
+    agentUsage: true,
+}).extend({ operationID: z.string(), rolloutRevision: z.number().int().nonnegative(), turns: z.literal(0) });
+// ---------------------------------------------------------------------------
+// Watermark — tracks incremental scan progress
+// ---------------------------------------------------------------------------
+export const StatsWatermark = z.object({
+    /** Last session.updated timestamp we scanned */
+    lastUpdated: z.number(),
+    /** Set of sessionIDs already digested (to detect deletions) */
+    sessionIDs: z.array(z.string()),
+    /** Timestamp of last full scan */
+    lastFullScanAt: z.number(),
+});
+// ---------------------------------------------------------------------------
+// Progress callback
+// ---------------------------------------------------------------------------
+export const ProgressEvent = z.object({
+    phase: z.enum(["scan", "digest", "bucket", "snapshot"]),
+    current: z.number(),
+    total: z.number(),
+    message: z.string().optional(),
+});

package/dist/worker.js

@@ -0,0 +1,6 @@
+import { version } from "../package.json" with { type: "json" };
+export const metadata = { id: "workbench", version, apiVersion: 1 };
+import { registerConfig } from "./config-schema.js";
+export function registerWorker() {
+    registerConfig();
+}

package/package.json

@@ -1,6 +1,234 @@
 {
   "name": "@ericsanchezok/synergy-workbench",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "3.1.0",
+  "type": "module",
+  "license": "MIT",
+  "exports": {
+    "./stats/cli/stats": {
+      "types": "./src/stats/cli/stats.ts",
+      "bun": "./dist/stats/cli/stats.js",
+      "import": "./dist/stats/cli/stats.js"
+    },
+    "./stats/aggregator": {
+      "types": "./src/stats/aggregator.ts",
+      "bun": "./dist/stats/aggregator.js",
+      "import": "./dist/stats/aggregator.js"
+    },
+    "./project/tools": {
+      "types": "./src/project/tools.ts",
+      "bun": "./dist/project/tools.js",
+      "import": "./dist/project/tools.js"
+    },
+    "./presentation/service": {
+      "types": "./src/presentation/service.ts",
+      "bun": "./dist/presentation/service.js",
+      "import": "./dist/presentation/service.js"
+    },
+    "./presentation/tools": {
+      "types": "./src/presentation/tools.ts",
+      "bun": "./dist/presentation/tools.js",
+      "import": "./dist/presentation/tools.js"
+    },
+    "./presentation/tools/workbench-view": {
+      "types": "./src/presentation/tools/workbench-view.ts",
+      "bun": "./dist/presentation/tools/workbench-view.js",
+      "import": "./dist/presentation/tools/workbench-view.js"
+    },
+    "./project/startup": {
+      "types": "./src/project/startup.ts",
+      "bun": "./dist/project/startup.js",
+      "import": "./dist/project/startup.js"
+    },
+    "./project/session-health": {
+      "types": "./src/project/session-health.ts",
+      "bun": "./dist/project/session-health.js",
+      "import": "./dist/project/session-health.js"
+    },
+    "./project/vcs": {
+      "types": "./src/project/vcs.ts",
+      "bun": "./dist/project/vcs.js",
+      "import": "./dist/project/vcs.js"
+    },
+    "./project/worktree-janitor": {
+      "types": "./src/project/worktree-janitor.ts",
+      "bun": "./dist/project/worktree-janitor.js",
+      "import": "./dist/project/worktree-janitor.js"
+    },
+    "./push/bridge": {
+      "types": "./src/push/bridge.ts",
+      "bun": "./dist/push/bridge.js",
+      "import": "./dist/push/bridge.js"
+    },
+    "./stats/routes/stats": {
+      "types": "./src/stats/routes/stats.ts",
+      "bun": "./dist/stats/routes/stats.js",
+      "import": "./dist/stats/routes/stats.js"
+    },
+    "./performance/routes/performance-route": {
+      "types": "./src/performance/routes/performance-route.ts",
+      "bun": "./dist/performance/routes/performance-route.js",
+      "import": "./dist/performance/routes/performance-route.js"
+    },
+    "./push/routes/push": {
+      "types": "./src/push/routes/push.ts",
+      "bun": "./dist/push/routes/push.js",
+      "import": "./dist/push/routes/push.js"
+    },
+    "./project/ide": {
+      "types": "./src/project/ide.ts",
+      "bun": "./dist/project/ide.js",
+      "import": "./dist/project/ide.js"
+    },
+    "./performance/catalog": {
+      "types": "./src/performance/catalog.ts",
+      "bun": "./dist/performance/catalog.js",
+      "import": "./dist/performance/catalog.js"
+    },
+    "./performance/dashboard": {
+      "types": "./src/performance/dashboard.ts",
+      "bun": "./dist/performance/dashboard.js",
+      "import": "./dist/performance/dashboard.js"
+    },
+    "./push/service": {
+      "types": "./src/push/service.ts",
+      "bun": "./dist/push/service.js",
+      "import": "./dist/push/service.js"
+    },
+    "./push/store": {
+      "types": "./src/push/store.ts",
+      "bun": "./dist/push/store.js",
+      "import": "./dist/push/store.js"
+    },
+    "./project/tools/session-control": {
+      "types": "./src/project/tools/session-control.ts",
+      "bun": "./dist/project/tools/session-control.js",
+      "import": "./dist/project/tools/session-control.js"
+    },
+    "./project/tools/worktree-enter": {
+      "types": "./src/project/tools/worktree-enter.ts",
+      "bun": "./dist/project/tools/worktree-enter.js",
+      "import": "./dist/project/tools/worktree-enter.js"
+    },
+    "./project/tools/worktree-leave": {
+      "types": "./src/project/tools/worktree-leave.ts",
+      "bun": "./dist/project/tools/worktree-leave.js",
+      "import": "./dist/project/tools/worktree-leave.js"
+    },
+    "./project/tools/worktree-archive": {
+      "types": "./src/project/tools/worktree-archive.ts",
+      "bun": "./dist/project/tools/worktree-archive.js",
+      "import": "./dist/project/tools/worktree-archive.js"
+    },
+    "./project/tools/worktree-list": {
+      "types": "./src/project/tools/worktree-list.ts",
+      "bun": "./dist/project/tools/worktree-list.js",
+      "import": "./dist/project/tools/worktree-list.js"
+    },
+    "./performance/timeline": {
+      "types": "./src/performance/timeline.ts",
+      "bun": "./dist/performance/timeline.js",
+      "import": "./dist/performance/timeline.js"
+    },
+    "./config-schema": {
+      "types": "./src/config-schema.ts",
+      "bun": "./dist/config-schema.js",
+      "import": "./dist/config-schema.js"
+    },
+    "./agents": {
+      "types": "./src/agents.ts",
+      "bun": "./dist/agents.js",
+      "import": "./dist/agents.js"
+    },
+    "./performance/prompt/builder": {
+      "types": "./src/performance/prompt/builder.ts",
+      "bun": "./dist/performance/prompt/builder.js",
+      "import": "./dist/performance/prompt/builder.js"
+    },
+    "./project/routes/git": {
+      "types": "./src/project/routes/git.ts",
+      "bun": "./dist/project/routes/git.js",
+      "import": "./dist/project/routes/git.js"
+    },
+    "./component": {
+      "types": "./src/component.ts",
+      "bun": "./dist/component.js",
+      "import": "./dist/component.js"
+    },
+    "./http": {
+      "types": "./src/http.ts",
+      "bun": "./dist/http.js",
+      "import": "./dist/http.js"
+    },
+    "./features": {
+      "types": "./src/features.ts",
+      "bun": "./dist/features.js",
+      "import": "./dist/features.js"
+    }
+  },
+  "dependencies": {
+    "@ericsanchezok/synergy-harness": "3.1.0",
+    "@ericsanchezok/synergy-local-runtime": "3.1.0",
+    "@ericsanchezok/synergy-util": "3.1.0",
+    "@hono/standard-validator": "0.4.0",
+    "hono": "4.13.13",
+    "hono-openapi": "1.1.2",
+    "web-push": "3.6.7",
+    "yargs": "18.2.0",
+    "zod": "4.6.7"
+  },
+  "peerDependencies": {
+    "@ericsanchezok/synergy-server": "3.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@ericsanchezok/synergy-server": {
+      "optional": true
+    }
+  },
+  "synergy": {
+    "formatVersion": 1,
+    "kind": "component",
+    "id": "workbench",
+    "version": "3.1.0",
+    "compatibility": {
+      "synergy": "3.1.0"
+    },
+    "apiVersion": 1,
+    "entry": "./dist/component.js",
+    "export": "workbench",
+    "requires": {
+      "local-runtime": "3.1.0"
+    },
+    "features": {
+      "kind": "product",
+      "definitions": [
+        {
+          "id": "workbench",
+          "owner": "workbench",
+          "maturity": "stable",
+          "activation": "restart",
+          "name": "Workbench",
+          "description": "Projects, task presentation, reviews and activity.",
+          "component": "workbench"
+        },
+        {
+          "id": "kanban",
+          "owner": "workbench",
+          "maturity": "experimental",
+          "activation": "restart",
+          "name": "Kanban",
+          "description": "View and organize tasks on a board."
+        }
+      ]
+    },
+    "packages": {}
+  },
+  "files": [
+    "src",
+    "dist",
+    "README.md",
+    "AGENTS.md"
+  ],
+  "engines": {
+    "bun": ">=1.4.3"
+  }
+}

package/src/agents.ts

@@ -0,0 +1,15 @@
+import type { Agent } from "@ericsanchezok/synergy-harness/agent/agent"
+import { resolveAgentModelRole, type BuiltinAgentContext } from "@ericsanchezok/synergy-harness/agent/builtin-context"
+import { createPerformanceAnalystAgent } from "./performance/prompt/builder"
+import { AgentBuiltins } from "@ericsanchezok/synergy-harness/agent/builtins"
+
+export function createDomainAgents(ctx: BuiltinAgentContext): Record<string, Agent.Info> {
+  const performanceAnalyst = createPerformanceAnalystAgent(ctx)
+  return {
+    [performanceAnalyst.name]: performanceAnalyst,
+  }
+}
+
+export function registerWorkbenchAgents() {
+  AgentBuiltins.register("workbench", createDomainAgents)
+}

package/src/cli-adapter.ts

@@ -0,0 +1,11 @@
+import type { CommandEntry } from "@ericsanchezok/synergy-util/cli-command"
+import type { CommandModule } from "@ericsanchezok/synergy-util/cli-command"
+
+export const commands: CommandEntry[] = [
+  {
+    command: "stats",
+    describe: "show token usage and cost statistics",
+    storage: "maintenance",
+    load: async () => (await import("./stats/cli/stats")).StatsCommand as unknown as CommandModule,
+  },
+]