@madmatt112org/spec-workflow-mcp 3.0.0

package/dist/core/adversarial-settings.js

@@ -0,0 +1,148 @@
+import * as nodeFs from 'node:fs';
+import { PathUtils } from './path-utils.js';
+const cache = new Map();
+const warnedKeys = new Set();
+function warnOnce(key, message) {
+    if (warnedKeys.has(key))
+        return;
+    warnedKeys.add(key);
+    console.warn(message);
+}
+function clearLoadWarnings(absPath) {
+    const prefix = `load:${absPath}:`;
+    for (const key of [...warnedKeys]) {
+        if (key.startsWith(prefix))
+            warnedKeys.delete(key);
+    }
+}
+function formatLoadWarning(absPath, reason, detail) {
+    return `[spec-workflow] adversarial-settings.json: ${reason} (path: ${absPath}); falling back to defaults. ${detail}`;
+}
+function isPlainObject(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+function deepFreeze(value) {
+    if (value === null || typeof value !== 'object')
+        return value;
+    for (const v of Object.values(value))
+        deepFreeze(v);
+    return Object.freeze(value);
+}
+function describeValue(v) {
+    if (v === null)
+        return 'null';
+    if (Array.isArray(v))
+        return 'array';
+    return typeof v;
+}
+function getSettingsPath(projectPath) {
+    return PathUtils.safeJoin(PathUtils.getWorkflowRoot(projectPath), 'adversarial-settings.json');
+}
+export function loadSettings(projectPath) {
+    const absPath = getSettingsPath(projectPath);
+    let stats;
+    try {
+        stats = nodeFs.statSync(absPath);
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === 'ENOENT') {
+            return {};
+        }
+        warnOnce(`load:${absPath}:io-stat`, formatLoadWarning(absPath, `stat failed (${code ?? 'unknown'})`, err.message));
+        return {};
+    }
+    const cached = cache.get(absPath);
+    if (cached) {
+        if (cached.mtimeMs === stats.mtimeMs && cached.size === stats.size) {
+            return cached.settings;
+        }
+        // (mtime, size) advanced — file was edited. Clear warn-once flags scoped to
+        // this file so a recovered file can surface a different cause without dedup masking.
+        clearLoadWarnings(absPath);
+    }
+    const cacheEmpty = () => {
+        const empty = deepFreeze({});
+        cache.set(absPath, { mtimeMs: stats.mtimeMs, size: stats.size, settings: empty });
+        return empty;
+    };
+    let raw;
+    try {
+        raw = nodeFs.readFileSync(absPath, 'utf-8');
+    }
+    catch (err) {
+        const code = err.code;
+        warnOnce(`load:${absPath}:io-read`, formatLoadWarning(absPath, `read failed (${code ?? 'unknown'})`, err.message));
+        return cacheEmpty();
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        warnOnce(`load:${absPath}:json-parse`, formatLoadWarning(absPath, 'JSON parse failed', err.message));
+        return cacheEmpty();
+    }
+    if (!isPlainObject(parsed)) {
+        warnOnce(`load:${absPath}:top-shape`, formatLoadWarning(absPath, 'top-level value is not an object', `received: ${describeValue(parsed)}`));
+        return cacheEmpty();
+    }
+    const settings = deepFreeze(parsed);
+    cache.set(absPath, { mtimeMs: stats.mtimeMs, size: stats.size, settings });
+    return settings;
+}
+export function resolveRunnerModel(settings, runner) {
+    const block = settings[runner];
+    if (block !== undefined && block !== null) {
+        if (!isPlainObject(block)) {
+            warnOnce(`runner-block-non-object:${runner}`, `[spec-workflow] adversarial-settings.json: '${runner}' is present but not an object (received: ${describeValue(block)}); falling back to defaults.`);
+        }
+        else {
+            const model = block.model;
+            if (model !== undefined) {
+                if (typeof model === 'string') {
+                    if (model !== '')
+                        return model;
+                    // Empty string: explicitly cleared, fall through to legacy.
+                }
+                else {
+                    warnOnce(`runner-model-non-string:${runner}`, `[spec-workflow] adversarial-settings.json: '${runner}.model' is present but not a string (received: ${describeValue(model)}); falling back to defaults.`);
+                }
+            }
+        }
+    }
+    const legacy = settings.model;
+    if (typeof legacy === 'string') {
+        if (legacy !== '')
+            return legacy;
+    }
+    else if (legacy !== undefined && legacy !== null) {
+        warnOnce('legacy-model-non-string', `[spec-workflow] adversarial-settings.json: legacy 'model' is present but not a string (received: ${describeValue(legacy)}); falling back to defaults.`);
+    }
+    return undefined;
+}
+export function isTypecheckEnabled(settings) {
+    const features = settings.features;
+    if (features === undefined || features === null)
+        return true;
+    if (!isPlainObject(features)) {
+        warnOnce('features-non-object', `[spec-workflow] adversarial-settings.json: 'features' is present but not an object (received: ${describeValue(features)}); falling back to defaults.`);
+        return true;
+    }
+    const tc = features.typecheck;
+    if (tc === undefined)
+        return true;
+    if (typeof tc === 'boolean')
+        return tc;
+    if (tc === '')
+        return true;
+    const repr = describeValue(tc);
+    warnOnce(`features-typecheck-non-boolean:${repr}`, `[spec-workflow] adversarial-settings.json: 'features.typecheck' is present but not a boolean (received: ${repr}); falling back to defaults.`);
+    return true;
+}
+// Test-only: reset module state between cases.
+export function __resetForTests() {
+    cache.clear();
+    warnedKeys.clear();
+}
+//# sourceMappingURL=adversarial-settings.js.map

package/dist/core/adversarial-settings.js.map

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

package/dist/core/archive-service.d.ts

@@ -0,0 +1,10 @@
+export declare class SpecArchiveService {
+    private projectPath;
+    constructor(projectPath: string);
+    archiveSpec(specName: string): Promise<void>;
+    unarchiveSpec(specName: string): Promise<void>;
+    isSpecActive(specName: string): Promise<boolean>;
+    isSpecArchived(specName: string): Promise<boolean>;
+    getSpecLocation(specName: string): Promise<'active' | 'archived' | 'not-found'>;
+}
+//# sourceMappingURL=archive-service.d.ts.map

package/dist/core/archive-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-service.d.ts","sourceRoot":"","sources":["../../src/core/archive-service.ts"],"names":[],"mappings":"AAIA,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,EAAE,MAAM;IAKzB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiC5C,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiC9C,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAShD,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASlD,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;CAStF"}

package/dist/core/archive-service.js

@@ -0,0 +1,99 @@
+import { promises as fs } from 'fs';
+import { PathUtils } from './path-utils.js';
+export class SpecArchiveService {
+    projectPath;
+    constructor(projectPath) {
+        // Path should already be translated by caller (ProjectManager)
+        this.projectPath = projectPath;
+    }
+    async archiveSpec(specName) {
+        const activeSpecPath = PathUtils.getSpecPath(this.projectPath, specName);
+        const archiveSpecPath = PathUtils.getArchiveSpecPath(this.projectPath, specName);
+        // Verify the active spec exists
+        try {
+            await fs.access(activeSpecPath);
+        }
+        catch {
+            throw new Error(`Spec '${specName}' not found in active specs`);
+        }
+        // Verify the archive destination doesn't already exist
+        try {
+            await fs.access(archiveSpecPath);
+            throw new Error(`Spec '${specName}' already exists in archive`);
+        }
+        catch (error) {
+            if (error instanceof Error && error.code !== 'ENOENT') {
+                throw error;
+            }
+        }
+        try {
+            // Ensure archive directory structure exists
+            await fs.mkdir(PathUtils.getArchiveSpecsPath(this.projectPath), { recursive: true });
+            // Move the entire spec directory to archive
+            await fs.rename(activeSpecPath, archiveSpecPath);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to archive spec '${specName}': ${errorMessage}`);
+        }
+    }
+    async unarchiveSpec(specName) {
+        const archiveSpecPath = PathUtils.getArchiveSpecPath(this.projectPath, specName);
+        const activeSpecPath = PathUtils.getSpecPath(this.projectPath, specName);
+        // Verify the archived spec exists
+        try {
+            await fs.access(archiveSpecPath);
+        }
+        catch {
+            throw new Error(`Spec '${specName}' not found in archive`);
+        }
+        // Verify the active destination doesn't already exist
+        try {
+            await fs.access(activeSpecPath);
+            throw new Error(`Spec '${specName}' already exists in active specs`);
+        }
+        catch (error) {
+            if (error instanceof Error && error.code !== 'ENOENT') {
+                throw error;
+            }
+        }
+        try {
+            // Ensure active specs directory exists
+            await fs.mkdir(PathUtils.getSpecPath(this.projectPath, ''), { recursive: true });
+            // Move the entire spec directory back to active
+            await fs.rename(archiveSpecPath, activeSpecPath);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to unarchive spec '${specName}': ${errorMessage}`);
+        }
+    }
+    async isSpecActive(specName) {
+        try {
+            await fs.access(PathUtils.getSpecPath(this.projectPath, specName));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async isSpecArchived(specName) {
+        try {
+            await fs.access(PathUtils.getArchiveSpecPath(this.projectPath, specName));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async getSpecLocation(specName) {
+        const isActive = await this.isSpecActive(specName);
+        if (isActive)
+            return 'active';
+        const isArchived = await this.isSpecArchived(specName);
+        if (isArchived)
+            return 'archived';
+        return 'not-found';
+    }
+}
+//# sourceMappingURL=archive-service.js.map

package/dist/core/archive-service.js.map

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

package/dist/core/dashboard-session.d.ts

@@ -0,0 +1,49 @@
+export interface DashboardSessionEntry {
+    url: string;
+    port: number;
+    pid: number;
+    startedAt: string;
+}
+/**
+ * Manages the global dashboard session
+ * Stores dashboard connection info in ~/.spec-workflow-mcp/activeSession.json
+ * (or SPEC_WORKFLOW_HOME if set)
+ */
+export declare class DashboardSessionManager {
+    private sessionDir;
+    private sessionPath;
+    constructor();
+    /**
+     * Ensure the session directory exists
+     */
+    private ensureSessionDir;
+    /**
+     * Read the session file
+     */
+    private readSession;
+    /**
+     * Write the session file atomically
+     */
+    private writeSession;
+    /**
+     * Check if a process is still running
+     */
+    private isProcessAlive;
+    /**
+     * Register the dashboard session
+     */
+    registerDashboard(url: string, port: number, pid: number): Promise<void>;
+    /**
+     * Unregister the dashboard session
+     */
+    unregisterDashboard(): Promise<void>;
+    /**
+     * Get the current dashboard session if it's valid
+     */
+    getDashboardSession(): Promise<DashboardSessionEntry | null>;
+    /**
+     * Check if a dashboard is currently running
+     */
+    isDashboardRunning(): Promise<boolean>;
+}
+//# sourceMappingURL=dashboard-session.d.ts.map

package/dist/core/dashboard-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-session.d.ts","sourceRoot":"","sources":["../../src/core/dashboard-session.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAS;;IAO5B;;OAEG;YACW,gBAAgB;IAkB9B;;OAEG;YACW,WAAW;IAezB;;OAEG;YACW,YAAY;IAW1B;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;IACG,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW9E;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAU1C;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAqBlE;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC;CAI7C"}

package/dist/core/dashboard-session.js

@@ -0,0 +1,132 @@
+import { join } from 'path';
+import { promises as fs } from 'fs';
+import { getGlobalDir, getPermissionErrorHelp } from './global-dir.js';
+/**
+ * Manages the global dashboard session
+ * Stores dashboard connection info in ~/.spec-workflow-mcp/activeSession.json
+ * (or SPEC_WORKFLOW_HOME if set)
+ */
+export class DashboardSessionManager {
+    sessionDir;
+    sessionPath;
+    constructor() {
+        this.sessionDir = getGlobalDir();
+        this.sessionPath = join(this.sessionDir, 'activeSession.json');
+    }
+    /**
+     * Ensure the session directory exists
+     */
+    async ensureSessionDir() {
+        try {
+            await fs.mkdir(this.sessionDir, { recursive: true });
+        }
+        catch (error) {
+            // Directory might already exist, ignore EEXIST errors
+            if (error.code === 'EEXIST') {
+                return;
+            }
+            // For permission errors, provide helpful guidance
+            if (error.code === 'EACCES' || error.code === 'EPERM') {
+                console.error(getPermissionErrorHelp('create directory', this.sessionDir));
+                throw error;
+            }
+            // Re-throw other errors
+            throw error;
+        }
+    }
+    /**
+     * Read the session file
+     */
+    async readSession() {
+        await this.ensureSessionDir();
+        try {
+            const content = await fs.readFile(this.sessionPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                // File doesn't exist yet
+                return null;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Write the session file atomically
+     */
+    async writeSession(session) {
+        await this.ensureSessionDir();
+        const content = JSON.stringify(session, null, 2);
+        // Write to temporary file first, then rename for atomic operation
+        const tempPath = `${this.sessionPath}.tmp`;
+        await fs.writeFile(tempPath, content, 'utf-8');
+        await fs.rename(tempPath, this.sessionPath);
+    }
+    /**
+     * Check if a process is still running
+     */
+    isProcessAlive(pid) {
+        try {
+            // Sending signal 0 checks if process exists without actually sending a signal
+            process.kill(pid, 0);
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    /**
+     * Register the dashboard session
+     */
+    async registerDashboard(url, port, pid) {
+        const session = {
+            url,
+            port,
+            pid,
+            startedAt: new Date().toISOString()
+        };
+        await this.writeSession(session);
+    }
+    /**
+     * Unregister the dashboard session
+     */
+    async unregisterDashboard() {
+        try {
+            await fs.unlink(this.sessionPath);
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT') {
+                throw error;
+            }
+        }
+    }
+    /**
+     * Get the current dashboard session if it's valid
+     */
+    async getDashboardSession() {
+        const session = await this.readSession();
+        if (!session) {
+            return null;
+        }
+        // Check if the dashboard process is still alive
+        if (!this.isProcessAlive(session.pid)) {
+            // Process is dead, clean up
+            try {
+                await this.unregisterDashboard();
+            }
+            catch (error) {
+                // Ignore cleanup errors
+            }
+            return null;
+        }
+        return session;
+    }
+    /**
+     * Check if a dashboard is currently running
+     */
+    async isDashboardRunning() {
+        const session = await this.getDashboardSession();
+        return session !== null;
+    }
+}
+//# sourceMappingURL=dashboard-session.js.map

package/dist/core/dashboard-session.js.map

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

package/dist/core/deferral-storage.d.ts

@@ -0,0 +1,32 @@
+import { Deferral } from '../types.js';
+/**
+ * Storage for deferred decisions using markdown files with YAML frontmatter.
+ * Each deferral is stored as a single file in .spec-workflow/deferrals/
+ */
+export declare class DeferralStorage {
+    private deferralsDir;
+    constructor(projectPath: string);
+    private ensureDir;
+    private generateId;
+    private toMarkdown;
+    private parseMarkdown;
+    create(deferral: Omit<Deferral, 'id' | 'status' | 'createdAt' | 'updatedAt' | 'resolvedAt' | 'resolution' | 'resolvedInSpec' | 'supersededBy'>, supersedes?: string): Promise<string>;
+    get(id: string): Promise<Deferral | null>;
+    list(filters?: {
+        status?: string;
+        originSpec?: string;
+        tag?: string;
+    }): Promise<Deferral[]>;
+    resolve(id: string, resolution: string, resolvedInSpec?: string): Promise<void>;
+    update(id: string, updates: {
+        title?: string;
+        revisitTrigger?: string;
+        tags?: string[];
+        context?: string;
+        decision?: string;
+        revisitCriteria?: string;
+    }): Promise<void>;
+    delete(id: string): Promise<void>;
+    private exists;
+}
+//# sourceMappingURL=deferral-storage.d.ts.map

package/dist/core/deferral-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferral-storage.d.ts","sourceRoot":"","sources":["../../src/core/deferral-storage.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,YAAY,CAAS;gBAEjB,WAAW,EAAE,MAAM;YAIjB,SAAS;IAIvB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,UAAU;IAiClB,OAAO,CAAC,aAAa;IAqDf,MAAM,CACV,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,GAAG,YAAY,GAAG,YAAY,GAAG,gBAAgB,GAAG,cAAc,CAAC,EACvI,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC;IAyCZ,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IASzC,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAwB3F,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe/E,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;QAChC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,GAAG,OAAO,CAAC,IAAI,CAAC;IAeX,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAgBzB,MAAM;CAQrB"}