@glasstrace/sdk 1.10.1 → 1.11.0

package/README.md

@@ -113,11 +113,49 @@ including composite invocations like `glasstrace init --yes --help`
 ## Refreshing agent instruction guidance
 
 `glasstrace init` and `glasstrace mcp add` write a managed Glasstrace
-MCP section into your project's agent instruction file (CLAUDE.md /
-codex.md / .cursorrules). The section opens with a cost-aware
-cross-tool decision paragraph telling your AI agent **when** Glasstrace
-MCP is worth calling and **which** tool is the cheapest first call for
-each symptom class.
+MCP section into your project's agent instruction file(s). Per the
+2026 cross-tool standard governed by the Agentic AI Foundation under
+the Linux Foundation (`agents.md`), the SDK writes:
+
+- **`AGENTS.md`** — universal cross-tool destination. Read by Cursor,
+  Codex, Claude Code, GitHub Copilot, Devin, Windsurf, and Gemini CLI.
+  Always written.
+- **`CLAUDE.md`** — Claude Code primary canonical destination.
+- **`GEMINI.md`** — Gemini CLI primary canonical destination (default
+  `context.fileName`).
+- **`.cursor/rules/glasstrace.mdc`** — Cursor canonical 2026
+  destination (Markdown-extension format with YAML frontmatter
+  `alwaysApply: true`); plus `.cursorrules` written unconditionally
+  as a transitional fallback for migration teams on mixed Cursor
+  versions.
+- **`.windsurf/rules/glasstrace.md`** — Windsurf workspace-rules
+  directory (active first-class format per Windsurf's docs at
+  `windsurf.com/university`).
+
+The section opens with explicit "Call Glasstrace FIRST when" / "SKIP
+Glasstrace when" decision rules telling your AI agent **when**
+Glasstrace MCP is worth calling and **which** tool is the cheapest
+first call for each symptom class.
+
+### Migration from legacy filenames
+
+If you installed `@glasstrace/sdk` before v1.11 (Wave 18 / DISC-1782),
+your project may have a managed Glasstrace block in legacy
+destinations the SDK no longer writes to as primary:
+
+- `codex.md` (Codex now reads `AGENTS.md` by default)
+- `.windsurfrules` (Windsurf moved to `.windsurf/rules/*.md`)
+
+Run `npx glasstrace upgrade-instructions` to migrate: the managed
+section is created at the new canonical destination(s). The legacy
+files are left untouched (their managed sections become stale but
+your free-text content is preserved); copy any custom prose from the
+legacy file to `AGENTS.md` to keep your agent's visibility into it.
+
+If you need to roll back to a pre-v1.11 SDK, pin to `~1.10.0` in
+`package.json`; the older SDK does not recognize `AGENTS.md` /
+`GEMINI.md` / `.cursor/rules/` as agent-instruction targets so its
+stale-section warning will not see them.
 
 The managed section's start marker carries an SDK version stamp, e.g.
 `<!-- glasstrace:mcp:start v=1.5.0 -->`. When you upgrade

package/dist/{chunk-WQF7ZQOM.js → chunk-DQFGNX3H.js}

@@ -73,7 +73,7 @@ import {
 import {
   isEndMarkerLine,
   parseStartMarkerLine
-} from "./chunk-ZBQQXVHD.js";
+} from "./chunk-YIEXKQYP.js";
 import {
   __require
 } from "./chunk-NSBPE2FW.js";
@@ -4451,9 +4451,14 @@ import * as fs2 from "node:fs";
 import * as path2 from "node:path";
 var warningEmitted = false;
 var AGENT_INSTRUCTION_FILES = [
+  "AGENTS.md",
   "CLAUDE.md",
+  "GEMINI.md",
+  ".cursor/rules/glasstrace.mdc",
+  ".windsurf/rules/glasstrace.md",
+  ".cursorrules",
   "codex.md",
-  ".cursorrules"
+  ".windsurfrules"
 ];
 function parseSemver(input) {
   const plusIdx = input.indexOf("+");
@@ -4614,11 +4619,11 @@ function registerGlasstrace(options) {
     setCoreState(CoreState.REGISTERING);
     maybeWarnStaleAgentInstructions({
       projectRoot: process.cwd(),
-      sdkVersion: "1.10.1"
+      sdkVersion: "1.11.0"
     });
     startRuntimeStateWriter({
       projectRoot: process.cwd(),
-      sdkVersion: "1.10.1"
+      sdkVersion: "1.11.0"
     });
     const config = resolveConfig(options);
     if (config.verbose) {
@@ -4785,8 +4790,8 @@ async function backgroundInit(config, anonKeyForInit, generation) {
   if (config.verbose) {
     console.info("[glasstrace] Background init firing.");
   }
-  const healthReport = collectHealthReport("1.10.1");
-  const initResult = await performInit(config, anonKeyForInit, "1.10.1", healthReport);
+  const healthReport = collectHealthReport("1.11.0");
+  const initResult = await performInit(config, anonKeyForInit, "1.11.0", healthReport);
   if (generation !== registrationGeneration) return;
   const currentState = getCoreState();
   if (currentState === CoreState.SHUTTING_DOWN || currentState === CoreState.SHUTDOWN) {
@@ -4809,7 +4814,7 @@ async function backgroundInit(config, anonKeyForInit, generation) {
   }
   maybeInstallConsoleCapture();
   if (didLastInitSucceed()) {
-    startHeartbeat(config, anonKeyForInit, "1.10.1", generation, (newApiKey, accountId) => {
+    startHeartbeat(config, anonKeyForInit, "1.11.0", generation, (newApiKey, accountId) => {
       setAuthState(AuthState.CLAIMING);
       emitLifecycleEvent("auth:claim_started", { accountId });
       setResolvedApiKey(newApiKey);
@@ -5206,4 +5211,4 @@ export {
   withGlasstraceConfig,
   captureError
 };
-//# sourceMappingURL=chunk-WQF7ZQOM.js.map
+//# sourceMappingURL=chunk-DQFGNX3H.js.map