@mytechtoday/augment-sdd 1.0.0 → 1.1.0

package/out/test/unit/initWizard.test.js

@@ -0,0 +1,170 @@
+"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 initWizard (UT-5 — ps-fix test-spec.md)
+ *
+ * UT-5a: QuickPick cancelled → no config written
+ * UT-5b: "beads-ps1" selected → scripts copied, .beads/issues.jsonl created,
+ *         beadsBackend written to workspace config
+ * UT-5c: "bd" selected + dolt absent → error message shown, no config written
+ * UT-5d: "bd" selected + dolt present → bd init called, config written
+ * UT-5e: current config ≠ "auto" + user keeps → returns early (no QuickPick)
+ * UT-5f: "coming soon" item selected → info message, no config written
+ *
+ * Strategy:
+ *   - Stub vscode.window.showQuickPick, showInformationMessage, showErrorMessage.
+ *   - Stub vscode.workspace.getConfiguration.
+ *   - Stub detectBackends from detectCli module.
+ *   - Stub fs.promises.copyFile, mkdir, writeFile for file operations.
+ *   - Stub runCli for the "bd init" call.
+ */
+const assert = __importStar(require("assert"));
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const sinon = __importStar(require("sinon"));
+const vscode = __importStar(require("vscode"));
+const initWizard_1 = require("../../commands/initWizard");
+const detectCliModule = __importStar(require("../../utils/detectCli"));
+const runCliModule = __importStar(require("../../utils/runCli"));
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function makeContext(extensionPath) {
+    return { extensionPath };
+}
+const BACKENDS_ALL_PRESENT = {
+    bd: { name: 'bd', version: '1.2.3' },
+    pwsh: { name: 'pwsh', version: '7.4.0' },
+    powershell: { name: 'powershell', version: null },
+    dolt: { name: 'dolt', version: '1.0.0' },
+};
+const BACKENDS_NONE = {
+    bd: { name: 'bd', version: null },
+    pwsh: { name: 'pwsh', version: null },
+    powershell: { name: 'powershell', version: null },
+    dolt: { name: 'dolt', version: null },
+};
+// Build a minimal config stub that tracks update() calls.
+function makeConfigStub(current = 'auto') {
+    const updateStub = sinon.stub().resolves();
+    const stub = sinon.stub(vscode.workspace, 'getConfiguration').returns({
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        get: (key, def) => key === 'beadsBackend' ? current : def,
+        update: updateStub,
+    });
+    return { stub, updateStub };
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+suite('initWizard — unit tests', () => {
+    let tmpDir;
+    setup(() => {
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'augsdd-wiz-'));
+        sinon.stub(detectCliModule, 'detectBackends').resolves(BACKENDS_ALL_PRESENT);
+        sinon.stub(detectCliModule, 'formatDetectionSummary').returns('summary');
+    });
+    teardown(() => {
+        sinon.restore();
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    // UT-5a -------------------------------------------------------------------
+    test('UT-5a: QuickPick cancelled → no config.update called', async () => {
+        const { updateStub } = makeConfigStub();
+        sinon.stub(vscode.window, 'showQuickPick').resolves(undefined);
+        await (0, initWizard_1.initWizard)(makeContext(tmpDir), tmpDir);
+        assert.ok(!updateStub.called, 'config.update should NOT be called when QuickPick is cancelled');
+    });
+    // UT-5b -------------------------------------------------------------------
+    test('UT-5b: "beads-ps1" selected → scripts copied, config written', async () => {
+        const { updateStub } = makeConfigStub();
+        // Create fake bundled scripts in the extension path
+        const extScriptsDir = path.join(tmpDir, 'scripts');
+        fs.mkdirSync(extScriptsDir, { recursive: true });
+        fs.writeFileSync(path.join(extScriptsDir, 'beads-helpers.ps1'), '# stub');
+        fs.writeFileSync(path.join(extScriptsDir, 'beads-query.ps1'), '# stub');
+        // Workspace dir (separate subdir so no collision)
+        const wsDir = path.join(tmpDir, 'ws');
+        fs.mkdirSync(wsDir);
+        sinon.stub(vscode.window, 'showQuickPick').resolves({
+            label: 'PowerShell Beads', backendId: 'beads-ps1',
+        });
+        sinon.stub(vscode.window, 'showInformationMessage').resolves(undefined);
+        await (0, initWizard_1.initWizard)(makeContext(tmpDir), wsDir);
+        // Scripts should have been copied to wsDir/scripts/
+        assert.ok(fs.existsSync(path.join(wsDir, 'scripts', 'beads-helpers.ps1')), 'beads-helpers.ps1 should be copied to workspace');
+        assert.ok(fs.existsSync(path.join(wsDir, 'scripts', 'beads-query.ps1')), 'beads-query.ps1 should be copied to workspace');
+        // .beads/issues.jsonl should be created
+        assert.ok(fs.existsSync(path.join(wsDir, '.beads', 'issues.jsonl')), '.beads/issues.jsonl should be created');
+        assert.ok(updateStub.calledWith('beadsBackend', 'beads-ps1', vscode.ConfigurationTarget.Workspace), 'config.update should set beadsBackend to beads-ps1');
+    });
+    // UT-5c -------------------------------------------------------------------
+    test('UT-5c: "bd" selected + dolt absent → error shown, no config.update', async () => {
+        detectCliModule.detectBackends.resolves(BACKENDS_NONE);
+        const { updateStub } = makeConfigStub();
+        sinon.stub(vscode.window, 'showQuickPick').resolves({
+            label: 'Classic Beads', backendId: 'bd',
+        });
+        const errStub = sinon.stub(vscode.window, 'showErrorMessage').resolves(undefined);
+        await (0, initWizard_1.initWizard)(makeContext(tmpDir), tmpDir);
+        assert.ok(errStub.called, 'error message should be shown when dolt is absent');
+        assert.ok(!updateStub.called, 'config.update should NOT be called when dolt is absent');
+    });
+    // UT-5d -------------------------------------------------------------------
+    test('UT-5d: "bd" selected + dolt present → bd init called, config written', async () => {
+        const { updateStub } = makeConfigStub();
+        sinon.stub(vscode.window, 'showQuickPick').resolves({
+            label: 'Classic Beads', backendId: 'bd',
+        });
+        sinon.stub(vscode.window, 'showInformationMessage').resolves(undefined);
+        const runCliStub = sinon.stub(runCliModule, 'runCli').resolves('Initialized.');
+        await (0, initWizard_1.initWizard)(makeContext(tmpDir), tmpDir);
+        assert.ok(runCliStub.calledWith('bd', ['init'], tmpDir), 'runCli should call bd init with the workspace root');
+        assert.ok(updateStub.calledWith('beadsBackend', 'bd', vscode.ConfigurationTarget.Workspace), 'config.update should set beadsBackend to bd');
+    });
+    // UT-5e -------------------------------------------------------------------
+    test('UT-5e: existing non-auto config + user keeps → early return, no QuickPick', async () => {
+        makeConfigStub('beads-ps1'); // already configured
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const infoStub = sinon.stub(vscode.window, 'showInformationMessage').resolves('Keep');
+        const qpStub = sinon.stub(vscode.window, 'showQuickPick');
+        await (0, initWizard_1.initWizard)(makeContext(tmpDir), tmpDir);
+        assert.ok(infoStub.called, 'info message should ask about existing config');
+        assert.ok(!qpStub.called, 'QuickPick should NOT be shown if user keeps current backend');
+    });
+});
+//# sourceMappingURL=initWizard.test.js.map

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

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

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

@@ -38,10 +38,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * UT-1: resolves with trimmed stdout on exit code 0
  * UT-2: rejects on non-zero exit code
  * UT-3: rejects on timeout
+ *
+ * Strategy: use the injectable _spawn parameter so cp.spawn is never stubbed
+ * directly (which fails in the VS Code Electron environment because the
+ * property descriptor is non-configurable and non-writable).
  */
 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) {
@@ -80,34 +82,19 @@ function fakeProc(opts) {
 // ---------------------------------------------------------------------------
 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();
-        }
+        const fakeSpawn = () => fakeProc({ stdout: 'hello\n', code: 0 });
+        const result = await (0, runCli_1.runCli)('echo', ['hello'], '/tmp', 30000, undefined, true, fakeSpawn);
+        assert.strictEqual(result, 'hello');
     });
     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();
-        }
+        const fakeSpawn = () => fakeProc({ stdout: '', stderr: 'err', code: 1 });
+        await assert.rejects((0, runCli_1.runCli)('false', [], '/tmp', 30000, undefined, true, fakeSpawn), /failed with exit code 1/);
     });
     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();
-        }
+        const fakeSpawn = () => fakeProc({ hangMs: 5000, code: null });
+        await assert.rejects((0, runCli_1.runCli)('sleep', ['5'], '/tmp', 100, undefined, true, fakeSpawn), /timed out/i);
     });
 });
 //# sourceMappingURL=runCli.test.js.map

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

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

package/out/utils/detectCli.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.detectCli = detectCli;
+exports.detectBackends = detectBackends;
+exports.formatDetectionSummary = formatDetectionSummary;
 /**
- * detectCli — checks whether a CLI binary is accessible on the system PATH.
+ * detectCli — PATH presence check + concurrent multi-backend probing.
  *
  * Uses the platform-appropriate tool (where on Windows, which on Unix) via
  * runCli so that detection is non-interactive and consistent with all other
@@ -27,4 +29,48 @@ async function detectCli(name) {
         return false;
     }
 }
+/**
+ * Probes bd, pwsh, powershell, and dolt in parallel (5 s timeout each).
+ * Each probe runs `<tool> --version`; any failure is recorded as version = null.
+ * Must never throw — safe to fire-and-forget on extension activation.
+ */
+async function detectBackends() {
+    const TIMEOUT_MS = 5000;
+    async function probeVersion(name) {
+        try {
+            const out = await (0, runCli_1.runCli)(name, ['--version'], process.cwd(), TIMEOUT_MS);
+            const firstLine = out.split('\n')[0].trim();
+            return { name, version: firstLine || null };
+        }
+        catch {
+            return { name, version: null };
+        }
+    }
+    const [bd, pwsh, powershell, dolt] = await Promise.all([
+        probeVersion('bd'),
+        probeVersion('pwsh'),
+        probeVersion('powershell'),
+        probeVersion('dolt'),
+    ]);
+    return { bd, pwsh, powershell, dolt };
+}
+/**
+ * Formats a DetectionResult as a multi-line summary suitable for the Output Channel.
+ *
+ * Example output:
+ *   Augment SDD: Detecting Beads backends...
+ *     ✓ bd           — [v1.4.2]
+ *     ✓ pwsh         — [7.4.1]
+ *     ✗ powershell   — not found
+ *     ✗ dolt         — not found
+ */
+function formatDetectionSummary(result) {
+    const lines = ['Augment SDD: Detecting Beads backends...'];
+    for (const probe of [result.bd, result.pwsh, result.powershell, result.dolt]) {
+        const icon = probe.version ? '  ✓' : '  ✗';
+        const versionStr = probe.version ? `[${probe.version}]` : 'not found';
+        lines.push(`${icon} ${probe.name.padEnd(12)} — ${versionStr}`);
+    }
+    return lines.join('\n');
+}
 //# sourceMappingURL=detectCli.js.map

package/out/utils/detectCli.js.map

@@ -1 +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"}
+{"version":3,"file":"detectCli.js","sourceRoot":"","sources":["../../src/utils/detectCli.ts"],"names":[],"mappings":";;AAeA,8BAWC;AA2BD,wCAqBC;AAYD,wDAQC;AA9FD;;;;;;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;AAsBD;;;;GAIG;AACI,KAAK,UAAU,cAAc;IAClC,MAAM,UAAU,GAAG,IAAK,CAAC;IAEzB,KAAK,UAAU,YAAY,CAAC,IAAY;QACtC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAA,eAAM,EAAC,IAAI,EAAE,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,CAAC;YACzE,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC5C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,IAAI,IAAI,EAAE,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACjC,CAAC;IACH,CAAC;IAED,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACrD,YAAY,CAAC,IAAI,CAAC;QAClB,YAAY,CAAC,MAAM,CAAC;QACpB,YAAY,CAAC,YAAY,CAAC;QAC1B,YAAY,CAAC,MAAM,CAAC;KACrB,CAAC,CAAC;IAEH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AACxC,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,sBAAsB,CAAC,MAAuB;IAC5D,MAAM,KAAK,GAAa,CAAC,0CAA0C,CAAC,CAAC;IACrE,KAAK,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7E,MAAM,IAAI,GAAQ,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;QAChD,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC;QACtE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,UAAU,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/out/utils/runCli.js

@@ -56,15 +56,21 @@ const MAX_LOGGED_ARGS_CHARS = 500;
  *  - 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 command    Executable name or path.
  * @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).
+ * @param shell      Whether to spawn via the OS shell (`shell: true`). Defaults
+ *                   to `true` for backward compatibility. Pass `false` when
+ *                   invoking `pwsh`/`powershell` directly so that Windows
+ *                   `cmd.exe` does not mangle script arguments.
  */
-function runCli(command, args, cwd, timeoutMs = 120000, logger) {
+function runCli(command, args, cwd, timeoutMs = 120000, logger, shell = true, 
+/** Injectable spawn implementation — override in tests to avoid real processes. */
+_spawn = cp.spawn) {
     // 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(' ');
@@ -73,7 +79,7 @@ function runCli(command, args, cwd, timeoutMs = 120000, logger) {
         : rawArgs;
     logger?.(`Run: ${command} ${displayArgs}`);
     return new Promise((resolve, reject) => {
-        const proc = cp.spawn(command, args, { cwd, shell: true });
+        const proc = _spawn(command, args, { cwd, shell });
         let stdout = '';
         let stderr = '';
         let settled = false;

package/out/utils/runCli.js.map

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

package/package.json

@@ -3,7 +3,7 @@
   "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",
+  "version": "1.1.0",
   "publisher": "mytech-today-now",
   "engines": {
     "vscode": "^1.85.0"
@@ -15,6 +15,11 @@
     "onStartupFinished"
   ],
   "main": "./out/extension.js",
+  "files": [
+    "out/**",
+    "scripts/beads-helpers.ps1",
+    "scripts/beads-query.ps1"
+  ],
   "contributes": {
     "commands": [
       {
@@ -36,6 +41,11 @@
         "command": "augmentSdd.fullPipeline",
         "title": "Augment SDD: Run Full Pipeline",
         "category": "Augment SDD"
+      },
+      {
+        "command": "augmentSdd.init",
+        "title": "Augment SDD: Initialize / Configure Backend",
+        "category": "Augment SDD"
       }
     ],
     "configuration": {
@@ -62,6 +72,17 @@
           "type": "boolean",
           "default": true,
           "description": "Show the Augment SDD Webview dashboard after pipeline steps."
+        },
+        "augmentSdd.beadsBackend": {
+          "type": "string",
+          "enum": ["auto", "bd", "beads-ps1"],
+          "enumDescriptions": [
+            "Auto-detect: use bd if available on PATH, fall back to scripts/beads-query.ps1 in the workspace.",
+            "Always use the classic bd CLI (requires bd.exe + dolt on PATH).",
+            "Always use the PowerShell scripts in scripts/ (no external dependencies)."
+          ],
+          "default": "auto",
+          "description": "Which Beads backend to use for issue tracking. Run 'Augment SDD: Init' to configure."
         }
       }
     }

package/.eslintrc.json

@@ -1,20 +0,0 @@
-{
-  "root": true,
-  "parser": "@typescript-eslint/parser",
-  "parserOptions": {
-    "ecmaVersion": 2020,
-    "sourceType": "module"
-  },
-  "plugins": ["@typescript-eslint"],
-  "extends": [
-    "eslint:recommended",
-    "plugin:@typescript-eslint/recommended"
-  ],
-  "rules": {
-    "@typescript-eslint/no-unused-vars": ["warn", { "argsIgnorePattern": "^_" }],
-    "@typescript-eslint/explicit-function-return-type": "off",
-    "@typescript-eslint/no-explicit-any": "warn"
-  },
-  "ignorePatterns": ["out", "node_modules"]
-}
-

package/src/commands/executeBeadsBatch.ts

@@ -1,153 +0,0 @@
-/**
- * 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}`;
-}
-