@peekdev/cli 0.1.0-alpha.1

package/dist/lib/status.d.ts

@@ -0,0 +1,54 @@
+import { type ExtensionIds, type InstallTarget } from '@peekdev/mcp/native-host';
+import type { Database } from 'better-sqlite3';
+/** Manifest install state for one browser target. */
+export interface ManifestTargetStatus {
+    readonly browser: string;
+    /** Filesystem path (darwin/linux) or registry key (win32). */
+    readonly location: string;
+    /** True when the manifest is present at the location. */
+    readonly installed: boolean;
+}
+/** Extension connection state — best-effort; "unknown" until a loopback exists (pre-3d). */
+export type ExtensionConnectionState = 'connected' | 'disconnected' | 'unknown';
+/** Everything `peek status` reports. */
+export interface StatusReport {
+    readonly dbPath: string;
+    /** True if the DB file exists on disk. */
+    readonly dbExists: boolean;
+    /** On-disk size in bytes (0 if absent). */
+    readonly dbBytes: number;
+    /** Highest applied migration, or 0 (or null if the DB couldn't be opened). */
+    readonly schemaVersion: number | null;
+    readonly sessionCount: number | null;
+    readonly hostBinaryPath: string;
+    readonly manifestTargets: ManifestTargetStatus[];
+    /** True if at least one browser has the manifest installed. */
+    readonly anyManifestInstalled: boolean;
+    readonly extensionConnection: ExtensionConnectionState;
+}
+/** Injected probes so status-gathering stays pure + testable. */
+export interface StatusProbes {
+    /** Absolute DB path (defaults via @peekdev/mcp/db `defaultDbPath`). */
+    readonly dbPath: string;
+    /** stat → byte size, or null if the path doesn't exist. */
+    readonly fileSize: (path: string) => number | null;
+    /** True if a manifest path / file exists. */
+    readonly fileExists: (path: string) => boolean;
+    /** Install targets for the current platform (from `resolveInstallTargets`). */
+    readonly manifestTargets: readonly InstallTarget[];
+    /** Configured extension IDs (drives the manifest preview). */
+    readonly extensionIds: ExtensionIds;
+    /**
+     * Open the DB read-only for schema/session counts, or null if it can't be
+     * opened (absent / locked / corrupt). The caller owns closing it.
+     */
+    readonly openDb: () => Database | null;
+}
+/**
+ * Gather the status report from the injected probes. Never throws on a missing
+ * DB or unreadable manifest dir — those become `false`/`null`/`0` fields so
+ * `peek status` can render a clean partial picture (e.g. fresh install with no
+ * DB yet, native host not registered).
+ */
+export declare function gatherStatus(probes: StatusProbes): StatusReport;
+//# sourceMappingURL=status.d.ts.map

package/dist/lib/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/lib/status.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,aAAa,EAGnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,qDAAqD;AACrD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,yDAAyD;IACzD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,4FAA4F;AAC5F,MAAM,MAAM,wBAAwB,GAAG,WAAW,GAAG,cAAc,GAAG,SAAS,CAAC;AAEhF,wCAAwC;AACxC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,8EAA8E;IAC9E,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,oBAAoB,EAAE,CAAC;IACjD,+DAA+D;IAC/D,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,mBAAmB,EAAE,wBAAwB,CAAC;CACxD;AAED,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IACnD,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAC/C,+EAA+E;IAC/E,QAAQ,CAAC,eAAe,EAAE,SAAS,aAAa,EAAE,CAAC;IACnD,8DAA8D;IAC9D,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,QAAQ,GAAG,IAAI,CAAC;CACxC;AAMD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CA4C/D"}

package/dist/lib/status.js

@@ -0,0 +1,62 @@
+// `peek status` data-gathering (ADR-0007 action item 6 / P2 PRD §C.1): native
+// host manifest install state, SQLite DB path + size + schema version, and
+// extension connection state. The gathering is factored into a pure function
+// over injected probes (filesystem stat/exists, platform, home dir) so it can be
+// tested against a temp PEEK_HOME with a seeded DB without touching the real OS
+// or browser dirs. The command shell wires the real probes + prints.
+import { schemaVersion } from '@peekdev/mcp/db';
+import { buildManifest, hostBinaryPath, } from '@peekdev/mcp/native-host';
+function targetLocation(t) {
+    return t.manifestPath ?? t.registryKey ?? '(unknown target)';
+}
+/**
+ * Gather the status report from the injected probes. Never throws on a missing
+ * DB or unreadable manifest dir — those become `false`/`null`/`0` fields so
+ * `peek status` can render a clean partial picture (e.g. fresh install with no
+ * DB yet, native host not registered).
+ */
+export function gatherStatus(probes) {
+    const dbBytes = probes.fileSize(probes.dbPath);
+    const dbExists = dbBytes !== null;
+    let version = null;
+    let sessionCount = null;
+    if (dbExists) {
+        const db = probes.openDb();
+        if (db) {
+            try {
+                version = schemaVersion(db);
+                sessionCount = db.prepare('SELECT COUNT(*) AS c FROM sessions').get().c;
+            }
+            catch {
+                // Leave version/sessionCount null — a present-but-unreadable DB is still
+                // worth reporting (the path + size already are).
+            }
+            finally {
+                db.close();
+            }
+        }
+    }
+    const manifest = buildManifest(hostBinaryPath(), probes.extensionIds);
+    const manifestTargets = probes.manifestTargets.map((t) => {
+        const location = targetLocation(t);
+        // Only filesystem targets can be probed for existence here; registry
+        // targets (win32) report `installed:false` until the Windows path lands
+        // (Phase 3d) — consistent with the installer's deferred registry write.
+        const installed = t.manifestPath !== undefined ? probes.fileExists(t.manifestPath) : false;
+        return { browser: t.browser, location, installed };
+    });
+    return {
+        dbPath: probes.dbPath,
+        dbExists,
+        dbBytes: dbBytes ?? 0,
+        schemaVersion: version,
+        sessionCount,
+        hostBinaryPath: manifest.path,
+        manifestTargets,
+        anyManifestInstalled: manifestTargets.some((t) => t.installed),
+        // A real loopback/health check needs the extension's native port, which
+        // isn't wired until Phase 3d. Report "unknown" cleanly rather than fake it.
+        extensionConnection: 'unknown',
+    };
+}
+//# sourceMappingURL=status.js.map

package/dist/lib/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/lib/status.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,2EAA2E;AAC3E,6EAA6E;AAC7E,iFAAiF;AACjF,gFAAgF;AAChF,qEAAqE;AAErE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAGL,aAAa,EACb,cAAc,GACf,MAAM,0BAA0B,CAAC;AAmDlC,SAAS,cAAc,CAAC,CAAgB;IACtC,OAAO,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,WAAW,IAAI,kBAAkB,CAAC;AAC/D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,OAAO,KAAK,IAAI,CAAC;IAElC,IAAI,OAAO,GAAkB,IAAI,CAAC;IAClC,IAAI,YAAY,GAAkB,IAAI,CAAC;IACvC,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAC3B,IAAI,EAAE,EAAE,CAAC;YACP,IAAI,CAAC;gBACH,OAAO,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC;gBAC5B,YAAY,GAAI,EAAE,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC,GAAG,EAAoB,CAAC,CAAC,CAAC;YAC7F,CAAC;YAAC,MAAM,CAAC;gBACP,yEAAyE;gBACzE,iDAAiD;YACnD,CAAC;oBAAS,CAAC;gBACT,EAAE,CAAC,KAAK,EAAE,CAAC;YACb,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,aAAa,CAAC,cAAc,EAAE,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;IACtE,MAAM,eAAe,GAA2B,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC/E,MAAM,QAAQ,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;QACnC,qEAAqE;QACrE,wEAAwE;QACxE,wEAAwE;QACxE,MAAM,SAAS,GAAG,CAAC,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC3F,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ;QACR,OAAO,EAAE,OAAO,IAAI,CAAC;QACrB,aAAa,EAAE,OAAO;QACtB,YAAY;QACZ,cAAc,EAAE,QAAQ,CAAC,IAAI;QAC7B,eAAe;QACf,oBAAoB,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9D,wEAAwE;QACxE,4EAA4E;QAC5E,mBAAmB,EAAE,SAAS;KAC/B,CAAC;AACJ,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const CLI_VERSION = "0.1.0-alpha.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW,kBAAkB,CAAC"}

package/dist/version.js

@@ -0,0 +1,6 @@
+// CLI version string surfaced by `peek --version` / `peek --help`. Kept as a
+// literal (rather than importing package.json — NodeNext + verbatimModuleSyntax
+// makes a runtime JSON import awkward, and a stray resolveJsonModule asset in
+// dist is avoidable). The release Changeset bumps both this and package.json.
+export const CLI_VERSION = '0.1.0-alpha.0';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,gFAAgF;AAChF,8EAA8E;AAC9E,8EAA8E;AAC9E,MAAM,CAAC,MAAM,WAAW,GAAG,eAAe,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@peekdev/cli",
+  "version": "0.1.0-alpha.1",
+  "description": "peek command-line tool. A thin read-mostly client of the native host's ~/.peek/sessions.db (ADR-0007): status, sessions list/show/export/delete, the `peek init` MCP-client wizard, and `peek audit log`.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "bin": {
+    "peek": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "NOTICE", "README.md"],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node ./scripts/postbuild.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --passWithNoTests"
+  },
+  "dependencies": {
+    "@peekdev/mcp": "workspace:*",
+    "better-sqlite3": "^12.10.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^22.10.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Cubenest/rrweb-stack.git",
+    "directory": "packages/peek-cli"
+  },
+  "homepage": "https://github.com/Cubenest/rrweb-stack/tree/main/packages/peek-cli#readme"
+}