@nodrift/cli 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Prism Labs (prismlabs.tech)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,41 @@
+# nodrift
+
+> Flight recorder + bisect for AI agent behavior. Your agent got worse overnight — find out why in 10 seconds.
+
+Agent behavior is determined by a composite nobody version-controls as a system: `CLAUDE.md`, skills, `.cursor/rules`, MCP server versions, harness/CLI version, model. Any of these can change without you — marketplace skills auto-update, harnesses ship silent changes, providers update models. nodrift snapshots the full composite, shows you exactly what changed, ranks the suspects, and rolls back the culprit.
+
+**Status: pre-release.** First public release targeted before 2026-07-28 (the MCP spec RC ships six breaking changes that day — `nodrift scan mcp` will tell you what breaks for you).
+
+## Quick start (once released)
+
+```
+npx @nodrift/cli init      # snapshot your full agent-config composite, <60s, no login
+nodrift diff          # git status for your agent config — incl. global files
+nodrift blame --since "last friday"   # ranked candidate causes for "it got worse"
+nodrift rollback skill:<name> --to <version>
+nodrift scan mcp      # what the 2026-07-28 MCP RC breaks in your config
+```
+
+## What it does — and what it honestly can't
+
+- `blame` produces **candidate causes, not verdicts** — correlation from timing, change magnitude, and source. Verdicts require running your eval suite across states (`bisect`, coming in v1.1).
+- Harness internals are unobservable: we can detect *that* behavior-determining state changed, not always *what* a vendor changed inside a release.
+- Canary evals (v1.1) are smoke detectors, not MRIs: they catch gross regressions (ignored instructions, skills not firing), not every subtle shift.
+
+## Supported harnesses
+
+Claude Code and Cursor at launch; Codex CLI and Copilot next. Adapters are read-only — nodrift never wraps, hooks, or instruments your agent at runtime.
+
+## Telemetry
+
+Opt-in only, and inspectable: `nodrift telemetry --show-payload` prints exactly what would be sent (event names, config hashes, version strings — never file contents, paths, or prompts). `--no-telemetry`, config, and `NODRIFT_TELEMETRY=0` are all honored, forever.
+
+## Docs
+
+- [Roadmap](docs/roadmap.md) — what's coming, in order
+- [Decisions](docs/decisions.md) — public architecture decision records
+- [Contributing](CONTRIBUTING.md) · [Security](SECURITY.md)
+
+## License
+
+[MIT](LICENSE). Contributions accepted under the [Developer Certificate of Origin](CONTRIBUTING.md#developer-certificate-of-origin).

package/bin/nodrift.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+console.log(`
+  nodrift — flight recorder + bisect for AI agent behavior
+
+  Your agent got worse overnight. Was it your skill edit, a marketplace
+  auto-update, the harness release, or the model?
+
+  v0.0.1 is a placeholder. First real release lands before 2026-07-28.
+
+  → https://nodrift.dev
+  → https://github.com/nodrift-dev/nodrift
+`);

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@nodrift/cli",
+  "version": "0.0.1",
+  "description": "Flight recorder + bisect for AI agent behavior. Coming soon — nodrift.dev",
+  "bin": {
+    "nodrift": "bin/nodrift.js"
+  },
+  "files": [
+    "bin"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nodrift-dev/nodrift.git"
+  },
+  "homepage": "https://nodrift.dev",
+  "keywords": [
+    "ai-agents",
+    "claude-code",
+    "cursor",
+    "config-drift",
+    "regression",
+    "cli"
+  ],
+  "engines": {
+    "node": ">=20"
+  }
+}