forkit-connect 0.1.28 → 0.1.30

package/dist/cli.js

@@ -78,6 +78,7 @@ const CLI_FALLBACK_PLAN_LIMITS = {
 };
 const PUBLIC_COMMANDS = [
     ['init', 'Initialize local Connect identity and privacy posture'],
+    ['version', 'Print the Forkit Connect CLI version'],
     ['login', 'Link this device to your Forkit.dev account'],
     ['logout', 'Remove the stored Forkit.dev session from this device'],
     ['status', 'Show account, scope, daemon, and queue status'],
@@ -93,6 +94,19 @@ const PUBLIC_COMMANDS = [
     ['ignore', 'Deny one detected local model on this device'],
     ['doctor', 'Run local environment diagnostics'],
 ];
+const START_HERE_COMMANDS = [
+    ['forkit-connect login', 'Pair this machine with your Forkit.dev account'],
+    ['forkit-connect workspace status', 'Confirm the active workspace and project scope'],
+    ['forkit-connect scan', 'Find local models, agents, and runtimes'],
+    ['forkit-connect inbox', 'Review what should become a Passport'],
+    ['forkit-connect runtime status', 'Check runtime connection and signal posture'],
+];
+const EVERYDAY_COMMANDS = [
+    ['forkit-connect status', 'One-line account, device, queue, and scope health'],
+    ['forkit-connect start', 'Open the guided local launcher'],
+    ['forkit-connect sync', 'Flush queued metadata and lifecycle evidence'],
+    ['forkit-connect doctor', 'Diagnose local setup issues'],
+];
 const ADVANCED_COMMAND_GROUPS = [
     ['connect', 'Model connection, runtime review, and handoff utilities'],
     ['runtime', 'Repo-scoped runtime observation and journaling utilities'],
@@ -117,27 +131,32 @@ const ADVANCED_COMMAND_GROUPS = [
     ['notify', 'Notification preview and delivery controls'],
 ];
 function usage() {
-    printCliHeader('CLI', 'Precise local review, runtime detection, and registration handoff.');
-    console.log(cliKeyLine('usage', 'forkit-connect <command> [options]'));
-    console.log(cliKeyLine('scope', 'forkit-connect workspace <list|select|create|status>'));
-    console.log(cliKeyLine('runtime', 'forkit-connect runtime <register|review|status>'));
-    printCliSection('Core');
-    for (const [command, description] of PUBLIC_COMMANDS) {
-        console.log(cliKeyLine(command, description));
+    printCliHeader('CLI', 'Local AI runtime passporting without copying model data.');
+    console.log(cliKeyLine('best first run', 'forkit-connect login'));
+    console.log(cliKeyLine('privacy model', 'metadata only; secrets stay local'));
+    console.log(cliKeyLine('advanced map', 'forkit-connect --advanced-help'));
+    printCliSection('Start Here');
+    for (const [command, description] of START_HERE_COMMANDS) {
+        console.log(cliCommandLine(command, description));
+    }
+    printCliSection('Daily Ops');
+    for (const [command, description] of EVERYDAY_COMMANDS) {
+        console.log(cliCommandLine(command, description));
     }
     printCliSection('Flags');
     console.log(cliKeyLine('--json', 'Machine-readable output when supported'));
-    console.log(cliKeyLine('--all-ready', 'Register every ready local model in the current scope'));
-    console.log(cliKeyLine('--model', 'Model name used by register'));
-    console.log(cliKeyLine('--entrypoint', 'Relative project path used by runtime register'));
+    console.log(cliKeyLine('--version', 'Print the Forkit Connect CLI version'));
     console.log(cliKeyLine('--dry-run', 'Show inferred runtime payload without creating it'));
-    console.log(cliKeyLine('--no-browser', 'Do not auto-open browser verification during login'));
     console.log(cliKeyLine('--plain', 'Disable the interactive terminal table surface'));
-    console.log(cliKeyLine('--advanced-help', 'Show internal and engineering commands'));
+    console.log(cliKeyLine('--advanced-help', 'Show the full engineering command map'));
 }
 function advancedUsage() {
-    usage();
-    printCliSection('Advanced');
+    printCliHeader('Advanced CLI', 'Full engineering map for automation, C2, and release operations.');
+    printCliSection('Public Commands');
+    for (const [command, description] of PUBLIC_COMMANDS) {
+        console.log(cliKeyLine(command, description));
+    }
+    printCliSection('Advanced Routes');
     console.log(cliKeyLine('connect', 'forkit-connect connect <modelNameOrDiscoveryHash>'));
     console.log(cliKeyLine('connect', 'forkit-connect connect <start|init|status|inbox|services|permissions|handoff|evolution review|runtime review|runtime status>'));
     console.log(cliKeyLine('targets', 'forkit-connect runtime target <add|list|remove|status>'));
@@ -877,6 +896,9 @@ function cliTag(label, tone = 'muted') {
 function cliKeyLine(label, value) {
     return `  ${cliDim(`${label}`.padEnd(CLI_LABEL_WIDTH, ' '))} ${value}`;
 }
+function cliCommandLine(command, value) {
+    return `  ${cliDim(command.padEnd(34, ' '))} ${value}`;
+}
 function printCliHeader(title, subtitle) {
     console.log(`[forkit-connect] ${cliBold(title)}`);
     if (subtitle) {
@@ -2609,6 +2631,10 @@ async function run() {
         showUsage();
         return;
     }
+    if (command === 'version' || command === '--version' || command === '-v') {
+        console.log((0, update_1.getCurrentConnectVersion)());
+        return;
+    }
     if (isHelpCommand(command)) {
         showUsage();
         return;
@@ -2754,6 +2780,37 @@ async function run() {
             return;
         }
         const result = await service.runDiscoveryCycle();
+        const heartbeatGaid = getArg('--heartbeat-gaid');
+        const heartbeatKey = getArg('--heartbeat-key');
+        let heartbeatQueueId = null;
+        if (heartbeatGaid && heartbeatKey) {
+            heartbeatQueueId = service.queueHeartbeatRuntimeSignal(heartbeatGaid, heartbeatKey);
+        }
+        if (hasFlag('--json')) {
+            printJson({
+                ok: result.ok,
+                message: result.message,
+                discovery_mode: result.discoveryMode,
+                runtimes: result.runtimes,
+                models: result.models,
+                counts: {
+                    new_models: result.newModels,
+                    already_known_models: result.alreadyKnownModels,
+                    duplicate_discoveries_skipped: result.duplicateDiscoveriesSkipped,
+                },
+                summary: result.summary,
+                queue: result.queue,
+                sync: result.sync,
+                heartbeat_queue_id: heartbeatQueueId,
+                next_action: result.ok
+                    ? null
+                    : 'Start Ollama, LM Studio, an OpenAI-compatible local server, or add local model directories, then rerun scan.',
+            });
+            if (!result.ok) {
+                process.exitCode = 0;
+            }
+            return;
+        }
         console.log(result.message);
         for (const runtime of result.runtimes) {
             const runtimeStatus = runtime.ok ? 'detected' : 'unavailable';
@@ -2767,13 +2824,8 @@ async function run() {
         console.log(`[forkit-connect] Detected new=${result.newModels} already_known=${result.alreadyKnownModels} duplicates_skipped=${result.duplicateDiscoveriesSkipped}`);
         printDiscoverySummary(result.summary);
         console.log(`[forkit-connect] Queue queued=${result.queue.queued} skipped_pending=${result.queue.skippedPending} skipped_bound=${result.queue.skippedBound} skipped_duplicates=${result.queue.skippedDuplicate}`);
-        const heartbeatGaid = getArg('--heartbeat-gaid');
-        const heartbeatKey = getArg('--heartbeat-key');
-        if (heartbeatGaid && heartbeatKey) {
-            const queueId = service.queueHeartbeatRuntimeSignal(heartbeatGaid, heartbeatKey);
-            if (queueId) {
-                console.log(`[forkit-connect] Queued heartbeat runtime signal: ${queueId}`);
-            }
+        if (heartbeatQueueId) {
+            console.log(`[forkit-connect] Queued heartbeat runtime signal: ${heartbeatQueueId}`);
         }
         console.log(`[forkit-connect] Queue processed=${result.sync.processed} succeeded=${result.sync.succeeded} failed=${result.sync.failed}`);
         if (!result.ok) {
@@ -2879,11 +2931,12 @@ async function run() {
                         await withTimeout(service.prewarmSmartRegistrationInbox(), 1800, undefined);
                         printSessionExportFallback(polled.body.connect_access_token);
                         const displayName = getSessionDisplayName(polled.body.connect_access_token);
-                        console.log(displayName
-                            ? `[forkit-connect] Welcome, ${displayName}. Continuing with an environment-backed session for this run.`
-                            : '[forkit-connect] Continuing with an environment-backed session for this run.');
-                        process.exitCode = 0;
-                        return true;
+                        console.error(displayName
+                            ? `[forkit-connect] Approval reached Forkit.dev for ${displayName}, but this CLI process could not persist the session.`
+                            : '[forkit-connect] Approval reached Forkit.dev, but this CLI process could not persist the session.');
+                        console.error('[forkit-connect] Login is not complete. Rerun `forkit-connect login` from a desktop/keychain session or fix secure storage first.');
+                        process.exitCode = 2;
+                        return false;
                     }
                     throw error;
                 }
@@ -6648,6 +6701,17 @@ async function run() {
     }
     if (command === 'doctor') {
         const checks = await service.runDoctorChecks();
+        if (hasFlag('--json')) {
+            printJson({
+                ok: !checks.some((check) => check.status === 'FAIL'),
+                generated_at: new Date().toISOString(),
+                checks,
+            });
+            if (checks.some((check) => check.status === 'FAIL')) {
+                process.exitCode = 2;
+            }
+            return;
+        }
         for (const check of checks) {
             console.log(`[${check.status}] ${check.name}: ${check.details}`);
         }

package/dist/v1/update.d.ts

@@ -19,7 +19,9 @@ export interface ReleaseManifest {
 export interface ReleaseCheckSuccess {
     ok: true;
     manifestUrl: string;
+    npmLatestUrl: string;
     currentVersion: string;
+    cliLatestVersion: string | null;
     manifest: ReleaseManifest;
     availability: 'up-to-date' | 'update-available' | 'required-update';
     downloadUrl: string | null;
@@ -27,12 +29,14 @@ export interface ReleaseCheckSuccess {
 export interface ReleaseCheckFailure {
     ok: false;
     manifestUrl: string;
+    npmLatestUrl: string;
     currentVersion: string;
     error: string;
 }
 export type ReleaseCheckResult = ReleaseCheckSuccess | ReleaseCheckFailure;
 export declare function getCurrentConnectVersion(): string;
 export declare function getReleaseManifestUrl(): string;
-export declare function checkForUpdates(manifestUrl?: string): Promise<ReleaseCheckResult>;
+export declare function getNpmLatestUrl(): string;
+export declare function checkForUpdates(manifestUrl?: string, npmLatestUrl?: string): Promise<ReleaseCheckResult>;
 export declare function formatUpdateCheckLines(result: ReleaseCheckResult): string[];
 //# sourceMappingURL=update.d.ts.map

package/dist/v1/update.js

@@ -5,12 +5,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getCurrentConnectVersion = getCurrentConnectVersion;
 exports.getReleaseManifestUrl = getReleaseManifestUrl;
+exports.getNpmLatestUrl = getNpmLatestUrl;
 exports.checkForUpdates = checkForUpdates;
 exports.formatUpdateCheckLines = formatUpdateCheckLines;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const node_url_1 = require("node:url");
 const DEFAULT_RELEASE_MANIFEST_URL = process.env.FORKIT_CONNECT_RELEASE_MANIFEST_URL ?? 'https://forkit.dev/connect/releases/latest.json';
+const DEFAULT_NPM_LATEST_URL = process.env.FORKIT_CONNECT_NPM_LATEST_URL ?? 'https://registry.npmjs.org/forkit-connect/latest';
 function readPackageJsonVersion() {
     try {
         const packageJsonPath = node_path_1.default.resolve(__dirname, '..', '..', 'package.json');
@@ -64,15 +66,41 @@ function pickDownloadUrl(downloads) {
     }
     return downloads.linuxAppImage?.url || downloads.linuxDeb?.url || null;
 }
+function isNpmLatestResponse(value) {
+    return !!value
+        && typeof value === 'object'
+        && typeof value.version === 'string'
+        && Boolean(String(value.version).trim());
+}
+async function fetchNpmLatestVersion(npmLatestUrl = DEFAULT_NPM_LATEST_URL) {
+    if (process.env.FORKIT_CONNECT_SKIP_NPM_UPDATE_CHECK === '1') {
+        return null;
+    }
+    const response = await fetch(npmLatestUrl, {
+        method: 'GET',
+        headers: {
+            Accept: 'application/json',
+        },
+    });
+    if (!response.ok) {
+        return null;
+    }
+    const body = await response.json();
+    return isNpmLatestResponse(body) ? body.version.trim() : null;
+}
 function getCurrentConnectVersion() {
     return readPackageJsonVersion();
 }
 function getReleaseManifestUrl() {
     return DEFAULT_RELEASE_MANIFEST_URL;
 }
-async function checkForUpdates(manifestUrl = getReleaseManifestUrl()) {
+function getNpmLatestUrl() {
+    return DEFAULT_NPM_LATEST_URL;
+}
+async function checkForUpdates(manifestUrl = getReleaseManifestUrl(), npmLatestUrl = getNpmLatestUrl()) {
     const currentVersion = getCurrentConnectVersion();
     try {
+        const cliLatestVersion = await fetchNpmLatestVersion(npmLatestUrl).catch(() => null);
         if (manifestUrl.startsWith('file://')) {
             const manifestPath = (0, node_url_1.fileURLToPath)(manifestUrl);
             const raw = await node_fs_1.default.promises.readFile(manifestPath, 'utf8');
@@ -81,12 +109,15 @@ async function checkForUpdates(manifestUrl = getReleaseManifestUrl()) {
                 return {
                     ok: false,
                     manifestUrl,
+                    npmLatestUrl,
                     currentVersion,
                     error: 'invalid_manifest',
                 };
             }
             const minimumSupportedComparison = compareVersions(currentVersion, body.minimumSupportedVersion);
-            const latestComparison = compareVersions(currentVersion, body.latestVersion);
+            const latestComparison = cliLatestVersion
+                ? compareVersions(currentVersion, cliLatestVersion)
+                : compareVersions(currentVersion, body.latestVersion);
             const availability = minimumSupportedComparison < 0
                 ? 'required-update'
                 : latestComparison < 0
@@ -95,7 +126,9 @@ async function checkForUpdates(manifestUrl = getReleaseManifestUrl()) {
             return {
                 ok: true,
                 manifestUrl,
+                npmLatestUrl,
                 currentVersion,
+                cliLatestVersion,
                 manifest: body,
                 availability,
                 downloadUrl: pickDownloadUrl(body.downloads),
@@ -111,6 +144,7 @@ async function checkForUpdates(manifestUrl = getReleaseManifestUrl()) {
             return {
                 ok: false,
                 manifestUrl,
+                npmLatestUrl,
                 currentVersion,
                 error: `manifest_http_${response.status}`,
             };
@@ -120,12 +154,15 @@ async function checkForUpdates(manifestUrl = getReleaseManifestUrl()) {
             return {
                 ok: false,
                 manifestUrl,
+                npmLatestUrl,
                 currentVersion,
                 error: 'invalid_manifest',
             };
         }
         const minimumSupportedComparison = compareVersions(currentVersion, body.minimumSupportedVersion);
-        const latestComparison = compareVersions(currentVersion, body.latestVersion);
+        const latestComparison = cliLatestVersion
+            ? compareVersions(currentVersion, cliLatestVersion)
+            : compareVersions(currentVersion, body.latestVersion);
         const availability = minimumSupportedComparison < 0
             ? 'required-update'
             : latestComparison < 0
@@ -134,7 +171,9 @@ async function checkForUpdates(manifestUrl = getReleaseManifestUrl()) {
         return {
             ok: true,
             manifestUrl,
+            npmLatestUrl,
             currentVersion,
+            cliLatestVersion,
             manifest: body,
             availability,
             downloadUrl: pickDownloadUrl(body.downloads),
@@ -144,6 +183,7 @@ async function checkForUpdates(manifestUrl = getReleaseManifestUrl()) {
         return {
             ok: false,
             manifestUrl,
+            npmLatestUrl,
             currentVersion,
             error: error instanceof Error ? error.message : 'manifest_fetch_failed',
         };
@@ -163,16 +203,20 @@ function formatUpdateCheckLines(result) {
         lines.push('This version is no longer supported.');
     }
     else if (result.availability === 'update-available') {
-        lines.push('Update available.');
+        lines.push('CLI update available.');
     }
     else {
-        lines.push('Forkit Connect is up to date.');
+        lines.push('Forkit Connect CLI is up to date.');
     }
-    lines.push(`Current version: ${result.currentVersion}`);
-    lines.push(`Latest version: ${result.manifest.latestVersion}`);
+    lines.push(`Current CLI version: ${result.currentVersion}`);
+    lines.push(`Latest CLI version: ${result.cliLatestVersion || 'unavailable'}`);
+    lines.push(`Desktop installer latest: ${result.manifest.latestVersion}`);
     if (result.availability !== 'up-to-date') {
-        if (result.downloadUrl) {
-            lines.push(`Download: ${result.downloadUrl}`);
+        if (result.cliLatestVersion && compareVersions(result.currentVersion, result.cliLatestVersion) < 0) {
+            lines.push('Update command: npm install -g forkit-connect@latest');
+        }
+        else if (result.downloadUrl) {
+            lines.push(`Desktop download: ${result.downloadUrl}`);
         }
         lines.push(`Release notes: ${result.manifest.releaseNotesUrl}`);
         if (result.manifest.updateMessage) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forkit-connect",
-  "version": "0.1.28",
+  "version": "0.1.30",
   "description": "Forkit Connect Local Engine - The Global AI Governance Fabric",
   "license": "MIT",
   "main": "dist/index.js",