@driftless-sh/cli 0.1.22 → 0.1.24

package/dist/index.js

@@ -6,9 +6,16 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
 var __commonJS = (cb, mod) => function __require() {
   return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
 };
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
 var __copyProps = (to, from, except, desc) => {
   if (from && typeof from === "object" || typeof from === "function") {
     for (let key of __getOwnPropNames(from))
@@ -26,6 +33,101 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
+// src/git.ts
+var git_exports = {};
+__export(git_exports, {
+  getAuthorName: () => getAuthorName,
+  getChangedFilesFromDiff: () => getChangedFilesFromDiff,
+  getChangedFilesList: () => getChangedFilesList,
+  getGitRemote: () => getGitRemote,
+  getLastCommitHash: () => getLastCommitHash,
+  getStagedDiff: () => getStagedDiff,
+  getUncommittedDiff: () => getUncommittedDiff,
+  isGitRepo: () => isGitRepo
+});
+function getGitRemote() {
+  try {
+    const url = (0, import_node_child_process.execSync)("git config --get remote.origin.url", {
+      encoding: "utf8",
+      cwd: process.cwd()
+    }).trim();
+    const match = url.match(/[:/]([^/]+)\/([^/]+?)(?:\.git)?$/);
+    if (match) {
+      return { org: match[1], repo: match[2] };
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+function isGitRepo() {
+  return (0, import_node_fs2.existsSync)((0, import_node_path2.resolve)(process.cwd(), ".git"));
+}
+function getUncommittedDiff() {
+  try {
+    return (0, import_node_child_process.execSync)("git diff", { encoding: "utf8", cwd: process.cwd() }).trim();
+  } catch {
+    return "";
+  }
+}
+function getStagedDiff() {
+  try {
+    return (0, import_node_child_process.execSync)("git diff --staged", { encoding: "utf8", cwd: process.cwd() }).trim();
+  } catch {
+    return "";
+  }
+}
+function getLastCommitHash() {
+  try {
+    return (0, import_node_child_process.execSync)("git rev-parse HEAD", { encoding: "utf8", cwd: process.cwd() }).trim();
+  } catch {
+    return "unknown";
+  }
+}
+function getChangedFilesFromDiff(diff) {
+  const text = diff ?? getUncommittedDiff();
+  if (!text) return [];
+  const files = /* @__PURE__ */ new Set();
+  for (const line of text.split("\n")) {
+    if (line.startsWith("+++ b/")) {
+      files.add(line.slice(6));
+    } else if (line.startsWith("--- a/")) {
+    } else if (line.startsWith("diff --git ")) {
+      const match = line.match(/diff --git a\/(.+?) b\/(.+)$/);
+      if (match) files.add(match[2]);
+    }
+  }
+  return [...files];
+}
+function getChangedFilesList() {
+  try {
+    const unstaged = (0, import_node_child_process.execSync)("git diff --name-only HEAD", { encoding: "utf8", cwd: process.cwd() }).trim();
+    const staged = (0, import_node_child_process.execSync)("git diff --staged --name-only", { encoding: "utf8", cwd: process.cwd() }).trim();
+    const files = /* @__PURE__ */ new Set();
+    if (unstaged) unstaged.split("\n").forEach((f) => files.add(f));
+    if (staged) staged.split("\n").forEach((f) => files.add(f));
+    return [...files].filter(Boolean);
+  } catch {
+    return [];
+  }
+}
+function getAuthorName() {
+  try {
+    return (0, import_node_child_process.execSync)("git config user.name", { encoding: "utf8", cwd: process.cwd() }).trim();
+  } catch {
+    return "unknown";
+  }
+}
+var import_node_child_process, import_node_fs2, import_node_path2;
+var init_git = __esm({
+  "src/git.ts"() {
+    "use strict";
+    import_node_child_process = require("node:child_process");
+    import_node_fs2 = require("node:fs");
+    import_node_path2 = require("node:path");
+  }
+});
+
 // ../../libs/scanner/dist/identity/identity.js
 var require_identity = __commonJS({
   "../../libs/scanner/dist/identity/identity.js"(exports2) {
@@ -2436,7 +2538,7 @@ var require_typescript = __commonJS({
       var __getOwnPropDesc2 = Object.getOwnPropertyDescriptor;
       var __getOwnPropNames2 = Object.getOwnPropertyNames;
       var __hasOwnProp2 = Object.prototype.hasOwnProperty;
-      var __export = (target, all) => {
+      var __export2 = (target, all) => {
         for (var name in all)
           __defProp2(target, name, { get: all[name], enumerable: true });
       };
@@ -2450,7 +2552,7 @@ var require_typescript = __commonJS({
       };
       var __toCommonJS = (mod) => (__copyProps2, mod);
       var typescript_exports = {};
-      __export(typescript_exports, {
+      __export2(typescript_exports, {
         ANONYMOUS: () => ANONYMOUS,
         AccessFlags: () => AccessFlags,
         AssertionLevel: () => AssertionLevel,
@@ -7537,7 +7639,7 @@ ${lanes.join("\n")}
       }
       var timestamp = nativePerformanceTime ? () => nativePerformanceTime.now() : Date.now;
       var ts_performance_exports = {};
-      __export(ts_performance_exports, {
+      __export2(ts_performance_exports, {
         clearMarks: () => clearMarks,
         clearMeasures: () => clearMeasures,
         createTimer: () => createTimer,
@@ -55840,7 +55942,7 @@ ${lanes.join("\n")}
         }
       }
       var ts_moduleSpecifiers_exports = {};
-      __export(ts_moduleSpecifiers_exports, {
+      __export2(ts_moduleSpecifiers_exports, {
         RelativePreference: () => RelativePreference,
         countPathComponents: () => countPathComponents,
         forEachFileNameOfModule: () => forEachFileNameOfModule,
@@ -126140,7 +126242,7 @@ ${lanes.join("\n")}
           }
         }
         function createImportCallExpressionAMD(arg, containsLexicalThis) {
-          const resolve8 = factory2.createUniqueName("resolve");
+          const resolve9 = factory2.createUniqueName("resolve");
           const reject = factory2.createUniqueName("reject");
           const parameters = [
             factory2.createParameterDeclaration(
@@ -126149,7 +126251,7 @@ ${lanes.join("\n")}
               /*dotDotDotToken*/
               void 0,
               /*name*/
-              resolve8
+              resolve9
             ),
             factory2.createParameterDeclaration(
               /*modifiers*/
@@ -126166,7 +126268,7 @@ ${lanes.join("\n")}
                 factory2.createIdentifier("require"),
                 /*typeArguments*/
                 void 0,
-                [factory2.createArrayLiteralExpression([arg || factory2.createOmittedExpression()]), resolve8, reject]
+                [factory2.createArrayLiteralExpression([arg || factory2.createOmittedExpression()]), resolve9, reject]
               )
             )
           ]);
@@ -150640,7 +150742,7 @@ ${lanes.join("\n")}
         }
       }
       var ts_JsTyping_exports = {};
-      __export(ts_JsTyping_exports, {
+      __export2(ts_JsTyping_exports, {
         NameValidationResult: () => NameValidationResult,
         discoverTypings: () => discoverTypings,
         isTypingUpToDate: () => isTypingUpToDate,
@@ -157686,7 +157788,7 @@ interface Symbol {
         return options;
       }
       var ts_NavigateTo_exports = {};
-      __export(ts_NavigateTo_exports, {
+      __export2(ts_NavigateTo_exports, {
         getNavigateToItems: () => getNavigateToItems
       });
       function getNavigateToItems(sourceFiles, checker, cancellationToken, searchValue, maxResultCount, excludeDtsFiles, excludeLibFiles) {
@@ -157791,7 +157893,7 @@ interface Symbol {
         };
       }
       var ts_NavigationBar_exports = {};
-      __export(ts_NavigationBar_exports, {
+      __export2(ts_NavigationBar_exports, {
         getNavigationBarItems: () => getNavigationBarItems,
         getNavigationTree: () => getNavigationTree
       });
@@ -158579,7 +158681,7 @@ interface Symbol {
         return text.replace(/\\?(?:\r?\n|[\r\u2028\u2029])/g, "");
       }
       var ts_refactor_exports = {};
-      __export(ts_refactor_exports, {
+      __export2(ts_refactor_exports, {
         addExportsInOldFile: () => addExportsInOldFile,
         addImportsForMovedSymbols: () => addImportsForMovedSymbols,
         addNewFileToTsconfig: () => addNewFileToTsconfig,
@@ -162122,7 +162224,7 @@ ${newComment.split("\n").map((c) => ` * ${c}`).join("\n")}
         }
       }
       var ts_refactor_extractSymbol_exports = {};
-      __export(ts_refactor_extractSymbol_exports, {
+      __export2(ts_refactor_extractSymbol_exports, {
         Messages: () => Messages,
         RangeFacts: () => RangeFacts,
         getRangeToExtract: () => getRangeToExtract2,
@@ -166701,7 +166803,7 @@ ${newComment.split("\n").map((c) => ` * ${c}`).join("\n")}
         return result;
       }
       var ts_BreakpointResolver_exports = {};
-      __export(ts_BreakpointResolver_exports, {
+      __export2(ts_BreakpointResolver_exports, {
         spanInSourceFileAtLocation: () => spanInSourceFileAtLocation
       });
       function spanInSourceFileAtLocation(sourceFile, position) {
@@ -167207,7 +167309,7 @@ ${newComment.split("\n").map((c) => ` * ${c}`).join("\n")}
         }
       }
       var ts_CallHierarchy_exports = {};
-      __export(ts_CallHierarchy_exports, {
+      __export2(ts_CallHierarchy_exports, {
         createCallHierarchyItem: () => createCallHierarchyItem,
         getIncomingCalls: () => getIncomingCalls,
         getOutgoingCalls: () => getOutgoingCalls,
@@ -167656,11 +167758,11 @@ ${newComment.split("\n").map((c) => ` * ${c}`).join("\n")}
         return group(collectCallSites(program, declaration), getCallSiteGroupKey, (entries) => convertCallSiteGroupToOutgoingCall(program, entries));
       }
       var ts_classifier_exports = {};
-      __export(ts_classifier_exports, {
+      __export2(ts_classifier_exports, {
         v2020: () => ts_classifier_v2020_exports
       });
       var ts_classifier_v2020_exports = {};
-      __export(ts_classifier_v2020_exports, {
+      __export2(ts_classifier_v2020_exports, {
         TokenEncodingConsts: () => TokenEncodingConsts,
         TokenModifier: () => TokenModifier,
         TokenType: () => TokenType,
@@ -167668,7 +167770,7 @@ ${newComment.split("\n").map((c) => ` * ${c}`).join("\n")}
         getSemanticClassifications: () => getSemanticClassifications2
       });
       var ts_codefix_exports = {};
-      __export(ts_codefix_exports, {
+      __export2(ts_codefix_exports, {
         PreserveOptionalFlags: () => PreserveOptionalFlags,
         addNewNodeForMemberSymbol: () => addNewNodeForMemberSymbol,
         codeFixAll: () => codeFixAll,
@@ -179589,7 +179691,7 @@ ${newComment.split("\n").map((c) => ` * ${c}`).join("\n")}
         }
       }
       var ts_Completions_exports = {};
-      __export(ts_Completions_exports, {
+      __export2(ts_Completions_exports, {
         CompletionKind: () => CompletionKind,
         CompletionSource: () => CompletionSource,
         SortText: () => SortText,
@@ -183845,7 +183947,7 @@ ${newComment.split("\n").map((c) => ` * ${c}`).join("\n")}
         return keyword === "abstract" || keyword === "async" || keyword === "await" || keyword === "declare" || keyword === "module" || keyword === "namespace" || keyword === "type" || keyword === "satisfies" || keyword === "as";
       }
       var ts_Completions_StringCompletions_exports = {};
-      __export(ts_Completions_StringCompletions_exports, {
+      __export2(ts_Completions_StringCompletions_exports, {
         getStringLiteralCompletionDetails: () => getStringLiteralCompletionDetails,
         getStringLiteralCompletions: () => getStringLiteralCompletions
       });
@@ -184913,7 +185015,7 @@ ${newComment.split("\n").map((c) => ` * ${c}`).join("\n")}
         return isCallExpression(node.parent) && firstOrUndefined(node.parent.arguments) === node && isIdentifier(node.parent.expression) && node.parent.expression.escapedText === "require";
       }
       var ts_FindAllReferences_exports = {};
-      __export(ts_FindAllReferences_exports, {
+      __export2(ts_FindAllReferences_exports, {
         Core: () => Core,
         DefinitionKind: () => DefinitionKind,
         EntryKind: () => EntryKind,
@@ -187497,7 +187599,7 @@ ${newComment.split("\n").map((c) => ` * ${c}`).join("\n")}
         }
       })(Core || (Core = {}));
       var ts_GoToDefinition_exports = {};
-      __export(ts_GoToDefinition_exports, {
+      __export2(ts_GoToDefinition_exports, {
         createDefinitionInfo: () => createDefinitionInfo,
         getDefinitionAndBoundSpan: () => getDefinitionAndBoundSpan,
         getDefinitionAtPosition: () => getDefinitionAtPosition,
@@ -188069,7 +188171,7 @@ ${newComment.split("\n").map((c) => ` * ${c}`).join("\n")}
         }
       }
       var ts_InlayHints_exports = {};
-      __export(ts_InlayHints_exports, {
+      __export2(ts_InlayHints_exports, {
         provideInlayHints: () => provideInlayHints
       });
       var leadingParameterNameCommentRegexFactory = (name) => {
@@ -188870,7 +188972,7 @@ ${newComment.split("\n").map((c) => ` * ${c}`).join("\n")}
         }
       }
       var ts_JsDoc_exports = {};
-      __export(ts_JsDoc_exports, {
+      __export2(ts_JsDoc_exports, {
         getDocCommentTemplateAtPosition: () => getDocCommentTemplateAtPosition,
         getJSDocParameterNameCompletionDetails: () => getJSDocParameterNameCompletionDetails,
         getJSDocParameterNameCompletions: () => getJSDocParameterNameCompletions,
@@ -189307,7 +189409,7 @@ ${newComment.split("\n").map((c) => ` * ${c}`).join("\n")}
         }
       }
       var ts_MapCode_exports = {};
-      __export(ts_MapCode_exports, {
+      __export2(ts_MapCode_exports, {
         mapCode: () => mapCode
       });
       function mapCode(sourceFile, contents, focusLocations, host, formatContext, preferences) {
@@ -189511,7 +189613,7 @@ ${content}
         node.forEachChild(resetNodePositions);
       }
       var ts_OrganizeImports_exports = {};
-      __export(ts_OrganizeImports_exports, {
+      __export2(ts_OrganizeImports_exports, {
         compareImportsOrRequireStatements: () => compareImportsOrRequireStatements,
         compareModuleSpecifiers: () => compareModuleSpecifiers2,
         getImportDeclarationInsertionIndex: () => getImportDeclarationInsertionIndex,
@@ -190171,7 +190273,7 @@ ${content}
         return compareModuleSpecifiersWorker(m1, m2, comparer);
       }
       var ts_OutliningElementsCollector_exports = {};
-      __export(ts_OutliningElementsCollector_exports, {
+      __export2(ts_OutliningElementsCollector_exports, {
         collectElements: () => collectElements
       });
       function collectElements(sourceFile, cancellationToken) {
@@ -190590,7 +190692,7 @@ ${content}
         return findChildOfKind(body, 19, sourceFile);
       }
       var ts_Rename_exports = {};
-      __export(ts_Rename_exports, {
+      __export2(ts_Rename_exports, {
         getRenameInfo: () => getRenameInfo,
         nodeIsEligibleForRename: () => nodeIsEligibleForRename
       });
@@ -190746,7 +190848,7 @@ ${content}
         }
       }
       var ts_SignatureHelp_exports = {};
-      __export(ts_SignatureHelp_exports, {
+      __export2(ts_SignatureHelp_exports, {
         getArgumentInfoForCompletions: () => getArgumentInfoForCompletions,
         getSignatureHelpItems: () => getSignatureHelpItems
       });
@@ -191292,7 +191394,7 @@ ${content}
         return { name: typeParameter.symbol.name, documentation: typeParameter.symbol.getDocumentationComment(checker), displayParts, isOptional: false, isRest: false };
       }
       var ts_SmartSelectionRange_exports = {};
-      __export(ts_SmartSelectionRange_exports, {
+      __export2(ts_SmartSelectionRange_exports, {
         getSmartSelectionRange: () => getSmartSelectionRange
       });
       function getSmartSelectionRange(pos, sourceFile) {
@@ -191523,7 +191625,7 @@ ${content}
         }
       }
       var ts_SymbolDisplay_exports = {};
-      __export(ts_SymbolDisplay_exports, {
+      __export2(ts_SymbolDisplay_exports, {
         getSymbolDisplayPartsDocumentationAndSymbolKind: () => getSymbolDisplayPartsDocumentationAndSymbolKind,
         getSymbolKind: () => getSymbolKind,
         getSymbolModifiers: () => getSymbolModifiers
@@ -192491,7 +192593,7 @@ ${content}
         });
       }
       var ts_textChanges_exports = {};
-      __export(ts_textChanges_exports, {
+      __export2(ts_textChanges_exports, {
         ChangeTracker: () => ChangeTracker,
         LeadingTriviaOption: () => LeadingTriviaOption,
         TrailingTriviaOption: () => TrailingTriviaOption,
@@ -193908,7 +194010,7 @@ ${options.prefix}` : "\n" : options.prefix
         });
       }
       var ts_formatting_exports = {};
-      __export(ts_formatting_exports, {
+      __export2(ts_formatting_exports, {
         FormattingContext: () => FormattingContext,
         FormattingRequestKind: () => FormattingRequestKind,
         RuleAction: () => RuleAction,
@@ -197808,7 +197910,7 @@ ${options.prefix}` : "\n" : options.prefix
         }
       })(SmartIndenter || (SmartIndenter = {}));
       var ts_preparePasteEdits_exports = {};
-      __export(ts_preparePasteEdits_exports, {
+      __export2(ts_preparePasteEdits_exports, {
         preparePasteEdits: () => preparePasteEdits
       });
       function preparePasteEdits(sourceFile, copiedFromRange, checker) {
@@ -197846,7 +197948,7 @@ ${options.prefix}` : "\n" : options.prefix
         return shouldProvidePasteEdits;
       }
       var ts_PasteEdits_exports = {};
-      __export(ts_PasteEdits_exports, {
+      __export2(ts_PasteEdits_exports, {
         pasteEditsProvider: () => pasteEditsProvider
       });
       var fixId55 = "providePostPasteEdits";
@@ -197953,7 +198055,7 @@ ${options.prefix}` : "\n" : options.prefix
         };
       }
       var ts_exports2 = {};
-      __export(ts_exports2, {
+      __export2(ts_exports2, {
         ANONYMOUS: () => ANONYMOUS,
         AccessFlags: () => AccessFlags,
         AssertionLevel: () => AssertionLevel,
@@ -200304,7 +200406,7 @@ ${options.prefix}` : "\n" : options.prefix
         };
       }
       var ts_server_exports3 = {};
-      __export(ts_server_exports3, {
+      __export2(ts_server_exports3, {
         ActionInvalidate: () => ActionInvalidate,
         ActionPackageInstalled: () => ActionPackageInstalled,
         ActionSet: () => ActionSet,
@@ -200402,7 +200504,7 @@ ${options.prefix}` : "\n" : options.prefix
         updateProjectIfDirty: () => updateProjectIfDirty
       });
       var ts_server_typingsInstaller_exports = {};
-      __export(ts_server_typingsInstaller_exports, {
+      __export2(ts_server_typingsInstaller_exports, {
         TypingsInstaller: () => TypingsInstaller,
         getNpmCommandForInstallation: () => getNpmCommandForInstallation,
         installNpmPackages: () => installNpmPackages,
@@ -200969,7 +201071,7 @@ ${options.prefix}` : "\n" : options.prefix
         return base === "tsconfig.json" || base === "jsconfig.json" ? base : void 0;
       }
       var ts_server_protocol_exports = {};
-      __export(ts_server_protocol_exports, {
+      __export2(ts_server_protocol_exports, {
         ClassificationType: () => ClassificationType,
         CommandTypes: () => CommandTypes,
         CompletionTriggerKind: () => CompletionTriggerKind,
@@ -212884,8 +212986,8 @@ Additional information: BADCLIENT: Bad error code, ${badCode} not found in range
         installPackage(options) {
           this.packageInstallId++;
           const request2 = { kind: "installPackage", ...options, id: this.packageInstallId };
-          const promise = new Promise((resolve8, reject) => {
-            (this.packageInstalledPromise ?? (this.packageInstalledPromise = /* @__PURE__ */ new Map())).set(this.packageInstallId, { resolve: resolve8, reject });
+          const promise = new Promise((resolve9, reject) => {
+            (this.packageInstalledPromise ?? (this.packageInstalledPromise = /* @__PURE__ */ new Map())).set(this.packageInstallId, { resolve: resolve9, reject });
           });
           this.installer.send(request2);
           return promise;
@@ -213043,7 +213145,7 @@ Additional information: BADCLIENT: Bad error code, ${badCode} not found in range
       _TypingsInstallerAdapter.requestDelayMillis = 100;
       var TypingsInstallerAdapter = _TypingsInstallerAdapter;
       var ts_server_exports4 = {};
-      __export(ts_server_exports4, {
+      __export2(ts_server_exports4, {
         ActionInvalidate: () => ActionInvalidate,
         ActionPackageInstalled: () => ActionPackageInstalled,
         ActionSet: () => ActionSet,
@@ -214245,11 +214347,16 @@ function getBaseUrl() {
 }
 function parseError(e) {
   const msg = e.message;
-  const jsonMatch = msg.match(/\{[^}]*"message"[^}]*\}/);
+  const jsonMatch = msg.match(/\{[\s\S]*\}/);
   if (jsonMatch) {
     try {
       const parsed = JSON.parse(jsonMatch[0]);
-      if (parsed.message) return parsed.message;
+      const parts = [];
+      if (parsed.message) parts.push(parsed.message);
+      if (parsed.request_id) parts.push(`request_id: ${parsed.request_id}`);
+      if (parsed.retryable !== void 0) parts.push(`retryable: ${parsed.retryable ? "yes" : "no"}`);
+      if (parsed.endpoint) parts.push(`endpoint: ${parsed.endpoint}`);
+      if (parts.length > 0) return parts.join(" | ");
     } catch {
     }
   }
@@ -214266,7 +214373,7 @@ function parseError(e) {
   return msg;
 }
 function request(method, path, body) {
-  return new Promise((resolve8, reject) => {
+  return new Promise((resolve9, reject) => {
     const baseUrl = getBaseUrl();
     const fullUrl = `${baseUrl}${path}`;
     const url = new URL(fullUrl);
@@ -214292,9 +214399,9 @@ function request(method, path, body) {
             return;
           }
           try {
-            resolve8(JSON.parse(data));
+            resolve9(JSON.parse(data));
           } catch {
-            resolve8(data);
+            resolve9(data);
           }
         });
       }
@@ -214321,70 +214428,8 @@ function formatError(e) {
   return parseError(e);
 }
 
-// src/git.ts
-var import_node_child_process = require("node:child_process");
-var import_node_fs2 = require("node:fs");
-var import_node_path2 = require("node:path");
-function getGitRemote() {
-  try {
-    const url = (0, import_node_child_process.execSync)("git config --get remote.origin.url", {
-      encoding: "utf8",
-      cwd: process.cwd()
-    }).trim();
-    const match = url.match(/[:/]([^/]+)\/([^/]+?)(?:\.git)?$/);
-    if (match) {
-      return { org: match[1], repo: match[2] };
-    }
-    return null;
-  } catch {
-    return null;
-  }
-}
-function isGitRepo() {
-  return (0, import_node_fs2.existsSync)((0, import_node_path2.resolve)(process.cwd(), ".git"));
-}
-function getUncommittedDiff() {
-  try {
-    return (0, import_node_child_process.execSync)("git diff", { encoding: "utf8", cwd: process.cwd() }).trim();
-  } catch {
-    return "";
-  }
-}
-function getStagedDiff() {
-  try {
-    return (0, import_node_child_process.execSync)("git diff --staged", { encoding: "utf8", cwd: process.cwd() }).trim();
-  } catch {
-    return "";
-  }
-}
-function getLastCommitHash() {
-  try {
-    return (0, import_node_child_process.execSync)("git rev-parse HEAD", { encoding: "utf8", cwd: process.cwd() }).trim();
-  } catch {
-    return "unknown";
-  }
-}
-function getChangedFilesList() {
-  try {
-    const unstaged = (0, import_node_child_process.execSync)("git diff --name-only HEAD", { encoding: "utf8", cwd: process.cwd() }).trim();
-    const staged = (0, import_node_child_process.execSync)("git diff --staged --name-only", { encoding: "utf8", cwd: process.cwd() }).trim();
-    const files = /* @__PURE__ */ new Set();
-    if (unstaged) unstaged.split("\n").forEach((f) => files.add(f));
-    if (staged) staged.split("\n").forEach((f) => files.add(f));
-    return [...files].filter(Boolean);
-  } catch {
-    return [];
-  }
-}
-function getAuthorName() {
-  try {
-    return (0, import_node_child_process.execSync)("git config user.name", { encoding: "utf8", cwd: process.cwd() }).trim();
-  } catch {
-    return "unknown";
-  }
-}
-
 // src/commands/init.ts
+init_git();
 var import_scanner = __toESM(require_dist());
 var import_node_fs3 = require("node:fs");
 var import_node_path3 = require("node:path");
@@ -214858,6 +214903,10 @@ View: https://driftless.icu/ecosystem`);
 }
 
 // src/commands/scan.ts
+init_git();
+function emitJSON(data) {
+  console.log(JSON.stringify(data, null, 2));
+}
 async function scanCommand(args) {
   if (!isGitRepo()) {
     console.error("Error: not a git repository.");
@@ -214868,6 +214917,7 @@ async function scanCommand(args) {
     console.error("Error: no git remote found.");
     process.exit(1);
   }
+  const isJSON = args.includes("--json");
   let workspace;
   try {
     workspace = await api.get("/me");
@@ -214896,7 +214946,8 @@ async function scanCommand(args) {
     diff = getUncommittedDiff();
     source = "uncommitted changes";
     if (!diff) {
-      console.log("No uncommitted changes. Clean.");
+      if (isJSON) emitJSON({ status: "clean", files: [], rules_evaluated: 0 });
+      else console.log("No uncommitted changes. Clean.");
       process.exit(0);
     }
     changedFiles = diff.split("\n").filter((line) => line.startsWith("+++ b/") || line.startsWith("--- a/")).map((line) => line.replace(/^\+\+\+ b\//, "").replace(/^--- a\//, "")).filter((f, i, arr) => arr.indexOf(f) === i);
@@ -214906,15 +214957,18 @@ async function scanCommand(args) {
     diff = [staged, unstaged].filter(Boolean).join("\n");
     source = staged && unstaged ? "staged + unstaged" : staged ? "staged" : "unstaged";
     if (!diff) {
-      console.log("No changes to scan. Clean.");
+      if (isJSON) emitJSON({ status: "clean", files: [], rules_evaluated: 0 });
+      else console.log("No changes to scan. Clean.");
       process.exit(0);
     }
   }
   const commitHash = getLastCommitHash();
   const author = getAuthorName();
-  console.log(`Scanning ${source}...`);
-  if (changedFiles.length > 0) {
-    console.log(`  Files: ${changedFiles.join(", ")}`);
+  if (!isJSON) {
+    console.log(`Scanning ${source}...`);
+    if (changedFiles.length > 0) {
+      console.log(`  Files: ${changedFiles.join(", ")}`);
+    }
   }
   const result = await api.post("/scan", {
     workspace_id: workspace.workspace_id,
@@ -214925,29 +214979,42 @@ async function scanCommand(args) {
   });
   const rulesEvaluated = result.rules_evaluated || 0;
   if (result.status === "clean") {
-    console.log(`Clean \u2014 ${rulesEvaluated} rule(s) evaluated, no violations.`);
+    if (isJSON) {
+      emitJSON({ status: "clean", files: changedFiles, rules_evaluated: rulesEvaluated, violations: [] });
+    } else {
+      console.log(`Clean \u2014 ${rulesEvaluated} rule(s) evaluated, no violations.`);
+    }
     process.exit(0);
   }
   if (!result.violations || result.violations.length === 0) {
-    console.log(`Clean \u2014 ${rulesEvaluated} rule(s) evaluated, no violations.`);
+    if (isJSON) {
+      emitJSON({ status: "clean", files: changedFiles, rules_evaluated: rulesEvaluated, violations: [] });
+    } else {
+      console.log(`Clean \u2014 ${rulesEvaluated} rule(s) evaluated, no violations.`);
+    }
     process.exit(0);
   }
-  console.log(`
+  if (isJSON) {
+    emitJSON({ status: "violated", files: changedFiles, rules_evaluated: rulesEvaluated, violations: result.violations });
+  } else {
+    console.log(`
 ${result.violations.length} violation(s) found (${rulesEvaluated} rule(s) evaluated):
 `);
-  for (const v of result.violations) {
-    const severityColor = v.severity === "critical" || v.severity === "high" ? "\x1B[31m" : "\x1B[33m";
-    console.log(`  ${severityColor}[${v.severity.toUpperCase()}]\x1B[0m ${v.rule_name}`);
-    console.log(`    ${v.explanation}`);
-    console.log(`    File: ${v.file_path}:${v.line_number}`);
-    console.log(`    Code: ${v.diff_snippet}`);
-    console.log();
+    for (const v of result.violations) {
+      const severityColor = v.severity === "critical" || v.severity === "high" ? "\x1B[31m" : "\x1B[33m";
+      console.log(`  ${severityColor}[${v.severity.toUpperCase()}]\x1B[0m ${v.rule_name}`);
+      console.log(`    ${v.explanation}`);
+      console.log(`    File: ${v.file_path}:${v.line_number}`);
+      console.log(`    Code: ${v.diff_snippet}`);
+      console.log();
+    }
+    console.log("Fix these violations before pushing.");
   }
-  console.log("Fix these violations before pushing.");
   process.exit(1);
 }
 
 // src/commands/context.ts
+init_git();
 var import_node_fs4 = require("node:fs");
 var import_node_path4 = require("node:path");
 function parseArgs(args) {
@@ -214969,16 +215036,27 @@ function parseArgs(args) {
   }
   return { flags, positional };
 }
-function emitJSON(data) {
+function emitJSON2(data) {
   console.log(JSON.stringify(data, null, 2));
 }
 function pad(s, n) {
   if (s.length >= n) return s;
   return s + " ".repeat(n - s.length);
 }
+function formatBadges(badges) {
+  const display = [];
+  for (const b of badges) {
+    if (b === "manual" || b === "fresh") continue;
+    display.push(`[${b}]`);
+  }
+  return display.join(" ");
+}
 function renderSummaryHuman(items) {
   if (items.length === 0) {
-    console.log("No context topics found.");
+    console.log("No context topics yet.");
+    console.log("\nNext:");
+    console.log('  driftless context add "auth-boundaries" --what "..." --how "..." --pattern "src/auth/**"');
+    console.log("  driftless init  # auto-generate topics from your codebase");
     return;
   }
   const topicWidth = Math.max(...items.map((i) => i.topic.length), 12) + 2;
@@ -214991,14 +215069,6 @@ function renderSummaryHuman(items) {
   console.log(`
 ${items.length} topic${items.length === 1 ? "" : "s"}.`);
 }
-function formatBadges(badges) {
-  const display = [];
-  for (const b of badges) {
-    if (b === "manual" || b === "fresh") continue;
-    display.push(`[${b}]`);
-  }
-  return display.join(" ");
-}
 function renderContextHuman(ctx) {
   console.log(`\u258C ${ctx.topic}`);
   console.log(`  ${ctx.summary}`);
@@ -215028,9 +215098,7 @@ function renderContextHuman(ctx) {
     console.log(`
   docs (${ctx.anchors.docs.length})`);
     for (const d of ctx.anchors.docs) {
-      const preview = d.content.split("\n").slice(0, 3).join("\n      ");
-      console.log(`    ${d.path || "(anchored)"}
-      ${preview}${d.content.split("\n").length > 3 ? "\n      ..." : ""}`);
+      console.log(`    ${d.path || "(anchored)"}`);
     }
   }
   if (ctx.components.length > 0) {
@@ -215084,7 +215152,7 @@ function renderMatchFilesHuman(results, files) {
     console.log(`No matching context for ${files.length} changed file${files.length === 1 ? "" : "s"}.`);
     return;
   }
-  console.log(`${results.length} topic${results.length === 1 ? "" : "s"} matched for ${files.length} file${files.length === 1 ? "" : "s"}:
+  console.log(`Matched ${results.length} topic${results.length === 1 ? "" : "s"} for ${files.length} file${files.length === 1 ? "" : "s"}:
 `);
   for (const r of results) {
     const ctx = r.context;
@@ -215100,6 +215168,15 @@ function renderMatchFilesHuman(results, files) {
     console.log("");
   }
 }
+function countLocalFilesMatching(pattern) {
+  try {
+    const { globSync } = require("node:fs");
+    const matches = globSync(pattern, { cwd: process.cwd() });
+    return matches.length;
+  } catch {
+    return 0;
+  }
+}
 async function resolveWorkspaceSlug() {
   try {
     const me = await api.get("/me");
@@ -215121,7 +215198,7 @@ async function contextCommand(args) {
   const workspaceSlug = await resolveWorkspaceSlug();
   const { flags, positional } = parseArgs(args);
   const subCommand = positional[0];
-  const isHuman = !!flags["human"];
+  const isJSON = !!flags["json"];
   if (subCommand === "list") {
     const query = [];
     if (flags["stale"]) query.push("stale=true");
@@ -215132,13 +215209,16 @@ async function contextCommand(args) {
     const qs = query.length > 0 ? `?${query.join("&")}` : "";
     try {
       const summaries = await api.get(`/workspaces/${workspaceSlug}/watchers${qs}`);
-      if (summaries.length === 0) {
-        console.error("No context topics yet. Run `driftless init` to auto-generate watchers from your codebase.");
-      }
-      if (isHuman) {
-        renderSummaryHuman(summaries);
+      if (summaries.length === 0 && !isJSON) {
+        console.log("No context topics yet.");
+        console.log("\nNext:");
+        console.log('  driftless context add "auth-boundaries" --what "..." --how "..." --pattern "src/auth/**"');
+        console.log("  driftless init  # auto-generate topics from your codebase");
+      }
+      if (isJSON) {
+        emitJSON2(summaries);
       } else {
-        emitJSON(summaries);
+        renderSummaryHuman(summaries);
       }
     } catch (e) {
       console.error(`List failed: ${formatError(e)}`);
@@ -215162,25 +215242,29 @@ async function contextCommand(args) {
         files = getChangedFilesList();
       }
       if (files.length === 0) {
-        if (isHuman) {
+        if (!isJSON) {
           console.log("No local changes detected.");
         } else {
-          emitJSON([]);
+          emitJSON2([]);
         }
         process.exit(0);
       }
+      const missingFiles = files.filter((f) => !(0, import_node_fs4.existsSync)((0, import_node_path4.resolve)(process.cwd(), f)));
+      if (missingFiles.length > 0 && !isJSON) {
+        console.error(`File(s) not found locally: ${missingFiles.join(", ")}. Matching by pattern only.`);
+      }
       try {
         const results = await api.post(
           `/workspaces/${workspaceSlug}/watchers/match-files`,
           { files }
         );
-        if (results.length === 0) {
-          console.error(`No context topics match these files. No watcher covers the changed paths.`);
+        if (results.length === 0 && !isJSON) {
+          console.log(`No context topics match these files.`);
         }
-        if (isHuman) {
-          renderMatchFilesHuman(results, files);
+        if (isJSON) {
+          emitJSON2(results);
         } else {
-          emitJSON(results);
+          renderMatchFilesHuman(results, files);
         }
       } catch (e) {
         console.error(`Match failed: ${formatError(e)}`);
@@ -215189,21 +215273,21 @@ async function contextCommand(args) {
       return;
     }
     if (!slug) {
-      console.error("Usage: driftless context get <topic> [--human]");
-      console.error('       driftless context get --files "path1,path2" [--human]');
-      console.error("       driftless context get --diff [--human]");
+      console.error("Usage: driftless context get <topic>");
+      console.error('       driftless context get --files "path1,path2"');
+      console.error("       driftless context get --diff");
       process.exit(1);
     }
     try {
       const ctx = await api.get(`/workspaces/${workspaceSlug}/watchers/${slug}`);
-      if (isHuman) {
-        renderContextHuman(ctx);
-      } else {
+      if (isJSON) {
         const sanitized = JSON.parse(JSON.stringify(ctx, (_key, value) => {
           if (typeof value === "string" && value.length > 500) return value.slice(0, 500) + "\u2026";
           return value;
         }));
-        emitJSON(sanitized);
+        emitJSON2(sanitized);
+      } else {
+        renderContextHuman(ctx);
       }
     } catch (e) {
       console.error(`Topic '${slug}' not found.`);
@@ -215214,20 +215298,20 @@ async function contextCommand(args) {
   if (subCommand === "search") {
     const query = positional.slice(1).join(" ");
     if (!query) {
-      console.error('Usage: driftless context search "<query>" [--human]');
+      console.error('Usage: driftless context search "<query>"');
       process.exit(1);
     }
     try {
       const results = await api.get(
         `/workspaces/${workspaceSlug}/watchers/search?q=${encodeURIComponent(query)}`
       );
-      if (results.length === 0) {
-        console.error(`No context topics matching "${query}".`);
+      if (results.length === 0 && !isJSON) {
+        console.log(`No context topics matching "${query}".`);
       }
-      if (isHuman) {
-        renderSummaryHuman(results);
+      if (isJSON) {
+        emitJSON2(results);
       } else {
-        emitJSON(results);
+        renderSummaryHuman(results);
       }
     } catch (e) {
       console.error(`Search failed: ${formatError(e)}`);
@@ -215244,32 +215328,41 @@ async function contextCommand(args) {
     let fileContent;
     if (flags["file"]) {
       try {
-        const fs = await import("node:fs");
-        fileContent = fs.readFileSync(flags["file"], "utf-8");
+        fileContent = (0, import_node_fs4.readFileSync)(flags["file"], "utf-8");
       } catch {
         console.error(`File not found: ${flags["file"]}`);
         process.exit(1);
       }
     }
+    const pattern = flags["pattern"];
+    if (pattern && !isJSON) {
+      const localCount = countLocalFilesMatching(pattern);
+      if (localCount === 0) {
+        console.error(`Warning: pattern "${pattern}" matches 0 files locally. Topic created anyway.`);
+      }
+    }
     try {
       const result = await api.post(`/workspaces/${workspaceSlug}/watchers`, {
         name,
         what: flags["what"],
         how: flags["how"],
         where_files: flags["where"] ? [flags["where"]] : void 0,
-        pattern: flags["pattern"],
+        pattern,
         decisions: flags["decisions"],
         gotchas: flags["gotchas"],
         ownership: flags["ownership"],
         file_content: fileContent
       });
-      if (isHuman) {
-        console.log(`Topic '${name}' created.`);
+      if (isJSON) {
+        emitJSON2(result);
       } else {
-        emitJSON(result);
+        console.log(`Topic '${name}' created.`);
+        if (pattern) console.log(`  pattern: ${pattern}`);
+        if (flags["what"]) console.log(`  what: ${flags["what"]}`);
+        if (flags["how"]) console.log(`  how: ${flags["how"]}`);
       }
     } catch (e) {
-      console.error(`Failed to create topic: ${e.message}`);
+      console.error(`Failed to create topic: ${formatError(e)}`);
       process.exit(1);
     }
     return;
@@ -215289,17 +215382,11 @@ async function contextCommand(args) {
     if (flags["gotchas"]) updates.gotchas = flags["gotchas"];
     if (flags["ownership"]) updates.ownership = flags["ownership"];
     const gotchaFlag = flags["gotcha"] || flags["gotchas_append"];
-    if (gotchaFlag) {
-      updates._append_gotchas = gotchaFlag;
-    }
+    if (gotchaFlag) updates._append_gotchas = gotchaFlag;
     const invariantFlag = flags["invariant"];
-    if (invariantFlag) {
-      updates._append_invariants = invariantFlag;
-    }
+    if (invariantFlag) updates._append_invariants = invariantFlag;
     const checkFlag = flags["check"];
-    if (checkFlag) {
-      updates._append_required_checks = checkFlag;
-    }
+    if (checkFlag) updates._append_required_checks = checkFlag;
     const enforceFlag = flags["enforce"];
     if (enforceFlag && typeof enforceFlag === "string") {
       updates._enforce_rule = enforceFlag;
@@ -215319,12 +215406,28 @@ async function contextCommand(args) {
       console.error('PR 3: --gotcha, --invariant, --check, --enforce "<rule-description>"');
       process.exit(1);
     }
+    if (flags["dry-run"]) {
+      console.log(`Would update topic '${slug}':`);
+      for (const [key, value] of Object.entries(updates)) {
+        if (key.startsWith("_")) continue;
+        console.log(`  ${key}: ${value}`);
+      }
+      if (!isJSON) {
+        console.log("\n(Dry run \u2014 no changes written to Driftless Cloud)");
+      }
+      if (isJSON) {
+        emitJSON2({ dry_run: true, topic: slug, updates });
+      }
+      process.exit(0);
+    }
     try {
       const result = await api.patch(
         `/workspaces/${workspaceSlug}/watchers/${slug}`,
         updates
       );
-      if (isHuman) {
+      if (isJSON) {
+        emitJSON2(result);
+      } else {
         renderContextHuman(result);
         if (result.enforcement) {
           if (result.enforcement.created) {
@@ -215336,11 +215439,9 @@ async function contextCommand(args) {
   \u26A0 enforce: ${result.enforcement.reason}`);
           }
         }
-      } else {
-        emitJSON(result);
       }
     } catch (e) {
-      console.error(`Failed to update topic: ${e.message}`);
+      console.error(`Failed to update topic: ${formatError(e)}`);
       process.exit(1);
     }
     return;
@@ -215351,12 +215452,25 @@ async function contextCommand(args) {
       console.error("Usage: driftless context delete <topic>");
       process.exit(1);
     }
+    if (flags["dry-run"]) {
+      console.log(`Would delete topic '${slug}'.`);
+      if (!isJSON) {
+        console.log("(Dry run \u2014 no changes written to Driftless Cloud)");
+      }
+      if (isJSON) {
+        emitJSON2({ dry_run: true, action: "delete", topic: slug });
+      }
+      process.exit(0);
+    }
     try {
       await api.delete(`/workspaces/${workspaceSlug}/watchers/${slug}`);
-      if (isHuman) console.log(`Topic '${slug}' deleted.`);
-      else emitJSON({ status: "deleted", topic: slug });
+      if (isJSON) {
+        emitJSON2({ status: "deleted", topic: slug });
+      } else {
+        console.log(`Topic '${slug}' deleted.`);
+      }
     } catch (e) {
-      console.error(`Failed to delete topic: ${e.message}`);
+      console.error(`Failed to delete topic: ${formatError(e)}`);
       process.exit(1);
     }
     return;
@@ -215379,8 +215493,7 @@ async function contextCommand(args) {
     let fileContent;
     if (docFlag) {
       try {
-        const fs = await import("node:fs");
-        fileContent = fs.readFileSync(docFlag, "utf-8");
+        fileContent = (0, import_node_fs4.readFileSync)(docFlag, "utf-8");
       } catch {
         console.error(`File not found: ${docFlag}`);
         process.exit(1);
@@ -215388,27 +215501,42 @@ 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;
     updates._event_detail = `ANCHOR_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)`);
+      if (noteFlag) console.log(`  note: ${noteFlag}`);
+      if (filesFlag) console.log(`  files: ${filesFlag}`);
+      if (patternFlag) console.log(`  pattern: ${patternFlag}`);
+      if (!isJSON) {
+        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 });
+      }
+      process.exit(0);
+    }
     try {
       const result = await api.patch(
         `/workspaces/${workspaceSlug}/watchers/${slug}`,
         updates
       );
-      if (isHuman) {
-        console.log(`Topic '${slug}' anchored.`);
-        if (fileContent) console.log(`  doc: ${docFlag} (${fileContent.length} chars)`);
-        if (noteFlag) console.log(`  note: ${noteFlag}`);
-        if (filesFlag) console.log(`  files: ${filesFlag}`);
-        if (patternFlag) console.log(`  pattern: ${patternFlag}`);
-      } else {
+      if (isJSON) {
         const sanitized = JSON.parse(JSON.stringify(result, (_key, value) => {
           if (typeof value === "string" && value.length > 500) return value.slice(0, 500) + "\u2026";
           return value;
         }));
-        emitJSON(sanitized);
+        emitJSON2(sanitized);
+      } else {
+        console.log(`Topic '${slug}' anchored.`);
+        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)}`);
@@ -215428,21 +215556,59 @@ async function contextCommand(args) {
       process.exit(1);
     }
     const missingFiles = files.filter((f) => !(0, import_node_fs4.existsSync)((0, import_node_path4.resolve)(process.cwd(), f)));
-    if (missingFiles.length > 0) {
+    if (missingFiles.length > 0 && !isJSON) {
       console.error(`File(s) not found locally: ${missingFiles.join(", ")}. Matching by pattern only.`);
     }
+    if (flags["dry-run"]) {
+      try {
+        const results = await api.post(
+          `/workspaces/${workspaceSlug}/watchers/match-files`,
+          { files }
+        );
+        console.log(`Would match ${results.length} topic${results.length === 1 ? "" : "s"}:`);
+        for (const r of results) {
+          console.log(`  ${r.context.topic} via ${r.match_reason}`);
+        }
+        if (missingFiles.length > 0) {
+          console.log(`
+Warnings:`);
+          for (const f of missingFiles) {
+            console.log(`  ${f} does not exist locally \u2014 matched by pattern only`);
+          }
+        }
+        if (!isJSON) {
+          console.log("\n(Dry run \u2014 no context delivered)");
+        }
+        if (isJSON) {
+          emitJSON2({ dry_run: true, matched: results.map((r) => ({ topic: r.context.topic, reason: r.match_reason })), missing_files: missingFiles });
+        }
+      } catch (e) {
+        console.error(`Dry run failed: ${formatError(e)}`);
+        process.exit(1);
+      }
+      process.exit(0);
+    }
     try {
       const results = await api.post(
         `/workspaces/${workspaceSlug}/watchers/match-files`,
         { files }
       );
-      if (results.length === 0) {
-        console.error(`No context topics match these files. No watcher covers the changed paths.`);
+      if (results.length === 0 && !isJSON) {
+        console.log(`No context topics match these files.`);
       }
-      if (isHuman) {
-        renderMatchFilesHuman(results, files);
+      if (isJSON) {
+        emitJSON2(results);
       } else {
-        emitJSON(results);
+        if (results.length > 0) {
+          console.log(`Matched ${results.length} topic${results.length === 1 ? "" : "s"}:`);
+          for (const r of results) {
+            console.log(`  ${r.context.topic} via ${r.match_reason}`);
+          }
+          console.log(`
+Context delivered for ${files.length} file${files.length === 1 ? "" : "s"}.`);
+        } else {
+          console.log(`No context topics match these files. No watcher covers the changed paths.`);
+        }
       }
     } catch (e) {
       console.error(`Push failed: ${formatError(e)}`);
@@ -215455,9 +215621,284 @@ async function contextCommand(args) {
 Run 'driftless help context' for full reference.`);
 }
 
-// src/commands/install-skill.ts
+// src/commands/session.ts
+init_git();
 var import_node_fs5 = require("node:fs");
 var import_node_path5 = require("node:path");
+function parseArgs2(args) {
+  const flags = {};
+  const positional = [];
+  for (let i = 0; i < args.length; i++) {
+    if (args[i].startsWith("--")) {
+      const key = args[i].slice(2);
+      const next = args[i + 1];
+      if (next && !next.startsWith("--")) {
+        flags[key] = next;
+        i++;
+      } else {
+        flags[key] = true;
+      }
+    } else {
+      positional.push(args[i]);
+    }
+  }
+  return { flags, positional };
+}
+function emitJSON3(data) {
+  console.log(JSON.stringify(data, null, 2));
+}
+async function resolveWorkspaceSlug2() {
+  try {
+    const me = await api.get("/me");
+    if (me?.slug) return me.slug;
+  } catch {
+  }
+  const remote = getGitRemote();
+  if (!remote) {
+    console.error("Error: no git remote found.");
+    process.exit(1);
+  }
+  return remote.org;
+}
+async function sessionCommand(args) {
+  if (!isGitRepo()) {
+    console.error("Error: not a git repository.");
+    process.exit(1);
+  }
+  const workspaceSlug = await resolveWorkspaceSlug2();
+  const { flags, positional } = parseArgs2(args);
+  const subCommand = positional[0];
+  const isJSON = !!flags["json"];
+  if (subCommand === "start") {
+    const filesFlag = flags["files"];
+    let files = [];
+    if (filesFlag) {
+      files = filesFlag.split(",").map((f) => f.trim()).filter(Boolean);
+    } else {
+      files = getChangedFilesList();
+    }
+    if (files.length === 0) {
+      if (!isJSON) {
+        console.log("No files specified and no local changes detected.");
+        console.log('Usage: driftless session start --files "src/auth/**"');
+      } else {
+        emitJSON3({ files: [], topics: [], docs: [], rules: [], gotchas: [] });
+      }
+      process.exit(0);
+    }
+    const missingFiles = files.filter((f) => !(0, import_node_fs5.existsSync)((0, import_node_path5.resolve)(process.cwd(), f)));
+    if (missingFiles.length > 0 && !isJSON) {
+      console.error(`Warning: ${missingFiles.length} file(s) not found locally \u2014 matching by pattern only.`);
+    }
+    try {
+      const results = await api.post(
+        `/workspaces/${workspaceSlug}/watchers/match-files`,
+        { files }
+      );
+      const topics = [];
+      const docs = [];
+      const rules = [];
+      const gotchas = [];
+      const allWhat = [];
+      const allHow = [];
+      for (const r of results) {
+        const ctx = r.context;
+        topics.push(ctx.topic);
+        if (ctx.description.what) allWhat.push(ctx.description.what);
+        if (ctx.description.how) allHow.push(ctx.description.how);
+        if (ctx.description.gotchas) gotchas.push(...ctx.description.gotchas);
+        if (ctx.anchors.docs) {
+          for (const d of ctx.anchors.docs) {
+            if (d.path) docs.push(d.path);
+          }
+        }
+        if (ctx.rules) {
+          for (const rule of ctx.rules) {
+            rules.push(rule.name);
+          }
+        }
+      }
+      if (isJSON) {
+        emitJSON3({
+          files,
+          missing_files: missingFiles,
+          topics,
+          docs: [...new Set(docs)],
+          rules,
+          gotchas,
+          context_summary: {
+            what: allWhat,
+            how: allHow
+          }
+        });
+      } else {
+        console.log(`Session started for ${files.length} file(s):
+`);
+        for (const f of files) {
+          const exists = (0, import_node_fs5.existsSync)((0, import_node_path5.resolve)(process.cwd(), f));
+          console.log(`  ${exists ? "\u2713" : "\u2717"} ${f}`);
+        }
+        if (missingFiles.length > 0) {
+          console.log(`
+Warning: ${missingFiles.length} file(s) not found locally.`);
+        }
+        if (topics.length > 0) {
+          console.log(`
+Matched ${topics.length} context topic(s):`);
+          for (const r of results) {
+            console.log(`  \u258C ${r.context.topic}  (${r.match_reason})`);
+            if (r.context.description.what) {
+              console.log(`    ${r.context.description.what}`);
+            }
+          }
+        } else {
+          console.log("\nNo context topics match these files.");
+        }
+        if (docs.length > 0) {
+          console.log(`
+Anchored docs:`);
+          for (const d of [...new Set(docs)]) {
+            console.log(`  \u{1F4C4} ${d}`);
+          }
+        }
+        if (gotchas.length > 0) {
+          console.log(`
+Gotchas:`);
+          for (const g of gotchas) {
+            console.log(`  ! ${g}`);
+          }
+        }
+        if (rules.length > 0) {
+          console.log(`
+Rules that will be evaluated:`);
+          for (const r of rules) {
+            console.log(`  \u2713 ${r}`);
+          }
+        }
+        console.log("\nBefore finishing:");
+        console.log("  driftless scan --diff");
+        console.log("  driftless session finish");
+      }
+    } catch (e) {
+      console.error(`Session start failed: ${formatError(e)}`);
+      process.exit(1);
+    }
+    return;
+  }
+  if (subCommand === "finish") {
+    const files = getChangedFilesList();
+    if (files.length === 0 && !isJSON) {
+      console.log("No local changes detected. Session clean.");
+      process.exit(0);
+    }
+    try {
+      const remote = getGitRemote();
+      if (!remote) {
+        console.error("Error: no git remote found.");
+        process.exit(1);
+      }
+      const me = await api.get("/me");
+      const repos = await api.get(`/workspaces/${me.slug}/repos`);
+      const repo = repos.find((r) => r.github_org === remote.org && r.github_repo === remote.repo);
+      if (!repo) {
+        console.error(`Repo '${remote.repo}' not found. Run 'driftless init' first.`);
+        process.exit(1);
+      }
+      const { getUncommittedDiff: getUncommittedDiff3, getStagedDiff: getStagedDiff2, getLastCommitHash: getLastCommitHash2, getAuthorName: getAuthorName2 } = await Promise.resolve().then(() => (init_git(), git_exports));
+      const staged = getStagedDiff2();
+      const unstaged = getUncommittedDiff3();
+      const diff = [staged, unstaged].filter(Boolean).join("\n");
+      if (!diff && !isJSON) {
+        console.log("No changes to scan. Session clean.");
+        process.exit(0);
+      }
+      const scanResult = await api.post("/scan", {
+        workspace_id: me.workspace_id,
+        repo_id: repo.id,
+        diff,
+        commit_hash: getLastCommitHash2(),
+        author: getAuthorName2()
+      });
+      const rulesEvaluated = scanResult.rules_evaluated || 0;
+      const violations = scanResult.violations || [];
+      const contextResults = files.length > 0 ? await api.post(
+        `/workspaces/${me.slug}/watchers/match-files`,
+        { files }
+      ) : [];
+      const staleTopics = contextResults.filter((r) => r.context.stale?.is_stale);
+      if (isJSON) {
+        emitJSON3({
+          files,
+          rules_evaluated: rulesEvaluated,
+          violations,
+          stale_topics: staleTopics.map((r) => ({ topic: r.context.topic, reason: r.context.stale.reason })),
+          context_matched: contextResults.map((r) => r.context.topic)
+        });
+      } else {
+        console.log(`Session finish \u2014 ${files.length} file(s) changed:
+`);
+        for (const f of files) {
+          console.log(`  \u270E ${f}`);
+        }
+        console.log(`
+${rulesEvaluated} rule(s) evaluated.`);
+        if (violations.length > 0) {
+          console.log(`
+${violations.length} violation(s) found:`);
+          for (const v of violations) {
+            console.log(`  \u2717 [${v.severity.toUpperCase()}] ${v.rule_name}`);
+            console.log(`    ${v.file_path}:${v.line_number} \u2014 ${v.explanation}`);
+          }
+          console.log("\nFix violations before pushing.");
+        } else {
+          console.log("No violations.");
+        }
+        if (staleTopics.length > 0) {
+          console.log(`
+\u26A0 ${staleTopics.length} stale context topic(s):`);
+          for (const s of staleTopics) {
+            console.log(`  ${s.context.topic} \u2014 ${s.context.stale.reason}`);
+            console.log(`    \u2192 driftless context update ${s.context.topic} --what "..." --how "..."`);
+          }
+        }
+        if (contextResults.length > 0) {
+          console.log(`
+Context touched:`);
+          for (const r of contextResults) {
+            console.log(`  \u258C ${r.context.topic}`);
+          }
+        }
+        console.log("\nLearned something? Update context:");
+        console.log('  driftless context update <topic> --gotchas "..."');
+        console.log('  driftless context add <new-topic> --what "..." --pattern "..."');
+      }
+      if (violations.length > 0) {
+        process.exit(1);
+      }
+    } catch (e) {
+      console.error(`Session finish failed: ${formatError(e)}`);
+      process.exit(1);
+    }
+    return;
+  }
+  console.log(`Usage: driftless session <start|finish> [args]
+
+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
+  --json                 Output as JSON
+
+Examples:
+  driftless session start --files "src/auth/**"
+  driftless session start          # uses local changes
+  driftless session finish         # scan + context report`);
+}
+
+// src/commands/install-skill.ts
+var import_node_fs6 = require("node:fs");
+var import_node_path6 = require("node:path");
 var template = `# Driftless \u2014 Live Repo Context
 
 Driftless Cloud holds the team's living codebase context (topics, anchors, rules, gotchas).
@@ -215583,32 +216024,33 @@ Context delivery + structural verification only.
 `;
 function installSkillCommand() {
   const cwd = process.cwd();
-  const agentsPath = (0, import_node_path5.resolve)(cwd, "AGENTS.md");
-  if ((0, import_node_fs5.existsSync)(agentsPath)) {
-    const existing = (0, import_node_fs5.readFileSync)(agentsPath, "utf8");
+  const agentsPath = (0, import_node_path6.resolve)(cwd, "AGENTS.md");
+  if ((0, import_node_fs6.existsSync)(agentsPath)) {
+    const existing = (0, import_node_fs6.readFileSync)(agentsPath, "utf8");
     if (existing.includes("# Driftless")) {
       console.log("Driftless section already present in AGENTS.md.");
       return;
     }
-    (0, import_node_fs5.writeFileSync)(agentsPath, existing + "\n---\n\n" + template);
+    (0, import_node_fs6.writeFileSync)(agentsPath, existing + "\n---\n\n" + template);
     console.log(`Appended Driftless section to ${agentsPath}`);
   } else {
-    (0, import_node_fs5.writeFileSync)(agentsPath, template);
+    (0, import_node_fs6.writeFileSync)(agentsPath, template);
     console.log(`Driftless skill installed at ${agentsPath}`);
   }
 }
 
 // src/commands/login.ts
-var import_node_fs6 = require("node:fs");
-var import_node_path6 = require("node:path");
+var import_node_fs7 = require("node:fs");
+var import_node_path7 = require("node:path");
 var import_node_readline = require("node:readline");
 var import_node_child_process2 = require("node:child_process");
 var import_node_os2 = require("node:os");
-var CONFIG_DIR = (0, import_node_path6.resolve)((0, import_node_os2.homedir)(), ".driftless");
-var CONFIG_PATH2 = (0, import_node_path6.resolve)(CONFIG_DIR, "config.json");
+var CONFIG_DIR = (0, import_node_path7.resolve)((0, import_node_os2.homedir)(), ".driftless");
+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");
@@ -215634,10 +216076,10 @@ async function loginCommand(args) {
     input: process.stdin,
     output: process.stdout
   });
-  const apiKey = await new Promise((resolve8) => {
+  const apiKey = await new Promise((resolve9) => {
     rl.question("Paste your API key: ", (answer) => {
       rl.close();
-      resolve8(answer.trim());
+      resolve9(answer.trim());
     });
   });
   if (!apiKey.startsWith("drift_")) {
@@ -215650,10 +216092,10 @@ async function loginCommand(args) {
 function saveConfig(apiKey, apiUrl) {
   const url = apiUrl || "https://api.driftless.icu/api/v1";
   try {
-    if (!(0, import_node_fs6.existsSync)(CONFIG_DIR)) {
-      (0, import_node_fs6.mkdirSync)(CONFIG_DIR, { recursive: true });
+    if (!(0, import_node_fs7.existsSync)(CONFIG_DIR)) {
+      (0, import_node_fs7.mkdirSync)(CONFIG_DIR, { recursive: true });
     }
-    (0, import_node_fs6.writeFileSync)(
+    (0, import_node_fs7.writeFileSync)(
       CONFIG_PATH2,
       JSON.stringify({ api_key: apiKey, api_url: url }, null, 2) + "\n"
     );
@@ -215669,8 +216111,9 @@ function saveConfig(apiKey, apiUrl) {
 }
 
 // src/commands/doctor.ts
-var import_node_fs7 = require("node:fs");
-var import_node_path7 = require("node:path");
+init_git();
+var import_node_fs8 = require("node:fs");
+var import_node_path8 = require("node:path");
 async function doctorCommand() {
   const checks = [];
   const apiKey = getApiKey();
@@ -215756,9 +216199,9 @@ async function doctorCommand() {
   } else {
     checks.push({ name: "Baseline", status: "warn", detail: "Skipped (no git remote)" });
   }
-  const agentsPath = (0, import_node_path7.resolve)(process.cwd(), "AGENTS.md");
-  if ((0, import_node_fs7.existsSync)(agentsPath)) {
-    const content = (0, import_node_fs7.readFileSync)(agentsPath, "utf-8");
+  const agentsPath = (0, import_node_path8.resolve)(process.cwd(), "AGENTS.md");
+  if ((0, import_node_fs8.existsSync)(agentsPath)) {
+    const content = (0, import_node_fs8.readFileSync)(agentsPath, "utf-8");
     if (content.includes("driftless")) {
       checks.push({ name: "AGENTS.md", status: "ok", detail: "Driftless skill installed" });
     } else {
@@ -215813,31 +216256,33 @@ function pad2(s, n) {
 }
 
 // src/index.ts
-var VERSION = "0.1.22";
-var HELP_TEXT = `Driftless CLI v${VERSION} \u2014 Context integrity for AI engineering teams
+var VERSION = "0.1.24";
+var HELP_TEXT = `Driftless CLI v${VERSION} \u2014 Living repo context for humans and coding agents
 
 Install:  npm install -g @driftless-sh/cli
 Docs:     https://driftless.icu/docs
 API:      https://api.driftless.icu/api/v1
 
 Agent loop:
-  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?
-  driftless context get --files "a,b"   Same, with explicit file paths
-  driftless context search "<query>"    Discover topics by keyword
-  driftless scan --diff                 Check changes against active rules
+  driftless session start             Show context before editing
+  driftless session finish            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?
+  driftless context search "<query>"  Discover topics by keyword
+  driftless scan --diff               Check changes against active rules
 
 Setup:
   driftless login --key <api-key>       Authenticate
-  driftless init                        Scan repo, generate rules + topics + anchor docs
+  driftless init                        Scan repo, bootstrap context, suggest rules
   driftless doctor                      Check environment health
 
 Commands:
   login             Authenticate with API key
-  init              Smart init: scan \u2192 detect patterns \u2192 create rules + topics + anchor docs
+  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)
   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)
@@ -215859,8 +216304,13 @@ Context subcommands:
   delete <topic>                Delete a topic
   push --files "p1,p2"          Legacy: match topics by file paths
 
+Session subcommands:
+  start [--files "p1,p2"]       Show relevant context before editing
+  finish                        Scan changes, check violations, suggest updates
+
 Flags:
-  --human     Show human-readable output (default is JSON for agent consumption)
+  --json      Output as JSON (default is human-readable)
+  --dry-run   Preview changes without writing to Driftless Cloud
 
 Auth priority:
   1. DRIFTLESS_API_KEY env var
@@ -215871,21 +216321,22 @@ Environment:
   DRIFTLESS_API_URL    API server URL (default: http://localhost:3000/api/v1)
 
 Output format:
-  All commands output JSON by default for agent consumption.
-  Use --human flag for readable text output.
+  All commands output human-readable text by default.
+  Use --json flag for machine-readable output (agents, CI).
 
 Examples:
+  driftless session start --files "src/auth/**"
+  driftless session finish
+
   driftless context add "b2b-guard" \\
     --what "Guard que protege endpoints B2B" \\
     --how "Verifica org_id en el token" \\
-    --pattern "src/shared/guards/**" \\
-    --decisions "Multi-tenant, usamos org_id" \\
-    --gotchas "No funciona con tokens de test" \\
-    --ownership "@team"
+    --pattern "src/shared/guards/**"
 
-  driftless context get sdk --human
+  driftless context get sdk
   driftless context search "auth"
   driftless scan --diff
+  driftless context push --files "src/auth/auth.controller.ts" --dry-run
 `;
 function showCommandHelp(cmd) {
   const help = {
@@ -215934,7 +216385,7 @@ Example:
     context: `driftless context <subcommand> [args] [flags]
 
 Live repo context \u2014 the team's shared codebase memory.
-JSON by default for agent consumption. Use --human for readable output.
+Human-readable by default. Use --json for machine output.
 
 Subcommands:
   list [filters]                List context topics
@@ -215956,69 +216407,20 @@ List filters:
   --manual                      Only manually-created topics
   --repo <id>                   Only topics scoped to a given repo
 
-Canonical 'get' shape (JSON):
-  {
-    "topic": "<slug>",
-    "summary": "...",
-    "description": { "what", "how", "decisions", "gotchas", "ownership" },
-    "anchors":     { "files", "patterns", "repos", "docs" },
-    "components":  [ ... ],
-    "rules":       [],
-    "invariants":  ["...", ...],
-    "violations":  [],
-    "events":      [],
-    "required_checks": ["...", ...],
-    "stale":       { "is_stale", "reason" },
-    "metadata":    { "created_by", "last_updated", "source" }
-  }
-
-Match-files response (JSON):
-  [
-    {
-      "context": { ... canonical shape ... },
-      "history": [ ... watcher events ... ],
-      "match_reason": "pattern:src/auth/**"
-    }
-  ]
-
-Create / update options:
-  --what          What this piece is
-  --how           How it works
-  --pattern       Glob (e.g. src/sdk/**) \u2014 resolves to files dynamically
-  --where         Explicit file path (alternative to --pattern)
-  --decisions     Why it was built this way
-  --gotchas       Known traps and edge cases
-  --ownership     Who maintains it
-  --file <path>   Anchor an existing markdown file as a doc (on add)
-
-Anchor options:
-  --doc <path>    Path to markdown file to anchor as file_content
-  --note "..."    Short note appended to decisions
-  --files "..."   Comma-separated file paths to anchor
-  --pattern "..." Glob pattern to anchor
-
-Update append options (PR 3):
-  --gotcha "..."       Append a gotcha to existing list
-  --invariant "..."    Append an invariant (team rule that must be followed)
-  --check "..."        Append a required pre-push check
-  --enforce "..."      Create a structural rule from the invariant
-
 Flags:
-  --human         Human-readable output (default is JSON)
+  --json          Machine-readable JSON output
+  --dry-run       Preview changes without writing to Driftless Cloud
 
 Examples:
-  driftless context list --stale --human
+  driftless context list
+  driftless context list --json
   driftless context get auth-boundaries
-  driftless context get auth-boundaries --human
-  driftless context get --diff --human
-  driftless context get --files "src/auth/guard.ts,src/auth/service.ts"
+  driftless context get --diff
   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 anchor auth --note "Use org_id for multi-tenant"
-  driftless context update auth --invariant "No direct DB from controllers"
-  driftless context update auth --check "Run harness:check before push"
+  driftless context push --files "src/auth/guard.ts" --dry-run
 `,
     "install-skill": `driftless install-skill
 
@@ -216070,6 +216472,9 @@ async function main() {
     case "context":
       await contextCommand(args.slice(1));
       break;
+    case "session":
+      await sessionCommand(args.slice(1));
+      break;
     case "install-skill":
       installSkillCommand();
       break;