@jingyi0605/codingns 0.2.0 → 0.3.0

package/dist/server/modules/butler/session-summary-scheduler.js

@@ -1,31 +1,38 @@
 import { nowIso } from "../../shared/utils/time.js";
+import { resolveAdaptiveSchedulerDelayMs } from "../tasks/scheduler-metrics.js";
 const DEFAULT_INTERVAL_MS = 15_000;
 export class SessionSummaryScheduler {
     butlerSessionSummaryService;
     intervalMs;
+    maxIntervalMs;
     now;
     logger;
+    schedulerMetrics;
     timer = null;
     ticking = false;
+    started = false;
+    disposed = false;
+    idleStreak = 0;
     constructor(butlerSessionSummaryService, options = {}) {
         this.butlerSessionSummaryService = butlerSessionSummaryService;
         this.intervalMs = Math.max(5_000, options.intervalMs ?? DEFAULT_INTERVAL_MS);
+        this.maxIntervalMs = Math.max(this.intervalMs, options.maxIntervalMs ?? this.intervalMs * 8);
         this.now = options.now ?? nowIso;
         this.logger = options.logger ?? console;
+        this.schedulerMetrics = options.schedulerMetrics ?? null;
     }
     start() {
-        if (this.timer) {
+        if (this.timer || this.disposed) {
             return;
         }
-        void this.tick();
-        this.timer = setInterval(() => {
-            void this.tick();
-        }, this.intervalMs);
-        this.timer.unref?.();
+        this.started = true;
+        this.scheduleNext(0);
     }
     async dispose() {
+        this.started = false;
+        this.disposed = true;
         if (this.timer) {
-            clearInterval(this.timer);
+            clearTimeout(this.timer);
             this.timer = null;
         }
         while (this.ticking) {
@@ -33,24 +40,53 @@ export class SessionSummaryScheduler {
         }
     }
     async runOnce() {
-        await this.tick();
+        await this.tick(false);
+    }
+    scheduleNext(delayMs) {
+        this.timer = setTimeout(() => {
+            this.timer = null;
+            void this.tick();
+        }, delayMs);
+        this.timer.unref?.();
     }
-    async tick() {
+    async tick(shouldScheduleNext = true) {
         if (this.ticking) {
             return;
         }
         this.ticking = true;
+        const tickStartedAt = Date.now();
+        const referenceAt = this.now();
+        let result = null;
+        let errorCount = 0;
         try {
-            await this.butlerSessionSummaryService.runOnce();
+            result = await this.butlerSessionSummaryService.runOnce();
         }
         catch (error) {
+            errorCount = 1;
             this.logger.error("[butler-session-summary-scheduler] tick failed", {
                 error: error instanceof Error ? error.message : String(error),
-                referenceAt: this.now()
+                referenceAt
             });
         }
         finally {
             this.ticking = false;
+            const idle = result?.idle ?? true;
+            const taskCount = (result?.scheduledCount ?? 0) + (result?.summarizedCount ?? 0);
+            this.idleStreak = idle ? this.idleStreak + 1 : 0;
+            const nextDelayMs = resolveAdaptiveSchedulerDelayMs(this.intervalMs, this.maxIntervalMs, this.idleStreak);
+            this.schedulerMetrics?.recordTick({
+                schedulerName: "session_summary",
+                referenceAt,
+                durationMs: Date.now() - tickStartedAt,
+                taskCount,
+                idle,
+                errorCount,
+                nextDelayMs,
+                idleStreak: this.idleStreak
+            });
+            if (shouldScheduleNext && this.started && !this.disposed && this.timer === null) {
+                this.scheduleNext(nextDelayMs);
+            }
         }
     }
 }

package/dist/server/modules/butler/session-summary-scheduler.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-summary-scheduler.js","sourceRoot":"","sources":["../../../../src/modules/butler/session-summary-scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAGpD,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAYnC,MAAM,OAAO,uBAAuB;IAQf;IAPF,UAAU,CAAS;IACnB,GAAG,CAAe;IAClB,MAAM,CAAgC;IAC/C,KAAK,GAA0C,IAAI,CAAC;IACpD,OAAO,GAAG,KAAK,CAAC;IAExB,YACmB,2BAAyE,EAC1F,UAA0C,EAAE;QAD3B,gCAA2B,GAA3B,2BAA2B,CAA8C;QAG1F,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,IAAI,mBAAmB,CAAC,CAAC;QAC7E,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,MAAM,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC;IAC1C,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QAED,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;YAC5B,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;QACnB,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACpB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;QAED,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;IAEO,KAAK,CAAC,IAAI;QAChB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QAEpB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,2BAA2B,CAAC,OAAO,EAAE,CAAC;QACnD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,gDAAgD,EAAE;gBAClE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC7D,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;aACxB,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACvB,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"session-summary-scheduler.js","sourceRoot":"","sources":["../../../../src/modules/butler/session-summary-scheduler.ts"],"names":[],"mappings":"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"}

package/dist/server/modules/debug-target/debug-runtime-reconciliation-scheduler.d.ts

@@ -0,0 +1,38 @@
+import { type SchedulerMetrics } from "../tasks/scheduler-metrics.js";
+import type { DebugTargetService } from "./debug-target-service.js";
+interface DebugRuntimeReconciliationSchedulerLogger {
+    error(message: string, detail?: unknown): void;
+}
+interface DebugRuntimeReconciliationSchedulerOptions {
+    intervalMs?: number;
+    maxIntervalMs?: number;
+    now?: () => string;
+    logger?: DebugRuntimeReconciliationSchedulerLogger;
+    schedulerMetrics?: SchedulerMetrics;
+}
+/**
+ * 调试运行时后台巡检器。
+ *
+ * 这层只负责“多久跑一次”，真正的对账和回收逻辑全部留在 DebugTargetService，
+ * 避免调度器偷偷长出第二套状态规则。
+ */
+export declare class DebugRuntimeReconciliationScheduler {
+    private readonly debugTargetService;
+    private readonly intervalMs;
+    private readonly maxIntervalMs;
+    private readonly now;
+    private readonly logger;
+    private readonly schedulerMetrics;
+    private timer;
+    private ticking;
+    private started;
+    private disposed;
+    private idleStreak;
+    constructor(debugTargetService: Pick<DebugTargetService, "runBackgroundRuntimeReconciliation">, options?: DebugRuntimeReconciliationSchedulerOptions);
+    start(): void;
+    dispose(): Promise<void>;
+    runOnce(): Promise<void>;
+    private scheduleNext;
+    private tick;
+}
+export {};

package/dist/server/modules/debug-target/debug-runtime-reconciliation-scheduler.js

@@ -0,0 +1,99 @@
+import { nowIso } from "../../shared/utils/time.js";
+import { resolveAdaptiveSchedulerDelayMs } from "../tasks/scheduler-metrics.js";
+const DEFAULT_INTERVAL_MS = 10_000;
+/**
+ * 调试运行时后台巡检器。
+ *
+ * 这层只负责“多久跑一次”，真正的对账和回收逻辑全部留在 DebugTargetService，
+ * 避免调度器偷偷长出第二套状态规则。
+ */
+export class DebugRuntimeReconciliationScheduler {
+    debugTargetService;
+    intervalMs;
+    maxIntervalMs;
+    now;
+    logger;
+    schedulerMetrics;
+    timer = null;
+    ticking = false;
+    started = false;
+    disposed = false;
+    idleStreak = 0;
+    constructor(debugTargetService, options = {}) {
+        this.debugTargetService = debugTargetService;
+        this.intervalMs = Math.max(5_000, options.intervalMs ?? DEFAULT_INTERVAL_MS);
+        this.maxIntervalMs = Math.max(this.intervalMs, options.maxIntervalMs ?? this.intervalMs * 8);
+        this.now = options.now ?? nowIso;
+        this.logger = options.logger ?? console;
+        this.schedulerMetrics = options.schedulerMetrics ?? null;
+    }
+    start() {
+        if (this.timer || this.disposed) {
+            return;
+        }
+        this.started = true;
+        this.scheduleNext(0);
+    }
+    async dispose() {
+        this.started = false;
+        this.disposed = true;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        while (this.ticking) {
+            await new Promise((resolve) => setTimeout(resolve, 10));
+        }
+    }
+    async runOnce() {
+        await this.tick(false);
+    }
+    scheduleNext(delayMs) {
+        this.timer = setTimeout(() => {
+            this.timer = null;
+            void this.tick();
+        }, delayMs);
+        this.timer.unref?.();
+    }
+    async tick(shouldScheduleNext = true) {
+        if (this.ticking) {
+            return;
+        }
+        this.ticking = true;
+        const tickStartedAt = Date.now();
+        const referenceAt = this.now();
+        let result = null;
+        let errorCount = 0;
+        try {
+            result = await this.debugTargetService.runBackgroundRuntimeReconciliation("debug_runtime_scheduler.tick");
+        }
+        catch (error) {
+            errorCount = 1;
+            this.logger.error("[debug-runtime-reconciliation-scheduler] tick failed", {
+                error: error instanceof Error ? error.message : String(error),
+                referenceAt
+            });
+        }
+        finally {
+            this.ticking = false;
+            const idle = result?.idle ?? true;
+            const taskCount = result?.reconciledRuntimeCount ?? 0;
+            this.idleStreak = idle ? this.idleStreak + 1 : 0;
+            const nextDelayMs = resolveAdaptiveSchedulerDelayMs(this.intervalMs, this.maxIntervalMs, this.idleStreak);
+            this.schedulerMetrics?.recordTick({
+                schedulerName: "debug_runtime_reconciliation",
+                referenceAt,
+                durationMs: Date.now() - tickStartedAt,
+                taskCount,
+                idle,
+                errorCount,
+                nextDelayMs,
+                idleStreak: this.idleStreak
+            });
+            if (shouldScheduleNext && this.started && !this.disposed && this.timer === null) {
+                this.scheduleNext(nextDelayMs);
+            }
+        }
+    }
+}
+//# sourceMappingURL=debug-runtime-reconciliation-scheduler.js.map

package/dist/server/modules/debug-target/debug-runtime-reconciliation-scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-runtime-reconciliation-scheduler.js","sourceRoot":"","sources":["../../../../src/modules/debug-target/debug-runtime-reconciliation-scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACpD,OAAO,EACL,+BAA+B,EAEhC,MAAM,+BAA+B,CAAC;AAMvC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAcnC;;;;;GAKG;AACH,MAAM,OAAO,mCAAmC;IAa3B;IAZF,UAAU,CAAS;IACnB,aAAa,CAAS;IACtB,GAAG,CAAe;IAClB,MAAM,CAA4C;IAClD,gBAAgB,CAA0B;IACnD,KAAK,GAAyC,IAAI,CAAC;IACnD,OAAO,GAAG,KAAK,CAAC;IAChB,OAAO,GAAG,KAAK,CAAC;IAChB,QAAQ,GAAG,KAAK,CAAC;IACjB,UAAU,GAAG,CAAC,CAAC;IAEvB,YACmB,kBAAkF,EACnG,UAAsD,EAAE;QADvC,uBAAkB,GAAlB,kBAAkB,CAAgE;QAGnG,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,IAAI,mBAAmB,CAAC,CAAC;QAC7E,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;QAC7F,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,MAAM,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC;QACxC,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,IAAI,CAAC;IAC3D,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChC,OAAO;QACT,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QAErB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;QAED,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAEO,YAAY,CAAC,OAAe;QAClC,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC3B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAClB,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;QACnB,CAAC,EAAE,OAAO,CAAC,CAAC;QACZ,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;IACvB,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,kBAAkB,GAAG,IAAI;QAC1C,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACjC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC/B,IAAI,MAAM,GAA4C,IAAI,CAAC;QAC3D,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,kCAAkC,CACvE,8BAA8B,CAC/B,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,UAAU,GAAG,CAAC,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sDAAsD,EAAE;gBACxE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC7D,WAAW;aACZ,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;YAErB,MAAM,IAAI,GAAG,MAAM,EAAE,IAAI,IAAI,IAAI,CAAC;YAClC,MAAM,SAAS,GAAG,MAAM,EAAE,sBAAsB,IAAI,CAAC,CAAC;YACtD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACjD,MAAM,WAAW,GAAG,+BAA+B,CACjD,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,aAAa,EAClB,IAAI,CAAC,UAAU,CAChB,CAAC;YACF,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC;gBAChC,aAAa,EAAE,8BAA8B;gBAC7C,WAAW;gBACX,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa;gBACtC,SAAS;gBACT,IAAI;gBACJ,UAAU;gBACV,WAAW;gBACX,UAAU,EAAE,IAAI,CAAC,UAAU;aAC5B,CAAC,CAAC;YAEH,IAAI,kBAAkB,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;gBAChF,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/server/modules/debug-target/debug-target-controller.d.ts

@@ -0,0 +1,70 @@
+import type { FastifyReply, FastifyRequest } from "fastify";
+import type { DebugTargetService } from "./debug-target-service.js";
+interface AnalyzeDebugTargetBody {
+    workspaceId?: string;
+    rootPath?: string;
+    commandHints?: unknown;
+}
+interface DebugTargetParams {
+    targetId?: string;
+}
+interface DebugTargetRuntimeHistoryQuery {
+    limit?: string;
+}
+interface RunDebugTargetBody {
+    shell?: string;
+    runtimeType?: string | null;
+}
+interface AiFallbackEditParams {
+    editId?: string;
+}
+interface AiFallbackEditBody {
+    patchRef?: string | null;
+    rollbackRef?: string | null;
+}
+export declare class DebugTargetController {
+    private readonly debugTargetService;
+    constructor(debugTargetService: DebugTargetService);
+    readonly analyze: (request: FastifyRequest<{
+        Body: AnalyzeDebugTargetBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly getFrameworkAnalysis: (request: FastifyRequest<{
+        Params: DebugTargetParams;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly refreshFrameworkAnalysis: (request: FastifyRequest<{
+        Params: DebugTargetParams;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly createLaunchPlan: (request: FastifyRequest<{
+        Params: DebugTargetParams;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly run: (request: FastifyRequest<{
+        Params: DebugTargetParams;
+        Body: RunDebugTargetBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly getRuntime: (request: FastifyRequest<{
+        Params: {
+            runtimeId?: string;
+        };
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly getLatestRuntime: (request: FastifyRequest<{
+        Params: DebugTargetParams;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly getRuntimeHistory: (request: FastifyRequest<{
+        Params: DebugTargetParams;
+        Querystring: DebugTargetRuntimeHistoryQuery;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly getCompatibilityMatrix: (_request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    readonly applyAiFallbackEdit: (request: FastifyRequest<{
+        Params: AiFallbackEditParams;
+        Body: AiFallbackEditBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly rejectAiFallbackEdit: (request: FastifyRequest<{
+        Params: AiFallbackEditParams;
+        Body: AiFallbackEditBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly rollbackAiFallbackEdit: (request: FastifyRequest<{
+        Params: AiFallbackEditParams;
+        Body: AiFallbackEditBody;
+    }>, reply: FastifyReply) => Promise<void>;
+}
+export {};

package/dist/server/modules/debug-target/debug-target-controller.js

@@ -0,0 +1,113 @@
+import { AppError } from "../../shared/errors/app-error.js";
+export class DebugTargetController {
+    debugTargetService;
+    constructor(debugTargetService) {
+        this.debugTargetService = debugTargetService;
+    }
+    analyze = async (request, reply) => {
+        const workspaceId = request.body.workspaceId?.trim();
+        const rootPath = request.body.rootPath?.trim();
+        if (!workspaceId) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "INVALID_INPUT",
+                detail: "分析调试目标必须提供 workspaceId",
+                field: "workspaceId"
+            });
+        }
+        if (!rootPath) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "INVALID_INPUT",
+                detail: "分析调试目标必须提供 rootPath",
+                field: "rootPath"
+            });
+        }
+        reply.send(this.debugTargetService.analyze({
+            workspaceId,
+            rootPath,
+            commandHints: normalizeCommandHints(request.body.commandHints)
+        }));
+    };
+    getFrameworkAnalysis = async (request, reply) => {
+        reply.send(this.debugTargetService.getFrameworkAnalysis(request.params.targetId?.trim() || ""));
+    };
+    refreshFrameworkAnalysis = async (request, reply) => {
+        reply.send(this.debugTargetService.refreshFrameworkAnalysis(request.params.targetId?.trim() || ""));
+    };
+    createLaunchPlan = async (request, reply) => {
+        reply.send(await this.debugTargetService.createLaunchPlan(request.params.targetId?.trim() || ""));
+    };
+    run = async (request, reply) => {
+        reply.send(await this.debugTargetService.run({
+            targetId: request.params.targetId?.trim() || "",
+            userId: request.auth.user.userId,
+            shell: request.body?.shell?.trim() || undefined,
+            runtimeType: normalizeRuntimeType(request.body?.runtimeType)
+        }));
+    };
+    getRuntime = async (request, reply) => {
+        reply.send(await this.debugTargetService.getRuntimeDetail(request.params.runtimeId?.trim() || ""));
+    };
+    getLatestRuntime = async (request, reply) => {
+        reply.send(await this.debugTargetService.getLatestRuntimeDetail(request.params.targetId?.trim() || ""));
+    };
+    getRuntimeHistory = async (request, reply) => {
+        const rawLimit = request.query.limit?.trim();
+        const limit = rawLimit ? Number.parseInt(rawLimit, 10) : 5;
+        reply.send(await this.debugTargetService.getRecentRuntimeDetails(request.params.targetId?.trim() || "", Number.isNaN(limit) ? 5 : limit));
+    };
+    getCompatibilityMatrix = async (_request, reply) => {
+        reply.send(this.debugTargetService.getCompatibilityMatrix());
+    };
+    applyAiFallbackEdit = async (request, reply) => {
+        reply.send(this.debugTargetService.updateAiFallbackEdit(request.params.editId?.trim() || "", "apply", {
+            patchRef: request.body?.patchRef ?? null,
+            rollbackRef: request.body?.rollbackRef ?? null
+        }));
+    };
+    rejectAiFallbackEdit = async (request, reply) => {
+        reply.send(this.debugTargetService.updateAiFallbackEdit(request.params.editId?.trim() || "", "reject", {
+            patchRef: request.body?.patchRef ?? null,
+            rollbackRef: request.body?.rollbackRef ?? null
+        }));
+    };
+    rollbackAiFallbackEdit = async (request, reply) => {
+        reply.send(this.debugTargetService.updateAiFallbackEdit(request.params.editId?.trim() || "", "rollback", {
+            patchRef: request.body?.patchRef ?? null,
+            rollbackRef: request.body?.rollbackRef ?? null
+        }));
+    };
+}
+function normalizeCommandHints(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value.filter((item) => typeof item === "string").map((item) => item.trim()).filter(Boolean);
+}
+function normalizeRuntimeType(input) {
+    if (input === undefined) {
+        return undefined;
+    }
+    if (input === null) {
+        return null;
+    }
+    const value = input.trim();
+    if (!value) {
+        return null;
+    }
+    if (value === "embedded-pty" ||
+        value === "tmux" ||
+        value === "conpty-powershell" ||
+        value === "conpty-cmd" ||
+        value === "conpty-git-bash") {
+        return value;
+    }
+    throw new AppError({
+        statusCode: 400,
+        errorCode: "INVALID_INPUT",
+        detail: `不支持的终端 runtimeType：${value}`,
+        field: "runtimeType"
+    });
+}
+//# sourceMappingURL=debug-target-controller.js.map

package/dist/server/modules/debug-target/debug-target-controller.js.map

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

package/dist/server/modules/debug-target/debug-target-service.d.ts

@@ -0,0 +1,105 @@
+import type Database from "better-sqlite3";
+import type { AiFallbackEditRepository } from "../../storage/repositories/ai-fallback-edit-repository.js";
+import type { DebugServiceRepository } from "../../storage/repositories/debug-service-repository.js";
+import type { DebugRuntimeSessionRepository } from "../../storage/repositories/debug-runtime-session-repository.js";
+import type { DebugTargetRepository } from "../../storage/repositories/debug-target-repository.js";
+import type { FrameworkAnalysisResultRepository } from "../../storage/repositories/framework-analysis-result-repository.js";
+import type { PortLeaseRepository } from "../../storage/repositories/port-lease-repository.js";
+import type { RuntimeBindingRepository } from "../../storage/repositories/runtime-binding-repository.js";
+import type { WorkspaceWorktreeRepository } from "../../storage/repositories/workspace-worktree-repository.js";
+import type { AiFallbackEditRecord, DebugLaunchPlan, DebugRuntimeHistoryEnvelope, DebugRuntimeDetail, DebugRuntimeSession, DebugServiceSpec, DebugTargetProfile, FrameworkAnalysisResult, TerminalCommandTemplate, TerminalInstance, TerminalRuntimeType } from "../../types/domain.js";
+import type { TerminalService } from "../terminal/terminal-service.js";
+import { TaskManager } from "../tasks/task-manager.js";
+import type { WorkspaceService } from "../workspace/workspace-service.js";
+import { FRAMEWORK_COMPATIBILITY_MATRIX } from "./framework-compatibility-matrix.js";
+export interface AnalyzeDebugTargetInput {
+    workspaceId: string;
+    rootPath: string;
+    commandHints?: string[];
+}
+export interface AnalyzeDebugTargetResult {
+    target: DebugTargetProfile;
+    services: DebugServiceSpec[];
+    analyses: FrameworkAnalysisResult[];
+    autoInjectionEligible: boolean;
+}
+export interface RunDebugTargetInput {
+    targetId: string;
+    userId: string;
+    shell?: string;
+    runtimeType?: TerminalRuntimeType | null;
+}
+export interface DebugRuntimeReconciliationResult {
+    scannedRuntimeCount: number;
+    reconciledRuntimeCount: number;
+    staleLeaseCount: number;
+    releasedLeaseCount: number;
+    failedRuntimeCount: number;
+    stoppedRuntimeCount: number;
+    idle: boolean;
+}
+export declare class DebugTargetService {
+    private readonly db;
+    private readonly workspaceService;
+    private readonly workspaceWorktreeRepository;
+    private readonly debugTargetRepository;
+    private readonly debugServiceRepository;
+    private readonly frameworkAnalysisResultRepository;
+    private readonly debugRuntimeSessionRepository;
+    private readonly portLeaseRepository;
+    private readonly runtimeBindingRepository;
+    private readonly aiFallbackEditRepository;
+    private readonly terminalCommandTemplateRepository;
+    private readonly terminalService;
+    private readonly terminalInstanceRepository;
+    private readonly taskManager;
+    constructor(db: Database.Database, workspaceService: WorkspaceService, workspaceWorktreeRepository: Pick<WorkspaceWorktreeRepository, "findByWorkspaceId">, debugTargetRepository: DebugTargetRepository, debugServiceRepository: DebugServiceRepository, frameworkAnalysisResultRepository: FrameworkAnalysisResultRepository, debugRuntimeSessionRepository: DebugRuntimeSessionRepository, portLeaseRepository: PortLeaseRepository, runtimeBindingRepository: RuntimeBindingRepository, aiFallbackEditRepository: AiFallbackEditRepository, terminalCommandTemplateRepository: {
+        listByWorkspace(workspaceId: string): TerminalCommandTemplate[];
+    }, terminalService: Pick<TerminalService, "createTerminal" | "writeInput" | "closeTerminal" | "getTerminalOrThrow">, terminalInstanceRepository: {
+        findById(id: string): TerminalInstance | null;
+    }, taskManager?: TaskManager);
+    analyze(input: AnalyzeDebugTargetInput): AnalyzeDebugTargetResult;
+    getFrameworkAnalysis(targetId: string): {
+        targetId: string;
+        items: FrameworkAnalysisResult[];
+    };
+    refreshFrameworkAnalysis(targetId: string): AnalyzeDebugTargetResult;
+    getCompatibilityMatrix(): {
+        version: string;
+        items: typeof FRAMEWORK_COMPATIBILITY_MATRIX;
+    };
+    createLaunchPlan(targetId: string): Promise<DebugLaunchPlan>;
+    run(input: RunDebugTargetInput): Promise<{
+        runtimeSession: DebugRuntimeSession;
+        services: Array<{
+            serviceId: string;
+            processInstanceId: string;
+            terminalId: string;
+            leasedPort: number | null;
+            runtimeBindingId: string;
+        }>;
+    }>;
+    handleTerminalExit(event: {
+        terminal: TerminalInstance;
+        requestedClose: boolean;
+    }): Promise<void>;
+    getRuntimeDetail(runtimeId: string): Promise<DebugRuntimeDetail>;
+    getLatestRuntimeDetail(targetId: string): Promise<DebugRuntimeDetail | null>;
+    getRecentRuntimeDetails(targetId: string, limit?: number): Promise<DebugRuntimeHistoryEnvelope>;
+    runBackgroundRuntimeReconciliation(source?: string): Promise<DebugRuntimeReconciliationResult>;
+    updateAiFallbackEdit(editId: string, action: "apply" | "reject" | "rollback", refs?: {
+        patchRef?: string | null;
+        rollbackRef?: string | null;
+    }): AiFallbackEditRecord;
+    private getTargetOrThrow;
+    private getServiceOrThrow;
+    private upsertTarget;
+    private resolveSourceMeta;
+    private resolveRootPath;
+    private registerBackgroundTasks;
+    private failRuntimePlan;
+    private reconcileActiveRuntimeLeases;
+    private reconcileRuntimeState;
+    private collectReconciliationRuntimeIds;
+    private releaseStaleLeases;
+}