@notis_ai/cli 0.2.0-beta.178.1 → 0.2.0-beta.1792022492092.1

package/src/space-harness-host.ts

@@ -0,0 +1,103 @@
+import React from 'react';
+import * as ReactDOM from 'react-dom';
+import * as ReactDOMClient from 'react-dom/client';
+import * as JSXRuntime from 'react/jsx-runtime';
+import { importBundleSource, resolveBundleRouteExport } from '../../sdk/src/bundleModule';
+import { SdkPresentation } from '../../sdk/src/presentation';
+import { createPrefetchQueue, createQueryClient } from '../../sdk/src/queryCache';
+import type { NotisRuntime } from '../../sdk/src/runtime';
+import { SPACE_VIEWER_READ_OPERATIONS } from '../../sdk/src/space';
+import type { SpaceActionOptions, SpaceDocumentBodyRequest, SpaceViewerReadOperation } from '../../sdk/src/space';
+
+type Call = { op: string; actionId?: string; ok: boolean | null; error?: string };
+const state = { mounted: false, renderStarted: false, errors: [] as Array<{ phase: string; message: string }>, runtimeCalls: [] as Call[] };
+Object.assign(window, { __harness: state, React, ReactDOM, ReactDOMClient, __ReactJSXRuntime: JSXRuntime });
+const diagnostic = (phase: string, reason: unknown) => state.errors.push({ phase,
+  message: reason instanceof Error ? reason.message : String(reason || 'Verification failed.') });
+window.addEventListener('error', event => diagnostic('window_error', event.error || event.message));
+window.addEventListener('unhandledrejection', event => diagnostic('unhandled_rejection', event.reason));
+window.addEventListener('securitypolicyviolation', event => diagnostic('security_policy', `Blocked ${event.violatedDirective}`));
+
+async function start() {
+  const response = await fetch('/snapshot', { credentials: 'omit' });
+  if (!response.ok) throw new Error('The frozen verification snapshot could not be loaded.');
+  const snapshot = await response.json();
+  const authority = structuredClone(snapshot.descriptor.space);
+  const runFixture = async (call: Call, input: unknown) => {
+    state.runtimeCalls.push(call);
+    try {
+      const result = await fetch('/fixture', { method: 'POST', credentials: 'omit',
+        headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(input), signal: AbortSignal.timeout(5_000) });
+      const payload = await result.json();
+      if (!result.ok) throw new Error(payload.message || 'No matching synthetic fixture.');
+      call.ok = true; return payload.result;
+    } catch (error) {
+      call.ok = false; call.error = error instanceof Error ? error.message : 'Verification request failed.';
+      throw error;
+    }
+  };
+  const protocolFailure = (message: string): Promise<never> => { diagnostic('protocol', message); return Promise.reject(new Error(message)); };
+  const deny = () => protocolFailure('Use a declared Space action.');
+  const queue = createPrefetchQueue(2);
+  const runtime: NotisRuntime = {
+    ...snapshot.descriptor, databases: [],
+    context: { ...snapshot.descriptor.context,
+      resourceId: snapshot.descriptor.context?.resource_id ?? snapshot.descriptor.context?.resourceId ?? null,
+      collectionItem: snapshot.descriptor.context?.collection_item ?? snapshot.descriptor.context?.collectionItem ?? null },
+    queryClient: createQueryClient({ maxEntries: 100, schedule: queue }),
+    listTools: deny, callTool: deny, request: deny,
+    callAction<T>(id: string, inputs: Record<string, unknown> = {}, options: SpaceActionOptions = {}): Promise<T> {
+      if (!Object.hasOwn(authority.actions, id)) return protocolFailure('Undeclared verification action.');
+      if ((options.readOnly || options.dedupe) && authority.actions[id].readOnly !== true) {
+        return protocolFailure('A write action cannot run as a cached read.');
+      }
+      return runFixture({ op: 'callAction', actionId: id, ok: null }, { action_id: id, inputs });
+    },
+    viewerRead: authority.viewerReads?.length ? <T,>(operation: SpaceViewerReadOperation, input: Record<string, unknown> = {}): Promise<T> => {
+      const family = Object.hasOwn(SPACE_VIEWER_READ_OPERATIONS, operation) ? SPACE_VIEWER_READ_OPERATIONS[operation] : null;
+      if (!family || !authority.viewerReads.includes(family)) return protocolFailure('Undeclared verification viewer read.');
+      return runFixture({ op: 'viewerRead', actionId: operation, ok: null }, { viewer_read: { operation, input } });
+    } : undefined,
+    shown: Object.values(authority.shows || {}).some(list => 'database' in list) ? <T,>(name: string, params: Record<string, unknown> = {}): Promise<T> => {
+      const list = authority.shows && Object.hasOwn(authority.shows, name) ? authority.shows[name] : null;
+      if (!list || !('database' in list)) return protocolFailure('Undeclared verification list.');
+      return runFixture({ op: 'shown', actionId: name, ok: null }, { shown: { name, params } });
+    } : undefined,
+    documentBody(request: SpaceDocumentBodyRequest) {
+      return runFixture({ op: 'documentBody', actionId: request?.readAction, ok: null }, { document_body: request });
+    },
+    navigate(payload) {
+      if (payload.kind !== 'space-reference' || typeof payload.alias !== 'string' || !authority.navigation?.includes(payload.alias)) {
+        return protocolFailure('Offline navigation requires a declared synthetic destination.');
+      }
+      // This observes a declaration only; no live navigation or access is claimed.
+      state.runtimeCalls.push({ op: 'navigate', actionId: payload.alias, ok: true });
+    },
+    publishActiveResource() {}, captureContextSelection() {},
+    addContext: async () => false, updateContext: async () => false, removeContext: async () => false,
+    registerTopBarSearch() {}, setTopBarSearchValue() {}, setTopBarSearchLoading() {},
+  };
+  const module = await importBundleSource(snapshot.source);
+  const view = resolveBundleRouteExport(module, ['SpaceView'], true);
+  if (!view) throw new Error('The SpaceView export is missing from this presentation.');
+  const host = document.createElement('div'); host.style.cssText = 'min-height:100vh;height:100vh';
+  const shadow = host.attachShadow({ mode: 'open' });
+  const css = document.createElement('style'); css.textContent = snapshot.css; shadow.appendChild(css);
+  const mount = document.createElement('div'); mount.setAttribute('data-notis-app-mount', 'true');
+  mount.style.cssText = 'min-height:0;height:100%'; shadow.appendChild(mount);
+  document.body.appendChild(host);
+  const controller = document.createElement('div'); document.body.appendChild(controller);
+  const mode = new URLSearchParams(location.search).get('theme') === 'dark' ? 'dark' : 'light';
+  document.documentElement.classList.toggle('dark', mode === 'dark');
+  state.renderStarted = true;
+  ReactDOMClient.createRoot(controller).render(React.createElement(SdkPresentation, {
+    mount, runtime, component: view.component, shell: module.__AppShell, theme: { mode, style: { colorScheme: mode } },
+    resetKey: snapshot.cacheKey,
+    onCommit: (hasContent: boolean) => { state.mounted = hasContent; },
+    onError: (error: Error) => { state.mounted = false; state.errors.push({ phase: 'render', message: error.message }); },
+    onProtocolError: (error: Error) => diagnostic('protocol', error),
+    fallback: (error: Error) => React.createElement('div', { role: 'alert' }, error.message),
+  }));
+}
+
+void start().catch(reason => state.errors.push({ phase: 'boot', message: reason instanceof Error ? reason.message : 'Verification did not start.' }));

package/template/.harness/index.html.tmpl

@@ -93,12 +93,10 @@
       color: hsl(var(--foreground));
       -webkit-font-smoothing: antialiased;
     }
-    #harness-status { position: fixed; top: 0; left: 0; right: 0; padding: 4px 8px; font-size: 11px; background: #111; color: #0f0; font-family: ui-monospace, SFMono-Regular, Menlo, monospace; z-index: 9999; }
-    #root { padding-top: 24px; min-height: 100vh; }
+    #root { min-height: 100vh; }
   </style>
 </head>
 <body>
-  <div id="harness-status">harness: booting</div>
   <div id="root" data-notis-app-root></div>
   <script type="module">
     const routeExport = {{ROUTE_EXPORT}};
@@ -134,10 +132,9 @@
       return Object.prototype.hasOwnProperty.call(tools, name) ? tools[name] : undefined;
     }
 
-    const status = document.getElementById('harness-status');
-    const setStatus = (msg, color = '#0f0') => {
-      status.textContent = `harness: ${msg}`;
-      status.style.color = color;
+    // Boot progress goes to the console so the rendered page stays identical to the app.
+    const setStatus = (msg, failed = false) => {
+      (failed ? console.error : console.info)(`[notis harness] ${msg}`);
     };
 
     window.__harness = {
@@ -416,13 +413,13 @@
           window.__harness.mounted = true;
           const errors = window.__harness.errors.length;
           const calls = window.__harness.runtimeCalls.length;
-          setStatus(`mounted (errors=${errors}, runtimeCalls=${calls})`, errors ? '#f55' : '#0f0');
+          setStatus(`mounted (errors=${errors}, runtimeCalls=${calls})`, errors > 0);
         } catch (error) {
           window.__harness.errors.push({
             type: 'scenario',
             message: error && error.message ? error.message : String(error),
           });
-          setStatus(`scenario failed: ${error && error.message ? error.message : String(error)}`, '#f55');
+          setStatus(`scenario failed: ${error && error.message ? error.message : String(error)}`, true);
         }
       }));
     } catch (error) {
@@ -431,7 +428,7 @@
         message: error && error.message ? error.message : String(error),
         stack: error && error.stack,
       });
-      setStatus(`boot failed: ${error && error.message ? error.message : String(error)}`, '#f55');
+      setStatus(`boot failed: ${error && error.message ? error.message : String(error)}`, true);
     }
   </script>
 </body>

package/template/app/globals.css

@@ -3,6 +3,7 @@
 @config "../tailwind.config.ts";
 @source "./";
 @source "../components";
+@source "../spaces";
 @source "../lib";
 @source "../packages/sdk/src";
 

package/src/command-specs/reports.js

@@ -1,97 +0,0 @@
-import { readFileSync, writeFileSync, rmSync } from 'node:fs';
-import { resolve, join } from 'node:path';
-import { appsCommandSpecs, appsInitHandler, appsBuildHandler, appsVerifyHandler } from './apps.js';
-import { buildArtifact, prepareAppRelease, resolveProjectDir, loadAppConfig } from '../runtime/app-platform.js';
-import { nextIdempotencyKey, runToolCommand } from './helpers.js';
-import { usageError, EXIT_CODES } from '../runtime/errors.js';
-
-async function assertReportProject(ctx) {
-  const dir = resolveProjectDir(ctx.args.dir || '.');
-  if ((await loadAppConfig(dir)).kind !== 'report') throw usageError('Set kind: "report" in notis.config.ts. Reports have no app installation or owned resources.');
-  return dir;
-}
-
-async function initReport(ctx) {
-  const dir = resolveProjectDir(ctx.args.dir || `./${ctx.args.name.toLowerCase().replace(/[^a-z0-9]+/g, '-')}`);
-  const result = await appsInitHandler({ ...ctx, args: { ...ctx.args, dir }, options: {}, output: { emitSuccess: value => value } });
-  writeFileSync(join(dir, 'notis.config.ts'), `import { defineNotisApp } from '@notis/sdk/config';
-export default defineNotisApp({
-  kind: 'report', name: ${JSON.stringify(ctx.args.name)},
-  routes: [{ path: '/', slug: 'home', name: 'Report', default: true }],
-  tools: [],
-});
-`);
-  writeFileSync(join(dir, 'app/page.tsx'), `'use client';
-import { useNotis, NotisCommentBoundary } from '@notis/sdk';
-export default function Report() {
-  const { app } = useNotis();
-  return <NotisCommentBoundary><main className="notis-app-shell space-y-6">
-    <h1 className="text-2xl font-semibold">{app?.name || 'Report'}</h1>
-    <p className="text-muted-foreground">Your report is ready to build.</p>
-  </main></NotisCommentBoundary>;
-}
-`);
-  rmSync(join(dir, 'CHANGELOG.md'), { force: true });
-  return ctx.output.emitSuccess({ ...result, command: 'reports init', hints: [
-    { command: `cd ${dir} && npm install`, reason: 'Install dependencies' },
-    { command: `notis reports build ${dir}`, reason: 'Build the standalone report' },
-  ] });
-}
-
-const localReportCommand = (command, name = command) => {
-  const app = appsCommandSpecs.find(item => item.command_path.join(' ') === `apps ${command}`);
-  return { ...app, command_path: ['reports', name],
-    summary: `${name[0].toUpperCase() + name.slice(1)} a standalone live SDK report.`,
-    when_to_use: 'Author a private standalone document using the shared view runtime; no app or database is required.',
-    args_schema: { ...app.args_schema, options: [...(app.args_schema.options || []).filter(option => !['--listing', '--from <slug>'].includes(option.flags)), ...(command === 'verify' ? [{ flags: '--document-id <id>', description: 'Saved report for live verification.' }, { flags: '--expected-revision <revision>', description: 'Saved report revision for live verification.' }] : [])] },
-    examples: [`notis reports ${name} ${command === 'init' ? '"Weekly report" ./weekly-report' : './weekly-report'}`],
-    handler: async ctx => {
-      if (command === 'init') return initReport(ctx);
-      await assertReportProject(ctx);
-      return (command === 'build' ? appsBuildHandler : appsVerifyHandler)({ ...ctx, options: { ...ctx.options, ...(name === 'preview' ? { keepOpen: true } : {}) } });
-    },
-  };
-};
-export const reportsCommandSpecs = [
-  localReportCommand('init'), localReportCommand('build'), localReportCommand('verify'), localReportCommand('verify', 'preview'),
-  {
-    command_path: ['reports', 'save'],
-    summary: 'Build, verify and save a standalone live report document.',
-    when_to_use: 'Persist an independently owned report, not an app release.',
-    args_schema: {
-      arguments: [{ token: '[dir]', key: 'dir', description: 'Report source directory.' }],
-      options: [
-        { flags: '--document-id <id>', description: 'Existing report document to update.' },
-        { flags: '--expected-revision <revision>', description: 'Current saved report revision; required for updates.' },
-        { flags: '--title <title>', description: 'Required, including updates. Document title.' },
-        { flags: '--context-file <file>', description: 'Required. UTF-8 readable report content and structure.' },
-      ],
-    },
-    examples: ['notis reports save ./weekly-report --title \"Weekly review\" --context-file ./context.md'], mutates: true, idempotent: true,
-    backend_call: { type: 'tool', name: 'LOCAL_NOTIS_SAVE_REPORT' },
-    async handler(ctx) {
-      const dir = await assertReportProject(ctx);
-      if (!ctx.options.title || !ctx.options.contextFile) throw usageError('--title and --context-file are required.');
-      if (ctx.options.documentId && (!/^\d+$/.test(String(ctx.options.expectedRevision ?? '')) || !Number.isSafeInteger(Number(ctx.options.expectedRevision)))) throw usageError('--expected-revision is required for update.');
-      const context = readFileSync(resolve(ctx.options.contextFile), 'utf8');
-      await buildArtifact(dir, { stdio: ctx.output.isMachineMode() ? 'pipe' : 'inherit' });
-      const release = prepareAppRelease(dir);
-      try {
-        if (release.manifest.routes?.length !== 1) throw usageError('Reports require exactly one SDK route.');
-        let verification;
-        const exit = await appsVerifyHandler({ ...ctx, args: { dir: release.projectDir }, options: { skipBuild: true, mode: 'stub' }, output: { ...ctx.output, isMachineMode: () => true, emitSuccess: value => { verification = value; } } });
-        if (exit !== EXIT_CODES.ok || verification?.data?.status !== 'passed') throw usageError('Report verification failed; nothing saved.');
-        const files = { ...release.files, ...Object.fromEntries(Object.entries(release.sourceFiles).map(([path, data]) => [`source/${path}`, data])) };
-        const result = await runToolCommand({ runtime: { ...ctx.runtime, timeoutMs: Math.max(ctx.runtime.timeoutMs || 0, 90000) }, toolName: 'LOCAL_NOTIS_SAVE_REPORT', mutating: true,
-          idempotencyKey: nextIdempotencyKey(ctx.globalOptions), arguments_: {
-            operation: ctx.options.documentId ? 'update' : 'create',
-            title: ctx.options.title,
-            ...(ctx.options.documentId ? { document_id: ctx.options.documentId, expected_revision: Number(ctx.options.expectedRevision) } : {}),
-            report: { schema: 'notis-report/v3', context, artifact: { manifest: release.manifest, files, encoding: 'base64' } },
-          } });
-        if (!result?.payload?.document?.id || !result.payload.document.view_revision) throw usageError('Save returned no record identity. Read back before retrying; the outcome may be unknown.');
-        return ctx.output.emitSuccess({ command: 'reports save', data: result.payload });
-      } finally { release.close(); }
-    },
-  },
-];