codiedev 0.7.7 → 0.7.8

package/dist/__tests__/versionCheck.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/versionCheck.test.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const versionCheck_1 = require("../versionCheck");
+(0, vitest_1.describe)("parseSemver", () => {
+    (0, vitest_1.it)("parses a normal version", () => {
+        (0, vitest_1.expect)((0, versionCheck_1.parseSemver)("0.7.7")).toEqual({ major: 0, minor: 7, patch: 7 });
+    });
+    (0, vitest_1.it)("strips a leading v", () => {
+        (0, vitest_1.expect)((0, versionCheck_1.parseSemver)("v1.2.3")).toEqual({ major: 1, minor: 2, patch: 3 });
+    });
+    (0, vitest_1.it)("ignores prerelease/build suffixes", () => {
+        (0, vitest_1.expect)((0, versionCheck_1.parseSemver)("1.2.3-beta.1+build.99")).toEqual({
+            major: 1,
+            minor: 2,
+            patch: 3,
+        });
+    });
+    (0, vitest_1.it)("returns null for malformed input", () => {
+        (0, vitest_1.expect)((0, versionCheck_1.parseSemver)("")).toBe(null);
+        (0, vitest_1.expect)((0, versionCheck_1.parseSemver)("not.a.version")).toBe(null);
+        (0, vitest_1.expect)((0, versionCheck_1.parseSemver)("1.2")).toBe(null);
+    });
+});
+(0, vitest_1.describe)("compareSemver", () => {
+    (0, vitest_1.it)("returns -1 when current is older (patch)", () => {
+        (0, vitest_1.expect)((0, versionCheck_1.compareSemver)("0.7.6", "0.7.7")).toBe(-1);
+    });
+    (0, vitest_1.it)("returns -1 when current is older (minor)", () => {
+        (0, vitest_1.expect)((0, versionCheck_1.compareSemver)("0.6.99", "0.7.0")).toBe(-1);
+    });
+    (0, vitest_1.it)("returns -1 when current is older (major)", () => {
+        (0, vitest_1.expect)((0, versionCheck_1.compareSemver)("0.99.99", "1.0.0")).toBe(-1);
+    });
+    (0, vitest_1.it)("returns 0 when equal", () => {
+        (0, vitest_1.expect)((0, versionCheck_1.compareSemver)("0.7.7", "0.7.7")).toBe(0);
+    });
+    (0, vitest_1.it)("returns 1 when current is ahead of latest (e.g. local dev build)", () => {
+        (0, vitest_1.expect)((0, versionCheck_1.compareSemver)("0.8.0", "0.7.7")).toBe(1);
+    });
+    (0, vitest_1.it)("treats malformed inputs as equal — never warn on garbage", () => {
+        (0, vitest_1.expect)((0, versionCheck_1.compareSemver)("garbage", "0.7.7")).toBe(0);
+        (0, vitest_1.expect)((0, versionCheck_1.compareSemver)("0.7.7", "garbage")).toBe(0);
+    });
+});
+(0, vitest_1.describe)("shouldShowUpdateWarning", () => {
+    const now = 1_777_777_777_000;
+    const dayMs = 24 * 60 * 60 * 1000;
+    (0, vitest_1.it)("warns when current is older AND cache is fresh", () => {
+        (0, vitest_1.expect)((0, versionCheck_1.shouldShowUpdateWarning)({
+            current: "0.7.6",
+            latest: "0.7.7",
+            lastChecked: now - 1000,
+            nowMs: now,
+            cacheTtlMs: dayMs,
+        })).toBe(true);
+    });
+    (0, vitest_1.it)("does not warn when current matches latest", () => {
+        (0, vitest_1.expect)((0, versionCheck_1.shouldShowUpdateWarning)({
+            current: "0.7.7",
+            latest: "0.7.7",
+            lastChecked: now,
+            nowMs: now,
+            cacheTtlMs: dayMs,
+        })).toBe(false);
+    });
+    (0, vitest_1.it)("does not warn when latest is unknown (no fetch yet)", () => {
+        (0, vitest_1.expect)((0, versionCheck_1.shouldShowUpdateWarning)({
+            current: "0.7.6",
+            latest: null,
+            lastChecked: 0,
+            nowMs: now,
+            cacheTtlMs: dayMs,
+        })).toBe(false);
+    });
+    (0, vitest_1.it)("does not warn when current is ahead of latest (dev build)", () => {
+        (0, vitest_1.expect)((0, versionCheck_1.shouldShowUpdateWarning)({
+            current: "0.8.0",
+            latest: "0.7.7",
+            lastChecked: now,
+            nowMs: now,
+            cacheTtlMs: dayMs,
+        })).toBe(false);
+    });
+});

package/dist/commands/doctor.js

@@ -40,6 +40,8 @@ const os = __importStar(require("os"));
 const child_process_1 = require("child_process");
 const shared_1 = require("./shared");
 const utils_1 = require("../utils");
+const version_1 = require("../version");
+const upgradeNudge_1 = require("../upgradeNudge");
 const CLAUDE_SETTINGS_PATH = path.join(os.homedir(), ".claude", "settings.json");
 const CLAUDE_INSTRUCTIONS_PATH = path.join(os.homedir(), ".claude", "CLAUDE.md");
 const CODEX_HOOKS_PATH = path.join(os.homedir(), ".codex", "hooks.json");
@@ -151,6 +153,7 @@ function hasGlabCli() {
 async function runDoctor(_args) {
     const checks = [];
     console.log("\nCodieDev doctor — checking your setup…\n");
+    await (0, upgradeNudge_1.maybePrintUpgradeNudge)();
     // 1. Config file
     const config = (0, utils_1.readConfig)();
     if (!config) {
@@ -171,7 +174,10 @@ async function runDoctor(_args) {
     try {
         const res = await fetch(`${config.backendUrl}/api/cli/validateToken`, {
             method: "POST",
-            headers: { "Content-Type": "application/json" },
+            headers: {
+                "Content-Type": "application/json",
+                "X-Codiedev-Cli-Version": version_1.CLI_VERSION,
+            },
             body: JSON.stringify({ token: config.token }),
         });
         if (res.ok) {

package/dist/commands/shared.js

@@ -40,6 +40,7 @@ exports.stripQuotes = stripQuotes;
 const https = __importStar(require("https"));
 const http = __importStar(require("http"));
 const utils_1 = require("../utils");
+const version_1 = require("../version");
 /**
  * Require a connected CodieDev config. Exits the process with a helpful
  * message if the user hasn't run `codiedev connect` yet.
@@ -75,6 +76,7 @@ function apiRequest(method, path, options) {
             method,
             headers: {
                 Authorization: `Bearer ${options.config.token}`,
+                "X-Codiedev-Cli-Version": version_1.CLI_VERSION,
                 ...(data
                     ? {
                         "Content-Type": "application/json",

package/dist/connect.js

@@ -39,6 +39,8 @@ const https = __importStar(require("https"));
 const http = __importStar(require("http"));
 const utils_1 = require("./utils");
 const connectFlow_1 = require("./connectFlow");
+const version_1 = require("./version");
+const upgradeNudge_1 = require("./upgradeNudge");
 const BACKEND_URL = process.env.CODIEDEV_URL || "https://judicious-falcon-861.convex.site";
 function prompt(rl, question) {
     return new Promise((resolve) => {
@@ -59,6 +61,7 @@ function postJson(url, body) {
             headers: {
                 "Content-Type": "application/json",
                 "Content-Length": Buffer.byteLength(data),
+                "X-Codiedev-Cli-Version": version_1.CLI_VERSION,
             },
         };
         const lib = parsed.protocol === "https:" ? https : http;
@@ -95,6 +98,7 @@ async function runConnect(args = []) {
     // engineer when he interpreted "no visible token" as "the old one is gone".
     const force = args.includes("--force") || args.includes("-f");
     console.log("\nWelcome to CodieDev CLI\n");
+    await (0, upgradeNudge_1.maybePrintUpgradeNudge)();
     console.log("This will connect your coding agent to your CodieDev workspace and install");
     console.log("the session capture hook for org-wide session sharing.\n");
     const saved = (0, utils_1.readConfig)();

package/dist/hook.js

@@ -38,6 +38,7 @@ const fs = __importStar(require("fs"));
 const https = __importStar(require("https"));
 const http = __importStar(require("http"));
 const utils_1 = require("./utils");
+const version_1 = require("./version");
 function postJson(url, body, bearerToken) {
     return new Promise((resolve, reject) => {
         const parsed = new URL(url);
@@ -51,6 +52,7 @@ function postJson(url, body, bearerToken) {
                 "Content-Type": "application/json",
                 "Content-Length": Buffer.byteLength(data),
                 Authorization: `Bearer ${bearerToken}`,
+                "X-Codiedev-Cli-Version": version_1.CLI_VERSION,
             },
         };
         const lib = parsed.protocol === "https:" ? https : http;

package/dist/upgradeNudge.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Fail-silent — never throws, never blocks on network. If the registry is
+ * unreachable or the cache is corrupt, the warning just doesn't print. The
+ * worst outcome is "user keeps running an old version" — same as before
+ * this feature existed.
+ */
+export declare function maybePrintUpgradeNudge(): Promise<void>;

package/dist/upgradeNudge.js

@@ -0,0 +1,123 @@
+"use strict";
+// Client-side "you're outdated" warning. Prints at the top of connect/doctor
+// when there's a newer `codiedev` published on npm. Pure helpers tested in
+// __tests__/versionCheck.test.ts; this module does the IO (registry fetch +
+// disk cache) and is exercised by manual smoke.
+//
+// Cache lives at ~/.codiedev/.update-cache.json. 24h TTL — long enough that
+// the registry isn't hit on every command, short enough that newly-published
+// versions surface the day after release.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.maybePrintUpgradeNudge = maybePrintUpgradeNudge;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const version_1 = require("./version");
+const versionCheck_1 = require("./versionCheck");
+const CACHE_PATH = path.join(os.homedir(), ".codiedev", ".update-cache.json");
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+const REGISTRY_URL = "https://registry.npmjs.org/codiedev/latest";
+const FETCH_TIMEOUT_MS = 1500;
+function readCache() {
+    try {
+        const raw = fs.readFileSync(CACHE_PATH, "utf8");
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.fetchedAt !== "number")
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+function writeCache(entry) {
+    try {
+        const dir = path.dirname(CACHE_PATH);
+        if (!fs.existsSync(dir))
+            fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(CACHE_PATH, JSON.stringify(entry), "utf8");
+    }
+    catch {
+        // ignore — cache is best-effort
+    }
+}
+async function fetchLatestFromNpm() {
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+        const res = await fetch(REGISTRY_URL, {
+            headers: { Accept: "application/json" },
+            signal: controller.signal,
+        });
+        clearTimeout(timer);
+        if (!res.ok)
+            return null;
+        const json = (await res.json());
+        return json.version ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Fail-silent — never throws, never blocks on network. If the registry is
+ * unreachable or the cache is corrupt, the warning just doesn't print. The
+ * worst outcome is "user keeps running an old version" — same as before
+ * this feature existed.
+ */
+async function maybePrintUpgradeNudge() {
+    const now = Date.now();
+    const cache = readCache();
+    let latest = cache?.latest ?? null;
+    const cacheStale = !cache || now - cache.fetchedAt > CACHE_TTL_MS;
+    if (cacheStale) {
+        latest = await fetchLatestFromNpm();
+        writeCache({ latest, fetchedAt: now });
+    }
+    const warn = (0, versionCheck_1.shouldShowUpdateWarning)({
+        current: version_1.CLI_VERSION,
+        latest,
+        lastChecked: cache?.fetchedAt ?? 0,
+        nowMs: now,
+        cacheTtlMs: CACHE_TTL_MS,
+    });
+    if (warn && latest) {
+        console.log("");
+        console.log(`⚠️  codiedev ${latest} available (you're on ${version_1.CLI_VERSION})`);
+        console.log(`   Upgrade: npm i -g codiedev@latest`);
+        console.log("");
+    }
+}

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const CLI_VERSION: string;

package/dist/version.js

@@ -0,0 +1,67 @@
+"use strict";
+// Resolves the running CLI version. Read once at startup so subsequent
+// auth calls don't pay an fs.readFile per request.
+//
+// We could `import packageJson from "../package.json"` but that requires
+// `resolveJsonModule` and emits the JSON into dist. Reading at runtime
+// keeps the bundle smaller and works regardless of tsconfig settings.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLI_VERSION = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+function resolveCliVersion() {
+    // dist/version.js sits alongside dist/cli.js. The package.json is one
+    // directory up from dist/, i.e. `../package.json` relative to this file.
+    // In TS source we're at src/version.ts so the path is `../package.json`.
+    const candidates = [
+        path.join(__dirname, "..", "package.json"),
+        path.join(__dirname, "..", "..", "package.json"),
+    ];
+    for (const p of candidates) {
+        try {
+            const raw = fs.readFileSync(p, "utf8");
+            const json = JSON.parse(raw);
+            if (json.name === "codiedev" && typeof json.version === "string") {
+                return json.version;
+            }
+        }
+        catch {
+            // try next candidate
+        }
+    }
+    return "0.0.0";
+}
+exports.CLI_VERSION = resolveCliVersion();

package/dist/versionCheck.d.ts

@@ -0,0 +1,28 @@
+export interface Semver {
+    major: number;
+    minor: number;
+    patch: number;
+}
+export declare function parseSemver(input: string): Semver | null;
+/**
+ * Returns -1 if a < b, 0 if equal, 1 if a > b.
+ *
+ * Malformed input on either side returns 0 — we never want to nag a user
+ * because of garbage version strings (corrupt cache, registry returned
+ * something weird, prerelease format we don't recognize).
+ */
+export declare function compareSemver(a: string, b: string): -1 | 0 | 1;
+export interface UpdateWarningInput {
+    current: string;
+    latest: string | null;
+    lastChecked: number;
+    nowMs: number;
+    cacheTtlMs: number;
+}
+/**
+ * Warning policy: only show when we have a known-newer `latest` from a
+ * recent-enough cache. Stale-cache freshness is enforced by the *caller*
+ * (which decides whether to refetch); this helper takes the cache state
+ * as-given and answers a single question — should the user see a nag?
+ */
+export declare function shouldShowUpdateWarning(input: UpdateWarningInput): boolean;

package/dist/versionCheck.js

@@ -0,0 +1,49 @@
+"use strict";
+// Pure version-comparison helpers for the "is your CLI outdated" warning.
+// The IO (fetching npm registry, reading/writing the cache file) lives in
+// connect.ts/doctor.ts and is exercised by manual smoke. Keeping the policy
+// pure means the truth table is unit-testable without mocking fetch or fs.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSemver = parseSemver;
+exports.compareSemver = compareSemver;
+exports.shouldShowUpdateWarning = shouldShowUpdateWarning;
+function parseSemver(input) {
+    if (!input)
+        return null;
+    const stripped = input.replace(/^v/i, "");
+    const m = stripped.match(/^(\d+)\.(\d+)\.(\d+)/);
+    if (!m)
+        return null;
+    return { major: Number(m[1]), minor: Number(m[2]), patch: Number(m[3]) };
+}
+/**
+ * Returns -1 if a < b, 0 if equal, 1 if a > b.
+ *
+ * Malformed input on either side returns 0 — we never want to nag a user
+ * because of garbage version strings (corrupt cache, registry returned
+ * something weird, prerelease format we don't recognize).
+ */
+function compareSemver(a, b) {
+    const pa = parseSemver(a);
+    const pb = parseSemver(b);
+    if (!pa || !pb)
+        return 0;
+    if (pa.major !== pb.major)
+        return pa.major < pb.major ? -1 : 1;
+    if (pa.minor !== pb.minor)
+        return pa.minor < pb.minor ? -1 : 1;
+    if (pa.patch !== pb.patch)
+        return pa.patch < pb.patch ? -1 : 1;
+    return 0;
+}
+/**
+ * Warning policy: only show when we have a known-newer `latest` from a
+ * recent-enough cache. Stale-cache freshness is enforced by the *caller*
+ * (which decides whether to refetch); this helper takes the cache state
+ * as-given and answers a single question — should the user see a nag?
+ */
+function shouldShowUpdateWarning(input) {
+    if (!input.latest)
+        return false;
+    return compareSemver(input.current, input.latest) === -1;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codiedev",
-  "version": "0.7.7",
+  "version": "0.7.8",
   "description": "Connect Claude Code, Codex, Cursor, or VS Code Copilot to CodieDev for org-wide session capture and artifact collaboration",
   "bin": {
     "codiedev": "./dist/cli.js",