@gmickel/gno 1.0.5 → 1.1.0

package/README.md

@@ -420,7 +420,7 @@ gno search "incident review" --tags-all "status/active,team/platform"
 # Export a publish artifact for gno.sh
 gno publish export work-docs --out ~/Downloads/work-docs.json
 gno publish export "gno://work-docs/runbooks/deploy.md" --out ~/Downloads/deploy.json
-# Or let GNO choose ~/Downloads/<slug>-<YYYYMMDD>.json automatically
+# Or let GNO choose your Downloads folder automatically
 gno publish export work-docs
 ```
 
@@ -631,7 +631,7 @@ gno publish export "gno://work-docs/runbooks/deploy.md" \
   --passphrase "correct horse battery staple" \
   --out ~/Downloads/deploy-encrypted.json
 
-# Let GNO pick the path (~/Downloads/<slug>-<YYYYMMDD>.json)
+# Let GNO pick the path in your Downloads folder
 gno publish export work-docs
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gmickel/gno",
-  "version": "1.0.5",
+  "version": "1.1.0",
   "description": "Local semantic search for your documents. Index Markdown, PDF, and Office files with hybrid BM25 + vector search.",
   "keywords": [
     "embeddings",

package/src/cli/commands/collection/clear-embeddings.ts

@@ -3,7 +3,7 @@
  */
 
 import { getIndexDbPath } from "../../../app/constants";
-import { loadConfig } from "../../../config";
+import { ensureDirectories, loadConfig } from "../../../config";
 import { resolveModelUri } from "../../../llm/registry";
 import { SqliteAdapter } from "../../../store/sqlite/adapter";
 import { CliError } from "../../errors";
@@ -33,6 +33,11 @@ export async function collectionClearEmbeddings(
     throw new CliError("VALIDATION", `Collection not found: ${name}`);
   }
 
+  const ensureResult = await ensureDirectories();
+  if (!ensureResult.ok) {
+    throw new CliError("RUNTIME", ensureResult.error.message);
+  }
+
   const store = new SqliteAdapter();
   const openResult = await store.open(getIndexDbPath(), config.ftsTokenizer);
   if (!openResult.ok) {

package/src/cli/commands/publish.ts

@@ -5,7 +5,6 @@
  */
 
 import { mkdir, writeFile } from "node:fs/promises";
-import { homedir } from "node:os";
 import { dirname } from "node:path";
 import { join } from "node:path";
 
@@ -15,6 +14,7 @@ import type {
 } from "../../publish/artifact";
 import type { SanitizeWarning } from "../../publish/obsidian-sanitize";
 
+import { resolveDownloadsDir } from "../../core/user-dirs";
 import { derivePublishArtifactFilename, slugify } from "../../publish/artifact";
 import { exportPublishArtifact } from "../../publish/export-service";
 import { formatSanitizeWarnings } from "../../publish/obsidian-sanitize";
@@ -50,16 +50,16 @@ function formatExportDateStamp(isoTimestamp: string): string {
   return isoTimestamp.slice(0, 10).replaceAll("-", "");
 }
 
-export function buildDefaultPublishExportPath(
+export async function buildDefaultPublishExportPath(
   artifact: PublishArtifact
-): string {
+): Promise<string> {
   const fileName = derivePublishArtifactFilename(artifact).replace(
     /\.json$/u,
     ""
   );
+  const downloadsDir = await resolveDownloadsDir();
   return join(
-    homedir(),
-    "Downloads",
+    downloadsDir,
     `${fileName}-${formatExportDateStamp(artifact.exportedAt)}.json`
   );
 }
@@ -114,7 +114,7 @@ export async function publishExport(
     }
 
     const outPath =
-      options.out?.trim() || buildDefaultPublishExportPath(artifact);
+      options.out?.trim() || (await buildDefaultPublishExportPath(artifact));
 
     await mkdir(dirname(outPath), { recursive: true });
     await writeFile(outPath, JSON.stringify(artifact, null, 2));

package/src/core/user-dirs.ts

@@ -0,0 +1,86 @@
+// node:os homedir: no Bun equivalent.
+import { homedir } from "node:os";
+// node:path join/normalize: no Bun path utilities.
+import { join, normalize } from "node:path";
+
+interface ResolveDownloadsDirDeps {
+  env?: Record<string, string | undefined>;
+  homeDir?: string;
+  platform?: NodeJS.Platform;
+  readTextFile?: (path: string) => Promise<string | null>;
+}
+
+const XDG_DOWNLOAD_DIR_REGEX = /^XDG_DOWNLOAD_DIR=(?:"([^"]+)"|([^\r\n#]+))$/mu;
+
+function expandEnvPath(
+  value: string,
+  env: Record<string, string | undefined>,
+  homeDir: string
+): string {
+  return normalize(
+    value
+      .trim()
+      .replaceAll(/\$HOME|\$\{HOME\}/gu, homeDir)
+      .replace(/^~(?=$|[\\/])/u, homeDir)
+      .replaceAll(
+        /%([^%]+)%/gu,
+        (_match, key: string) => env[key] ?? env[key.toUpperCase()] ?? ""
+      )
+  );
+}
+
+function parseXdgDownloadsDir(
+  fileContents: string,
+  env: Record<string, string | undefined>,
+  homeDir: string
+): string | null {
+  const match = fileContents.match(XDG_DOWNLOAD_DIR_REGEX);
+  const rawValue = match?.[1] ?? match?.[2];
+  if (!rawValue) {
+    return null;
+  }
+  return expandEnvPath(rawValue, env, homeDir);
+}
+
+async function defaultReadTextFile(path: string): Promise<string | null> {
+  const file = Bun.file(path);
+  if (!(await file.exists())) {
+    return null;
+  }
+  return file.text();
+}
+
+export async function resolveDownloadsDir(
+  deps: ResolveDownloadsDirDeps = {}
+): Promise<string> {
+  const env = deps.env ?? process.env;
+  const platform = deps.platform ?? process.platform;
+  const homeDir = deps.homeDir ?? homedir();
+  const readTextFile = deps.readTextFile ?? defaultReadTextFile;
+
+  if (platform === "linux") {
+    const explicit = env.XDG_DOWNLOAD_DIR?.trim();
+    if (explicit) {
+      return expandEnvPath(explicit, env, homeDir);
+    }
+
+    const xdgConfigHome =
+      env.XDG_CONFIG_HOME?.trim() || join(homeDir, ".config");
+    const userDirs = await readTextFile(join(xdgConfigHome, "user-dirs.dirs"));
+    if (userDirs) {
+      const parsed = parseXdgDownloadsDir(userDirs, env, homeDir);
+      if (parsed) {
+        return parsed;
+      }
+    }
+  }
+
+  if (platform === "win32") {
+    const userProfile = env.USERPROFILE?.trim();
+    if (userProfile) {
+      return join(userProfile, "Downloads");
+    }
+  }
+
+  return join(homeDir, "Downloads");
+}