@fundamental-engine/core 0.4.0

package/dist/inspect/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/inspect/report.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,uEAAuE;IACvE,wBAAwB,EAAE,MAAM,EAAE,CAAC;CACpC;AAED,iEAAiE;AACjE,wBAAgB,YAAY,IAAI,YAAY,CAc3C;AAED,4DAA4D;AAC5D,wBAAgB,UAAU,CAAC,CAAC,GAAE,YAA6B,GAAG,MAAM,CAWnE"}

package/dist/inspect/report.js

@@ -0,0 +1,44 @@
+/**
+ * System report (testing-and-conformance, "agent report" / productization). Aggregates the whole
+ * field-ui model into one inspectable object: how many contracts, force passports, conformance
+ * experiments, agent types, and recipes the build ships — and whether every force is both
+ * passported and conformance-covered. A productization artifact: a build can print it, a CI can
+ * assert on it, an Inspector can render it.
+ */
+import { CONTRACTS } from "../contracts/index.js";
+import { PASSPORTS } from "../contracts/passport.js";
+import { AGENT_CONTRACTS } from "../agents/index.js";
+import { VISUAL_CONTRACTS } from "../visual/index.js";
+import { RECIPE_CONTRACTS, FIELD_RECIPES } from "../recipes/index.js";
+import { EXPERIMENTS } from "../conformance/experiments.js";
+import { allForces } from "../conformance/run.js";
+/** Build the system report from the live registry + catalogs. */
+export function systemReport() {
+    const registry = allForces();
+    const tokens = Object.keys(registry);
+    const experimented = new Set(EXPERIMENTS.map((e) => e.scenario.force));
+    return {
+        forces: tokens.length,
+        passports: Object.keys(PASSPORTS).length,
+        conformanceExperiments: EXPERIMENTS.length,
+        contracts: CONTRACTS.length + AGENT_CONTRACTS.length + VISUAL_CONTRACTS.length + RECIPE_CONTRACTS.length,
+        agentTypes: AGENT_CONTRACTS.length,
+        recipes: FIELD_RECIPES.length,
+        forcesMissingPassport: tokens.filter((t) => !PASSPORTS[t]),
+        forcesMissingConformance: tokens.filter((t) => !experimented.has(t)),
+    };
+}
+/** Render the system report as a short Markdown summary. */
+export function reportText(r = systemReport()) {
+    const ok = (xs) => (xs.length ? `⚠ ${xs.join(', ')}` : '✓ none');
+    return [
+        '# field-ui system report',
+        '',
+        `- Forces: **${r.forces}** (passports: ${r.passports}, conformance experiments: ${r.conformanceExperiments})`,
+        `- Contracts: **${r.contracts}** (agent types: ${r.agentTypes})`,
+        `- Field recipes: **${r.recipes}**`,
+        `- Forces missing a passport: ${ok(r.forcesMissingPassport)}`,
+        `- Forces missing conformance: ${ok(r.forcesMissingConformance)}`,
+    ].join('\n');
+}
+//# sourceMappingURL=report.js.map

package/dist/inspect/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/inspect/report.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAelD,iEAAiE;AACjE,MAAM,UAAU,YAAY;IAC1B,MAAM,QAAQ,GAAG,SAAS,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IACvE,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM;QACxC,sBAAsB,EAAE,WAAW,CAAC,MAAM;QAC1C,SAAS,EAAE,SAAS,CAAC,MAAM,GAAG,eAAe,CAAC,MAAM,GAAG,gBAAgB,CAAC,MAAM,GAAG,gBAAgB,CAAC,MAAM;QACxG,UAAU,EAAE,eAAe,CAAC,MAAM;QAClC,OAAO,EAAE,aAAa,CAAC,MAAM;QAC7B,qBAAqB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC1D,wBAAwB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;KACrE,CAAC;AACJ,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,UAAU,CAAC,IAAkB,YAAY,EAAE;IACzD,MAAM,EAAE,GAAG,CAAC,EAAY,EAAU,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACnF,OAAO;QACL,0BAA0B;QAC1B,EAAE;QACF,eAAe,CAAC,CAAC,MAAM,kBAAkB,CAAC,CAAC,SAAS,8BAA8B,CAAC,CAAC,sBAAsB,GAAG;QAC7G,kBAAkB,CAAC,CAAC,SAAS,oBAAoB,CAAC,CAAC,UAAU,GAAG;QAChE,sBAAsB,CAAC,CAAC,OAAO,IAAI;QACnC,gCAAgC,EAAE,CAAC,CAAC,CAAC,qBAAqB,CAAC,EAAE;QAC7D,iCAAiC,EAAE,CAAC,CAAC,CAAC,wBAAwB,CAAC,EAAE;KAClE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/inspect/snapshot.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Snapshot regression (testing-and-conformance §12). Run a seeded scenario through the real engine
+ * and capture a small, deterministic fingerprint of the result — particle count and mean speed /
+ * heat at the final frame. Because the runner is deterministic (seeded RNG), the same scenario
+ * always yields the same snapshot, so a snapshot saved today catches an accidental physics change
+ * tomorrow. Pure aside from running the (pure) simulation.
+ */
+import type { Scenario } from '../conformance/types.ts';
+export interface SceneSnapshot {
+    force: string;
+    frames: number;
+    seed: number;
+    particleCount: number;
+    meanSpeed: number;
+    meanHeat: number;
+}
+/** Capture a deterministic snapshot of a scenario's final frame. */
+export declare function captureSnapshot(scenario: Scenario): SceneSnapshot;
+/** Compare two snapshots; returns a list of fields that differ beyond `tol` (empty = match). */
+export declare function compareSnapshot(a: SceneSnapshot, b: SceneSnapshot, tol?: number): string[];
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/inspect/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/inspect/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAGxD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAKD,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,aAAa,CAWjE;AAED,gGAAgG;AAChG,wBAAgB,eAAe,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,EAAE,GAAG,SAAO,GAAG,MAAM,EAAE,CAOxF"}

package/dist/inspect/snapshot.js

@@ -0,0 +1,30 @@
+import { runScenario } from "../conformance/run.js";
+const mean = (xs) => (xs.length ? xs.reduce((a, b) => a + b, 0) / xs.length : 0);
+const round = (n) => Math.round(n * 1e6) / 1e6;
+/** Capture a deterministic snapshot of a scenario's final frame. */
+export function captureSnapshot(scenario) {
+    const result = runScenario(scenario);
+    const last = result.trajectory[result.trajectory.length - 1] ?? [];
+    return {
+        force: scenario.force,
+        frames: scenario.frames,
+        seed: scenario.seed ?? 0,
+        particleCount: last.length,
+        meanSpeed: round(mean(last.map((p) => p.speed))),
+        meanHeat: round(mean(last.map((p) => p.heat))),
+    };
+}
+/** Compare two snapshots; returns a list of fields that differ beyond `tol` (empty = match). */
+export function compareSnapshot(a, b, tol = 1e-6) {
+    const diffs = [];
+    if (a.force !== b.force)
+        diffs.push(`force: ${a.force} → ${b.force}`);
+    if (a.particleCount !== b.particleCount)
+        diffs.push(`particleCount: ${a.particleCount} → ${b.particleCount}`);
+    if (Math.abs(a.meanSpeed - b.meanSpeed) > tol)
+        diffs.push(`meanSpeed: ${a.meanSpeed} → ${b.meanSpeed}`);
+    if (Math.abs(a.meanHeat - b.meanHeat) > tol)
+        diffs.push(`meanHeat: ${a.meanHeat} → ${b.meanHeat}`);
+    return diffs;
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/inspect/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/inspect/snapshot.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAWpD,MAAM,IAAI,GAAG,CAAC,EAAY,EAAU,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACnG,MAAM,KAAK,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AAE/D,oEAAoE;AACpE,MAAM,UAAU,eAAe,CAAC,QAAkB;IAChD,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACnE,OAAO;QACL,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC;QACxB,aAAa,EAAE,IAAI,CAAC,MAAM;QAC1B,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QAChD,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;KAC/C,CAAC;AACJ,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,eAAe,CAAC,CAAgB,EAAE,CAAgB,EAAE,GAAG,GAAG,IAAI;IAC5E,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IACtE,IAAI,CAAC,CAAC,aAAa,KAAK,CAAC,CAAC,aAAa;QAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,aAAa,MAAM,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC;IAC9G,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,GAAG;QAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;IACxG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,GAAG;QAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,QAAQ,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;IACnG,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/recipes/catalog.d.ts

@@ -0,0 +1,51 @@
+/**
+ * The field-recipe catalog (authoring-and-recipes §7) — the data file for the 64 portable
+ * `FieldRecipe`s that map the four-field translation model onto practical interface patterns, grouped
+ * into four tiers (`RECIPE_TIERS`). Each doubles as a worked example and a conformance fixture: every
+ * runtime token is a real passported force, every render layer + diagnostic is a known mode, the
+ * declared primitives match the body tokens, and no primitive is a diagnostic/metric/concept/condition
+ * — so `validateRecipe` passes for all of them (the conformance test enforces this).
+ *
+ * Lanes are kept separate: `primitives` are strict runtime tokens; `concepts`/`conditions` (layered in
+ * by id below) are product language and activation logic; `metrics`/`diagnostics` are measured state
+ * and inspection modes. These are classification + authoring artifacts — they compose existing
+ * primitives and add NO new engine behavior. Eight ids are the recommended first-release set.
+ */
+import type { FieldRecipe, RecipeTier } from './schema.ts';
+export declare const PRIORITY_WELL: FieldRecipe;
+export declare const FOCUS_ORBIT: FieldRecipe;
+export declare const SEARCH_RELEVANCE_FIELD: FieldRecipe;
+export declare const SIGNAL_PATH: FieldRecipe;
+export declare const EVIDENCE_FIELD: FieldRecipe;
+export declare const CONFLICT_FIELD: FieldRecipe;
+export declare const RELATIONSHIP_BOND: FieldRecipe;
+export declare const CONCEPT_CLUSTER: FieldRecipe;
+export declare const COHERENCE_FIELD: FieldRecipe;
+export declare const READING_FIELD: FieldRecipe;
+export declare const MEMORY_TRACE: FieldRecipe;
+export declare const DECAY_NOTICE: FieldRecipe;
+export declare const PHASE_SHIFT: FieldRecipe;
+export declare const GUIDED_FLOW: FieldRecipe;
+export declare const DIAGNOSTIC_LENS: FieldRecipe;
+export declare const ACCESSIBILITY_EQUIVALENCE: FieldRecipe;
+export interface RecipeTierGroup {
+    key: RecipeTier;
+    label: string;
+    recipes: readonly FieldRecipe[];
+}
+/** The four catalog tiers, in order — the navigable structure over {@link FIELD_RECIPES}. */
+export declare const RECIPE_TIERS: readonly RecipeTierGroup[];
+/** The full field-recipe catalog (authoring §7) — 64 recipes across four tiers, in catalog order. */
+export declare const FIELD_RECIPES: readonly FieldRecipe[];
+/** @deprecated renamed to {@link FIELD_RECIPES}. */
+export declare const ESSENTIAL_RECIPES: readonly FieldRecipe[];
+/**
+ * The recommended first-release set: eight recipes that explain the system quickly and span the four
+ * fields. The full sixteen give the project its range; these eight are the front door.
+ */
+export declare const FIRST_RELEASE_RECIPE_IDS: readonly string[];
+/** The first-release recipes, resolved from {@link FIRST_RELEASE_RECIPE_IDS} in declared order. */
+export declare const FIRST_RELEASE_RECIPES: readonly FieldRecipe[];
+/** Look up a recipe by id — the canonical 64 first, then the experimental set (undefined if unknown). */
+export declare function recipeById(id: string): FieldRecipe | undefined;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/recipes/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/recipes/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAK3D,eAAO,MAAM,aAAa,EAAE,WAkB3B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,WAmBzB,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,WAmBpC,CAAC;AAIF,eAAO,MAAM,WAAW,EAAE,WAmBzB,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,WAqB5B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,WAoB5B,CAAC;AAIF,eAAO,MAAM,iBAAiB,EAAE,WAoB/B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,WAoB7B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,WAoB7B,CAAC;AAIF,eAAO,MAAM,aAAa,EAAE,WAoB3B,CAAC;AAIF,eAAO,MAAM,YAAY,EAAE,WAkB1B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,WAmB1B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,WAkBzB,CAAC;AAIF,eAAO,MAAM,WAAW,EAAE,WAoBzB,CAAC;AAIF,eAAO,MAAM,eAAe,EAAE,WAc7B,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,WAcvC,CAAC;AAgoCF,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,UAAU,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;CACjC;AAED,6FAA6F;AAC7F,eAAO,MAAM,YAAY,EAAE,SAAS,eAAe,EAKlD,CAAC;AAEF,qGAAqG;AACrG,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAA2C,CAAC;AAE5F,oDAAoD;AACpD,eAAO,MAAM,iBAAiB,EAAE,SAAS,WAAW,EAAkB,CAAC;AAEvE;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,MAAM,EASrD,CAAC;AAEF,mGAAmG;AACnG,eAAO,MAAM,qBAAqB,EAAE,SAAS,WAAW,EAEvD,CAAC;AAEF,yGAAyG;AACzG,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE9D"}