Merge commit 'd803bfe2b1fe7f5e219e50ac20d6801a0a58ac75' as 'vendor/ruvector'

vendor/ruvector/npm/packages/cognitum-gate-wasm/examples/basic-usage.js

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * Basic Coherence Gate Usage - TypeScript Example
+ *
+ * This example demonstrates:
+ * - Initializing the gate
+ * - Requesting action permission
+ * - Handling decisions
+ *
+ * Run with: npx ts-node examples/basic-usage.ts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const gate_1 = require("@cognitum/gate");
+async function main() {
+    console.log('=== Cognitum Gate - Basic Usage ===\n');
+    // Initialize the gate
+    const gate = await gate_1.CognitumGate.init({
+        thresholds: {
+            minCut: 10.0,
+            maxShift: 0.5,
+            eDeny: 0.01,
+            ePermit: 100.0,
+        },
+        storage: 'memory', // Use 'indexeddb' for persistence
+    });
+    console.log('Gate initialized\n');
+    // Define an action
+    const action = {
+        actionId: 'deploy-v2.1.0',
+        actionType: 'deployment',
+        agentId: 'ci-agent',
+        target: 'production-cluster',
+        metadata: {
+            version: '2.1.0',
+            changedFiles: 42,
+        },
+    };
+    console.log('Requesting permission for:', action.actionId);
+    // Request permission
+    const result = await gate.permitAction(action);
+    // Handle the decision
+    switch (result.decision) {
+        case gate_1.GateDecision.Permit:
+            console.log('\n✅ PERMITTED');
+            console.log('Token:', result.token.slice(0, 50) + '...');
+            console.log('Valid until:', new Date(result.validUntilNs / 1000000).toISOString());
+            // Agent can now proceed with the action
+            await performDeployment(action, result.token);
+            break;
+        case gate_1.GateDecision.Defer:
+            console.log('\n⏸️  DEFERRED - Human review required');
+            console.log('Reason:', result.reason);
+            console.log('Escalation URL:', result.escalation?.contextUrl);
+            // Wait for human decision or timeout
+            const humanDecision = await waitForHumanDecision(result.receiptSequence);
+            if (humanDecision.approved) {
+                await performDeployment(action, humanDecision.token);
+            }
+            break;
+        case gate_1.GateDecision.Deny:
+            console.log('\n❌ DENIED');
+            console.log('Reason:', result.reason);
+            console.log('Witness:', result.witness);
+            // Log the denial for review
+            await logDeniedAction(action, result);
+            break;
+    }
+    // Audit: Get the receipt
+    const receipt = await gate.getReceipt(result.receiptSequence);
+    console.log('\nReceipt hash:', receipt.hash.slice(0, 16) + '...');
+    console.log('\n=== Example Complete ===');
+}
+async function performDeployment(action, token) {
+    console.log(`\nDeploying ${action.metadata?.version} to ${action.target}...`);
+    console.log('(Deployment would happen here with token validation)');
+}
+async function waitForHumanDecision(sequence) {
+    console.log(`\nWaiting for human decision on sequence ${sequence}...`);
+    // In production, this would poll an API or use WebSocket
+    return { approved: true, token: 'human-approved-token' };
+}
+async function logDeniedAction(action, result) {
+    console.log(`\nLogging denied action: ${action.actionId}`);
+    // In production, send to logging/alerting system
+}
+main().catch(console.error);
+//# sourceMappingURL=basic-usage.js.map