@planckspace/cli 0.0.2 → 0.1.1

package/dist/scrapers/windsurf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"windsurf.d.ts","sourceRoot":"","sources":["../../src/scrapers/windsurf.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAQ,aAAa,EAAE,MAAM,YAAY,CAAC;AAwDtD,mFAAmF;AACnF,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAa1C;AAsJD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,MAAM,EAAsB,GAAG,aAAa,EAAE,CAkEvF"}

package/dist/scrapers/windsurf.js

@@ -0,0 +1,255 @@
+import fs from "fs";
+import path from "path";
+import os from "os";
+import Database from "better-sqlite3";
+import { computeCostUsd } from "@planckspace/core";
+import { resolveRepo } from "./repo.js";
+// ── Status: BETA / UNVERIFIED (see docs/COVERAGE.md) ────────────────────────────
+//
+// Windsurf (by Codeium) is a VS Code fork, so it uses the same per-user storage
+// layout as VS Code / Cursor:  <appSupport>/Windsurf/User/globalStorage/state.vscdb
+// (an `ItemTable` key-value store), with its "Cascade" agent history kept there.
+//
+// IMPORTANT HONESTY NOTE: no Windsurf installation was available when this scraper
+// was written, so its exact Cascade key names and message schema could NOT be
+// verified against real data the way Cursor's were. This scraper therefore:
+//   • locates Windsurf's state DB across macOS / Linux / Windows (incl. "- Next"),
+//   • reads ONLY values under keys that plausibly hold Cascade conversations,
+//   • extracts only structurally-unambiguous fields (timestamps, message counts,
+//     and token/model fields *if present*),
+//   • and, crucially, does NOT fabricate sessions: if it finds the DB but cannot
+//     recognise a conversation schema, it warns once and returns nothing.
+//
+// On a machine with Windsurf this will either light up or print a clear "schema
+// not recognised" diagnostic to drive the next iteration. We never invent tokens,
+// costs, or models that the data does not contain.
+// Keys under which a Windsurf/Cascade conversation might be stored. Kept narrow on
+// purpose: matching loose patterns against every workbench value would manufacture
+// junk sessions, which is worse than honestly reporting nothing.
+const CASCADE_KEY_PATTERNS = [/cascade/i, /windsurf.*(chat|conversation|session)/i, /codeium.*(chat|conversation)/i];
+// ── DB locations ─────────────────────────────────────────────────────────────────
+/** Candidate Windsurf global-state DB paths for the current OS (stable + Next). */
+export function windsurfDbPaths() {
+    const home = os.homedir();
+    const flavors = ["Windsurf", "Windsurf - Next"];
+    const bases = [];
+    if (process.platform === "darwin") {
+        for (const f of flavors)
+            bases.push(path.join(home, "Library", "Application Support", f));
+    }
+    else if (process.platform === "win32") {
+        const appData = process.env.APPDATA ?? path.join(home, "AppData", "Roaming");
+        for (const f of flavors)
+            bases.push(path.join(appData, f));
+    }
+    else {
+        for (const f of flavors)
+            bases.push(path.join(home, ".config", f));
+    }
+    return bases.map((b) => path.join(b, "User", "globalStorage", "state.vscdb"));
+}
+// ── Helpers ──────────────────────────────────────────────────────────────────────
+function parseJson(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function toIso(v) {
+    if (v == null)
+        return null;
+    if (typeof v === "number") {
+        const d = new Date(v);
+        return Number.isNaN(d.getTime()) ? null : d.toISOString();
+    }
+    const d = new Date(v);
+    return Number.isNaN(d.getTime()) ? null : d.toISOString();
+}
+function messageTimestamp(m) {
+    return toIso(m.createdAt) ?? toIso(m.timestamp) ?? toIso(m.time);
+}
+function isUserMessage(m) {
+    const role = (m.role ?? m.sender ?? "").toString().toLowerCase();
+    if (role === "user" || role === "human")
+        return true;
+    if (m.type === 1 || m.type === "user")
+        return true;
+    return false;
+}
+function messageTokens(m) {
+    const tc = m.tokenCount;
+    const u = m.usage;
+    return {
+        input: tc?.inputTokens ?? u?.inputTokens ?? u?.input_tokens ?? 0,
+        output: tc?.outputTokens ?? u?.outputTokens ?? u?.output_tokens ?? 0,
+    };
+}
+/** Recognise a value as a Cascade conversation and pull its message list out. */
+function asConversation(value) {
+    if (!value || typeof value !== "object")
+        return null;
+    const obj = value;
+    const messages = obj.messages ?? obj.turns ?? obj.bubbles;
+    if (!Array.isArray(messages) || messages.length === 0)
+        return null;
+    // Require at least one message to carry a recognisable timestamp; otherwise we
+    // cannot honestly place this session in time, so we decline rather than guess.
+    if (!messages.some((m) => messageTimestamp(m) !== null))
+        return null;
+    return { ...obj, messages };
+}
+function buildSession(conv, fallbackId) {
+    const messages = conv.messages ?? [];
+    const timestamps = messages
+        .map(messageTimestamp)
+        .filter((t) => t !== null)
+        .sort();
+    if (timestamps.length === 0)
+        return null;
+    let totalInput = 0;
+    let totalOutput = 0;
+    let totalCost = 0;
+    const turns = [];
+    let current = null;
+    let sessionModel = "unknown";
+    const close = () => {
+        if (current)
+            turns.push(current);
+        current = null;
+    };
+    for (const m of messages) {
+        const ts = messageTimestamp(m) ?? "";
+        const model = m.model ?? m.modelName ?? sessionModel;
+        if (model && model !== "unknown" && sessionModel === "unknown")
+            sessionModel = model;
+        if (isUserMessage(m)) {
+            close();
+            current = {
+                sequence: turns.length + 1,
+                model,
+                inputTokens: 0,
+                outputTokens: 0,
+                cacheReadTokens: 0,
+                cacheWriteTokens: 0,
+                costUsd: 0,
+                toolCalls: [],
+                filesTouched: [],
+                timestamp: ts,
+            };
+            continue;
+        }
+        if (!current) {
+            current = {
+                sequence: turns.length + 1,
+                model,
+                inputTokens: 0,
+                outputTokens: 0,
+                cacheReadTokens: 0,
+                cacheWriteTokens: 0,
+                costUsd: 0,
+                toolCalls: [],
+                filesTouched: [],
+                timestamp: ts,
+            };
+        }
+        const { input, output } = messageTokens(m);
+        current.inputTokens += input;
+        current.outputTokens += output;
+        current.costUsd += computeCostUsd({ inputTokens: input, outputTokens: output, cacheReadTokens: 0, cacheWriteTokens: 0 }, model);
+        if (model && model !== "unknown")
+            current.model = model;
+        totalInput += input;
+        totalOutput += output;
+    }
+    close();
+    totalCost = turns.reduce((s, t) => s + t.costUsd, 0);
+    const workingDir = conv.workspacePath ?? conv.workspace ?? conv.cwd ?? "";
+    const { repoName, gitBranch } = resolveRepo(workingDir);
+    const id = conv.id ?? conv.conversationId ?? conv.sessionId ?? fallbackId;
+    return {
+        sessionId: `windsurf:${id}`,
+        tool: "windsurf",
+        model: sessionModel,
+        startedAt: timestamps[0],
+        endedAt: timestamps[timestamps.length - 1],
+        inputTokens: totalInput,
+        outputTokens: totalOutput,
+        cacheReadTokens: 0,
+        cacheWriteTokens: 0,
+        costUsd: totalCost,
+        turns,
+        workingDir,
+        turnCount: turns.length,
+        filesTouchedCount: 0, // not reliably derivable without a verified schema
+        repoName,
+        gitBranch,
+    };
+}
+// ── Main entrypoint ─────────────────────────────────────────────────────────────
+/**
+ * Scan Windsurf's global state DB(s) for Cascade conversations.
+ * @param dbPaths override the DB locations (used by tests). Defaults to OS paths.
+ */
+export function scanWindsurfLogs(dbPaths = windsurfDbPaths()) {
+    const existing = dbPaths.filter((p) => fs.existsSync(p));
+    if (existing.length === 0)
+        return []; // Windsurf not installed — expected, silent.
+    const sessions = [];
+    for (const dbPath of existing) {
+        let db;
+        try {
+            db = new Database(dbPath, { readonly: true, fileMustExist: true });
+        }
+        catch (err) {
+            console.warn(`[windsurf] Cannot open ${dbPath}: ${String(err)} — skipping`);
+            continue;
+        }
+        try {
+            const tables = db.prepare("SELECT name FROM sqlite_master WHERE type='table'").all().map((t) => t.name);
+            let matchedKeys = 0;
+            let recognised = 0;
+            for (const table of tables) {
+                // Every VS Code KV table we know of is (key TEXT, value BLOB/TEXT).
+                const cols = db.prepare(`PRAGMA table_info("${table}")`).all().map((c) => c.name);
+                if (!cols.includes("key") || !cols.includes("value"))
+                    continue;
+                const rows = db.prepare(`SELECT key, value FROM "${table}"`).all();
+                for (const row of rows) {
+                    if (!CASCADE_KEY_PATTERNS.some((re) => re.test(row.key)))
+                        continue;
+                    matchedKeys++;
+                    const parsed = parseJson(row.value.toString());
+                    if (!parsed)
+                        continue;
+                    // A value may be a single conversation or an array of them.
+                    const candidates = Array.isArray(parsed) ? parsed : [parsed];
+                    for (let i = 0; i < candidates.length; i++) {
+                        const conv = asConversation(candidates[i]);
+                        if (!conv)
+                            continue;
+                        const session = buildSession(conv, `${row.key}:${i}`);
+                        if (session) {
+                            sessions.push(session);
+                            recognised++;
+                        }
+                    }
+                }
+            }
+            if (matchedKeys > 0 && recognised === 0) {
+                console.warn(`[windsurf] Found ${matchedKeys} Cascade-like key(s) in ${dbPath} but none matched a ` +
+                    `recognised conversation schema. Windsurf support is beta/unverified — please open an ` +
+                    `issue so we can map its format. No sessions were fabricated.`);
+            }
+        }
+        catch (err) {
+            console.warn(`[windsurf] Failed to read ${dbPath}: ${String(err)}`);
+        }
+        finally {
+            db.close();
+        }
+    }
+    return sessions;
+}
+//# sourceMappingURL=windsurf.js.map

package/dist/scrapers/windsurf.js.map

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

package/dist/sync/payload.d.ts

@@ -0,0 +1,14 @@
+import type { TelemetryPayload } from "@planckspace/core";
+import type { SessionRow } from "../db/store.js";
+/** The shape returned by getUnsyncedSessions() — SessionRow with turnsJson stripped. */
+export type UnsyncedSession = Omit<SessionRow, "turnsJson">;
+/**
+ * Build the wire payload for a single session — METADATA ONLY.
+ *
+ * PRIVACY INVARIANT: this function maps each TelemetryPayload field EXPLICITLY.
+ * It never spreads the row and never references turnsJson, prompt text, response
+ * text, or file contents. Anything not listed below is, by construction, not sent.
+ * The privacy guard test (payload.privacy.test.ts) enforces this and must always pass.
+ */
+export declare function buildTelemetryPayload(row: UnsyncedSession, workspaceId: string): TelemetryPayload;
+//# sourceMappingURL=payload.d.ts.map

package/dist/sync/payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../src/sync/payload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,wFAAwF;AACxF,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AAE5D;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,eAAe,EACpB,WAAW,EAAE,MAAM,GAClB,gBAAgB,CA0BlB"}

package/dist/sync/payload.js

@@ -0,0 +1,36 @@
+/**
+ * Build the wire payload for a single session — METADATA ONLY.
+ *
+ * PRIVACY INVARIANT: this function maps each TelemetryPayload field EXPLICITLY.
+ * It never spreads the row and never references turnsJson, prompt text, response
+ * text, or file contents. Anything not listed below is, by construction, not sent.
+ * The privacy guard test (payload.privacy.test.ts) enforces this and must always pass.
+ */
+export function buildTelemetryPayload(row, workspaceId) {
+    return {
+        sessionId: row.id,
+        // The DB only ever holds scraper-sourced Claude Code sessions today; the cast
+        // narrows the stored string to the core enum without widening the wire contract.
+        tool: row.tool,
+        model: row.model,
+        startedAt: row.startedAt,
+        endedAt: row.endedAt,
+        inputTokens: row.inputTokens,
+        outputTokens: row.outputTokens,
+        cacheReadTokens: row.cacheReadTokens,
+        cacheWriteTokens: row.cacheWriteTokens,
+        costUsd: row.costUsd,
+        // Backend schema requires a non-empty repoName.
+        repoName: row.repoName ?? "unknown",
+        gitBranch: row.gitBranch,
+        // Recorded by git correlation (the repo's `user.email`), not from prompt
+        // content. May differ from the login email — the cloud maps it to a member.
+        gitAuthorEmail: row.gitAuthorEmail,
+        outcome: row.outcome,
+        turnCount: row.turnCount,
+        filesTouchedCount: row.filesTouchedCount,
+        source: "scraper",
+        workspaceId,
+    };
+}
+//# sourceMappingURL=payload.js.map

package/dist/sync/payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../src/sync/payload.ts"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,GAAoB,EACpB,WAAmB;IAEnB,OAAO;QACL,SAAS,EAAE,GAAG,CAAC,EAAE;QACjB,8EAA8E;QAC9E,iFAAiF;QACjF,IAAI,EAAE,GAAG,CAAC,IAAgC;QAC1C,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,eAAe,EAAE,GAAG,CAAC,eAAe;QACpC,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;QACtC,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,gDAAgD;QAChD,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,SAAS;QACnC,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,yEAAyE;QACzE,4EAA4E;QAC5E,cAAc,EAAE,GAAG,CAAC,cAAc;QAClC,OAAO,EAAE,GAAG,CAAC,OAAsC;QACnD,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,iBAAiB,EAAE,GAAG,CAAC,iBAAiB;QACxC,MAAM,EAAE,SAAS;QACjB,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/sync/syncEngine.d.ts

@@ -0,0 +1,16 @@
+export type SyncDeps = {
+    apiUrl: string;
+    token: string;
+    workspaceId: string;
+};
+export type SyncResult = {
+    synced: number;
+    failed: number;
+};
+/**
+ * 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 declare function syncOnce(deps: SyncDeps): Promise<SyncResult>;
+//# sourceMappingURL=syncEngine.d.ts.map

package/dist/sync/syncEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncEngine.d.ts","sourceRoot":"","sources":["../../src/sync/syncEngine.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,QAAQ,GAAG;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAkD5D;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CA+BlE"}

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":"AAAA,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,UAAU,GAAG,GAAG,CAAC;AACvB,MAAM,WAAW,GAAG,CAAC,CAAC;AAUtB,SAAS,KAAK,CAAI,GAAQ,EAAE,IAAY;IACtC,MAAM,GAAG,GAAU,EAAE,CAAC;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,IAAI;QAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAC5E,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AASD,sFAAsF;AACtF,SAAS,WAAW,CAAC,OAAoB;IACvC,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC9C,OAAO,OAAO,CAAC,MAAM,IAAI,GAAG,IAAI,OAAO,CAAC,MAAM,KAAK,GAAG,CAAC;AACzD,CAAC;AAED,KAAK,UAAU,SAAS,CACtB,IAAc,EACd,QAAmB;IAEnB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,aAAa,EAAE;YACnD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,IAAI,CAAC,KAAK,EAAE;aACtC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;SAC/B,CAAC,CAAC;QACH,IAAI,GAAG,CAAC,EAAE;YAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9C,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,KAAK,EAAE,QAAQ,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;SACpE,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,kBAAkB,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;IAC/D,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAc;IAC3C,MAAM,IAAI,GAAG,mBAAmB,EAAE,CAAC;IACnC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IAEvD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC;QAC5C,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACnC,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC/B,qBAAqB,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,CAC3C,CAAC;QAEF,IAAI,OAAO,GAAgB,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QACzC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;YACxD,OAAO,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC1C,IAAI,OAAO,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,OAAO,KAAK,WAAW;gBAAE,MAAM;YAC1E,sCAAsC;YACtC,MAAM,KAAK,CAAC,GAAG,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC;QAClC,CAAC;QAED,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;YACf,kBAAkB,CAAC,GAAG,CAAC,CAAC;YACxB,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,IAAI,eAAe,CAAC,CAAC;YACvD,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC"}

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,10 +1,42 @@
 {
   "name": "@planckspace/cli",
-  "version": "0.0.2",
-  "description": "Planck CLI — write AI rules once, compile to every tool",
-  "main": "index.js",
-  "bin": { "planck": "./index.js" },
-  "keywords": ["ai", "context", "claude", "cursor", "developer-tools"],
-  "license": "MIT",
-  "engines": { "node": ">=20" }
+  "version": "0.1.1",
+  "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