@bhargavvc/sdd-cc 1.30.1 → 1.42.3

package/sdk/dist/query/websearch.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Web search query handler — Brave Search API integration.
+ *
+ * Provides web search for researcher agents. Returns { available: false }
+ * gracefully when BRAVE_API_KEY is missing so agents can fall back to
+ * built-in WebSearch tools.
+ *
+ * @example
+ * ```typescript
+ * import { websearch } from './websearch.js';
+ *
+ * await websearch(['typescript generics'], '/project');
+ * // { data: { available: true, query: 'typescript generics', count: 10, results: [...] } }
+ * ```
+ */
+import type { QueryHandler } from './utils.js';
+/**
+ * Search the web via Brave Search API.
+ * Requires BRAVE_API_KEY env var.
+ *
+ * Args: query [--limit N] [--freshness day|week|month]
+ */
+export declare const websearch: QueryHandler;
+//# sourceMappingURL=websearch.d.ts.map

package/sdk/dist/query/websearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websearch.d.ts","sourceRoot":"","sources":["../../src/query/websearch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,YAyDvB,CAAC"}

package/sdk/dist/query/websearch.js

@@ -0,0 +1,68 @@
+/**
+ * Web search query handler — Brave Search API integration.
+ *
+ * Provides web search for researcher agents. Returns { available: false }
+ * gracefully when BRAVE_API_KEY is missing so agents can fall back to
+ * built-in WebSearch tools.
+ *
+ * @example
+ * ```typescript
+ * import { websearch } from './websearch.js';
+ *
+ * await websearch(['typescript generics'], '/project');
+ * // { data: { available: true, query: 'typescript generics', count: 10, results: [...] } }
+ * ```
+ */
+/**
+ * Search the web via Brave Search API.
+ * Requires BRAVE_API_KEY env var.
+ *
+ * Args: query [--limit N] [--freshness day|week|month]
+ */
+export const websearch = async (args) => {
+    const apiKey = process.env.BRAVE_API_KEY;
+    if (!apiKey) {
+        return { data: { available: false, reason: 'BRAVE_API_KEY not set' } };
+    }
+    const query = args[0];
+    if (!query) {
+        return { data: { available: false, error: 'Query required' } };
+    }
+    const limitIdx = args.indexOf('--limit');
+    const freshnessIdx = args.indexOf('--freshness');
+    const limit = limitIdx !== -1 ? parseInt(args[limitIdx + 1], 10) : 10;
+    const freshness = freshnessIdx !== -1 ? args[freshnessIdx + 1] : null;
+    const params = new URLSearchParams({
+        q: query,
+        count: String(limit),
+        country: 'us',
+        search_lang: 'en',
+        text_decorations: 'false',
+    });
+    if (freshness)
+        params.set('freshness', freshness);
+    try {
+        const response = await fetch(`https://api.search.brave.com/res/v1/web/search?${params}`, {
+            headers: {
+                'Accept': 'application/json',
+                'X-Subscription-Token': apiKey,
+            },
+        });
+        if (!response.ok) {
+            return { data: { available: false, error: `API error: ${response.status}` } };
+        }
+        const body = await response.json();
+        const results = (body.web?.results || []).map(r => ({
+            title: r.title,
+            url: r.url,
+            description: r.description,
+            age: r.age || null,
+        }));
+        return { data: { available: true, query, count: results.length, results } };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { data: { available: false, error: msg } };
+    }
+};
+//# sourceMappingURL=websearch.js.map

package/sdk/dist/query/websearch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websearch.js","sourceRoot":"","sources":["../../src/query/websearch.ts"],"names":[],"mappings":"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"}

package/sdk/dist/query/workspace.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Workspace-aware state resolution — scopes .planning/ paths to a
+ * SDD_WORKSTREAM or SDD_PROJECT environment context.
+ *
+ * Port of planningDir() workspace logic from sdd/bin/lib/core.cjs
+ * (line 669+). Provides WorkspaceContext reading and validated path scoping.
+ *
+ * Security: workspace names are validated to reject path traversal (T-14-05).
+ *
+ * @example
+ * ```typescript
+ * import { resolveWorkspaceContext, workspacePlanningPaths } from './workspace.js';
+ *
+ * const ctx = resolveWorkspaceContext();
+ * // { workstream: 'backend', project: null }
+ *
+ * const paths = workspacePlanningPaths('/my/project', ctx);
+ * // paths.state → '/my/project/.planning/workstreams/backend/STATE.md'
+ * ```
+ */
+export interface PlanningPaths {
+    planning: string;
+    state: string;
+    roadmap: string;
+    project: string;
+    config: string;
+    phases: string;
+    requirements: string;
+}
+/**
+ * Resolved workspace context from environment variables.
+ */
+export interface WorkspaceContext {
+    /** Active workstream name (from SDD_WORKSTREAM env var), or null */
+    workstream: string | null;
+    /** Active project name (from SDD_PROJECT env var), or null */
+    project: string | null;
+}
+/**
+ * Read SDD_WORKSTREAM and SDD_PROJECT environment variables.
+ *
+ * Returns a WorkspaceContext with null values when the env vars are not set.
+ *
+ * @returns Resolved workspace context
+ */
+export declare function resolveWorkspaceContext(): WorkspaceContext;
+/**
+ * Return PlanningPaths scoped to the active workspace or project.
+ *
+ * When context has a workstream set: base = .planning/workstreams/<ws>/
+ * When context has a project set: base = .planning/<project>/
+ * When context is null or empty: base = .planning/ (default)
+ *
+ * Workspace and project names are validated before path construction.
+ *
+ * @param projectDir - Absolute project root path
+ * @param context - Optional workspace context (defaults to no scoping)
+ * @returns PlanningPaths scoped to the active workspace
+ * @throws SDDError if workspace/project name fails validation
+ */
+export declare function workspacePlanningPaths(projectDir: string, context?: WorkspaceContext): PlanningPaths;
+//# sourceMappingURL=workspace.d.ts.map

package/sdk/dist/query/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/query/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAQD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,8DAA8D;IAC9D,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAuCD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,IAAI,gBAAgB,CAK1D;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,gBAAgB,GACzB,aAAa,CAwBf"}

package/sdk/dist/query/workspace.js

@@ -0,0 +1,104 @@
+/**
+ * Workspace-aware state resolution — scopes .planning/ paths to a
+ * SDD_WORKSTREAM or SDD_PROJECT environment context.
+ *
+ * Port of planningDir() workspace logic from sdd/bin/lib/core.cjs
+ * (line 669+). Provides WorkspaceContext reading and validated path scoping.
+ *
+ * Security: workspace names are validated to reject path traversal (T-14-05).
+ *
+ * @example
+ * ```typescript
+ * import { resolveWorkspaceContext, workspacePlanningPaths } from './workspace.js';
+ *
+ * const ctx = resolveWorkspaceContext();
+ * // { workstream: 'backend', project: null }
+ *
+ * const paths = workspacePlanningPaths('/my/project', ctx);
+ * // paths.state → '/my/project/.planning/workstreams/backend/STATE.md'
+ * ```
+ */
+import { join } from 'node:path';
+import { SDDError, ErrorClassification } from '../errors.js';
+function toPosixPath(p) {
+    return p.split('\\').join('/');
+}
+// ─── Validation ────────────────────────────────────────────────────────────
+/**
+ * Validate a workspace or project name.
+ *
+ * Rejects names that could cause path traversal (T-14-05):
+ * - Empty string
+ * - Names containing '/' or '\'
+ * - Names containing '..' sequences
+ *
+ * @param name - Workspace or project name to validate
+ * @param kind - Label for error messages ('workstream' or 'project')
+ * @throws SDDError with Validation classification on invalid name
+ */
+function validateWorkspaceName(name, kind) {
+    if (!name || name.trim() === '') {
+        throw new SDDError(`${kind} name must not be empty`, ErrorClassification.Validation);
+    }
+    if (name.includes('/') || name.includes('\\')) {
+        throw new SDDError(`${kind} name must not contain path separators: ${name}`, ErrorClassification.Validation);
+    }
+    if (name.includes('..')) {
+        throw new SDDError(`${kind} name must not contain '..' (path traversal): ${name}`, ErrorClassification.Validation);
+    }
+}
+// ─── resolveWorkspaceContext ───────────────────────────────────────────────
+/**
+ * Read SDD_WORKSTREAM and SDD_PROJECT environment variables.
+ *
+ * Returns a WorkspaceContext with null values when the env vars are not set.
+ *
+ * @returns Resolved workspace context
+ */
+export function resolveWorkspaceContext() {
+    return {
+        workstream: process.env['SDD_WORKSTREAM'] || null,
+        project: process.env['SDD_PROJECT'] || null,
+    };
+}
+// ─── workspacePlanningPaths ────────────────────────────────────────────────
+/**
+ * Return PlanningPaths scoped to the active workspace or project.
+ *
+ * When context has a workstream set: base = .planning/workstreams/<ws>/
+ * When context has a project set: base = .planning/<project>/
+ * When context is null or empty: base = .planning/ (default)
+ *
+ * Workspace and project names are validated before path construction.
+ *
+ * @param projectDir - Absolute project root path
+ * @param context - Optional workspace context (defaults to no scoping)
+ * @returns PlanningPaths scoped to the active workspace
+ * @throws SDDError if workspace/project name fails validation
+ */
+export function workspacePlanningPaths(projectDir, context) {
+    let base;
+    if (context?.workstream != null) {
+        validateWorkspaceName(context.workstream, 'workstream');
+        base = join(projectDir, '.planning', 'workstreams', context.workstream);
+    }
+    else if (context?.project != null) {
+        validateWorkspaceName(context.project, 'project');
+        // Match CJS planningDir() policy: project scopes under `.planning/<project>/`
+        // (not `.planning/projects/<project>/`).
+        base = join(projectDir, '.planning', context.project);
+    }
+    else {
+        base = join(projectDir, '.planning');
+    }
+    return {
+        planning: toPosixPath(base),
+        state: toPosixPath(join(base, 'STATE.md')),
+        roadmap: toPosixPath(join(base, 'ROADMAP.md')),
+        project: toPosixPath(join(base, 'PROJECT.md')),
+        config: toPosixPath(join(base, 'config.json')),
+        phases: toPosixPath(join(base, 'phases')),
+        requirements: toPosixPath(join(base, 'REQUIREMENTS.md')),
+    };
+}
+//# sourceMappingURL=workspace.js.map

package/sdk/dist/query/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../src/query/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAY7D,SAAS,WAAW,CAAC,CAAS;IAC5B,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACjC,CAAC;AAcD,8EAA8E;AAE9E;;;;;;;;;;;GAWG;AACH,SAAS,qBAAqB,CAAC,IAAY,EAAE,IAAY;IACvD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAChC,MAAM,IAAI,QAAQ,CAChB,GAAG,IAAI,yBAAyB,EAChC,mBAAmB,CAAC,UAAU,CAC/B,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,QAAQ,CAChB,GAAG,IAAI,2CAA2C,IAAI,EAAE,EACxD,mBAAmB,CAAC,UAAU,CAC/B,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,QAAQ,CAChB,GAAG,IAAI,iDAAiD,IAAI,EAAE,EAC9D,mBAAmB,CAAC,UAAU,CAC/B,CAAC;IACJ,CAAC;AACH,CAAC;AAED,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,IAAI;QACjD,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,IAAI;KAC5C,CAAC;AACJ,CAAC;AAED,8EAA8E;AAE9E;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,sBAAsB,CACpC,UAAkB,EAClB,OAA0B;IAE1B,IAAI,IAAY,CAAC;IAEjB,IAAI,OAAO,EAAE,UAAU,IAAI,IAAI,EAAE,CAAC;QAChC,qBAAqB,CAAC,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QACxD,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1E,CAAC;SAAM,IAAI,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,CAAC;QACpC,qBAAqB,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAClD,8EAA8E;QAC9E,yCAAyC;QACzC,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IACvC,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,WAAW,CAAC,IAAI,CAAC;QAC3B,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC1C,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAC9C,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAC9C,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;QAC9C,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACzC,YAAY,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;KACzD,CAAC;AACJ,CAAC"}

package/sdk/dist/query/workstream-inventory.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Workstream Inventory Module.
+ *
+ * Owns discovery and read-only projection of .planning/workstreams/* state.
+ * Query handlers should render outputs from this inventory instead of
+ * rescanning workstream directories directly.
+ */
+export interface WorkstreamPhaseInventory {
+    directory: string;
+    status: 'complete' | 'in_progress' | 'pending';
+    plan_count: number;
+    summary_count: number;
+}
+export interface WorkstreamInventory {
+    name: string;
+    path: string;
+    active: boolean;
+    files: {
+        roadmap: boolean;
+        state: boolean;
+        requirements: boolean;
+    };
+    status: string;
+    current_phase: string | null;
+    last_activity: string | null;
+    phases: WorkstreamPhaseInventory[];
+    phase_count: number;
+    completed_phases: number;
+    roadmap_phase_count: number;
+    total_plans: number;
+    completed_plans: number;
+    progress_percent: number;
+}
+export interface WorkstreamInventoryList {
+    mode: 'flat' | 'workstream';
+    active: string | null;
+    workstreams: WorkstreamInventory[];
+    count: number;
+    message?: string;
+}
+export declare const planningRoot: (projectDir: string) => string;
+export declare const workstreamsRoot: (projectDir: string) => string;
+export declare function countRoadmapPhases(roadmapPath: string, fallbackCount: number): number;
+export declare function countPhaseFiles(phaseDir: string): {
+    planCount: number;
+    summaryCount: number;
+};
+export declare function inspectWorkstream(projectDir: string, name: string, options?: {
+    active?: string | null;
+}): WorkstreamInventory | null;
+export declare function listWorkstreamInventories(projectDir: string): WorkstreamInventoryList;
+//# sourceMappingURL=workstream-inventory.d.ts.map

package/sdk/dist/query/workstream-inventory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workstream-inventory.d.ts","sourceRoot":"","sources":["../../src/query/workstream-inventory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,GAAG,aAAa,GAAG,SAAS,CAAC;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE;QACL,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,EAAE,OAAO,CAAC;QACf,YAAY,EAAE,OAAO,CAAC;KACvB,CAAC;IACF,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,wBAAwB,EAAE,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC;IAC5B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,YAAY,GAAI,YAAY,MAAM,KAAG,MACnB,CAAC;AAEhC,eAAO,MAAM,eAAe,GAAI,YAAY,MAAM,KAAG,MACN,CAAC;AAiBhD,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAQrF;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAG7F;AAmBD,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAO,GACvC,mBAAmB,GAAG,IAAI,CAwD5B;AAED,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,uBAAuB,CA2BrF"}

package/sdk/dist/query/workstream-inventory.js

@@ -0,0 +1,141 @@
+/**
+ * Workstream Inventory Module.
+ *
+ * Owns discovery and read-only projection of .planning/workstreams/* state.
+ * Query handlers should render outputs from this inventory instead of
+ * rescanning workstream directories directly.
+ */
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join, relative } from 'node:path';
+import { toPosixPath } from './helpers.js';
+import { scanPhasePlans } from './plan-scan.js';
+import { stateExtractField } from './state-document.js';
+import { readActiveWorkstream } from './active-workstream-store.js';
+export const planningRoot = (projectDir) => join(projectDir, '.planning');
+export const workstreamsRoot = (projectDir) => join(planningRoot(projectDir), 'workstreams');
+function wsPlanningPaths(projectDir, name) {
+    const base = join(planningRoot(projectDir), 'workstreams', name);
+    return {
+        state: join(base, 'STATE.md'),
+        roadmap: join(base, 'ROADMAP.md'),
+        phases: join(base, 'phases'),
+        requirements: join(base, 'REQUIREMENTS.md'),
+    };
+}
+function readSubdirectories(dir) {
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir, { withFileTypes: true }).filter(e => e.isDirectory()).map(e => e.name);
+}
+export function countRoadmapPhases(roadmapPath, fallbackCount) {
+    try {
+        const roadmapContent = readFileSync(roadmapPath, 'utf-8');
+        const matches = roadmapContent.match(/^#{2,4}\s+Phase\s+[\w][\w.-]*/gm);
+        return matches ? matches.length : fallbackCount;
+    }
+    catch {
+        return fallbackCount;
+    }
+}
+export function countPhaseFiles(phaseDir) {
+    const scan = scanPhasePlans(phaseDir);
+    return { planCount: scan.planCount, summaryCount: scan.summaryCount };
+}
+function readStateProjection(statePath) {
+    try {
+        const stateContent = readFileSync(statePath, 'utf-8');
+        return {
+            status: stateExtractField(stateContent, 'Status') || 'unknown',
+            current_phase: stateExtractField(stateContent, 'Current Phase'),
+            last_activity: stateExtractField(stateContent, 'Last Activity'),
+        };
+    }
+    catch {
+        return {
+            status: 'unknown',
+            current_phase: null,
+            last_activity: null,
+        };
+    }
+}
+export function inspectWorkstream(projectDir, name, options = {}) {
+    const wsDir = join(workstreamsRoot(projectDir), name);
+    if (!existsSync(wsDir))
+        return null;
+    const active = options.active === undefined ? readActiveWorkstream(projectDir) : options.active;
+    const p = wsPlanningPaths(projectDir, name);
+    const phaseDirs = readSubdirectories(p.phases);
+    const phases = [];
+    let completedPhases = 0;
+    let totalPlans = 0;
+    let completedPlans = 0;
+    for (const dir of [...phaseDirs].sort()) {
+        const counts = countPhaseFiles(join(p.phases, dir));
+        const status = counts.summaryCount >= counts.planCount && counts.planCount > 0
+            ? 'complete'
+            : counts.planCount > 0
+                ? 'in_progress'
+                : 'pending';
+        totalPlans += counts.planCount;
+        completedPlans += Math.min(counts.summaryCount, counts.planCount);
+        if (status === 'complete')
+            completedPhases++;
+        phases.push({
+            directory: dir,
+            status,
+            plan_count: counts.planCount,
+            summary_count: counts.summaryCount,
+        });
+    }
+    const roadmapPhaseCount = countRoadmapPhases(p.roadmap, phaseDirs.length);
+    const state = readStateProjection(p.state);
+    return {
+        name,
+        path: toPosixPath(relative(projectDir, wsDir)),
+        active: name === active,
+        files: {
+            roadmap: existsSync(p.roadmap),
+            state: existsSync(p.state),
+            requirements: existsSync(p.requirements),
+        },
+        status: state.status,
+        current_phase: state.current_phase,
+        last_activity: state.last_activity,
+        phases,
+        phase_count: phases.length,
+        completed_phases: completedPhases,
+        roadmap_phase_count: roadmapPhaseCount,
+        total_plans: totalPlans,
+        completed_plans: completedPlans,
+        progress_percent: roadmapPhaseCount > 0 ? Math.min(100, Math.round((completedPhases / roadmapPhaseCount) * 100)) : 0,
+    };
+}
+export function listWorkstreamInventories(projectDir) {
+    const wsRoot = workstreamsRoot(projectDir);
+    if (!existsSync(wsRoot)) {
+        return {
+            mode: 'flat',
+            active: null,
+            workstreams: [],
+            count: 0,
+            message: 'No workstreams — operating in flat mode',
+        };
+    }
+    const active = readActiveWorkstream(projectDir);
+    const entries = readdirSync(wsRoot, { withFileTypes: true });
+    const workstreams = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const inventory = inspectWorkstream(projectDir, entry.name, { active });
+        if (inventory)
+            workstreams.push(inventory);
+    }
+    return {
+        mode: 'workstream',
+        active,
+        workstreams,
+        count: workstreams.length,
+    };
+}
+//# sourceMappingURL=workstream-inventory.js.map

package/sdk/dist/query/workstream-inventory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workstream-inventory.js","sourceRoot":"","sources":["../../src/query/workstream-inventory.ts"],"names":[],"mappings":"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"}

package/sdk/dist/query/workstream.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Workstream query handlers — list, get, create, set, status, complete, progress.
+ *
+ * Ported from sdd/bin/lib/workstream.cjs.
+ * Manages .planning/workstreams/ directory for multi-workstream projects.
+ *
+ * @example
+ * ```typescript
+ * import { workstreamList, workstreamCreate } from './workstream.js';
+ *
+ * await workstreamList([], '/project');
+ * // { data: { workstreams: ['backend', 'frontend'], count: 2 } }
+ *
+ * await workstreamCreate(['api'], '/project');
+ * // { data: { created: true, name: 'api', path: '.planning/workstreams/api' } }
+ * ```
+ */
+import type { QueryHandler } from './utils.js';
+/**
+ * Current active workstream and mode (flat vs workstream).
+ *
+ * Port of `cmdWorkstreamGet` from `workstream.cjs` lines 367–371.
+ */
+export declare const workstreamGet: QueryHandler;
+export declare const workstreamList: QueryHandler;
+export declare const workstreamCreate: QueryHandler;
+export declare const workstreamSet: QueryHandler;
+export declare const workstreamStatus: QueryHandler;
+export declare const workstreamComplete: QueryHandler;
+/**
+ * Port of `cmdWorkstreamProgress` from `workstream.cjs` — aggregate status for each workstream.
+ * (Not the same as roadmap `progress` / `progressBar`.)
+ */
+export declare const workstreamProgress: QueryHandler;
+//# sourceMappingURL=workstream.d.ts.map

package/sdk/dist/query/workstream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workstream.d.ts","sourceRoot":"","sources":["../../src/query/workstream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAkBH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM/C;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,YAS3B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,YAqB5B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,YAoE9B,CAAC;AAqBF,eAAO,MAAM,aAAa,EAAE,YAwB3B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,YA+B9B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,YA8DhC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,YA4BhC,CAAC"}