@notis_ai/cli 0.2.18 → 0.2.20

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_design_rules.json

@@ -0,0 +1,320 @@
+{
+  "version": 1,
+  "include": ["app/**", "components/**", "spaces/**"],
+  "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,
+  "profiles": {
+    "space": {
+      "description": "Every file a Space view can draw from. Used by notis spaces build/verify/preview/deploy and by the server on source-verify, source-stage and source-publish. Rules without a profiles field run in every profile; rules with profiles run only in the listed ones. A rule's profile_messages.<profile> replaces its message in that profile. Comments are blanked before matching.",
+      "include": ["app/**", "components/**", "hooks/**", "lib/**", "spaces/**", "src/**", "views/**"],
+      "exclude": ["**/*.test.*", "**/*.spec.*", "**/__tests__/**", "**/fixtures/**"]
+    }
+  },
+  "toolkit_live_pieces": [],
+  "toolkit_note": "Rules with a toolkit_piece point at a hand-rolled pattern the live Notis toolkit replaces. They stay warnings until that piece name is added to toolkit_live_pieces, then they refuse like any error.",
+  "rules": [
+    {
+      "id": "no-border-box",
+      "severity": "error",
+      "pattern": "(?<![\\w-])border(?![\\w-])(?!\\s*:\\s*(?:0(?:px)?|none)\\s*(?:!important\\s*)?(?:[;}]))|(?<![\\w-])border-(?:[xy]|\\d+)(?![\\w-])",
+      "message": "Four-side borders are banned. Use a flat tint (bg-muted / bg-background) or a single border-t / border-b hairline between sections.",
+      "exclude": ["components/ui/badge.tsx", "components/ui/native-select.tsx"]
+    },
+    {
+      "id": "no-side-bar",
+      "severity": "error",
+      "pattern": "(?<![\\w-])border-[lrtbse]-(?:[2-8](?![\\w.-])|\\[|(?:primary|destructive|foreground|muted-foreground|ring|accent|current)(?![\\w-]))|\\bshadow-\\[[^\\]\\s]*inset_(?:-?(?:[1-9]|0?\\.\\d*[1-9])|0(?:px)?_-?(?:[2-9]|[1-9]\\d))|(?:box-shadow|boxShadow)\\s*:[^;{}]*\\binset\\s+(?:-?(?:[1-9]|0?\\.\\d*[1-9])|0(?:px)?\\s+-?(?:[2-9]|[1-9]\\d))|(?<![\\w-])border-(?:left|right|top|bottom|inline-start|inline-end|block-start|block-end)(?:\\s*:(?!\\s*(?:(?:0(?:px)?|none)\\b|1px\\s+solid\\s+(?:transparent\\b|(?:hsl\\()?var\\(--[\\w-]*border)))|-width\\s*:(?!\\s*(?:0(?:px)?|1px)\\b)|-color\\s*:(?!\\s*(?:transparent\\b|(?:hsl\\()?var\\(--[\\w-]*border)))|\\bborder(?:Left|Right|Top|Bottom|InlineStart|InlineEnd|BlockStart|BlockEnd)\\s*:\\s*['\\\"`](?!(?:(?:0(?:px)?|none)\\b|1px\\s+solid\\s+(?:transparent\\b|(?:hsl\\()?var\\(--[\\w-]*border)))",
+      "message": "One-side edges are banned: no thicker or coloured border and no inset shadow on a single side. Mark a selection or highlight with a background tint (bg-muted) or a 1px ring on all four sides."
+    },
+    {
+      "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, the Row hover from @notis/sdk/ui, or one hairline between sections.",
+      "profile_messages": {
+        "space": "Row dividers are banned. Use Row from @notis/sdk/ui (its spacing and hover tint separate items) 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.",
+      "profile_messages": {
+        "space": "Uppercase tracking eyebrows are banned. Use text-xs text-muted-foreground labels; the top bar crumb names the page."
+      }
+    },
+    {
+      "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.",
+      "profile_messages": {
+        "space": "In-page search inputs are banned. Give ListReader a search prop from @notis/sdk/ui: the top bar owns the search field."
+      }
+    },
+    {
+      "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.",
+      "profile_messages": {
+        "space": "Loading text is banned. Keep headings visible and render Skeleton from @notis/sdk/ui in the missing region only."
+      }
+    },
+    {
+      "id": "no-app-shell-split",
+      "severity": "error",
+      "profiles": ["app"],
+      "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: no padded page with an aside. Lay it out with notis-app-split and the notis-app-pane-list / notis-app-pane-detail panes."
+    },
+    {
+      "id": "no-page-heading",
+      "severity": "error",
+      "profiles": ["space"],
+      "pattern": "\\bPageHeading\\b|(?<![\\w-])nui-heading(?:-[\\w-]+)?(?![\\w-])|\\bimport\\s+(?:type\\s+)?\\{[^}]*\\bCard\\b[^}]*\\}\\s*from\\b|<Card(?![\\w.])|['\\\"`]@/components/ui/card['\\\"`]",
+      "message": "Spaces have no in-page title or card: the top bar shows the Space and the open record. Remove PageHeading and Card; give ListReader a title and lay blocks out with Section from @notis/sdk/ui."
+    },
+    {
+      "id": "no-space-h1",
+      "severity": "error",
+      "profiles": ["space"],
+      "pattern": "<h1(?![\\w-])|\\bcreateElement\\(\\s*['\\\"`]h1['\\\"`]",
+      "message": "A Space never draws an h1: the top bar holds the title. Blocks inside the page take a Section title (an h2) from @notis/sdk/ui."
+    },
+    {
+      "id": "no-centered-column",
+      "severity": "error",
+      "profiles": ["space"],
+      "pattern": "(?<![\\w-])mx-auto(?![\\w-])[^\\n\\\"'`]*(?<![\\w-])(?:max-w-|container(?![\\w-]))|(?<![\\w-])(?:max-w-[\\w\\[\\]./-]+|container)(?![\\w-])[^\\n\\\"'`]*(?<![\\w-])mx-auto(?![\\w-])|(?:max-width|maxWidth)\\s*:[^{}]*\\bmargin(?:-inline|Inline)?\\s*:\\s*['\\\"`]?(?:0(?:px)?\\s+)?auto\\b|\\bmargin(?:-inline|Inline)?\\s*:\\s*['\\\"`]?(?:0(?:px)?\\s+)?auto\\b[^{}]*(?:max-width|maxWidth)\\s*:",
+      "message": "Spaces fill their pane edge to edge. Drop the centred column (mx-auto with max-w or container, or max-width with margin auto): Section from @notis/sdk/ui keeps the 24px inset and form fields cap their own width."
+    },
+    {
+      "id": "no-app-shell",
+      "severity": "error",
+      "profiles": ["space"],
+      "pattern": "(?<![\\w-])notis-app-(?:shell|surface)(?![\\w-])|(?<![\\w-])list-row(?![\\w-])",
+      "message": "notis-app-shell, notis-app-surface and list-row are gone. Use ListReader, Section and Row from @notis/sdk/ui: they own the page frame, its padding and the row hover."
+    },
+    {
+      "id": "no-root-shortcut-provider",
+      "severity": "error",
+      "profiles": ["space"],
+      "scope": "file",
+      "pattern": "\\bimport\\s+(?:type\\s+)?\\{[^}]*\\bShortcutProvider\\b[^}]*\\}\\s*from\\s*['\\\"`]@notis/sdk['\\\"`]",
+      "message": "@notis/sdk no longer exports ShortcutProvider: NotisProvider already mounts it for every Space. Drop the import and the wrapper; register keys with useShortcuts from @notis/sdk/interactions."
+    },
+    {
+      "id": "no-own-search",
+      "severity": "error",
+      "profiles": ["space"],
+      "pattern": "\\buseTopBarSearch\\s*\\(|\\btype=\\{?\\s*['\\\"`]search['\\\"`]",
+      "message": "A Space never wires its own search. Give ListReader a search prop from @notis/sdk/ui: the top bar shows the field and the reader filters its list."
+    },
+    {
+      "id": "no-removed-listreader-props",
+      "severity": "error",
+      "profiles": ["space"],
+      "pattern": "<ListReader(?![\\w.])(?:<[^<>]*>)?(?:[^{}>]|\\{(?:[^{}]|\\{(?:[^{}]|\\{[^{}]*\\})*\\})*\\})*?\\s(?:(?:toolbar|header|fill)\\s*=|divided(?![\\w-])|fill(?=[\\s/>]))",
+      "message": "ListReader no longer takes toolbar, header, divided or fill. Put the bar in title, tabs, create, viewMenu, infoLine and search; the reader always fills its pane and Row owns the spacing."
+    },
+    {
+      "id": "tiles-galleries-only",
+      "severity": "warn",
+      "profiles": ["space"],
+      "pattern": "\\blayout\\s*=\\s*\\{?\\s*['\\\"`]tiles['\\\"`]|\\brenderTile\\b",
+      "message": "Tiles are for galleries only (competitors, integrations, discovering skills). Every other collection is a ListReader list: drop layout tiles and renderTile unless this view is a gallery."
+    },
+    {
+      "id": "space-no-global-key-listener",
+      "severity": "error",
+      "profiles": ["space"],
+      "pattern": "\\b(?:window|document|globalThis|self)\\s*\\.\\s*(?:addEventListener\\s*\\(\\s*['\"`](?:keydown|keyup|keypress)['\"`]|onkey(?:down|up|press)\\s*=)",
+      "message": "Spaces never listen for keys on window or document: the host runs one keyboard engine for every pane. Use useShortcut or useListKeys from @notis/sdk/ui, or onKeyDown on the focused element."
+    },
+    {
+      "id": "space-no-viewport-height",
+      "severity": "error",
+      "profiles": ["space"],
+      "pattern": "(?<![\\w-])(?:min-|max-)?h-(?:screen|dvh|svh|lvh)\\b|(?<![\\w.-])\\d+(?:\\.\\d+)?[dsl]?vh\\b",
+      "message": "The host gives every Space its full height. Use h-full, flex-1 and min-h-0 instead of screen or vh heights, which overflow the host frame and the phone layout."
+    },
+    {
+      "id": "space-no-raw-color",
+      "severity": "error",
+      "profiles": ["space"],
+      "pattern": "\\b(?:rgba?|hsla?|hwb|oklch|oklab|lab|lch)\\(\\s*(?!var\\(|from\\b)[\\d.]|(?<![\\w-])(?:bg|text|border|fill|stroke|ring|outline|decoration|from|via|to|caret|accent|placeholder|divide)-(?:white|black)\\b",
+      "message": "Colours come from theme tokens so light and dark both work: hsl(var(--primary)), text-foreground, bg-background, text-primary-foreground. Literal rgb/hsl/oklch values and white/black utilities are banned."
+    },
+    {
+      "id": "space-no-body-portal",
+      "severity": "error",
+      "profiles": ["space"],
+      "pattern": "\\bcreatePortal\\s*\\(|\\bdocument\\.body\\b|<(?:[A-Z]\\w*\\.)?Portal\\b",
+      "message": "Spaces render inside a Shadow root. A menu or popover portalled to document.body loses the Space's styles, theme and keyboard. Use Menu or Popover from @notis/sdk/ui or render the layer inline."
+    },
+    {
+      "id": "space-no-english-literal",
+      "severity": "error",
+      "profiles": ["space"],
+      "include": ["**/*.tsx", "**/*.jsx"],
+      "pattern": "(?:^[ \\t]*|(?<![\\s=]))>[ \\t]*(?=[^<>{}\\n]*[A-Za-z]{2})[A-Za-z][^<>{}\\n=;()&|]*(?:</|\\{)|\\b(?:placeholder|title|aria-label|alt|label)=[\"'](?=[^\"'{}\\n]*[A-Za-z]{2})[^\"'{}\\n]*[\"']",
+      "message": "A Space keeps its visible words in its words table (or uses a toolkit piece that owns its words) and renders them from there, never as a literal in JSX."
+    },
+    {
+      "id": "space-no-private-path",
+      "severity": "error",
+      "profiles": ["space"],
+      "pattern": "['\"`](?:/Users/|/home/[\\w.-]+/|/private/|/var/folders/|~/|file:/)|['\"`/]\\.(?:notis|context)/|['\"`/]\\.env(?:\\.[\\w-]+)?['\"`]",
+      "message": "A Space never names a private path (a home folder, .notis, .context or .env). Everything it needs ships with its source or comes from its declared resources."
+    },
+    {
+      "id": "space-no-outside-import",
+      "severity": "error",
+      "profiles": ["space"],
+      "pattern": "(?:\\bfrom\\s*|\\bimport\\s*\\(\\s*|\\brequire\\s*\\(\\s*|^\\s*import\\s+)['\"`](?:/|[A-Za-z]:[\\\\/]|node:|@notis/sdk/(?:src|dist|internal|lib)\\b|(?:\\.\\.?/)+packages/sdk/)",
+      "message": "Import only from this Space's own files and the public @notis/sdk entry points. Absolute paths, node: modules and toolkit internals break in the host."
+    },
+    {
+      "id": "toolkit-list-reader",
+      "severity": "warn",
+      "profiles": ["space"],
+      "toolkit_piece": "ListReader",
+      "pattern": "\\bnotis-app-(?:split|pane-list|pane-detail)\\b",
+      "message": "A hand-made list plus detail split. Use ListReader from @notis/sdk/ui: it owns the split, the one-pane rule next to chat and the phone layout."
+    },
+    {
+      "id": "toolkit-list-keys",
+      "severity": "warn",
+      "profiles": ["space"],
+      "toolkit_piece": "useListKeys",
+      "pattern": "['\"`]Arrow(?:Up|Down)['\"`]|\\.key\\s*===?\\s*['\"`][jkJK]['\"`]",
+      "message": "Hand-made up/down or J/K list movement. Use ListReader or useListKeys from @notis/sdk/ui so keys match the Manager (J wraps)."
+    },
+    {
+      "id": "toolkit-shortcut",
+      "severity": "warn",
+      "profiles": ["space"],
+      "toolkit_piece": "useShortcut",
+      "pattern": "\\.key\\s*===?\\s*['\"`](?![jkJK]['\"`])[a-zA-Z?/]['\"`]",
+      "message": "A hand-made letter shortcut. Use useShortcut from @notis/sdk/ui so it shows in the ? sheet and never clashes with the host's keys."
+    },
+    {
+      "id": "toolkit-selection-bar",
+      "severity": "warn",
+      "profiles": ["space"],
+      "toolkit_piece": "SelectionBar",
+      "pattern": "\\bMultiSelect(?:ActionBar|Checkbox|DragOverlay)\\b|\\buseMultiSelect\\b",
+      "message": "Old multi-select pieces. Use SelectionBar and useSelection from @notis/sdk/ui: they own the checkboxes, the bar, its standard actions and their EN/FR words."
+    },
+    {
+      "id": "toolkit-keycap",
+      "severity": "warn",
+      "profiles": ["space"],
+      "toolkit_piece": "Keycap",
+      "pattern": "<kbd\\b|\\bShortcutHints?\\b",
+      "message": "Hand-made key hints. Use Keycap from @notis/sdk/ui; the ? sheet lists every shortcut for free."
+    },
+    {
+      "id": "toolkit-menu",
+      "severity": "warn",
+      "profiles": ["space"],
+      "toolkit_piece": "Menu",
+      "pattern": "@radix-ui/react-(?:dropdown-menu|popover|context-menu|menubar)|\\brole=[\"']menu[\"']|\\bDropdownMenu\\b",
+      "message": "A hand-made menu or popover. Use Menu or Popover from @notis/sdk/ui: it opens inside the Shadow root with the host's keys and looks."
+    },
+    {
+      "id": "toolkit-open-as",
+      "severity": "warn",
+      "profiles": ["space"],
+      "toolkit_piece": "OpenAs",
+      "pattern": "\\bfixed\\b[^\\n\"'`]{0,80}\\binset-(?:0|x-0|y-0)\\b|\\binset-(?:0|x-0|y-0)\\b[^\\n\"'`]{0,80}\\bfixed\\b|position\\s*:\\s*fixed\\b",
+      "message": "A hand-made overlay or side panel. Open the item as Side, Center or Full through ListReader's openAs or OpenAsMenu from @notis/sdk/ui; a Space does not build its own reader frame."
+    }
+  ]
+}

package/config/portal-route-roots.json

@@ -0,0 +1,45 @@
+[
+  "api",
+  "apps",
+  "auth",
+  "authorized-agents",
+  "automations",
+  "billing",
+  "channels",
+  "chat",
+  "cli-connected",
+  "cli-setup",
+  "desktop-quick-login",
+  "documents",
+  "email-verified",
+  "install",
+  "integrations",
+  "invalid-access",
+  "login",
+  "manage",
+  "mcp-oauth-callback",
+  "memories",
+  "oauth",
+  "oauth-complete",
+  "overlay",
+  "pricing",
+  "referrals",
+  "reminders",
+  "sandbox-preview",
+  "settings",
+  "share",
+  "signup",
+  "skills",
+  "spaces",
+  "start",
+  "store",
+  "subscribe",
+  "team",
+  "transcript",
+  "typography-demo",
+  "usage",
+  "usage-menu-bar",
+  "view",
+  "voice-notch",
+  "wrapped"
+]