@krischoichoi/channel-control 0.6.0

package/lib/update-check.js

@@ -0,0 +1,380 @@
+/**
+ * Bundle update check — prompt-only npm dist-tag check for
+ * `@krischoichoi/dsh-channels` (the bundle users install).
+ *
+ * The official Harness has no plugin update mechanism (`dsh plugin` is a pnpm
+ * passthrough; `dsh-host-plugin-inventory` is a read-only loader projection),
+ * so this control-plane module adds a lightweight runtime hint:
+ *
+ * - Checks `https://registry.npmjs.org/@krischoichoi/dsh-channels/{latest,next}`
+ *   (single-tag manifests, far lighter than a full packument), 15s timeout,
+ *   offline/timeout/validation failures are swallowed into a debug log — a
+ *   check failure must NEVER produce a user-facing error.
+ * - Registry responses are EXTERNAL input and validated with zod `safeParse`
+ *   (a `version` that is not a legal semver string is treated as offline).
+ * - The result is cached in the shared ChannelStorage under a versioned key
+ *   with a configurable TTL (default 24h); an in-memory copy avoids repeated
+ *   disk reads within the same process. A cache written for a different
+ *   installed version is discarded, so the first run after an upgrade
+ *   re-checks immediately.
+ * - Comparison rules (prerelease-aware, hand-written — no semver dependency):
+ *     * stable install  → compared against the `latest` tag only;
+ *     * prerelease install → compared against max(latest, next);
+ *     * strictly greater than the installed version prompts.
+ * - Version-line rule: when the target's major.minor differs from the
+ *   installed version the hint must carry the TWO-STEP upgrade commands
+ *   (Harness CLI first, then re-add the bundle); same line → single
+ *   `plugin update` command.
+ *
+ * This feature only ever PROMPTS. It never installs, upgrades or mutates
+ * anything outside its own cache key.
+ */
+import pkg from '../package.json' with { type: 'json' };
+import { z } from 'zod';
+/** The bundle package users install (checked on the npm registry). */
+export const BUNDLE_PACKAGE = '@krischoichoi/dsh-channels';
+/** npm registry base. External endpoint; responses are untrusted input. */
+const REGISTRY_BASE = 'https://registry.npmjs.org';
+/** Registry fetch timeout (mirrors scripts/check-upstream.mjs). */
+export const FETCH_TIMEOUT_MS = 15000;
+/** Durable cache key (versioned so future format changes invalidate old rows). */
+export const UPDATE_CHECK_STORAGE_KEY = 'update-check:v1';
+/** Cache schema version marker persisted alongside the snapshot. */
+const CACHE_FORMAT = 1;
+/**
+ * The installed bundle version. By release convention every runtime-family
+ * package (the bundle + its ten dependencies, see docs/release.md) moves in
+ * lockstep — each changeset lists the whole family and every package.json
+ * carries the same version — so this package's own version IS the installed
+ * `@krischoichoi/dsh-channels` version. Keep the family lockstep when bumping;
+ * `test/update-check.test.ts` asserts this package's version equals the
+ * bundle's.
+ */
+export const BUNDLE_VERSION = pkg.version;
+const silentLogger = { debug() { }, info() { } };
+/* ------------------------------------------------------------------ */
+/* semver (hand-written, prerelease-aware — no new dependency)         */
+/* ------------------------------------------------------------------ */
+/** Official semver regex (no leading v/=; build metadata tolerated). */
+const SEMVER_RE = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*)(?:\.(?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*))*))?(?:\+([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?$/;
+/** Parse a strict semver string, or undefined when malformed. */
+export function parseSemver(version) {
+    const match = SEMVER_RE.exec(version.trim());
+    if (!match)
+        return undefined;
+    return {
+        major: Number(match[1]),
+        minor: Number(match[2]),
+        patch: Number(match[3]),
+        pre: match[4] !== undefined ? match[4].split('.') : null,
+    };
+}
+/** Whether a version string is a legal strict semver (with/without suffixes). */
+export function isSemverString(version) {
+    return SEMVER_RE.test(version.trim());
+}
+function isNumericIdentifier(identifier) {
+    return /^[0-9]+$/.test(identifier);
+}
+/** Semver §11 prerelease precedence: numeric < alphanumeric, longer wins ties. */
+function comparePrereleaseIdentifiers(a, b) {
+    const shared = Math.min(a.length, b.length);
+    for (let i = 0; i < shared; i++) {
+        const x = a[i];
+        const y = b[i];
+        const xNum = isNumericIdentifier(x);
+        const yNum = isNumericIdentifier(y);
+        if (xNum && yNum) {
+            const diff = Number(x) - Number(y);
+            if (diff !== 0)
+                return diff < 0 ? -1 : 1;
+            continue;
+        }
+        if (xNum)
+            return -1; // numeric identifiers always have lower precedence
+        if (yNum)
+            return 1;
+        if (x !== y)
+            return x < y ? -1 : 1;
+    }
+    if (a.length === b.length)
+        return 0;
+    return a.length < b.length ? -1 : 1; // larger identifier set wins
+}
+/**
+ * Full semver precedence compare. Build metadata is ignored. Callers must
+ * pre-validate inputs with parseSemver; an unparseable side compares equal
+ * (never greater), so a malformed value can never fabricate an update hint.
+ */
+export 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;
+    if (pa.pre === null && pb.pre === null)
+        return 0;
+    if (pa.pre === null)
+        return 1; // release > prerelease
+    if (pb.pre === null)
+        return -1;
+    return comparePrereleaseIdentifiers(pa.pre, pb.pre);
+}
+/* ------------------------------------------------------------------ */
+/* Trust boundary: zod schemas for external input                      */
+/* ------------------------------------------------------------------ */
+/** A registry manifest only needs a legal semver `version` field. */
+const registryManifestSchema = z
+    .object({ version: z.string().refine(isSemverString, 'version must be a strict semver string') })
+    .loose();
+/** Durable cache body (own storage is re-validated on load: storage can corrupt). */
+const storedSnapshotSchema = z
+    .object({
+    v: z.literal(CACHE_FORMAT),
+    checkedAt: z.number(),
+    currentVersion: z.string().refine(isSemverString),
+    latest: z.string().refine(isSemverString),
+    next: z.string().refine(isSemverString).optional(),
+})
+    .loose();
+/* ------------------------------------------------------------------ */
+/* Update evaluation (pure; unit-testable without I/O)                 */
+/* ------------------------------------------------------------------ */
+/** Same-line upgrade: `plugin update` already refreshes within the range. */
+const SAME_LINE_COMMANDS = [
+    'npx @deepseek-ai/dsh plugin --profile web update -w @krischoichoi/dsh-channels',
+];
+/** Cross-line upgrade: Harness CLI FIRST, then re-add the bundle (order matters). */
+const CROSS_LINE_COMMANDS = [
+    'npm i -g @deepseek-ai/dsh@latest',
+    'npx @deepseek-ai/dsh plugin --profile web add -w @krischoichoi/dsh-channels@latest',
+];
+/**
+ * Evaluate the prompt from dist-tag versions against the installed version.
+ * Pure function; malformed versions are ignored (they can never prompt).
+ */
+export function evaluateBundleUpdate(currentVersion, tags) {
+    const current = parseSemver(currentVersion);
+    if (!current)
+        return undefined;
+    const candidates = [];
+    if (tags.latest !== undefined && isSemverString(tags.latest)) {
+        candidates.push({ tag: 'latest', version: tags.latest, parsed: parseSemver(tags.latest) });
+    }
+    // Prerelease installs also consider the `next` dist-tag; stable installs
+    // never get prompted onto a prerelease.
+    if (current.pre !== null && tags.next !== undefined && isSemverString(tags.next)) {
+        candidates.push({ tag: 'next', version: tags.next, parsed: parseSemver(tags.next) });
+    }
+    if (candidates.length === 0)
+        return undefined;
+    let target = candidates[0];
+    for (const candidate of candidates) {
+        if (compareSemver(candidate.version, target.version) > 0)
+            target = candidate;
+    }
+    if (compareSemver(target.version, currentVersion) <= 0)
+        return undefined;
+    const crossLine = target.parsed.major !== current.major || target.parsed.minor !== current.minor;
+    return {
+        version: target.version,
+        tag: target.tag,
+        crossLine,
+        commands: crossLine ? [...CROSS_LINE_COMMANDS] : [...SAME_LINE_COMMANDS],
+    };
+}
+/* ------------------------------------------------------------------ */
+/* Checker                                                             */
+/* ------------------------------------------------------------------ */
+/**
+ * [BundleUpdateChecker] — TTL-cached, offline-tolerant npm dist-tag check.
+ * Never throws: every failure path (disabled, offline, timeout, schema
+ * rejection, storage error) degrades to "no update known".
+ */
+export class BundleUpdateChecker {
+    currentVersion;
+    enabled;
+    intervalMs;
+    getStorage;
+    logger;
+    now;
+    /** In-memory snapshot so a process reads storage at most once per cache. */
+    memory;
+    inflight;
+    constructor(options) {
+        this.currentVersion = options.currentVersion ?? BUNDLE_VERSION;
+        this.enabled = options.enabled;
+        this.intervalMs = Math.max(0, options.intervalHours) * 3_600_000;
+        this.getStorage = options.getStorage ?? (() => undefined);
+        this.logger = options.logger ?? silentLogger;
+        this.now = options.now ?? (() => Date.now());
+    }
+    /**
+     * Fire-and-forget check (startup hook). Re-entrant: concurrent callers share
+     * one in-flight promise; a fresh cache short-circuits without fetching.
+     * Never rejects — callers may `void` it safely.
+     */
+    trigger() {
+        if (this.inflight)
+            return this.inflight;
+        if (!this.enabled) {
+            this.logger.debug('[channel-control] update check disabled (updateCheck.enabled=false)');
+            return Promise.resolve();
+        }
+        this.inflight = this.runCheck().finally(() => {
+            this.inflight = undefined;
+        });
+        return this.inflight;
+    }
+    /**
+     * Read-only status for the web control plane / /version command. Returns
+     * immediately with the cached snapshot (storage-backed when the process has
+     * not checked yet) and kicks a background refresh when the cache is stale
+     * or absent — a first request never blocks on the registry.
+     */
+    async getStatus() {
+        // Disabled means fully off: no hints either — even a fresh snapshot left
+        // in storage by a previous (enabled) run must not surface.
+        if (!this.enabled)
+            return { currentVersion: this.currentVersion };
+        if (!this.memory) {
+            const stored = await this.loadStored();
+            if (stored)
+                this.memory = stored;
+        }
+        if (!this.isFresh(this.memory))
+            void this.trigger().catch(() => { });
+        return this.toStatus(this.memory);
+    }
+    async runCheck() {
+        try {
+            if (this.isFresh(this.memory))
+                return;
+            if (!this.memory) {
+                const stored = await this.loadStored();
+                if (stored) {
+                    this.memory = stored;
+                    if (this.isFresh(this.memory))
+                        return;
+                }
+            }
+            const { latest, next } = await this.fetchDistTags();
+            const snapshot = {
+                checkedAt: this.now(),
+                currentVersion: this.currentVersion,
+                latest,
+                ...(next !== undefined ? { next } : {}),
+            };
+            this.memory = snapshot;
+            await this.persist(snapshot);
+            const { update } = this.toStatus(snapshot);
+            if (update) {
+                // The ONE startup info line (AGENTS.md §5.2.1 spirit: no registry raw
+                // payload, no noise when there is nothing to say).
+                this.logger.info(`[channel-control] ${BUNDLE_PACKAGE} ${this.currentVersion} -> ${update.version} available ` +
+                    `(dist-tag: ${update.tag}, npm latest: ${latest}); upgrade is manual — see /version or the web Channels settings`);
+            }
+        }
+        catch (error) {
+            // Offline / timeout / schema rejection: silent for the user, debug only.
+            this.logger.debug('[channel-control] bundle update check skipped (offline or invalid response)', error);
+        }
+    }
+    isFresh(snapshot) {
+        if (!snapshot)
+            return false;
+        return this.now() - snapshot.checkedAt < this.intervalMs;
+    }
+    toStatus(snapshot) {
+        if (!snapshot)
+            return { currentVersion: this.currentVersion };
+        return {
+            currentVersion: this.currentVersion,
+            update: evaluateBundleUpdate(this.currentVersion, snapshot),
+            checkedAt: snapshot.checkedAt,
+        };
+    }
+    /**
+     * Fetch the `latest` and `next` single-tag manifests in parallel. The next
+     * tag is optional (404 → absent); latest is required for a successful
+     * check. Any non-404 failure, and any zod rejection, throws so the whole
+     * check is treated as offline (no partially-trusted snapshot is kept).
+     */
+    async fetchDistTags() {
+        const [latestResult, nextResult] = await Promise.allSettled([
+            this.fetchManifestVersion('latest'),
+            this.fetchManifestVersion('next'),
+        ]);
+        if (latestResult.status === 'rejected')
+            throw latestResult.reason;
+        const latest = latestResult.value;
+        if (latest === undefined)
+            throw new Error('npm latest dist-tag manifest unavailable');
+        let next;
+        if (nextResult.status === 'fulfilled')
+            next = nextResult.value;
+        return { latest, ...(next !== undefined ? { next } : {}) };
+    }
+    /** One tag manifest → its version. 404 → undefined (tag not published). */
+    async fetchManifestVersion(tag) {
+        const response = await fetch(`${REGISTRY_BASE}/${BUNDLE_PACKAGE}/${tag}`, {
+            headers: { accept: 'application/json' },
+            signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+        });
+        if (response.status === 404)
+            return undefined;
+        if (!response.ok)
+            throw new Error(`${BUNDLE_PACKAGE}/${tag}: HTTP ${response.status}`);
+        const body = await response.json();
+        const parsed = registryManifestSchema.safeParse(body);
+        if (!parsed.success) {
+            throw new Error(`${BUNDLE_PACKAGE}/${tag}: registry manifest failed schema validation`);
+        }
+        return parsed.data.version;
+    }
+    async loadStored() {
+        const storage = this.getStorage();
+        if (!storage)
+            return undefined;
+        try {
+            const raw = await storage.get(UPDATE_CHECK_STORAGE_KEY);
+            if (raw === undefined)
+                return undefined;
+            const parsed = storedSnapshotSchema.safeParse(JSON.parse(raw));
+            if (!parsed.success)
+                return undefined;
+            // A cache recorded for a different installed version (e.g. written
+            // before this process upgraded) is discarded so the next check re-runs.
+            if (parsed.data.currentVersion !== this.currentVersion)
+                return undefined;
+            const data = parsed.data;
+            return {
+                checkedAt: data.checkedAt,
+                currentVersion: data.currentVersion,
+                latest: data.latest,
+                ...(data.next !== undefined ? { next: data.next } : {}),
+            };
+        }
+        catch {
+            return undefined; // missing/corrupt cache row → simply re-check
+        }
+    }
+    async persist(snapshot) {
+        const storage = this.getStorage();
+        if (!storage)
+            return;
+        try {
+            const body = { v: CACHE_FORMAT, ...snapshot };
+            await storage.set(UPDATE_CHECK_STORAGE_KEY, JSON.stringify(body));
+        }
+        catch (error) {
+            this.logger.debug('[channel-control] failed to persist update-check cache', error);
+        }
+    }
+}
+//# sourceMappingURL=update-check.js.map

package/lib/update-check.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@krischoichoi/channel-control",
+  "version": "0.6.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/krischoichoi/dsh-channels.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Universal Channel Control Plane for DeepSeek Harness Channels (configuration, credentials, auth sessions, runtime lifecycle)",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./plugin": {
+      "types": "./lib/plugin.d.ts",
+      "default": "./lib/plugin.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "clean": "rimraf lib"
+  },
+  "dependencies": {
+    "@deepseek-ai/cordis": "^4.0.4",
+    "@deepseek-ai/schemastery": "~3.18.4",
+    "@krischoichoi/channel-core": "workspace:*",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "rimraf": "^6.0.0",
+    "typescript": "^5.9.0",
+    "vitest": "^3.2.0"
+  },
+  "license": "MIT"
+}