@planckspace/cli 0.0.1 → 0.1.0

package/dist/sync/syncEngine.js

@@ -0,0 +1,76 @@
+import { getUnsyncedSessions, markSessionsSynced, recordSyncError, } from "../db/store.js";
+import { buildTelemetryPayload } from "./payload.js";
+const BATCH_SIZE = 100;
+const MAX_RETRIES = 3;
+function chunk(arr, size) {
+    const out = [];
+    for (let i = 0; i < arr.length; i += size)
+        out.push(arr.slice(i, i + size));
+    return out;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/** A failure worth retrying: no response (network) or a 5xx / 429 from the server. */
+function isTransient(outcome) {
+    if (outcome.status === undefined)
+        return true;
+    return outcome.status >= 500 || outcome.status === 429;
+}
+async function postBatch(deps, payloads) {
+    try {
+        const res = await fetch(`${deps.apiUrl}/api/ingest`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${deps.token}`,
+            },
+            body: JSON.stringify(payloads),
+        });
+        if (res.ok)
+            return { ok: true, status: res.status };
+        const text = await res.text().catch(() => "");
+        return {
+            ok: false,
+            status: res.status,
+            error: `HTTP ${res.status}${text ? `: ${text.slice(0, 200)}` : ""}`,
+        };
+    }
+    catch (err) {
+        return { ok: false, error: `network error: ${String(err)}` };
+    }
+}
+/**
+ * Push all unsynced sessions to {apiUrl}/api/ingest in batches of up to 100.
+ * Successful batches are marked synced; failed batches record lastError and stay
+ * unsynced for the next run. Transient failures retry with exponential backoff.
+ */
+export async function syncOnce(deps) {
+    const rows = getUnsyncedSessions();
+    if (rows.length === 0)
+        return { synced: 0, failed: 0 };
+    let synced = 0;
+    let failed = 0;
+    for (const batch of chunk(rows, BATCH_SIZE)) {
+        const ids = batch.map((r) => r.id);
+        const payloads = batch.map((r) => buildTelemetryPayload(r, deps.workspaceId));
+        let outcome = { ok: false };
+        for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+            outcome = await postBatch(deps, payloads);
+            if (outcome.ok || !isTransient(outcome) || attempt === MAX_RETRIES)
+                break;
+            // Exponential backoff: 500ms, 1s, 2s.
+            await sleep(500 * 2 ** attempt);
+        }
+        if (outcome.ok) {
+            markSessionsSynced(ids);
+            synced += ids.length;
+        }
+        else {
+            recordSyncError(ids, outcome.error ?? "unknown error");
+            failed += ids.length;
+        }
+    }
+    return { synced, failed };
+}
+//# sourceMappingURL=syncEngine.js.map

package/dist/sync/syncEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncEngine.js","sourceRoot":"","sources":["../../src/sync/syncEngine.ts"],"names":[],"mappings":"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"}

package/install.sh

@@ -0,0 +1,126 @@
+#!/usr/bin/env bash
+# PlanckSpace installer — https://planckspace.dev/install
+#
+# Usage:
+#   curl -fsSL https://planckspace.dev/install | sh
+#   curl -fsSL https://planckspace.dev/install | sh -s -- --token pk_live_xxx
+set -euo pipefail
+
+DASHBOARD_URL="https://app.planckspace.dev"
+VSCODE_EXT_URL="https://marketplace.visualstudio.com/items?itemName=planckspace.planckspace"
+PKG="@planckspace/cli"
+
+# ── helpers ──────────────────────────────────────────────────────────────────
+say()  { printf '\n%s\n' "$*"; }
+info() { printf '  %s\n' "$*"; }
+die()  { printf '\nERROR: %s\n\n' "$*" >&2; exit 1; }
+
+# ── parse args ───────────────────────────────────────────────────────────────
+TOKEN=""
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --token)   TOKEN="${2:-}"; shift 2 ;;
+    --token=*) TOKEN="${1#--token=}"; shift ;;
+    *)         shift ;;
+  esac
+done
+
+# ── OS / arch check ──────────────────────────────────────────────────────────
+OS="$(uname -s 2>/dev/null || echo unknown)"
+ARCH="$(uname -m 2>/dev/null || echo unknown)"
+
+case "$OS" in
+  Darwin|Linux) ;;
+  MINGW*|MSYS*|CYGWIN*|Windows_NT)
+    say "Windows detected."
+    say "PlanckSpace requires WSL (Windows Subsystem for Linux)."
+    info "1. Open PowerShell as Administrator and run:  wsl --install"
+    info "2. After WSL is set up, open a WSL terminal and run:"
+    info "   curl -fsSL https://planckspace.dev/install | sh"
+    exit 1
+    ;;
+  *)
+    die "Unsupported OS: $OS. Install manually with: npm install -g $PKG"
+    ;;
+esac
+
+say "PlanckSpace installer  (OS: $OS / arch: $ARCH)"
+
+# ── Node.js check ────────────────────────────────────────────────────────────
+node_ok() {
+  command -v node >/dev/null 2>&1 || return 1
+  local v
+  v="$(node --version 2>/dev/null | sed 's/v//' | cut -d. -f1)"
+  [[ "${v:-0}" -ge 20 ]]
+}
+
+if ! node_ok; then
+  say "Node.js 20+ is required but was not found."
+  say "Install it with nvm (recommended — no sudo needed):"
+  info "curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash"
+  info "source \"\${HOME}/.nvm/nvm.sh\""
+  info "nvm install 20"
+  say "Or download from: https://nodejs.org/en/download"
+  say "Then re-run this installer."
+  exit 1
+fi
+
+NODE_VER="$(node --version)"
+info "Node $NODE_VER found."
+
+# ── npm check ────────────────────────────────────────────────────────────────
+command -v npm >/dev/null 2>&1 || die "npm not found. Re-install Node.js from https://nodejs.org"
+
+# ── install CLI ──────────────────────────────────────────────────────────────
+say "Installing $PKG..."
+npm install -g "$PKG" --loglevel error
+
+# verify the binary is reachable
+command -v planck >/dev/null 2>&1 || {
+  # npm global bin might not be in PATH — try to fix
+  NPM_BIN="$(npm bin -g 2>/dev/null || true)"
+  if [[ -n "$NPM_BIN" && -x "$NPM_BIN/planck" ]]; then
+    export PATH="$NPM_BIN:$PATH"
+  else
+    die "'planck' binary not found after install. Add \`$(npm prefix -g)/bin\` to your PATH."
+  fi
+}
+
+# ── init ─────────────────────────────────────────────────────────────────────
+say "Initializing ~/.planckspace..."
+planck init
+
+# ── login ────────────────────────────────────────────────────────────────────
+CONNECTED=false
+if [[ -n "$TOKEN" ]]; then
+  say "Connecting to your workspace..."
+  planck login --token "$TOKEN" && CONNECTED=true || true
+else
+  say "No token provided."
+  info "Visit $DASHBOARD_URL to get your invite token, then run:"
+  info "  planck login <your-token>"
+fi
+
+# ── scan (backfill existing history) ─────────────────────────────────────────
+say "Scanning local AI session history (this is fast)..."
+planck scan
+
+# ── sync (only when connected) ───────────────────────────────────────────────
+if [[ "$CONNECTED" == "true" ]]; then
+  say "Syncing data to your workspace..."
+  planck sync
+fi
+
+# ── done ─────────────────────────────────────────────────────────────────────
+say "--------------------------------------"
+say "PlanckSpace is ready."
+say "--------------------------------------"
+if [[ "$CONNECTED" == "true" ]]; then
+  info "Dashboard:       $DASHBOARD_URL"
+else
+  info "Next step:       planck login <token>"
+  info "Dashboard:       $DASHBOARD_URL"
+fi
+info "VS Code extension: $VSCODE_EXT_URL"
+info "Check setup:     planck status"
+say ""

package/package.json

@@ -1,7 +1,42 @@
 {
   "name": "@planckspace/cli",
-  "version": "0.0.1",
-  "description": "Planck - AI Context Management",
-  "main": "index.js",
-  "license": "MIT"
+  "version": "0.1.0",
+  "description": "PlanckSpace CLI — sync AI token usage from your editor to the team ledger",
+  "type": "module",
+  "bin": {
+    "planck": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "clean": "rm -rf dist",
+    "scan:test": "tsx src/scripts/scanTest.ts",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build",
+    "release": "npm publish"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist",
+    "install.sh"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@planckspace/core": "^0.1.0",
+    "better-sqlite3": "^12.10.0",
+    "commander": "^15.0.0",
+    "dotenv": "^17.4.2",
+    "simple-git": "^3.36.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^25.9.1",
+    "tsx": "^4.22.4",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.7"
+  }
 }

package/index.js

@@ -1 +0,0 @@
-// placeholder