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

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

@@ -171,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');
@@ -374,7 +379,7 @@ async function main() {
     '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' +
@@ -541,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.
@@ -1402,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',

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,
+};