@markii/host 0.17.0-next.2 → 0.17.0-next.4

package/dist/host/labels.d.ts

@@ -1,21 +1,11 @@
 /**
- * `HostLabels`: the wording nouns every shared behavior module
- * (`./script-execution.ts`, `./refresh-interval.ts`) interpolates, and the
- * one concrete record per app this repo ships. Each app's `HostAdapter`
- * imports its record rather than inventing its own strings, which is what
- * collapses the survey's near-identical wording pairs (`tmp/W11-survey.md`,
- * section A4) into one template.
+ * The shared wording templates a host's shared behaviors interpolate
+ * `HostLabels` into live beside each behavior. This module holds the one
+ * label sentence that has no per-host noun. Each app owns its own
+ * `HostLabels` record and passes it as `HostAdapter.labels`.
  *
- * Pure and dependency-free: re-exported from `../browser.ts` as well as
- * `../index.ts` so VS Code's Node-free webview bundle can read it too.
+ * Pure and dependency-free.
  */
-import type { HostLabels } from './adapter.js';
-/** The VS Code extension's labels, taken from its current wording (`apps/vscode/src/script-execution.ts`, `apps/vscode/src/extension.ts`'s output channel). */
-export declare const VSCODE_LABELS: HostLabels;
-/** The Obsidian plugin's labels, taken from its current wording (`apps/obsidian/src/script-execution.ts`, docs/integration.md's host checklist). */
-export declare const OBSIDIAN_LABELS: HostLabels;
-/** The `markii` command line tool's labels: it has no persistent preview panel, and its diagnostics surface is stderr, gated behind `--verbose` for anything short of a failure (`apps/cli/src/main.ts`). */
-export declare const CLI_LABELS: HostLabels;
 /**
  * The quiet marker a rendered note shows when its `uses:` list names packs
  * this host has not installed (docs/packs.md). One sentence for every host;

package/dist/host/labels.js

@@ -1,25 +1,11 @@
-/** The VS Code extension's labels, taken from its current wording (`apps/vscode/src/script-execution.ts`, `apps/vscode/src/extension.ts`'s output channel). */
-export const VSCODE_LABELS = {
-    appNoun: 'extension',
-    previewNoun: 'the Markii preview',
-    diagnosticsSurface: 'the Markii output channel',
-    deviceNoun: 'this device',
-    settingName: 'markii.scriptsDisabled',
-};
-/** The Obsidian plugin's labels, taken from its current wording (`apps/obsidian/src/script-execution.ts`, docs/integration.md's host checklist). */
-export const OBSIDIAN_LABELS = {
-    appNoun: 'plugin',
-    previewNoun: 'the Markii preview',
-    diagnosticsSurface: 'the Markii diagnostics',
-    deviceNoun: 'this device',
-};
-/** The `markii` command line tool's labels: it has no persistent preview panel, and its diagnostics surface is stderr, gated behind `--verbose` for anything short of a failure (`apps/cli/src/main.ts`). */
-export const CLI_LABELS = {
-    appNoun: 'command line tool',
-    previewNoun: 'the rendered note',
-    diagnosticsSurface: 'stderr',
-    deviceNoun: 'this device',
-};
+/**
+ * The shared wording templates a host's shared behaviors interpolate
+ * `HostLabels` into live beside each behavior. This module holds the one
+ * label sentence that has no per-host noun. Each app owns its own
+ * `HostLabels` record and passes it as `HostAdapter.labels`.
+ *
+ * Pure and dependency-free.
+ */
 /**
  * The quiet marker a rendered note shows when its `uses:` list names packs
  * this host has not installed (docs/packs.md). One sentence for every host;

package/dist/host/pack-archive.d.ts

@@ -1,14 +1,8 @@
 import type { PackArchiveContents, PackArchiveError } from '@markii/pack';
 /** One line describing why `openPackArchive` rejected an archive, for a host's install-diagnostics wording. Passes `kind: 'zip'`'s and `kind: 'missing-entry'`'s message through verbatim (already specific); summarizes a manifest failure plainly. */
 export declare function describeArchiveError(error: PackArchiveError): string;
-/** The filesystem write seam `writeArchiveContents` needs (`./pack-install.ts`). Deliberately narrow: extracting an archive only ever creates files under a directory it first clears, it never reads back or deletes anything else. */
-export interface ArchiveExtractFs {
-    /** Removes `absolutePath` and everything under it, or resolves quietly if it does not exist. Never rejects: a directory that fails to clear is treated the same as a fresh one, and the write that follows fails loudly on its own if the path is genuinely unusable. */
-    readonly removeDirectory: (absolutePath: string) => Promise<void>;
-    /** Creates a directory and any missing parents. May reject on a genuine I/O failure. */
-    readonly makeDirectory: (absolutePath: string) => Promise<void>;
-    readonly writeFile: (absolutePath: string, bytes: Uint8Array) => Promise<void>;
-}
+/** Writes one file and creates its missing parent folders: `HostAdapter.writeFile`. */
+export type ArchiveFileWriter = (absolutePath: string, bytes: Uint8Array) => Promise<void>;
 /**
  * Writes a validated archive's contents into `destinationDir`: `pack.json`
  * (the parsed manifest, re-serialized: `openPackArchive` keeps only the
@@ -17,7 +11,7 @@ export interface ArchiveExtractFs {
  * copy), `webview.js`, `webview.css` and `terminal.js` when the archive has them, and
  * `scripts/*` when it ships any. Does NOT clear `destinationDir` first;
  * a caller that needs a clean re-extract (a reinstall replacing an
- * existing pack) calls `fs.removeDirectory` itself before this.
+ * existing pack) removes the folder itself before this.
  *
  * PATH JAIL: `@markii/pack`'s `openPackArchive` has already rejected any
  * entry whose name escapes the archive (`../`, an absolute path) or
@@ -27,4 +21,4 @@ export interface ArchiveExtractFs {
  * `webview.css`, or a `scripts/`-relative Lua module name), never from
  * anything read back out of the zip's raw entry names.
  */
-export declare function writeArchiveContents(archive: PackArchiveContents, destinationDir: string, fs: ArchiveExtractFs): Promise<void>;
+export declare function writeArchiveContents(archive: PackArchiveContents, destinationDir: string, writeFile: ArchiveFileWriter): Promise<void>;

package/dist/host/pack-archive.js

@@ -1,24 +1,17 @@
 /**
  * `.mkp` pack archive handling, merged from `apps/vscode/src/packs/archive-packs.ts`
- * and `apps/obsidian/src/packs/archive-packs.ts` (survey finding A8). The
- * orchestrator diffed the two files directly (not through the survey's
- * earlier, unverified guess) and found them functionally byte-identical:
- * the same three exports (`describeArchiveError`, `writeArchiveContents`,
- * `ArchiveExtractFs`), the same implementation, the same path-jail
- * reasoning. They differed only in doc-comment wording (which host's
- * install command they described) and one em dash in a comment, which
- * carries no behavior. See `tmp/W11-phase1b.md` for the exact diff output.
+ * and `apps/obsidian/src/packs/archive-packs.ts`. It exports
+ * `describeArchiveError`, `writeArchiveContents` and `ArchiveFileWriter`.
  *
  * This module bridges `@markii/pack`'s in-memory archive reader
  * (`openPackArchive`, never modified here) into the write a pack install
  * needs: extracting a validated archive's contents onto disk, under
  * whichever install root the calling host names (`HostPackSource.installRoot`).
  *
- * Environment-free (`ArchiveExtractFs` is an injected seam). The real
- * Node-backed one, `createNodeArchiveExtractFs`, lives in `../node-fs.ts`
- * and is exported from `@markii/host/node`.
+ * Environment-free: the write goes through the host adapter's `writeFile`,
+ * which creates any missing parent folder.
  */
-import { dirnamePath, joinPath } from '../path-util.js';
+import { joinPath } from '../path-util.js';
 /** One line describing why `openPackArchive` rejected an archive, for a host's install-diagnostics wording. Passes `kind: 'zip'`'s and `kind: 'missing-entry'`'s message through verbatim (already specific); summarizes a manifest failure plainly. */
 export function describeArchiveError(error) {
     if (error.kind === 'zip')
@@ -35,7 +28,7 @@ export function describeArchiveError(error) {
  * copy), `webview.js`, `webview.css` and `terminal.js` when the archive has them, and
  * `scripts/*` when it ships any. Does NOT clear `destinationDir` first;
  * a caller that needs a clean re-extract (a reinstall replacing an
- * existing pack) calls `fs.removeDirectory` itself before this.
+ * existing pack) removes the folder itself before this.
  *
  * PATH JAIL: `@markii/pack`'s `openPackArchive` has already rejected any
  * entry whose name escapes the archive (`../`, an absolute path) or
@@ -45,24 +38,22 @@ export function describeArchiveError(error) {
  * `webview.css`, or a `scripts/`-relative Lua module name), never from
  * anything read back out of the zip's raw entry names.
  */
-export async function writeArchiveContents(archive, destinationDir, fs) {
-    await fs.makeDirectory(destinationDir);
+export async function writeArchiveContents(archive, destinationDir, writeFile) {
     const encoder = new TextEncoder();
-    await fs.writeFile(joinPath(destinationDir, 'pack.json'), encoder.encode(JSON.stringify(archive.manifest, null, 2) + '\n'));
-    await fs.writeFile(joinPath(destinationDir, 'webview.js'), archive.scriptBytes);
+    await writeFile(joinPath(destinationDir, 'pack.json'), encoder.encode(JSON.stringify(archive.manifest, null, 2) + '\n'));
+    await writeFile(joinPath(destinationDir, 'webview.js'), archive.scriptBytes);
     if (archive.stylesheetBytes !== undefined) {
-        await fs.writeFile(joinPath(destinationDir, 'webview.css'), archive.stylesheetBytes);
+        await writeFile(joinPath(destinationDir, 'webview.css'), archive.stylesheetBytes);
     }
     if (archive.terminalScriptBytes !== undefined) {
-        await fs.writeFile(joinPath(destinationDir, 'terminal.js'), archive.terminalScriptBytes);
+        await writeFile(joinPath(destinationDir, 'terminal.js'), archive.terminalScriptBytes);
     }
     const moduleNames = Object.keys(archive.scriptModules);
     if (moduleNames.length > 0) {
         const scriptsDir = joinPath(destinationDir, 'scripts');
         for (const name of moduleNames) {
             const target = joinPath(scriptsDir, name);
-            await fs.makeDirectory(dirnamePath(target));
-            await fs.writeFile(target, archive.scriptModules[name]);
+            await writeFile(target, archive.scriptModules[name]);
         }
     }
 }

package/dist/host/pack-install.d.ts

@@ -1,5 +1,5 @@
-import type { ArchiveExtractFs } from './pack-archive.js';
 import type { HostAdapter, HostLabels } from './adapter.js';
+import type { InstallPackOutcome as HostInstallPackOutcome } from './create-host.js';
 /** Whether a directory already exists under the install root, injected so this module needs no real disk to test. */
 export type PackDirectoryExists = (absolutePath: string) => Promise<boolean>;
 export interface InstallPackFromArchiveOptions {
@@ -9,7 +9,8 @@ export interface InstallPackFromArchiveOptions {
     /** This host's own pack-install directory (`HostPackSource.installRoot()`). Each installed pack gets a subdirectory named by its namespace, since two packs can never share one (docs/packs.md's collision rule), which makes "is this namespace already installed" a plain directory check. */
     readonly installRoot: string;
     readonly exists: PackDirectoryExists;
-    readonly extractFs: ArchiveExtractFs;
+    /** Removes the installed folder before a replacing install (`HostPackSource.removeFolder`). Called only when the namespace is already installed. */
+    readonly removeFolder: (absolutePath: string) => Promise<void>;
     /**
      * Namespaces this install may never claim (`HostPackSource.reservedNamespaces()`).
      * Empty for a host with no reserved set (VS Code). Checked before the
@@ -17,22 +18,10 @@ export interface InstallPackFromArchiveOptions {
      */
     readonly reservedNamespaces: ReadonlySet<string>;
 }
-export type InstallPackOutcome = {
-    readonly kind: 'installed';
-    readonly packName: string;
-    readonly installedDir: string;
-    readonly replaced: boolean;
-} | {
-    readonly kind: 'declined';
-    readonly step: 'consent' | 'replace';
-    readonly packName: string;
-} | {
-    readonly kind: 'reserved';
-    readonly packName: string;
-} | {
-    readonly kind: 'rejected';
-    readonly reason: string;
-};
+/** What one install attempt produced, in the shape `createMarkiiHost(...).installPack` returns (minus `unsupported`, which only the host behavior can say). */
+export type InstallAttemptOutcome = Exclude<HostInstallPackOutcome, {
+    readonly kind: 'unsupported';
+}>;
 /**
  * Never throws: a validation failure, a declined prompt, or a write
  * failure all come back as a structured outcome. Order: validate the
@@ -47,7 +36,7 @@ export type InstallPackOutcome = {
  * a host that can only show a non-blocking surface must deny rather than
  * assume yes.
  */
-export declare function installPackFromArchive(adapter: HostAdapter, options: InstallPackFromArchiveOptions): Promise<InstallPackOutcome>;
+export declare function installPackFromArchive(adapter: HostAdapter, options: InstallPackFromArchiveOptions): Promise<InstallAttemptOutcome>;
 /**
  * The consent prompt's wording (AGENTS.md's product principles: "clean is
  * not silent," and a consent step must say plainly what it authorizes).
@@ -67,8 +56,7 @@ export declare function installConsentMessage(packName: string, labels: HostLabe
 /**
  * The collision confirmation's wording: a namespace already installed,
  * asked before replacing it. CANONICAL WORDING: "removes" (VS Code's prior
- * wording) over Obsidian's prior "deletes" — see `tmp/W11-phase1b.md`'s
- * before/after table for the exact strings this replaces.
+ * wording) over Obsidian's prior "deletes".
  */
 export declare function installReplaceConfirmMessage(packName: string): string;
 /**
@@ -83,6 +71,6 @@ export declare function installReplaceConfirmMessage(packName: string): string;
  * `markii.packs` before anything loads it), so it doesn't. Defaults to
  * `false`.
  */
-export declare function installPackMessage(outcome: InstallPackOutcome, archivePath: string, labels: HostLabels, reloadsAutomatically?: boolean): string;
+export declare function installPackMessage(outcome: HostInstallPackOutcome, archivePath: string, labels: HostLabels, reloadsAutomatically?: boolean): string;
 /** The full diagnostics-surface detail for one install attempt (AGENTS.md's "clean is not silent": the other of a failure's two homes). */
-export declare function installPackDiagnosticLines(outcome: InstallPackOutcome, archivePath: string): string[];
+export declare function installPackDiagnosticLines(outcome: InstallAttemptOutcome, archivePath: string): string[];

package/dist/host/pack-install.js

@@ -1,11 +1,9 @@
 /**
  * The `.mkp` pack-install decision logic, merged from
  * `apps/vscode/src/packs/install-pack.ts` and
- * `apps/obsidian/src/packs/install-pack.ts` (survey finding A2: the single
- * biggest duplication finding in the survey — identical function names,
- * identical types, near-identical wording, differing only in that
- * Obsidian refuses a bundled-namespace archive before the consent prompt
- * and VS Code has no such concept).
+ * `apps/obsidian/src/packs/install-pack.ts`. Obsidian refuses a
+ * bundled-namespace archive before the consent prompt and VS Code has no
+ * such concept.
  *
  * `reservedNamespaces` generalizes Obsidian's `bundledNamespaces`: it
  * defaults to empty, so VS Code's behavior is byte-identical to before
@@ -41,7 +39,7 @@ function describeThrown(err) {
  * assume yes.
  */
 export async function installPackFromArchive(adapter, options) {
-    const { archiveBytes, archivePath, installRoot, exists, extractFs, reservedNamespaces, } = options;
+    const { archiveBytes, archivePath, installRoot, exists, removeFolder, reservedNamespaces, } = options;
     const opened = await openPackArchive(archiveBytes);
     if (!opened.ok) {
         return {
@@ -51,7 +49,7 @@ export async function installPackFromArchive(adapter, options) {
     }
     const packName = opened.archive.manifest.name;
     if (reservedNamespaces.has(packName)) {
-        return { kind: 'reserved', packName };
+        return { kind: 'reserved', namespace: packName };
     }
     let consented;
     try {
@@ -67,7 +65,7 @@ export async function installPackFromArchive(adapter, options) {
         return { kind: 'rejected', reason: describeThrown(err) };
     }
     if (!consented) {
-        return { kind: 'declined', step: 'consent', packName };
+        return { kind: 'declined', step: 'consent', namespace: packName };
     }
     const targetDir = joinPath(installRoot, packName);
     let alreadyInstalled;
@@ -93,13 +91,14 @@ export async function installPackFromArchive(adapter, options) {
             return { kind: 'rejected', reason: describeThrown(err) };
         }
         if (!proceed) {
-            return { kind: 'declined', step: 'replace', packName };
+            return { kind: 'declined', step: 'replace', namespace: packName };
         }
         replaced = true;
     }
     try {
-        await extractFs.removeDirectory(targetDir);
-        await writeArchiveContents(opened.archive, targetDir, extractFs);
+        if (alreadyInstalled)
+            await removeFolder(targetDir);
+        await writeArchiveContents(opened.archive, targetDir, (path, bytes) => adapter.writeFile(path, bytes));
     }
     catch (err) {
         return {
@@ -108,7 +107,12 @@ export async function installPackFromArchive(adapter, options) {
         };
     }
     await trustInstalledPack(adapter, packName, targetDir);
-    return { kind: 'installed', packName, installedDir: targetDir, replaced };
+    return {
+        kind: 'installed',
+        namespace: packName,
+        installedDir: targetDir,
+        replaced,
+    };
 }
 /**
  * The consent prompt's wording (AGENTS.md's product principles: "clean is
@@ -131,8 +135,7 @@ export function installConsentMessage(packName, labels) {
 /**
  * The collision confirmation's wording: a namespace already installed,
  * asked before replacing it. CANONICAL WORDING: "removes" (VS Code's prior
- * wording) over Obsidian's prior "deletes" — see `tmp/W11-phase1b.md`'s
- * before/after table for the exact strings this replaces.
+ * wording) over Obsidian's prior "deletes".
  */
 export function installReplaceConfirmMessage(packName) {
     return `A pack named "${packName}" is already installed. Replacing it removes the installed copy and cannot be undone.`;
@@ -150,21 +153,21 @@ export function installReplaceConfirmMessage(packName) {
  * `false`.
  */
 export function installPackMessage(outcome, archivePath, labels, reloadsAutomatically = false) {
-    if (outcome.kind === 'rejected') {
+    if (outcome.kind === 'rejected' || outcome.kind === 'unsupported') {
         return `Markii: could not install a pack from "${archivePath}". Open ${labels.diagnosticsSurface} for details.`;
     }
     if (outcome.kind === 'reserved') {
-        return `Markii: "${outcome.packName}" is built in and cannot be installed. Nothing was installed.`;
+        return `Markii: "${outcome.namespace}" is built in and cannot be installed. Nothing was installed.`;
     }
     if (outcome.kind === 'declined') {
         return outcome.step === 'consent'
-            ? `Markii: install of "${outcome.packName}" cancelled. Nothing was installed.`
-            : `Markii: install of "${outcome.packName}" cancelled. The existing pack was kept.`;
+            ? `Markii: install of "${outcome.namespace}" cancelled. Nothing was installed.`
+            : `Markii: install of "${outcome.namespace}" cancelled. The existing pack was kept.`;
     }
     const reloadSuffix = reloadsAutomatically ? ' Markii packs reloaded.' : '';
     return outcome.replaced
-        ? `Markii: reinstalled pack "${outcome.packName}".${reloadSuffix}`
-        : `Markii: installed pack "${outcome.packName}".${reloadSuffix}`;
+        ? `Markii: reinstalled pack "${outcome.namespace}".${reloadSuffix}`
+        : `Markii: installed pack "${outcome.namespace}".${reloadSuffix}`;
 }
 /** The full diagnostics-surface detail for one install attempt (AGENTS.md's "clean is not silent": the other of a failure's two homes). */
 export function installPackDiagnosticLines(outcome, archivePath) {
@@ -175,15 +178,15 @@ export function installPackDiagnosticLines(outcome, archivePath) {
     }
     if (outcome.kind === 'reserved') {
         return [
-            `Install pack from file refused "${archivePath}": pack "${outcome.packName}" is a reserved namespace and cannot be installed.`,
+            `Install pack from file refused "${archivePath}": pack "${outcome.namespace}" is a reserved namespace and cannot be installed.`,
         ];
     }
     if (outcome.kind === 'declined') {
         return [
-            `Install pack from file cancelled for "${archivePath}" (pack "${outcome.packName}") at the ${outcome.step} step; nothing was installed.`,
+            `Install pack from file cancelled for "${archivePath}" (pack "${outcome.namespace}") at the ${outcome.step} step; nothing was installed.`,
         ];
     }
     return [
-        `Install pack from file installed pack "${outcome.packName}" from "${archivePath}" to ${outcome.installedDir}${outcome.replaced ? ' (replacing the previous install)' : ''}.`,
+        `Install pack from file installed pack "${outcome.namespace}" from "${archivePath}" to ${outcome.installedDir}${outcome.replaced ? ' (replacing the previous install)' : ''}.`,
     ];
 }

package/dist/host/pack-load.d.ts

@@ -1,8 +1,7 @@
 /**
  * The shared discovery path behind `loadPacks`, merged from
  * `apps/vscode/src/packs/discover-configured-packs.ts` and
- * `apps/obsidian/src/packs/discover-configured-packs.ts` (survey finding
- * A3) plus the discovery-and-namespace-collection half both apps'
+ * `apps/obsidian/src/packs/discover-configured-packs.ts` plus the discovery-and-namespace-collection half both apps'
  * `packs/pack-context.ts` also duplicate on top of it.
  *
  * Pack POLICY — which folders are even candidates before any content is

package/dist/host/pack-trust-behavior.js

@@ -12,7 +12,7 @@
  * already asked), enabling a present folder asks the same prompt, and
  * disabling or removing withdraws the entry.
  *
- * A host that declares `trust: 'none'` (or omits the field) trusts every
+ * A host that declares `trust: 'none'` trusts every
  * folder its own policy authorizes, and every function here is inert for
  * it. Neutral on purpose: only the adapter's file and state primitives
  * are used.

package/dist/host/refresh-interval.d.ts

@@ -3,9 +3,7 @@
  * merged from `apps/vscode/src/refresh-interval.ts` (the input-box
  * parse/validate half) and `apps/obsidian/src/local-settings.ts`'s
  * `refreshIntervalMsFromSeconds`/`MIN_REFRESH_INTERVAL_SECONDS` (the
- * read-side clamp half) — survey finding A7: the constant was duplicated
- * verbatim, with Obsidian's own comment noting it mirrors VS Code's, and
- * the clamp-not-reject policy was duplicated as both prose and behavior.
+ * read-side clamp half).
  *
  * The policy: a positive value under `MIN_REFRESH_INTERVAL_SECONDS` is
  * still ACCEPTED as typed (a host's own settings UI must not silently

package/dist/host/refresh-interval.js

@@ -3,9 +3,7 @@
  * merged from `apps/vscode/src/refresh-interval.ts` (the input-box
  * parse/validate half) and `apps/obsidian/src/local-settings.ts`'s
  * `refreshIntervalMsFromSeconds`/`MIN_REFRESH_INTERVAL_SECONDS` (the
- * read-side clamp half) — survey finding A7: the constant was duplicated
- * verbatim, with Obsidian's own comment noting it mirrors VS Code's, and
- * the clamp-not-reject policy was duplicated as both prose and behavior.
+ * read-side clamp half).
  *
  * The policy: a positive value under `MIN_REFRESH_INTERVAL_SECONDS` is
  * still ACCEPTED as typed (a host's own settings UI must not silently

package/dist/host/run-behavior.d.ts

@@ -1,7 +1,6 @@
 /**
  * The `run` behavior's host-shaped seams, built from a `HostAdapter`:
- * this is where survey findings A1 and A6 stop being duplicated three
- * times over.
+ * the grant prompts and the isolate spawn live here once for every host.
  *
  * A1: `apps/vscode/src/preview-panel.ts`'s `promptHostAdapter` /
  * `promptUnknownHostsAdapter` / `promptManyHostsAdapter`,
@@ -24,7 +23,7 @@
  * `runOnce` (the existing, already-shared grant-flow-plus-spawn
  * orchestration) and writes the `RunTrace` through `adapter.now()` rather
  * than `Date.now()`, so a fixed clock in a test fake makes the trace
- * byte-stable (batch 11 Phase 3's requirement).
+ * byte-stable.
  */
 import type { RunTrigger } from '@markii/runtime';
 import { type PromptHost, type PromptManyHosts, type PromptUnknownHosts } from '../run/grant-flow.js';
@@ -54,7 +53,7 @@ export declare function promptsFromAdapter(adapter: HostAdapter): {
 };
 /**
  * The one `spawnRun` adapter every Node host (`apps/vscode`, `apps/cli`)
- * used to duplicate (survey A6), plus the browser-isolate path Obsidian's
+ * needs, plus the browser-isolate path Obsidian's
  * own `spawnRun` wrapper needed. Dispatches on `HostIsolate`'s
  * discriminated union: a `'node'` host supplies only a worker path; a
  * `'browser'` host supplies an async, disposable `IsolateSpawner` factory,

package/dist/host/run-behavior.js

@@ -63,9 +63,23 @@ function noIsolateResult(cacheSnapshot) {
         cacheSnapshot,
     };
 }
+/** A synthetic `RunResult` for a node isolate whose worker file cannot be located. The run never throws. */
+function workerMissingResult(cacheSnapshot, error) {
+    return {
+        values: {},
+        failures: [
+            {
+                name: '<document>',
+                message: `the script worker could not be located: ${error instanceof Error ? error.message : String(error)}`,
+                kind: 'capability-denied',
+            },
+        ],
+        cacheSnapshot,
+    };
+}
 /**
  * The one `spawnRun` adapter every Node host (`apps/vscode`, `apps/cli`)
- * used to duplicate (survey A6), plus the browser-isolate path Obsidian's
+ * needs, plus the browser-isolate path Obsidian's
  * own `spawnRun` wrapper needed. Dispatches on `HostIsolate`'s
  * discriminated union: a `'node'` host supplies only a worker path; a
  * `'browser'` host supplies an async, disposable `IsolateSpawner` factory,
@@ -75,9 +89,16 @@ export async function spawnRunViaAdapter(isolate, options) {
     if (!isolate)
         return noIsolateResult(options.cacheSnapshot);
     if (isolate.kind === 'node') {
+        let workerPath;
+        try {
+            workerPath = isolate.workerPath();
+        }
+        catch (error) {
+            return workerMissingResult(options.cacheSnapshot, error);
+        }
         return spawnRunHost({
             ...options,
-            workerPath: isolate.workerPath(),
+            workerPath,
             spawnIsolate: isolate.spawnIsolate,
         });
     }

package/dist/host/script-execution.d.ts

@@ -1,7 +1,7 @@
 /**
  * The device-level script-execution switch and every sentence it can
  * produce, merged from `apps/vscode/src/script-execution.ts` and
- * `apps/obsidian/src/script-execution.ts` (survey finding A4: same file
+ * `apps/obsidian/src/script-execution.ts` (same file
  * name, same four exports, doc comments sharing the same "WHAT IT IS /
  * WHY DEVICE-LOCAL / WHY THE WORDING LIVES HERE" structure, differing
  * only in a handful of words).

package/dist/html-engine.js

@@ -1,9 +1,9 @@
 /**
- * The `@markii/html`-backed `HtmlExportEngine`. Kept out of the main entry
- * (it is the one module that carries the static HTML renderer); a host that
+ * The `@markii/host/html-engine` entry: the `@markii/html`-backed
+ * `HtmlExportEngine`. Kept out of the main and `/node` entries (it is the
+ * one module that needs the optional `@markii/html` peer); a host that
  * exports HTML builds it here and hands it to `createMarkiiHost`'s
- * `htmlEngine` option or to `buildNoteExport`. Reached through
- * `@markii/host/node`.
+ * `htmlEngine` option or to `buildNoteExport`.
  */
 import { escapeHtml, exportHtmlDocument, renderMarkToHtml } from '@markii/html';
 import { defaultHtmlRegistry } from '@markii/html/components';