golem15/msd-core
4
0
Fork 0
Code Issues 1 Pull Requests Actions 2 Packages Projects Releases Wiki Activity

feat: add GSD_PROJECT env var for multi-project workspace support

Browse Source 
Adds project-scoped planning directory resolution via GSD_PROJECT
environment variable. When set, planningDir() routes to
.planning/{project}/ instead of .planning/, enabling multiple
independent projects to coexist under a single .planning/ root.

Use case: shared workspaces (e.g., Obsidian vaults, monorepo knowledge
bases) where multiple projects are managed from one directory. Each
project keeps its own config.json, ROADMAP.md, STATE.md, and phases/
under .planning/{project-name}/.

GSD_PROJECT follows the same pattern as GSD_WORKSTREAM and can be
combined with it: .planning/{project}/workstreams/{ws}/

Also updates loadConfig() to read config.json from the project-scoped
directory when GSD_PROJECT is active.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Ned Malki
2026-03-30 16:12:05 +07:00
parent 1421dc07bc
commit 3b0a7560e5
1 changed files with 22 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

30
get-shit-done/bin/lib/core.cjs
View File

@@ -195,7 +195,7 @@ function safeReadFile(filePath) {
} }
function loadConfig(cwd) { function loadConfig(cwd) {
const configPath = path.join(cwd, '.planning', 'config.json'); const configPath = path.join(planningDir(cwd), 'config.json');
const defaults = { const defaults = {
model_profile: 'balanced', model_profile: 'balanced',
commit_docs: true, commit_docs: true,
@@ -540,20 +540,34 @@ function withPlanningLock(cwd, fn) {
} }
/** /**
* Get the .planning directory path, workstream-aware. * Get the .planning directory path, project- and workstream-aware.
* When a workstream is active (via explicit ws arg or GSD_WORKSTREAM env var), *
* returns `.planning/workstreams/{ws}/`. Otherwise returns `.planning/`. * Resolution order:
* 1. If GSD_PROJECT is set (env var or explicit `project` arg), routes to
* `.planning/{project}/` — supports multi-project workspaces where several
* independent projects share a single `.planning/` root directory (e.g.,
* an Obsidian vault or monorepo knowledge base used as a command center).
* 2. If GSD_WORKSTREAM is set, routes to `.planning/workstreams/{ws}/`.
* 3. Otherwise returns `.planning/`.
*
* GSD_PROJECT and GSD_WORKSTREAM can be combined:
* `.planning/{project}/workstreams/{ws}/`
* *
* @param {string} cwd - project root * @param {string} cwd - project root
* @param {string} [ws] - explicit workstream name; if omitted, checks GSD_WORKSTREAM env var * @param {string} [ws] - explicit workstream name; if omitted, checks GSD_WORKSTREAM env var
* @param {string} [project] - explicit project name; if omitted, checks GSD_PROJECT env var
*/ */
function planningDir(cwd, ws) { function planningDir(cwd, ws, project) {
if (project === undefined) project = process.env.GSD_PROJECT || null;
if (ws === undefined) ws = process.env.GSD_WORKSTREAM || null; if (ws === undefined) ws = process.env.GSD_WORKSTREAM || null;
if (!ws) return path.join(cwd, '.planning');
return path.join(cwd, '.planning', 'workstreams', ws); let base = path.join(cwd, '.planning');
if (project) base = path.join(base, project);
if (ws) base = path.join(base, 'workstreams', ws);
return base;
} }
/** Always returns the root .planning/ path, ignoring workstreams. For shared resources. */ /** Always returns the root .planning/ path, ignoring workstreams and projects. For shared resources. */
function planningRoot(cwd) { function planningRoot(cwd) {
return path.join(cwd, '.planning'); return path.join(cwd, '.planning');
} }