@ai-studio-3d/vyasa 0.1.0

package/README.md

@@ -0,0 +1,69 @@
+# vyasa
+
+Local analytics dashboard for AI coding agent sessions — waste detection, full-text search, session replay, and cross-machine session transport. Supports Claude Code and Codex.
+
+## Install
+
+```bash
+npx vyasa
+```
+
+Or install globally:
+
+```bash
+npm install -g vyasa
+```
+
+## Usage
+
+```bash
+vyasa                   # Index ~/.claude/projects + ~/.codex/sessions, open dashboard
+vyasa --rebuild         # Force full re-index before starting
+vyasa import <file>     # Import a .vyasa bundle from another machine
+```
+
+### Importing a session bundle
+
+If a teammate sent you a `.vyasa` file (or you exported one from another machine):
+
+```bash
+npx vyasa import session.vyasa                       # same-platform resume
+npx vyasa import session.vyasa --to=codex            # translate Claude → Codex
+npx vyasa import session.vyasa --to=claude-code      # translate Codex → Claude
+```
+
+This places the JSONL in your local agent's storage (`~/.claude/projects/...` or `~/.codex/sessions/...`) and offers to resume it natively. Flags:
+
+- `--to=<platform>` — translate the session into the target platform's JSONL format before placement. Accepts `claude-code` or `codex`. Tool calls are translated where they map cleanly (Bash↔exec_command exact, Write/Edit↔apply_patch best-effort, unknown tools wrapped as no-op shell-echoes that preserve the original metadata). Thinking blocks (Claude) and reasoning items (Codex) are dropped — they don't translate.
+- `--yes` / `-y` — skip the resume prompt and resume immediately if the agent CLI is on PATH.
+- `--no-resume` — place the file but don't offer to resume.
+
+### Exporting / sharing a session
+
+In the dashboard, open any session in Replay. Two buttons in the header:
+
+- **Hand off ↗** — downloads a `.vyasa` bundle. Recipient runs `npx vyasa import` (optionally `--to=<other-platform>` to translate) and resumes natively in their CLI.
+- **Continue elsewhere ⎘** — copies a primer prompt to your clipboard. Paste into any other agent (Codex, Cursor, ChatGPT, OpenCode, …) to warm-start with prior context. Lossy in a different way than `--to`: no tool-call transcript appears in the receiving CLI's UI, but the receiving agent gets a clean text summary.
+
+### `.vyasa` bundle format
+
+Gzipped tar with three entries:
+
+```
+manifest.json    metadata: platform, sessionId, projectDir, originalPath, jsonlSizeBytes, exportedAt, …
+session.jsonl    verbatim copy of the source JSONL
+README.md        one-line install instructions for the recipient
+```
+
+Power users can `tar -xzf foo.vyasa` and place files manually if they prefer not to install vyasa.
+
+## Requirements
+
+- Node.js >= 20
+- Claude Code with sessions in `~/.claude/projects/`, or Codex with sessions in `~/.codex/sessions/`
+
+## Known limitations
+
+- **Subagent sessions** (when the same `sessionId` appears in multiple JSONL files under one parent session directory) collapse into a single row in the local DB; the exported bundle uses whichever file was ingested last. Resume still works because the recipient's CLI re-discovers the parent session from the file location.
+- The recipient's Claude Code shows imported sessions under the sender's encoded project directory name (which is the sender's absolute project path). This is functional but visually foreign on the recipient side.
+- The primer prompt (cross-tool warm-start) is intentionally lossy — it summarizes recent turns but does not carry the agent's internal state, prompt cache, or full tool-call output history.

package/data/common-kit.json

@@ -0,0 +1,34 @@
+{
+  "version": 1,
+  "skills": [
+    {
+      "id": "code-reviewer",
+      "purpose": "Code review tasks",
+      "install": "Add to ~/.claude/skills/code-reviewer/SKILL.md"
+    },
+    {
+      "id": "security-audit",
+      "purpose": "Security review of code/configs",
+      "install": "Add to ~/.claude/skills/security-audit/SKILL.md"
+    },
+    {
+      "id": "commit-message-writer",
+      "purpose": "Generate conventional commit messages",
+      "install": "Add to ~/.claude/skills/commit-message-writer/SKILL.md"
+    }
+  ],
+  "mcpServers": [
+    {
+      "id": "github",
+      "purpose": "GitHub PR / issue / repo operations natively",
+      "install": "claude mcp add github",
+      "replaces": ["Bash:gh "]
+    },
+    {
+      "id": "context7",
+      "purpose": "Pull up-to-date library docs without manual WebFetch",
+      "install": "claude mcp add context7",
+      "replaces": ["WebFetch:react.dev", "WebFetch:vercel.com/docs", "WebFetch:nextjs.org/docs"]
+    }
+  ]
+}

package/data/pricing.json

@@ -0,0 +1,119 @@
+[
+  {
+    "model": "claude-opus-4-7",
+    "period_start": "2025-10-01",
+    "period_end": null,
+    "input_per_mtok": 15.00,
+    "output_per_mtok": 75.00,
+    "cache_write_per_mtok": 18.75,
+    "cache_read_per_mtok": 1.50
+  },
+  {
+    "model": "claude-sonnet-4-6",
+    "period_start": "2025-10-01",
+    "period_end": null,
+    "input_per_mtok": 3.00,
+    "output_per_mtok": 15.00,
+    "cache_write_per_mtok": 3.75,
+    "cache_read_per_mtok": 0.30
+  },
+  {
+    "model": "claude-haiku-4-5",
+    "period_start": "2025-10-01",
+    "period_end": null,
+    "input_per_mtok": 0.80,
+    "output_per_mtok": 4.00,
+    "cache_write_per_mtok": 1.00,
+    "cache_read_per_mtok": 0.08
+  },
+  {
+    "model": "claude-haiku-4-5-20251001",
+    "period_start": "2025-10-01",
+    "period_end": null,
+    "input_per_mtok": 0.80,
+    "output_per_mtok": 4.00,
+    "cache_write_per_mtok": 1.00,
+    "cache_read_per_mtok": 0.08
+  },
+  {
+    "model": "claude-sonnet-4-5",
+    "period_start": "2025-07-01",
+    "period_end": null,
+    "input_per_mtok": 3.00,
+    "output_per_mtok": 15.00,
+    "cache_write_per_mtok": 3.75,
+    "cache_read_per_mtok": 0.30
+  },
+  {
+    "model": "gpt-5.5",
+    "period_start": "2026-04-24",
+    "period_end": null,
+    "input_per_mtok": 5.00,
+    "output_per_mtok": 30.00,
+    "cache_write_per_mtok": 0,
+    "cache_read_per_mtok": 1.25
+  },
+  {
+    "model": "gpt-5",
+    "period_start": "2026-01-01",
+    "period_end": null,
+    "input_per_mtok": 1.25,
+    "output_per_mtok": 10.00,
+    "cache_write_per_mtok": 0,
+    "cache_read_per_mtok": 0.125
+  },
+  {
+    "model": "gpt-5-mini",
+    "period_start": "2026-01-01",
+    "period_end": null,
+    "input_per_mtok": 0.25,
+    "output_per_mtok": 2.00,
+    "cache_write_per_mtok": 0,
+    "cache_read_per_mtok": 0.025
+  },
+  {
+    "model": "o3",
+    "period_start": "2026-01-01",
+    "period_end": null,
+    "input_per_mtok": 2.00,
+    "output_per_mtok": 8.00,
+    "cache_write_per_mtok": 0,
+    "cache_read_per_mtok": 0.50
+  },
+  {
+    "model": "o4-mini",
+    "period_start": "2026-01-01",
+    "period_end": null,
+    "input_per_mtok": 1.10,
+    "output_per_mtok": 4.40,
+    "cache_write_per_mtok": 0,
+    "cache_read_per_mtok": 0.275
+  },
+  {
+    "model": "gpt-4.1",
+    "period_start": "2026-01-01",
+    "period_end": null,
+    "input_per_mtok": 2.00,
+    "output_per_mtok": 8.00,
+    "cache_write_per_mtok": 0,
+    "cache_read_per_mtok": 0.50
+  },
+  {
+    "model": "gpt-4.1-mini",
+    "period_start": "2026-01-01",
+    "period_end": null,
+    "input_per_mtok": 0.40,
+    "output_per_mtok": 1.60,
+    "cache_write_per_mtok": 0,
+    "cache_read_per_mtok": 0.10
+  },
+  {
+    "model": "gpt-4.1-nano",
+    "period_start": "2026-01-01",
+    "period_end": null,
+    "input_per_mtok": 0.10,
+    "output_per_mtok": 0.40,
+    "cache_write_per_mtok": 0,
+    "cache_read_per_mtok": 0.025
+  }
+]

package/data/schema/AnalyticsData.json

@@ -0,0 +1,214 @@
+{
+  "$ref": "#/definitions/AnalyticsData",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "definitions": {
+    "ActivityCell": {
+      "additionalProperties": false,
+      "properties": {
+        "dayOfWeek": {
+          "type": "number"
+        },
+        "errorCount": {
+          "description": "Error tool-calls in this bucket — drives \"depth\"/run-health tint.",
+          "type": "number"
+        },
+        "hour": {
+          "type": "number"
+        },
+        "sessionCount": {
+          "type": "number"
+        },
+        "tokens": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "dayOfWeek",
+        "hour",
+        "sessionCount",
+        "tokens",
+        "errorCount"
+      ],
+      "type": "object"
+    },
+    "ActivityClock": {
+      "additionalProperties": false,
+      "properties": {
+        "cells": {
+          "description": "7×24 grid of buckets (index = dayOfWeek*24 + hour). dayOfWeek: 0=Sun..6=Sat, hour: 0–23, both in the server's local timezone (where sessions were recorded).",
+          "items": {
+            "$ref": "#/definitions/ActivityCell"
+          },
+          "type": "array"
+        },
+        "maxSessions": {
+          "description": "Max sessionCount across all cells (for color-ramp normalization on the client).",
+          "type": "number"
+        },
+        "maxTokens": {
+          "description": "Max tokens across all cells.",
+          "type": "number"
+        }
+      },
+      "required": [
+        "cells",
+        "maxSessions",
+        "maxTokens"
+      ],
+      "type": "object"
+    },
+    "AnalyticsData": {
+      "additionalProperties": false,
+      "properties": {
+        "activityClock": {
+          "$ref": "#/definitions/ActivityClock",
+          "description": "Day-of-week × hour activity grid — the work-rhythm \"flow map\"."
+        },
+        "dailyCost": {
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "costCents": {
+                "type": "number"
+              },
+              "date": {
+                "type": "string"
+              },
+              "sessionCount": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "date",
+              "costCents",
+              "sessionCount"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "dailyTokens": {
+          "description": "Per-day token totals, aligned to dailyCost dates (tokens read better than $ since most sessions show $0).",
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "date": {
+                "type": "string"
+              },
+              "tokens": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "date",
+              "tokens"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "modelCost": {
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "costCents": {
+                "type": "number"
+              },
+              "model": {
+                "type": "string"
+              },
+              "outputTokens": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "model",
+              "costCents",
+              "outputTokens"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "projectCost": {
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "costCents": {
+                "type": "number"
+              },
+              "project": {
+                "type": "string"
+              },
+              "sessionCount": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "project",
+              "costCents",
+              "sessionCount"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "range": {
+          "$ref": "#/definitions/AnalyticsRange"
+        },
+        "summary": {
+          "$ref": "#/definitions/AnalyticsSummary",
+          "description": "Headline stats for the selected range."
+        }
+      },
+      "required": [
+        "range",
+        "dailyCost",
+        "projectCost",
+        "modelCost",
+        "dailyTokens",
+        "summary",
+        "activityClock"
+      ],
+      "type": "object"
+    },
+    "AnalyticsRange": {
+      "enum": [
+        "7d",
+        "30d",
+        "90d",
+        "all"
+      ],
+      "type": "string"
+    },
+    "AnalyticsSummary": {
+      "additionalProperties": false,
+      "properties": {
+        "activeDays": {
+          "description": "Distinct calendar days with at least one session.",
+          "type": "number"
+        },
+        "busiestHour": {
+          "description": "Local hour 0–23 with the most sessions, or null if no data.",
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "totalSessions": {
+          "type": "number"
+        },
+        "totalTokens": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "totalSessions",
+        "totalTokens",
+        "activeDays",
+        "busiestHour"
+      ],
+      "type": "object"
+    }
+  }
+}

package/data/schema/FoundationData.json

@@ -0,0 +1,42 @@
+{
+  "$ref": "#/definitions/FoundationData",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "definitions": {
+    "FoundationData": {
+      "additionalProperties": false,
+      "properties": {
+        "cacheHitRateLast30Days": {
+          "type": "number"
+        },
+        "modelMix": {
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "model": {
+                "type": "string"
+              },
+              "pct": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "model",
+              "pct"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "totalCostCentsThisWeek": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "totalCostCentsThisWeek",
+        "cacheHitRateLast30Days",
+        "modelMix"
+      ],
+      "type": "object"
+    }
+  }
+}