@driftless-sh/cli 0.1.26 → 0.1.29

package/README.md

@@ -15,7 +15,7 @@ driftless login --key <api-key>       # Generate one at driftless.icu → Settin
 driftless init                         # Scan repo, bootstrap context, suggest rules
 driftless session start                # See relevant context before editing
 driftless scan --diff                  # Check changes against rules before pushing
-driftless session finish               # Scan + context report + stale detection
+driftless session end                  # Scan + context report + stale detection
 driftless install-skill                # Write AGENTS.md for Claude Code / Cursor
 ```
 
@@ -70,12 +70,12 @@ The agent loop — start with context, finish with a report.
 ```bash
 driftless session start                # Show context for local changes
 driftless session start --files "src/auth/**"  # Show context for specific files
-driftless session finish               # Scan changes, check violations, suggest updates
+driftless session end                  # Scan changes, check violations, suggest updates
 ```
 
 **Before editing:** `session start` tells you which context topics, docs, and gotchas apply to the files you're about to touch.
 
-**Before pushing:** `session finish` runs `scan --diff`, reports violations, and flags stale context that needs updating.
+**Before pushing:** `session end` runs `scan --diff`, reports violations, and flags stale context that needs updating.
 
 ---
 
@@ -134,8 +134,8 @@ driftless context get auth-boundaries --json
 | `context update <slug>` | Update topic fields |
 | `context delete <slug>` | Delete a topic |
 | `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 sync <slug>` | Sync a doc to a topic |
+| `context load --files` | Match topics for given file paths |
 | `context export` | Export all watchers to `.driftless/watchers/*.yaml` |
 | `context import` | Import watchers from `.driftless/watchers/*.yaml` |
 
@@ -144,9 +144,9 @@ driftless context get auth-boundaries --json
 All write commands support `--dry-run` to preview changes without writing to Cloud:
 
 ```bash
-driftless context push --files "src/auth/**" --dry-run
+driftless context load --files "src/auth/**" --dry-run
 driftless context update auth --what "..." --dry-run
-driftless context anchor auth --doc docs/auth.md --dry-run
+driftless context sync auth --doc docs/auth.md --dry-run
 ```
 
 #### Creating topics
@@ -204,8 +204,8 @@ driftless context update sdk --what "SDK v2 with streaming"
 # Append a gotcha
 driftless context update sdk --gotchas "Reset token on org switch"
 
-# Anchor a doc
-driftless context anchor auth --doc docs/auth.md --files "src/auth/**"
+# Sync a doc
+driftless context sync auth --doc docs/auth.md --files "src/auth/**"
 
 # Export all watchers to .driftless/watchers/*.yaml
 driftless context export
@@ -287,7 +287,7 @@ This creates `AGENTS.md` with instructions for Claude Code to use Driftless befo
 driftless session start --files "src/auth/**"
 
 # Before finishing work
-driftless session finish
+driftless session end
 
 # After discovering new context
 driftless context add "name" --what "..." --how "..." --where "..."

package/dist/index.js

@@ -214442,7 +214442,7 @@ var AGENTS_BLOCK = `
 ## Driftless \u2014 Context Integrity
 
 Before touching files:
-  driftless context push --files "<files you're about to edit>"
+  driftless context load --files "<files you're about to edit>"
 
 Before pushing:
   driftless scan --diff
@@ -214539,7 +214539,7 @@ async function installSkillCommand() {
 // src/commands/init.ts
 function getVersion() {
   try {
-    return "0.1.26";
+    return "0.1.29";
   } catch {
     return "0.0.0";
   }
@@ -214984,27 +214984,7 @@ async function initCommand(args) {
   }
   step("creating context", `${watchersCreated} watchers \u2713`);
   const existingDocs = detectExistingDocs(cwd);
-  let docsAnchored = 0;
-  for (const doc of existingDocs) {
-    try {
-      const fullPath = (0, import_node_path4.resolve)(cwd, doc.path);
-      const fileContent = (0, import_node_fs4.readFileSync)(fullPath, "utf-8");
-      await api.post(`/workspaces/${workspaceSlug}/watchers`, {
-        name: doc.name,
-        what: doc.what,
-        how: "Anchored documentation",
-        pattern: doc.pattern,
-        decisions: fileContent.slice(0, 2e3),
-        file_content: fileContent,
-        ownership: "@team",
-        where_repos: [repo.id],
-        created_by: "driftless-init"
-      });
-      docsAnchored++;
-    } catch {
-    }
-  }
-  step("anchoring docs", `${docsAnchored} docs \u2713`);
+  step("detecting docs", `${existingDocs.length} found (not auto-synced)`);
   let skillLine = "skipped";
   try {
     const skillResult = await runInstallSkill(cwd);
@@ -215018,7 +214998,7 @@ async function initCommand(args) {
   console.log("\u2713 repo context bootstrapped");
   console.log(`  \u251C\u2500 watchers      ${watchersCreated}`);
   console.log(`  \u251C\u2500 rules          ${rulesCreated}`);
-  console.log(`  \u251C\u2500 docs          ${docsAnchored}`);
+  console.log(`  \u251C\u2500 docs found    ${existingDocs.length} (ask your agent to sync them)`);
   console.log(`  \u251C\u2500 components   ${components.length}`);
   console.log(`  \u2514\u2500 relations    ${relationCount}`);
   console.log("");
@@ -215602,11 +215582,11 @@ async function contextCommand(args) {
     }
     return;
   }
-  if (subCommand === "anchor") {
+  if (subCommand === "sync") {
     const slug = positional[1];
     if (!slug) {
-      console.error('Usage: driftless context anchor <topic> --doc <path> --files "<glob>"');
-      console.error('       driftless context anchor <topic> --note "..." --files "<glob>"');
+      console.error('Usage: driftless context sync <topic> --doc <path> --files "<glob>"');
+      console.error('       driftless context sync <topic> --note "..." --files "<glob>"');
       process.exit(1);
     }
     const docFlag = flags["doc"];
@@ -215632,7 +215612,7 @@ async function contextCommand(args) {
     if (noteFlag) updates.decisions = noteFlag;
     if (filesFlag) updates.where_files = filesFlag.split(",").map((f) => f.trim()).filter(Boolean);
     if (patternFlag) updates.pattern = patternFlag;
-    updates._event_detail = `ANCHOR_ADDED: doc=${!!fileContent}, note=${!!noteFlag}, files=${filesFlag || "none"}`;
+    updates._event_detail = `SYNC_ADDED: doc=${!!fileContent}, note=${!!noteFlag}, files=${filesFlag || "none"}`;
     if (flags["dry-run"]) {
       console.log(`Would anchor topic '${slug}':`);
       if (docFlag) console.log(`  doc: ${docFlag} (${fileContent ? fileContent.length : 0} chars)`);
@@ -215643,7 +215623,7 @@ async function contextCommand(args) {
         console.log("\n(Dry run \u2014 no changes written to Driftless Cloud)");
       }
       if (isJSON) {
-        emitJSON2({ dry_run: true, action: "anchor", topic: slug, doc: docFlag, note: noteFlag, files: filesFlag, pattern: patternFlag });
+        emitJSON2({ dry_run: true, action: "sync", topic: slug, doc: docFlag, note: noteFlag, files: filesFlag, pattern: patternFlag });
       }
       process.exit(0);
     }
@@ -215659,22 +215639,22 @@ async function contextCommand(args) {
         }));
         emitJSON2(sanitized);
       } else {
-        console.log(`Topic '${slug}' anchored.`);
+        console.log(`Topic '${slug}' synced.`);
         if (docFlag) console.log(`  doc: ${docFlag} (${fileContent ? fileContent.length : 0} chars)`);
         if (noteFlag) console.log(`  note: ${noteFlag}`);
         if (filesFlag) console.log(`  files: ${filesFlag}`);
         if (patternFlag) console.log(`  pattern: ${patternFlag}`);
       }
     } catch (e) {
-      console.error(`Anchor failed: ${formatError(e)}`);
+      console.error(`Sync failed: ${formatError(e)}`);
       process.exit(1);
     }
     return;
   }
-  if (subCommand === "push") {
+  if (subCommand === "load") {
     const filesFlag = flags["files"];
     if (!filesFlag) {
-      console.error('Usage: driftless context push --files "path1,path2,path3"');
+      console.error('Usage: driftless context load --files "path1,path2,path3"');
       process.exit(1);
     }
     const files = filesFlag.split(",").map((f) => f.trim()).filter(Boolean);
@@ -215745,7 +215725,7 @@ Warnings:`);
         }
       }
     } catch (e) {
-      console.error(`Push failed: ${formatError(e)}`);
+      console.error(`Load failed: ${formatError(e)}`);
       process.exit(1);
     }
     return;
@@ -215901,7 +215881,7 @@ Done: ${created} created, ${updated} updated.`);
     }
     return;
   }
-  console.log(`Usage: driftless context <list|get|add|update|delete|search|push> [args]
+  console.log(`Usage: driftless context <list|get|add|update|delete|search|load> [args]
 
 Run 'driftless help context' for full reference.`);
 }
@@ -216062,7 +216042,7 @@ Rules that will be evaluated:`);
         }
         console.log("\nBefore finishing:");
         console.log("  driftless scan --diff");
-        console.log("  driftless session finish");
+        console.log("  driftless session end");
       }
     } catch (e) {
       console.error(`Session start failed: ${formatError(e)}`);
@@ -216070,7 +216050,7 @@ Rules that will be evaluated:`);
     }
     return;
   }
-  if (subCommand === "finish") {
+  if (subCommand === "end") {
     const files = getChangedFilesList();
     if (files.length === 0 && !isJSON) {
       console.log("No local changes detected. Session clean.");
@@ -216120,7 +216100,7 @@ Rules that will be evaluated:`);
           context_matched: contextResults.map((r) => r.context.topic)
         });
       } else {
-        console.log(`Session finish \u2014 ${files.length} file(s) changed:
+        console.log(`Session end \u2014 ${files.length} file(s) changed:
 `);
         for (const f of files) {
           console.log(`  \u270E ${f}`);
@@ -216161,24 +216141,24 @@ Context touched:`);
         process.exit(1);
       }
     } catch (e) {
-      console.error(`Session finish failed: ${formatError(e)}`);
+      console.error(`Session end failed: ${formatError(e)}`);
       process.exit(1);
     }
     return;
   }
-  console.log(`Usage: driftless session <start|finish> [args]
+  console.log(`Usage: driftless session <start|end> [args]
 
-start  \u2014 Show relevant context before editing
+start \u2014 Show relevant context before editing
   --files "path1,path2"  Files to check (default: local changes)
   --json                 Output as JSON
 
-finish \u2014 Scan changes, check violations, suggest context updates
+end   \u2014 Scan changes, check violations, suggest context updates
   --json                 Output as JSON
 
 Examples:
   driftless session start --files "src/auth/**"
   driftless session start          # uses local changes
-  driftless session finish         # scan + context report`);
+  driftless session end            # scan + context report`);
 }
 
 // src/commands/login.ts
@@ -216398,7 +216378,7 @@ function pad2(s, n) {
 }
 
 // src/index.ts
-var VERSION = "0.1.26";
+var VERSION = "0.1.29";
 var HELP_TEXT = `Driftless CLI v${VERSION} \u2014 Living repo context for humans and coding agents
 
 Install:  npm install -g @driftless-sh/cli
@@ -216407,7 +216387,7 @@ API:      https://api.driftless.icu/api/v1
 
 Agent loop:
   driftless session start             Show context before editing
-  driftless session finish            Scan changes + context report
+  driftless session end               Scan changes + context report
   driftless context list              List all context topics
   driftless context get <topic>       Live view of one topic before editing
   driftless context get --diff        What context matters for my local changes?
@@ -216424,7 +216404,7 @@ Commands:
   init              Smart init: scan \u2192 detect patterns \u2192 create topics + rules + anchor docs
   scan              Evaluate staged + uncommitted changes against rules
   scan --diff       Evaluate uncommitted changes only
-  session           Agent session: start (context) \u2192 finish (scan + report)
+  session           Agent session: start (context) \u2192 end (scan + report)
   context           Live repo context (topics, search, anchors)
   install-skill     Install AGENTS.md into current repo
   doctor            Check environment health (auth, API, git, workspace, repo, baseline)
@@ -216437,18 +216417,18 @@ Context subcommands:
   get --diff                    Match topics for local uncommitted changes
   search "<query>"              Full-text search across topics
   add "<name>" --what "..."     Create a new topic
-  anchor <topic> --doc <path>   Anchor a doc to a topic
-  anchor <topic> --note "..."   Add a note to a topic
+  sync <topic> --doc <path>     Sync a doc to a topic
+  sync <topic> --note "..."     Add a note to a topic
   update <topic> --what "..."   Update topic fields
   update <topic> --gotcha "..." Append a gotcha
   update <topic> --invariant ".." Append an invariant
   update <topic> --check "..."  Append a required check
   delete <topic>                Delete a topic
-  push --files "p1,p2"          Legacy: match topics by file paths
+  load --files "p1,p2"          Match topics by file paths
 
 Session subcommands:
   start [--files "p1,p2"]       Show relevant context before editing
-  finish                        Scan changes, check violations, suggest updates
+  end                           Scan changes, check violations, suggest updates
 
 Flags:
   --json      Output as JSON (default is human-readable)
@@ -216468,7 +216448,7 @@ Output format:
 
 Examples:
   driftless session start --files "src/auth/**"
-  driftless session finish
+  driftless session end
 
   driftless context add "b2b-guard" \\
     --what "Guard que protege endpoints B2B" \\
@@ -216478,7 +216458,7 @@ Examples:
   driftless context get sdk
   driftless context search "auth"
   driftless scan --diff
-  driftless context push --files "src/auth/auth.controller.ts" --dry-run
+  driftless context load --files "src/auth/auth.controller.ts" --dry-run
 `;
 function showCommandHelp(cmd) {
   const help = {
@@ -216536,11 +216516,11 @@ Subcommands:
   get --diff                    Match topics for local uncommitted changes
   search "<query>"              Full-text search across topics
   add "<name>" [opts]           Create a new topic
-  anchor <topic> --doc <path>   Anchor a doc to a topic
-  anchor <topic> --note "..."   Add a note to a topic
+  sync <topic> --doc <path>     Sync a doc to a topic
+  sync <topic> --note "..."     Add a note to a topic
   update <topic> [opts]         Update topic fields
   delete <topic>                Delete a topic
-  push --files "p1,p2,..."      Legacy: match topics for given file paths
+  load --files "p1,p2,..."      Match topics for given file paths
 
 List filters:
   --stale                       Only stale topics
@@ -216561,8 +216541,8 @@ Examples:
   driftless context search "auth"
   driftless context add "sdk" --pattern "src/sdk/**" --what "Public SDK"
   driftless context update sdk --gotchas "Reset token on org switch"
-  driftless context anchor auth --doc docs/auth.md --files "src/auth/**"
-  driftless context push --files "src/auth/guard.ts" --dry-run
+  driftless context sync auth --doc docs/auth.md --files "src/auth/**"
+  driftless context load --files "src/auth/guard.ts" --dry-run
 `,
     "install-skill": `driftless install-skill