stikfix 1.5.0 → 1.6.0

package/dist/host/stikfix-init.cjs

@@ -30,6 +30,8 @@ var REG_CHROME_KEY = `HKCU\\Software\\Google\\Chrome\\NativeMessagingHosts\\${NA
 var REG_EDGE_KEY = `HKCU\\Software\\Microsoft\\Edge\\NativeMessagingHosts\\${NATIVE_HOST_NAME}`;
 var REG_FIREFOX_KEY = `HKCU\\Software\\Mozilla\\NativeMessagingHosts\\${NATIVE_HOST_NAME}`;
 var DEFAULT_GECKO_ID = "stikfix@stikfix.com";
+var CONFIG_DIR = (home) => (0, import_node_path2.join)(home, ".config", "stikfix");
+var CONFIG_PATH = (home) => (0, import_node_path2.join)(CONFIG_DIR(home), "config.json");
 var LAUNCHER_BATCH_FILENAME = "stikfix-host.bat";
 var LAUNCHER_VBS_FILENAME = "stikfix-host.vbs";
 var LAUNCHER_LNK_FILENAME = "Stikfix Host.lnk";
@@ -176,14 +178,17 @@ function createLauncherFiles(opts) {
   const hostEntry = opts.hostEntryPath;
   const rootArg = opts.root;
   const portArg = opts.port !== void 0 ? ` --port ${opts.port}` : "";
+  const useExe = typeof opts.hostExe === "string" && opts.hostExe.length > 0;
+  const hostExe = opts.hostExe ?? "";
   if (plat === "win32") {
+    const batchLaunch = useExe ? `"${hostExe}" serve --root "${rootArg}"${portArg}` : `"${nodeCmd}" "${hostEntry}" --root "${rootArg}"${portArg}`;
     const batchContent = [
       "@echo off",
       `rem Stikfix HTTP host launcher \u2014 double-click to start the backend`,
       `rem Generated by: npx stikfix init`,
       `rem Root: ${rootArg}`,
       ``,
-      `"${nodeCmd}" "${hostEntry}" --root "${rootArg}"${portArg}`,
+      batchLaunch,
       `if %ERRORLEVEL% NEQ 0 pause`
     ].join("\r\n");
     const batchPath = paths.launcher;
@@ -191,17 +196,20 @@ function createLauncherFiles(opts) {
     written.push(batchPath);
     const vq = (s) => s.replace(/"/g, '""');
     const vbsHostEntry = vq(hostEntry);
+    const vbsHostExe = vq(hostExe);
     const vbsRoot = vq(rootArg);
     const vbsPortArg = opts.port !== void 0 ? ` --port ${opts.port}` : "";
+    const vbsRunLine = useExe ? `sh.Run "cmd /c """ & hostExe & """ serve --root """ & root & """${vbsPortArg}", 0, False` : `sh.Run "cmd /c node """ & hostEntry & """ --root """ & root & """${vbsPortArg}", 0, False`;
     const vbsContent = [
       "Option Explicit",
-      "Dim sh, fso, hostEntry, root, portFile, msg, port, f",
+      "Dim sh, fso, hostEntry, hostExe, root, portFile, msg, port, f",
       'Set sh = CreateObject("WScript.Shell")',
       'Set fso = CreateObject("Scripting.FileSystemObject")',
       `hostEntry = "${vbsHostEntry}"`,
+      `hostExe = "${vbsHostExe}"`,
       `root = "${vbsRoot}"`,
       "' Launch the host hidden (window style 0), do not wait",
-      `sh.Run "cmd /c node """ & hostEntry & """ --root """ & root & """${vbsPortArg}", 0, False`,
+      vbsRunLine,
       "' Give it a moment to bind and write the port file",
       "WScript.Sleep 1800",
       'msg = "Stikfix host is running." & vbCrLf & vbCrLf & "You can start dropping notes."',
@@ -218,21 +226,22 @@ function createLauncherFiles(opts) {
     (0, import_node_fs.writeFileSync)(vbsPath, vbsContent, { encoding: "utf8" });
     written.push(vbsPath);
     if (paths.shortcut) {
-      const lnkPath = paths.shortcut;
+      const guessedLnkPath = paths.shortcut;
       const iconPath = opts.iconPath ?? "";
-      const safeLnkPath = lnkPath.replace(/'/g, "''");
+      const safeLnkFileName = LAUNCHER_LNK_FILENAME.replace(/'/g, "''");
       const safeIconPath = iconPath.replace(/'/g, "''");
       const wscriptPath = (0, import_node_path2.join)(process.env["SystemRoot"] ?? "C:\\Windows", "System32", "wscript.exe");
       const safeWscript = wscriptPath.replace(/'/g, "''");
       const safeVbsPath = vbsPath.replace(/'/g, "''");
-      const psScript = `$ws = New-Object -ComObject WScript.Shell;$s = $ws.CreateShortcut('${safeLnkPath}');$s.TargetPath = '${safeWscript}';$s.Arguments = '"${safeVbsPath}"';$s.Description = 'Start the Stikfix HTTP backend host';` + (safeIconPath ? `$s.IconLocation = '${safeIconPath},0';` : "") + `$s.Save()`;
+      const psScript = `$desktop = [Environment]::GetFolderPath('Desktop');$lnkPath = Join-Path $desktop '${safeLnkFileName}';$ws = New-Object -ComObject WScript.Shell;$s = $ws.CreateShortcut($lnkPath);$s.TargetPath = '${safeWscript}';$s.Arguments = '"${safeVbsPath}"';$s.Description = 'Start the Stikfix HTTP backend host';` + (safeIconPath ? `$s.IconLocation = '${safeIconPath},0';` : "") + `$s.Save();Write-Output $lnkPath`;
       try {
-        (0, import_node_child_process.execFileSync)(
+        const stdout = (0, import_node_child_process.execFileSync)(
           "powershell.exe",
           ["-NoProfile", "-NonInteractive", "-Command", psScript],
-          { timeout: 15e3, stdio: "ignore" }
+          { timeout: 15e3, encoding: "utf8" }
         );
-        written.push(lnkPath);
+        const resolvedLnkPath = stdout.split(/\r?\n/).map((line) => line.trim()).filter(Boolean).pop() ?? guessedLnkPath;
+        written.push(resolvedLnkPath);
       } catch (err) {
         warnings.push(
           `Desktop shortcut creation failed (non-fatal): ${String(err.message)}. The batch file at ${batchPath} can be used directly.`
@@ -245,7 +254,7 @@ function createLauncherFiles(opts) {
       `# Stikfix HTTP host launcher \u2014 double-click in Finder or drag to Dock`,
       `# Generated by: npx stikfix init`,
       ``,
-      `exec "${nodeCmd}" "${hostEntry}" --root "${rootArg}"${portArg}`
+      useExe ? `exec "${hostExe}" serve --root "${rootArg}"${portArg}` : `exec "${nodeCmd}" "${hostEntry}" --root "${rootArg}"${portArg}`
     ].join("\n");
     const commandPath = paths.launcher;
     (0, import_node_fs.writeFileSync)(commandPath, commandContent, { encoding: "utf8", mode: 493 });
@@ -256,7 +265,7 @@ function createLauncherFiles(opts) {
       `# Stikfix HTTP host launcher`,
       `# Generated by: npx stikfix init`,
       ``,
-      `exec "${nodeCmd}" "${hostEntry}" --root "${rootArg}"${portArg}`
+      useExe ? `exec "${hostExe}" serve --root "${rootArg}"${portArg}` : `exec "${nodeCmd}" "${hostEntry}" --root "${rootArg}"${portArg}`
     ].join("\n");
     const shPath = paths.launcher;
     (0, import_node_fs.writeFileSync)(shPath, shContent, { encoding: "utf8" });
@@ -321,8 +330,8 @@ function registerNativeHost(opts) {
   const home = opts.home ?? (0, import_node_os.homedir)();
   const browser = opts.browser ?? "chrome";
   const manifestPath = nativeManifestPath(plat, home, browser);
-  const wrapperPath = writeNativeWrapper(opts.hostBinPath, plat, home, browser);
-  const manifest = buildManifest(opts.extensionId, wrapperPath, browser);
+  const manifestTarget = opts.directPath ? (0, import_node_path2.resolve)(opts.hostBinPath) : writeNativeWrapper(opts.hostBinPath, plat, home, browser);
+  const manifest = buildManifest(opts.extensionId, manifestTarget, browser);
   writeManifest(manifest, manifestPath);
   if (plat === "win32") {
     const execReg = opts.execReg ?? ((args) => {
@@ -373,6 +382,34 @@ function unregisterNativeHost(opts = {}) {
     }
   }
 }
+function teardownHost(opts = {}) {
+  const plat = opts.plat ?? process.platform;
+  const home = opts.home ?? (0, import_node_os.homedir)();
+  const browser = opts.browser ?? "chrome";
+  const result = {
+    manifestRemoved: true,
+    configPath: CONFIG_PATH(home),
+    configRemoved: false
+  };
+  try {
+    unregisterNativeHost({ plat, home, browser });
+  } catch (err) {
+    result.manifestRemoved = false;
+    result.manifestError = err instanceof Error ? err.message : String(err);
+  }
+  try {
+    unregisterStartup({ plat, home });
+  } catch (err) {
+    result.startupError = err instanceof Error ? err.message : String(err);
+  }
+  try {
+    (0, import_node_fs.rmSync)(result.configPath, { force: true });
+    result.configRemoved = true;
+  } catch {
+    result.configRemoved = false;
+  }
+  return result;
+}
 
 // host/src/extension-id.ts
 var import_node_crypto2 = require("node:crypto");
@@ -430,8 +467,8 @@ function resolveStartupChoice(forceOn, forceOff, isTTY) {
   }
   return false;
 }
-var CONFIG_DIR = (0, import_node_path3.join)((0, import_node_os2.homedir)(), ".config", "stikfix");
-var CONFIG_PATH = (0, import_node_path3.join)(CONFIG_DIR, "config.json");
+var CONFIG_DIR2 = (0, import_node_path3.join)((0, import_node_os2.homedir)(), ".config", "stikfix");
+var CONFIG_PATH2 = (0, import_node_path3.join)(CONFIG_DIR2, "config.json");
 if (subcommand === "init") {
   const rawRoot = values["root"];
   const rawExtId = values["extension-id"];
@@ -449,9 +486,9 @@ if (subcommand === "init") {
   const name = (0, import_node_path3.basename)(root);
   const notesDir = (0, import_node_path3.join)(root, "notes");
   const hostEntryPath = (0, import_node_path3.resolve)((0, import_node_path3.join)(__dirname, "src", "index.js"));
-  (0, import_node_fs2.mkdirSync)(CONFIG_DIR, { recursive: true });
+  (0, import_node_fs2.mkdirSync)(CONFIG_DIR2, { recursive: true });
   const config = { root, name, notesDir, hostEntry: hostEntryPath, nodePath: process.execPath };
-  (0, import_node_fs2.writeFileSync)(CONFIG_PATH, JSON.stringify(config, null, 2), { encoding: "utf8", mode: 384 });
+  (0, import_node_fs2.writeFileSync)(CONFIG_PATH2, JSON.stringify(config, null, 2), { encoding: "utf8", mode: 384 });
   const hostBinPath = (0, import_node_path3.resolve)((0, import_node_path3.join)(__dirname, "stikfix-native.cjs"));
   try {
     registerNativeHost({ extensionId, hostBinPath, browser });
@@ -540,9 +577,9 @@ if (subcommand === "init") {
   console.log("");
   console.log("  2. Start the backend \u2014 double-click the desktop launcher:");
   if (process.platform === "win32") {
-    const lnkPath = (0, import_node_path3.join)((0, import_node_os2.homedir)(), "Desktop", "Stikfix Host.lnk");
+    const lnkPath = launcherResult.written.find((p) => p.endsWith(".lnk")) ?? "";
     const batchPath = launcherResult.written.find((p) => p.endsWith(".bat")) ?? "";
-    if ((0, import_node_fs2.existsSync)(lnkPath)) {
+    if (lnkPath && (0, import_node_fs2.existsSync)(lnkPath)) {
       console.log('       Desktop shortcut: "Stikfix Host" (icon on your Desktop)');
     } else if (batchPath) {
       console.log("       Batch file: " + batchPath);
@@ -567,17 +604,13 @@ if (subcommand === "init") {
   console.log("  npx --yes stikfix@latest init --root " + root);
 } else if (subcommand === "uninstall") {
   const browser = resolveBrowser(values["browser"]);
-  try {
-    unregisterNativeHost({ browser });
-  } catch (err) {
-    console.error("stikfix uninstall: error removing native-host manifest:", String(err));
+  const teardown = teardownHost({ browser });
+  if (teardown.manifestError) {
+    console.error("stikfix uninstall: error removing native-host manifest:", teardown.manifestError);
   }
-  try {
-    unregisterStartup();
-  } catch (err) {
-    console.error("stikfix uninstall: error removing startup entry:", String(err));
+  if (teardown.startupError) {
+    console.error("stikfix uninstall: error removing startup entry:", teardown.startupError);
   }
-  (0, import_node_fs2.rmSync)(CONFIG_PATH, { force: true });
   console.log("stikfix: native host unregistered.");
   console.log("  manifest removed");
   console.log("  launcher files removed");

package/dist/host/stikfix-native.cjs

@@ -23,6 +23,7 @@ __export(native_host_exports, {
   handlePickFolder: () => handlePickFolder,
   handleStartHost: () => handleStartHost,
   main: () => main,
+  runNativeHost: () => runNativeHost,
   validateChosenFolder: () => validateChosenFolder
 });
 module.exports = __toCommonJS(native_host_exports);
@@ -212,8 +213,11 @@ function handleStartHost(cfg, root, spawnFn = import_node_child_process2.spawn,
   }
   const nodePath = typeof cfg.nodePath === "string" && cfg.nodePath.length > 0 ? cfg.nodePath : process.execPath;
   const hostEntry = resolveHostEntry(cfg);
+  const hostExe = typeof cfg.hostExe === "string" && cfg.hostExe.length > 0 ? cfg.hostExe : void 0;
+  const spawnCmd = hostExe ?? nodePath;
+  const spawnArgs = hostExe ? ["serve", "--root", resolvedRoot] : [hostEntry, "--root", resolvedRoot];
   try {
-    const child = spawnFn(nodePath, [hostEntry, "--root", resolvedRoot], {
+    const child = spawnFn(spawnCmd, spawnArgs, {
       detached: true,
       stdio: "ignore",
       windowsHide: true
@@ -315,7 +319,17 @@ function main() {
     process.exit(0);
   });
 }
-if (typeof require !== "undefined" && typeof module !== "undefined" && require.main === module) {
+async function runNativeHost() {
+  main();
+}
+function bundledInExe() {
+  try {
+    return typeof __STIKFIX_BUNDLED__ !== "undefined" && __STIKFIX_BUNDLED__ === true;
+  } catch {
+    return false;
+  }
+}
+if (!bundledInExe() && typeof require !== "undefined" && typeof module !== "undefined" && require.main === module) {
   main();
 }
 // Annotate the CommonJS export names for ESM import in node:
@@ -323,5 +337,6 @@ if (typeof require !== "undefined" && typeof module !== "undefined" && require.m
   handlePickFolder,
   handleStartHost,
   main,
+  runNativeHost,
   validateChosenFolder
 });

package/dist/lib/pin-position.js

@@ -0,0 +1,69 @@
+/**
+ * URL-path matching and pin position computation for stikfix persistent pins.
+ *
+ * matchesUrlPath + computePinPosition — pure, node:test-safe (no DOM/chrome at module level).
+ * Scroll offsets and anchor rects are PASSED AS PARAMETERS by the caller (pin.ts in Plan 04),
+ * which supplies window.scrollX/scrollY and el.getBoundingClientRect() at render time.
+ *
+ * INVARIANT: No top-level browser API access — no window/document/chrome references.
+ * This module imports cleanly under node:test.
+ */
+/**
+ * Compare two URLs by pathname only, ignoring query string and fragment (D-02).
+ * Returns false (not throws) on any malformed URL input.
+ *
+ * @param noteUrl  The URL stored in the note's YAML frontmatter
+ * @param pageUrl  The current page URL from chrome.tabs.get
+ */
+export function matchesUrlPath(noteUrl, pageUrl) {
+    try {
+        const notePath = new URL(noteUrl).pathname;
+        const pagePath = new URL(pageUrl).pathname;
+        return notePath === pagePath;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Compute the CSS viewport position for an on-page pin — pure, DOM-free.
+ *
+ * Branch logic:
+ *   - orphaned || anchorRect === null: orphaned-fallback at last-known page-absolute
+ *     rect minus scroll offsets → { left: storedRect.x - scrollX, top: storedRect.y - scrollY, orphaned: true }
+ *   - !orphaned && anchorRect !== null: use anchorRect x/y directly (already in
+ *     fixed/viewport coords from getBoundingClientRect or stored viewport coords
+ *     for free notes) → { left: anchorRect.x, top: anchorRect.y, orphaned: false }
+ *
+ * The caller (pin.ts) passes:
+ *   - anchorRect: el.getBoundingClientRect() for element pins, stored viewport
+ *     coords {x,y,width:0,height:0} for free pins, or null when selector misses.
+ *   - storedRect: page-absolute rect from frontmatter (for orphaned-fallback).
+ *   - scrollX/scrollY: window.scrollX / window.scrollY at call time.
+ *   - orphaned: true when the selector re-query returned null.
+ *
+ * NEVER reads window.scrollX or window.scrollY internally — caller supplies them.
+ *
+ * @param anchorRect  Live fixed-coord rect from getBoundingClientRect, or null
+ * @param storedRect  Page-absolute rect from frontmatter (orphaned fallback), or null
+ * @param scrollX     window.scrollX at call time (passed by caller)
+ * @param scrollY     window.scrollY at call time (passed by caller)
+ * @param orphaned    true when selector matched nothing on the current page
+ */
+export function computePinPosition(anchorRect, storedRect, scrollX, scrollY, orphaned) {
+    if (orphaned || anchorRect === null) {
+        // Orphaned fallback: last-known page-absolute rect → convert to viewport via scroll
+        return {
+            left: (storedRect?.x ?? 0) - scrollX,
+            top: (storedRect?.y ?? 0) - scrollY,
+            orphaned: true,
+        };
+    }
+    // Element-anchored (live getBoundingClientRect in fixed/viewport coords)
+    // OR free-floating (stored viewport coords already in anchorRect x/y)
+    return {
+        left: anchorRect.x,
+        top: anchorRect.y,
+        orphaned: false,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stikfix",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Pin sticky notes on any page — your AI reads them.",
   "license": "MIT",
   "author": "Omer Nesher <omernesher@gmail.com>",
@@ -32,6 +32,7 @@
   },
   "files": [
     "dist/host/src",
+    "dist/lib/pin-position.js",
     "dist/host/stikfix-init.cjs",
     "dist/host/stikfix-native.cjs",
     "public/icon",
@@ -50,13 +51,19 @@
     "test:lib": "tsc -p tsconfig.lib.json && node --test \"dist/lib/lib/test/**/*.test.js\"",
     "test": "tsc -p tsconfig.host.json && node --test \"dist/host/test/**/*.test.js\"",
     "check": "tsc --noEmit && tsc --noEmit -p tsconfig.host.json && node scripts/clean-room-check.mjs && node scripts/host-smoke-test.mjs && npm run test:lib && npm test",
+    "pack:crx": "node scripts/pack-crx.mjs",
+    "gen:update-xml": "node scripts/gen-update-xml.mjs",
+    "build:sea": "node scripts/build-sea.mjs",
+    "build:installer": "node scripts/build-installer.mjs",
     "postinstall": "node -e \"try{require.resolve('wxt');require('node:child_process').execSync('wxt prepare',{stdio:'inherit'})}catch(e){}\""
   },
   "devDependencies": {
     "@medv/finder": "4.0.2",
     "@types/chrome": "0.1.42",
     "@types/node": "25.9.1",
+    "crx3": "2.0.0",
     "interactjs": "1.10.27",
+    "postject": "1.0.0-alpha.6",
     "typescript": "6.0.3",
     "wxt": "0.20.26"
   },