@stravica-ai/digital-operator-pa 0.1.4 → 0.1.6

package/dist/engineering-pa-core/src/desk/team-scope.mjs

@@ -106,6 +106,59 @@ export function filterProjectsByTeam(projects, opts = {}) {
  * Absent/blank -> null, which means "do not team-scope nav" (fail open,
  * backwards compatible: pre-team devices show every nav fragment).
  */
+/**
+ * Read + JSON-parse a file, returning the parsed value or null on any error
+ * (missing file, unreadable, malformed JSON). Shared by the base + overlay
+ * reads so both fail-open identically.
+ */
+function readJsonSync(path) {
+  try {
+    return JSON.parse(readFileSync(path, 'utf8'));
+  } catch {
+    return null;
+  }
+}
+
+async function readJsonAsync(path) {
+  try {
+    return JSON.parse(await readFile(path, 'utf8'));
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Shallow-merge the optional device-local overlay
+ * (operator/config/preferences.local.json) OVER the parsed base
+ * preferences.json.
+ *
+ * The overlay is device-local state that must NOT round-trip through
+ * library-sync. preferences.json is down-path-materialised from a shared
+ * canonical source (see the estate's .library-sync manifest — the barry
+ * `config/` mount), so a device-scoped field (e.g. `team`) written into the
+ * synced file would be clobbered on the next cycle, and a canonical edit
+ * would stamp one device's identity onto every device. The overlay lives
+ * outside every mount source, so down-path reconciliation never tracks or
+ * deletes it (computeDeletions is manifest-driven — it only removes
+ * previously-materialised files), and it is gitignored so estate git-sync
+ * never carries it between hosts (see scaffold buildGitignore).
+ *
+ * Precedence: overlay keys win; keys the overlay omits fall through to the
+ * base. An absent/malformed overlay leaves the base exactly as-is, so a
+ * device with no overlay behaves identically to pre-overlay releases.
+ *
+ * `base`/`overlay` are already-parsed values (a plain object, or null when
+ * the file was missing/malformed). Returns null only when BOTH are absent,
+ * preserving the "no config at all -> fail-open defaults" path through
+ * normaliseTeamScopeConfig.
+ */
+function mergePreferences(base, overlay) {
+  const b = base && typeof base === 'object' && !Array.isArray(base) ? base : null;
+  const o = overlay && typeof overlay === 'object' && !Array.isArray(overlay) ? overlay : null;
+  if (!b && !o) return null;
+  return { ...(b || {}), ...(o || {}) };
+}
+
 function normaliseTeamScopeConfig(config) {
   const c = config && typeof config === 'object' ? config : {};
   const paName = c.paName || c.agentName || 'pa';
@@ -136,13 +189,11 @@ function normaliseTeamScopeConfig(config) {
  * @returns {Promise<{ paName: string, teamIdentities: string[], scopeEnabled: boolean, team: string|null }>}
  */
 export async function readTeamScopeConfig(repoRoot) {
-  let config = null;
-  try {
-    config = JSON.parse(await readFile(join(repoRoot, 'operator', 'config', 'preferences.json'), 'utf8'));
-  } catch {
-    // Missing/malformed file -> defaults (scoping disabled, no team).
-  }
-  return normaliseTeamScopeConfig(config);
+  // Base (synced) preferences, then the device-local overlay merged OVER it.
+  // Missing/malformed either file -> null for that layer -> defaults.
+  const base = await readJsonAsync(join(repoRoot, 'operator', 'config', 'preferences.json'));
+  const overlay = await readJsonAsync(join(repoRoot, 'operator', 'config', 'preferences.local.json'));
+  return normaliseTeamScopeConfig(mergePreferences(base, overlay));
 }
 
 /**
@@ -156,13 +207,11 @@ export async function readTeamScopeConfig(repoRoot) {
  * @returns {{ paName: string, teamIdentities: string[], scopeEnabled: boolean, team: string|null }}
  */
 export function readTeamScopeConfigSync(repoRoot) {
-  let config = null;
-  try {
-    config = JSON.parse(readFileSync(join(repoRoot, 'operator', 'config', 'preferences.json'), 'utf8'));
-  } catch {
-    // Missing/malformed file -> defaults (scoping disabled, no team).
-  }
-  return normaliseTeamScopeConfig(config);
+  // Base (synced) preferences, then the device-local overlay merged OVER it.
+  // Missing/malformed either file -> null for that layer -> defaults.
+  const base = readJsonSync(join(repoRoot, 'operator', 'config', 'preferences.json'));
+  const overlay = readJsonSync(join(repoRoot, 'operator', 'config', 'preferences.local.json'));
+  return normaliseTeamScopeConfig(mergePreferences(base, overlay));
 }
 
 /**

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

@@ -157,6 +157,11 @@ export function buildGitignore() {
     '# Workspace runtime',
     '.ws.pid',
     '',
+    '# Device-local preferences overlay — per-host identity (e.g. `team`)',
+    '# shallow-merged OVER the synced preferences.json. Device-local by',
+    '# nature, so it is never committed or synced between hosts.',
+    'operator/config/preferences.local.json',
+    '',
   ].join('\n');
 }
 

package/dist/engineering-pa-scaffold/templates/CLAUDE.md.template

@@ -184,7 +184,7 @@ Stage observations, update journal, update work items, update spawn-log outcomes
 | Operator knowledge | `operator/knowledge/` |
 | Platform core docs | `@stravica-ai/engineering-pa-core/docs/` |
 | Platform core knowledge (bucket scaffolds) | `@stravica-ai/engineering-pa-core/knowledge/` |
-| Config / preferences | `operator/config/preferences.json` |
+| Config / preferences | `operator/config/preferences.json` (+ device-local `preferences.local.json` overlay) |
 | PA run folder | `agents/{PA_NAME}/` |
 | Autonomy envelope | `agents/{PA_NAME}/autonomy-envelope.md` |
 | Work items | `work/w-YYYY-MM-DD-NNN.json` |

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

@@ -3,7 +3,7 @@
 <head>
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>Engineering Assistant</title>
+<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>
@@ -347,14 +347,14 @@
       var name = data.paName;
       var capName = name.charAt(0).toUpperCase() + name.slice(1);
       brandName.textContent = capName;
-      document.title = capName + ' — Engineering Assistant';
+      document.title = capName + ' — Digital Operator';
     } else {
       brandName.textContent = 'Workspace';
     }
-    brandSub.textContent = 'Engineering Assistant';
+    brandSub.textContent = 'Digital Operator';
   }).catch(function() {
     document.getElementById('brand-name').textContent = 'Workspace';
-    document.getElementById('brand-subtitle').textContent = 'Engineering Assistant';
+    document.getElementById('brand-subtitle').textContent = 'Digital Operator';
   });
 </script>
 </body>

package/dist/engineering-pa-workspace/src/nav.mjs

@@ -33,9 +33,13 @@
  *
  * Team scoping (display)
  * ----------------------
- * The device declares its team via `operator/config/preferences.json:team`
- * (resolved by the server through readTeamScopeConfigSync and passed in as
- * `opts.team`). The default scoped view keeps entries whose team is the
+ * The device declares its team via the `team` key in
+ * `operator/config/preferences.json` — or, preferred, the device-local
+ * `operator/config/preferences.local.json` overlay shallow-merged over it
+ * (device identity is device-local, and preferences.json is synced from a
+ * shared canonical source; see readTeamScopeConfig in team-scope.mjs). It is
+ * resolved by the server through readTeamScopeConfigSync and passed in as
+ * `opts.team`. The default scoped view keeps entries whose team is the
  * device team OR untagged (null). Untagged-always-shown keeps core nav and
  * shared/company pages visible everywhere and makes the whole mechanism
  * backwards compatible: a device with no `team` configured, or fragments

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stravica-ai/digital-operator-pa",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Digital Operator PA — single-bundled public package surface (bins + library) for the platform.",
   "type": "module",
   "main": "./index.mjs",