trimprompt 1.0.1 → 1.0.3

package/aicg-spec/rules.yaml

@@ -0,0 +1,555 @@
+# PromptShave.ai - Rewrite Rules Registry
+# Contains command-matching patterns, routing mapping, and expected savings metadata.
+
+version: "1.0"
+
+rules:
+  - pattern: '^(?:git|yadm)\s+(?:-[Cc]\s+\S+\s+)*(status|log|diff|show|add|commit|push|pull|branch|fetch|stash|worktree)'
+    pshave_cmd: "pshave git"
+    rewrite_prefixes: [git, yadm]
+    category: Git
+    savings_pct: 70
+    subcmd_savings:
+      diff: 80
+      show: 80
+      add: 59
+      commit: 59
+
+  - pattern: '^gh\s+(pr|issue|run|repo|api|release)'
+    pshave_cmd: "pshave gh"
+    rewrite_prefixes: [gh]
+    category: GitHub
+    savings_pct: 82
+    subcmd_savings:
+      pr: 87
+      run: 82
+      issue: 80
+
+  - pattern: '^glab\s+(mr|issue|ci|pipeline|api|release)'
+    pshave_cmd: "pshave glab"
+    rewrite_prefixes: [glab]
+    category: GitLab
+    savings_pct: 82
+    subcmd_savings:
+      mr: 87
+      ci: 82
+      issue: 80
+
+  - pattern: '^cargo\s+(build|test|clippy|check|fmt|install)'
+    pshave_cmd: "pshave cargo"
+    rewrite_prefixes: [cargo]
+    category: Cargo
+    savings_pct: 80
+    subcmd_savings:
+      test: 90
+      check: 80
+    subcmd_status:
+      fmt: passthrough
+
+  - pattern: '^pnpm\s+(exec|i|install|list|ls|outdated|run|run-script)'
+    pshave_cmd: "pshave pnpm"
+    rewrite_prefixes: [pnpm]
+    category: PackageManager
+    savings_pct: 80
+
+  - pattern: '^npm\s+(exec|run|run-script|rum|urn|x)(\s|$)'
+    pshave_cmd: "pshave npm"
+    rewrite_prefixes: [npm]
+    category: PackageManager
+    savings_pct: 70
+
+  - pattern: '^npx\s+'
+    pshave_cmd: "pshave npx"
+    rewrite_prefixes: [npx]
+    category: PackageManager
+    savings_pct: 70
+
+  - pattern: '^(cat|head|tail)\s+'
+    pshave_cmd: "pshave read"
+    rewrite_prefixes: [cat, head, tail]
+    category: Files
+    savings_pct: 60
+
+  - pattern: '^(rg|grep)\s+'
+    pshave_cmd: "pshave grep"
+    rewrite_prefixes: [rg, grep]
+    category: Files
+    savings_pct: 75
+
+  - pattern: '^ls(\s|$)'
+    pshave_cmd: "pshave ls"
+    rewrite_prefixes: [ls]
+    category: Files
+    savings_pct: 65
+
+  - pattern: '^find\s+'
+    pshave_cmd: "pshave find"
+    rewrite_prefixes: [find]
+    category: Files
+    savings_pct: 70
+
+  - pattern: '^((p?np(m|x)|p?npm\s+(exec|run|run-script)|npm\s+(rum|urn|x)|pnpm\s+dlx)\s+)?tsc(\s|$)'
+    pshave_cmd: "pshave tsc"
+    rewrite_prefixes: [npm exec tsc, npm rum tsc, npm run tsc, npm run-script tsc, npm tsc, npm urn tsc, npm x tsc, npx tsc, pnpm dlx tsc, pnpm exec tsc, pnpm run tsc, pnpm run-script tsc, pnpm tsc, pnpx tsc, tsc]
+    category: Build
+    savings_pct: 83
+
+  - pattern: '^((p?np(m|x)|p?npm\s+(exec|run|run-script)|npm\s+(rum|urn|x)|pnpm\s+dlx)\s+)?(biome|eslint|lint)(\s|$)'
+    pshave_cmd: "pshave lint"
+    rewrite_prefixes: [biome, eslint, lint, npm biome, npm eslint, npm exec biome, npm exec eslint, npm lint, npm rum biome, npm rum eslint, npm rum lint, npm run biome, npm run eslint, npm run lint, npm run-script biome, npm run-script eslint, npm run-script lint, npm urn biome, npm urn eslint, npm urn lint, npm x biome, npm x eslint, npx biome, npx eslint, npx lint, pnpm biome, pnpm dlx biome, pnpm dlx eslint, pnpm eslint, pnpm exec biome, pnpm exec eslint, pnpm lint, pnpm run biome, pnpm run eslint, pnpm run lint, pnpm run-script biome, pnpm run-script eslint, pnpm run-script lint, pnpx biome, pnpx eslint, pnpx lint]
+    category: Build
+    savings_pct: 84
+
+  - pattern: '^((p?np(m|x)|p?npm\s+(exec|run|run-script)|npm\s+(rum|urn|x)|pnpm\s+dlx)\s+)?prettier'
+    pshave_cmd: "pshave prettier"
+    rewrite_prefixes: [npm exec prettier, npm prettier, npm rum prettier, npm run prettier, npm run-script prettier, npm urn prettier, npm x prettier, npx prettier, pnpm dlx prettier, pnpm exec prettier, pnpm prettier, pnpm run prettier, pnpm run-script prettier, pnpx prettier, prettier]
+    category: Build
+    savings_pct: 70
+
+  - pattern: '^((p?np(m|x)|p?npm\s+(exec|run|run-script)|npm\s+(rum|urn|x)|pnpm\s+dlx)\s+)?next\s+build'
+    pshave_cmd: "pshave next"
+    rewrite_prefixes: [next build, npm exec next build, npm next build, npm rum next build, npm run next build, npm run-script next build, npm urn next build, npm x next build, npx next build, pnpm dlx next build, pnpm exec next build, pnpm next build, pnpm run next build, pnpm run-script next build, pnpx next build]
+    category: Build
+    savings_pct: 87
+
+  - pattern: '^((p?np(m|x)|p?npm\s+(exec|run|run-script)|npm\s+(rum|urn|x)|pnpm\s+dlx)\s+)?jest(\s+run)?(\s|$)'
+    pshave_cmd: "pshave jest"
+    rewrite_prefixes: [jest run, jest, npm exec jest run, npm exec jest, npm jest run, npm jest, npm rum jest run, npm rum jest, npm run jest run, npm run jest, npm run-script jest run, npm run-script jest, npm urn jest run, npm urn jest, npm x jest run, npm x jest, npx jest run, npx jest, pnpm dlx jest run, pnpm dlx jest, pnpm exec jest run, pnpm exec jest, pnpm jest run, pnpm jest, pnpm run jest run, pnpm run jest, pnpm run-script jest run, pnpm run-script jest, pnpx jest run, pnpx jest]
+    category: Tests
+    savings_pct: 99
+
+  - pattern: '^((p?np(m|x)|p?npm\s+(exec|run|run-script)|npm\s+(rum|urn|x)|pnpm\s+dlx)\s+)?vitest(\s+run)?(\s|$)'
+    pshave_cmd: "pshave vitest"
+    rewrite_prefixes: [npm exec vitest run, npm exec vitest, npm rum vitest run, npm rum vitest, npm run vitest run, npm run vitest, npm run-script vitest run, npm run-script vitest, npm urn vitest run, npm urn vitest, npm vitest run, npm vitest, npm x vitest run, npm x vitest, npx vitest run, npx vitest, pnpm dlx vitest run, pnpm dlx vitest, pnpm exec vitest run, pnpm exec vitest, pnpm run vitest run, pnpm run vitest, pnpm run-script vitest run, pnpm run-script vitest, pnpm vitest run, pnpm vitest, pnpx vitest run, pnpx vitest, vitest run, vitest]
+    category: Tests
+    savings_pct: 99
+
+  - pattern: '^((p?np(m|x)|p?npm\s+(exec|run|run-script)|npm\s+(rum|urn|x)|pnpm\s+dlx)\s+)?playwright'
+    pshave_cmd: "pshave playwright"
+    rewrite_prefixes: [npm exec playwright, npm playwright, npm rum playwright, npm run playwright, npm run-script playwright, npm urn playwright, npm x playwright, npx playwright, playwright, pnpm dlx playwright, pnpm exec playwright, pnpm playwright, pnpm run playwright, pnpm run-script playwright, pnpx playwright]
+    category: Tests
+    savings_pct: 94
+
+  - pattern: '^((p?np(m|x)|p?npm\s+(exec|run|run-script)|npm\s+(rum|urn|x)|pnpm\s+dlx)\s+)?prisma'
+    pshave_cmd: "pshave prisma"
+    rewrite_prefixes: [npm exec prisma, npm prisma, npm rum prisma, npm run prisma, npm run-script prisma, npm urn prisma, npm x prisma, npx prisma, pnpm dlx prisma, pnpm exec prisma, pnpm prisma, pnpm run prisma, pnpm run-script prisma, pnpx prisma, prisma]
+    category: Build
+    savings_pct: 88
+
+  - pattern: '^docker\s+(ps|images|logs|run|exec|build|compose\s+(ps|logs|build))'
+    pshave_cmd: "pshave docker"
+    rewrite_prefixes: [docker]
+    category: Infra
+    savings_pct: 85
+
+  - pattern: '^kubectl\s+(get|logs|describe|apply)'
+    pshave_cmd: "pshave kubectl"
+    rewrite_prefixes: [kubectl]
+    category: Infra
+    savings_pct: 85
+
+  - pattern: '^tree(\s|$)'
+    pshave_cmd: "pshave tree"
+    rewrite_prefixes: [tree]
+    category: Files
+    savings_pct: 70
+
+  - pattern: '^diff\s+'
+    pshave_cmd: "pshave diff"
+    rewrite_prefixes: [diff]
+    category: Files
+    savings_pct: 60
+
+  - pattern: '^curl\s+'
+    pshave_cmd: "pshave curl"
+    rewrite_prefixes: [curl]
+    category: Network
+    savings_pct: 70
+
+  - pattern: '^wget\s+'
+    pshave_cmd: "pshave wget"
+    rewrite_prefixes: [wget]
+    category: Network
+    savings_pct: 65
+
+  - pattern: '^(python3?\s+-m\s+)?mypy(\s|$)'
+    pshave_cmd: "pshave mypy"
+    rewrite_prefixes: [python3 -m mypy, python -m mypy, mypy]
+    category: Build
+    savings_pct: 80
+
+  - pattern: '^ruff\s+(check|format)'
+    pshave_cmd: "pshave ruff"
+    rewrite_prefixes: [ruff]
+    category: Python
+    savings_pct: 80
+    subcmd_savings:
+      check: 80
+      format: 75
+
+  - pattern: '^(python[0-9.]*\s+-m\s+)?pytest(\s|$)'
+    pshave_cmd: "pshave pytest"
+    rewrite_prefixes: [python3 -m pytest, python -m pytest, pytest]
+    category: Python
+    savings_pct: 90
+
+  - pattern: '^(pip3?|uv\s+pip)\s+(list|outdated|install|show)'
+    pshave_cmd: "pshave pip"
+    rewrite_prefixes: [pip3, pip, uv pip]
+    category: Python
+    savings_pct: 75
+    subcmd_savings:
+      list: 75
+      outdated: 80
+
+  - pattern: '^go\s+(test|build|vet)'
+    pshave_cmd: "pshave go"
+    rewrite_prefixes: [go]
+    category: Go
+    savings_pct: 85
+    subcmd_savings:
+      test: 90
+      build: 80
+      vet: 75
+
+  - pattern: '^(?:golangci-lint|golangci)\s+(run)(?:\s|$)'
+    pshave_cmd: "pshave golangci-lint run"
+    rewrite_prefixes: [golangci-lint run, golangci run]
+    category: Go
+    savings_pct: 85
+
+  - pattern: '^bundle\s+(install|update)\b'
+    pshave_cmd: "pshave bundle"
+    rewrite_prefixes: [bundle]
+    category: Ruby
+    savings_pct: 70
+
+  - pattern: '^(?:bundle\s+exec\s+)?(?:bin/)?(?:rake|rails)\s+test'
+    pshave_cmd: "pshave rake"
+    rewrite_prefixes: [bundle exec rails, bundle exec rake, bin/rails, rails, rake]
+    category: Ruby
+    savings_pct: 85
+    subcmd_savings:
+      test: 90
+
+  - pattern: '^(?:bundle\s+exec\s+)?rspec(?:\s|$)'
+    pshave_cmd: "pshave rspec"
+    rewrite_prefixes: [bundle exec rspec, bin/rspec, rspec]
+    category: Tests
+    savings_pct: 65
+
+  - pattern: '^(?:bundle\s+exec\s+)?rubocop(?:\s|$)'
+    pshave_cmd: "pshave rubocop"
+    rewrite_prefixes: [bundle exec rubocop, rubocop]
+    category: Build
+    savings_pct: 65
+
+  - pattern: '^aws\s+'
+    pshave_cmd: "pshave aws"
+    rewrite_prefixes: [aws]
+    category: Infra
+    savings_pct: 80
+    subcmd_savings:
+      sts: 80
+      s3: 60
+      ec2: 85
+      ecs: 90
+      rds: 80
+      cloudformation: 90
+      logs: 88
+      lambda: 90
+      iam: 85
+      dynamodb: 70
+      s3api: 75
+      eks: 87
+      sqs: 78
+      secretsmanager: 75
+
+  - pattern: '^psql(\s|$)'
+    pshave_cmd: "pshave psql"
+    rewrite_prefixes: [psql]
+    category: Infra
+    savings_pct: 75
+
+  - pattern: '^ansible-playbook\b'
+    pshave_cmd: "pshave ansible-playbook"
+    rewrite_prefixes: [ansible-playbook]
+    category: Infra
+    savings_pct: 70
+
+  - pattern: '^brew\s+(install|upgrade)\b'
+    pshave_cmd: "pshave brew"
+    rewrite_prefixes: [brew]
+    category: PackageManager
+    savings_pct: 65
+
+  - pattern: '^composer\s+(install|update|require)\b'
+    pshave_cmd: "pshave composer"
+    rewrite_prefixes: [composer]
+    category: PackageManager
+    savings_pct: 65
+
+  - pattern: '^df(\s|$)'
+    pshave_cmd: "pshave df"
+    rewrite_prefixes: [df]
+    category: System
+    savings_pct: 60
+
+  - pattern: '^dotnet\s+build\b'
+    pshave_cmd: "pshave dotnet"
+    rewrite_prefixes: [dotnet]
+    category: Build
+    savings_pct: 70
+
+  - pattern: '^du\b'
+    pshave_cmd: "pshave du"
+    rewrite_prefixes: [du]
+    category: System
+    savings_pct: 60
+
+  - pattern: '^fail2ban-client\b'
+    pshave_cmd: "pshave fail2ban-client"
+    rewrite_prefixes: [fail2ban-client]
+    category: Infra
+    savings_pct: 60
+
+  - pattern: '^gcloud\b'
+    pshave_cmd: "pshave gcloud"
+    rewrite_prefixes: [gcloud]
+    category: Infra
+    savings_pct: 65
+
+  - pattern: '^(?:\./gradlew|gradlew\.bat|gradlew|gradle)(?:\s+(test|build|clean|assemble\w*|install\w*|check|lint\w*|dependencies))?(\s|$)'
+    pshave_cmd: "pshave gradlew"
+    rewrite_prefixes: ["./gradlew", "gradlew.bat", "gradlew", "gradle"]
+    category: Build
+    savings_pct: 75
+    subcmd_savings:
+      test: 90
+      build: 80
+      check: 80
+
+  - pattern: '^hadolint\b'
+    pshave_cmd: "pshave hadolint"
+    rewrite_prefixes: [hadolint]
+    category: Build
+    savings_pct: 65
+
+  - pattern: '^helm\b'
+    pshave_cmd: "pshave helm"
+    rewrite_prefixes: [helm]
+    category: Infra
+    savings_pct: 65
+
+  - pattern: '^iptables\b'
+    pshave_cmd: "pshave iptables"
+    rewrite_prefixes: [iptables]
+    category: Infra
+    savings_pct: 60
+
+  - pattern: '^make\b'
+    pshave_cmd: "pshave make"
+    rewrite_prefixes: [make]
+    category: Build
+    savings_pct: 65
+
+  - pattern: '^markdownlint\b'
+    pshave_cmd: "pshave markdownlint"
+    rewrite_prefixes: [markdownlint]
+    category: Build
+    savings_pct: 65
+
+  - pattern: '^mix\s+(compile|format)(\s|$)'
+    pshave_cmd: "pshave mix"
+    rewrite_prefixes: [mix]
+    category: Build
+    savings_pct: 65
+
+  - pattern: '^(?:\./mvnw|mvnw\.cmd|mvnw|mvn)\b(?:\s+\S+)*?\s+(compile|test|integration-test|package|install|verify|deploy)\b'
+    pshave_cmd: "pshave mvn"
+    rewrite_prefixes: ["./mvnw", "mvnw.cmd", "mvnw", "mvn"]
+    category: Build
+    savings_pct: 82
+
+  - pattern: '^ping\b'
+    pshave_cmd: "pshave ping"
+    rewrite_prefixes: [ping]
+    category: Network
+    savings_pct: 60
+
+  - pattern: '^pio\s+run'
+    pshave_cmd: "pshave pio"
+    rewrite_prefixes: [pio]
+    category: Build
+    savings_pct: 65
+
+  - pattern: '^poetry\s+(install|lock|update)\b'
+    pshave_cmd: "pshave poetry"
+    rewrite_prefixes: [poetry]
+    category: Python
+    savings_pct: 65
+
+  - pattern: '^pre-commit\b'
+    pshave_cmd: "pshave pre-commit"
+    rewrite_prefixes: [pre-commit]
+    category: Build
+    savings_pct: 65
+
+  - pattern: '^ps(\s|$)'
+    pshave_cmd: "pshave ps"
+    rewrite_prefixes: [ps]
+    category: System
+    savings_pct: 60
+
+  - pattern: '^quarto\s+render'
+    pshave_cmd: "pshave quarto"
+    rewrite_prefixes: [quarto]
+    category: Build
+    savings_pct: 65
+
+  - pattern: '^rsync\b'
+    pshave_cmd: "pshave rsync"
+    rewrite_prefixes: [rsync]
+    category: Network
+    savings_pct: 65
+
+  - pattern: '^shellcheck\b'
+    pshave_cmd: "pshave shellcheck"
+    rewrite_prefixes: [shellcheck]
+    category: Build
+    savings_pct: 65
+
+  - pattern: '^shopify\s+theme\s+(push|pull)'
+    pshave_cmd: "pshave shopify"
+    rewrite_prefixes: [shopify]
+    category: Build
+    savings_pct: 65
+
+  - pattern: '^sops\b'
+    pshave_cmd: "pshave sops"
+    rewrite_prefixes: [sops]
+    category: Infra
+    savings_pct: 60
+
+  - pattern: '^swift\s+(build|test)\b'
+    pshave_cmd: "pshave swift"
+    rewrite_prefixes: [swift]
+    category: Build
+    savings_pct: 65
+    subcmd_savings:
+      test: 90
+
+  - pattern: '^systemctl\s+status\b'
+    pshave_cmd: "pshave systemctl"
+    rewrite_prefixes: [systemctl]
+    category: System
+    savings_pct: 65
+
+  - pattern: '^terraform\s+plan'
+    pshave_cmd: "pshave terraform"
+    rewrite_prefixes: [terraform]
+    category: Infra
+    savings_pct: 70
+
+  - pattern: '^tofu\s+(fmt|init|plan|validate)(\s|$)'
+    pshave_cmd: "pshave tofu"
+    rewrite_prefixes: [tofu]
+    category: Infra
+    savings_pct: 70
+
+  - pattern: '^trunk\s+build'
+    pshave_cmd: "pshave trunk"
+    rewrite_prefixes: [trunk]
+    category: Build
+    savings_pct: 65
+
+  - pattern: '^uv\s+(sync|pip\s+install)\b'
+    pshave_cmd: "pshave uv"
+    rewrite_prefixes: [uv]
+    category: Python
+    savings_pct: 65
+
+  - pattern: '^yamllint\b'
+    pshave_cmd: "pshave yamllint"
+    rewrite_prefixes: [yamllint]
+    category: Build
+    savings_pct: 65
+
+  - pattern: '^wc(\s|$)'
+    pshave_cmd: "pshave wc"
+    rewrite_prefixes: [wc]
+    category: Files
+    savings_pct: 60
+
+  - pattern: '^gt\s+'
+    pshave_cmd: "pshave gt"
+    rewrite_prefixes: [gt]
+    category: Git
+    savings_pct: 70
+
+  - pattern: '^liquibase(?:\s|$)'
+    pshave_cmd: "pshave liquibase"
+    rewrite_prefixes: [liquibase]
+    category: Infra
+    savings_pct: 65
+
+ignored_prefixes:
+  - "cd "
+  - "cd\t"
+  - "echo "
+  - "printf "
+  - "export "
+  - "source "
+  - "mkdir "
+  - "rm "
+  - "mv "
+  - "cp "
+  - "chmod "
+  - "chown "
+  - "touch "
+  - "which "
+  - "type "
+  - "test "
+  - "true"
+  - "false"
+  - "sleep "
+  - "wait"
+  - "kill "
+  - "set "
+  - "unset "
+  - "sort "
+  - "uniq "
+  - "tr "
+  - "cut "
+  - "awk "
+  - "sed "
+  - "python3 -c"
+  - "python -c"
+  - "node -e"
+  - "ruby -e"
+  - "pshave "
+  - "pwd"
+  - "bash "
+  - "sh "
+  - "then\n"
+  - "then "
+  - "else\n"
+  - "else "
+  - "do\n"
+  - "do "
+  - "for "
+  - "while "
+  - "if "
+  - "case "
+
+ignored_exact:
+  - "cd"
+  - "echo"
+  - "true"
+  - "false"
+  - "wait"
+  - "pwd"
+  - "bash"
+  - "sh"
+  - "fi"
+  - "done"

package/aicg-spec/schema.md

@@ -0,0 +1,93 @@
+# PromptShave.ai - Telemetry & Pricing Database Schema
+
+This document defines the database models and schemas for both the local developer database and the centralized enterprise hub database.
+
+---
+
+## 1. Local Database (SQLite)
+Each developer machine stores its execution log in `~/.promptshave/stats.db`.
+
+### Table: `executions`
+Stores individual proxied command executions and token savings metrics.
+
+```sql
+CREATE TABLE executions (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    timestamp TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+    command TEXT NOT NULL,                  -- Main CLI tool (e.g. "git", "npm")
+    subcommand TEXT,                        -- Subcommand (e.g. "status", "test")
+    raw_chars INTEGER NOT NULL,             -- Character length of raw output
+    compressed_chars INTEGER NOT NULL,      -- Character length of compressed output
+    estimated_raw_tokens INTEGER NOT NULL,  -- Estimated raw token count (char_count / 4)
+    estimated_compressed_tokens INTEGER NOT NULL, -- Estimated compressed token count
+    tokens_saved INTEGER NOT NULL,          -- raw_tokens - compressed_tokens
+    model_used TEXT NOT NULL,               -- Selected model context (e.g. "claude-3-5-sonnet")
+    exit_code INTEGER NOT NULL,             -- Exit code of command execution
+    synced INTEGER DEFAULT 0                -- 0 = unsynced, 1 = synced to central Hub
+);
+
+CREATE INDEX idx_executions_synced ON executions(synced) WHERE synced = 0;
+CREATE INDEX idx_executions_timestamp ON executions(timestamp);
+```
+
+---
+
+## 2. Central Hub Database (PostgreSQL)
+The Enterprise Hub aggregates logs across all developer laptops inside the organization.
+
+### Table: `organizations`
+Supports multi-tenant scaling (if needed) or represents the main company.
+```sql
+CREATE TABLE organizations (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    name VARCHAR(255) NOT NULL,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+```
+
+### Table: `developers`
+Represents an anonymous developer profile. The `developer_hash` is a SHA-256 hash generated locally from their system username, ensuring compliance with data privacy standards (no PII leaves their machine).
+```sql
+CREATE TABLE developers (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    org_id UUID REFERENCES organizations(id) ON DELETE CASCADE,
+    developer_hash VARCHAR(64) UNIQUE NOT NULL, -- SHA-256 of local username
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+```
+
+### Table: `telemetry_logs`
+Aggregates telemetry records synced from all client instances.
+```sql
+CREATE TABLE telemetry_logs (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    developer_id UUID REFERENCES developers(id) ON DELETE CASCADE,
+    timestamp TIMESTAMPTZ NOT NULL,
+    command VARCHAR(50) NOT NULL,
+    subcommand VARCHAR(50),
+    raw_tokens INTEGER NOT NULL,
+    compressed_tokens INTEGER NOT NULL,
+    tokens_saved INTEGER NOT NULL,
+    model_used VARCHAR(100) NOT NULL,
+    exit_code INTEGER NOT NULL
+);
+
+CREATE INDEX idx_telemetry_logs_timestamp ON telemetry_logs(timestamp);
+CREATE INDEX idx_telemetry_logs_command ON telemetry_logs(command);
+CREATE INDEX idx_telemetry_logs_saved ON telemetry_logs(tokens_saved);
+```
+
+### Table: `pricing_rules`
+Defines token pricing rules to calculate money saved dynamically.
+```sql
+CREATE TABLE pricing_rules (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    org_id UUID REFERENCES organizations(id) ON DELETE CASCADE, -- Allows custom corporate discounts
+    model_key VARCHAR(100) NOT NULL,
+    model_name VARCHAR(100) NOT NULL,
+    input_price_per_1m NUMERIC(10, 4) NOT NULL, -- e.g. 3.0000 for Claude 3.5 Sonnet
+    output_price_per_1m NUMERIC(10, 4) NOT NULL,
+    updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    UNIQUE(org_id, model_key)
+);
+```