@lssm/lib.contracts-spec 17.3.2

package/dist/docs/views/contractReference.dataView.d.ts

@@ -0,0 +1,78 @@
+export declare const ContractReferenceDataView: {
+    readonly meta: {
+        readonly key: "docs.contract.reference.view";
+        readonly title: "Contract Reference";
+        readonly version: "1.0.0";
+        readonly description: "Detail view for a single contract reference.";
+        readonly domain: "docs";
+        readonly owners: string[];
+        readonly tags: [...string[], "reference"];
+        readonly stability: "experimental";
+        readonly entity: "contract-reference";
+        readonly docId: [import("..").DocId];
+    };
+    readonly source: {
+        primary: {
+            key: string;
+            version: string;
+        };
+    };
+    readonly view: {
+        readonly kind: "detail";
+        readonly fields: [{
+            readonly key: "key";
+            readonly label: "field.key.label";
+            readonly dataPath: "reference.key";
+        }, {
+            readonly key: "version";
+            readonly label: "field.version.label";
+            readonly dataPath: "reference.version";
+        }, {
+            readonly key: "type";
+            readonly label: "field.type.label";
+            readonly dataPath: "reference.type";
+        }, {
+            readonly key: "title";
+            readonly label: "field.title.label";
+            readonly dataPath: "reference.title";
+        }, {
+            readonly key: "description";
+            readonly label: "field.description.label";
+            readonly dataPath: "reference.description";
+            readonly format: "markdown";
+        }, {
+            readonly key: "tags";
+            readonly label: "field.tags.label";
+            readonly dataPath: "reference.tags";
+        }, {
+            readonly key: "owners";
+            readonly label: "field.owners.label";
+            readonly dataPath: "reference.owners";
+        }, {
+            readonly key: "stability";
+            readonly label: "field.stability.label";
+            readonly dataPath: "reference.stability";
+        }];
+        readonly primaryField: "title";
+        readonly secondaryFields: ["description"];
+    };
+    readonly policy: {
+        flags: [];
+        pii: [];
+    };
+} & {
+    meta: {
+        readonly key: "docs.contract.reference.view";
+        readonly title: "Contract Reference";
+        readonly version: "1.0.0";
+        readonly description: "Detail view for a single contract reference.";
+        readonly domain: "docs";
+        readonly owners: string[];
+        readonly tags: [...string[], "reference"];
+        readonly stability: "experimental";
+        readonly entity: "contract-reference";
+        readonly docId: [import("..").DocId];
+    } & {
+        translationKey: "docs.contract.reference.view.i18n";
+    };
+};

package/dist/docs/views/contractReference.dataView.js

@@ -0,0 +1 @@
+import{defineDataView as t}from"../../data-views/index.js";import{defineTranslation as i}from"../../translations/index.js";import{DOCS_DOMAIN as a,DOCS_OWNERS as l,DOCS_STABILITY as r,DOCS_TAGS as n}from"../constants.js";import{ContractReferenceQuery as e}from"../queries/contractReference.query.js";import{docId as o}from"../registry.js";const s=i({meta:{key:"docs.contract.reference.view.i18n",version:"1.0.0",domain:a,owners:l},locale:"en",messages:{"field.key.label":{value:"Key"},"field.version.label":{value:"Version"},"field.type.label":{value:"Type"},"field.title.label":{value:"Title"},"field.description.label":{value:"Description"},"field.tags.label":{value:"Tags"},"field.owners.label":{value:"Owners"},"field.stability.label":{value:"Stability"}}});export const ContractReferenceDataView=t(s,{meta:{key:"docs.contract.reference.view",title:"Contract Reference",version:"1.0.0",description:"Detail view for a single contract reference.",domain:a,owners:l,tags:[...n,"reference"],stability:r,entity:"contract-reference",docId:[o("docs.tech.docs-reference")]},source:{primary:{key:e.meta.key,version:e.meta.version}},view:{kind:"detail",fields:[{key:"key",label:"field.key.label",dataPath:"reference.key"},{key:"version",label:"field.version.label",dataPath:"reference.version"},{key:"type",label:"field.type.label",dataPath:"reference.type"},{key:"title",label:"field.title.label",dataPath:"reference.title"},{key:"description",label:"field.description.label",dataPath:"reference.description",format:"markdown"},{key:"tags",label:"field.tags.label",dataPath:"reference.tags"},{key:"owners",label:"field.owners.label",dataPath:"reference.owners"},{key:"stability",label:"field.stability.label",dataPath:"reference.stability"}],primaryField:"title",secondaryFields:["description"]},policy:{flags:[],pii:[]}});

package/dist/docs/views/docsIndex.dataView.d.ts

@@ -0,0 +1,119 @@
+export declare const DocsIndexDataView: {
+    readonly meta: {
+        readonly key: "docs.index.view";
+        readonly title: "Docs Index";
+        readonly version: "1.0.0";
+        readonly description: "List and filter documentation entries.";
+        readonly domain: "docs";
+        readonly owners: string[];
+        readonly tags: [...string[], "index"];
+        readonly stability: "experimental";
+        readonly entity: "docs";
+        readonly docId: [import("..").DocId];
+    };
+    readonly source: {
+        primary: {
+            key: string;
+            version: string;
+        };
+    };
+    readonly view: {
+        readonly kind: "list";
+        readonly fields: [{
+            readonly key: "id";
+            readonly label: "field.id.label";
+            readonly dataPath: "id";
+        }, {
+            readonly key: "title";
+            readonly label: "field.title.label";
+            readonly dataPath: "title";
+        }, {
+            readonly key: "summary";
+            readonly label: "field.summary.label";
+            readonly dataPath: "summary";
+        }, {
+            readonly key: "route";
+            readonly label: "field.route.label";
+            readonly dataPath: "route";
+        }, {
+            readonly key: "tags";
+            readonly label: "field.tags.label";
+            readonly dataPath: "tags";
+            readonly format: "badge";
+        }, {
+            readonly key: "kind";
+            readonly label: "field.kind.label";
+            readonly dataPath: "kind";
+        }, {
+            readonly key: "visibility";
+            readonly label: "field.visibility.label";
+            readonly dataPath: "visibility";
+        }];
+        readonly primaryField: "title";
+        readonly secondaryFields: ["summary", "route"];
+        readonly filters: [{
+            readonly key: "query";
+            readonly label: "filter.query.label";
+            readonly field: "query";
+            readonly type: "search";
+        }, {
+            readonly key: "visibility";
+            readonly label: "filter.visibility.label";
+            readonly field: "visibility";
+            readonly type: "enum";
+            readonly options: [{
+                readonly value: "public";
+                readonly label: "filter.visibility.option.public";
+            }, {
+                readonly value: "internal";
+                readonly label: "filter.visibility.option.internal";
+            }, {
+                readonly value: "mixed";
+                readonly label: "filter.visibility.option.mixed";
+            }];
+        }, {
+            readonly key: "kind";
+            readonly label: "filter.kind.label";
+            readonly field: "kind";
+            readonly type: "enum";
+            readonly options: [{
+                readonly value: "goal";
+                readonly label: "filter.kind.option.goal";
+            }, {
+                readonly value: "how";
+                readonly label: "filter.kind.option.how";
+            }, {
+                readonly value: "usage";
+                readonly label: "filter.kind.option.usage";
+            }, {
+                readonly value: "reference";
+                readonly label: "filter.kind.option.reference";
+            }, {
+                readonly value: "faq";
+                readonly label: "filter.kind.option.faq";
+            }, {
+                readonly value: "changelog";
+                readonly label: "filter.kind.option.changelog";
+            }];
+        }];
+    };
+    readonly policy: {
+        flags: [];
+        pii: [];
+    };
+} & {
+    meta: {
+        readonly key: "docs.index.view";
+        readonly title: "Docs Index";
+        readonly version: "1.0.0";
+        readonly description: "List and filter documentation entries.";
+        readonly domain: "docs";
+        readonly owners: string[];
+        readonly tags: [...string[], "index"];
+        readonly stability: "experimental";
+        readonly entity: "docs";
+        readonly docId: [import("..").DocId];
+    } & {
+        translationKey: "docs.index.view.i18n";
+    };
+};

package/dist/docs/views/docsIndex.dataView.js

@@ -0,0 +1 @@
+import{defineDataView as a}from"../../data-views/index.js";import{defineTranslation as t}from"../../translations/index.js";import{DOCS_DOMAIN as i,DOCS_OWNERS as l,DOCS_STABILITY as o,DOCS_TAGS as n}from"../constants.js";import{DocsIndexQuery as e}from"../queries/docsIndex.query.js";import{docId as r}from"../registry.js";const d=t({meta:{key:"docs.index.view.i18n",version:"1.0.0",domain:i,owners:l},locale:"en",messages:{"field.id.label":{value:"ID"},"field.title.label":{value:"Title"},"field.summary.label":{value:"Summary"},"field.route.label":{value:"Route"},"field.tags.label":{value:"Tags"},"field.kind.label":{value:"Kind"},"field.visibility.label":{value:"Visibility"},"filter.query.label":{value:"Search"},"filter.visibility.label":{value:"Visibility"},"filter.visibility.option.public":{value:"Public"},"filter.visibility.option.internal":{value:"Internal"},"filter.visibility.option.mixed":{value:"Mixed"},"filter.kind.label":{value:"Kind"},"filter.kind.option.goal":{value:"Goal"},"filter.kind.option.how":{value:"How"},"filter.kind.option.usage":{value:"Usage"},"filter.kind.option.reference":{value:"Reference"},"filter.kind.option.faq":{value:"FAQ"},"filter.kind.option.changelog":{value:"Changelog"}}});export const DocsIndexDataView=a(d,{meta:{key:"docs.index.view",title:"Docs Index",version:"1.0.0",description:"List and filter documentation entries.",domain:i,owners:l,tags:[...n,"index"],stability:o,entity:"docs",docId:[r("docs.tech.docs-search")]},source:{primary:{key:e.meta.key,version:e.meta.version}},view:{kind:"list",fields:[{key:"id",label:"field.id.label",dataPath:"id"},{key:"title",label:"field.title.label",dataPath:"title"},{key:"summary",label:"field.summary.label",dataPath:"summary"},{key:"route",label:"field.route.label",dataPath:"route"},{key:"tags",label:"field.tags.label",dataPath:"tags",format:"badge"},{key:"kind",label:"field.kind.label",dataPath:"kind"},{key:"visibility",label:"field.visibility.label",dataPath:"visibility"}],primaryField:"title",secondaryFields:["summary","route"],filters:[{key:"query",label:"filter.query.label",field:"query",type:"search"},{key:"visibility",label:"filter.visibility.label",field:"visibility",type:"enum",options:[{value:"public",label:"filter.visibility.option.public"},{value:"internal",label:"filter.visibility.option.internal"},{value:"mixed",label:"filter.visibility.option.mixed"}]},{key:"kind",label:"filter.kind.label",field:"kind",type:"enum",options:[{value:"goal",label:"filter.kind.option.goal"},{value:"how",label:"filter.kind.option.how"},{value:"usage",label:"filter.kind.option.usage"},{value:"reference",label:"filter.kind.option.reference"},{value:"faq",label:"filter.kind.option.faq"},{value:"changelog",label:"filter.kind.option.changelog"}]}]},policy:{flags:[],pii:[]}});

package/dist/docs/views/exampleCatalog.dataView.d.ts

@@ -0,0 +1,97 @@
+export declare const ExampleCatalogDocBlock: {
+    id: string;
+    title: string;
+    summary: string;
+    kind: "reference";
+    visibility: "public";
+    route: string;
+    tags: string[];
+    body: string;
+};
+export declare const ExampleCatalogDataView: {
+    readonly meta: {
+        readonly key: "docs.examples.catalog.view";
+        readonly title: "Examples Catalog";
+        readonly version: "1.0.0";
+        readonly description: "Catalog view of ContractSpec examples and demos.";
+        readonly domain: "docs";
+        readonly owners: string[];
+        readonly tags: [...string[], "examples"];
+        readonly stability: "experimental";
+        readonly entity: "docs-examples";
+        readonly docId: [import("..").DocId];
+    };
+    readonly source: {
+        primary: {
+            key: string;
+            version: string;
+        };
+    };
+    readonly view: {
+        readonly kind: "grid";
+        readonly fields: [{
+            readonly key: "id";
+            readonly label: "field.id.label";
+            readonly dataPath: "id";
+        }, {
+            readonly key: "title";
+            readonly label: "field.title.label";
+            readonly dataPath: "title";
+        }, {
+            readonly key: "summary";
+            readonly label: "field.summary.label";
+            readonly dataPath: "summary";
+        }, {
+            readonly key: "route";
+            readonly label: "field.route.label";
+            readonly dataPath: "route";
+        }, {
+            readonly key: "tags";
+            readonly label: "field.tags.label";
+            readonly dataPath: "tags";
+            readonly format: "badge";
+        }];
+        readonly primaryField: "title";
+        readonly secondaryFields: ["summary"];
+        readonly filters: [{
+            readonly key: "query";
+            readonly label: "filter.query.label";
+            readonly field: "query";
+            readonly type: "search";
+        }, {
+            readonly key: "tags";
+            readonly label: "filter.tags.label";
+            readonly field: "tag";
+            readonly type: "enum";
+            readonly options: [{
+                readonly value: "examples";
+                readonly label: "filter.tags.option.examples";
+            }, {
+                readonly value: "templates";
+                readonly label: "filter.tags.option.templates";
+            }, {
+                readonly value: "sandbox";
+                readonly label: "filter.tags.option.sandbox";
+            }];
+        }];
+    };
+    readonly policy: {
+        flags: [];
+        pii: [];
+    };
+} & {
+    meta: {
+        readonly key: "docs.examples.catalog.view";
+        readonly title: "Examples Catalog";
+        readonly version: "1.0.0";
+        readonly description: "Catalog view of ContractSpec examples and demos.";
+        readonly domain: "docs";
+        readonly owners: string[];
+        readonly tags: [...string[], "examples"];
+        readonly stability: "experimental";
+        readonly entity: "docs-examples";
+        readonly docId: [import("..").DocId];
+    } & {
+        translationKey: "docs.examples.catalog.view.i18n";
+    };
+};

package/dist/docs/views/exampleCatalog.dataView.js

@@ -0,0 +1,4 @@
+import{defineDataView as t}from"../../data-views/index.js";import{defineTranslation as s}from"../../translations/index.js";import{DOCS_DOMAIN as a,DOCS_OWNERS as l,DOCS_STABILITY as o,DOCS_TAGS as i}from"../constants.js";import{DocsIndexQuery as e}from"../queries/docsIndex.query.js";import{docId as r}from"../registry.js";const m=s({meta:{key:"docs.examples.catalog.view.i18n",version:"1.0.0",domain:a,owners:l},locale:"en",messages:{"field.id.label":{value:"ID"},"field.title.label":{value:"Title"},"field.summary.label":{value:"Summary"},"field.route.label":{value:"Route"},"field.tags.label":{value:"Tags"},"filter.query.label":{value:"Search"},"filter.tags.label":{value:"Tags"},"filter.tags.option.examples":{value:"Examples"},"filter.tags.option.templates":{value:"Templates"},"filter.tags.option.sandbox":{value:"Sandbox"}}});export const ExampleCatalogDocBlock={id:"docs.tech.docs-examples",title:"Examples catalog",summary:"Document and surface example projects with sandbox support.",kind:"reference",visibility:"public",route:"/docs/tech/docs/examples",tags:["docs","examples"],body:`# Examples catalog
+
+Examples are registered as ExampleSpecs and surface DocBlocks for discovery, templates, and sandbox entrypoints.
+`};export const ExampleCatalogDataView=t(m,{meta:{key:"docs.examples.catalog.view",title:"Examples Catalog",version:"1.0.0",description:"Catalog view of ContractSpec examples and demos.",domain:a,owners:l,tags:[...i,"examples"],stability:o,entity:"docs-examples",docId:[r("docs.tech.docs-examples")]},source:{primary:{key:e.meta.key,version:e.meta.version}},view:{kind:"grid",fields:[{key:"id",label:"field.id.label",dataPath:"id"},{key:"title",label:"field.title.label",dataPath:"title"},{key:"summary",label:"field.summary.label",dataPath:"summary"},{key:"route",label:"field.route.label",dataPath:"route"},{key:"tags",label:"field.tags.label",dataPath:"tags",format:"badge"}],primaryField:"title",secondaryFields:["summary"],filters:[{key:"query",label:"filter.query.label",field:"query",type:"search"},{key:"tags",label:"filter.tags.label",field:"tag",type:"enum",options:[{value:"examples",label:"filter.tags.option.examples"},{value:"templates",label:"filter.tags.option.templates"},{value:"sandbox",label:"filter.tags.option.sandbox"}]}]},policy:{flags:[],pii:[]}});

package/dist/docs/views/index.d.js

@@ -0,0 +1 @@
+export*from"./contractReference.dataView.js";export*from"./docsIndex.dataView.js";export*from"./exampleCatalog.dataView.js";

package/dist/docs/views/index.d.ts

@@ -0,0 +1,3 @@
+export * from './contractReference.dataView.js';
+export * from './docsIndex.dataView.js';
+export * from './exampleCatalog.dataView.js';

package/dist/docs/views/index.js

@@ -0,0 +1 @@
+export*from"./contractReference.dataView.js";export*from"./docsIndex.dataView.js";export*from"./exampleCatalog.dataView.js";

package/dist/editions/companyos-scenario.d.ts

@@ -0,0 +1,39 @@
+import type { DataViewRef } from '../features/index.js';
+import { type EditionConnectGateResult, type EditionConnectReviewPacket } from './connect-gates.js';
+import type { EditionEditorViewModel } from './editor/types.js';
+import { type EditionEnterpriseGuardrailContext, type EditionEnterpriseGuardrailResult } from './enterprise-guardrails.js';
+import { type EditionExperimentDashboardViewModel } from './experiments.js';
+import { type EditionHarnessCoverageResult, type EditionHarnessReplayEnvelope } from './harness-evidence.js';
+import { type EditionImprovementLoopViewModel } from './improvement.js';
+import { type EditionCoachWorkflowSurface } from './intelligence-coach.js';
+import { type EditionKnowledgeProvenanceEnvelope, type EditionKnowledgeReadiness } from './knowledge-provenance.js';
+import { type EditionRollbackViewModel } from './rollback.js';
+import { type FileEditionPatch } from './storage-file.js';
+import { type HybridEditionSyncResult } from './storage-hybrid.js';
+import type { EditionLifecycle } from './types.js';
+export interface ManagedCompanyOsFullLoopScenario {
+    scenarioRef: string;
+    stableFileEdition: EditionLifecycle;
+    databaseExperimentEdition: EditionLifecycle;
+    editor: EditionEditorViewModel;
+    hybridPatch: FileEditionPatch;
+    releaseProjection: HybridEditionSyncResult;
+    harnessReplay: EditionHarnessReplayEnvelope;
+    harnessCoverage: EditionHarnessCoverageResult;
+    knowledgeProvenance: EditionKnowledgeProvenanceEnvelope;
+    knowledgeReadiness: EditionKnowledgeReadiness;
+    connectReviewPacket: EditionConnectReviewPacket;
+    connectGate: EditionConnectGateResult;
+    coachSurface: EditionCoachWorkflowSurface;
+    enterpriseGuardrails: EditionEnterpriseGuardrailContext;
+    enterpriseGuardrailResult: EditionEnterpriseGuardrailResult;
+    experimentDashboard: EditionExperimentDashboardViewModel;
+    improvementLoop: EditionImprovementLoopViewModel;
+    rollback: EditionRollbackViewModel;
+    databaseAuditEventRefs: string[];
+    canonicalOntologyRefs: string[];
+    dataViewRefs: DataViewRef[];
+    evidenceTrailRefs: string[];
+    readyForEnterpriseReview: boolean;
+}
+export declare function resolveManagedCompanyOsFullLoopScenario(): ManagedCompanyOsFullLoopScenario;

package/dist/editions/companyos-scenario.js

@@ -0,0 +1 @@
+import{evaluateEditionConnectGate as F,ManagedCompanyOsConnectReviewPacketFixture as P}from"./connect-gates.js";import{ManagedCompanyOsEditionEditorViewFixture as s}from"./editor/index.js";import{evaluateEditionEnterpriseGuardrails as O,ManagedCompanyOsEnterpriseGuardrailContextFixture as V}from"./enterprise-guardrails.js";import{ManagedCompanyOsEditionExperimentBindingFixture as G,ManagedCompanyOsEditionExperimentMetricsFixture as S,resolveEditionExperimentDashboard as D}from"./experiments.js";import{ManagedCompanyOsDatabaseExperimentEditionFixture as L,ManagedCompanyOsFilePublishedEditionFixture as I}from"./fixtures.js";import{evaluateEditionHarnessCoverage as A,ManagedCompanyOsHarnessReplayEnvelopeFixture as H}from"./harness-evidence.js";import{ManagedCompanyOsImprovementCandidateFixture as q,resolveEditionImprovementLoop as K}from"./improvement.js";import{ManagedCompanyOsCoachSuggestionFixtures as T,resolveEditionCoachWorkflowSurface as j}from"./intelligence-coach.js";import{evaluateEditionKnowledgeReadiness as W,ManagedCompanyOsKnowledgeProvenanceEnvelopeFixture as z}from"./knowledge-provenance.js";import{executeEditionRollback as B,planEditionRollback as _,resolveEditionRollbackView as J}from"./rollback.js";import{createInMemoryDatabaseEditionAdapter as N}from"./storage.js";import{createInMemoryFileEditionAdapter as Q}from"./storage-file.js";import{createInMemoryHybridEditionSyncAdapter as U}from"./storage-hybrid.js";import{validateEditionLifecycle as X}from"./validation.js";export function resolveManagedCompanyOsFullLoopScenario(){const o=I,e=L;w(o);w(e);const n=N([e]),x=Q([o]),y=U(),d=y.materializeDatabaseDraftToFilePatch({databaseEdition:e,fileAdapter:x,baseRef:o.identity.editionId,targetRef:"file-patch:customer-profile:db-experiment-v2",evidenceRefs:["artifact:db-draft-to-file-patch","harness-run:customer-profile-materialization"]});if(!d.patch)throw Error("Managed CompanyOS scenario requires a file patch.");const u=H,i=A({envelope:u,requiredArtifactKinds:["screenshot","dom-snapshot","trace"]}),R=z,a=W({envelope:R,requiredCanonRefs:["canon:companyos:customer-profile"]}),c=P,r=F({packet:c}),v=y.projectFileReleaseToDatabase({fileEdition:o,databaseAdapter:n,databaseEdition:{...e,identity:{...e.identity,state:"published"},evidence:{...e.evidence,compatibilityIntent:"behavior_compatible",promotionEvidenceRefs:["promotion:companyos:db-experiment:approved"],releaseRefs:["release:companyos:2026.06.1"]}},actorRef:"actor:contract-steward",evidenceRefs:["release:companyos:2026.06.1","replay:companyos:file-release-to-db"]}),g=_({edition:e,targetEditionRef:o.identity.editionId,approvalRefs:["approval:companyos:rollback-approved"],harnessRunRefs:["harness-run:customer-profile-rollback"],replayPacketRef:"replay:customer-profile-rollback"}),l=J(g,B(g)),p=j({surfaceRef:"coach-surface:companyos:contract-editions",suggestions:T,minimumConfidence:0.8}),b=V,t=O({context:b}),m=D({experiment:G,activeEdition:e,metrics:S,requiredEvidenceRefs:["connect:companyos:experiment-promotion:permit","harness-run:customer-profile-experiment"]}),f=K({state:{loopRef:"loop:companyos:customer-profile:full-loop",mode:"mixed",stage:"verify",activeEdition:e,scopeRefs:["workspace:managed-companyos"],candidates:[q],historyRefs:["audit:companyos:full-loop:started"]}}),h=n.getAuditEvents(e.identity.editionId).map((E)=>E.eventRef),C=["ontology:companyos:contract-editions","canon:companyos:customer-profile"],k=[{key:"contract-edition.full-loop.dashboard",version:"1.0.0"}],M=Y([...s.evidence.connectVerdictRefs,...s.evidence.harnessRunRefs,...s.evidence.knowledgeProvenanceRefs,...d.evidenceRefs,...v.evidenceRefs,...i.evidenceRefs.harnessRunRefs,...i.evidenceRefs.replayEvidenceRefs,...i.evidenceRefs.artifactRefs,...a.knowledgeProvenanceRefs,...a.canonicalRefs,...c.evidenceRefs,...r.policyDecisionRefs,...p.feedbackEventRefs,...t.auditTrailRefs,...t.redactionRefs,...t.observabilityRefs,...l.preview.requiredEvidenceRefs,...m.promotionReadiness.requiredEvidenceRefs,...f.auditEventRefs]);return{scenarioRef:"scenario:managed-companyos:contract-edition-full-loop",stableFileEdition:o,databaseExperimentEdition:e,editor:s,hybridPatch:d.patch,releaseProjection:v,harnessReplay:u,harnessCoverage:i,knowledgeProvenance:R,knowledgeReadiness:a,connectReviewPacket:c,connectGate:r,coachSurface:p,enterpriseGuardrails:b,enterpriseGuardrailResult:t,experimentDashboard:m,improvementLoop:f,rollback:l,databaseAuditEventRefs:h,canonicalOntologyRefs:C,dataViewRefs:k,evidenceTrailRefs:M,readyForEnterpriseReview:i.ready&&a.ready&&r.allowed&&r.reviewResolved&&p.decisions.every((E)=>E.ready)&&t.ready&&h.length>0&&m.promotionReadiness.ready&&l.execution?.status==="executed"&&f.autonomousActionRefs.length>0}}function w(o){const e=X(o);if(!e.valid)throw Error(`Invalid scenario edition: ${e.issues.map((n)=>n.message).join("; ")}`)}function Y(o){return Array.from(new Set(o))}

package/dist/editions/connect-gates.d.ts

@@ -0,0 +1,30 @@
+import type { ConnectReviewThresholds, ConnectVerdict } from '../workspace-config/contractsrc-types.js';
+import type { EditionEvolutionIntent } from './types.js';
+export interface EditionConnectReviewPacket {
+    packetRef: string;
+    subjectEditionRef: string;
+    intent: EditionEvolutionIntent;
+    verdict: ConnectVerdict;
+    thresholds: ConnectReviewThresholds;
+    policyDecisionRefs: string[];
+    reviewerRefs: string[];
+    evidenceRefs: string[];
+    escalationRefs: string[];
+}
+export interface EditionConnectGateResult {
+    packetRef: string;
+    allowed: boolean;
+    reviewResolved: boolean;
+    verdict: ConnectVerdict;
+    requiredVerdict: ConnectVerdict;
+    requiresHumanReview: boolean;
+    missingEvidenceKinds: string[];
+    policyDecisionRefs: string[];
+}
+export declare function evaluateEditionConnectGate(input: {
+    packet: EditionConnectReviewPacket;
+}): EditionConnectGateResult;
+export declare function mergeEditionConnectGates(input: {
+    packets: EditionConnectReviewPacket[];
+}): EditionConnectGateResult;
+export declare const ManagedCompanyOsConnectReviewPacketFixture: EditionConnectReviewPacket;

package/dist/editions/connect-gates.js

@@ -0,0 +1 @@
+export function evaluateEditionConnectGate(e){const i=a(e.packet.intent,e.packet.thresholds),n=d(e.packet),t=c(e.packet.verdict)<=c(i);return{packetRef:e.packet.packetRef,allowed:t&&n.length===0&&(i!=="require_review"||e.packet.escalationRefs.length>0)&&(e.packet.verdict!=="require_review"||e.packet.escalationRefs.length>0),reviewResolved:(i!=="require_review"||e.packet.escalationRefs.length>0)&&(e.packet.verdict!=="require_review"||e.packet.escalationRefs.length>0),verdict:e.packet.verdict,requiredVerdict:i,requiresHumanReview:e.packet.verdict==="require_review"||i==="require_review",missingEvidenceKinds:n,policyDecisionRefs:e.packet.policyDecisionRefs}}export function mergeEditionConnectGates(e){if(!e.packets.length)return{packetRef:"connect:missing",allowed:!1,verdict:"deny",requiredVerdict:"permit",reviewResolved:!1,requiresHumanReview:!0,missingEvidenceKinds:["packet"],policyDecisionRefs:[]};const i=e.packets.map((t)=>evaluateEditionConnectGate({packet:t})),n=i.reduce((t,o)=>c(o.verdict)>c(t.verdict)?o:t);return{packetRef:e.packets.map((t)=>t.packetRef).join("+"),allowed:i.every((t)=>t.allowed),reviewResolved:i.every((t)=>t.reviewResolved),verdict:n.verdict,requiredVerdict:n.requiredVerdict,requiresHumanReview:i.some((t)=>t.requiresHumanReview),missingEvidenceKinds:s(i.flatMap((t)=>t.missingEvidenceKinds)),policyDecisionRefs:s(i.flatMap((t)=>t.policyDecisionRefs))}}export const ManagedCompanyOsConnectReviewPacketFixture={packetRef:"connect:companyos:contract-edition-full-loop:packet",subjectEditionRef:"companyos.customer-profile.db.experiment.v2",intent:"experiment",verdict:"permit",thresholds:{protectedPathWrite:"require_review",unknownImpact:"require_review",contractDrift:"require_review",breakingChange:"require_review",destructiveCommand:"deny"},policyDecisionRefs:["policy-decision:companyos:connect-full-loop"],reviewerRefs:["connect-reviewer:contractspec"],evidenceRefs:["connect:companyos:experiment-promotion:permit","harness-run:companyos:contract-edition-full-loop","knowledge:companyos:customer-profile:canon"],escalationRefs:["approval:companyos:connect-review-resolved"]};function a(e,i){if(e==="breaking")return i.breakingChange??"require_review";if(e==="migration_required")return i.contractDrift??"require_review";return i.unknownImpact??"permit"}function d(e){const i=[];r(i,"policy",e.policyDecisionRefs);r(i,"reviewer",e.reviewerRefs);r(i,"evidence",e.evidenceRefs);if(e.verdict==="require_review")r(i,"escalation",e.escalationRefs);return i}function c(e){return{permit:0,rewrite:1,require_review:2,deny:3}[e]}function r(e,i,n){if(!n.length)e.push(i)}function s(e){return Array.from(new Set(e))}

package/dist/editions/delivery-audit.d.ts

@@ -0,0 +1,25 @@
+export interface EditionDeliveryModuleRecord {
+    moduleRef: string;
+    contractRefs: string[];
+    runtimeRefs: string[];
+    fixtureRefs: string[];
+    testRefs: string[];
+    exportRefs: string[];
+    docRefs: string[];
+}
+export interface EditionDeliveryAuditAssets {
+    exportRefs: string[];
+    testRefs: string[];
+    docRefs: string[];
+}
+export interface EditionDeliveryAuditReport {
+    complete: boolean;
+    missingByModule: Record<string, string[]>;
+    moduleRefs: string[];
+}
+export declare function evaluateEditionDeliveryAudit(input: {
+    modules: EditionDeliveryModuleRecord[];
+    assets?: EditionDeliveryAuditAssets;
+}): EditionDeliveryAuditReport;
+export declare const EditionFullLoopDeliveryAssets: EditionDeliveryAuditAssets;
+export declare const EditionFullLoopDeliveryRecords: EditionDeliveryModuleRecord[];

package/dist/editions/delivery-audit.js

@@ -0,0 +1 @@
+export function evaluateEditionDeliveryAudit(e){const i={};for(const t of e.modules){const o=a(t,e.assets);if(o.length)i[t.moduleRef]=o}return{complete:Object.keys(i).length===0,missingByModule:i,moduleRefs:e.modules.map((t)=>t.moduleRef)}}export const EditionFullLoopDeliveryAssets={exportRefs:["@lssm/lib.contracts-spec/editions","@lssm/lib.contracts-spec/editions/editor","@lssm/lib.contracts-spec/editions/storage","@lssm/lib.contracts-spec/editions/storage-file","@lssm/lib.contracts-spec/editions/storage-hybrid","@lssm/lib.contracts-spec/editions/rollback","@lssm/lib.contracts-spec/editions/experiments","@lssm/lib.contracts-spec/editions/improvement","@lssm/lib.contracts-spec/editions/companyos-scenario","@lssm/lib.contracts-spec/editions/harness-evidence","@lssm/lib.contracts-spec/editions/knowledge-provenance","@lssm/lib.contracts-spec/editions/connect-gates","@lssm/lib.contracts-spec/editions/intelligence-coach","@lssm/lib.contracts-spec/editions/enterprise-guardrails","@lssm/lib.contracts-spec/editions/ontology-boundary","@lssm/lib.contracts-spec/editions/evidence-boundary","@lssm/lib.contracts-spec/editions/storage-parity","@lssm/lib.contracts-spec/editions/delivery-audit","@lssm/lib.contracts-spec/editions/full-loop-gate","@lssm/lib.contracts-spec/editions/operation-specs","@lssm/lib.contracts-spec/editions/runtime-wiring","@lssm/example.managed-companyos-contract-editions/example"],testRefs:["test:editor","test:storage","test:storage-file","test:storage-hybrid","test:rollback","test:experiments","test:improvement","test:companyos-scenario","test:harness-evidence","test:knowledge-provenance","test:connect-gates","test:intelligence-coach","test:enterprise-guardrails","test:ontology-boundary","test:evidence-boundary","test:storage-parity","test:delivery-audit","test:full-loop-gate","test:operation-specs","test:runtime-wiring","test:managed-companyos-contract-editions-example"],docRefs:["packages/libs/contracts-spec/src/editions/README.md","packages/examples/managed-companyos-contract-editions/README.md"]};export const EditionFullLoopDeliveryRecords=[s("editor","ManagedCompanyOsEditionEditorViewFixture"),s("storage","createInMemoryDatabaseEditionAdapter"),s("storage-file","createInMemoryFileEditionAdapter"),s("storage-hybrid","createInMemoryHybridEditionSyncAdapter"),s("rollback","planEditionRollback"),s("experiments","ManagedCompanyOsEditionExperimentBindingFixture"),s("improvement","ManagedCompanyOsImprovementCandidateFixture"),s("companyos-scenario","resolveManagedCompanyOsFullLoopScenario"),s("harness-evidence","ManagedCompanyOsHarnessReplayEnvelopeFixture"),s("knowledge-provenance","ManagedCompanyOsKnowledgeProvenanceEnvelopeFixture"),s("connect-gates","ManagedCompanyOsConnectReviewPacketFixture"),s("intelligence-coach","ManagedCompanyOsCoachSuggestionFixtures"),s("enterprise-guardrails","ManagedCompanyOsEnterpriseGuardrailContextFixture"),s("ontology-boundary","evaluateEditionOntologyBoundary"),s("evidence-boundary","evaluateEditionEvidenceBoundary"),s("storage-parity","evaluateEditionStorageParity"),s("operation-specs","EditionOperationSpecs"),s("runtime-wiring","evaluateEditionRuntimeWiring"),r()];function s(e,i){return{moduleRef:e,contractRefs:[`types:${e}`],runtimeRefs:[`runtime:${i}`],fixtureRefs:[`fixture:${i}`],testRefs:[`test:${e}`],exportRefs:[`@lssm/lib.contracts-spec/editions/${e}`],docRefs:["packages/libs/contracts-spec/src/editions/README.md"]}}function r(){return{moduleRef:"managed-companyos-contract-editions-example",contractRefs:["types:managed-companyos-contract-editions-example"],runtimeRefs:["runtime:resolveManagedCompanyOsEditionsExample"],fixtureRefs:["fixture:ManagedCompanyOsEditionsExample"],testRefs:["test:managed-companyos-contract-editions-example"],exportRefs:["@lssm/example.managed-companyos-contract-editions/example"],docRefs:["packages/examples/managed-companyos-contract-editions/README.md"]}}function a(e,i){const t=[];if(!e.contractRefs.length)t.push("contracts");if(!e.runtimeRefs.length)t.push("runtime");if(!e.fixtureRefs.length)t.push("fixtures");if(!e.testRefs.length)t.push("tests");if(!e.exportRefs.length)t.push("exports");if(!e.docRefs.length)t.push("docs");if(!i)return t;if(!n(e.testRefs,i.testRefs))t.push("available-tests");if(!n(e.exportRefs,i.exportRefs))t.push("available-exports");if(!n(e.docRefs,i.docRefs))t.push("available-docs");return t}function n(e,i){return e.every((t)=>i.includes(t))}

package/dist/editions/docs.d.ts

@@ -0,0 +1,2 @@
+import type { DocBlock } from '../docs/types.js';
+export declare const tech_contracts_editions_DocBlocks: DocBlock[];

package/dist/editions/docs.js

@@ -0,0 +1,45 @@
+export const tech_contracts_editions_DocBlocks=[{id:"docs.tech.contracts.editions.lifecycle",title:"Contract editions: lifecycle, versioning, storage, and AI loops",summary:"Contract editions are lifecycle envelopes that make file-backed and database-backed contract evolution explicit, governed, replayable, and AI-editable.",kind:"reference",visibility:"public",route:"/docs/tech/contracts/editions/lifecycle",tags:["tech","contracts","editions","versioning","storage","ai-native"],body:`# Contract editions lifecycle
+
+A contract edition is the storage-agnostic lifecycle envelope around a typed TS contract. It lets humans and AI agents draft, review, experiment, publish, migrate, roll back, and archive contract changes without hiding authority, evidence, or storage behavior in runtime code.
+
+## Version taxonomy
+
+| Name | Meaning | Typical owner |
+| --- | --- | --- |
+| contractVersion | Public contract semantics, usually matching the contract meta/version. | Contract author |
+| editionVersion | Lifecycle envelope revision for a specific draft, experiment, migration, rollback, or release candidate. | Steward workflow |
+| storageRevision | Physical persistence revision: Git commit/path selector or database revision id. | Storage adapter |
+| releaseVersion | Deployment/promoted release capsule that consumed an edition. | Release workflow |
+| experimentVersion | Experiment allocation/variant revision using the edition. | Experiment owner |
+
+Rollback and migration are lifecycle states/events/evidence, not version numbers. They can create new editionVersion and storageRevision values, but the reason must stay explicit in lifecycle and evidence refs.
+
+## Storage kinds
+
+| Storage | Use when | Required evidence |
+| --- | --- | --- |
+| file | Stable source-of-truth, Git review, build/deploy reproducibility, package exports. Same-file multi-edition is allowed only with selector/build metadata. | Git/path refs; selector refs for same-file multi-edition |
+| database | Realtime collaboration, long-living processes, quick AI/human iteration, vertical-specific drafts, and live governance. | Revision/history refs and rollback refs |
+| hybrid | Sync/projection state between file and database, not a third canonical store. | Source/target refs, conflict state, sync evidence refs |
+
+## Lifecycle and authority
+
+Lifecycle states are draft, review, published, experiment, deprecated, archived, rollback, and migration. Authority is policy-per-vertical and can permit suggest-only AI, draft patches, reversible application, autonomous stewardship, human approval, or mixed control.
+
+Promotion and sync are blocked without evidence. Published editions require test, replay, rollback, and promotion evidence. Breaking and migration-required intents require migration refs. Experiments require experiment refs and an experimentVersion.
+
+## Primitive mapping matrix
+
+| Primitive | Edition role |
+| --- | --- |
+| agent-step-observability | Records AI/human suggestions, auto-apply decisions, and approval gates. |
+| ai-improvement | Produces draft patches, reversible applies, and evidence-linked improvement loops. |
+| experiments | Carries A/B allocations and experimentVersion for contract variants. |
+| ContractSpec Connect | Supplies policy verdicts, compatibility gates, and escalation evidence. |
+| release/replay capsules | Prove promoted editions are reproducible and rollback-ready. |
+| graph evolution commands | Provide human/AI editing surfaces for draft and migration flows. |
+| database contract surfaces | Persist realtime revisions, collaboration history, and rollback anchors. |
+
+## Managed CompanyOS posture
+
+Managed CompanyOS should start with file-backed published editions for stable contracts and database-backed experiment editions for fast vertical iteration. Database drafts materialize to file patches before release unless the vertical policy explicitly grants database authority for that lifecycle state.`}];

package/dist/editions/editor/fixtures.d.ts

@@ -0,0 +1,3 @@
+import type { EditionAiProposalReviewViewModel } from './types.js';
+export declare const ManagedCompanyOsAiProposalReviewFixture: EditionAiProposalReviewViewModel;
+export declare const ManagedCompanyOsEditionEditorViewFixture: import("./types").EditionEditorViewModel;

package/dist/editions/editor/fixtures.js

@@ -0,0 +1 @@
+import{ManagedCompanyOsDatabaseExperimentEditionFixture as e}from"../fixtures.js";import{resolveEditionEditorView as o}from"./resolver.js";export const ManagedCompanyOsAiProposalReviewFixture={proposalRef:"proposal:companyos:customer-profile-redesign",aiRunRef:"ai-run:contract-steward:customer-profile-redesign",risk:"medium",suggestedPatchRef:"patch:companyos:customer-profile-redesign",reversibleApplyPlanRef:"apply-plan:companyos:customer-profile-redesign",knowledgeProvenanceRefs:["knowledge:product-canon:customer-profile"],policyDecisionRefs:["policy-decision:companyos:db-experiment"],requiresHumanApproval:!0};export const ManagedCompanyOsEditionEditorViewFixture=o({edition:e,workspaceRef:"workspace:managed-companyos",presence:[{actorRef:"human:platform-reviewer",displayName:"Platform reviewer",status:"active",cursorRef:"cursor:customer-profile:title",lastSeenAt:"2026-06-06T00:05:00.000Z"}],comments:[{commentRef:"comment:customer-profile:approval-note",actorRef:"human:platform-reviewer",body:"Review growth vertical customer profile fields before experiment.",createdAt:"2026-06-06T00:06:00.000Z",resolved:!1}],approvals:[{approvalRef:"approval:customer-profile:pending-human",actorRef:"human:platform-reviewer",status:"pending",policyDecisionRef:"policy-decision:companyos:db-experiment",createdAt:"2026-06-06T00:07:00.000Z"}],timeline:[{eventRef:"event:edition-proposal-created",label:"AI proposal created",at:"2026-06-06T00:04:00.000Z",actorRef:"ai:contract-steward",evidenceRefs:["artifact:db-draft-to-file-patch"]}],proposal:ManagedCompanyOsAiProposalReviewFixture,harnessRunRefs:["harness-run:edition-editor:customer-profile"],knowledgeProvenanceRefs:["knowledge:product-canon:customer-profile"]});

package/dist/editions/editor/index.d.ts

@@ -0,0 +1,4 @@
+export * from './fixtures.js';
+export * from './resolver.js';
+export * from './schema.js';
+export * from './types.js';

package/dist/editions/editor/index.js

@@ -0,0 +1 @@
+export*from"./fixtures.js";export*from"./resolver.js";export*from"./schema.js";export*from"./types.js";

package/dist/editions/editor/resolver.d.ts

@@ -0,0 +1,2 @@
+import type { EditionEditorViewModel, ResolveEditionEditorViewInput } from './types.js';
+export declare function resolveEditionEditorView(input: ResolveEditionEditorViewInput): EditionEditorViewModel;

package/dist/editions/editor/resolver.js

@@ -0,0 +1 @@
+export function resolveEditionEditorView(e){const{edition:i}=e,t=i.evidence,o=e.baseEditionRef??i.governedFacet?.lineageRefs.at(-1);return{viewId:`edition-editor:${i.identity.editionId}`,workspaceRef:e.workspaceRef,activeEdition:i,tree:n(i),validationIssues:e.validationIssues??[],evidence:{connectVerdictRefs:t.connectVerdictRefs,testEvidenceRefs:t.testEvidenceRefs,replayEvidenceRefs:t.replayEvidenceRefs,rollbackEvidenceRefs:t.rollbackEvidenceRefs,promotionEvidenceRefs:t.promotionEvidenceRefs,migrationRefs:t.migrationRefs,experimentRefs:t.experimentRefs,policyDecisionRefs:t.policyDecisionRefs,harnessRunRefs:e.harnessRunRefs??[],knowledgeProvenanceRefs:e.knowledgeProvenanceRefs??[]},diff:{baseEditionRef:o,currentEditionRef:i.identity.editionId,changeKind:r(t.compatibilityIntent),summary:`${i.identity.subjectKey} ${i.identity.state} edition`,affectedRefs:i.governedFacet?.sourceRefs??[],comments:e.comments??[],approvals:e.approvals??[],policyDecisionRefs:t.policyDecisionRefs,canApplyReversible:i.authority.allowedModes.includes("apply_reversible")},proposal:e.proposal,presence:e.presence??[],timeline:e.timeline??[]}}function n(e){const i=d(e),t={id:e.identity.editionId,kind:"edition",label:e.identity.editionId,storageKind:e.storage.kind,state:e.identity.state,children:e.hybrid?[i,{id:`hybrid:${e.hybrid.sourceRef}->${e.hybrid.targetRef}`,kind:"hybrid_projection",label:e.hybrid.state,children:[]}]:[i]};return[{id:e.identity.subjectKey,kind:"subject",label:e.identity.subjectKey,children:[t]}]}function d(e){if(e.storage.kind==="file")return{id:`file:${e.storage.path}`,kind:"file_projection",label:e.storage.path,storageKind:"file",children:[]};return{id:e.storage.recordRef,kind:"database_projection",label:e.storage.recordRef,storageKind:"database",children:[]}}function r(e){switch(e){case"additive":return"additive";case"breaking":return"breaking";case"migration_required":return"migration";case"rollback_ready":return"rollback";case"behavior_compatible":case"experiment":return"modified"}}