@basestream/cli 0.2.11 → 0.3.0

package/README.md

@@ -1,380 +1,80 @@
-# Basestream.ai
+# Basestream
 
 **Your team uses AI every day. Now you can see what it's building.**
 
-Basestream is an AI Work Intelligence platform that automatically tracks what developers build with AI tools (Claude Code, Cursor, etc.) and gives engineering teams visibility into AI-powered output.
+Basestream automatically tracks what your developers build with AI tools and gives engineering leaders visibility into AI-powered output — no manual logging, no workflow changes.
 
-A product of [Sublevel Inc.](https://sublevel.com)
+[basestream.ai](https://basestream.ai) | [Documentation](https://docs.basestream.ai)
 
 ---
 
-## Quick Start
+## Install
 
 ```bash
-# 1. Start Postgres (from monorepo root — shared with packages/api)
-cd packages/api && docker compose up -d && cd ../basestream
-
-# 2. Install dependencies
-npm install --legacy-peer-deps
-
-# 3. Set up environment
-cp .env.example .env
-# .env is pre-configured for local dev with SKIP_PAYMENT=true
-
-# 4. Push schema to database
-npx drizzle-kit generate
-# Then apply the migration:
-cat src/db/migrations/0000_*.sql | docker exec -i basement-pg psql -U postgres -d basement_starter
-
-# 5. Seed demo data (3 users, 44 entries, 1 org)
-npx tsx src/db/seed.ts
-
-# 6. Run dev server
-npm run dev
+npx @basestream/cli init
 ```
 
-Open [http://localhost:3000](http://localhost:3000) to see the landing page.
-
-### End-to-End Local Testing
-
-With `SKIP_PAYMENT=true` in `.env`, you can:
-
-- Sign up via email magic link (check console for the link)
-- Skip Stripe checkout — clicking "Get early access" instantly upgrades to Team
-- Create orgs, invite members, manage integrations
-- Ingest work entries via API key (`POST /api/entries`)
-- Bulk sync entries (`POST /api/sync` — idempotent via sessionId)
-
----
-
-## Architecture
-
-```
-packages/basestream/
-├── src/
-│   ├── db/
-│   │   ├── schema.ts                # Drizzle schema: 10 tables, 7 enums (bs_ prefixed)
-│   │   ├── index.ts                 # Drizzle client (pg Pool → port 5434)
-│   │   ├── seed.ts                  # Demo: 3 users, 44 entries, 1 org
-│   │   └── migrations/             # Generated SQL migrations
-│   ├── app/
-│   │   ├── page.tsx                 # Landing page (marketing)
-│   │   ├── layout.tsx               # Root layout (fonts, metadata)
-│   │   ├── login/page.tsx           # Auth: email + GitHub + Google
-│   │   ├── signup/page.tsx          # Auth + Stripe checkout flow
-│   │   ├── api/                     # 16 API routes
-│   │   │   ├── auth/                # NextAuth handler
-│   │   │   ├── stripe/              # Checkout + webhook
-│   │   │   ├── entries/             # CRUD + pagination + filters
-│   │   │   ├── sync/               # Bulk upsert (CLI sync)
-│   │   │   ├── summary/            # Aggregated stats + ROI
-│   │   │   ├── search/             # Full-text search
-│   │   │   ├── orgs/               # Org + members + invites
-│   │   │   └── integrations/       # 5 integration stubs
-│   │   └── dashboard/              # 9 authenticated pages
-│   │       ├── page.tsx            # Overview (feed + heatmap)
-│   │       ├── team/               # Manager view (charts)
-│   │       ├── projects/           # Project grid
-│   │       ├── roi/                # ROI metrics + Recharts
-│   │       ├── integrations/       # Connect/disconnect tools
-│   │       └── settings/           # Profile, billing, team mgmt
-│   ├── components/
-│   │   ├── landing/                # 12 marketing components
-│   │   ├── dashboard/              # 8 dashboard components
-│   │   └── ui/                     # 5 shared UI primitives
-│   ├── lib/                        # Core libraries
-│   │   ├── auth.ts                 # NextAuth config (DrizzleAdapter)
-│   │   ├── stripe.ts               # Stripe helpers
-│   │   ├── api-auth.ts             # API key + session auth
-│   │   ├── utils.ts                # Utility functions
-│   │   └── integrations/           # 6 integration modules
-│   ├── hooks/                      # 3 data hooks
-│   ├── types/                      # TypeScript types
-│   └── middleware.ts               # Route protection
-├── drizzle.config.ts               # Drizzle Kit config
-├── tailwind.config.ts              # Design system
-└── package.json
-```
-
-**86 files total.** TypeScript strict mode, zero type errors.
-
----
-
-## Tech Stack
-
-| Layer     | Technology                                                                          |
-| --------- | ----------------------------------------------------------------------------------- |
-| Framework | Next.js 14 (App Router)                                                             |
-| Language  | TypeScript (strict)                                                                 |
-| Styling   | Tailwind CSS + CSS variables                                                        |
-| Database  | PostgreSQL 16 via Drizzle ORM (shared `basement_starter` DB, `bs_` prefixed tables) |
-| Auth      | NextAuth.js (GitHub, Google, email magic link)                                      |
-| Payments  | Stripe (Checkout, Webhooks, Customer Portal)                                        |
-| Charts    | Recharts                                                                            |
-| Local dev | Docker Compose                                                                      |
-
----
-
-## Design System
-
-The visual identity is **warm, editorial, premium** -- not the typical dark dev-tool aesthetic.
-
-### Colors
+This will:
 
-| Token         | Hex       | Usage                   |
-| ------------- | --------- | ----------------------- |
-| `cream`       | `#FAF8F4` | Primary background      |
-| `warm-white`  | `#FFFDF9` | Card backgrounds        |
-| `ink`         | `#1A1714` | Primary text            |
-| `ink-soft`    | `#4A453D` | Secondary text          |
-| `ink-muted`   | `#8A8379` | Tertiary text, labels   |
-| `accent`      | `#C4653A` | Terracotta orange, CTAs |
-| `accent-soft` | `#E8956A` | Hover states            |
-| `accent-bg`   | `#FFF3ED` | Accent backgrounds      |
-| `border`      | `#E8E4DE` | Card borders            |
-| `sage`        | `#6B7E6B` | Success, dev indicators |
-| `blue`        | `#4A6FA5` | Info, links             |
+1. Authenticate with your Basestream account
+2. Configure automatic session tracking
+3. Start capturing work in the background
 
-### Typography
+## How it works
 
-- **Headings:** Newsreader (serif), weight 400, letter-spacing -0.025em
-- **Body:** DM Sans (sans-serif), weight 300 body / 500 labels
-- **Code:** SF Mono / Fira Code (monospace)
+Basestream runs silently alongside your AI tools. At the end of each session, it captures what was built — files changed, commits made, tools used, token usage — and syncs it to your dashboard.
 
-### Animations
-
-- Word-by-word blur reveal (hero headline)
-- Terminal typing sequence with cursor blink
-- Scroll-triggered reveal (opacity + translateY)
-- Animated counters (eased count-up)
-- Tool chip stagger reveal
-- Divider accent wipe
-- Ambient glow orb drift
-- Card hover transitions
-- Nav scroll blur transition
-
----
-
-## Landing Page
-
-The landing page at `/` is a single-page marketing site with 12 sections:
-
-1. **Navbar** -- Fixed, blur-on-scroll, logo + links + CTA
-2. **Hero** -- Glow orbs, word-by-word blur reveal headline, badge, dual CTAs
-3. **Terminal Demo** -- Typing animation showing `npx basestream init` flow
-4. **Problem Section** -- "Sessions vanish", "Tokens != outcomes", "Status is manual"
-5. **Divider** -- Accent wipe on scroll
-6. **How It Works** -- 3 numbered steps with hover accent lines
-7. **Divider**
-8. **Two Views** -- Developer journal + Manager dashboard mockups with animated counters
-9. **Integrations** -- Tool chips with stagger animation (6 active, 3 coming soon)
-10. **Pricing** -- 3-tier (Free / $12 Team / Custom Enterprise)
-11. **CTA** -- Final conversion with accent glow
-12. **Footer** -- Copyright + links
-
----
+**No prompts. No interruptions. No behavior changes required.**
 
-## Authentication
+### Supported tools
 
-Three providers via NextAuth.js:
+- Claude Code
+- Cursor
+- GitHub Copilot
+- More coming soon
 
-- **GitHub OAuth** -- `GITHUB_CLIENT_ID` + `GITHUB_CLIENT_SECRET`
-- **Google OAuth** -- `GOOGLE_CLIENT_ID` + `GOOGLE_CLIENT_SECRET`
-- **Email magic link** -- Sends sign-in link to email
-
-Session includes `user.id` and `user.plan` via callback augmentation.
-
-Middleware at `src/middleware.ts` protects all `/dashboard/*` routes.
-
----
-
-## Stripe Integration
-
-### Flow
-
-1. User clicks "Get early access" on Team pricing -> `/signup?plan=team`
-2. After auth, redirects to `GET /api/stripe/checkout` -> Stripe Checkout
-3. Stripe webhook (`POST /api/stripe/webhook`) handles:
-   - `checkout.session.completed` -- Upgrade user to TEAM plan
-   - `customer.subscription.updated` -- Update billing period
-   - `customer.subscription.deleted` -- Downgrade to FREE
-
-### Plans
-
-| Plan       | Price       | Features                                              |
-| ---------- | ----------- | ----------------------------------------------------- |
-| Personal   | Free        | Auto-logging, personal dashboard, CLI, weekly digest  |
-| Team       | $12/user/mo | Team dashboard, privacy controls, GitHub, ROI metrics |
-| Enterprise | Custom      | SSO/SAML, SOC 2, self-hosted, RBAC, audit logs        |
-
----
-
-## API Routes
-
-### Data Ingestion
-
-| Method | Route          | Auth    | Description                            |
-| ------ | -------------- | ------- | -------------------------------------- |
-| `POST` | `/api/entries` | API key | Create single work entry               |
-| `POST` | `/api/sync`    | API key | Bulk upsert (idempotent via sessionId) |
-
-### Data Retrieval
-
-| Method   | Route               | Auth            | Description                            |
-| -------- | ------------------- | --------------- | -------------------------------------- |
-| `GET`    | `/api/entries`      | Session/API key | List entries (paginated, filtered)     |
-| `GET`    | `/api/entries/[id]` | Session         | Get single entry                       |
-| `PATCH`  | `/api/entries/[id]` | Session         | Update entry                           |
-| `DELETE` | `/api/entries/[id]` | Session         | Delete entry                           |
-| `GET`    | `/api/summary`      | Session         | Aggregated stats (optional `type=roi`) |
-| `GET`    | `/api/search?q=`    | Session         | Full-text search on summary/why        |
-
-### Organization
-
-| Method            | Route                       | Auth               | Description               |
-| ----------------- | --------------------------- | ------------------ | ------------------------- |
-| `GET/POST`        | `/api/orgs`                 | Session            | List/create organizations |
-| `GET/POST`        | `/api/orgs/[orgId]/members` | Session (Manager+) | List/add members          |
-| `GET/POST/DELETE` | `/api/orgs/[orgId]/invites` | Session (Admin)    | Manage invites            |
-
-### Integrations
-
-| Method            | Route                               | Auth                 | Description           |
-| ----------------- | ----------------------------------- | -------------------- | --------------------- |
-| `GET/POST/DELETE` | `/api/integrations/github`          | Session + org member | GitHub integration    |
-| `GET/POST/DELETE` | `/api/integrations/hubspot`         | Session + org member | HubSpot integration   |
-| `GET/POST/DELETE` | `/api/integrations/jira`            | Session + org member | Jira integration      |
-| `GET/POST/DELETE` | `/api/integrations/google-calendar` | Session + org member | Google Calendar       |
-| `GET/POST/DELETE` | `/api/integrations/fireflies`       | Session + org member | Fireflies integration |
-
-All integration routes verify org membership. DELETE requires ADMIN role.
-
----
-
-## Dashboard Pages
-
-All pages use the warm cream aesthetic with shared components.
-
-| Page         | Path                          | Description                                                  |
-| ------------ | ----------------------------- | ------------------------------------------------------------ |
-| Overview     | `/dashboard`                  | Personal feed + activity heatmap + quick stats               |
-| Team         | `/dashboard/team`             | Manager view: stacked bar chart, per-person activity, digest |
-| Projects     | `/dashboard/projects`         | Project grid with category breakdown bars                    |
-| ROI          | `/dashboard/roi`              | Snapshot metrics + bar/pie/line Recharts                     |
-| Integrations | `/dashboard/integrations`     | Connect/disconnect tool integrations                         |
-| Settings     | `/dashboard/settings`         | Profile, API keys, notification prefs                        |
-| Billing      | `/dashboard/settings/billing` | Plan management, Stripe portal                               |
-| Team Mgmt    | `/dashboard/settings/team`    | Members, roles, invites                                      |
-
----
-
-## Database Schema
-
-10 models across auth, work tracking, organizations, and integrations:
-
-- **User** -- Auth + Stripe billing fields + plan
-- **Account/Session/VerificationToken** -- NextAuth adapter tables
-- **Org** -- Organization with slug
-- **OrgMember** -- User-org junction with role (ADMIN/MANAGER/DEVELOPER)
-- **OrgInvite** -- Email invitations with expiry
-- **WorkEntry** -- Core data: summary, category, why, outcome, git context, AI metadata
-- **ApiKey** -- `bs_`-prefixed keys for CLI auth
-- **Integration** -- Per-org tool connections
-
-### Seed Data
-
-Run `npx prisma db seed` to populate:
-
-- **Acme Engineering** org with 3 team members
-- **Sarah Chen** (Manager), **James Rodriguez** (Developer), **Priya Patel** (Developer)
-- **~50 work entries** across 5 projects over 2 weeks
-- Realistic summaries, PR URLs, branch names, session durations
-
----
-
-## Claude Code Integration
-
-The core product mechanic: `src/lib/integrations/claude-code-rules.ts` exports a CLAUDE.md template that instructs Claude Code to silently log structured work entries to `~/.basestream/buffer/` after every meaningful task.
-
-Each entry captures:
-
-- Summary, category, business context (why)
-- Git context (repo, branch, files changed)
-- Outcome and complexity
-- AI metadata (model, tool version, session duration, turns)
-
-The CLI syncs buffered entries to the API via `POST /api/sync`.
-
----
-
-## Environment Variables
+## Commands
 
 ```bash
-# Database (shared with packages/api — same Postgres instance)
-DATABASE_URL=postgresql://postgres:postgres@localhost:5434/basement_starter
+basestream init       # Set up Basestream in your environment
+basestream login      # Authenticate with your account
+basestream sync       # Manually sync buffered entries
+basestream status     # View this week's sessions
+basestream uninstall  # Remove Basestream from your environment
+```
 
-# Skip Stripe for local dev
-SKIP_PAYMENT=true
+## Dashboard
 
-# Auth
-NEXTAUTH_URL=http://localhost:3000
-NEXTAUTH_SECRET=           # openssl rand -base64 32
+Your team's AI work shows up at [app.basestream.ai](https://app.basestream.ai):
 
-# OAuth
-GITHUB_CLIENT_ID=
-GITHUB_CLIENT_SECRET=
-GOOGLE_CLIENT_ID=
-GOOGLE_CLIENT_SECRET=
+- **Overview** — Activity feed, heatmap, quick stats
+- **Team** — Who's building what, output by person
+- **Projects** — Work grouped by repository
+- **Scores** — Performance metrics weighted by role
+- **Cost Intelligence** — Token spend, tool adoption, before/after efficiency
+- **ROI** — Cost per outcome, hours saved, completion rates
+- **Integrations** — Connect GitHub, Jira, Notion, Google Calendar, and more
 
-# Stripe
-STRIPE_SECRET_KEY=
-STRIPE_PUBLISHABLE_KEY=
-STRIPE_WEBHOOK_SECRET=
-STRIPE_TEAM_PRICE_ID=
+## Plans
 
-# Integrations (optional)
-HUBSPOT_CLIENT_ID=
-HUBSPOT_CLIENT_SECRET=
-JIRA_CLIENT_ID=
-JIRA_CLIENT_SECRET=
-GOOGLE_CALENDAR_CLIENT_ID=
-GOOGLE_CALENDAR_CLIENT_SECRET=
-FIREFLIES_API_KEY=
-```
+| Plan       | Price       | For                                 |
+| ---------- | ----------- | ----------------------------------- |
+| Personal   | Free        | Individual developers               |
+| Team       | $12/user/mo | Engineering teams                   |
+| Enterprise | Custom      | Organizations with compliance needs |
 
----
+## Privacy
 
-## Scripts
+- Work entries are scoped to your organization
+- Visibility controls: private, team, or public per entry
+- No source code is ever captured — only metadata
+- API keys are scoped per user, revocable anytime
 
-```bash
-npm run dev              # Start dev server (port 3000)
-npm run build            # Production build
-npm run start            # Start production server
-npm run db:generate      # Generate SQL migration from schema
-npm run db:push          # Push schema to database
-npm run db:seed          # Seed demo data (npx tsx src/db/seed.ts)
-npx drizzle-kit studio   # Visual database browser
-npx tsc --noEmit         # Type check
-```
+## Support
 
----
+- [Documentation](https://docs.basestream.ai)
+- [Contact us](mailto:support@basestream.ai)
 
-## Verification Status
+---
 
-| Check                              | Status                                                 |
-| ---------------------------------- | ------------------------------------------------------ |
-| TypeScript strict (`tsc --noEmit`) | 0 errors                                               |
-| Next.js build (`next build`)       | All 26 pages generated                                 |
-| Landing page sections              | All 12 implemented                                     |
-| Dashboard pages                    | All 9 implemented                                      |
-| API routes                         | All 16 implemented                                     |
-| Shared components used             | All 8 dashboard + 5 UI components wired in             |
-| Auth flow                          | NextAuth + DrizzleAdapter + middleware + 3 providers   |
-| Stripe flow                        | Checkout + webhook + portal + SKIP_PAYMENT bypass      |
-| Drizzle schema                     | 10 tables (bs\_ prefixed), 7 enums, all indexes        |
-| Seed data                          | 3 users, 44 entries, 1 org                             |
-| Monorepo integration               | `packages/basestream/`, shared Postgres on port 5434   |
-| E2E API tested                     | POST/GET entries, bulk sync (idempotent), API key auth |
-| Design system                      | Colors, fonts, animations all matching spec            |
-| Mobile responsive                  | Sidebar collapse, grid stack, nav hide                 |
-| Branding                           | "Basestream" + "A Sublevel product" throughout         |
+Built by [Sublevel Inc.](https://sublevel.com)

package/dist/cli.mjs

@@ -455,6 +455,18 @@ var OrgRole = makeEnum(["ADMIN", "MANAGER", "USER"]);
 var ArtifactStatus = makeEnum(["GENERATING", "READY", "FAILED"]);
 var ArtifactPeriod = makeEnum(["QUARTER", "HALF", "YEAR", "CUSTOM"]);
 var IntegrationType = makeEnum(["GITHUB", "HUBSPOT", "JIRA", "GOOGLE_CALENDAR", "FIREFLIES", "CLAUDE_CODE", "NOTION"]);
+var MemberRole = makeEnum([
+  "ENGINEER",
+  "MANAGER",
+  "DESIGNER",
+  "EXEC",
+  "SALES",
+  "SUPPORT",
+  "DATA_SCIENTIST",
+  "PRODUCT",
+  "QA",
+  "DEVOPS"
+]);
 
 // src/cli/commands/status.ts
 init_util();
@@ -605,6 +617,10 @@ function readSessionAccumulator(sessionId) {
     raw.filesWritten = new Set(raw.filesWritten || []);
     raw.commitShas = new Set(raw.commitShas || []);
     raw.userMessages = raw.userMessages || [];
+    raw.inputTokens = raw.inputTokens || 0;
+    raw.outputTokens = raw.outputTokens || 0;
+    raw.cacheReadTokens = raw.cacheReadTokens || 0;
+    raw.cacheWriteTokens = raw.cacheWriteTokens || 0;
     return raw;
   } catch {
     return null;
@@ -616,8 +632,12 @@ function writeSessionAccumulator(acc) {
     ...acc,
     filesWritten: Array.from(acc.filesWritten),
     commitShas: Array.from(acc.commitShas),
-    userMessages: acc.userMessages.slice(0, 5)
-    // Keep at most 5
+    userMessages: acc.userMessages.slice(0, 5),
+    inputTokens: acc.inputTokens,
+    outputTokens: acc.outputTokens,
+    cacheReadTokens: acc.cacheReadTokens,
+    cacheWriteTokens: acc.cacheWriteTokens,
+    model: acc.model
   };
   fs5.writeFileSync(sessionFile, JSON.stringify(serializable, null, 2));
 }
@@ -650,6 +670,18 @@ function analyzeTranscript(transcriptPath, acc) {
       );
       if (hasText) acc.turns++;
     }
+    if (entry.type === "assistant") {
+      const msg = entry.message;
+      const usage = msg?.usage || entry.usage;
+      const model = msg?.model || entry.model;
+      if (model) acc.model = model;
+      if (usage) {
+        acc.inputTokens += usage.input_tokens || 0;
+        acc.outputTokens += usage.output_tokens || 0;
+        acc.cacheReadTokens += usage.cache_read_input_tokens || 0;
+        acc.cacheWriteTokens += usage.cache_creation_input_tokens || 0;
+      }
+    }
     if (entry.type === "assistant") {
       for (const block of contentBlocks) {
         if (block.type === "tool_use") {
@@ -751,7 +783,11 @@ function flushToBuffer(acc) {
     filesTouched: acc.filesWritten.size,
     complexity,
     toolVersion: null,
-    model: null,
+    model: acc.model || null,
+    inputTokens: acc.inputTokens > 0 ? acc.inputTokens : null,
+    outputTokens: acc.outputTokens > 0 ? acc.outputTokens : null,
+    cacheReadTokens: acc.cacheReadTokens > 0 ? acc.cacheReadTokens : null,
+    cacheWriteTokens: acc.cacheWriteTokens > 0 ? acc.cacheWriteTokens : null,
     sessionDurationMin: durationMin > 0 ? durationMin : 1,
     turns: acc.turns,
     prUrl: null,
@@ -865,6 +901,10 @@ async function hookStop() {
       filesWritten: /* @__PURE__ */ new Set(),
       commitShas: /* @__PURE__ */ new Set(),
       userMessages: [],
+      inputTokens: 0,
+      outputTokens: 0,
+      cacheReadTokens: 0,
+      cacheWriteTokens: 0,
       gitBranch: gitInfo.branch,
       gitRepo: gitInfo.repo,
       projectName: gitInfo.projectName
@@ -874,6 +914,11 @@ async function hookStop() {
   acc.turns = 0;
   acc.toolCalls = [];
   acc.userMessages = [];
+  acc.inputTokens = 0;
+  acc.outputTokens = 0;
+  acc.cacheReadTokens = 0;
+  acc.cacheWriteTokens = 0;
+  acc.model = void 0;
   if (transcript_path) {
     acc = analyzeTranscript(transcript_path, acc);
   }
@@ -1014,7 +1059,7 @@ async function main() {
     process.exit(0);
   }
   if (command === "--version" || command === "-v") {
-    console.log(true ? "0.2.11" : "dev");
+    console.log(true ? "0.3.0" : "dev");
     process.exit(0);
   }
   switch (command || "init") {

package/package.json

@@ -18,5 +18,5 @@
     "unlink:cli": "npm unlink -g @basestream/cli"
   },
   "type": "module",
-  "version": "0.2.11"
+  "version": "0.3.0"
 }