@shrkcrft/inspector 0.1.0-alpha.30 → 0.1.0-alpha.31

package/dist/area-map.d.ts

@@ -1,16 +1,10 @@
+import { AreaKind } from '@shrkcrft/core';
+import type { ISharkCraftConfig } from '@shrkcrft/config';
 import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
+export { AreaKind };
 export declare const AREA_MAP_SCHEMA = "sharkcraft.area-map/v1";
-export declare enum AreaKind {
-    Core = "core",
-    Ui = "ui",
-    App = "app",
-    Api = "api",
-    Tests = "tests",
-    Docs = "docs",
-    Infra = "infra",
-    Generated = "generated",
-    Unknown = "unknown"
-}
+/** Below this share of classified files the map reports itself `degraded` (config: `areaMap.minClassificationRate`). */
+export declare const DEFAULT_MIN_CLASSIFICATION_RATE = 0.5;
 export interface IAreaMapEntry {
     id: string;
     kind: AreaKind;
@@ -31,8 +25,59 @@ export interface IAreaMap {
     projectRoot: string;
     areas: readonly IAreaMapEntry[];
     unclassifiedFiles: number;
+    /** Files the map walked. `classifiedFiles + unclassifiedFiles === totalFiles`. */
+    totalFiles: number;
+    classifiedFiles: number;
+    /** `classifiedFiles / totalFiles` (0..1; 0 when nothing was walked). */
+    classificationRate: number;
+    /** The rate `degraded` is judged against. */
+    minClassificationRate: number;
+    /**
+     * True when fewer files classified than `minClassificationRate`. Every view
+     * derived from the map (impact, review packets, the report site) inherits
+     * the blind spot, so it reports this instead of silently understating.
+     */
+    degraded: boolean;
+    /** The first unclassified paths, sorted — what `areaMap.patterns` should cover. */
+    unclassifiedSample: readonly string[];
+    /** Which pattern tables classified: the built-in layout table, project config, or both. */
+    patternSource: 'built-in' | 'config' | 'config+built-in';
+}
+/** How one file classified, and which table decided. */
+export interface IAreaClassification {
+    readonly kind: AreaKind;
+    /** The project pattern's `id`, when a config pattern with one matched. */
+    readonly id?: string;
+    readonly source: 'config' | 'built-in' | 'none';
 }
+type AreaMapConfig = NonNullable<ISharkCraftConfig['areaMap']>;
+/**
+ * THE file → area classifier. The area map, impact's target attribution and
+ * the changes summary's project-declared areas all go through it, so a
+ * project pattern means the same thing everywhere.
+ *
+ * Project patterns (`areaMap.patterns`) run FIRST, in declared order; then the
+ * built-in layout table, unless `replaceDefaults` (or `builtIns: false`, for a
+ * caller that only wants the project's own taxonomy).
+ */
+export declare function createAreaClassifier(config?: AreaMapConfig | null, options?: {
+    readonly builtIns?: boolean;
+}): (file: string) => IAreaClassification;
+/**
+ * THE area id of a classified file: `<kind>:<pattern id | package or top segment>`.
+ *
+ * `buildAreaMap` keys its entries with it, and every view asking "which area
+ * is this file in" (impact's affected areas, `core-area`, boundary risks)
+ * classifies the file and looks this id up. A prefix match on an entry's
+ * `paths` cannot answer it: `paths` holds only the top segment, so a config
+ * pattern for `libs/<group>/core/**` made EVERY `libs/…` file look core.
+ */
+export declare function areaIdOf(classification: IAreaClassification, file: string): string;
 export declare function buildAreaMap(inspection: ISharkcraftInspection): IAreaMap;
+/** `12.5%` — one formatting of a classification rate for every renderer. */
+export declare function formatClassificationRate(rate: number): string;
+/** The loud line a degraded map earns — one wording across text, markdown and HTML. */
+export declare function areaMapDegradedLine(map: IAreaMap): string | undefined;
 export declare function renderAreaMapText(map: IAreaMap): string;
 export declare function renderAreaMapMarkdown(map: IAreaMap): string;
 //# sourceMappingURL=area-map.d.ts.map

package/dist/area-map.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"area-map.d.ts","sourceRoot":"","sources":["../src/area-map.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,eAAe,2BAA2B,CAAC;AAExD,oBAAY,QAAQ;IAClB,IAAI,SAAS;IACb,EAAE,OAAO;IACT,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,KAAK,UAAU;IACf,IAAI,SAAS;IACb,KAAK,UAAU;IACf,SAAS,cAAc;IACvB,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,OAAO,eAAe,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAChC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAoED,wBAAgB,YAAY,CAAC,UAAU,EAAE,qBAAqB,GAAG,QAAQ,CA4ExE;AA0BD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CASvD;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAc3D"}
+{"version":3,"file":"area-map.d.ts","sourceRoot":"","sources":["../src/area-map.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAIvE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAEpB,eAAO,MAAM,eAAe,2BAA2B,CAAC;AAExD,wHAAwH;AACxH,eAAO,MAAM,+BAA+B,MAAM,CAAC;AAKnD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,OAAO,eAAe,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,6CAA6C;IAC7C,qBAAqB,EAAE,MAAM,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB,mFAAmF;IACnF,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,2FAA2F;IAC3F,aAAa,EAAE,UAAU,GAAG,QAAQ,GAAG,iBAAiB,CAAC;CAC1D;AAED,wDAAwD;AACxD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;CACjD;AAED,KAAK,aAAa,GAAG,WAAW,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC;AAsD/D;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI,EAC7B,OAAO,GAAE;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GAC5C,CAAC,IAAI,EAAE,MAAM,KAAK,mBAAmB,CAoBvC;AASD;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,cAAc,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAElF;AAOD,wBAAgB,YAAY,CAAC,UAAU,EAAE,qBAAqB,GAAG,QAAQ,CA0FxE;AA0BD,4EAA4E;AAC5E,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAMrE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAmBvD;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CA0B3D"}

package/dist/area-map.js

@@ -1,18 +1,15 @@
 import { existsSync, readdirSync, statSync } from 'node:fs';
 import * as nodePath from 'node:path';
+import { AreaKind } from '@shrkcrft/core';
+import { globToRegex } from '@shrkcrft/boundaries';
+// The enum moved to core (so the config schema can validate a pattern's kind
+// against it); re-exported here so every existing import keeps working.
+export { AreaKind };
 export const AREA_MAP_SCHEMA = 'sharkcraft.area-map/v1';
-export var AreaKind;
-(function (AreaKind) {
-    AreaKind["Core"] = "core";
-    AreaKind["Ui"] = "ui";
-    AreaKind["App"] = "app";
-    AreaKind["Api"] = "api";
-    AreaKind["Tests"] = "tests";
-    AreaKind["Docs"] = "docs";
-    AreaKind["Infra"] = "infra";
-    AreaKind["Generated"] = "generated";
-    AreaKind["Unknown"] = "unknown";
-})(AreaKind || (AreaKind = {}));
+/** Below this share of classified files the map reports itself `degraded` (config: `areaMap.minClassificationRate`). */
+export const DEFAULT_MIN_CLASSIFICATION_RATE = 0.5;
+/** Unclassified paths named in the map — actionable, not a count alone. */
+const UNCLASSIFIED_SAMPLE = 20;
 const AREA_PATTERNS = [
     { kind: AreaKind.Core, match: [/^packages\/core(\/|$)/, /^src\/core(\/|$)/], idHint: 'core' },
     { kind: AreaKind.Ui, match: [/^packages\/(ui|dashboard|web)(\/|$)/, /^(src|app)\/(ui|components|pages|views)(\/|$)/], idHint: 'ui' },
@@ -67,12 +64,36 @@ function walk(root, base = '') {
     }
     return out;
 }
-function classify(file) {
-    for (const p of AREA_PATTERNS) {
-        if (p.match.some((re) => re.test(file)))
-            return p.kind;
-    }
-    return AreaKind.Unknown;
+/**
+ * THE file → area classifier. The area map, impact's target attribution and
+ * the changes summary's project-declared areas all go through it, so a
+ * project pattern means the same thing everywhere.
+ *
+ * Project patterns (`areaMap.patterns`) run FIRST, in declared order; then the
+ * built-in layout table, unless `replaceDefaults` (or `builtIns: false`, for a
+ * caller that only wants the project's own taxonomy).
+ */
+export function createAreaClassifier(config, options = {}) {
+    const project = (config?.patterns ?? []).map((p) => ({
+        kind: p.kind,
+        ...(p.id ? { id: p.id } : {}),
+        matchers: p.match.map((g) => globToRegex(g)),
+    }));
+    const useBuiltIns = options.builtIns !== false && config?.replaceDefaults !== true;
+    return (file) => {
+        for (const p of project) {
+            if (p.matchers.some((re) => re.test(file))) {
+                return { kind: p.kind, ...(p.id ? { id: p.id } : {}), source: 'config' };
+            }
+        }
+        if (useBuiltIns) {
+            for (const p of AREA_PATTERNS) {
+                if (p.match.some((re) => re.test(file)))
+                    return { kind: p.kind, source: 'built-in' };
+            }
+        }
+        return { kind: AreaKind.Unknown, source: 'none' };
+    };
 }
 function packageOrTopSegment(file) {
     const segs = file.split('/');
@@ -82,20 +103,39 @@ function packageOrTopSegment(file) {
         return `apps/${segs[1]}`;
     return segs[0] ?? '';
 }
+/**
+ * THE area id of a classified file: `<kind>:<pattern id | package or top segment>`.
+ *
+ * `buildAreaMap` keys its entries with it, and every view asking "which area
+ * is this file in" (impact's affected areas, `core-area`, boundary risks)
+ * classifies the file and looks this id up. A prefix match on an entry's
+ * `paths` cannot answer it: `paths` holds only the top segment, so a config
+ * pattern for `libs/<group>/core/**` made EVERY `libs/…` file look core.
+ */
+export function areaIdOf(classification, file) {
+    return `${classification.kind}:${classification.id ?? packageOrTopSegment(file)}`;
+}
+function patternSourceOf(config) {
+    if ((config?.patterns?.length ?? 0) === 0)
+        return config?.replaceDefaults === true ? 'config' : 'built-in';
+    return config?.replaceDefaults === true ? 'config' : 'config+built-in';
+}
 export function buildAreaMap(inspection) {
     const root = inspection.projectRoot;
+    const config = inspection.config?.areaMap;
+    const classify = createAreaClassifier(config);
     const allFiles = existsSync(root) ? walk(root) : [];
     const byKey = new Map();
-    let unclassified = 0;
+    const unclassifiedPaths = [];
     for (const f of allFiles) {
-        const kind = classify(f);
-        if (kind === AreaKind.Unknown)
-            unclassified += 1;
+        const c = classify(f);
+        if (c.kind === AreaKind.Unknown)
+            unclassifiedPaths.push(f);
         const seg = packageOrTopSegment(f);
-        const key = `${kind}:${seg}`;
+        const key = areaIdOf(c, f);
         let entry = byKey.get(key);
         if (!entry) {
-            entry = { kind, paths: new Set(), fileCount: 0 };
+            entry = { kind: c.kind, paths: new Set(), fileCount: 0 };
             byKey.set(key, entry);
         }
         entry.paths.add(seg);
@@ -134,11 +174,23 @@ export function buildAreaMap(inspection) {
         });
     }
     areas.sort((a, b) => b.fileCount - a.fileCount);
+    const totalFiles = allFiles.length;
+    const unclassifiedFiles = unclassifiedPaths.length;
+    const classifiedFiles = totalFiles - unclassifiedFiles;
+    const classificationRate = totalFiles === 0 ? 0 : Math.round((classifiedFiles / totalFiles) * 10_000) / 10_000;
+    const minClassificationRate = config?.minClassificationRate ?? DEFAULT_MIN_CLASSIFICATION_RATE;
     return {
         schema: AREA_MAP_SCHEMA,
         projectRoot: root,
         areas,
-        unclassifiedFiles: unclassified,
+        unclassifiedFiles,
+        totalFiles,
+        classifiedFiles,
+        classificationRate,
+        minClassificationRate,
+        degraded: totalFiles > 0 && classificationRate < minClassificationRate,
+        unclassifiedSample: [...unclassifiedPaths].sort().slice(0, UNCLASSIFIED_SAMPLE),
+        patternSource: patternSourceOf(config),
     };
 }
 function stripGlob(s) {
@@ -164,9 +216,28 @@ function computeRiskScore(input) {
         score -= 10;
     return Math.max(0, Math.min(100, 30 + score));
 }
+/** `12.5%` — one formatting of a classification rate for every renderer. */
+export function formatClassificationRate(rate) {
+    return `${(rate * 100).toFixed(1)}%`;
+}
+/** The loud line a degraded map earns — one wording across text, markdown and HTML. */
+export function areaMapDegradedLine(map) {
+    if (!map.degraded)
+        return undefined;
+    return (`area attribution degraded — ${formatClassificationRate(map.classificationRate)} of files classified ` +
+        `(below ${formatClassificationRate(map.minClassificationRate)}); add areaMap.patterns to sharkcraft.config.ts`);
+}
 export function renderAreaMapText(map) {
     const lines = [];
     lines.push(`Area map (${map.areas.length} areas, ${map.unclassifiedFiles} unclassified files)`);
+    lines.push(`  classified ${map.classifiedFiles}/${map.totalFiles} (${formatClassificationRate(map.classificationRate)}) · patterns: ${map.patternSource}`);
+    const degraded = areaMapDegradedLine(map);
+    if (degraded) {
+        lines.push(`  ! ${degraded}`);
+        if (map.unclassifiedSample.length > 0) {
+            lines.push(`    unclassified (first ${map.unclassifiedSample.length}): ${map.unclassifiedSample.join(', ')}`);
+        }
+    }
     for (const a of map.areas.slice(0, 50)) {
         lines.push(`  ${a.kind.padEnd(10)} ${String(a.fileCount).padStart(5)} files  paths=${a.paths.join(', ')}  risk=${a.riskScore}`);
     }
@@ -178,6 +249,16 @@ export function renderAreaMapMarkdown(map) {
     lines.push('');
     lines.push(`Total areas: **${map.areas.length}** — unclassified files: ${map.unclassifiedFiles}.`);
     lines.push('');
+    lines.push(`Classified: **${map.classifiedFiles}/${map.totalFiles}** (${formatClassificationRate(map.classificationRate)}) · patterns: ${map.patternSource}.`);
+    const degraded = areaMapDegradedLine(map);
+    if (degraded) {
+        lines.push('');
+        lines.push(`> **Warning:** ${degraded}.`);
+        if (map.unclassifiedSample.length > 0) {
+            lines.push(`> Unclassified (first ${map.unclassifiedSample.length}): ${map.unclassifiedSample.map((p) => `\`${p}\``).join(', ')}`);
+        }
+    }
+    lines.push('');
     lines.push('| Kind | Files | Paths | Boundary rules | Risk |');
     lines.push('| --- | ---: | --- | ---: | ---: |');
     for (const a of map.areas) {

package/dist/asset-doctor-proposed-exit.d.ts

@@ -0,0 +1,21 @@
+import { type IUnitLiveness } from '@shrkcrft/core';
+import type { IAssetDoctorFlags } from './i-asset-doctor-flags.js';
+/**
+ * THE proposal of every asset doctor (round 13): `registrations doctor`,
+ * `scaffolds doctor`, `search tuning doctor`, `self-config doctor|report`, and
+ * MCP `get_scaffold_pattern_doctor` / `get_self_config_doctor` — so a CLI verb
+ * and its MCP twin cannot propose different exits over the same report.
+ *
+ * 1 on an error, on a warning under `--strict`, or on a selector unit THE
+ * `--fail-on-dead-units` predicate (`selectorUnitFails`) fails — an unmarked
+ * dead unit, or a stale LOCAL `expectEmpty` marker; a pack's stale marker is
+ * INFO and never fails the consumer, and an intended-empty unit never fails.
+ * Else 0. Settle the proposal against the doctor's coverage (`settleVerdict`):
+ * a Coverage-weight dead or unproven unit turns 0 into 2 whatever the flags.
+ */
+export declare function assetDoctorProposedExit(found: {
+    readonly errors: number;
+    readonly warnings: number;
+    readonly units: readonly Pick<IUnitLiveness, 'state' | 'mark'>[];
+}, flags: IAssetDoctorFlags): 0 | 1;
+//# sourceMappingURL=asset-doctor-proposed-exit.d.ts.map

package/dist/asset-doctor-proposed-exit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-doctor-proposed-exit.d.ts","sourceRoot":"","sources":["../src/asset-doctor-proposed-exit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE;IACL,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC;CAClE,EACD,KAAK,EAAE,iBAAiB,GACvB,CAAC,GAAG,CAAC,CAKP"}

package/dist/asset-doctor-proposed-exit.js

@@ -0,0 +1,22 @@
+import { selectorUnitFails } from '@shrkcrft/core';
+/**
+ * THE proposal of every asset doctor (round 13): `registrations doctor`,
+ * `scaffolds doctor`, `search tuning doctor`, `self-config doctor|report`, and
+ * MCP `get_scaffold_pattern_doctor` / `get_self_config_doctor` — so a CLI verb
+ * and its MCP twin cannot propose different exits over the same report.
+ *
+ * 1 on an error, on a warning under `--strict`, or on a selector unit THE
+ * `--fail-on-dead-units` predicate (`selectorUnitFails`) fails — an unmarked
+ * dead unit, or a stale LOCAL `expectEmpty` marker; a pack's stale marker is
+ * INFO and never fails the consumer, and an intended-empty unit never fails.
+ * Else 0. Settle the proposal against the doctor's coverage (`settleVerdict`):
+ * a Coverage-weight dead or unproven unit turns 0 into 2 whatever the flags.
+ */
+export function assetDoctorProposedExit(found, flags) {
+    if (found.errors > 0)
+        return 1;
+    if (flags.strict && found.warnings > 0)
+        return 1;
+    const unitFlags = { failOnDeadUnits: flags.failOnDeadUnits, strict: flags.strict, strictPromotesWarnings: false };
+    return found.units.some((u) => selectorUnitFails(u, unitFlags)) ? 1 : 0;
+}

package/dist/asset-provenance.js

@@ -187,7 +187,7 @@ export function renderProvenanceMarkdown(report) {
     lines.push(`Total entries: ${report.total}`);
     lines.push('');
     if (!report.ledgerExists) {
-        lines.push('> No provenance ledger yet. Run any `shrk knowledge author` / `shrk pack author` preview to start one.');
+        lines.push('> No provenance ledger yet. Run any `shrk knowledge add --write-preview` (or update / remove) or `shrk pack author preview --write-preview` to start one.');
         lines.push('');
         return lines.join('\n');
     }

package/dist/boundaries-changed-only.d.ts

@@ -43,12 +43,35 @@ export interface IChangedScopeFilterResult<TViolation extends IBoundaryLikeViola
     includedViolations: ReadonlyArray<TViolation>;
     ignoredLegacyCount: number;
     ignoredLegacyByRule: Readonly<Record<string, number>>;
+    /**
+     * Violations included because their RULE was escalated — its definition (or
+     * the config / alias map it is evaluated under) changed, so every violation
+     * it produces is new to this changeset, whatever file it sits in.
+     */
+    escalatedCount?: number;
+}
+/** Extra inputs to {@link filterViolationsToChangedScope}. */
+export interface IChangedScopeFilterOptions {
+    /**
+     * Rules whose violations are included regardless of their file (round 11,
+     * 6.3 / closing#d). A rule edit can create violations only in UNCHANGED
+     * files — the filter used to file every one of them as "legacy", so
+     * `--changed-only` and `finish` read green over the violation the edit just
+     * introduced. The caller computes the set with
+     * `resolveBoundaryRuleInvalidation`.
+     */
+    readonly escalatedRuleIds?: ReadonlySet<string> | readonly string[];
+    /** A changed-file set the caller already resolved — skips a second git call. */
+    readonly resolved?: {
+        readonly mode: ChangedScopeMode;
+        readonly files: readonly string[];
+    };
 }
 export declare function resolveChangedFiles(opts: IChangedScopeOptions): {
     mode: ChangedScopeMode;
     files: string[];
 };
-export declare function filterViolationsToChangedScope<TViolation extends IBoundaryLikeViolation>(violations: ReadonlyArray<TViolation>, opts: IChangedScopeOptions): IChangedScopeFilterResult<TViolation>;
+export declare function filterViolationsToChangedScope<TViolation extends IBoundaryLikeViolation>(violations: ReadonlyArray<TViolation>, opts: IChangedScopeOptions, filterOptions?: IChangedScopeFilterOptions): IChangedScopeFilterResult<TViolation>;
 export interface IChangedBoundaryReport {
     schema: 'sharkcraft.changed-boundary-report/v1';
     mode: ChangedScopeMode;

package/dist/boundaries-changed-only.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"boundaries-changed-only.d.ts","sourceRoot":"","sources":["../src/boundaries-changed-only.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,oBAAY,gBAAgB;IAC1B,WAAW,iBAAiB;IAC5B,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,KAAK,UAAU;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9B,gEAAgE;IAChE,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB,CAAC,UAAU,SAAS,sBAAsB;IAClF,IAAI,EAAE,gBAAgB,CAAC;IACvB,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACpC,kBAAkB,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAC9C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACvD;AAWD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,oBAAoB,GAAG;IAC/D,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAkBA;AAED,wBAAgB,8BAA8B,CAAC,UAAU,SAAS,sBAAsB,EACtF,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,EACrC,IAAI,EAAE,oBAAoB,GACzB,yBAAyB,CAAC,UAAU,CAAC,CAiCvC;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,uCAAuC,CAAC;IAChD,IAAI,EAAE,gBAAgB,CAAC;IACvB,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,aAAa,CAAC,sBAAsB,CAAC,CAAC;IAC1D,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACvD;AAED,wBAAgB,0BAA0B,CAAC,UAAU,SAAS,sBAAsB,EAClF,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,EACrC,IAAI,EAAE,oBAAoB,GACzB,sBAAsB,CAWxB"}
+{"version":3,"file":"boundaries-changed-only.d.ts","sourceRoot":"","sources":["../src/boundaries-changed-only.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,oBAAY,gBAAgB;IAC1B,WAAW,iBAAiB;IAC5B,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,KAAK,UAAU;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9B,gEAAgE;IAChE,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB,CAAC,UAAU,SAAS,sBAAsB;IAClF,IAAI,EAAE,gBAAgB,CAAC;IACvB,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACpC,kBAAkB,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAC9C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,8DAA8D;AAC9D,MAAM,WAAW,0BAA0B;IACzC;;;;;;;OAOG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,MAAM,EAAE,CAAC;IACpE,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;CAC5F;AAWD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,oBAAoB,GAAG;IAC/D,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAkBA;AAED,wBAAgB,8BAA8B,CAAC,UAAU,SAAS,sBAAsB,EACtF,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,EACrC,IAAI,EAAE,oBAAoB,EAC1B,aAAa,GAAE,0BAA+B,GAC7C,yBAAyB,CAAC,UAAU,CAAC,CA2CvC;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,uCAAuC,CAAC;IAChD,IAAI,EAAE,gBAAgB,CAAC;IACvB,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,aAAa,CAAC,sBAAsB,CAAC,CAAC;IAC1D,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACvD;AAED,wBAAgB,0BAA0B,CAAC,UAAU,SAAS,sBAAsB,EAClF,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,EACrC,IAAI,EAAE,oBAAoB,GACzB,sBAAsB,CAWxB"}

package/dist/boundaries-changed-only.js

@@ -50,12 +50,21 @@ export function resolveChangedFiles(opts) {
     const out = getChangedFiles(opts.projectRoot, { includeWorktree: true });
     return { mode: ChangedScopeMode.ChangedOnly, files: out };
 }
-export function filterViolationsToChangedScope(violations, opts) {
-    const { mode, files } = resolveChangedFiles(opts);
+export function filterViolationsToChangedScope(violations, opts, filterOptions = {}) {
+    const { mode, files } = filterOptions.resolved ?? resolveChangedFiles(opts);
     const changedSet = new Set(files.map((f) => f.split(/[\\/]/).join('/')));
+    const escalated = new Set(filterOptions.escalatedRuleIds ?? []);
     const included = [];
     const ignoredByRule = {};
+    let escalatedCount = 0;
     for (const v of violations) {
+        // A rule whose definition changed produced this violation in THIS
+        // changeset, whatever file it sits in — never "legacy".
+        if (escalated.has(v.ruleId)) {
+            included.push(v);
+            escalatedCount += 1;
+            continue;
+        }
         const candidate = v.file ?? v.fromFile ?? '';
         const norm = normalisePath(candidate, opts.projectRoot);
         if (changedSet.has(norm)) {
@@ -81,6 +90,7 @@ export function filterViolationsToChangedScope(violations, opts) {
         includedViolations: included,
         ignoredLegacyCount,
         ignoredLegacyByRule: ignoredByRule,
+        ...(escalated.size > 0 ? { escalatedCount } : {}),
     };
 }
 export function buildChangedBoundaryReport(violations, opts) {

package/dist/boundary-check-options.model.d.ts

@@ -0,0 +1,40 @@
+import type { IBoundaryRule, IImportScanResult } from '@shrkcrft/boundaries';
+import type { ChangedScopeMode, IChangedScopeOptions } from './boundaries-changed-only.js';
+import type { IBoundaryLoadIssue } from './boundary-load-issue.model.js';
+/** Inputs to `runBoundaryCheck` — every boundary surface passes the same ones. */
+export interface IRunBoundaryCheckOptions {
+    /** `--rule <id>`: evaluate only this rule. An unknown id is a usage error (exit 3). */
+    readonly onlyRuleId?: string;
+    /**
+     * `--rule-file <path>`: evaluate ONLY these rules (loaded by the CLI through
+     * the same loader `boundaryFiles` use). Never reachable from MCP — loading a
+     * rule file executes it.
+     */
+    readonly ruleFile?: {
+        readonly path: string;
+        readonly rules: readonly IBoundaryRule[];
+        readonly loadIssues?: readonly IBoundaryLoadIssue[];
+    };
+    /** Changed-scope mode: report violations the changeset introduced (plus escalated rules). */
+    readonly changedScope?: IChangedScopeOptions;
+    /** A changed-file set the caller already resolved (finish). Takes precedence over `changedScope` resolution. */
+    readonly changed?: {
+        readonly mode: ChangedScopeMode;
+        readonly files: readonly string[];
+    };
+    /** Read imports from raw text, comments included (`--include-comments`). */
+    readonly includeComments?: boolean;
+    /**
+     * Escalate rules whose definition the changeset touched (default `true`).
+     * `false` (`--no-rule-escalation`) keeps them out — and the run then reports
+     * those rules UNEXAMINED, so it can never read as a pass.
+     */
+    readonly escalate?: boolean;
+    /** `--fail-on-dead-units`: a dead selector unit fails the run (1). */
+    readonly failOnDeadUnits?: boolean;
+    /** `--strict`: warning-severity violations fail too. */
+    readonly strict?: boolean;
+    /** Reuse an existing scan (the rule-set diff scans once for both sides). */
+    readonly scan?: IImportScanResult;
+}
+//# sourceMappingURL=boundary-check-options.model.d.ts.map

package/dist/boundary-check-options.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundary-check-options.model.d.ts","sourceRoot":"","sources":["../src/boundary-check-options.model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAC3F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEzE,kFAAkF;AAClF,MAAM,WAAW,wBAAwB;IACvC,uFAAuF;IACvF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;QACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;KACrD,CAAC;IACF,6FAA6F;IAC7F,QAAQ,CAAC,YAAY,CAAC,EAAE,oBAAoB,CAAC;IAC7C,gHAAgH;IAChH,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;IAC1F,4EAA4E;IAC5E,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,wDAAwD;IACxD,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,CAAC,EAAE,iBAAiB,CAAC;CACnC"}

package/dist/boundary-check-options.model.js

@@ -0,0 +1 @@
+export {};

package/dist/boundary-check-result.model.d.ts

@@ -0,0 +1,89 @@
+import type { IVerdictCoverage } from '@shrkcrft/core';
+import type { IBoundaryDeadUnit, IBoundaryUnitFinding, IBoundarySuppressedViolation, IBoundaryViolation, IEvaluateResult, IImportScanResult } from '@shrkcrft/boundaries';
+import type { ChangedScopeMode } from './boundaries-changed-only.js';
+import type { IBoundaryConfigurationStatus } from './boundary-configuration-status.model.js';
+import type { IBoundaryLoadIssue } from './boundary-load-issue.model.js';
+import type { IBoundaryRuleCheck } from './boundary-rule-check.model.js';
+import type { IBoundaryRuleInvalidation } from './boundary-rule-invalidation.model.js';
+import type { IBoundaryStaleExceptionFinding } from './boundary-stale-exception-finding.model.js';
+/**
+ * The ONE boundary-check answer (round 11, C#one-boundary-check-authority):
+ * `check boundaries`, finish's boundaries gate, `diff-check` and both MCP
+ * boundary tools read this, so the alias map, the escalation, the exemptions
+ * and the verdict cannot differ between them.
+ */
+export interface IBoundaryCheckResult {
+    readonly schema: 'sharkcraft.boundary-check/v1';
+    readonly projectRoot: string;
+    readonly ruleSource: {
+        readonly kind: 'registry';
+    } | {
+        readonly kind: 'rule-file';
+        readonly path: string;
+    };
+    /** Rules in the source (registry or rule file), before `--rule`. */
+    readonly rulesConfigured: number;
+    /** Rules this run is accountable for: after `--rule`, and in changed mode the governing + escalated ones. */
+    readonly selectedRuleIds: readonly string[];
+    readonly scan: IImportScanResult;
+    /** The full evaluation over the whole scan (always — escalation and stale exceptions need it). */
+    readonly evaluation: IEvaluateResult;
+    readonly rules: readonly IBoundaryRuleCheck[];
+    /** Reported violations (in changed mode: introduced by the changeset or by an escalated rule). */
+    readonly violations: readonly IBoundaryViolation[];
+    readonly counts: {
+        readonly error: number;
+        readonly warning: number;
+        readonly info: number;
+    };
+    readonly suppressed: readonly IBoundarySuppressedViolation[];
+    readonly staleExceptions: readonly IBoundaryStaleExceptionFinding[];
+    /** The selected rules' UNMARKED dead selector units — each rule's settled `.dead`. */
+    readonly deadUnits: readonly IBoundaryDeadUnit[];
+    /**
+     * Units marked `{ pattern, expectEmpty: true }` whose target does not exist
+     * (round 13): accepted — printed `accepted by expectEmpty: …` at exit 0 —
+     * and never a failure, under any flag.
+     */
+    readonly intendedEmpty: readonly IBoundaryUnitFinding[];
+    /**
+     * Units marked `expectEmpty` whose target now exists (round 13): the fence
+     * went live and the marker is stale. ✓ withheld; fails only under
+     * `--fail-on-dead-units` / `--strict`, and never for a pack marker (INFO).
+     */
+    readonly wentLive: readonly IBoundaryUnitFinding[];
+    /** The units that fail THIS run — core's `selectorUnitFails` under the run's flags. */
+    readonly failingUnits: readonly IBoundaryUnitFinding[];
+    readonly loadIssues: readonly IBoundaryLoadIssue[];
+    readonly configuration?: IBoundaryConfigurationStatus;
+    readonly changed?: {
+        readonly mode: ChangedScopeMode;
+        readonly changedFiles: readonly string[];
+        /** Changed SOURCE files (present in the scan) that at least one rule governs. */
+        readonly governedFiles: readonly string[];
+        readonly ignoredLegacyCount: number;
+        readonly ignoredLegacyByRule: Readonly<Record<string, number>>;
+        readonly escalation: IBoundaryRuleInvalidation;
+        /** Rules escalated in this run (empty under `--no-rule-escalation`). */
+        readonly escalatedRuleIds: readonly string[];
+        /** Rules that needed escalation but `--no-rule-escalation` kept out — reported unexamined. */
+        readonly escalationSuppressed: readonly string[];
+    };
+    /** Run coverage: rules examined of rules selected. */
+    readonly runCoverage: IVerdictCoverage;
+    /** The exit this run proposes before settling on coverage (the CLI envelope takes this). */
+    readonly proposedExit: number;
+    /** Settled with core's shortfall rule — never 0 over an unexamined scope. */
+    readonly exitCode: number;
+    readonly verdict: 'pass' | 'fail' | 'not-verified' | 'usage-error';
+    readonly shortfalls: readonly string[];
+    /**
+     * The settled acceptances (`<rule>: accepted by expectEmpty: …`) — present
+     * only at exit 0, like every acceptance (core `settleVerdict`). Round 13.
+     */
+    readonly accepted: readonly string[];
+    /** Set when `--rule` named no rule (exit 3). */
+    readonly unknownRuleId?: string;
+    readonly availableRuleIds?: readonly string[];
+}
+//# sourceMappingURL=boundary-check-result.model.d.ts.map

package/dist/boundary-check-result.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundary-check-result.model.d.ts","sourceRoot":"","sources":["../src/boundary-check-result.model.ts"],"names":[],"mappings":"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"}

package/dist/boundary-check-result.model.js

@@ -0,0 +1 @@
+export {};

package/dist/boundary-configuration-status.d.ts

@@ -0,0 +1,38 @@
+import type { ILoadedBoundaryRulesFile } from '@shrkcrft/boundaries';
+import type { IBoundaryConfigurationStatus } from './boundary-configuration-status.model.js';
+import type { IBoundaryLoadIssue } from './boundary-load-issue.model.js';
+import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
+/** The conventional local rule file — loaded ONLY when listed in `boundaryFiles`. */
+export declare const DEFAULT_LOCAL_BOUNDARY_FILE = "boundaries.ts";
+/**
+ * Classify the local `boundaryFiles` entries — THE code path both the
+ * inspector's load loop and {@link describeBoundaryConfiguration} use, so the
+ * loader and the diagnostics cannot disagree about which files exist.
+ *
+ * `unlistedDefault` is set when `sharkcraft/boundaries.ts` exists but no entry
+ * points at it: the file an author naturally creates loads nothing until it is
+ * listed. It is reported, never auto-loaded — auto-loading would start
+ * enforcing rules silently (new exit 1s).
+ */
+export declare function classifyLocalBoundaryFiles(sharkcraftDir: string, boundaryFiles: readonly string[]): {
+    readonly listed: readonly {
+        readonly rel: string;
+        readonly abs: string;
+        readonly exists: boolean;
+    }[];
+    readonly unlistedDefault?: string;
+};
+/** A path relative to the project root (`/`-separated), or the absolute path when outside it. */
+export declare function boundaryFileLabel(projectRoot: string, abs: string): string;
+/**
+ * The structured load issues one loaded rule file carries — used by the
+ * inspector (local + pack files) and `check boundaries --rule-file`, so every
+ * origin reports a dropped rule the same way.
+ */
+export declare function boundaryLoadIssuesFromFile(loaded: ILoadedBoundaryRulesFile, projectRoot: string, origin: IBoundaryLoadIssue['origin'], packageName?: string): IBoundaryLoadIssue[];
+/**
+ * Are boundary rules configured, and if not, why? The one answer every
+ * boundary surface renders (round 11, L-1).
+ */
+export declare function describeBoundaryConfiguration(inspection: ISharkcraftInspection): IBoundaryConfigurationStatus;
+//# sourceMappingURL=boundary-configuration-status.d.ts.map

package/dist/boundary-configuration-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundary-configuration-status.d.ts","sourceRoot":"","sources":["../src/boundary-configuration-status.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,0CAA0C,CAAC;AAC7F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,qFAAqF;AACrF,eAAO,MAAM,2BAA2B,kBAAkB,CAAC;AAE3D;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,SAAS,MAAM,EAAE,GAC/B;IACD,QAAQ,CAAC,MAAM,EAAE,SAAS;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IACrG,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC,CAQA;AAED,iGAAiG;AACjG,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAI1E;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,wBAAwB,EAChC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,EACpC,WAAW,CAAC,EAAE,MAAM,GACnB,kBAAkB,EAAE,CAoBtB;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,qBAAqB,GAAG,4BAA4B,CA8D7G"}