@driftless-sh/cli 0.1.23 → 0.1.25

package/README.md

@@ -136,6 +136,8 @@ driftless context get auth-boundaries --json
 | `context search <query>` | Full-text search across topics |
 | `context anchor <slug>` | Anchor a doc to a topic |
 | `context push --files` | Match topics for given file paths |
+| `context export` | Export all watchers to `.driftless/watchers/*.yaml` |
+| `context import` | Import watchers from `.driftless/watchers/*.yaml` |
 
 #### Dry run
 
@@ -205,6 +207,12 @@ driftless context update sdk --gotchas "Reset token on org switch"
 # Anchor a doc
 driftless context anchor auth --doc docs/auth.md --files "src/auth/**"
 
+# Export all watchers to .driftless/watchers/*.yaml
+driftless context export
+
+# Import watchers from .driftless/watchers/*.yaml
+driftless context import
+
 # Delete a topic
 driftless context delete old-feature
 ```
@@ -308,7 +316,9 @@ driftless scan
 driftless context
   ├── CRUD topics via REST API
   ├── Full-text search (Postgres tsvector)
-  └── Pattern resolution (glob → resolved files)
+  ├── Pattern resolution (glob → resolved files)
+  ├── export → .driftless/watchers/*.yaml (context as code)
+  └── import ← .driftless/watchers/*.yaml (bootstrap from repo)
 ```
 
 ## License

package/dist/index.js

@@ -445,7 +445,7 @@ var require_util = __commonJS({
       return path;
     }
     exports2.normalize = normalize;
-    function join2(aRoot, aPath) {
+    function join3(aRoot, aPath) {
       if (aRoot === "") {
         aRoot = ".";
       }
@@ -477,7 +477,7 @@ var require_util = __commonJS({
       }
       return joined;
     }
-    exports2.join = join2;
+    exports2.join = join3;
     exports2.isAbsolute = function(aPath) {
       return aPath.charAt(0) === "/" || urlRegexp.test(aPath);
     };
@@ -650,7 +650,7 @@ var require_util = __commonJS({
             parsed.path = parsed.path.substring(0, index + 1);
           }
         }
-        sourceURL = join2(urlGenerate(parsed), sourceURL);
+        sourceURL = join3(urlGenerate(parsed), sourceURL);
       }
       return normalize(sourceURL);
     }
@@ -215072,6 +215072,7 @@ ${items.length} topic${items.length === 1 ? "" : "s"}.`);
 function renderContextHuman(ctx) {
   console.log(`\u258C ${ctx.topic}`);
   console.log(`  ${ctx.summary}`);
+  if (ctx.version !== void 0) console.log(`  version:    ${ctx.version}`);
   if (ctx.stale.is_stale) {
     console.log(`
   \u26A0 STALE: ${ctx.stale.reason || "Context may be outdated"}`);
@@ -215501,6 +215502,7 @@ async function contextCommand(args) {
     }
     const updates = { last_updated: /* @__PURE__ */ new Date() };
     if (fileContent) updates.file_content = fileContent;
+    if (docFlag) updates.anchored_doc_path = docFlag;
     if (noteFlag) updates.decisions = noteFlag;
     if (filesFlag) updates.where_files = filesFlag.split(",").map((f) => f.trim()).filter(Boolean);
     if (patternFlag) updates.pattern = patternFlag;
@@ -215615,6 +215617,157 @@ Context delivered for ${files.length} file${files.length === 1 ? "" : "s"}.`);
     }
     return;
   }
+  if (subCommand === "export") {
+    const dir = flags["dir"] ?? ".driftless/watchers";
+    const absDir = (0, import_node_path4.resolve)(process.cwd(), dir);
+    try {
+      const summaries = await api.get(`/workspaces/${workspaceSlug}/watchers`);
+      (0, import_node_fs4.mkdirSync)(absDir, { recursive: true });
+      for (const summary of summaries) {
+        const slug = summary.topic;
+        let ctx;
+        try {
+          ctx = await api.get(`/workspaces/${workspaceSlug}/watchers/${slug}`);
+        } catch {
+          console.error(`  skipped ${slug} (fetch failed)`);
+          continue;
+        }
+        const lines = [];
+        const needsQuotes = (s) => /[:#\[\]{}&*!|>'"%@`,]/.test(s) || s.trim() !== s;
+        const safeStr = (s) => needsQuotes(s) ? `"${s.replace(/"/g, '\\"')}"` : s;
+        lines.push(`slug: ${safeStr(slug)}`);
+        if (ctx.version !== void 0) lines.push(`version: ${ctx.version}`);
+        if (ctx.description.what) lines.push(`what: ${safeStr(ctx.description.what)}`);
+        if (ctx.description.how) lines.push(`how: ${safeStr(ctx.description.how)}`);
+        if (ctx.anchors.files.length > 0) {
+          lines.push(`where_files:`);
+          for (const f of ctx.anchors.files) lines.push(`  - ${safeStr(f)}`);
+        }
+        if (ctx.anchors.docs.length > 0 && ctx.anchors.docs[0].path) {
+          lines.push(`anchored_doc: ${safeStr(ctx.anchors.docs[0].path)}`);
+        }
+        if (ctx.description.decisions) lines.push(`decisions: ${safeStr(ctx.description.decisions)}`);
+        if (ctx.description.gotchas.length > 0) {
+          lines.push(`gotchas: ${safeStr(ctx.description.gotchas.join(". "))}`);
+        }
+        if (ctx.description.ownership) lines.push(`ownership: ${safeStr(ctx.description.ownership)}`);
+        const yamlContent = lines.join("\n") + "\n";
+        (0, import_node_fs4.writeFileSync)((0, import_node_path4.join)(absDir, `${slug}.yaml`), yamlContent, "utf-8");
+      }
+      if (!isJSON) {
+        console.log(`Exported ${summaries.length} watcher${summaries.length === 1 ? "" : "s"} \u2192 ${dir}/`);
+      } else {
+        emitJSON2({ exported: summaries.length, dir });
+      }
+    } catch (e) {
+      console.error(`Export failed: ${formatError(e)}`);
+      process.exit(1);
+    }
+    return;
+  }
+  if (subCommand === "import") {
+    const dir = flags["dir"] ?? ".driftless/watchers";
+    const absDir = (0, import_node_path4.resolve)(process.cwd(), dir);
+    if (!(0, import_node_fs4.existsSync)(absDir)) {
+      console.error(`Directory not found: ${dir}`);
+      process.exit(1);
+    }
+    let files;
+    try {
+      files = (0, import_node_fs4.readdirSync)(absDir).filter((f) => f.endsWith(".yaml"));
+    } catch (e) {
+      console.error(`Failed to read directory: ${formatError(e)}`);
+      process.exit(1);
+    }
+    if (files.length === 0) {
+      console.log(`No .yaml files found in ${dir}/`);
+      return;
+    }
+    let created = 0;
+    let updated = 0;
+    for (const file of files) {
+      const filePath = (0, import_node_path4.join)(absDir, file);
+      let raw;
+      try {
+        raw = (0, import_node_fs4.readFileSync)(filePath, "utf-8");
+      } catch {
+        console.error(`  skipped ${file} (read error)`);
+        continue;
+      }
+      const parsed = {};
+      let lastArrayKey = null;
+      for (const line of raw.split("\n")) {
+        if (!line.trim() || line.trim().startsWith("#")) continue;
+        if (/^\s{2,}-\s/.test(line)) {
+          if (lastArrayKey) {
+            const item = line.replace(/^\s{2,}-\s*/, "").trim();
+            const existing = parsed[lastArrayKey];
+            if (Array.isArray(existing)) {
+              existing.push(item);
+            } else {
+              parsed[lastArrayKey] = [item];
+            }
+          }
+          continue;
+        }
+        const colonIdx = line.indexOf(":");
+        if (colonIdx === -1) continue;
+        const key = line.slice(0, colonIdx).trim();
+        let value = line.slice(colonIdx + 1).trim();
+        if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+          value = value.slice(1, -1).replace(/\\"/g, '"');
+        }
+        if (value === "") {
+          lastArrayKey = key;
+          parsed[key] = [];
+        } else {
+          lastArrayKey = null;
+          parsed[key] = value;
+        }
+      }
+      const slug = parsed["slug"];
+      if (!slug) {
+        console.error(`  skipped ${file} (no slug field)`);
+        continue;
+      }
+      const payload = {};
+      if (parsed["what"]) payload.what = parsed["what"];
+      if (parsed["how"]) payload.how = parsed["how"];
+      if (parsed["where_files"]) payload.where_files = parsed["where_files"];
+      if (parsed["anchored_doc"]) payload.anchored_doc_path = parsed["anchored_doc"];
+      if (parsed["decisions"]) payload.decisions = parsed["decisions"];
+      if (parsed["gotchas"]) payload.gotchas = parsed["gotchas"];
+      if (parsed["ownership"]) payload.ownership = parsed["ownership"];
+      let exists = false;
+      try {
+        await api.get(`/workspaces/${workspaceSlug}/watchers/${slug}`);
+        exists = true;
+      } catch {
+        exists = false;
+      }
+      try {
+        if (exists) {
+          await api.patch(`/workspaces/${workspaceSlug}/watchers/${slug}`, payload);
+          console.log(`  \u2713 ${slug} (updated)`);
+          updated++;
+        } else {
+          const name = slug.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+          await api.post(`/workspaces/${workspaceSlug}/watchers`, { name, ...payload });
+          console.log(`  \u2713 ${slug} (created)`);
+          created++;
+        }
+      } catch (e) {
+        console.error(`  \u2717 ${slug}: ${formatError(e)}`);
+      }
+    }
+    if (!isJSON) {
+      console.log(`
+Done: ${created} created, ${updated} updated.`);
+    } else {
+      emitJSON2({ created, updated });
+    }
+    return;
+  }
   console.log(`Usage: driftless context <list|get|add|update|delete|search|push> [args]
 
 Run 'driftless help context' for full reference.`);
@@ -216048,7 +216201,8 @@ var CONFIG_DIR = (0, import_node_path7.resolve)((0, import_node_os2.homedir)(),
 var CONFIG_PATH2 = (0, import_node_path7.resolve)(CONFIG_DIR, "config.json");
 function openBrowser(url) {
   const cmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
-  (0, import_node_child_process2.exec)(`${cmd} ${url}`);
+  const child = (0, import_node_child_process2.spawn)(cmd, [url], { stdio: "ignore", detached: true });
+  child.unref();
 }
 async function loginCommand(args) {
   const keyIndex = args.indexOf("--key");
@@ -216254,7 +216408,7 @@ function pad2(s, n) {
 }
 
 // src/index.ts
-var VERSION = "0.1.23";
+var VERSION = "0.1.25";
 var HELP_TEXT = `Driftless CLI v${VERSION} \u2014 Living repo context for humans and coding agents
 
 Install:  npm install -g @driftless-sh/cli