@hasna/instructions 0.5.3 → 0.5.5

package/dist/lib/app-home.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Configs-app store-home resolution via the @hasna/paths resolver (XDG / macOS
+ * home layout). The "configs" app is the @hasna/instructions package surface
+ * that ships the `configs` / `configs-mcp` aliases and owns the configs store
+ * (SQLite store, backups, station-profile cache). Every shipped local-storage
+ * path derives from the effective store home.
+ *
+ * The legacy `~/.hasna/instructions` default (with the `HASNA_CONFIGS_HOME`
+ * exact-app override) stays the effective store home until the store has
+ * actually been migrated to the XDG config home or the operator sets the
+ * config-kind override `HASNA_CONFIG_HOME` — an existing local store never
+ * becomes invisible on upgrade.
+ */
+export declare const HASNA_CONFIGS_HOME_ENV = "HASNA_CONFIGS_HOME";
+/** Pre-XDG default store home: ~/.hasna/instructions (computed at call time; HOME may be redirected). */
+export declare function legacyStoreHome(env?: NodeJS.ProcessEnv): string;
+/**
+ * The @hasna/paths-resolved config home for the configs app (XDG layout):
+ * ~/.config/hasna/configs on Linux; ~/Library/Application
+ * Support/Hasna/configs on macOS.
+ */
+export declare function resolverStoreHome(env?: NodeJS.ProcessEnv): string;
+/**
+ * Whether the resolver (XDG) home should be adopted as the store home. The
+ * resolver home is adopted only when the operator has set `HASNA_CONFIG_HOME`
+ * (the config-kind override — a deliberate opt-in to the XDG layout) or the
+ * store has already been physically migrated there (`instructions.db` exists at
+ * the resolver home). A machine that only redirects another kind must NOT have
+ * its configs store moved, and a live store at the legacy home must never
+ * become invisible on upgrade.
+ */
+export declare function adoptResolverStoreHome(resolved: string, env?: NodeJS.ProcessEnv): boolean;
+/** The exact-app override root: `HASNA_CONFIGS_HOME`. Empty values are treated as unset. */
+export declare function exactStoreHome(env?: NodeJS.ProcessEnv): string | undefined;
+/**
+ * Effective configs store home: the exact-app override (`HASNA_CONFIGS_HOME`)
+ * wins unconditionally; otherwise the @hasna/paths config home once adopted
+ * (`HASNA_CONFIG_HOME` set or the store already migrated there); otherwise the
+ * legacy `~/.hasna/instructions` default, so an existing store never becomes
+ * invisible on upgrade.
+ */
+export declare function getConfigsStoreHome(env?: NodeJS.ProcessEnv): string;
+/** The store's SQLite database path under the effective store home. */
+export declare function getConfigsStoreDbPath(env?: NodeJS.ProcessEnv): string;
+/**
+ * The local database path surfaced by server status/health surfaces (e.g. the
+ * MCP server's `db_path` field). The exact `HASNA_INSTRUCTIONS_DB_PATH`
+ * override wins; otherwise the resolver-derived store db path (legacy
+ * `~/.hasna/instructions/instructions.db` until the XDG config home is
+ * adopted, matching `db/database.ts`). A server status must never hardcode the
+ * legacy literal — the store can live at the resolver home.
+ */
+export declare function getReportedDbPath(env?: NodeJS.ProcessEnv): string;
+//# sourceMappingURL=app-home.d.ts.map

package/dist/lib/app-home.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-home.d.ts","sourceRoot":"","sources":["../../src/lib/app-home.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,sBAAsB,uBAAuB,CAAC;AAM3D,yGAAyG;AACzG,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAE5E;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAE9E;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAIT;AAED,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,GAAG,SAAS,CAGvF;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAKhF;AAED,uEAAuE;AACvE,wBAAgB,qBAAqB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAElF;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAI9E"}

package/dist/lib/app-home.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=app-home.test.d.ts.map

package/dist/lib/app-home.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-home.test.d.ts","sourceRoot":"","sources":["../../src/lib/app-home.test.ts"],"names":[],"mappings":""}

package/dist/lib/raw-store-root.d.ts

@@ -1,17 +1,21 @@
 /**
  * Legacy environment variable that overrides the raw store root.
- * Kept for compatibility: the canonical default is `~/.hasna/instructions`,
+ * Kept for compatibility: the canonical default is the effective configs store
+ * home (legacy `~/.hasna/instructions` until the XDG config home is adopted),
  * and `HASNA_CONFIGS_HOME` remains a supported override.
  */
 export declare const RAW_STORE_ROOT_ENV = "HASNA_CONFIGS_HOME";
 /**
- * Canonical data root for the instructions app.
+ * Canonical data root for the instructions/configs app.
  *
- * Defaults to `~/.hasna/instructions` (was `~/.hasna/configs`, another app's
- * home). Every shipped local-storage path derives from this root: the SQLite
- * store (`db/database.ts`) and the CLI db-path / backup computations
- * (`cli/index.tsx`). `HASNA_CONFIGS_HOME` overrides the default and is
- * honored by every derived path.
+ * Every shipped local-storage path derives from this root: the SQLite store
+ * (`db/database.ts`) and the CLI db-path / backup computations
+ * (`cli/index.tsx`). The root is resolved through the @hasna/paths resolver
+ * (XDG / macOS home layout): the legacy `~/.hasna/instructions` default (with
+ * the `HASNA_CONFIGS_HOME` exact-app override) stays the effective root until
+ * the store has actually been migrated to the XDG config home or the operator
+ * sets the config-kind override `HASNA_CONFIG_HOME`. An existing local store
+ * never becomes invisible on upgrade.
  */
-export declare function getRawStoreRoot(): string;
+export declare function getRawStoreRoot(env?: NodeJS.ProcessEnv): string;
 //# sourceMappingURL=raw-store-root.d.ts.map

package/dist/lib/raw-store-root.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"raw-store-root.d.ts","sourceRoot":"","sources":["../../src/lib/raw-store-root.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AAEvD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAIxC"}
+{"version":3,"file":"raw-store-root.d.ts","sourceRoot":"","sources":["../../src/lib/raw-store-root.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAE5E"}

package/dist/lib/station-profile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"station-profile.d.ts","sourceRoot":"","sources":["../../src/lib/station-profile.ts"],"names":[],"mappings":"AAsDA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAEpE,8EAA8E;AAC9E,eAAO,MAAM,8BAA8B,uBAAuB,CAAC;AAEnE,iFAAiF;AACjF,eAAO,MAAM,yBAAyB,oBAAoB,CAAC;AAC3D,4FAA4F;AAC5F,eAAO,MAAM,qBAAqB,EAAG,SAAkB,CAAC;AAExD,6EAA6E;AAC7E,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAC7C,2FAA2F;AAC3F,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAClD;wEACwE;AACxE,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAEhD,gEAAgE;AAChE,eAAO,MAAM,6BAA6B,WAAW,CAAC;AAEtD,eAAO,MAAM,0BAA0B,iCAAiC,CAAC;AACzE,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAE7C,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,iEAAiE;IACjE,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC;gFAC4E;IAC5E,MAAM,EAAE,mBAAmB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,qBAAqB,CAAC;IAC/B,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,qBAAqB,CAAC;IAC/B,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACxC,WAAW,EAAE,IAAI,GAAG,SAAS,GAAG,QAAQ,CAAC;CAC1C;AAMD;;0BAE0B;AAC1B,wBAAgB,0BAA0B,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAGvF;AAED,wBAAgB,uBAAuB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAEpF;AAED,wBAAgB,sBAAsB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAEnF;AAED;yEACyE;AACzE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAWxF;AAED;2DAC2D;AAC3D,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,EAC/C,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAKhC;AAcD;yEACyE;AACzE,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAkBjF;AAED;8EAC8E;AAC9E,wBAAgB,4BAA4B,CAC1C,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAChC,qBAAqB,CAmBvB;AAsBD;;;;4EAI4E;AAC5E,wBAAgB,6BAA6B,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,sBAAsB,GAAG,IAAI,CAmBjH;AAQD;;;eAGe;AACf,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,wBAAwB,GAAG,MAAM,CAqChF;AASD;0EAC0E;AAC1E,wBAAgB,qBAAqB,CACnC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3E,2BAA2B,CA8B7B;AAED,yCAAyC;AACzC,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,GAAG,IAAI,CAQtF;AAED;6EAC6E;AAC7E,wBAAgB,oBAAoB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,wBAAwB,GAAG,IAAI,CAY1G"}
+{"version":3,"file":"station-profile.d.ts","sourceRoot":"","sources":["../../src/lib/station-profile.ts"],"names":[],"mappings":"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"}

package/dist/mcp/index.js

@@ -97,19 +97,131 @@ var init_retired_storage_mode = __esm(() => {
   ];
 });
 
-// src/lib/raw-store-root.ts
+// ../../node_modules/.bun/@hasna+paths@0.1.0/node_modules/@hasna/paths/dist/index.js
 import { homedir } from "os";
-import { join as join2, resolve } from "path";
-function getRawStoreRoot() {
-  return resolve(process.env[RAW_STORE_ROOT_ENV] || join2(process.env["HOME"] || homedir(), ".hasna", "instructions"));
+import { join as join2 } from "path";
+function assertApp(app) {
+  if (typeof app !== "string" || app.length === 0) {
+    throw new TypeError("paths: app must be a non-empty string");
+  }
+  if (!APP_SLUG_RE.test(app)) {
+    throw new TypeError(`paths: invalid app slug "${app}" \u2014 expected lowercase kebab-case ([a-z0-9]+(-[a-z0-9]+)*)`);
+  }
+}
+function envOf(options) {
+  return options.env ?? process.env;
+}
+function envValue(options, kind) {
+  const value = envOf(options)[KIND_ENV[kind]];
+  return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function isMacOS(platform) {
+  return platform === "darwin";
+}
+function baseDir(kind, options) {
+  const override = envValue(options, kind);
+  if (override)
+    return override;
+  const home = options.home ?? homedir();
+  const platform = options.platform ?? process.platform;
+  if (isMacOS(platform)) {
+    switch (kind) {
+      case "config":
+      case "data":
+        return join2(home, "Library", "Application Support", "Hasna");
+      case "cache":
+        return join2(home, "Library", "Caches", "Hasna");
+      case "state":
+        return join2(home, "Library", "Logs", "Hasna");
+    }
+  }
+  switch (kind) {
+    case "config":
+      return join2(home, ".config", "hasna");
+    case "data":
+      return join2(home, ".local", "share", "hasna");
+    case "state":
+      return join2(home, ".local", "state", "hasna");
+    case "cache":
+      return join2(home, ".cache", "hasna");
+  }
+}
+function resolvePath(kind, options) {
+  assertApp(options.app);
+  const appSegment = options.internal === true ? join2("internal", options.app) : options.app;
+  return join2(baseDir(kind, options), appSegment);
+}
+function configDir(options) {
+  return resolvePath("config", options);
+}
+var KIND_ENV, APP_SLUG_RE;
+var init_dist = __esm(() => {
+  KIND_ENV = {
+    config: "HASNA_CONFIG_HOME",
+    data: "HASNA_DATA_HOME",
+    state: "HASNA_STATE_HOME",
+    cache: "HASNA_CACHE_HOME"
+  };
+  APP_SLUG_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+});
+
+// src/lib/app-home.ts
+import { existsSync as existsSync2 } from "fs";
+import { homedir as homedir2 } from "os";
+import { join as join3, resolve } from "path";
+function homeDir(env = process.env) {
+  return env["HOME"] || env["USERPROFILE"] || homedir2();
+}
+function legacyStoreHome(env = process.env) {
+  return resolve(join3(homeDir(env), ".hasna", "instructions"));
+}
+function resolverStoreHome(env = process.env) {
+  return configDir({ app: "configs", env, home: env.HOME || env.USERPROFILE || homedir2() });
+}
+function adoptResolverStoreHome(resolved, env = process.env) {
+  const override = env.HASNA_CONFIG_HOME;
+  if (typeof override === "string" && override.trim().length > 0)
+    return true;
+  return existsSync2(join3(resolved, "instructions.db"));
+}
+function exactStoreHome(env = process.env) {
+  const v = env[HASNA_CONFIGS_HOME_ENV];
+  return v && v.trim() ? v.trim() : undefined;
+}
+function getConfigsStoreHome(env = process.env) {
+  const exact = exactStoreHome(env);
+  if (exact)
+    return resolve(exact);
+  const resolved = resolverStoreHome(env);
+  return adoptResolverStoreHome(resolved, env) ? resolve(resolved) : legacyStoreHome(env);
+}
+function getConfigsStoreDbPath(env = process.env) {
+  return join3(getConfigsStoreHome(env), "instructions.db");
+}
+function getReportedDbPath(env = process.env) {
+  const override = env["HASNA_INSTRUCTIONS_DB_PATH"];
+  if (typeof override === "string" && override.length > 0)
+    return override;
+  return getConfigsStoreDbPath(env);
+}
+var HASNA_CONFIGS_HOME_ENV = "HASNA_CONFIGS_HOME";
+var init_app_home = __esm(() => {
+  init_dist();
+});
+
+// src/lib/raw-store-root.ts
+import { resolve as resolve2 } from "path";
+function getRawStoreRoot(env = process.env) {
+  return resolve2(getConfigsStoreHome(env));
 }
-var RAW_STORE_ROOT_ENV = "HASNA_CONFIGS_HOME";
-var init_raw_store_root = () => {};
+var init_raw_store_root = __esm(() => {
+  init_app_home();
+});
 
 // src/db/database.ts
 import { Database } from "bun:sqlite";
-import { existsSync as existsSync2, mkdirSync, rmSync } from "fs";
-import { join as join3 } from "path";
+import { existsSync as existsSync3, mkdirSync, rmSync } from "fs";
+import { join as join4 } from "path";
 import { randomUUID } from "crypto";
 function getDbPath() {
   if (process.env["HASNA_INSTRUCTIONS_DB_PATH"]) {
@@ -117,7 +229,7 @@ function getDbPath() {
   }
   const dir = getRawStoreRoot();
   mkdirSync(dir, { recursive: true });
-  return join3(dir, "instructions.db");
+  return join4(dir, "instructions.db");
 }
 function uuid() {
   return randomUUID();
@@ -158,7 +270,7 @@ function resetLocalDatabase() {
   if (dbPath === ":memory:")
     return;
   for (const p of [dbPath, `${dbPath}-wal`, `${dbPath}-shm`]) {
-    if (existsSync2(p))
+    if (existsSync3(p))
       rmSync(p);
   }
 }
@@ -595,9 +707,9 @@ var init_template = __esm(() => {
 });
 
 // src/lib/machine.ts
-import { arch as currentArch, homedir as homedir2, hostname as currentHostname, type as currentOsType } from "os";
-import { existsSync as existsSync3 } from "fs";
-import { join as join4 } from "path";
+import { arch as currentArch, homedir as homedir3, hostname as currentHostname, type as currentOsType } from "os";
+import { existsSync as existsSync4 } from "fs";
+import { join as join5 } from "path";
 function normalizeOsFamily(os) {
   const value = (os ?? "").trim().toLowerCase();
   if (value === "darwin" || value === "macos" || value === "mac" || value === "osx")
@@ -609,11 +721,11 @@ function normalizeOsFamily(os) {
   return value || "unknown";
 }
 function detectMachineContext(overrides = {}) {
-  const homeDir = overrides.home_dir ?? process.env["CONFIGS_HOME"] ?? process.env["HOME"] ?? homedir2();
+  const homeDir2 = overrides.home_dir ?? process.env["CONFIGS_HOME"] ?? process.env["HOME"] ?? homedir3();
   const os = overrides.os ?? currentOsType();
   const osFamily = normalizeOsFamily(os);
-  const bunBinDir = overrides.bun_bin_dir ?? join4(homeDir, ".bun", "bin");
-  const defaultBunPath = osFamily === "macos" && existsSync3(BREW_BUN_PATH) ? BREW_BUN_PATH : join4(bunBinDir, "bun");
+  const bunBinDir = overrides.bun_bin_dir ?? join5(homeDir2, ".bun", "bin");
+  const defaultBunPath = osFamily === "macos" && existsSync4(BREW_BUN_PATH) ? BREW_BUN_PATH : join5(bunBinDir, "bun");
   return {
     id: "current-machine",
     hostname: overrides.hostname ?? currentHostname(),
@@ -622,11 +734,11 @@ function detectMachineContext(overrides = {}) {
     last_applied_at: null,
     created_at: "",
     os_family: osFamily,
-    home_dir: homeDir,
-    workspace_root: overrides.workspace_root ?? join4(homeDir, osFamily === "macos" ? "Workspace" : "workspace"),
+    home_dir: homeDir2,
+    workspace_root: overrides.workspace_root ?? join5(homeDir2, osFamily === "macos" ? "Workspace" : "workspace"),
     bun_bin_dir: bunBinDir,
     bun_path: overrides.bun_path ?? defaultBunPath,
-    path_prefix: overrides.path_prefix ?? (osFamily === "macos" ? `${join4("/opt", "homebrew", "bin")}:${bunBinDir}` : bunBinDir)
+    path_prefix: overrides.path_prefix ?? (osFamily === "macos" ? `${join5("/opt", "homebrew", "bin")}:${bunBinDir}` : bunBinDir)
   };
 }
 function machineContextToVariables(machine) {
@@ -5139,7 +5251,7 @@ var init_session_render_contract = __esm(() => {
 });
 
 // src/lib/project-context.ts
-import { basename, dirname as dirname2, isAbsolute, join as join5, parse, relative, resolve as resolve2 } from "path";
+import { basename, dirname as dirname2, isAbsolute, join as join6, parse, relative, resolve as resolve3 } from "path";
 function revisionKey(value) {
   const sequence = value.match(/^(?:rev-)?([0-9]+)$/);
   if (sequence)
@@ -5701,13 +5813,13 @@ var init_asset_plan = __esm(() => {
 
 // src/lib/cursor-authority.ts
 import { createHash } from "crypto";
-import { homedir as homedir3 } from "os";
-import { join as join6, resolve as resolve3 } from "path";
+import { homedir as homedir4 } from "os";
+import { join as join7, resolve as resolve4 } from "path";
 function sha256(content) {
   return createHash("sha256").update(content).digest("hex");
 }
-function homeDir() {
-  return process.env["HOME"] || homedir3();
+function homeDir2() {
+  return process.env["HOME"] || homedir4();
 }
 function markerPayload(content, markerLine, markerIndex) {
   const index = markerIndex ?? content.indexOf(markerLine);
@@ -5716,7 +5828,7 @@ function markerPayload(content, markerLine, markerIndex) {
   return content.slice(0, index) + content.slice(index + markerLine.length).replace(/^\n/, "");
 }
 function isCursorGlobalAuthorityPath(path) {
-  return resolve3(path) === resolve3(join6(homeDir(), CURSOR_GLOBAL_AUTHORITY_RELATIVE_PATH));
+  return resolve4(path) === resolve4(join7(homeDir2(), CURSOR_GLOBAL_AUTHORITY_RELATIVE_PATH));
 }
 function stampCursorGlobalAuthorityMarker(content) {
   const existing = content.match(CURSOR_GLOBAL_AUTHORITY_MARKER_PATTERN);
@@ -6924,8 +7036,8 @@ var init_config_store = __esm(() => {
 });
 
 // src/lib/session-render-ownership.ts
-import { existsSync as existsSync4, readFileSync as readFileSync2, statSync } from "fs";
-import { dirname as dirname3, join as join7, parse as parse2, relative as relative2, sep } from "path";
+import { existsSync as existsSync5, readFileSync as readFileSync2, statSync } from "fs";
+import { dirname as dirname3, join as join8, parse as parse2, relative as relative2, sep } from "path";
 function toSegments(absolutePath2) {
   return absolutePath2.replaceAll("\\", "/").split("/").filter(Boolean);
 }
@@ -6944,7 +7056,7 @@ function pathIsSessionRenderManagedDir(absolutePath2) {
 function readManifestRelativePaths(manifestPath) {
   let stats;
   try {
-    if (!existsSync4(manifestPath))
+    if (!existsSync5(manifestPath))
       return null;
     stats = statSync(manifestPath);
   } catch {
@@ -6973,7 +7085,7 @@ function sessionRenderManifestClaimsPath(absolutePath2) {
   const root = parse2(absolutePath2).root;
   let home = dirname3(absolutePath2);
   for (let depth = 0;depth < MANIFEST_ANCESTOR_LIMIT; depth += 1) {
-    const manifestPath = join7(home, ...SESSION_RENDER_MANIFEST_RELATIVE_PATH.split("/"));
+    const manifestPath = join8(home, ...SESSION_RENDER_MANIFEST_RELATIVE_PATH.split("/"));
     const relativePaths = readManifestRelativePaths(manifestPath);
     if (relativePaths) {
       const claimed = relative2(home, absolutePath2).split(sep).join("/");
@@ -7008,17 +7120,17 @@ __export(exports_apply, {
   applyConfigs: () => applyConfigs,
   applyConfig: () => applyConfig
 });
-import { existsSync as existsSync5, mkdirSync as mkdirSync2, readFileSync as readFileSync3, realpathSync, writeFileSync } from "fs";
-import { basename as basename3, dirname as dirname4, join as join8, resolve as resolve4 } from "path";
-import { homedir as homedir4 } from "os";
+import { existsSync as existsSync6, mkdirSync as mkdirSync2, readFileSync as readFileSync3, realpathSync, writeFileSync } from "fs";
+import { basename as basename3, dirname as dirname4, join as join9, resolve as resolve5 } from "path";
+import { homedir as homedir5 } from "os";
 function getConfigHome() {
-  return process.env["CONFIGS_HOME"] || process.env["HOME"] || homedir4();
+  return process.env["CONFIGS_HOME"] || process.env["HOME"] || homedir5();
 }
 function expandPath(p) {
   if (p.startsWith("~/")) {
-    return resolve4(getConfigHome(), p.slice(2));
+    return resolve5(getConfigHome(), p.slice(2));
   }
-  return resolve4(p);
+  return resolve5(p);
 }
 function normalizeTargetPath(p) {
   const expanded = expandPath(p);
@@ -7028,9 +7140,9 @@ function normalizeTargetPath(p) {
     let current = expanded;
     const missingSegments = [];
     while (true) {
-      if (existsSync5(current)) {
+      if (existsSync6(current)) {
         try {
-          return resolve4(realpathSync(current), ...missingSegments);
+          return resolve5(realpathSync(current), ...missingSegments);
         } catch {
           return expanded;
         }
@@ -7059,11 +7171,11 @@ async function writeConfigResult(config, targetPath, content, opts, meta = {}) {
   }
   const path = expandPath(renderedTargetPath);
   const renderedForTarget = isCursorGlobalAuthorityPath(path) ? stampCursorGlobalAuthorityMarker(renderedContent) : renderedContent;
-  const previousContent = existsSync5(path) ? readFileSync3(path, "utf-8") : null;
+  const previousContent = existsSync6(path) ? readFileSync3(path, "utf-8") : null;
   const changed = previousContent !== renderedForTarget;
   if (!opts.dryRun) {
     const dir = dirname4(path);
-    if (!existsSync5(dir)) {
+    if (!existsSync6(dir)) {
       mkdirSync2(dir, { recursive: true });
     }
     if (previousContent !== null && changed) {
@@ -7097,7 +7209,7 @@ function wouldDestroyACredential(targetPath, renderedContent, format) {
   let current;
   try {
     const path = expandPath(targetPath);
-    if (!existsSync5(path))
+    if (!existsSync6(path))
       return [];
     current = readFileSync3(path, "utf-8");
   } catch {
@@ -7423,7 +7535,7 @@ function sessionRendererOwnsCanonicalTarget(normalized, opts) {
     getConfigHome(),
     opts.vars?.["HOME_DIR"]
   ].filter((home) => typeof home === "string" && home.length > 0));
-  if ([...homes].some((home) => SESSION_RENDER_OWNED_CONFIG_TARGETS.some((relativePath) => normalized === normalizeTargetPath(join8(home, ...relativePath.split("/"))))))
+  if ([...homes].some((home) => SESSION_RENDER_OWNED_CONFIG_TARGETS.some((relativePath) => normalized === normalizeTargetPath(join9(home, ...relativePath.split("/"))))))
     return true;
   return sessionRenderOwnsPath(normalized);
 }
@@ -7456,8 +7568,8 @@ __export(exports_sync, {
   KNOWN_CONFIGS: () => KNOWN_CONFIGS,
   CLAUDE_PROMPT_OUTPUTS: () => CLAUDE_PROMPT_OUTPUTS
 });
-import { existsSync as existsSync6, readdirSync, readFileSync as readFileSync4 } from "fs";
-import { basename as basename4, extname as extname2, join as join9 } from "path";
+import { existsSync as existsSync7, readdirSync, readFileSync as readFileSync4 } from "fs";
+import { basename as basename4, extname as extname2, join as join10 } from "path";
 function claudeRuleOutputs(fileName) {
   const stem = basename4(fileName, extname2(fileName));
   return [
@@ -7496,7 +7608,7 @@ function isGeneratedOutputTarget2(config, owners) {
   return !!ownerIds && !ownerIds.has(config.id);
 }
 function hasClaudePromptSource() {
-  return existsSync6(expandPath("~/.claude/CLAUDE.md"));
+  return existsSync7(expandPath("~/.claude/CLAUDE.md"));
 }
 function hasClaudeRuleSourceForCursorTarget(targetPath) {
   const absoluteTargetPath = expandPath(targetPath);
@@ -7504,7 +7616,7 @@ function hasClaudeRuleSourceForCursorTarget(targetPath) {
   if (!absoluteTargetPath.startsWith(`${absolutePrefix}/`) || !absoluteTargetPath.endsWith(".mdc"))
     return false;
   const stem = basename4(absoluteTargetPath, ".mdc");
-  return existsSync6(expandPath(`~/.claude/rules/${stem}.md`)) || existsSync6(expandPath(`~/.claude/rules/${stem}.mdc`));
+  return existsSync7(expandPath(`~/.claude/rules/${stem}.md`)) || existsSync7(expandPath(`~/.claude/rules/${stem}.mdc`));
 }
 function isKnownGeneratedTargetPath(targetPath) {
   const normalizedTargetPath = normalizeTargetPath(targetPath);
@@ -7521,8 +7633,8 @@ async function syncProject(opts) {
   const allConfigs = await store.listConfigs();
   const machine = detectMachineContext();
   for (const pf of PROJECT_CONFIG_FILES) {
-    const abs = join9(absDir, pf.file);
-    if (!existsSync6(abs))
+    const abs = join10(absDir, pf.file);
+    if (!existsSync7(abs))
       continue;
     try {
       const rawContent = readFileSync4(abs, "utf-8");
@@ -7554,19 +7666,19 @@ async function syncProject(opts) {
     }
   }
   for (const ruleDir of [
-    { dir: join9(absDir, ".claude", "rules"), agent: "claude", namePrefix: "rules" },
-    { dir: join9(absDir, ".agents", "rules"), agent: "antigravity", namePrefix: "antigravity-rules" },
-    { dir: join9(absDir, ".cursor", "rules"), agent: "cursor", namePrefix: "cursor-rules" },
-    { dir: join9(absDir, ".github", "instructions"), agent: "copilot", namePrefix: "copilot-instructions" },
-    { dir: join9(absDir, ".devin", "rules"), agent: "devin", namePrefix: "devin-rules" },
-    { dir: join9(absDir, ".windsurf", "rules"), agent: "windsurf-legacy", namePrefix: "windsurf-rules" },
-    { dir: join9(absDir, ".clinerules"), agent: "cline", namePrefix: "cline-rules" }
+    { dir: join10(absDir, ".claude", "rules"), agent: "claude", namePrefix: "rules" },
+    { dir: join10(absDir, ".agents", "rules"), agent: "antigravity", namePrefix: "antigravity-rules" },
+    { dir: join10(absDir, ".cursor", "rules"), agent: "cursor", namePrefix: "cursor-rules" },
+    { dir: join10(absDir, ".github", "instructions"), agent: "copilot", namePrefix: "copilot-instructions" },
+    { dir: join10(absDir, ".devin", "rules"), agent: "devin", namePrefix: "devin-rules" },
+    { dir: join10(absDir, ".windsurf", "rules"), agent: "windsurf-legacy", namePrefix: "windsurf-rules" },
+    { dir: join10(absDir, ".clinerules"), agent: "cline", namePrefix: "cline-rules" }
   ]) {
-    if (!existsSync6(ruleDir.dir))
+    if (!existsSync7(ruleDir.dir))
       continue;
     const mdFiles = readdirSync(ruleDir.dir).filter((f) => f.endsWith(".md") || f.endsWith(".mdc"));
     for (const f of mdFiles) {
-      const abs = join9(ruleDir.dir, f);
+      const abs = join10(ruleDir.dir, f);
       const raw = readFileSync4(abs, "utf-8");
       const redacted = redactContent(raw, "markdown");
       const machineAware = templateizeMachineContent(redacted.content, machine);
@@ -7606,14 +7718,14 @@ async function syncKnown(opts = {}) {
   for (const known of targets) {
     if (known.rulesDir) {
       const absDir = expandPath(known.rulesDir);
-      if (!existsSync6(absDir)) {
+      if (!existsSync7(absDir)) {
         result.skipped.push(known.rulesDir);
         continue;
       }
       const extensions = known.rulesExtensions ?? [".md", ".mdc"];
       const ruleFiles = readdirSync(absDir).filter((f) => extensions.some((ext) => f.endsWith(ext)));
       for (const f of ruleFiles) {
-        const abs2 = join9(absDir, f);
+        const abs2 = join10(absDir, f);
         const targetPath = abs2.replace(home, "~");
         if (existingOutputOwners.has(normalizeTargetPath(targetPath)) || isKnownGeneratedTargetPath(targetPath)) {
           result.skipped.push(`${targetPath} (generated output)`);
@@ -7647,7 +7759,7 @@ async function syncKnown(opts = {}) {
       continue;
     }
     const abs = expandPath(known.path);
-    if (!existsSync6(abs)) {
+    if (!existsSync7(abs)) {
       result.skipped.push(known.path);
       continue;
     }
@@ -7753,7 +7865,7 @@ function storedPlaceholderIsLiteralOnDisk(storedLine, diskLine) {
 }
 function buildDiff(expectedContent, targetPath, storedFormat, showSecrets) {
   const path = expandPath(targetPath);
-  if (!existsSync6(path))
+  if (!existsSync7(path))
     return `(file not found on disk: ${path})`;
   const diskContent = readFileSync4(path, "utf-8");
   if (diskContent === expectedContent)
@@ -7983,20 +8095,20 @@ var init_sync = __esm(() => {
 });
 
 // src/lib/sync-dir.ts
-import { existsSync as existsSync7, readdirSync as readdirSync2, readFileSync as readFileSync5, statSync as statSync2 } from "fs";
-import { join as join10, relative as relative3 } from "path";
-import { homedir as homedir5 } from "os";
+import { existsSync as existsSync8, readdirSync as readdirSync2, readFileSync as readFileSync5, statSync as statSync2 } from "fs";
+import { join as join11, relative as relative3 } from "path";
+import { homedir as homedir6 } from "os";
 function shouldSkip(p) {
   return SKIP.some((s) => p.includes(s));
 }
 async function syncFromDir(dir, opts = {}) {
   const store = opts.store ?? resolveConfigStore();
   const absDir = expandPath(dir);
-  if (!existsSync7(absDir))
+  if (!existsSync8(absDir))
     return { added: 0, updated: 0, unchanged: 0, skipped: [`Not found: ${absDir}`] };
-  const files = opts.recursive !== false ? walkDir(absDir) : readdirSync2(absDir).map((f) => join10(absDir, f)).filter((f) => statSync2(f).isFile());
+  const files = opts.recursive !== false ? walkDir(absDir) : readdirSync2(absDir).map((f) => join11(absDir, f)).filter((f) => statSync2(f).isFile());
   const result = { added: 0, updated: 0, unchanged: 0, skipped: [] };
-  const home = homedir5();
+  const home = homedir6();
   const allConfigs = await store.listConfigs();
   for (const file of files) {
     if (shouldSkip(file)) {
@@ -8031,7 +8143,7 @@ async function syncFromDir(dir, opts = {}) {
 }
 async function syncToDir(dir, opts = {}) {
   const store = opts.store ?? resolveConfigStore();
-  const home = homedir5();
+  const home = homedir6();
   const absDir = expandPath(dir);
   const normalized = dir.startsWith("~/") ? dir : absDir.replace(home, "~");
   const configs = (await store.listConfigs()).filter((c) => c.target_path && (c.target_path.startsWith(normalized) || c.target_path.startsWith(absDir)));
@@ -8055,7 +8167,7 @@ async function syncToDir(dir, opts = {}) {
 }
 function walkDir(dir, files = []) {
   for (const entry of readdirSync2(dir, { withFileTypes: true })) {
-    const full = join10(dir, entry.name);
+    const full = join11(dir, entry.name);
     if (shouldSkip(full))
       continue;
     if (entry.isDirectory())
@@ -8078,7 +8190,7 @@ var init_sync_dir = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/instructions",
-    version: "0.5.3",
+    version: "0.5.5",
     description: "AI coding agent instruction & configuration manager \u2014 store, version, apply, and share all your AI coding configs. CLI + MCP + HTTP API (instructions-serve) + generated SDK + Dashboard.",
     type: "module",
     main: "dist/index.js",
@@ -8119,7 +8231,7 @@ var require_package = __commonJS((exports, module) => {
       "dev:serve": "bun run src/server/index.ts",
       seed: "bun run scripts/seed.ts",
       prepublishOnly: "bun run scripts/check-publish-hold.ts && bun run build",
-      postinstall: "mkdir -p $HOME/.hasna/instructions $HOME/.hasna/instructions/backups 2>/dev/null || true",
+      postinstall: `node -e "const fs=require('node:fs'),path=require('node:path'),os=require('node:os');const home=process.env.HOME||process.env.USERPROFILE||os.homedir();const exact=process.env.HASNA_CONFIGS_HOME;const configHome=process.env.HASNA_CONFIG_HOME;const root=exact&&exact.trim()?path.resolve(exact.trim()):(configHome&&configHome.trim()?path.join(configHome.trim(),'configs'):path.join(home,'.hasna','instructions'));try{fs.mkdirSync(root,{recursive:true,mode:0o700});fs.mkdirSync(path.join(root,'backups'),{recursive:true,mode:0o700});}catch{}"`,
       prepack: "bun run build"
     },
     keywords: [
@@ -8154,12 +8266,13 @@ var require_package = __commonJS((exports, module) => {
     author: "Andrei Hasna <andrei@hasna.com>",
     license: "Apache-2.0",
     dependencies: {
-      "@hasna/contracts": "0.14.0",
+      "@hasna/contracts": "0.14.1",
       "@hasna/events": "^0.1.16",
+      "@hasna/paths": "0.1.0",
       "@modelcontextprotocol/sdk": "^1.12.1",
       chalk: "^5.4.1",
       commander: "^13.1.0",
-      hono: "^4.7.4",
+      hono: "4.13.3",
       ink: "^5.2.0",
       pg: "^8.13.3",
       react: "^18.3.1",
@@ -8209,6 +8322,7 @@ function getPackageVersion() {
 
 // src/mcp/server.ts
 init_config_store();
+init_app_home();
 init_apply();
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
@@ -8472,7 +8586,7 @@ function buildServer() {
             drifted,
             drifted_configs: driftedSlugs.slice(0, 5),
             missing,
-            db_path: process.env["HASNA_INSTRUCTIONS_DB_PATH"] || "~/.hasna/instructions/instructions.db"
+            db_path: getReportedDbPath()
           });
         }
         case "sync_known": {

package/dist/mcp/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AA4EnE,wBAAgB,WAAW,IAAI,MAAM,CA+VpC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AA6EnE,wBAAgB,WAAW,IAAI,MAAM,CA+VpC"}