@knowsuchagency/fulcrum 1.6.1 → 1.7.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knowsuchagency/fulcrum",
-  "version": "1.6.1",
+  "version": "1.7.1",
   "description": "Harness Attention. Orchestrate Agents. Ship.",
   "license": "PolyForm-Perimeter-1.0.0",
   "repository": {

package/server/index.js

@@ -4739,6 +4739,7 @@ __export(exports_settings, {
   syncClaudeCodeTheme: () => syncClaudeCodeTheme,
   setNestedValue: () => setNestedValue,
   resetSettings: () => resetSettings,
+  isTestMode: () => isTestMode,
   isDeveloperMode: () => isDeveloperMode,
   initializeFulcrumDirectories: () => initializeFulcrumDirectories,
   getZAiSettings: () => getZAiSettings,
@@ -4757,12 +4758,36 @@ __export(exports_settings, {
   ensureWorktreesDir: () => ensureWorktreesDir,
   ensureLatestSettings: () => ensureLatestSettings,
   ensureFulcrumDir: () => ensureFulcrumDir,
+  enableTestMode: () => enableTestMode,
   CURRENT_SCHEMA_VERSION: () => CURRENT_SCHEMA_VERSION,
   CLAUDE_CODE_THEMES: () => CLAUDE_CODE_THEMES
 });
 import * as fs2 from "fs";
 import * as path from "path";
 import * as os from "os";
+function enableTestMode() {
+  _testMode = true;
+}
+function isTestMode() {
+  return _testMode;
+}
+function getRealHomeDir() {
+  return process.env.HOME_BACKUP || os.homedir();
+}
+function getHomeDir() {
+  return process.env.HOME || os.homedir();
+}
+function assertNotProductionPath(p, context) {
+  if (!_testMode)
+    return;
+  const realHome = getRealHomeDir();
+  const productionFulcrum = path.join(realHome, ".fulcrum");
+  const productionClaude = path.join(realHome, ".claude");
+  const productionClaudeJson = path.join(realHome, ".claude.json");
+  if (p.startsWith(productionFulcrum + path.sep) || p === productionFulcrum || p.startsWith(productionClaude + path.sep) || p === productionClaude || p === productionClaudeJson) {
+    throw new Error(`TEST ISOLATION VIOLATION in ${context}: attempted to access production path ${p}`);
+  }
+}
 function getNestedValue(obj, path2) {
   return path2.split(".").reduce((o, k) => {
     if (o && typeof o === "object") {
@@ -4821,10 +4846,10 @@ function expandPath(p) {
   if (!p)
     return p;
   if (p === "~") {
-    return os.homedir();
+    return getHomeDir();
   }
   if (p.startsWith("~/")) {
-    return path.join(os.homedir(), p.slice(2));
+    return path.join(getHomeDir(), p.slice(2));
   }
   if (!path.isAbsolute(p)) {
     return path.resolve(p);
@@ -4833,13 +4858,19 @@ function expandPath(p) {
 }
 function getFulcrumDir() {
   if (process.env.FULCRUM_DIR) {
-    return expandPath(process.env.FULCRUM_DIR);
+    const p = expandPath(process.env.FULCRUM_DIR);
+    assertNotProductionPath(p, "getFulcrumDir");
+    return p;
   }
   const cwdFulcrum = path.join(process.cwd(), ".fulcrum");
   if (fs2.existsSync(cwdFulcrum)) {
+    assertNotProductionPath(cwdFulcrum, "getFulcrumDir");
     return cwdFulcrum;
   }
-  return path.join(os.homedir(), ".fulcrum");
+  if (_testMode) {
+    throw new Error("TEST ISOLATION VIOLATION: FULCRUM_DIR not set and no local .fulcrum directory found");
+  }
+  return path.join(getHomeDir(), ".fulcrum");
 }
 function getDatabasePath() {
   return path.join(getFulcrumDir(), "fulcrum.db");
@@ -5141,7 +5172,9 @@ function updateNotificationSettings(updates, clientTimestamp) {
   return updated;
 }
 function getClaudeSettingsPath() {
-  return path.join(os.homedir(), ".claude", "settings.json");
+  const p = path.join(getHomeDir(), ".claude", "settings.json");
+  assertNotProductionPath(p, "getClaudeSettingsPath");
+  return p;
 }
 function getClaudeSettings() {
   const settingsPath = getClaudeSettingsPath();
@@ -5163,7 +5196,9 @@ function updateClaudeSettings(updates) {
   fs2.writeFileSync(settingsPath, JSON.stringify(merged, null, 2), "utf-8");
 }
 function getClaudeConfigPath() {
-  return path.join(os.homedir(), ".claude.json");
+  const p = path.join(getHomeDir(), ".claude.json");
+  assertNotProductionPath(p, "getClaudeConfigPath");
+  return p;
 }
 function getClaudeConfig() {
   const configPath = getClaudeConfigPath();
@@ -5302,7 +5337,7 @@ function ensureLatestSettings() {
   fs2.writeFileSync(settingsPath, JSON.stringify(merged, null, 2), "utf-8");
   log2.settings.info("Settings normalized to latest schema", { schemaVersion: CURRENT_SCHEMA_VERSION });
 }
-var CURRENT_SCHEMA_VERSION = 1, CLAUDE_CODE_THEMES, DEFAULT_SETTINGS, OLD_DEFAULT_PORT = 3333, MIGRATION_MAP, DEFAULT_NOTIFICATION_SETTINGS, claudeConfigLock, DEFAULT_ZAI_SETTINGS;
+var _testMode = false, CURRENT_SCHEMA_VERSION = 1, CLAUDE_CODE_THEMES, DEFAULT_SETTINGS, OLD_DEFAULT_PORT = 3333, MIGRATION_MAP, DEFAULT_NOTIFICATION_SETTINGS, claudeConfigLock, DEFAULT_ZAI_SETTINGS;
 var init_settings = __esm(() => {
   init_logger3();
   CLAUDE_CODE_THEMES = ["light", "light-ansi", "light-daltonized", "dark", "dark-ansi", "dark-daltonized"];
@@ -11418,10 +11453,10 @@ var require_resolve_block_map = __commonJS((exports) => {
     let offset = bm.offset;
     let commentEnd = null;
     for (const collItem of bm.items) {
-      const { start, key, sep: sep3, value } = collItem;
+      const { start, key, sep: sep4, value } = collItem;
       const keyProps = resolveProps.resolveProps(start, {
         indicator: "explicit-key-ind",
-        next: key ?? sep3?.[0],
+        next: key ?? sep4?.[0],
         offset,
         onError,
         parentIndent: bm.indent,
@@ -11435,7 +11470,7 @@ var require_resolve_block_map = __commonJS((exports) => {
           else if ("indent" in key && key.indent !== bm.indent)
             onError(offset, "BAD_INDENT", startColMsg);
         }
-        if (!keyProps.anchor && !keyProps.tag && !sep3) {
+        if (!keyProps.anchor && !keyProps.tag && !sep4) {
           commentEnd = keyProps.end;
           if (keyProps.comment) {
             if (map.comment)
@@ -11460,7 +11495,7 @@ var require_resolve_block_map = __commonJS((exports) => {
       ctx.atKey = false;
       if (utilMapIncludes.mapIncludes(ctx, map.items, keyNode))
         onError(keyStart, "DUPLICATE_KEY", "Map keys must be unique");
-      const valueProps = resolveProps.resolveProps(sep3 ?? [], {
+      const valueProps = resolveProps.resolveProps(sep4 ?? [], {
         indicator: "map-value-ind",
         next: value,
         offset: keyNode.range[2],
@@ -11476,7 +11511,7 @@ var require_resolve_block_map = __commonJS((exports) => {
           if (ctx.options.strict && keyProps.start < valueProps.found.offset - 1024)
             onError(keyNode.range, "KEY_OVER_1024_CHARS", "The : indicator must be at most 1024 chars after the start of an implicit block mapping key");
         }
-        const valueNode = value ? composeNode(ctx, value, valueProps, onError) : composeEmptyNode(ctx, offset, sep3, null, valueProps, onError);
+        const valueNode = value ? composeNode(ctx, value, valueProps, onError) : composeEmptyNode(ctx, offset, sep4, null, valueProps, onError);
         if (ctx.schema.compat)
           utilFlowIndentCheck.flowIndentCheck(bm.indent, value, onError);
         offset = valueNode.range[2];
@@ -11562,7 +11597,7 @@ var require_resolve_end = __commonJS((exports) => {
     let comment = "";
     if (end) {
       let hasSpace = false;
-      let sep3 = "";
+      let sep4 = "";
       for (const token of end) {
         const { source, type } = token;
         switch (type) {
@@ -11576,13 +11611,13 @@ var require_resolve_end = __commonJS((exports) => {
             if (!comment)
               comment = cb;
             else
-              comment += sep3 + cb;
-            sep3 = "";
+              comment += sep4 + cb;
+            sep4 = "";
             break;
           }
           case "newline":
             if (comment)
-              sep3 += source;
+              sep4 += source;
             hasSpace = true;
             break;
           default:
@@ -11622,18 +11657,18 @@ var require_resolve_flow_collection = __commonJS((exports) => {
     let offset = fc.offset + fc.start.source.length;
     for (let i = 0;i < fc.items.length; ++i) {
       const collItem = fc.items[i];
-      const { start, key, sep: sep3, value } = collItem;
+      const { start, key, sep: sep4, value } = collItem;
       const props = resolveProps.resolveProps(start, {
         flow: fcName,
         indicator: "explicit-key-ind",
-        next: key ?? sep3?.[0],
+        next: key ?? sep4?.[0],
         offset,
         onError,
         parentIndent: fc.indent,
         startOnNewline: false
       });
       if (!props.found) {
-        if (!props.anchor && !props.tag && !sep3 && !value) {
+        if (!props.anchor && !props.tag && !sep4 && !value) {
           if (i === 0 && props.comma)
             onError(props.comma, "UNEXPECTED_TOKEN", `Unexpected , in ${fcName}`);
           else if (i < fc.items.length - 1)
@@ -11685,8 +11720,8 @@ var require_resolve_flow_collection = __commonJS((exports) => {
           }
         }
       }
-      if (!isMap && !sep3 && !props.found) {
-        const valueNode = value ? composeNode(ctx, value, props, onError) : composeEmptyNode(ctx, props.end, sep3, null, props, onError);
+      if (!isMap && !sep4 && !props.found) {
+        const valueNode = value ? composeNode(ctx, value, props, onError) : composeEmptyNode(ctx, props.end, sep4, null, props, onError);
         coll.items.push(valueNode);
         offset = valueNode.range[2];
         if (isBlock(value))
@@ -11698,7 +11733,7 @@ var require_resolve_flow_collection = __commonJS((exports) => {
         if (isBlock(key))
           onError(keyNode.range, "BLOCK_IN_FLOW", blockMsg);
         ctx.atKey = false;
-        const valueProps = resolveProps.resolveProps(sep3 ?? [], {
+        const valueProps = resolveProps.resolveProps(sep4 ?? [], {
           flow: fcName,
           indicator: "map-value-ind",
           next: value,
@@ -11709,8 +11744,8 @@ var require_resolve_flow_collection = __commonJS((exports) => {
         });
         if (valueProps.found) {
           if (!isMap && !props.found && ctx.options.strict) {
-            if (sep3)
-              for (const st of sep3) {
+            if (sep4)
+              for (const st of sep4) {
                 if (st === valueProps.found)
                   break;
                 if (st.type === "newline") {
@@ -11727,7 +11762,7 @@ var require_resolve_flow_collection = __commonJS((exports) => {
           else
             onError(valueProps.start, "MISSING_CHAR", `Missing , or : between ${fcName} items`);
         }
-        const valueNode = value ? composeNode(ctx, value, valueProps, onError) : valueProps.found ? composeEmptyNode(ctx, valueProps.end, sep3, null, valueProps, onError) : null;
+        const valueNode = value ? composeNode(ctx, value, valueProps, onError) : valueProps.found ? composeEmptyNode(ctx, valueProps.end, sep4, null, valueProps, onError) : null;
         if (valueNode) {
           if (isBlock(value))
             onError(valueNode.range, "BLOCK_IN_FLOW", blockMsg);
@@ -11904,7 +11939,7 @@ var require_resolve_block_scalar = __commonJS((exports) => {
         chompStart = i + 1;
     }
     let value = "";
-    let sep3 = "";
+    let sep4 = "";
     let prevMoreIndented = false;
     for (let i = 0;i < contentStart; ++i)
       value += lines[i][0].slice(trimIndent) + `
@@ -11922,33 +11957,33 @@ var require_resolve_block_scalar = __commonJS((exports) => {
         indent = "";
       }
       if (type === Scalar.Scalar.BLOCK_LITERAL) {
-        value += sep3 + indent.slice(trimIndent) + content;
-        sep3 = `
+        value += sep4 + indent.slice(trimIndent) + content;
+        sep4 = `
 `;
       } else if (indent.length > trimIndent || content[0] === "\t") {
-        if (sep3 === " ")
-          sep3 = `
+        if (sep4 === " ")
+          sep4 = `
 `;
-        else if (!prevMoreIndented && sep3 === `
+        else if (!prevMoreIndented && sep4 === `
 `)
-          sep3 = `
+          sep4 = `
 
 `;
-        value += sep3 + indent.slice(trimIndent) + content;
-        sep3 = `
+        value += sep4 + indent.slice(trimIndent) + content;
+        sep4 = `
 `;
         prevMoreIndented = true;
       } else if (content === "") {
-        if (sep3 === `
+        if (sep4 === `
 `)
           value += `
 `;
         else
-          sep3 = `
+          sep4 = `
 `;
       } else {
-        value += sep3 + content;
-        sep3 = " ";
+        value += sep4 + content;
+        sep4 = " ";
         prevMoreIndented = false;
       }
     }
@@ -12129,27 +12164,27 @@ var require_resolve_flow_scalar = __commonJS((exports) => {
     if (!match3)
       return source;
     let res = match3[1];
-    let sep3 = " ";
+    let sep4 = " ";
     let pos = first.lastIndex;
     line.lastIndex = pos;
     while (match3 = line.exec(source)) {
       if (match3[1] === "") {
-        if (sep3 === `
+        if (sep4 === `
 `)
-          res += sep3;
+          res += sep4;
         else
-          sep3 = `
+          sep4 = `
 `;
       } else {
-        res += sep3 + match3[1];
-        sep3 = " ";
+        res += sep4 + match3[1];
+        sep4 = " ";
       }
       pos = line.lastIndex;
     }
     const last = /[ \t]*(.*)/sy;
     last.lastIndex = pos;
     match3 = last.exec(source);
-    return res + sep3 + (match3?.[1] ?? "");
+    return res + sep4 + (match3?.[1] ?? "");
   }
   function doubleQuotedValue(source, onError) {
     let res = "";
@@ -12922,14 +12957,14 @@ var require_cst_stringify = __commonJS((exports) => {
       }
     }
   }
-  function stringifyItem({ start, key, sep: sep3, value }) {
+  function stringifyItem({ start, key, sep: sep4, value }) {
     let res = "";
     for (const st of start)
       res += st.source;
     if (key)
       res += stringifyToken(key);
-    if (sep3)
-      for (const st of sep3)
+    if (sep4)
+      for (const st of sep4)
         res += st.source;
     if (value)
       res += stringifyToken(value);
@@ -14059,18 +14094,18 @@ var require_parser = __commonJS((exports) => {
       if (this.type === "map-value-ind") {
         const prev = getPrevProps(this.peek(2));
         const start = getFirstKeyStartProps(prev);
-        let sep3;
+        let sep4;
         if (scalar.end) {
-          sep3 = scalar.end;
-          sep3.push(this.sourceToken);
+          sep4 = scalar.end;
+          sep4.push(this.sourceToken);
           delete scalar.end;
         } else
-          sep3 = [this.sourceToken];
+          sep4 = [this.sourceToken];
         const map = {
           type: "block-map",
           offset: scalar.offset,
           indent: scalar.indent,
-          items: [{ start, key: scalar, sep: sep3 }]
+          items: [{ start, key: scalar, sep: sep4 }]
         };
         this.onKeyLine = true;
         this.stack[this.stack.length - 1] = map;
@@ -14224,15 +14259,15 @@ var require_parser = __commonJS((exports) => {
               } else if (isFlowToken(it.key) && !includesToken(it.sep, "newline")) {
                 const start2 = getFirstKeyStartProps(it.start);
                 const key = it.key;
-                const sep3 = it.sep;
-                sep3.push(this.sourceToken);
+                const sep4 = it.sep;
+                sep4.push(this.sourceToken);
                 delete it.key;
                 delete it.sep;
                 this.stack.push({
                   type: "block-map",
                   offset: this.offset,
                   indent: this.indent,
-                  items: [{ start: start2, key, sep: sep3 }]
+                  items: [{ start: start2, key, sep: sep4 }]
                 });
               } else if (start.length > 0) {
                 it.sep = it.sep.concat(start, this.sourceToken);
@@ -14426,13 +14461,13 @@ var require_parser = __commonJS((exports) => {
           const prev = getPrevProps(parent);
           const start = getFirstKeyStartProps(prev);
           fixFlowSeqItems(fc);
-          const sep3 = fc.end.splice(1, fc.end.length);
-          sep3.push(this.sourceToken);
+          const sep4 = fc.end.splice(1, fc.end.length);
+          sep4.push(this.sourceToken);
           const map = {
             type: "block-map",
             offset: fc.offset,
             indent: fc.indent,
-            items: [{ start, key: fc, sep: sep3 }]
+            items: [{ start, key: fc, sep: sep4 }]
           };
           this.onKeyLine = true;
           this.stack[this.stack.length - 1] = map;
@@ -44231,8 +44266,8 @@ var path2 = {
   win32: { sep: "\\" },
   posix: { sep: "/" }
 };
-var sep = defaultPlatform === "win32" ? path2.win32.sep : path2.posix.sep;
-minimatch.sep = sep;
+var sep2 = defaultPlatform === "win32" ? path2.win32.sep : path2.posix.sep;
+minimatch.sep = sep2;
 var GLOBSTAR = Symbol("globstar **");
 minimatch.GLOBSTAR = GLOBSTAR;
 var qmark2 = "[^/]";
@@ -47475,7 +47510,7 @@ class PathScurryBase {
   #children;
   nocase;
   #fs;
-  constructor(cwd = process.cwd(), pathImpl, sep2, { nocase, childrenCacheSize = 16 * 1024, fs: fs3 = defaultFS } = {}) {
+  constructor(cwd = process.cwd(), pathImpl, sep3, { nocase, childrenCacheSize = 16 * 1024, fs: fs3 = defaultFS } = {}) {
     this.#fs = fsFromOption(fs3);
     if (cwd instanceof URL || cwd.startsWith("file://")) {
       cwd = fileURLToPath(cwd);
@@ -47486,7 +47521,7 @@ class PathScurryBase {
     this.#resolveCache = new ResolveCache;
     this.#resolvePosixCache = new ResolveCache;
     this.#children = new ChildrenCache(childrenCacheSize);
-    const split = cwdPath.substring(this.rootPath.length).split(sep2);
+    const split = cwdPath.substring(this.rootPath.length).split(sep3);
     if (split.length === 1 && !split[0]) {
       split.pop();
     }
@@ -53315,8 +53350,8 @@ function withCustomRequest(customRequest) {
 
 // node_modules/@octokit/auth-token/dist-bundle/index.js
 var b64url = "(?:[a-zA-Z0-9_-]+)";
-var sep3 = "\\.";
-var jwtRE = new RegExp(`^${b64url}${sep3}${b64url}${sep3}${b64url}$`);
+var sep4 = "\\.";
+var jwtRE = new RegExp(`^${b64url}${sep4}${b64url}${sep4}${b64url}$`);
 var isJWT = jwtRE.test.bind(jwtRE);
 async function auth(token) {
   const isApp = isJWT(token);