@gempack/squad-mcp 0.3.1 → 0.6.0

package/dist/resources/agent-loader.js

@@ -1,36 +1,49 @@
-import { promises as fs } from 'node:fs';
-import path from 'node:path';
-import os from 'node:os';
-import { fileURLToPath } from 'node:url';
-import { AGENTS } from '../config/ownership-matrix.js';
-import { SquadError } from '../errors.js';
-import { logger } from '../observability/logger.js';
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import { fileURLToPath } from "node:url";
+import { AGENTS } from "../config/ownership-matrix.js";
+import { SquadError } from "../errors.js";
+import { logger } from "../observability/logger.js";
+import { validateOverrideDir, validateOverrideFile, rejectionToError, getAllowlistSize, __resetOverrideAllowlistCache, } from "../util/override-allowlist.js";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const AGENT_FILE_MAP = {
-    po: 'PO.md',
-    'tech-lead-planner': 'TechLead-Planner.md',
-    'tech-lead-consolidator': 'TechLead-Consolidator.md',
-    'senior-architect': 'Senior-Architect.md',
-    'senior-dba': 'Senior-DBA.md',
-    'senior-developer': 'Senior-Developer.md',
-    'senior-dev-reviewer': 'Senior-Dev-Reviewer.md',
-    'senior-dev-security': 'Senior-Dev-Security.md',
-    'senior-qa': 'Senior-QA.md',
+    'product-owner': "product-owner.md",
+    "tech-lead-planner": "tech-lead-planner.md",
+    "tech-lead-consolidator": "tech-lead-consolidator.md",
+    "senior-architect": "senior-architect.md",
+    "senior-dba": "senior-dba.md",
+    "senior-developer": "senior-developer.md",
+    "senior-dev-reviewer": "senior-dev-reviewer.md",
+    "senior-dev-security": "senior-dev-security.md",
+    "senior-qa": "senior-qa.md",
 };
-export const SHARED_FILES = ['_Severity-and-Ownership.md', 'Skill-Squad-Dev.md', 'Skill-Squad-Review.md'];
+export const SHARED_FILES = [
+    "_shared/_Severity-and-Ownership.md",
+    "_shared/Skill-Squad-Dev.md",
+    "_shared/Skill-Squad-Review.md",
+];
 function defaultLocalDir() {
-    if (process.platform === 'win32') {
-        const appdata = process.env.APPDATA ?? path.join(os.homedir(), 'AppData', 'Roaming');
-        return path.join(appdata, 'squad-mcp', 'agents');
+    if (process.platform === "win32") {
+        const appdata = process.env.APPDATA ?? path.join(os.homedir(), "AppData", "Roaming");
+        return path.join(appdata, "squad-mcp", "agents");
     }
-    const xdg = process.env.XDG_CONFIG_HOME ?? path.join(os.homedir(), '.config');
-    return path.join(xdg, 'squad-mcp', 'agents');
+    const xdg = process.env.XDG_CONFIG_HOME ?? path.join(os.homedir(), ".config");
+    return path.join(xdg, "squad-mcp", "agents");
 }
+/**
+ * Returns the configured override directory and whether it was set explicitly
+ * via `SQUAD_AGENTS_DIR`. Empty string is treated as unset.
+ */
 export function getLocalDir() {
-    return process.env.SQUAD_AGENTS_DIR ?? defaultLocalDir();
+    const env = process.env.SQUAD_AGENTS_DIR;
+    if (env !== undefined && env !== "") {
+        return { rawDir: env, explicit: true };
+    }
+    return { rawDir: defaultLocalDir(), explicit: false };
 }
 export function getEmbeddedDir() {
-    return path.resolve(__dirname, '..', '..', 'agents');
+    return path.resolve(__dirname, "..", "..", "agents");
 }
 async function exists(p) {
     try {
@@ -41,82 +54,251 @@ async function exists(p) {
         return false;
     }
 }
+async function isDirectory(p) {
+    try {
+        const s = await fs.stat(p);
+        return s.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
 let embeddedAsserted = false;
-let overrideWarnEmitted = false;
 let overrideActiveAnnounced = false;
+let overrideMissingWarnEmitted = false;
+let permWarnEmitted = false;
+const overrideValidationCache = new Map();
+/**
+ * Test-only: reset all module-level caches and one-shot flags.
+ * Production code MUST NOT call this.
+ */
+export function __resetAgentLoaderForTests() {
+    embeddedAsserted = false;
+    overrideActiveAnnounced = false;
+    overrideMissingWarnEmitted = false;
+    permWarnEmitted = false;
+    overrideValidationCache.clear();
+    __resetOverrideAllowlistCache();
+}
+/**
+ * Create the override directory with user-only permissions.
+ * On Unix, mkdir's mode is masked by umask, so an explicit chmod follows.
+ * Chmod failures propagate — initLocalConfig must not silently succeed when the
+ * security invariant (mode 0o700) cannot be met.
+ * On Windows, fs.mkdir mode is ignored; APPDATA inherits user-only DACL by default.
+ * Custom paths outside APPDATA on Windows fall back to whatever the parent grants.
+ */
+async function createSecureDir(dir) {
+    await fs.mkdir(dir, { recursive: true, mode: 0o700 });
+    if (process.platform !== "win32") {
+        await fs.chmod(dir, 0o700);
+    }
+}
+/**
+ * Copy a file with user-only read/write permissions on Unix.
+ * fs.copyFile preserves the source mode (0o644 from the bundle), so an explicit
+ * chmod is required for 0o600 semantics. Failure propagates so the operator
+ * sees the security invariant breakage, rather than silent success.
+ */
+async function copyFileSecure(src, dst) {
+    await fs.copyFile(src, dst);
+    if (process.platform !== "win32") {
+        await fs.chmod(dst, 0o600);
+    }
+}
+/**
+ * Warn once per process if the override directory is world-writable. Group-write
+ * is allowed (single-user box convention); only world-write triggers the warning.
+ * Skipped on Windows: fs.stat does not surface DACL semantics.
+ *
+ * The "once" flag is claimed BEFORE the await so concurrent first-load calls do
+ * not produce duplicate warnings.
+ */
+async function checkOverrideDirPerms(dir) {
+    if (process.platform === "win32")
+        return;
+    if (permWarnEmitted)
+        return;
+    permWarnEmitted = true;
+    try {
+        const s = await fs.stat(dir);
+        if ((s.mode & 0o002) !== 0) {
+            logger.warn("override directory is world-writable", {
+                details: {
+                    configured_path: dir,
+                    mode: "0o" + (s.mode & 0o777).toString(8),
+                    recommendation: `chmod 700 ${dir}`,
+                },
+            });
+        }
+    }
+    catch {
+        // stat already validated upstream; ignore failure here
+    }
+}
 async function ensureEmbeddedDir() {
     if (embeddedAsserted)
         return;
     const dir = getEmbeddedDir();
     if (!(await exists(dir))) {
-        throw new SquadError('AGENT_DIR_MISSING', `embedded agents directory missing at ${dir}`);
+        throw new SquadError("AGENT_DIR_MISSING", `embedded agents directory missing at ${dir}`);
     }
     embeddedAsserted = true;
 }
-async function announceOverrideOnce() {
-    if (overrideActiveAnnounced)
-        return;
-    const localDir = getLocalDir();
-    if (process.env.SQUAD_AGENTS_DIR && (await exists(localDir))) {
-        logger.info('agent override active', { details: { local_dir_present: true } });
+/**
+ * Resolve and validate the active override directory.
+ *
+ * Returns:
+ *   - validated `ValidationOk` (override active for this resolution).
+ *   - `null` when there is no active override (use embedded). The "no active
+ *     override" cases include: directory does not exist on disk; default
+ *     platform dir failed validation (rare — these always live under an
+ *     allowlisted root in practice).
+ *
+ * Throws `OVERRIDE_REJECTED` only when `SQUAD_AGENTS_DIR` was set explicitly
+ * AND the directory exists but fails policy (outside allowlist, UNC, symlink
+ * escape, etc.). A missing explicit-env directory still soft-fails with a
+ * one-shot warn — this preserves the prior contract.
+ */
+async function resolveOverride() {
+    const { rawDir, explicit } = getLocalDir();
+    const cached = overrideValidationCache.get(rawDir);
+    if (cached !== undefined)
+        return cached;
+    if (!(await isDirectory(rawDir))) {
+        if (explicit && !overrideMissingWarnEmitted) {
+            overrideMissingWarnEmitted = true;
+            logger.warn("SQUAD_AGENTS_DIR set but directory not found; falling back to embedded defaults", {
+                details: { configured_path: rawDir },
+            });
+        }
+        overrideValidationCache.set(rawDir, null);
+        return null;
+    }
+    const result = await validateOverrideDir(rawDir);
+    if (!result.ok) {
+        if (explicit) {
+            const size = await getAllowlistSize();
+            const err = rejectionToError(result, size);
+            logger.warn("SQUAD_AGENTS_DIR rejected", {
+                error_code: err.code,
+                details: { reason: result.reason, configured_path: rawDir },
+            });
+            throw err;
+        }
+        // Platform-default rejection: log warn, fall back silently. Rare.
+        logger.warn("platform default agent directory failed validation", {
+            details: { reason: result.reason, configured_path: rawDir },
+        });
+        overrideValidationCache.set(rawDir, null);
+        return null;
+    }
+    if (!overrideActiveAnnounced) {
+        overrideActiveAnnounced = true;
+        const fields = {
+            resolved_path: result.resolvedPath,
+            allowlist_match: result.allowlistMatch,
+            has_unsafe_override: result.unsafeOverride,
+            source: explicit ? "env" : "platform_default",
+        };
+        if (result.unsafeOverride) {
+            logger.warn("agent override active (unsafe escape hatch)", {
+                details: fields,
+            });
+        }
+        else {
+            logger.info("agent override active", { details: fields });
+        }
     }
-    else if (process.env.SQUAD_AGENTS_DIR && !overrideWarnEmitted) {
-        logger.warn('SQUAD_AGENTS_DIR set but directory not found; falling back to embedded defaults');
-        overrideWarnEmitted = true;
+    await checkOverrideDirPerms(result.resolvedPath);
+    overrideValidationCache.set(rawDir, result);
+    return result;
+}
+/**
+ * Validate an agent name against the AGENT_FILE_MAP. Prevents agent-name
+ * traversal (e.g. `../../../etc/passwd`) at the loader boundary.
+ */
+function assertKnownAgent(name) {
+    if (!Object.prototype.hasOwnProperty.call(AGENT_FILE_MAP, name)) {
+        throw new SquadError("UNKNOWN_AGENT", `unknown agent: ${name}`, { name });
     }
-    overrideActiveAnnounced = true;
 }
 export async function resolveAgentFile(name) {
     await ensureEmbeddedDir();
-    await announceOverrideOnce();
+    assertKnownAgent(name);
     const file = AGENT_FILE_MAP[name];
-    const local = path.join(getLocalDir(), file);
-    if (await exists(local))
-        return local;
+    const override = await resolveOverride();
+    if (override) {
+        const overrideFile = await validateOverrideFile(override.resolvedPath, file);
+        if (overrideFile)
+            return overrideFile;
+        // File missing or per-file escape — silent fallback to embedded for this file.
+    }
     return path.join(getEmbeddedDir(), file);
 }
 export async function resolveSharedFile(file) {
     await ensureEmbeddedDir();
-    await announceOverrideOnce();
-    const local = path.join(getLocalDir(), file);
-    if (await exists(local))
-        return local;
+    if (!SHARED_FILES.includes(file)) {
+        throw new SquadError("INVALID_INPUT", `shared file not allowed: ${file}`, {
+            file,
+        });
+    }
+    const override = await resolveOverride();
+    if (override) {
+        const overrideFile = await validateOverrideFile(override.resolvedPath, file);
+        if (overrideFile)
+            return overrideFile;
+    }
     return path.join(getEmbeddedDir(), file);
 }
 export async function readAgentDefinition(name) {
     const filePath = await resolveAgentFile(name);
-    return fs.readFile(filePath, 'utf8');
+    return fs.readFile(filePath, "utf8");
 }
 export async function listAvailableAgents() {
-    const dir = getLocalDir();
-    const localExists = await exists(dir);
+    // Trigger validation so misconfigured overrides surface here too.
+    let overridden = false;
+    try {
+        const result = await resolveOverride();
+        overridden = result !== null;
+    }
+    catch {
+        // OVERRIDE_REJECTED bubbles up to the caller via the resolve call below
+        // when individual agent files are read. For listing, treat as no override.
+        overridden = false;
+    }
     return Object.values(AGENTS).map((a) => ({
         name: a.name,
         role: a.role,
         owns: a.owns,
         conventions: a.conventions,
         file: AGENT_FILE_MAP[a.name],
-        overridden: localExists,
+        overridden,
     }));
 }
 export async function initLocalConfig(force = false) {
     await ensureEmbeddedDir();
-    const dir = getLocalDir();
-    await fs.mkdir(dir, { recursive: true });
+    const { rawDir } = getLocalDir();
+    await createSecureDir(rawDir);
     const created = [];
     const skipped = [];
     // SECURITY: file names come from hardcoded constants only; never accept user-supplied names here.
     const sources = [...Object.values(AGENT_FILE_MAP), ...SHARED_FILES];
     for (const file of sources) {
-        const dst = path.join(dir, file);
+        const dst = path.join(rawDir, file);
         if ((await exists(dst)) && !force) {
             skipped.push(file);
             continue;
         }
+        // Shared docs live under _shared/; ensure the parent dir exists before copyFile.
+        const parent = path.dirname(dst);
+        if (parent !== rawDir) {
+            await createSecureDir(parent);
+        }
         const src = path.join(getEmbeddedDir(), file);
-        await fs.copyFile(src, dst);
+        await copyFileSecure(src, dst);
         created.push(file);
     }
-    return { created, skipped, dir };
+    return { created, skipped, dir: rawDir };
 }
 //# sourceMappingURL=agent-loader.js.map

package/dist/resources/agent-loader.js.map

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

package/dist/tasks/select.d.ts

@@ -0,0 +1,64 @@
+import type { AgentName } from "../config/ownership-matrix.js";
+import type { Task, TaskStatus } from "./store.js";
+/**
+ * Pure selection helpers over the in-memory tasks list. Stateless. Used by
+ * the next_task and list_tasks MCP tools.
+ */
+export interface ListTasksOptions {
+    /** Filter to one or more statuses. */
+    status?: TaskStatus[];
+    /**
+     * When set, return only tasks whose `agent_hints` includes ANY of these
+     * agents. Tasks without agent_hints are repo-wide and always pass.
+     */
+    agent?: AgentName;
+    /**
+     * When set, return only tasks whose `scope` glob matches at least one of
+     * these paths. Tasks without scope are repo-wide and always pass.
+     */
+    changed_files?: string[];
+    /** Cap result count. Default unlimited. */
+    limit?: number;
+}
+export declare function listTasks(tasks: Task[], opts?: ListTasksOptions): Task[];
+export interface NextTaskOptions {
+    /**
+     * Treat these statuses as "complete" for dependency checks. Defaults to
+     * just `done`. A task whose deps are all `done` is considered ready.
+     */
+    done_statuses?: TaskStatus[];
+    /**
+     * Statuses considered eligible for selection. Defaults to `pending`.
+     * Use `["pending", "blocked"]` to also surface blocked tasks (with a hint
+     * the caller can show the user — handled outside this function).
+     */
+    candidate_statuses?: TaskStatus[];
+    agent?: AgentName;
+    changed_files?: string[];
+}
+export interface NextTaskResult {
+    task: Task | null;
+    /** Reason "task is null": no candidates, or all blocked by deps. */
+    reason: "no_candidates" | "all_blocked" | "ok";
+    /**
+     * Tasks that match candidate filters but have unmet dependencies. Useful
+     * for the caller to show "X is next when Y completes".
+     */
+    blocked: Array<{
+        task: Task;
+        missing_deps: number[];
+    }>;
+}
+/**
+ * Pick the next ready task. A task is ready when:
+ *  - its status is in `candidate_statuses` (default `["pending"]`)
+ *  - every id in its `dependencies` refers to a task whose status is in
+ *    `done_statuses` (default `["done"]`)
+ *  - it passes the agent / changed_files filters
+ *
+ * Tiebreakers (in order): priority (high < medium < low), then id ascending.
+ *
+ * Returns the task plus a structured result so the caller can distinguish
+ * "no candidates" from "all blocked by deps" (different UX).
+ */
+export declare function nextTask(tasks: Task[], opts?: NextTaskOptions): NextTaskResult;

package/dist/tasks/select.js

@@ -0,0 +1,84 @@
+import { matchesGlob } from "../config/squad-yaml.js";
+export function listTasks(tasks, opts = {}) {
+    let out = tasks;
+    if (opts.status && opts.status.length > 0) {
+        const set = new Set(opts.status);
+        out = out.filter((t) => set.has(t.status));
+    }
+    if (opts.agent !== undefined) {
+        const wantedAgent = opts.agent;
+        out = out.filter((t) => {
+            if (!t.agent_hints || t.agent_hints.length === 0)
+                return true;
+            return t.agent_hints.includes(wantedAgent);
+        });
+    }
+    if (opts.changed_files && opts.changed_files.length > 0) {
+        const files = opts.changed_files;
+        out = out.filter((t) => {
+            if (!t.scope)
+                return true;
+            return files.some((f) => matchesGlob(t.scope, f));
+        });
+    }
+    if (opts.limit !== undefined && opts.limit > 0) {
+        out = out.slice(0, opts.limit);
+    }
+    return out;
+}
+const PRIORITY_RANK = {
+    high: 0,
+    medium: 1,
+    low: 2,
+};
+/**
+ * Pick the next ready task. A task is ready when:
+ *  - its status is in `candidate_statuses` (default `["pending"]`)
+ *  - every id in its `dependencies` refers to a task whose status is in
+ *    `done_statuses` (default `["done"]`)
+ *  - it passes the agent / changed_files filters
+ *
+ * Tiebreakers (in order): priority (high < medium < low), then id ascending.
+ *
+ * Returns the task plus a structured result so the caller can distinguish
+ * "no candidates" from "all blocked by deps" (different UX).
+ */
+export function nextTask(tasks, opts = {}) {
+    const doneSet = new Set(opts.done_statuses ?? ["done"]);
+    const candidateStatuses = opts.candidate_statuses ?? ["pending"];
+    // Build done-id index over the FULL task list — deps may point at any task,
+    // not just ones passing the filters.
+    const doneIds = new Set(tasks.filter((t) => doneSet.has(t.status)).map((t) => t.id));
+    // Filter to candidates (status + agent + scope).
+    const filterOpts = { status: candidateStatuses };
+    if (opts.agent !== undefined)
+        filterOpts.agent = opts.agent;
+    if (opts.changed_files !== undefined)
+        filterOpts.changed_files = opts.changed_files;
+    const candidates = listTasks(tasks, filterOpts);
+    if (candidates.length === 0) {
+        return { task: null, reason: "no_candidates", blocked: [] };
+    }
+    const ready = [];
+    const blocked = [];
+    for (const t of candidates) {
+        const missing = t.dependencies.filter((d) => !doneIds.has(d));
+        if (missing.length === 0) {
+            ready.push(t);
+        }
+        else {
+            blocked.push({ task: t, missing_deps: missing });
+        }
+    }
+    if (ready.length === 0) {
+        return { task: null, reason: "all_blocked", blocked };
+    }
+    ready.sort((a, b) => {
+        const p = PRIORITY_RANK[a.priority] - PRIORITY_RANK[b.priority];
+        if (p !== 0)
+            return p;
+        return a.id - b.id;
+    });
+    return { task: ready[0], reason: "ok", blocked };
+}
+//# sourceMappingURL=select.js.map

package/dist/tasks/select.js.map

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