soloforge 1.1.2 → 1.1.31

package/dist/engine/core/logger.js

@@ -0,0 +1,118 @@
+/**
+ * SoloForge 统一日志模块
+ *
+ * 替代散落在 src 中的 console.log / console.error / console.warn。
+ * 区分用户可见输出、调试日志、错误日志，支持 --json 模式和测试静默。
+ */
+// ── 日志级别 ──
+import { ENV } from "./env.js";
+// ── 全局状态 ──
+let _silenced = false; // 测试模式：抑制所有输出
+let _jsonMode = false; // --json 模式：stdout 只允许 JSON
+let _debugEnabled = false; // 是否输出 debug 级别日志
+/**
+ * 初始化日志器状态。
+ * 在 CLI 入口和测试 setup 中调用。
+ */
+export function initLogger(opts) {
+    if (opts?.json !== undefined)
+        _jsonMode = opts.json;
+    if (opts?.silent !== undefined)
+        _silenced = opts.silent;
+    if (opts?.debug !== undefined)
+        _debugEnabled = opts.debug;
+}
+/**
+ * 从环境变量初始化（兼容 SOLOFORGE_DEBUG）。
+ */
+export function initLoggerFromEnv() {
+    _debugEnabled = process.env[ENV.DEBUG] === "1";
+    _silenced = process.env[ENV.SILENT] === "1";
+}
+/**
+ * 重置日志器状态（测试 teardown 用）。
+ */
+export function resetLogger() {
+    _silenced = false;
+    _jsonMode = false;
+    _debugEnabled = false;
+}
+// ── 内部输出函数 ──
+function stderrWrite(...args) {
+    if (_silenced)
+        return;
+    console.error(...args);
+}
+function stdoutWrite(...args) {
+    if (_silenced)
+        return;
+    // eslint-disable-next-line no-console -- 日志模块自身使用 console.log 输出到 stdout
+    console.log(...args);
+}
+// ── 用户可见输出（stdout） ──
+/**
+ * 用户可见信息。输出到 stdout。
+ * CLI 的 --json 模式由调用方自行判断是否输出。
+ */
+export function userInfo(...args) {
+    stdoutWrite(...args);
+}
+/**
+ * 用户可见警告。输出到 stderr，--json 模式下也输出（不污染 stdout）。
+ */
+export function userWarn(...args) {
+    stderrWrite(...args);
+}
+/**
+ * 用户可见错误。输出到 stderr，--json 模式下也输出。
+ */
+export function userError(...args) {
+    stderrWrite(...args);
+}
+/**
+ * 用户可见输出（强制 stdout，仅用于 --json 的 JSON.stringify 结果）。
+ * 调用方需确保只传 JSON 字符串。
+ */
+export function userJson(payload) {
+    stdoutWrite(payload);
+}
+// ── 调试日志（stderr） ──
+/**
+ * 调试日志。仅 SOLOFORGE_DEBUG=1 时输出到 stderr。
+ * 所有引擎内部 trace 应使用此函数。
+ */
+export function debug(module, ...args) {
+    if (!_debugEnabled || _silenced)
+        return;
+    stderrWrite(`[soloForge] ${module}:`, ...args);
+}
+// ── 内部警告（stderr） ──
+/**
+ * 内部警告：非用户直接可见，但运维/诊断需要。
+ * 始终输出到 stderr（除非静默模式）。
+ */
+export function internalWarn(module, ...args) {
+    if (_silenced)
+        return;
+    stderrWrite(`[soloForge] ${module}:`, ...args);
+}
+/**
+ * JSON 安全错误：在 --json 模式下，将错误写入 stderr 而非 stdout。
+ */
+export function jsonSafeError(...args) {
+    stderrWrite(...args);
+}
+// ── 查询当前状态 ──
+export function isJsonMode() { return _jsonMode; }
+export function isSilenced() { return _silenced; }
+export function isDebugEnabled() { return _debugEnabled; }
+// ── 兼容旧 debugLog ──
+/**
+ * 向后兼容旧 debugLog()。新代码应使用 debug()。
+ */
+export function debugLog(...args) {
+    if (!_debugEnabled || _silenced)
+        return;
+    stderrWrite("[soloForge]", ...args);
+}
+//# sourceMappingURL=logger.js.map

package/dist/engine/core/logger.js.map

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

package/dist/engine/core/path_scope_utils.d.ts

@@ -0,0 +1,21 @@
+export interface PathComparisonOptions {
+    caseSensitive?: boolean;
+}
+/**
+ * Canonical path string used for comparison only.
+ *
+ * This intentionally detects the path grammar from the string itself instead
+ * of assuming the current OS. That lets tests and adapters reason about
+ * Windows paths on macOS/Linux and vice versa.
+ */
+export declare function normalizePathForComparison(rawPath: string, options?: PathComparisonOptions): string;
+export declare function hasGlobPattern(rawPath: string): boolean;
+export declare function isSameOrDescendantPath(candidatePath: string, boundaryPath: string, options?: PathComparisonOptions): boolean;
+export declare function matchesScopePattern(candidatePath: string, scopePattern: string, options?: PathComparisonOptions): boolean;
+export declare function normalizeScopePattern(rawPath: string, _options?: PathComparisonOptions): string;
+export declare function isPathInScope(candidatePath: string, scopePattern: string, options?: PathComparisonOptions): boolean;
+export declare function isPathInAnyScope(candidatePath: string, scopePatterns: string[], options?: PathComparisonOptions): boolean;
+export declare function toPosixPath(rawPath: string): string;
+export declare function ensureTrailingSlash(rawPath: string): string;
+export declare function isPathInsideProject(projectRoot: string, targetPath: string, options?: PathComparisonOptions): boolean;
+//# sourceMappingURL=path_scope_utils.d.ts.map

package/dist/engine/core/path_scope_utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path_scope_utils.d.ts","sourceRoot":"","sources":["../../../src/engine/core/path_scope_utils.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAyBD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,qBAA0B,GAClC,MAAM,CAaR;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAOT;AA2BD,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAQT;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,qBAA0B,GACnC,MAAM,CAMR;AAED,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAKT;AAED,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EAAE,EACvB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAET;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAK3D;AAED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAET"}

package/dist/engine/core/path_scope_utils.js

@@ -0,0 +1,126 @@
+import path from "node:path";
+function defaultCaseSensitive() {
+    return process.platform !== "win32" && process.platform !== "darwin";
+}
+function looksWindowsLike(rawPath) {
+    return /^[a-zA-Z]:[\\/]/.test(rawPath)
+        || rawPath.startsWith("\\\\")
+        || rawPath.includes("\\");
+}
+function stripTrailingSlash(value) {
+    if (value === "/" || /^[a-zA-Z]:\/$/.test(value))
+        return value;
+    return value.replace(/\/+$/, "");
+}
+function isRootLike(value) {
+    return value === ""
+        || value === "."
+        || value === "./"
+        || value === "/"
+        || /^[a-zA-Z]:\/?$/.test(value);
+}
+/**
+ * Canonical path string used for comparison only.
+ *
+ * This intentionally detects the path grammar from the string itself instead
+ * of assuming the current OS. That lets tests and adapters reason about
+ * Windows paths on macOS/Linux and vice versa.
+ */
+export function normalizePathForComparison(rawPath, options = {}) {
+    const caseSensitive = options.caseSensitive ?? defaultCaseSensitive();
+    const trimmed = String(rawPath ?? "").trim();
+    if (!trimmed)
+        return "";
+    const normalized = looksWindowsLike(trimmed)
+        ? path.win32.normalize(trimmed).replace(/\\/g, "/")
+        : path.posix.normalize(trimmed.replace(/\\/g, "/"));
+    const withoutTrailing = stripTrailingSlash(normalized);
+    return caseSensitive
+        ? withoutTrailing.replace(/^([A-Z]):\//, (_, drive) => `${drive.toLowerCase()}:/`)
+        : withoutTrailing.toLowerCase();
+}
+export function hasGlobPattern(rawPath) {
+    return /[*?]/.test(String(rawPath ?? ""));
+}
+export function isSameOrDescendantPath(candidatePath, boundaryPath, options = {}) {
+    const candidate = normalizePathForComparison(candidatePath, options);
+    const boundary = normalizePathForComparison(boundaryPath, options);
+    if (!candidate || !boundary)
+        return false;
+    if (isRootLike(boundary))
+        return true;
+    if (candidate === boundary)
+        return true;
+    return candidate.startsWith(`${boundary}/`);
+}
+function escapeRegex(value) {
+    return value.replace(/[.+^${}()|[\]\\]/g, "\\$&");
+}
+function globToRegExp(pattern, options = {}) {
+    const normalized = normalizePathForComparison(pattern, options);
+    let source = "";
+    for (let i = 0; i < normalized.length; i += 1) {
+        const char = normalized[i];
+        if (char === "*") {
+            if (normalized[i + 1] === "*") {
+                source += ".*";
+                i += 1;
+            }
+            else {
+                source += "[^/]*";
+            }
+        }
+        else if (char === "?") {
+            source += "[^/]";
+        }
+        else {
+            source += escapeRegex(char);
+        }
+    }
+    return new RegExp(`^${source}$`, (options.caseSensitive ?? defaultCaseSensitive()) ? "" : "i");
+}
+export function matchesScopePattern(candidatePath, scopePattern, options = {}) {
+    const pattern = normalizePathForComparison(scopePattern, options);
+    if (!pattern)
+        return false;
+    if (isRootLike(pattern))
+        return true;
+    if (/[*?]/.test(pattern)) {
+        return globToRegExp(pattern, options).test(normalizePathForComparison(candidatePath, options));
+    }
+    return isSameOrDescendantPath(candidatePath, pattern, options);
+}
+export function normalizeScopePattern(rawPath, _options = {}) {
+    const normalized = toPosixPath(rawPath);
+    if (!normalized)
+        return "";
+    if (isRootLike(normalized))
+        return normalized;
+    if (hasGlobPattern(normalized))
+        return normalized.replace(/\/+$/, "");
+    return ensureTrailingSlash(normalized);
+}
+export function isPathInScope(candidatePath, scopePattern, options = {}) {
+    if (hasGlobPattern(scopePattern)) {
+        return matchesScopePattern(candidatePath, scopePattern, options);
+    }
+    return isSameOrDescendantPath(candidatePath, scopePattern, options);
+}
+export function isPathInAnyScope(candidatePath, scopePatterns, options = {}) {
+    return scopePatterns.some((scopePattern) => isPathInScope(candidatePath, scopePattern, options));
+}
+export function toPosixPath(rawPath) {
+    return normalizePathForComparison(rawPath, { caseSensitive: true }).replace(/^\.\//, "");
+}
+export function ensureTrailingSlash(rawPath) {
+    const normalized = toPosixPath(rawPath);
+    if (!normalized || normalized.endsWith("/"))
+        return normalized;
+    if (normalized === "." || normalized === "/")
+        return normalized;
+    return `${normalized}/`;
+}
+export function isPathInsideProject(projectRoot, targetPath, options = {}) {
+    return isSameOrDescendantPath(targetPath, projectRoot, options);
+}
+//# sourceMappingURL=path_scope_utils.js.map

package/dist/engine/core/path_scope_utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path_scope_utils.js","sourceRoot":"","sources":["../../../src/engine/core/path_scope_utils.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAM7B,SAAS,oBAAoB;IAC3B,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC;AACvE,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAe;IACvC,OAAO,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC;WACjC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC;WAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAa;IACvC,IAAI,KAAK,KAAK,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/D,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,KAAK,KAAK,EAAE;WACd,KAAK,KAAK,GAAG;WACb,KAAK,KAAK,IAAI;WACd,KAAK,KAAK,GAAG;WACb,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAAe,EACf,UAAiC,EAAE;IAEnC,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,oBAAoB,EAAE,CAAC;IACtE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAExB,MAAM,UAAU,GAAG,gBAAgB,CAAC,OAAO,CAAC;QAC1C,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;QACnD,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;IAEtD,MAAM,eAAe,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACvD,OAAO,aAAa;QAClB,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,KAAa,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC;QAC1F,CAAC,CAAC,eAAe,CAAC,WAAW,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,aAAqB,EACrB,YAAoB,EACpB,UAAiC,EAAE;IAEnC,MAAM,SAAS,GAAG,0BAA0B,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAG,0BAA0B,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACnE,IAAI,CAAC,SAAS,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1C,IAAI,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,IAAI,SAAS,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACxC,OAAO,SAAS,CAAC,UAAU,CAAC,GAAG,QAAQ,GAAG,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,KAAK,CAAC,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,YAAY,CAAC,OAAe,EAAE,UAAiC,EAAE;IACxE,MAAM,UAAU,GAAG,0BAA0B,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAChE,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,IAAI,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBAC9B,MAAM,IAAI,IAAI,CAAC;gBACf,CAAC,IAAI,CAAC,CAAC;YACT,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,OAAO,CAAC;YACpB,CAAC;QACH,CAAC;aAAM,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACxB,MAAM,IAAI,MAAM,CAAC;QACnB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,OAAO,IAAI,MAAM,CAAC,IAAI,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,aAAa,IAAI,oBAAoB,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AACjG,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,aAAqB,EACrB,YAAoB,EACpB,UAAiC,EAAE;IAEnC,MAAM,OAAO,GAAG,0BAA0B,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAClE,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,IAAI,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,OAAO,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,sBAAsB,CAAC,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,OAAe,EACf,WAAkC,EAAE;IAEpC,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,CAAC;IAC3B,IAAI,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC;IAC9C,IAAI,cAAc,CAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACtE,OAAO,mBAAmB,CAAC,UAAU,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,aAAqB,EACrB,YAAoB,EACpB,UAAiC,EAAE;IAEnC,IAAI,cAAc,CAAC,YAAY,CAAC,EAAE,CAAC;QACjC,OAAO,mBAAmB,CAAC,aAAa,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,sBAAsB,CAAC,aAAa,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,aAAqB,EACrB,aAAuB,EACvB,UAAiC,EAAE;IAEnC,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,aAAa,CAAC,aAAa,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;AACnG,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,0BAA0B,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,UAAU,CAAC;IAC/D,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,GAAG;QAAE,OAAO,UAAU,CAAC;IAChE,OAAO,GAAG,UAAU,GAAG,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,WAAmB,EACnB,UAAkB,EAClB,UAAiC,EAAE;IAEnC,OAAO,sBAAsB,CAAC,UAAU,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;AAClE,CAAC"}

package/dist/engine/core/paths.d.ts

@@ -0,0 +1,86 @@
+/**
+ * 集中路径常量 — 统一管理所有 .soloforge/ 相关路径。
+ *
+ * 消除 50+ 个文件中分散的硬编码路径字符串。
+ * 使用方式: import { getProjectPaths, SOLOFORGE_DIR } from "../core/paths.js"
+ */
+/** .soloforge 目录名 */
+export declare const SOLOFORGE_DIR = ".soloforge";
+/** 项目级路径集合 — 基于 projectPath 动态生成 */
+export declare function getProjectPaths(projectPath: string): {
+    /** .soloforge/ 根目录 */
+    root: string;
+    /** .soloforge/config.yaml */
+    configYaml: string;
+    /** .soloforge/config.evidence.json */
+    configEvidence: string;
+    /** .soloforge/policy.yaml */
+    policyYaml: string;
+    /** .soloforge/blueprint.yaml */
+    blueprintYaml: string;
+    /** .soloforge/state/ */
+    stateDir: string;
+    /** .soloforge/state/current-task.json */
+    currentTaskPointer: string;
+    /** .soloforge/state/debt/ */
+    debtDir: string;
+    /** .soloforge/state/onboarding-session.json */
+    onboardingSession: string;
+    /** .soloforge/knowledge/ */
+    knowledgeDir: string;
+    /** .soloforge/knowledge/patterns/ */
+    knowledgePatterns: string;
+    /** .soloforge/knowledge/patterns/core/ */
+    knowledgePatternsCore: string;
+    /** .soloforge/knowledge/patterns/temp/ */
+    knowledgePatternsTemp: string;
+    /** .soloforge/knowledge/procedures/ */
+    knowledgeProcedures: string;
+    /** .soloforge/knowledge/domain/backend/ */
+    knowledgeDomainBackend: string;
+    /** .soloforge/knowledge/domain/frontend/ */
+    knowledgeDomainFrontend: string;
+    /** .soloforge/knowledge/acceptance_templates/ */
+    knowledgeAcceptanceTemplates: string;
+    /** .soloforge/knowledge/review_rules/ */
+    knowledgeReviewRules: string;
+    /** .soloforge/knowledge/product_profiles/ */
+    knowledgeProductProfiles: string;
+    /** .soloforge/knowledge/checklists/ */
+    knowledgeChecklists: string;
+    /** .soloforge/knowledge/defaults.yaml */
+    knowledgeDefaults: string;
+    /** .soloforge/staged/ */
+    stagedDir: string;
+    /** .soloforge/navigation-snapshot.json */
+    navigationSnapshot: string;
+    /** .soloforge/template-manifest.json */
+    templateManifest: string;
+    /** .soloforge/adapter_hashes.json */
+    adapterHashes: string;
+    /** .soloforge/version.json */
+    versionJson: string;
+    /** .soloforge/manifest.json */
+    manifestJson: string;
+    /** .soloforge/sync-manifest.json */
+    syncManifest: string;
+    /** .soloforge/advisory-report.json */
+    advisoryReport: string;
+    /** .soloforge/output/ */
+    outputDir: string;
+    /** .soloforge/tmp/ingest/ */
+    tmpIngest: string;
+    /** .soloforge/design-artifacts/ */
+    designArtifactsDir: string;
+    /** .soloforge/config-backups/ */
+    configBackups: string;
+    /** .soloforge/backups/ */
+    backupsDir: string;
+    /** .soloforge/templates/ */
+    templatesDir: string;
+};
+/** 项目根目录下的锁文件（不在 .soloforge/ 内） */
+export declare function getLockFilePath(projectPath: string): string;
+/** 全局用户目录下的 patterns 路径 */
+export declare function getGlobalPatternsPath(): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/engine/core/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/engine/core/paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,qBAAqB;AACrB,eAAO,MAAM,aAAa,eAAe,CAAC;AAE1C,oCAAoC;AACpC,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM;IAG/C,sBAAsB;;IAItB,6BAA6B;;IAE7B,sCAAsC;;IAEtC,6BAA6B;;IAE7B,gCAAgC;;IAIhC,wBAAwB;;IAExB,yCAAyC;;IAEzC,6BAA6B;;IAE7B,+CAA+C;;IAI/C,4BAA4B;;IAE5B,qCAAqC;;IAErC,0CAA0C;;IAE1C,0CAA0C;;IAE1C,uCAAuC;;IAEvC,2CAA2C;;IAE3C,4CAA4C;;IAE5C,iDAAiD;;IAEjD,yCAAyC;;IAEzC,6CAA6C;;IAE7C,uCAAuC;;IAEvC,yCAAyC;;IAIzC,yBAAyB;;IAIzB,0CAA0C;;IAE1C,wCAAwC;;IAExC,qCAAqC;;IAErC,8BAA8B;;IAE9B,+BAA+B;;IAE/B,oCAAoC;;IAEpC,sCAAsC;;IAItC,yBAAyB;;IAEzB,6BAA6B;;IAI7B,mCAAmC;;IAInC,iCAAiC;;IAEjC,0BAA0B;;IAI1B,4BAA4B;;EAG/B;AAED,mCAAmC;AACnC,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,2BAA2B;AAC3B,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C"}

package/dist/engine/core/paths.js

@@ -0,0 +1,103 @@
+/**
+ * 集中路径常量 — 统一管理所有 .soloforge/ 相关路径。
+ *
+ * 消除 50+ 个文件中分散的硬编码路径字符串。
+ * 使用方式: import { getProjectPaths, SOLOFORGE_DIR } from "../core/paths.js"
+ */
+import path from "node:path";
+/** .soloforge 目录名 */
+export const SOLOFORGE_DIR = ".soloforge";
+/** 项目级路径集合 — 基于 projectPath 动态生成 */
+export function getProjectPaths(projectPath) {
+    const root = path.join(projectPath, SOLOFORGE_DIR);
+    return {
+        /** .soloforge/ 根目录 */
+        root,
+        // ── 配置文件 ──
+        /** .soloforge/config.yaml */
+        configYaml: path.join(root, "config.yaml"),
+        /** .soloforge/config.evidence.json */
+        configEvidence: path.join(root, "config.evidence.json"),
+        /** .soloforge/policy.yaml */
+        policyYaml: path.join(root, "policy.yaml"),
+        /** .soloforge/blueprint.yaml */
+        blueprintYaml: path.join(root, "blueprint.yaml"),
+        // ── 状态目录 ──
+        /** .soloforge/state/ */
+        stateDir: path.join(root, "state"),
+        /** .soloforge/state/current-task.json */
+        currentTaskPointer: path.join(root, "state", "current-task.json"),
+        /** .soloforge/state/debt/ */
+        debtDir: path.join(root, "state", "debt"),
+        /** .soloforge/state/onboarding-session.json */
+        onboardingSession: path.join(root, "state", "onboarding-session.json"),
+        // ── 知识库 ──
+        /** .soloforge/knowledge/ */
+        knowledgeDir: path.join(root, "knowledge"),
+        /** .soloforge/knowledge/patterns/ */
+        knowledgePatterns: path.join(root, "knowledge", "patterns"),
+        /** .soloforge/knowledge/patterns/core/ */
+        knowledgePatternsCore: path.join(root, "knowledge", "patterns", "core"),
+        /** .soloforge/knowledge/patterns/temp/ */
+        knowledgePatternsTemp: path.join(root, "knowledge", "patterns", "temp"),
+        /** .soloforge/knowledge/procedures/ */
+        knowledgeProcedures: path.join(root, "knowledge", "procedures"),
+        /** .soloforge/knowledge/domain/backend/ */
+        knowledgeDomainBackend: path.join(root, "knowledge", "domain", "backend"),
+        /** .soloforge/knowledge/domain/frontend/ */
+        knowledgeDomainFrontend: path.join(root, "knowledge", "domain", "frontend"),
+        /** .soloforge/knowledge/acceptance_templates/ */
+        knowledgeAcceptanceTemplates: path.join(root, "knowledge", "acceptance_templates"),
+        /** .soloforge/knowledge/review_rules/ */
+        knowledgeReviewRules: path.join(root, "knowledge", "review_rules"),
+        /** .soloforge/knowledge/product_profiles/ */
+        knowledgeProductProfiles: path.join(root, "knowledge", "product_profiles"),
+        /** .soloforge/knowledge/checklists/ */
+        knowledgeChecklists: path.join(root, "knowledge", "checklists"),
+        /** .soloforge/knowledge/defaults.yaml */
+        knowledgeDefaults: path.join(root, "knowledge", "defaults.yaml"),
+        // ── 暂存区 ──
+        /** .soloforge/staged/ */
+        stagedDir: path.join(root, "staged"),
+        // ── 其他文件 ──
+        /** .soloforge/navigation-snapshot.json */
+        navigationSnapshot: path.join(root, "navigation-snapshot.json"),
+        /** .soloforge/template-manifest.json */
+        templateManifest: path.join(root, "template-manifest.json"),
+        /** .soloforge/adapter_hashes.json */
+        adapterHashes: path.join(root, "adapter_hashes.json"),
+        /** .soloforge/version.json */
+        versionJson: path.join(root, "version.json"),
+        /** .soloforge/manifest.json */
+        manifestJson: path.join(root, "manifest.json"),
+        /** .soloforge/sync-manifest.json */
+        syncManifest: path.join(root, "sync-manifest.json"),
+        /** .soloforge/advisory-report.json */
+        advisoryReport: path.join(root, "advisory-report.json"),
+        // ── 输出目录 ──
+        /** .soloforge/output/ */
+        outputDir: path.join(root, "output"),
+        /** .soloforge/tmp/ingest/ */
+        tmpIngest: path.join(root, "tmp", "ingest"),
+        // ── 设计产物 ──
+        /** .soloforge/design-artifacts/ */
+        designArtifactsDir: path.join(root, "design-artifacts"),
+        // ── 备份 ──
+        /** .soloforge/config-backups/ */
+        configBackups: path.join(root, "config-backups"),
+        /** .soloforge/backups/ */
+        backupsDir: path.join(root, "backups"),
+        // ── 模板 ──
+        /** .soloforge/templates/ */
+        templatesDir: path.join(root, "templates"),
+    };
+}
+/** 项目根目录下的锁文件（不在 .soloforge/ 内） */
+export function getLockFilePath(projectPath) {
+    return path.join(projectPath, ".soloforge.lock");
+}
+/** 全局用户目录下的 patterns 路径 */
+export function getGlobalPatternsPath() {
+    return path.join(process.env.HOME ?? "", SOLOFORGE_DIR, "patterns");
+}
+//# sourceMappingURL=paths.js.map

package/dist/engine/core/paths.js.map

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

package/dist/engine/core/write_file_atomic.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 原子写入工具 — 先写 .tmp 再 rename，保证读者不会看到半写文件。
+ *
+ * 参考 task_context/manager.ts:save() 的 tmp+rename 模式：
+ * - 使用唯一 ID 后缀避免并发写入同一 .tmp 文件
+ * - rename 在文件系统层面保证原子性
+ * - 写入失败时 best-effort 清理 .tmp 文件
+ */
+/**
+ * 同步原子写入：先写 .tmp 再 rename。
+ *
+ * @param filePath - 目标文件路径
+ * @param content - 要写入的内容
+ * @param encoding - 编码，默认 "utf-8"
+ */
+export declare function atomicWriteFileSync(filePath: string, content: string, encoding?: BufferEncoding): void;
+/**
+ * 异步原子写入：先写 .tmp 再 rename。
+ *
+ * @param filePath - 目标文件路径
+ * @param content - 要写入的内容
+ * @param encoding - 编码，默认 "utf-8"
+ */
+export declare function atomicWriteFile(filePath: string, content: string, encoding?: BufferEncoding): Promise<void>;
+//# sourceMappingURL=write_file_atomic.d.ts.map

package/dist/engine/core/write_file_atomic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write_file_atomic.d.ts","sourceRoot":"","sources":["../../../src/engine/core/write_file_atomic.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,cAAwB,GACjC,IAAI,CAeN;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,cAAwB,GACjC,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/engine/core/write_file_atomic.js

@@ -0,0 +1,63 @@
+/**
+ * 原子写入工具 — 先写 .tmp 再 rename，保证读者不会看到半写文件。
+ *
+ * 参考 task_context/manager.ts:save() 的 tmp+rename 模式：
+ * - 使用唯一 ID 后缀避免并发写入同一 .tmp 文件
+ * - rename 在文件系统层面保证原子性
+ * - 写入失败时 best-effort 清理 .tmp 文件
+ */
+import fs from "node:fs";
+import fsp from "node:fs/promises";
+import path from "node:path";
+import crypto from "node:crypto";
+import { debug } from "./logger.js";
+/**
+ * 同步原子写入：先写 .tmp 再 rename。
+ *
+ * @param filePath - 目标文件路径
+ * @param content - 要写入的内容
+ * @param encoding - 编码，默认 "utf-8"
+ */
+export function atomicWriteFileSync(filePath, content, encoding = "utf-8") {
+    // 确保父目录存在
+    const dir = path.dirname(filePath);
+    fs.mkdirSync(dir, { recursive: true });
+    // 使用随机 ID 后缀避免并发写入冲突
+    const tmpPath = `${filePath}.${crypto.randomUUID().slice(0, 8)}.tmp`;
+    try {
+        fs.writeFileSync(tmpPath, content, encoding);
+        fs.renameSync(tmpPath, filePath);
+    }
+    catch (e) {
+        // best-effort 清理临时文件
+        try {
+            fs.unlinkSync(tmpPath);
+        }
+        catch { }
+        throw e;
+    }
+}
+/**
+ * 异步原子写入：先写 .tmp 再 rename。
+ *
+ * @param filePath - 目标文件路径
+ * @param content - 要写入的内容
+ * @param encoding - 编码，默认 "utf-8"
+ */
+export async function atomicWriteFile(filePath, content, encoding = "utf-8") {
+    // 确保父目录存在
+    const dir = path.dirname(filePath);
+    await fsp.mkdir(dir, { recursive: true });
+    // 使用随机 ID 后缀避免并发写入冲突
+    const tmpPath = `${filePath}.${crypto.randomUUID().slice(0, 8)}.tmp`;
+    try {
+        await fsp.writeFile(tmpPath, content, encoding);
+        await fsp.rename(tmpPath, filePath);
+    }
+    catch (e) {
+        // best-effort 清理临时文件
+        await fsp.unlink(tmpPath).catch((e) => { debug("原子写入", "清理临时文件失败", e); });
+        throw e;
+    }
+}
+//# sourceMappingURL=write_file_atomic.js.map

package/dist/engine/core/write_file_atomic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write_file_atomic.js","sourceRoot":"","sources":["../../../src/engine/core/write_file_atomic.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,GAAG,MAAM,kBAAkB,CAAC;AACnC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,OAAe,EACf,WAA2B,OAAO;IAElC,UAAU;IACV,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEvC,qBAAqB;IACrB,MAAM,OAAO,GAAG,GAAG,QAAQ,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC;IACrE,IAAI,CAAC;QACH,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC7C,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,qBAAqB;QACrB,IAAI,CAAC;YAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;QACxC,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAgB,EAChB,OAAe,EACf,WAA2B,OAAO;IAElC,UAAU;IACV,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1C,qBAAqB;IACrB,MAAM,OAAO,GAAG,GAAG,QAAQ,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC;IACrE,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAChD,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,qBAAqB;QACrB,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnF,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC"}

package/dist/engine/dependency_scanner.d.ts

@@ -1,4 +1,4 @@
-import type { DependencyScanResult } from "../types.js";
+import type { DependencyScanResult } from "../types/index.js";
 /**
  * 扫描依赖文件中的已知漏洞 — 根据文件名自动选择解析器。
  * 支持格式: package.json (Node.js)、pom.xml (Java/Maven)、build.gradle (Java/Gradle)。

package/dist/engine/dependency_scanner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dependency_scanner.d.ts","sourceRoot":"","sources":["../../src/engine/dependency_scanner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAwQ3E;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,oBAAoB,CA0FxF"}
+{"version":3,"file":"dependency_scanner.d.ts","sourceRoot":"","sources":["../../src/engine/dependency_scanner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAuQjF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,oBAAoB,CA+FxF"}