lawspec 0.23.0 → 0.25.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +167 -1
- package/README.md +29 -22
- package/UNICODE-LICENSE.txt +39 -0
- package/api.mjs +14 -23
- package/bin/lawspec.mjs +200 -67
- package/build.json +381 -155
- package/builtin-data-names.mjs +73 -0
- package/compatibility.json +21 -0
- package/core.wasm +2 -2
- package/doctor.mjs +98 -1
- package/examples/native-payments/clojure/lawspec.json +62 -0
- package/examples/native-payments/clojure/src/domain/payments.clj +11 -0
- package/examples/native-payments/clojure/test/domain/payment_generators.clj +9 -0
- package/examples/native-payments/csharp/lawspec.json +13 -2
- package/examples/native-payments/elixir/lawspec.json +14 -3
- package/examples/native-payments/erlang/lawspec.json +14 -3
- package/examples/native-payments/fsharp/lawspec.json +14 -3
- package/examples/native-payments/gleam/lawspec.json +14 -3
- package/examples/native-payments/go/lawspec.json +14 -3
- package/examples/native-payments/groovy/lawspec.json +176 -0
- package/examples/native-payments/groovy/src/main/groovy/domain/PaymentsDomain.groovy +49 -0
- package/examples/native-payments/groovy/src/test/groovy/domain/PaymentGenerators.groovy +15 -0
- package/examples/native-payments/haskell/lawspec.json +14 -3
- package/examples/native-payments/java/lawspec.json +14 -3
- package/examples/native-payments/javascript/lawspec.json +14 -3
- package/examples/native-payments/kotlin/lawspec.json +14 -3
- package/examples/native-payments/python/lawspec.json +14 -3
- package/examples/native-payments/rust/lawspec.json +14 -3
- package/examples/native-payments/scala/lawspec.json +176 -0
- package/examples/native-payments/scala/src/main/scala/domain/PaymentsDomain.scala +18 -0
- package/examples/native-payments/scala/src/test/scala/domain/PaymentGenerators.scala +8 -0
- package/examples/native-payments/swift/lawspec.json +165 -0
- package/examples/native-payments/swift/src/Native/PaymentsDomain.swift +35 -0
- package/examples/native-payments/swift/tests/Native/PaymentGenerators.swift +12 -0
- package/examples/native-payments/typescript/lawspec.json +14 -3
- package/examples/packages/orders/lawspec.json +25 -5
- package/examples/packages/orders/orders.lawspec +36 -34
- package/examples/packages/shop-domain/src/domain.lawspec +23 -21
- package/examples/packages/shop-tax-1/src/rates.lawspec +4 -4
- package/examples/packages/shop-tax-2/src/rates.lawspec +5 -4
- package/examples/rc1/authorization-snapshots.lawspec +112 -0
- package/examples/rc1/banner-filenames.lawspec +63 -0
- package/examples/rc1/bit-codec.lawspec +56 -0
- package/examples/rc1/bounded-witness-search.lawspec +144 -0
- package/examples/rc1/conflicting-requirements.lawspec +30 -0
- package/examples/rc1/constructive-witnesses.lawspec +113 -0
- package/examples/rc1/documentary-review.lawspec +42 -0
- package/examples/rc1/empty-domains.lawspec +46 -0
- package/examples/rc1/finite-integer-domains.lawspec +75 -0
- package/examples/rc1/law-metadata.lawspec +29 -0
- package/examples/rc1/native-payments.lawspec +107 -0
- package/examples/rc1/nesting/rrr.lawspec +33 -0
- package/examples/rc1/nesting/rru.lawspec +56 -0
- package/examples/rc1/nesting/rur.lawspec +57 -0
- package/examples/rc1/nesting/ruu.lawspec +77 -0
- package/examples/rc1/nesting/urr.lawspec +52 -0
- package/examples/rc1/nesting/uru.lawspec +72 -0
- package/examples/rc1/nesting/uur.lawspec +73 -0
- package/examples/rc1/nesting/uuu.lawspec +95 -0
- package/examples/rc1/order-workflow.lawspec +126 -0
- package/examples/rc1/parcel-measurements.lawspec +92 -0
- package/examples/rc1/picture-records.lawspec +51 -0
- package/examples/rc1/picture-tuples.lawspec +47 -0
- package/examples/rc1/record-payloads.lawspec +56 -0
- package/examples/rc1/recursive-records.lawspec +64 -0
- package/examples/rc1/refund-conformance.lawspec +44 -0
- package/examples/rc1/refund-policy.lawspec +88 -0
- package/examples/rc1/requirement-composition.lawspec +89 -0
- package/examples/rc1/structural-records.lawspec +53 -0
- package/examples/rc1-authoring.lawspec +56 -0
- package/examples-command.mjs +11 -5
- package/explain.mjs +112 -0
- package/expression-presentation.mjs +333 -0
- package/files.mjs +16 -0
- package/index.d.ts +934 -12
- package/lsp.mjs +231 -0
- package/migrate.mjs +135 -0
- package/migration-bindings.mjs +86 -0
- package/migration-cases.mjs +45 -0
- package/migration-collections.mjs +54 -0
- package/migration-correspondence.mjs +275 -0
- package/migration-generation.mjs +99 -0
- package/migration-laws.mjs +102 -0
- package/migration-records.mjs +166 -0
- package/migration-source.mjs +247 -0
- package/migration-write.mjs +156 -0
- package/native-evidence.mjs +187 -0
- package/native-examples.mjs +8 -1
- package/node-events-reporter.mjs +23 -0
- package/package.json +8 -1
- package/positional-fields.mjs +13 -0
- package/proof.d.ts +35 -0
- package/proof.mjs +174 -0
- package/scala-coverage.mjs +56 -0
- package/starter-rc1.lawspec +25 -0
- package/templates.mjs +65 -3
- package/test-command.mjs +177 -29
- package/typed-presentation.mjs +165 -0
|
@@ -0,0 +1,275 @@
|
|
|
1
|
+
// Generated from templates/npm/migration-correspondence.mjs by lawspec-dev generate. Do not edit.
|
|
2
|
+
// These fingerprints cover the compiler's complete typed Core, not the
|
|
3
|
+
// smaller documentary JSON views. They establish no unrun law verification.
|
|
4
|
+
const digest=/^[0-9a-f]{64}$/;
|
|
5
|
+
const components=[['programDigest','program'],['definitionPlaneDigest','definitionPlane'],['lawBodiesDigest','lawBodies']];
|
|
6
|
+
const parts=['definitions','contracts','dataTypes'];
|
|
7
|
+
const templateComponents=[['declarationsDigest','declarations'],['definitionTemplatesDigest','definitions'],
|
|
8
|
+
['lawTemplatesDigest','laws'],['lawBodiesDigest','lawBodies']];
|
|
9
|
+
|
|
10
|
+
function rowsValid(rows,policies=false) {
|
|
11
|
+
return Array.isArray(rows)&&rows.every(item=>item&&typeof item.comparisonId==='string'&&
|
|
12
|
+
(policies?['nonempty','universal'].includes(item.policy)&&
|
|
13
|
+
(item.formalParameterCount===undefined||Number.isSafeInteger(item.formalParameterCount)&&item.formalParameterCount>=0):
|
|
14
|
+
typeof item.digest==='string'&&digest.test(item.digest)))&&
|
|
15
|
+
new Set(rows.map(item=>item.comparisonId)).size===rows.length;
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
function differences(before,after,names) {
|
|
19
|
+
return Object.fromEntries(names.map(name=>{
|
|
20
|
+
const original=new Map(before[name].map(item=>[item.comparisonId,item.digest]));
|
|
21
|
+
const migrated=new Map(after[name].map(item=>[item.comparisonId,item.digest]));
|
|
22
|
+
return [name,{added:[...migrated.keys()].filter(id=>!original.has(id)),
|
|
23
|
+
removed:[...original.keys()].filter(id=>!migrated.has(id)),
|
|
24
|
+
changed:[...original.keys()].filter(id=>migrated.has(id)&&original.get(id)!==migrated.get(id))}];
|
|
25
|
+
}));
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
function checkedDefinitionTemplates(before,after,evidence,machineBits) {
|
|
29
|
+
if(evidence?.status!=='matched'||evidence.version!==1||evidence.algorithm!=='sha256'||
|
|
30
|
+
evidence.machineBits!==machineBits||evidence.originalsUnchanged!==true||
|
|
31
|
+
!templateComponents.every(([field])=>evidence.before?.[field]===before[field]&&evidence.after?.[field]===after[field])) return false;
|
|
32
|
+
const headers=evidence.interfaces,core=evidence.typedCore;
|
|
33
|
+
if(headers?.status!=='matched'||typeof headers.before!=='string'||!digest.test(headers.before)||headers.before!==headers.after||
|
|
34
|
+
core?.status!=='matched'||core.version!==1||core.algorithm!=='sha256'||core.machineBits!==machineBits||
|
|
35
|
+
core.copyValidated!==true||core.originalsUnchanged!==true||
|
|
36
|
+
typeof core.sourceBeforeDigest!=='string'||!digest.test(core.sourceBeforeDigest)||
|
|
37
|
+
!available(core.before)||!available(core.after)||core.before.machineBits!==machineBits||core.after.machineBits!==machineBits||
|
|
38
|
+
core.before.domainPolicies.length!==0||core.after.domainPolicies.length!==0) return false;
|
|
39
|
+
return components.every(([field,name])=>core[name]?.status==='matched'&&
|
|
40
|
+
core[name].before===core.before[field]&&core[name].after===core.after[field]&&core[name].before===core[name].after);
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
function anchoredTemplates(before,after,evidence,machineBits) {
|
|
44
|
+
return evidence?.status==='matched'&&evidence.version===1&&evidence.algorithm==='sha256'&&
|
|
45
|
+
evidence.machineBits===machineBits&&evidence.originalsUnchanged===true&&
|
|
46
|
+
templateComponents.every(([field])=>evidence.before?.[field]===before[field]&&evidence.after?.[field]===after[field]);
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
function matchingPair(pair) {
|
|
50
|
+
return pair?.status==='matched'&&typeof pair.before==='string'&&digest.test(pair.before)&&pair.before===pair.after;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
function templateCoreIdentity(id) {
|
|
54
|
+
const split=id.indexOf('::law::');
|
|
55
|
+
return split<0?id:id.slice(0,split+7)+id.slice(split+7).replace(/[:%]/g,char=>char===':'?'%3A':'%25');
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
function checkedLawTemplates(before,after,evidence,machineBits) {
|
|
59
|
+
if(!anchoredTemplates(before,after,evidence,machineBits)||!matchingPair(evidence.metadata)||
|
|
60
|
+
evidence.lawBodiesEvaluated!==false) return false;
|
|
61
|
+
const core=evidence.typedCore;
|
|
62
|
+
if(core?.status!=='matched'||core.version!==1||core.algorithm!=='sha256'||core.machineBits!==machineBits||
|
|
63
|
+
core.copyValidated!==true||core.originalsUnchanged!==true||typeof core.sourceBeforeDigest!=='string'||!digest.test(core.sourceBeforeDigest)||
|
|
64
|
+
!available(core.before)||!available(core.after)||core.before.machineBits!==machineBits||core.after.machineBits!==machineBits) return false;
|
|
65
|
+
for(const [source,snapshot] of [[before,core.before],[after,core.after]]) {
|
|
66
|
+
if(JSON.stringify(source.domainPolicies.map(row=>({...row,comparisonId:templateCoreIdentity(row.comparisonId)})))!==
|
|
67
|
+
JSON.stringify(snapshot.domainPolicies)) return false;
|
|
68
|
+
}
|
|
69
|
+
return components.every(([field,name])=>{
|
|
70
|
+
const claim=core[name],old=core.before[field],made=core.after[field];
|
|
71
|
+
return claim?.before===old&&claim?.after===made&&claim.status===(old===made?'matched':'not-established')&&
|
|
72
|
+
(name==='program'||old===made);
|
|
73
|
+
});
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
function compareTemplates(before,after,machineBits,definitionEvidence,lawEvidence,unitEvidence) {
|
|
77
|
+
const available=value=>[32,64].includes(machineBits)&&value?.status==='available'&&value.version===1&&value.algorithm==='sha256'&&
|
|
78
|
+
value.machineBits===machineBits&&templateComponents.every(([name])=>typeof value[name]==='string'&&digest.test(value[name]))&&
|
|
79
|
+
['units','definitions','laws'].every(name=>rowsValid(value[name]))&&rowsValid(value.domainPolicies,true);
|
|
80
|
+
if(!available(before)||!available(after)) return {status:'not-established',
|
|
81
|
+
reason:'Matching-version checked source-template snapshots at the program machine width were not available.'};
|
|
82
|
+
const checks=Object.fromEntries(templateComponents.map(([field,name])=>[name,
|
|
83
|
+
before[field]===after[field]?{status:'matched',basis:'matching-checked-source-template-fingerprints'}:
|
|
84
|
+
{status:'not-established',reason:'The checked source-template '+name+' fingerprints differ.'}]));
|
|
85
|
+
const definitionsMatched=checkedDefinitionTemplates(before,after,definitionEvidence,machineBits);
|
|
86
|
+
const lawsMatched=checkedLawTemplates(before,after,lawEvidence,machineBits);
|
|
87
|
+
if(checks.definitions.status!=='matched'&&definitionsMatched) {
|
|
88
|
+
checks.definitions={status:'matched',basis:'matching-complete-symbolic-definition-Core-and-source-interfaces-after-validated-payload-transport'};
|
|
89
|
+
}
|
|
90
|
+
if(checks.lawBodies.status!=='matched'&&lawsMatched) checks.lawBodies={status:'matched',
|
|
91
|
+
basis:'matching-complete-symbolic-law-Core-and-source-metadata-after-validated-payload-transport'};
|
|
92
|
+
if(checks.declarations.status!=='matched'&&definitionsMatched&&lawsMatched&&
|
|
93
|
+
anchoredTemplates(before,after,unitEvidence,machineBits)&&matchingPair(unitEvidence.metadata)&&
|
|
94
|
+
unitEvidence.definitions==='matched'&&unitEvidence.laws==='matched'&&unitEvidence.payloadShapes==='matched') {
|
|
95
|
+
checks.declarations={status:'matched',basis:'matching-complete-source-unit-metadata-and-certified-symbolic-terms-and-payloads'};
|
|
96
|
+
}
|
|
97
|
+
// Domain evidence belongs to the complete source capture that produced it.
|
|
98
|
+
// A concrete-Core witness, stale capture, or one chosen law parameter is
|
|
99
|
+
// insufficient for a reusable template's uniform input population.
|
|
100
|
+
const anchored=value=>{
|
|
101
|
+
const evidence=value.inputDomains;
|
|
102
|
+
return {...value,inputDomains:templateComponents.every(([field])=>evidence?.sourceTemplates?.[field]===value[field])?
|
|
103
|
+
evidence:undefined};
|
|
104
|
+
};
|
|
105
|
+
let policies=compareDomainPolicies(anchored(before),anchored(after));
|
|
106
|
+
// The compiler's symbolic comparison copy retains the original inputs;
|
|
107
|
+
// abstract parameter declarations are never witnesses. Reuse only complete
|
|
108
|
+
// transported input evidence anchored to the checked law-template copy.
|
|
109
|
+
if(policies.status!=='matched'&&lawsMatched) {
|
|
110
|
+
const transported=compareDomainPolicies(lawEvidence.typedCore.before,lawEvidence.typedCore.after);
|
|
111
|
+
const candidates=new Map((transported.domains??[]).map(row=>[row.comparisonId,row]));
|
|
112
|
+
const domains=policies.domains.map(row=>{
|
|
113
|
+
const candidate=candidates.get(templateCoreIdentity(row.comparisonId));
|
|
114
|
+
return row.status==='matched'||candidate?.status!=='matched'?row:{...candidate,comparisonId:row.comparisonId,
|
|
115
|
+
basis:'matching-transported-template-domain-dependencies-and-verified-input-witnesses',
|
|
116
|
+
valueRepresentation:'transported-before-and-canonical-after'};
|
|
117
|
+
});
|
|
118
|
+
const matched=before.domainPolicies.length===after.domainPolicies.length&&domains.every(row=>row.status==='matched');
|
|
119
|
+
policies={...policies,status:matched?'matched':'not-established',domains,
|
|
120
|
+
...(matched?{basis:'verified-input-domain-correspondence',reason:undefined}:{})};
|
|
121
|
+
}
|
|
122
|
+
if(checks.laws.status!=='matched'&&checks.lawBodies.status==='matched'&&policies.status==='matched') {
|
|
123
|
+
checks.laws={status:'matched',basis:'matching-policy-erased-source-templates-and-verified-input-domains'};
|
|
124
|
+
}
|
|
125
|
+
return {status:policies.status==='matched'&&Object.values(checks).every(check=>check.status==='matched')?'matched':'not-established',
|
|
126
|
+
scope:'pre-specialization checked source templates',...checks,
|
|
127
|
+
lawBodies:{...checks.lawBodies,includesDomainPolicy:false},
|
|
128
|
+
domainPolicies:policies,
|
|
129
|
+
differences:differences(before,after,['units','definitions','laws'])};
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
function available(snapshot) {
|
|
133
|
+
return snapshot?.status==='available'&&snapshot.version===1&&snapshot.algorithm==='sha256'&&
|
|
134
|
+
[32,64].includes(snapshot.machineBits)&&components.every(([field])=>typeof snapshot[field]==='string'&&digest.test(snapshot[field]))&&
|
|
135
|
+
parts.every(name=>rowsValid(snapshot[name]))&&rowsValid(snapshot.domainPolicies,true);
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
function compareDomainPolicies(before,after) {
|
|
139
|
+
const original=before.domainPolicies,migrated=after.domainPolicies;
|
|
140
|
+
const unchanged=JSON.stringify(original)===JSON.stringify(migrated);
|
|
141
|
+
if(unchanged) return {status:'matched',before:original,after:migrated,basis:'unchanged-domain-policies'};
|
|
142
|
+
const valid=sample=>sample?.status==='available'&&sample.version===1&&sample.algorithm==='sha256'&&
|
|
143
|
+
sample.machineBits===before.machineBits&&sample.lawBodiesEvaluated===false&&Array.isArray(sample.domains)&&
|
|
144
|
+
sample.domains.every(row=>row&&typeof row.comparisonId==='string'&&typeof row.domainDigest==='string'&&digest.test(row.domainDigest)&&
|
|
145
|
+
['inhabited','empty','uniformly-inhabited','empty-parameters','parameter-counterexample','incomplete','unsupported'].includes(row.status))&&
|
|
146
|
+
new Set(sample.domains.map(row=>row.comparisonId)).size===sample.domains.length;
|
|
147
|
+
const evidenceAvailable=valid(before.inputDomains)&&valid(after.inputDomains);
|
|
148
|
+
const oldDomains=new Map(evidenceAvailable?before.inputDomains.domains.map(row=>[row.comparisonId,row]):[]);
|
|
149
|
+
const newDomains=new Map(evidenceAvailable?after.inputDomains.domains.map(row=>[row.comparisonId,row]):[]);
|
|
150
|
+
const validBindings=(bindings,count)=>Array.isArray(bindings)&&bindings.length===count&&
|
|
151
|
+
bindings.every(binding=>binding&&typeof binding.binder==='string'&&binding.value&&typeof binding.value==='object')&&
|
|
152
|
+
new Set(bindings.map(binding=>binding.binder)).size===bindings.length;
|
|
153
|
+
const binderNames=bindings=>JSON.stringify(bindings.map(binding=>binding.binder));
|
|
154
|
+
const validWitness=(row,policy)=>{
|
|
155
|
+
if(!row||!Number.isSafeInteger(row.inputCount)||row.inputCount<0||
|
|
156
|
+
(row.formalParameterCount??0)!==(policy.formalParameterCount??0)) return false;
|
|
157
|
+
if(row.status==='inhabited') return (!(policy.formalParameterCount>0)||row.uniformity==='parameter-independent')&&
|
|
158
|
+
validBindings(row.witness,row.inputCount);
|
|
159
|
+
if(!(policy.formalParameterCount>0)||row.complete!==true) return false;
|
|
160
|
+
if(row.status==='empty-parameters') return true;
|
|
161
|
+
if(row.status!=='uniformly-inhabited'||row.uniformity!=='complete-finite-parameters'||
|
|
162
|
+
!Array.isArray(row.parameterCases)||row.parameterCases.length===0) return false;
|
|
163
|
+
const cases=row.parameterCases;
|
|
164
|
+
return cases.every(item=>item&&validBindings(item.parameters,policy.formalParameterCount)&&
|
|
165
|
+
validBindings(item.witness,row.inputCount)&&
|
|
166
|
+
binderNames(item.parameters)===binderNames(cases[0].parameters)&&
|
|
167
|
+
binderNames(item.witness)===binderNames(cases[0].witness)&&
|
|
168
|
+
!item.parameters.some(parameter=>item.witness.some(input=>input.binder===parameter.binder)))&&
|
|
169
|
+
new Set(cases.map(item=>JSON.stringify(item.parameters))).size===cases.length;
|
|
170
|
+
};
|
|
171
|
+
const inputNames=row=>row.status==='empty-parameters'?null:
|
|
172
|
+
binderNames(row.status==='inhabited'?row.witness:row.parameterCases[0].witness);
|
|
173
|
+
const witnessView=row=>row.status==='inhabited'?row.witness:
|
|
174
|
+
row.status==='empty-parameters'?{status:row.status}:{parameterCases:row.parameterCases};
|
|
175
|
+
const rows=original.map(row=>{
|
|
176
|
+
const next=migrated.find(item=>item.comparisonId===row.comparisonId);
|
|
177
|
+
if(!next) return {comparisonId:row.comparisonId,status:'not-established',reason:'The migrated input domain is missing.'};
|
|
178
|
+
if((row.formalParameterCount??0)!==(next.formalParameterCount??0)) return {
|
|
179
|
+
comparisonId:row.comparisonId,status:'not-established',reason:'The formal parameter scopes differ.'};
|
|
180
|
+
if(row.policy===next.policy) return {comparisonId:row.comparisonId,status:'matched',basis:'unchanged-domain-policy'};
|
|
181
|
+
const old=oldDomains.get(row.comparisonId),changed=newDomains.get(row.comparisonId);
|
|
182
|
+
if(validWitness(old,row)&&validWitness(changed,next)&&old.domainDigest===changed.domainDigest&&
|
|
183
|
+
old.inputCount===changed.inputCount&&inputNames(old)===inputNames(changed)) return {
|
|
184
|
+
comparisonId:row.comparisonId,status:'matched',basis:'matching-domain-dependencies-and-verified-input-witnesses',
|
|
185
|
+
before:witnessView(old),after:witnessView(changed)};
|
|
186
|
+
return {comparisonId:row.comparisonId,status:'not-established',reason:
|
|
187
|
+
'The changed population policy needs matching domain dependencies and verified input witnesses; empty or incomplete searches do not justify it.'};
|
|
188
|
+
});
|
|
189
|
+
const matched=original.length===migrated.length&&rows.every(row=>row.status==='matched');
|
|
190
|
+
return {status:matched?'matched':'not-established',basis:matched?'verified-input-domain-correspondence':undefined,
|
|
191
|
+
...(matched?{}:{reason:'Nonempty and universal domains differ. Establish inhabitance, including dependent and empty domains, before accepting this change.'}),
|
|
192
|
+
before:original,after:migrated,domains:rows,lawVerification:'not-established-by-domain-evidence'};
|
|
193
|
+
}
|
|
194
|
+
|
|
195
|
+
function anchoredTransport(before,after,transport) {
|
|
196
|
+
if(!transport) return false;
|
|
197
|
+
// Bind the comparison copy to both actual admitted programs. A shape match,
|
|
198
|
+
// a body match, or an unanchored witness is not an input-domain certificate.
|
|
199
|
+
return ['matched','not-established'].includes(transport.status)&&transport.version===1&&transport.algorithm==='sha256'&&
|
|
200
|
+
transport.machineBits===before.machineBits&&transport.copyValidated===true&&transport.originalsUnchanged===true&&
|
|
201
|
+
transport.sourceBeforeDigest===before.programDigest&&available(transport.before)&&available(transport.after)&&
|
|
202
|
+
transport.before.machineBits===before.machineBits&&transport.after.machineBits===after.machineBits&&
|
|
203
|
+
transport.after.programDigest===after.programDigest&&
|
|
204
|
+
JSON.stringify(transport.before.domainPolicies)===JSON.stringify(before.domainPolicies)&&
|
|
205
|
+
JSON.stringify(transport.after.domainPolicies)===JSON.stringify(after.domainPolicies);
|
|
206
|
+
}
|
|
207
|
+
|
|
208
|
+
function compareTransportedDomains(before,after,transport,direct) {
|
|
209
|
+
if(direct.status==='matched'||!anchoredTransport(before,after,transport)) return direct;
|
|
210
|
+
const compared=compareDomainPolicies(transport.before,transport.after);
|
|
211
|
+
const candidates=new Map((compared.domains??[]).map(row=>[row.comparisonId,row]));
|
|
212
|
+
const domains=direct.domains.map(row=>{
|
|
213
|
+
if(row.status==='matched') return row;
|
|
214
|
+
const candidate=candidates.get(row.comparisonId);
|
|
215
|
+
return candidate?.status==='matched'?{...candidate,
|
|
216
|
+
basis:'matching-transported-domain-dependencies-and-verified-input-witnesses',
|
|
217
|
+
valueRepresentation:'transported-before-and-canonical-after'}:row;
|
|
218
|
+
});
|
|
219
|
+
const matched=before.domainPolicies.length===after.domainPolicies.length&&domains.every(row=>row.status==='matched');
|
|
220
|
+
return {...direct,status:matched?'matched':'not-established',domains,
|
|
221
|
+
...(matched?{basis:'verified-input-domain-correspondence',reason:undefined}:{}),
|
|
222
|
+
transport:{status:'available',sourceBeforeDigest:transport.sourceBeforeDigest,
|
|
223
|
+
copyValidated:true,originalsUnchanged:true}};
|
|
224
|
+
}
|
|
225
|
+
|
|
226
|
+
// A domain certificate alone cannot justify a body transformation. Require
|
|
227
|
+
// the compiler's complete validated-copy fingerprints and their pair claims,
|
|
228
|
+
// anchored to both admitted programs. The comparison copy is never executed.
|
|
229
|
+
function checkedTransportBodies(before,after,transport) {
|
|
230
|
+
if(!anchoredTransport(before,after,transport)||transport.status!=='matched') return false;
|
|
231
|
+
const pair=(name,field,equal)=>{
|
|
232
|
+
const claim=transport[name],old=transport.before[field],made=transport.after[field];
|
|
233
|
+
return claim?.before===old&&claim?.after===made&&
|
|
234
|
+
claim.status===(old===made?'matched':'not-established')&&(!equal||old===made);
|
|
235
|
+
};
|
|
236
|
+
return pair('program','programDigest',false)&&pair('definitionPlane','definitionPlaneDigest',true)&&
|
|
237
|
+
pair('lawBodies','lawBodiesDigest',true);
|
|
238
|
+
}
|
|
239
|
+
|
|
240
|
+
export function compareMigrationSnapshots(before,after,transport,definitionEvidence,lawEvidence,unitEvidence) {
|
|
241
|
+
const incomplete=reason=>({status:'not-established',reason});
|
|
242
|
+
const unproved={
|
|
243
|
+
sourceTemplates:compareTemplates(before?.sourceTemplates,after?.sourceTemplates,
|
|
244
|
+
before?.machineBits===after?.machineBits?before?.machineBits:undefined,definitionEvidence,lawEvidence,unitEvidence),
|
|
245
|
+
nativeBindings:incomplete('Native constructor, field and representation bindings require project-wide correspondence.'),
|
|
246
|
+
generatedBehavior:incomplete('Generated plans and native behavior require their own target validation.'),
|
|
247
|
+
};
|
|
248
|
+
if(!available(before)||!available(after)||before.machineBits!==after.machineBits) {
|
|
249
|
+
const reason='The compiler did not return matching-version Core migration snapshots at one machine width.';
|
|
250
|
+
return {status:'not-established',scope:'checked concrete Core',
|
|
251
|
+
...Object.fromEntries(components.map(([,component])=>[component,incomplete(reason)])),
|
|
252
|
+
domainPolicies:incomplete(reason),...unproved};
|
|
253
|
+
}
|
|
254
|
+
const checks=Object.fromEntries(components.map(([field,component])=>[component,
|
|
255
|
+
before[field]===after[field]?{status:'matched',basis:'matching-full-Core-fingerprints'}:incomplete('The normalized '+component+' fingerprints differ; correspondence has not been established.')]));
|
|
256
|
+
const domainPolicies=compareTransportedDomains(before,after,transport,compareDomainPolicies(before,after));
|
|
257
|
+
const transported=checkedTransportBodies(before,after,transport);
|
|
258
|
+
if(transported) for(const component of ['definitionPlane','lawBodies']) {
|
|
259
|
+
if(checks[component].status!=='matched') checks[component]={status:'matched',
|
|
260
|
+
basis:'matching-complete-Core-fingerprints-after-validated-payload-transport'};
|
|
261
|
+
}
|
|
262
|
+
// lawBodiesDigest covers the entire normalized Core, with only root input
|
|
263
|
+
// population policies erased. Equal bodies plus verified policy equivalence
|
|
264
|
+
// establish Core correspondence; they do not establish any law's truth.
|
|
265
|
+
if(checks.program.status!=='matched'&&checks.definitionPlane.status==='matched'&&
|
|
266
|
+
checks.lawBodies.status==='matched'&&domainPolicies.status==='matched') {
|
|
267
|
+
checks.program={status:'matched',basis:transported?
|
|
268
|
+
'matching-complete-Core-after-validated-payload-transport-and-input-domain-correspondence':
|
|
269
|
+
'matching-policy-erased-complete-Core-and-verified-input-domains'};
|
|
270
|
+
}
|
|
271
|
+
return {status:'not-established',scope:'checked concrete Core',...checks,
|
|
272
|
+
differences:differences(before,after,parts),
|
|
273
|
+
lawBodies:{...checks.lawBodies,includesDomainPolicy:false},
|
|
274
|
+
domainPolicies,...unproved};
|
|
275
|
+
}
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
// Generated from templates/npm/migration-generation.mjs by lawspec-dev generate. Do not edit.
|
|
2
|
+
// Generation is an independent migration gate. A compiler's accepted emission
|
|
3
|
+
// receipt never means that a target compiler or an external implementation ran.
|
|
4
|
+
import {bindingDigest,checkBindingProposal} from './migration-bindings.mjs';
|
|
5
|
+
|
|
6
|
+
const pending=reason=>({status:'not-established',reason});
|
|
7
|
+
const digest=value=>typeof value==='string'&&/^[0-9a-f]{64}$/.test(value);
|
|
8
|
+
const sourceInputs=input=>Object.fromEntries(['sources','packages','package','dependencies']
|
|
9
|
+
.filter(key=>input[key]!==undefined).map(key=>[key,input[key]]));
|
|
10
|
+
const safePath=value=>typeof value==='string'&&value.length>0&&!/[\\\0]/.test(value)&&
|
|
11
|
+
value.split('/').every(part=>part&&part!=='.'&&part!=='..')&&!/^[A-Za-z]:/.test(value);
|
|
12
|
+
const acceptedSide=side=>side?.status==='accepted'&&Array.isArray(side.diagnostics)&&side.diagnostics.length===0&&
|
|
13
|
+
Array.isArray(side.files)&&side.files.length>0&&side.files.every(file=>file&&safePath(file.path)&&
|
|
14
|
+
['user','generated'].includes(file.ownership)&&['source','test'].includes(file.placement)&&
|
|
15
|
+
Object.keys(file).every(key=>['path','ownership','placement','contentDigest','adapterReferenceDigest'].includes(key))&&
|
|
16
|
+
digest(file.contentDigest)&&(file.adapterReferenceDigest===undefined||digest(file.adapterReferenceDigest)))&&
|
|
17
|
+
new Set(side.files.map(file=>file.path)).size===side.files.length&&digest(side.artifactDigest)&&
|
|
18
|
+
bindingDigest(side.files)===side.artifactDigest;
|
|
19
|
+
|
|
20
|
+
export function checkGenerationReceipt(before,after,request,bindingProposal,evidence){
|
|
21
|
+
if(!request?.migrated||!request.generation||!evidence?.generation)
|
|
22
|
+
return pending('A complete generation request and receipt are required.');
|
|
23
|
+
const proposal=evidence?.bindingProposal;
|
|
24
|
+
const binding=checkBindingProposal(before,after,request.nativeBindings,request.target,proposal);
|
|
25
|
+
if(binding.status!=='matched'||bindingDigest(proposal)!==bindingDigest(bindingProposal))
|
|
26
|
+
return pending('Generation does not carry the matching checked binding proposal.');
|
|
27
|
+
if(evidence?.version!==1||evidence.algorithm!=='sha256'||evidence.target!==request.target||
|
|
28
|
+
evidence.machineBits!==(request.machineBits??64)||evidence.sourceDir!==(request.sourceDir??null)||
|
|
29
|
+
evidence.testDir!==(request.testDir??null)||evidence.minify!==(request.minify??false)||
|
|
30
|
+
bindingDigest(evidence.generation)!==bindingDigest(request.generation)||evidence.planning!=='legacy-harnesses'||
|
|
31
|
+
evidence.sourceInputs?.before!==bindingDigest(sourceInputs(request))||
|
|
32
|
+
evidence.sourceInputs?.after!==bindingDigest(sourceInputs(request.migrated))||
|
|
33
|
+
evidence.nativeConformance!=='not-established'||evidence.lawVerification!=='not-established-by-generation')
|
|
34
|
+
return pending('Generation receipt does not match these exact sources, dependencies, target, width, layout and limits.');
|
|
35
|
+
if(evidence.status!=='accepted'||!acceptedSide(evidence.before)||!acceptedSide(evidence.after)){
|
|
36
|
+
const failures=['before','after'].flatMap(side=>evidence[side]?.diagnostics?.map(item=>`${side}: ${item.code}: ${item.message}`)??[]);
|
|
37
|
+
return pending(failures.join(' ')||evidence.after?.reason||'Complete target generation was not accepted on both inputs.');
|
|
38
|
+
}
|
|
39
|
+
return {status:'accepted',basis:'compiler-emission-of-both-checked-programs',
|
|
40
|
+
scope:'legacy harness plans and complete artifact manifests; target compilation and native behavior remain separate'};
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
const boundaryAssumptions=['existing compiler emitters',
|
|
44
|
+
'unchanged native implementations under their original binding assumptions'];
|
|
45
|
+
const boundaryKeys=['configuration','types','calls','handlers','unboundAdapters','unmappedData'];
|
|
46
|
+
const availableBoundary=side=>side?.status==='available'&&side.contract&&
|
|
47
|
+
typeof side.contract==='object'&&!Array.isArray(side.contract)&&
|
|
48
|
+
Object.keys(side.contract).length===boundaryKeys.length&&
|
|
49
|
+
boundaryKeys.every(key=>key==='configuration'?side.contract[key]&&typeof side.contract[key]==='object'&&
|
|
50
|
+
!Array.isArray(side.contract[key]):Array.isArray(side.contract[key]))&&
|
|
51
|
+
digest(side.digest)&&bindingDigest(side.contract)===side.digest;
|
|
52
|
+
|
|
53
|
+
export function checkNativeBoundaryReceipt(before,after,request,bindingProposal,evidence){
|
|
54
|
+
const generation=checkGenerationReceipt(before,after,request,bindingProposal,evidence);
|
|
55
|
+
if(generation.status!=='accepted')return pending(generation.reason);
|
|
56
|
+
const boundary=evidence.nativeBoundary;
|
|
57
|
+
if(boundary?.version!==1||boundary.algorithm!=='sha256'||boundary.policy!=='resolved-native-contract-v1'||
|
|
58
|
+
boundary.nativeConformance!=='not-established'||
|
|
59
|
+
boundary.lawVerification!=='not-established-by-boundary-correspondence'||
|
|
60
|
+
bindingDigest(boundary.assumptions??null)!==bindingDigest(boundaryAssumptions)||
|
|
61
|
+
!availableBoundary(boundary.before)||!availableBoundary(boundary.after))
|
|
62
|
+
return pending(boundary?.after?.reason||boundary?.before?.reason||
|
|
63
|
+
'A complete resolved native boundary comparison with its original assumptions is required.');
|
|
64
|
+
const configuration={...bindingProposal.proposedNativeBindings,types:[]};
|
|
65
|
+
if(bindingDigest(boundary.after.contract.configuration)!==bindingDigest(configuration)||
|
|
66
|
+
boundary.status!=='matched'||boundary.before.digest!==boundary.after.digest)
|
|
67
|
+
return pending('Resolved native call contracts or generated adapter layouts differ across the migration.');
|
|
68
|
+
return {status:'matched',basis:'compiler-resolved-native-contract-correspondence',
|
|
69
|
+
scope:boundary.scope,assumptions:[...boundaryAssumptions],
|
|
70
|
+
nativeConformance:'not-established',lawVerification:'not-established-by-boundary-correspondence'};
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
export async function planMigrationGeneration(compiler,config,input,sources,before,after,bindingPreview,migratedContext={}){
|
|
74
|
+
const rows=[];
|
|
75
|
+
for(const binding of bindingPreview.targets){
|
|
76
|
+
const target=binding.index===null?input:config.targets[binding.index];
|
|
77
|
+
if(binding.status!=='matched'||!binding.target||typeof compiler.migrationGeneration!=='function'){
|
|
78
|
+
const unavailable=pending(binding.reason||
|
|
79
|
+
'A concrete target, matching binding proposal and generation-capable compiler are required.');
|
|
80
|
+
rows.push({target:binding.target,index:binding.index,...unavailable,nativeBoundary:{...unavailable}});continue;
|
|
81
|
+
}
|
|
82
|
+
const options={...input,schemaVersion:5,languageProfile:'1.0-rc.1',verification:{layers:[]},
|
|
83
|
+
target:binding.target,sourceDir:target.sourceDir,testDir:target.testDir,minify:input.minify===true};
|
|
84
|
+
const request={...options,from:'0.24',nativeBindings:binding.evidence.inputBindings,
|
|
85
|
+
migrated:{...options,...migratedContext,sources,nativeBindings:binding.proposedNativeBindings}};
|
|
86
|
+
const result=await compiler.migrationGeneration(request),evidence=result.migrationGeneration;
|
|
87
|
+
const checked=result.diagnostics?.length?pending(result.diagnostics.map(item=>item.message).join(' ')):
|
|
88
|
+
checkGenerationReceipt(before,after,request,binding.evidence,evidence);
|
|
89
|
+
const nativeBoundary=checked.status==='accepted'?
|
|
90
|
+
checkNativeBoundaryReceipt(before,after,request,binding.evidence,evidence):pending(checked.reason);
|
|
91
|
+
rows.push({target:binding.target,index:binding.index,...checked,nativeBoundary,evidence,diagnostics:result.diagnostics??[]});
|
|
92
|
+
}
|
|
93
|
+
const count=bindingPreview.configurationCount;
|
|
94
|
+
return {status:count===0?'not-requested':rows.length===count&&rows.every(row=>row.status==='accepted')?'accepted':'not-established',
|
|
95
|
+
scope:'every configured target; emitted artifacts, not native execution',configurationCount:count,targets:rows,
|
|
96
|
+
nativeBoundary:{status:count===0?'not-requested':rows.length===count&&rows.every(row=>row.nativeBoundary.status==='matched')?
|
|
97
|
+
'matched':'not-established',configurationCount:count,
|
|
98
|
+
scope:'resolved native call contracts and generated adapter layouts under unchanged native implementation assumptions'}};
|
|
99
|
+
}
|
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
// Generated from templates/npm/migration-laws.mjs by lawspec-dev generate. Do not edit.
|
|
2
|
+
// Law edits consume the original parser's checked source inventory. They
|
|
3
|
+
// deliberately target the current minor grammar; its remaining plain closers
|
|
4
|
+
// are superseded by the following milestone's all-named-ending requirement.
|
|
5
|
+
import {MigrationDocument,planLegacyComputationEdits} from './migration-source.mjs';
|
|
6
|
+
import {planLegacyCases} from './migration-cases.mjs';
|
|
7
|
+
import {planLegacyRecords,legacyRecordShapes} from './migration-records.mjs';
|
|
8
|
+
import {planLegacyCollectionNames} from './migration-collections.mjs';
|
|
9
|
+
|
|
10
|
+
function phrase(name) {
|
|
11
|
+
if (!name || name.trim() !== name || /[\r\n]/.test(name))
|
|
12
|
+
throw new Error('Legacy quoted names with empty bodies or edge whitespace need an explicit rename');
|
|
13
|
+
return '"|' + name.replace(/[\\|]/g,character => '\\'+character) + '|';
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
export function planLegacySourceEdits(sources, baseline, sourceSyntax, sourceFields) {
|
|
17
|
+
const computations = planLegacyComputationEdits(sources,baseline,sourceSyntax);
|
|
18
|
+
const documents = new Map(sources.map(source => [source.path,new MigrationDocument(source)]));
|
|
19
|
+
for (const source of computations) documents.get(source.path).edits.push(...source.edits);
|
|
20
|
+
// The legacy resolver uses the bare target Natural for its implicit
|
|
21
|
+
// refinement and same-spelled user refinements. Do not assume the builtin
|
|
22
|
+
// meaning if any admitted source explicitly declares that refinement.
|
|
23
|
+
const builtinNatural=!sourceSyntax.some(source=>source.nodes.some(node=>
|
|
24
|
+
node.kind==='declaration.refinement'&&node.name==='Natural'));
|
|
25
|
+
const indexed=sourceSyntax.filter(source=>documents.has(source.path)).map(source=>{
|
|
26
|
+
const document=documents.get(source.path);
|
|
27
|
+
const nodes=source.nodes.map(node=>({...node,...document.range({kind:'source',span:node.span})}));
|
|
28
|
+
if (nodes.some(node=>!Number.isInteger(node.start))) throw new Error('Source inventory belongs to a different migration document');
|
|
29
|
+
return {...source,nodes,builtinNatural,
|
|
30
|
+
constructorShapes:sourceFields?.status==='available' ? sourceFields.constructors : null,
|
|
31
|
+
fieldUses:sourceFields?.status==='available' ? sourceFields.uses.filter(use=>use.span.start.file===source.path) : null};
|
|
32
|
+
});
|
|
33
|
+
const shapes=legacyRecordShapes(indexed);
|
|
34
|
+
for (const source of indexed) {
|
|
35
|
+
const document = documents.get(source.path);
|
|
36
|
+
if (!document) continue;
|
|
37
|
+
const nodes=source.nodes;
|
|
38
|
+
const contains = (outer,inner) => outer.start <= inner.start && inner.end <= outer.end;
|
|
39
|
+
const code = node => document.code(node.start,node.end);
|
|
40
|
+
const first = node => code(node)[0];
|
|
41
|
+
const replaceToken = (token,content,reason) => {
|
|
42
|
+
if (!token) throw new Error('Checked source node has no token for '+reason);
|
|
43
|
+
document.edit(token.start,token.end,content,reason);
|
|
44
|
+
};
|
|
45
|
+
const headerDelimiter = (node,word) => {
|
|
46
|
+
let depth = 0;
|
|
47
|
+
return code(node).find(token => {
|
|
48
|
+
if (['(','[','{'].includes(token.text)) depth++;
|
|
49
|
+
if ([')',']','}'].includes(token.text)) depth--;
|
|
50
|
+
return depth === 0 && token.text === word;
|
|
51
|
+
});
|
|
52
|
+
};
|
|
53
|
+
planLegacyCollectionNames(document,source);
|
|
54
|
+
planLegacyRecords(document,source,shapes);
|
|
55
|
+
planLegacyCases(document,nodes);
|
|
56
|
+
for (const node of nodes) {
|
|
57
|
+
if (node.kind === 'quoted-name') {
|
|
58
|
+
// Scenarios and benchmark labels retain their existing quoted syntax.
|
|
59
|
+
if (nodes.some(parent => ['declaration.scenario','benchmark'].includes(parent.kind) && contains(parent,node))) continue;
|
|
60
|
+
const token = first(node);
|
|
61
|
+
if (token?.kind !== 'quoted') throw new Error('Checked quoted name has no legacy delimiter');
|
|
62
|
+
const marker = nodes.some(parent => ['import','export'].includes(parent.kind) && contains(parent,node)) ? 'law ' : '';
|
|
63
|
+
replaceToken(token,marker+phrase(node.name),'quoted law or example name');
|
|
64
|
+
}
|
|
65
|
+
if (node.kind === 'law-reference')
|
|
66
|
+
document.edit(node.start,node.start,'apply law ','reusable law application');
|
|
67
|
+
if (node.kind === 'section') {
|
|
68
|
+
const tokens = code(node);
|
|
69
|
+
const delimiter = tokens[1];
|
|
70
|
+
if (tokens[0]?.text !== node.name || !['is','are'].includes(delimiter?.text))
|
|
71
|
+
throw new Error('Checked law section has no legacy delimiter');
|
|
72
|
+
replaceToken(delimiter,':','law section delimiter');
|
|
73
|
+
}
|
|
74
|
+
if (node.kind === 'example') {
|
|
75
|
+
replaceToken(headerDelimiter(node,'is'),':','example delimiter');
|
|
76
|
+
}
|
|
77
|
+
if (node.kind === 'quantifier.forall') {
|
|
78
|
+
const tokens = code(node);
|
|
79
|
+
if (tokens[0]?.text !== '`for all`') throw new Error('Checked universal quantifier has no legacy opener');
|
|
80
|
+
replaceToken(tokens[0],'for all','universal quantifier');
|
|
81
|
+
replaceToken(headerDelimiter(node,'.'),'=>','universal binder delimiter');
|
|
82
|
+
// Source inventory is in completion order, so nested quantifiers at
|
|
83
|
+
// the same offset close inside out, after any inner conditional.
|
|
84
|
+
document.edit(tokens.at(-1).end,tokens.at(-1).end,' end','universal scope','universal:'+node.start);
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
// Expectations move as one lossless source range. Comments, line breaks,
|
|
88
|
+
// recorded names and child expression edits accompany the moved text.
|
|
89
|
+
for (const table of nodes.filter(node => node.kind === 'table')) {
|
|
90
|
+
const expectations = nodes.filter(node => node.kind === 'table-expectation' && contains(table,node));
|
|
91
|
+
if (!expectations.length) throw new Error('A legacy table without expectations needs an explicit authoring decision');
|
|
92
|
+
const start = Math.min(...expectations.map(node => node.start));
|
|
93
|
+
const end = Math.max(...expectations.map(node => node.end));
|
|
94
|
+
const opener = first(table);
|
|
95
|
+
if (opener?.text !== 'table') throw new Error('Checked table has no legacy opener');
|
|
96
|
+
replaceToken(headerDelimiter(table,'is'),':','table delimiter');
|
|
97
|
+
document.moveBefore(start,end,opener.start,'expectation-first table');
|
|
98
|
+
document.edit(opener.start,opener.start,'in ','expectation table introducer');
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
return [...documents.values()].map(document => document.result());
|
|
102
|
+
}
|