@opengsd/gsd-core 1.2.0 → 1.3.0

package/commands/gsd/review.md

@@ -1,7 +1,7 @@
 ---
 name: gsd:review
 description: Request cross-AI peer review of phase plans from external AI CLIs
-argument-hint: "--phase N [--gemini] [--claude] [--codex] [--opencode] [--qwen] [--cursor] [--all]"
+argument-hint: "--phase N [--gemini] [--claude] [--codex] [--opencode] [--qwen] [--cursor] [--agy] [--all]"
 allowed-tools:
   - Read
   - Write
@@ -20,7 +20,7 @@ planning via /gsd:plan-phase --reviews.
 </objective>
 
 <execution_context>
-@~/.claude/get-shit-done/workflows/review.md
+@~/.claude/gsd-core/workflows/review.md
 </execution_context>
 
 <context>
@@ -33,6 +33,7 @@ Phase number: extracted from $ARGUMENTS (required)
 - `--opencode` — Include OpenCode review (uses model from user's OpenCode config)
 - `--qwen` — Include Qwen Code review (Alibaba Qwen models)
 - `--cursor` — Include Cursor agent review
+- `--agy` / `--antigravity` — Include Antigravity CLI review
 - `--all` — Include all available CLIs
 </context>
 

package/commands/gsd/secure-phase.md

@@ -23,7 +23,7 @@ Output: updated SECURITY.md.
 </objective>
 
 <execution_context>
-@~/.claude/get-shit-done/workflows/secure-phase.md
+@~/.claude/gsd-core/workflows/secure-phase.md
 </execution_context>
 
 <context>

package/commands/gsd/settings.md

@@ -21,7 +21,7 @@ Routes to the settings workflow which handles:
 </objective>
 
 <execution_context>
-@~/.claude/get-shit-done/workflows/settings.md
+@~/.claude/gsd-core/workflows/settings.md
 </execution_context>
 
 <process>

package/commands/gsd/ship.md

@@ -18,7 +18,7 @@ Closes the plan → execute → verify → ship loop.
 </objective>
 
 <execution_context>
-@~/.claude/get-shit-done/workflows/ship.md
+@~/.claude/gsd-core/workflows/ship.md
 </execution_context>
 
-Execute the ship workflow from @~/.claude/get-shit-done/workflows/ship.md end-to-end.
+Execute the ship workflow from @~/.claude/gsd-core/workflows/ship.md end-to-end.

package/commands/gsd/sketch.md

@@ -30,13 +30,13 @@ Does not require prior new-project setup — auto-creates `.planning/sketches/`
 </objective>
 
 <execution_context>
-@~/.claude/get-shit-done/workflows/sketch.md
-@~/.claude/get-shit-done/workflows/sketch-wrap-up.md
-@~/.claude/get-shit-done/references/ui-brand.md
-@~/.claude/get-shit-done/references/sketch-theme-system.md
-@~/.claude/get-shit-done/references/sketch-interactivity.md
-@~/.claude/get-shit-done/references/sketch-tooling.md
-@~/.claude/get-shit-done/references/sketch-variant-patterns.md
+@~/.claude/gsd-core/workflows/sketch.md
+@~/.claude/gsd-core/workflows/sketch-wrap-up.md
+@~/.claude/gsd-core/references/ui-brand.md
+@~/.claude/gsd-core/references/sketch-theme-system.md
+@~/.claude/gsd-core/references/sketch-interactivity.md
+@~/.claude/gsd-core/references/sketch-tooling.md
+@~/.claude/gsd-core/references/sketch-variant-patterns.md
 </execution_context>
 
 <runtime_note>

package/commands/gsd/spec-phase.md

@@ -29,8 +29,8 @@ Clarify phase requirements through structured Socratic questioning with quantita
 </objective>
 
 <execution_context>
-@~/.claude/get-shit-done/workflows/spec-phase.md
-@~/.claude/get-shit-done/templates/spec.md
+@~/.claude/gsd-core/workflows/spec-phase.md
+@~/.claude/gsd-core/templates/spec.md
 </execution_context>
 
 <runtime_note>

package/commands/gsd/spike.md

@@ -30,9 +30,9 @@ Does not require prior new-project setup — auto-creates `.planning/spikes/` if
 </objective>
 
 <execution_context>
-@~/.claude/get-shit-done/workflows/spike.md
-@~/.claude/get-shit-done/workflows/spike-wrap-up.md
-@~/.claude/get-shit-done/references/ui-brand.md
+@~/.claude/gsd-core/workflows/spike.md
+@~/.claude/gsd-core/workflows/spike-wrap-up.md
+@~/.claude/gsd-core/references/ui-brand.md
 </execution_context>
 
 <runtime_note>

package/commands/gsd/stats.md

@@ -11,7 +11,7 @@ Display comprehensive project statistics including phase progress, plan executio
 </objective>
 
 <execution_context>
-@~/.claude/get-shit-done/workflows/stats.md
+@~/.claude/gsd-core/workflows/stats.md
 </execution_context>
 
 <process>

package/commands/gsd/surface.md

@@ -37,7 +37,7 @@ Parse the first token of $ARGUMENTS:
 ## list / status
 
 Call `listSurface(runtimeConfigDir, manifest, CLUSTERS)` from
-`get-shit-done/bin/lib/surface.cjs`. Display:
+`gsd-core/bin/lib/surface.cjs`. Display:
 
 ```
 Enabled (N skills, ~T tokens):
@@ -144,12 +144,12 @@ All paths can be overridden by reading the `CLAUDE_CONFIG_DIR` env var if set.
 
 - Unknown cluster name → list valid cluster names, exit without writing.
 - Unknown profile name → list known profiles (`core`, `standard`, `full`), exit.
-- Missing `surface.cjs` → prompt: "Run `npm i -g get-shit-done` to reinstall GSD."
+- Missing `surface.cjs` → prompt: "Run `npm i -g gsd-core` to reinstall GSD."
 
 <execution_context>
 Surface state file: `~/.claude/.gsd-surface.json`
 Install profile marker: `~/.claude/.gsd-profile`
 Skill dirs: `~/.claude/skills/gsd-*/`
-Engine module: `~/.claude/get-shit-done/bin/lib/surface.cjs`
-Cluster definitions: `~/.claude/get-shit-done/bin/lib/clusters.cjs`
+Engine module: `~/.claude/gsd-core/bin/lib/surface.cjs`
+Cluster definitions: `~/.claude/gsd-core/bin/lib/clusters.cjs`
 </execution_context>

package/commands/gsd/thread.md

@@ -16,7 +16,7 @@ doesn't belong to any specific phase.
 </objective>
 
 <execution_context>
-@~/.claude/get-shit-done/workflows/thread.md
+@~/.claude/gsd-core/workflows/thread.md
 </execution_context>
 
 <process>

package/commands/gsd/ui-phase.md

@@ -21,8 +21,8 @@ Flow: Validate → Research UI → Verify UI-SPEC → Done
 </objective>
 
 <execution_context>
-@~/.claude/get-shit-done/workflows/ui-phase.md
-@~/.claude/get-shit-done/references/ui-brand.md
+@~/.claude/gsd-core/workflows/ui-phase.md
+@~/.claude/gsd-core/references/ui-brand.md
 </execution_context>
 
 <context>

package/commands/gsd/ui-review.md

@@ -19,8 +19,8 @@ Output: {phase_num}-UI-REVIEW.md
 </objective>
 
 <execution_context>
-@~/.claude/get-shit-done/workflows/ui-review.md
-@~/.claude/get-shit-done/references/ui-brand.md
+@~/.claude/gsd-core/workflows/ui-review.md
+@~/.claude/gsd-core/references/ui-brand.md
 </execution_context>
 
 <context>

package/commands/gsd/ultraplan-phase.md

@@ -21,8 +21,8 @@ Requirements: Claude Code v2.1.91+, claude.ai account, GitHub repository.
 </objective>
 
 <execution_context>
-@~/.claude/get-shit-done/workflows/ultraplan-phase.md
-@~/.claude/get-shit-done/references/ui-brand.md
+@~/.claude/gsd-core/workflows/ultraplan-phase.md
+@~/.claude/gsd-core/references/ui-brand.md
 </execution_context>
 
 <context>

package/commands/gsd/undo.md

@@ -21,9 +21,9 @@ Three modes:
 </objective>
 
 <execution_context>
-@~/.claude/get-shit-done/workflows/undo.md
-@~/.claude/get-shit-done/references/ui-brand.md
-@~/.claude/get-shit-done/references/gate-prompts.md
+@~/.claude/gsd-core/workflows/undo.md
+@~/.claude/gsd-core/references/ui-brand.md
+@~/.claude/gsd-core/references/gate-prompts.md
 </execution_context>
 
 <context>

package/commands/gsd/update.md

@@ -25,7 +25,7 @@ Routes to the update workflow which handles:
 </objective>
 
 <execution_context>
-@~/.claude/get-shit-done/workflows/update.md
+@~/.claude/gsd-core/workflows/update.md
 </execution_context>
 
 <flags>
@@ -43,6 +43,6 @@ Parse the first token of $ARGUMENTS:
 </process>
 
 <execution_context_extended>
-@~/.claude/get-shit-done/workflows/sync-skills.md
-@~/.claude/get-shit-done/workflows/reapply-patches.md
+@~/.claude/gsd-core/workflows/sync-skills.md
+@~/.claude/gsd-core/workflows/reapply-patches.md
 </execution_context_extended>

package/commands/gsd/validate-phase.md

@@ -23,7 +23,7 @@ Output: updated VALIDATION.md + generated test files.
 </objective>
 
 <execution_context>
-@~/.claude/get-shit-done/workflows/validate-phase.md
+@~/.claude/gsd-core/workflows/validate-phase.md
 </execution_context>
 
 <context>

package/commands/gsd/verify-work.md

@@ -21,8 +21,8 @@ Output: {phase_num}-UAT.md tracking all test results. If issues found: diagnosed
 </objective>
 
 <execution_context>
-@~/.claude/get-shit-done/workflows/verify-work.md
-@~/.claude/get-shit-done/templates/UAT.md
+@~/.claude/gsd-core/workflows/verify-work.md
+@~/.claude/gsd-core/templates/UAT.md
 </execution_context>
 
 <context>

package/commands/gsd/workspace.md

@@ -29,10 +29,10 @@ Mode routing:
 </routing>
 
 <execution_context>
-@~/.claude/get-shit-done/workflows/new-workspace.md
-@~/.claude/get-shit-done/workflows/list-workspaces.md
-@~/.claude/get-shit-done/workflows/remove-workspace.md
-@~/.claude/get-shit-done/references/ui-brand.md
+@~/.claude/gsd-core/workflows/new-workspace.md
+@~/.claude/gsd-core/workflows/list-workspaces.md
+@~/.claude/gsd-core/workflows/remove-workspace.md
+@~/.claude/gsd-core/references/ui-brand.md
 </execution_context>
 
 <context>

package/{get-shit-done → gsd-core}/bin/check-latest-version.cjs

@@ -7,7 +7,7 @@
  * The /gsd-update workflow's check_latest_version step was previously
  * prescribed in LLM-driven prose ("run `npm view gsd-core
  * version`"). The executing model could shortcut the prescription and
- * invent npm queries against wrong-shaped names (`@get-shit-done/cli`,
+ * invent npm queries against wrong-shaped names (`@gsd-core/cli`,
  * `get-shit-done-cli`, `gsd`), all of which 404 or — worse — return an
  * unrelated typosquat package.
  *

package/{get-shit-done → gsd-core}/bin/gsd-tools.cjs

@@ -46,6 +46,8 @@
  *   roadmap analyze                    Full roadmap parse with disk status
  *   roadmap update-plan-progress <N>   Update progress table row from disk (PLAN vs SUMMARY counts)
  *   roadmap annotate-dependencies <N>  Add wave dependency notes + cross-cutting constraints to ROADMAP.md
+ *   roadmap validate                   Validate phase ID convention compliance
+ *   roadmap upgrade [--apply] --convention milestone-prefixed  Migrate phase IDs to M-NN convention
  *
  * Requirements Operations:
  *   requirements mark-complete <ids>   Mark requirement IDs as complete in REQUIREMENTS.md
@@ -169,7 +171,12 @@
 const fs = require('fs');
 const path = require('path');
 const core = require('./lib/core.cjs');
-const { error, findProjectRoot, ERROR_REASON } = core;
+const { error, ERROR_REASON } = core;
+// Resolve findProjectRoot lazily at call time rather than binding it at module
+// load. It is a re-export from core.cjs (sourced from project-root.cjs); a
+// call-time lookup is robust against any require/load-ordering edge where the
+// re-export isn't bound yet when this entrypoint is first required (#604).
+const findProjectRoot = (...args) => core.findProjectRoot(...args);
 const { getActiveWorkstream } = require('./lib/planning-workspace.cjs');
 const { resolveActiveWorkstream, applyResolvedWorkstreamEnv } = require('./lib/active-workstream-store.cjs');
 const state = require('./lib/state.cjs');
@@ -368,11 +375,11 @@ async function main() {
   const TOP_LEVEL_USAGE = 'Usage: gsd-tools <command> [args] [--raw] [--pick <field>] [--cwd <path>] [--ws <name>] [--json-errors]\n' +
     'Commands: agent, agent-skills, audit-open, audit-uat, check, check-commit, commit, commit-to-subrepo, ' +
     'config-ensure-section, config-get, config-new-project, config-path, config-set, migrate-config, ' +
-    'current-timestamp, detect-custom-files, docs-init, extract-messages, find-phase, ' +
+    'current-timestamp, detect-custom-files, docs-init, effort, extract-messages, find-phase, ' +
     'from-gsd2, frontmatter, gap-analysis, generate-claude-md, generate-claude-profile, ' +
     'generate-dev-preferences, generate-slug, graphify, history-digest, init, intel, ' +
     'learnings, list-todos, milestone, phase, phase-plan-index, phases, profile-questionnaire, ' +
-    'profile-sample, progress, prompt-budget, requirements, resolve-model, roadmap, scaffold, state, ' +
+    'profile-sample, progress, prompt-budget, requirements, resolve-granularity, resolve-model, roadmap, scaffold, state, ' +
     'task, template, validate, verify, verify-path-exists, verify-summary, workstream, worktree\n\n' +
     'Global flags:\n' +
     '  --raw              Emit raw output without post-processing\n' +
@@ -539,6 +546,11 @@ async function runCommand(command, args, cwd, raw, defaultValue, originalCommand
       break;
     }
 
+    case 'resolve-granularity': {
+      commands.cmdResolveGranularity(cwd, args[1], raw);
+      break;
+    }
+
     case 'resolve-execution': {
       // Deterministic flag parsing: consume --flag <value> pairs first,
       // then the AGENT is the single remaining positional.
@@ -1400,7 +1412,7 @@ async function runCommand(command, args, cwd, raw, defaultValue, originalCommand
       // GSD-managed directories to scan for user-added files.
       // These are the directories the installer wipes on update.
       const GSD_MANAGED_DIRS = [
-        'get-shit-done',
+        'gsd-core',
         'agents',
         path.join('commands', 'gsd'),
         'hooks',
@@ -1651,6 +1663,40 @@ async function runCommand(command, args, cwd, raw, defaultValue, originalCommand
       break;
     }
 
+    case 'effort': {
+      const subcommand = args[1];
+      if (subcommand === 'sync') {
+        const effortSyncArgs = args.slice(2);
+        let dryRun = true;
+        let effortSyncConfigDir;
+        let effortSyncRuntime;
+        for (let i = 0; i < effortSyncArgs.length; i++) {
+          const a = effortSyncArgs[i];
+          if (a === '--apply') { dryRun = false; continue; }
+          if (a === '--dry-run') { dryRun = true; continue; }
+          if (a.startsWith('--config-dir=')) { effortSyncConfigDir = a.slice('--config-dir='.length); continue; }
+          if (a === '--config-dir') {
+            const v = effortSyncArgs[i + 1];
+            if (!v || v.startsWith('--')) error('Missing value for --config-dir', ERROR_REASON.USAGE);
+            effortSyncConfigDir = v; i++; continue;
+          }
+          if (a.startsWith('--runtime=')) { effortSyncRuntime = a.slice('--runtime='.length); continue; }
+          if (a === '--runtime') {
+            const v = effortSyncArgs[i + 1];
+            if (!v || v.startsWith('--')) error('Missing value for --runtime', ERROR_REASON.USAGE);
+            effortSyncRuntime = v; i++; continue;
+          }
+          if (a === '--raw') continue;
+          if (a.startsWith('-')) error(`Unknown flag for effort sync: ${a}`, ERROR_REASON.USAGE);
+          error(`effort sync takes no positional arguments; got: ${a}`, ERROR_REASON.USAGE);
+        }
+        commands.cmdEffortSync(cwd, raw, { dryRun, configDir: effortSyncConfigDir, runtime: effortSyncRuntime });
+      } else {
+        error('Unknown effort subcommand. Available: sync', ERROR_REASON.SDK_UNKNOWN_COMMAND);
+      }
+      break;
+    }
+
     default: {
       // #3243: if the caller passed a dotted form (e.g. "foo.bar"), the shim
       // above split it so `command` here is the head ("foo"). Use

package/gsd-core/bin/lib/active-workstream-store.cjs

@@ -0,0 +1,291 @@
+"use strict";
+/**
+ * Active Workstream Pointer Store Module
+ *
+ * Owns active workstream source precedence, session identity, and pointer IO:
+ * CLI --ws > GSD_WORKSTREAM env > stored active workstream pointer.
+ *
+ * ADR-457 build-at-publish: the hand-written bin/lib/active-workstream-store.cjs
+ * collapsed to a TypeScript source of truth. Behaviour is preserved
+ * byte-for-behaviour from the prior hand-written .cjs; only types are added.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_crypto_1 = __importDefault(require("node:crypto"));
+const shell_command_projection_cjs_1 = require("./shell-command-projection.cjs");
+const workstream_name_policy_cjs_1 = require("./workstream-name-policy.cjs");
+const WORKSTREAM_SESSION_ENV_KEYS = [
+    'GSD_SESSION_KEY',
+    'CODEX_THREAD_ID',
+    'CLAUDE_SESSION_ID',
+    'CLAUDE_CODE_SSE_PORT',
+    'OPENCODE_SESSION_ID',
+    'GEMINI_SESSION_ID',
+    'CURSOR_SESSION_ID',
+    'WINDSURF_SESSION_ID',
+    'TERM_SESSION_ID',
+    'WT_SESSION',
+    'TMUX_PANE',
+    'ZELLIJ_SESSION_NAME',
+];
+let cachedControllingTtyToken = null;
+let didProbeControllingTtyToken = false;
+function planningRoot(cwd) {
+    return node_path_1.default.join(cwd, '.planning');
+}
+function validateWorkstreamName(name) {
+    return (0, workstream_name_policy_cjs_1.isValidActiveWorkstreamName)(name);
+}
+function sanitizeWorkstreamSessionToken(value) {
+    if (value === null || value === undefined)
+        return null;
+    const raw = typeof value === 'string' ? value : `${value}`;
+    const token = raw.trim().replace(/[^a-zA-Z0-9._-]+/g, '_').replace(/^_+|_+$/g, '');
+    return token ? token.slice(0, 160) : null;
+}
+function probeControllingTtyToken() {
+    if (didProbeControllingTtyToken)
+        return cachedControllingTtyToken;
+    didProbeControllingTtyToken = true;
+    if (!(process.stdin && process.stdin.isTTY)) {
+        return cachedControllingTtyToken;
+    }
+    const ttyPath = (0, shell_command_projection_cjs_1.probeTty)();
+    if (ttyPath) {
+        const token = sanitizeWorkstreamSessionToken(ttyPath.replace(/^\/dev\//, ''));
+        if (token)
+            cachedControllingTtyToken = `tty-${token}`;
+    }
+    return cachedControllingTtyToken;
+}
+function getControllingTtyToken() {
+    for (const envKey of ['TTY', 'SSH_TTY']) {
+        const token = sanitizeWorkstreamSessionToken(process.env[envKey]);
+        if (token)
+            return `tty-${token.replace(/^dev_/, '')}`;
+    }
+    return probeControllingTtyToken();
+}
+function getWorkstreamSessionKey() {
+    for (const envKey of WORKSTREAM_SESSION_ENV_KEYS) {
+        const raw = process.env[envKey];
+        const token = sanitizeWorkstreamSessionToken(raw);
+        if (token)
+            return `${envKey.toLowerCase().replace(/[^a-z0-9]+/g, '-')}-${token}`;
+    }
+    return getControllingTtyToken();
+}
+function getSessionScopedWorkstreamFile(cwd, fixedSessionKey) {
+    const sessionKey = fixedSessionKey || getWorkstreamSessionKey();
+    if (!sessionKey)
+        return null;
+    let planningAbs;
+    try {
+        planningAbs = node_fs_1.default.realpathSync.native(planningRoot(cwd));
+    }
+    catch {
+        planningAbs = node_path_1.default.resolve(planningRoot(cwd));
+    }
+    const projectId = node_crypto_1.default
+        .createHash('sha1')
+        .update(planningAbs)
+        .digest('hex')
+        .slice(0, 16);
+    const dirPath = node_path_1.default.join(node_os_1.default.tmpdir(), 'gsd-workstream-sessions', projectId);
+    return {
+        sessionKey,
+        dirPath,
+        filePath: node_path_1.default.join(dirPath, sessionKey),
+    };
+}
+function createSharedPointerAdapter(cwd) {
+    const filePath = node_path_1.default.join(planningRoot(cwd), 'active-workstream');
+    return {
+        read() {
+            const raw = (0, shell_command_projection_cjs_1.platformReadSync)(filePath);
+            return raw ? raw.trim() || null : null;
+        },
+        write(name) {
+            (0, shell_command_projection_cjs_1.platformWriteSync)(filePath, name + '\n');
+        },
+        clear() {
+            try {
+                node_fs_1.default.unlinkSync(filePath);
+            }
+            catch { }
+        },
+    };
+}
+function createSessionScopedPointerAdapter(cwd, fixedSessionKey) {
+    const scoped = getSessionScopedWorkstreamFile(cwd, fixedSessionKey);
+    if (!scoped)
+        return null;
+    return {
+        read() {
+            const raw = (0, shell_command_projection_cjs_1.platformReadSync)(scoped.filePath);
+            return raw ? raw.trim() || null : null;
+        },
+        write(name) {
+            (0, shell_command_projection_cjs_1.platformEnsureDir)(scoped.dirPath);
+            (0, shell_command_projection_cjs_1.platformWriteSync)(scoped.filePath, name + '\n');
+        },
+        clear() {
+            try {
+                node_fs_1.default.unlinkSync(scoped.filePath);
+            }
+            catch { }
+            try {
+                const remaining = node_fs_1.default.readdirSync(scoped.dirPath);
+                if (remaining.length === 0) {
+                    node_fs_1.default.rmdirSync(scoped.dirPath);
+                }
+            }
+            catch { }
+        },
+    };
+}
+function createMemoryPointerAdapter(initialName = null) {
+    let value = initialName;
+    return {
+        read() {
+            return value;
+        },
+        write(name) {
+            value = name;
+        },
+        clear() {
+            value = null;
+        },
+    };
+}
+function pickActiveWorkstreamAdapter(cwd, opts = {}) {
+    if (opts.activeWorkstreamAdapter) {
+        return opts.activeWorkstreamAdapter;
+    }
+    const sessionKey = getWorkstreamSessionKey();
+    if (sessionKey) {
+        if (opts.activeWorkstreamAdapters && opts.activeWorkstreamAdapters.session) {
+            return opts.activeWorkstreamAdapters.session;
+        }
+        return createSessionScopedPointerAdapter(cwd, sessionKey);
+    }
+    if (opts.activeWorkstreamAdapters && opts.activeWorkstreamAdapters.shared) {
+        return opts.activeWorkstreamAdapters.shared;
+    }
+    return createSharedPointerAdapter(cwd);
+}
+function getActiveWorkstream(cwd, opts = {}) {
+    const adapter = pickActiveWorkstreamAdapter(cwd, opts);
+    if (!adapter)
+        return null;
+    const name = adapter.read();
+    if (!name || !validateWorkstreamName(name)) {
+        adapter.clear();
+        return null;
+    }
+    const wsDir = node_path_1.default.join(planningRoot(cwd), 'workstreams', name);
+    if (!node_fs_1.default.existsSync(wsDir)) {
+        adapter.clear();
+        return null;
+    }
+    return name;
+}
+function setActiveWorkstream(cwd, name, opts = {}) {
+    const adapter = pickActiveWorkstreamAdapter(cwd, opts);
+    if (!adapter)
+        return;
+    if (!name) {
+        adapter.clear();
+        return;
+    }
+    if (!validateWorkstreamName(name)) {
+        throw new Error('Invalid workstream name: must be alphanumeric, hyphens, underscores, or dots');
+    }
+    const wsDir = node_path_1.default.join(planningRoot(cwd), 'workstreams', name);
+    (0, shell_command_projection_cjs_1.platformEnsureDir)(wsDir);
+    adapter.write(name);
+}
+function clearActiveWorkstream(cwd, opts = {}) {
+    const adapter = pickActiveWorkstreamAdapter(cwd, opts);
+    if (!adapter)
+        return;
+    adapter.clear();
+}
+function parseCliWorkstream(args) {
+    const wsEqArg = args.find((arg) => arg.startsWith('--ws='));
+    const wsIdx = args.indexOf('--ws');
+    if (wsEqArg) {
+        const value = wsEqArg.slice('--ws='.length).trim();
+        if (!value)
+            throw new Error('Missing value for --ws');
+        return {
+            value,
+            source: 'cli',
+            args: args.filter((arg) => arg !== wsEqArg),
+        };
+    }
+    if (wsIdx !== -1) {
+        const value = args[wsIdx + 1];
+        if (!value || value.startsWith('--'))
+            throw new Error('Missing value for --ws');
+        return {
+            value,
+            source: 'cli',
+            args: args.filter((_, idx) => idx !== wsIdx && idx !== wsIdx + 1),
+        };
+    }
+    return {
+        value: null,
+        source: null,
+        args: args.slice(),
+    };
+}
+function resolveActiveWorkstream(cwd, args, env = process.env, deps = {}) {
+    const parsed = parseCliWorkstream(args);
+    const getStored = deps.getStored || ((dir) => getActiveWorkstream(dir, deps));
+    let ws = null;
+    let source = 'none';
+    if (parsed.value) {
+        ws = parsed.value;
+        source = parsed.source ?? 'cli';
+    }
+    else if (env && typeof env['GSD_WORKSTREAM'] === 'string' && env['GSD_WORKSTREAM'].trim()) {
+        ws = env['GSD_WORKSTREAM'].trim();
+        source = 'env';
+    }
+    else {
+        ws = getStored(cwd) || null;
+        source = ws ? 'store' : 'none';
+    }
+    if (ws && !validateWorkstreamName(ws)) {
+        throw new Error('Invalid workstream name: must be alphanumeric, hyphens, underscores, or dots');
+    }
+    return {
+        ws,
+        source,
+        args: parsed.args,
+    };
+}
+function applyResolvedWorkstreamEnv(resolution, env = process.env) {
+    if (!resolution || !resolution.ws)
+        return;
+    env['GSD_WORKSTREAM'] = resolution.ws;
+}
+module.exports = {
+    validateWorkstreamName,
+    getWorkstreamSessionKey,
+    createSharedPointerAdapter,
+    createSessionScopedPointerAdapter,
+    createMemoryPointerAdapter,
+    pickActiveWorkstreamAdapter,
+    getActiveWorkstream,
+    setActiveWorkstream,
+    clearActiveWorkstream,
+    parseCliWorkstream,
+    resolveActiveWorkstream,
+    applyResolvedWorkstreamEnv,
+};