@volter/twin-standard 1.0.104 → 1.0.105

package/dist/src/assessment.d.ts

@@ -96,8 +96,12 @@ export declare function assessPack(packDir: string, options?: AssessmentOptions)
         teardownVerified: boolean;
         retainedReadback: boolean;
         clock: {
+            beforeStop?: string | null | undefined;
+            afterResume?: string | null | undefined;
+            retentionVerified?: boolean | undefined;
             at: string;
             advanceAfterRun?: string;
+            mode?: undefined;
         } | {
             mode: string;
         };

package/dist/src/consumer.d.ts

@@ -80,8 +80,12 @@ export declare function runConsumerWorkflow(packDir: string, options: ConsumerOp
     teardownVerified: boolean;
     retainedReadback: boolean;
     clock: {
+        beforeStop?: string | null | undefined;
+        afterResume?: string | null | undefined;
+        retentionVerified?: boolean | undefined;
         at: string;
         advanceAfterRun?: string;
+        mode?: undefined;
     } | {
         mode: string;
     };

package/dist/src/consumer.js

@@ -163,6 +163,8 @@ export async function runConsumerWorkflow(packDir, options) {
     let upAttempted = false;
     let retainedReadback = false;
     let teardownVerified = false;
+    let clockBeforeStop = null;
+    let clockAfterResume = null;
     try {
         if (compiledCli)
             nodeVersion = (await execute('node-version', 'node', ['--version'])).trim();
@@ -180,9 +182,20 @@ export async function runConsumerWorkflow(packDir, options) {
                 await run('clock-advance', ['clock', 'advance', recipe.clock.advanceAfterRun]);
                 await run('inspect-timed-result', ['run', '--', ...recipe.retention.readback]);
             }
+            if (recipe.clock) {
+                clockBeforeStop = (await run('clock-before-stop', ['clock', 'show'])).trim();
+                const instant = Date.parse(clockBeforeStop);
+                if (!Number.isFinite(instant) || new Date(instant).toISOString() !== clockBeforeStop)
+                    throw new Error('Declared customer clock is not frozen before stop');
+            }
             const before = JSON.parse(await run('log-before-stop', ['log', '--json']));
             await run('stop', ['down']);
             await run('resume', ['up']);
+            if (recipe.clock) {
+                clockAfterResume = (await run('clock-after-resume', ['clock', 'show'])).trim();
+                if (clockAfterResume !== clockBeforeStop)
+                    throw new Error('Resume lost or changed the declared customer clock');
+            }
             const resumed = JSON.parse(await run('log-after-resume', ['log', '--json']));
             if (JSON.stringify(before) !== JSON.stringify(resumed))
                 throw new Error('Resume changed recorded application state before readback');
@@ -218,7 +231,7 @@ export async function runConsumerWorkflow(packDir, options) {
         sourceInputsSha256: consumerSourceDigest(packDir), recipeSha256: createHash('sha256').update(JSON.stringify(recipe)).digest('hex'),
         fixture: existsSync(join(packDir, 'journeys/first-use.json')) ? 'journeys/first-use.json' : `standard/clients/${vendor}.first-use.json`, appDir: resolve(options.appDir), appName: basename(options.appDir),
         commands, failures, teardownVerified, retainedReadback,
-        clock: recipe.clock ?? { mode: 'wall' },
+        clock: recipe.clock ? { ...recipe.clock, ...('readback' in recipe.retention ? { beforeStop: clockBeforeStop, afterResume: clockAfterResume, retentionVerified: retainedReadback && clockBeforeStop !== null && clockBeforeStop === clockAfterResume } : {}) } : { mode: 'wall' },
         ...('none' in recipe.retention ? { retentionNotApplicable: recipe.retention.none } : {}),
         node: nodeVersion,
         evaluatorRuntime: { nodeCompatibility: process.versions.node, bun: process.versions.bun ?? null },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/twin-standard",
-  "version": "1.0.104",
+  "version": "1.0.105",
   "description": "The Protocol 3 standard for Volter twin packs: the criteria a pack is graded by, the grader, the gate a pack repository and the twin catalog run on every change and submission, and the spec derivation the grade checks against. Pin a version: every place a pack is judged judges by that standard.",
   "keywords": [
     "twin",
@@ -75,7 +75,7 @@
     "yaml": "2.9.0"
   },
   "peerDependencies": {
-    "@volter/world-core": "3.0.112",
+    "@volter/world-core": "3.0.113",
     "@volter/world-runtime": "*",
     "playwright": "^1.63.0"
   },

package/src/consumer.ts

@@ -149,6 +149,8 @@ export async function runConsumerWorkflow(packDir: string, options: ConsumerOpti
   let upAttempted = false;
   let retainedReadback = false;
   let teardownVerified = false;
+  let clockBeforeStop: string | null = null;
+  let clockAfterResume: string | null = null;
   try {
     if (compiledCli) nodeVersion = (await execute('node-version', 'node', ['--version'])).trim();
     await run('init', ['init', '--twins', vendor]);
@@ -163,9 +165,18 @@ export async function runConsumerWorkflow(packDir: string, options: ConsumerOpti
         await run('clock-advance', ['clock', 'advance', recipe.clock.advanceAfterRun]);
         await run('inspect-timed-result', ['run', '--', ...recipe.retention.readback]);
       }
+      if (recipe.clock) {
+        clockBeforeStop = (await run('clock-before-stop', ['clock', 'show'])).trim();
+        const instant = Date.parse(clockBeforeStop);
+        if (!Number.isFinite(instant) || new Date(instant).toISOString() !== clockBeforeStop) throw new Error('Declared customer clock is not frozen before stop');
+      }
       const before = JSON.parse(await run('log-before-stop', ['log', '--json']));
       await run('stop', ['down']);
       await run('resume', ['up']);
+      if (recipe.clock) {
+        clockAfterResume = (await run('clock-after-resume', ['clock', 'show'])).trim();
+        if (clockAfterResume !== clockBeforeStop) throw new Error('Resume lost or changed the declared customer clock');
+      }
       const resumed = JSON.parse(await run('log-after-resume', ['log', '--json']));
       if (JSON.stringify(before) !== JSON.stringify(resumed)) throw new Error('Resume changed recorded application state before readback');
       await run('retained-readback', ['run', '--', ...recipe.retention.readback]);
@@ -192,7 +203,7 @@ export async function runConsumerWorkflow(packDir: string, options: ConsumerOpti
     sourceInputsSha256: consumerSourceDigest(packDir), recipeSha256: createHash('sha256').update(JSON.stringify(recipe)).digest('hex'),
     fixture: existsSync(join(packDir, 'journeys/first-use.json')) ? 'journeys/first-use.json' : `standard/clients/${vendor}.first-use.json`, appDir: resolve(options.appDir), appName: basename(options.appDir),
     commands, failures, teardownVerified, retainedReadback,
-    clock: recipe.clock ?? { mode: 'wall' },
+    clock: recipe.clock ? { ...recipe.clock, ...('readback' in recipe.retention ? { beforeStop: clockBeforeStop, afterResume: clockAfterResume, retentionVerified: retainedReadback && clockBeforeStop !== null && clockBeforeStop === clockAfterResume } : {}) } : { mode: 'wall' },
     ...('none' in recipe.retention ? { retentionNotApplicable: recipe.retention.none } : {}),
     node: nodeVersion,
     evaluatorRuntime: { nodeCompatibility: process.versions.node, bun: process.versions.bun ?? null },