autotel-cli 0.1.0

package/README.md

@@ -0,0 +1,220 @@
+# autotel-cli
+
+CLI for autotel - setup wizard, diagnostics, and incremental features.
+
+## Installation
+
+```bash
+npm install -g autotel-cli
+# or
+npx autotel <command>
+```
+
+## Commands
+
+### `autotel init`
+
+Interactive setup wizard to initialize autotel in your project.
+
+```bash
+# Interactive mode
+npx autotel init
+
+# Use defaults (local backend, all auto-instrumentations)
+npx autotel init --yes
+
+# Use a quick preset
+npx autotel init --preset node-datadog-pino
+
+# Dry run - see what would be created
+npx autotel init --dry-run
+```
+
+**Options:**
+- `--yes, -y` - Accept defaults, non-interactive
+- `--preset <name>` - Use a quick preset (e.g., `node-datadog-pino`, `node-honeycomb`)
+- `--dry-run` - Skip installation and print what would be done
+- `--no-install` - Generate files only, skip package installation
+- `--force` - Overwrite existing config (creates backup first)
+
+**Quick presets:**
+- `node-datadog-pino` - Node.js + Datadog + Pino logging
+- `node-datadog-agent` - Node.js + Datadog Agent (local development)
+- `node-honeycomb` - Node.js + Honeycomb
+- `node-otlp` - Node.js + Generic OTLP endpoint
+
+### `autotel doctor`
+
+Run diagnostics on your autotel setup.
+
+```bash
+# Run all checks
+npx autotel doctor
+
+# Output as JSON
+npx autotel doctor --json
+
+# Auto-fix resolvable issues
+npx autotel doctor --fix
+
+# List available checks
+npx autotel doctor --list-checks
+```
+
+**Options:**
+- `--json` - Output machine-readable JSON
+- `--fix` - Auto-fix resolvable issues
+- `--list-checks` - List all available checks
+- `--env-file <path>` - Specify env file to check
+
+**Exit codes:**
+- `0` - All checks passed
+- `1` - Warnings found
+- `2` - Errors found
+
+### `autotel add <type> <name>`
+
+Add a backend, subscriber, plugin, or platform incrementally.
+
+```bash
+# Add Datadog backend
+npx autotel add backend datadog
+
+# Add PostHog event subscriber
+npx autotel add subscriber posthog
+
+# Add Mongoose plugin
+npx autotel add plugin mongoose
+
+# List all available presets
+npx autotel add --list
+
+# List backends only
+npx autotel add backend --list
+
+# Show help for a specific preset
+npx autotel add backend datadog --help
+```
+
+**Types:**
+- `backend` - Telemetry backends (Datadog, Honeycomb, OTLP, etc.)
+- `subscriber` - Event subscribers (PostHog, Mixpanel, Segment, Slack, etc.)
+- `plugin` - Database/ORM plugins (Mongoose, Drizzle, etc.)
+- `platform` - Platform support (AWS Lambda, Cloudflare Workers, etc.)
+
+**Options:**
+- `--list` - List available presets
+- `--dry-run` - Skip installation and print what would be done
+- `--force` - Overwrite non-CLI-owned config (creates backup first)
+
+## Global Options
+
+All commands support these options:
+
+- `--cwd <path>` - Target directory (default: current working directory)
+- `--verbose` - Show detailed output
+- `--quiet` - Only show warnings and errors
+
+## Package Manager Detection
+
+The CLI automatically detects your package manager from the nearest lockfile:
+
+1. `pnpm-lock.yaml` → pnpm
+2. `bun.lockb` → bun
+3. `yarn.lock` → yarn
+4. `package-lock.json` → npm
+
+Fallback: npm if no lockfile found.
+
+## Monorepo Support
+
+The CLI detects workspace roots and handles installation correctly:
+
+```bash
+# Install at package root (default)
+npx autotel init --cwd ./packages/my-app
+
+# Install at workspace root
+npx autotel init --cwd ./packages/my-app --workspace-root
+```
+
+## Generated Files
+
+### `src/instrumentation.mts`
+
+The CLI generates an instrumentation file with clear section markers:
+
+```typescript
+/**
+ * autotel instrumentation - managed by autotel-cli
+ * Run `autotel add <feature>` to update this file
+ */
+import 'autotel/register';
+import { init } from 'autotel';
+
+// --- AUTOTEL:BACKEND ---
+import { createDatadogConfig } from 'autotel-backends/datadog';
+
+init({
+  // --- AUTOTEL:BACKEND_CONFIG ---
+  ...createDatadogConfig({
+    apiKey: process.env.DATADOG_API_KEY,
+  }),
+});
+```
+
+### `.env.example`
+
+Environment variable template based on selected presets:
+
+```bash
+# Autotel configuration
+# Copy to .env and fill in values
+
+# Datadog API key for authentication
+# ⚠️ SENSITIVE: Do not commit this value
+DATADOG_API_KEY=your-api-key
+```
+
+## Starting Your App
+
+After running `autotel init`, start your app with the `--import` flag:
+
+```bash
+# Node.js ESM
+node --import ./src/instrumentation.mts dist/index.js
+
+# With tsx (development)
+tsx --import ./src/instrumentation.mts src/index.ts
+```
+
+Or add it to your `package.json` scripts:
+
+```json
+{
+  "scripts": {
+    "start": "node --import ./src/instrumentation.mjs dist/index.js",
+    "dev": "tsx --import ./src/instrumentation.mts src/index.ts"
+  }
+}
+```
+
+## Development
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build
+pnpm build
+
+# Run tests
+pnpm test
+
+# Type check
+pnpm typecheck
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }