@mytechtoday/augment-sdd 1.0.0

package/out/test/unit/runCli.test.js

@@ -0,0 +1,113 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Unit tests for runCli.ts
+ * UT-1: resolves with trimmed stdout on exit code 0
+ * UT-2: rejects on non-zero exit code
+ * UT-3: rejects on timeout
+ */
+const assert = __importStar(require("assert"));
+const cp = __importStar(require("child_process"));
+const sinon = __importStar(require("sinon"));
+const events_1 = require("events");
+const runCli_1 = require("../../utils/runCli");
+function fakeProc(opts) {
+    const stdoutEE = new events_1.EventEmitter();
+    const stderrEE = new events_1.EventEmitter();
+    const procEE = new events_1.EventEmitter();
+    // Minimal object that satisfies what runCli actually accesses.
+    const proc = {
+        stdout: stdoutEE,
+        stderr: stderrEE,
+        kill: () => { },
+        on: procEE.on.bind(procEE),
+        once: procEE.once.bind(procEE),
+        removeListener: procEE.removeListener.bind(procEE),
+        emit: procEE.emit.bind(procEE),
+    };
+    setImmediate(() => {
+        if (opts.stdout) {
+            stdoutEE.emit('data', Buffer.from(opts.stdout));
+        }
+        if (opts.stderr) {
+            stderrEE.emit('data', Buffer.from(opts.stderr));
+        }
+        if (opts.hangMs === undefined) {
+            procEE.emit('close', opts.code ?? 0);
+        }
+        else {
+            // Deliberately hang so the runCli timer can fire first.
+            setTimeout(() => procEE.emit('close', null), opts.hangMs);
+        }
+    });
+    return proc;
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+suite('runCli — unit tests', () => {
+    test('UT-1: resolves with trimmed stdout on exit code 0', async () => {
+        const stub = sinon.stub(cp, 'spawn').returns(fakeProc({ stdout: 'hello\n', code: 0 }));
+        try {
+            const result = await (0, runCli_1.runCli)('echo', ['hello'], '/tmp');
+            assert.strictEqual(result, 'hello');
+        }
+        finally {
+            stub.restore();
+        }
+    });
+    test('UT-2: rejects on non-zero exit code', async () => {
+        const stub = sinon.stub(cp, 'spawn').returns(fakeProc({ stdout: '', stderr: 'err', code: 1 }));
+        try {
+            await assert.rejects((0, runCli_1.runCli)('false', [], '/tmp'), /failed with exit code 1/);
+        }
+        finally {
+            stub.restore();
+        }
+    });
+    test('UT-3: rejects on timeout', async () => {
+        // hangMs (5 000) >> timeoutMs (100) → timer fires first, process is killed,
+        // promise rejects with a message containing "timed out".
+        const stub = sinon.stub(cp, 'spawn').returns(fakeProc({ hangMs: 5000, code: null }));
+        try {
+            await assert.rejects((0, runCli_1.runCli)('sleep', ['5'], '/tmp', 100), /timed out/i);
+        }
+        finally {
+            stub.restore();
+        }
+    });
+});
+//# sourceMappingURL=runCli.test.js.map

package/out/test/unit/runCli.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runCli.test.js","sourceRoot":"","sources":["../../../src/test/unit/runCli.test.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;GAKG;AACH,+CAAiC;AACjC,kDAAoC;AACpC,6CAA+B;AAC/B,mCAAsC;AACtC,+CAA4C;AAkB5C,SAAS,QAAQ,CAAC,IAAkB;IAClC,MAAM,QAAQ,GAAG,IAAI,qBAAY,EAAE,CAAC;IACpC,MAAM,QAAQ,GAAG,IAAI,qBAAY,EAAE,CAAC;IACpC,MAAM,MAAM,GAAK,IAAI,qBAAY,EAAE,CAAC;IAEpC,+DAA+D;IAC/D,MAAM,IAAI,GAAG;QACX,MAAM,EAAU,QAAQ;QACxB,MAAM,EAAU,QAAQ;QACxB,IAAI,EAAY,GAAG,EAAE,GAA4C,CAAC;QAClE,EAAE,EAAc,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC;QACtC,IAAI,EAAY,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;QACxC,cAAc,EAAE,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;QAClD,IAAI,EAAY,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;KACzC,CAAC;IAEF,YAAY,CAAC,GAAG,EAAE;QAChB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAAC,CAAC;QACrE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAAC,CAAC;QAErE,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,wDAAwD;YACxD,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,IAAkC,CAAC;AAC5C,CAAC;AAED,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E,KAAK,CAAC,qBAAqB,EAAE,GAAG,EAAE;IAEhC,IAAI,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,OAAO,CAC1C,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CACzC,CAAC;QACF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAA,eAAM,EAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;YACvD,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACtC,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,OAAO,CAC1C,QAAQ,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CACjD,CAAC;QACF,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,OAAO,CAClB,IAAA,eAAM,EAAC,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAC3B,yBAAyB,CAC1B,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;QAC1C,4EAA4E;QAC5E,yDAAyD;QACzD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,OAAO,CAC1C,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CACxC,CAAC;QACF,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,OAAO,CAClB,IAAA,eAAM,EAAC,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EACnC,YAAY,CACb,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,CAAC;AAEL,CAAC,CAAC,CAAC"}

package/out/utils/detectCli.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectCli = detectCli;
+/**
+ * detectCli — checks whether a CLI binary is accessible on the system PATH.
+ *
+ * Uses the platform-appropriate tool (where on Windows, which on Unix) via
+ * runCli so that detection is non-interactive and consistent with all other
+ * CLI invocations in the extension.
+ */
+const runCli_1 = require("./runCli");
+/**
+ * Returns `true` if `name` resolves to an executable on the system PATH,
+ * `false` otherwise.
+ *
+ * @param name  The CLI binary name to look up (e.g., "auggie", "openspec", "bd").
+ */
+async function detectCli(name) {
+    // `where` (Windows) / `which` (Unix/macOS) exits 0 only when the binary is found.
+    const lookupCommand = process.platform === 'win32' ? 'where' : 'which';
+    try {
+        // Use the workspace root as cwd; any valid directory works for which/where.
+        await (0, runCli_1.runCli)(lookupCommand, [name], process.cwd(), 10000);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=detectCli.js.map

package/out/utils/detectCli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectCli.js","sourceRoot":"","sources":["../../src/utils/detectCli.ts"],"names":[],"mappings":";;AAeA,8BAWC;AA1BD;;;;;;GAMG;AACH,qCAAkC;AAElC;;;;;GAKG;AACI,KAAK,UAAU,SAAS,CAAC,IAAY;IAC1C,kFAAkF;IAClF,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IAEvE,IAAI,CAAC;QACH,4EAA4E;QAC5E,MAAM,IAAA,eAAM,EAAC,aAAa,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,KAAM,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/out/utils/getConfig.js

@@ -0,0 +1,60 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConfig = getConfig;
+/**
+ * getConfig — type-safe VS Code settings reader for the Augment SDD extension.
+ *
+ * All extension settings live under the "augmentSdd" namespace as declared in
+ * package.json `contributes.configuration`.  Callers provide a default value
+ * so they never receive `undefined` even when the setting is absent.
+ *
+ * Bead 9 wires this helper into every command; it is created here early so
+ * generateOpenSpec (Bead 5) and generateBeads (Bead 6) can use it immediately.
+ */
+const vscode = __importStar(require("vscode"));
+/**
+ * Read a value from the `augmentSdd` configuration scope.
+ *
+ * @param key           Setting key without the `augmentSdd.` prefix
+ *                      (e.g., `"jiraFolder"`, `"batchSize"`).
+ * @param defaultValue  Returned when the setting is absent or undefined.
+ * @returns             The configured value, or `defaultValue`.
+ */
+function getConfig(key, defaultValue) {
+    const value = vscode.workspace.getConfiguration('augmentSdd').get(key);
+    return value !== undefined ? value : defaultValue;
+}
+//# sourceMappingURL=getConfig.js.map

package/out/utils/getConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getConfig.js","sourceRoot":"","sources":["../../src/utils/getConfig.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoBA,8BAGC;AAvBD;;;;;;;;;GASG;AACH,+CAAiC;AAEjC;;;;;;;GAOG;AACH,SAAgB,SAAS,CAAI,GAAW,EAAE,YAAe;IACvD,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC,GAAG,CAAI,GAAG,CAAC,CAAC;IAC1E,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC;AACpD,CAAC"}

package/out/utils/logger.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initLogger = initLogger;
+exports.log = log;
+exports.revealOutputChannel = revealOutputChannel;
+/** The shared OutputChannel instance, set by initLogger(). */
+let _channel;
+/**
+ * Initialise the logger with the extension's shared OutputChannel.
+ * Must be called once in activate() before any other logging.
+ */
+function initLogger(channel) {
+    _channel = channel;
+}
+/**
+ * Append a timestamped message to the Augment SDD Output Channel.
+ * Safe to call before initLogger() — the message is silently dropped.
+ */
+function log(message) {
+    const ts = new Date().toISOString();
+    _channel?.appendLine(`[${ts}] ${message}`);
+}
+/**
+ * Reveal the Augment SDD Output Channel in the VS Code UI and bring it
+ * into focus without stealing the editor focus.
+ */
+function revealOutputChannel() {
+    _channel?.show(true);
+}
+//# sourceMappingURL=logger.js.map

package/out/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":";;AAqBA,gCAEC;AAMD,kBAGC;AAMD,kDAEC;AA1BD,8DAA8D;AAC9D,IAAI,QAA0C,CAAC;AAE/C;;;GAGG;AACH,SAAgB,UAAU,CAAC,OAA6B;IACtD,QAAQ,GAAG,OAAO,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,SAAgB,GAAG,CAAC,OAAe;IACjC,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACpC,QAAQ,EAAE,UAAU,CAAC,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,SAAgB,mBAAmB;IACjC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;AACvB,CAAC"}

package/out/utils/runCli.js

@@ -0,0 +1,122 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCli = runCli;
+/**
+ * runCli — reusable child_process.spawn wrapper for all augment-sdd commands.
+ *
+ * Design (D1): Uses spawn (not exec) to avoid memory caps and to enable
+ * deterministic timeout handling. execa is intentionally excluded to keep the
+ * runtime dependency footprint at zero.
+ *
+ * Design (D2): Centralises timeout, error formatting, and logging. The optional
+ * `logger` callback receives structured messages before and after each call so
+ * callers can route them to the Augment SDD Output Channel without this module
+ * depending on VS Code APIs.
+ */
+const cp = __importStar(require("child_process"));
+/** Maximum characters of the serialised args string written to the log. */
+const MAX_LOGGED_ARGS_CHARS = 500;
+/**
+ * Spawn `command` with `args` in `cwd`, collect stdout/stderr, and:
+ *  - Resolve with trimmed stdout on exit code 0.
+ *  - Reject with a descriptive Error on non-zero exit code.
+ *  - Kill the process and reject with a timeout Error when `timeoutMs` elapses.
+ *  - Reject immediately if the spawn itself emits an error (e.g., ENOENT).
+ *
+ * @param command    Executable name or path (passed to spawn with shell: true).
+ * @param args       Argument list. Prompt-like args are truncated in log output.
+ * @param cwd        Working directory for the spawned process.
+ * @param timeoutMs  Maximum allowed runtime in ms. Defaults to 120 000 ms.
+ * @param logger     Optional callback that receives structured log messages
+ *                   (pre-run, result, timeout, spawn-error). Timestamps should
+ *                   be added by the caller (e.g., the `log` helper in logger.ts).
+ */
+function runCli(command, args, cwd, timeoutMs = 120000, logger) {
+    // Log the invocation with args truncated to avoid flooding the Output Channel
+    // with large Auggie prompts (spec: truncate prompt ≤ 500 chars in log entries).
+    const rawArgs = args.join(' ');
+    const displayArgs = rawArgs.length > MAX_LOGGED_ARGS_CHARS
+        ? rawArgs.slice(0, MAX_LOGGED_ARGS_CHARS) + '…'
+        : rawArgs;
+    logger?.(`Run: ${command} ${displayArgs}`);
+    return new Promise((resolve, reject) => {
+        const proc = cp.spawn(command, args, { cwd, shell: true });
+        let stdout = '';
+        let stderr = '';
+        let settled = false;
+        /** Settle the promise at most once. */
+        function settle(action) {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            clearTimeout(timer);
+            action();
+        }
+        // Enforce a hard timeout: kill the process and reject with a clear message.
+        const timer = setTimeout(() => {
+            settle(() => {
+                proc.kill();
+                const msg = `CLI "${command} ${args.join(' ')}" timed out after ${timeoutMs} ms`;
+                logger?.(`Timeout after ${timeoutMs} ms | ${command}`);
+                reject(new Error(msg));
+            });
+        }, timeoutMs);
+        proc.stdout.on('data', (data) => { stdout += data; });
+        proc.stderr.on('data', (data) => { stderr += data; });
+        proc.on('close', (code) => {
+            settle(() => {
+                if (code === 0) {
+                    logger?.(`Exit 0 | stdout: ${stdout.trim()}`);
+                    resolve(stdout.trim());
+                }
+                else {
+                    const stderrTrimmed = stderr.trim();
+                    logger?.(`Exit ${code} | stderr: ${stderrTrimmed}`);
+                    reject(new Error(`CLI "${command} ${args.join(' ')}" failed with exit code ${code}\nStderr: ${stderrTrimmed}`));
+                }
+            });
+        });
+        // Propagate spawn errors (e.g., ENOENT — binary not found) immediately.
+        proc.on('error', (err) => {
+            settle(() => {
+                logger?.(`Spawn error: ${err.message}`);
+                reject(err);
+            });
+        });
+    });
+}
+//# sourceMappingURL=runCli.js.map

package/out/utils/runCli.js.map

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

package/package.json

@@ -0,0 +1,111 @@
+{
+  "$schema": "https://json.schemastore.org/vscode-extension-manifest.json",
+  "name": "@mytechtoday/augment-sdd",
+  "displayName": "Augment SDD",
+  "description": "Automates the OpenSpec + Beads + Auggie pipeline (steps 5–7) for spec-driven development in VS Code.",
+  "version": "1.0.0",
+  "publisher": "mytech-today-now",
+  "engines": {
+    "vscode": "^1.85.0"
+  },
+  "categories": [
+    "Other"
+  ],
+  "activationEvents": [
+    "onStartupFinished"
+  ],
+  "main": "./out/extension.js",
+  "contributes": {
+    "commands": [
+      {
+        "command": "augmentSdd.generateOpenSpec",
+        "title": "Augment SDD: Generate OpenSpec",
+        "category": "Augment SDD"
+      },
+      {
+        "command": "augmentSdd.generateBeads",
+        "title": "Augment SDD: Generate Beads",
+        "category": "Augment SDD"
+      },
+      {
+        "command": "augmentSdd.executeBeadsBatch",
+        "title": "Augment SDD: Execute Beads Batch",
+        "category": "Augment SDD"
+      },
+      {
+        "command": "augmentSdd.fullPipeline",
+        "title": "Augment SDD: Run Full Pipeline",
+        "category": "Augment SDD"
+      }
+    ],
+    "configuration": {
+      "title": "Augment SDD",
+      "properties": {
+        "augmentSdd.batchSize": {
+          "type": "integer",
+          "default": 3,
+          "minimum": 1,
+          "maximum": 10,
+          "description": "Number of Beads to include in each Auggie batch execution."
+        },
+        "augmentSdd.auggieExtraFlags": {
+          "type": "string",
+          "default": "",
+          "description": "Extra flags appended to every `auggie --print --quiet` invocation."
+        },
+        "augmentSdd.jiraFolder": {
+          "type": "string",
+          "default": ".jira",
+          "description": "Folder to auto-detect JIRA Markdown ticket files."
+        },
+        "augmentSdd.enableWebviewDashboard": {
+          "type": "boolean",
+          "default": true,
+          "description": "Show the Augment SDD Webview dashboard after pipeline steps."
+        }
+      }
+    }
+  },
+  "scripts": {
+    "vscode:prepublish": "npm run compile",
+    "compile": "tsc -p ./",
+    "watch": "tsc -watch -p ./",
+    "test": "node ./out/test/runTest.js",
+    "lint": "eslint src --ext ts"
+  },
+  "devDependencies": {
+    "@types/glob": "^8.1.0",
+    "@types/mocha": "^10.0.0",
+    "@types/node": "^20.x",
+    "@types/sinon": "^17.0.0",
+    "@types/vscode": "^1.85.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "@vscode/test-electron": "^2.3.0",
+    "eslint": "^8.0.0",
+    "mocha": "^10.0.0",
+    "sinon": "^17.0.0",
+    "typescript": "^5.3.0"
+  },
+  "publishConfig": {
+    "access": "restricted",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "metadata": {
+    "openspecChange": "init",
+    "jiraTicket": "AUGSDD-1",
+    "schema": "spec-driven",
+    "createdAt": "2026-04-02",
+    "capabilities": [
+      "cli-detection",
+      "generate-openspec",
+      "generate-beads",
+      "execute-beads-batch",
+      "full-pipeline",
+      "run-cli-wrapper",
+      "logging-output-channel",
+      "extension-settings",
+      "webview-dashboard"
+    ]
+  }
+}

package/src/commands/executeBeadsBatch.ts

@@ -0,0 +1,153 @@
+/**
+ * executeBeadsBatch — Bead 7 command implementation.
+ *
+ * Steps (tasks 7.1-7.7):
+ *  7.1 Fetch and JSON-parse bd ready --json; exit gracefully if empty.
+ *  7.2 Slice first N beads per augmentSdd.batchSize setting (default 3).
+ *  7.3 Build batch Auggie prompt with --- BEAD START --- sentinels.
+ *  7.4 Execute auggie --print --quiet via runCli.
+ *  7.5 Parse bd update sentinel lines from response.
+ *  7.6 Execute each parsed bd update command; continue on partial failure.
+ *  7.7 Show warning if no sentinel lines were parsed from Auggie response.
+ */
+import * as vscode from 'vscode';
+import { runCli } from '../utils/runCli';
+import { getConfig } from '../utils/getConfig';
+import { log, revealOutputChannel } from '../utils/logger';
+import { parseBeadUpdates } from '../parsers/parseBeadUpdates';
+
+/** Shape returned by `bd ready --json`. */
+interface ReadyBead {
+  id: string;
+  title: string;
+  description: string;
+}
+
+/** Entry point registered as `augmentSdd.executeBeadsBatch`. */
+export async function executeBeadsBatch(): Promise<void> {
+  const workspaceRoot = vscode.workspace.workspaceFolders?.[0]?.uri.fsPath;
+  if (!workspaceRoot) {
+    vscode.window.showErrorMessage('Augment SDD: No workspace folder open.');
+    return;
+  }
+
+  // 7.1 Fetch ready beads
+  let beads: ReadyBead[];
+  try {
+    const raw = await runCli('bd', ['ready', '--json'], workspaceRoot, 30_000, log);
+    beads = JSON.parse(raw) as ReadyBead[];
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    log(`executeBeadsBatch: failed to fetch ready beads — ${msg}`);
+    const action = await vscode.window.showErrorMessage(
+      `Augment SDD: Failed to fetch ready beads. ${msg}`,
+      'View Logs'
+    );
+    if (action === 'View Logs') { revealOutputChannel(); }
+    return;
+  }
+
+  if (beads.length === 0) {
+    vscode.window.showInformationMessage('Augment SDD: No beads ready.');
+    return;
+  }
+
+  // 7.2 Slice to batchSize
+  const batchSize = getConfig<number>('batchSize', 3);
+  const batch = beads.slice(0, batchSize);
+  log(`executeBeadsBatch: ${batch.length} bead(s) selected (batchSize=${batchSize})`);
+
+  // 7.3 Build prompt
+  const prompt = buildBatchPrompt(batch);
+  log(`executeBeadsBatch: prompt length=${prompt.length}`);
+
+  // 7.4 Run Auggie
+  let auggieOutput: string;
+  try {
+    const extraFlags = getConfig<string>('auggieExtraFlags', '');
+    const args = ['--print', '--quiet', prompt];
+    if (extraFlags) {
+      args.push(...extraFlags.split(/\s+/).filter(Boolean));
+    }
+    auggieOutput = await runCli('auggie', args, workspaceRoot, 600_000, log);
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    log(`executeBeadsBatch: Auggie failed — ${msg}`);
+    const action = await vscode.window.showErrorMessage(
+      `Augment SDD: Auggie execution failed. ${msg}`,
+      'View Logs'
+    );
+    if (action === 'View Logs') { revealOutputChannel(); }
+    return;
+  }
+
+  // 7.5 Parse sentinel lines
+  const updates = parseBeadUpdates(auggieOutput);
+  log(`executeBeadsBatch: parsed ${updates.length} sentinel line(s)`);
+
+  // 7.7 Warn if no sentinels found
+  if (updates.length === 0) {
+    log('executeBeadsBatch: WARNING — no bd update sentinel lines found in Auggie response');
+    const action = await vscode.window.showWarningMessage(
+      'Augment SDD: Auggie did not return any bead completion sentinels. Check logs for details.',
+      'View Logs'
+    );
+    if (action === 'View Logs') { revealOutputChannel(); }
+    return;
+  }
+
+  // 7.6 Execute each sentinel command; continue on partial failure
+  let successCount = 0;
+  let failureCount = 0;
+  for (const updateCmd of updates) {
+    const parts = updateCmd.split(/\s+/);
+    // parts: ['bd', 'update', '<id>', '--status', 'done']
+    const args = parts.slice(1); // drop 'bd'
+    try {
+      await runCli('bd', args, workspaceRoot, 30_000, log);
+      log(`executeBeadsBatch: ✓ ${updateCmd}`);
+      successCount++;
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      log(`executeBeadsBatch: ✗ ${updateCmd} — ${msg}`);
+      failureCount++;
+    }
+  }
+
+  // Surface final result
+  if (failureCount === 0) {
+    vscode.window.showInformationMessage(
+      `Augment SDD: Batch complete — ${successCount} bead(s) marked done.`
+    );
+  } else {
+    const action = await vscode.window.showWarningMessage(
+      `Augment SDD: Batch finished with ${failureCount} failure(s). ${successCount} bead(s) succeeded.`,
+      'View Logs'
+    );
+    if (action === 'View Logs') { revealOutputChannel(); }
+  }
+}
+
+/**
+ * 7.3: Construct the multi-bead Auggie prompt with --- BEAD START --- sentinels.
+ */
+function buildBatchPrompt(beads: ReadyBead[]): string {
+  const header = [
+    'You are Auggie, a senior engineer working inside this codebase.',
+    'Implement the following beads one at a time. For each bead:',
+    '',
+    '1. Understand the requirements from the provided OpenSpec context.',
+    '2. Make all necessary code changes.',
+    '3. At the VERY END of your response for that specific bead, output EXACTLY this line and nothing else on that line:',
+    '   bd update <BEAD-ID> --status done',
+    '',
+    'Do not output any other bd commands unless completing a bead.',
+  ].join('\n');
+
+  const sections = beads.map(b =>
+    `--- BEAD START ---\nID: ${b.id}\nTitle: ${b.title}\nDescription: ${b.description}`
+  ).join('\n\n');
+
+  return `${header}\n\n${sections}`;
+}
+