@glasstrace/sdk 1.6.1 → 1.7.0

package/README.md

@@ -83,7 +83,7 @@ init-hang cannot leave your installation in a broken state.
 | Exit code | Meaning |
 |-----------|---------|
 | `0` | Scaffolding succeeded AND the server confirmed the anon key. |
-| `1` | Scaffolding failed. No verification attempted. |
+| `1` | Scaffolding failed, OR the static-discovery file at `public/.well-known/glasstrace.json` could not be written. The browser extension cannot discover the project until that file is written; rerun `glasstrace init` after fixing the underlying error (most commonly: the static root is missing or read-only). |
 | `2` | Scaffolding succeeded but server verification failed. Safe to re-run. |
 
 On a non-zero verification exit, the error message distinguishes three
@@ -98,6 +98,18 @@ total cap). HTTP 4xx/5xx and malformed responses are surfaced
 immediately. Set `GLASSTRACE_SKIP_INIT_VERIFY=1` to skip verification
 for offline installs.
 
+## Getting help
+
+```bash
+glasstrace --help        # or: glasstrace -h
+glasstrace init --help   # same; help short-circuits subcommand routing
+```
+
+Help invocations print the command list and exit cleanly without
+modifying the project. Help is detected anywhere in the argv slice,
+including composite invocations like `glasstrace init --yes --help`
+(the `--yes` is ignored — the user asked for help).
+
 ## Refreshing agent instruction guidance
 
 `glasstrace init` and `glasstrace mcp add` write a managed Glasstrace

package/dist/{chunk-SYNQJZZY.js → chunk-OWPA7GHV.js}

@@ -4616,11 +4616,11 @@ function registerGlasstrace(options) {
     setCoreState(CoreState.REGISTERING);
     maybeWarnStaleAgentInstructions({
       projectRoot: process.cwd(),
-      sdkVersion: "1.6.1"
+      sdkVersion: "1.7.0"
     });
     startRuntimeStateWriter({
       projectRoot: process.cwd(),
-      sdkVersion: "1.6.1"
+      sdkVersion: "1.7.0"
     });
     const config = resolveConfig(options);
     if (config.verbose) {
@@ -4787,8 +4787,8 @@ async function backgroundInit(config, anonKeyForInit, generation) {
   if (config.verbose) {
     console.info("[glasstrace] Background init firing.");
   }
-  const healthReport = collectHealthReport("1.6.1");
-  const initResult = await performInit(config, anonKeyForInit, "1.6.1", healthReport);
+  const healthReport = collectHealthReport("1.7.0");
+  const initResult = await performInit(config, anonKeyForInit, "1.7.0", healthReport);
   if (generation !== registrationGeneration) return;
   const currentState = getCoreState();
   if (currentState === CoreState.SHUTTING_DOWN || currentState === CoreState.SHUTDOWN) {
@@ -4811,7 +4811,7 @@ async function backgroundInit(config, anonKeyForInit, generation) {
   }
   maybeInstallConsoleCapture();
   if (didLastInitSucceed()) {
-    startHeartbeat(config, anonKeyForInit, "1.6.1", generation, (newApiKey, accountId) => {
+    startHeartbeat(config, anonKeyForInit, "1.7.0", generation, (newApiKey, accountId) => {
       setAuthState(AuthState.CLAIMING);
       emitLifecycleEvent("auth:claim_started", { accountId });
       setResolvedApiKey(newApiKey);
@@ -5211,4 +5211,4 @@ export {
   withGlasstraceConfig,
   captureError
 };
-//# sourceMappingURL=chunk-SYNQJZZY.js.map
+//# sourceMappingURL=chunk-OWPA7GHV.js.map

package/dist/cli/init.cjs

@@ -16994,7 +16994,7 @@ async function mcpAdd(options) {
   const bearer = resolved.effective.key;
   for (const agent of targetAgents) {
     const name = formatAgentName(agent.name);
-    const sdkVersion = true ? "1.6.1" : "0.0.0-dev";
+    const sdkVersion = true ? "1.7.0" : "0.0.0-dev";
     if (agent.name !== "generic") {
       const cliSuccess = await registerViaCli(agent, bearer);
       if (cliSuccess) {
@@ -17262,7 +17262,7 @@ async function runUpgradeInstructions(options) {
     );
     return { exitCode: 1, refreshed, skipped, warnings, errors };
   }
-  const sdkVersion = true ? "1.6.1" : "0.0.0-dev";
+  const sdkVersion = true ? "1.7.0" : "0.0.0-dev";
   for (const agent of agents) {
     if (agent.infoFilePath === null) {
       continue;
@@ -17517,6 +17517,7 @@ var init_exports = {};
 __export(init_exports, {
   decideMcpConfigAction: () => decideMcpConfigAction,
   gitignoreExcludesDiscoveryFile: () => gitignoreExcludesDiscoveryFile,
+  isHelpInvocation: () => isHelpInvocation,
   meetsNodeVersion: () => meetsNodeVersion,
   rollbackSteps: () => rollbackSteps,
   runInit: () => runInit,
@@ -18625,6 +18626,7 @@ async function runInit(options) {
   const summary = [];
   const warnings = [];
   const errors = [];
+  let discoveryFileWriteFailed = false;
   let projectRoot;
   try {
     const classification = resolveProjectRoot(options.projectRoot);
@@ -18801,6 +18803,7 @@ Then add this as the first statement in your register() function:
           warnings.push(
             `Failed to write ${relPath}${discoveryResult.error !== void 0 ? `: ${discoveryResult.error}` : ""}. The Glasstrace browser extension cannot discover this project until the file is written; rerun \`glasstrace init\` after fixing the underlying error.`
           );
+          discoveryFileWriteFailed = true;
           break;
       }
       const gitignorePath = path9.join(projectRoot, ".gitignore");
@@ -18821,6 +18824,7 @@ Then add this as the first statement in your register() function:
           resolveStaticRoot(projectRoot).layout
         )}: ${err instanceof Error ? err.message : String(err)}`
       );
+      discoveryFileWriteFailed = true;
     }
     let anyConfigWritten = false;
     let anyConfigRewrittenWithBearer = false;
@@ -18898,7 +18902,7 @@ Then add this as the first statement in your register() function:
           }
           anyConfigWritten = true;
           anyConfigRewrittenWithBearer = true;
-          const sdkVersionForInject = true ? "1.6.1" : "0.0.0-dev";
+          const sdkVersionForInject = true ? "1.7.0" : "0.0.0-dev";
           const infoContent = generateInfoSection(
             agent,
             MCP_ENDPOINT,
@@ -18980,6 +18984,9 @@ Then add this as the first statement in your register() function:
       summary.push("Skipped anon key verification (no anon key on disk)");
     }
   }
+  if (discoveryFileWriteFailed) {
+    return { exitCode: 1, summary, warnings, errors };
+  }
   return { exitCode: 0, summary, warnings, errors };
 }
 async function verifyAnonKeyRegistration(projectRoot) {
@@ -19001,7 +19008,7 @@ async function verifyAnonKeyRegistration(projectRoot) {
   }
   const baseConfig = resolveConfig({ apiKey: devKey });
   const config2 = { ...baseConfig, apiKey: devKey };
-  const sdkVersion = true ? "1.6.1" : "0.0.0-dev";
+  const sdkVersion = true ? "1.7.0" : "0.0.0-dev";
   const result = await verifyInitReachable(config2, anonKey, sdkVersion);
   if (result.ok) {
     return { outcome: "verified" };
@@ -19051,7 +19058,11 @@ function parseArgs(argv) {
 }
 var scriptPath = typeof process !== "undefined" && process.argv[1] !== void 0 ? process.argv[1].replace(/\\/g, "/") : void 0;
 var scriptBasename = scriptPath !== void 0 ? path9.basename(scriptPath) : void 0;
-var isDirectExecution = scriptPath !== void 0 && (scriptPath.endsWith("/cli/init.js") || scriptPath.endsWith("/cli/init.ts") || scriptBasename === "glasstrace");
+var isDirectExecution = scriptPath !== void 0 && (scriptPath.endsWith("/cli/init.js") || scriptPath.endsWith("/cli/init.cjs") || scriptPath.endsWith("/cli/init.ts") || scriptBasename === "glasstrace");
+function isHelpInvocation(argv) {
+  return argv.some((arg) => arg === "--help" || arg === "-h");
+}
+var HELP_TEXT = "glasstrace \u2014 Glasstrace SDK CLI\n\nUsage:\n  glasstrace init [--yes] [--coverage-map] [--force] [--validate]\n  glasstrace uninit [--dry-run] [--force]\n  glasstrace status [--json]\n  glasstrace mcp add [--force] [--dry-run]\n  glasstrace upgrade-instructions\n\nRun a command without arguments to see its defaults.\nDocs: https://glasstrace.dev/docs/cli\n";
 if (isDirectExecution) {
   if (!meetsNodeVersion(20)) {
     process.stderr.write(
@@ -19060,6 +19071,10 @@ if (isDirectExecution) {
     );
     process.exit(1);
   }
+  if (isHelpInvocation(process.argv.slice(2))) {
+    process.stdout.write(HELP_TEXT);
+    process.exit(0);
+  }
   const subcommand = process.argv[2];
   if (subcommand === "mcp") {
     if (process.argv[3] === "add") {
@@ -19302,6 +19317,7 @@ Usage:
 0 && (module.exports = {
   decideMcpConfigAction,
   gitignoreExcludesDiscoveryFile,
+  isHelpInvocation,
   meetsNodeVersion,
   rollbackSteps,
   runInit,