@stravica-ai/digital-operator-pa 0.1.47 → 0.1.49

package/dist/engineering-pa-scaffold/src/generator.mjs

@@ -7,13 +7,19 @@
 // kind: 'dir' (mkdir -p) | 'file' (write file with contents) | 'json'
 // (stringify + write).
 
-import { existsSync, readFileSync } from 'node:fs';
+import { existsSync, readFileSync, statSync } from 'node:fs';
 import { readFile, readdir } from 'node:fs/promises';
 import { createRequire } from 'node:module';
-import { dirname, join, resolve } from 'node:path';
+import { hostname, platform } from 'node:os';
+import { delimiter as pathDelimiter, dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 import { emptyEnvelope, renderEnvelope } from '../../engineering-pa-core/src/autonomy/envelope.mjs';
+import {
+  DEFAULT_CADENCE_HOURS,
+  distillationScheduleFilename,
+  distillationScheduleId,
+} from '../../engineering-pa-core/src/distill/health.mjs';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const requireFromHere = createRequire(import.meta.url);
@@ -553,6 +559,13 @@ export function buildOnboardingStateJson(config) {
       profileIntake: 'pending',
       aliasOffer: 'pending',
       workspaceOffer: 'pending',
+      // Mandatory — no opt-out. The distillation sweep is the only thing
+      // that turns staged observations into knowledge docs; without an
+      // installed schedule the whole self-learning loop is dead. The
+      // /onboard walkthrough runs `scheduler install` on the scaffolded
+      // schedule file and triggers one real run before it marks this
+      // step ok. See packages/core/docs/commands/onboard.md.
+      librarianSchedule: 'pending',
       atlassianOffer: 'pending',
     },
     completedAt: null,
@@ -567,10 +580,180 @@ export function buildGitkeep() {
   return '';
 }
 
+/**
+ * Pick the OS-native scheduler backend the scaffold writes into the
+ * distillation-sweep schedule file. macOS -> launchd, Linux -> cron,
+ * Windows -> schtasks. Every other platform lands on `null`, which
+ * makes `scheduler install` fall back to detect + refusal (with a
+ * clean stderr message).
+ *
+ * Kept as a switch on `process.platform` rather than a call to
+ * scheduler/detect.mjs: the schedule file is written once at scaffold
+ * time and shipped in the repo, so the backend choice must be stable
+ * (a `detect()` reading brew-installed cron vs launchd is a per-host
+ * moment-in-time decision that should not be baked into a tracked
+ * file). Every host later runs `scheduler install --force-host` from
+ * its own real backend; the schedule file's `backend` field just names
+ * the default. Exported for tests.
+ *
+ * @param {string} [plat] - override for tests; defaults to `process.platform`.
+ * @returns {'launchd'|'cron'|'schtasks'|null}
+ */
+export function defaultSchedulerBackend(plat = platform()) {
+  if (plat === 'darwin') return 'launchd';
+  if (plat === 'linux') return 'cron';
+  if (plat === 'win32') return 'schtasks';
+  return null;
+}
+
+// System paths the launchd defaults already carry (see
+// packages/core/src/scheduler/install.mjs withLaunchdDefaults). If
+// `claude` resolves inside any of these, no explicit PATH is needed on
+// the scaffolded schedule — the installer's baked-in PATH covers it.
+const LAUNCHD_DEFAULT_PATHS = [
+  '/opt/homebrew/bin',
+  '/usr/local/bin',
+  '/usr/bin',
+  '/bin',
+  '/usr/sbin',
+  '/sbin',
+];
+
+/**
+ * Walk `process.env.PATH` at scaffold time looking for the `claude`
+ * executable. Returns the resolved directory, or null if nothing on
+ * PATH matches. The scaffold uses this to decide whether to bake an
+ * explicit `environment.PATH` into the schedule file (needed when the
+ * operator's claude install lives somewhere the launchd default PATH
+ * would not find — e.g. ~/.local/bin from a curl-installer). Exported
+ * for tests, which drive it with a fake PATH.
+ *
+ * @param {object} [opts]
+ * @param {string} [opts.pathEnv] - override for tests; defaults to process.env.PATH.
+ * @param {string} [opts.binName] - override for tests; defaults to `claude`.
+ * @returns {string|null}
+ */
+export function resolveClaudeBinDir({ pathEnv, binName = 'claude' } = {}) {
+  const raw = pathEnv ?? process.env.PATH ?? '';
+  const dirs = raw.split(pathDelimiter).filter(Boolean);
+  for (const dir of dirs) {
+    const candidate = join(dir, binName);
+    let st;
+    try {
+      st = statSync(candidate);
+    } catch {
+      continue;
+    }
+    if (!st.isFile()) continue;
+    if ((st.mode & 0o111) === 0) continue;
+    return dir;
+  }
+  return null;
+}
+
+/**
+ * Build the operator repo's scaffolded `schedules/<paName>-distillation-sweep.json`.
+ *
+ * This is the single load-bearing artefact that makes the whole
+ * self-learning loop work in a solo instance. Without a scheduled
+ * sweep, `agents/<paName>/staging/` fills up forever and no knowledge
+ * doc is ever distilled. The `/onboard` walkthrough runs
+ * `scheduler install` on this file (with --force-host to survive the
+ * macOS hostname flap) as a mandatory step before onboarding is marked
+ * complete.
+ *
+ * Shape choices, with the estate lore they close:
+ *   - `command: node node_modules/@stravica-ai/digital-operator-pa/bin/distill run`.
+ *     Absolute node path is resolved by the scheduler at install time
+ *     (`resolveLaunchdArgv0('node', ...)` returns `process.execPath`);
+ *     the bin path goes through the stable `node_modules/@stravica-ai/…`
+ *     symlink rather than the versioned `.pnpm` store path, so a
+ *     package upgrade does not silently break the schedule (Dex lore
+ *     w-2026-07-16-006).
+ *   - `workingDirectory` is the absolute `targetDir`. No `${DAVE_ROOT}`
+ *     token — a solo instance is not the estate and does not have that
+ *     env var; a fresh `os.hostname()`-bound scheduler install with an
+ *     unset DAVE_ROOT would otherwise fall through to a bogus
+ *     `node_modules`-rooted path (`validateWorkDir` refuses that at
+ *     install time — good, but the scaffold should not create that
+ *     failure mode in the first place).
+ *   - `host` is the current machine's hostname as `os.hostname()`
+ *     computes it, so `scheduler install` without `--force-host` picks
+ *     up the file cleanly on the scaffolded machine, and refuses on any
+ *     other. The /onboard step passes `--force-host` unconditionally
+ *     because macOS hostnames flap between the DHCP name and the
+ *     configured name (w018 hostname-flap precedent), and a well-formed
+ *     refusal at first-run onboarding is the worst possible operator
+ *     experience.
+ *   - `enabled: true`. This is not opt-in.
+ *   - `schedule: '0 * / 4 * * *'` — every 4 hours, on the hour. Matches
+ *     the estate's original distillation-sweep cadence and cheap enough
+ *     that a solo instance never notices the tick.
+ *   - `environment.PATH` is included ONLY when `claude` resolves at
+ *     scaffold time OUTSIDE the launchd default PATH set (e.g. ~/.local/bin
+ *     from the curl installer). In the common brew case it's covered by
+ *     `withLaunchdDefaults()` and setting an explicit PATH would
+ *     override — not merge — that default and lose the standard
+ *     directories (w-2026-08-05 EnvironmentVariables trap).
+ *
+ * @param {object} config
+ * @param {string} config.paName
+ * @param {string} config.targetDir - absolute
+ * @param {object} [seams]
+ * @param {string} [seams.host] - hostname override (for tests)
+ * @param {'launchd'|'cron'|'schtasks'|null} [seams.backend] - override (for tests)
+ * @param {string|null} [seams.claudeBinDir] - override (for tests)
+ * @returns {object}
+ */
+export function buildDistillationScheduleJson(config, seams = {}) {
+  const backend = seams.backend !== undefined ? seams.backend : defaultSchedulerBackend();
+  const host = seams.host !== undefined ? seams.host : hostname();
+  const claudeBinDir = seams.claudeBinDir !== undefined
+    ? seams.claudeBinDir
+    : resolveClaudeBinDir();
+
+  const out = {
+    id: distillationScheduleId(config.paName),
+    agent: config.paName,
+    name: `Librarian distillation sweep (every ${DEFAULT_CADENCE_HOURS}h)`,
+    schedule: `0 */${DEFAULT_CADENCE_HOURS} * * *`,
+    command: 'node node_modules/@stravica-ai/digital-operator-pa/bin/distill run',
+    workingDirectory: config.targetDir,
+    enabled: true,
+    backend,
+    host,
+    description: [
+      `Solo-instance librarian distillation sweep for ${config.paName}. Turns the`,
+      'staged observations under agents/<paName>/staging/ into promoted knowledge',
+      'docs under operator/knowledge/, then invalidates the retrieval graph so the',
+      'next `pa knowledge search` sees the new material. Installed by the /onboard',
+      'walkthrough (mandatory step) via `scheduler install --force-host`. Removing',
+      'this schedule silently kills the PA\'s self-learning loop; reinstate it by',
+      're-running /onboard.',
+    ].join(' '),
+    // DAVE_ROOT MUST be set explicitly — the scheduler's withLaunchdDefaults()
+    // falls back to `resolve(__dirname, '..','..','..')` which under a
+    // published tarball lands inside the versioned .pnpm store path and
+    // `validateLaunchdDaveRoot` refuses (exit 2) at install time. The
+    // solo colleague running `scheduler install` from their instance
+    // shell also does not typically have DAVE_ROOT set. Baking it into
+    // the schedule closes both cases (w-2026-07-15-003 + w-2026-07-16-006
+    // trap class). PATH is only added when `claude` lives outside the
+    // launchd default PATH set.
+    environment: { DAVE_ROOT: config.targetDir },
+  };
+
+  if (claudeBinDir && !LAUNCHD_DEFAULT_PATHS.includes(claudeBinDir)) {
+    out.environment.PATH = [claudeBinDir, ...LAUNCHD_DEFAULT_PATHS].join(pathDelimiter);
+  }
+
+  return out;
+}
+
 /**
  * Build the .claude/settings.json contents.
  *
- * Two things:
+ * Three things:
  *   1. `permissions.deny` for the built-in `deep-research` skill and
  *      workflow. The core operating model (Bucket 4) directs the PA to
  *      the `/research` verb, which persists a session and promotes
@@ -584,12 +767,16 @@ export function buildGitkeep() {
  *      scaffold ships the wiring inert. A per-repo overlay slot is
  *      scaffolded alongside as `.claude/coordinator-overlay.json`.
  *
- * SessionStart hooks (boot-context style injection) are deliberately
- * NOT scaffolded — the boot-context tool lives in the HQ estate, not
- * the published package. Scaffolding a hook that names a binary the
- * colleague does not have would fire on every session boot with a
- * non-blocking error. Documented in docs/onboarding-solo.md under
- * "what is not included in solo mode".
+ *   3. `hooks.SessionStart` wiring `distill health --hook-envelope` so
+ *      every session boots with a `distillationHealth (live)` block at
+ *      the top of the context. Reads the local distill ledger + the
+ *      scaffolded schedule file — never spawns claude, never triggers a
+ *      sweep, cheap to run. The block warns loudly when the schedule is
+ *      missing (fresh scaffold pre-/onboard), disabled, or the last run
+ *      is stale, so the whole self-learning loop cannot die silently
+ *      the way it did on the WSD-laptop cold install of 0.1.41. Invoked
+ *      through `pnpm exec` because Claude Code hook subprocesses do not
+ *      inherit the pnpm-augmented PATH the interactive session enjoys.
  */
 export function buildClaudeSettingsJson() {
   return {
@@ -608,6 +795,17 @@ export function buildClaudeSettingsJson() {
           ],
         },
       ],
+      SessionStart: [
+        {
+          matcher: '',
+          hooks: [
+            {
+              type: 'command',
+              command: 'pnpm exec distill health --hook-envelope',
+            },
+          ],
+        },
+      ],
     },
   };
 }
@@ -810,12 +1008,23 @@ export function buildPlanFromTemplates(config, templates) {
   plan.push({ kind: 'file', path: `agents/${paName}/autonomy-envelope.md`, contents: autonomyEnvelope });
   plan.push({ kind: 'json', path: `agents/${paName}/spawn-log.json`, contents: spawnLog });
 
-  // Empty-directory markers — git won't track empty dirs.
+  // Load-bearing: the scaffolded distillation-sweep schedule the
+  // /onboard walkthrough installs and fires as a mandatory step. See
+  // buildDistillationScheduleJson for the shape rationale.
+  const distillSched = buildDistillationScheduleJson(config);
+  plan.push({
+    kind: 'json',
+    path: `schedules/${distillationScheduleFilename(paName)}`,
+    contents: distillSched,
+  });
+
+  // Empty-directory markers — git won't track empty dirs. `schedules/`
+  // now ships with a real file (the distillation sweep) so it never
+  // needs a .gitkeep.
   for (const d of [
     `agents/${paName}/staging`,
     'work',
     'projects',
-    'schedules',
     '.vault',
     'operator/extensions/roles',
     'operator/extensions/tools',

package/dist/engineering-pa-workspace/app/assets/theme.css

@@ -3,8 +3,9 @@
  *
  * Two themes live here: dark (default) and light, toggled by the operator
  * via the banner button. Selection is persisted in localStorage under
- * `dave.theme` and applied to `documentElement.dataset.theme` before first
- * paint by the inline init script in each page's <head>.
+ * `dop.theme` (product-generic; legacy `dave.theme` is read once and
+ * migrated forward) and applied to `documentElement.dataset.theme` before
+ * first paint by the inline init script in each page's <head>.
  *
  * Token set is the union of every page's prior `:root` block. Both themes
  * MUST define the same set of names — any unilateral token becomes invisible

package/dist/engineering-pa-workspace/app/assets/theme.js

@@ -4,7 +4,7 @@
  * Two responsibilities split across two surfaces:
  *
  * 1. Pre-paint init. Each page also embeds a tiny inline <script> in <head>
- *    that reads `localStorage.dave.theme` and sets
+ *    that reads `localStorage.dop.theme` and sets
  *    `documentElement.dataset.theme` BEFORE first paint. That avoids a
  *    light-flash on a dark-preference user (FOUC). The inline script is the
  *    duplicate of `applyStoredTheme()` below; keeping it inline is the
@@ -18,7 +18,17 @@
  *    context (matching banner.js's behaviour) so a page opened directly
  *    still owns its own toggle.
  *
- * Storage: localStorage key `dave.theme`, values 'dark' | 'light'.
+ * Storage: localStorage key `dop.theme`, values 'dark' | 'light'. The
+ * canonical token lives in `src/workspace-page-contract.mjs`; this file
+ * hand-copies the literal because it runs in the browser and cannot
+ * import ESM modules from that path. The theme parity test pins the two
+ * copies to the same value.
+ *
+ * Legacy: `dave.theme` is the pre-rename key. On first boot after the
+ * rename we read it once, copy the value to `dop.theme`, and never touch
+ * it again — nobody re-picks their theme just because the estate went
+ * product-generic. See `src/workspace-page-contract.mjs`.
+ *
  * Default when unset: 'dark' (operator preference — see CLAUDE.md). We do
  * NOT consult prefers-color-scheme; dark is the chosen default and we don't
  * want auto-detection overriding it on first load.
@@ -26,15 +36,22 @@
 (function () {
   'use strict';
 
-  var STORAGE_KEY = 'dave.theme';
+  var STORAGE_KEY = 'dop.theme';
+  var LEGACY_STORAGE_KEY = 'dave.theme';
   var DEFAULT_THEME = 'dark';
   var VALID = { dark: 1, light: 1 };
-  var MESSAGE_TYPE = 'dave.theme.set';
+  var MESSAGE_TYPE = 'dop.theme.set';
 
   function readStored() {
     try {
       var raw = localStorage.getItem(STORAGE_KEY);
       if (raw && VALID[raw]) return raw;
+      // Legacy fallback: one-time migration from the pre-rename key.
+      var legacy = localStorage.getItem(LEGACY_STORAGE_KEY);
+      if (legacy && VALID[legacy]) {
+        try { localStorage.setItem(STORAGE_KEY, legacy); } catch (_e) { /* no-op */ }
+        return legacy;
+      }
     } catch (_e) { /* storage unavailable — fall through to default */ }
     return DEFAULT_THEME;
   }
@@ -148,12 +165,18 @@
     boot();
   }
 
-  // Expose for tests + the inline init helper.
-  window.__daveTheme = {
+  // Expose for tests + the inline init helper. `__daveTheme` is kept as an
+  // alias for anything under `operator/extensions/**` that grew a direct
+  // reference before the rename; `__dopTheme` is the canonical name and
+  // is what new callers should use.
+  var api = {
     read: readStored,
     write: writeStored,
     apply: applyTheme,
     storageKey: STORAGE_KEY,
+    legacyStorageKey: LEGACY_STORAGE_KEY,
     defaultTheme: DEFAULT_THEME,
   };
+  window.__dopTheme = api;
+  window.__daveTheme = api;
 })();

package/dist/engineering-pa-workspace/app/banner.js

@@ -22,7 +22,11 @@
 
   const ENDPOINT = '/__api/status-mon';
   const POLL_INTERVAL_MS = 30_000;
-  const DISMISSED_KEY = 'dave.statusmon.dismissed';
+  // Product-generic key; the pre-rename store was 'dave.statusmon.dismissed'.
+  // Read-once fallback keeps existing dismissals across the rename so a
+  // resolved incident someone had already dismissed doesn't reappear.
+  const DISMISSED_KEY = 'dop.statusmon.dismissed';
+  const LEGACY_DISMISSED_KEY = 'dave.statusmon.dismissed';
 
   const SLOT_ID = 'global-banner';
 
@@ -36,7 +40,15 @@
 
   function readDismissed() {
     try {
-      const raw = localStorage.getItem(DISMISSED_KEY);
+      var raw = localStorage.getItem(DISMISSED_KEY);
+      if (!raw) {
+        // Legacy fallback: read the pre-rename store once and migrate.
+        var legacy = localStorage.getItem(LEGACY_DISMISSED_KEY);
+        if (legacy) {
+          try { localStorage.setItem(DISMISSED_KEY, legacy); } catch { /* no-op */ }
+          raw = legacy;
+        }
+      }
       if (!raw) return [];
       const parsed = JSON.parse(raw);
       if (!Array.isArray(parsed)) return [];

package/dist/engineering-pa-workspace/app/delegations.html

@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <title>Delegations — Workspace</title>
-<script>(function(){try{var t=localStorage.getItem('dave.theme');document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
+<script>(function(){try{var t=localStorage.getItem('dop.theme');if(!t){var legacy=localStorage.getItem('dave.theme');if(legacy==='light'||legacy==='dark'){t=legacy;try{localStorage.setItem('dop.theme',legacy);}catch(_){}}}document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
 <link rel="stylesheet" href="/core/tools/workspace/app/assets/theme.css">
 <script src="/core/tools/workspace/app/assets/theme.js" defer></script>
 <style>

package/dist/engineering-pa-workspace/app/home.html

@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <title>Home</title>
-<script>(function(){try{var t=localStorage.getItem('dave.theme');document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
+<script>(function(){try{var t=localStorage.getItem('dop.theme');if(!t){var legacy=localStorage.getItem('dave.theme');if(legacy==='light'||legacy==='dark'){t=legacy;try{localStorage.setItem('dop.theme',legacy);}catch(_){}}}document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
 <link rel="stylesheet" href="/core/tools/workspace/app/assets/theme.css">
 <script src="/core/tools/workspace/app/assets/theme.js" defer></script>
 <style>

package/dist/engineering-pa-workspace/app/index.html

@@ -6,7 +6,7 @@
 <title>Digital Operator</title>
 <link rel="icon" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Crect width='16' height='16' rx='3' fill='%236366f1'/%3E%3Ctext x='8' y='12' font-family='monospace' font-size='11' font-weight='bold' text-anchor='middle' fill='%23121218'%3ED%3C/text%3E%3C/svg%3E">
 <script src="/banner.js" defer></script>
-<script>(function(){try{var t=localStorage.getItem('dave.theme');document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
+<script>(function(){try{var t=localStorage.getItem('dop.theme');if(!t){var legacy=localStorage.getItem('dave.theme');if(legacy==='light'||legacy==='dark'){t=legacy;try{localStorage.setItem('dop.theme',legacy);}catch(_){}}}document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
 <link rel="stylesheet" href="/core/tools/workspace/app/assets/theme.css">
 <script src="/core/tools/workspace/app/assets/theme.js" defer></script>
 <style>

package/dist/engineering-pa-workspace/app/knowledge-map.html

@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <title>Knowledge Map — Workspace</title>
-<script>(function(){try{var t=localStorage.getItem('dave.theme');document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
+<script>(function(){try{var t=localStorage.getItem('dop.theme');if(!t){var legacy=localStorage.getItem('dave.theme');if(legacy==='light'||legacy==='dark'){t=legacy;try{localStorage.setItem('dop.theme',legacy);}catch(_){}}}document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
 <link rel="stylesheet" href="/core/tools/workspace/app/assets/theme.css">
 <script src="/core/tools/workspace/app/assets/theme.js" defer></script>
 <style>

package/dist/engineering-pa-workspace/app/knowledge.html

@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <title>Knowledge</title>
-<script>(function(){try{var t=localStorage.getItem('dave.theme');document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
+<script>(function(){try{var t=localStorage.getItem('dop.theme');if(!t){var legacy=localStorage.getItem('dave.theme');if(legacy==='light'||legacy==='dark'){t=legacy;try{localStorage.setItem('dop.theme',legacy);}catch(_){}}}document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
 <link rel="stylesheet" href="/core/tools/workspace/app/assets/theme.css">
 <script src="/core/tools/workspace/app/assets/theme.js" defer></script>
 <style>

package/dist/engineering-pa-workspace/app/notes.html

@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <title>Notes — Dave</title>
-<script>(function(){try{var t=localStorage.getItem('dave.theme');document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
+<script>(function(){try{var t=localStorage.getItem('dop.theme');if(!t){var legacy=localStorage.getItem('dave.theme');if(legacy==='light'||legacy==='dark'){t=legacy;try{localStorage.setItem('dop.theme',legacy);}catch(_){}}}document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
 <link rel="stylesheet" href="/core/tools/workspace/app/assets/theme.css">
 <script src="/core/tools/workspace/app/assets/theme.js" defer></script>
 <style>

package/dist/engineering-pa-workspace/app/onboarding.html

@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <title>Welcome to your PA</title>
-<script>(function(){try{var t=localStorage.getItem('dave.theme');document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
+<script>(function(){try{var t=localStorage.getItem('dop.theme');if(!t){var legacy=localStorage.getItem('dave.theme');if(legacy==='light'||legacy==='dark'){t=legacy;try{localStorage.setItem('dop.theme',legacy);}catch(_){}}}document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
 <link rel="stylesheet" href="/core/tools/workspace/app/assets/theme.css">
 <script src="/core/tools/workspace/app/assets/theme.js" defer></script>
 <style>

package/dist/engineering-pa-workspace/app/profile.html

@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <title>Profile</title>
-<script>(function(){try{var t=localStorage.getItem('dave.theme');document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
+<script>(function(){try{var t=localStorage.getItem('dop.theme');if(!t){var legacy=localStorage.getItem('dave.theme');if(legacy==='light'||legacy==='dark'){t=legacy;try{localStorage.setItem('dop.theme',legacy);}catch(_){}}}document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
 <link rel="stylesheet" href="/core/tools/workspace/app/assets/theme.css">
 <script src="/core/tools/workspace/app/assets/theme.js" defer></script>
 <style>

package/dist/engineering-pa-workspace/app/project-detail.html

@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <title>Project Detail</title>
-<script>(function(){try{var t=localStorage.getItem('dave.theme');document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
+<script>(function(){try{var t=localStorage.getItem('dop.theme');if(!t){var legacy=localStorage.getItem('dave.theme');if(legacy==='light'||legacy==='dark'){t=legacy;try{localStorage.setItem('dop.theme',legacy);}catch(_){}}}document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
 <link rel="stylesheet" href="/core/tools/workspace/app/assets/theme.css">
 <script src="/core/tools/workspace/app/assets/theme.js" defer></script>
 <style>

package/dist/engineering-pa-workspace/app/projects.html

@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <title>Projects — Dave</title>
-<script>(function(){try{var t=localStorage.getItem('dave.theme');document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
+<script>(function(){try{var t=localStorage.getItem('dop.theme');if(!t){var legacy=localStorage.getItem('dave.theme');if(legacy==='light'||legacy==='dark'){t=legacy;try{localStorage.setItem('dop.theme',legacy);}catch(_){}}}document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
 <link rel="stylesheet" href="/core/tools/workspace/app/assets/theme.css">
 <script src="/core/tools/workspace/app/assets/theme.js" defer></script>
 <style>

package/dist/engineering-pa-workspace/app/repos.html

@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <title>Git Overview — Workspace</title>
-<script>(function(){try{var t=localStorage.getItem('dave.theme');document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
+<script>(function(){try{var t=localStorage.getItem('dop.theme');if(!t){var legacy=localStorage.getItem('dave.theme');if(legacy==='light'||legacy==='dark'){t=legacy;try{localStorage.setItem('dop.theme',legacy);}catch(_){}}}document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
 <link rel="stylesheet" href="/core/tools/workspace/app/assets/theme.css">
 <script src="/core/tools/workspace/app/assets/theme.js" defer></script>
 <style>

package/dist/engineering-pa-workspace/app/schedules.html

@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <title>Schedules — Workspace</title>
-<script>(function(){try{var t=localStorage.getItem('dave.theme');document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
+<script>(function(){try{var t=localStorage.getItem('dop.theme');if(!t){var legacy=localStorage.getItem('dave.theme');if(legacy==='light'||legacy==='dark'){t=legacy;try{localStorage.setItem('dop.theme',legacy);}catch(_){}}}document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
 <link rel="stylesheet" href="/core/tools/workspace/app/assets/theme.css">
 <script src="/core/tools/workspace/app/assets/theme.js" defer></script>
 <style>

package/dist/engineering-pa-workspace/app/secrets.html

@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <title>Secrets</title>
-<script>(function(){try{var t=localStorage.getItem('dave.theme');document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
+<script>(function(){try{var t=localStorage.getItem('dop.theme');if(!t){var legacy=localStorage.getItem('dave.theme');if(legacy==='light'||legacy==='dark'){t=legacy;try{localStorage.setItem('dop.theme',legacy);}catch(_){}}}document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
 <link rel="stylesheet" href="/core/tools/workspace/app/assets/theme.css">
 <script src="/core/tools/workspace/app/assets/theme.js" defer></script>
 <style>

package/dist/engineering-pa-workspace/app/staging.html

@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <title>Staging Inbox — Workspace</title>
-<script>(function(){try{var t=localStorage.getItem('dave.theme');document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
+<script>(function(){try{var t=localStorage.getItem('dop.theme');if(!t){var legacy=localStorage.getItem('dave.theme');if(legacy==='light'||legacy==='dark'){t=legacy;try{localStorage.setItem('dop.theme',legacy);}catch(_){}}}document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
 <link rel="stylesheet" href="/core/tools/workspace/app/assets/theme.css">
 <script src="/core/tools/workspace/app/assets/theme.js" defer></script>
 <style>

package/dist/engineering-pa-workspace/app/tasks.html

@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <title>Tasks — Dave</title>
-<script>(function(){try{var t=localStorage.getItem('dave.theme');document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
+<script>(function(){try{var t=localStorage.getItem('dop.theme');if(!t){var legacy=localStorage.getItem('dave.theme');if(legacy==='light'||legacy==='dark'){t=legacy;try{localStorage.setItem('dop.theme',legacy);}catch(_){}}}document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
 <link rel="stylesheet" href="/core/tools/workspace/app/assets/theme.css">
 <script src="/core/tools/workspace/app/assets/theme.js" defer></script>
 <style>

package/dist/engineering-pa-workspace/app/viewer.html

@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <title>Document Viewer</title>
-<script>(function(){try{var t=localStorage.getItem('dave.theme');document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
+<script>(function(){try{var t=localStorage.getItem('dop.theme');if(!t){var legacy=localStorage.getItem('dave.theme');if(legacy==='light'||legacy==='dark'){t=legacy;try{localStorage.setItem('dop.theme',legacy);}catch(_){}}}document.documentElement.dataset.theme=(t==='light'||t==='dark')?t:'dark';}catch(_){document.documentElement.dataset.theme='dark';}})();</script>
 <link rel="stylesheet" href="/core/tools/workspace/app/assets/theme.css">
 <script src="/core/tools/workspace/app/assets/theme.js" defer></script>
 <style>

package/dist/engineering-pa-workspace/index.mjs

@@ -10,3 +10,19 @@ export const version = '0.1.1';
 export { loadNav } from './src/nav.mjs';
 export { startPoller as startStatusMonPoller } from './src/status-mon/poller.mjs';
 export { handleApi } from './src/api.mjs';
+
+// Shared workspace-page contract — every core page and every scaffolded
+// extension page carries the same head + top-of-body markup. Owning the
+// tokens here stops the scaffold and the core pages drifting on the theme
+// storage key.
+export {
+  THEME_STORAGE_KEY,
+  THEME_LEGACY_STORAGE_KEY,
+  THEME_MESSAGE_TYPE,
+  THEME_CSS_LINK,
+  THEME_JS_TAG,
+  BANNER_JS_TAG,
+  GLOBAL_BANNER_HTML,
+  prepaintScriptTag,
+  standardHeadInner,
+} from './src/workspace-page-contract.mjs';

package/dist/engineering-pa-workspace/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@stravica-ai/engineering-pa-workspace",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Workspace server + viewer — operator-facing local web UI for the PA platform.",
   "type": "module",
   "main": "./index.mjs",
   "exports": {
-    ".": "./index.mjs"
+    ".": "./index.mjs",
+    "./index.mjs": "./index.mjs"
   },
   "dependencies": {
     "@stravica-ai/engineering-pa-cli": "workspace:*",