@driftless-sh/cli 0.1.15 → 0.1.17

package/README.md

@@ -11,26 +11,37 @@ npm install -g @driftless-sh/cli
 ## Quick Start
 
 ```bash
-driftless login --key <api-key>     # Authenticate
-driftless init                       # Scan repo, upload baseline, suggest rules
-driftless scan --diff                # Check uncommitted changes against rules
-driftless context get <name>         # Load team context before coding
+driftless login --key <api-key>       # Generate one at driftless.icu → Settings → API keys
+driftless init                         # Scan repo, upload baseline, suggest rules
+driftless scan --diff                  # Check uncommitted changes against rules
+driftless context get <name>           # Load team context before coding
+driftless install-skill                # Write AGENTS.md for Claude Code / Cursor
 ```
 
-Dashboard: [driftless.icu](https://driftless.icu) | API: [api.driftless.icu](https://api.driftless.icu/api/v1)
+Dashboard: [driftless.icu](https://driftless.icu) | API: [api.driftless.icu/api/v1](https://api.driftless.icu/api/v1)
+
+### Where to get your API key
+
+1. Go to [driftless.icu](https://driftless.icu) → Sign in
+2. Navigate to **Settings → API keys**
+3. Click **Generate key**
+4. Copy the key and run: `driftless login --key drift_xxx`
+
+Or set the env var: `export DRIFTLESS_API_KEY=drift_xxx`
 
 ## Commands
 
 ### `driftless login`
 
-Authenticate with Driftless Cloud.
+Authenticate with Driftless Cloud. Generates an API key at [driftless.icu](https://driftless.icu) → Settings → API keys.
 
 ```bash
 driftless login --key drift_xxx
-driftless login --key drift_xxx --url https://api.driftless.icu/api/v1
 ```
 
-Auth is stored in `~/.driftless/config.json`. You can also set `DRIFTLESS_API_KEY` as an env var.
+Auth is stored in `~/.driftless/config.json`. You can also set `DRIFTLESS_API_KEY` as an env var instead.
+
+**Default API URL:** `https://api.driftless.icu/api/v1` — no need to specify it unless you're running a self-hosted instance.
 
 ---
 
@@ -39,7 +50,7 @@ Auth is stored in `~/.driftless/config.json`. You can also set `DRIFTLESS_API_KE
 Full repo initialization. Runs a 3-pass scan:
 
 1. **Identity** — detects framework, system type, auth patterns (zero tokens)
-2. **AST extraction** — extracts endpoints, guards, services, modules, and their relations (zero tokens)
+2. **AST extraction** — extracts endpoints, guards, services, modules, DTOs with fields + validations, and their relations (zero tokens)
 3. **Upload** — sends baseline + components + relations to Cloud
 
 ```bash
@@ -224,12 +235,14 @@ All output is JSON by default, making it easy for agents to parse and use as con
 
 ## Architecture
 
-The CLI is bundled with esbuild into a single distributable binary. The `@driftless/scanner` lib (ts-morph AST parser) is bundled inside the CLI at build time. This avoids publishing the scanner as a separate npm package and keeps `workspace:*` deps internal.
+The CLI is bundled with esbuild into a single distributable binary. The `@driftless/scanner` lib (TypeScript Compiler API parser) is bundled inside the CLI at build time. This avoids publishing the scanner as a separate npm package and keeps `workspace:*` deps internal.
+
+The scanner uses `ts.createSourceFile()` per file — no global Project, no LanguageService, no OOM risk. ~300ms, ~35MB for 260 files. Detects controllers, endpoints, guards, services, modules, DTOs with fields + validations, and builds a dependency graph from imports.
 
 ```
 driftless init
   ├── Pass 1: Identity (package.json, tsconfig, folder structure)
-  ├── Pass 2: AST extraction (ts-morph → endpoints, guards, services, relations)
+  ├── Pass 2: AST extraction (TypeScript Compiler API → endpoints, guards, services, DTOs, relations)
   └── Pass 3: Upload to Cloud (baseline + components + relations)
 
 driftless scan

package/dist/index.js

@@ -215722,7 +215722,7 @@ function pad2(s, n) {
 }
 
 // src/index.ts
-var VERSION = "0.1.14";
+var VERSION = "0.1.16";
 var HELP_TEXT = `Driftless CLI v${VERSION} \u2014 Context integrity for AI engineering teams
 
 Install:  npm install -g @driftless-sh/cli