@vectle/cli 1.0.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (105) hide show
  1. package/CHANGELOG.md +15 -0
  2. package/README.md +15 -8
  3. package/dist/activity.d.ts +10 -0
  4. package/dist/activity.js +10 -0
  5. package/dist/activity.js.map +1 -0
  6. package/dist/adapters/claude.d.ts +4 -0
  7. package/dist/adapters/claude.js +279 -0
  8. package/dist/adapters/claude.js.map +1 -0
  9. package/dist/adapters/codex.d.ts +16 -0
  10. package/dist/adapters/codex.js +410 -0
  11. package/dist/adapters/codex.js.map +1 -0
  12. package/dist/adapters/common.d.ts +80 -0
  13. package/dist/adapters/common.js +249 -0
  14. package/dist/adapters/common.js.map +1 -0
  15. package/dist/adapters/cursor.d.ts +4 -0
  16. package/dist/adapters/cursor.js +240 -0
  17. package/dist/adapters/cursor.js.map +1 -0
  18. package/dist/adapters/vscode.d.ts +4 -0
  19. package/dist/adapters/vscode.js +240 -0
  20. package/dist/adapters/vscode.js.map +1 -0
  21. package/dist/agent-policy.d.ts +50 -0
  22. package/dist/agent-policy.js +83 -0
  23. package/dist/agent-policy.js.map +1 -0
  24. package/dist/client.d.ts +69 -10
  25. package/dist/client.js +247 -24
  26. package/dist/client.js.map +1 -1
  27. package/dist/constants.d.ts +12 -2
  28. package/dist/constants.js +7 -1
  29. package/dist/constants.js.map +1 -1
  30. package/dist/contracts.d.ts +53 -0
  31. package/dist/contracts.js +68 -0
  32. package/dist/contracts.js.map +1 -0
  33. package/dist/delivery.d.ts +80 -0
  34. package/dist/delivery.js +304 -0
  35. package/dist/delivery.js.map +1 -0
  36. package/dist/findings.d.ts +12 -0
  37. package/dist/findings.js +41 -0
  38. package/dist/findings.js.map +1 -0
  39. package/dist/help.d.ts +1 -0
  40. package/dist/help.js +53 -0
  41. package/dist/help.js.map +1 -0
  42. package/dist/index.js +370 -72
  43. package/dist/index.js.map +1 -1
  44. package/dist/integrations.d.ts +126 -0
  45. package/dist/integrations.js +173 -0
  46. package/dist/integrations.js.map +1 -0
  47. package/dist/legacy-compat.d.ts +45 -0
  48. package/dist/legacy-compat.js +149 -0
  49. package/dist/legacy-compat.js.map +1 -0
  50. package/dist/lifecycle.d.ts +50 -0
  51. package/dist/lifecycle.js +146 -0
  52. package/dist/lifecycle.js.map +1 -0
  53. package/dist/locator.d.ts +58 -0
  54. package/dist/locator.js +233 -0
  55. package/dist/locator.js.map +1 -0
  56. package/dist/mcp.d.ts +12 -2
  57. package/dist/mcp.js +194 -48
  58. package/dist/mcp.js.map +1 -1
  59. package/dist/modes.d.ts +37 -0
  60. package/dist/modes.js +32 -0
  61. package/dist/modes.js.map +1 -0
  62. package/dist/outbox.d.ts +9 -0
  63. package/dist/outbox.js +188 -0
  64. package/dist/outbox.js.map +1 -0
  65. package/dist/parser.d.ts +10 -0
  66. package/dist/parser.js +99 -0
  67. package/dist/parser.js.map +1 -0
  68. package/dist/pulse.d.ts +122 -0
  69. package/dist/pulse.js +412 -0
  70. package/dist/pulse.js.map +1 -0
  71. package/dist/release-manifest.d.ts +123 -0
  72. package/dist/release-manifest.js +226 -0
  73. package/dist/release-manifest.js.map +1 -0
  74. package/dist/release.d.ts +1 -1
  75. package/dist/response.d.ts +17 -0
  76. package/dist/response.js +15 -0
  77. package/dist/response.js.map +1 -1
  78. package/dist/rollout.d.ts +8 -0
  79. package/dist/rollout.js +27 -0
  80. package/dist/rollout.js.map +1 -0
  81. package/dist/runtime.d.ts +60 -0
  82. package/dist/runtime.js +276 -0
  83. package/dist/runtime.js.map +1 -0
  84. package/dist/secure-store.d.ts +36 -0
  85. package/dist/secure-store.js +282 -0
  86. package/dist/secure-store.js.map +1 -0
  87. package/dist/setup.d.ts +159 -0
  88. package/dist/setup.js +629 -0
  89. package/dist/setup.js.map +1 -0
  90. package/dist/state.d.ts +98 -0
  91. package/dist/state.js +226 -0
  92. package/dist/state.js.map +1 -0
  93. package/dist/status.d.ts +282 -0
  94. package/dist/status.js +213 -0
  95. package/dist/status.js.map +1 -0
  96. package/dist/store.d.ts +44 -2
  97. package/dist/store.js +222 -44
  98. package/dist/store.js.map +1 -1
  99. package/dist/update.d.ts +33 -1
  100. package/dist/update.js +88 -16
  101. package/dist/update.js.map +1 -1
  102. package/dist/write-journal.d.ts +71 -0
  103. package/dist/write-journal.js +175 -0
  104. package/dist/write-journal.js.map +1 -0
  105. package/package.json +7 -2
@@ -0,0 +1,282 @@
1
+ import type { VectleClient } from './client.js';
2
+ import { type IntegrationManifest, type IntegrationManifestEntry } from './integrations.js';
3
+ import type { ClientFamily, VectleConfig } from './store.js';
4
+ import type { CliRelease } from './update.js';
5
+ type Freshness = {
6
+ state: 'live' | 'cached' | 'unchecked' | 'unavailable';
7
+ observed_at: string | null;
8
+ };
9
+ declare function selectionOption(entry: IntegrationManifestEntry): {
10
+ client_family: import("./integrations.js").SupportedClientFamily;
11
+ profile_label: string;
12
+ adapter_entry_id: string;
13
+ };
14
+ export type StatusOptions = {
15
+ clientFamily?: ClientFamily | 'auto' | 'all';
16
+ local?: boolean;
17
+ publicCapability?: Record<string, unknown> | null;
18
+ installationCapability?: Record<string, unknown> | null;
19
+ manifest?: IntegrationManifest;
20
+ releaseEligible?: boolean;
21
+ releaseMetadata?: {
22
+ state: Freshness['state'];
23
+ observed_at: string | null;
24
+ sequence: number | null;
25
+ minimum_supported_version: string | null;
26
+ recommended_version: string | null;
27
+ update_available: boolean | null;
28
+ } | null;
29
+ };
30
+ export declare function readDoctorServices(client: Pick<VectleClient, 'health' | 'latestRelease'>, releaseMetadata: StatusOptions['releaseMetadata'], local: boolean, cliVersion?: string): Promise<[PromiseSettledResult<Record<string, unknown>>, PromiseSettledResult<{
31
+ state: Freshness["state"];
32
+ observed_at: string | null;
33
+ sequence: number | null;
34
+ minimum_supported_version: string | null;
35
+ recommended_version: string | null;
36
+ update_available: boolean | null;
37
+ } | null | undefined>] | [PromiseSettledResult<Record<string, unknown>>, PromiseSettledResult<CliRelease>] | readonly [{
38
+ readonly status: "fulfilled";
39
+ readonly value: {
40
+ readonly status: "unchecked";
41
+ };
42
+ }, {
43
+ readonly status: "fulfilled";
44
+ readonly value: null;
45
+ }]>;
46
+ export declare function buildLocalStatus(config: VectleConfig, options?: StatusOptions): {
47
+ schema_version: "vectle-status-v2";
48
+ selected: "none" | "all" | "family" | "current_integration";
49
+ selection: {
50
+ schema_version: "client-selection-v1";
51
+ status: "not_required" | "none_detected";
52
+ reason: "all_requested" | "no_supported_client";
53
+ options: never[];
54
+ } | {
55
+ schema_version: "client-selection-v1";
56
+ status: "not_required";
57
+ reason: "all_requested";
58
+ options: {
59
+ client_family: import("./integrations.js").SupportedClientFamily;
60
+ profile_label: string;
61
+ adapter_entry_id: string;
62
+ }[];
63
+ } | {
64
+ schema_version: "client-selection-v1";
65
+ status: "selected";
66
+ reason: "explicit_family";
67
+ options: {
68
+ client_family: import("./integrations.js").SupportedClientFamily;
69
+ profile_label: string;
70
+ adapter_entry_id: string;
71
+ }[];
72
+ } | {
73
+ schema_version: "client-selection-v1";
74
+ status: "choice_required";
75
+ reason: "same_family_multiple_profiles";
76
+ options: {
77
+ client_family: import("./integrations.js").SupportedClientFamily;
78
+ profile_label: string;
79
+ adapter_entry_id: string;
80
+ }[];
81
+ } | {
82
+ schema_version: "client-selection-v1";
83
+ status: "selected";
84
+ reason: "managed_invocation";
85
+ options: {
86
+ client_family: import("./integrations.js").SupportedClientFamily;
87
+ profile_label: string;
88
+ adapter_entry_id: string;
89
+ }[];
90
+ };
91
+ installation: {
92
+ configured: boolean;
93
+ local_mode: import("./store.js").LocalMode;
94
+ consent_state: "revocation_pending" | "legacy_v1" | "not_connected" | "revoked" | "active_v2";
95
+ approved_behavior_ceiling: {
96
+ authority: "current";
97
+ consent_version: 2;
98
+ startup_pulse: "automatic" | "on_demand";
99
+ sharing_and_correction: "automatic" | "explicit_only";
100
+ } | null;
101
+ actions_required: {
102
+ code: "new_setup";
103
+ target: null;
104
+ }[] | {
105
+ code: "consent_upgrade";
106
+ target: null;
107
+ }[] | {
108
+ code: "finish_server_revocation";
109
+ target: null;
110
+ }[];
111
+ };
112
+ aggregate: {
113
+ configured_integrations: number;
114
+ verified_full_lifecycle: number;
115
+ automatic_lookup_integrations: number;
116
+ automatic_update_integrations: number;
117
+ automatic_submission_integrations: number;
118
+ automatic_correction_integrations: number;
119
+ integrations_needing_action: number;
120
+ };
121
+ integrations: {
122
+ adapter_entry_id: string;
123
+ client_family: import("./integrations.js").SupportedClientFamily;
124
+ profile_label: string;
125
+ integration_capability: "full_lifecycle" | "policy_and_mcp" | "mcp_only" | "authorized_only" | "disconnected" | "conflict";
126
+ startup_invocation_policy: "off" | "on_demand" | "automatic_guard";
127
+ sharing_invocation_policy: "off" | "explicit_only" | "automatic_guard";
128
+ lookup_capability: "automatic" | "on_demand" | "unavailable";
129
+ updates_capability: "automatic" | "on_demand" | "unavailable";
130
+ write_capabilities: {
131
+ submission: "automatic" | "explicit_only" | "unavailable";
132
+ correction: "automatic" | "explicit_only" | "unavailable";
133
+ withdrawal: "explicit_only" | "unavailable";
134
+ };
135
+ approval_persistence: {
136
+ read: "promptless" | "host_prompts_may_repeat" | "unsupported";
137
+ write: "promptless" | "host_prompts_may_repeat" | "unsupported";
138
+ };
139
+ actions_required: {
140
+ code: "client_choice" | "repair" | "mcp_server_trust" | "lifecycle_hook_trust" | "client_restart";
141
+ target: ReturnType<typeof selectionOption> | null;
142
+ }[];
143
+ limitations: ("runtime_not_durable" | "host_approval_may_repeat" | "lifecycle_unsupported" | "local_sessions_only" | "cold_start_unverified")[];
144
+ runtime_health: "healthy" | "lookup_degraded" | "auth_degraded" | "server_unavailable";
145
+ completion_notice: {
146
+ notice_id: string;
147
+ copy_variant: string;
148
+ status: "pending" | "leased" | "acknowledged";
149
+ } | null;
150
+ }[];
151
+ freshness: {
152
+ public_controls: Freshness;
153
+ installation_controls: Freshness;
154
+ release_manifest: {
155
+ state: Freshness["state"];
156
+ observed_at: string | null;
157
+ sequence: number | null;
158
+ minimum_supported_version: string | null;
159
+ recommended_version: string | null;
160
+ update_available: boolean | null;
161
+ };
162
+ };
163
+ };
164
+ export declare function readStatus(client: VectleClient, config: VectleConfig, token: string | null, options?: StatusOptions): Promise<{
165
+ schema_version: "vectle-status-v2";
166
+ selected: "none" | "all" | "family" | "current_integration";
167
+ selection: {
168
+ schema_version: "client-selection-v1";
169
+ status: "not_required" | "none_detected";
170
+ reason: "all_requested" | "no_supported_client";
171
+ options: never[];
172
+ } | {
173
+ schema_version: "client-selection-v1";
174
+ status: "not_required";
175
+ reason: "all_requested";
176
+ options: {
177
+ client_family: import("./integrations.js").SupportedClientFamily;
178
+ profile_label: string;
179
+ adapter_entry_id: string;
180
+ }[];
181
+ } | {
182
+ schema_version: "client-selection-v1";
183
+ status: "selected";
184
+ reason: "explicit_family";
185
+ options: {
186
+ client_family: import("./integrations.js").SupportedClientFamily;
187
+ profile_label: string;
188
+ adapter_entry_id: string;
189
+ }[];
190
+ } | {
191
+ schema_version: "client-selection-v1";
192
+ status: "choice_required";
193
+ reason: "same_family_multiple_profiles";
194
+ options: {
195
+ client_family: import("./integrations.js").SupportedClientFamily;
196
+ profile_label: string;
197
+ adapter_entry_id: string;
198
+ }[];
199
+ } | {
200
+ schema_version: "client-selection-v1";
201
+ status: "selected";
202
+ reason: "managed_invocation";
203
+ options: {
204
+ client_family: import("./integrations.js").SupportedClientFamily;
205
+ profile_label: string;
206
+ adapter_entry_id: string;
207
+ }[];
208
+ };
209
+ installation: {
210
+ configured: boolean;
211
+ local_mode: import("./store.js").LocalMode;
212
+ consent_state: "revocation_pending" | "legacy_v1" | "not_connected" | "revoked" | "active_v2";
213
+ approved_behavior_ceiling: {
214
+ authority: "current";
215
+ consent_version: 2;
216
+ startup_pulse: "automatic" | "on_demand";
217
+ sharing_and_correction: "automatic" | "explicit_only";
218
+ } | null;
219
+ actions_required: {
220
+ code: "new_setup";
221
+ target: null;
222
+ }[] | {
223
+ code: "consent_upgrade";
224
+ target: null;
225
+ }[] | {
226
+ code: "finish_server_revocation";
227
+ target: null;
228
+ }[];
229
+ };
230
+ aggregate: {
231
+ configured_integrations: number;
232
+ verified_full_lifecycle: number;
233
+ automatic_lookup_integrations: number;
234
+ automatic_update_integrations: number;
235
+ automatic_submission_integrations: number;
236
+ automatic_correction_integrations: number;
237
+ integrations_needing_action: number;
238
+ };
239
+ integrations: {
240
+ adapter_entry_id: string;
241
+ client_family: import("./integrations.js").SupportedClientFamily;
242
+ profile_label: string;
243
+ integration_capability: "full_lifecycle" | "policy_and_mcp" | "mcp_only" | "authorized_only" | "disconnected" | "conflict";
244
+ startup_invocation_policy: "off" | "on_demand" | "automatic_guard";
245
+ sharing_invocation_policy: "off" | "explicit_only" | "automatic_guard";
246
+ lookup_capability: "automatic" | "on_demand" | "unavailable";
247
+ updates_capability: "automatic" | "on_demand" | "unavailable";
248
+ write_capabilities: {
249
+ submission: "automatic" | "explicit_only" | "unavailable";
250
+ correction: "automatic" | "explicit_only" | "unavailable";
251
+ withdrawal: "explicit_only" | "unavailable";
252
+ };
253
+ approval_persistence: {
254
+ read: "promptless" | "host_prompts_may_repeat" | "unsupported";
255
+ write: "promptless" | "host_prompts_may_repeat" | "unsupported";
256
+ };
257
+ actions_required: {
258
+ code: "client_choice" | "repair" | "mcp_server_trust" | "lifecycle_hook_trust" | "client_restart";
259
+ target: ReturnType<typeof selectionOption> | null;
260
+ }[];
261
+ limitations: ("runtime_not_durable" | "host_approval_may_repeat" | "lifecycle_unsupported" | "local_sessions_only" | "cold_start_unverified")[];
262
+ runtime_health: "healthy" | "lookup_degraded" | "auth_degraded" | "server_unavailable";
263
+ completion_notice: {
264
+ notice_id: string;
265
+ copy_variant: string;
266
+ status: "pending" | "leased" | "acknowledged";
267
+ } | null;
268
+ }[];
269
+ freshness: {
270
+ public_controls: Freshness;
271
+ installation_controls: Freshness;
272
+ release_manifest: {
273
+ state: Freshness["state"];
274
+ observed_at: string | null;
275
+ sequence: number | null;
276
+ minimum_supported_version: string | null;
277
+ recommended_version: string | null;
278
+ update_available: boolean | null;
279
+ };
280
+ };
281
+ }>;
282
+ export {};
package/dist/status.js ADDED
@@ -0,0 +1,213 @@
1
+ import { CLI_VERSION } from './constants.js';
2
+ import { compareVersions } from './release.js';
3
+ import { fetchReleaseManifest } from './release-manifest.js';
4
+ import { loadAgentState } from './state.js';
5
+ import { localStateRoot } from './delivery.js';
6
+ import { localMode } from './modes.js';
7
+ import { loadIntegrationManifest } from './integrations.js';
8
+ import { readHookState } from './lifecycle.js';
9
+ const clientFamilies = new Set(['codex', 'claude_code', 'cursor', 'vscode', 'terminal', 'unknown']);
10
+ function timestamp(value) { return typeof value === 'string' && Number.isFinite(Date.parse(value)) ? value : null; }
11
+ function fresh(value, now = Date.now()) {
12
+ const observed = timestamp(value?.observed_at);
13
+ const expires = timestamp(value?.expires_at);
14
+ if (!observed || !expires || Date.parse(expires) <= now || Date.parse(expires) > Date.parse(observed) + 5 * 60_000)
15
+ return { state: value ? 'unavailable' : 'unchecked', observed_at: null };
16
+ return { state: 'live', observed_at: observed };
17
+ }
18
+ function publicEnabled(value, freshness) {
19
+ return freshness.state === 'live' && value?.operations?.startup_lookup?.status === 'enabled';
20
+ }
21
+ function operation(value, name, field, freshness) {
22
+ if (freshness.state !== 'live')
23
+ return 'unsupported';
24
+ const raw = value?.operations?.[name]?.[field];
25
+ return raw === 'enabled' || raw === 'disabled' || raw === 'not_authorized' || raw === 'insufficient_scope' || raw === 'unsupported' ? raw : 'unsupported';
26
+ }
27
+ function selectionOption(entry) {
28
+ return { client_family: entry.client_family, profile_label: entry.profile_label, adapter_entry_id: entry.adapter_entry_id };
29
+ }
30
+ function noSelection(reason = 'no_supported_client') {
31
+ return { schema_version: 'client-selection-v1', status: reason === 'all_requested' ? 'not_required' : 'none_detected', reason, options: [] };
32
+ }
33
+ function consentState(config) {
34
+ if (!config.installation)
35
+ return config.contributorId ? 'legacy_v1' : 'not_connected';
36
+ if (localMode(config) === 'revocation_pending')
37
+ return 'revocation_pending';
38
+ if (localMode(config) === 'off')
39
+ return 'revoked';
40
+ return config.installation.consent_version === 2 ? 'active_v2' : 'legacy_v1';
41
+ }
42
+ function ceiling(config) {
43
+ if (!config.installation)
44
+ return null;
45
+ return {
46
+ authority: 'current',
47
+ consent_version: config.installation.consent_version,
48
+ startup_pulse: config.installation.automatic_lookup ? 'automatic' : 'on_demand',
49
+ sharing_and_correction: config.installation.automatic_sharing ? 'automatic' : 'explicit_only',
50
+ };
51
+ }
52
+ function effectiveSelection(config, manifest, requested) {
53
+ const entries = manifest.entries;
54
+ if (requested === 'all')
55
+ return { selected: 'all', selection: { schema_version: 'client-selection-v1', status: 'not_required', reason: 'all_requested', options: entries.map(selectionOption) } };
56
+ if (requested && requested !== 'auto' && clientFamilies.has(requested)) {
57
+ const matches = entries.filter(entry => entry.client_family === requested);
58
+ if (matches.length === 1)
59
+ return { selected: 'family', selection: { schema_version: 'client-selection-v1', status: 'selected', reason: 'explicit_family', options: matches.map(selectionOption) } };
60
+ if (matches.length > 1)
61
+ return { selected: 'none', selection: { schema_version: 'client-selection-v1', status: 'choice_required', reason: 'same_family_multiple_profiles', options: matches.map(selectionOption).slice(0, 8) } };
62
+ return { selected: 'none', selection: noSelection('no_supported_client') };
63
+ }
64
+ if (entries.length === 1)
65
+ return { selected: 'current_integration', selection: { schema_version: 'client-selection-v1', status: 'selected', reason: 'managed_invocation', options: entries.map(selectionOption) } };
66
+ if (entries.length > 1)
67
+ return { selected: 'all', selection: { schema_version: 'client-selection-v1', status: 'not_required', reason: 'all_requested', options: entries.map(selectionOption) } };
68
+ return { selected: 'none', selection: noSelection() };
69
+ }
70
+ function integrationStatus(config, entry, publicValue, publicFreshness, installValue, installFreshness, releaseEligible = false) {
71
+ const mode = localMode(config);
72
+ const installation = config.installation;
73
+ const marker = config.stateRoot ? readHookState(config.stateRoot, entry.adapter_entry_id) : null;
74
+ const markerReady = Boolean(marker && marker.client_family === entry.client_family && marker.integration_manifest_digest === entry.integration_binding_digest && marker.policy_checksum === entry.policy_checksum && Date.parse(marker.executed_at) >= Date.parse(entry.updated_at));
75
+ const effectiveCapability = markerReady ? 'full_lifecycle' : entry.integration_capability;
76
+ const hostReady = effectiveCapability === 'full_lifecycle';
77
+ const readTransport = effectiveCapability !== 'disconnected' && effectiveCapability !== 'conflict';
78
+ const lookupAutomatic = Boolean(installation?.automatic_lookup) && hostReady && (mode === 'active' || mode === 'read-only') && publicEnabled(publicValue, publicFreshness) && releaseEligible;
79
+ const lookup = !readTransport || mode === 'paused' || mode === 'off' ? 'unavailable' : lookupAutomatic ? 'automatic' : 'on_demand';
80
+ const updatesStatus = operation(installValue, 'hive_updates', 'automatic_status', installFreshness);
81
+ const updatesAutomatic = Boolean(installation?.automatic_lookup) && hostReady && (mode === 'active' || mode === 'read-only') && updatesStatus === 'enabled' && releaseEligible;
82
+ const updates = !readTransport || mode === 'paused' || mode === 'off' ? 'unavailable' : updatesAutomatic ? 'automatic' : 'on_demand';
83
+ const explicitSubmit = operation(installValue, 'finding_submit', 'explicit_status', installFreshness) === 'enabled' && mode === 'active' && Boolean(installation);
84
+ const automaticSubmit = explicitSubmit && Boolean(installation?.automatic_sharing) && hostReady && operation(installValue, 'automatic_finding_submit', 'automatic_status', installFreshness) === 'enabled' && releaseEligible;
85
+ const explicitCorrection = operation(installValue, 'finding_correction', 'explicit_status', installFreshness) === 'enabled' && Boolean(installation);
86
+ const automaticCorrection = explicitCorrection && Boolean(installation?.automatic_sharing) && hostReady && operation(installValue, 'automatic_finding_correction', 'automatic_status', installFreshness) === 'enabled' && releaseEligible;
87
+ const withdrawal = operation(installValue, 'content_withdraw', 'explicit_status', installFreshness) === 'enabled' && Boolean(installation) ? 'explicit_only' : 'unavailable';
88
+ const readPolicy = lookupAutomatic ? 'promptless' : hostReady ? 'host_prompts_may_repeat' : 'unsupported';
89
+ const writePolicy = automaticSubmit || automaticCorrection ? 'promptless' : hostReady ? 'host_prompts_may_repeat' : 'unsupported';
90
+ const actions = [];
91
+ const limitations = [];
92
+ if (effectiveCapability === 'mcp_only')
93
+ limitations.push('lifecycle_unsupported');
94
+ if (effectiveCapability === 'policy_and_mcp' && !markerReady) {
95
+ actions.push({ code: 'lifecycle_hook_trust', target: selectionOption(entry) });
96
+ actions.push({ code: 'client_restart', target: selectionOption(entry) });
97
+ }
98
+ if (effectiveCapability === 'authorized_only')
99
+ actions.push({ code: 'repair', target: selectionOption(entry) });
100
+ if (effectiveCapability === 'conflict')
101
+ actions.push({ code: 'repair', target: selectionOption(entry) });
102
+ const runtimeHealth = publicFreshness.state === 'unavailable' && installFreshness.state === 'unavailable' ? 'server_unavailable' : installFreshness.state === 'unavailable' && installation ? 'auth_degraded' : publicFreshness.state === 'unavailable' ? 'lookup_degraded' : 'healthy';
103
+ let completionNotice = null;
104
+ try {
105
+ const state = loadAgentState(localStateRoot(config));
106
+ const notice = state.pending_notices.find(item => item.schema_version === 'completion-notice-v1' && typeof item.notice_id === 'string');
107
+ if (notice)
108
+ completionNotice = { notice_id: notice.notice_id, copy_variant: notice.copy_variant ?? 'integration_verified', status: notice.status ?? (notice.pending === false ? 'acknowledged' : 'pending') };
109
+ }
110
+ catch { /* local status remains truthful without an optional notice */ }
111
+ return {
112
+ adapter_entry_id: entry.adapter_entry_id,
113
+ client_family: entry.client_family,
114
+ profile_label: entry.profile_label,
115
+ integration_capability: effectiveCapability,
116
+ startup_invocation_policy: mode === 'paused' || mode === 'off' || !readTransport ? 'off' : hostReady ? 'automatic_guard' : 'on_demand',
117
+ sharing_invocation_policy: mode === 'active' && hostReady && installation?.automatic_sharing ? 'automatic_guard' : mode === 'active' && explicitSubmit ? 'explicit_only' : 'off',
118
+ lookup_capability: lookup,
119
+ updates_capability: updates,
120
+ write_capabilities: { submission: mode !== 'active' || !explicitSubmit ? 'unavailable' : automaticSubmit ? 'automatic' : 'explicit_only', correction: !explicitCorrection ? 'unavailable' : automaticCorrection ? 'automatic' : 'explicit_only', withdrawal },
121
+ approval_persistence: { read: readPolicy, write: writePolicy },
122
+ actions_required: actions,
123
+ limitations,
124
+ runtime_health: runtimeHealth,
125
+ completion_notice: completionNotice,
126
+ };
127
+ }
128
+ export async function readDoctorServices(client, releaseMetadata, local, cliVersion = CLI_VERSION) {
129
+ if (local) {
130
+ return [
131
+ { status: 'fulfilled', value: { status: 'unchecked' } },
132
+ { status: 'fulfilled', value: null },
133
+ ];
134
+ }
135
+ const manifestVersion = compareVersions(cliVersion, '1.1.0');
136
+ if (manifestVersion !== null && manifestVersion >= 0) {
137
+ return Promise.allSettled([
138
+ client.health(true),
139
+ Promise.resolve(releaseMetadata),
140
+ ]);
141
+ }
142
+ return Promise.allSettled([
143
+ client.health(true),
144
+ client.latestRelease(true),
145
+ ]);
146
+ }
147
+ export function buildLocalStatus(config, options = {}) {
148
+ const manifest = options.manifest ?? loadIntegrationManifest(config.stateRoot);
149
+ const selected = effectiveSelection(config, manifest, options.clientFamily);
150
+ const publicValue = options.publicCapability ?? null;
151
+ const installValue = options.installationCapability ?? null;
152
+ const publicFreshness = options.local ? { state: 'unchecked', observed_at: null } : fresh(publicValue);
153
+ const installFreshness = options.local ? { state: 'unchecked', observed_at: null } : fresh(installValue);
154
+ const integrations = manifest.entries.map(entry => integrationStatus(config, entry, publicValue, publicFreshness, installValue, installFreshness, options.releaseEligible ?? false));
155
+ const mode = localMode(config);
156
+ const consent = consentState(config);
157
+ const authority = config.installation ? ceiling(config) : null;
158
+ const installationActions = consent === 'not_connected' ? [{ code: 'new_setup', target: null }] : consent === 'legacy_v1' ? [{ code: 'consent_upgrade', target: null }] : mode === 'revocation_pending' ? [{ code: 'finish_server_revocation', target: null }] : [];
159
+ return {
160
+ schema_version: 'vectle-status-v2',
161
+ selected: selected.selected,
162
+ selection: selected.selection,
163
+ installation: { configured: Boolean(config.installation), local_mode: mode, consent_state: consent, approved_behavior_ceiling: authority, actions_required: installationActions },
164
+ aggregate: {
165
+ configured_integrations: integrations.length,
166
+ verified_full_lifecycle: integrations.filter(item => item.integration_capability === 'full_lifecycle').length,
167
+ automatic_lookup_integrations: integrations.filter(item => item.lookup_capability === 'automatic').length,
168
+ automatic_update_integrations: integrations.filter(item => item.updates_capability === 'automatic').length,
169
+ automatic_submission_integrations: integrations.filter(item => item.write_capabilities.submission === 'automatic').length,
170
+ automatic_correction_integrations: integrations.filter(item => item.write_capabilities.correction === 'automatic').length,
171
+ integrations_needing_action: integrations.filter(item => item.actions_required.length > 0).length,
172
+ },
173
+ integrations,
174
+ freshness: {
175
+ public_controls: publicFreshness,
176
+ installation_controls: installFreshness,
177
+ release_manifest: options.releaseMetadata ?? { state: options.releaseEligible ? 'live' : 'unchecked', observed_at: options.releaseEligible ? new Date().toISOString() : null, sequence: null, minimum_supported_version: null, recommended_version: null, update_available: null },
178
+ },
179
+ };
180
+ }
181
+ export async function readStatus(client, config, token, options = {}) {
182
+ if (options.local)
183
+ return buildLocalStatus(config, { ...options, local: true });
184
+ const manifestVersion = compareVersions(CLI_VERSION, '1.1.0');
185
+ const [publicResult, diagnosticResult, releaseResult] = await Promise.allSettled([
186
+ client.anonymousCapabilities(1_000),
187
+ token && config.schema_version === 'vectle-config-v2' ? client.diagnostic(token, 1_000) : Promise.resolve(null),
188
+ manifestVersion !== null && manifestVersion >= 0 ? fetchReleaseManifest(config.endpoint, localStateRoot(config), { persist: false }) : Promise.resolve(null),
189
+ ]);
190
+ const publicCapability = publicResult.status === 'fulfilled' ? publicResult.value : null;
191
+ let installationCapability = null;
192
+ if (diagnosticResult.status === 'fulfilled' && diagnosticResult.value && typeof diagnosticResult.value === 'object') {
193
+ const diagnostic = diagnosticResult.value;
194
+ installationCapability = diagnostic.capabilities && typeof diagnostic.capabilities === 'object' ? diagnostic.capabilities : null;
195
+ }
196
+ let releaseMetadata = null;
197
+ let releaseEligible = false;
198
+ if (releaseResult.status === 'fulfilled' && releaseResult.value && typeof releaseResult.value === 'object') {
199
+ const result = releaseResult.value;
200
+ const envelope = result.envelope;
201
+ const manifest = envelope?.manifest;
202
+ const currentSupported = manifest ? compareVersions(CLI_VERSION, manifest.minimum_supported_cli) : null;
203
+ const blocked = Boolean(manifest?.blocked_artifacts.some(item => item.artifact_kind === 'cli_package' && item.version === CLI_VERSION && item.platform === 'any' && item.architecture === 'any'));
204
+ releaseEligible = Boolean(envelope && (result.state === 'live' || result.state === 'cached') && currentSupported !== null && currentSupported >= 0 && !blocked);
205
+ const comparison = manifest ? compareVersions(CLI_VERSION, manifest.recommended_cli) : null;
206
+ releaseMetadata = { state: result.state, observed_at: releaseEligible ? new Date().toISOString() : null, sequence: manifest?.sequence ?? null, minimum_supported_version: manifest?.minimum_supported_cli ?? null, recommended_version: manifest?.recommended_cli ?? null, update_available: comparison === null ? null : comparison < 0 };
207
+ }
208
+ else if (manifestVersion !== null && manifestVersion >= 0) {
209
+ releaseMetadata = { state: 'unavailable', observed_at: null, sequence: null, minimum_supported_version: null, recommended_version: null, update_available: null };
210
+ }
211
+ return buildLocalStatus(config, { ...options, publicCapability, installationCapability, releaseEligible, releaseMetadata });
212
+ }
213
+ //# sourceMappingURL=status.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"status.js","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"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"}
package/dist/store.d.ts CHANGED
@@ -1,24 +1,66 @@
1
+ import { type InstallationCredentialBackend, type SecureBackend, type SecurePurpose } from './secure-store.js';
1
2
  export type ClientFamily = 'codex' | 'claude_code' | 'cursor' | 'vscode' | 'terminal' | 'unknown';
3
+ export type LocalMode = 'unconfigured' | 'active' | 'read-only' | 'paused' | 'revocation_pending' | 'off';
4
+ export type CredentialBackend = 'keychain' | 'file' | 'environment';
5
+ export type V2Installation = {
6
+ support_code: string;
7
+ approved_api_origin: string;
8
+ credential_backend: InstallationCredentialBackend;
9
+ credential_account_handle: string;
10
+ consent_version: 2;
11
+ consented_scopes: string[];
12
+ consent_policy_digest: string;
13
+ approved_at: string;
14
+ automatic_lookup: boolean;
15
+ automatic_sharing: boolean;
16
+ };
2
17
  export type VectleConfig = {
18
+ schema_version?: 'vectle-config-v2';
3
19
  endpoint: string;
4
20
  contributorId?: string;
5
21
  displayName?: string;
6
22
  identityScope?: 'project' | 'global';
7
23
  clientFamily: ClientFamily;
8
24
  queryAnalytics: boolean;
9
- credentialBackend?: 'keychain' | 'file' | 'environment';
25
+ operationalAnalytics?: boolean;
26
+ query_analytics?: boolean;
27
+ operational_analytics?: boolean;
28
+ mode?: LocalMode;
29
+ rollout_seed?: string;
30
+ installation?: V2Installation | null;
31
+ adapterEntryId?: string;
32
+ integrationBindingDigest?: string;
33
+ policyChecksum?: string;
34
+ stateRoot?: string;
35
+ credentialBackend?: CredentialBackend;
10
36
  authorizationMode?: 'standing' | 'per_write';
11
37
  authorizationExpiresAt?: string;
12
38
  lastUpdateNoticeVersion?: string;
13
39
  lastUpdateNoticeAt?: string;
40
+ /** Internal, local-only fields. They are never written by the v2 serializer. */
41
+ config_source?: 'legacy_v1' | 'v2';
42
+ configCorrupt?: boolean;
14
43
  };
15
44
  export declare function configDirectory(): string;
16
45
  export declare function configPath(): string;
17
46
  export declare function defaultConfig(): VectleConfig;
18
47
  export declare function loadConfig(): VectleConfig;
48
+ /**
49
+ * Read the minimal v2 config projection bound to an explicit state root.
50
+ * Managed MCP and lifecycle processes use this instead of trusting an
51
+ * ambient VECTLE_CONFIG_DIR selected by the host.
52
+ */
53
+ export declare function loadBoundConfig(root: string): VectleConfig | null;
19
54
  export declare function saveConfig(config: VectleConfig): void;
20
55
  export declare function keychainAvailable(): "keychain" | "file" | "environment" | null;
21
56
  export declare function storeCredential(token: string, allowFileFallback?: boolean): VectleConfig['credentialBackend'];
22
57
  export declare function readCredential(): string | null;
23
58
  export declare function deleteCredential(): void;
24
- export declare function credentialBackendDescription(): "keychain" | "file" | "environment" | "environment override" | "not configured";
59
+ export declare function credentialBackendDescription(): CredentialBackend | "environment override" | "not configured";
60
+ export declare function installationCredentialAccount(config: Pick<VectleConfig, 'endpoint' | 'installation'>): string;
61
+ export declare function storeInstallationCredential(token: string, config: Pick<VectleConfig, 'endpoint' | 'installation'>, allowFileFallback?: boolean): InstallationCredentialBackend;
62
+ export declare function readInstallationCredential(config: Pick<VectleConfig, 'endpoint' | 'installation'>): string | null;
63
+ export declare function deleteInstallationCredential(config: Pick<VectleConfig, 'endpoint' | 'installation'>): void;
64
+ export declare function storeTransientCredential(secret: string, config: Pick<VectleConfig, 'endpoint' | 'installation'>, purpose: SecurePurpose, operationId: string, expiresAt: string, allowFileFallback?: boolean): import("./secure-store.js").SecureStoreHandle;
65
+ export declare function readTransientCredential(config: Pick<VectleConfig, 'endpoint' | 'installation'>, purpose: SecurePurpose, operationId: string, backend?: SecureBackend): string | null;
66
+ export declare function deleteTransientCredential(config: Pick<VectleConfig, 'endpoint' | 'installation'>, purpose: SecurePurpose, operationId: string, backend?: SecureBackend): void;