forkit-connect 0.1.7 → 0.1.9

package/dist/cli.js

@@ -1427,6 +1427,11 @@ function formatSmartInboxActionValue(action, itemType, connectableModelName) {
     }
 }
 function formatSmartInboxActionLabel(item) {
+    if (item.item_type === 'model'
+        && item.recommended_action === 'create_passport_draft'
+        && String(item.details_received_automatically.registration_flow_state || '').trim() === 'private_draft_required') {
+        return 'Open Draft Path';
+    }
     return formatSmartInboxActionValue(item.recommended_action, item.item_type, String(item.details_received_automatically.connectable_model_name || '').trim());
 }
 function printInboxGroup(label, items) {
@@ -1463,6 +1468,7 @@ function printConnectStatusOverview(status) {
         paused_session_count: status.paused_session_count,
         revoked_session_count: status.revoked_session_count,
         credential_reconnect_needed: status.credential_reconnect_needed,
+        draft_first_count: status.draft_first_count,
         ready_to_connect_count: status.ready_to_connect_count,
         needs_confirmation_count: status.needs_confirmation_count,
         connected_count: status.connected_count,
@@ -1473,12 +1479,13 @@ function printConnectStatusOverview(status) {
     }, null, 2));
 }
 function printPublicStatusOverview(status) {
+    const otherReadyCount = Math.max(0, status.ready_to_connect_count - status.draft_first_count);
     console.log('[forkit-connect] Status');
     console.log(`- device=${status.device_paired ? 'paired' : 'approval pending'}`);
     console.log(`- scope=${status.workspace_id && status.project_id ? `${status.workspace_id} / ${status.project_id}` : 'not selected'}`);
     console.log(`- daemon=${status.daemon_status}`);
     console.log(`- local inventory=models ${status.models_discovered} · agents ${status.agents_discovered} · runtimes ${status.runtimes_discovered}`);
-    console.log(`- review queue=ready ${status.ready_to_connect_count} · needs review ${status.needs_confirmation_count}`);
+    console.log(`- review queue=draft first ${status.draft_first_count} · ready ${otherReadyCount} · needs review ${status.needs_confirmation_count}`);
     console.log(`- connected records=${status.connected_count}`);
     console.log(`- pending runtime sync=${status.c2_sync_pending}`);
     console.log(`- privacy=${status.privacy_mode}`);
@@ -1747,8 +1754,11 @@ async function run() {
             preferSnapshot: true,
             refreshInBackground: false,
         });
+        const draftFirstCount = inbox.groups.ready_to_connect.filter((item) => (item.item_type === 'model'
+            && String(item.details_received_automatically.registration_flow_state || '').trim() === 'private_draft_required')).length;
         return {
             ...overview,
+            draft_first_count: draftFirstCount,
             ready_to_connect_count: inbox.summary.ready_to_connect_count,
             needs_confirmation_count: inbox.summary.needs_confirmation_count,
             connected_count: inbox.summary.connected_count,
@@ -2070,6 +2080,7 @@ async function run() {
                     ? 'Local workspace/project scope is cached on this device, but account login is required before governed actions can continue.'
                     : 'Account login is required before governed workspace/project actions can continue.',
             daemon_status: overview.daemon_status,
+            draft_first_count: overview.draft_first_count,
             ready_to_connect_count: overview.ready_to_connect_count,
             needs_confirmation_count: overview.needs_confirmation_count,
             connected_count: overview.connected_count,
@@ -2113,6 +2124,7 @@ async function run() {
                 {
                     title: 'Queue',
                     lines: [
+                        shellLine('Draft-first review', payload.draft_first_count),
                         shellLine('Ready to connect', payload.ready_to_connect_count),
                         shellLine('Needs confirmation', payload.needs_confirmation_count),
                         shellLine('Connected', payload.connected_count),
@@ -2850,6 +2862,8 @@ async function run() {
         const detailKeys = [
             'verification_summary',
             'limitations_summary',
+            'registration_guidance',
+            'registration_error_message',
             'scope_suggestion',
             'scope_mismatch_reason',
             'connectable_model_name',

package/dist/launcher.js

@@ -676,6 +676,9 @@ function buildDiscovery(service) {
         const registeredPassportName = getInboxDetailText(entry, 'registered_passport_name');
         const scopeSuggestion = getInboxDetailText(entry, 'scope_suggestion');
         const verificationSummary = getInboxDetailText(entry, 'verification_summary');
+        const registrationState = getInboxDetailText(entry, 'registration_flow_state');
+        const registrationGuidance = getInboxDetailText(entry, 'registration_guidance')
+            ?? getInboxDetailText(entry, 'registration_error_message');
         const matchReason = entry.match_reason;
         const draftPending = binding?.status === 'pending';
         let statusLabel = 'Ready to register';
@@ -697,6 +700,13 @@ function buildDiscovery(service) {
             actionLabel = 'Review';
             actionTone = 'accent';
         }
+        else if (registrationState === 'private_draft_required') {
+            statusLabel = 'Draft first';
+            statusMeta = registrationGuidance ?? 'This model needs to go through the private draft path before publishing.';
+            statusTone = 'warn';
+            actionLabel = 'Review';
+            actionTone = 'accent';
+        }
         else if (group === 'connected') {
             statusLabel = 'Registered';
             statusMeta = registeredPassportName
@@ -902,6 +912,9 @@ function buildDiscovery(service) {
     const modelItems = items.filter((item) => item.kind === 'model');
     const agentItems = items.filter((item) => item.kind === 'agent');
     const runtimeItems = items.filter((item) => item.kind === 'runtime');
+    const draftFirstCount = inbox.groups.ready_to_connect.filter((item) => (item.item_type === 'model'
+        && String(item.details_received_automatically.registration_flow_state || '').trim() === 'private_draft_required')).length;
+    const otherReadyCount = Math.max(0, inbox.summary.ready_to_connect_count - draftFirstCount);
     return {
         ok: true,
         generatedAt: new Date().toISOString(),
@@ -916,7 +929,7 @@ function buildDiscovery(service) {
             localDetection: state.detected_runtimes.length > 0 || state.detected_models.length > 0 ? 'active' : 'attention',
             metadataExtraction: state.detected_models.length > 0 ? 'active' : 'attention',
             duplicateMatching: inbox.existing_passport_match_candidates.length > 0 || state.model_bindings.length > 0 ? 'active' : 'attention',
-            passportReadiness: `${inbox.summary.ready_to_connect_count} ready · ${inbox.summary.needs_confirmation_count} review · ${inbox.summary.connected_count} linked`,
+            passportReadiness: `${draftFirstCount} draft-first · ${otherReadyCount} ready · ${inbox.summary.needs_confirmation_count} review · ${inbox.summary.connected_count} linked`,
         },
         groups: {
             ready_to_connect: inbox.groups.ready_to_connect.length,

package/dist/v1/service.d.ts

@@ -253,6 +253,7 @@ export interface ConnectStatusOverview {
     paused_session_count: number;
     revoked_session_count: number;
     credential_reconnect_needed: boolean;
+    draft_first_count: number;
     ready_to_connect_count: number;
     needs_confirmation_count: number;
     connected_count: number;
@@ -408,6 +409,7 @@ export declare class ConnectV1Service {
     private hasExactBoundPassportForModel;
     private runtimeHasExactBoundModelDuplicate;
     private clearModelReviewDeferral;
+    private updateDetectedModelRegistrationHint;
     private buildPassportMatchSuggestionForModel;
     private normalizeRemotePassportList;
     private loadRemoteWorkspaceNameMaps;

package/dist/v1/service.js

@@ -2287,6 +2287,33 @@ class ConnectV1Service {
             : item);
         this.stateStore.replaceDetectedModels(nextModels);
     }
+    updateDetectedModelRegistrationHint(model, input) {
+        const nextModels = this.stateStore.readState().detected_models.map((item) => {
+            if (item.discoveryHash !== model.discoveryHash) {
+                return item;
+            }
+            const nextMetadata = {
+                ...(item.metadata && typeof item.metadata === 'object' ? item.metadata : {}),
+            };
+            const assignOrDelete = (key, value) => {
+                if (value === null || value === undefined || value === '') {
+                    delete nextMetadata[key];
+                    return;
+                }
+                nextMetadata[key] = value;
+            };
+            assignOrDelete('tracking_status', input.trackingStatus ?? null);
+            assignOrDelete('registration_error_code', input.errorCode ?? null);
+            assignOrDelete('registration_error_message', input.errorMessage ?? null);
+            assignOrDelete('registration_error_status', typeof input.errorStatus === 'number' ? input.errorStatus : null);
+            assignOrDelete('registration_guidance', input.guidance ?? null);
+            return {
+                ...item,
+                metadata: nextMetadata,
+            };
+        });
+        this.stateStore.replaceDetectedModels(nextModels);
+    }
     buildPassportMatchSuggestionForModel(state, model, runtimePassport) {
         const registrationKey = (0, discovery_1.buildModelRegistrationKey)(model, state.runtime_identity.runtimeId);
         const candidates = state.model_bindings
@@ -4305,6 +4332,10 @@ class ConnectV1Service {
             const observedProjectId = normalizeDisplayText(modelMetadata.projectId ?? modelMetadata.project_id);
             const scopeSuggestion = this.resolveScopeSuggestion(refreshedState, observedWorkspaceId, observedProjectId);
             const itemId = this.buildInboxItemId('model', model.discoveryHash);
+            const registrationTrackingStatus = normalizeDisplayText(modelMetadata.tracking_status);
+            const registrationErrorMessage = normalizeDisplayText(modelMetadata.registration_error_message);
+            const registrationErrorCode = normalizeDisplayText(modelMetadata.registration_error_code);
+            const registrationGuidance = normalizeDisplayText(modelMetadata.registration_guidance);
             const recommendedAction = binding?.status === 'bound'
                 ? 'open_on_forkit'
                 : suggestion.match_confidence === 'medium'
@@ -4371,6 +4402,10 @@ class ConnectV1Service {
                     registered_workspace_name: binding?.workspaceName ?? null,
                     registered_project_name: binding?.projectName ?? null,
                     remote_match_source: binding?.remoteMatchSource ?? null,
+                    registration_flow_state: registrationTrackingStatus,
+                    registration_error_message: registrationErrorMessage,
+                    registration_error_code: registrationErrorCode,
+                    registration_guidance: registrationGuidance,
                     verification_summary: verification.verification,
                     limitations_summary: verification.limitations,
                     review_disposition: reviewDisposition,
@@ -4690,6 +4725,11 @@ class ConnectV1Service {
         const state = this.stateStore.readState();
         const includeInbox = options?.includeInbox !== false;
         const inbox = includeInbox ? this.buildSmartRegistrationInbox() : null;
+        const draftFirstCount = inbox
+            ? inbox.groups.ready_to_connect.filter((item) => (item.item_type === 'model'
+                && String(item.details_received_automatically.registration_flow_state || '').trim() === 'private_draft_required')).length
+            : state.detected_models.filter((item) => (item.status !== 'ignored'
+                && String((item.metadata && typeof item.metadata === 'object' ? item.metadata : {}).tracking_status || '').trim() === 'private_draft_required')).length;
         const sessionSummary = this.getC2SessionSummary();
         const binding = this.getEffectiveBindingState(state);
         const bindingReconnectRequired = this.bindingRequiresReconnect(state);
@@ -4709,6 +4749,7 @@ class ConnectV1Service {
             paused_session_count: sessionSummary.paused_session_count,
             revoked_session_count: sessionSummary.revoked_session_count,
             credential_reconnect_needed: bindingReconnectRequired || sessionSummary.credential_reconnect_needed,
+            draft_first_count: draftFirstCount,
             ready_to_connect_count: inbox?.summary.ready_to_connect_count ?? discoveredModels,
             needs_confirmation_count: inbox?.summary.needs_confirmation_count ?? 0,
             connected_count: inbox?.summary.connected_count ?? connectedCount,
@@ -7798,6 +7839,13 @@ class ConnectV1Service {
             ? 'public'
             : 'private';
         this.clearModelReviewDeferral(model);
+        this.updateDetectedModelRegistrationHint(model, {
+            trackingStatus: null,
+            errorCode: null,
+            errorMessage: null,
+            errorStatus: null,
+            guidance: null,
+        });
         const { payload, registrationKey } = this.buildConnectDraftPayload(model, state, draftScope, {
             visibility: requestedVisibility,
         });
@@ -7939,6 +7987,16 @@ class ConnectV1Service {
             const api = this.getApiClient(state);
             const result = await api.createPassportDraft(payload);
             if (!result.ok) {
+                const backendCode = extractApiErrorCode(result.body) || `DRAFT_CREATE_FAILED:${result.status}`;
+                if (backendCode === 'INVALID_DRAFT_VISIBILITY') {
+                    this.updateDetectedModelRegistrationHint(model, {
+                        trackingStatus: 'private_draft_required',
+                        errorCode: backendCode,
+                        errorMessage: 'This registration must start as a private draft before it can be published.',
+                        errorStatus: result.status,
+                        guidance: 'Open the review flow and continue through the private draft path first.',
+                    });
+                }
                 this.observeBackendCommunicationState({
                     passportGaid: bindingWithRuntime?.gaid ?? null,
                     runtimeGaid: runtimePassport?.runtime_gaid ?? null,
@@ -7947,7 +8005,7 @@ class ConnectV1Service {
                     body: result.body,
                     source: 'draft_sync',
                 });
-                throw new Error(result.status === 409 ? 'DRAFT_ALREADY_EXISTS' : (extractApiErrorCode(result.body) || `DRAFT_CREATE_FAILED:${result.status}`));
+                throw new Error(result.status === 409 ? 'DRAFT_ALREADY_EXISTS' : backendCode);
             }
             const parsed = this.parseDraftResponse(result);
             let finalGaid = parsed.gaid;

package/dist/v1/state.js

@@ -938,8 +938,30 @@ class LocalStateStore {
             const seen = new Map();
             for (const model of models) {
                 const existing = state.detected_models.find((item) => item.discoveryHash === model.discoveryHash);
+                const nextMetadata = model.metadata && typeof model.metadata === 'object'
+                    ? { ...model.metadata }
+                    : {};
+                const existingMetadata = existing?.metadata && typeof existing.metadata === 'object'
+                    ? existing.metadata
+                    : null;
+                if (existingMetadata) {
+                    for (const key of [
+                        'draft_id',
+                        'passport_gaid',
+                        'tracking_status',
+                        'registration_error_code',
+                        'registration_error_message',
+                        'registration_error_status',
+                        'registration_guidance',
+                    ]) {
+                        if (!Object.prototype.hasOwnProperty.call(nextMetadata, key) && Object.prototype.hasOwnProperty.call(existingMetadata, key)) {
+                            nextMetadata[key] = existingMetadata[key];
+                        }
+                    }
+                }
                 seen.set(model.discoveryHash, {
                     ...model,
+                    metadata: nextMetadata,
                     status: model.status === 'ignored' || model.status === 'bound'
                         ? model.status
                         : existing?.status === 'ignored' || existing?.status === 'bound'

package/package.json

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