forge-cc 0.1.41 → 1.0.0

package/dist/gates/tests-gate.js

@@ -1,219 +1,91 @@
-import { execSync } from "node:child_process";
-import { buildTestRemediation, buildTestCoverageRemediation } from "./remediation.js";
-import { analyzeTestCoverage } from "./test-analysis.js";
-import { loadConfig } from "../config/loader.js";
-/**
- * Common test failure patterns with file/line info:
- *   FAIL src/foo.test.ts > suite > test name
- *   at src/foo.test.ts:42:10
- */
-const TEST_FILE_RE = /^FAIL\s+(.+?)(?:\s+>|$)/;
-const STACKTRACE_RE = /at\s+.*?([^\s(]+):(\d+):\d+/;
-export async function verifyTests(projectDir, options) {
-    const start = Date.now();
-    const errors = [];
-    const warnings = [];
-    // Load config and run test analysis
-    const config = loadConfig(options?.configRoot ?? projectDir);
-    const testingConfig = config.testing;
-    const analysis = await analyzeTestCoverage(projectDir);
-    // Detect whether a test script exists in package.json
-    let hasTestScript = false;
+import { spawn } from "node:child_process";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+/** Detect test runner from package.json dependencies. */
+async function detectRunner(projectDir) {
     try {
-        const pkgRaw = execSync("node -e \"process.stdout.write(JSON.stringify(require('./package.json')))\"", {
-            cwd: projectDir,
-            stdio: "pipe",
-            timeout: 10_000,
-        });
-        const pkg = JSON.parse(String(pkgRaw));
-        hasTestScript = !!pkg.scripts?.test;
+        const content = await readFile(join(projectDir, "package.json"), "utf-8");
+        const pkg = JSON.parse(content);
+        const deps = {
+            ...pkg.dependencies,
+            ...pkg.devDependencies,
+        };
+        if ("vitest" in deps)
+            return "vitest";
+        if ("jest" in deps)
+            return "jest";
     }
     catch {
-        // No package.json or invalid — hasTestScript stays false
-    }
-    // -----------------------------------------------------------------------
-    // Baseline check: If zero test files AND no test script, FAIL immediately
-    // -----------------------------------------------------------------------
-    if (analysis.coverage.testFiles === 0 && !hasTestScript) {
-        const categoryNames = analysis.categories.map(c => c.name).join(", ");
-        const msg = `No tests found. ${analysis.coverage.sourceFiles} source file${analysis.coverage.sourceFiles === 1 ? "" : "s"} across ${analysis.categories.length} categor${analysis.categories.length === 1 ? "y" : "ies"} (${categoryNames || "none"}) have no test coverage. Run \`/forge:setup\` to scaffold tests.`;
-        const error = { message: msg };
-        error.remediation = buildTestCoverageRemediation(error);
-        errors.push(error);
-        return {
-            gate: "tests",
-            passed: false,
-            errors,
-            warnings,
-            duration_ms: Date.now() - start,
-        };
+        // No package.json — fall through
     }
-    // Also baseline-fail if test files exist but no test script to run them
-    if (analysis.coverage.testFiles === 0 && hasTestScript) {
-        // Test script exists but no test files found — still baseline fail
-        const msg = `No test files found. A test script exists in package.json but no test files were detected. Run \`/forge:setup\` to scaffold tests.`;
-        const error = { message: msg };
-        error.remediation = buildTestCoverageRemediation(error);
-        errors.push(error);
+    return "unknown";
+}
+async function runTestRunner(projectDir) {
+    const start = Date.now();
+    const runner = await detectRunner(projectDir);
+    if (runner === "unknown") {
         return {
             gate: "tests",
             passed: false,
-            errors,
-            warnings,
-            duration_ms: Date.now() - start,
+            errors: [{ file: "", line: 0, message: "No test runner detected (install vitest or jest)" }],
+            durationMs: Date.now() - start,
         };
     }
-    // -----------------------------------------------------------------------
-    // Run tests (if a test script exists)
-    // -----------------------------------------------------------------------
-    let testsRanSuccessfully = true;
-    if (hasTestScript) {
-        try {
-            const result = execSync("npm run test -- --run", {
-                cwd: projectDir,
-                stdio: "pipe",
-                timeout: 300_000,
-            });
-            const output = String(result);
-            // Parse test summary from Vitest output
-            const summaryMatch = output.match(/Tests\s+(\d+)\s+passed(?:\s*\|\s*(\d+)\s+failed)?/);
-            if (summaryMatch) {
-                const passed = summaryMatch[1];
-                const failed = summaryMatch[2] ?? "0";
-                warnings.push(`${passed} passed, ${failed} failed`);
-            }
-        }
-        catch (err) {
-            testsRanSuccessfully = false;
-            const stdout = err instanceof Error && "stdout" in err
-                ? String(err.stdout)
-                : "";
-            const stderr = err instanceof Error && "stderr" in err
-                ? String(err.stderr)
-                : "";
-            const output = `${stdout}\n${stderr}`;
-            let lastFailFile;
-            for (const line of output.split("\n")) {
-                const trimmed = line.trim();
-                if (!trimmed)
-                    continue;
-                // Track which test file we're in
-                const failMatch = TEST_FILE_RE.exec(trimmed);
-                if (failMatch) {
-                    lastFailFile = failMatch[1];
-                }
-                // Try to extract stack trace location
-                const stackMatch = STACKTRACE_RE.exec(trimmed);
-                if (stackMatch) {
-                    lastFailFile = stackMatch[1];
-                }
-                if (trimmed.includes("FAIL") ||
-                    trimmed.includes("AssertionError") ||
-                    trimmed.includes("AssertionError") ||
-                    trimmed.includes("Expected") ||
-                    trimmed.includes("Received")) {
+    const cmd = runner === "vitest" ? ["vitest", "run"] : ["jest", "--ci"];
+    return new Promise((resolve) => {
+        const child = spawn("npx", cmd, {
+            cwd: projectDir,
+            shell: true,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (data) => {
+            stdout += data.toString();
+        });
+        child.stderr.on("data", (data) => {
+            stderr += data.toString();
+        });
+        child.on("close", (code) => {
+            const errors = [];
+            if (code !== 0) {
+                const output = stdout + stderr;
+                const failRegex = /FAIL\s+(.+)/g;
+                let match;
+                while ((match = failRegex.exec(output)) !== null) {
                     errors.push({
-                        file: lastFailFile,
-                        line: stackMatch ? Number.parseInt(stackMatch[2], 10) : undefined,
-                        message: trimmed,
+                        file: match[1].trim(),
+                        line: 0,
+                        message: `Test suite failed: ${match[1].trim()}`,
                     });
                 }
-            }
-            // Also try to extract the summary even on failure
-            const summaryMatch = output.match(/Tests\s+(?:(\d+)\s+passed\s*\|\s*)?(\d+)\s+failed/);
-            if (summaryMatch) {
-                const passed = summaryMatch[1] ?? "0";
-                const failed = summaryMatch[2];
-                warnings.push(`${passed} passed, ${failed} failed`);
-            }
-            if (errors.length === 0) {
-                errors.push({ message: "Test runner exited with non-zero status" });
-            }
-            // Enrich errors with remediation hints
-            for (const error of errors) {
-                error.remediation = buildTestRemediation(error);
-            }
-        }
-    }
-    // -----------------------------------------------------------------------
-    // Enforcement check: Verify changed files have corresponding tests
-    // -----------------------------------------------------------------------
-    if (testingConfig?.enforce) {
-        const changedSourceFiles = getChangedSourceFiles(projectDir);
-        if (changedSourceFiles.length > 0) {
-            const untestedSet = new Set(analysis.coverage.untestedFiles);
-            for (const file of changedSourceFiles) {
-                const normalized = file.replace(/\\/g, "/");
-                if (untestedSet.has(normalized)) {
-                    const error = {
-                        file: normalized,
-                        message: `Missing test file for changed source: ${normalized}`,
-                    };
-                    error.remediation = buildTestCoverageRemediation(error);
-                    errors.push(error);
-                }
-            }
-        }
-    }
-    // -----------------------------------------------------------------------
-    // Thin coverage advisory
-    // -----------------------------------------------------------------------
-    if (analysis.coverage.testFiles > 0 && analysis.coverage.ratio < 0.3) {
-        warnings.push(`Thin test coverage: ratio ${analysis.coverage.ratio} (${analysis.coverage.testFiles} test file${analysis.coverage.testFiles === 1 ? "" : "s"} for ${analysis.coverage.sourceFiles} source file${analysis.coverage.sourceFiles === 1 ? "" : "s"}). Consider adding tests for untested files.`);
-    }
-    const passed = testsRanSuccessfully && errors.length === 0;
-    return {
-        gate: "tests",
-        passed,
-        errors,
-        warnings,
-        duration_ms: Date.now() - start,
-    };
-}
-/**
- * Get source files changed relative to HEAD~1 or the staging area.
- * Returns paths relative to projectDir, normalized with forward slashes.
- */
-function getChangedSourceFiles(projectDir) {
-    const files = [];
-    // Try git diff against HEAD~1 first, fall back to cached diff
-    for (const cmd of [
-        "git diff --name-only HEAD~1",
-        "git diff --cached --name-only",
-    ]) {
-        try {
-            const output = execSync(cmd, {
-                cwd: projectDir,
-                stdio: "pipe",
-                timeout: 10_000,
-            }).toString().trim();
-            if (output) {
-                for (const line of output.split("\n")) {
-                    const trimmed = line.trim();
-                    if (!trimmed)
-                        continue;
-                    // Only include source files (not test files, not configs)
-                    if (isSourceFilePath(trimmed)) {
-                        files.push(trimmed.replace(/\\/g, "/"));
-                    }
+                if (errors.length === 0) {
+                    errors.push({
+                        file: "",
+                        line: 0,
+                        message: `Test runner exited with code ${code}`,
+                    });
                 }
-                break; // Use the first successful command
             }
-        }
-        catch {
-            // Command failed — try the next one
-        }
-    }
-    return files;
-}
-/** Check if a path looks like a source file (TS/JS, not a test, not a declaration). */
-function isSourceFilePath(filePath) {
-    if (!/\.(ts|tsx|js|jsx)$/.test(filePath))
-        return false;
-    if (/\.(test|spec)\.(ts|tsx|js|jsx)$/.test(filePath))
-        return false;
-    if (filePath.endsWith(".d.ts"))
-        return false;
-    return true;
+            resolve({
+                gate: "tests",
+                passed: code === 0,
+                errors,
+                durationMs: Date.now() - start,
+            });
+        });
+        child.on("error", (err) => {
+            resolve({
+                gate: "tests",
+                passed: false,
+                errors: [{ file: "", line: 0, message: err.message }],
+                durationMs: Date.now() - start,
+            });
+        });
+    });
 }
+export const testsGate = {
+    name: "tests",
+    run: runTestRunner,
+};
 //# sourceMappingURL=tests-gate.js.map

package/dist/gates/tests-gate.js.map

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

package/dist/gates/types-gate.d.ts

@@ -1,2 +1,2 @@
-import type { GateResult } from "../types.js";
-export declare function verifyTypes(projectDir: string): Promise<GateResult>;
+import type { Gate } from "./index.js";
+export declare const typesGate: Gate;

package/dist/gates/types-gate.js

@@ -1,64 +1,58 @@
-import { execSync } from "node:child_process";
-import { buildTypeRemediation } from "./remediation.js";
-/** Regex to parse tsc error lines: src/foo.ts(10,5): error TS2322: ... */
-const TSC_ERROR_RE = /^(.+?)\((\d+),\d+\):\s*(.+)$/;
-export async function verifyTypes(projectDir) {
-    const start = Date.now();
+import { spawn } from "node:child_process";
+/** Parse tsc output lines into structured errors. */
+function parseTscOutput(output) {
     const errors = [];
-    const warnings = [];
-    try {
-        execSync("npx tsc --noEmit", {
-            cwd: projectDir,
-            stdio: "pipe",
-            timeout: 120_000,
+    // tsc error format: file(line,col): error TSxxxx: message
+    const regex = /^(.+?)\((\d+),(\d+)\):\s+error\s+TS\d+:\s+(.+)$/gm;
+    let match;
+    while ((match = regex.exec(output)) !== null) {
+        errors.push({
+            file: match[1],
+            line: parseInt(match[2], 10),
+            column: parseInt(match[3], 10),
+            message: match[4],
         });
-        return {
-            gate: "types",
-            passed: true,
-            errors,
-            warnings,
-            duration_ms: Date.now() - start,
-        };
-    }
-    catch (err) {
-        const output = err instanceof Error && "stdout" in err
-            ? String(err.stdout)
-            : "";
-        for (const line of output.split("\n")) {
-            const trimmed = line.trim();
-            if (!trimmed)
-                continue;
-            if (trimmed.toLowerCase().includes("warning")) {
-                warnings.push(trimmed);
-            }
-            else if (trimmed.includes("error TS")) {
-                const match = TSC_ERROR_RE.exec(trimmed);
-                if (match) {
-                    errors.push({
-                        file: match[1],
-                        line: Number.parseInt(match[2], 10),
-                        message: match[3],
-                    });
-                }
-                else {
-                    errors.push({ message: trimmed });
-                }
-            }
-        }
-        if (errors.length === 0) {
-            errors.push({ message: "tsc exited with non-zero status but no TS errors were parsed" });
-        }
-        // Enrich errors with remediation hints
-        for (const error of errors) {
-            error.remediation = buildTypeRemediation(error);
-        }
-        return {
-            gate: "types",
-            passed: false,
-            errors,
-            warnings,
-            duration_ms: Date.now() - start,
-        };
     }
+    return errors;
+}
+function runTsc(projectDir) {
+    return new Promise((resolve) => {
+        const start = Date.now();
+        const child = spawn("npx", ["tsc", "--noEmit"], {
+            cwd: projectDir,
+            shell: true,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (data) => {
+            stdout += data.toString();
+        });
+        child.stderr.on("data", (data) => {
+            stderr += data.toString();
+        });
+        child.on("close", (code) => {
+            const output = stdout + stderr;
+            const errors = parseTscOutput(output);
+            resolve({
+                gate: "types",
+                passed: code === 0,
+                errors,
+                durationMs: Date.now() - start,
+            });
+        });
+        child.on("error", (err) => {
+            resolve({
+                gate: "types",
+                passed: false,
+                errors: [{ file: "", line: 0, message: err.message }],
+                durationMs: Date.now() - start,
+            });
+        });
+    });
 }
+export const typesGate = {
+    name: "types",
+    run: runTsc,
+};
 //# sourceMappingURL=types-gate.js.map

package/dist/gates/types-gate.js.map

@@ -1 +1 @@
-{"version":3,"file":"types-gate.js","sourceRoot":"","sources":["../../src/gates/types-gate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,0EAA0E;AAC1E,MAAM,YAAY,GAAG,8BAA8B,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,UAAkB;IAClD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,CAAC;QACH,QAAQ,CAAC,kBAAkB,EAAE;YAC3B,GAAG,EAAE,UAAU;YACf,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,OAAO;SACjB,CAAC,CAAC;QAEH,OAAO;YACL,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,IAAI;YACZ,MAAM;YACN,QAAQ;YACR,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;SAChC,CAAC;IACJ,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,MAAM,GACV,GAAG,YAAY,KAAK,IAAI,QAAQ,IAAI,GAAG;YACrC,CAAC,CAAC,MAAM,CAAE,GAA0B,CAAC,MAAM,CAAC;YAC5C,CAAC,CAAC,EAAE,CAAC;QAET,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO;gBAAE,SAAS;YAEvB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC9C,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC;iBAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBACxC,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACzC,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;wBACd,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;wBACnC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;qBAClB,CAAC,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;gBACpC,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,8DAA8D,EAAE,CAAC,CAAC;QAC3F,CAAC;QAED,uCAAuC;QACvC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,KAAK,CAAC,WAAW,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAClD,CAAC;QAED,OAAO;YACL,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,KAAK;YACb,MAAM;YACN,QAAQ;YACR,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;SAChC,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"types-gate.js","sourceRoot":"","sources":["../../src/gates/types-gate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAI3C,qDAAqD;AACrD,SAAS,cAAc,CAAC,MAAc;IACpC,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,0DAA0D;IAC1D,MAAM,KAAK,GAAG,mDAAmD,CAAC;IAClE,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;YACd,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YAC5B,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YAC9B,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;SAClB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,MAAM,CAAC,UAAkB;IAChC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE;YAC9C,GAAG,EAAE,UAAU;YACf,KAAK,EAAE,IAAI;YACX,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QAEH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAEhB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;YACvC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;YACvC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;YAC/B,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;YACtC,OAAO,CAAC;gBACN,IAAI,EAAE,OAAO;gBACb,MAAM,EAAE,IAAI,KAAK,CAAC;gBAClB,MAAM;gBACN,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC/B,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,OAAO,CAAC;gBACN,IAAI,EAAE,OAAO;gBACb,MAAM,EAAE,KAAK;gBACb,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;gBACrD,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC/B,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAS;IAC7B,IAAI,EAAE,OAAO;IACb,GAAG,EAAE,MAAM;CACZ,CAAC"}

package/dist/linear/client.d.ts

@@ -1,114 +1,37 @@
-/**
- * Typed wrapper around the Linear GraphQL API.
- * Used by lifecycle modules (projects.ts, milestones.ts, issues.ts)
- * and the execution engine for programmatic Linear management.
- */
-export interface LinearProject {
-    id: string;
-    name: string;
-    description?: string;
-    state: string;
-    url: string;
-}
-export interface LinearMilestone {
-    id: string;
-    name: string;
-    description?: string;
-    progress: number;
-    sortOrder: number;
-}
-export interface LinearIssue {
-    id: string;
-    identifier: string;
-    title: string;
-    description?: string;
-    state: string;
-    projectId?: string;
-    milestoneId?: string;
+export interface ForgeLinearClientOptions {
+    apiKey: string;
     teamId?: string;
-    url: string;
-}
-export interface LinearTeam {
-    id: string;
-    name: string;
-    key: string;
-}
-export interface CreateProjectInput {
-    name: string;
-    description?: string;
-    teamIds: string[];
-    state?: string;
-}
-export interface UpdateProjectInput {
-    name?: string;
-    description?: string;
-    state?: string;
-}
-export interface CreateMilestoneInput {
-    projectId: string;
-    name: string;
-    description?: string;
-    targetDate?: string;
-}
-export interface CreateIssueInput {
-    title: string;
-    description?: string;
-    teamId: string;
-    projectId?: string;
-    milestoneId?: string;
-    priority?: number;
-    state?: string;
 }
-export interface UpdateIssueInput {
-    title?: string;
-    description?: string;
-    state?: string;
-    stateId?: string;
-    milestoneId?: string;
-    priority?: number;
-}
-export declare class LinearClientError extends Error {
-    readonly statusCode?: number | undefined;
-    readonly errors?: Array<{
-        message: string;
-    }> | undefined;
-    constructor(message: string, statusCode?: number | undefined, errors?: Array<{
-        message: string;
-    }> | undefined);
-}
-export declare class LinearClient {
-    private readonly apiKey;
-    constructor(apiKey?: string);
-    listProjects(opts?: {
-        query?: string;
-        state?: string;
-    }): Promise<LinearProject[]>;
-    createProject(input: CreateProjectInput): Promise<LinearProject>;
-    updateProject(id: string, input: UpdateProjectInput): Promise<LinearProject>;
-    listMilestones(projectId: string): Promise<LinearMilestone[]>;
-    createMilestone(input: CreateMilestoneInput): Promise<LinearMilestone>;
-    listIssues(opts?: {
-        projectId?: string;
-        milestoneId?: string;
-        state?: string;
-    }): Promise<LinearIssue[]>;
-    createIssue(input: CreateIssueInput): Promise<LinearIssue>;
-    updateIssue(id: string, input: UpdateIssueInput): Promise<LinearIssue>;
-    createComment(issueId: string, body: string): Promise<void>;
-    listTeams(): Promise<LinearTeam[]>;
-    listWorkflowStates(teamId: string): Promise<Array<{
+/**
+ * Thin wrapper around @linear/sdk's LinearClient, scoped to a team.
+ * All public methods degrade gracefully on API errors (warn, don't crash).
+ */
+export declare class ForgeLinearClient {
+    private readonly client;
+    private readonly teamId;
+    constructor(opts: ForgeLinearClientOptions);
+    /** Resolve a workflow state UUID by its display name for a given team. */
+    resolveStateId(teamId: string, stateName: string): Promise<string>;
+    /** Update an issue's workflow state. */
+    updateIssueState(issueId: string, stateId: string): Promise<void>;
+    /** Update a project's status (state name in Linear projects). */
+    updateProjectState(projectId: string, stateId: string): Promise<void>;
+    /** List all teams visible to the authenticated user. */
+    listTeams(): Promise<Array<{
+        id: string;
+        name: string;
+        key: string;
+    }>>;
+    /** List issues belonging to a project. Returns identifier (e.g. "MSIG-123") and title. */
+    listIssuesByProject(projectId: string): Promise<Array<{
+        id: string;
+        identifier: string;
+        title: string;
+    }>>;
+    /** List projects filtered by team. */
+    listProjects(teamId: string): Promise<Array<{
         id: string;
         name: string;
+        state: string;
     }>>;
-    /**
-     * Execute a GraphQL request against the Linear API with retry + backoff.
-     */
-    private request;
-    /**
-     * Auto-paginate a connection query. The query MUST accept `$after: String`
-     * and the root field must return `{ pageInfo { hasNextPage endCursor } nodes { ... } }`.
-     */
-    private paginate;
-    /** Normalize a raw issue node from GraphQL into our flat LinearIssue shape. */
-    private mapIssue;
 }