@driftless-sh/cli 0.1.33 → 0.1.35

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,136 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
+// src/api-client.ts
+var api_client_exports = {};
+__export(api_client_exports, {
+  api: () => api,
+  formatError: () => formatError,
+  getApiKey: () => getApiKey,
+  getApiUrl: () => getApiUrl
+});
+function loadApiKey() {
+  const envKey = process.env["DRIFTLESS_API_KEY"];
+  if (envKey) return envKey;
+  try {
+    if ((0, import_node_fs.existsSync)(CONFIG_PATH)) {
+      const config = JSON.parse((0, import_node_fs.readFileSync)(CONFIG_PATH, "utf8"));
+      return config.api_key || null;
+    }
+  } catch {
+  }
+  return null;
+}
+function getBaseUrl() {
+  const envUrl = process.env["DRIFTLESS_API_URL"];
+  if (envUrl) {
+    return envUrl.endsWith("/api/v1") ? envUrl : `${envUrl}/api/v1`;
+  }
+  try {
+    if ((0, import_node_fs.existsSync)(CONFIG_PATH)) {
+      const config = JSON.parse((0, import_node_fs.readFileSync)(CONFIG_PATH, "utf8"));
+      return config.api_url || DEFAULT_URL;
+    }
+  } catch {
+  }
+  return DEFAULT_URL;
+}
+function parseError(e) {
+  const msg = e.message;
+  const jsonMatch = msg.match(/\{[\s\S]*\}/);
+  if (jsonMatch) {
+    try {
+      const parsed = JSON.parse(jsonMatch[0]);
+      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 {
+    }
+  }
+  const statusMatch = msg.match(/HTTP (\d+):/);
+  if (statusMatch) {
+    const code = parseInt(statusMatch[1], 10);
+    if (code === 500) return "Internal server error \u2014 the API encountered an unexpected issue";
+    if (code === 401) return "Authentication failed \u2014 check your API key";
+    if (code === 403) return "Access denied \u2014 your API key lacks permission";
+    if (code === 404) return "Not found \u2014 the resource does not exist";
+    if (code === 429) return "Rate limited \u2014 too many requests, try again later";
+    return `Server error (HTTP ${code})`;
+  }
+  return msg;
+}
+function request(method, path, body) {
+  return new Promise((resolve8, reject) => {
+    const baseUrl = getBaseUrl();
+    const fullUrl = `${baseUrl}${path}`;
+    const url = new URL(fullUrl);
+    const isHttps = url.protocol === "https:";
+    const fn = isHttps ? import_node_https.request : import_node_http.request;
+    const headers = {
+      "Content-Type": "application/json",
+      Accept: "application/json"
+    };
+    const apiKey = loadApiKey();
+    if (apiKey) {
+      headers["X-API-Key"] = apiKey;
+    }
+    const req = fn(
+      fullUrl,
+      { method, headers },
+      (res) => {
+        let data = "";
+        res.on("data", (chunk) => data += chunk.toString());
+        res.on("end", () => {
+          if (res.statusCode && res.statusCode >= 400) {
+            reject(new Error(`HTTP ${res.statusCode}: ${data}`));
+            return;
+          }
+          try {
+            resolve8(JSON.parse(data));
+          } catch {
+            resolve8(data);
+          }
+        });
+      }
+    );
+    req.on("error", (e) => reject(new Error(`Connection failed: ${e.message}`)));
+    if (body) req.write(JSON.stringify(body));
+    req.end();
+  });
+}
+function getApiUrl() {
+  return getBaseUrl();
+}
+function getApiKey() {
+  return loadApiKey();
+}
+function formatError(e) {
+  return parseError(e);
+}
+var import_node_http, import_node_https, import_node_fs, import_node_path, import_node_os, CONFIG_PATH, DEFAULT_URL, api;
+var init_api_client = __esm({
+  "src/api-client.ts"() {
+    "use strict";
+    import_node_http = require("node:http");
+    import_node_https = require("node:https");
+    import_node_fs = require("node:fs");
+    import_node_path = require("node:path");
+    import_node_os = require("node:os");
+    CONFIG_PATH = (0, import_node_path.resolve)((0, import_node_os.homedir)(), ".driftless", "config.json");
+    DEFAULT_URL = "http://localhost:3000/api/v1";
+    api = {
+      get: (path) => request("GET", path),
+      post: (path, body) => request("POST", path, body),
+      put: (path, body) => request("PUT", path, body),
+      patch: (path, body) => request("PATCH", path, body),
+      delete: (path) => request("DELETE", path)
+    };
+  }
+});
+
 // ../../libs/scanner/dist/identity/identity.js
 var require_identity = __commonJS({
   "../../libs/scanner/dist/identity/identity.js"(exports2) {
@@ -2436,7 +2573,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 +2587,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 +7674,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 +55977,7 @@ ${lanes.join("\n")}
         }
       }
       var ts_moduleSpecifiers_exports = {};
-      __export(ts_moduleSpecifiers_exports, {
+      __export2(ts_moduleSpecifiers_exports, {
         RelativePreference: () => RelativePreference,
         countPathComponents: () => countPathComponents,
         forEachFileNameOfModule: () => forEachFileNameOfModule,
@@ -150640,7 +150777,7 @@ ${lanes.join("\n")}
         }
       }
       var ts_JsTyping_exports = {};
-      __export(ts_JsTyping_exports, {
+      __export2(ts_JsTyping_exports, {
         NameValidationResult: () => NameValidationResult,
         discoverTypings: () => discoverTypings,
         isTypingUpToDate: () => isTypingUpToDate,
@@ -157686,7 +157823,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 +157928,7 @@ interface Symbol {
         };
       }
       var ts_NavigationBar_exports = {};
-      __export(ts_NavigationBar_exports, {
+      __export2(ts_NavigationBar_exports, {
         getNavigationBarItems: () => getNavigationBarItems,
         getNavigationTree: () => getNavigationTree
       });
@@ -158579,7 +158716,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 +162259,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 +166838,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 +167344,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 +167793,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 +167805,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 +179726,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 +183982,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 +185050,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 +187634,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 +188206,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 +189007,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 +189444,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 +189648,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 +190308,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 +190727,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 +190883,7 @@ ${content}
         }
       }
       var ts_SignatureHelp_exports = {};
-      __export(ts_SignatureHelp_exports, {
+      __export2(ts_SignatureHelp_exports, {
         getArgumentInfoForCompletions: () => getArgumentInfoForCompletions,
         getSignatureHelpItems: () => getSignatureHelpItems
       });
@@ -191292,7 +191429,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 +191660,7 @@ ${content}
         }
       }
       var ts_SymbolDisplay_exports = {};
-      __export(ts_SymbolDisplay_exports, {
+      __export2(ts_SymbolDisplay_exports, {
         getSymbolDisplayPartsDocumentationAndSymbolKind: () => getSymbolDisplayPartsDocumentationAndSymbolKind,
         getSymbolKind: () => getSymbolKind,
         getSymbolModifiers: () => getSymbolModifiers
@@ -192491,7 +192628,7 @@ ${content}
         });
       }
       var ts_textChanges_exports = {};
-      __export(ts_textChanges_exports, {
+      __export2(ts_textChanges_exports, {
         ChangeTracker: () => ChangeTracker,
         LeadingTriviaOption: () => LeadingTriviaOption,
         TrailingTriviaOption: () => TrailingTriviaOption,
@@ -193908,7 +194045,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 +197945,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 +197983,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 +198090,7 @@ ${options.prefix}` : "\n" : options.prefix
         };
       }
       var ts_exports2 = {};
-      __export(ts_exports2, {
+      __export2(ts_exports2, {
         ANONYMOUS: () => ANONYMOUS,
         AccessFlags: () => AccessFlags,
         AssertionLevel: () => AssertionLevel,
@@ -200304,7 +200441,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 +200539,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 +201106,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,
@@ -213043,7 +213180,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,
@@ -214209,122 +214346,35 @@ var require_dist = __commonJS({
   }
 });
 
-// src/api-client.ts
-var import_node_http = require("node:http");
-var import_node_https = require("node:https");
-var import_node_fs = require("node:fs");
-var import_node_path = require("node:path");
-var import_node_os = require("node:os");
-var CONFIG_PATH = (0, import_node_path.resolve)((0, import_node_os.homedir)(), ".driftless", "config.json");
-function loadApiKey() {
-  const envKey = process.env["DRIFTLESS_API_KEY"];
-  if (envKey) return envKey;
-  try {
-    if ((0, import_node_fs.existsSync)(CONFIG_PATH)) {
-      const config = JSON.parse((0, import_node_fs.readFileSync)(CONFIG_PATH, "utf8"));
-      return config.api_key || null;
-    }
-  } catch {
-  }
-  return null;
-}
-var DEFAULT_URL = "http://localhost:3000/api/v1";
-function getBaseUrl() {
-  const envUrl = process.env["DRIFTLESS_API_URL"];
-  if (envUrl) {
-    return envUrl.endsWith("/api/v1") ? envUrl : `${envUrl}/api/v1`;
-  }
-  try {
-    if ((0, import_node_fs.existsSync)(CONFIG_PATH)) {
-      const config = JSON.parse((0, import_node_fs.readFileSync)(CONFIG_PATH, "utf8"));
-      return config.api_url || DEFAULT_URL;
-    }
-  } catch {
-  }
-  return DEFAULT_URL;
+// src/analytics.ts
+var analytics_exports = {};
+__export(analytics_exports, {
+  analyticsEvent: () => analyticsEvent
+});
+function analyticsEvent(event, distinctId, props = {}) {
+  if (!KEY) return;
+  fetch(`${HOST}/capture/`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      api_key: KEY,
+      event,
+      distinct_id: `workspace:${distinctId}`,
+      properties: { ...props, source: "cli", $lib: "driftless-cli" }
+    })
+  }).catch(() => void 0);
 }
-function parseError(e) {
-  const msg = e.message;
-  const jsonMatch = msg.match(/\{[\s\S]*\}/);
-  if (jsonMatch) {
-    try {
-      const parsed = JSON.parse(jsonMatch[0]);
-      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 {
-    }
-  }
-  const statusMatch = msg.match(/HTTP (\d+):/);
-  if (statusMatch) {
-    const code = parseInt(statusMatch[1], 10);
-    if (code === 500) return "Internal server error \u2014 the API encountered an unexpected issue";
-    if (code === 401) return "Authentication failed \u2014 check your API key";
-    if (code === 403) return "Access denied \u2014 your API key lacks permission";
-    if (code === 404) return "Not found \u2014 the resource does not exist";
-    if (code === 429) return "Rate limited \u2014 too many requests, try again later";
-    return `Server error (HTTP ${code})`;
+var KEY, HOST;
+var init_analytics = __esm({
+  "src/analytics.ts"() {
+    "use strict";
+    KEY = "";
+    HOST = "https://us.i.posthog.com";
   }
-  return msg;
-}
-function request(method, path, body) {
-  return new Promise((resolve8, reject) => {
-    const baseUrl = getBaseUrl();
-    const fullUrl = `${baseUrl}${path}`;
-    const url = new URL(fullUrl);
-    const isHttps = url.protocol === "https:";
-    const fn = isHttps ? import_node_https.request : import_node_http.request;
-    const headers = {
-      "Content-Type": "application/json",
-      Accept: "application/json"
-    };
-    const apiKey = loadApiKey();
-    if (apiKey) {
-      headers["X-API-Key"] = apiKey;
-    }
-    const req = fn(
-      fullUrl,
-      { method, headers },
-      (res) => {
-        let data = "";
-        res.on("data", (chunk) => data += chunk.toString());
-        res.on("end", () => {
-          if (res.statusCode && res.statusCode >= 400) {
-            reject(new Error(`HTTP ${res.statusCode}: ${data}`));
-            return;
-          }
-          try {
-            resolve8(JSON.parse(data));
-          } catch {
-            resolve8(data);
-          }
-        });
-      }
-    );
-    req.on("error", (e) => reject(new Error(`Connection failed: ${e.message}`)));
-    if (body) req.write(JSON.stringify(body));
-    req.end();
-  });
-}
-var api = {
-  get: (path) => request("GET", path),
-  post: (path, body) => request("POST", path, body),
-  put: (path, body) => request("PUT", path, body),
-  patch: (path, body) => request("PATCH", path, body),
-  delete: (path) => request("DELETE", path)
-};
-function getApiUrl() {
-  return getBaseUrl();
-}
-function getApiKey() {
-  return loadApiKey();
-}
-function formatError(e) {
-  return parseError(e);
-}
+});
+
+// src/commands/init.ts
+init_api_client();
 
 // src/git.ts
 var import_node_child_process = require("node:child_process");
@@ -214401,6 +214451,7 @@ function getAuthorName() {
 var import_scanner = __toESM(require_dist());
 var import_node_fs4 = require("node:fs");
 var import_node_path4 = require("node:path");
+init_analytics();
 
 // src/commands/install-skill.ts
 var import_node_fs3 = require("node:fs");
@@ -214501,13 +214552,22 @@ async function installSkillCommand() {
   const icon = (s) => s === "created" ? "created \u2713" : s === "updated" ? "updated \u2713" : "already configured \u2713";
   console.log(`  CLAUDE.md   ${icon(result.claudeMd)}`);
   console.log(`  AGENTS.md   ${icon(result.agentsMd)}`);
+  try {
+    const { api: api2 } = await Promise.resolve().then(() => (init_api_client(), api_client_exports));
+    const me = await api2.get("/me");
+    if (me?.slug) {
+      const { analyticsEvent: analyticsEvent2 } = await Promise.resolve().then(() => (init_analytics(), analytics_exports));
+      analyticsEvent2("cli_install_skill", me.slug, { claude_md: result.claudeMd, agents_md: result.agentsMd });
+    }
+  } catch {
+  }
   return result;
 }
 
 // src/commands/init.ts
 function getVersion() {
   try {
-    return "0.1.33";
+    return "0.1.35";
   } catch {
     return "0.0.0";
   }
@@ -214806,6 +214866,15 @@ function step(label, value) {
 }
 async function initCommand(args) {
   const version = getVersion();
+  let srcOverride;
+  let suggest = false;
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--src" && i + 1 < args.length && !args[i + 1].startsWith("--")) {
+      srcOverride = args[++i];
+    } else if (args[i] === "--suggest") {
+      suggest = true;
+    }
+  }
   console.log("D R I F T L E S S");
   console.log(`v${version}`);
   console.log("");
@@ -214841,10 +214910,12 @@ async function initCommand(args) {
   const workspaceSlug = workspace.slug;
   console.log(`Repository: ${remote.org}/${remote.repo}`);
   console.log(`Workspace:  ${workspaceSlug} \u2713`);
+  if (srcOverride) console.log(`Scan root:  ${srcOverride}`);
   console.log("");
   const cwd = process.cwd();
+  const scanRoot = srcOverride ? (0, import_node_path4.resolve)(cwd, srcOverride) : cwd;
   const scanStart = Date.now();
-  const scanResult = await (0, import_scanner.scanRepo)(cwd);
+  const scanResult = await (0, import_scanner.scanRepo)(scanRoot);
   const scanMs = Date.now() - scanStart;
   const earlyPatterns = analyzeCodePatterns(scanResult.components);
   const summary = {
@@ -214916,46 +214987,53 @@ async function initCommand(args) {
       step("uploading components", "failed (continuing)");
     }
   }
-  const patterns = earlyPatterns;
-  const smartRules = generateSmartRules(repo.id, patterns);
   let rulesCreated = 0;
-  let rulesSkipped = 0;
-  for (const rule of smartRules) {
-    try {
-      const result = await api.post(`/workspaces/${workspaceSlug}/rules`, { ...rule, auto_suggested: true });
-      if (result?.skipped) {
+  if (suggest) {
+    const smartRules = generateSmartRules(repo.id, earlyPatterns);
+    let rulesSkipped = 0;
+    for (const rule of smartRules) {
+      try {
+        const result = await api.post(`/workspaces/${workspaceSlug}/rules`, { ...rule, auto_suggested: true });
+        if (result?.skipped) rulesSkipped++;
+        else rulesCreated++;
+      } catch {
         rulesSkipped++;
-      } else {
-        rulesCreated++;
       }
-    } catch {
-      rulesSkipped++;
     }
+    step("creating rules", `${rulesCreated} created \xB7 ${rulesSkipped} skipped \u2713`);
+  } else {
+    step("creating rules", "skipped (use --suggest to auto-generate)");
   }
-  step("creating rules", `${rulesCreated} created \xB7 ${rulesSkipped} skipped \u2713`);
-  const smartWatchers = generateSmartWatchers(components);
   let watchersCreated = 0;
-  let watchersSkipped = 0;
-  for (const watcher of smartWatchers) {
-    try {
-      await api.post(`/workspaces/${workspaceSlug}/watchers`, {
-        name: watcher.name,
-        what: watcher.what,
-        how: watcher.how,
-        pattern: watcher.pattern,
-        decisions: watcher.decisions,
-        gotchas: watcher.gotchas,
-        ownership: watcher.ownership,
-        where_repos: [repo.id],
-        created_by: "driftless-init",
-        suggested: true
-      });
-      watchersCreated++;
-    } catch {
-      watchersSkipped++;
+  if (suggest) {
+    const smartWatchers = generateSmartWatchers(components);
+    let watchersSkipped = 0;
+    for (const watcher of smartWatchers) {
+      try {
+        await api.post(`/workspaces/${workspaceSlug}/watchers`, {
+          name: watcher.name,
+          what: watcher.what,
+          how: watcher.how,
+          pattern: watcher.pattern,
+          decisions: watcher.decisions,
+          gotchas: watcher.gotchas,
+          ownership: watcher.ownership,
+          where_repos: [repo.id],
+          created_by: "driftless-init",
+          suggested: true,
+          origin: "auto",
+          status: "draft",
+          kind: "domain-map"
+        });
+        watchersCreated++;
+      } catch {
+        watchersSkipped++;
+      }
     }
+    step("creating context", `${watchersCreated} topics \u2713`);
+  } else {
+    step("creating context", "skipped (use --suggest to auto-generate)");
   }
-  step("creating context", `${watchersCreated} watchers \u2713`);
   const existingDocs = detectExistingDocs(cwd);
   step("detecting docs", `${existingDocs.length} found (not auto-synced)`);
   let skillLine = "skipped";
@@ -214969,8 +215047,8 @@ async function initCommand(args) {
   step("installing skill", skillLine);
   console.log("");
   console.log("\u2713 repo context bootstrapped");
-  console.log(`  \u251C\u2500 watchers      ${watchersCreated}`);
-  console.log(`  \u251C\u2500 rules          ${rulesCreated}`);
+  console.log(`  \u251C\u2500 topics        ${suggest ? watchersCreated : "(use --suggest to generate)"}`);
+  console.log(`  \u251C\u2500 rules          ${suggest ? rulesCreated : "(use --suggest to generate)"}`);
   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}`);
@@ -214979,10 +215057,18 @@ async function initCommand(args) {
   console.log("  next       \u2192  driftless context list");
   console.log("");
   console.log(DIVIDER);
+  analyticsEvent("cli_init_run", workspaceSlug, {
+    framework: summary.framework,
+    endpoints: summary.endpoints ?? components.filter((c) => c.type === "controller").length,
+    components: components.length,
+    watchers_created: watchersCreated
+  });
   process.exit(0);
 }
 
 // src/commands/scan.ts
+init_api_client();
+init_analytics();
 function emitJSON(data) {
   console.log(JSON.stringify(data, null, 2));
 }
@@ -215058,6 +215144,7 @@ async function scanCommand(args) {
   });
   const rulesEvaluated = result.rules_evaluated || 0;
   if (result.status === "clean") {
+    analyticsEvent("cli_scan_run", workspace.slug, { violations_found: false, count: 0 });
     if (isJSON) {
       emitJSON({ status: "clean", files: changedFiles, rules_evaluated: rulesEvaluated, violations: [] });
     } else {
@@ -215066,6 +215153,7 @@ async function scanCommand(args) {
     process.exit(0);
   }
   if (!result.violations || result.violations.length === 0) {
+    analyticsEvent("cli_scan_run", workspace.slug, { violations_found: false, count: 0 });
     if (isJSON) {
       emitJSON({ status: "clean", files: changedFiles, rules_evaluated: rulesEvaluated, violations: [] });
     } else {
@@ -215073,6 +215161,7 @@ async function scanCommand(args) {
     }
     process.exit(0);
   }
+  analyticsEvent("cli_scan_run", workspace.slug, { violations_found: true, count: result.violations.length });
   if (isJSON) {
     emitJSON({ status: "violated", files: changedFiles, rules_evaluated: rulesEvaluated, violations: result.violations });
   } else {
@@ -215093,8 +215182,10 @@ ${result.violations.length} violation(s) found (${rulesEvaluated} rule(s) evalua
 }
 
 // src/commands/context.ts
+init_api_client();
 var import_node_fs5 = require("node:fs");
 var import_node_path5 = require("node:path");
+init_analytics();
 function parseArgs(args) {
   const flags = {};
   const positional = [];
@@ -215139,10 +215230,12 @@ function renderSummaryHuman(items) {
   }
   const topicWidth = Math.max(...items.map((i) => i.topic.length), 12) + 2;
   const badgeWidth = Math.max(...items.map((i) => formatBadges(i.badges).length), 8) + 2;
+  const statusWidth = Math.max(...items.map((i) => (i.classification?.status || "").length), 8) + 2;
   for (const item of items) {
     const topic = pad(item.topic, topicWidth);
     const badges = pad(formatBadges(item.badges), badgeWidth);
-    console.log(`${topic}${badges}${item.summary}`);
+    const status = pad(item.classification?.status || "", statusWidth);
+    console.log(`${topic}${status}${badges}${item.summary}`);
   }
   console.log(`
 ${items.length} topic${items.length === 1 ? "" : "s"}.`);
@@ -215151,11 +215244,19 @@ function renderContextHuman(ctx) {
   console.log(`\u258C ${ctx.topic}`);
   console.log(`  ${ctx.summary}`);
   if (ctx.version !== void 0) console.log(`  version:    ${ctx.version}`);
+  if (ctx.classification) {
+    const { origin, status, kind } = ctx.classification;
+    console.log(`  origin: ${origin}  status: ${status}  kind: ${kind}`);
+  }
   if (ctx.stale.is_stale) {
     console.log(`
   \u26A0 STALE: ${ctx.stale.reason || "Context may be outdated"}`);
     console.log(`  \u2192 driftless context update ${ctx.topic} --what "..." --how "..."`);
   }
+  if (ctx.metadata.created_by === "driftless-init") {
+    console.log(`
+  \u24D8 auto-suggested by init \u2014 confirm with \`driftless context update ${ctx.topic} --what "..."\``);
+  }
   console.log("");
   if (ctx.description.what) console.log(`  what:       ${ctx.description.what}`);
   if (ctx.description.how) console.log(`  how:        ${ctx.description.how}`);
@@ -215284,9 +215385,23 @@ async function contextCommand(args) {
     if (flags["docs"]) query.push("docs=true");
     if (flags["auto"]) query.push("auto=true");
     if (flags["manual"]) query.push("manual=true");
-    if (flags["repo"]) query.push(`repo=${encodeURIComponent(flags["repo"])}`);
     if (flags["suggested"]) query.push("suggested=true");
     else query.push("suggested=false");
+    if (flags["status"]) query.push(`status=${encodeURIComponent(flags["status"])}`);
+    if (flags["kind"]) query.push(`kind=${encodeURIComponent(flags["kind"])}`);
+    if (flags["repo"]) {
+      query.push(`repo=${encodeURIComponent(flags["repo"])}`);
+    } else if (flags["auto"]) {
+      const currentRemote = getGitRemote();
+      if (currentRemote) {
+        try {
+          const repos = await api.get(`/workspaces/${workspaceSlug}/repos`);
+          const match = repos.find((r) => r.github_org === currentRemote.org && r.github_repo === currentRemote.repo);
+          if (match) query.push(`repo=${encodeURIComponent(match.id)}`);
+        } catch {
+        }
+      }
+    }
     const qs = query.length > 0 ? `?${query.join("&")}` : "";
     try {
       const summaries = await api.get(`/workspaces/${workspaceSlug}/watchers${qs}`);
@@ -215365,6 +215480,7 @@ async function contextCommand(args) {
     }
     try {
       const ctx = await api.get(`/workspaces/${workspaceSlug}/watchers/${slug}`);
+      analyticsEvent("cli_context_get", workspaceSlug, { topic: slug });
       if (isJSON) {
         const sanitized = JSON.parse(JSON.stringify(ctx, (_key, value) => {
           if (typeof value === "string" && value.length > 500) return value.slice(0, 500) + "\u2026";
@@ -215421,6 +215537,9 @@ async function contextCommand(args) {
     }
     const pattern = flags["pattern"];
     if (pattern && !isJSON) {
+      if (pattern.includes(",")) {
+        console.error(`Warning: pattern "${pattern}" contains a comma. Only one glob is accepted per topic. Create separate topics or remove the comma.`);
+      }
       const localCount = countLocalFilesMatching(pattern);
       if (localCount === 0) {
         console.error(`Warning: pattern "${pattern}" matches 0 files locally. Topic created anyway.`);
@@ -215436,8 +215555,11 @@ async function contextCommand(args) {
         decisions: flags["decisions"],
         gotchas: flags["gotchas"],
         ownership: flags["ownership"],
-        file_content: fileContent
+        file_content: fileContent,
+        status: flags["status"],
+        kind: flags["kind"]
       });
+      analyticsEvent("context_created", workspaceSlug, { topic: name, has_pattern: !!pattern, has_what: !!flags["what"] });
       if (isJSON) {
         emitJSON2(result);
       } else {
@@ -215466,12 +215588,21 @@ async function contextCommand(args) {
     if (flags["decisions"]) updates.decisions = flags["decisions"];
     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;
-    const invariantFlag = flags["invariant"];
-    if (invariantFlag) updates._append_invariants = invariantFlag;
-    const checkFlag = flags["check"];
-    if (checkFlag) updates._append_required_checks = checkFlag;
+    if (flags["status"]) updates.status = flags["status"];
+    const gotchaValues = [];
+    const invariantValues = [];
+    const checkValues = [];
+    for (let i = 0; i < args.length - 1; i++) {
+      const a = args[i];
+      const b = args[i + 1];
+      if (!b || b.startsWith("--")) continue;
+      if (a === "--gotcha" || a === "--gotchas_append") gotchaValues.push(b);
+      if (a === "--invariant") invariantValues.push(b);
+      if (a === "--check") checkValues.push(b);
+    }
+    if (gotchaValues.length > 0) updates._append_gotchas = gotchaValues.join("\n");
+    if (invariantValues.length > 0) updates._append_invariants = invariantValues.join("\n");
+    if (checkValues.length > 0) updates._append_required_checks = checkValues.join("\n");
     const enforceFlag = flags["enforce"];
     if (enforceFlag && typeof enforceFlag === "string") {
       updates._enforce_rule = enforceFlag;
@@ -215479,16 +215610,18 @@ async function contextCommand(args) {
       updates._enforce_rule = true;
     }
     const eventParts = [];
-    if (gotchaFlag) eventParts.push(`gotcha appended`);
-    if (invariantFlag) eventParts.push(`invariant appended`);
-    if (checkFlag) eventParts.push(`check appended`);
+    if (gotchaValues.length > 0) eventParts.push(`gotcha appended`);
+    if (invariantValues.length > 0) eventParts.push(`invariant appended`);
+    if (checkValues.length > 0) eventParts.push(`check appended`);
     if (enforceFlag) eventParts.push(`enforce requested`);
     if (eventParts.length > 0) {
       updates._event_detail = `CONTEXT_UPDATED: ${eventParts.join(", ")}`;
     }
     if (Object.keys(updates).length === 0) {
-      console.error("No fields to update. Use --what, --how, --pattern, --decisions, --gotchas, --ownership");
-      console.error('PR 3: --gotcha, --invariant, --check, --enforce "<rule-description>"');
+      console.error("No fields to update.");
+      console.error("Scalar: --what, --how, --pattern, --decisions, --gotchas, --ownership");
+      console.error("Append: --gotcha (repeatable), --invariant (repeatable), --check (repeatable)");
+      console.error('Enforce: --enforce "<rule-description>"');
       process.exit(1);
     }
     const currentRemote = getGitRemote();
@@ -215520,6 +215653,7 @@ async function contextCommand(args) {
         `/workspaces/${workspaceSlug}/watchers/${slug}`,
         updates
       );
+      analyticsEvent("cli_context_update", workspaceSlug, { topic: slug });
       if (isJSON) {
         emitJSON2(result);
       } else {
@@ -215596,7 +215730,12 @@ 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 (docFlag) {
+      updates.anchored_doc_path = docFlag;
+      updates.origin = "doc";
+      updates.status = "draft";
+      updates.kind = "docs-pending";
+    }
     if (noteFlag) updates.decisions = noteFlag;
     if (filesFlag) updates.where_files = filesFlag.split(",").map((f) => f.trim()).filter(Boolean);
     if (patternFlag) updates.pattern = patternFlag;
@@ -215875,6 +216014,7 @@ Run 'driftless help context' for full reference.`);
 }
 
 // src/commands/sync.ts
+init_api_client();
 function parseArgs2(args) {
   const flags = {};
   for (let i = 0; i < args.length; i++) {
@@ -215927,18 +216067,18 @@ async function syncCommand(args) {
   }
   if (!repoId) {
     if (!isJSON) {
-      console.log(`Repo '${remote.org}/${remote.repo}' not found in workspace.`);
-      console.log("Run driftless init to register this repo first.");
+      console.log(`\u26A0 Repo '${remote.org}/${remote.repo}' not found in workspace '${workspaceSlug}'.`);
+      console.log("  Run `driftless init` to register this repo, or `driftless doctor` to diagnose.");
     } else {
-      emitJSON3({ error: "repo_not_found", repo: `${remote.org}/${remote.repo}` });
+      emitJSON3({ error: "repo_not_found", repo: `${remote.org}/${remote.repo}`, workspace: workspaceSlug });
     }
-    process.exit(0);
+    process.exit(1);
   }
   const [eventsRes, staleTopics, violations, suggestedTopics] = await Promise.allSettled([
     api.get(`/workspaces/${workspaceSlug}/watchers/events?repo_id=${repoId}&limit=20`),
     api.get(`/workspaces/${workspaceSlug}/watchers?stale=true&repo=${repoId}`),
     api.get(`/workspaces/${workspaceSlug}/violations?repo_id=${repoId}&status=open&limit=20`),
-    api.get(`/workspaces/${workspaceSlug}/watchers?suggested=true`)
+    api.get(`/workspaces/${workspaceSlug}/watchers?suggested=true&repo=${repoId}`)
   ]);
   const events = eventsRes.status === "fulfilled" ? eventsRes.value.events ?? [] : [];
   const stale = staleTopics.status === "fulfilled" ? staleTopics.value : [];
@@ -216079,6 +216219,7 @@ function saveConfig(apiKey, apiUrl) {
 }
 
 // src/commands/doctor.ts
+init_api_client();
 var import_node_fs7 = require("node:fs");
 var import_node_path7 = require("node:path");
 async function doctorCommand() {
@@ -216186,13 +216327,18 @@ async function doctorCommand() {
         if (ghApp) {
           checks.push({ name: "GitHub App", status: "ok", detail: "Installed and active" });
         } else {
-          checks.push({ name: "GitHub App", status: "warn", detail: "Not installed. Install via dashboard Settings \u2192 GitHub" });
+          checks.push({ name: "GitHub App", status: "warn", detail: "Not installed \u2014 driftless.icu/ecosystem \u2192 Settings \u2192 Integrations (if just installed, wait ~60s)" });
+        }
+      } catch (err) {
+        const isNotFound = err?.status === 404 || String(err?.message ?? "").includes("404");
+        if (isNotFound) {
+          checks.push({ name: "GitHub App", status: "warn", detail: "Not installed \u2014 driftless.icu/ecosystem \u2192 Settings \u2192 Integrations" });
+        } else {
+          checks.push({ name: "GitHub App", status: "warn", detail: "Could not verify \u2014 check your connection or API key" });
         }
-      } catch {
-        checks.push({ name: "GitHub App", status: "warn", detail: "Could not verify" });
       }
     } else {
-      checks.push({ name: "GitHub App", status: "warn", detail: "Could not verify" });
+      checks.push({ name: "GitHub App", status: "warn", detail: "Could not verify (workspace unknown)" });
     }
   } else {
     checks.push({ name: "GitHub App", status: "warn", detail: "Skipped (not a git repo)" });
@@ -216224,7 +216370,7 @@ function pad2(s, n) {
 }
 
 // src/index.ts
-var VERSION = "0.1.33";
+var VERSION = "0.1.35";
 var HELP_TEXT = `Driftless CLI v${VERSION} \u2014 Living repo context for humans and coding agents
 
 Install:  npm install -g @driftless-sh/cli
@@ -216241,7 +216387,7 @@ Agent loop:
 
 Setup:
   driftless login --key <api-key>       Authenticate
-  driftless init                        Scan repo, bootstrap context, suggest rules
+  driftless init [--src <path>]         Scan repo, bootstrap context (add --suggest for auto topics+rules)
   driftless doctor                      Check environment health
 
 Commands:
@@ -216292,8 +216438,8 @@ Examples:
   driftless sync --json                # machine-readable output
 
   driftless context add "b2b-guard" \\
-    --what "Guard que protege endpoints B2B" \\
-    --how "Verifica org_id en el token" \\
+    --what "Guard protecting B2B endpoints" \\
+    --how "Verifies org_id from the auth token" \\
     --pattern "src/shared/guards/**"
 
   driftless context get sdk
@@ -216315,22 +216461,30 @@ Options:
 Example:
   driftless login --key drift_xxx
 `,
-    init: `driftless init
+    init: `driftless init [--src <path>] [--suggest]
 
 Smart initialization \u2014 zero friction:
   1. Detects framework, system type, auth patterns (Pass 1)
   2. AST scan: extracts endpoints, guards, services, modules, relations (Pass 2)
   3. Analyzes code patterns: guard enforcement, multi-tenant, large files, legacy
   4. Uploads baseline + components + relations to Cloud
-  5. Creates specific rules from detected patterns (not generic ones)
-  6. Creates context topics for each detected module with smart gotchas
-  7. Detects existing docs (not auto-synced \u2014 ask your agent to sync them)
+  5. Detects existing docs (not auto-synced \u2014 ask your agent to sync them)
+  6. Installs AGENTS.md skill
+
+With --suggest (optional):
+  Also auto-generates rules and context topics from detected patterns.
+
+Options:
+  --src <path>   Scan root relative to cwd (monorepo support).
+                 Git root stays at cwd; scanner starts from <path>.
+  --suggest      Auto-generate rules and context topics. Off by default.
 
 Must be run from a git repository root.
 
-Example:
-  cd my-nestjs-repo
+Examples:
   driftless init
+  driftless init --src apps/api/src
+  driftless init --src apps/api/src --suggest
 `,
     scan: `driftless scan [--diff]
 
@@ -216427,25 +216581,53 @@ async function main() {
   const command = args[0];
   switch (command) {
     case "init":
-      await initCommand(args.slice(1));
+      if (args[1] === "--help") {
+        showCommandHelp("init");
+      } else {
+        await initCommand(args.slice(1));
+      }
       break;
     case "scan":
-      await scanCommand(args.slice(1));
+      if (args[1] === "--help") {
+        showCommandHelp("scan");
+      } else {
+        await scanCommand(args.slice(1));
+      }
       break;
     case "context":
-      await contextCommand(args.slice(1));
+      if (args[1] === "--help") {
+        showCommandHelp("context");
+      } else {
+        await contextCommand(args.slice(1));
+      }
       break;
     case "sync":
-      await syncCommand(args.slice(1));
+      if (args[1] === "--help") {
+        showCommandHelp("sync");
+      } else {
+        await syncCommand(args.slice(1));
+      }
       break;
     case "install-skill":
-      await installSkillCommand();
+      if (args[1] === "--help") {
+        showCommandHelp("install-skill");
+      } else {
+        await installSkillCommand();
+      }
       break;
     case "login":
-      loginCommand(args.slice(1));
+      if (args[1] === "--help") {
+        showCommandHelp("login");
+      } else {
+        loginCommand(args.slice(1));
+      }
       break;
     case "doctor":
-      await doctorCommand();
+      if (args[1] === "--help") {
+        showCommandHelp("doctor");
+      } else {
+        await doctorCommand();
+      }
       break;
     case "help":
       if (args[1]) {