@gurulu/cli 0.4.6 → 1.0.0

package/LICENSE

@@ -0,0 +1,92 @@
+License text copyright (c) 2020 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+Parameters
+
+Licensor:             MONAFY LTD (UK Company No. 17031485)
+Licensed Work:        @gurulu/cli (version 0.1.0 and later). The Licensed Work is (c) 2026
+                      MONAFY LTD.
+Additional Use Grant: You may make production use of the Licensed Work, provided
+                      Your use does not include offering the Licensed Work to third
+                      parties on a hosted or embedded basis in order to compete with 
+                      MONAFY LTD's paid version(s) of the Licensed Work. For purposes 
+                      of this license:
+
+                      A "competitive offering" is a Product that is offered to third
+                      parties on a paid basis, including through paid support 
+                      arrangements, that significantly overlaps with the capabilities 
+                      of MONAFY LTD's paid version(s) of the Licensed Work. If Your 
+                      Product is not a competitive offering when You first make it 
+                      generally available, it will not become a competitive offering
+                      later due to MONAFY LTD releasing a new version of the Licensed 
+                      Work with additional capabilities. In addition, Products that 
+                      are not provided on a paid basis are not competitive.
+
+                      "Product" means software that is offered to end users to manage 
+                      in their own environments or offered as a service on a hosted 
+                      basis.
+
+                      "Embedded" means including the source code or executable code 
+                      from the Licensed Work in a competitive offering. "Embedded" 
+                      also means packaging the competitive offering in such a way 
+                      that the Licensed Work must be accessed or downloaded for the 
+                      competitive offering to operate.
+
+                      Hosting or using the Licensed Work(s) for internal purposes 
+                      within an organization is not considered a competitive 
+                      offering. MONAFY LTD considers your organization to include all 
+                      of your affiliates under common control.
+
+                      For binding interpretive guidance on using MONAFY LTD products 
+                      under the Business Source License, please visit our FAQ. 
+                      (https://gurulu.io/legal/busl-faq)
+Change Date:          2030-05-21.
+Change License:       Apache License, Version 2.0
+
+For information about alternative licensing arrangements for the Licensed Work,
+please contact legal@gurulu.io.
+
+Notice
+
+Business Source License 1.1
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.

package/README.md

@@ -1,127 +1,56 @@
 # @gurulu/cli
 
-CLI for Gurulu.io — setup, diagnostics, data exploration, and AI-powered analytics from your terminal.
+CLI for [Gurulu](https://gurulu.io) — Truth Layer for product analytics.
 
-## Quick Start
+Registry-as-code, typed events, schema sync between your codebase and the Gurulu event registry.
+
+## Install
 
 ```bash
-npx @gurulu/cli init
+npm install -g @gurulu/cli
+# or
+bun add -g @gurulu/cli
 ```
 
-## Commands
-
-### Authentication
-
-| Command | Description |
-|---------|-------------|
-| `gurulu auth` | Authenticate via device-link flow (or `--key` for manual) |
-| `gurulu login` | Authenticate with API key |
-| `gurulu logout` | Remove a stored profile |
-| `gurulu whoami` | Show current authentication state |
-
-### Setup & Diagnostics
-
-| Command | Description |
-|---------|-------------|
-| `gurulu init` | Set up Gurulu analytics (auto-detects framework) |
-| `gurulu install [path]` | Install Gurulu tracker in a repository |
-| `gurulu add-server` | Add server-side SDK (@gurulu/node) |
-| `gurulu status` | Check SDK health and connection |
-| `gurulu doctor` | Diagnose setup issues |
-| `gurulu config <action>` | Manage CLI profiles (list, use, show, delete) |
-
-### Sites & Keys
-
-| Command | Description |
-|---------|-------------|
-| `gurulu sites <action>` | Manage sites (list, create, show, delete, rotate-token) |
-| `gurulu api-keys <action>` | Manage API keys (list, create, revoke, rotate) |
-
-### Data & Events
-
-| Command | Description |
-|---------|-------------|
-| `gurulu events <action>` | View ingested events (list, tail) |
-| `gurulu insights <action>` | View daily insights (today, history, weekly) |
-| `gurulu chat [question]` | Ask analytics questions in natural language (NL -> SQL) |
-
-### Identity & Audiences
-
-| Command | Description |
-|---------|-------------|
-| `gurulu identity <action>` | View identity state (decay, transfers, cdc-sources) |
-| `gurulu audiences <action>` | View audiences (list, show) |
-| `gurulu experiments <action>` | View experiments (list, show, results) |
-
-### Integrations & Export
-
-| Command | Description |
-|---------|-------------|
-| `gurulu warehouse <action>` | Warehouse exports (BigQuery) |
-| `gurulu warehouses <action>` | View warehouse exports (list, runs) |
-| `gurulu destinations <action>` | View activation destinations (list, show) |
-| `gurulu db <action>` | Connect, list, sync, or remove database sources |
-
-### Monitoring & Debugging
-
-| Command | Description |
-|---------|-------------|
-| `gurulu alerts <action>` | View anomaly alerts (list, show, channels) |
-| `gurulu sourcemap <action>` | Upload source maps for error deobfuscation |
-| `gurulu audit <action>` | Stream or export the CLI audit log (tail, export) |
-| `gurulu playground <action>` | View playground sessions (list) |
-
-## Supported Frameworks
-
-Next.js (App & Pages Router), React (Vite & CRA), Vue 3, Nuxt 3, Svelte & SvelteKit, Astro, Express, NestJS, Plain HTML.
-
-## Authentication
+## Quick start
 
 ```bash
-gurulu auth                        # Device-link flow (recommended)
-gurulu login --api-key pak_live_x  # Manual API key
+gurulu login              # authenticate (OAuth device flow)
+cd my-project
+gurulu init --workspace <workspace-uuid>
+gurulu pull               # fetch registry + generate typed events
 ```
 
-Or set the `GURULU_API_KEY` environment variable.
-
-## Non-Interactive Mode
-
-All commands support `--no-interactive` for CI/CD:
+Then in your code:
 
-```bash
-gurulu init --site-id abc123 --token tok_xxx --no-interactive
+```ts
+import { track } from '@gurulu/web';
+// IDE autocomplete: event names + property types from your registry
+track('checkout.completed', { order_id: 'o_123', total: 49.99 });
 ```
 
-## JSON Output
+## Commands
 
-Use `--json` flag for machine-readable output:
+| Command | Purpose |
+|---|---|
+| `gurulu init` | Initialize Gurulu workspace in current project |
+| `gurulu login` | Authenticate via OAuth device flow |
+| `gurulu logout` | Remove stored credentials |
+| `gurulu whoami` | Show active workspace + user |
+| `gurulu pull` | Pull registry snapshot + generate typed events |
+| `gurulu push` | Propose new event/property to the registry |
+| `gurulu validate` | Scan codebase for deprecated/unknown event calls |
+| `gurulu doctor` | Run 5-check installation diagnostic |
+| `gurulu mcp start` | Start MCP server for Cursor / Claude Code / Lovable |
 
-```bash
-gurulu events list --json
-gurulu status --json
-gurulu doctor --json
-```
+## Documentation
 
-## Telemetry
+[gurulu.io/docs](https://gurulu.io/docs)
 
-`gurulu install` records anonymous install telemetry — framework, CLI version,
-install status, and a SHA-256 hash of the absolute repo path — to help us
-improve framework detection and patch reliability. **No source code, file
-contents, or environment variables are ever sent.**
+## License
 
-On the first interactive install you'll be asked to opt in. Your choice is
-persisted to `~/.gurulu/config.json` (`telemetry: true|false`) and never
-re-asked.
+Business Source License 1.1 — see [LICENSE](./LICENSE).
 
-To opt out:
-
-```bash
-gurulu install --no-telemetry              # one-off
-export GURULU_TELEMETRY=off                # session / shell
-export DO_NOT_TRACK=1                      # honored across most CLI tools
-echo '{"telemetry": false}' > ~/.gurulu/config.json   # permanent
-```
+The Licensed Work converts to the Apache License, Version 2.0 on **2030-05-21**.
 
-Any of `GURULU_TELEMETRY=off|0|false|no`, `DO_NOT_TRACK=1`, `--no-telemetry`,
-or `telemetry: false` in `~/.gurulu/config.json` disables telemetry — the repo
-hash is never computed and no network request is made.
+Copyright © 2026 MONAFY LTD (UK Company No. 17031485).

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}