@event4u/agent-config 16.4.0 → 16.5.0

package/dist/cli/commands/uiRenderAssetTypes.js

@@ -0,0 +1,145 @@
+/**
+ * uiRenderAssetTypes — the asset profile's declared vocabulary.
+ *
+ * Its own module so that the profile and its geometry comparison can both read
+ * these without importing each other: the profile calls the comparison, the
+ * comparison needs the classes and the tolerance shape, and a direct import
+ * either way round is a cycle.
+ *
+ * Every constant here was pre-registered in step 0.3 of
+ * `road-to-svg-with-a-witness` — before any checker existed — so a threshold
+ * could not be chosen to fit what a rule already reported.
+ */
+import * as path from 'node:path';
+// ---------------------------------------------------------------------------
+// Declared constants — every one of them pre-registered in step 0.3
+// ---------------------------------------------------------------------------
+export const ASSET_CLASSES = ['icon', 'mark', 'illustration', 'diagram', 'animated'];
+/**
+ * Per class, never global. A file is loose BELOW its class threshold.
+ * Overridden by a `fill_ratio_thresholds` block in `--thresholds <file>`.
+ */
+export const DEFAULT_FILL_RATIO_THRESHOLDS = {
+    icon: 0.3,
+    mark: 0.45,
+    illustration: 0.4,
+    diagram: 0.35,
+    animated: 0.35,
+};
+/** Step 2.6's tolerances. Overridden by `geometry_tolerances` in `--thresholds`. */
+export const DEFAULT_GEOMETRY_TOLERANCES = {
+    icon: { silhouette_iou_min: 0.98, max_boundary_distance_units: 1 },
+    mark: { silhouette_iou_min: 0.98, max_boundary_distance_units: 2 },
+    illustration: { silhouette_iou_min: 0.96, max_boundary_distance_units: 3 },
+    diagram: { silhouette_iou_min: 0.97, max_boundary_distance_units: 2 },
+    animated: { silhouette_iou_min: 0.97, max_boundary_distance_units: 2 },
+};
+/**
+ * Used ONLY when no `tokens.json` resolves. The manifest records
+ * `source: "fallback"` whenever these are used, because a reader cannot
+ * otherwise tell a project's own background from this module's guess.
+ */
+export const FALLBACK_BACKGROUNDS = { light: '#ffffff', dark: '#111111' };
+/** The four paths the brand resolver searches, in its order. First hit wins. */
+export const BRAND_TOKEN_PATHS = [
+    'tokens.json',
+    'assets/tokens.json',
+    'resources/tokens.json',
+    path.join('agents', 'settings', 'brand', 'tokens.json'),
+];
+/** Icon sizes are the three the incumbent sets ship at. Other classes: 1x and 2x. */
+export const ICON_SIZES = [16, 24, 48];
+/**
+ * A `mark` is captured here too — step 4.3 of
+ * `road-to-svg-from-a-live-session`.
+ *
+ * A review sent an accepted mark back because its face turned to mush at
+ * 32 px, and a simplified small-size variant was built. Nothing in the profile
+ * produced a capture at those sizes, so the only way to know was to look at
+ * something that did not exist. 16 and 32 are the two the review named.
+ */
+export const MARK_SMALL_SIZES = [16, 32];
+/**
+ * Below this, a draw-on animation is not reported. The planted row reads
+ * 0.283 (a 300-unit dash on a 215-unit path) and its twin reads 0.0, so the
+ * band between them is wide; 0.05 is inside it with room on both sides.
+ */
+export const DRAW_ON_DEAD_TIME_THRESHOLD = 0.05;
+/** A channel at or above this, with alpha 1, counts as near-white paint. */
+export const NEAR_WHITE_CHANNEL = 237;
+/**
+ * The synthetic host document. Fulfilled by the route handler at a URL inside
+ * the asset's OWN directory, so a relative `href` inside the asset resolves
+ * exactly as it would in place — without this module ever writing into the
+ * directory it is reading.
+ */
+export const HOST_BASENAME = '__agent-config-asset-host__.html';
+/** Schemes a page may reach. Everything else is aborted and counted. */
+export const ALLOWED_SCHEMES = ['file:', 'data:', 'blob:', 'about:'];
+/**
+ * How a shape declares that a gap in the silhouette is DELIBERATE.
+ *
+ * Step 4.1. A ring has a hole in the middle and the ground shows through it on
+ * purpose; without a way to say so, every ring reads as a seam. By attribute
+ * rather than by geometry, because "is this gap intended" is a question only
+ * the author can answer.
+ */
+export const HOLE_ATTRIBUTE = 'data-hole';
+/**
+ * The bleed share above which `geometry/background-bleed-inside-silhouette`
+ * fires, pre-registered in `fixtures/svg-assets/README.md` before the reading
+ * was written.
+ *
+ * A seam is a hairline: one or two pixels wide along a shared edge. The
+ * overlap twin — the same two shapes overlapping by one unit — reads 0. The
+ * threshold sits between them with room on both sides.
+ *
+ * IT DOES MOVE WITH THE RENDER SIZE, and this doc used to claim it does not.
+ * Finding 7 of the third completion review. A share is scale-free only when
+ * both terms scale together: a seam whose width is a fraction of a USER UNIT
+ * grows with the capture and its share is stable, but one that is an
+ * anti-aliasing artefact stays one or two DEVICE pixels wide at every size, so
+ * its count grows with the perimeter while the denominator grows with the
+ * area — the share falls roughly as 1/width. The planted fixture is the second
+ * kind (a ring of inner radius 20 against a disc of radius 20), so this number
+ * is pre-registered against the capture sizes THIS PROFILE TAKES, which top
+ * out at 2x the intrinsic width. A caller rendering the same file at several
+ * thousand pixels would read a share below the threshold on a file that still
+ * has the seam.
+ *
+ * Not re-derived here: fixing it means making the reading a function of the
+ * seam's width in user units rather than of its pixel count, which is a
+ * different measurement and a larger change than a remediation should take.
+ * Stated so a reader is not told the opposite.
+ */
+export const BLEED_SHARE_THRESHOLD = 0.002;
+/**
+ * Above this share of the registered source's painted pixels lying OUTSIDE the
+ * subject, `geometry/foreign-content-in-frame` fires.
+ *
+ * Finding 14 of this change's completion review: it was an inline `0.02` beside
+ * two named, documented, pre-registered thresholds. 2 % is the band an
+ * anti-aliased outline can occupy on a small mark without anything foreign
+ * being in the frame — it is a NOISE FLOOR, not a measured quality line, and
+ * saying so is the difference between a number a reader can argue with and one
+ * they cannot find.
+ */
+export const FOREIGN_CONTENT_SHARE_THRESHOLD = 0.02;
+/** Below this contrast ratio against its ground, a painted pixel is hard to see. */
+export const MIN_CONTRAST_RATIO = 3;
+/**
+ * The share of painted pixels below {@link MIN_CONTRAST_RATIO} above which
+ * `accessibility/low-contrast-on-background` fires.
+ *
+ * Half the mark, not a few anti-aliased edge pixels: an edge blends into its
+ * ground by construction, and a rule that fired on that would fire on every
+ * file. Pre-registered with the bleed threshold above.
+ */
+export const LOW_CONTRAST_SHARE_THRESHOLD = 0.5;
+/**
+ * The square sample grid both the profile and the comparison rasterise into.
+ * One constant because a comparison taken at a different resolution than the
+ * reading it is compared against is not a comparison.
+ */
+export const SAMPLE_RES = 256;
+//# sourceMappingURL=uiRenderAssetTypes.js.map

package/dist/cli/main.js

@@ -23,6 +23,7 @@ import { runDoctorShell } from './commands/doctorShell.js';
 import { runRtkDetect } from './commands/rtkDetect.js';
 import { runUiAudit } from './commands/uiAudit.js';
 import { runUiRender } from './commands/uiRender.js';
+import { parseRegistration } from './commands/uiRenderAssetCompare.js';
 import { runUiServe } from './commands/uiServe.js';
 import { shouldInitLaunchGui, buildInitGuiOptions, buildProjectInitDelegation, findInitGuiConflict, withoutGuiFlag } from './initRouting.js';
 import { maybePrintFirstRunNotice } from './firstRunNotice.js';
@@ -125,8 +126,53 @@ async function main(rawArgv) {
         .option('--json', 'Print the manifest on stdout as well as writing it')
         .option('--project-root <path>', 'Override the project root')
         .option('--slug <name>', 'Override the output directory name')
+        .option('--profile <name>', 'page (default) or asset — a single SVG, per class, light and dark')
+        .option('--class <name>', 'Asset class: icon | mark | illustration | diagram | animated')
+        .option('--delivery <mode>', 'Delivery mode: inline | document | img | css-bg')
+        .option('--thresholds <file>', 'JSON carrying fill_ratio_thresholds / geometry_tolerances')
+        .option('--icon-set <paths>', 'Comma-separated incumbent icon SVGs, read for their own grid')
+        .option('--compare <file>', 'Second render of the same frame to compare against')
+        .option('--registration <spec>', 'Raster source region as x,y,w,h[@scale]')
         .action(async (target, opts) => {
-        process.exitCode = await runUiRender({ target, ...opts });
+        // Validated, not cast. A cast let `--class Icon` through as an
+        // AssetClass that matches no threshold key, so
+        // `fill_ratio_threshold` came out `undefined`,
+        // `structure/loose-viewbox` could never fire, and the key
+        // vanished from the manifest — a silent downgrade of a reading
+        // to nothing. `lint_svg_asset` validates the same two
+        // vocabularies and exits 1; so does this.
+        const ASSET_CLASS_NAMES = ['icon', 'mark', 'illustration', 'diagram', 'animated'];
+        const DELIVERY_NAMES = ['inline', 'document', 'img', 'css-bg'];
+        if (opts.class !== undefined && !ASSET_CLASS_NAMES.includes(opts.class)) {
+            process.stderr.write(`[ui:render] unknown --class "${opts.class}"; expected one of ${ASSET_CLASS_NAMES.join(', ')}\n`);
+            process.exitCode = 1;
+            return;
+        }
+        if (opts.delivery !== undefined && !DELIVERY_NAMES.includes(opts.delivery)) {
+            process.stderr.write(`[ui:render] unknown --delivery "${opts.delivery}"; expected one of ${DELIVERY_NAMES.join(', ')}\n`);
+            process.exitCode = 1;
+            return;
+        }
+        if (opts.profile !== undefined && opts.profile !== 'page' && opts.profile !== 'asset') {
+            process.stderr.write(`[ui:render] unknown --profile "${opts.profile}"; expected page or asset\n`);
+            process.exitCode = 1;
+            return;
+        }
+        process.exitCode = await runUiRender({
+            target,
+            ...(opts.json === undefined ? {} : { json: opts.json }),
+            ...(opts.projectRoot === undefined ? {} : { projectRoot: opts.projectRoot }),
+            ...(opts.slug === undefined ? {} : { slug: opts.slug }),
+            ...(opts.profile === 'asset' ? { profile: 'asset' } : {}),
+            ...(opts.class === undefined ? {} : { assetClass: opts.class }),
+            ...(opts.delivery === undefined ? {} : { delivery: opts.delivery }),
+            ...(opts.thresholds === undefined ? {} : { thresholds: opts.thresholds }),
+            ...(opts.iconSet === undefined ? {} : { iconSet: opts.iconSet.split(',').map((s) => s.trim()) }),
+            ...(opts.compare === undefined ? {} : { compareTo: opts.compare }),
+            ...(parseRegistration(opts.registration) === null
+                ? {}
+                : { registration: parseRegistration(opts.registration) }),
+        });
     });
     program
         .command('ui:serve')

package/dist/cli/registry.js

@@ -37,7 +37,7 @@ export const REGISTRY = [
     { name: 'rtk:detect', disposition: 'native', synopsis: 'rtk (Rust Token Killer) presence + identity readout — contract: docs/contracts/rtk-detection.md.' },
     { name: 'ui:serve', disposition: 'native', synopsis: 'Start the local UI server.' },
     { name: 'ui:audit', disposition: 'native', synopsis: 'Inventory a UI tree into agents/runtime/state/ui-audit.json (Class A; the artefact ui-audit-gate reads).' },
-    { name: 'ui:render', disposition: 'native', synopsis: 'Headless capture at desktop / 375px / 320px into agents/runtime/state/render/ (Class A; no process survives).' },
+    { name: 'ui:render', disposition: 'native', synopsis: 'Headless capture at desktop / 375px / 320px, or --profile asset for one SVG per class on a light and a dark background, into agents/runtime/state/render/ (Class A; no process survives).' },
     { name: 'config', disposition: 'native', synopsis: 'Open the configuration GUI (global by default; --project for the project surface).' },
     { name: 'settings', disposition: 'native', synopsis: 'Open the local Settings GUI (alias of config).' },
     { name: 'install', disposition: 'native', synopsis: 'Open the install wizard (UI server, lands on Step 1 / AI tools).' },

package/dist/cli-delegate/{chunk-MSUL5NYP.js → chunk-4DBG5K7M.js}

@@ -3,7 +3,7 @@ import {
   pruneAgedRefusalState,
   readSessionCounts,
   statePathFor
-} from "./chunk-AED2VQGM.js";
+} from "./chunk-TMWYUOK4.js";
 import {
   current_branch,
   git_common_dir,

package/dist/cli-delegate/{chunk-AED2VQGM.js → chunk-TMWYUOK4.js}

@@ -562,6 +562,8 @@ function segmentVerifies(rawWords) {
     case "node":
     case "deno":
       return rest.some((a) => a === "test" || a.startsWith("--test"));
+    case "agent-config":
+      return false;
     case "scripts-run": {
       const script = bareName(arg1);
       return /^(check|lint|verify|validate)[-_]/.test(script);
@@ -579,6 +581,12 @@ var _WIDE_CANDIDATE_RE = /\b(test|tests|vitest|jest|pytest|phpunit|pest|tsc|esli
 function mightBeVerification(command) {
   return _WIDE_CANDIDATE_RE.test(command);
 }
+function isAssetRenderCommand(command) {
+  return /\bui:render\b/.test(command) && /--profile[= ]\s*asset\b/.test(command);
+}
+function isVerificationAttempt(command) {
+  return isVerificationCommand(command) || isAssetRenderCommand(command);
+}
 
 // src/scripts/_lib/touched_file_quality.ts
 import { spawnSync } from "node:child_process";
@@ -2753,7 +2761,8 @@ function pruneAgedRefusalState(workspaceRoot, opts = {}) {
 }
 
 export {
-  isVerificationCommand,
+  isAssetRenderCommand,
+  isVerificationAttempt,
   readRunEvidence,
   hasRedThenGreen,
   describeRecordFinding,