@notis_ai/cli 0.2.0-beta.16.1 → 0.2.0-beta.161.1

package/bin/check-runtime.js

@@ -0,0 +1,15 @@
+// Keep this dependency-free: npm engines are advisory unless engine-strict is set.
+// Both installation and the public entry point check before loading dependencies.
+import { readFileSync } from 'node:fs';
+
+const { engines } = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+// This package declares one inclusive minimum, not a compound semver range.
+const minimum = engines.node.match(/^>=(\d+)\.(\d+)\.(\d+)$/);
+if (!minimum) throw new Error('CLI engines.node must declare one inclusive minimum version.');
+const required = minimum.slice(1).map(Number);
+const current = process.versions.node.split('.').map(Number);
+const difference = current.map((part, index) => part - required[index]).find((part) => part !== 0);
+if (difference < 0) {
+  process.stderr.write(`Notis CLI requires Node.js ${engines.node}; found ${process.versions.node}. Upgrade Node.js before running or installing the CLI.\n`);
+  process.exit(1);
+}

package/bin/notis.js

@@ -1,2 +1,4 @@
 #!/usr/bin/env node
+import './check-runtime.js';
+
 import('../src/cli.js').then(({ run }) => run());

package/config/notis_app_boundary_rules.json

@@ -0,0 +1,50 @@
+{
+  "javascript": [
+    {
+      "pattern": "window\\.__NOTIS_RUNTIME__",
+      "message": "window.__NOTIS_RUNTIME__ is forbidden; rely on the portal-injected NotisProvider runtime."
+    },
+    {
+      "pattern": "document\\.(?:body|head|documentElement)\\b",
+      "message": "document.body, document.head, and document.documentElement are forbidden; apps must stay inside the app surface."
+    },
+    {
+      "pattern": "document\\.(?:querySelector|querySelectorAll|getElementById|getElementsByClassName|getElementsByTagName)\\s*\\(\\s*(['\"`])[^\\n]*\\[data-notis-",
+      "message": "querying portal-owned [data-notis-*] hooks is forbidden."
+    },
+    {
+      "pattern": "createPortal\\s*\\(",
+      "message": "React portals are unsupported in Notis apps until a shadow-safe overlay contract exists."
+    },
+    {
+      "pattern": "@radix-ui/react-portal",
+      "message": "@radix-ui/react-portal is unsupported in Notis apps until a shadow-safe overlay contract exists."
+    },
+    {
+      "pattern": "PortalPrimitive",
+      "message": "Radix portal primitives are unsupported in Notis apps until a shadow-safe overlay contract exists."
+    }
+  ],
+  "css": [
+    {
+      "pattern": ":root\\b",
+      "message": ":root selectors are forbidden; styles must stay inside the app surface."
+    },
+    {
+      "pattern": "(^|[\\s,>+~])html(?=[\\s.#[:{>+~,]|$)",
+      "message": "html selectors are forbidden; styles must stay inside the app surface."
+    },
+    {
+      "pattern": "(^|[\\s,>+~])body(?=[\\s.#[:{>+~,]|$)",
+      "message": "body selectors are forbidden; styles must stay inside the app surface."
+    },
+    {
+      "pattern": "\\[data-notis-(?!app-root\\b)[^\\]]*\\]",
+      "message": "portal-owned [data-notis-*] selectors are forbidden. Use [data-notis-app-root] only for the app surface itself."
+    },
+    {
+      "pattern": "\\[data-sidebar(?:=[^\\]]+)?\\]",
+      "message": "portal sidebar selectors are forbidden."
+    }
+  ]
+}

package/config/notis_app_design_rules.json

@@ -0,0 +1,135 @@
+{
+  "version": 1,
+  "include": ["app/**", "components/**"],
+  "exclude": [
+    "components/ui/input.tsx",
+    "components/ui/textarea.tsx",
+    "components/ui/checkbox.tsx",
+    "components/ui/switch.tsx",
+    "components/ui/button.tsx"
+  ],
+  "extensions": [".js", ".jsx", ".ts", ".tsx", ".css"],
+  "allow_directive": "notis-design-allow",
+  "allow_reason_min_length": 12,
+  "rules": [
+    {
+      "id": "no-border-box",
+      "severity": "error",
+      "pattern": "(?<![\\w-])border(?![\\w-])|(?<![\\w-])border-(?:[xy]|\\d+)(?![\\w-])",
+      "message": "Four-side borders are banned. Use a flat Card (bg-muted / bg-background) or a single border-t / border-b hairline between sections.",
+      "exclude": ["components/ui/badge.tsx", "components/ui/card.tsx", "components/ui/native-select.tsx"]
+    },
+    {
+      "id": "no-side-bar",
+      "severity": "error",
+      "pattern": "\\bborder-[lr]-[248]\\b",
+      "message": "Thick left or right border bars are banned. Indicate selection with a background tint (bg-muted)."
+    },
+    {
+      "id": "no-dashed-box",
+      "severity": "error",
+      "pattern": "\\bborder-dashed\\b",
+      "message": "Dashed boxes are banned. Empty states are centered muted text with an optional primary button."
+    },
+    {
+      "id": "no-divide",
+      "severity": "error",
+      "pattern": "\\bdivide-[xy]\\b|<hr\\b",
+      "message": "Row dividers are banned. Use spacing, .list-row hover tint, or one hairline between sections."
+    },
+    {
+      "id": "no-ring-box",
+      "severity": "error",
+      "pattern": "(?<![\\w:-])ring-(?:1|2|4|inset)\\b",
+      "message": "Rings as a box or selection indicator are banned. Keep focus-visible:ring-2 on controls; use bg-muted for selection."
+    },
+    {
+      "id": "no-shadow",
+      "severity": "error",
+      "pattern": "\\bshadow-(?:sm|md|xl|2xl)\\b",
+      "message": "Shadows are banned on panels, cards, tiles, and bubbles. Only a floating popover or menu may use shadow-lg with bg-popover.",
+      "exclude": ["components/ui/popover.tsx", "components/ui/dropdown-menu.tsx", "components/ui/tooltip.tsx", "components/ui/select.tsx", "components/ui/dialog.tsx", "components/ui/sheet.tsx"]
+    },
+    {
+      "id": "no-floating-shadow-without-popover",
+      "severity": "error",
+      "pattern": "^(?!.*bg-popover).*\\bshadow-lg\\b",
+      "message": "shadow-lg is only allowed on a floating layer that also uses bg-popover.",
+      "exclude": ["components/ui/popover.tsx", "components/ui/dropdown-menu.tsx", "components/ui/tooltip.tsx", "components/ui/select.tsx", "components/ui/dialog.tsx", "components/ui/sheet.tsx"]
+    },
+    {
+      "id": "no-palette-hue",
+      "severity": "error",
+      "pattern": "\\b(?:bg|text|border|ring|from|via|to|fill|stroke|outline|decoration|accent|caret|divide|shadow|placeholder)-(?:red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose|slate|gray|zinc|neutral|stone)-\\d{2,3}\\b",
+      "message": "Hardcoded Tailwind palette colors are banned. Use tokens: text-foreground, text-muted-foreground, text-primary, bg-muted, bg-primary/10, text-destructive, bg-destructive/10."
+    },
+    {
+      "id": "no-hex-color",
+      "severity": "error",
+      "pattern": "#[0-9a-fA-F]{3}(?:[0-9a-fA-F]{3}(?:[0-9a-fA-F]{2})?)?(?![\\w-])",
+      "message": "Hex colors are banned. Use theme tokens (hsl(var(--primary)) with opacity steps for charts)."
+    },
+    {
+      "id": "no-gradient",
+      "severity": "error",
+      "pattern": "\\bbg-gradient-|linear-gradient\\(|radial-gradient\\(|conic-gradient\\(",
+      "message": "Gradients are banned."
+    },
+    {
+      "id": "no-backdrop-blur",
+      "severity": "error",
+      "pattern": "\\bbackdrop-blur",
+      "message": "Glassmorphism is banned."
+    },
+    {
+      "id": "no-eyebrow",
+      "severity": "error",
+      "pattern": "\\buppercase\\b[^\\n]{0,80}\\btracking-(?:wide|wider|widest|\\[)|\\btracking-(?:wide|wider|widest|\\[)[^\\n]{0,80}\\buppercase\\b",
+      "message": "Uppercase tracking eyebrows are banned. Use a plain noun page title and text-xs text-muted-foreground labels."
+    },
+    {
+      "id": "no-tiny-text",
+      "severity": "error",
+      "pattern": "\\btext-\\[(?:[0-9]|1[01])(?:\\.\\d+)?px\\]",
+      "message": "Text below 12px is banned. Use text-xs (12px) at minimum."
+    },
+    {
+      "id": "no-badge-outline",
+      "severity": "error",
+      "pattern": "<Badge\\b[^>]*variant=[\"']outline[\"']",
+      "message": "Badge variant=\"outline\" is banned. Use default, secondary, or destructive."
+    },
+    {
+      "id": "no-raw-select",
+      "severity": "error",
+      "pattern": "<select\\b",
+      "message": "Raw <select> is banned. Use NativeSelect from @/components/ui/native-select.",
+      "exclude": ["components/ui/native-select.tsx"]
+    },
+    {
+      "id": "no-search-input",
+      "severity": "error",
+      "pattern": "<input\\b[^>]*type=[\"']search[\"']|<[Ii]nput\\b[^>]*placeholder=[\"'][^\"']*\\b[Ss]earch",
+      "message": "In-app search inputs are banned. The portal owns search: wire useTopBarSearch from @notis/sdk."
+    },
+    {
+      "id": "no-font-serif",
+      "severity": "error",
+      "pattern": "\\bfont-serif\\b",
+      "message": "font-serif is banned. Apps use the portal font."
+    },
+    {
+      "id": "no-loading-placeholder",
+      "severity": "error",
+      "pattern": ">\\s*Loading(?:\\.{3}|…)?(?:\\s[^<]{0,40})?<|[\"'`]Loading(?:\\.{3}|…)",
+      "message": "Loading text is banned. Keep headings visible and render Skeleton / ViewSkeleton from @notis/sdk in the missing region only."
+    },
+    {
+      "id": "no-app-shell-split",
+      "severity": "error",
+      "scope": "file",
+      "pattern": "notis-app-shell[\\s\\S]*<aside\\b|<aside\\b[\\s\\S]*notis-app-shell",
+      "message": "A list-plus-detail page must be full-bleed. Replace notis-app-shell with notis-app-split and the notis-app-pane-list / notis-app-pane-detail panes."
+    }
+  ]
+}