@glasstrace/sdk 1.6.0 → 1.7.0

package/dist/cli/init.d.cts

@@ -177,5 +177,17 @@ type VerifyAnonKeyOutcome = {
  * @internal Exported for testability.
  */
 declare function verifyAnonKeyRegistration(projectRoot: string): Promise<VerifyAnonKeyOutcome>;
+/**
+ * Detect a help invocation. Help flags short-circuit before any
+ * subcommand routing so help invocations never run mutating code paths
+ * (DISC-1566). Accepts the argv slice from the second positional onward
+ * (i.e., `process.argv.slice(2)`).
+ *
+ * The check is presence-based on `--help` or `-h` anywhere in the slice.
+ * Composite invocations like `glasstrace init --yes --help` are help
+ * invocations: the user asked for help, so help is what they get; the
+ * `--yes` is ignored.
+ */
+declare function isHelpInvocation(argv: readonly string[]): boolean;
 
-export { type InitOptions, type InitResult, type VerifyAnonKeyOutcome, decideMcpConfigAction, gitignoreExcludesDiscoveryFile, meetsNodeVersion, rollbackSteps, runInit, verifyAnonKeyRegistration };
+export { type InitOptions, type InitResult, type VerifyAnonKeyOutcome, decideMcpConfigAction, gitignoreExcludesDiscoveryFile, isHelpInvocation, meetsNodeVersion, rollbackSteps, runInit, verifyAnonKeyRegistration };

package/dist/cli/init.d.ts

@@ -177,5 +177,17 @@ type VerifyAnonKeyOutcome = {
  * @internal Exported for testability.
  */
 declare function verifyAnonKeyRegistration(projectRoot: string): Promise<VerifyAnonKeyOutcome>;
+/**
+ * Detect a help invocation. Help flags short-circuit before any
+ * subcommand routing so help invocations never run mutating code paths
+ * (DISC-1566). Accepts the argv slice from the second positional onward
+ * (i.e., `process.argv.slice(2)`).
+ *
+ * The check is presence-based on `--help` or `-h` anywhere in the slice.
+ * Composite invocations like `glasstrace init --yes --help` are help
+ * invocations: the user asked for help, so help is what they get; the
+ * `--yes` is ignored.
+ */
+declare function isHelpInvocation(argv: readonly string[]): boolean;
 
-export { type InitOptions, type InitResult, type VerifyAnonKeyOutcome, decideMcpConfigAction, gitignoreExcludesDiscoveryFile, meetsNodeVersion, rollbackSteps, runInit, verifyAnonKeyRegistration };
+export { type InitOptions, type InitResult, type VerifyAnonKeyOutcome, decideMcpConfigAction, gitignoreExcludesDiscoveryFile, isHelpInvocation, meetsNodeVersion, rollbackSteps, runInit, verifyAnonKeyRegistration };

package/dist/cli/init.js

@@ -26,7 +26,7 @@ import {
   detectAgents,
   generateInfoSection,
   generateMcpConfig
-} from "../chunk-D3QXU2VM.js";
+} from "../chunk-KI7YJ7XD.js";
 import {
   MCP_ENDPOINT,
   getOrCreateAnonKey,
@@ -625,6 +625,7 @@ async function runInit(options) {
   const summary = [];
   const warnings = [];
   const errors = [];
+  let discoveryFileWriteFailed = false;
   let projectRoot;
   try {
     const classification = resolveProjectRoot(options.projectRoot);
@@ -801,6 +802,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 = path2.join(projectRoot, ".gitignore");
@@ -821,6 +823,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;
@@ -898,7 +901,7 @@ Then add this as the first statement in your register() function:
           }
           anyConfigWritten = true;
           anyConfigRewrittenWithBearer = true;
-          const sdkVersionForInject = true ? "1.6.0" : "0.0.0-dev";
+          const sdkVersionForInject = true ? "1.7.0" : "0.0.0-dev";
           const infoContent = generateInfoSection(
             agent,
             MCP_ENDPOINT,
@@ -980,6 +983,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) {
@@ -1001,7 +1007,7 @@ async function verifyAnonKeyRegistration(projectRoot) {
   }
   const baseConfig = resolveConfig({ apiKey: devKey });
   const config = { ...baseConfig, apiKey: devKey };
-  const sdkVersion = true ? "1.6.0" : "0.0.0-dev";
+  const sdkVersion = true ? "1.7.0" : "0.0.0-dev";
   const result = await verifyInitReachable(config, anonKey, sdkVersion);
   if (result.ok) {
     return { outcome: "verified" };
@@ -1051,7 +1057,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 ? path2.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(
@@ -1060,6 +1070,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") {
@@ -1301,6 +1315,7 @@ Usage:
 export {
   decideMcpConfigAction,
   gitignoreExcludesDiscoveryFile,
+  isHelpInvocation,
   meetsNodeVersion,
   rollbackSteps,
   runInit,