agentic-workflow-manager 3.9.0 → 3.10.0

package/dist/src/commands/preflight/checks.js

@@ -4,10 +4,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.preflight = preflight;
+const child_process_1 = require("child_process");
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const status_1 = require("../sensors/status");
 const init_1 = require("../sensors/init");
+const paths_1 = require("../../core/paths");
 const MANIFEST = path_1.default.join('.awm', 'sensors.json');
 /**
  * The agent needs project context delivered every session. A repo with neither file
@@ -106,6 +108,89 @@ function checkPack(cwd, manifest) {
     }
     return { id: 'pack', ok: true, detail: `${manifest.pack} matches the detected stack` };
 }
+/**
+ * Extract just the hostname portion of a git remote URL — never match against the
+ * full URL string. A bare substring check against the whole remote (`remote.includes
+ * ('gitlab')`) false-positives on an org/repo name that happens to contain the word,
+ * e.g. `git@github.enterprise.internal:kodria/gitlab-migration-tool.git` is a GitHub
+ * Enterprise remote, not GitLab — "gitlab" only appears in the repo name.
+ *
+ * Covers the two common remote URL shapes:
+ *   HTTPS: `https://github.com/org/repo.git`      -> `github.com`
+ *   SSH:   `git@github.com:org/repo.git`          -> `github.com`
+ *
+ * Scheme-prefixed remotes (`https://`, `ssh://`, ...) are parsed with the built-in
+ * `URL` class rather than a hand-rolled regex — `.hostname` is spec-defined to exclude
+ * both userinfo (`user:pass@`/`user@`) and `:port`, so a userinfo or password/token
+ * that happens to contain "github"/"gitlab" (e.g. an SSH username `ssh://gitlab@host/`
+ * or a CI credential-injection URL `https://x-access-token:$TOKEN@host/...`) can never
+ * leak into the matched host, and IPv6 literals in brackets are also handled correctly.
+ *
+ * The SCP-style shorthand (`user@host:path`, no scheme — not a real URI, so `URL`
+ * rejects it) falls back to a regex whose host-capture group excludes `@`, so a second
+ * `@` in the remote (`user@host@evil:path`) can't smuggle a bogus "host" past the colon
+ * check either — it simply fails to match and returns `undefined`.
+ *
+ * Returns `undefined` when neither shape matches, so callers fall through to the same
+ * "unrecognized host" handling as any other unmatched URL.
+ */
+function extractHost(remote) {
+    try {
+        return new URL(remote).hostname;
+    }
+    catch {
+        // Not a valid URL — likely git's SCP-like shorthand (user@host:path, no scheme).
+        // Node's URL class does not parse this form (it's not a real URI).
+    }
+    const scpMatch = remote.match(/^[^@\s]+@([^:\s@]+):/);
+    return scpMatch?.[1];
+}
+/**
+ * Advisory only — `ok` is ALWAYS `true` here, no matter what it finds. The
+ * `finishing-a-development-branch`/`receiving-code-review` skills detect the git host
+ * (GitHub vs GitLab) and shell out to `gh`/`glab` to open a PR/MR, degrading honestly
+ * when neither is on PATH. This check tells the operator, in advance, whether that
+ * downstream step will actually work — but plenty of legitimate workflows never create
+ * a PR/MR at all (merge locally, keep the branch as-is), so gating the whole harness on
+ * missing tooling here would be wrong. It is FYI, never a blocker.
+ */
+function checkHost(cwd) {
+    let remote;
+    try {
+        remote = (0, child_process_1.execFileSync)('git', ['remote', 'get-url', 'origin'], {
+            cwd,
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'], // no origin / not a repo prints to stderr — keep it off the operator's screen
+        }).trim();
+    }
+    catch {
+        // No `origin`, or not a git repo at all — nothing to advise on.
+        return { id: 'host', ok: true, detail: 'no git remote detected — PR/MR automation not applicable' };
+    }
+    const host = extractHost(remote);
+    if (host?.includes('github.com')) {
+        return (0, paths_1.resolveOnPath)('gh')
+            ? { id: 'host', ok: true, detail: 'github detected, gh available' }
+            : {
+                id: 'host',
+                ok: true,
+                detail: 'github detected, gh not on PATH — PR creation will require manual steps',
+                remedy: 'install the GitHub CLI (gh), or PR creation will need to be done manually',
+            };
+    }
+    if (host?.includes('gitlab')) {
+        return (0, paths_1.resolveOnPath)('glab')
+            ? { id: 'host', ok: true, detail: 'gitlab detected, glab available' }
+            : {
+                id: 'host',
+                ok: true,
+                detail: 'gitlab detected, glab not on PATH — MR creation will require manual steps',
+                remedy: 'install the GitLab CLI (glab), or MR creation will need to be done manually',
+            };
+    }
+    // Bitbucket, Azure DevOps, an internal git server, etc. — don't overclaim support.
+    return { id: 'host', ok: true, detail: 'git host not recognized (github/gitlab) — PR/MR automation not applicable' };
+}
 function preflight(cwd = process.cwd()) {
     const manifest = readManifest(cwd);
     const manifestExists = fs_1.default.existsSync(path_1.default.join(cwd, MANIFEST));
@@ -115,6 +200,9 @@ function preflight(cwd = process.cwd()) {
         // Skipped when there is no manifest: reporting "tools broken" on a repo that was
         // never set up buries the one thing the operator needs to read.
         ...(manifestExists ? [checkTools(cwd), checkPack(cwd, manifest)] : []),
+        // Runs unconditionally — orthogonal to sensor configuration entirely, this is
+        // about PR/MR tooling, not sensors.
+        checkHost(cwd),
     ];
     const status = !manifestExists ? 'not_configured'
         : checks.every(c => c.ok) ? 'ready'

package/dist/src/commands/sensors/changed.js

@@ -4,10 +4,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.changedFiles = changedFiles;
+exports.hasUnsafeWin32Chars = hasUnsafeWin32Chars;
 exports.applyChangedCmd = applyChangedCmd;
 exports.filterByExtension = filterByExtension;
 const child_process_1 = require("child_process");
 const path_1 = __importDefault(require("path"));
+const paths_1 = require("../../core/paths");
 function git(args, cwd) {
     return (0, child_process_1.execFileSync)('git', args, {
         cwd,
@@ -56,14 +58,82 @@ function changedFiles(cwd, base = 'HEAD') {
     const files = Array.from(new Set(out.map(s => s.trim()).filter(Boolean))).sort();
     return { files };
 }
+/**
+ * cmd.exe metacharacters that quoting does NOT reliably neutralize.
+ *
+ * Per the BatBadBut / CVE-2024-27980 research (flatt.tech/research/posts/batbadbut-
+ * you-cant-securely-execute-commands-on-windows/ — the paper Node's own CVE fix was
+ * based on), `%` still triggers environment-variable expansion *inside* a
+ * double-quoted string, and `&` can break a command out of quoting under certain
+ * conditions. cmd.exe parses these BEFORE the target program ever sees argv, so no
+ * amount of `"..."`/`\"` escaping at the argv layer (which is all `shellQuote` can
+ * touch) is a complete guarantee against them. Newline/CR are included because the
+ * same research flags them, and they are nonsensical in a real path regardless.
+ *
+ * This is a denylist, not an escaping table, on purpose: the responsible fix for
+ * this vulnerability class is to REFUSE (fall back to the full, unscoped command —
+ * see `run.ts`), not to hand-roll a smarter cmd.exe escaper. Node's own security
+ * team reached the same conclusion for the identical problem.
+ */
+const WIN32_UNSAFE_CHARS = /[&|<>^%\r\n]/;
+/** True when `file` contains a character cmd.exe would parse as its own syntax. */
+function hasUnsafeWin32Chars(file) {
+    return WIN32_UNSAFE_CHARS.test(file);
+}
+/**
+ * CommandLineToArgvW-safe quoting (the algorithm behind Python's
+ * `subprocess.list2cmdline`, Rust's `std::process::Command` on Windows, and .NET's
+ * argument escaper). Per the documented rule
+ * (learn.microsoft.com/en-us/cpp/c-language/parsing-c-command-line-arguments):
+ * an EVEN run of backslashes before a `"` collapses to half as many literal
+ * backslashes and the `"` is a real delimiter; an ODD run collapses the same way
+ * but the leftover backslash escapes the `"` into a literal character instead of a
+ * delimiter. Backslashes not followed by a `"` are always literal and untouched.
+ *
+ * This alone does not make interpolation safe on win32 — see `hasUnsafeWin32Chars`
+ * and its callers in `run.ts` for the metacharacter layer this cannot address.
+ */
+function win32ArgvQuote(arg) {
+    let result = '"';
+    let backslashes = 0;
+    for (const ch of arg) {
+        if (ch === '\\') {
+            backslashes++;
+        }
+        else if (ch === '"') {
+            result += '\\'.repeat(backslashes * 2 + 1) + '"';
+            backslashes = 0;
+        }
+        else {
+            result += '\\'.repeat(backslashes) + ch;
+            backslashes = 0;
+        }
+    }
+    result += '\\'.repeat(backslashes * 2); // double any trailing run before the closing quote
+    result += '"';
+    return result;
+}
 /**
  * Quote a path for a shell command line. Sensor commands are strings run through a
  * shell, so a path with a space or a quote in it would otherwise split into two
  * arguments — or, worse, end the quoting and let the rest of the name be read as
- * shell syntax. Single quotes with the `'\''` escape are the only form POSIX shells
- * treat as fully literal.
+ * shell syntax.
+ *
+ * `runCommand` (see `exec.ts`) spawns this string with `shell: true`, which on
+ * win32 is `cmd.exe`, not a POSIX shell. Single quotes are not quoting syntax to
+ * cmd.exe — it just splits on the space inside them — so a POSIX-only quote here
+ * would silently hand eslint/semgrep two garbage arguments instead of one real
+ * path. `'\''` (single quotes with the escape) is what POSIX shells treat as fully
+ * literal — no exceptions, per POSIX shell grammar, so no metacharacter denylist is
+ * needed on that branch. On win32, `win32ArgvQuote` is the argv-layer half of
+ * safety; the metacharacter denylist above (enforced by the caller in `run.ts`,
+ * before this function is ever reached) is the other half this function cannot
+ * provide on its own.
  */
 function shellQuote(file) {
+    if ((0, paths_1.isWindowsNative)()) {
+        return win32ArgvQuote(file);
+    }
     return `'${file.replace(/'/g, `'\\''`)}'`;
 }
 /**

package/dist/src/commands/sensors/exec.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runCommand = runCommand;
 const child_process_1 = require("child_process");
+const paths_1 = require("../../core/paths");
 const DEFAULT_MAX_BUFFER = 64 * 1024 * 1024;
 const DEFAULT_KILL_GRACE_MS = 2_000;
 /** After SIGKILL, resolve regardless. A sensor must never hang the gate. */
@@ -22,7 +23,7 @@ const POST_KILL_GRACE_MS = 1_000;
  * negative-pid kill reaches every descendant at once.
  */
 function killTree(pid, signal) {
-    if (process.platform === 'win32') {
+    if ((0, paths_1.isWindowsNative)()) {
         // Windows has no process groups in the POSIX sense; taskkill /T walks the tree.
         try {
             (0, child_process_1.execFile)('taskkill', ['/pid', String(pid), '/T', '/F'], () => { });
@@ -65,7 +66,7 @@ function runCommand(cmd, opts) {
         const child = (0, child_process_1.spawn)(cmd, {
             shell: true,
             cwd: opts.cwd,
-            detached: process.platform !== 'win32',
+            detached: !(0, paths_1.isWindowsNative)(),
             // stdin closed: a sensor must never block waiting for input, and the
             // EOF also tells watch-mode-capable tools (vitest, jest) to run once.
             stdio: ['ignore', 'pipe', 'pipe'],

package/dist/src/commands/sensors/run.js

@@ -21,6 +21,7 @@ const baseline_1 = require("./baseline");
 const changed_1 = require("./changed");
 const init_1 = require("./init");
 const registries_1 = require("../../core/registries");
+const paths_1 = require("../../core/paths");
 const MANIFEST_FILE = '.awm/sensors.json';
 const DEFAULT_FAST_TIMEOUT = 10_000;
 const DEFAULT_SLOW_TIMEOUT = 120_000;
@@ -268,6 +269,21 @@ async function runSensors(opts = {}) {
     // Resolved once for the whole run, not per sensor: `git` is cheap but the answer
     // must be identical across sensors, or two of them scope to different file sets.
     const changed = opts.changed ? (0, changed_1.changedFiles)(cwd, opts.base ?? 'HEAD') : null;
+    // Security (BatBadBut / CVE-2024-27980): on native Windows, `runCommand` spawns
+    // the sensor command through cmd.exe (`shell: true`), which parses `& | < > ^ %`
+    // as ITS OWN syntax before the target program ever sees argv — quoting does not
+    // reliably neutralize this layer (the primary research this fix is based on
+    // concludes escaping it is not safely possible). A changed filename carrying one
+    // of these is refused, not escaped: routed through the exact same fallback the
+    // module already has for "scope could not be resolved" (`changed.error`), so
+    // every sensor degrades to its full unscoped command rather than interpolating
+    // an unsafe path. POSIX is unaffected — single-quote quoting there is fully
+    // literal per POSIX shell grammar, no metacharacter exception exists.
+    if (changed && !changed.error && (0, paths_1.isWindowsNative)() && changed.files.some(changed_1.hasUnsafeWin32Chars)) {
+        changed.error = 'a changed filename contains a cmd.exe metacharacter (& | < > ^ % or newline/CR) '
+            + 'that quoting cannot reliably neutralize on native Windows — refusing to interpolate it, '
+            + 'falling back to the full unscoped command';
+    }
     // Sensors are independent processes over the same tree, so they run
     // concurrently rather than one-after-another: wall clock becomes the slowest
     // sensor instead of the sum of all of them. Tasks are built — and dispatched —

package/dist/src/commands/sensors/status.js

@@ -4,9 +4,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.computeSensorStatus = computeSensorStatus;
-const child_process_1 = require("child_process");
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
+const paths_1 = require("../../core/paths");
 /** First non-flag token after `npx` — the tool the command actually runs. */
 function npxTool(parts) {
     for (let i = 1; i < parts.length; i++) {
@@ -29,7 +29,7 @@ function configCheck(parts, cwd) {
  * - `npx <tool>`: the tool MUST be installed locally (node_modules/.bin). Otherwise
  *   `npx` would fetch a remote package at run time (dependency-confusion risk) and
  *   the sensor would fail. A green status here would be a lie.
- * - other binaries: must resolve on PATH (`which`).
+ * - other binaries: must resolve on PATH (`where` on win32, `command -v` elsewhere).
  * - any `--config <file>` referenced must exist.
  */
 function checkCmd(cmd, cwd) {
@@ -48,10 +48,7 @@ function checkCmd(cmd, cwd) {
         }
         return configCheck(parts, cwd) ?? { ok: true, detail: `${tool} (node_modules/.bin)` };
     }
-    try {
-        (0, child_process_1.execSync)(`which ${bin}`, { stdio: 'pipe' });
-    }
-    catch {
+    if (!(0, paths_1.resolveOnPath)(bin)) {
         return { ok: false, detail: `${bin} not found in PATH` };
     }
     return configCheck(parts, cwd) ?? { ok: true, detail: bin };

package/dist/src/core/paths.js

@@ -10,6 +10,7 @@ exports.platform = platform;
 exports.isWindowsNative = isWindowsNative;
 exports.platformLabel = platformLabel;
 exports.warnIfUnsupportedPlatform = warnIfUnsupportedPlatform;
+exports.resolveOnPath = resolveOnPath;
 // cli/src/core/paths.ts
 //
 // Single source of truth for home / AWM_HOME resolution and platform detection.
@@ -17,6 +18,7 @@ exports.warnIfUnsupportedPlatform = warnIfUnsupportedPlatform;
 // always honored and tests need no jest.resetModules().
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
+const child_process_1 = require("child_process");
 /** User home directory with a robust fallback. Never returns a raw, possibly-empty process.env.HOME. */
 function homeDir() {
     return process.env.HOME || os_1.default.homedir();
@@ -54,3 +56,14 @@ function warnIfUnsupportedPlatform(log) {
     if (isWindowsNative())
         log(exports.WINDOWS_NATIVE_WARNING);
 }
+/** Resolve a binary on PATH portably: `where` on win32, POSIX `command -v` elsewhere. */
+function resolveOnPath(bin) {
+    const cmd = isWindowsNative() ? `where ${bin}` : `command -v ${bin}`;
+    try {
+        (0, child_process_1.execSync)(cmd, { stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/tests/commands/preflight/preflight.test.js

@@ -6,8 +6,23 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const fs_1 = __importDefault(require("fs"));
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
+const child_process_1 = require("child_process");
 const checks_1 = require("../../../src/commands/preflight/checks");
 const preflight_1 = require("../../../src/commands/preflight");
+// Only `execSync` (used by `resolveOnPath` to check for `gh`/`glab`) is mocked — `git
+// remote get-url origin` runs for real via `execFileSync` against real tmpdir git repos,
+// same as every other check in this file exercises the real filesystem.
+jest.mock('child_process', () => ({
+    ...jest.requireActual('child_process'),
+    execSync: jest.fn(),
+}));
+const mockExecSync = child_process_1.execSync;
+/** Turn a tmpdir into a real git repo with (optionally) an `origin` remote. */
+function gitRepo(dir, remoteUrl) {
+    (0, child_process_1.execFileSync)('git', ['init'], { cwd: dir, stdio: 'pipe' });
+    if (remoteUrl)
+        (0, child_process_1.execFileSync)('git', ['remote', 'add', 'origin', remoteUrl], { cwd: dir, stdio: 'pipe' });
+}
 /** CLAUDE.md: no test may reach the real ~/.awm. Everything here is a tmpdir. */
 function project(opts = {}) {
     const dir = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'awm-preflight-'));
@@ -112,6 +127,156 @@ describe('preflight', () => {
         expect((0, preflight_1.exitCodeFor)({ status: 'degraded', checks: [] })).toBe(1);
         expect((0, preflight_1.exitCodeFor)({ status: 'ready', checks: [] })).toBe(0);
     });
+    describe('host check (advisory — never changes the exit code)', () => {
+        beforeEach(() => { mockExecSync.mockReset(); });
+        it('reports github + gh available, and does not affect status', () => {
+            const dir = make({ manifest: { pack: 'generic', sensors: {} } });
+            gitRepo(dir, 'git@github.com:kodria/agentic-workflow.git');
+            mockExecSync.mockImplementation(((cmd) => {
+                if (cmd === 'command -v gh')
+                    return Buffer.from('/usr/bin/gh');
+                throw new Error(`not found: ${cmd}`);
+            }));
+            const report = (0, checks_1.preflight)(dir);
+            expect(check(report, 'host').ok).toBe(true);
+            expect(check(report, 'host').detail).toBe('github detected, gh available');
+            expect(report.status).toBe('ready');
+        });
+        it('is still ok:true (advisory only) when gitlab is detected but glab is not on PATH, and status stays ready', () => {
+            // The only thing "wrong" in this fixture is the missing `glab` — proving the
+            // advisory contract: it must not drag an otherwise-clean repo to `degraded`.
+            const dir = make({ manifest: { pack: 'generic', sensors: {} } });
+            gitRepo(dir, 'https://gitlab.com/kodria/agentic-workflow.git');
+            mockExecSync.mockImplementation((() => {
+                throw new Error('not found');
+            }));
+            const report = (0, checks_1.preflight)(dir);
+            expect(check(report, 'host').ok).toBe(true);
+            expect(check(report, 'host').detail).toContain('glab not on PATH');
+            expect(check(report, 'host').remedy).toContain('glab');
+            expect(report.status).toBe('ready');
+        });
+        it('handles no origin remote gracefully — no throw, ok:true, minimal detail', () => {
+            const dir = make({ manifest: { pack: 'generic', sensors: {} } });
+            // Not a git repo at all — the common case for `execFileSync` failing here.
+            const report = (0, checks_1.preflight)(dir);
+            expect(check(report, 'host').ok).toBe(true);
+            expect(check(report, 'host').detail).toBe('no git remote detected — PR/MR automation not applicable');
+            expect(check(report, 'host').remedy).toBeUndefined();
+            expect(report.status).toBe('ready');
+        });
+        it('handles a git repo with no origin remote configured gracefully', () => {
+            const dir = make({ manifest: { pack: 'generic', sensors: {} } });
+            gitRepo(dir); // git init, no remote
+            const report = (0, checks_1.preflight)(dir);
+            expect(check(report, 'host').ok).toBe(true);
+            expect(check(report, 'host').detail).toContain('no git remote detected');
+        });
+        it('does not overclaim support for an unrecognized host', () => {
+            const dir = make({ manifest: { pack: 'generic', sensors: {} } });
+            gitRepo(dir, 'git@bitbucket.org:kodria/agentic-workflow.git');
+            const report = (0, checks_1.preflight)(dir);
+            expect(check(report, 'host').ok).toBe(true);
+            expect(check(report, 'host').detail).toContain('not recognized');
+            expect(report.status).toBe('ready');
+        });
+        it('does not misclassify a GitHub Enterprise host whose repo NAME contains "gitlab"', () => {
+            // The bug: a bare `remote.includes('gitlab')` matches the full remote URL
+            // string, so an org/repo name containing "gitlab" false-positives even though
+            // the actual host is unrelated. Hostname must be extracted first and matched
+            // in isolation.
+            const dir = make({ manifest: { pack: 'generic', sensors: {} } });
+            gitRepo(dir, 'git@github.enterprise.internal:kodria/gitlab-migration-tool.git');
+            const report = (0, checks_1.preflight)(dir);
+            expect(check(report, 'host').ok).toBe(true);
+            expect(check(report, 'host').detail).toContain('not recognized');
+            expect(report.status).toBe('ready');
+        });
+        it('does not misclassify a non-GitHub host whose repo NAME contains "github"', () => {
+            // Same class of bug on the github side: "something-github-tool" is a repo
+            // name, not the host.
+            const dir = make({ manifest: { pack: 'generic', sensors: {} } });
+            gitRepo(dir, 'https://example.com/kodria/something-github-tool.git');
+            const report = (0, checks_1.preflight)(dir);
+            expect(check(report, 'host').ok).toBe(true);
+            expect(check(report, 'host').detail).toContain('not recognized');
+            expect(report.status).toBe('ready');
+        });
+        it('does not misclassify a GitHub Enterprise host whose SSH USERNAME is "gitlab"', () => {
+            // The related bug: the scheme-based regex captured everything between
+            // `scheme://` and the first `/`, including `userinfo@` — so an SSH username
+            // of "gitlab" leaked into the matched "host" string and false-positived the
+            // `.includes('gitlab')` check even though the real host is GitHub
+            // Enterprise. `new URL(...).hostname` must exclude userinfo entirely.
+            //
+            // Note: `github.company-internal.com` legitimately contains the substring
+            // "github.com" (from "company"), so — with the userinfo bug fixed — this
+            // correctly classifies as github (checkHost's own substring matching is a
+            // separate, pre-existing design, not part of this fix). The regression this
+            // test guards is that it must never again read as gitlab.
+            const dir = make({ manifest: { pack: 'generic', sensors: {} } });
+            gitRepo(dir, 'ssh://gitlab@github.company-internal.com:22/team/repo.git');
+            mockExecSync.mockImplementation((() => { throw new Error('not found'); }));
+            const report = (0, checks_1.preflight)(dir);
+            expect(check(report, 'host').ok).toBe(true);
+            expect(check(report, 'host').detail).toContain('github detected');
+            expect(check(report, 'host').detail).not.toContain('gitlab');
+            expect(report.status).toBe('ready');
+        });
+        it('does not misclassify a host whose injected credential/token contains "gitlab"', () => {
+            // A realistic CI credential-injection remote:
+            // `git remote set-url origin https://x-access-token:$TOKEN@host/...`. If the
+            // token or password happens to contain "gitlab", it must not leak into the
+            // matched host either.
+            const dir = make({ manifest: { pack: 'generic', sensors: {} } });
+            gitRepo(dir, 'https://user:gitlab@example-host.com/org/repo.git');
+            const report = (0, checks_1.preflight)(dir);
+            expect(check(report, 'host').ok).toBe(true);
+            expect(check(report, 'host').detail).toContain('not recognized');
+            expect(report.status).toBe('ready');
+        });
+        it('does not misclassify an SCP-style remote with a second "@" in it', () => {
+            // `user@host:path` shorthand has no scheme for `URL` to parse, so it falls
+            // back to a regex. A second "@" (e.g. a malformed/adversarial remote) must
+            // not let a bogus "host@evil"-shaped capture slip past the colon check —
+            // the host-capture group excludes "@", so this fails to match at all and
+            // falls through to "unrecognized" rather than misclassifying as gitlab.
+            const dir = make({ manifest: { pack: 'generic', sensors: {} } });
+            gitRepo(dir, 'user@github.com@gitlab.evil:org/repo.git');
+            const report = (0, checks_1.preflight)(dir);
+            expect(check(report, 'host').ok).toBe(true);
+            expect(check(report, 'host').detail).toContain('not recognized');
+            expect(report.status).toBe('ready');
+        });
+        it('still detects github.com over HTTPS', () => {
+            const dir = make({ manifest: { pack: 'generic', sensors: {} } });
+            gitRepo(dir, 'https://github.com/org/repo.git');
+            mockExecSync.mockImplementation((() => { throw new Error('not found'); }));
+            const report = (0, checks_1.preflight)(dir);
+            expect(check(report, 'host').detail).toContain('github detected');
+        });
+        it('still detects github.com over SSH shorthand', () => {
+            const dir = make({ manifest: { pack: 'generic', sensors: {} } });
+            gitRepo(dir, 'git@github.com:org/repo.git');
+            mockExecSync.mockImplementation((() => { throw new Error('not found'); }));
+            const report = (0, checks_1.preflight)(dir);
+            expect(check(report, 'host').detail).toContain('github detected');
+        });
+        it('still detects gitlab over HTTPS', () => {
+            const dir = make({ manifest: { pack: 'generic', sensors: {} } });
+            gitRepo(dir, 'https://gitlab.example.com/org/repo.git');
+            mockExecSync.mockImplementation((() => { throw new Error('not found'); }));
+            const report = (0, checks_1.preflight)(dir);
+            expect(check(report, 'host').detail).toContain('gitlab detected');
+        });
+        it('still detects gitlab over SSH shorthand', () => {
+            const dir = make({ manifest: { pack: 'generic', sensors: {} } });
+            gitRepo(dir, 'git@gitlab.example.com:org/repo.git');
+            mockExecSync.mockImplementation((() => { throw new Error('not found'); }));
+            const report = (0, checks_1.preflight)(dir);
+            expect(check(report, 'host').detail).toContain('gitlab detected');
+        });
+    });
     it('tells the operator not to hand a broken harness to an unattended run', () => {
         const out = (0, preflight_1.formatReport)({
             status: 'not_configured',

package/dist/tests/commands/sensors/changed-windows.test.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const changed_1 = require("../../../src/commands/sensors/changed");
+describe('applyChangedCmd — Windows quoting', () => {
+    const originalPlatform = process.platform;
+    beforeEach(() => {
+        Object.defineProperty(process, 'platform', { value: 'win32' });
+    });
+    afterEach(() => {
+        Object.defineProperty(process, 'platform', { value: originalPlatform });
+    });
+    it('double-quotes paths on win32 instead of POSIX single-quoting', () => {
+        // `runCommand` spawns this string with `shell: true`, which is cmd.exe on
+        // win32. cmd.exe does not treat single quotes as quoting syntax — it would
+        // split `'my dir/a.ts'` into two garbage arguments on the space. Double
+        // quotes are the form cmd.exe actually honors.
+        expect((0, changed_1.applyChangedCmd)('eslint {files}', ['my dir/a.ts']))
+            .toBe(`eslint "my dir/a.ts"`);
+    });
+    it('escapes an embedded double quote with a preceding backslash', () => {
+        expect((0, changed_1.applyChangedCmd)('eslint {files}', ['weird"name.ts']))
+            .toBe(`eslint "weird\\"name.ts"`);
+    });
+    it('handles a filename with both a space and an embedded quote together', () => {
+        expect((0, changed_1.applyChangedCmd)('eslint {files}', ['my dir/it"s.ts']))
+            .toBe(`eslint "my dir/it\\"s.ts"`);
+    });
+    it('doubles a lone trailing backslash so the closing quote is not escaped away', () => {
+        // Bug 1 (correctness): a filename ending in a single `\` (e.g. a scoped path
+        // like `report\`), naively closed with `..."report\""`, puts an ODD number of
+        // backslashes (1) directly before the closing `"`. Per the documented
+        // CommandLineToArgvW rule (learn.microsoft.com/en-us/cpp/c-language/parsing-c-command-line-arguments),
+        // an odd backslash run before a `"` consumes the backslashes in pairs (0
+        // literal here) and the last one escapes the quote into a literal character —
+        // so the wrapper never closes and the argument is corrupted/unterminated.
+        //
+        // The correct output doubles the trailing run to an EVEN count (2) before the
+        // closing quote: even backslashes before a `"` collapse to half as many
+        // literal backslashes (1) and the `"` is read as a real delimiter, closing the
+        // wrapper cleanly and recovering exactly the original single trailing `\`.
+        expect((0, changed_1.applyChangedCmd)('eslint {files}', ['report\\']))
+            .toBe(`eslint "report\\\\"`);
+    });
+});

package/dist/tests/commands/sensors/changed.test.js

@@ -93,6 +93,10 @@ describe('applyChangedCmd', () => {
         expect((0, changed_1.applyChangedCmd)('eslint {files}', ["it's.ts"]))
             .toBe(`eslint 'it'\\''s.ts'`);
     });
+    it('handles a filename with both a space and an embedded quote together', () => {
+        expect((0, changed_1.applyChangedCmd)('eslint {files}', ["my dir/it's.ts"]))
+            .toBe(`eslint 'my dir/it'\\''s.ts'`);
+    });
 });
 describe('filterByExtension', () => {
     it('drops files the sensor cannot be handed', () => {

package/dist/tests/commands/sensors/exec-windows.test.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const events_1 = require("events");
+const child_process_1 = require("child_process");
+const exec_1 = require("../../../src/commands/sensors/exec");
+jest.mock('child_process', () => ({
+    spawn: jest.fn(),
+    execFile: jest.fn(),
+}));
+const mockSpawn = child_process_1.spawn;
+const mockExecFile = child_process_1.execFile;
+/** Minimal stand-in for a ChildProcess: enough surface for exec.ts to drive. */
+function fakeChild(pid = 4242) {
+    const child = new events_1.EventEmitter();
+    child.pid = pid;
+    child.stdout = new events_1.EventEmitter();
+    child.stderr = new events_1.EventEmitter();
+    child.unref = jest.fn();
+    return child;
+}
+describe('runCommand — win32', () => {
+    const originalPlatform = process.platform;
+    beforeEach(() => {
+        Object.defineProperty(process, 'platform', { value: 'win32' });
+        mockSpawn.mockReset();
+        mockExecFile.mockReset();
+    });
+    afterEach(() => {
+        Object.defineProperty(process, 'platform', { value: originalPlatform });
+        jest.useRealTimers();
+    });
+    it('spawns with detached: false — win32 has no POSIX process groups to detach into', async () => {
+        const child = fakeChild();
+        mockSpawn.mockReturnValue(child);
+        const pending = (0, exec_1.runCommand)('echo hi', { timeout: 5000, cwd: process.cwd() });
+        expect(mockSpawn).toHaveBeenCalledWith('echo hi', expect.objectContaining({ detached: false }));
+        child.emit('close', 0, null);
+        const r = await pending;
+        expect(r.code).toBe(0);
+    });
+    it('kills via `taskkill /pid <pid> /T /F` on timeout, never the POSIX process.kill(-pid) path', async () => {
+        jest.useFakeTimers();
+        const child = fakeChild(4242);
+        mockSpawn.mockReturnValue(child);
+        mockExecFile.mockImplementation(((...args) => {
+            const cb = args[args.length - 1];
+            if (typeof cb === 'function')
+                cb(null, '', '');
+            return {};
+        }));
+        const posixKillSpy = jest.spyOn(process, 'kill').mockImplementation(() => true);
+        const pending = (0, exec_1.runCommand)('slow-command', {
+            timeout: 1000,
+            cwd: process.cwd(),
+            killGraceMs: 500,
+        });
+        // Fire the deadline: cutShort() -> killTree(pid, 'SIGTERM').
+        jest.advanceTimersByTime(1000);
+        expect(mockExecFile).toHaveBeenCalledWith('taskkill', ['/pid', '4242', '/T', '/F'], expect.any(Function));
+        // The win32 branch returns before ever reaching the POSIX fallback.
+        expect(posixKillSpy).not.toHaveBeenCalled();
+        // Escalation to SIGKILL, then the post-kill grace that resolves regardless.
+        jest.advanceTimersByTime(500);
+        expect(mockExecFile).toHaveBeenCalledWith('taskkill', ['/pid', '4242', '/T', '/F'], expect.any(Function));
+        expect(mockExecFile).toHaveBeenCalledTimes(2);
+        expect(posixKillSpy).not.toHaveBeenCalled();
+        jest.advanceTimersByTime(1000);
+        const r = await pending;
+        expect(r.timedOut).toBe(true);
+        expect(r.signal).toBe('SIGKILL');
+        posixKillSpy.mockRestore();
+    });
+});

package/dist/tests/commands/sensors/run-changed.test.js

@@ -133,4 +133,39 @@ describe('runSensors --changed', () => {
         await load().runSensors({ cwd: dir, changed: true, base: 'main' });
         expect(mockChangedFiles).toHaveBeenCalledWith(dir, 'main');
     });
+    describe('on native Windows, with an unsafe changed filename', () => {
+        // Bug 2 (security): `runCommand` (exec.ts) spawns the sensor command with
+        // `shell: true`, which on win32 is cmd.exe — it parses `& | < > ^ %` as its
+        // OWN metacharacters BEFORE the target program ever sees argv, regardless of
+        // `"..."` wrapping in many cases (BatBadBut / CVE-2024-27980 research: `%`
+        // still triggers variable expansion inside double-quoted strings, and `&` can
+        // break out of a quoted string). Escaping these reliably is a known-unreliable
+        // approach, so the fix REFUSES: any changed file with one of these characters
+        // (on native Windows only) makes the whole scope unsafe to interpolate, and
+        // the run degrades to the sensor's full unscoped command instead — the exact
+        // fallback already used when `changedFiles()` cannot resolve the scope at all.
+        const originalPlatform = process.platform;
+        beforeEach(() => {
+            Object.defineProperty(process, 'platform', { value: 'win32' });
+        });
+        afterEach(() => {
+            Object.defineProperty(process, 'platform', { value: originalPlatform });
+        });
+        it('falls back to the full command instead of interpolating the unsafe filename', async () => {
+            dir = project({ lint: LINT });
+            mockChangedFiles.mockReturnValue({ files: ['src/a.ts', 'evil&name.ts'] });
+            const out = await load().runSensors({ cwd: dir, changed: true });
+            // The unsafe filename must never reach the dispatched command line, quoted
+            // or otherwise — assert on the actual command, not just "no crash".
+            expect(cmds()).toContain('eslint --format json .');
+            expect(cmds().join(' ')).not.toContain('evil&name.ts');
+            expect(out.sensors[0].scope).toBeUndefined();
+        });
+        it('reports the unsafe scope the same way an unresolved scope is reported', async () => {
+            dir = project({ lint: LINT });
+            mockChangedFiles.mockReturnValue({ files: ['evil&name.ts'] });
+            const out = await load().runSensors({ cwd: dir, changed: true });
+            expect(out.changedScope?.error).toBeDefined();
+        });
+    });
 });

package/dist/tests/commands/sensors/status-windows.test.js

@@ -0,0 +1,55 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const child_process_1 = require("child_process");
+const status_1 = require("../../../src/commands/sensors/status");
+jest.mock('child_process', () => ({ execSync: jest.fn() }));
+const mockExecSync = child_process_1.execSync;
+describe('computeSensorStatus — Windows PATH resolution', () => {
+    let tmpDir;
+    const originalPlatform = process.platform;
+    beforeEach(() => {
+        tmpDir = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'awm-status-win-'));
+        mockExecSync.mockReset();
+        Object.defineProperty(process, 'platform', { value: 'win32' });
+    });
+    afterEach(() => {
+        fs_1.default.rmSync(tmpDir, { recursive: true });
+        Object.defineProperty(process, 'platform', { value: originalPlatform });
+    });
+    it('resolves an installed binary on win32 using `where`, not `which`', () => {
+        fs_1.default.mkdirSync(path_1.default.join(tmpDir, '.awm'), { recursive: true });
+        fs_1.default.writeFileSync(path_1.default.join(tmpDir, '.awm', 'sensors.json'), JSON.stringify({
+            pack: 'js-ts',
+            sensors: { security: { cmd: 'semgrep --json .', fast: false } }
+        }));
+        mockExecSync.mockImplementation(((cmd) => {
+            if (cmd.startsWith('where '))
+                return Buffer.from('C:\\tools\\semgrep.exe');
+            throw new Error(`not found: ${cmd}`);
+        }));
+        const result = (0, status_1.computeSensorStatus)(tmpDir);
+        expect(result.overall).toBe('HEALTHY');
+        expect(result.checks.security.ok).toBe(true);
+    });
+    it('reports ok:false on win32 when `where` cannot find the binary', () => {
+        fs_1.default.mkdirSync(path_1.default.join(tmpDir, '.awm'), { recursive: true });
+        fs_1.default.writeFileSync(path_1.default.join(tmpDir, '.awm', 'sensors.json'), JSON.stringify({
+            pack: 'js-ts',
+            sensors: { security: { cmd: 'semgrep --json .', fast: false } }
+        }));
+        mockExecSync.mockImplementation(((cmd) => {
+            if (cmd.startsWith('where '))
+                throw new Error(`not found: ${cmd}`);
+            throw new Error(`not found: ${cmd}`);
+        }));
+        const result = (0, status_1.computeSensorStatus)(tmpDir);
+        expect(result.overall).toBe('DEGRADED');
+        expect(result.checks.security.ok).toBe(false);
+    });
+});

package/dist/tests/commands/sensors/status.test.js

@@ -85,6 +85,30 @@ describe('computeSensorStatus', () => {
         expect(result.overall).toBe('DEGRADED');
         expect(result.checks.security.ok).toBe(false);
     });
+    describe('on POSIX', () => {
+        const originalPlatform = process.platform;
+        beforeEach(() => {
+            Object.defineProperty(process, 'platform', { value: 'linux' });
+        });
+        afterEach(() => {
+            Object.defineProperty(process, 'platform', { value: originalPlatform });
+        });
+        it('resolves an installed binary using `command -v`, not `where`', () => {
+            fs_1.default.mkdirSync(path_1.default.join(tmpDir, '.awm'), { recursive: true });
+            fs_1.default.writeFileSync(path_1.default.join(tmpDir, '.awm', 'sensors.json'), JSON.stringify({
+                pack: 'js-ts',
+                sensors: { security: { cmd: 'semgrep --json .', fast: false } }
+            }));
+            mockExecSync.mockImplementation(((cmd) => {
+                if (cmd === 'command -v semgrep')
+                    return Buffer.from('/usr/bin/semgrep');
+                throw new Error(`not found: ${cmd}`);
+            }));
+            const result = (0, status_1.computeSensorStatus)(tmpDir);
+            expect(result.overall).toBe('HEALTHY');
+            expect(result.checks.security.ok).toBe(true);
+        });
+    });
     it('marks disabled sensors as ok', () => {
         fs_1.default.mkdirSync(path_1.default.join(tmpDir, '.awm'), { recursive: true });
         fs_1.default.writeFileSync(path_1.default.join(tmpDir, '.awm', 'sensors.json'), JSON.stringify({

package/dist/tests/core/paths.test.js

@@ -5,7 +5,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
+const child_process_1 = require("child_process");
 const paths_1 = require("../../src/core/paths");
+jest.mock('child_process', () => ({ execSync: jest.fn() }));
+const mockExecSync = child_process_1.execSync;
 describe('core/paths', () => {
     let origHome;
     let origAwmHome;
@@ -13,6 +16,7 @@ describe('core/paths', () => {
     beforeEach(() => {
         origHome = process.env.HOME;
         origAwmHome = process.env.AWM_HOME;
+        mockExecSync.mockReset();
     });
     afterEach(() => {
         if (origHome === undefined)
@@ -75,4 +79,34 @@ describe('core/paths', () => {
         (0, paths_1.warnIfUnsupportedPlatform)(log);
         expect(calls).toEqual([paths_1.WINDOWS_NATIVE_WARNING]);
     });
+    describe('resolveOnPath', () => {
+        it('uses `command -v` on POSIX and returns true when the binary resolves', () => {
+            setPlatform('linux');
+            mockExecSync.mockImplementation(((cmd) => {
+                if (cmd === 'command -v semgrep')
+                    return Buffer.from('/usr/bin/semgrep');
+                throw new Error(`not found: ${cmd}`);
+            }));
+            expect((0, paths_1.resolveOnPath)('semgrep')).toBe(true);
+        });
+        it('returns false on POSIX when `command -v` fails to resolve the binary', () => {
+            setPlatform('linux');
+            mockExecSync.mockImplementation(() => { throw new Error('not found'); });
+            expect((0, paths_1.resolveOnPath)('semgrep')).toBe(false);
+        });
+        it('uses `where` on win32, not `command -v`', () => {
+            setPlatform('win32');
+            mockExecSync.mockImplementation(((cmd) => {
+                if (cmd === 'where semgrep')
+                    return Buffer.from('C:\\tools\\semgrep.exe');
+                throw new Error(`not found: ${cmd}`);
+            }));
+            expect((0, paths_1.resolveOnPath)('semgrep')).toBe(true);
+        });
+        it('returns false on win32 when `where` cannot find the binary', () => {
+            setPlatform('win32');
+            mockExecSync.mockImplementation(() => { throw new Error('not found'); });
+            expect((0, paths_1.resolveOnPath)('semgrep')).toBe(false);
+        });
+    });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-workflow-manager",
-  "version": "3.9.0",
+  "version": "3.10.0",
   "main": "dist/src/index.js",
   "bin": {
     "awm": "./dist/src/index.js"