@lssm/lib.companyos-spec 3.0.2

package/dist/fixtures/v2-operating-graph.js

@@ -0,0 +1,2 @@
+// @bun
+var e={id:"companyos_operating_graph_packet_incident_brain",graphSnapshot:{id:"graph_snapshot_incident_brain_001",generatedAt:"2026-05-12T06:00:00.000Z",snapshotHash:"sha256:incident-brain-001",sourceSystems:[{id:"knowledge_incident_space",kind:"knowledge",label:"Incident Knowledge Space",connectorCapability:"knowledge.fragments.read",freshnessSla:"near_realtime",metadata:{}}],sourceRecords:[{id:"source_record_incident_runbook",sourceSystemId:"knowledge_incident_space",externalId:"fragment:incident-runbook-001",recordType:"knowledge_fragment",sourceHash:"sha256:runbook-fragment-001",observedAt:"2026-05-12T06:00:00.000Z",provenance:[{id:"evidence_incident_runbook_001",connectorCapability:"knowledge.fragments.read",observedAt:"2026-05-12T06:00:00.000Z",metadata:{}}],substrateRefs:[{id:"knowledge_fragment_ref_runbook",substrate:"knowledge",ref:"knowledge://incident/runbook/001",fragmentId:"incident-runbook-001",evidenceRefIds:["evidence_incident_runbook_001"],metadata:{}}],evidenceRefIds:["evidence_incident_runbook_001"],metadata:{}}],nodes:[{id:"node_incident_runbook",kind:"runbook",label:"Incident Brain Triage Runbook",sourceRecordRefIds:["source_record_incident_runbook"],evidenceRefIds:["evidence_incident_runbook_001"],sourceAclRefIds:["acl_incident_private"],policyRefIds:["policy_incident_operator_only"],confidence:0.94,reviewState:"reviewed",freshness:{status:"fresh",observedAt:"2026-05-12T06:00:00.000Z",expiresAt:"2026-05-13T06:00:00.000Z",evidenceRefIds:["evidence_incident_runbook_001"]},conflictRefIds:[],metadata:{}},{id:"node_incident_owner",kind:"person",label:"Incident Commander",sourceRecordRefIds:["source_record_incident_runbook"],evidenceRefIds:["evidence_incident_runbook_001"],confidence:0.88,reviewState:"review_required",freshness:{status:"fresh",observedAt:"2026-05-12T06:00:00.000Z",evidenceRefIds:["evidence_incident_runbook_001"]},sourceAclRefIds:[],policyRefIds:[],conflictRefIds:[],metadata:{}}],edges:[{id:"edge_runbook_owner",kind:"owns",fromNodeId:"node_incident_owner",toNodeId:"node_incident_runbook",sourceRecordRefIds:["source_record_incident_runbook"],evidenceRefIds:["evidence_incident_runbook_001"],confidence:0.84,reviewState:"review_required",metadata:{}}],conflicts:[],replayCursorRef:"graph_replay_cursor_incident_001",evidenceRefIds:["evidence_incident_runbook_001"],metadata:{}},identityCandidates:[{id:"identity_candidate_incident_owner",leftNodeId:"node_incident_owner",rightNodeId:"node_incident_owner",entityKind:"person",confidence:0.88,reasonCodes:["same_source_owner_label"],evidenceRefIds:["evidence_incident_runbook_001"],reviewState:"review_required"}],identityLinkDecisions:[{id:"identity_decision_incident_owner",candidateId:"identity_candidate_incident_owner",decision:"approved",canonicalNodeId:"node_incident_owner",reviewerPrincipalId:"principal_incident_commander",reviewedAt:"2026-05-12T06:00:00.000Z",reviewEvidenceRefIds:["evidence_incident_runbook_001"],destructiveMerge:!1,sourceMutationAllowed:!1}],accessRequests:[{id:"graph_access_request_incident",actorRef:{id:"authos_actor_incident_commander",substrate:"authos",ref:"authos://actors/incident-commander",actorId:"principal_incident_commander",evidenceRefIds:["evidence_incident_runbook_001"],metadata:{}},rbacDecisionRef:{id:"rbac_decision_incident_graph",substrate:"rbac",ref:"rbac://decisions/incident-graph",decisionId:"rbac_decision_incident_graph",verdict:"allow",permissionIds:["incident.graph.read"],redactedFieldRefs:[],evidenceRefIds:["evidence_incident_runbook_001"],metadata:{}},requestedNodeIds:["node_incident_runbook"],purpose:"incident triage",sourceAclRefIds:["acl_incident_private"],policyRefIds:["policy_incident_operator_only"],evidenceRefIds:["evidence_incident_runbook_001"]}],accessDecisions:[{id:"graph_access_decision_incident",requestId:"graph_access_request_incident",verdict:"allow",visibleNodeIds:["node_incident_runbook"],redactedNodeIds:[],redactedFieldRefs:[],failClosed:!0,decidedAt:"2026-05-12T06:00:00.000Z",evidenceRefIds:["evidence_incident_runbook_001"],reasons:["rbac decision allowed incident.graph.read"]}],realtimeEvents:[{id:"graph_event_incident_runbook_upsert",snapshotId:"graph_snapshot_incident_brain_001",operation:"node_upsert",sequence:1,idempotencyKey:"graph_event_incident_runbook_upsert:1",roomRef:{id:"data_room_incident_graph",substrate:"data_transmission",ref:"data-transmission://rooms/incident-graph",protocolVersion:"data-transmission.v0",roomId:"incident-graph",evidenceRefIds:["evidence_incident_runbook_001"],metadata:{},idempotencyKey:"graph_event_incident_runbook_upsert:1"},replayCursor:{id:"graph_replay_cursor_incident_001",cursor:"cursor-0001",sequence:1,lastEventId:"graph_event_incident_runbook_upsert",replayRef:"replay://incident-graph/0001"},nodeId:"node_incident_runbook",occurredAt:"2026-05-12T06:00:00.000Z",evidenceRefIds:["evidence_incident_runbook_001"]}],runbookProcedures:[{id:"runbook_procedure_incident_triage",nodeId:"node_incident_runbook",ownerPrincipalId:"principal_incident_commander",policyGateRequestId:"graph_access_request_incident",steps:[{id:"runbook_step_collect_context",title:"Collect incident context",instruction:"Review incident graph evidence before proposing action.",evidenceRefIds:["evidence_incident_runbook_001"]}],freshness:{status:"fresh",observedAt:"2026-05-12T06:00:00.000Z",expiresAt:"2026-05-13T06:00:00.000Z",evidenceRefIds:["evidence_incident_runbook_001"]},requiredPermissionDecisionIds:["graph_access_decision_incident"],evidenceRefIds:["evidence_incident_runbook_001"]}],runbookReadiness:[{id:"runbook_readiness_incident_triage",procedureId:"runbook_procedure_incident_triage",status:"ready",evaluatedAt:"2026-05-12T06:00:00.000Z",policyGateDecisionId:"graph_access_decision_incident",permissionDecisionId:"graph_access_decision_incident",blockedReasons:[],evidenceRefIds:["evidence_incident_runbook_001"]}],runbookConformanceCases:[{id:"runbook_conformance_incident_triage_ready",procedureId:"runbook_procedure_incident_triage",readinessId:"runbook_readiness_incident_triage",expectedStatus:"ready",assertion:"Fresh authorized runbook is ready without provider execution.",evidenceRefIds:["evidence_incident_runbook_001"]}],compiledAgenticArtifacts:[{id:"compiled_skill_incident_triage_v1",artifactKind:"skill_file",version:"1.0.0",artifactRef:{id:"skill://companyos/incident-triage/v1",type:"CompanyOsCompiledSkillArtifact",label:"Incident triage compiled skill"},runbookProcedureId:"runbook_procedure_incident_triage",sourceRecordRefIds:["source_record_incident_runbook"],identityDecisionIds:["identity_decision_incident_owner"],accessDecisionIds:["graph_access_decision_incident"],compiledFromBrainEntryIds:["brain_entry_incident_triage_procedure"],compilerPrincipalId:"principal_incident_commander",compiledAt:"2026-05-12T06:00:00.000Z",freshness:{status:"fresh",observedAt:"2026-05-12T06:00:00.000Z",expiresAt:"2026-05-13T06:00:00.000Z",evidenceRefIds:["evidence_incident_runbook_001"]},evidenceRefIds:["evidence_incident_runbook_001"],sourceRefs:[{id:"evidence_incident_runbook_001",connectorCapability:"knowledge.fragments.read",observedAt:"2026-05-12T06:00:00.000Z",metadata:{}}],noProviderBinding:!0,metadata:{}}],agenticReadinessChecks:[{id:"agentic_readiness_incident_triage_skill",compiledArtifactId:"compiled_skill_incident_triage_v1",runbookReadinessId:"runbook_readiness_incident_triage",status:"ready",evaluatedAt:"2026-05-12T06:00:00.000Z",sourceRecordRefIds:["source_record_incident_runbook"],identityDecisionIds:["identity_decision_incident_owner"],accessDecisionIds:["graph_access_decision_incident"],blockedReasons:[],evidenceRefIds:["evidence_incident_runbook_001"],metadata:{}}],agenticConformanceEvidence:[{id:"agentic_conformance_incident_triage_skill",compiledArtifactId:"compiled_skill_incident_triage_v1",readinessCheckId:"agentic_readiness_incident_triage_skill",runbookConformanceCaseId:"runbook_conformance_incident_triage_ready",status:"pass",assertion:"Compiled skill remains contract-only, fresh, permissioned, and conformance-ready.",checkedAt:"2026-05-12T06:00:00.000Z",replayRefIds:["graph_replay_cursor_incident_001"],executionReceiptIds:[],evidenceRefIds:["evidence_incident_runbook_001"],noRuntimeExecution:!0,metadata:{}}],agenticCorrectionOutcomeReceipts:[{id:"agentic_correction_receipt_incident_triage_skill",compiledArtifactId:"compiled_skill_incident_triage_v1",conformanceEvidenceId:"agentic_conformance_incident_triage_skill",correctionKind:"runbook_correction",status:"accepted",summary:"Operator correction accepted the triage skill as read-only until a future policy gate approves execution.",outcomeReceiptId:"outcome_incident_triage_skill_ready",observedAt:"2026-05-12T06:00:00.000Z",sourceEvidenceRefIds:["evidence_incident_runbook_001"],evidenceRefIds:["evidence_incident_runbook_001"],noProviderMutation:!0,metadata:{}}],evidenceRefIds:["evidence_incident_runbook_001"],noProductionWriteAssertion:!0};export{e as companyOsV2OperatingGraphFixture};

package/dist/fixtures/v2-voice-originated-action.d.ts

@@ -0,0 +1,22 @@
+export declare const voiceOriginatedActionFixture: {
+    id: string;
+    scenario: string;
+    origin: {
+        kind: "voice";
+        actorPrincipalId: string;
+        transcriptRef: {
+            id: string;
+            source: "voice";
+        };
+        sourceRef: {
+            id: string;
+            connectorCapability: string;
+            providerKey: string;
+            externalId: string;
+            observedAt: string;
+            metadata: {};
+        };
+        capturedAt: string;
+        metadata: {};
+    };
+};

package/dist/fixtures/v2-voice-originated-action.js

@@ -0,0 +1,2 @@
+// @bun
+var e={id:"fixture-v2-voice-originated-action-001",scenario:"Customer voice complaint about upgrade block. Sensitive account data present. Unsafe customer commitment (direct refund promise) blocked by policy gate.",origin:{kind:"voice",actorPrincipalId:"customer:demo-001",transcriptRef:{id:"demo-transcript-001",source:"voice"},sourceRef:{id:"demo-stt:call-001",connectorCapability:"voice_call",providerKey:"demo-stt",externalId:"call-001",observedAt:"2026-05-16T10:00:00Z",metadata:{}},capturedAt:"2026-05-16T10:00:05Z",metadata:{}}};export{e as voiceOriginatedActionFixture};

package/dist/fixtures/v2-voiceops-support-to-product.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Deterministic fixture adapted from the approved hackathon VoiceOps S0
+ * candidate set. The tracked version keeps only redacted/local-safe material;
+ * raw transcript/source files remain in ignored `.omx/imports/**`.
+ */
+export declare const voiceOpsSupportToProductFixtureSource: {
+    readonly sourceHead: 'c3eb0e62d6bee0ac069e17940fcb8c463127fe3b';
+    readonly candidatePaths: readonly ['data/fixtures/transcript.txt', 'data/fixtures/run-record.json', 'data/fixtures/receipt-example-v2.json', 'packages/libs/voiceops-fixtures/src/scenarios.ts', 'packages/libs/voiceops-fixtures/src/transcripts.ts', 'packages/libs/voiceops-fixtures/src/receipts.ts'];
+};
+export declare const voiceOpsSupportToProductTranscriptFixture: readonly [{
+    readonly speaker: 'Customer';
+    readonly text: string;
+}, {
+    readonly speaker: 'PM';
+    readonly text: string;
+}];
+export declare const voiceOpsSupportToProductOriginFixture: {
+    kind: "voice";
+    actorPrincipalId: string;
+    sessionId: string;
+    transcriptRef: {
+        id: string;
+        source: "fixture";
+    };
+    sourceRef: {
+        id: string;
+        connectorCapability: string;
+        providerKey: string;
+        externalId: string;
+        observedAt: string;
+        metadata: {
+            scenario: string;
+            sourceHead: "c3eb0e62d6bee0ac069e17940fcb8c463127fe3b";
+        };
+    };
+    capturedAt: string;
+    metadata: {
+        scenario: string;
+        businessImpactBand: string;
+        redactedFields: string[];
+        prohibitedDefaultBehaviors: string[];
+    };
+};
+export declare const voiceOpsSupportToProductInternalActionLifecycleFixture: readonly [{
+    readonly from: 'proposed';
+    readonly to: 'needs_approval';
+    readonly reason: 'Voice-originated product gap requires accountable PM approval.';
+    readonly at: '2026-01-01T00:00:10.000Z';
+}, {
+    readonly from: 'needs_approval';
+    readonly to: 'approved';
+    readonly reason: 'PM approved internal-only product work.';
+    readonly at: '2026-01-01T00:00:20.000Z';
+}, {
+    readonly from: 'approved';
+    readonly to: 'executed';
+    readonly reason: 'Internal product gap task created with redacted customer context.';
+    readonly at: '2026-01-01T00:00:30.000Z';
+}];
+export declare const voiceOpsSupportToProductCustomerCommitmentLifecycleFixture: readonly [{
+    readonly from: 'proposed';
+    readonly to: 'blocked';
+    readonly reason: 'External customer commitment is blocked until the security owner approves exact wording.';
+    readonly at: '2026-01-01T00:00:15.000Z';
+}];
+export declare const voiceOpsSupportToProductReceiptMaterialFixture: {
+    runRecordRef: {
+        runId: string;
+        harnessTarget: string;
+    };
+    redactionSummary: {
+        redactedFieldCount: number;
+        redactedFieldPaths: string[];
+        redactedBy: string;
+        redactedAt: string;
+    };
+    derivedAt: string;
+};
+export declare const voiceOpsSupportToProductPolicyFixture: {
+    readonly allowedActions: readonly ['create-product-gap', 'notify-account-exec'];
+    readonly blockedActions: readonly ['promise-fix-tomorrow'];
+    readonly pendingApprovalActions: readonly ['route-security-review'];
+    readonly productionWrites: false;
+    readonly externalCalls: false;
+    readonly sandboxMode: true;
+};
+export declare const voiceOpsQuoteApprovalTranscriptFixture: readonly [{
+    readonly speaker: 'Customer';
+    readonly text: string;
+}];
+export declare const voiceOpsQuoteApprovalOriginFixture: {
+    kind: "voice";
+    actorPrincipalId: string;
+    sessionId: string;
+    transcriptRef: {
+        id: string;
+        source: "fixture";
+    };
+    sourceRef: {
+        id: string;
+        connectorCapability: string;
+        providerKey: string;
+        externalId: string;
+        observedAt: string;
+        metadata: {
+            scenario: string;
+            sourceHead: "c3eb0e62d6bee0ac069e17940fcb8c463127fe3b";
+        };
+    };
+    capturedAt: string;
+    metadata: {
+        scenario: string;
+        businessImpactBand: string;
+        commercialGuardrails: string[];
+    };
+};
+export declare const voiceOpsQuoteDraftLifecycleFixture: readonly [{
+    readonly from: 'proposed';
+    readonly to: 'approved';
+    readonly reason: 'Internal expansion quote draft may be prepared with redacted context.';
+    readonly at: '2026-01-01T01:00:10.000Z';
+}, {
+    readonly from: 'approved';
+    readonly to: 'executed';
+    readonly reason: 'Internal quote draft task created; no customer-facing send occurred.';
+    readonly at: '2026-01-01T01:00:20.000Z';
+}];
+export declare const voiceOpsQuoteSendLifecycleFixture: readonly [{
+    readonly from: 'proposed';
+    readonly to: 'needs_approval';
+    readonly reason: 'Sending a commercial quote requires Finance and Sales approval.';
+    readonly at: '2026-01-01T01:00:15.000Z';
+}];
+export declare const voiceOpsQuoteInvoiceLifecycleFixture: readonly [{
+    readonly from: 'proposed';
+    readonly to: 'blocked';
+    readonly reason: 'Invoice creation is blocked because no approved quote exists.';
+    readonly at: '2026-01-01T01:00:16.000Z';
+}];
+export declare const voiceOpsQuoteApprovalReceiptMaterialFixture: {
+    runRecordRef: {
+        runId: string;
+        harnessTarget: string;
+    };
+    redactionSummary: {
+        redactedFieldCount: number;
+        redactedFieldPaths: never[];
+        redactedBy: string;
+        redactedAt: string;
+    };
+    derivedAt: string;
+};
+export declare const voiceOpsQuoteApprovalPolicyFixture: {
+    readonly allowedActions: readonly ['draft-expansion-quote'];
+    readonly blockedActions: readonly ['create-expansion-invoice'];
+    readonly pendingApprovalActions: readonly ['send-expansion-quote'];
+    readonly productionWrites: false;
+    readonly externalCalls: false;
+    readonly sandboxMode: true;
+};

package/dist/fixtures/v2-voiceops-support-to-product.js

@@ -0,0 +1,2 @@
+// @bun
+var e={sourceHead:"c3eb0e62d6bee0ac069e17940fcb8c463127fe3b",candidatePaths:["data/fixtures/transcript.txt","data/fixtures/run-record.json","data/fixtures/receipt-example-v2.json","packages/libs/voiceops-fixtures/src/scenarios.ts","packages/libs/voiceops-fixtures/src/transcripts.ts","packages/libs/voiceops-fixtures/src/receipts.ts"]},o=[{speaker:"Customer",text:"We are blocked on the upgrade because the security answer is unclear. The customer email and account identifier were captured upstream and redacted before CompanyOS ingestion. Please promise this will be fixed by tomorrow or the expansion may pause."},{speaker:"PM",text:"Approve creating the internal product gap and route the security documentation question for review. Do not send any customer commitment yet."}],t={kind:"voice",actorPrincipalId:"customer:rivage-retail-redacted",sessionId:"session.voiceops.support-to-product.001",transcriptRef:{id:"transcript.rivage.customer.redacted.fixture",source:"fixture"},sourceRef:{id:"fixture.voiceops.support-to-product.001",connectorCapability:"voice_transcript_fixture",providerKey:"fixture",externalId:"fixture-call-redacted-001",observedAt:"2026-01-01T00:00:00.000Z",metadata:{scenario:"support-to-product-security-gap",sourceHead:e.sourceHead}},capturedAt:"2026-01-01T00:00:05.000Z",metadata:{scenario:"support-to-product-security-gap",businessImpactBand:"eur-25k-50k",redactedFields:["email","account_id"],prohibitedDefaultBehaviors:["external_customer_commitment","production_write","provider_call"]}},r=[{from:"proposed",to:"needs_approval",reason:"Voice-originated product gap requires accountable PM approval.",at:"2026-01-01T00:00:10.000Z"},{from:"needs_approval",to:"approved",reason:"PM approved internal-only product work.",at:"2026-01-01T00:00:20.000Z"},{from:"approved",to:"executed",reason:"Internal product gap task created with redacted customer context.",at:"2026-01-01T00:00:30.000Z"}],a=[{from:"proposed",to:"blocked",reason:"External customer commitment is blocked until the security owner approves exact wording.",at:"2026-01-01T00:00:15.000Z"}],i={runRecordRef:{runId:"run_support_to_product_001",harnessTarget:"companyos.voiceops.support-to-product.fixture"},redactionSummary:{redactedFieldCount:2,redactedFieldPaths:["transcript.customer.email","transcript.customer.account_id"],redactedBy:"companyos.voiceops.fixture-redactor",redactedAt:"2026-01-01T00:00:06.000Z"},derivedAt:"2026-01-01T00:00:40.000Z"},s={allowedActions:["create-product-gap","notify-account-exec"],blockedActions:["promise-fix-tomorrow"],pendingApprovalActions:["route-security-review"],productionWrites:!1,externalCalls:!1,sandboxMode:!0},c=[{speaker:"Customer",text:"If the security review is resolved, please send the expansion quote for the 50-seat plan. Procurement needs the numbers in writing before signing off."}],n={kind:"voice",actorPrincipalId:"customer:rivage-retail-redacted",sessionId:"session.voiceops.quote-approval.001",transcriptRef:{id:"transcript.rivage.quote-request.redacted.fixture",source:"fixture"},sourceRef:{id:"fixture.voiceops.quote-approval.001",connectorCapability:"voice_transcript_fixture",providerKey:"fixture",externalId:"fixture-call-redacted-quote-001",observedAt:"2026-01-01T01:00:00.000Z",metadata:{scenario:"sales-call-to-quote-approval",sourceHead:e.sourceHead}},capturedAt:"2026-01-01T01:00:05.000Z",metadata:{scenario:"sales-call-to-quote-approval",businessImpactBand:"eur-25k-50k",commercialGuardrails:["quote_send_requires_finance_sales_approval","invoice_creation_blocked_without_approved_quote"]}},p=[{from:"proposed",to:"approved",reason:"Internal expansion quote draft may be prepared with redacted context.",at:"2026-01-01T01:00:10.000Z"},{from:"approved",to:"executed",reason:"Internal quote draft task created; no customer-facing send occurred.",at:"2026-01-01T01:00:20.000Z"}],d=[{from:"proposed",to:"needs_approval",reason:"Sending a commercial quote requires Finance and Sales approval.",at:"2026-01-01T01:00:15.000Z"}],u=[{from:"proposed",to:"blocked",reason:"Invoice creation is blocked because no approved quote exists.",at:"2026-01-01T01:00:16.000Z"}],l={runRecordRef:{runId:"run_quote_approval_001",harnessTarget:"companyos.voiceops.quote-approval.fixture"},redactionSummary:{redactedFieldCount:0,redactedFieldPaths:[],redactedBy:"companyos.voiceops.fixture-redactor",redactedAt:"2026-01-01T01:00:06.000Z"},derivedAt:"2026-01-01T01:00:40.000Z"},v={allowedActions:["draft-expansion-quote"],blockedActions:["create-expansion-invoice"],pendingApprovalActions:["send-expansion-quote"],productionWrites:!1,externalCalls:!1,sandboxMode:!0};export{n as voiceOpsQuoteApprovalOriginFixture,v as voiceOpsQuoteApprovalPolicyFixture,l as voiceOpsQuoteApprovalReceiptMaterialFixture,c as voiceOpsQuoteApprovalTranscriptFixture,p as voiceOpsQuoteDraftLifecycleFixture,u as voiceOpsQuoteInvoiceLifecycleFixture,d as voiceOpsQuoteSendLifecycleFixture,a as voiceOpsSupportToProductCustomerCommitmentLifecycleFixture,e as voiceOpsSupportToProductFixtureSource,r as voiceOpsSupportToProductInternalActionLifecycleFixture,t as voiceOpsSupportToProductOriginFixture,s as voiceOpsSupportToProductPolicyFixture,i as voiceOpsSupportToProductReceiptMaterialFixture,o as voiceOpsSupportToProductTranscriptFixture};

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './companyos-spec.feature.js';
+export * from './docs/index.js';
+export * from './fixtures/index.js';
+export * from './types/index.js';
+export * from './validation/index.js';