@flood-md/agent 0.2.9 → 0.2.11

package/rules.json

@@ -2,6 +2,15 @@
   "schemaVersion": 1,
   "scope": "Installed Flood React/Next.js projects",
   "rules": [
+    {
+      "id": "motion.state",
+      "when": "Adding or changing animation or transitions",
+      "for": ["designer", "developer", "agent"],
+      "requires": ["Installed motion tokens", "Component state and focus contract"],
+      "sourceOfTruth": "references/flood-motion/SKILL.md",
+      "guide": "references/flood-motion/SKILL.md",
+      "verify": ["Reduced motion", "Keyboard and pointer behavior", "Interrupted or reversed transitions"]
+    },
     {
       "id": "api.installed",
       "when": "Importing or changing Flood APIs",
@@ -39,7 +48,9 @@
         "Intrinsic actions and responsive form parent",
         "Close choice label and independent group spacing",
         "Reuse shared atoms while preserving specialized native semantics",
-        "Container/grid/media geometry at320px and enlarged RTL text",
+        "Selected role owners and their installed contracts recorded before JSX",
+        "Actual date/selection popup checked against the selected component",
+        "Container/grid/media geometry at the host's declared viewport and text targets",
         "No invisible focusable content without reveal behavior"
       ]
     },
@@ -100,6 +111,7 @@
       "verify": [
         "Resolved scoped semantic values",
         "Text and non-text contrast",
+        "For tinted themes, compare closed fields and open floating layers on canvas and filled surfaces, including the opaque fallback",
         "No parallel raw palette"
       ]
     },
@@ -138,7 +150,9 @@
       "guide": "references/verification.md",
       "verify": [
         "Commands and actual results recorded",
+        "For a new task screen, exercise the accepted result and applicable recovery path, including retained user state and focus",
         "Manual checks distinguished",
+        "For visual layout changes, compare settled renders and state the reason for the chosen treatment",
         "Untested behavior stated"
       ]
     },
@@ -177,9 +191,11 @@
       "guide": "references/spacing.md",
       "verify": [
         "Measure visible gaps and row pitch, including padding and minimum height",
+        "Compare two rendered treatments at the same viewport and name which preserves the intended grouping and visible emphasis",
         "Check wrapping and enlarged text",
         "Check fine/coarse pointers and nonoverlapping interactive targets",
-        "Preserve keyboard focus and label activation"
+        "Preserve keyboard focus and label activation",
+        "Peer form grids sharing an outer frame use coherent tracks and gutters, or have an explicit contextual reason"
       ]
     },
     {
@@ -220,6 +236,9 @@
       "guide": "references/flood-foundations/SKILL.md",
       "verify": [
         "Trace changed roles to their actual consumers",
+        "Compare actions, fields, choice/selection, supporting elements and indicators on canvas/default/raised/modal/floating materials",
+        "Nearest nested material resets context; transparent wrappers and picker bodies inherit it",
+        "Opaque/reduced-transparency and forced-colors paths retain readable content and reachable focus",
         "Distinguish decoration, necessary boundaries, selection and accent focus",
         "Check explicit icon sizing, heading semantics, long text and enlarged root geometry"
       ]
@@ -281,7 +300,8 @@
       "verify": [
         "Inspect actual FormData and field ownership",
         "Exercise accepted/refused controlled updates and incomplete drafts",
-        "Defaults match representation; no defaultValue-as-update or invented save guarantee"
+        "Defaults match representation; no defaultValue-as-update or invented save guarantee",
+        "Verify submitted free text versus selected IDs and reject options belonging to an older manual query."
       ]
     },
     {
@@ -300,6 +320,7 @@
       "guide": "references/flood-forms/SKILL.md",
       "verify": [
         "Normal and prevented reset preserve documented ownership",
+        "A settings reset restores the last accepted values, including after a successful save",
         "Minute/second defaults match selected precision",
         "Advisory messages remain valid; native errors and disabled/read-only retain distinct semantics"
       ]
@@ -340,6 +361,7 @@
       "guide": "references/flood-overlays/SKILL.md",
       "verify": [
         "Check used sides, viewport edges, resize, long content and RTL",
+        "Select fits ordinary option labels even when the trigger is narrow, and stays within the viewport with long labels",
         "No drawer gap caused by page scrollbar gutter",
         "Header, footer and padding leave a useful body reading area at enlarged narrow sizes; fitting rectangles alone is insufficient",
         "Popup remains distinguishable with no rail-covered or clipped essential content"
@@ -362,7 +384,21 @@
       "verify": [
         "Native link behavior and current destination preserved",
         "Selection, focus and expansion remain distinct",
-        "Long labels and final sidebar items remain usable in actual supported orientations"
+        "Long labels and final sidebar items remain usable in actual supported orientations",
+        "Check sidebar width in both directions and with reduced motion; omit visible group titles that repeat context",
+        "Compare top header anchors across short/long routes and check focus when an action moves into overflow.",
+        "Global module, contextual page, disclosure and context visibility have separate owners",
+        "Modifier clicks preserve the current tab; location versus page current semantics are accurate",
+        "Validate complete route identity; invalid extra segments cannot produce unnamed destinations",
+        "Scoped filters/search do not leak between modules; disappearing focus has a stable fallback after row/pane/dialog removal",
+        "Collapsed hints appear on hover and keyboard focus without replacing native links or competing with an open flyout",
+        "Disclosure glyphs remain subordinate to destination icons while hit areas and shared trailing centers remain intact",
+        "Pane toggle artwork, accessible name and aria-expanded reflect the accepted visible state",
+        "Scrollbars use a deliberate edge budget without permanent unused document strips or shifting navigation tracks",
+        "NavigationItem is the shared row owner for NavigationList and NavigationTree; split selection spans both link and disclosure",
+        "Disclosure-only rows have one full-row button; link-plus-disclosure keeps separate native targets and independent accepted state",
+        "Configurable group headings, separators and collapse preserve accessible names and reachable compact destinations",
+        "Measure actual account/profile trigger centers with header and body in every compact profile, not only decorative glyph centers"
       ]
     },
     {
@@ -382,7 +418,8 @@
       "verify": [
         "Caption, headers and named-value relationships preserved",
         "Row actions remain independent named controls",
-        "File metadata/status/progress reuse their existing primitives"
+        "File metadata/status/progress reuse their existing primitives",
+        "Test one supplied server page without local slicing/sorting; declare and validate page/dataset selection scope."
       ]
     },
     {
@@ -422,7 +459,8 @@
       "verify": [
         "Pending/success/error/cancel/local state is truthful",
         "Unknown progress never fabricates a percentage",
-        "Empty content explains its cause and appropriate next action"
+        "Empty content explains its cause and appropriate next action",
+        "Distinguish missing, malformed and unreadable persistence; retain data/draft after refused writes and require explicit replacement."
       ]
     },
     {
@@ -505,6 +543,204 @@
         "Existing coverage distinguished from checks run for this revision",
         "Failures, source/host ownership and remaining limits recorded"
       ]
+    },
+    {
+      "id": "knowledge.versioned",
+      "when": "Discovering or extending Flood knowledge",
+      "for": [
+        "developer",
+        "agent"
+      ],
+      "requires": [
+        "Matching package/configuration/guide versions",
+        "Host instructions"
+      ],
+      "sourceOfTruth": "Installed catalog and selected canonical or customized material",
+      "guide": "references/knowledge.md",
+      "verify": [
+        "Read scope and version before selecting material",
+        "Finish selected instruction pages",
+        "Run growth and clean-consumer checks for source changes"
+      ]
+    },
+    {
+      "id": "content.necessary",
+      "when": "Introducing or editing visible interface copy and hierarchy",
+      "for": [
+        "designer",
+        "developer",
+        "agent"
+      ],
+      "requires": [
+        "User task and scope",
+        "Existing product vocabulary"
+      ],
+      "sourceOfTruth": "Actual user decisions and current interface context",
+      "guide": "references/flood-interface-content/SKILL.md",
+      "verify": [
+        "Changed copy has a necessary role or is removed",
+        "Titles, subtitles and hints do not repeat obvious context",
+        "Compare copy across the shell, list and opened record; keep a repeated fact only when it changes scope, action or comprehension in its location",
+        "Accessible names, needed constraints and recovery remain available",
+        "Each supporting sentence serves a specific decision or recovery need in the current state, not a hypothetical future risk",
+        "No standing implementation/storage caption merely because the data has a retention limitation",
+        "Prototype provenance stays in README/test handoff unless it changes a current record/choice/action; no automatic permanent environment badge",
+        "Review canonical previews and copied recipes: optional descriptions are absent unless they add a real distinction."
+      ]
+    },
+    {
+      "id": "content.accurate",
+      "when": "Writing state, export, storage or completion messages",
+      "for": [
+        "designer",
+        "developer",
+        "agent"
+      ],
+      "requires": [
+        "Actual operation and completed outcome"
+      ],
+      "sourceOfTruth": "Host behavior and confirmed product facts",
+      "guide": "references/flood-interface-content/SKILL.md",
+      "verify": [
+        "No invented capabilities, expert verification or delivery claims",
+        "Error explains the applicable failure and supported recovery",
+        "Technical details appear only when they affect a user decision"
+      ]
+    },
+    {
+      "id": "content.reference",
+      "when": "Adapting content from another product or reference",
+      "for": [
+        "designer",
+        "developer",
+        "agent"
+      ],
+      "requires": [
+        "Reference purpose",
+        "Host objects, actions and states"
+      ],
+      "sourceOfTruth": "Host capability and user vocabulary",
+      "guide": "references/flood-interface-content/SKILL.md",
+      "verify": [
+        "Reference pattern is mapped to the host question it answers",
+        "Competitor workflows, promises and marketing language are not transplanted without matching behavior"
+      ]
+    },
+    {
+      "id": "layout.hierarchy",
+      "when": "Composing or reviewing task titles, group legends, named fields and shared form tracks",
+      "for": [
+        "designer",
+        "developer",
+        "agent",
+        "reviewer"
+      ],
+      "requires": [
+        "Installed component and token contracts",
+        "Task reading order and actual rendered host"
+      ],
+      "sourceOfTruth": "Installed hierarchy recipes and host content requirements",
+      "guide": "references/flood-hierarchy/SKILL.md",
+      "verify": [
+        "Task, group and field roles are distinguishable without redundant headings",
+        "Labels and controls read as groups after accounting for line height, fill and adjacent boundaries",
+        "Related rows share measured control edges; width exceptions have a content reason",
+        "Dialog title/body inset is owned once; actions remain reachable at enlarged text",
+        "Calendar content remains readable inside viewport collision limits"
+      ]
+    },
+    {
+      "id": "records.scan",
+      "when": "Composing record lists, detail views or several row metadata values",
+      "for": [
+        "designer",
+        "developer",
+        "agent",
+        "reviewer"
+      ],
+      "requires": [
+        "Current recognition/comparison/action task",
+        "Installed record component contracts",
+        "Rendered sibling records with varied content"
+      ],
+      "sourceOfTruth": "Task information needs and installed record contracts",
+      "guide": "references/flood-records/SKILL.md",
+      "verify": [
+        "Field to decision and list/detail placement choices recorded outside UI",
+        "Identity and summary remain readable with long and missing metadata",
+        "Stable scan positions or real named comparison columns, not drifting pseudo-columns",
+        "List, details, first-use and filtered empty states reviewed separately",
+        "A short mutually exclusive filter for one table uses a selection control; verify keyboard selection, surviving search/sort and focused control",
+        "Record edits preserve applied filters and list position; focus returns to the opener or a surviving list control",
+        "For a row opening in-place details, compare title-to-metadata rhythm and the shared table edge; exercise row activation, keyboard entry and independent nested controls"
+      ]
+    },
+    {
+      "id": "records.meaning",
+      "when": "Presenting category, lifecycle status, priority, timestamps or collection counts",
+      "for": [
+        "designer",
+        "developer",
+        "agent",
+        "reviewer"
+      ],
+      "requires": [
+        "Actual field semantics and current user decision"
+      ],
+      "sourceOfTruth": "Host data meanings and corresponding Flood primitive contract",
+      "guide": "references/flood-records/SKILL.md",
+      "verify": [
+        "Category/state/urgency distinguished with names where needed, not color alone",
+        "Essential triage/comparison fields retained; optional attributes do not compete equally",
+        "Dates identify useful events with suitable precision; formatted equality is not event equality",
+        "Compare filter and footer count scope before keeping both; show missing evidence where it changes a decision",
+        "Necessary announcements remain"
+      ]
+    },
+    {
+      "id": "composition.family",
+      "when": "Adding a reusable component or changing its visual contract",
+      "for": [
+        "designer",
+        "developer",
+        "agent",
+        "reviewer"
+      ],
+      "requires": [
+        "Closest existing component contracts",
+        "Actual host interaction requirements"
+      ],
+      "sourceOfTruth": "Matching source/installed declarations and semantic tokens",
+      "guide": "references/component-families.md",
+      "verify": [
+        "Closest siblings rendered at the same size, surface and root text scale",
+        "Shape, nested inset and content-box overflow budget checked together",
+        "Read-only editing restrictions kept separate from focus and disabled semantics",
+        "Another consumer checked after a shared primitive correction"
+      ]
+    },
+    {
+      "id": "spacing.shared-tracks",
+      "when": "Composing repeated navigation or record rows with headers, groups or fixed footers",
+      "for": [
+        "designer",
+        "developer",
+        "agent",
+        "reviewer"
+      ],
+      "requires": [
+        "Rendered role anatomy",
+        "Declared leading/text/trailing tracks and nested-indent rule"
+      ],
+      "sourceOfTruth": "Shared rendered content tracks, including scroll gutter budget",
+      "guide": "references/flood-spacing/SKILL.md",
+      "verify": [
+        "Measure glyph centers and text starts across header, peer rows, groups and footer",
+        "Compare badge and disclosure centers; reserve missing peer icon slots",
+        "Check tracks with and without overflow, nested rows, RTL and enlarged text",
+        "Repair the owning component/shared grid rather than applying per-item offsets",
+        "Compare outer start/end clearance in expanded and compact states; internally aligned content must not drift to one edge"
+      ]
     }
   ],
   "guideResolution": "Match guide to source in manifest.files; use its target relative to the host project root."

package/workflows.json

@@ -2,15 +2,176 @@
   "schemaVersion": 1,
   "scope": "Task routing for the existing Flood dark base; applicability is not test evidence",
   "workflows": [
-    { "id": "composition", "guide": "references/flood-composition/SKILL.md", "all": true },
-    { "id": "spacing", "guide": "references/flood-spacing/SKILL.md", "all": true },
-    { "id": "foundations", "guide": "references/flood-foundations/SKILL.md", "all": true },
-    { "id": "accessibility", "guide": "references/flood-accessibility/SKILL.md", "all": true },
-    { "id": "forms", "guide": "references/flood-forms/SKILL.md", "groups": ["forms"], "components": ["Button", "Label", "Fieldset", "ErrorSummary"] },
-    { "id": "overlays", "guide": "references/flood-overlays/SKILL.md", "groups": ["overlays"], "components": ["Select", "Combobox", "MultiSelect", "TreeSelect", "DatePicker", "DateRangePicker", "TimePicker", "DateTimePicker", "DateTimeRangePicker"] },
-    { "id": "navigation", "guide": "references/flood-navigation/SKILL.md", "groups": ["navigation"], "components": ["Tree", "TreeSelect", "Toolbar", "CommandList", "ListBox", "ToggleGroup", "SegmentedControl", "Accordion", "Collapsible"] },
-    { "id": "data-display", "guide": "references/flood-data-display/SKILL.md", "groups": ["content"], "components": ["UploadItem", "UploadList", "EmptyState", "ScrollArea"] },
-    { "id": "feedback", "guide": "references/flood-feedback/SKILL.md", "groups": ["feedback"], "components": ["Field", "Fieldset", "Input", "Textarea", "Select", "ListBox", "CopyButton", "Badge", "UploadItem", "UploadList"] },
-    { "id": "verification", "guide": "references/flood-verification/SKILL.md", "all": true }
+    {
+      "id": "motion",
+      "guide": "references/flood-motion/SKILL.md",
+      "all": true
+    },
+    {
+      "id": "composition",
+      "guide": "references/flood-composition/SKILL.md",
+      "all": true
+    },
+    {
+      "id": "interface-content",
+      "guide": "references/flood-interface-content/SKILL.md",
+      "all": true
+    },
+    {
+      "id": "hierarchy",
+      "guide": "references/flood-hierarchy/SKILL.md",
+      "groups": [
+        "forms",
+        "overlays",
+        "layout",
+        "typography"
+      ],
+      "components": [
+        "Card",
+        "PageHeader",
+        "Section",
+        "EmptyState"
+      ]
+    },
+    {
+      "id": "spacing",
+      "guide": "references/flood-spacing/SKILL.md",
+      "all": true
+    },
+    {
+      "id": "foundations",
+      "guide": "references/flood-foundations/SKILL.md",
+      "all": true
+    },
+    {
+      "id": "accessibility",
+      "guide": "references/flood-accessibility/SKILL.md",
+      "all": true
+    },
+    {
+      "id": "forms",
+      "guide": "references/flood-forms/SKILL.md",
+      "groups": [
+        "forms"
+      ],
+      "components": [
+        "Button",
+        "Label",
+        "Fieldset",
+        "ErrorSummary",
+        "CollectionToolbar",
+        "CollectionViewSwitcher"
+      ]
+    },
+    {
+      "id": "overlays",
+      "guide": "references/flood-overlays/SKILL.md",
+      "groups": [
+        "overlays"
+      ],
+      "components": [
+        "Select",
+        "Combobox",
+        "MultiSelect",
+        "FilterCondition",
+        "FilterGroup",
+        "TreeSelect",
+        "DatePicker",
+        "DateRangePicker",
+        "TimePicker",
+        "DateTimePicker",
+        "DateTimeRangePicker",
+        "CollectionToolbar",
+        "CollectionViewSwitcher",
+        "Sidebar"
+      ]
+    },
+    {
+      "id": "navigation",
+      "guide": "references/flood-navigation/SKILL.md",
+      "groups": [
+        "navigation"
+      ],
+      "components": [
+        "Tree",
+        "TreeSelect",
+        "Toolbar",
+        "CommandList",
+        "ListBox",
+        "ToggleGroup",
+        "SegmentedControl",
+        "Accordion",
+        "Collapsible",
+        "CollectionViewSwitcher",
+        "NavigationItem",
+        "NavigationGroup",
+        "NavigationTree",
+        "NavigationList",
+        "AppShell",
+        "AppTopBar",
+        "Sidebar"
+      ]
+    },
+    {
+      "id": "data-display",
+      "guide": "references/flood-data-display/SKILL.md",
+      "groups": [
+        "content"
+      ],
+      "components": [
+        "FilterCondition",
+        "FilterGroup",
+        "UploadItem",
+        "UploadList",
+        "EmptyState",
+        "ScrollArea"
+      ]
+    },
+    {
+      "id": "records",
+      "guide": "references/flood-records/SKILL.md",
+      "components": [
+        "DataList",
+        "DataListItem",
+        "Table",
+        "DataTable",
+        "SegmentedControl",
+        "CollectionToolbar",
+        "DescriptionList",
+        "Card",
+        "Section",
+        "StatusIndicator",
+        "Badge",
+        "FileItem",
+        "FileList",
+        "UploadItem",
+        "UploadList",
+        "EmptyState"
+      ]
+    },
+    {
+      "id": "feedback",
+      "guide": "references/flood-feedback/SKILL.md",
+      "groups": [
+        "feedback"
+      ],
+      "components": [
+        "Field",
+        "Fieldset",
+        "Input",
+        "Textarea",
+        "Select",
+        "ListBox",
+        "CopyButton",
+        "Badge",
+        "UploadItem",
+        "UploadList"
+      ]
+    },
+    {
+      "id": "verification",
+      "guide": "references/flood-verification/SKILL.md",
+      "all": true
+    }
   ]
 }