@stacknext/cli 0.0.0-stage → 0.6.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 StackNext contributors
+
+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

@@ -1,3 +1,42 @@
-# Temporary Holding Version
+# @stacknext/cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Local-first runtime debugging, diagnostics and Playwright regression testing for
+Next.js App Router apps and AI coding agents.
+
+StackNext collects OpenTelemetry spans plus Drizzle/Prisma query events and
+Next.js errors over loopback, stores them in a bounded in-memory sample, and
+exposes a dashboard, CLI and read-only MCP server. It also derives deterministic
+diagnostic findings and compares Playwright-linked runtime captures against
+saved baselines. No cloud account, hosted backend, AI API key or telemetry
+upload.
+
+## Quick start
+
+```bash
+npm install --save-dev @stacknext/cli @stacknext/next
+npx stacknext init
+npx stacknext doctor
+npx stacknext dev
+```
+
+`init` detects Next.js 15/16 with the App Router, writes
+`stacknext.config.json`, and creates `instrumentation.ts` (or
+`instrumentation.js` for a JavaScript project) only when none exists. Existing
+instrumentation is preserved and a manual hook is printed.
+`dev` starts the loopback collector and the app's own `dev` script.
+
+Add `@stacknext/drizzle`, `@stacknext/prisma`, or `@stacknext/playwright` only
+when you use those integrations.
+
+## Requirements
+
+- Node.js 20.9 or newer
+- Next.js 15 or 16, App Router, Node.js runtime
+- Playwright 1.40+ for runtime regression capture
+
+Next.js Edge runtime and the Pages Router are not supported. The package is
+ESM-only. See the [project README](https://github.com/marrrkkk/stacknext#readme),
+[getting started](https://github.com/marrrkkk/stacknext/blob/main/docs/getting-started.md)
+and [compatibility matrix](https://github.com/marrrkkk/stacknext/blob/main/docs/compatibility.md).
+
+License: MIT.

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":""}

package/dist/bin.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { main } from './program.js';
+await main();
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAEnC,MAAM,IAAI,EAAE,CAAA"}

package/dist/collector/server.d.ts

@@ -0,0 +1,28 @@
+import { TelemetryStore, type HealthResponse, type NextOtelVerboseStatus, type StackNextConfig } from '@stacknext/core';
+export interface StartCollectorOptions {
+    port: number;
+    token: string;
+    projectName: string;
+    config: StackNextConfig;
+    dashboardDir: string | null;
+    version?: string;
+    host?: string;
+    log?: (message: string) => void;
+    autoPort?: boolean;
+    sseHeartbeatMs?: number;
+    /** Project whose saved runs, baselines and comparisons are served read-only. */
+    projectDir?: string;
+    /** Overrides environment/config inference, mainly for tests and `stacknext dev`. */
+    nextOtelVerbose?: NextOtelVerboseStatus;
+}
+export interface CollectorHandle {
+    port: number;
+    url: string;
+    token: string;
+    store: TelemetryStore;
+    health: () => HealthResponse;
+    close: () => Promise<void>;
+}
+export declare function resolveDashboardDir(): Promise<string>;
+export declare function startCollector(options: StartCollectorOptions): Promise<CollectorHandle>;
+//# sourceMappingURL=server.d.ts.map

package/dist/collector/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/collector/server.ts"],"names":[],"mappings":"AAOA,OAAO,EAKL,cAAc,EAkBd,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EAYrB,MAAM,iBAAiB,CAAA;AAoCxB,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,eAAe,CAAA;IACvB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,oFAAoF;IACpF,eAAe,CAAC,EAAE,qBAAqB,CAAA;CACxC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,cAAc,CAAA;IACrB,MAAM,EAAE,MAAM,cAAc,CAAA;IAC5B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B;AAoSD,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC,CA2B3D;AAoBD,wBAAsB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CA+gC7F"}