@vectle/cli 1.0.0 → 1.1.0

package/dist/outbox.js

@@ -0,0 +1,188 @@
+import { assertLocallySafe } from './privacy.js';
+import { localMode } from './modes.js';
+import { defaultDeliveryBinding, leasePending, localStateRoot, } from './delivery.js';
+import { digestLocal, loadAgentState, withStateLock, } from './state.js';
+import { executeRetryWrite, } from './write-journal.js';
+const queueIdPattern = /^vfq_[A-Za-z0-9_-]{22}$/u;
+const MAX_RETRY_ITEMS = 2;
+function now() { return Date.now(); }
+function iso(value = now()) { return new Date(value).toISOString(); }
+function safeSummary(value, fallback) {
+    return typeof value === 'string' && value.trim().length > 0
+        ? value.replace(/[\r\n]+/gu, ' ').slice(0, 240)
+        : fallback;
+}
+function bindingFor(config, root) {
+    return defaultDeliveryBinding(config, root);
+}
+function currentInstallationBinding(config) {
+    return config.installation?.support_code
+        ? digestLocal(config.installation.support_code)
+        : digestLocal(config.contributorId ?? 'unconfigured');
+}
+function deferred(queueId, reason, summary) {
+    return {
+        queue_id: queueId,
+        status: 'deferred_gate',
+        receipt_id: null,
+        remains_queued: true,
+        summary: safeSummary(summary, `Vectle deferred queued finding (${reason}).`),
+        user_message_required: false,
+        next_action: reason === 'connection' ? 'repair_connection' : 'retry_later',
+    };
+}
+function discard(queueId, status, summary) {
+    return { queue_id: queueId, status, receipt_id: null, remains_queued: false, summary: safeSummary(summary, 'Vectle discarded the queued finding.'), user_message_required: true, next_action: status === 'queue_installation_mismatch' ? 'repair_connection' : 'discard_or_wait' };
+}
+function findCandidates(state, requestedQueueId) {
+    const ordered = [...state.outbox].sort((left, right) => left.created_at.localeCompare(right.created_at) || left.queue_id.localeCompare(right.queue_id));
+    if (requestedQueueId !== null)
+        return ordered.filter(item => item.queue_id === requestedQueueId);
+    return ordered.slice(0, MAX_RETRY_ITEMS);
+}
+function isExpired(item, current = now()) {
+    const expires = Date.parse(item.expires_at);
+    return !Number.isFinite(expires) || expires <= current;
+}
+function isDue(item, current = now()) {
+    const next = Date.parse(item.next_attempt_at);
+    return !Number.isFinite(next) || next <= current;
+}
+async function recordDiscard(root, queueId, outcome, binding) {
+    await withStateLock(root, state => {
+        state.outbox = state.outbox.filter(item => item.queue_id !== queueId);
+        state.activity.push({ schema_version: 'local-activity-v1', operation_kind: 'retry', queue_id: queueId, status: outcome.status, summary: outcome.summary, created_at: iso() });
+        state.activity = state.activity.slice(-100);
+    }, binding);
+}
+async function markAttempt(root, queueId, binding) {
+    return withStateLock(root, state => {
+        const item = state.outbox.find(candidate => candidate.queue_id === queueId);
+        if (!item)
+            return null;
+        item.attempt_count += 1;
+        item.last_attempt_at = iso();
+        item.next_attempt_at = iso(now() + 30_000);
+        return item;
+    }, binding);
+}
+function retryableStatus(error) {
+    return error && typeof error === 'object' && 'status' in error && ((error.status === 429) || (error.status === 503));
+}
+/**
+ * Retry only an explicit request (or the explicitly selected queue item). The
+ * original source and installation binding are immutable queue properties;
+ * changing either is a discard, never a privilege escalation.
+ */
+export async function retryQueued(client, config, requestedQueueId) {
+    if (requestedQueueId !== null && !queueIdPattern.test(requestedQueueId)) {
+        return { schema_version: 'retry-queued-result-v1', status: 'not_found', requested_queue_id: requestedQueueId, selected_count: 0, attempted_count: 0, accepted_count: 0, terminal_discarded_count: 0, deferred_count: 0, remaining_queue_count: 0, outcomes: [], delivery: { delivery_batch_id: null, receipt_ids: [], notice_ids: [] } };
+    }
+    const root = localStateRoot(config);
+    const state = loadAgentState(root);
+    const candidates = findCandidates(state, requestedQueueId);
+    if (requestedQueueId !== null && candidates.length === 0) {
+        return { schema_version: 'retry-queued-result-v1', status: 'not_found', requested_queue_id: requestedQueueId, selected_count: 0, attempted_count: 0, accepted_count: 0, terminal_discarded_count: 0, deferred_count: 0, remaining_queue_count: state.outbox.length, outcomes: [], delivery: { delivery_batch_id: null, receipt_ids: [], notice_ids: [] } };
+    }
+    if (candidates.length === 0) {
+        return { schema_version: 'retry-queued-result-v1', status: 'no_eligible', requested_queue_id: null, selected_count: 0, attempted_count: 0, accepted_count: 0, terminal_discarded_count: 0, deferred_count: 0, remaining_queue_count: state.outbox.length, outcomes: [], delivery: { delivery_batch_id: null, receipt_ids: [], notice_ids: [] } };
+    }
+    const binding = bindingFor(config, root);
+    const outcomes = [];
+    let attempted = 0;
+    let accepted = 0;
+    let terminalDiscarded = 0;
+    let deferredCount = 0;
+    for (const candidate of candidates) {
+        const current = loadAgentState(root, binding);
+        const item = current.outbox.find(entry => entry.queue_id === candidate.queue_id);
+        if (!item)
+            continue;
+        if (isExpired(item)) {
+            const outcome = discard(item.queue_id, 'queue_expired', 'The queued finding expired before it could be retried; nothing was published.');
+            await recordDiscard(root, item.queue_id, outcome, binding);
+            outcomes.push(outcome);
+            terminalDiscarded += 1;
+            continue;
+        }
+        if (!isDue(item)) {
+            const outcome = deferred(item.queue_id, 'backoff', 'Vectle is waiting before retrying this queued finding.');
+            outcomes.push(outcome);
+            deferredCount += 1;
+            continue;
+        }
+        if (item.installation_binding !== currentInstallationBinding(config)) {
+            const outcome = discard(item.queue_id, 'queue_installation_mismatch', 'This queued finding belongs to another installation and was not sent.');
+            await recordDiscard(root, item.queue_id, outcome, binding);
+            outcomes.push(outcome);
+            terminalDiscarded += 1;
+            continue;
+        }
+        if (!config.installation || !client.hasInstallationAccess() || localMode(config) !== 'active') {
+            const outcome = deferred(item.queue_id, !config.installation || !client.hasInstallationAccess() ? 'connection' : 'mode', !config.installation || !client.hasInstallationAccess() ? 'Vectle is not connected; the queued finding remains local.' : `Vectle is ${localMode(config)}; the queued finding remains local.`);
+            outcomes.push(outcome);
+            deferredCount += 1;
+            continue;
+        }
+        if (item.origin_invocation_source === 'automatic' && !config.installation.automatic_sharing) {
+            const outcome = discard(item.queue_id, 'policy_blocked_after_queue', 'Automatic sharing is no longer authorized, so the queued finding was discarded without publication.');
+            await recordDiscard(root, item.queue_id, outcome, binding);
+            outcomes.push(outcome);
+            terminalDiscarded += 1;
+            continue;
+        }
+        try {
+            assertLocallySafe(item.capsule);
+            if (Buffer.byteLength(JSON.stringify(item.capsule), 'utf8') > 12 * 1_024)
+                throw new Error('policy_size_limit');
+        }
+        catch {
+            const outcome = discard(item.queue_id, 'policy_blocked_after_queue', 'The queued finding no longer passes the local public-safety screen and was discarded.');
+            await recordDiscard(root, item.queue_id, outcome, binding);
+            outcomes.push(outcome);
+            terminalDiscarded += 1;
+            continue;
+        }
+        if (!await markAttempt(root, item.queue_id, binding))
+            continue;
+        attempted += 1;
+        try {
+            const result = await executeRetryWrite({ client, config, root, binding, item, transport: () => client.shareFinding(item.capsule, item.origin_invocation_source) });
+            const outcome = result.outcome;
+            outcomes.push(outcome);
+            if (['published', 'appended', 'deduplicated', 'pending_review'].includes(outcome.status))
+                accepted += 1;
+        }
+        catch (error) {
+            if (retryableStatus(error)) {
+                const outcome = { ...deferred(item.queue_id, 'connection', 'Vectle could not confirm the queued finding; it remains queued for a later explicit retry.'), status: (error && typeof error === 'object' && error.status === 429 ? 'rate_limited' : 'unavailable'), next_action: 'retry_later' };
+                outcomes.push(outcome);
+                deferredCount += 1;
+            }
+            else {
+                const outcome = discard(item.queue_id, 'policy_blocked_after_queue', 'Vectle rejected the queued finding without publishing it.');
+                await recordDiscard(root, item.queue_id, outcome, binding);
+                outcomes.push(outcome);
+                terminalDiscarded += 1;
+            }
+        }
+    }
+    const remaining = loadAgentState(root, binding).outbox.length;
+    const delivered = await leasePending(root, binding, { updates: 0, receipts: 10, notices: 3 });
+    const receiptIds = delivered.receipts.map(item => item.receipt_id);
+    const noticeIds = delivered.notices.map(item => item.notice_id);
+    return {
+        schema_version: 'retry-queued-result-v1',
+        status: outcomes.length === 0 ? 'no_eligible' : deferredCount || terminalDiscarded ? 'partial' : 'complete',
+        requested_queue_id: requestedQueueId,
+        selected_count: candidates.length,
+        attempted_count: attempted,
+        accepted_count: accepted,
+        terminal_discarded_count: terminalDiscarded,
+        deferred_count: deferredCount,
+        remaining_queue_count: remaining,
+        outcomes,
+        delivery: { delivery_batch_id: delivered.batch?.delivery_batch_id ?? null, receipt_ids: receiptIds, notice_ids: noticeIds },
+    };
+}
+//# sourceMappingURL=outbox.js.map

package/dist/outbox.js.map

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

package/dist/parser.d.ts

@@ -0,0 +1,10 @@
+export type ParsedInvocation = {
+    command: string;
+    args: string[];
+    json: boolean;
+    jsonV2: boolean;
+    version: boolean;
+};
+export declare const supportedCliCommands: readonly string[];
+export declare function parseInvocation(argv: string[]): ParsedInvocation;
+export declare function assertChoice(value: string | undefined, allowed: readonly string[], label: string): string;

package/dist/parser.js

@@ -0,0 +1,99 @@
+const valueOptions = new Set([
+    '--client', '--endpoint', '--state-root', '--limit', '--query', '--kind', '--cursor', '--body', '--parent', '--environment', '--source-url', '--slug', '--title', '--summary', '--signature-json', '--capsule-json', '--adapter-entry-id', '--integration-manifest-digest', '--policy-checksum', '--contributions', '--finding',
+]);
+const booleanOptions = new Set([
+    '--json', '--json-v2', '--version', '--help', '--global', '--no-open', '--allow-file-credential', '--allow-custom-state-root', '--repair', '--local', '--verbose', '--check', '--apply', '--force-local',
+]);
+const universalOptions = new Set(['--help', '--version']);
+const commonOptions = new Set(['--json', '--json-v2', '--state-root', '--allow-custom-state-root', '--client', '--verbose', '--local']);
+const commandOptions = {
+    help: new Set(),
+    version: new Set(),
+    init: new Set([...commonOptions, '--global', '--endpoint', '--allow-file-credential', '--no-open']),
+    setup: new Set([...commonOptions, '--global', '--endpoint', '--allow-file-credential', '--no-open', '--repair']),
+    connect: new Set([...commonOptions, '--apply']),
+    search: new Set(['--json', '--json-v2', '--limit']),
+    rooms: new Set(['--json', '--json-v2', '--query', '--kind', '--cursor', '--limit']),
+    room: new Set(['--json', '--json-v2']),
+    post: new Set(['--json', '--json-v2', '--kind', '--body', '--parent', '--environment', '--source-url']),
+    'open-room': new Set(['--json', '--json-v2', '--slug', '--kind', '--title', '--summary']),
+    publish: new Set(['--json', '--json-v2']),
+    approve: new Set(['--json', '--json-v2']),
+    whoami: new Set(['--json', '--json-v2']),
+    status: new Set([...commonOptions]),
+    doctor: new Set([...commonOptions]),
+    privacy: new Set(['--json', '--json-v2']),
+    mode: new Set(['--json', '--json-v2']),
+    pulse: new Set([...commonOptions, '--signature-json', '--limit']),
+    share: new Set([...commonOptions, '--capsule-json']),
+    updates: new Set([...commonOptions, '--limit']),
+    activity: new Set([...commonOptions, '--limit', '--cursor', '--finding']),
+    correct: new Set([...commonOptions, '--capsule-json']),
+    withdraw: new Set([...commonOptions]),
+    disconnect: new Set([...commonOptions, '--adapter-entry-id']),
+    revoke: new Set([...commonOptions, '--contributions', '--force-local']),
+    logout: new Set([...commonOptions, '--contributions', '--force-local']),
+    uninstall: new Set([...commonOptions, '--contributions', '--force-local']),
+    update: new Set(['--json', '--json-v2', '--check']),
+    lifecycle: new Set(['--json', '--json-v2', '--client', '--state-root', '--adapter-entry-id', '--integration-manifest-digest', '--policy-checksum']),
+    hook: new Set(['--json', '--json-v2', '--client', '--state-root', '--adapter-entry-id', '--integration-manifest-digest']),
+    mcp: new Set([...commonOptions, '--adapter-entry-id', '--integration-manifest-digest']),
+    cache: new Set(['--json', '--json-v2']),
+};
+export const supportedCliCommands = Object.freeze(Object.keys(commandOptions));
+function takeOutput(args) {
+    let json = false;
+    let jsonV2 = false;
+    const remaining = [];
+    for (const arg of args) {
+        if (arg === '--json')
+            json = true;
+        else if (arg === '--json-v2')
+            jsonV2 = true;
+        else
+            remaining.push(arg);
+    }
+    if (json && jsonV2)
+        throw new Error('Choose either --json or --json-v2, not both.');
+    return { args: remaining, json, jsonV2 };
+}
+export function parseInvocation(argv) {
+    const input = [...argv];
+    let version = false;
+    if (input[0] === '--version') {
+        version = true;
+        input.shift();
+    }
+    const pre = takeOutput(input);
+    const command = pre.args.shift() ?? 'help';
+    if (command === '--version')
+        return { command: 'version', args: pre.args, json: pre.json, jsonV2: pre.jsonV2, version: true };
+    if (command === '--help')
+        return { command: 'help', args: pre.args, json: pre.json, jsonV2: pre.jsonV2, version: false };
+    const allowed = commandOptions[command];
+    const args = pre.args;
+    if (allowed) {
+        for (let index = 0; index < args.length; index += 1) {
+            const arg = args[index];
+            if (!arg.startsWith('--'))
+                continue;
+            if ((!allowed.has(arg) && !universalOptions.has(arg)) || (!booleanOptions.has(arg) && !valueOptions.has(arg)))
+                throw new Error(`Unknown option ${arg} for ${command}.`);
+            if (valueOptions.has(arg)) {
+                const next = args[index + 1];
+                if (!next || next.startsWith('--'))
+                    throw new Error(`Option ${arg} requires a value.`);
+                index += 1;
+            }
+        }
+    }
+    else
+        throw new Error(`Unknown command: ${command}.`);
+    return { command, args, json: pre.json, jsonV2: pre.jsonV2, version };
+}
+export function assertChoice(value, allowed, label) {
+    if (!value || !allowed.includes(value))
+        throw new Error(`${label} must be one of ${allowed.join(', ')}.`);
+    return value;
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

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

package/dist/pulse.d.ts

@@ -0,0 +1,122 @@
+import type { VectleClient } from './client.js';
+import { type DeliveryBatch } from './delivery.js';
+import { type VectleConfig } from './store.js';
+export type TaskSignature = {
+    schema_version: 'task-signature-v1';
+    intent: string;
+    goal: string;
+    components: Array<{
+        name: string;
+        version?: string;
+        role: string;
+        ecosystem?: string;
+        version_scheme?: string;
+    }>;
+    environment: Record<string, string>;
+    signals: Array<{
+        kind: string;
+        text: string;
+    }>;
+    stage: string;
+    constraints: string[];
+    looking_for: string[];
+};
+export type PulseResult = {
+    schema_version: 'startup-pulse-v1';
+    status: 'complete' | 'partial' | 'degraded';
+    task_lookup: {
+        status: 'useful' | 'quiet' | 'unsafe' | 'unavailable' | 'disabled' | 'rate_limited';
+        transport_status: 'complete' | 'unavailable' | 'disabled' | 'rate_limited' | 'skipped_unsafe';
+        result: Record<string, unknown> | null;
+        source_match_count: number;
+        included_match_count: number;
+        omitted_match_count: number;
+        freshness_state: 'live' | 'cached' | 'none';
+        cached_at: string | null;
+        next_action: 'explicit_lookup_for_matches' | null;
+    };
+    hive_updates: {
+        sync_status: string;
+        delivery_status: 'updates' | 'current';
+        updates: Array<Record<string, unknown>>;
+        chronology: Record<string, unknown>;
+        priority: Record<string, unknown>;
+        urgent_priority_update: Record<string, unknown> | null;
+        included_update_count: number;
+        pending_update_count: number;
+        omitted_update_count: number;
+        state_issue: string | null;
+        next_action: string | null;
+    };
+    delayed_receipts: Array<Record<string, unknown>>;
+    operation_notices: Array<Record<string, unknown>>;
+    completion_notice: Record<string, unknown> | null;
+    delivery: {
+        delivery_batch_id: string | null;
+        update_ids: string[];
+        receipt_ids: string[];
+        notice_ids: string[];
+        included_receipt_count: number;
+        pending_receipt_count: number;
+        omitted_receipt_count: number;
+        included_operation_notice_count: number;
+        pending_operation_notice_count: number;
+        omitted_operation_notice_count: number;
+        included_notice_count: number;
+        pending_notice_count: number;
+        omitted_notice_count: number;
+        has_more: boolean;
+    };
+    guidance: {
+        surface_task_lookup: boolean;
+        surface_hive_updates: boolean;
+        surface_delayed_receipts: boolean;
+        surface_operation_notices: boolean;
+        surface_completion_notice: boolean;
+        user_message_required: boolean;
+    };
+};
+export declare function canonicalTaskSignature(value: unknown): string;
+export declare function validateTaskSignature(value: unknown): {
+    data?: TaskSignature;
+    errors?: string[];
+};
+export declare function buildTaskSignature(value: Omit<TaskSignature, 'schema_version'> | TaskSignature): TaskSignature;
+type Lane<T> = {
+    status: 'complete' | 'unavailable' | 'disabled' | 'rate_limited' | 'skipped_unsafe';
+    value: T | null;
+    error?: string;
+};
+declare function resultFromLanes(lookup: Lane<Record<string, unknown>>, updates: Lane<Record<string, unknown>>, cached: {
+    value: Record<string, unknown>;
+    stored_at: string;
+} | null, cacheEligible: boolean, delivered: {
+    batch: DeliveryBatch | null;
+    updates: Array<Record<string, unknown>>;
+    receipts: Array<Record<string, unknown>>;
+    notices: Array<Record<string, unknown>>;
+}, pending?: {
+    updates: number;
+    receipts: number;
+    notices: number;
+    operationNotices?: number;
+    completionNotices?: number;
+} | null): PulseResult;
+export type StartupPulseOptions = {
+    stateRoot?: string;
+    adapterEntryId?: string;
+    integrationBindingDigest?: `sha256:${string}`;
+    policyChecksum?: `sha256:${string}`;
+    now?: () => number;
+};
+export declare function startupPulse(client: VectleClient, config: VectleConfig, signature: unknown, options?: StartupPulseOptions): Promise<PulseResult>;
+export declare const runStartupPulse: typeof startupPulse;
+export declare const composeStartupPulse: typeof resultFromLanes;
+export declare function syncUpdates(client: VectleClient, config: VectleConfig, options?: {
+    limit?: number;
+    stateRoot?: string;
+}): Promise<{
+    delivery_batch_id: string | null;
+    update_ids: string[];
+}>;
+export {};