@notis_ai/cli 0.2.0-beta.156.1 → 0.2.0-beta.158.1

package/README.md

@@ -186,45 +186,12 @@ Create a new remote Notis app and optionally link a local project to it.
 
 When to use: Provision a fresh remote app before the first deploy. Pass a project directory to link it immediately.
 
-Examples:
-- `npx --package @notis_ai/cli@latest -- notis apps create "My App"`
-- `npx --package @notis_ai/cli@latest -- notis apps create "My App" .`
-
-### `npx --package @notis_ai/cli@latest -- notis apps dev [dir]`
-
-Register a development root and connect its apps to the shared local development host.
-
-When to use: Run this once for any folder that should be watched permanently. The folder itself, direct child apps, and apps/* are discovered automatically by every signed-in Notis Desktop instance. A linked app substitutes its online bundle only when local notisAppVersion is strictly greater than the installed release.
-
 Options:
-- `--port <number>` — Local bundle server port (default: 5173).
-- `--scratch` — Use isolated empty databases, bundled skills, and bundled automations for this session instead of the installed app's resources. For fixture work and destructive experiments.
-- `--live-data` — Deprecated: using the installed app's real resources is now the default. Accepted as a no-op; use `--scratch` for the old isolated behavior.
-- `--grant-cloud-shell` — Approve a cloudComputer: 'shell' declaration without the interactive prompt. The grant persists for this dev app; authorship alone never grants it.
+- `--team-id <id>` — Create or reuse the exact team-scoped app (default: personal).
 
 Examples:
-- `npx --package @notis_ai/cli@latest -- notis apps dev`
-- `npx --package @notis_ai/cli@latest -- notis apps dev ./my-app`
-- `npx --package @notis_ai/cli@latest -- notis apps dev ./workspace --port 5200`
-- `npx --package @notis_ai/cli@latest -- notis apps dev --scratch  # isolated resources for fixture or schema experiments`
-
-### `npx --package @notis_ai/cli@latest -- notis apps roots list`
-
-List persistent machine-local Notis app development roots.
-
-When to use: See which folders every local Notis Desktop instance watches for development apps.
-
-Examples:
-- `npx --package @notis_ai/cli@latest -- notis apps roots list`
-
-### `npx --package @notis_ai/cli@latest -- notis apps roots remove <folder>`
-
-Stop watching a registered Notis app development root.
-
-When to use: Remove a persistent development root. The built-in ~/.notis/apps root cannot be removed.
-
-Examples:
-- `npx --package @notis_ai/cli@latest -- notis apps roots remove ./old-apps`
+- `npx --package @notis_ai/cli@latest -- notis apps create "My App"`
+- `npx --package @notis_ai/cli@latest -- notis apps create "My App" .`
 
 ### `npx --package @notis_ai/cli@latest -- notis apps build [dir]`
 
@@ -286,15 +253,19 @@ Link a local project to a remote Notis app.
 
 When to use: Connect a local project to an existing app for deployment.
 
+Options:
+- `--expected-version <version>` — Link only if the remote deployment version still matches this non-negative integer.
+
 Examples:
 - `npx --package @notis_ai/cli@latest -- notis apps link abc123`
 - `npx --package @notis_ai/cli@latest -- notis apps link abc123 ./my-app`
+- `npx --package @notis_ai/cli@latest -- notis apps link abc123 ./recovered-app --expected-version 0`
 
 ### `npx --package @notis_ai/cli@latest -- notis apps pull <app-id> [dir]`
 
 Download a Notis app source snapshot into a local project folder.
 
-When to use: Edit an installed app locally. Preserve any local edits, pull and link the latest persisted source, then increment package.json notisAppVersion above that release before notis apps dev; continue with build and deploy.
+When to use: Edit an installed app. Preserve local edits, pull and link its persisted source, then build, verify and deploy.
 
 Options:
 - `--force` — Overwrite a non-empty target directory.
@@ -306,20 +277,15 @@ Examples:
 
 ### `npx --package @notis_ai/cli@latest -- notis apps deploy [dir]`
 
-Build and upload the app to the linked Notis app.
+Build, verify and release the linked Workspace app.
 
-When to use: Ship the installed app to production for the linked user/team app. A project that has only a development app is promoted in place on first deploy: same app id, same databases, dev markers removed. This command does not publish to the app store.
+When to use: Build, verify and release the linked personal or team Workspace app. This command does not publish to the Store.
 
 Options:
 - `--app-id <id>` — Override linked app ID.
-- `--skip-build` — Skip the build step (use existing .notis/output/).
-- `--direct` — Explicitly upload to Supabase storage, bypassing the backend server.
+- `--skip-build` — Reuse unchanged build output; automated verification still runs.
 
 Examples:
-- `npx --package @notis_ai/cli@latest -- notis apps deploy`
-- `npx --package @notis_ai/cli@latest -- notis apps deploy --skip-build`
-- `npx --package @notis_ai/cli@latest -- notis apps deploy --app-id abc123`
-- `npx --package @notis_ai/cli@latest -- notis apps deploy --direct`
 
 ### `npx --package @notis_ai/cli@latest -- notis apps publish [dir]`
 

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."
+    }
+  ]
+}