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

package/dist/rules/ai-governance-feedback-control-present.js

@@ -0,0 +1,223 @@
+import { join } from "node:path";
+import fg from "fast-glob";
+import { createLyseRule } from "./_rule-module.js";
+import { extractNamesFromSource, extractVueNames, safeReadText, COMPONENT_GLOB, SCAN_IGNORE, fileHasAiMarker, makeAllowlistCheck, } from "./ai-governance-ai-marker-component-present.js";
+const RULE_ID = "ai-governance/feedback-control-present";
+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);
+// Feedback control vocabulary — case-insensitive substring match after
+// separator normalisation (kebab/snake stripped before comparison).
+// Names ending in display-counter suffixes or Icon primitives are excluded.
+const FEEDBACK_PATTERNS = [
+    "feedback",
+    "thumbsup",
+    "thumbsdown",
+    "rating",
+    "vote",
+    "helpful",
+];
+// Exclude icon primitives AND display-only counters/result labels.
+const EXCLUDE_SUFFIX_RE = /(?:icon|count|result|total|tally|text)$/i;
+// Normalise kebab-case and snake_case names before vocabulary matching.
+function normaliseName(name) {
+    return name.toLowerCase().replace(/[-_]/g, "");
+}
+export function isFeedbackControlName(name) {
+    const lower = normaliseName(name);
+    if (EXCLUDE_SUFFIX_RE.test(lower))
+        return false;
+    return FEEDBACK_PATTERNS.some((p) => lower.includes(p));
+}
+// Categorized bonus: source exposes named reason options (enum object, union
+// type, or options array) containing known negative-reason vocabulary words.
+const REASON_VOCAB = /\b(inaccurate|unhelpful|offensive|tooLong|too_long|harmful|misleading|irrelevant)\b/i;
+const ENUM_OR_TYPE_RE = /(?:type|enum|const)\s+\w*[Rr]eason\w*\s*[=:{<]/;
+const OPTIONS_ARRAY_RE = /\w*[Oo]ption\w*\s*=\s*\[/;
+export function detectCategorizedFeedback(source) {
+    if (!REASON_VOCAB.test(source))
+        return false;
+    return ENUM_OR_TYPE_RE.test(source) || OPTIONS_ARRAY_RE.test(source);
+}
+function deriveNameFromPath(relPath) {
+    const parts = relPath.split("/");
+    const file = parts[parts.length - 1] ?? "";
+    return file.replace(/\.(tsx|jsx|vue)$/, "");
+}
+// Per-file co-location: only count a feedback control found in a FILE that
+// ALSO contains an AI marker in that same file.
+// Accepts an optional pre-computed file list to avoid a second glob in evaluate.
+export function scanForFeedbackControls(repoRoot, files) {
+    const found = new Map();
+    function record(name, categorized) {
+        const key = normaliseName(name);
+        const existing = found.get(key);
+        if (!existing) {
+            found.set(key, { displayName: name, categorized });
+        }
+        else {
+            found.set(key, { displayName: existing.displayName, categorized: existing.categorized || categorized });
+        }
+    }
+    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.sort()) {
+        const source = safeReadText(join(repoRoot, rel));
+        if (!source)
+            continue;
+        if (!fileHasAiMarker(source, rel))
+            continue;
+        const baseName = deriveNameFromPath(rel);
+        if (isFeedbackControlName(baseName)) {
+            record(baseName, detectCategorizedFeedback(source));
+            continue;
+        }
+        const names = rel.endsWith(".vue")
+            ? extractVueNames(source)
+            : extractNamesFromSource(source);
+        for (const name of names) {
+            if (isFeedbackControlName(name)) {
+                record(name, detectCategorizedFeedback(source));
+            }
+        }
+    }
+    const entries = [...found.values()].sort((a, b) => a.displayName.localeCompare(b.displayName));
+    const names = entries.map((e) => e.displayName);
+    const categorized = entries.some((e) => e.categorized);
+    return { names, categorized };
+}
+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 the file list for both the gate check and the full 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
+    }
+    let anyAiMarker = false;
+    for (const rel of componentFiles) {
+        const source = safeReadText(join(ctx.repoRoot, rel));
+        if (!source)
+            continue;
+        if (fileHasAiMarker(source, rel)) {
+            anyAiMarker = true;
+            break;
+        }
+    }
+    if (!anyAiMarker)
+        return { findings, opportunities: 0 };
+    const { names, categorized } = scanForFeedbackControls(ctx.repoRoot, componentFiles);
+    if (names.length > 0) {
+        const list = names.join(", ");
+        const categorizedNote = categorized
+            ? " (categorized reason enum detected)"
+            : "";
+        findings.push({
+            ruleId: RULE_ID,
+            axis: "ai-governance",
+            severity: "info",
+            location: { file: "src/index.ts", line: 1, column: 1 },
+            message: `Feedback control${names.length === 1 ? "" : "s"} detected: ${list}${categorizedNote} (HAX G15 / PAIR Feedback)`,
+            suggestion: "Feedback control found — ensure it is paired with the AI-marker component on AI-generated surfaces. If not already categorized, expose a reason enum (e.g. inaccurate, unhelpful, offensive) for richer signal.",
+        });
+        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 feedback control was detected (HAX G15 / PAIR Feedback). Ship a thumbs-up/down, rating, or helpful/unhelpful component so users can signal AI output quality.",
+        suggestion: "Add a dedicated feedback component (e.g. AiFeedback, ThumbsUp/ThumbsDown, StarRating, WasThisHelpful) and optionally expose a reason enum (inaccurate, unhelpful, offensive) for categorized feedback.",
+    });
+    return { findings, opportunities: 1 };
+};
+export const rule = createLyseRule({
+    meta: {
+        axis: "ai-governance",
+        lyseRuleId: RULE_ID,
+        defaultSeverity: "warning",
+        shortDescription: "Detect a feedback control on AI output",
+        fullDescription: "When an AI-marker component is detected in the design system, this rule checks whether a companion feedback control exists co-located in the same file. Detection is per-file: a feedback vocabulary match only earns credit when the same file also contains an AI-marker (component name or JSX tag). Detection is two-phase. Phase 1 — name-based scan: checks exported identifiers and file base names against the feedback vocabulary (case-insensitive substring, separator-normalised): `feedback`, `thumbsup`, `thumbsdown`, `rating`, `vote`, `helpful`. Names ending in `Icon`, `Count`, `Result`, `Total`, `Tally`, or `Text` suffixes (display counters / icon primitives) are excluded. Phase 2 — categorized bonus: for each matched feedback component file, checks whether the source exposes a reason vocabulary word (`inaccurate`, `unhelpful`, `offensive`, `tooLong`, `harmful`, `misleading`, `irrelevant`) alongside an enum object, union type, or options array. Three outcomes: AI-marker present + feedback control co-located → `info` (notes if categorized; HAX G15 / PAIR Feedback cited); AI-marker present + no co-located feedback control → `warning`; no AI-marker anywhere → no finding.",
+        helpUri: "https://github.com/lyse-labs/lyse/blob/main/docs/rules/ai-governance-feedback-control-present.md",
+        rationale: `Why it matters
+
+Users interacting with AI-generated content need a structured way to signal output quality. HAX G15 (IBM Human-AI Experience guidelines, Granular feedback) and the Google PAIR Feedback & Control guidebook require that AI-powered interfaces expose a feedback control — thumbs up/down, rating, or helpful/unhelpful — so users can communicate when AI output is wrong, harmful, or unhelpful.
+
+Vendor mandates: Microsoft Fluent 2 AI design guidelines mandate a feedback affordance on AI output; Amazon Cloudscape AI components documentation encourages it; Red Hat PatternFly AI component guidance recommends it. Without a dedicated component, teams implement ad-hoc controls with inconsistent UX, missing accessibility attributes, and no shared vocabulary for categorized negative feedback.
+
+Categorized feedback (why was it bad?) provides richer model-improvement signal than binary thumbs alone. This rule rewards designs that expose a reason enum (inaccurate, unhelpful, offensive) by noting the categorized bonus in the info message.
+
+The rule uses per-file co-location: a feedback control only earns credit when it lives in the same file as an AI-marker component or JSX tag. Generic form-validation components (ValidationFeedback), display counters (VoteCount), or product review widgets (ProductRating) in unrelated files do not falsely count. The rule fires only when at least one AI-marker file exists. A DS with no AI surface is not penalized.`,
+        examples: [
+            {
+                good: "// AiFeedback.tsx — co-located with AI marker\nexport const AILabel = () => null;\nexport const ThumbsUp = () => null;\nexport const ThumbsDown = () => null;",
+                bad: "// ValidationFeedback.tsx — form errors, no AI marker\nexport const ValidationFeedback = () => null;\n// AILabel.tsx — separate file, no feedback control",
+            },
+            {
+                good: "// AiFeedback.tsx — exposes categorized reasons alongside AI marker\nexport const AIBadge = () => null;\nexport const AiFeedback = () => null;\nexport const FeedbackReason = { inaccurate: 'inaccurate', unhelpful: 'unhelpful', offensive: 'offensive' } as const;",
+                bad: "// AiFeedback.tsx — no reason categories\nexport const AiFeedback = () => null;",
+            },
+            {
+                good: "// StarRating.tsx present alongside AIBadge in the same file",
+                bad: "// AIBadge.tsx present but no rating, vote, or helpful component shipped in the same file",
+            },
+        ],
+        allowlist: [
+            "repos containing `lyse-disable ai-governance/feedback-control-present` 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 = {
+    isFeedbackControlName,
+    detectCategorizedFeedback,
+    isAllowlisted,
+    scanForFeedbackControls,
+    DISABLE_DIRECTIVE,
+    ALLOWLIST_CANDIDATES,
+    FEEDBACK_PATTERNS,
+};
+//# sourceMappingURL=ai-governance-feedback-control-present.js.map

package/dist/rules/ai-governance-feedback-control-present.js.map

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

package/dist/rules/ai-governance-human-control-affordances.d.ts

@@ -0,0 +1,16 @@
+import type { Rule } from "../types.js";
+export interface ControlHit {
+    name?: string;
+    label?: string;
+}
+export declare function detectPerOutputControls(source: string): ControlHit[];
+export declare function detectGlobalAiToggle(source: string): boolean;
+export declare const rule: Rule;
+export declare const _internal: {
+    detectPerOutputControls: typeof detectPerOutputControls;
+    detectGlobalAiToggle: typeof detectGlobalAiToggle;
+    isAllowlisted: (repoRoot: string) => boolean;
+    DISABLE_DIRECTIVE: string;
+    ALLOWLIST_CANDIDATES: string[];
+    AI_MARKER_NAMES: ReadonlySet<string>;
+};

package/dist/rules/ai-governance-human-control-affordances.js

@@ -0,0 +1,228 @@
+import { join } from "node:path";
+import fg from "fast-glob";
+import { createLyseRule } from "./_rule-module.js";
+import { AI_MARKER_NAMES, safeReadText, extractNamesFromSource, COMPONENT_GLOB, SCAN_IGNORE, fileHasAiMarker, makeAllowlistCheck, } from "./ai-governance-ai-marker-component-present.js";
+const RULE_ID = "ai-governance/human-control-affordances";
+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);
+// ────────────────────────────────────────────────────────────────────────────
+// Group 1 — Per-output control affordances
+// ────────────────────────────────────────────────────────────────────────────
+const PER_OUTPUT_NAME_PATTERNS = [
+    "regenerate",
+    "retry",
+    "stopgenerat",
+    "editresponse",
+    "editoutput",
+    "undo",
+    "confirm",
+    "dismiss",
+    "accept",
+    "reject",
+];
+const PER_OUTPUT_LABELS = new Set([
+    "regenerate",
+    "retry",
+    "stop",
+    "stop generating",
+    "undo",
+    "confirm",
+    "dismiss",
+    "accept",
+    "reject",
+]);
+const BUTTON_OR_CTA_RE = /<(button|Button|a)\b[^>]*>/g;
+function isPerOutputName(name) {
+    const lower = name.toLowerCase();
+    return PER_OUTPUT_NAME_PATTERNS.some((p) => lower.includes(p));
+}
+function extractButtonLabels(source) {
+    const labels = [];
+    BUTTON_OR_CTA_RE.lastIndex = 0;
+    let m;
+    while ((m = BUTTON_OR_CTA_RE.exec(source)) !== null) {
+        const rest = source.slice(m.index + m[0].length);
+        const close = rest.search(/<\/\s*(button|Button|a)\s*>/);
+        const inner = (close === -1 ? rest : rest.slice(0, close))
+            .replace(/<[^>]*>/g, " ")
+            .trim()
+            .replace(/\s+/g, " ");
+        if (inner.length > 0 && inner.length < 80)
+            labels.push(inner);
+    }
+    return labels;
+}
+export function detectPerOutputControls(source) {
+    const hits = [];
+    for (const name of extractNamesFromSource(source)) {
+        if (isPerOutputName(name))
+            hits.push({ name });
+    }
+    for (const label of extractButtonLabels(source)) {
+        if (PER_OUTPUT_LABELS.has(label.toLowerCase()))
+            hits.push({ label });
+    }
+    return hits;
+}
+// ────────────────────────────────────────────────────────────────────────────
+// Group 2 — Global AI settings / disable toggle
+// ────────────────────────────────────────────────────────────────────────────
+const GLOBAL_NAME_PATTERNS = [
+    "aisettings",
+    "aipreferences",
+    "disableai",
+    "aicontrols",
+    "aiconfig",
+];
+const GLOBAL_LABEL_RE = /(?<![a-zA-Z-])label\s*=\s*["'`](Disable AI|AI features|AI settings|Enable AI|AI on|AI off)["'`]/i;
+function isGlobalAiToggleName(name) {
+    const lower = name.toLowerCase();
+    return GLOBAL_NAME_PATTERNS.some((p) => lower.includes(p));
+}
+export function detectGlobalAiToggle(source) {
+    for (const name of extractNamesFromSource(source)) {
+        if (isGlobalAiToggleName(name))
+            return true;
+    }
+    return GLOBAL_LABEL_RE.test(source);
+}
+// ────────────────────────────────────────────────────────────────────────────
+// evaluate
+// ────────────────────────────────────────────────────────────────────────────
+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,
+        });
+    }
+    catch {
+        // non-fatal
+    }
+    componentFiles.sort();
+    let seenMarker = false;
+    const allControlHits = [];
+    let hasGlobalToggle = false;
+    for (const rel of componentFiles) {
+        const abs = join(ctx.repoRoot, rel);
+        const source = safeReadText(abs);
+        if (!source)
+            continue;
+        const hasMarker = fileHasAiMarker(source, rel);
+        if (hasMarker) {
+            seenMarker = true;
+            const hits = detectPerOutputControls(source);
+            allControlHits.push(...hits);
+        }
+        if (detectGlobalAiToggle(source))
+            hasGlobalToggle = true;
+    }
+    if (!seenMarker) {
+        return { findings, opportunities: 0 };
+    }
+    const opportunities = componentFiles.length;
+    if (allControlHits.length > 0) {
+        const names = allControlHits
+            .map((h) => h.name ?? h.label ?? "")
+            .filter(Boolean);
+        const list = [...new Set(names)].join(", ");
+        const globalNote = hasGlobalToggle
+            ? "Global AI toggle: present."
+            : "Global AI toggle: not detected.";
+        findings.push({
+            ruleId: RULE_ID,
+            axis: "ai-governance",
+            severity: "info",
+            location: { file: "src/index.ts", line: 1, column: 1 },
+            message: `Per-output human-control affordances detected (HAX G8): ${list}. ${globalNote} (HAX G9)`,
+            suggestion: "Human-control affordances found — verify they are accessible and paired consistently with every AI-generated surface.",
+        });
+        return { findings, opportunities };
+    }
+    findings.push({
+        ruleId: RULE_ID,
+        axis: "ai-governance",
+        severity: "warning",
+        location: { file: "src/index.ts", line: 1, column: 1 },
+        message: "AI surface detected but no per-output control affordances found (HAX G8 / HAX G9). " +
+            "Ship Regenerate / Stop / Edit / Undo / Confirm / Dismiss / Accept / Reject controls " +
+            "so users can correct AI-generated output.",
+        suggestion: "Add per-output control components (e.g. RegenerateButton, StopGenerating, EditResponse, UndoAction, ConfirmOutput, DismissResult, AcceptSuggestion, RejectSuggestion) and a global AI settings/disable toggle (e.g. AISettings, AiPreferences, DisableAI).",
+    });
+    return { findings, opportunities };
+};
+export const rule = createLyseRule({
+    meta: {
+        axis: "ai-governance",
+        lyseRuleId: RULE_ID,
+        defaultSeverity: "warning",
+        shortDescription: "Detect human-control affordances over AI output",
+        fullDescription: "Scans component files (`**/*.{tsx,jsx,vue}`) for two groups of human-control affordances. " +
+            "Group 1 — per-output controls: exported component names or button labels matching the correction/dismissal vocabulary " +
+            "(Regenerate, Retry, Stop, Edit, Undo, Confirm, Dismiss, Accept, Reject). " +
+            "Group 2 — global AI toggle: exported names or toggle labels indicating a settings surface that lets users disable AI " +
+            "(AISettings, AiPreferences, DisableAI, or a label 'Disable AI' / 'AI features'). " +
+            "Cross-condition: when an AI-marker component is present (per the shared `isAiMarkerName` predicate) but no per-output control is found, emits `warning`; " +
+            "when controls are detected, emits `info` listing them and noting global toggle presence. " +
+            "Emits nothing when the DS has no AI surface. Guidelines: HAX G8 (efficient correction) / G9 (efficient dismissal).",
+        helpUri: "https://github.com/lyse-labs/lyse/blob/main/docs/rules/ai-governance-human-control-affordances.md",
+        rationale: `Why it matters
+
+HAX G8 (efficient correction) and G9 (efficient dismissal) are foundational human-AI interaction guidelines: users must be able to correct, stop, retry, or dismiss AI-generated output without friction. Without corresponding affordances in the design system, consuming teams implement ad-hoc controls that are inconsistent, inaccessible, and miss the correction loop entirely.
+
+This rule performs static detection: does the DS export components covering the standard correction/dismissal vocabulary? It does not verify usage site coverage (deferred to Track 4).
+
+A DS with no AI-marker component emits nothing and is not penalised.`,
+        examples: [
+            {
+                good: "// src/index.ts\nexport { AIBadge } from './ai-badge';\nexport { RegenerateButton } from './regenerate-button';\nexport { AISettings } from './ai-settings';",
+                bad: "// src/index.ts\nexport { AIBadge } from './ai-badge';\n// no correction or dismissal controls exported",
+            },
+            {
+                good: "// AIControls.tsx\nexport function RegenerateButton() { return <button>Regenerate</button>; }\nexport function DismissResult() { return <button>Dismiss</button>; }",
+                bad: "// No per-output control components; users have no standardised way to correct AI output",
+            },
+            {
+                good: "// AISettings.tsx\nexport function AISettings() {\n  return <Toggle label=\"Disable AI\" />;\n}",
+                bad: "// AI surface present but no global disable/settings toggle shipped",
+            },
+        ],
+        allowlist: [
+            "repos containing `lyse-disable ai-governance/human-control-affordances` in an adjacent README or `.lyse.yaml` — rule is N/A",
+            "repos with no AI-marker component at all — 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 = {
+    detectPerOutputControls,
+    detectGlobalAiToggle,
+    isAllowlisted,
+    DISABLE_DIRECTIVE,
+    ALLOWLIST_CANDIDATES,
+    AI_MARKER_NAMES,
+};
+//# sourceMappingURL=ai-governance-human-control-affordances.js.map

package/dist/rules/ai-governance-human-control-affordances.js.map

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

package/dist/rules/ai-governance-value-gate-doc-present.d.ts

@@ -0,0 +1,18 @@
+import type { Rule } from "../types.js";
+export declare function detectGateLanguage(content: string): boolean;
+interface GateDocResult {
+    rel: string;
+    hasGateLanguage: boolean;
+}
+export declare function discoverGateDoc(repoRoot: string): GateDocResult | null;
+export declare const rule: Rule;
+export declare const _internal: {
+    detectGateLanguage: typeof detectGateLanguage;
+    discoverGateDoc: typeof discoverGateDoc;
+    isAllowlisted: (repoRoot: string) => boolean;
+    DISABLE_DIRECTIVE: string;
+    ALLOWLIST_CANDIDATES: string[];
+    STATIC_CANDIDATES: string[];
+    DOC_GLOBS: string[];
+};
+export {};