@goflag/cli 0.2.8 → 0.2.10

package/dist/index.d.ts

@@ -48,6 +48,16 @@ type TagOrigin = {
     kind: "computed";
 };
 type Severity = "error" | "warning" | "info";
+/**
+ * How authoritative the requirement behind a finding is.
+ *
+ * Lives here rather than in the rule layer for the same reason `Issue` does:
+ * it crosses the engine → report → CLI `--json` boundary. An agent reading a
+ * report has to be able to tell a `spec-required` from a `heuristic` before it
+ * decides what to change, and a type that stopped at the rule registry could
+ * not tell it — `../rules/types` re-exports this one.
+ */
+type Rigor = "spec-required" | "spec-recommended" | "vendor-spec" | "guideline" | "heuristic";
 
 /**
  * Hreflang reciprocity + matrix derivation (Phase 7.4 / 7.5).
@@ -289,6 +299,34 @@ interface ExtractionIcon {
         height: number;
     } | "any">;
 }
+/** One entry of a Web App Manifest's `icons` member. */
+interface ExtractionManifestIcon {
+    src: string;
+    sizes?: string;
+    type?: string;
+    purpose?: string;
+    /** Parsed `sizes` entries; empty for absent or unparseable values. */
+    parsedSizes: Array<{
+        width: number;
+        height: number;
+    } | "any">;
+}
+/**
+ * The `<link rel="manifest">`, and what the manifest said when goflag fetched
+ * it.
+ *
+ * `parsed` is deliberately three-valued. `undefined` means no probe ran — the
+ * manifest was never looked at — while `false` means it was fetched and could
+ * not be read. A rule must be able to tell those apart from a manifest that
+ * parsed and declares no icons, because only the last of the three is evidence
+ * about the site.
+ */
+interface ExtractionManifest {
+    href: string;
+    parsed?: boolean;
+    /** Present only when `parsed` is true. */
+    icons?: ExtractionManifestIcon[];
+}
 /** One feed advertisement (`rel="alternate"` with a feed content type). */
 interface ExtractionFeed {
     type: string;
@@ -303,9 +341,7 @@ interface ExtractionFeed {
 interface ExtractionLinks {
     hreflang: ExtractionHreflang[];
     icons: ExtractionIcon[];
-    manifest?: {
-        href: string;
-    };
+    manifest?: ExtractionManifest;
     feeds: ExtractionFeed[];
 }
 /** One `<script type="application/ld+json">` block. */
@@ -320,6 +356,29 @@ interface ExtractionJsonLd {
     /** Verbatim script content — the evidence, especially on parse errors. */
     raw: string;
 }
+/** One intrinsic size a file declares about itself. */
+interface ExtractionAssetSize {
+    width: number;
+    height: number;
+}
+/**
+ * What was served at one asset URL the page declared.
+ *
+ * The rules stay pure functions of this model: the network happened in a
+ * dedicated pass (`docs/og-plan.md` D8) and its answers arrive here as data,
+ * exactly like the manifest's.
+ */
+interface ExtractionAsset {
+    status: number;
+    /** 2xx *and* an image content type. */
+    ok: boolean;
+    contentType?: string;
+    /**
+     * Sizes decoded from the file's header — several for an ICO. Absent for a
+     * format goflag does not decode, which means *unknown*, never *none*.
+     */
+    sizes?: ExtractionAssetSize[];
+}
 /**
  * The per-page observation. Everything a page rule (or an agent judging a
  * prose rule) may read; nothing else.
@@ -336,6 +395,13 @@ interface Extraction {
     twitter: ExtractionTwitter;
     links: ExtractionLinks;
     jsonLd: ExtractionJsonLd[];
+    /**
+     * What was served at each asset URL this page declared, keyed by resolved
+     * URL. **Absent when no probe pass ran** — a rule must read that as "not
+     * looked at" rather than "nothing there", the same three-valued care the
+     * manifest gets.
+     */
+    assets?: Record<string, ExtractionAsset>;
 }
 
 /**
@@ -368,8 +434,6 @@ interface Extraction {
  * findings into issues at that boundary.
  */
 
-/** How authoritative the requirement behind a rule is. */
-type Rigor = "spec-required" | "spec-recommended" | "vendor-spec" | "guideline" | "heuristic";
 /** A band a scored measurement can land in. */
 type Band = "ideal" | "acceptable" | "poor";
 /** Everything a rule declares about itself, before any evaluation. */
@@ -686,6 +750,13 @@ interface SiteIssue {
     why?: string;
     /** A copy-pasteable fix snippet, when the rule offers one. */
     fix?: string;
+    /**
+     * Same two fields as `SeoIssue`, and absent for a different reason: a
+     * `SiteRule` may simply not declare a rigor yet. Three of the four do not,
+     * and the catalogue reports that gap rather than inventing an authority.
+     */
+    rigor?: Rigor;
+    sources?: string[];
 }
 /** How the audit established which locales the site serves. */
 interface LocaleAxisReport {
@@ -718,6 +789,20 @@ interface SeoIssue {
     why?: string;
     /** A copy-pasteable fix snippet, when the rule offers one. */
     fix?: string;
+    /**
+     * How authoritative the requirement is, and the documents that back it.
+     *
+     * Carried on the finding because a report is read where the rule registry is
+     * not — a JSON file in CI, a PR comment, an agent's context. Without it a
+     * consumer cannot tell a `spec-required` from a `heuristic`, which is the one
+     * distinction the rigor axis exists to make.
+     */
+    rigor?: Rigor;
+    sources?: string[];
+    /** What the page actually said, as the rule saw it. */
+    observed?: unknown;
+    /** One sentence stating what a passing page looks like. */
+    expected?: string;
 }
 /**
  * One prose rule's evidence bundle, attributed to a page. The `id` is a
@@ -1048,6 +1133,12 @@ interface RollupLink {
 interface RollupSeo {
     ruleId: string;
     severity: Severity;
+    /**
+     * How authoritative the rule is. Constant within a group — a rollup is one
+     * rule — which is what makes the summary the right place to show it: one tag
+     * per line instead of one per finding.
+     */
+    rigor?: Rigor;
     why?: string;
     fix?: string;
     /** A representative message (from the first occurrence). */

package/dist/index.js

@@ -11,7 +11,7 @@ import {
   runAudit,
   summarize,
   targetKey
-} from "./chunk-SKX7UCGC.js";
+} from "./chunk-DKGBLJ4H.js";
 export {
   Logger,
   SAMPLE_LIMIT,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goflag/cli",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "type": "module",
   "description": "Audits a site for broken links, missing translation pages, a robots.txt that contradicts your pages, and missing or misconfigured SEO metadata. JSON-first.",
   "keywords": [