@lyse-labs/lyse 0.1.0-alpha.2 → 0.2.0-alpha.1

package/dist/rules/ai-governance-ai-tokens-reserved.js

@@ -0,0 +1,85 @@
+import { createLyseRule } from "./_rule-module.js";
+import { detectReservedAiTokens } from "../parsers/ai-tokens.js";
+import { makeAllowlistCheck } from "./ai-governance-ai-marker-component-present.js";
+const RULE_ID = "ai-governance/ai-tokens-reserved";
+const MAX_FINDING_NAMES = 20;
+const DISABLE_DIRECTIVE = `lyse-disable ${RULE_ID}`;
+const ALLOWLIST_CANDIDATES = [
+    "README.md",
+    "README",
+    "README.mdx",
+    "readme.md",
+    ".lyse.yaml",
+    ".lyse.yml",
+];
+const isAllowlisted = makeAllowlistCheck(DISABLE_DIRECTIVE);
+const evaluate = async (ctx, _files) => {
+    const findings = [];
+    if (!ctx.repoRoot) {
+        return { findings, opportunities: 0 };
+    }
+    if (isAllowlisted(ctx.repoRoot)) {
+        return { findings, opportunities: 0 };
+    }
+    const names = detectReservedAiTokens(ctx.repoRoot);
+    if (names.length === 0) {
+        return { findings, opportunities: 0 };
+    }
+    const shown = names.slice(0, MAX_FINDING_NAMES);
+    const more = names.length - shown.length;
+    const list = shown.join(", ") + (more > 0 ? `, +${more} more` : "");
+    findings.push({
+        ruleId: RULE_ID,
+        axis: "ai-governance",
+        severity: "info",
+        location: { file: "tokens.json", line: 1, column: 1 },
+        message: `Detected ${names.length} reserved AI-marker design token${names.length === 1 ? "" : "s"}: ${list}`,
+        suggestion: "inventory only — reserved AI tokens are recognised vocabularies (Carbon dragon-fruit / *-ai-*, Polaris magic, Workday Canvas *-ai-*); the composite rule `ai-governance/ai-token-requires-marker` will gate downstream usage",
+    });
+    return { findings, opportunities: 1 };
+};
+export const rule = createLyseRule({
+    meta: {
+        axis: "ai-governance",
+        lyseRuleId: RULE_ID,
+        defaultSeverity: "info",
+        shortDescription: "Inventory reserved AI-marker design tokens",
+        fullDescription: "Scans token sources (`tokens.json`, `tokens/**/*.json`, `*.tokens.json`, and `**/*.css` `--*` custom properties) for token names that match reserved AI-marker vocabularies: Carbon (`dragon-fruit`, `*-ai-*` color tokens), Shopify Polaris (`--p-color-*-magic*`, `magic-*`), Workday Canvas (`*-ai-*` segment), and the generic leading/trailing `ai` segment. Matching is segment-anchored (split by `-`, `_`, `.`, `/`) so `rain`, `paint`, `mainColor`, `captain`, `detail` do not trigger. Emits one info finding listing up to 20 matched names when reserved tokens are present; emits nothing when none are. Severity is informational — a DS with no AI surface is not penalized here; the gating rule lives in Track 3.3 (`ai-governance/ai-token-requires-marker`).",
+        helpUri: "https://github.com/lyse-labs/lyse/blob/main/docs/rules/ai-governance-ai-tokens-reserved.md",
+        rationale: `Why it matters
+
+AI-marker tokens are how a design system tells consumers — humans and agents — that a UI region was produced by AI. Carbon's \`dragon-fruit\` AI gradient, Polaris's \`magic\` namespace, and Workday Canvas's \`*-ai-*\` color tokens are the three established vocabularies; a fourth generic \`ai\` segment covers the long tail.
+
+Track 3 of the Lyse roadmap (Face B — AI-Governance) treats these tokens as the foundation for the composite gating rule \`ai-governance/ai-token-requires-marker\` (Track 3.3), which enforces that AI-produced surfaces actually wear the AI marker. This rule is the inventory step: detect which reserved tokens the repo declares so 3.3 has a deterministic set to check against. It carries no penalty — a DS with zero AI tokens (no AI surface) emits no finding and is not down-scored. The teeth live in 3.3.
+
+The shared parser \`detectReservedAiTokens(repoRoot)\` is exported from \`packages/core/src/parsers/ai-tokens.ts\` so 3.3 reuses the exact same detection set.`,
+        examples: [
+            {
+                good: '/* tokens.json */ { "color": { "primary": "#0070f3" } }',
+                bad: '/* tokens.json */ { "color": { "ai": { "primary": "#0070f3" } } }',
+            },
+            {
+                good: ":root { --color-primary: #0070f3; }",
+                bad: ":root { --p-color-bg-magic: #f4f0fd; }",
+            },
+            {
+                good: '/* tokens.json */ { "gradient": { "sunrise": "..." } }',
+                bad: '/* tokens.json */ { "gradient": { "dragon-fruit": "..." } }',
+            },
+        ],
+        allowlist: [
+            "repos containing `lyse-disable ai-governance/ai-tokens-reserved` in an adjacent README or `.lyse.yaml` — rule is N/A",
+            "token files larger than 2 MB — skipped to avoid pathological cases",
+            "files under `node_modules/`, `dist/`, `build/`, `.git/`, `.next/`, `out/`, `coverage/`",
+        ],
+    },
+    defaultOptions: [],
+    create: () => ({ evaluate }),
+});
+export const _internal = {
+    isAllowlisted,
+    DISABLE_DIRECTIVE,
+    ALLOWLIST_CANDIDATES,
+    MAX_FINDING_NAMES,
+};
+//# sourceMappingURL=ai-governance-ai-tokens-reserved.js.map

package/dist/rules/ai-governance-ai-tokens-reserved.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-governance-ai-tokens-reserved.js","sourceRoot":"","sources":["../../src/rules/ai-governance-ai-tokens-reserved.ts"],"names":[],"mappings":"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"}

package/dist/rules/ai-governance-disclaimer-present.d.ts

@@ -0,0 +1,18 @@
+import type { Rule } from "../types.js";
+interface DisclaimerResult {
+    found: boolean;
+    isGitLabExact: boolean;
+}
+export declare function detectDisclaimer(source: string): DisclaimerResult;
+export declare function detectAiMarkerInSource(source: string): boolean;
+export declare const rule: Rule;
+export declare const _internal: {
+    detectDisclaimer: typeof detectDisclaimer;
+    detectAiMarkerInSource: typeof detectAiMarkerInSource;
+    isAllowlisted: (repoRoot: string) => boolean;
+    AI_MARKER_NAMES: ReadonlySet<string>;
+    DISABLE_DIRECTIVE: string;
+    ALLOWLIST_CANDIDATES: string[];
+    GITLAB_EXACT_DISCLAIMER: string;
+};
+export {};

package/dist/rules/ai-governance-disclaimer-present.js

@@ -0,0 +1,210 @@
+import { join } from "node:path";
+import fg from "fast-glob";
+import { createLyseRule } from "./_rule-module.js";
+import { AI_MARKER_NAMES, isAiMarkerName, safeReadText, COMPONENT_GLOB, SCAN_IGNORE, makeAllowlistCheck, } from "./ai-governance-ai-marker-component-present.js";
+const RULE_ID = "ai-governance/disclaimer-present";
+const DISABLE_DIRECTIVE = `lyse-disable ${RULE_ID}`;
+// WHY separate constant: the exact GitLab Pajamas canonical wording is the
+// highest-confidence signal that a team has adopted the industry-standard
+// disclaimer. Verify against Pajamas AI experience guidelines before updating;
+// embed verbatim so substring match is unambiguous.
+const GITLAB_EXACT_DISCLAIMER = "AI-generated content may be inaccurate. Always check important information.";
+// Disclaimer text phrases — word-boundary anchored, case-insensitive.
+// "ai generated" (space variant) covered by the first two patterns.
+const DISCLAIMER_PHRASES = [
+    /\bgenerated\s+by\s+ai\b/i,
+    /\bai[- ]?generated\b/i,
+    /\bmay\s+be\s+inaccurate\b/i,
+    /\bcheck\s+important\s+info\b/i,
+    /\bpowered\s+by\s+ai\b/i,
+];
+// WHY AI prefix check: generic legal/cookie/privacy disclaimers co-located
+// with an AI marker must not earn info credit — only AI-specific disclaimer
+// components count. Exact `Disclaimer` (standalone) is always AI-disclaimer
+// context; prefixed names must carry an AI-domain qualifier.
+function hasDisclaimerTagName(name) {
+    const lower = name.toLowerCase();
+    if (!lower.includes("disclaimer"))
+        return false;
+    if (lower === "disclaimer")
+        return true;
+    return (lower.startsWith("ai") ||
+        lower.startsWith("genai") ||
+        lower.startsWith("generative") ||
+        lower.startsWith("llm"));
+}
+const ALLOWLIST_CANDIDATES = [
+    "README.md",
+    "README",
+    "README.mdx",
+    "readme.md",
+    ".lyse.yaml",
+    ".lyse.yml",
+];
+const isAllowlisted = makeAllowlistCheck(DISABLE_DIRECTIVE);
+export function detectDisclaimer(source) {
+    if (source.includes(GITLAB_EXACT_DISCLAIMER)) {
+        return { found: true, isGitLabExact: true };
+    }
+    for (const re of DISCLAIMER_PHRASES) {
+        if (re.test(source))
+            return { found: true, isGitLabExact: false };
+    }
+    for (const m of source.matchAll(/<\s*([A-Za-z][\w.]*)/g)) {
+        if (m[1] && hasDisclaimerTagName(m[1])) {
+            return { found: true, isGitLabExact: false };
+        }
+    }
+    return { found: false, isGitLabExact: false };
+}
+export function detectAiMarkerInSource(source) {
+    for (const m of source.matchAll(/<\s*([A-Za-z][\w.-]*)/g)) {
+        if (m[1] && isAiMarkerName(m[1]))
+            return true;
+    }
+    return false;
+}
+const MAX_LISTED_FILES = 20;
+const evaluate = async (ctx, _files) => {
+    const findings = [];
+    if (!ctx.repoRoot)
+        return { findings, opportunities: 0 };
+    if (isAllowlisted(ctx.repoRoot))
+        return { findings, opportunities: 0 };
+    let componentFiles = [];
+    try {
+        componentFiles = fg
+            .sync(COMPONENT_GLOB, {
+            cwd: ctx.repoRoot,
+            absolute: false,
+            dot: false,
+            ignore: SCAN_IGNORE,
+            onlyFiles: true,
+            unique: true,
+        })
+            .sort();
+    }
+    catch {
+        return { findings, opportunities: 0 };
+    }
+    if (componentFiles.length === 0)
+        return { findings, opportunities: 0 };
+    let anyAiSurface = false;
+    const missingDisclaimerFiles = [];
+    for (const rel of componentFiles) {
+        const abs = join(ctx.repoRoot, rel);
+        const source = safeReadText(abs);
+        if (!source)
+            continue;
+        const hasMarker = detectAiMarkerInSource(source);
+        const disclaimer = detectDisclaimer(source);
+        if (!hasMarker)
+            continue;
+        anyAiSurface = true;
+        if (!disclaimer.found) {
+            missingDisclaimerFiles.push(rel);
+        }
+        if (disclaimer.found) {
+            const gitlabNote = disclaimer.isGitLabExact
+                ? " Matches the GitLab Pajamas canonical disclaimer wording (highest confidence)."
+                : "";
+            const baseFinding = {
+                ruleId: RULE_ID,
+                axis: "ai-governance",
+                severity: "info",
+                location: { file: rel, line: 1, column: 1 },
+                message: `AI disclaimer detected in ${rel}.${gitlabNote} Capability framing present (HAX G1/G2).`,
+            };
+            if (!disclaimer.isGitLabExact) {
+                baseFinding.suggestion =
+                    `Consider adopting the GitLab Pajamas canonical wording for highest-confidence scoring: ` +
+                        `"AI-generated content may be inaccurate. Always check important information."`;
+            }
+            findings.push(baseFinding);
+        }
+    }
+    if (!anyAiSurface)
+        return { findings: [], opportunities: 0 };
+    if (missingDisclaimerFiles.length > 0) {
+        const listed = missingDisclaimerFiles.slice(0, MAX_LISTED_FILES);
+        const overflow = missingDisclaimerFiles.length - listed.length;
+        const fileList = listed.join(", ") + (overflow > 0 ? `, +${overflow} more` : "");
+        findings.unshift({
+            ruleId: RULE_ID,
+            axis: "ai-governance",
+            severity: "warning",
+            location: { file: missingDisclaimerFiles[0] ?? "src/index.ts", line: 1, column: 1 },
+            message: `${missingDisclaimerFiles.length} file${missingDisclaimerFiles.length === 1 ? "" : "s"} contain an AI-marker component but no disclaimer text or disclaimer component (HAX G1/G2 — GitLab Pajamas): ${fileList}.`,
+            suggestion: `Render a visible disclaimer alongside AI-generated content. ` +
+                `GitLab Pajamas canonical wording: "AI-generated content may be inaccurate. Always check important information."`,
+        });
+    }
+    return { findings, opportunities: componentFiles.length };
+};
+export const rule = createLyseRule({
+    meta: {
+        axis: "ai-governance",
+        lyseRuleId: RULE_ID,
+        defaultSeverity: "warning",
+        shortDescription: "Detect AI disclaimer near AI-generated output",
+        fullDescription: "Scans component files (`**/*.{tsx,jsx,vue}`) for a co-located AI disclaimer — " +
+            "either disclaimer text (`Generated by AI`, `AI-generated`, `May be inaccurate`, " +
+            "`Check important info`, `Powered by AI`, case-insensitive word-boundary) or a " +
+            "`*Disclaimer*` / `*AIDisclaimer*` component tag. " +
+            "Highest-confidence signal: the GitLab Pajamas canonical disclaimer wording matched verbatim. " +
+            "Cross-condition: if an AI-marker component (per AI_MARKER_NAMES) is present but no disclaimer is found, " +
+            "emits `warning`; if a disclaimer is detected, emits `info` (noting the GitLab canonical match when applicable). " +
+            "Emits nothing when no AI surface is present.",
+        helpUri: "https://github.com/lyse-labs/lyse/blob/main/docs/rules/ai-governance-disclaimer-present.md",
+        rationale: `Why it matters
+
+AI systems make errors. Capability-framing guidelines (HAX G1/G2) require that AI-generated surfaces carry a visible disclaimer so users understand the system's limits and know to verify critical information.
+
+GitLab Pajamas formalises this with a canonical disclaimer string: "AI-generated content may be inaccurate. Always check important information." When the exact Pajamas wording is used, Lyse flags it as highest-confidence.
+
+This rule enforces the pairing: an AI-marker component is the visual signal that content is AI-generated; a disclaimer is the capability-framing signal that the content may err. Having the marker without the disclaimer leaves users without the context they need to make safe decisions.
+
+The rule emits \`warning\` (action required) when a marker is present but no disclaimer is found, and \`info\` (inventory) when a disclaimer is detected — flagging whether it matches the GitLab canonical wording.`,
+        examples: [
+            {
+                good: "// AISummary.tsx — marker + disclaimer present\n" +
+                    "<AILabel />\n" +
+                    "<p>{summary}</p>\n" +
+                    '<p className="disclaimer">Generated by AI. May be inaccurate.</p>',
+                bad: "// AISummary.tsx — marker present, no disclaimer\n" +
+                    "<AILabel />\n" +
+                    "<p>{summary}</p>",
+            },
+            {
+                good: "// GitLab canonical wording — highest-confidence pass\n" +
+                    '<AIDisclaimer message="AI-generated content may be inaccurate. Always check important information." />',
+                bad: "// AI marker but disclaimer is buried in a tooltip the user may never see\n" +
+                    "<AIBadge /><Tooltip>AI content</Tooltip>",
+            },
+            {
+                good: "// Vue SFC — disclaimer component rendered alongside output\n" +
+                    "<template><AIOutput :text /><AiDisclaimer /></template>",
+                bad: "// Vue SFC — AI token reserved in class, no disclaimer rendered\n" +
+                    '<template><div class="ai-output">{{ text }}</div></template>',
+            },
+        ],
+        allowlist: [
+            "repos containing `lyse-disable ai-governance/disclaimer-present` in an adjacent README or `.lyse.yaml` — rule is N/A",
+            "repos with no AI-marker component AND no disclaimer text — no AI surface detected, rule emits nothing",
+            "files larger than 1 MB — skipped to avoid pathological cases",
+            "files under `node_modules/`, `dist/`, `build/`, `.git/`, `.next/`, `out/`, `coverage/`",
+        ],
+    },
+    defaultOptions: [],
+    create: () => ({ evaluate }),
+});
+export const _internal = {
+    detectDisclaimer,
+    detectAiMarkerInSource,
+    isAllowlisted,
+    AI_MARKER_NAMES,
+    DISABLE_DIRECTIVE,
+    ALLOWLIST_CANDIDATES,
+    GITLAB_EXACT_DISCLAIMER,
+};
+//# sourceMappingURL=ai-governance-disclaimer-present.js.map

package/dist/rules/ai-governance-disclaimer-present.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-governance-disclaimer-present.js","sourceRoot":"","sources":["../../src/rules/ai-governance-disclaimer-present.ts"],"names":[],"mappings":"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"}

package/dist/rules/ai-governance-explainability-affordance.d.ts

@@ -0,0 +1,14 @@
+import type { Rule } from "../types.js";
+export declare function isExplainabilityAffordanceName(name: string): boolean;
+export declare function isMarkerWithPopover(name: string, source: string): boolean;
+export declare function scanForExplainabilityAffordances(repoRoot: string, files?: string[]): string[];
+export declare const rule: Rule;
+export declare const _internal: {
+    isAllowlisted: (repoRoot: string) => boolean;
+    isExplainabilityAffordanceName: typeof isExplainabilityAffordanceName;
+    isMarkerWithPopover: typeof isMarkerWithPopover;
+    scanForExplainabilityAffordances: typeof scanForExplainabilityAffordances;
+    AFFORDANCE_PATTERNS: string[];
+    DISABLE_DIRECTIVE: string;
+    ALLOWLIST_CANDIDATES: string[];
+};

package/dist/rules/ai-governance-explainability-affordance.js

@@ -0,0 +1,196 @@
+import { join } from "node:path";
+import fg from "fast-glob";
+import { createLyseRule } from "./_rule-module.js";
+import { isAiMarkerName, extractNamesFromSource, extractVueNames, safeReadText, COMPONENT_GLOB, SCAN_IGNORE, fileHasAiMarker, deriveComponentNameFromPath, scanForMarkerComponents, makeAllowlistCheck, } from "./ai-governance-ai-marker-component-present.js";
+const RULE_ID = "ai-governance/explainability-affordance";
+const DISABLE_DIRECTIVE = `lyse-disable ${RULE_ID}`;
+const ALLOWLIST_CANDIDATES = [
+    "README.md",
+    "README",
+    "README.mdx",
+    "readme.md",
+    ".lyse.yaml",
+    ".lyse.yml",
+];
+// Name-based affordance detection patterns (case-insensitive substring match).
+const AFFORDANCE_PATTERNS = [
+    "explain",
+    "explainability",
+    "whythis",
+    "citation",
+    "sources",
+    "confidence",
+    "provenance",
+];
+// ARIA attributes indicating a popover/tooltip carrying explanation content.
+const ARIA_POPOVER_RE = /\baria-describedby\s*=|role\s*=\s*["'](?:dialog|tooltip)["']/i;
+const isAllowlisted = makeAllowlistCheck(DISABLE_DIRECTIVE);
+export function isExplainabilityAffordanceName(name) {
+    const lower = name.toLowerCase();
+    return AFFORDANCE_PATTERNS.some((p) => lower.includes(p));
+}
+export function isMarkerWithPopover(name, source) {
+    if (!isAiMarkerName(name))
+        return false;
+    return ARIA_POPOVER_RE.test(source);
+}
+// Accepts an optional pre-computed file list to avoid a second glob in evaluate.
+export function scanForExplainabilityAffordances(repoRoot, files) {
+    const found = [];
+    let componentFiles;
+    if (files !== undefined) {
+        componentFiles = files;
+    }
+    else {
+        componentFiles = [];
+        try {
+            componentFiles = fg.sync(COMPONENT_GLOB, {
+                cwd: repoRoot,
+                absolute: false,
+                dot: false,
+                ignore: SCAN_IGNORE,
+                onlyFiles: true,
+                unique: true,
+            });
+        }
+        catch {
+            // non-fatal
+        }
+    }
+    for (const rel of componentFiles) {
+        const baseName = deriveComponentNameFromPath(rel);
+        const source = safeReadText(join(repoRoot, rel));
+        if (!source)
+            continue;
+        const hasMarker = fileHasAiMarker(source, rel) || isAiMarkerName(baseName);
+        if (!hasMarker)
+            continue;
+        // File contains an AI marker — now check for co-located affordance names.
+        const names = rel.endsWith(".vue")
+            ? extractVueNames(source)
+            : extractNamesFromSource(source);
+        // Also check the file name itself (e.g. AIConfidenceDisplay.tsx where the
+        // file is both a marker AND an affordance by name).
+        if (isExplainabilityAffordanceName(baseName)) {
+            found.push(baseName);
+        }
+        for (const name of names) {
+            if (isExplainabilityAffordanceName(name)) {
+                found.push(name);
+            }
+            else if (isMarkerWithPopover(name, source)) {
+                found.push(`${name}[popover]`);
+            }
+        }
+    }
+    const seen = new Set();
+    const deduped = [];
+    for (const name of found) {
+        const key = name.toLowerCase();
+        if (!seen.has(key)) {
+            seen.add(key);
+            deduped.push(name);
+        }
+    }
+    return deduped.sort();
+}
+const evaluate = async (ctx, _files) => {
+    const findings = [];
+    if (!ctx.repoRoot) {
+        return { findings, opportunities: 0 };
+    }
+    if (isAllowlisted(ctx.repoRoot)) {
+        return { findings, opportunities: 0 };
+    }
+    // Glob once — reuse file list for the marker gate check and affordance scan.
+    let componentFiles = [];
+    try {
+        componentFiles = fg.sync(COMPONENT_GLOB, {
+            cwd: ctx.repoRoot,
+            absolute: false,
+            dot: false,
+            ignore: SCAN_IGNORE,
+            onlyFiles: true,
+            unique: true,
+        });
+    }
+    catch {
+        // non-fatal
+    }
+    if (scanForMarkerComponents(ctx.repoRoot).length === 0) {
+        return { findings, opportunities: 0 };
+    }
+    const affordances = scanForExplainabilityAffordances(ctx.repoRoot, componentFiles);
+    if (affordances.length > 0) {
+        const list = affordances.join(", ");
+        findings.push({
+            ruleId: RULE_ID,
+            axis: "ai-governance",
+            severity: "info",
+            location: { file: "src/index.ts", line: 1, column: 1 },
+            message: `Explainability affordance${affordances.length === 1 ? "" : "s"} detected: ${list} (HAX G11 / PAIR Explainability)`,
+            suggestion: "Explainability affordance found — ensure it is paired with the AI-marker component and surfaces rationale or confidence information to users.",
+        });
+        return { findings, opportunities: 1 };
+    }
+    findings.push({
+        ruleId: RULE_ID,
+        axis: "ai-governance",
+        severity: "warning",
+        location: { file: "src/index.ts", line: 1, column: 1 },
+        message: "An AI-marker component is present but no explainability affordance was detected (HAX G11 / PAIR Explainability). Consider shipping a companion Explain/Citation/Confidence component or binding the marker to a popover/tooltip with aria-describedby or role=\"dialog\".",
+        suggestion: "Add a dedicated explainability component (e.g. ExplainPopover, CitationList, ConfidenceDisplay, WhyThis) or attach aria-describedby / role=\"tooltip\" to the AI-marker to surface rationale for AI-generated content.",
+    });
+    return { findings, opportunities: 1 };
+};
+export const rule = createLyseRule({
+    meta: {
+        axis: "ai-governance",
+        lyseRuleId: RULE_ID,
+        defaultSeverity: "warning",
+        shortDescription: "Detect an explainability affordance paired with AI-marker components",
+        fullDescription: "When an AI-marker component is detected in the design system (per the shared `isAiMarkerName` predicate exported by `ai-governance/ai-marker-component-present`), this rule checks whether a companion explainability affordance exists. Detection is name-based: any exported identifier or component file whose name contains `Explain`, `Explainability`, `WhyThis`, `Citation`, `Sources`, `Confidence`, or `Provenance` (case-insensitive) qualifies. A marker component that opens a popover or tooltip carrying explanation content (`aria-describedby` / `role=\"dialog\"` / `role=\"tooltip\"`) also satisfies the rule. Emits `info` when an affordance is found; emits `warning` when an AI-marker exists but no affordance is detected. Emits nothing when no AI-marker is present (no AI surface). Guidelines: HAX G11 (Explain AI decisions) / PAIR Explainability. The behavioral slice — verifying that an indicator appears wherever AI output is rendered — is deferred to Track 4.",
+        helpUri: "https://github.com/lyse-labs/lyse/blob/main/docs/rules/ai-governance-explainability-affordance.md",
+        rationale: `Why it matters
+
+Users interacting with AI-generated content have a right to understand why a particular output was produced. HAX G11 (Google PAIR / IBM Human-AI Experience guidelines) requires that AI-powered interfaces expose an explanation pathway — a popover, citation list, confidence meter, or similar affordance — so users can evaluate trustworthiness and take informed action.
+
+Without this affordance, consumers of the design system have no standard component to reach for when building explainable AI interfaces, leading to ad-hoc implementations with inconsistent UX and missing accessibility attributes.
+
+This rule checks only the static "affordance present" slice (Track 3.5): does the DS export a component whose name signals explainability intent, or does an AI-marker component carry the appropriate ARIA binding to open an explanation panel? The behavioral slice — ensuring such an indicator appears wherever AI output is rendered in a consuming application — requires semantic location detection and is out of scope here; it will be addressed in Track 4.
+
+A DS with no AI-marker component at all has no AI surface and is not penalised.`,
+        examples: [
+            {
+                good: "// src/index.ts\nexport { AILabel } from './ai-label';\nexport { ExplainPopover } from './explain-popover';",
+                bad: "// src/index.ts\nexport { AILabel } from './ai-label';\n// no Explain/Citation/Confidence component exported",
+            },
+            {
+                good: '// AILabel.tsx — marker bound to explanation panel\n<button aria-describedby="explain-panel">AI</button>\n<div id="explain-panel" role="dialog">Why: …</div>',
+                bad: "// AILabel.tsx — marker with no explanation binding\n<span className=\"ai-badge\">AI</span>",
+            },
+            {
+                good: "// src/index.ts\nexport { ConfidenceDisplay } from './confidence-display';\nexport { CitationList } from './citation-list';",
+                bad: "// AI tokens and AIBadge exported, but no explainability affordance component present",
+            },
+        ],
+        allowlist: [
+            "repos containing `lyse-disable ai-governance/explainability-affordance` in an adjacent README or `.lyse.yaml` — rule is N/A",
+            "repos with no AI-marker component — no AI surface detected, rule emits nothing",
+            "files larger than 1 MB — skipped to avoid pathological cases",
+            "files under `node_modules/`, `dist/`, `build/`, `.git/`, `.next/`, `out/`, `coverage/`",
+        ],
+    },
+    defaultOptions: [],
+    create: () => ({ evaluate }),
+});
+export const _internal = {
+    isAllowlisted,
+    isExplainabilityAffordanceName,
+    isMarkerWithPopover,
+    scanForExplainabilityAffordances,
+    AFFORDANCE_PATTERNS,
+    DISABLE_DIRECTIVE,
+    ALLOWLIST_CANDIDATES,
+};
+//# sourceMappingURL=ai-governance-explainability-affordance.js.map

package/dist/rules/ai-governance-explainability-affordance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-governance-explainability-affordance.js","sourceRoot":"","sources":["../../src/rules/ai-governance-explainability-affordance.ts"],"names":[],"mappings":"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"}

package/dist/rules/ai-governance-feedback-control-present.d.ts

@@ -0,0 +1,19 @@
+import type { Rule } from "../types.js";
+export declare function isFeedbackControlName(name: string): boolean;
+export declare function detectCategorizedFeedback(source: string): boolean;
+interface FeedbackScan {
+    names: string[];
+    categorized: boolean;
+}
+export declare function scanForFeedbackControls(repoRoot: string, files?: string[]): FeedbackScan;
+export declare const rule: Rule;
+export declare const _internal: {
+    isFeedbackControlName: typeof isFeedbackControlName;
+    detectCategorizedFeedback: typeof detectCategorizedFeedback;
+    isAllowlisted: (repoRoot: string) => boolean;
+    scanForFeedbackControls: typeof scanForFeedbackControls;
+    DISABLE_DIRECTIVE: string;
+    ALLOWLIST_CANDIDATES: string[];
+    FEEDBACK_PATTERNS: readonly ["feedback", "thumbsup", "thumbsdown", "rating", "vote", "helpful"];
+};
+export {};