@shrkcrft/inspector 0.1.0-alpha.2 → 0.1.0-alpha.20

package/dist/ai-readiness.js

@@ -1,6 +1,14 @@
 import { KnowledgeType, hasActionHints } from '@shrkcrft/knowledge';
+import { WorkspaceProfile } from '@shrkcrft/workspace';
 import { diagnoseActionHints } from "./action-hint-diagnostics.js";
 import { runDoctor } from "./sharkcraft-inspector.js";
+/**
+ * Entry types that describe a *location* or a *fact* rather than an action, so
+ * they are not expected to carry actionHints and are excluded from the
+ * action-hint coverage metric. Mirrors the skip set in
+ * `action-hint-diagnostics.ts` (keep the two in sync).
+ */
+const HINT_EXEMPT_TYPES = new Set(['path', 'overview', 'technical']);
 function gradeOf(score) {
     if (score >= 85)
         return 'excellent';
@@ -37,17 +45,97 @@ function isCriticalOrHighWorkflow(entry) {
     return p === 'critical' || p === 'high';
 }
 /**
- * Deterministic 0..100 AI-readiness score. Penalties are explicit:
- *  - Quantity-only "stuff a registry full of entries" is capped via softCap.
- *  - Duplicate-id warnings reduce data-quality dimension.
- *  - Placeholder docs (TODO / TBD / "fill in") reduce docs dimension.
- *  - Critical/high workflow entries missing actionHints reduce safety dim.
- *  - Doctor health stays a hard gate.
+ * Classify the workspace from its profile flags. Used to mark dimensions
+ * core / advisory / n/a so the aggregate score reflects what actually
+ * matters for this repo.
+ */
+function classifyShape(profiles) {
+    const has = (p) => profiles.includes(p);
+    const isLibrary = has(WorkspaceProfile.IsLibrary);
+    const isService = has(WorkspaceProfile.IsService);
+    const isMonorepo = has(WorkspaceProfile.IsMonorepo) ||
+        has(WorkspaceProfile.HasNx) ||
+        has(WorkspaceProfile.HasTurborepo) ||
+        has(WorkspaceProfile.HasPackageWorkspaces);
+    const isApplication = !isLibrary &&
+        (has(WorkspaceProfile.IsFrontend) ||
+            has(WorkspaceProfile.IsBackend) ||
+            isService);
+    let label;
+    if (isMonorepo) {
+        label = isLibrary ? 'library monorepo' : 'monorepo';
+    }
+    else if (isLibrary) {
+        label = 'library';
+    }
+    else if (isService) {
+        label = 'service';
+    }
+    else if (has(WorkspaceProfile.IsFrontend)) {
+        label = 'frontend app';
+    }
+    else if (has(WorkspaceProfile.IsBackend)) {
+        label = 'backend app';
+    }
+    else if (has(WorkspaceProfile.HasTypeScript)) {
+        label = 'TypeScript project';
+    }
+    else {
+        label = 'unclassified';
+    }
+    return { label, isLibrary, isService, isMonorepo, isApplication };
+}
+/**
+ * Deterministic AI-readiness report.
+ *
+ * Replaces the original "single 0-100 score" UX with a shape-aware
+ * report. Each dimension is classified as:
+ *
+ *   - `core` — counts in the aggregate score; produces a recommendation
+ *     when below threshold.
+ *   - `advisory` — shown but doesn't drag the score down; no
+ *     recommendation. Used for dimensions that are nice-to-have but
+ *     not load-bearing for the detected workspace shape (e.g. docs in
+ *     a CLI library).
+ *   - `n/a-for-shape` — irrelevant to this workspace; hidden by
+ *     default. Lets a CLI library skip "add templates" without
+ *     manually suppressing every release.
+ *
+ * Two binary verdicts ride alongside the score:
+ *   - `readyForAgentWrites` — every gate an autonomous agent would need
+ *     before issuing `shrk apply` (config + cli-only safety + clean
+ *     doctor).
+ *   - `readyForAgentReads` — every gate a read-only agent (e.g. an MCP
+ *     context lookup) would need (knowledge entries loaded + doctor
+ *     clean).
+ *
+ * Numerical penalties stay explicit:
+ *   - Quantity-only "stuff a registry full of entries" is capped via softCap.
+ *   - Duplicate-id warnings reduce data-quality dimension.
+ *   - Placeholder docs (TODO / TBD / "fill in") reduce docs dimension.
+ *   - Critical/high workflow entries missing actionHints reduce safety dim.
+ *   - Doctor health stays a hard gate.
  */
 export function buildAiReadinessReport(inspection) {
     const dims = [];
     const recs = [];
-    // 1) Config present
+    const shape = classifyShape(inspection.workspace.profiles);
+    // Reusable applies-to predicates.
+    const templatesApply = shape.isLibrary && !shape.isMonorepo
+        ? 'n/a-for-shape'
+        : shape.isApplication
+            ? 'core'
+            : 'advisory';
+    const pipelinesApply = shape.isLibrary && !shape.isMonorepo
+        ? 'n/a-for-shape'
+        : 'advisory';
+    const pathsApply = shape.isMonorepo || shape.isApplication
+        ? 'core'
+        : 'advisory';
+    const docsApply = shape.isApplication || shape.isMonorepo
+        ? 'core'
+        : 'advisory';
+    // 1) Config present — always core (this is the "did you opt in?" signal).
     dims.push({
         id: 'config',
         title: 'sharkcraft.config.ts present',
@@ -56,6 +144,7 @@ export function buildAiReadinessReport(inspection) {
         note: inspection.configFile
             ? `loaded from ${inspection.configFile}`
             : 'missing — using defaults',
+        applies: 'core',
     });
     if (!inspection.configFile) {
         recs.push('Create sharkcraft/sharkcraft.config.ts to opt in to project-specific config.');
@@ -68,6 +157,7 @@ export function buildAiReadinessReport(inspection) {
         weight: 1.0,
         score: softCapScore(k, 15),
         note: `${k} entries (softcap 15, full at 22)`,
+        applies: 'core',
     });
     if (k < 10)
         recs.push('Add more structured knowledge entries (target: 10+).');
@@ -79,10 +169,11 @@ export function buildAiReadinessReport(inspection) {
         weight: 1.0,
         score: softCapScore(rules.length, 8),
         note: `${rules.length} rules (softcap 8)`,
+        applies: 'core',
     });
     if (rules.length < 5)
         recs.push('Add at least 5 rules describing coding/architecture conventions.');
-    // 4) Path conventions — softcap at 6.
+    // 4) Path conventions — core for monorepos / applications, advisory otherwise.
     const paths = inspection.pathService.list();
     dims.push({
         id: 'paths',
@@ -90,10 +181,16 @@ export function buildAiReadinessReport(inspection) {
         weight: 0.8,
         score: softCapScore(paths.length, 6),
         note: `${paths.length} path conventions (softcap 6)`,
+        applies: pathsApply,
+        appliesReason: pathsApply === 'advisory'
+            ? 'Path conventions matter most for monorepos and applications with explicit src/ layouts.'
+            : undefined,
     });
-    if (paths.length < 4)
+    if (pathsApply === 'core' && paths.length < 4) {
         recs.push('Add path conventions for src/, services/, utils/, tests/ etc.');
-    // 5) Templates — softcap at 4.
+    }
+    // 5) Templates — n/a for pure libraries; core for applications;
+    //    advisory for monorepos (often useful but not load-bearing).
     const t = inspection.templates.length;
     dims.push({
         id: 'templates',
@@ -101,10 +198,18 @@ export function buildAiReadinessReport(inspection) {
         weight: 0.8,
         score: softCapScore(t, 4),
         note: `${t} templates (softcap 4)`,
+        applies: templatesApply,
+        appliesReason: templatesApply === 'n/a-for-shape'
+            ? 'Libraries don\'t scaffold downstream code — templates are not load-bearing here.'
+            : templatesApply === 'advisory'
+                ? 'Templates help generate consistent constructs, but the repo can be agent-ready without them.'
+                : undefined,
     });
-    if (t < 3)
+    if (templatesApply === 'core' && t < 3) {
         recs.push('Define templates for the constructs you generate most often.');
-    // 6) Pipelines — softcap at 3.
+    }
+    // 6) Pipelines — n/a for pure libraries; advisory for everything else.
+    //    Pipelines are nice but rarely block agent workflows.
     const p = inspection.pipelines.length;
     dims.push({
         id: 'pipelines',
@@ -112,21 +217,34 @@ export function buildAiReadinessReport(inspection) {
         weight: 0.8,
         score: softCapScore(p, 3),
         note: `${p} pipelines (softcap 3)`,
+        applies: pipelinesApply,
+        appliesReason: pipelinesApply === 'n/a-for-shape'
+            ? 'Libraries don\'t orchestrate feature pipelines — this dimension does not apply.'
+            : 'Pipelines describe preferred flows; a repo can be agent-ready with just rules + path conventions.',
     });
-    if (p < 2)
-        recs.push('Add at least one feature-dev or safe-generation pipeline.');
-    // 7) Action-hint coverage — fraction of entries that carry hints.
-    const withHints = inspection.knowledgeEntries.filter((e) => hasActionHints(e)).length;
-    const hintsScore = k === 0 ? 0 : Math.min(10, Math.round((withHints / Math.max(k, 1)) * 20));
+    // No recommendation when pipelines is advisory — the old "add a pipeline"
+    // exhortation fired on libraries it shouldn't have.
+    // 7) Action-hint coverage — fraction of HINT-ELIGIBLE entries that carry
+    // hints. Path / overview / technical entries describe a location or a fact
+    // rather than an action, so the action-hint quality doctor deliberately
+    // doesn't grade them (see action-hint-diagnostics). Counting them in the
+    // denominator penalised the score for structural non-gaps — an entry that
+    // *can't* meaningfully carry action hints isn't a missing one — so they are
+    // excluded from both numerator and denominator here too.
+    const hintEligible = inspection.knowledgeEntries.filter((e) => !HINT_EXEMPT_TYPES.has(String(e.type).toLowerCase()));
+    const eligibleCount = hintEligible.length;
+    const withHints = hintEligible.filter((e) => hasActionHints(e)).length;
+    const hintsScore = eligibleCount === 0 ? 0 : Math.min(10, Math.round((withHints / eligibleCount) * 20));
     dims.push({
         id: 'action-hints',
         title: 'Entries with action hints',
         weight: 1.2,
         score: hintsScore,
-        note: `${withHints} of ${k} entries carry actionHints`,
+        note: `${withHints} of ${eligibleCount} hint-eligible entries carry actionHints`,
+        applies: 'core',
     });
     if (hintsScore < 7)
-        recs.push('Add actionHints to high-priority rules (commands, mcpTools, forbiddenActions).');
+        recs.push('Add actionHints to high-priority entries (commands, mcpTools, forbiddenActions, relatedKnowledge).');
     // 8) Verification commands
     const haveVerify = inspection.knowledgeEntries.some((e) => (e.actionHints?.verificationCommands?.length ?? 0) > 0);
     dims.push({
@@ -135,6 +253,7 @@ export function buildAiReadinessReport(inspection) {
         weight: 0.6,
         score: haveVerify ? 10 : 0,
         note: haveVerify ? 'at least one entry lists verification commands' : 'no entry lists verification commands',
+        applies: 'core',
     });
     if (!haveVerify)
         recs.push('Add verificationCommands to safety/generation rules (e.g. typecheck + tests).');
@@ -146,10 +265,11 @@ export function buildAiReadinessReport(inspection) {
         weight: 0.6,
         score: haveForbidden ? 10 : 0,
         note: haveForbidden ? 'at least one entry lists forbiddenActions' : 'no entry lists forbiddenActions',
+        applies: 'core',
     });
     if (!haveForbidden)
         recs.push('Add forbiddenActions to clarify what agents must NOT do.');
-    // 10) Docs — softcap at 4. Penalize placeholder docs.
+    // 10) Docs — softcap at 4. Penalize placeholder docs. Advisory for libraries.
     const docFiles = inspection.sourceFiles.filter((s) => s.endsWith('.md'));
     let placeholderDocCount = 0;
     for (const entry of inspection.knowledgeEntries) {
@@ -169,19 +289,17 @@ export function buildAiReadinessReport(inspection) {
         note: placeholderDocCount > 0
             ? `${docFiles.length} markdown files (-${docsPenalty} for ${placeholderDocCount} placeholder markers)`
             : `${docFiles.length} markdown files`,
+        applies: docsApply,
+        appliesReason: docsApply === 'advisory'
+            ? 'Standalone libraries communicate via README + API docs more than per-task markdown.'
+            : undefined,
     });
     if (placeholderDocCount > 0) {
         recs.push(`Replace TODO/placeholder markers in ${placeholderDocCount} doc/task file(s).`);
     }
     // 11) Doctor health — passes is a near-required gate.
-    //
-    // Action-hint quality warnings are also surfaced by the doctor, but the
-    // dedicated `hint-quality` dimension below already scores them. Counting
-    // them here too would punish the same warning twice and crush the score
-    // once a repo crosses ten hint warnings. Exclude them from this dimension.
     const doctor = runDoctor(inspection);
-    const structuralWarnings = doctor.checks.filter((c) => c.severity === 'warning' &&
-        !c.id.startsWith('actionhints-')).length;
+    const structuralWarnings = doctor.checks.filter((c) => c.severity === 'warning' && !c.id.startsWith('actionhints-')).length;
     const doctorScore = doctor.passed ? Math.max(0, 10 - structuralWarnings) : 0;
     dims.push({
         id: 'doctor',
@@ -191,13 +309,16 @@ export function buildAiReadinessReport(inspection) {
         note: doctor.passed
             ? `passed (${structuralWarnings} structural warnings, ${doctor.summary.warnings} total)`
             : `${doctor.summary.errors} errors`,
+        applies: 'core',
     });
     if (!doctor.passed)
         recs.push('Fix doctor errors before relying on agent workflows.');
-    // 12) Pack discovery health
+    // 12) Pack discovery health — n/a when no packs are installed (don't
+    //     reward inaction with a neutral 5).
     const packs = inspection.packs;
+    const packsApply = packs.discoveredPacks.length === 0 ? 'n/a-for-shape' : 'core';
     const packsScore = packs.discoveredPacks.length === 0
-        ? 5 // neutral when no packs are installed
+        ? 0 // would-be neutral 5 was masking how often this dim doesn't apply
         : packs.invalidPacks.length === 0
             ? 10
             : 4;
@@ -209,14 +330,17 @@ export function buildAiReadinessReport(inspection) {
         note: packs.discoveredPacks.length === 0
             ? 'no packs discovered'
             : `${packs.validPacks.length}/${packs.discoveredPacks.length} packs valid`,
+        applies: packsApply,
+        appliesReason: packsApply === 'n/a-for-shape'
+            ? 'No SharkCraft packs installed — pack-discovery health does not apply.'
+            : undefined,
     });
-    if (packs.invalidPacks.length > 0) {
+    if (packsApply === 'core' && packs.invalidPacks.length > 0) {
         recs.push('Fix invalid pack manifests (see `shrk packs doctor`).');
     }
     // 13) Generation safety — flagship cli-only write policy rule required.
     const hasDryRunDefault = inspection.knowledgeEntries.some((e) => e.actionHints?.writePolicy === 'cli-only' ||
         (e.actionHints?.forbiddenActions ?? []).some((f) => /write through mcp/i.test(f)));
-    // Additionally penalize when any critical/high workflow entry lacks hints.
     const workflowMissingHints = inspection.knowledgeEntries.filter((e) => isCriticalOrHighWorkflow(e) && !hasActionHints(e)).length;
     let safetyScore = hasDryRunDefault ? 10 : 3;
     if (workflowMissingHints > 0) {
@@ -232,6 +356,7 @@ export function buildAiReadinessReport(inspection) {
                 ? `cli-only write policy present, but ${workflowMissingHints} critical/high workflow entry/entries lack actionHints`
                 : 'cli-only write policy + forbidden-actions present'
             : 'no entry declares cli-only write policy',
+        applies: 'core',
     });
     if (!hasDryRunDefault) {
         recs.push('Add a critical safety rule with writePolicy:"cli-only" and "do not write through MCP".');
@@ -251,6 +376,7 @@ export function buildAiReadinessReport(inspection) {
         weight: 0.6,
         score: hintIssueScore,
         note: `${hintReport.issues.length} quality warnings across ${hintReport.evaluatedEntryCount} relevant entries`,
+        applies: 'core',
     });
     // 15) Data quality — duplicate ids surface as warnings.
     const dupCount = inspection.validationIssues.filter((v) => v.code === 'duplicate-id').length;
@@ -263,17 +389,37 @@ export function buildAiReadinessReport(inspection) {
         note: dupCount === 0
             ? 'no duplicate knowledge ids'
             : `${dupCount} duplicate id(s) — first occurrence kept`,
+        applies: 'core',
     });
     if (dupCount > 0)
         recs.push(`Resolve ${dupCount} duplicate knowledge id(s).`);
-    // Aggregate.
-    const totalWeight = dims.reduce((sum, d) => sum + d.weight, 0);
-    const weightedSum = dims.reduce((sum, d) => sum + d.score * d.weight, 0);
-    const score = Math.round((weightedSum / totalWeight) * 10);
+    // Aggregate over `core` dimensions only — advisory + n/a do not count.
+    const coreDims = dims.filter((d) => d.applies === 'core');
+    const totalWeight = coreDims.reduce((sum, d) => sum + d.weight, 0);
+    const weightedSum = coreDims.reduce((sum, d) => sum + d.score * d.weight, 0);
+    const score = totalWeight > 0 ? Math.round((weightedSum / totalWeight) * 10) : 0;
+    // Binary verdicts — honest yes/no rather than a fuzzy score.
+    const blockers = [];
+    if (!doctor.passed)
+        blockers.push('doctor reports errors');
+    if (!inspection.configFile)
+        blockers.push('sharkcraft.config.ts missing');
+    if (!hasDryRunDefault)
+        blockers.push('no cli-only write policy rule');
+    if (k === 0)
+        blockers.push('no knowledge entries loaded');
+    const readyForAgentWrites = blockers.length === 0;
+    const readyForAgentReads = doctor.passed && k > 0;
     return {
         score,
         grade: gradeOf(score),
         dimensions: dims,
         topRecommendations: recs.slice(0, 5),
+        verdicts: {
+            readyForAgentWrites,
+            readyForAgentReads,
+            blockers,
+        },
+        workspaceShape: shape,
     };
 }

package/dist/apply-dispatch-trace.d.ts

@@ -15,12 +15,11 @@ export declare const APPLY_DISPATCH_TRACE_SCHEMA = "sharkcraft.apply-dispatch-tr
 export declare enum DispatchKind {
     Template = "template",
     Helper = "helper",
-    PluginLifecycle = "plugin-lifecycle",
     RegistrationHint = "registration-hint",
     Synthetic = "synthetic",
     Unknown = "unknown"
 }
-export type DispatchSource = 'registry/template' | 'registry/helper' | 'registry/plugin-lifecycle-profile' | 'registry/registration-hint' | 'synthetic' | 'unknown';
+export type DispatchSource = 'registry/template' | 'registry/helper' | 'registry/registration-hint' | 'synthetic' | 'unknown';
 export interface IDispatchFileOpCounts {
     readonly create: number;
     readonly update: number;

package/dist/apply-dispatch-trace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apply-dispatch-trace.d.ts","sourceRoot":"","sources":["../src/apply-dispatch-trace.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"apply-dispatch-trace.d.ts","sourceRoot":"","sources":["../src/apply-dispatch-trace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,UAAU,EAAsB,MAAM,qBAAqB,CAAC;AAC1E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,2BAA2B,uCAAuC,CAAC;AAEhF,oBAAY,YAAY;IACtB,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,gBAAgB,sBAAsB;IACtC,SAAS,cAAc;IACvB,OAAO,YAAY;CACpB;AAED,MAAM,MAAM,cAAc,GACtB,mBAAmB,GACnB,iBAAiB,GACjB,4BAA4B,GAC5B,WAAW,GACX,SAAS,CAAC;AAEd,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EACP,WAAW,GACX,YAAY,GACZ,uBAAuB,GACvB,mBAAmB,GACnB,0BAA0B,GAC1B,eAAe,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,WAAW,GAAG,YAAY,GAAG,eAAe,CAAC;IAC9E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,OAAO,2BAA2B,CAAC;IACpD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,yDAAyD;IACzD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,qBAAqB,CAAC;IAC7C,QAAQ,CAAC,cAAc,EAAE,uBAAuB,CAAC;IACjD,uDAAuD;IACvD,QAAQ,CAAC,qBAAqB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACtD,kEAAkE;IAClE,QAAQ,CAAC,eAAe,EACpB,aAAa,GACb,UAAU,GACV,UAAU,GACV,SAAS,CAAC;IACd,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,yDAAyD;IACzD,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IACzD,6DAA6D;IAC7D,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9C,8DAA8D;IAC9D,QAAQ,CAAC,WAAW,EAAE,SAAS,GAAG,SAAS,GAAG,aAAa,CAAC;IAC5D,qCAAqC;IACrC,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,0BAA0B;IACzC,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC;IAC3C,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,uDAAuD;IACvD,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,0DAA0D;IAC1D,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,uDAAuD;IACvD,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,yEAAyE;IACzE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,gBAAgB,CAAC;CAC5D;AAiHD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,0BAA0B,GAClC,mBAAmB,CAwIrB;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CA2B/E"}

package/dist/apply-dispatch-trace.js

@@ -3,13 +3,11 @@ export var DispatchKind;
 (function (DispatchKind) {
     DispatchKind["Template"] = "template";
     DispatchKind["Helper"] = "helper";
-    DispatchKind["PluginLifecycle"] = "plugin-lifecycle";
     DispatchKind["RegistrationHint"] = "registration-hint";
     DispatchKind["Synthetic"] = "synthetic";
     DispatchKind["Unknown"] = "unknown";
 })(DispatchKind || (DispatchKind = {}));
 const TEMPLATE_PREFIX_HELPER = '__helper__';
-const TEMPLATE_PREFIX_PLUGIN_LIFECYCLE = '__plugin-lifecycle__';
 const TEMPLATE_PREFIX_REGISTRATION_HINT = '__registration-hint__';
 function classifyTemplate(templateId) {
     if (templateId.startsWith(TEMPLATE_PREFIX_HELPER)) {
@@ -19,13 +17,6 @@ function classifyTemplate(templateId) {
             handler: '@shrkcrft/inspector/helper-registry + @shrkcrft/generator/synthetic-plan.evaluateSavedPlanInPlace',
         };
     }
-    if (templateId.startsWith(TEMPLATE_PREFIX_PLUGIN_LIFECYCLE)) {
-        return {
-            kind: DispatchKind.PluginLifecycle,
-            source: 'registry/plugin-lifecycle-profile',
-            handler: '@shrkcrft/inspector/plugin-lifecycle + @shrkcrft/generator/synthetic-plan.evaluateSavedPlanInPlace',
-        };
-    }
     if (templateId.startsWith(TEMPLATE_PREFIX_REGISTRATION_HINT)) {
         return {
             kind: DispatchKind.RegistrationHint,

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

@@ -1 +1 @@
-{"version":3,"file":"area-explore.d.ts","sourceRoot":"","sources":["../src/area-explore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAgB,MAAM,eAAe,CAAC;AAEvD,eAAO,MAAM,mBAAmB,+BAA+B,CAAC;AAEhE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;CAC7E;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EACT,iBAAiB,GACjB,aAAa,GACb,cAAc,GACd,cAAc,GACd,gBAAgB,GAChB,mBAAmB,GACnB,UAAU,CAAC;IACf,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,OAAO,mBAAmB,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;IACxD,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,iBAAiB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;IACrD,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC9C;AAiMD,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,qBAAqB,CAAC;IAClC,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,cAAc,CAAC,EAAE,aAAa,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,mDAAmD;IACnD,YAAY,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,8CAA8C;IAC9C,eAAe,CAAC,EAAE,aAAa,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjF,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,iBAAiB,GAAG,kBAAkB,CA+IxE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAoDxE;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAuC5E"}
+{"version":3,"file":"area-explore.d.ts","sourceRoot":"","sources":["../src/area-explore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAgB,MAAM,eAAe,CAAC;AAEvD,eAAO,MAAM,mBAAmB,+BAA+B,CAAC;AAEhE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;CAC7E;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EACT,iBAAiB,GACjB,aAAa,GACb,cAAc,GACd,cAAc,GACd,gBAAgB,GAChB,mBAAmB,GACnB,UAAU,CAAC;IACf,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,OAAO,mBAAmB,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;IACxD,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,iBAAiB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;IACrD,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC9C;AA6LD,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,qBAAqB,CAAC;IAClC,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,cAAc,CAAC,EAAE,aAAa,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,mDAAmD;IACnD,YAAY,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,8CAA8C;IAC9C,eAAe,CAAC,EAAE,aAAa,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjF,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,iBAAiB,GAAG,kBAAkB,CAiJxE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAoDxE;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAuC5E"}

package/dist/area-explore.js

@@ -123,17 +123,13 @@ function describeRole(relPath, kind) {
     }
     switch (kind) {
         case AreaKind.Core:
-            return 'Core building blocks (Result, errors, ids) — lowest in the layer order.';
+            return 'Core building blocks (Result, errors, ids).';
         case AreaKind.Tests:
             return 'Tests.';
         case AreaKind.Docs:
             return 'Documentation.';
         case AreaKind.Generated:
             return 'Generated output — do not hand-edit.';
-        case AreaKind.Adapter:
-            return 'Framework / runtime adapter glue.';
-        case AreaKind.Plugin:
-            return 'Plugin / pack code.';
         default:
             return `${kind} area.`;
     }
@@ -250,7 +246,9 @@ export function exploreArea(input) {
             kind: classifyFileKind(relPath),
         });
     }
-    files.sort((a, b) => b.sizeBytes - a.sizeBytes);
+    // Secondary key makes the order TOTAL: same-size files near the cutoff would
+    // otherwise be ranked by filesystem order (non-deterministic).
+    files.sort((a, b) => b.sizeBytes - a.sizeBytes || a.relPath.localeCompare(b.relPath));
     const areaMap = buildAreaMap(input.inspection);
     const inferredKind = inferKindForPath(relPath, areaMap);
     const role = describeRole(relPath, inferredKind);

package/dist/area-map.d.ts

@@ -2,11 +2,6 @@ import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
 export declare const AREA_MAP_SCHEMA = "sharkcraft.area-map/v1";
 export declare enum AreaKind {
     Core = "core",
-    Common = "common",
-    Runtime = "runtime",
-    Kernel = "kernel",
-    Plugin = "plugin",
-    Adapter = "adapter",
     Ui = "ui",
     App = "app",
     Api = "api",

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,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,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;AAyED,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,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"}

package/dist/area-map.js

@@ -4,11 +4,6 @@ export const AREA_MAP_SCHEMA = 'sharkcraft.area-map/v1';
 export var AreaKind;
 (function (AreaKind) {
     AreaKind["Core"] = "core";
-    AreaKind["Common"] = "common";
-    AreaKind["Runtime"] = "runtime";
-    AreaKind["Kernel"] = "kernel";
-    AreaKind["Plugin"] = "plugin";
-    AreaKind["Adapter"] = "adapter";
     AreaKind["Ui"] = "ui";
     AreaKind["App"] = "app";
     AreaKind["Api"] = "api";
@@ -20,11 +15,6 @@ export var AreaKind;
 })(AreaKind || (AreaKind = {}));
 const AREA_PATTERNS = [
     { kind: AreaKind.Core, match: [/^packages\/core(\/|$)/, /^src\/core(\/|$)/], idHint: 'core' },
-    { kind: AreaKind.Common, match: [/^packages\/(common|shared)(\/|$)/, /^src\/(common|shared)(\/|$)/], idHint: 'common' },
-    { kind: AreaKind.Runtime, match: [/^packages\/runtime(\/|$)/, /^src\/runtime(\/|$)/], idHint: 'runtime' },
-    { kind: AreaKind.Kernel, match: [/^packages\/kernel(\/|$)/, /^src\/kernel(\/|$)/], idHint: 'kernel' },
-    { kind: AreaKind.Plugin, match: [/plugins?(\/|$)/, /^packages\/plugin-/], idHint: 'plugin' },
-    { kind: AreaKind.Adapter, match: [/adapters?(\/|$)/, /^packages\/adapter-/], idHint: 'adapter' },
     { kind: AreaKind.Ui, match: [/^packages\/(ui|dashboard|web)(\/|$)/, /^(src|app)\/(ui|components|pages|views)(\/|$)/], idHint: 'ui' },
     { kind: AreaKind.App, match: [/^apps?\//, /^packages\/app(\/|$)/], idHint: 'app' },
     { kind: AreaKind.Api, match: [/^packages\/api(\/|$)/, /\/api\//, /\/routes\//, /\/controllers\//], idHint: 'api' },

package/dist/changed-preflight.d.ts

@@ -54,6 +54,13 @@ export declare function planChangedPreflight(options: {
     readonly projectRoot: string;
     readonly changedFiles: ReadonlyArray<string>;
     readonly profile?: PreflightProfile;
+    /** Override the test gate command (defaults to `bun test`). Grounded in the
+     *  project's declared verification commands by the CLI caller. */
+    readonly testCommand?: string;
+    /** Override the typecheck gate command (defaults to the base-tsconfig run). */
+    readonly typecheckCommand?: string;
+    /** Extra path prefixes that count as engine source (e.g. config-declared). */
+    readonly sourceGlobs?: readonly string[];
 }): IChangedPreflightPlan;
 export declare function renderChangedPreflightText(plan: IChangedPreflightPlan): string;
 //# sourceMappingURL=changed-preflight.d.ts.map

package/dist/changed-preflight.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"changed-preflight.d.ts","sourceRoot":"","sources":["../src/changed-preflight.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,wBAAwB,oCAAoC,CAAC;AAE1E,oBAAY,gBAAgB;IAC1B,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,MAAM,WAAW;CAClB;AAED,oBAAY,eAAe;IACzB,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,SAAS,cAAc;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kFAAkF;IAClF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,WAAW,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,OAAO,wBAAwB,CAAC;IACjD,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7C,QAAQ,CAAC,eAAe,EAAE,2BAA2B,CAAC;IACtD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AA+CD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC;CACrC,GAAG,qBAAqB,CA8QxB;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAiB9E"}
+{"version":3,"file":"changed-preflight.d.ts","sourceRoot":"","sources":["../src/changed-preflight.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,wBAAwB,oCAAoC,CAAC;AA6B1E,oBAAY,gBAAgB;IAC1B,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,MAAM,WAAW;CAClB;AAED,oBAAY,eAAe;IACzB,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,SAAS,cAAc;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kFAAkF;IAClF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,WAAW,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,OAAO,wBAAwB,CAAC;IACjD,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7C,QAAQ,CAAC,eAAe,EAAE,2BAA2B,CAAC;IACtD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AA+DD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC;IACpC;sEACkE;IAClE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,+EAA+E;IAC/E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,8EAA8E;IAC9E,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C,GAAG,qBAAqB,CAmRxB;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAiB9E"}