@lssm/lib.contracts-spec 17.3.2

package/dist/node/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/node/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},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/node/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/node/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"}}

package/dist/node/editions/editor/schema.js

@@ -0,0 +1 @@
+import{z as e}from"zod";import{editionLifecycleSchema as i}from"../validation.js";export const editionEditorTreeNodeKindSchema=e.enum(["subject","invoice","quote","credit_note","file","form","note","policy","knowledge_doc","edition","file_projection","database_projection","hybrid_projection"]),editionEditorPresenceStatusSchema=e.enum(["active","idle","offline"]),editionEditorChangeKindSchema=e.enum(["none","additive","modified","breaking","migration","rollback"]),editionEditorApprovalStatusSchema=e.enum(["pending","approved","changes_requested","rejected"]),editionEditorTreeNodeSchema=e.lazy(()=>e.object({id:e.string().min(1),kind:editionEditorTreeNodeKindSchema,label:e.string().min(1),storageKind:e.enum(["file","database"]).optional(),state:e.string().min(1).optional(),children:e.array(editionEditorTreeNodeSchema)}).strict()),editionCollaborationPresenceSchema=e.object({actorRef:e.string().min(1),displayName:e.string().min(1),status:editionEditorPresenceStatusSchema,cursorRef:e.string().min(1).optional(),selectionRef:e.string().min(1).optional(),lastSeenAt:e.string().min(1)}).strict(),editionEditorCommentSchema=e.object({commentRef:e.string().min(1),actorRef:e.string().min(1),body:e.string().min(1),createdAt:e.string().min(1),resolved:e.boolean()}).strict(),editionEditorApprovalSchema=e.object({approvalRef:e.string().min(1),actorRef:e.string().min(1),status:editionEditorApprovalStatusSchema,policyDecisionRef:e.string().min(1).optional(),createdAt:e.string().min(1)}).strict(),editionEditorTimelineItemSchema=e.object({eventRef:e.string().min(1),label:e.string().min(1),at:e.string().min(1),actorRef:e.string().min(1),evidenceRefs:e.array(e.string().min(1))}).strict(),editionDiffReviewViewModelSchema=e.object({baseEditionRef:e.string().min(1).optional(),currentEditionRef:e.string().min(1),changeKind:editionEditorChangeKindSchema,summary:e.string().min(1),affectedRefs:e.array(e.string().min(1)),comments:e.array(editionEditorCommentSchema),approvals:e.array(editionEditorApprovalSchema),policyDecisionRefs:e.array(e.string().min(1)),canApplyReversible:e.boolean()}).strict(),editionEvidencePanelViewModelSchema=e.object({connectVerdictRefs:e.array(e.string().min(1)),testEvidenceRefs:e.array(e.string().min(1)),replayEvidenceRefs:e.array(e.string().min(1)),rollbackEvidenceRefs:e.array(e.string().min(1)),promotionEvidenceRefs:e.array(e.string().min(1)),migrationRefs:e.array(e.string().min(1)),experimentRefs:e.array(e.string().min(1)),policyDecisionRefs:e.array(e.string().min(1)),harnessRunRefs:e.array(e.string().min(1)),knowledgeProvenanceRefs:e.array(e.string().min(1))}).strict(),editionAiProposalReviewViewModelSchema=e.object({proposalRef:e.string().min(1),aiRunRef:e.string().min(1),risk:e.enum(["low","medium","high"]),suggestedPatchRef:e.string().min(1).optional(),reversibleApplyPlanRef:e.string().min(1).optional(),knowledgeProvenanceRefs:e.array(e.string().min(1)),policyDecisionRefs:e.array(e.string().min(1)),requiresHumanApproval:e.boolean()}).strict(),editionEditorViewModelSchema=e.object({viewId:e.string().min(1),workspaceRef:e.string().min(1),activeEdition:i,tree:e.array(editionEditorTreeNodeSchema),validationIssues:e.array(e.object({path:e.array(e.union([e.string(),e.number()])),message:e.string()})),evidence:editionEvidencePanelViewModelSchema,diff:editionDiffReviewViewModelSchema,proposal:editionAiProposalReviewViewModelSchema.optional(),presence:e.array(editionCollaborationPresenceSchema),timeline:e.array(editionEditorTimelineItemSchema)}).strict();

package/dist/node/editions/enterprise-guardrails.js

@@ -0,0 +1 @@
+export function evaluateEditionEnterpriseGuardrails(e){const t=[];n(t,"policy",e.context.policyDecisionRefs);n(t,"audit",e.context.auditEventRefs);n(t,"redaction",e.context.redactionRefs);n(t,"tenant-isolation",e.context.tenantIsolationRefs);n(t,"observability",e.context.observabilityRefs);n(t,"evidence",e.context.evidenceRefs);if(!e.context.tenantRef.startsWith("tenant:"))t.push("tenant-ref");const o=`isolation:${e.context.tenantRef}`;if(!e.context.tenantIsolationRefs.includes(o))t.push("tenant-isolation-match");if(!e.context.workspaceRef.startsWith("workspace:"))t.push("workspace-ref");return{ready:t.length===0,missingKinds:t,auditTrailRefs:i([...e.context.auditEventRefs,...e.context.evidenceRefs]),policyDecisionRefs:e.context.policyDecisionRefs,redactionRefs:e.context.redactionRefs,observabilityRefs:e.context.observabilityRefs}}export const ManagedCompanyOsEnterpriseGuardrailContextFixture={contextRef:"enterprise:companyos:contract-editions:guardrails",tenantRef:"tenant:managed-companyos-acme",workspaceRef:"workspace:managed-companyos",verticalRef:"vertical:managed-companyos",actorRef:"actor:contract-steward",policyDecisionRefs:["policy-decision:companyos:connect-full-loop","policy-decision:knowledge:companyos:read"],auditEventRefs:["audit:companyos:full-loop:started","audit:improvement:customer-profile:db-v2-copy-tune:evaluated"],redactionRefs:["redaction:companyos:customer-pii:masked"],tenantIsolationRefs:["isolation:tenant:managed-companyos-acme"],observabilityRefs:["trace:companyos:contract-edition-full-loop","metric:companyos:contract-edition-latency"],evidenceRefs:["harness-run:companyos:contract-edition-full-loop","replay:companyos:contract-edition-full-loop"]};function n(e,t,o){if(!o.length)e.push(t)}function i(e){return Array.from(new Set(e))}

package/dist/node/editions/evidence-boundary.js

@@ -0,0 +1 @@
+export function evaluateEditionEvidenceBoundary(e){const i=d(),r=[];for(const t of e.evidenceRefs){const c=a(t);if(!c){r.push(t);continue}i[c].push(t)}const o=e.requiredSystems.filter((t)=>i[t].length===0);return{valid:r.length===0&&o.length===0,unknownRefs:[...r,...o.map((t)=>`${t}:missing`)],coverage:i}}function a(e){if(s(e))return;if(n(e,"harness-run:"))return"harness";if(n(e,"replay:"))return"replay";if(n(e,"connect:"))return"connect";if(n(e,"knowledge:")||n(e,"knowledge-evidence:")||n(e,"knowledge-query:")||n(e,"canon:"))return"knowledge";if(n(e,"policy-decision:"))return"policy";if(n(e,"audit:"))return"audit";if(n(e,"rollback:"))return"rollback";if(n(e,"metric:"))return"metric";if(n(e,"artifact:"))return"artifact";if(n(e,"trace:"))return"trace";if(n(e,"redaction:"))return"redaction";if(n(e,"isolation:"))return"isolation";if(n(e,"coach.suggestion.offered:"))return"coach";if(n(e,"release:"))return"release";return}function n(e,i){return e.startsWith(i)&&e.slice(i.length).trim().length>0}function s(e){return/[*?[\]{}]/u.test(e)}function d(){return{harness:[],replay:[],connect:[],knowledge:[],policy:[],audit:[],rollback:[],metric:[],artifact:[],trace:[],redaction:[],isolation:[],coach:[],release:[]}}

package/dist/node/editions/experiments.js

@@ -0,0 +1 @@
+export function evaluateEditionPromotionReadiness(e){const i=e.winnerVariantRef??a(e.metrics),t=e.experiment.variants.find((r)=>r.variantRef===i),n=[];if(!i||!t)n.push("winner");if(!t?.rollbackReady)n.push("rollback");if(!["winner_selected","promoted"].includes(e.experiment.status))n.push("experiment-status");const o=e.experiment.variants.reduce((r,s)=>r+s.allocation,0);if(Math.abs(o-1)>0.001)n.push("allocation");if(e.experiment.variants.some((r)=>!r.activeScopeRefs.length))n.push("scope");if(!e.experiment.connectVerdictRefs.length)n.push("connect");if(!e.experiment.policyDecisionRefs.length)n.push("policy");if(!e.experiment.harnessRunRefs.length)n.push("harness");if(!e.experiment.testEvidenceRefs.length)n.push("test");if(!e.experiment.replayEvidenceRefs.length)n.push("replay");if(!e.experiment.promotionEvidenceRefs.length)n.push("promotion");for(const r of e.requiredEvidenceRefs)if(!c(e,r))n.push(r);return{ready:n.length===0,winnerVariantRef:i,missingEvidenceKinds:n,requiredEvidenceRefs:e.requiredEvidenceRefs}}export function resolveEditionExperimentDashboard(e){const i=evaluateEditionPromotionReadiness({experiment:e.experiment,metrics:e.metrics,requiredEvidenceRefs:e.requiredEvidenceRefs});return{dashboardId:`edition-experiment:${e.experiment.experimentRef}`,experiment:e.experiment,activeEdition:e.activeEdition,metrics:e.metrics,promotionReadiness:i,rollbackReadyVariantRefs:e.experiment.variants.filter((t)=>t.rollbackReady).map((t)=>t.variantRef)}}export const ManagedCompanyOsEditionExperimentBindingFixture={experimentRef:"experiment:customer-profile-redesign:v1",status:"winner_selected",controlVariantRef:"variant:file-v1",variants:[{variantRef:"variant:file-v1",editionRef:"companyos.customer-profile.file.v1",allocation:0.5,activeScopeRefs:["vertical:managed-companyos-core"],metricEvidenceRefs:["metric:customer-profile:file-v1:conversion"],rollbackReady:!0},{variantRef:"variant:db-v2-growth",editionRef:"companyos.customer-profile.db.experiment.v2",allocation:0.5,activeScopeRefs:["vertical:managed-companyos-growth"],metricEvidenceRefs:["metric:customer-profile:db-v2:conversion"],rollbackReady:!0}],policyDecisionRefs:["policy-decision:companyos:experiment-promotion"],connectVerdictRefs:["connect:companyos:experiment-promotion:permit"],harnessRunRefs:["harness-run:customer-profile-experiment"],testEvidenceRefs:["test:customer-profile-experiment"],replayEvidenceRefs:["replay:customer-profile-experiment"],promotionEvidenceRefs:["promotion:companyos:db-experiment:approved"]},ManagedCompanyOsEditionExperimentMetricsFixture=[{metricRef:"metric:customer-profile:conversion",label:"Customer profile completion conversion",status:"ready",winnerVariantRef:"variant:db-v2-growth",evidenceRefs:["metric:customer-profile:db-v2:conversion"]}];function a(e){return e.find((i)=>i.status==="ready")?.winnerVariantRef}function c(e,i){return e.experiment.connectVerdictRefs.includes(i)||e.experiment.policyDecisionRefs.includes(i)||e.experiment.harnessRunRefs.includes(i)||e.experiment.testEvidenceRefs.includes(i)||e.experiment.replayEvidenceRefs.includes(i)||e.experiment.promotionEvidenceRefs.includes(i)||e.experiment.variants.some((t)=>t.metricEvidenceRefs.includes(i))||e.metrics.some((t)=>t.evidenceRefs.includes(i))}

package/dist/node/editions/fixtures.js

@@ -0,0 +1 @@
+export const ManagedCompanyOsFilePublishedEditionFixture={identity:{subjectKey:"companyos.contract.customer-profile",subjectType:"managed-companyos.contract",editionKind:"contract",editionId:"companyos.customer-profile.file.v1",state:"published",createdBy:"human:platform",createdAt:"2026-06-06T00:00:00.000Z"},governedFacet:{versions:{contractVersion:"1.0.0",editionVersion:"1",storageRevision:"git:main:customer-profile",releaseVersion:"2026.06.0"},lineageRefs:[],sourceRefs:["file:packages/libs/contracts-spec/src/companyos/customer.ts"],evolutionIntent:"behavior_compatible",connectVerdictRefs:["connect:companyos:file-release:permit"]},storage:{kind:"file",path:"packages/libs/contracts-spec/src/companyos/customer.ts",branch:"main",releaseCapsuleRef:"release:companyos:2026.06.0"},authority:{policyRef:"policy:companyos:file-release",scopes:["vertical","workspace","subject_class"],storageAuthority:"file",allowedModes:["suggest","draft_patch","human_approval_required"],requiresHumanApprovalFor:["breaking","migration_required"],allowsAutonomousPromotion:!1,allowsAutonomousRollback:!1,allowsDatabaseLiveIteration:!1,requiresFileMaterializationForRelease:!0},evidence:{compatibilityIntent:"behavior_compatible",connectVerdictRefs:["connect:companyos:file-release:permit"],testEvidenceRefs:["test:companyos:file-release"],replayEvidenceRefs:["replay:companyos:file-release"],rollbackEvidenceRefs:["rollback:companyos:file-release:v0"],promotionEvidenceRefs:["promotion:companyos:file-release"],migrationRefs:[],releaseRefs:["release:companyos:2026.06.0"],experimentRefs:[],policyDecisionRefs:["policy-decision:companyos:file-release"]}},ManagedCompanyOsDatabaseExperimentEditionFixture={identity:{subjectKey:"companyos.contract.customer-profile",subjectType:"managed-companyos.contract",editionKind:"contract",editionId:"companyos.customer-profile.db.experiment.v2",state:"experiment",createdBy:"ai:contract-steward",createdAt:"2026-06-06T00:00:00.000Z"},governedFacet:{versions:{contractVersion:"2.0.0",editionVersion:"2",storageRevision:"dbrev:customer-profile:42",experimentVersion:"exp:customer-profile-redesign:1"},lineageRefs:["companyos.customer-profile.file.v1"],sourceRefs:["db:editions/companyos.customer-profile.db.experiment.v2"],evolutionIntent:"experiment",connectVerdictRefs:["connect:companyos:db-experiment:require_review"]},storage:{kind:"database",recordRef:"db:editions/companyos.customer-profile.db.experiment.v2",workspaceRef:"workspace:managed-companyos",verticalRef:"vertical:managed-companyos-growth",collaborationSessionRefs:["collab:customer-profile-redesign"],revisionRef:"dbrev:customer-profile:42",historyRefs:["history:customer-profile:1","history:customer-profile:42"],rollbackRefs:["rollback:customer-profile:file-v1"]},hybrid:{state:"db_draft_to_file_patch",sourceStorage:"database",targetStorage:"file",sourceRef:"db:editions/companyos.customer-profile.db.experiment.v2",targetRef:"file:packages/libs/contracts-spec/src/companyos/customer.ts",authoritativeStorage:"database",selectorRef:"selector:vertical:managed-companyos-growth",resolutionPolicyRef:"policy:companyos:db-to-file-materialization",evidenceRefs:["artifact:db-draft-to-file-patch"]},authority:{policyRef:"policy:companyos:database-experiment",scopes:["vertical","workspace","subject_class","lifecycle_state"],storageAuthority:"database",allowedModes:["suggest","draft_patch","apply_reversible","mixed"],requiresHumanApprovalFor:["breaking","migration_required"],allowsAutonomousPromotion:!1,allowsAutonomousRollback:!0,allowsDatabaseLiveIteration:!0,requiresFileMaterializationForRelease:!0},evidence:{compatibilityIntent:"experiment",connectVerdictRefs:["connect:companyos:db-experiment:require_review"],testEvidenceRefs:["test:companyos:db-experiment"],replayEvidenceRefs:["replay:companyos:db-experiment"],rollbackEvidenceRefs:["rollback:customer-profile:file-v1"],promotionEvidenceRefs:["promotion:companyos:db-experiment:blocked"],migrationRefs:["migration:customer-profile:v1-to-v2"],releaseRefs:[],experimentRefs:["experiment:customer-profile-redesign:v1"],policyDecisionRefs:["policy-decision:companyos:db-experiment"]}};

package/dist/node/editions/full-loop-gate.js

@@ -0,0 +1 @@
+import{resolveManagedCompanyOsFullLoopScenario as l}from"./companyos-scenario.js";import{EditionFullLoopDeliveryAssets as c,EditionFullLoopDeliveryRecords as g,evaluateEditionDeliveryAudit as m}from"./delivery-audit.js";import{evaluateEditionEvidenceBoundary as u}from"./evidence-boundary.js";import{evaluateEditionOntologyBoundary as y}from"./ontology-boundary.js";import{evaluateEditionRuntimeWiring as f}from"./runtime-wiring.js";import{evaluateEditionStorageParity as p}from"./storage-parity.js";export function evaluateManagedCompanyOsFullLoopGate(){const e=l(),s=y({editor:e.editor,dashboard:e.experimentDashboard,rollback:e.rollback,canonicalOntologyRefs:e.canonicalOntologyRefs,dataViewRefs:e.dataViewRefs}),n=f(),a=u({evidenceRefs:e.evidenceTrailRefs,requiredSystems:["harness","replay","connect","knowledge"]}),r=p({fileEditions:[e.stableFileEdition],databaseEditions:[e.databaseExperimentEdition],hybridPatchRefs:[e.hybridPatch],releaseMaterializationRefs:[e.hybridPatch.targetRef,e.releaseProjection.hybrid.targetRef]}),t=m({modules:g,assets:c}),d=[...i("ontology",s.contractBacked?[]:s.missingBindings),...i("evidence",a.valid?[]:a.unknownRefs),...i("storage",r.firstClass?[]:r.missingKinds),...i("delivery",t.complete?[]:Object.keys(t.missingByModule)),...i("runtime-wiring",n.wired?[]:n.missingKinds),...i("harness",e.harnessCoverage.ready?[]:e.harnessCoverage.missingArtifactKinds),...i("knowledge",e.knowledgeReadiness.ready?[]:e.knowledgeReadiness.missingKinds),...i("connect",e.connectGate.allowed&&e.connectGate.reviewResolved?[]:e.connectGate.missingEvidenceKinds),...i("intelligence",e.coachSurface.decisions.every((o)=>o.ready)?[]:e.coachSurface.decisions.flatMap((o)=>o.missingEvidenceKinds)),...i("enterprise",e.enterpriseGuardrailResult.ready?[]:e.enterpriseGuardrailResult.missingKinds)];return{ready:e.readyForEnterpriseReview&&d.length===0,missingKinds:d,evidenceRefs:[...e.evidenceTrailRefs,...n.operationRefs,...n.builderRefs,...n.integrationRefs]}}function i(e,s){return s.map((n)=>`${e}:${n}`)}

package/dist/node/editions/harness-evidence.js

@@ -0,0 +1 @@
+export function createEditionHarnessReplayEnvelope(e){return{envelopeRef:e.envelopeRef,sourcePackage:"@lssm/lib.harness",scenario:e.scenario,run:e.run,assertions:e.assertions,artifacts:e.artifacts,replayBundleRef:e.replayBundleRef,coveredEditionRefs:e.coveredEditionRefs,evidenceRefs:{harnessRunRefs:[e.run.runId],replayEvidenceRefs:[e.replayBundleRef],testEvidenceRefs:e.assertions.map((t)=>t.assertionKey),artifactRefs:e.artifacts.map((t)=>t.artifactId)},status:o(e.run,e.assertions)}}export function evaluateEditionHarnessCoverage(e){const t=new Set(e.envelope.artifacts.map((s)=>s.kind)),n=e.requiredArtifactKinds.filter((s)=>!t.has(s)),a=e.envelope.assertions.filter((s)=>s.status==="failed").map((s)=>s.assertionKey),r=e.envelope.run.steps.filter((s)=>s.status==="blocked").map((s)=>s.stepId);return{ready:e.envelope.status==="passed"&&n.length===0&&a.length===0&&r.length===0,missingArtifactKinds:n,failedAssertionRefs:a,blockedStepRefs:r,evidenceRefs:e.envelope.evidenceRefs}}export const ManagedCompanyOsHarnessScenarioFixture={meta:{key:"harness.scenario.contract-edition.companyos-full-loop",title:"Managed CompanyOS contract edition full-loop replay",version:"1.0.0",description:"Validate editor, DB iteration, hybrid file materialization, rollback, and promotion readiness.",domain:"contracts",stability:"beta",owners:["team:contractspec"],tags:["contracts","editions","companyos"]},target:{isolation:"preview",preferredTargets:["preview","sandbox"]},allowedModes:["deterministic-browser","code-execution"],steps:[{key:"open-editor",description:"Open the realtime contract edition editor.",actionClass:"navigate",intent:"inspect editor evidence panel",expectedEvidence:["screenshot","dom-snapshot"]},{key:"run-replay",description:"Replay the edition lifecycle and rollback path.",actionClass:"code-exec-read",intent:"prove lifecycle can be replayed without mutation",expectedEvidence:["trace","step-summary"]}],assertions:[{key:"promotion-ready",type:"json-match",description:"Promotion readiness includes Connect and harness evidence."},{key:"rollback-ready",type:"step-status",description:"Rollback replay is executable."}],requiredEvidence:["screenshot","dom-snapshot","trace","step-summary"],success:{requireAllAssertions:!0,maxBlockedSteps:0}},ManagedCompanyOsHarnessReplayEnvelopeFixture=createEditionHarnessReplayEnvelope({envelopeRef:"harness-envelope:companyos:contract-edition-full-loop",scenario:ManagedCompanyOsHarnessScenarioFixture,run:{runId:"harness-run:companyos:contract-edition-full-loop",status:"completed",mode:"deterministic-browser",scenarioKey:ManagedCompanyOsHarnessScenarioFixture.meta.key,target:{targetId:"preview:companyos-contract-editions",kind:"preview",isolation:"preview",environment:"test"},steps:ManagedCompanyOsHarnessScenarioFixture.steps.map((e)=>({stepId:`step:${e.key}`,stepKey:e.key,runId:"harness-run:companyos:contract-edition-full-loop",mode:e.mode??"deterministic-browser",actionClass:e.actionClass,verdict:"autonomous",requiresApproval:!1,status:"completed"})),evidenceCount:4,createdAt:"2026-06-06T00:00:00.000Z",updatedAt:"2026-06-06T00:01:00.000Z"},assertions:ManagedCompanyOsHarnessScenarioFixture.assertions.map((e)=>({assertionKey:e.key,status:"passed"})),artifacts:["screenshot","dom-snapshot","trace","step-summary"].map((e)=>({artifactId:`artifact:companyos:${e}`,kind:e,runId:"harness-run:companyos:contract-edition-full-loop",uri:`harness://companyos/${e}`,createdAt:"2026-06-06T00:01:00.000Z"})),replayBundleRef:"replay:companyos:contract-edition-full-loop",coveredEditionRefs:["companyos.customer-profile.file.v1","companyos.customer-profile.db.experiment.v2"]});function o(e,t){if(e.status==="blocked")return"blocked";return e.status==="completed"&&t.every((n)=>n.status==="passed")?"passed":"failed"}

package/dist/node/editions/improvement.js

@@ -0,0 +1 @@
+export function evaluateEditionImprovementCandidate(e){const o=a(e.candidate),t=d(e),n=s({candidate:e.candidate,edition:e.edition,mode:e.mode,missingEvidenceKinds:o,requiresHumanReview:t});return{candidateRef:e.candidate.candidateRef,action:n,stage:c(n),ready:n!=="block_candidate"&&o.length===0,requiresHumanReview:t,missingEvidenceKinds:o,reasonRefs:m(e.candidate,o)}}export function resolveEditionImprovementLoop(e){const o=e.state.candidates.map((t)=>evaluateEditionImprovementCandidate({candidate:t,edition:e.state.activeEdition,mode:e.state.mode}));return{loopRef:e.state.loopRef,mode:e.state.mode,stage:e.state.stage,activeEdition:e.state.activeEdition,decisions:o,suggestionQueueRefs:r(o,"suggest_only"),draftQueueRefs:r(o,"draft_patch"),humanReviewQueueRefs:r(o,"request_human_review"),autonomousActionRefs:o.filter((t)=>["apply_reversible","promote_candidate","rollback_candidate"].includes(t.action)).map((t)=>t.candidateRef),auditEventRefs:[...e.state.historyRefs,...o.flatMap((t)=>t.reasonRefs)]}}export const ManagedCompanyOsImprovementCandidateFixture={candidateRef:"improvement:customer-profile:db-v2-copy-tune",targetEditionRef:"companyos.customer-profile.db.experiment.v2",intent:"behavior_compatible",authorityMode:"apply_reversible",suggestedByRef:"intelligence:coach:contract-steward",summary:"Tune customer profile copy from observed onboarding friction.",riskLevel:"low",knowledgeProvenanceRefs:["knowledge:companyos:customer-profile:canon"],connectVerdictRefs:["connect:companyos:copy-tune:permit"],harnessRunRefs:["harness-run:customer-profile-copy-tune"],replayEvidenceRefs:["replay:customer-profile-copy-tune"],policyDecisionRefs:["policy-decision:companyos:copy-tune"],requiredEvidenceRefs:["knowledge:companyos:customer-profile:canon"],draftPatchRef:"patch:customer-profile:db-v2-copy-tune",rollbackPlanRef:"rollback:customer-profile:db-v2-copy-tune"};function a(e){const o=[];i(o,"knowledge",e.knowledgeProvenanceRefs);i(o,"connect",e.connectVerdictRefs);i(o,"harness",e.harnessRunRefs);i(o,"replay",e.replayEvidenceRefs);i(o,"policy",e.policyDecisionRefs);if(!e.rollbackPlanRef)o.push("rollback");for(const t of e.requiredEvidenceRefs)if(!p(e,t))o.push(t);return o}function d(e){return e.mode==="human_in_loop"||e.candidate.authorityMode==="human_approval_required"||e.edition.authority.requiresHumanApprovalFor.includes(e.candidate.intent)||e.candidate.riskLevel==="high"&&e.mode!=="autonomous"}function s(e){if(e.missingEvidenceKinds.length)return e.candidate.draftPatchRef?"draft_patch":"suggest_only";if(e.requiresHumanReview)return"request_human_review";if(!e.edition.authority.allowedModes.includes(e.candidate.authorityMode))return"block_candidate";if(e.candidate.intent==="rollback_ready")return e.edition.authority.allowsAutonomousRollback?"rollback_candidate":"request_human_review";if(e.candidate.intent==="experiment"&&e.candidate.experimentRef)return e.edition.authority.allowsAutonomousPromotion?"promote_candidate":"request_human_review";if(e.candidate.authorityMode==="apply_reversible")return"apply_reversible";return e.candidate.draftPatchRef?"draft_patch":"suggest_only"}function c(e){return{suggest_only:"suggest",draft_patch:"draft",request_human_review:"review",apply_reversible:"apply",promote_candidate:"promote",rollback_candidate:"rollback",block_candidate:"blocked"}[e]}function m(e,o){return[`audit:${e.candidateRef}:evaluated`,...o.map((t)=>`audit:${e.candidateRef}:missing:${t}`)]}function r(e,o){return e.filter((t)=>t.action===o).map((t)=>t.candidateRef)}function i(e,o,t){if(!t.length)e.push(o)}function p(e,o){return[...e.knowledgeProvenanceRefs,...e.connectVerdictRefs,...e.harnessRunRefs,...e.replayEvidenceRefs,...e.policyDecisionRefs].includes(o)}

package/dist/node/editions/index.js

@@ -0,0 +1 @@
+export*from"./companyos-scenario.js";export*from"./connect-gates.js";export*from"./delivery-audit.js";export*from"./docs.js";export*from"./editor/index.js";export*from"./enterprise-guardrails.js";export*from"./evidence-boundary.js";export*from"./experiments.js";export*from"./fixtures.js";export*from"./full-loop-gate.js";export*from"./harness-evidence.js";export*from"./improvement.js";export*from"./intelligence-coach.js";export*from"./knowledge-provenance.js";export*from"./ontology-boundary.js";export*from"./operation-specs.js";export*from"./rollback.js";export*from"./runtime-wiring.js";export*from"./schema.js";export*from"./storage.js";export*from"./storage-parity.js";export*from"./types.js";export*from"./validation.js";

package/dist/node/editions/intelligence-coach.js

@@ -0,0 +1 @@
+import{coachOperationPartial as n}from"../operations/registry.coach.js";export function resolveEditionCoachWorkflowSurface(e){const i=e.suggestions.map((o)=>s({suggestion:o,minimumConfidence:e.minimumConfidence}));return{surfaceRef:e.surfaceRef,capabilityRef:"coach.suggest",operationKeys:Object.keys(n),suggestions:e.suggestions,decisions:i,reviewQueueRefs:i.filter((o)=>o.requiresReview).map((o)=>o.suggestionRef),workflowActionRefs:i.filter((o)=>o.ready&&!o.requiresReview).map((o)=>o.suggestionRef),feedbackEventRefs:i.map((o)=>o.feedbackEventRef)}}export const ManagedCompanyOsCoachSuggestionFixtures=[{suggestionRef:"coach:companyos:copy-tune:suggestion",operationKey:"workflow.coach.suggest-step",surface:"workflow",targetEditionRef:"companyos.customer-profile.db.experiment.v2",title:"Apply reversible copy-tune after harness replay passes.",rationale:"Customer-profile onboarding friction is backed by product canon and replay evidence.",confidence:0.91,linkedImprovementCandidateRef:"improvement:customer-profile:db-v2-copy-tune",requiredReviewRefs:[],evidenceRefs:["knowledge:companyos:customer-profile:canon","harness-run:companyos:contract-edition-full-loop","connect:companyos:contract-edition-full-loop:packet"],status:"offered"},{suggestionRef:"coach:companyos:governance-review:suggestion",operationKey:"governance.coach.suggest-constraint",surface:"governance",targetEditionRef:"companyos.customer-profile.db.experiment.v2",title:"Ask reviewer to approve future breaking migrations.",rationale:"Breaking migrations remain human-gated by vertical policy.",confidence:0.86,requiredReviewRefs:["approval:companyos:platform-reviewer"],evidenceRefs:["policy-decision:companyos:connect-full-loop"],status:"offered"}];function s(e){const i=[];if(!e.suggestion.evidenceRefs.length)i.push("evidence");if(!n[e.suggestion.operationKey])i.push("coach-operation");if(e.suggestion.confidence<e.minimumConfidence)i.push("confidence");return{suggestionRef:e.suggestion.suggestionRef,ready:i.length===0,requiresReview:e.suggestion.requiredReviewRefs.length>0,missingEvidenceKinds:i,feedbackEventRef:`coach.suggestion.offered:${e.suggestion.suggestionRef}`}}

package/dist/node/editions/knowledge-provenance.js

@@ -0,0 +1 @@
+import{productCanonKnowledgeSpace as c}from"../knowledge/spaces/product-canon.js";export function createEditionKnowledgeProvenanceEnvelope(e){return{envelopeRef:e.envelopeRef,sourcePackage:"@lssm/lib.knowledge",space:e.space,verticalRef:e.verticalRef,canonRefs:e.canonRefs,fragmentRefs:e.fragmentRefs,queryEvidenceRefs:e.queryEvidenceRefs,policyDecisionRefs:e.policyDecisionRefs,freshness:e.freshness,trustLevel:e.space.access.trustLevel}}export function evaluateEditionKnowledgeReadiness(e){const n=[];if(e.envelope.sourcePackage!=="@lssm/lib.knowledge")n.push("sourcePackage");if(e.envelope.space.meta.category!=="canonical")n.push("canonical-space");if(e.envelope.trustLevel!=="high")n.push("high-trust");if(e.envelope.freshness!=="fresh")n.push("freshness");s(n,"fragment",e.envelope.fragmentRefs);s(n,"query-evidence",e.envelope.queryEvidenceRefs);s(n,"policy",e.envelope.policyDecisionRefs);for(const o of e.requiredCanonRefs)if(!e.envelope.canonRefs.includes(o))n.push(o);return{ready:n.length===0,missingKinds:n,knowledgeProvenanceRefs:[e.envelope.envelopeRef,...e.envelope.fragmentRefs.map((o)=>o.evidenceRef),...e.envelope.queryEvidenceRefs],canonicalRefs:e.envelope.canonRefs}}export const ManagedCompanyOsKnowledgeProvenanceEnvelopeFixture=createEditionKnowledgeProvenanceEnvelope({envelopeRef:"knowledge:companyos:customer-profile:canon",space:c,verticalRef:"vertical:managed-companyos",canonRefs:["canon:companyos:customer-profile","canon:companyos:contract-edition-policy"],fragmentRefs:[{fragmentRef:"knowledge://knowledge.product-canon/customer-profile",spaceKey:c.meta.key,sourceRef:"source:product-canon:customer-profile",canonicalRef:"canon:companyos:customer-profile",evidenceRef:"knowledge-evidence:customer-profile-canon",observedAt:"2026-06-06T00:00:00.000Z"}],queryEvidenceRefs:["knowledge-query:companyos:customer-profile"],policyDecisionRefs:["policy-decision:knowledge:companyos:read"],freshness:"fresh"});function s(e,n,o){if(!o.length)e.push(n)}

package/dist/node/editions/ontology-boundary.js

@@ -0,0 +1 @@
+export function evaluateEditionOntologyBoundary(i){const e=[],o=i.canonicalOntologyRefs??[],d=i.dataViewRefs??[],t=i.editor.activeEdition.identity.editionId;if(i.editor.diff.currentEditionRef!==t)e.push("editor.diff.currentEditionRef");if(!r(i.editor.tree,i.editor.activeEdition.identity.subjectKey))e.push("editor.tree.subjectKey");if(i.dashboard.activeEdition.identity.editionId!==t&&!i.dashboard.experiment.variants.some((n)=>n.editionRef===i.dashboard.activeEdition.identity.editionId))e.push("dashboard.activeEdition");const a=i.editor.activeEdition.governedFacet?.lineageRefs??[];if(i.rollback.preview.editionId!==t&&!a.includes(i.rollback.preview.targetEditionRef))e.push("rollback.preview.editionId");if(!o.includes("ontology:companyos:contract-editions"))e.push("canonical.ontologyRef");if(!d.some((n)=>n.key==="contract-edition.full-loop.dashboard"))e.push("canonical.dataViewRef");return{contractBacked:e.length===0,missingBindings:e,boundEditionRefs:s([t,i.dashboard.activeEdition.identity.editionId,i.rollback.preview.editionId,i.rollback.preview.targetEditionRef]),canonicalOntologyRefs:o,dataViewRefs:d}}function r(i,e){return i.some((o)=>o.id===e||r(o.children,e))}function s(i){return Array.from(new Set(i))}

package/dist/node/editions/operation-specs.js

@@ -0,0 +1 @@
+import{ScalarTypeEnum as e,SchemaModel as t}from"@lssm/lib.schema";import{defineCommand as a,defineQuery as r}from"../operations/index.js";import{StabilityEnum as p}from"../ownership.js";const n=new t({name:"EditionOperationInput",fields:{editionRef:{type:e.String_unsecure(),isOptional:!1},tenantRef:{type:e.String_unsecure(),isOptional:!1},actorRef:{type:e.String_unsecure(),isOptional:!1},idempotencyKey:{type:e.String_unsecure(),isOptional:!1}}}),l=new t({name:"EditionFullLoopEvaluateInput",fields:{scenarioRef:{type:e.String_unsecure(),isOptional:!1},tenantRef:{type:e.String_unsecure(),isOptional:!1}}}),d=new t({name:"EditionFullLoopEvaluateOutput",fields:{ready:{type:e.Boolean(),isOptional:!1},missingKinds:{type:e.String_unsecure(),isOptional:!1,isArray:!0},evidenceRefs:{type:e.String_unsecure(),isOptional:!1,isArray:!0}}}),s=new t({name:"EditionMutationOutput",fields:{accepted:{type:e.Boolean(),isOptional:!1},editionRef:{type:e.String_unsecure(),isOptional:!1},auditEventRefs:{type:e.String_unsecure(),isOptional:!1,isArray:!0},replayPacketRefs:{type:e.String_unsecure(),isOptional:!1,isArray:!0}}}),o={domain:"editions",owners:["team-contractspec"],tags:["editions","companyos","full-loop"],stability:p.Experimental};export const EditionFullLoopEvaluateQuery=r({meta:{...o,key:"edition.full-loop.evaluate",title:"Evaluate Edition Full Loop",version:"1.0.0",description:"Evaluate whether a tenant-scoped edition loop is fully wired across specs, storage, builder/runtime, integrations, examples, and evidence gates.",goal:"Give humans and agents one read contract for enterprise readiness before promoting a managed vertical edition.",context:"Read-only gate used by Managed CompanyOS dashboards, autonomous improvement loops, and release capsules. It returns missing categories instead of silently self-attesting readiness."},io:{input:l,output:d},policy:{auth:"user",permissions:["editions.read"],pii:[]},transport:{rest:{method:"GET",path:"/editions/full-loop/evaluate"},mcp:{toolName:"edition_full_loop_evaluate_v1"}},sideEffects:{audit:["edition.full-loop.evaluated"]},outputDataView:{key:"edition.full-loop.dashboard",version:"1.0.0"}}),EditionImprovementProposeCommand=a({meta:{...o,key:"edition.improvement.propose",title:"Propose Edition Improvement",version:"1.0.0",description:"Create a draft improvement proposal for a edition from human, AI, harness, knowledge, or integration feedback.",goal:"Make AI-native contract evolution editable through chat or UI while preserving audit, replay, and human-review hooks.",context:"Write contract for autonomous or human-in-the-loop improvement systems. Handlers must persist evidence refs and remain tenant isolated."},io:{input:n,output:s},policy:{auth:"user",permissions:["editions.improve"],pii:[],escalate:"human_review"},transport:{rest:{method:"POST",path:"/editions/improvements"},mcp:{toolName:"edition_improvement_propose_v1"}},sideEffects:{audit:["edition.improvement.proposed"],analytics:["edition.improvement.proposed"]}}),EditionReleaseProjectCommand=a({meta:{...o,key:"edition.release.project",title:"Project Edition Release",version:"1.0.0",description:"Project an approved file or database edition release across storage backends and runtime adapters.",goal:"Close the file/database storage loop so git-backed releases and dynamic database runtimes converge with rollback evidence.",context:"Used after promotion or rollback approval. Handlers must emit audit/replay refs and prove storage parity across file, database, and hybrid adapters."},io:{input:n,output:s},policy:{auth:"admin",permissions:["editions.release"],pii:[],escalate:"human_review"},transport:{rest:{method:"POST",path:"/editions/releases/project"},mcp:{toolName:"edition_release_project_v1"}},sideEffects:{audit:["edition.release.projected"],analytics:["edition.release.projected"]}}),EditionOperationSpecs=Object.freeze({[EditionFullLoopEvaluateQuery.meta.key]:EditionFullLoopEvaluateQuery,[EditionImprovementProposeCommand.meta.key]:EditionImprovementProposeCommand,[EditionReleaseProjectCommand.meta.key]:EditionReleaseProjectCommand}),EditionOperationSpecRefs=Object.freeze(Object.values(EditionOperationSpecs).map((i)=>({key:i.meta.key,version:i.meta.version,kind:i.meta.kind})));

package/dist/node/editions/rollback.js

@@ -0,0 +1 @@
+export function planEditionRollback(e){const i=`rollback-plan:${e.edition.identity.editionId}:to:${e.targetEditionRef}`,t=n(e.edition),o=[...e.edition.evidence.rollbackEvidenceRefs,...e.harnessRunRefs,e.replayPacketRef],r={rollbackRef:i,editionId:e.edition.identity.editionId,targetEditionRef:e.targetEditionRef,impacts:t,requiredApprovalRefs:e.approvalRefs,requiredEvidenceRefs:o,replayPacketRef:e.replayPacketRef,canExecute:e.approvalRefs.length>0&&e.edition.evidence.rollbackEvidenceRefs.length>0&&e.harnessRunRefs.length>0&&e.replayPacketRef.length>0};return{rollbackRef:i,preview:r,steps:a(r)}}export function executeEditionRollback(e){if(!e.preview.canExecute)return{rollbackRef:e.rollbackRef,status:"blocked",executedStepRefs:[],remainingStepRefs:e.steps.map((i)=>i.stepRef),replayPacketRef:e.preview.replayPacketRef,auditEventRefs:[]};return{rollbackRef:e.rollbackRef,status:"executed",executedStepRefs:e.steps.map((i)=>i.stepRef),remainingStepRefs:[],replayPacketRef:e.preview.replayPacketRef,auditEventRefs:[`audit:${e.rollbackRef}:executed`]}}export function resolveEditionRollbackView(e,i){return{preview:e.preview,plan:e,execution:i}}export function planEditionMigration(e){return{migrationRef:`migration:${e.edition.identity.editionId}:to:${e.targetContractVersion}`,sourceEditionRef:e.edition.identity.editionId,targetContractVersion:e.targetContractVersion,compatibilityIntent:e.edition.evidence.compatibilityIntent,affectedConsumerRefs:[...e.affectedConsumerRefs],requiredApprovalRefs:[...e.approvalRefs],evidenceRefs:[...e.evidenceRefs,...e.edition.evidence.migrationRefs]}}function n(e){const i=[{projection:e.storage.kind,ref:e.storage.kind==="file"?e.storage.path:e.storage.recordRef,risk:e.storage.kind==="file"?"medium":"high",reason:`${e.storage.kind} projection will be restored`}];if(e.hybrid)i.push({projection:"hybrid",ref:`${e.hybrid.sourceRef}->${e.hybrid.targetRef}`,risk:"high",reason:"hybrid projection must be reconciled after rollback"});return i}function a(e){return[{stepRef:`${e.rollbackRef}:validate-evidence`,kind:"validate_evidence",label:"Validate rollback approvals and evidence",evidenceRefs:e.requiredEvidenceRefs},...e.impacts.map((i,t)=>({stepRef:`${e.rollbackRef}:impact-${t+1}`,kind:i.projection==="file"?"restore_file_projection":i.projection==="database"?"restore_database_projection":"sync_hybrid_projection",label:i.reason,evidenceRefs:e.requiredEvidenceRefs})),{stepRef:`${e.rollbackRef}:run-replay`,kind:"run_replay",label:"Run replay verification after rollback",evidenceRefs:[e.replayPacketRef]},{stepRef:`${e.rollbackRef}:record-audit`,kind:"record_audit",label:"Record rollback audit event",evidenceRefs:e.requiredEvidenceRefs}]}

package/dist/node/editions/runtime-wiring.js

@@ -0,0 +1 @@
+import{EditionOperationSpecRefs as r}from"./operation-specs.js";export const ManagedCompanyOsEditionRuntimeWiringReport={wired:!0,missingKinds:[],operationRefs:r.map((e)=>`${e.kind}:${e.key}@${e.version}`),builderRefs:["@lssm/lib.builder-runtime:delivery-loop","@lssm/lib.builder-runtime:release-capsule","@lssm/lib.builder-runtime:contract-intelligence"],runtimeRefs:["@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/full-loop-gate"],integrationRefs:["integration:contractspec-connect:review-gate","integration:companyos:tenant-isolation","integration:companyos:release-audit"],intelligenceRefs:["intelligence:coach-surface:contract-editions","intelligence:autonomous-improvement-loop","knowledge:companyos:customer-profile-canon"],exampleRefs:["@lssm/example.managed-companyos-contract-editions/example"],capabilities:[s("capability:contract-edition.spec-operations","operation-specs",["test:operation-specs","export:operation-specs"]),s("capability:contract-edition.builder-runtime","runtime-wiring",["test:runtime-wiring","example:managed-companyos-contract-editions"]),s("capability:contract-edition.integration-gates","connect-gates",["connect:companyos:experiment-promotion:permit","approval:companyos:connect-review-resolved"])]};export function evaluateEditionRuntimeWiring(e={}){const i={...ManagedCompanyOsEditionRuntimeWiringReport,...e,capabilities:e.capabilities??ManagedCompanyOsEditionRuntimeWiringReport.capabilities},n=[...t("operation-specs",i.operationRefs),...t("builder-runtime",i.builderRefs),...t("runtime-adapters",i.runtimeRefs),...t("integration-contracts",i.integrationRefs),...t("intelligence-system",i.intelligenceRefs),...t("examples",i.exampleRefs),...i.capabilities.flatMap((o)=>o.evidenceRefs.length?[]:[`capability-evidence:${o.capabilityRef}`])];return{...i,wired:n.length===0,missingKinds:n}}function s(e,i,n){return{capabilityRef:e,moduleRef:i,evidenceRefs:n}}function t(e,i){return i.length?[]:[e]}

package/dist/node/editions/schema.js

@@ -0,0 +1 @@
+import{z as e}from"zod";export const editionLifecycleStateSchema=e.enum(["draft","review","published","experiment","deprecated","archived","rollback","migration"]),editionStorageKindSchema=e.enum(["file","database"]),editionHybridStateSchema=e.enum(["db_draft_to_file_patch","file_release_to_db_published","in_sync","diverged","file_authoritative_conflict","database_authoritative_conflict","manual_resolution_required","sync_failed","sync_resolved"]),editionEvolutionIntentSchema=e.enum(["additive","behavior_compatible","breaking","experiment","migration_required","rollback_ready"]),editionAuthorityModeSchema=e.enum(["suggest","draft_patch","apply_reversible","autonomous_steward","human_approval_required","mixed"]),editionKindSchema=e.enum(["invoice","quote","credit_note","contract","file","form","note","policy","knowledge_doc"]),editionVersionSetSchema=e.object({contractVersion:e.string().min(1),editionVersion:e.string().min(1),storageRevision:e.string().min(1),releaseVersion:e.string().min(1).optional(),experimentVersion:e.string().min(1).optional()}).strict(),editionIdentitySchema=e.object({subjectKey:e.string().min(1),subjectType:e.string().min(1),editionKind:editionKindSchema,editionId:e.string().min(1),state:editionLifecycleStateSchema,createdBy:e.string().min(1),createdAt:e.string().min(1)}).strict(),governedEditionFacetSchema=e.object({versions:editionVersionSetSchema,evolutionIntent:editionEvolutionIntentSchema,connectVerdictRefs:e.array(e.string().min(1)),lineageRefs:e.array(e.string().min(1)),sourceRefs:e.array(e.string().min(1)).min(1)}).strict(),editionFileProjectionSchema=e.object({kind:e.literal("file"),path:e.string().min(1),gitRef:e.string().min(1).optional(),commitSha:e.string().min(1).optional(),branch:e.string().min(1).optional(),tag:e.string().min(1).optional(),releaseCapsuleRef:e.string().min(1).optional(),multiEditionSelector:e.string().min(1).optional(),buildSelectorRef:e.string().min(1).optional(),deploySelectorRef:e.string().min(1).optional()}).strict(),editionDatabaseProjectionSchema=e.object({kind:e.literal("database"),recordRef:e.string().min(1),workspaceRef:e.string().min(1),verticalRef:e.string().min(1).optional(),customerRef:e.string().min(1).optional(),collaborationSessionRefs:e.array(e.string().min(1)),revisionRef:e.string().min(1),historyRefs:e.array(e.string().min(1)).min(1),rollbackRefs:e.array(e.string().min(1)).min(1)}).strict(),editionHybridProjectionSchema=e.object({state:editionHybridStateSchema,sourceStorage:editionStorageKindSchema,targetStorage:editionStorageKindSchema,sourceRef:e.string().min(1),targetRef:e.string().min(1),authoritativeStorage:editionStorageKindSchema.optional(),selectorRef:e.string().min(1).optional(),conflictReason:e.string().min(1).optional(),resolutionPolicyRef:e.string().min(1).optional(),divergenceRef:e.string().min(1).optional(),evidenceRefs:e.array(e.string().min(1))}).strict(),editionAuthorityPolicySchema=e.object({policyRef:e.string().min(1),scopes:e.array(e.enum(["vertical","workspace","customer","subject_class","lifecycle_state"])).min(1),storageAuthority:editionStorageKindSchema,allowedModes:e.array(editionAuthorityModeSchema).min(1),requiresHumanApprovalFor:e.array(editionEvolutionIntentSchema),allowsAutonomousPromotion:e.boolean(),allowsAutonomousRollback:e.boolean(),allowsDatabaseLiveIteration:e.boolean(),requiresFileMaterializationForRelease:e.boolean()}).strict(),editionEvidenceSchema=e.object({compatibilityIntent:editionEvolutionIntentSchema,connectVerdictRefs:e.array(e.string().min(1)),testEvidenceRefs:e.array(e.string().min(1)),replayEvidenceRefs:e.array(e.string().min(1)),rollbackEvidenceRefs:e.array(e.string().min(1)),promotionEvidenceRefs:e.array(e.string().min(1)),migrationRefs:e.array(e.string().min(1)),releaseRefs:e.array(e.string().min(1)),experimentRefs:e.array(e.string().min(1)),policyDecisionRefs:e.array(e.string().min(1))}).strict();

package/dist/node/editions/storage-file.js

@@ -0,0 +1 @@
+export class InMemoryFileEditionAdapter{editions=new Map;patches=[];constructor(e=[]){for(const i of e){n(i);this.editions.set(r(i),structuredClone(i))}}getEditionByPath(e,i){return this.listFileEditions(e).find((t)=>t.storage.kind==="file"&&(!i||t.storage.multiEditionSelector===i))}listFileEditions(e){return Array.from(this.editions.values()).filter((i)=>i.storage.kind==="file"&&(!e||i.storage.path===e)).map((i)=>structuredClone(i))}materializePatch(e){if(e.edition.storage.kind!=="file")throw Error("FileEditionAdapter only accepts file-backed editions.");const i={patchRef:`patch:${e.edition.identity.editionId}:${this.patches.length+1}`,editionId:e.edition.identity.editionId,path:e.edition.storage.path,baseRef:e.baseRef,targetRef:e.targetRef,selectorRef:e.edition.storage.multiEditionSelector,evidenceRefs:[...e.evidenceRefs]};this.patches.push(i);return{...i,evidenceRefs:[...i.evidenceRefs]}}listPatches(){return this.patches.map((e)=>({...e,evidenceRefs:[...e.evidenceRefs]}))}}export function createInMemoryFileEditionAdapter(e=[]){return new InMemoryFileEditionAdapter(e)}function n(e){if(e.storage.kind!=="file")throw Error("FileEditionAdapter only accepts file-backed editions.")}function r(e){if(e.storage.kind!=="file")throw Error("FileEditionAdapter only accepts file-backed editions.");return`${e.storage.path}:${e.storage.multiEditionSelector??"default"}`}

package/dist/node/editions/storage-hybrid.js

@@ -0,0 +1 @@
+export class InMemoryHybridEditionSyncAdapter{materializeDatabaseDraftToFilePatch(e){if(e.databaseEdition.storage.kind!=="database")throw Error("Hybrid DB-to-file sync requires a database edition.");const i=a(e.databaseEdition),t=e.fileAdapter.materializePatch({edition:i,baseRef:e.baseRef,targetRef:e.targetRef,evidenceRefs:e.evidenceRefs});return{hybrid:{state:"db_draft_to_file_patch",sourceStorage:"database",targetStorage:"file",sourceRef:e.databaseEdition.storage.recordRef,targetRef:`file:${t.path}`,authoritativeStorage:"database",evidenceRefs:[...e.evidenceRefs]},patch:t,evidenceRefs:[...e.evidenceRefs]}}projectFileReleaseToDatabase(e){r(e.fileEdition,e.databaseEdition);const i=e.fileEdition.storage.kind==="file"?e.fileEdition.storage.path:"",t=e.databaseAdapter.upsertEdition({edition:e.databaseEdition,actorRef:e.actorRef,evidenceRefs:e.evidenceRefs});if(t.storage.kind!=="database")throw Error("Hybrid file-to-DB sync requires database projection.");return{hybrid:{state:"file_release_to_db_published",sourceStorage:"file",targetStorage:"database",sourceRef:`file:${i}`,targetRef:t.storage.recordRef,authoritativeStorage:"file",evidenceRefs:[...e.evidenceRefs]},databaseEdition:t,evidenceRefs:[...e.evidenceRefs]}}}export function createInMemoryHybridEditionSyncAdapter(){return new InMemoryHybridEditionSyncAdapter}function r(e,i){if(e.storage.kind!=="file")throw Error("Hybrid file-to-DB sync requires a file edition.");if(i.storage.kind!=="database")throw Error("Hybrid file-to-DB sync requires a database projection.");if(i.identity.state!=="published")throw Error("Hybrid file-to-DB sync requires a published DB projection.");if(e.identity.subjectKey!==i.identity.subjectKey)throw Error("Hybrid file-to-DB sync requires matching subject keys.");if(e.identity.subjectType!==i.identity.subjectType)throw Error("Hybrid file-to-DB sync requires matching subject types.");if(!(i.governedFacet?.lineageRefs.includes(e.identity.editionId)??!1))throw Error("Hybrid file-to-DB sync requires DB lineage to include the file release.");if(!i.evidence.releaseRefs.length)throw Error("Hybrid file-to-DB sync requires release evidence refs.");if(!i.evidence.promotionEvidenceRefs.length)throw Error("Hybrid file-to-DB sync requires promotion evidence refs.");if(!i.evidence.replayEvidenceRefs.length)throw Error("Hybrid file-to-DB sync requires replay evidence refs.")}function a(e){if(e.storage.kind!=="database")throw Error("Hybrid DB-to-file sync requires a database edition.");return{...e,storage:{kind:"file",path:e.hybrid?.targetRef.replace(/^file:/,"")??e.governedFacet?.sourceRefs[0]??e.identity.editionId,multiEditionSelector:e.hybrid?.selectorRef,buildSelectorRef:e.hybrid?.selectorRef}}}

package/dist/node/editions/storage-parity.js

@@ -0,0 +1 @@
+export function evaluateEditionStorageParity(e){const a=e.fileEditions.filter((i)=>i.storage.kind==="file").map((i)=>i.identity.editionId),n=e.databaseEditions.filter((i)=>i.storage.kind==="database").map((i)=>i.identity.editionId),s=e.hybridPatchRefs.map((i)=>i.patchRef),t=[];if(!a.length)t.push("file-edition");if(!n.length)t.push("database-edition");if(!s.length)t.push("hybrid-patch");if(!e.releaseMaterializationRefs.length)t.push("release-materialization");return{firstClass:t.length===0,missingKinds:t,fileEditionRefs:a,databaseEditionRefs:n,hybridPatchRefs:s}}

package/dist/node/editions/storage.js

@@ -0,0 +1 @@
+export class InMemoryDatabaseEditionAdapter{editions=new Map;auditEvents=[];constructor(e=[]){for(const t of e){o(t);this.editions.set(t.identity.editionId,n(t))}}getEdition(e){const t=this.editions.get(e);return t?n(t):void 0}listEditions(e){return Array.from(this.editions.values()).filter((t)=>a(t,e)).filter((t)=>!e.subjectKey||t.identity.subjectKey===e.subjectKey).map(n)}upsertEdition(e){o(e.edition);const t=this.editions.get(e.edition.identity.editionId);if(t&&e.expectedRevisionRef&&t.storage.kind==="database"&&t.storage.revisionRef!==e.expectedRevisionRef)throw Error(`Edition revision conflict: expected ${e.expectedRevisionRef}, got ${t.storage.revisionRef}`);const i=n(e.edition);this.editions.set(i.identity.editionId,i);this.auditEvents.push({eventRef:`event:${i.identity.editionId}:${t?"updated":"created"}:${this.auditEvents.length+1}`,editionId:i.identity.editionId,actorRef:e.actorRef,kind:t?"updated":"created",at:i.identity.createdAt,evidenceRefs:e.evidenceRefs??i.evidence.policyDecisionRefs});return n(i)}appendRollbackAnchor(e,t){const i=this.editions.get(e);if(!i)throw Error(`Edition not found: ${e}`);if(i.storage.kind!=="database")throw Error("DatabaseEditionAdapter only accepts database-backed editions.");if(!i.storage.rollbackRefs.includes(t))i.storage.rollbackRefs=[...i.storage.rollbackRefs,t];this.auditEvents.push({eventRef:`event:${e}:rollback-anchor:${this.auditEvents.length+1}`,editionId:e,actorRef:"system:database-edition-adapter",kind:"rollback_anchor_recorded",at:i.identity.createdAt,evidenceRefs:[t]});return n(i)}getAuditEvents(e){return this.auditEvents.filter((t)=>t.editionId===e).map((t)=>({...t,evidenceRefs:[...t.evidenceRefs]}))}snapshot(){return{editions:Array.from(this.editions.values()).map(n),auditEvents:this.auditEvents.map((e)=>({...e,evidenceRefs:[...e.evidenceRefs]}))}}}export function createInMemoryDatabaseEditionAdapter(e=[]){return new InMemoryDatabaseEditionAdapter(e)}function o(e){if(e.storage.kind!=="database")throw Error("DatabaseEditionAdapter only accepts database-backed editions.")}function a(e,t){if(e.storage.kind!=="database")return!1;return e.storage.workspaceRef===t.workspaceRef&&(!t.verticalRef||e.storage.verticalRef===t.verticalRef)&&(!t.customerRef||e.storage.customerRef===t.customerRef)}function n(e){return structuredClone(e)}export*from"./storage-file.js";export*from"./storage-hybrid.js";

package/dist/node/editions/validation.js

@@ -0,0 +1 @@
+import{z as t}from"zod";import{editionAuthorityPolicySchema as n,editionDatabaseProjectionSchema as d,editionEvidenceSchema as c,editionFileProjectionSchema as u,editionHybridProjectionSchema as m,editionIdentitySchema as f,governedEditionFacetSchema as l}from"./schema.js";export{editionAuthorityModeSchema,editionAuthorityPolicySchema,editionDatabaseProjectionSchema,editionEvidenceSchema,editionEvolutionIntentSchema,editionFileProjectionSchema,editionHybridProjectionSchema,editionHybridStateSchema,editionIdentitySchema,editionKindSchema,editionLifecycleStateSchema,editionStorageKindSchema,editionVersionSetSchema,governedEditionFacetSchema}from"./schema.js";export const editionLifecycleSchema=t.object({identity:f,governedFacet:l.optional(),storage:t.union([u,d]),hybrid:m.optional(),authority:n,evidence:c}).strict().superRefine((e,i)=>{if(r(e.identity.editionKind)&&!e.governedFacet)i.addIssue({code:t.ZodIssueCode.custom,message:"governed edition kinds require governedFacet",path:["governedFacet"]});if(!r(e.identity.editionKind)&&e.governedFacet)i.addIssue({code:t.ZodIssueCode.custom,message:"inert edition kinds must not carry governedFacet",path:["governedFacet"]});if(e.identity.state==="published")s(i,[["connectVerdictRefs",e.evidence.connectVerdictRefs],["testEvidenceRefs",e.evidence.testEvidenceRefs],["replayEvidenceRefs",e.evidence.replayEvidenceRefs],["rollbackEvidenceRefs",e.evidence.rollbackEvidenceRefs],["promotionEvidenceRefs",e.evidence.promotionEvidenceRefs],["policyDecisionRefs",e.evidence.policyDecisionRefs]]);if(e.evidence.compatibilityIntent==="breaking"||e.evidence.compatibilityIntent==="migration_required")s(i,[["migrationRefs",e.evidence.migrationRefs]]);if(e.identity.state==="experiment"){s(i,[["experimentRefs",e.evidence.experimentRefs]]);if(!e.governedFacet?.versions.experimentVersion)i.addIssue({code:t.ZodIssueCode.custom,message:"experiment editions require experimentVersion",path:["governedFacet","versions","experimentVersion"]})}if(e.storage.kind==="file"){if(!Boolean(e.storage.gitRef??e.storage.commitSha??e.storage.branch??e.storage.tag)&&!e.storage.multiEditionSelector)i.addIssue({code:t.ZodIssueCode.custom,message:"file storage requires a Git ref or same-file multi-edition selector",path:["storage"]});if(e.storage.multiEditionSelector&&!e.storage.buildSelectorRef)i.addIssue({code:t.ZodIssueCode.custom,message:"same-file multi-edition storage requires build selector metadata",path:["storage","buildSelectorRef"]})}if(e.storage.kind==="database"){if(!e.storage.historyRefs.length||!e.storage.rollbackRefs.length)i.addIssue({code:t.ZodIssueCode.custom,message:"database-backed mutable editions require history and rollback refs",path:["storage"]})}if(e.hybrid){if(e.hybrid.sourceStorage===e.hybrid.targetStorage)i.addIssue({code:t.ZodIssueCode.custom,message:"hybrid sync must bridge different storage kinds",path:["hybrid"]});if(!e.hybrid.evidenceRefs.length)i.addIssue({code:t.ZodIssueCode.custom,message:"hybrid sync states require evidence refs",path:["hybrid","evidenceRefs"]})}if(e.authority.allowsAutonomousPromotion&&e.authority.requiresHumanApprovalFor.includes(e.evidence.compatibilityIntent))i.addIssue({code:t.ZodIssueCode.custom,message:"autonomous promotion conflicts with human approval policy for this evolution intent",path:["authority","allowsAutonomousPromotion"]})});function r(e){return["contract","invoice","quote","credit_note"].includes(e)}function s(e,i){for(const[o,a]of i)if(!a.length)e.addIssue({code:t.ZodIssueCode.custom,message:`${o} are required for this edition lifecycle state`,path:["evidence",o]})}function h(e){return e.issues.map((i)=>({path:i.path.filter((o)=>typeof o==="string"||typeof o==="number"),message:i.message}))}export function validateEditionLifecycle(e){const i=editionLifecycleSchema.safeParse(e);if(!i.success)return{valid:!1,issues:h(i.error)};return{valid:!0,value:i.data,issues:[]}}

package/dist/node/entities/compatibility.js

@@ -0,0 +1,20 @@
+const o=["defineContractEntity","defineContractEdge","EntityRegistry","ContractEntitySpec","ContractEdgeSpec","EdgeSpec"];export const contractEntityOntologyCompatibilityLedger=[{id:"contracts-spec-entity-ontology-contracts",kind:"ontology-contract",packageName:"@lssm/lib.contracts-spec",importPath:"@lssm/lib.contracts-spec",sourcePath:"packages/libs/contracts-spec/src/entities/index.ts",symbols:o,compatibilityIntent:"additive",decision:"Entity ontology contracts are additive primitives layered on existing schema contracts.",evidenceRefs:["packages/libs/contracts-spec/src/entities/defineContractEntity.test.ts","packages/libs/contracts-spec/src/entities/compatibility.test.ts"]},{id:"contracts-spec-entity-root-barrel-export",kind:"root-barrel-export",packageName:"@lssm/lib.contracts-spec",importPath:"@lssm/lib.contracts-spec",sourcePath:"packages/libs/contracts-spec/src/index.ts",symbols:o,compatibilityIntent:"root-barrel-only",decision:"Entity ontology symbols are public from the root barrel; the entities subpath ledger entry records the narrow additive package subpath separately.",evidenceRefs:["packages/libs/contracts-spec/src/index.ts","packages/libs/contracts-spec/src/entities/compatibility.test.ts"]},{id:"contracts-spec-entities-subpath-export",kind:"package-subpath",packageName:"@lssm/lib.contracts-spec",importPath:"@lssm/lib.contracts-spec/entities",sourcePath:"packages/libs/contracts-spec/package.json",symbols:[],compatibilityIntent:"subpath-additive",decision:"The `./entities` package export is intentionally additive and mirrors the entity ontology symbols available from the root barrel.",evidenceRefs:["packages/libs/contracts-spec/package.json","packages/libs/contracts-spec/src/entities/compatibility.test.ts"]}];export function assertContractEntityOntologyCompatibilityLedger(e=contractEntityOntologyCompatibilityLedger){if(e.length===0)throw Error("Contract entity ontology compatibility ledger is empty.");const i=new Set;for(const t of e){if(i.has(t.id))throw Error(`Duplicate contract entity ontology compatibility ledger id: ${t.id}`);i.add(t.id);if(!t.importPath||!t.sourcePath)throw Error(`Contract entity ontology compatibility ledger entry ${t.id} is missing import or source path.`);if(t.evidenceRefs.length===0)throw Error(`Contract entity ontology compatibility ledger entry ${t.id} has no evidence refs.`)}return e}export const tech_contracts_entities_compatibility_DocBlocks=[{id:"docs.tech.contracts.entities.compatibility",title:"Contract Entity Ontology Compatibility Ledger",summary:"Entity ontology symbols are additive from the root barrel and the narrow `./entities` package subpath.",kind:"reference",visibility:"public",route:"/docs/tech/contracts/entities/compatibility",tags:["tech","contracts","entities","compatibility","exports"],body:`# Contract Entity Ontology Compatibility Ledger
+
+The entity ontology public surface is intentionally additive through the root barrel and the narrow \`./entities\` package subpath.
+
+## Public import
+
+\`\`\`ts
+import {
+  defineContractEntity,
+  defineContractEdge,
+  EntityRegistry,
+} from '@lssm/lib.contracts-spec/entities';
+\`\`\`
+
+## Compatibility decision
+
+- \`@lssm/lib.contracts-spec\` exports the entity ontology symbols from the root barrel.
+- \`@lssm/lib.contracts-spec/entities\` is not introduced by this ledger.
+- Future work that adds \`./entities\` must update \`package.json\`, the publish exports, tests, docs, and release metadata together.
+`}];

package/dist/node/entities/defineContractEdge.js

@@ -0,0 +1,41 @@
+export function defineContractEdge(e){return e}export const tech_contracts_entities_edge_DocBlocks=[{id:"docs.tech.contracts.entities.edge",title:"ContractEdgeSpec — Declarative Graph Edge Contract",summary:"`ContractEdgeSpec` is the declarative graph edge contract: a versioned, ownership-tagged wrapper around `EdgeSpec` for use in `EntityRegistry` and graph `DataViewSpec` sources.",kind:"reference",visibility:"public",route:"/docs/tech/contracts/entities/edge",tags:["tech","contracts","entities","edge","graph"],body:`# ContractEdgeSpec
+
+## Purpose
+
+\`ContractEdgeSpec\` pairs an \`EdgeSpec\` with standard ownership metadata so
+graph edges can be registered, versioned, and discovered the same way other
+ContractSpec contracts are.
+
+## Factory
+
+\`\`\`typescript
+import { defineContractEdge } from '@lssm/lib.contracts-spec';
+
+export const UserToProjectEdge = defineContractEdge({
+  meta: {
+    key: 'user-to-project',
+    version: '1.0.0',
+    description: 'A user owns zero or more projects.',
+    stability: 'stable',
+    owners: ['platform.core'],
+    tags: ['graph'],
+  },
+  edge: { id: 'user-to-project', from: 'user', to: 'project', relation: 'has-many', cardinality: 'one-to-many', directed: true },
+});
+\`\`\`
+
+## Registry
+
+Register via \`EntityRegistry\`:
+
+\`\`\`typescript
+const registry = new EntityRegistry();
+registry.registerEdge(UserToProjectEdge);
+\`\`\`
+
+## Related
+
+- \`EdgeSpec\` — the inline edge shape (see \`entities/types.ts\`)
+- \`ContractEntitySpec\` — entity-level wrapper that can declare edges inline
+- \`EntityRegistry\` — stores both entity and edge contracts
+`}];

package/dist/node/entities/defineContractEntity.js

@@ -0,0 +1,80 @@
+export function defineContractEntity(t){return t}export const tech_contracts_entities_entity_DocBlocks=[{id:"docs.tech.contracts.entities.entity",title:"ContractEntitySpec — Declarative Entity Contract (Layer 1 + 2)",summary:"`ContractEntitySpec` is the entity contract supporting two adoption layers: Layer 1 (slug + edges only) and Layer 2 (full `EntitySpec<TFields>` + edges). Schema layer's `defineEntity` is untouched per A4.",kind:"reference",visibility:"public",route:"/docs/tech/contracts/entities/entity",tags:["tech","contracts","entities","graph"],body:`# ContractEntitySpec
+
+## Purpose
+
+\`ContractEntitySpec\` is the entity contract. It provides:
+
+1. A canonical **entity slug** via \`meta.key\`.
+2. Optional **inline edges** (\`edges?: EdgeSpec[]\`).
+3. Standard **ownership metadata** (version, stability, owners, tags).
+4. **Layer 2**: optional \`entity?: EntitySpec<TFields>\` for DB-modeling semantics
+   delegated to \`@lssm/lib.schema\`'s \`EntitySpec\`.
+
+## Layer Summary
+
+| Layer | What ships | \`entity\` field |
+|-------|------------|-----------------|
+| **Layer 1** | slug + edges | omitted |
+| **Layer 2** | slug + full \`EntitySpec<TFields>\` + edges | required |
+
+## Layer 1 Usage (slug + edges)
+
+\`\`\`typescript
+import { defineContractEntity } from '@lssm/lib.contracts-spec';
+
+export const UserEntity = defineContractEntity({
+  meta: {
+    key: 'user',
+    version: '1.0.0',
+    description: 'Platform user entity.',
+    stability: 'stable',
+    owners: ['platform.core'],
+    tags: ['user', 'auth'],
+  },
+  edges: [
+    { id: 'user-to-project', from: 'user', to: 'project', relation: 'has-many', cardinality: 'one-to-many', directed: true },
+  ],
+});
+\`\`\`
+
+## Layer 2 Usage (full EntitySpec + edges)
+
+\`\`\`typescript
+import { defineContractEntity } from '@lssm/lib.contracts-spec';
+import { defineEntity, field } from '@lssm/lib.schema';
+
+export const UserEntity = defineContractEntity({
+  meta: {
+    key: 'user',
+    version: '1.0.0',
+    description: 'Platform user with auth + profile.',
+    stability: 'stable',
+    owners: ['platform.core'],
+    tags: ['user', 'auth'],
+  },
+  entity: defineEntity({
+    name: 'User',
+    description: 'Platform user with auth + profile.',
+    fields: {
+      id: field.id(),
+      email: field.email(),
+      createdAt: field.createdAt(),
+    },
+  }),
+  edges: [
+    { id: 'user-to-project', from: 'user', to: 'project', relation: 'has-many', cardinality: 'one-to-many', directed: true },
+  ],
+});
+\`\`\`
+
+## A4 Constraint
+
+The schema layer's \`defineEntity\` (\`@lssm/lib.schema\`) remains untouched.
+\`defineContractEntity\` accepts its output via **structural typing** — no wrapping,
+no re-implementation, no modification to the schema package.
+
+## Registry Precondition (C12)
+
+The \`EntityRegistry\` holding this spec **must** be initialized before graph
+\`DataViewRenderer\` accesses entity slugs or edge relationships.
+`}];

package/dist/node/entities/index.js

@@ -0,0 +1 @@
+export{assertContractEntityOntologyCompatibilityLedger,contractEntityOntologyCompatibilityLedger,tech_contracts_entities_compatibility_DocBlocks}from"./compatibility.js";export{defineContractEdge,tech_contracts_entities_edge_DocBlocks}from"./defineContractEdge.js";export{defineContractEntity,tech_contracts_entities_entity_DocBlocks}from"./defineContractEntity.js";export{EntityRegistry,tech_contracts_entities_registry_DocBlocks}from"./registry.js";export{tech_contracts_entities_types_DocBlocks}from"./types.js";

package/dist/node/entities/registry.js

@@ -0,0 +1 @@
+import{SpecContractRegistry as p}from"../registry.js";export class EntityRegistry extends p{edges=new Map;constructor(e){super("entity",e)}registerEdge(e){const t=`${e.meta.key}.v${e.meta.version}`;if(this.edges.has(t))throw Error(`Duplicate contract \`edge\` ${t}`);this.edges.set(t,e);return this}getEdge(e,t){if(t!=null)return this.edges.get(`${e}.v${t}`);let i;for(const[d,r]of this.edges.entries()){if(!d.startsWith(`${e}.v`))continue;if(!i){i=r;continue}const[s=0,c=0,a=0]=i.meta.version.split(".").map(Number),[n=0,o=0,g=0]=r.meta.version.split(".").map(Number);if(n>s||n===s&&o>c||n===s&&o===c&&g>a)i=r}return i}listEdgeSpecs(){return[...this.edges.values()]}listEdges(){const e=[];for(const t of this.list())if(t.edges)e.push(...t.edges);for(const t of this.edges.values())e.push(t.edge);return e}}export const tech_contracts_entities_registry_DocBlocks=[{id:"docs.tech.contracts.entities.registry",title:"EntityRegistry — Entity & Edge Contract Registry",summary:"`EntityRegistry` stores `ContractEntitySpec` and `ContractEdgeSpec` instances, then exposes a unified `listEdges()` view for graph renderers.",kind:"reference",visibility:"public",route:"/docs/tech/contracts/entities/registry",tags:["tech","contracts","entities","registry","graph"],body:"# EntityRegistry\n\n## Purpose\n\n`EntityRegistry` is the single runtime store for entity and edge contracts.\nIt extends `SpecContractRegistry<'entity', ContractEntitySpec>` and adds a\nsecondary edge map for named `ContractEdgeSpec` entries.\n\n## Initialization (C12 Precondition)\n\nThe registry **must** be initialized (entities and edges registered) before\nany graph `DataViewRenderer` reads entity slugs or edge relationships.\nInline-edge-only views do not share this requirement.\n\n## API Summary\n\n| Method | Description |\n|--------|-------------|\n| `register(spec)` | Register a `ContractEntitySpec` (inherited). |\n| `registerEdge(spec)` | Register a named `ContractEdgeSpec`. |\n| `list()` | List all entity specs (inherited). |\n| `listEdgeSpecs()` | List all named edge specs. |\n| `listEdges()` | Unified flat list of all `EdgeSpec` (inline + named). |\n| `get(key, version?)` | Retrieve entity spec by key (inherited). |\n| `getEdge(key, version?)` | Retrieve named edge spec by key. |\n\n## Example\n\n```typescript\nconst registry = new EntityRegistry([UserEntity, ProjectEntity]);\nregistry.registerEdge(UserToProjectEdge);\n\nconst edges = registry.listEdges();\n// [{ id: 'user-to-project', from: 'user', to: 'project', relation: 'has-many', cardinality: 'one-to-many', ... }]\n```\n"}];

package/dist/node/entities/types.js

@@ -0,0 +1 @@
+export const tech_contracts_entities_types_DocBlocks=[{id:"docs.tech.contracts.entities.types",title:"EdgeSpec — Graph Edge Contract Type",summary:"`EdgeSpec` is the Layer-1 declarative type for a relationship between two entity slugs in a ContractSpec graph view. Required fields: `id`, `from`, `to`, `relation`, `cardinality`.",kind:"reference",visibility:"public",route:"/docs/tech/contracts/entities/types",tags:["tech","contracts","entities","edge","graph"],body:"# EdgeSpec\n\n## Purpose\n\n`EdgeSpec` describes a graph edge (relationship) between two entity types in\na ContractSpec graph view.\n\n## Fields\n\n| Field         | Type                                                          | Required | Description                                |\n|---------------|---------------------------------------------------------------|----------|--------------------------------------------|\n| `id`        | `string`                                                    | ✅       | Stable edge identifier                     |\n| `from`      | `string`                                                    | ✅       | Entity key of the source node              |\n| `to`        | `string`                                                    | ✅       | Entity key of the target node              |\n| `relation`  | `string`                                                    | ✅       | Semantic relation name                     |\n| `cardinality` | `'one-to-one' \\| 'one-to-many' \\| 'many-to-one' \\| 'many-to-many'` | ✅ | Cardinality |\n| `directed`  | `boolean`                                                   | —        | Defaults to `true` (from → to)           |\n| `inverse`   | `string`                                                    | —        | `id` of the inverse edge spec            |\n| `traversal` | `{ strategy?, maxDepth? }`                                  | —        | Graph traversal hints                      |\n| `label`     | `string`                                                    | —        | Human-readable edge label in graph views   |\n| `attributes` | `Record<string, unknown>`                                  | —        | Domain-specific rendering/rule metadata    |\n\n## Layer Roadmap\n\n- **Layer 1** (current): id + from/to + relation + cardinality. No DB modeling.\n- **Layer 2** (Phase 2): full `EntitySpec<TFields>` + edges via `defineContractEntity`.\n\n## Example\n\n```typescript\nimport { defineContractEdge } from '@lssm/lib.contracts-spec';\n\nconst UserToProjectEdge = defineContractEdge({\n  meta: { key: 'user-to-project', version: '1.0.0', description: '...', stability: 'stable', owners: [], tags: [] },\n  edge: {\n    id: 'user-to-project',\n    from: 'user',\n    to: 'project',\n    relation: 'has-many',\n    cardinality: 'one-to-many',\n    directed: true,\n  },\n});\n```\n"}];

package/dist/node/events.js

@@ -0,0 +1 @@
+import{SpecContractRegistry as n}from"./registry.js";export function defineEvent(e){return e}export const eventKey=(e,t)=>`${e}.v${t}`;export class EventRegistry extends n{constructor(e){super("event",e)}}

package/dist/node/examples/define.js

@@ -0,0 +1 @@
+export const defineExample=(e)=>e;

package/dist/node/examples/index.js

@@ -0,0 +1,141 @@
+export{defineExample}from"./define.js";export{ExampleRegistry}from"./registry.js";export{ExampleDocumentationSchema,ExampleEntrypointsSchema,ExampleKindSchema,ExampleMetaSchema,ExampleSandboxModeSchema,ExampleSpecSchema,ExampleSurfacesSchema,ExampleVisibilitySchema,parseExampleDocumentation,parseExampleEntrypoints,parseExampleMeta,parseExampleSpec,parseExampleSurfaces,safeParseExampleSpec}from"./schema.js";export{ExampleKindEnum,ExampleSandboxModeEnum,ExampleVisibilityEnum,isExampleKind,isExampleVisibility,isFeatureRef,isSpecPointer}from"./types.js";export{validateExample,validateExampleReferences,validateExamples}from"./validation.js";export const tech_contracts_examples_DocBlocks=[{id:"docs.tech.contracts.examples",title:"Example Specifications",summary:"ExampleSpec defines complete, demonstrable ContractSpec applications.",kind:"reference",visibility:"public",route:"/docs/tech/contracts/examples",tags:["tech","contracts","examples","templates"],body:`## Example Specifications
+
+ExampleSpec is a contract for defining complete, demonstrable ContractSpec applications. Examples integrate with AppBlueprintSpec and FeatureModuleSpec to provide a full application specification.
+
+### Overview
+
+An \`ExampleSpec\` captures:
+- **Metadata** (via \`ExampleMeta\` extending \`OwnerShipMeta\`): key, version, title, description, ownership, tags, stability
+- **Example-specific fields**: kind, visibility, summary
+- **Surfaces**: where the example can be used (templates, sandbox, studio, MCP)
+- **Entrypoints**: package exports mapping
+- **Blueprint**: optional AppBlueprintSpec or reference
+- **Features**: optional FeatureModuleSpec array or references
+
+### Usage
+
+\`\`\`typescript
+
+const example: ExampleSpec = {
+  meta: {
+    key: 'saas-boilerplate',
+    version: '1.0.0',
+    title: 'SaaS Boilerplate',
+    description: 'Multi-tenant SaaS foundation with billing and RBAC.',
+    kind: 'template',
+    visibility: 'public',
+    stability: 'experimental',
+    owners: ['@saas-team'],
+    tags: ['saas', 'multi-tenant', 'billing'],
+    summary: 'Complete SaaS starter.',
+  },
+  surfaces: {
+    templates: true,
+    sandbox: { enabled: true, modes: ['playground', 'specs', 'builder'] },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true },
+  },
+  entrypoints: {
+    packageName: '@lssm/example.saas-boilerplate',
+    feature: './saas-boilerplate.feature',
+    contracts: './contracts',
+  },
+  features: [SaasBoilerplateFeature],
+};
+\`\`\`
+
+### ExampleRegistry
+
+Use \`ExampleRegistry\` to manage examples:
+
+\`\`\`typescript
+const registry = new ExampleRegistry();
+registry.register(example);
+
+// Query examples
+registry.listByKind('template');
+registry.listByVisibility('public');
+registry.listBySurface('studio');
+registry.listInstallable();
+registry.search('billing');
+\`\`\`
+
+### ExampleMeta
+
+\`ExampleMeta\` extends \`OwnerShipMeta\` with example-specific fields:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| key | string | Unique identifier |
+| version | number | Spec version |
+| title | string? | Human-readable title |
+| description | string | Technical description |
+| kind | ExampleKind | template, workflow, integration, etc. |
+| visibility | ExampleVisibility | public, internal, experimental |
+| stability | Stability | idea, experimental, beta, stable, deprecated |
+| owners | string[] | Owner identifiers |
+| tags | string[] | Discovery tags |
+| summary | string? | Marketing summary |
+
+### ExampleKind
+
+| Kind | Use Case |
+|------|----------|
+| template | Full application template |
+| workflow | Workflow automation example |
+| integration | Integration showcase |
+| knowledge | Knowledge base example |
+| blueprint | App blueprint example |
+| ui | UI component showcase |
+| script | CLI/script example |
+| library | Library/SDK example |
+
+### Surfaces
+
+| Surface | Purpose |
+|---------|---------|
+| templates | Available as new project template |
+| sandbox | Interactive playground support |
+| studio | ContractSpec Studio support |
+| mcp | Model Context Protocol support |
+
+### Validation
+
+\`\`\`typescript
+
+const result = validateExample(example);
+if (!result.valid) {
+  console.error(result.errors);
+}
+
+// Batch validation with duplicate detection
+const batchResult = validateExamples([example1, example2]);
+\`\`\`
+
+### Integration with Blueprints and Features
+
+Examples can reference or embed blueprints and features:
+
+\`\`\`typescript
+const example: ExampleSpec = {
+  // ... meta, surfaces, entrypoints
+  
+  // Inline blueprint
+  blueprint: myAppBlueprint,
+  
+  // Or reference by pointer
+  blueprint: { key: 'core.app', version: '1.0.0' },
+  
+  // Inline features
+  features: [MyFeature],
+  
+  // Or reference
+  features: [{ key: 'my-feature' }],
+};
+\`\`\`
+
+### Related
+
+- [App Configuration](file:///docs/tech/contracts/app-config) - AppBlueprintSpec
+- [Features](file:///docs/tech/contracts/features) - FeatureModuleSpec
+`}];

package/dist/node/examples/registry.js

@@ -0,0 +1 @@
+import{SpecContractRegistry as s}from"../registry.js";export class ExampleRegistry extends s{constructor(t){super("example",t)}listByKind(t){return this.list().filter((e)=>e.meta.kind===t)}listByVisibility(t){return this.list().filter((e)=>e.meta.visibility===t)}listByDomain(t){return this.list().filter((e)=>e.meta.domain===t)}listBySurface(t){return this.list().filter((e)=>{if(t==="templates")return e.surfaces.templates;if(t==="sandbox")return e.surfaces.sandbox.enabled;if(t==="studio")return e.surfaces.studio.enabled;if(t==="mcp")return e.surfaces.mcp.enabled;return!1})}listInstallable(){return this.list().filter((t)=>t.surfaces.studio.installable)}groupByKind(){const t=new Map;for(const e of this.list()){const i=t.get(e.meta.kind)??[];i.push(e);t.set(e.meta.kind,i)}return t}getUniqueKinds(){const t=new Set;for(const e of this.list())t.add(e.meta.kind);return[...t]}getUniqueDomains(){const t=new Set;for(const e of this.list())if(e.meta.domain)t.add(e.meta.domain);return[...t]}search(t){const e=t.toLowerCase().trim();if(!e)return this.list();return this.list().filter((i)=>{return[i.meta.key,i.meta.title??"",i.meta.description,i.meta.summary??"",...i.meta.tags].join(" ").toLowerCase().includes(e)})}}