@opengsd/gsd-core 1.4.0-rc.1 → 1.4.0

package/commands/gsd/autonomous.md

@@ -2,6 +2,8 @@
 name: gsd:autonomous
 description: Run all remaining phases autonomously — discuss→plan→execute per phase
 argument-hint: "[--from N] [--to N] [--only N] [--interactive]"
+context: fork
+effort: xhigh
 allowed-tools:
   - Read
   - Write

package/commands/gsd/execute-phase.md

@@ -2,6 +2,8 @@
 name: gsd:execute-phase
 description: Execute all plans in a phase with wave-based parallelization
 argument-hint: "<phase-number> [--wave N] [--gaps-only] [--interactive] [--tdd]"
+context: fork
+effort: xhigh
 allowed-tools:
   - Read
   - Write

package/commands/gsd/plan-phase.md

@@ -2,6 +2,8 @@
 name: gsd:plan-phase
 description: Create detailed phase plan (PLAN.md) with verification loop
 argument-hint: "[phase] [--auto] [--research] [--skip-research] [--research-phase <N>] [--view] [--gaps] [--skip-verify] [--prd <file>] [--ingest <path-or-glob>] [--ingest-format <auto|nygard|madr|narrative>] [--reviews] [--text] [--tdd] [--mvp]"
+context: fork
+effort: xhigh
 allowed-tools:
   - Read
   - Write

package/commands/gsd/progress.md

@@ -2,6 +2,7 @@
 name: gsd:progress
 description: Check progress, advance workflow, or dispatch freeform intent — the unified GSD situational command
 argument-hint: "[--forensic | --next | --do \"task description\"]"
+effort: low
 allowed-tools:
   - Read
   - Bash

package/commands/gsd/stats.md

@@ -1,6 +1,7 @@
 ---
 name: gsd:stats
 description: Display project statistics — phases, plans, requirements, git metrics, and timeline
+effort: low
 allowed-tools:
   - Read
   - Bash

package/commands/gsd/update.md

@@ -1,7 +1,7 @@
 ---
 name: gsd:update
 description: Update GSD to latest version with changelog display
-argument-hint: "[--sync | --reapply]"
+argument-hint: "[--sync | --reapply | --next | --rc]"
 allowed-tools:
   - Read
   - Write
@@ -31,6 +31,7 @@ Routes to the update workflow which handles:
 <flags>
 - **--sync**: Sync managed GSD skills across runtime roots so multi-runtime users stay aligned after an update. Runs the sync-skills workflow (--from, --to, --dry-run, --apply flags supported).
 - **--reapply**: Reapply local modifications after a GSD update. Uses three-way comparison (pristine baseline, user-modified backup, newly installed version) to merge user customizations back. Runs the reapply-patches workflow.
+- **--next** (alias **--rc**): Target the `@next` RC dist-tag instead of `@latest` so you can install or refresh a release candidate (e.g. `1.4.0-rc.1`) through the normal update flow — scope/runtime detection, changelog preview, custom-file backup, and cache clearing all still apply. Omitting it keeps targeting `@latest` (no change). See ADR #660 for the RC channel.
 - **(no flag)**: Standard update — check for new version, show changelog, install.
 </flags>
 
@@ -38,7 +39,7 @@ Routes to the update workflow which handles:
 Parse the first token of $ARGUMENTS:
 - If it is `--sync`: strip the flag, execute the sync-skills workflow (passing remaining args for --from/--to/--dry-run/--apply).
 - If it is `--reapply`: strip the flag, execute the reapply-patches workflow.
-- Otherwise: execute the update workflow end-to-end.
+- Otherwise (including `--next` / `--rc`): execute the update workflow end-to-end, passing `$ARGUMENTS` through so the workflow's parse_update_channel step can select the release channel.
 
 </process>
 

package/gemini-extension.json

@@ -0,0 +1,6 @@
+{
+  "name": "gsd-core",
+  "version": "1.4.0",
+  "description": "GSD Core — a meta-prompting, context engineering, and spec-driven development system for AI coding agents. Loads gsd's operating context into every Gemini CLI session.",
+  "contextFileName": "GEMINI.md"
+}

package/gsd-core/bin/check-latest-version.cjs

@@ -37,18 +37,64 @@ const CHECK_REASON = Object.freeze({
 
 const SEMVER_RE = /^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?$/;
 
+// #815: the one RC channel ADR #660 sanctions, plus the stable default.
+// An allowlist (not a free string) keeps a typo from silently resolving
+// `npm view` to an empty or foreign dist-tag.
+const ALLOWED_TAGS = Object.freeze(['latest', 'next']);
+
+/**
+ * Build the `npm view` args for a dist-tag. `latest` keeps the bare package
+ * spec so the default invocation is byte-for-byte identical to before tag
+ * support existed (#815); any other allowlisted tag appends `@<tag>` so
+ * `npm view @opengsd/gsd-core@next version` resolves the RC channel (#660).
+ */
+function buildViewArgs(tag = 'latest') {
+  if (!ALLOWED_TAGS.includes(tag)) {
+    throw new RangeError(`invalid dist-tag '${tag}'; allowed: ${ALLOWED_TAGS.join(', ')}`);
+  }
+  const spec = tag === 'latest' ? PACKAGE_NAME : `${PACKAGE_NAME}@${tag}`;
+  return ['view', spec, 'version'];
+}
+
+/**
+ * Resolve the requested dist-tag from argv. Defaults to `latest` (no flag =>
+ * no behavior change). Restricted to ALLOWED_TAGS so a typo can't silently
+ * resolve to an empty/foreign tag (#815 alternative 1).
+ */
+function resolveTag(argv) {
+  let val;
+  const eq = argv.find((a) => typeof a === 'string' && a.startsWith('--tag='));
+  if (eq !== undefined) {
+    val = eq.slice('--tag='.length);
+  } else {
+    const i = argv.indexOf('--tag');
+    if (i === -1) return 'latest';
+    val = argv[i + 1];
+  }
+  if (!val || !ALLOWED_TAGS.includes(val)) {
+    throw new RangeError(
+      `invalid --tag '${val || ''}'; allowed: ${ALLOWED_TAGS.join(', ')}`,
+    );
+  }
+  return val;
+}
+
 /**
  * Pure-ish: takes an injected spawn function so tests don't actually run npm.
  * In production, defaults to execNpm() from the shell-projection seam.
  */
 function checkLatestVersion(opts = {}) {
+  const tag = opts.tag || 'latest';
+  if (!ALLOWED_TAGS.includes(tag)) {
+    throw new RangeError(`invalid dist-tag '${tag}'; allowed: ${ALLOWED_TAGS.join(', ')}`);
+  }
   // Default path routes through the shell-projection seam (execNpm owns the
   // Windows shell-flag policy and timeout default). The injection point
   // remains spawnSync-shaped for test compatibility — the adapter below
   // translates { exitCode } → { status } so the consumer logic is unchanged.
   // Bounded at 15s so a hung registry doesn't block /gsd-update (#2993 CR).
   const defaultSpawn = () => {
-    const r = execNpm(['view', PACKAGE_NAME, 'version'], { timeout: 15_000 });
+    const r = execNpm(buildViewArgs(tag), { timeout: 15_000 });
     return {
       status: r.exitCode,
       stdout: r.stdout,
@@ -90,8 +136,16 @@ function checkLatestVersion(opts = {}) {
 }
 
 function main() {
-  const json = process.argv.includes('--json');
-  const r = checkLatestVersion();
+  const argv = process.argv.slice(2);
+  const json = argv.includes('--json');
+  let tag;
+  try {
+    tag = resolveTag(argv);
+  } catch (e) {
+    process.stderr.write(`check-latest-version: ${e.message}\n`);
+    return 2;
+  }
+  const r = checkLatestVersion({ tag });
   if (json) {
     process.stdout.write(JSON.stringify(r) + '\n');
   } else if (r.ok) {
@@ -104,4 +158,4 @@ function main() {
 
 if (require.main === module) runMain(main);
 
-module.exports = { checkLatestVersion, CHECK_REASON, PACKAGE_NAME };
+module.exports = { checkLatestVersion, CHECK_REASON, PACKAGE_NAME, ALLOWED_TAGS, buildViewArgs, resolveTag };

package/gsd-core/bin/lib/install-profiles.cjs

@@ -351,6 +351,63 @@ function stageSkillsForRuntimeAsSkills(srcCommandsDir, resolvedProfile, converte
     ensureExitCleanup();
     return stageDir;
 }
+/**
+ * Stage converted command files as flat `.md` files.
+ *
+ * Analogous to `stageSkillsForRuntimeAsSkills` but for runtimes that use a
+ * flat commands directory (e.g. Cursor's `.cursor/commands/<name>.md`).
+ * Each source `.md` is passed through `converter` and written as a single flat
+ * `${stem}.md` file in the staging directory (no subdirectory, no prefix).
+ *
+ * The `_copyStaged` commands branch in install.js will add the prefix when
+ * copying staged files to the destination directory, so staged files must be
+ * named with just the stem (e.g. `help.md` not `gsd-help.md`).
+ *
+ * The `converter` receives `(content, ${prefix}${stem})` so it can embed the
+ * full command name (e.g. 'gsd-help') into the document body if needed.
+ *
+ * Used by the `convertedCommandsKind` layout descriptor in
+ * runtime-artifact-layout.cts (#785 — Cursor 1.6 slash commands).
+ *
+ * @param srcCommandsDir  source commands directory (e.g. commands/gsd/)
+ * @param resolvedProfile profile filter — '*' for all, Set for subset
+ * @param converter       (content, commandName) → string  pure converter
+ * @param prefix          command name prefix (for converter arg), e.g. 'gsd-'
+ */
+function stageCommandsForRuntimeFlat(srcCommandsDir, resolvedProfile, converter, prefix) {
+    if (!node_fs_1.default.existsSync(srcCommandsDir))
+        return srcCommandsDir;
+    const stageDir = node_fs_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), 'gsd-profile-runtime-commands-'));
+    try {
+        const entries = node_fs_1.default.readdirSync(srcCommandsDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isFile())
+                continue;
+            if (!entry.name.endsWith('.md'))
+                continue;
+            const stem = entry.name.slice(0, -3);
+            if (resolvedProfile.skills !== '*' && !(resolvedProfile.skills).has(stem))
+                continue;
+            const content = node_fs_1.default.readFileSync(node_path_1.default.join(srcCommandsDir, entry.name), 'utf8');
+            // Pass the full command name (with prefix) to the converter so it can
+            // reference the installed command name in the body (e.g. for descriptions).
+            // The staged file itself is named without the prefix; _copyStaged adds it.
+            const commandName = `${prefix}${stem}`;
+            const converted = converter(content, commandName);
+            node_fs_1.default.writeFileSync(node_path_1.default.join(stageDir, `${stem}.md`), converted);
+        }
+    }
+    catch (err) {
+        try {
+            node_fs_1.default.rmSync(stageDir, { recursive: true, force: true });
+        }
+        catch { /* best-effort */ }
+        throw err;
+    }
+    STAGED_DIRS.add(stageDir);
+    ensureExitCleanup();
+    return stageDir;
+}
 // ---------------------------------------------------------------------------
 // Profile marker persistence
 // ---------------------------------------------------------------------------
@@ -513,6 +570,7 @@ module.exports = {
     stageSkillsForProfile,
     stageAgentsForProfile,
     stageSkillsForRuntimeAsSkills,
+    stageCommandsForRuntimeFlat,
     STAGED_DIRS,
     readActiveProfile,
     writeActiveProfile,

package/gsd-core/bin/lib/installer-migration-report.cjs

@@ -34,7 +34,10 @@ const VALID_CHOICES = ['keep', 'remove'];
 exports.BUNDLED_GSD_HOOK_FILES = Object.freeze(new Set([
     'hooks/gsd-check-update-worker.js',
     'hooks/gsd-check-update.js',
+    'hooks/gsd-config-reload.js',
     'hooks/gsd-context-monitor.js',
+    'hooks/gsd-cursor-post-tool.js',
+    'hooks/gsd-cursor-session-start.js',
     'hooks/gsd-graphify-update.sh',
     'hooks/gsd-phase-boundary.sh',
     'hooks/gsd-prompt-guard.js',

package/gsd-core/bin/lib/installer-migrations/000-first-time-baseline.cjs

@@ -24,7 +24,7 @@ const RUNTIME_SURFACES = {
     kilo: ['gsd-core', 'command', 'skills', 'agents'],
     copilot: ['gsd-core', 'skills', 'agents'],
     antigravity: ['gsd-core', 'skills', 'agents'],
-    cursor: ['gsd-core', 'skills', 'agents'],
+    cursor: ['gsd-core', 'skills', 'agents', 'hooks', 'hooks.json'],
     windsurf: ['gsd-core', 'skills', 'agents', 'rules'],
     augment: ['gsd-core', 'skills', 'agents'],
     trae: ['gsd-core', 'skills', 'agents', 'rules'],

package/gsd-core/bin/lib/runtime-artifact-layout.cjs

@@ -18,7 +18,7 @@ const node_path_1 = __importDefault(require("node:path"));
 const node_fs_1 = __importDefault(require("node:fs"));
 // eslint-disable-next-line @typescript-eslint/no-require-imports
 const installProfiles = require("./install-profiles.cjs");
-const { stageSkillsForProfile, stageAgentsForProfile, stageSkillsForRuntimeAsSkills, } = installProfiles;
+const { stageSkillsForProfile, stageAgentsForProfile, stageSkillsForRuntimeAsSkills, stageCommandsForRuntimeFlat, } = installProfiles;
 // In .cts (CommonJS output) files, `require` is available as a global.
 const _require = require;
 /**
@@ -175,6 +175,34 @@ function skillsKind(destSubpath, prefix, converterName, runtime, configDir) {
         },
     };
 }
+/**
+ * Build a converted-commands kind descriptor for runtimes that use a flat
+ * commands directory with per-file conversion (e.g. Cursor 1.6 slash commands).
+ *
+ * Unlike `commandsKind` (which passes raw source files through), this kind
+ * applies `converterName` from bin/install.js exports to each file during
+ * staging, writing flat `${prefix}${stem}.md` files to the staged directory.
+ *
+ * The staged files are then written by `_copyStaged` (commands branch) which
+ * handles prefix logic via the existing layout machinery.
+ *
+ * @param destSubpath   destination subpath within configDir (e.g. 'commands')
+ * @param prefix        filename prefix, e.g. 'gsd-'
+ * @param converterName name of converter function in bin/install.js exports
+ * @param configDir     runtime config dir (for .gsd-source marker resolution)
+ */
+function convertedCommandsKind(destSubpath, prefix, converterName, configDir) {
+    return {
+        kind: 'commands',
+        destSubpath,
+        prefix,
+        stage: (resolved) => {
+            const installExports = getInstallExports();
+            const converter = installExports[converterName];
+            return stageCommandsForRuntimeFlat(findInstallSourceRoot(configDir), resolved, converter, prefix);
+        },
+    };
+}
 // ---------------------------------------------------------------------------
 // Public API
 // ---------------------------------------------------------------------------
@@ -205,7 +233,14 @@ function resolveRuntimeArtifactLayout(runtime, configDir, scope = 'global') {
             }
             break;
         case 'cursor':
-            kinds = [skillsKind('skills', 'gsd-', 'convertClaudeCommandToCursorSkill', 'cursor', configDir)];
+            // Cursor 1.6+ supports two artifact surfaces:
+            //   1. skills/gsd-<name>/SKILL.md  — rich skills with frontmatter + adapter header
+            //   2. commands/gsd-<name>.md      — plain markdown slash commands (no frontmatter)
+            //      accessed via '/' in the Agent input (#785)
+            kinds = [
+                skillsKind('skills', 'gsd-', 'convertClaudeCommandToCursorSkill', 'cursor', configDir),
+                convertedCommandsKind('commands', 'gsd-', 'convertClaudeCommandToCursorCommand', configDir),
+            ];
             break;
         case 'gemini':
             kinds = [commandsKind('commands/gsd', 'gsd-', configDir)];
@@ -223,7 +258,10 @@ function resolveRuntimeArtifactLayout(runtime, configDir, scope = 'global') {
             kinds = [skillsKind('skills', 'gsd-', 'convertClaudeCommandToWindsurfSkill', 'windsurf', configDir)];
             break;
         case 'augment':
-            kinds = [skillsKind('skills', 'gsd-', 'convertClaudeCommandToAugmentSkill', 'augment', configDir)];
+            kinds = [
+                commandsKind('commands', 'gsd-', configDir),
+                skillsKind('skills', 'gsd-', 'convertClaudeCommandToAugmentSkill', 'augment', configDir),
+            ];
             break;
         case 'trae':
             kinds = [skillsKind('skills', 'gsd-', 'convertClaudeCommandToTraeSkill', 'trae', configDir)];
@@ -235,20 +273,40 @@ function resolveRuntimeArtifactLayout(runtime, configDir, scope = 'global') {
             kinds = [skillsKind('skills/gsd', '', 'convertClaudeCommandToClaudeSkill', 'hermes', configDir)];
             break;
         case 'codebuddy':
-            kinds = [skillsKind('skills', 'gsd-', 'convertClaudeCommandToCodebuddySkill', 'codebuddy', configDir)];
+            // CodeBuddy (Tencent) reads two user-level surfaces (codebuddy.ai/docs/cli):
+            //   1. commands/gsd-<name>.md      — slash commands shown in the '/' menu (#789)
+            //   2. skills/gsd-<name>/SKILL.md  — model-invocable skills, emitted with
+            //      user-invocable:false so they stay OUT of '/' (the commands surface is
+            //      the sole '/' entry point) — avoids a duplicated /gsd-* per workflow.
+            // Subagents (~/.codebuddy/agents/) are already emitted by the generic agents
+            // block in bin/install.js; MCP is excluded (gsd ships no MCP server).
+            kinds = [
+                convertedCommandsKind('commands', 'gsd-', 'convertClaudeCommandToCodebuddyCommand', configDir),
+                skillsKind('skills', 'gsd-', 'convertClaudeCommandToCodebuddySkill', 'codebuddy', configDir),
+            ];
             break;
         case 'cline':
-            kinds = [];
+            kinds = scope === 'global' ? [skillsKind('skills', 'gsd-', 'convertClaudeCommandToClineSkill', 'cline', configDir)] : [];
             break;
         case 'opencode':
-            kinds = [commandsKind('command', 'gsd-', configDir)];
+            // OpenCode reads flat slash commands from command/ and on-demand skills
+            // from skills/<name>/SKILL.md (https://opencode.ai/docs/skills). Emit both.
+            kinds = [
+                commandsKind('command', 'gsd-', configDir),
+                skillsKind('skills', 'gsd-', 'convertClaudeCommandToOpencodeSkill', 'opencode', configDir),
+            ];
             break;
         case 'kilo':
-            kinds = [commandsKind('command', 'gsd-', configDir)];
+            // Kilo derives from OpenCode and shares the skills/<name>/SKILL.md layout
+            // (https://kilo.ai/docs/customize/skills). Emit flat commands + skills.
+            kinds = [
+                commandsKind('command', 'gsd-', configDir),
+                skillsKind('skills', 'gsd-', 'convertClaudeCommandToKiloSkill', 'kilo', configDir),
+            ];
             break;
         default:
             throw new TypeError(`Unknown runtime: '${runtime}' — add to runtime-artifact-layout.cjs table`);
     }
-    return { runtime, configDir, kinds };
+    return { runtime, configDir, scope, kinds };
 }
-module.exports = { resolveRuntimeArtifactLayout, findInstallSourceRoot };
+module.exports = { resolveRuntimeArtifactLayout, findInstallSourceRoot, getInstallExports };

package/gsd-core/bin/lib/runtime-config-adapter-registry.cjs

@@ -0,0 +1,56 @@
+'use strict';
+// ---------------------------------------------------------------------------
+// Registry
+// ---------------------------------------------------------------------------
+const REGISTRY = Object.freeze({
+    claude: Object.freeze({ installSurface: 'settings-json', writesSharedSettings: true, finishPermissionWriter: null }),
+    gemini: Object.freeze({ installSurface: 'settings-json', writesSharedSettings: true, finishPermissionWriter: null }),
+    antigravity: Object.freeze({ installSurface: 'settings-json', writesSharedSettings: true, finishPermissionWriter: null }),
+    augment: Object.freeze({ installSurface: 'settings-json', writesSharedSettings: true, finishPermissionWriter: null }),
+    qwen: Object.freeze({ installSurface: 'settings-json', writesSharedSettings: true, finishPermissionWriter: null }),
+    hermes: Object.freeze({ installSurface: 'settings-json', writesSharedSettings: true, finishPermissionWriter: null }),
+    codebuddy: Object.freeze({ installSurface: 'settings-json', writesSharedSettings: true, finishPermissionWriter: null }),
+    opencode: Object.freeze({ installSurface: 'settings-json', writesSharedSettings: true, finishPermissionWriter: 'opencode' }),
+    kilo: Object.freeze({ installSurface: 'settings-json', writesSharedSettings: false, finishPermissionWriter: 'kilo' }),
+    codex: Object.freeze({ installSurface: 'codex-toml', writesSharedSettings: false, finishPermissionWriter: null }),
+    copilot: Object.freeze({ installSurface: 'copilot-instructions', writesSharedSettings: false, finishPermissionWriter: null }),
+    cline: Object.freeze({ installSurface: 'cline-rules', writesSharedSettings: false, finishPermissionWriter: null }),
+    cursor: Object.freeze({ installSurface: 'cursor-hooks-json', writesSharedSettings: false, finishPermissionWriter: null }),
+    windsurf: Object.freeze({ installSurface: 'profile-marker-only', writesSharedSettings: false, finishPermissionWriter: null }),
+    trae: Object.freeze({ installSurface: 'profile-marker-only', writesSharedSettings: false, finishPermissionWriter: null }),
+});
+// ---------------------------------------------------------------------------
+// Exports
+// ---------------------------------------------------------------------------
+/** The complete set of 15 supported runtimes for config-adapter dispatch. */
+const ALLOWED_CONFIG_RUNTIMES = new Set(Object.keys(REGISTRY));
+/** All valid installSurface values. */
+const INSTALL_SURFACES = Object.freeze([
+    'settings-json',
+    'codex-toml',
+    'copilot-instructions',
+    'cline-rules',
+    'cursor-hooks-json',
+    'profile-marker-only',
+]);
+/**
+ * Resolve the config adapter intent for a given runtime.
+ *
+ * Returns a fresh object each call so callers cannot poison the registry by
+ * mutating the returned value.
+ *
+ * @throws {TypeError} if runtime is not a known supported runtime.
+ */
+function resolveRuntimeConfigIntent(runtime) {
+    if (!Object.hasOwn(REGISTRY, runtime)) {
+        throw new TypeError(`Unknown runtime for config adapter: ${runtime}`);
+    }
+    const entry = REGISTRY[runtime];
+    return {
+        runtime,
+        installSurface: entry.installSurface,
+        writesSharedSettings: entry.writesSharedSettings,
+        finishPermissionWriter: entry.finishPermissionWriter,
+    };
+}
+module.exports = { resolveRuntimeConfigIntent, ALLOWED_CONFIG_RUNTIMES, INSTALL_SURFACES };

package/gsd-core/bin/lib/runtime-homes.cjs

@@ -12,9 +12,9 @@
  * Runtime-specific notes:
  *   hermes  — GSD skills nest under skills/gsd/<skillName>/ (not the flat
  *             skills/<skillName>/ layout used by all other runtimes).
- *   cline   — Rules-based; commands are embedded in .clinerules. Cline does
- *             not use a skills/ directory. getGlobalSkillDir() returns null
- *             for cline so the caller can emit an appropriate warning.
+ *   cline   — Skills-capable since v3.48.0 (#782). SKILL.md files live at
+ *             ~/.cline/skills/<skillName>/SKILL.md (same flat layout as cursor/codex).
+ *             .clinerules is also emitted (rules-based compatibility layer).
  */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
@@ -62,8 +62,15 @@ function resolveAntigravityGlobalDir(opts = {}) {
 /**
  * Return the global config base directory for the given runtime.
  * Respects the same env-var overrides as bin/install.js getGlobalDir().
+ *
+ * @param runtime   - The runtime identifier (e.g. 'claude', 'opencode').
+ * @param explicitDir - If provided and non-empty, returned immediately after
+ *   tilde-expansion, overriding all env-var and default logic. This matches
+ *   the behaviour of bin/install.js getGlobalDir(runtime, explicitDir).
  */
-function getGlobalConfigDir(runtime) {
+function getGlobalConfigDir(runtime, explicitDir) {
+    if (explicitDir)
+        return expandTilde(explicitDir);
     const home = node_os_1.default.homedir();
     const env = process.env;
     switch (runtime) {
@@ -84,7 +91,11 @@ function getGlobalConfigDir(runtime) {
             return env['GROK_AGENTS_HOME'] ? expandTilde(env['GROK_AGENTS_HOME']) : node_path_1.default.join(home, '.agents');
         // ── Copilot (VS Code) ────────────────────────────────────────────────────
         case 'copilot':
-            return env['COPILOT_CONFIG_DIR'] ? expandTilde(env['COPILOT_CONFIG_DIR']) : node_path_1.default.join(home, '.copilot');
+            if (env['COPILOT_CONFIG_DIR'])
+                return expandTilde(env['COPILOT_CONFIG_DIR']);
+            if (env['COPILOT_HOME'])
+                return expandTilde(env['COPILOT_HOME']);
+            return node_path_1.default.join(home, '.copilot');
         // ── Antigravity ──────────────────────────────────────────────────────────
         case 'antigravity':
             return resolveAntigravityGlobalDir({ env, home });
@@ -115,6 +126,8 @@ function getGlobalConfigDir(runtime) {
         case 'opencode': {
             if (env['OPENCODE_CONFIG_DIR'])
                 return expandTilde(env['OPENCODE_CONFIG_DIR']);
+            if (env['OPENCODE_CONFIG'])
+                return node_path_1.default.dirname(expandTilde(env['OPENCODE_CONFIG']));
             if (env['XDG_CONFIG_HOME'])
                 return node_path_1.default.join(expandTilde(env['XDG_CONFIG_HOME']), 'opencode');
             return node_path_1.default.join(home, '.config', 'opencode');
@@ -123,6 +136,8 @@ function getGlobalConfigDir(runtime) {
         case 'kilo': {
             if (env['KILO_CONFIG_DIR'])
                 return expandTilde(env['KILO_CONFIG_DIR']);
+            if (env['KILO_CONFIG'])
+                return node_path_1.default.dirname(expandTilde(env['KILO_CONFIG']));
             if (env['XDG_CONFIG_HOME'])
                 return node_path_1.default.join(expandTilde(env['XDG_CONFIG_HOME']), 'kilo');
             return node_path_1.default.join(home, '.config', 'kilo');
@@ -136,19 +151,25 @@ function getGlobalConfigDir(runtime) {
  * Return the global skills base directory for the given runtime.
  * Most runtimes: <configDir>/skills
  * Hermes: <configDir>/skills/gsd  (nested category layout — #2841)
- * Cline:  null (rules-based, no skills directory)
+ * Cline ≥ v3.48.0: <configDir>/skills  (SKILL.md-based global skills — #782)
  */
 function getGlobalSkillsBase(runtime) {
-    if (runtime === 'cline')
-        return null;
-    const configDir = getGlobalConfigDir(runtime);
-    if (runtime === 'hermes')
+    if (runtime === 'hermes') {
+        const configDir = getGlobalConfigDir(runtime);
         return node_path_1.default.join(configDir, 'skills', 'gsd');
+    }
+    // Kilo Code discovers global skills from ~/.kilo/skills/ (HOME-relative),
+    // independent of the XDG-based config dir (~/.config/kilo) used for commands.
+    // See: https://kilo.ai/docs/customize/skills
+    // "Global skills are located in the `.kilo` directory within your Home
+    //  directory: ~/.kilo/skills/"
+    if (runtime === 'kilo')
+        return node_path_1.default.join(node_os_1.default.homedir(), '.kilo', 'skills');
+    const configDir = getGlobalConfigDir(runtime);
     return node_path_1.default.join(configDir, 'skills');
 }
 /**
  * Return the full path to a specific skill's directory for the given runtime.
- * Returns null for runtimes that don't use a skills directory (cline).
  */
 function getGlobalSkillDir(runtime, skillName) {
     const base = getGlobalSkillsBase(runtime);

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

@@ -153,6 +153,7 @@ function projectManagedHookCommand({ absoluteRunner, scriptPath, runtime = 'gene
 const MANAGED_HOOK_BASENAMES_BY_SURFACE = {
     'settings-json': new Set([
         'gsd-check-update.js',
+        'gsd-config-reload.js',
         'gsd-statusline.js',
         'gsd-context-monitor.js',
         'gsd-prompt-guard.js',
@@ -168,6 +169,7 @@ const MANAGED_HOOK_BASENAMES_BY_SURFACE = {
 const MANAGED_HOOK_COMMAND_BASENAMES_BY_SURFACE = {
     'settings-json': new Set([
         'gsd-check-update.js',
+        'gsd-config-reload.js',
         'gsd-statusline.js',
         'gsd-context-monitor.js',
         'gsd-prompt-guard.js',
@@ -188,6 +190,10 @@ const MANAGED_HOOK_COMMAND_BASENAMES_BY_SURFACE = {
         // reconcileCodexHooksJsonSessionStart can replace stale node-runner commands
         // with the .cmd shim on reinstall (and vice-versa on cross-platform moves).
         'gsd-check-update.cmd',
+        // #772: context-monitor is now registered for Codex SubagentStart/Stop/PostToolUse.
+        'gsd-context-monitor.js',
+        // #772: Windows .cmd shim for gsd-context-monitor — same #3426 pattern.
+        'gsd-context-monitor.cmd',
     ]),
 };
 const LEGACY_MANAGED_HOOK_ALIASES_BY_SURFACE = {