@notis_ai/cli 0.2.5 → 0.2.7

package/dist/scaffolds/notis-journal/metadata/screenshot-fixtures.json

@@ -0,0 +1,132 @@
+{
+  "tools": {
+    "LOCAL_NOTIS_DATABASE_QUERY": {
+      "documents": [
+        {
+          "id": "journal-demo-1",
+          "title": "Journal — 2026-07-16",
+          "content_markdown": "",
+          "created_time": "2026-07-16T08:00:00.000Z",
+          "properties": {
+            "Name": { "type": "title", "title": [{ "type": "text", "text": { "content": "Journal — 2026-07-16" } }] },
+            "Date": { "type": "date", "date": { "start": "2026-07-16", "end": null, "timezone": null } },
+            "Morning Mood": { "type": "number", "number": 6 },
+            "Morning Mood Word": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "rested" } }] },
+            "Morning Feeling": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "Calm and a little excited about the demo this afternoon." } }] },
+            "Energy": { "type": "number", "number": 8 },
+            "Motivation": { "type": "number", "number": 9 },
+            "Gratitude 1": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "A slow coffee on the balcony before anyone was awake" } }] },
+            "Gratitude 2": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "Camille laughing at my terrible pun last night" } }] },
+            "Gratitude 3": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "That my back finally feels normal again" } }] },
+            "Intention": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "One deep-work block on the launch page before opening messages." } }] },
+            "Affirmation": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "I am allowed to do one thing at a time." } }] }
+          }
+        },
+        {
+          "id": "journal-demo-2",
+          "title": "Journal — 2026-07-15",
+          "content_markdown": "Started the day convinced it was a write-off. By 16:00 the fix was shipped and the walk with Théo unknotted the roadmap question that has been bugging me for a week. Note to self: leave the house earlier.",
+          "created_time": "2026-07-15T08:00:00.000Z",
+          "properties": {
+            "Name": { "type": "title", "title": [{ "type": "text", "text": { "content": "Journal — 2026-07-15" } }] },
+            "Date": { "type": "date", "date": { "start": "2026-07-15", "end": null, "timezone": null } },
+            "Morning Mood": { "type": "number", "number": 4 },
+            "Morning Mood Word": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "foggy" } }] },
+            "Morning Feeling": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "Slept badly, brain still booting." } }] },
+            "Energy": { "type": "number", "number": 4 },
+            "Motivation": { "type": "number", "number": 6 },
+            "Gratitude 1": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "Rain on the window while working" } }] },
+            "Gratitude 2": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "The boulangerie was still open at 19:30" } }] },
+            "Gratitude 3": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "A friend checking in for no reason" } }] },
+            "Intention": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "Keep the day small: ship the fix, walk at lunch." } }] },
+            "Affirmation": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "I am steady even on slow days." } }] },
+            "Day Mood": { "type": "number", "number": 6 },
+            "Day Mood Word": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "redeemed" } }] },
+            "Highlight": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "The afternoon walk turned into an hour of ideas with Théo." } }] },
+            "Lesson": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "A rough morning predicts nothing about the afternoon." } }] }
+          }
+        },
+        {
+          "id": "journal-demo-3",
+          "title": "Journal — 2026-07-14",
+          "content_markdown": "",
+          "created_time": "2026-07-14T08:00:00.000Z",
+          "properties": {
+            "Name": { "type": "title", "title": [{ "type": "text", "text": { "content": "Journal — 2026-07-14" } }] },
+            "Date": { "type": "date", "date": { "start": "2026-07-14", "end": null, "timezone": null } },
+            "Morning Mood": { "type": "number", "number": 7 },
+            "Morning Mood Word": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "sunny" } }] },
+            "Morning Feeling": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "Woke up before the alarm, ready to go." } }] },
+            "Energy": { "type": "number", "number": 9 },
+            "Motivation": { "type": "number", "number": 9 },
+            "Gratitude 1": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "Eight hours of sleep, finally" } }] },
+            "Gratitude 2": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "The new espresso beans" } }] },
+            "Gratitude 3": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "A clear calendar until noon" } }] },
+            "Intention": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "Finish the investor update and actually send it." } }] },
+            "Affirmation": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "I am building something worth the patience it takes." } }] },
+            "Day Mood": { "type": "number", "number": 7 },
+            "Day Mood Word": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "unstoppable" } }] },
+            "Highlight": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "Sent the update and got two warm replies within the hour." } }] },
+            "Lesson": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "Momentum compounds when I front-load the scary task." } }] }
+          }
+        },
+        {
+          "id": "journal-demo-4",
+          "title": "Journal — 2026-07-13",
+          "content_markdown": "",
+          "created_time": "2026-07-13T08:00:00.000Z",
+          "properties": {
+            "Name": { "type": "title", "title": [{ "type": "text", "text": { "content": "Journal — 2026-07-13" } }] },
+            "Date": { "type": "date", "date": { "start": "2026-07-13", "end": null, "timezone": null } },
+            "Morning Mood": { "type": "number", "number": 3 },
+            "Morning Mood Word": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "heavy" } }] },
+            "Morning Feeling": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "Anxious about the support backlog." } }] },
+            "Energy": { "type": "number", "number": 3 },
+            "Motivation": { "type": "number", "number": 4 },
+            "Gratitude 1": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "Tea instead of a third coffee" } }] },
+            "Gratitude 2": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "The cat sleeping on my desk all morning" } }] },
+            "Intention": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "Answer ten tickets, then stop counting." } }] },
+            "Affirmation": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "I am more than my inbox." } }] },
+            "Day Mood": { "type": "number", "number": 4 },
+            "Day Mood Word": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "okay" } }] },
+            "Highlight": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "Closed the hardest ticket with an actual fix, not a workaround." } }] },
+            "Lesson": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "Naming the dread out loud makes it about half as loud." } }] }
+          }
+        },
+        {
+          "id": "journal-demo-5",
+          "title": "Journal — 2026-07-12",
+          "content_markdown": "Quiet, focused day. The kind that does not make stories but makes progress.",
+          "created_time": "2026-07-12T08:00:00.000Z",
+          "properties": {
+            "Name": { "type": "title", "title": [{ "type": "text", "text": { "content": "Journal — 2026-07-12" } }] },
+            "Date": { "type": "date", "date": { "start": "2026-07-12", "end": null, "timezone": null } },
+            "Morning Mood": { "type": "number", "number": 5 },
+            "Morning Mood Word": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "curious" } }] },
+            "Morning Feeling": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "Mildly under-slept but interested in the day." } }] },
+            "Energy": { "type": "number", "number": 6 },
+            "Motivation": { "type": "number", "number": 7 },
+            "Gratitude 1": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "Morning light in the kitchen" } }] },
+            "Gratitude 2": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "A podcast that made the dishes disappear" } }] },
+            "Gratitude 3": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "Knowing exactly what today is for" } }] },
+            "Intention": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "Prototype the stats page before lunch." } }] },
+            "Affirmation": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "I am learning fast enough." } }] },
+            "Day Mood": { "type": "number", "number": 6 },
+            "Day Mood Word": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "satisfying" } }] },
+            "Highlight": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "The prototype clicked on the third try." } }] },
+            "Lesson": { "type": "rich_text", "rich_text": [{ "type": "text", "text": { "content": "The second draft is where the good ideas live." } }] }
+          }
+        }
+      ]
+    }
+  },
+  "scenarios": {
+    "journal-overview": { "actions": [] },
+    "journal-evening": {
+      "actions": [
+        { "type": "click", "selector": "[data-rail-row='2026-07-15']", "settle_ms": 700 }
+      ]
+    },
+    "journal-stats": { "actions": [] }
+  }
+}

package/dist/scaffolds/notis-journal/notis.config.ts

@@ -0,0 +1,93 @@
+import { defineNotisApp } from '@notis/sdk/config';
+
+export default defineNotisApp({
+  name: 'notis-journal',
+  title: '5 Minutes Journal',
+  description:
+    'A display-only five-minute journal built from your morning and evening check-ins with Notis. Browse daily mood, energy, motivation, gratitude, intentions, affirmations, highlights, lessons, and free-form reflections, then use Stats to see trends and ritual consistency over time.',
+  icon: 'phosphor:notebook',
+  accent: 'amber',
+  author: { name: 'Florian (Flo) Pariset' },
+  categories: ['Personal', 'Productivity'],
+  tagline: 'Five intentional minutes with Notis, split between morning and evening.',
+  screenshots: [
+    {
+      path: 'metadata/screenshot-1.png',
+      alt: '5 Minutes Journal timeline with a morning check-in: mood scale, energy and motivation, gratitudes, intention, and affirmation.',
+      route: 'journal',
+      scenario: 'journal-overview',
+      focus: '[data-store-screenshot="journal"]',
+      theme: 'light',
+    },
+    {
+      path: 'metadata/screenshot-2.png',
+      alt: '5 Minutes Journal timeline in dark mode with a morning check-in, mood, energy, motivation, gratitudes, intention, and affirmation.',
+      route: 'journal',
+      scenario: 'journal-overview',
+      focus: '[data-store-screenshot="journal"]',
+      theme: 'dark',
+    },
+    {
+      path: 'metadata/screenshot-3.png',
+      alt: 'A completed day with both the morning ritual and the evening reflection, highlight, and lesson.',
+      route: 'journal',
+      scenario: 'journal-evening',
+      focus: '[data-store-screenshot="journal"]',
+      theme: 'light',
+    },
+    {
+      path: 'metadata/screenshot-4.png',
+      alt: 'A completed 5 Minutes Journal day in dark mode with both the morning ritual and evening reflection.',
+      route: 'journal',
+      scenario: 'journal-evening',
+      focus: '[data-store-screenshot="journal"]',
+      theme: 'dark',
+    },
+    {
+      path: 'metadata/screenshot-5.png',
+      alt: 'Stats page with mood trends, energy and motivation, ritual consistency, and the gratitude wall.',
+      route: 'insights',
+      scenario: 'journal-stats',
+      focus: '[data-store-screenshot="stats"]',
+      theme: 'light',
+    },
+    {
+      path: 'metadata/screenshot-6.png',
+      alt: '5 Minutes Journal Stats in dark mode with mood trends, ritual consistency, and recent gratitudes.',
+      route: 'insights',
+      scenario: 'journal-stats',
+      focus: '[data-store-screenshot="stats"]',
+      theme: 'dark',
+    },
+  ],
+  databases: ['journal_entries'],
+  skills: [
+    {
+      key: 'journal-onboarding',
+      path: './skills/journal-onboarding/SKILL.md',
+      name: 'journal-onboarding',
+      description:
+        'Set up the Journal morning and evening automations and run their check-ins.',
+    },
+  ],
+  onboarding: {
+    skill: 'journal-onboarding',
+    prompt: 'Help me set up my Journal morning and evening check-ins.',
+  },
+  routes: [
+    {
+      path: '/',
+      slug: 'journal',
+      name: 'Journal',
+      icon: 'phosphor:notebook',
+      default: true,
+    },
+    {
+      path: '/insights',
+      slug: 'insights',
+      name: 'Stats',
+      icon: 'phosphor:chart-line-up',
+    },
+  ],
+  tools: ['LOCAL_NOTIS_DATABASE_QUERY'],
+});

package/dist/scaffolds/notis-journal/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "notis-journal",
+  "version": "0.1.0",
+  "notisAppVersion": "0.1.6",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "test": "tsx --test app/journal-core.test.ts"
+  },
+  "dependencies": {
+    "@notis/sdk": "file:./packages/sdk",
+    "@phosphor-icons/react": "^2.1.10",
+    "@radix-ui/react-slot": "^1.1.0",
+    "class-variance-authority": "^0.7.0",
+    "clsx": "^2.1.1",
+    "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",
+    "tsx": "^4.21.0",
+    "typescript": "^5.0.0",
+    "vite": "^6.0.0"
+  }
+}

package/dist/scaffolds/notis-journal/packages/sdk/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@notis/sdk",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./config": "./src/config.ts",
+    "./vite": "./src/vite.ts",
+    "./ui": "./src/ui.ts",
+    "./styles.css": "./src/styles.css"
+  },
+  "files": [
+    "src",
+    "template"
+  ],
+  "scripts": {
+    "type-check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "react-markdown": "^10.1.0",
+    "remark-gfm": "^4.0.1"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0",
+    "vite": ">=5.0.0",
+    "@vitejs/plugin-react": ">=4.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/dist/scaffolds/notis-journal/packages/sdk/src/components/DocumentEditor.tsx

@@ -0,0 +1,93 @@
+'use client';
+
+import type { CSSProperties, ReactElement } from 'react';
+import { useNotisRuntime } from '../provider';
+import { useDocument } from '../hooks/useDocument';
+import { Markdown } from './Markdown';
+import type { NotisDocumentEditorProps } from '../runtime';
+
+const fallbackNoticeStyle: CSSProperties = {
+  marginTop: '0.75rem',
+  fontSize: '12px',
+  color: 'hsl(var(--muted-foreground))',
+};
+
+const fallbackFrameStyle: CSSProperties = {
+  borderRadius: '0.5rem',
+  border: '1px dashed hsl(var(--border))',
+  padding: '1rem',
+  fontSize: '13px',
+  color: 'hsl(var(--muted-foreground))',
+};
+
+const fallbackTitleStyle: CSSProperties = {
+  margin: '0 0 0.75rem',
+  fontSize: '1.5rem',
+  fontWeight: 700,
+  letterSpacing: '-0.01em',
+  color: 'hsl(var(--foreground))',
+};
+
+/**
+ * Read-only stand-in used when no host editor is available (standalone dev
+ * harness, snapshots). Markdown content renders via `Markdown`; other content
+ * types get a typed placeholder.
+ */
+function DocumentEditorFallback({ documentId, variant = 'full', className }: NotisDocumentEditorProps) {
+  const runtime = useNotisRuntime();
+  const { document, loading, error } = useDocument(documentId);
+  // Listing screenshots should show the app as it looks in the portal, so the
+  // harness-only editing notice stays out of scenario captures.
+  const isScreenshot = Boolean(runtime?.context?.screenshotScenario);
+
+  if (loading) {
+    return <div className={className} style={fallbackFrameStyle}>Loading document…</div>;
+  }
+  if (error || !document) {
+    return (
+      <div className={className} style={fallbackFrameStyle}>
+        {error?.message ?? 'Document not found.'}
+      </div>
+    );
+  }
+
+  const isMarkdown = document.contentType !== 'file';
+  return (
+    <div className={className}>
+      {variant === 'full' ? <h1 style={fallbackTitleStyle}>{document.title}</h1> : null}
+      {isMarkdown ? (
+        <>
+          <Markdown value={document.contentMarkdown ?? ''} />
+          {isScreenshot ? null : (
+            <p style={fallbackNoticeStyle}>Read-only preview — editing is available inside the Notis portal.</p>
+          )}
+        </>
+      ) : (
+        <div style={fallbackFrameStyle}>
+          {document.fileType ? `${document.fileType.toUpperCase()} document` : 'File document'} — open it in
+          the Notis portal to view.
+        </div>
+      )}
+    </div>
+  );
+}
+
+/**
+ * Embeds the document editor for a document anywhere in an app view. The host
+ * (portal) provides the implementation through `runtime.ui.DocumentEditor` and
+ * dispatches on the document's content type (markdown -> rich text editor,
+ * files -> matching viewer). Outside the portal this falls back to a read-only
+ * preview.
+ *
+ * ```tsx
+ * <DocumentEditor documentId={entry.id} variant="body" className="min-h-[320px]" />
+ * ```
+ */
+export function DocumentEditor(props: NotisDocumentEditorProps): ReactElement {
+  const runtime = useNotisRuntime();
+  const HostEditor = runtime?.ui?.DocumentEditor;
+  if (HostEditor) {
+    return <HostEditor {...props} />;
+  }
+  return <DocumentEditorFallback {...props} />;
+}

package/dist/scaffolds/notis-journal/packages/sdk/src/components/Markdown.tsx

@@ -0,0 +1,60 @@
+'use client';
+
+import type { AnchorHTMLAttributes, ReactElement } from 'react';
+import ReactMarkdown, { type Components } from 'react-markdown';
+import remarkGfm from 'remark-gfm';
+
+export interface MarkdownProps {
+  /** Markdown source to render. */
+  value: string;
+  /** Typography scale. 'sm' suits dense surfaces (cards, list rows). */
+  size?: 'sm' | 'base';
+  className?: string;
+  /** Per-element overrides, passed through to react-markdown. */
+  components?: Components;
+}
+
+function MarkdownLink({
+  href,
+  children,
+  node: _node,
+  ...rest
+}: AnchorHTMLAttributes<HTMLAnchorElement> & { node?: unknown }) {
+  const isExternal = typeof href === 'string' && /^https?:\/\//i.test(href);
+  return (
+    <a
+      href={href}
+      {...(isExternal ? { target: '_blank', rel: 'noreferrer noopener' } : {})}
+      {...rest}
+    >
+      {children}
+    </a>
+  );
+}
+
+const defaultComponents: Components = {
+  a: MarkdownLink,
+};
+
+/**
+ * Renders a markdown value with Notis typography. Markdown is a value type:
+ * use this anywhere markdown appears — document content, database fields,
+ * generated text. Styling comes from `.notis-markdown` rules in the SDK
+ * stylesheet and follows the portal theme variables.
+ */
+export function Markdown({ value, size = 'base', className, components }: MarkdownProps): ReactElement {
+  const classes = ['notis-markdown', size === 'sm' ? 'notis-markdown--sm' : null, className]
+    .filter(Boolean)
+    .join(' ');
+
+  return (
+    <div className={classes}>
+      <ReactMarkdown
+        remarkPlugins={[remarkGfm]}
+        components={components ? { ...defaultComponents, ...components } : defaultComponents}
+      >
+        {value}
+      </ReactMarkdown>
+    </div>
+  );
+}