@lssm/lib.companyos-spec 3.0.2

package/dist/types/control-plane-projections.d.ts

@@ -0,0 +1,320 @@
+export declare const COMPANYOS_CONTROL_PLANE_PROJECTION_VERSION: '1.0.0';
+export declare const CompanyOsGraphNodeEntityProjection: {
+    readonly meta: {
+        readonly version: "1.0.0";
+        readonly stability: 'experimental';
+        readonly owners: string[];
+        readonly tags: string[];
+        readonly key: "companyos.graph.node";
+        readonly title: "CompanyOS graph node";
+        readonly description: "Provider-neutral CompanyOS operating-graph node projected for control-plane review surfaces.";
+        readonly domain: "companyos";
+    };
+    readonly edges: [{
+        readonly id: "companyos.graph.node-evidence-for-control-plane.execution";
+        readonly from: "companyos.graph.node";
+        readonly to: "control-plane.execution";
+        readonly relation: "evidence-for";
+        readonly cardinality: "many-to-many";
+        readonly directed: true;
+        readonly label: "evidence for execution";
+    }];
+};
+export declare const CompanyOsGraphEdgeEntityProjection: {
+    readonly meta: {
+        readonly version: "1.0.0";
+        readonly stability: 'experimental';
+        readonly owners: string[];
+        readonly tags: string[];
+        readonly key: "companyos.graph.edge";
+        readonly title: "CompanyOS graph edge";
+        readonly description: "Provider-neutral CompanyOS operating-graph relationship projected for control-plane review surfaces.";
+        readonly domain: "companyos";
+    };
+};
+export declare const ControlPlaneExecutionEntityProjection: {
+    readonly meta: {
+        readonly version: "1.0.0";
+        readonly stability: 'experimental';
+        readonly owners: string[];
+        readonly tags: string[];
+        readonly key: "control-plane.execution";
+        readonly title: "Control-plane execution";
+        readonly description: "Execution projection that lets CompanyOS approval evidence and trace entries align with control-plane commands.";
+        readonly domain: "control-plane";
+    };
+    readonly edges: [{
+        readonly id: "control-plane.execution-requires-companyos.approval-gate";
+        readonly from: "control-plane.execution";
+        readonly to: "companyos.approval-gate";
+        readonly relation: "requires";
+        readonly cardinality: "many-to-one";
+        readonly directed: true;
+        readonly label: "requires CompanyOS approval gate";
+    }];
+};
+export declare const CompanyOsApprovalGateEntityProjection: {
+    readonly meta: {
+        readonly version: "1.0.0";
+        readonly stability: 'experimental';
+        readonly owners: string[];
+        readonly tags: string[];
+        readonly key: "companyos.approval-gate";
+        readonly title: "CompanyOS approval gate";
+        readonly description: "Authority boundary for high-impact CompanyOS actions before control-plane approval or rejection commands continue execution.";
+        readonly domain: "companyos";
+    };
+};
+export declare const CompanyOsControlPlaneProjectionEdges: {
+    readonly meta: {
+        readonly version: "1.0.0";
+        readonly stability: 'experimental';
+        readonly owners: string[];
+        readonly tags: string[];
+        readonly key: "companyos.approval-gate.controls-control-plane.execution";
+        readonly title: "CompanyOS approval controls execution";
+        readonly description: "Links CompanyOS approval-gate state to the control-plane execution it may approve or reject.";
+        readonly domain: "companyos";
+    };
+    readonly edge: {
+        readonly id: "companyos.approval-gate-controls-control-plane.execution";
+        readonly from: "companyos.approval-gate";
+        readonly to: "control-plane.execution";
+        readonly relation: "controls";
+        readonly cardinality: "one-to-many";
+        readonly directed: true;
+        readonly label: "controls execution";
+    };
+}[];
+export declare const CompanyOsControlPlaneEntityProjections: ({
+    readonly meta: {
+        readonly version: "1.0.0";
+        readonly stability: 'experimental';
+        readonly owners: string[];
+        readonly tags: string[];
+        readonly key: "companyos.graph.node";
+        readonly title: "CompanyOS graph node";
+        readonly description: "Provider-neutral CompanyOS operating-graph node projected for control-plane review surfaces.";
+        readonly domain: "companyos";
+    };
+    readonly edges: [{
+        readonly id: "companyos.graph.node-evidence-for-control-plane.execution";
+        readonly from: "companyos.graph.node";
+        readonly to: "control-plane.execution";
+        readonly relation: "evidence-for";
+        readonly cardinality: "many-to-many";
+        readonly directed: true;
+        readonly label: "evidence for execution";
+    }];
+} | {
+    readonly meta: {
+        readonly version: "1.0.0";
+        readonly stability: 'experimental';
+        readonly owners: string[];
+        readonly tags: string[];
+        readonly key: "companyos.graph.edge";
+        readonly title: "CompanyOS graph edge";
+        readonly description: "Provider-neutral CompanyOS operating-graph relationship projected for control-plane review surfaces.";
+        readonly domain: "companyos";
+    };
+} | {
+    readonly meta: {
+        readonly version: "1.0.0";
+        readonly stability: 'experimental';
+        readonly owners: string[];
+        readonly tags: string[];
+        readonly key: "control-plane.execution";
+        readonly title: "Control-plane execution";
+        readonly description: "Execution projection that lets CompanyOS approval evidence and trace entries align with control-plane commands.";
+        readonly domain: "control-plane";
+    };
+    readonly edges: [{
+        readonly id: "control-plane.execution-requires-companyos.approval-gate";
+        readonly from: "control-plane.execution";
+        readonly to: "companyos.approval-gate";
+        readonly relation: "requires";
+        readonly cardinality: "many-to-one";
+        readonly directed: true;
+        readonly label: "requires CompanyOS approval gate";
+    }];
+} | {
+    readonly meta: {
+        readonly version: "1.0.0";
+        readonly stability: 'experimental';
+        readonly owners: string[];
+        readonly tags: string[];
+        readonly key: "companyos.approval-gate";
+        readonly title: "CompanyOS approval gate";
+        readonly description: "Authority boundary for high-impact CompanyOS actions before control-plane approval or rejection commands continue execution.";
+        readonly domain: "companyos";
+    };
+})[];
+export declare const CompanyOsControlPlaneGraphDataViewProjection: {
+    readonly meta: {
+        readonly key: "companyos.control-plane.approval-graph";
+        readonly version: "1.0.0";
+        readonly title: "CompanyOS control-plane approval graph";
+        readonly description: "Entity-declarative graph projection for reviewing CompanyOS evidence, approval gates, and control-plane executions together.";
+        readonly stability: "experimental";
+        readonly owners: ["companyos.core"];
+        readonly tags: ["companyos", "control-plane", "approval", "graph"];
+        readonly entity: "control-plane.execution";
+        readonly domain: "companyos";
+    };
+    readonly source: {
+        readonly variant: "entity-declarative";
+        readonly entity: "control-plane.execution";
+        readonly edges: [{
+            readonly from: "control-plane.execution";
+            readonly to: "companyos.approval-gate";
+            readonly relation: "requires";
+        }, {
+            readonly from: "companyos.graph.node";
+            readonly to: "control-plane.execution";
+            readonly relation: "evidence-for";
+        }];
+    };
+    readonly view: {
+        readonly kind: "graph";
+        readonly layout: {
+            readonly kind: "dag";
+            readonly direction: "TB";
+        };
+        readonly nodeKindField: "kind";
+        readonly edgeKindField: "relation";
+        readonly inspector: "panel";
+        readonly fields: [{
+            readonly key: "label";
+            readonly label: "Label";
+            readonly dataPath: "label";
+            readonly roles: ["title"];
+        }, {
+            readonly key: "kind";
+            readonly label: "Kind";
+            readonly dataPath: "kind";
+            readonly roles: ["tag"];
+        }, {
+            readonly key: "reviewState";
+            readonly label: "Review state";
+            readonly dataPath: "reviewState";
+            readonly roles: ["status"];
+        }];
+    };
+    readonly policy: {
+        flags: ["approval-required", "operator-review"];
+        pii: [];
+    };
+} & {
+    meta: {
+        readonly key: "companyos.control-plane.approval-graph";
+        readonly version: "1.0.0";
+        readonly title: "CompanyOS control-plane approval graph";
+        readonly description: "Entity-declarative graph projection for reviewing CompanyOS evidence, approval gates, and control-plane executions together.";
+        readonly stability: "experimental";
+        readonly owners: ["companyos.core"];
+        readonly tags: ["companyos", "control-plane", "approval", "graph"];
+        readonly entity: "control-plane.execution";
+        readonly domain: "companyos";
+    } & {
+        translationKey: "companyos.control-plane.approval-graph";
+    };
+};
+export declare const CompanyOsControlPlaneGraphArtifactProjection: {
+    schemaVersion: "1.0";
+    artifactVersion: "graph-artifact.v1";
+    kind: "contract-graph";
+    generatedAt: string;
+    workspaceRoot: string;
+    redactionMode: "path-only";
+    nodes: ({
+        owners: string[];
+        tags: string[];
+        provenance: {
+            path: string;
+        }[];
+        id: string;
+        key: "companyos.graph.node";
+        kind: "data-view";
+        label: string;
+        confidence: "explicit";
+    } | {
+        owners: string[];
+        tags: string[];
+        provenance: {
+            path: string;
+        }[];
+        id: string;
+        key: "companyos.approval-gate";
+        kind: "policy";
+        label: string;
+        confidence: "explicit";
+    } | {
+        owners: string[];
+        tags: string[];
+        provenance: {
+            path: string;
+        }[];
+        id: string;
+        key: "control-plane.execution";
+        kind: "workflow";
+        label: string;
+        confidence: "explicit";
+    } | {
+        owners: string[];
+        tags: string[];
+        provenance: {
+            path: string;
+        }[];
+        id: string;
+        key: string;
+        kind: "command";
+        label: string;
+        confidence: "explicit";
+    } | {
+        owners: string[];
+        tags: string[];
+        provenance: {
+            path: string;
+        }[];
+        id: string;
+        key: string;
+        kind: "query";
+        label: string;
+        confidence: "explicit";
+    })[];
+    edges: ({
+        provenance: {
+            path: string;
+        }[];
+        id: string;
+        from: string;
+        to: string;
+        kind: "requires";
+        confidence: "explicit";
+        reason: string;
+    } | {
+        provenance: {
+            path: string;
+        }[];
+        id: string;
+        from: string;
+        to: string;
+        kind: "targets";
+        confidence: "explicit";
+    } | {
+        provenance: {
+            path: string;
+        }[];
+        id: string;
+        from: string;
+        to: string;
+        kind: "documents";
+        confidence: "explicit";
+    })[];
+    diagnostics: never[];
+    counts: {
+        nodes: number;
+        edges: number;
+        diagnostics: number;
+    };
+};

package/dist/types/control-plane-projections.js

@@ -0,0 +1,2 @@
+// @bun
+import{defineContractEdge as m,defineContractEntity as n}from"@lssm/lib.contracts-spec";import{ControlPlaneExecutionApproveCommand as a}from"@lssm/lib.contracts-spec/control-plane/commands/controlPlaneExecutionApprove.command";import{ControlPlaneExecutionRejectCommand as r}from"@lssm/lib.contracts-spec/control-plane/commands/controlPlaneExecutionReject.command";import{ControlPlaneTraceGetQuery as i}from"@lssm/lib.contracts-spec/control-plane/queries/controlPlaneTraceGet.query";import{defineDataView as y}from"@lssm/lib.contracts-spec/data-views";import{GraphArtifactSchemaVersionV1 as g,GraphArtifactVersionV1 as u}from"@lssm/lib.contracts-spec/graph-artifacts";import{defineTranslation as v}from"@lssm/lib.contracts-spec/translations";var c="1.0.0",p=[{path:"packages/libs/companyos-spec/src/types/control-plane-projections.ts"}],e={owners:["companyos.core"],tags:["companyos","control-plane","projection"],provenance:p},t={provenance:p},o={version:c,stability:"experimental",owners:["companyos.core"],tags:["companyos","control-plane","projection"]},l=n({meta:{...o,key:"companyos.graph.node",title:"CompanyOS graph node",description:"Provider-neutral CompanyOS operating-graph node projected for control-plane review surfaces.",domain:"companyos"},edges:[{id:"companyos.graph.node-evidence-for-control-plane.execution",from:"companyos.graph.node",to:"control-plane.execution",relation:"evidence-for",cardinality:"many-to-many",directed:!0,label:"evidence for execution"}]}),x=n({meta:{...o,key:"companyos.graph.edge",title:"CompanyOS graph edge",description:"Provider-neutral CompanyOS operating-graph relationship projected for control-plane review surfaces.",domain:"companyos"}}),s=n({meta:{...o,key:"control-plane.execution",title:"Control-plane execution",description:"Execution projection that lets CompanyOS approval evidence and trace entries align with control-plane commands.",domain:"control-plane"},edges:[{id:"control-plane.execution-requires-companyos.approval-gate",from:"control-plane.execution",to:"companyos.approval-gate",relation:"requires",cardinality:"many-to-one",directed:!0,label:"requires CompanyOS approval gate"}]}),d=n({meta:{...o,key:"companyos.approval-gate",title:"CompanyOS approval gate",description:"Authority boundary for high-impact CompanyOS actions before control-plane approval or rejection commands continue execution.",domain:"companyos"}}),E=[m({meta:{...o,key:"companyos.approval-gate.controls-control-plane.execution",title:"CompanyOS approval controls execution",description:"Links CompanyOS approval-gate state to the control-plane execution it may approve or reject.",domain:"companyos"},edge:{id:"companyos.approval-gate-controls-control-plane.execution",from:"companyos.approval-gate",to:"control-plane.execution",relation:"controls",cardinality:"one-to-many",directed:!0,label:"controls execution"}})],b=[l,x,s,d],f=v({meta:{key:"companyos.control-plane.approval-graph",version:"1.0.0",domain:"companyos",owners:["companyos.core"]},locale:"en",messages:{Label:{value:"Label"},Kind:{value:"Kind"},"Review state":{value:"Review state"}}}),w=y(f,{meta:{key:"companyos.control-plane.approval-graph",version:c,title:"CompanyOS control-plane approval graph",description:"Entity-declarative graph projection for reviewing CompanyOS evidence, approval gates, and control-plane executions together.",stability:"experimental",owners:["companyos.core"],tags:["companyos","control-plane","approval","graph"],entity:"control-plane.execution",domain:"companyos"},source:{variant:"entity-declarative",entity:"control-plane.execution",edges:[{from:"control-plane.execution",to:"companyos.approval-gate",relation:"requires"},{from:"companyos.graph.node",to:"control-plane.execution",relation:"evidence-for"}]},view:{kind:"graph",layout:{kind:"dag",direction:"TB"},nodeKindField:"kind",edgeKindField:"relation",inspector:"panel",fields:[{key:"label",label:"Label",dataPath:"label",roles:["title"]},{key:"kind",label:"Kind",dataPath:"kind",roles:["tag"]},{key:"reviewState",label:"Review state",dataPath:"reviewState",roles:["status"]}]},policy:{flags:["approval-required","operator-review"],pii:[]}}),G={schemaVersion:g,artifactVersion:u,kind:"contract-graph",generatedAt:"2026-05-17T00:00:00.000Z",workspaceRoot:"contractspec://companyos/control-plane-projections",redactionMode:"path-only",nodes:[{...e,id:"entity:companyos.graph.node",key:l.meta.key,kind:"data-view",label:"CompanyOS graph node",confidence:"explicit"},{...e,id:"entity:companyos.approval-gate",key:d.meta.key,kind:"policy",label:"CompanyOS approval gate",confidence:"explicit"},{...e,id:"entity:control-plane.execution",key:s.meta.key,kind:"workflow",label:"Control-plane execution",confidence:"explicit"},{...e,id:"operation:controlPlane.execution.approve",key:a.meta.key,kind:"command",label:a.meta.title??"Approve Execution Step",confidence:"explicit"},{...e,id:"operation:controlPlane.execution.reject",key:r.meta.key,kind:"command",label:r.meta.title??"Reject Execution Step",confidence:"explicit"},{...e,id:"query:controlPlane.trace.get",key:i.meta.key,kind:"query",label:i.meta.title??"Get Execution Trace",confidence:"explicit"}],edges:[{...t,id:"edge:approval-gate-controls-execution",from:"entity:companyos.approval-gate",to:"entity:control-plane.execution",kind:"requires",confidence:"explicit",reason:"CompanyOS approval gates must resolve before high-impact execution continuation."},{...t,id:"edge:approve-targets-execution",from:"operation:controlPlane.execution.approve",to:"entity:control-plane.execution",kind:"targets",confidence:"explicit"},{...t,id:"edge:reject-targets-execution",from:"operation:controlPlane.execution.reject",to:"entity:control-plane.execution",kind:"targets",confidence:"explicit"},{...t,id:"edge:trace-documents-execution",from:"query:controlPlane.trace.get",to:"entity:control-plane.execution",kind:"documents",confidence:"explicit"}],diagnostics:[],counts:{nodes:6,edges:4,diagnostics:0}};export{c as COMPANYOS_CONTROL_PLANE_PROJECTION_VERSION,d as CompanyOsApprovalGateEntityProjection,b as CompanyOsControlPlaneEntityProjections,G as CompanyOsControlPlaneGraphArtifactProjection,w as CompanyOsControlPlaneGraphDataViewProjection,E as CompanyOsControlPlaneProjectionEdges,x as CompanyOsGraphEdgeEntityProjection,l as CompanyOsGraphNodeEntityProjection,s as ControlPlaneExecutionEntityProjection};