peer-ai-standards 1.0.0-next.13 → 1.0.0-next.15

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # peer-ai-standards
 
+## 1.0.0-next.15
+
+### Minor Changes
+
+- f217df4: Two new rules (RFC 0019, for #202):
+  
+  - **REACT-11: a hook is called by its own name, never passed around as a value.** It's enforced by ESLint's `react-hooks/hooks`, which `peer-ai-eslint-config` turns on for React, React Native and Next.js parts, and catches a hook passed as an argument. `code-review` reads for what the tool can't see: a hook renamed, passed as a prop, or kept in an object. Under the React Compiler, each breaks the component on a later render.
+  - **TEST-12: tests run the code the build ships,** with the same compiler, transforms and flags, such as the React Compiler. Where a test runner can't, an end-to-end check of the built app covers the difference. `test-strategy` checks it for the project, `code-review` for a change to the build or test settings, and `qa-acceptance` for an item that adds a compiler or transform.
+  
+  `code-review` also gains a guide for CODE-16, the framework's own rules: a tool's check counts as evidence only when it runs for the file.
+
+### Patch Changes
+
+- Updated dependencies [2a0e5e1]
+  - peer-ai-workflow@1.0.0-next.15
+
+## 1.0.0-next.14
+
+### Patch Changes
+
+- peer-ai-workflow@1.0.0-next.14
+
 ## 1.0.0-next.13
 
 ### Patch Changes

package/dist/core/testing.d.ts

@@ -48,4 +48,14 @@ export declare const testing: ({
     stage: "production";
     check: "ai-review";
     severity: "medium";
+} | {
+    id: string;
+    domain: "testing";
+    title: string;
+    rule: string;
+    why: string;
+    ask: string;
+    stage: "mvp";
+    check: "ai-review";
+    severity: "high";
 })[];

package/dist/core/testing.js

@@ -121,4 +121,15 @@ export const testing = [
         check: "ai-review",
         severity: "medium",
     },
+    {
+        id: "TEST-12",
+        domain: "testing",
+        title: "Tests run the code the build ships",
+        rule: "Unit and component tests run the code through the same compiler, transforms and flags as the build that ships, such as the React Compiler or a Babel plugin. Where a test runner can't, an end-to-end check of the built app covers the difference, and the test strategy says so.",
+        why: "Tests that run different code from the shipped build pass while the product breaks. A compiler that changes how code runs, such as one that memoises, is exactly where they differ.",
+        ask: "Does the test setup apply every compiler and transform the build does?",
+        stage: "mvp",
+        check: "ai-review",
+        severity: "high",
+    },
 ];

package/dist/profiles/react.js

@@ -176,5 +176,22 @@ export const react = {
             severity: "medium",
             carries: "PERF-06",
         },
+        {
+            id: "REACT-11",
+            title: "A hook is called by its own name, never passed around as a value",
+            rule: "A hook is called directly, by a name that starts with use. It's never passed as an argument or a prop, stored in a variable or an object, or called through another name.",
+            why: "React, and the React Compiler, know a hook by its name. A hook called through another name may be memoised or skipped, which shifts the order of hooks and breaks the component on a later render.",
+            ask: "Is any hook in this change passed, stored or called by a name that doesn't start with use?",
+            stage: "prototype",
+            check: "auto",
+            severity: "high",
+            carries: "CODE-16",
+            enforcer: { tool: "eslint", rule: "react-hooks/hooks" },
+            examples: {
+                file: "example.tsx",
+                fails: 'import { useState } from "react";\nfunction useBay(): string {\n  const [bay] = useState("Bay 1");\n  return bay;\n}\nfunction useLatest(read: () => string): string {\n  return read();\n}\nexport function Booking() {\n  const bay = useLatest(useBay);\n  return <p>{bay}</p>;\n}\n',
+                passes: 'import { useState } from "react";\nfunction useBay(): string {\n  const [bay] = useState("Bay 1");\n  return bay;\n}\nexport function Booking() {\n  const bay = useBay();\n  return <p>{bay}</p>;\n}\n',
+            },
+        },
     ],
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "peer-ai-standards",
-  "version": "1.0.0-next.13",
+  "version": "1.0.0-next.15",
   "description": "Peer AI's engineering standards: 197 rules for every project, and stack profiles with the tools that enforce them",
   "license": "MIT",
   "type": "module",
@@ -11,7 +11,7 @@
     }
   },
   "dependencies": {
-    "peer-ai-workflow": "1.0.0-next.13",
+    "peer-ai-workflow": "1.0.0-next.15",
     "zod": "4.6.5"
   },
   "engines": {