@opengsd/gsd-core 1.6.0-rc.2 → 1.6.0

package/gsd-core/bin/lib/runtime-hooks-surface.cjs

@@ -238,6 +238,21 @@ function normalizeNodePath(execPath, opts) {
     if (/^\/opt\/homebrew\/Cellar\/node(@\d+)?\/[^/]+\/bin\/node(\.exe)?$/.test(execPath)) {
         return '/opt/homebrew/bin/node';
     }
+    // mise pins a concrete node version at <data>/installs/node/<ver>/bin/node
+    // (Windows: <data>/installs/node/<ver>/node.exe). Node realpaths
+    // process.execPath to that versioned path, and `mise up` prunes old versions,
+    // so a baked hook command 404s after any node bump — the same ephemeral-path
+    // failure #977 fixed for fnm. The stable alias is the sibling shim
+    // (<data>/shims/node), which always resolves to the active version, like the
+    // Homebrew symlink survives `brew upgrade node`. Derive <data> from execPath
+    // so a custom MISE_DATA_DIR layout still works, and only rewrite when the shim
+    // exists — otherwise fall back to the raw execPath unchanged.
+    const miseMatch = normalizedForMatch.match(/^(.*)\/installs\/node\/[^/]+\/(?:bin\/)?node(\.exe)?$/);
+    if (miseMatch) {
+        const shim = `${miseMatch[1]}/shims/node${miseMatch[2] || ''}`;
+        if (existsSync(shim))
+            return shim;
+    }
     return execPath;
 }
 function resolveNodeRunner(opts) {

package/gsd-core/bin/lib/runtime-name-policy.cjs

@@ -17,6 +17,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.canonicalizeRuntimeName = canonicalizeRuntimeName;
 exports.resolveRuntimeNameFromCandidates = resolveRuntimeNameFromCandidates;
+exports.getProjectInstructionFile = getProjectInstructionFile;
 exports.getDirName = getDirName;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
@@ -96,9 +97,53 @@ function resolveRuntimeNameFromCandidates(...candidates) {
     }
     return null;
 }
+/**
+ * Map a runtime id to its project instruction file path (relative to project
+ * root). Bug #1529: this is the SINGLE source of truth shared by both
+ * consumption surfaces —
+ *   (A) the Node surface: profile-output.cjs (generate-claude-md handler)
+ *   (B) the bash surface: `gsd-tools query project-instruction-file --runtime <r>`,
+ *       consumed by gsd-core/workflows/new-project.md to set $INSTRUCTION_FILE
+ *
+ * Mapping table (per the #1529 issue contract):
+ *
+ *   claude                      → .claude/CLAUDE.md
+ *   codex, opencode, kilo, kimi → AGENTS.md
+ *   copilot                     → .github/copilot-instructions.md
+ *   antigravity, gemini         → GEMINI.md
+ *   unknown / future runtimes   → AGENTS.md (safe cross-agent default)
+ *
+ * Source-of-truth references for each runtime's read path:
+ *   - copilot: GitHub Docs — repository-wide custom instructions are read ONLY
+ *     from `.github/copilot-instructions.md`; a root `copilot-instructions.md`
+ *     is not a read path. `AGENTS.md` is also read (agent instructions).
+ *     https://docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions
+ *     (Installer parity: runtime-config-adapter-registry.cts installSurface
+ *     'copilot-instructions' writes the same `.github/copilot-instructions.md`.)
+ *   - codex/opencode/kilo/kimi: AGENTS.md is the documented cross-agent
+ *     instruction file (agentsmd/agents.md convention).
+ *   - antigravity/gemini: GEMINI.md is Gemini CLI's contextFileName.
+ *
+ * Aliases are normalized via `canonicalizeRuntimeName` first, so inputs like
+ * `codex-cli` resolve to `codex` → `AGENTS.md`. Replaces the prior codex-only
+ * override in profile-output.cjs (#3163) which left AGENTS-native runtimes
+ * (opencode/kilo/kimi) incorrectly emitting `.claude/CLAUDE.md`. Pure: no I/O.
+ */
+function getProjectInstructionFile(runtime) {
+    const canonical = canonicalizeRuntimeName(runtime);
+    if (canonical === 'claude')
+        return '.claude/CLAUDE.md';
+    if (canonical === 'copilot')
+        return '.github/copilot-instructions.md';
+    if (canonical === 'antigravity' || canonical === 'gemini')
+        return 'GEMINI.md';
+    // codex, opencode, kilo, kimi, AND unknown/future runtimes all default to
+    // root AGENTS.md (the safe cross-agent instruction file).
+    return 'AGENTS.md';
+}
 /**
  * Map a canonical runtime id to its on-disk local config directory name
- * (e.g. `cursor` -> `.cursor`, `windsurf` -> `.devin`). Unknown/empty inputs
+ * (e.g. `cursor` -> `.cursor`, `windsurf` -> `.windsurf`). Unknown/empty inputs
  * fall back to `.claude`.
  *
  * Pure runtime-identity projection. Relocated from `bin/install.js` per
@@ -122,7 +167,7 @@ function getDirName(runtime) {
     if (runtime === 'cursor')
         return '.cursor';
     if (runtime === 'windsurf')
-        return '.devin';
+        return '.windsurf';
     if (runtime === 'augment')
         return '.augment';
     if (runtime === 'trae')

package/gsd-core/bin/lib/shell-command-projection.cjs

@@ -347,6 +347,16 @@ function projectPathActionProjection({ mode = 'repair', targetDir, platform = pr
                 shell: 'bash',
                 command: `echo 'export PATH="${bashTargetDir}:$PATH"' >> ~/.bashrc`,
             },
+            // #323: fish has no `export`/`$PATH`-list syntax. `fish_add_path` is the
+            // fish-native API (>= fish 3.2, 2021) that persists to the universal
+            // variable store and de-duplicates. The directory is single-quoted with
+            // the same POSIX literal escaping as the zsh/bash siblings — `'\''` is
+            // also a valid escaped single quote in fish between quote spans.
+            {
+                label: 'fish',
+                shell: 'fish',
+                command: `fish_add_path '${bashTargetDir}'`,
+            },
         ];
     }
     else {