@notis_ai/cli 0.2.0 → 0.2.2

package/dist/scaffolds/notes/components/ui/badge.tsx

@@ -0,0 +1,28 @@
+import * as React from 'react';
+import { cva, type VariantProps } from 'class-variance-authority';
+
+import { cn } from '@/lib/utils';
+
+const badgeVariants = cva(
+  'inline-flex items-center rounded-full border px-2.5 py-0.5 text-xs font-medium transition-colors focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2',
+  {
+    variants: {
+      variant: {
+        default: 'border-transparent bg-primary/10 text-primary',
+        secondary: 'border-transparent bg-secondary text-secondary-foreground',
+        outline: 'text-foreground',
+      },
+    },
+    defaultVariants: {
+      variant: 'default',
+    },
+  },
+);
+
+export interface BadgeProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof badgeVariants> {}
+
+function Badge({ className, variant, ...props }: BadgeProps) {
+  return <div className={cn(badgeVariants({ variant }), className)} {...props} />;
+}
+
+export { Badge, badgeVariants };

package/dist/scaffolds/notes/components/ui/button.tsx

@@ -0,0 +1,53 @@
+import * as React from 'react';
+import { Slot } from '@radix-ui/react-slot';
+import { cva, type VariantProps } from 'class-variance-authority';
+
+import { cn } from '@/lib/utils';
+
+const buttonVariants = cva(
+  'inline-flex items-center justify-center whitespace-nowrap rounded-md text-sm font-medium ring-offset-background transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50',
+  {
+    variants: {
+      variant: {
+        default: 'bg-primary text-primary-foreground hover:bg-primary/90',
+        destructive: 'bg-destructive text-destructive-foreground hover:bg-destructive/90',
+        outline: 'border border-input bg-background hover:bg-accent hover:text-accent-foreground',
+        secondary: 'bg-secondary text-secondary-foreground hover:bg-secondary/80',
+        ghost: 'hover:bg-accent hover:text-accent-foreground',
+        link: 'text-primary underline-offset-4 hover:underline',
+      },
+      size: {
+        default: 'h-10 px-4 py-2',
+        sm: 'h-9 rounded-md px-3',
+        lg: 'h-11 rounded-md px-8',
+        icon: 'h-10 w-10',
+      },
+    },
+    defaultVariants: {
+      variant: 'default',
+      size: 'default',
+    },
+  },
+);
+
+export interface ButtonProps
+  extends React.ButtonHTMLAttributes<HTMLButtonElement>,
+    VariantProps<typeof buttonVariants> {
+  asChild?: boolean;
+}
+
+const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
+  ({ className, variant, size, asChild = false, ...props }, ref) => {
+    const Comp = asChild ? Slot : 'button';
+    return (
+      <Comp
+        className={cn(buttonVariants({ variant, size, className }))}
+        ref={ref}
+        {...props}
+      />
+    );
+  },
+);
+Button.displayName = 'Button';
+
+export { Button, buttonVariants };

package/dist/scaffolds/notes/components/ui/card.tsx

@@ -0,0 +1,56 @@
+import * as React from 'react';
+
+import { cn } from '@/lib/utils';
+
+const Card = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(
+  ({ className, ...props }, ref) => (
+    <div
+      ref={ref}
+      className={cn('rounded-2xl border bg-card text-card-foreground shadow-sm', className)}
+      {...props}
+    />
+  ),
+);
+Card.displayName = 'Card';
+
+const CardHeader = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(
+  ({ className, ...props }, ref) => (
+    <div ref={ref} className={cn('flex flex-col space-y-1.5 p-6', className)} {...props} />
+  ),
+);
+CardHeader.displayName = 'CardHeader';
+
+const CardTitle = React.forwardRef<HTMLParagraphElement, React.HTMLAttributes<HTMLHeadingElement>>(
+  ({ className, ...props }, ref) => (
+    <h3
+      ref={ref}
+      className={cn('text-xl font-semibold leading-none tracking-tight', className)}
+      {...props}
+    />
+  ),
+);
+CardTitle.displayName = 'CardTitle';
+
+const CardDescription = React.forwardRef<
+  HTMLParagraphElement,
+  React.HTMLAttributes<HTMLParagraphElement>
+>(({ className, ...props }, ref) => (
+  <p ref={ref} className={cn('text-sm text-muted-foreground', className)} {...props} />
+));
+CardDescription.displayName = 'CardDescription';
+
+const CardContent = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(
+  ({ className, ...props }, ref) => (
+    <div ref={ref} className={cn('p-6 pt-0', className)} {...props} />
+  ),
+);
+CardContent.displayName = 'CardContent';
+
+const CardFooter = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(
+  ({ className, ...props }, ref) => (
+    <div ref={ref} className={cn('flex items-center p-6 pt-0', className)} {...props} />
+  ),
+);
+CardFooter.displayName = 'CardFooter';
+
+export { Card, CardHeader, CardFooter, CardTitle, CardDescription, CardContent };

package/dist/scaffolds/notes/components.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "new-york",
+  "rsc": false,
+  "tsx": true,
+  "tailwind": {
+    "config": "tailwind.config.ts",
+    "css": "app/globals.css",
+    "baseColor": "zinc",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  }
+}

package/dist/scaffolds/notes/lib/utils.ts

@@ -0,0 +1,6 @@
+import { type ClassValue, clsx } from 'clsx';
+import { twMerge } from 'tailwind-merge';
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}

package/dist/scaffolds/notes/notis.config.ts

@@ -0,0 +1,31 @@
+import { defineNotisApp } from '@notis/sdk/config';
+
+export default defineNotisApp({
+  name: 'Notis Notes',
+  description: 'Browse notes by documents, table, or calendar with folders in the sidebar.',
+  icon: 'lucide:notebook-pen',
+  databases: ['note_folders', 'notes'],
+  routes: [
+    {
+      path: '/',
+      slug: 'notes',
+      name: 'Notes',
+      icon: 'lucide:notebook-pen',
+      default: true,
+      collection: {
+        database: 'note_folders',
+        titleProperty: 'Name',
+        parentProperty: 'Parent',
+        sidebar: {
+          mode: 'tree',
+          allowCreate: true,
+        },
+      },
+    },
+  ],
+  tools: [
+    'notis_query_database',
+    'notis_get_document',
+    'notis_upsert_document',
+  ],
+});

package/dist/scaffolds/notes/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "notis-notes-app",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build"
+  },
+  "dependencies": {
+    "@notis/sdk": "file:../../packages/sdk",
+    "@radix-ui/react-slot": "^1.1.0",
+    "class-variance-authority": "^0.7.0",
+    "clsx": "^2.1.1",
+    "lucide-react": "^0.474.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tailwind-merge": "^2.6.0",
+    "tailwindcss-animate": "^1.0.7"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@vitejs/plugin-react": "^4.0.0",
+    "postcss": "^8.0.0",
+    "tailwindcss": "^3.4.0",
+    "typescript": "^5.0.0",
+    "vite": "^6.0.0"
+  }
+}

package/dist/scaffolds/notes/postcss.config.mjs

@@ -0,0 +1,8 @@
+/** @type {import('postcss-load-config').Config} */
+const config = {
+  plugins: {
+    tailwindcss: {},
+  },
+};
+
+export default config;

package/dist/scaffolds/notes/tailwind.config.ts

@@ -0,0 +1,58 @@
+import type { Config } from 'tailwindcss';
+import tailwindAnimate from 'tailwindcss-animate';
+
+const config: Config = {
+  darkMode: ['class'],
+  content: [
+    './app/**/*.{ts,tsx}',
+    './components/**/*.{ts,tsx}',
+    './lib/**/*.{ts,tsx}',
+  ],
+  theme: {
+    extend: {
+      colors: {
+        border: 'hsl(var(--border))',
+        input: 'hsl(var(--input))',
+        ring: 'hsl(var(--ring))',
+        background: 'hsl(var(--background))',
+        foreground: 'hsl(var(--foreground))',
+        primary: {
+          DEFAULT: 'hsl(var(--primary))',
+          foreground: 'hsl(var(--primary-foreground))',
+        },
+        secondary: {
+          DEFAULT: 'hsl(var(--secondary))',
+          foreground: 'hsl(var(--secondary-foreground))',
+        },
+        destructive: {
+          DEFAULT: 'hsl(var(--destructive))',
+          foreground: 'hsl(var(--destructive-foreground))',
+        },
+        muted: {
+          DEFAULT: 'hsl(var(--muted))',
+          foreground: 'hsl(var(--muted-foreground))',
+        },
+        accent: {
+          DEFAULT: 'hsl(var(--accent))',
+          foreground: 'hsl(var(--accent-foreground))',
+        },
+        popover: {
+          DEFAULT: 'hsl(var(--popover))',
+          foreground: 'hsl(var(--popover-foreground))',
+        },
+        card: {
+          DEFAULT: 'hsl(var(--card))',
+          foreground: 'hsl(var(--card-foreground))',
+        },
+      },
+      borderRadius: {
+        lg: 'var(--radius)',
+        md: 'calc(var(--radius) - 2px)',
+        sm: 'calc(var(--radius) - 4px)',
+      },
+    },
+  },
+  plugins: [tailwindAnimate],
+};
+
+export default config;

package/dist/scaffolds/notes/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "types": ["vite/client"],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": ["**/*.ts", "**/*.tsx"],
+  "exclude": ["node_modules"]
+}

package/dist/scaffolds/notes/vite.config.ts

@@ -0,0 +1,10 @@
+import { notisViteConfig } from '@notis/sdk/vite';
+import react from '@vitejs/plugin-react';
+import appConfig from './notis.config';
+
+const config = notisViteConfig(appConfig);
+
+export default {
+  ...config,
+  plugins: [react(), ...(config.plugins || [])],
+};

package/dist/scaffolds.json

@@ -0,0 +1,13 @@
+{
+  "source": "apps/*/notis.config.ts",
+  "scaffolds": [
+    {
+      "slug": "notes",
+      "name": "Notis Notes",
+      "description": "Browse notes by documents, table, or calendar with folders in the sidebar.",
+      "icon": "lucide:notebook-pen",
+      "categories": [],
+      "tagline": "Browse notes by documents, table, or calendar with folders in the sidebar."
+    }
+  ]
+}

package/package.json

@@ -1,19 +1,26 @@
 {
   "name": "@notis_ai/cli",
-  "version": "0.2.0",
-  "description": "Agent-first Notis CLI for apps, databases, and generic tool execution",
+  "version": "0.2.2",
+  "description": "Agent-first Notis CLI for apps and generic tool execution",
   "type": "module",
   "bin": {
     "notis": "bin/notis.js"
   },
   "files": [
     "bin/",
+    "dist/",
     "src/",
+    "skills/",
+    "template/",
     "README.md"
   ],
   "scripts": {
+    "build": "node ./scripts/build-scaffolds.js",
     "docs:generate": "node ./scripts/generate-docs.js",
     "docs:check": "node ./scripts/generate-docs.js --check",
+    "prepack": "npm run build",
+    "release:prepare": "npm run build && node ./scripts/prepare-publish.js --apply",
+    "cli:set-mode": "node ./scripts/set-cli-mode.js",
     "test": "node --test"
   },
   "engines": {
@@ -29,5 +36,8 @@
     "ai",
     "agent-skills"
   ],
+  "publishConfig": {
+    "access": "public"
+  },
   "license": "MIT"
 }

package/skills/notis-apps/SKILL.md

@@ -0,0 +1,162 @@
+---
+name: notis-apps
+description: Design and package Notis apps. Use when users want an app that groups databases, routes, documents, automations, and skills into one installable Notis product.
+---
+
+# Notis Apps Skill
+
+Use this skill when the user wants to create, edit, debug, or package a Notis app. Notis apps are Vite + React projects that deploy into the Notis Portal as installed apps for the current user or team.
+
+Run the Notis CLI through NPX, for example `npx --package @notis_ai/cli@latest -- notis apps list`. Notis Desktop keeps the CLI auth profile current. This `notis-apps` skill is delivered through normal Notis skill sync for the signed-in user, alongside other curated skills.
+
+## Platform Model
+
+A Notis app is:
+
+- a Vite + React project
+- built with `@notis/sdk`
+- configured through `notis.config.ts`
+- packaged as an ES module bundle with `app.js`, `app.css`, and `manifest.json`
+- rendered by the Notis Portal as a React component, not an iframe
+- connected to Notis data and tools through the Portal-provided runtime and SDK hooks
+
+Use the Notis CLI for the app lifecycle:
+
+```bash
+npx --package @notis_ai/cli@latest -- notis apps init
+npx --package @notis_ai/cli@latest -- notis apps dev
+npx --package @notis_ai/cli@latest -- notis apps build
+npx --package @notis_ai/cli@latest -- notis apps verify
+npx --package @notis_ai/cli@latest -- notis apps create
+npx --package @notis_ai/cli@latest -- notis apps link
+npx --package @notis_ai/cli@latest -- notis apps pull
+npx --package @notis_ai/cli@latest -- notis apps deploy
+npx --package @notis_ai/cli@latest -- notis apps doctor
+```
+
+Use this command form everywhere:
+
+```bash
+npx --package @notis_ai/cli@latest -- notis apps ...
+```
+
+## Hard Rules
+
+- Use React + Vite only. Do not use Next.js or a custom server for app projects.
+- Build standard pages in `app/`. Do not write raw `views/<slug>/index.js` files.
+- Keep navigation in `notis.config.ts` `routes`; each route needs a stable `slug`.
+- Reference existing databases by slug in `notis.config.ts`; do not assume deploy creates databases automatically.
+- Declare runtime tool access in `notis.config.ts` `tools`.
+- Use `@notis/sdk` hooks instead of direct runtime access.
+- Do not rely on `window.__NOTIS_RUNTIME__` or portal-owned DOM hooks.
+- `npx --package @notis_ai/cli@latest -- notis apps deploy` updates an installed app. It does not publish to the public App Store.
+- Public or team App Store publishing is a Portal review flow.
+- Use Phosphor icon names with the `phosphor:` prefix. Do not use emoji icons.
+- Prefer scaffolded shadcn components and portal theme tokens over custom visual systems.
+
+## App Workflow
+
+1. Discover existing apps if needed:
+
+```bash
+npx --package @notis_ai/cli@latest -- notis apps list
+```
+
+2. Start from a scaffold or pull an existing app:
+
+```bash
+npx --package @notis_ai/cli@latest -- notis apps scaffolds list
+npx --package @notis_ai/cli@latest -- notis apps init "My App"
+npx --package @notis_ai/cli@latest -- notis apps pull <app-id> ./my-app
+```
+
+3. Install dependencies and develop:
+
+```bash
+npm install
+npx --package @notis_ai/cli@latest -- notis apps dev
+```
+
+4. Build and verify:
+
+```bash
+npx --package @notis_ai/cli@latest -- notis apps build
+npx --package @notis_ai/cli@latest -- notis apps verify
+```
+
+5. Create or link the remote app, then deploy:
+
+```bash
+npx --package @notis_ai/cli@latest -- notis apps create "My App" .
+npx --package @notis_ai/cli@latest -- notis apps deploy
+```
+
+or:
+
+```bash
+npx --package @notis_ai/cli@latest -- notis apps link <app-id>
+npx --package @notis_ai/cli@latest -- notis apps deploy
+```
+
+## App Structure
+
+Expected project shape:
+
+```text
+notis.config.ts
+vite.config.ts
+app/
+components/
+metadata/
+.notis/output/
+```
+
+`notis.config.ts` owns:
+
+- app metadata: name, title, description, icon, categories, tagline
+- database slug references
+- route definitions
+- tool access
+
+Example:
+
+```ts
+import { defineNotisApp } from '@notis/sdk/config';
+
+export default defineNotisApp({
+  name: 'my-app',
+  title: 'My App',
+  description: 'A focused Notis app.',
+  icon: 'phosphor:squares-four',
+  databases: ['tasks'],
+  routes: [
+    {
+      path: '/',
+      slug: 'tasks',
+      name: 'Tasks',
+      icon: 'phosphor:check-square',
+      default: true,
+    },
+  ],
+  tools: ['notis-default-query', 'notis-default-upsert_tasks'],
+});
+```
+
+## Runtime Usage
+
+Use SDK hooks for data and tool access:
+
+```tsx
+import { useTool } from '@notis/sdk';
+
+const query = useTool('notis-default-query');
+```
+
+Do not fetch Notis backend endpoints directly from app code unless the SDK explicitly requires it. The Portal provides authentication, runtime context, and route rendering.
+
+## Troubleshooting
+
+- If deploy fails with backend connectivity errors, run `npx --package @notis_ai/cli@latest -- notis apps doctor` and check the configured API base.
+- If editing an existing app, use `npx --package @notis_ai/cli@latest -- notis apps pull <app-id>` when source snapshots are available.
+- If the Portal shows a stale bundle, hard refresh the Portal or deploy a new version.
+- If an app route fails to load, run `npx --package @notis_ai/cli@latest -- notis apps verify` and inspect `.notis/output/manifest.json`.