@volter/twin-standard 1.0.138 → 1.0.140

package/dist/src/gate.d.ts

@@ -1,9 +1,10 @@
+import { type GradeOptions } from './grade.js';
 /** Every unit of a pack repository: each pack (a directory with a package.json) and each lane in it (a directory with
  *  its own src/manifest.ts and no package.json). */
 export declare function unitsOf(repo: string): string[];
 export declare function laneRootFailures(dir: string): string[];
 /** Each unit's blocking form failures (empty when it may be in the repository). */
-export declare function p3Gate(units: string[]): Promise<Array<{
+export declare function p3Gate(units: string[], opts?: Pick<GradeOptions, 'onCriterion'>): Promise<Array<{
     unit: string;
     failures: string[];
 }>>;

package/dist/src/gate.js

@@ -96,7 +96,7 @@ export function laneRootFailures(dir) {
     return beyond.length ? [...failures, `kernel-contract: ${beyond.join('; ')}`] : failures;
 }
 /** Each unit's blocking form failures (empty when it may be in the repository). */
-export async function p3Gate(units) {
+export async function p3Gate(units, opts = {}) {
     return withCheckoutFiles(async () => {
         const out = [];
         for (const unit of units) {
@@ -107,7 +107,7 @@ export async function p3Gate(units) {
                 out.push({ unit, failures: laneRootFailures(unit) });
                 continue;
             }
-            const grades = await grade(unit, { static: true, sections: ['form'] });
+            const grades = await grade(unit, { static: true, sections: ['form'], ...opts });
             const form = Object.values(grades).flatMap((g) => g.criteria).filter((c) => !c.pass);
             out.push({ unit, failures: form.map((c) => `${c.id}: ${c.reason}`) });
         }

package/dist/src/grade.d.ts

@@ -16,6 +16,11 @@ export interface StandardGrade {
     planned: string[];
 }
 export type GradeOptions = {
+    /** Report which native criterion is being read, without changing its result. */
+    onCriterion?: (unit: string, criterion: string, result?: {
+        pass: boolean;
+        reason: string;
+    }) => void;
     /** only the criteria that read the tree (the executed ones are the pack's typecheck and tests) */
     static?: boolean;
     /** only these sections (the catalog grades a submission's `form`) */

package/dist/src/grade.js

@@ -20,6 +20,7 @@ export async function grade(dir, opts = {}) {
                 continue;
             if (opts.sections && !opts.sections.includes(c.section))
                 continue;
+            opts.onCriterion?.(name, c.id);
             let result;
             try {
                 result = await c.check(unit);
@@ -27,6 +28,7 @@ export async function grade(dir, opts = {}) {
             catch (e) {
                 result = { pass: false, reason: `the check threw: ${e.message.slice(0, 160)}` };
             }
+            opts.onCriterion?.(name, c.id, result);
             criteria.push({ id: c.id, section: c.section, asks: c.asks, ...result });
         }
         const met = criteria.filter((c) => c.pass).length;

package/dist/src/protocol-3.js

@@ -335,7 +335,9 @@ const criteria = [
                     const m = (await import(__rewriteRelativeImportExtension(join(src, 'manifest.ts')))).manifest;
                     ids = new Set((m?.screens ?? []).map((x) => x.id));
                 }
-                catch { /* a manifest that does not load fails manifest-data and states-module */ }
+                catch (error) {
+                    outside.push(`(manifest.ts does not load: ${error instanceof Error ? error.message : String(error)})`);
+                }
                 // screens/shared.tsx: what two or more of the pack's screens share (its page shell, its skin), itself no screen.
                 // Without the manifest's screen ids no screen file can be judged: that is said, never every screen listed outside.
                 if (ids === undefined)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/twin-standard",
-  "version": "1.0.138",
+  "version": "1.0.140",
   "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.146",
+    "@volter/world-core": "3.0.148",
     "@volter/world-runtime": "*",
     "playwright": "^1.63.0"
   },

package/src/gate.ts

@@ -16,7 +16,7 @@ import { spawnSync } from 'node:child_process';
 import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
 import { join } from 'node:path';
 import ts from 'typescript';
-import { grade } from './grade.ts';
+import { grade, type GradeOptions } from './grade.ts';
 import { withCheckoutFiles } from './protocol-3.ts';
 import { isPackArtifact } from './pack-files.ts';
 
@@ -85,7 +85,7 @@ export function laneRootFailures(dir: string): string[] {
 }
 
 /** Each unit's blocking form failures (empty when it may be in the repository). */
-export async function p3Gate(units: string[]): Promise<Array<{ unit: string; failures: string[] }>> {
+export async function p3Gate(units: string[], opts: Pick<GradeOptions, 'onCriterion'> = {}): Promise<Array<{ unit: string; failures: string[] }>> {
   return withCheckoutFiles(async () => {
     const out: Array<{ unit: string; failures: string[] }> = [];
     for (const unit of units) {
@@ -93,7 +93,7 @@ export async function p3Gate(units: string[]): Promise<Array<{ unit: string; fai
       // front (architecture, "Pack layout", "Other wires: lanes")
       const lanesOnly = !hasOwnSurface(unit) && readdirSync(unit).some((n) => existsSync(join(unit, n, 'src', 'manifest.ts')));
       if (lanesOnly || !existsSync(join(unit, 'src', 'manifest.ts'))) { out.push({ unit, failures: laneRootFailures(unit) }); continue; }
-      const grades = await grade(unit, { static: true, sections: ['form'] });
+      const grades = await grade(unit, { static: true, sections: ['form'], ...opts });
       const form = Object.values(grades).flatMap((g) => g.criteria).filter((c) => !c.pass);
       out.push({ unit, failures: form.map((c) => `${c.id}: ${c.reason}`) });
     }

package/src/grade.ts

@@ -14,6 +14,8 @@ export interface CriterionGrade { id: string; section: string; asks: string; pas
 export interface StandardGrade { grade: number; met: number; total: number; criteria: CriterionGrade[]; planned: string[] }
 
 export type GradeOptions = {
+  /** Report which native criterion is being read, without changing its result. */
+  onCriterion?: (unit: string, criterion: string, result?: { pass: boolean; reason: string }) => void;
   /** only the criteria that read the tree (the executed ones are the pack's typecheck and tests) */
   static?: boolean;
   /** only these sections (the catalog grades a submission's `form`) */
@@ -36,8 +38,10 @@ export async function grade(dir: string, opts: GradeOptions = {}): Promise<Recor
     for (const c of standard.criteria) {
       if (opts.static && c.executed) continue;
       if (opts.sections && !opts.sections.includes(c.section)) continue;
+      opts.onCriterion?.(name, c.id);
       let result;
       try { result = await c.check(unit); } catch (e) { result = { pass: false, reason: `the check threw: ${(e as Error).message.slice(0, 160)}` }; }
+      opts.onCriterion?.(name, c.id, result);
       criteria.push({ id: c.id, section: c.section, asks: c.asks, ...result });
     }
     const met = criteria.filter((c) => c.pass).length;

package/src/protocol-3.ts

@@ -301,7 +301,7 @@ const criteria: Criterion[] = [
         try {
           const m = ((await import(join(src, 'manifest.ts'))) as { manifest?: { screens?: Array<{ id: string }> } }).manifest;
           ids = new Set((m?.screens ?? []).map((x) => x.id));
-        } catch { /* a manifest that does not load fails manifest-data and states-module */ }
+        } catch (error) { outside.push(`(manifest.ts does not load: ${error instanceof Error ? error.message : String(error)})`); }
         // screens/shared.tsx: what two or more of the pack's screens share (its page shell, its skin), itself no screen.
         // Without the manifest's screen ids no screen file can be judged: that is said, never every screen listed outside.
         if (ids === undefined) outside.push('(src/screens/ unjudged: manifest.ts does not load)');