@notis_ai/cli 0.2.7 → 0.2.9

package/README.md

@@ -4,7 +4,7 @@ Agent-first Notis CLI for apps and generic tool execution.
 
 ## Install
 
-Use the Notis CLI through NPX. Install and sign into Notis Desktop to keep the local CLI auth profile current; do not rely on an installed `notis` command. Related skills such as `notis-cli` and `notis-apps` are delivered through normal Notis skill sync for the signed-in user.
+Use the Notis CLI through NPX; do not rely on an installed `notis` command. When Notis Desktop is signed in, its local credential remains the fastest path. On a server, container, or machine without Desktop, run `notis login` to authorize a scoped, revocable OAuth credential in the browser.
 
 For CI, hosted agents, or internal scripts, pass a non-persisted token with `NOTIS_JWT=<token>`.
 
@@ -12,12 +12,13 @@ For CI, hosted agents, or internal scripts, pass a non-persisted token with `NOT
 
 ```bash
 npx --package @notis_ai/cli@latest -- notis --help
+npx --package @notis_ai/cli@latest -- notis login
 npx --package @notis_ai/cli@latest -- notis doctor
 npx --package @notis_ai/cli@latest -- notis apps list
 npx --package @notis_ai/cli@latest -- notis tools search "list Notis databases"
 ```
 
-The desktop app owns sign-in and keeps the CLI profile in sync automatically.
+Credential precedence is worktree runtime, `NOTIS_JWT`, a valid Desktop credential, then OAuth. `notis logout` revokes and removes OAuth without signing Desktop out. Use `notis login --paste-code` for the HTTPS copy-paste fallback on a remote machine.
 
 The CLI defaults to `json` output in agent or non-TTY contexts and `table` output in interactive terminals.
 
@@ -31,6 +32,44 @@ The CLI defaults to `json` output in agent or non-TTY contexts and `table` outpu
 - `--timeout-ms <n>` — HTTP timeout in milliseconds
 - `--idempotency-key <key>` — Override the generated idempotency key for mutating commands
 
+## Authentication
+
+### `npx --package @notis_ai/cli@latest -- notis login`
+
+Authorize the Notis CLI in a browser with scoped OAuth access.
+
+When to use: Use this on a machine where Notis Desktop is unavailable, signed out, or should not own CLI authentication.
+
+Options:
+- `--no-browser` — Print the authorization URL without opening a browser.
+- `--print-url` — Print the authorization URL even when opening a browser.
+- `--paste-code` — Use the copy-paste callback for SSH and headless machines.
+- `--force` — Create an independent OAuth grant even when Desktop is signed in.
+- `--timeout-seconds <n>` — How long to wait for authorization (default 300).
+- `--scope <scope>` — OAuth permission to request (repeatable).
+- `--code <code>` — Redeem the code shown in the browser after a non-interactive login.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis login`
+- `npx --package @notis_ai/cli@latest -- notis login --no-browser --print-url`
+- `npx --package @notis_ai/cli@latest -- notis login --paste-code`
+- `npx --package @notis_ai/cli@latest -- notis login --code 4f3c2b1a`
+- `npx --package @notis_ai/cli@latest -- notis login --force`
+
+### `npx --package @notis_ai/cli@latest -- notis logout`
+
+Revoke and remove the scoped OAuth credential for the active CLI profile.
+
+When to use: Use this to disconnect the command line without signing Notis Desktop out.
+
+Options:
+- `--all-profiles` — Remove OAuth credentials from every CLI profile.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis logout`
+- `npx --package @notis_ai/cli@latest -- notis logout --all-profiles`
+
+
 ## Apps
 
 ### `npx --package @notis_ai/cli@latest -- notis apps list`
@@ -200,6 +239,21 @@ Examples:
 - `npx --package @notis_ai/cli@latest -- notis apps publish --confirm-ready`
 - `npx --package @notis_ai/cli@latest -- notis apps publish ./my-app --confirm-ready`
 
+### `npx --package @notis_ai/cli@latest -- notis apps duplicate [dir]`
+
+Duplicate an app into an independent copy with its own databases.
+
+When to use: When the same app should run for a second purpose - a notes app for blog drafts alongside one for bookmarks. The copy shares no data with the source.
+
+Options:
+- `--app-id <id>` — App to duplicate. Defaults to the app this project is linked to.
+- `--name <name>` — Name for the duplicate (default: the source name followed by "copy").
+- `--copy-documents <mode>` — Which rows to copy: 'declared' (default, the starter content a fresh install would have), 'all', or 'none'.
+
+Examples:
+- `npx --package @notis_ai/cli@latest -- notis apps duplicate --name "Blog"`
+- `npx --package @notis_ai/cli@latest -- notis apps duplicate --app-id abc123 --name "Bookmarks" --copy-documents none`
+
 ### `npx --package @notis_ai/cli@latest -- notis apps doctor [dir]`
 
 Check project health and readiness.

package/dist/scaffolds/notis-database/app/page.tsx

@@ -1,7 +1,7 @@
 'use client';
 
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
-import { useTool, useTopBarSearch } from '@notis/sdk';
+import { normalizeDocumentRecord, useTool, useTopBarSearch } from '@notis/sdk';
 import { WarningCircleIcon as AlertCircle, AtIcon as AtSign, CalendarIcon as Calendar, CheckSquareIcon as CheckSquare, CaretDownIcon as ChevronDown, CircleIcon as Circle, CircleIcon as CircleDot, DatabaseIcon as Database, FileTextIcon as FileText, HashIcon as Hash, LinkIcon as Link2, ListChecksIcon as ListChecks, CircleNotchIcon as Loader2, EnvelopeIcon as Mail, PaperclipIcon as Paperclip, PhoneIcon as Phone, SigmaIcon as Sigma, TagIcon as Tag, TextTIcon as Type, UserIcon as User } from '@phosphor-icons/react';
 
 import { Badge } from '@/components/ui/badge';
@@ -326,10 +326,10 @@ export default function CatalogPage() {
     if (activeTab !== 'documents') return;
     if (!detail) return;
 
-    const databaseSlug = detail.slug;
-    if (!databaseSlug) {
+    const databaseId = detail.id;
+    if (!databaseId) {
       setDocuments([]);
-      setDocumentsError('This database does not have a queryable slug.');
+      setDocumentsError('This database does not have a stable ID.');
       setDocumentsLoading(false);
       return;
     }
@@ -347,7 +347,7 @@ export default function CatalogPage() {
 
       for (let page = 0; page < maxPages; page += 1) {
         const result = await queryCall({
-          database_slug: databaseSlug,
+          database_id: databaseId,
           query: { page_size: pageSize },
           offset,
         });
@@ -357,7 +357,10 @@ export default function CatalogPage() {
           throw new Error(result?.message || 'Failed to load documents.');
         }
 
-        collected = [...collected, ...(result.documents ?? [])];
+          collected = [
+            ...collected,
+            ...(result.documents ?? []).map((document) => normalizeDocumentRecord(document)),
+          ];
         setDocuments(collected);
 
         if (!result.has_more) return;
@@ -411,7 +414,10 @@ export default function CatalogPage() {
   const propCount = nonRelationProps(detail).length;
 
   return (
-    <div className="flex h-screen w-full overflow-hidden bg-background text-foreground antialiased">
+    <div
+      data-store-screenshot="catalog"
+      className="flex h-screen w-full overflow-hidden bg-background text-foreground antialiased"
+    >
       <aside className="flex h-full w-[288px] flex-shrink-0 flex-col border-r border-border bg-background">
         <div className="flex items-baseline justify-between gap-2 px-4 pb-3 pt-4">
           <h1 className="text-lg font-semibold tracking-tight">Databases</h1>
@@ -691,6 +697,7 @@ function DetailHeader({
           label="Properties"
           count={propCount}
           active={activeTab === 'properties'}
+          tab="properties"
           onClick={() => onTabChange('properties')}
         />
         <TabButton
@@ -698,6 +705,7 @@ function DetailHeader({
           label="Relations"
           count={relCount}
           active={activeTab === 'relations'}
+          tab="relations"
           onClick={() => onTabChange('relations')}
         />
         <TabButton
@@ -705,6 +713,7 @@ function DetailHeader({
           label="Documents"
           count={docCount}
           active={activeTab === 'documents'}
+          tab="documents"
           onClick={() => onTabChange('documents')}
         />
       </div>
@@ -717,17 +726,20 @@ function TabButton({
   label,
   count,
   active,
+  tab,
   onClick,
 }: {
   icon: React.ReactNode;
   label: string;
   count: number;
   active: boolean;
+  tab: ActiveTab;
   onClick: () => void;
 }) {
   return (
     <button
       type="button"
+      data-tab={tab}
       onClick={onClick}
       className={cn(
         'flex items-center gap-1.5 px-3.5 py-1.5 text-[12.5px] transition-colors',
@@ -953,10 +965,10 @@ function DocumentsTable({
                   </div>
                 </TableCell>
                 <TableCell className="whitespace-nowrap text-muted-foreground">
-                  {formatDateTime(document.created_time)}
+                  {formatDateTime(document.createdAt)}
                 </TableCell>
                 <TableCell className="whitespace-nowrap text-muted-foreground">
-                  {formatDateTime(document.last_edited_time)}
+                  {formatDateTime(document.lastEditedTime)}
                 </TableCell>
                 {properties.map((property) => {
                   const propertyName = property.name ?? property.id;
@@ -994,43 +1006,36 @@ function PropertyValue({
   property: DatabaseProperty;
   value: DocumentPropertyValue | undefined;
 }) {
-  if (!value) return <MutedDash />;
+  if (value == null || value === '') return <MutedDash />;
 
   switch (property.type) {
     case 'title':
-      return <TextValue value={textFromRichText(value.title)} />;
     case 'rich_text':
-      return <TextValue value={textFromRichText(value.rich_text)} />;
+      return <TextValue value={typeof value === 'string' ? value : stringifyFallback(value)} />;
     case 'number':
-      return <TextValue value={typeof value.number === 'number' ? compactNumber(value.number) : ''} />;
+      return <TextValue value={typeof value === 'number' ? compactNumber(value) : ''} />;
     case 'select':
-    case 'status': {
-      const selected = value[property.type];
-      if (!selected || typeof selected !== 'object') return <MutedDash />;
-      const option = selected as { name?: string | null; color?: string | null };
-      if (!option.name) return <MutedDash />;
+    case 'status':
+      if (typeof value !== 'string') return <MutedDash />;
       return (
-        <Badge variant="secondary" className={cn('rounded-sm px-1.5 py-px', selectTint(option.color))}>
-          {option.name}
+        <Badge variant="secondary" className="rounded-sm px-1.5 py-px">
+          {value}
         </Badge>
       );
-    }
     case 'multi_select': {
-      const options = Array.isArray(value.multi_select) ? value.multi_select : [];
+      const options = Array.isArray(value) ? value : [];
       if (options.length === 0) return <MutedDash />;
       return (
         <div className="flex max-w-[240px] flex-wrap gap-1">
           {options.map((option, index) => {
-            const item = option && typeof option === 'object'
-              ? option as { id?: string | null; name?: string | null; color?: string | null }
-              : null;
+            const label = typeof option === 'string' ? option : stringifyFallback(option);
             return (
               <Badge
-                key={item?.id ?? item?.name ?? index}
+                key={`${label}-${index}`}
                 variant="secondary"
-                className={cn('rounded-sm px-1.5 py-px', selectTint(item?.color))}
+                className="rounded-sm px-1.5 py-px"
               >
-                {item?.name ?? 'Untitled'}
+                {label || 'Untitled'}
               </Badge>
             );
           })}
@@ -1038,25 +1043,17 @@ function PropertyValue({
       );
     }
     case 'checkbox':
-      return <TextValue value={value.checkbox ? 'Yes' : 'No'} />;
-    case 'date': {
-      const date = value.date;
-      if (!date || typeof date !== 'object') return <MutedDash />;
-      const range = date as { start?: string | null; end?: string | null };
-      const start = formatDate(range.start);
-      const end = range.end ? formatDate(range.end) : null;
-      return <TextValue value={end ? `${start} – ${end}` : start} />;
-    }
+      return <TextValue value={value === true ? 'Yes' : 'No'} />;
+    case 'date':
+      return <TextValue value={typeof value === 'string' ? formatDate(value) : ''} />;
     case 'url':
     case 'email':
     case 'phone_number':
-      return <TextValue value={typeof value[property.type] === 'string' ? value[property.type] as string : ''} />;
+      return <TextValue value={typeof value === 'string' ? value : ''} />;
     case 'relation':
-      return <TextValue value={relationLabel(value.relation, 'linked record')} />;
     case 'people':
-      return <TextValue value={relationLabel(value.people, 'person')} />;
     case 'files':
-      return <TextValue value={relationLabel(value.files, 'file')} />;
+      return <TextValue value={relationLabel(value, property.type === 'people' ? 'person' : property.type === 'files' ? 'file' : 'linked record')} />;
     default:
       return <TextValue value={stringifyFallback(value)} />;
   }

package/dist/scaffolds/notis-database/lib/types.ts

@@ -25,7 +25,8 @@ export type GetDatabaseArgs = {
 };
 
 export type QueryDatabaseArgs = {
-  database_slug: string;
+  database_id?: string;
+  database_slug?: string;
   query: {
     page_size?: number;
   };
@@ -105,10 +106,7 @@ export type GetDatabaseResult =
   | { database: DatabaseDetail }
   | { status: 'error'; message: string };
 
-export type DocumentPropertyValue = {
-  type?: string;
-  [key: string]: unknown;
-};
+export type DocumentPropertyValue = unknown;
 
 export type DatabaseDocument = {
   id: string;
@@ -116,8 +114,8 @@ export type DatabaseDocument = {
   properties?: Record<string, DocumentPropertyValue>;
   property_states?: Record<string, string>;
   url?: string | null;
-  created_time?: string | null;
-  last_edited_time?: string | null;
+  createdAt?: string | null;
+  lastEditedTime?: string | null;
   icon?: string | null;
   cover?: string | null;
 };