@ai-agent-forge/agent-forge 0.85.0

package/dist/profiles/suite-lifecycle.js

@@ -0,0 +1,447 @@
+/**
+ * Suite lifecycle operations (方案系统设计.md v2 §9, M4): create/clone,
+ * delete (trash + release + sweep), reset, session reference scan, and
+ * dangling settings cleanup.
+ *
+ * Every operation is deterministic given its inputs (`now` is injectable) and
+ * reports refusal reasons as structured errors. Deletion only ever renames
+ * the workspace into the trash directory — release and sweep are separate,
+ * re-runnable steps — so recovery stays possible until the trash is released.
+ * Memory purge is intentionally a hook: the Foundation purge gate lands with
+ * M5; before that only suite assets are released.
+ */
+import { randomUUID } from "node:crypto";
+import { closeSync, cpSync, existsSync, mkdirSync, openSync, readdirSync, readFileSync, readSync, renameSync, statSync, writeFileSync, } from "node:fs";
+import { readdir, rm, stat } from "node:fs/promises";
+import { basename, join } from "node:path";
+import { StringDecoder } from "node:string_decoder";
+import { generateDiffString } from "../core/tools/edit-diff.js";
+import { createProfileLock, replaceProfileLock } from "../profile/lock.js";
+import { createProfileMigrationPolicy } from "../profile/profile-migration.js";
+import { BUILTIN_SUITE_CAPABILITIES, BUILTIN_SUITE_TOOLS, DEFAULT_ROLE_ASSOCIATIONS, FACTORY_CONTENTS_VERSION, getBuiltinSuite, isBuiltinSuiteId, isValidSuiteId, SUITE_SCHEMA_VERSION, serializeSuiteJson, } from "./builtin-suites.js";
+import { buildSuiteProfileIdentity, getSuitesRootDir, getSuiteWorkspaceDir, loadSuiteWorkspace, parseSuiteProfileLockFile, SUITE_AGENTS_MD_FILENAME, SUITE_LOCK_FILENAME, SUITE_MANIFEST_FILENAME, SUITE_SESSION_ENTRY_TYPE, SuiteResolutionError, serializeSuiteProfileLockFile, suiteManifestDigest, } from "./suite-loader.js";
+export const SUITE_TRASH_DIR_NAME = ".trash";
+/** Trash retention for sweepSuiteTrash (M4 decision record). */
+export const DEFAULT_SUITE_TRASH_RETENTION_MS = 7 * 24 * 60 * 60 * 1000;
+/**
+ * Explicit programmatic authorization token for deleteSuite. The CLI confirms
+ * interactively before calling; programmatic callers pass this token to prove
+ * intent. Absent keeps the CLI-first flow working.
+ */
+export const SUITE_DELETE_CONFIRM_TOKEN = "suite-delete";
+/** lockedBy/authorizedBy stamped onto locks created by --suite-reset (2.7b). */
+export const SUITE_RESET_AUTHORIZED_BY = "suite-reset";
+/** Structured lifecycle refusal: operation, suite id, and every reason. */
+export class SuiteLifecycleError extends Error {
+    operation;
+    suiteId;
+    reasons;
+    constructor(operation, suiteId, reasons) {
+        super(`Suite ${operation} failed for "${suiteId}": ${reasons.join("; ")}`);
+        this.name = "SuiteLifecycleError";
+        this.operation = operation;
+        this.suiteId = suiteId;
+        this.reasons = Object.freeze([...reasons]);
+    }
+}
+/**
+ * Creates a user suite workspace (设计 §9): `<agentDir>/suites/<id>/` with a
+ * suite.json plus an empty agents.md skeleton, or — with `cloneFrom` — a copy
+ * of the source workspace (effective definition, so a corrupted builtin
+ * source clones its factory content) with the suite.json identity rewritten:
+ * new id, `builtin: false`, and a `clonedFrom` record carrying the source id
+ * and the digest of the source's effective suite.json value. The source's
+ * `.profile-lock.json` is never copied: the clone is a new profile identity
+ * whose lock is created on first assembly.
+ */
+export function createSuite(options) {
+    const { agentDir, id } = options;
+    const suiteDir = getSuiteWorkspaceDir(agentDir, id);
+    const suiteJsonPath = join(suiteDir, SUITE_MANIFEST_FILENAME);
+    const reasons = [];
+    if (!isValidSuiteId(id)) {
+        reasons.push(`id must be a suite id (^[a-z0-9-]+$, no leading/trailing hyphen, Windows reserved names rejected), found ${JSON.stringify(id)}`);
+    }
+    if (isBuiltinSuiteId(id)) {
+        reasons.push(`"${id}" is a builtin suite id; builtin workspaces are provisioned automatically and cannot be created`);
+    }
+    if (existsSync(suiteDir)) {
+        reasons.push(`workspace directory ${suiteDir} already exists`);
+    }
+    if (reasons.length > 0)
+        throw new SuiteLifecycleError("create", id, reasons);
+    let definition;
+    if (options.cloneFrom === undefined) {
+        definition = {
+            schemaVersion: SUITE_SCHEMA_VERSION,
+            id,
+            name: options.name ?? id,
+            builtin: false,
+            tools: BUILTIN_SUITE_TOOLS,
+            capabilities: BUILTIN_SUITE_CAPABILITIES,
+            associations: { skills: [], mcp: [], plugins: [], roles: DEFAULT_ROLE_ASSOCIATIONS },
+            inheritSystemAgentsMd: false,
+            memory: "assistant",
+            orientation: "assistant",
+            model: null,
+            thinking: null,
+            clonedFrom: null,
+            factoryRevision: FACTORY_CONTENTS_VERSION,
+        };
+        mkdirSync(suiteDir, { recursive: true });
+        writeFileSync(suiteJsonPath, serializeSuiteJson(definition), "utf8");
+        writeFileSync(join(suiteDir, SUITE_AGENTS_MD_FILENAME), "", "utf8");
+    }
+    else {
+        const source = loadEffectiveSourceWorkspace(agentDir, options.cloneFrom);
+        definition = {
+            ...source.suite,
+            id,
+            name: options.name ?? `${source.suite.name} clone`,
+            builtin: false,
+            clonedFrom: {
+                id: source.suite.id,
+                digest: suiteManifestDigest(source.suite),
+                at: options.now?.() ?? Date.now(),
+            },
+            factoryRevision: FACTORY_CONTENTS_VERSION,
+        };
+        // Copy user assets (agents.md, skills, plugins, ...) but never the
+        // source profile lock: the clone freezes its own identity on first
+        // assembly.
+        cpSync(source.suiteDir, suiteDir, {
+            recursive: true,
+            filter: (sourcePath) => basename(sourcePath) !== SUITE_LOCK_FILENAME,
+        });
+        writeFileSync(suiteJsonPath, serializeSuiteJson(definition), "utf8");
+    }
+    return { suiteId: id, suiteDir, suiteJsonPath, definition };
+}
+function loadEffectiveSourceWorkspace(agentDir, cloneFrom) {
+    try {
+        return loadSuiteWorkspace({ agentDir, suiteId: cloneFrom });
+    }
+    catch (error) {
+        if (error instanceof SuiteResolutionError) {
+            throw new SuiteLifecycleError("create", cloneFrom, [`clone source "${cloneFrom}" does not exist`]);
+        }
+        throw new SuiteLifecycleError("create", cloneFrom, [
+            `clone source "${cloneFrom}" is unusable: ${error instanceof Error ? error.message : String(error)}`,
+        ]);
+    }
+}
+/** Bounded head-scan window, aligned with the session header reader (1 MB). */
+const SUITE_REF_SCAN_LIMIT_BYTES = 1024 * 1024;
+const SUITE_REF_READ_BUFFER_SIZE = 64 * 1024;
+/**
+ * Scans every session tree under `<agentDir>/sessions/<project>/*.jsonl` for
+ * sessions whose creation-time custom entry (customType "suite") binds them
+ * to `suiteId` (设计 §10.1). The suite entry sits in the first few lines of
+ * the file, so a bounded head scan (1 MB, matching the session header reader)
+ * is sufficient; a file whose binding line has been seen is decided — later
+ * lines cannot change it. Unreadable, oversized, or malformed files are
+ * skipped, never fatal. Custom session dirs (--session-dir) are out of scope.
+ */
+export function findSuiteSessionRefs(agentDir, suiteId) {
+    const sessionsDir = join(agentDir, "sessions");
+    if (!existsSync(sessionsDir))
+        return [];
+    const refs = [];
+    for (const projectEntry of readdirSync(sessionsDir, { withFileTypes: true })) {
+        if (!projectEntry.isDirectory())
+            continue;
+        const projectDir = join(sessionsDir, projectEntry.name);
+        let files;
+        try {
+            files = readdirSync(projectDir).filter((file) => file.endsWith(".jsonl"));
+        }
+        catch {
+            continue;
+        }
+        for (const file of files) {
+            const path = join(projectDir, file);
+            try {
+                const outcome = scanSessionFileForSuiteBinding(path, suiteId);
+                if (outcome.bound && outcome.sessionId !== undefined) {
+                    refs.push({
+                        path,
+                        sessionId: outcome.sessionId,
+                        cwd: outcome.cwd,
+                        modified: statSync(path).mtime,
+                    });
+                }
+            }
+            catch {
+                // Skip unreadable files; one bad file must not block deletion.
+            }
+        }
+    }
+    return refs;
+}
+function scanSessionFileForSuiteBinding(path, suiteId) {
+    const fd = openSync(path, "r");
+    try {
+        const decoder = new StringDecoder("utf8");
+        const buffer = Buffer.allocUnsafe(SUITE_REF_READ_BUFFER_SIZE);
+        let scannedBytes = 0;
+        let sessionId;
+        let cwd;
+        let leftover = "";
+        let bound = false;
+        let bindingDecided = false;
+        while (scannedBytes < SUITE_REF_SCAN_LIMIT_BYTES && !bindingDecided) {
+            const readLength = Math.min(buffer.length, SUITE_REF_SCAN_LIMIT_BYTES - scannedBytes);
+            const bytesRead = readSync(fd, buffer, 0, readLength, null);
+            if (bytesRead === 0)
+                break;
+            scannedBytes += bytesRead;
+            const chunk = leftover + decoder.write(buffer.subarray(0, bytesRead));
+            const lines = chunk.split("\n");
+            leftover = lines.pop() ?? "";
+            for (const line of lines) {
+                const entry = parseSuiteRefLine(line);
+                if (entry === undefined)
+                    continue;
+                if (entry.header !== undefined && sessionId === undefined) {
+                    sessionId = entry.header.id;
+                    cwd = entry.header.cwd;
+                }
+                if (entry.boundToSuite !== undefined) {
+                    bound = entry.boundToSuite === suiteId;
+                    bindingDecided = true;
+                    break;
+                }
+            }
+        }
+        return { sessionId, cwd, bound };
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+function parseSuiteRefLine(line) {
+    const trimmed = line.trim();
+    if (trimmed.length === 0)
+        return undefined;
+    let value;
+    try {
+        value = JSON.parse(trimmed);
+    }
+    catch {
+        return undefined;
+    }
+    if (value === null || typeof value !== "object" || Array.isArray(value))
+        return undefined;
+    const record = value;
+    if (record.type === "session" && typeof record.id === "string") {
+        return { header: { id: record.id, cwd: typeof record.cwd === "string" ? record.cwd : undefined } };
+    }
+    if (record.type === "custom" && record.customType === SUITE_SESSION_ENTRY_TYPE) {
+        const data = record.data;
+        const suiteId = data !== null && typeof data === "object" && typeof data.suiteId === "string"
+            ? data.suiteId
+            : undefined;
+        return suiteId === undefined ? {} : { boundToSuite: suiteId };
+    }
+    return {};
+}
+/**
+ * Moves a user suite workspace into `<agentDir>/suites/.trash/<id>-<UTC
+ * compact timestamp>-<random>/`. Builtin suites are refused; the workspace
+ * (directory + suite.json) must exist but does not need to parse; any
+ * session reference refuses the delete with the full list. The rename keeps
+ * the workspace recoverable; releaseTrashedSuite/sweepSuiteTrash do the
+ * actual removal.
+ */
+export function deleteSuite(options) {
+    const { agentDir, id } = options;
+    if (options.confirmToken !== undefined && options.confirmToken !== SUITE_DELETE_CONFIRM_TOKEN) {
+        throw new SuiteLifecycleError("delete", id, [
+            `confirmToken must be "${SUITE_DELETE_CONFIRM_TOKEN}" when provided`,
+        ]);
+    }
+    const reasons = [];
+    if (isBuiltinSuiteId(id)) {
+        reasons.push(`builtin suite "${id}" cannot be deleted`);
+    }
+    const suiteDir = getSuiteWorkspaceDir(agentDir, id);
+    const suiteJsonPath = join(suiteDir, SUITE_MANIFEST_FILENAME);
+    if (!existsSync(suiteDir)) {
+        reasons.push(`workspace directory ${suiteDir} does not exist`);
+    }
+    else if (!existsSync(suiteJsonPath)) {
+        reasons.push(`${suiteJsonPath} does not exist`);
+    }
+    if (reasons.length > 0)
+        throw new SuiteLifecycleError("delete", id, reasons);
+    if (options.refs.length > 0) {
+        throw new SuiteLifecycleError("delete", id, options.refs.map((ref) => `session ${ref.sessionId} at ${ref.path} references this suite`));
+    }
+    const trashRoot = join(getSuitesRootDir(agentDir), SUITE_TRASH_DIR_NAME);
+    mkdirSync(trashRoot, { recursive: true });
+    const trashPath = join(trashRoot, `${id}-${formatTrashTimestamp(options.now?.() ?? Date.now())}-${randomUUID().replaceAll("-", "").slice(0, 6)}`);
+    renameSync(suiteDir, trashPath);
+    options.purgeMemories?.(id);
+    return { trashPath };
+}
+function formatTrashTimestamp(ms) {
+    // UTC compact, sortable: "20260907T123456789Z".
+    return new Date(ms).toISOString().replace(/[-:]/g, "").replace(".", "");
+}
+/**
+ * Fire-and-forget removal of one trash entry (Node's built-in Windows retry
+ * semantics). Failures never throw: the entry simply remains for the next
+ * sweepSuiteTrash run.
+ */
+export function releaseTrashedSuite(trashPath) {
+    void rm(trashPath, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 }).catch(() => {
+        // Left for sweepSuiteTrash; release is re-runnable by structure.
+    });
+}
+/**
+ * Removes trash entries older than `retentionMs` (default 7 days, per the M4
+ * decision record). Entries are aged by their mtime; unreadable entries are
+ * kept. Deterministic given the injectable clock.
+ */
+export async function sweepSuiteTrash(agentDir, options = {}) {
+    const trashRoot = join(getSuitesRootDir(agentDir), SUITE_TRASH_DIR_NAME);
+    const retentionMs = options.retentionMs ?? DEFAULT_SUITE_TRASH_RETENTION_MS;
+    const cutoffMs = (options.now?.() ?? Date.now()) - retentionMs;
+    const removed = [];
+    const kept = [];
+    let entryNames;
+    try {
+        entryNames = await readdir(trashRoot);
+    }
+    catch {
+        return { removed: Object.freeze(removed), kept: Object.freeze(kept) };
+    }
+    for (const name of entryNames) {
+        const entryPath = join(trashRoot, name);
+        try {
+            const stats = await stat(entryPath);
+            if (stats.mtimeMs <= cutoffMs) {
+                await rm(entryPath, { recursive: true, force: true });
+                removed.push(name);
+            }
+            else {
+                kept.push(name);
+            }
+        }
+        catch {
+            kept.push(name);
+        }
+    }
+    return { removed: Object.freeze(removed), kept: Object.freeze(kept) };
+}
+/**
+ * Plans a builtin suite reset (设计 §9 重置): diff the on-disk suite.json
+ * against the factory declaration without touching anything. User suites are
+ * refused — they have no factory contents to restore; remove them instead.
+ */
+export function resetSuite(options) {
+    const { agentDir, id } = options;
+    const factory = getBuiltinSuite(id);
+    if (factory === undefined) {
+        throw new SuiteLifecycleError("reset", id, [
+            isBuiltinSuiteId(id)
+                ? `builtin suite "${id}" has no factory declaration`
+                : `suite "${id}" is not builtin; only builtin suites can be reset — delete user suites instead`,
+        ]);
+    }
+    const suiteDir = getSuiteWorkspaceDir(agentDir, id);
+    const suiteJsonPath = join(suiteDir, SUITE_MANIFEST_FILENAME);
+    const lockPath = join(suiteDir, SUITE_LOCK_FILENAME);
+    const factoryJson = serializeSuiteJson(factory);
+    const currentRaw = existsSync(suiteJsonPath) ? readFileSync(suiteJsonPath, "utf8") : "";
+    const apply = () => {
+        const identity = buildSuiteProfileIdentity(factory);
+        // Evaluate the replacement before any write (2.7b): a failure above this
+        // point leaves the previous suite.json and lock untouched.
+        let previousLock;
+        if (existsSync(lockPath)) {
+            try {
+                previousLock = parseSuiteProfileLockFile(readFileSync(lockPath, "utf8"));
+            }
+            catch {
+                previousLock = undefined;
+            }
+        }
+        let lock;
+        let previousGeneration;
+        let replaced = false;
+        if (previousLock !== undefined) {
+            // Explicit authorized migration (2.7b): applyMigration decides whether
+            // the stored lock is already current; only a non-current outcome
+            // replaces the lock, through replaceProfileLock — the lock's only
+            // authorized swap primitive (generation increments).
+            const policy = createProfileMigrationPolicy();
+            const migration = policy.applyMigration({
+                lock: previousLock,
+                current: identity,
+                authorizedBy: SUITE_RESET_AUTHORIZED_BY,
+                ...(options.now === undefined ? {} : { now: options.now }),
+            });
+            if (migration.status === "failed") {
+                throw new SuiteLifecycleError("reset", id, [migration.reason]);
+            }
+            if (migration.status === "current") {
+                lock = previousLock;
+            }
+            else {
+                const swap = replaceProfileLock(previousLock, identity, { authorizedBy: SUITE_RESET_AUTHORIZED_BY }, options.now === undefined ? {} : { now: options.now });
+                lock = swap.lock;
+                previousGeneration = swap.previousGeneration;
+                replaced = true;
+            }
+        }
+        else {
+            lock = createProfileLock(identity, {
+                lockedBy: SUITE_RESET_AUTHORIZED_BY,
+                ...(options.now === undefined ? {} : { now: options.now }),
+            });
+            replaced = true;
+        }
+        // The workspace may never have been assembled (first assembly provisions
+        // it, loadSuiteWorkspace-style); create the directory so a reset of a
+        // never-assembled builtin does not fail with a bare ENOENT.
+        mkdirSync(suiteDir, { recursive: true });
+        writeFileSync(suiteJsonPath, factoryJson, "utf8");
+        // D-075 S4 第三批：reset 不再预种角色文件——种子由 subagent-delegate 插件
+        // 注册期的幂等补缺承担（见 entry.ts）；方案重置只重写方案自身内容。
+        if (replaced || previousLock === undefined) {
+            writeFileSync(lockPath, serializeSuiteProfileLockFile(lock), "utf8");
+        }
+        return {
+            suiteId: id,
+            wroteFactory: currentRaw !== factoryJson,
+            lock,
+            ...(previousGeneration === undefined ? {} : { previousGeneration }),
+        };
+    };
+    return {
+        suiteId: id,
+        factory,
+        suiteJsonPath,
+        lockPath,
+        diffText: generateDiffString(currentRaw, factoryJson).diff,
+        apply,
+    };
+}
+/**
+ * Clears the project/global settings `suite` keys when they point at `id`
+ * (设计 §9 删除连带). Keys pointing elsewhere are untouched.
+ */
+export function clearDanglingSuiteSettings(settingsManager, id) {
+    const clearedScopes = [];
+    if (settingsManager.getProjectSettings().suite === id) {
+        settingsManager.setProjectSuite(undefined);
+        clearedScopes.push("project");
+    }
+    if (settingsManager.getGlobalSettings().suite === id) {
+        settingsManager.setSuite(undefined);
+        clearedScopes.push("global");
+    }
+    return { clearedScopes: Object.freeze(clearedScopes) };
+}
+//# sourceMappingURL=suite-lifecycle.js.map

package/dist/profiles/suite-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suite-lifecycle.js","sourceRoot":"","sources":["../../src/profiles/suite-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACN,SAAS,EACT,MAAM,EACN,UAAU,EACV,SAAS,EACT,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,aAAa,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,EACN,0BAA0B,EAC1B,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EAEpB,kBAAkB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,yBAAyB,EACzB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,yBAAyB,EACzB,wBAAwB,EACxB,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,EAEpB,6BAA6B,EAC7B,mBAAmB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,CAAC,MAAM,oBAAoB,GAAG,QAAQ,CAAC;AAC7C,gEAAgE;AAChE,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AACxE;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,cAAc,CAAC;AACzD,gFAAgF;AAChF,MAAM,CAAC,MAAM,yBAAyB,GAAG,aAAa,CAAC;AAIvD,2EAA2E;AAC3E,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACpC,SAAS,CAA0B;IACnC,OAAO,CAAS;IAChB,OAAO,CAAoB;IAEpC,YAAY,SAAkC,EAAE,OAAe,EAAE,OAA0B,EAAE;QAC5F,KAAK,CAAC,SAAS,SAAS,gBAAgB,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3E,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAAA,CAC3C;CACD;AAwBD;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,OAA2B,EAAqB;IAC3E,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC;IACjC,MAAM,QAAQ,GAAG,oBAAoB,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACpD,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,EAAE,uBAAuB,CAAC,CAAC;IAE9D,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CACX,4GAA4G,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAChI,CAAC;IACH,CAAC;IACD,IAAI,gBAAgB,CAAC,EAAE,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,CACX,IAAI,EAAE,iGAAiG,CACvG,CAAC;IACH,CAAC;IACD,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,uBAAuB,QAAQ,iBAAiB,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,mBAAmB,CAAC,QAAQ,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAE7E,IAAI,UAA2B,CAAC;IAChC,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACrC,UAAU,GAAG;YACZ,aAAa,EAAE,oBAAoB;YACnC,EAAE;YACF,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;YACxB,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,mBAAmB;YAC1B,YAAY,EAAE,0BAA0B;YACxC,YAAY,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE;YACpF,qBAAqB,EAAE,KAAK;YAC5B,MAAM,EAAE,WAAW;YACnB,WAAW,EAAE,WAAW;YACxB,KAAK,EAAE,IAAI;YACX,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;YAChB,eAAe,EAAE,wBAAwB;SACzC,CAAC;QACF,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,aAAa,CAAC,aAAa,EAAE,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC;QACrE,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,wBAAwB,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;IACrE,CAAC;SAAM,CAAC;QACP,MAAM,MAAM,GAAG,4BAA4B,CAAC,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QACzE,UAAU,GAAG;YACZ,GAAG,MAAM,CAAC,KAAK;YACf,EAAE;YACF,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,QAAQ;YAClD,OAAO,EAAE,KAAK;YACd,UAAU,EAAE;gBACX,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE;gBACnB,MAAM,EAAE,mBAAmB,CAAC,MAAM,CAAC,KAAK,CAAC;gBACzC,EAAE,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE;aACjC;YACD,eAAe,EAAE,wBAAwB;SACzC,CAAC;QACF,mEAAmE;QACnE,mEAAmE;QACnE,YAAY;QACZ,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE;YACjC,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,mBAAmB;SACpE,CAAC,CAAC;QACH,aAAa,CAAC,aAAa,EAAE,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC;IACtE,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC;AAAA,CAC5D;AAED,SAAS,4BAA4B,CAAC,QAAgB,EAAE,SAAiB,EAAkB;IAC1F,IAAI,CAAC;QACJ,OAAO,kBAAkB,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAI,KAAK,YAAY,oBAAoB,EAAE,CAAC;YAC3C,MAAM,IAAI,mBAAmB,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC,iBAAiB,SAAS,kBAAkB,CAAC,CAAC,CAAC;QACpG,CAAC;QACD,MAAM,IAAI,mBAAmB,CAAC,QAAQ,EAAE,SAAS,EAAE;YAClD,iBAAiB,SAAS,kBAAkB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;SACpG,CAAC,CAAC;IACJ,CAAC;AAAA,CACD;AAcD,+EAA+E;AAC/E,MAAM,0BAA0B,GAAG,IAAI,GAAG,IAAI,CAAC;AAC/C,MAAM,0BAA0B,GAAG,EAAE,GAAG,IAAI,CAAC;AAQ7C;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB,EAAE,OAAe,EAAqB;IAC1F,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC/C,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,EAAE,CAAC;IACxC,MAAM,IAAI,GAAsB,EAAE,CAAC;IACnC,KAAK,MAAM,YAAY,IAAI,WAAW,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAC9E,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE;YAAE,SAAS;QAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;QACxD,IAAI,KAAe,CAAC;QACpB,IAAI,CAAC;YACJ,KAAK,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC3E,CAAC;QAAC,MAAM,CAAC;YACR,SAAS;QACV,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YACpC,IAAI,CAAC;gBACJ,MAAM,OAAO,GAAG,8BAA8B,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBAC9D,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;oBACtD,IAAI,CAAC,IAAI,CAAC;wBACT,IAAI;wBACJ,SAAS,EAAE,OAAO,CAAC,SAAS;wBAC5B,GAAG,EAAE,OAAO,CAAC,GAAG;wBAChB,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK;qBAC9B,CAAC,CAAC;gBACJ,CAAC;YACF,CAAC;YAAC,MAAM,CAAC;gBACR,+DAA+D;YAChE,CAAC;QACF,CAAC;IACF,CAAC;IACD,OAAO,IAAI,CAAC;AAAA,CACZ;AAED,SAAS,8BAA8B,CAAC,IAAY,EAAE,OAAe,EAAuB;IAC3F,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC;QACJ,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,0BAA0B,CAAC,CAAC;QAC9D,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,IAAI,SAA6B,CAAC;QAClC,IAAI,GAAuB,CAAC;QAC5B,IAAI,QAAQ,GAAG,EAAE,CAAC;QAClB,IAAI,KAAK,GAAG,KAAK,CAAC;QAClB,IAAI,cAAc,GAAG,KAAK,CAAC;QAE3B,OAAO,YAAY,GAAG,0BAA0B,IAAI,CAAC,cAAc,EAAE,CAAC;YACrE,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,0BAA0B,GAAG,YAAY,CAAC,CAAC;YACtF,MAAM,SAAS,GAAG,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;YAC5D,IAAI,SAAS,KAAK,CAAC;gBAAE,MAAM;YAC3B,YAAY,IAAI,SAAS,CAAC;YAC1B,MAAM,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;YACtE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAChC,QAAQ,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;YAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBAC1B,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;gBACtC,IAAI,KAAK,KAAK,SAAS;oBAAE,SAAS;gBAClC,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;oBAC3D,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC5B,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC;gBACxB,CAAC;gBACD,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;oBACtC,KAAK,GAAG,KAAK,CAAC,YAAY,KAAK,OAAO,CAAC;oBACvC,cAAc,GAAG,IAAI,CAAC;oBACtB,MAAM;gBACP,CAAC;YACF,CAAC;QACF,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;IAClC,CAAC;YAAS,CAAC;QACV,SAAS,CAAC,EAAE,CAAC,CAAC;IACf,CAAC;AAAA,CACD;AAQD,SAAS,iBAAiB,CAAC,IAAY,EAAuC;IAC7E,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3C,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACJ,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1F,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;QAChE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC;IACpG,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,UAAU,KAAK,wBAAwB,EAAE,CAAC;QAChF,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACzB,MAAM,OAAO,GACZ,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAQ,IAAgC,CAAC,OAAO,KAAK,QAAQ;YACzG,CAAC,CAAG,IAAgC,CAAC,OAAkB;YACvD,CAAC,CAAC,SAAS,CAAC;QACd,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;IAC/D,CAAC;IACD,OAAO,EAAE,CAAC;AAAA,CACV;AA0BD;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,OAA2B,EAAqB;IAC3E,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC;IACjC,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,IAAI,OAAO,CAAC,YAAY,KAAK,0BAA0B,EAAE,CAAC;QAC/F,MAAM,IAAI,mBAAmB,CAAC,QAAQ,EAAE,EAAE,EAAE;YAC3C,yBAAyB,0BAA0B,iBAAiB;SACpE,CAAC,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,gBAAgB,CAAC,EAAE,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,qBAAqB,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACpD,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,EAAE,uBAAuB,CAAC,CAAC;IAC9D,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,IAAI,CAAC,uBAAuB,QAAQ,iBAAiB,CAAC,CAAC;IAChE,CAAC;SAAM,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACvC,OAAO,CAAC,IAAI,CAAC,GAAG,aAAa,iBAAiB,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,mBAAmB,CAAC,QAAQ,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAE7E,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,mBAAmB,CAC5B,QAAQ,EACR,EAAE,EACF,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,GAAG,CAAC,SAAS,OAAO,GAAG,CAAC,IAAI,wBAAwB,CAAC,CAC1F,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAC,CAAC;IACzE,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,CACrB,SAAS,EACT,GAAG,EAAE,IAAI,oBAAoB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,UAAU,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAC9G,CAAC;IACF,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC;IAC5B,OAAO,EAAE,SAAS,EAAE,CAAC;AAAA,CACrB;AAED,SAAS,oBAAoB,CAAC,EAAU,EAAU;IACjD,gDAAgD;IAChD,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAAA,CACxE;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAiB,EAAQ;IAC5D,KAAK,EAAE,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAChG,iEAAiE;IADgC,CAEjG,CAAC,CAAC;AAAA,CACH;AAOD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACpC,QAAgB,EAChB,OAAO,GAAiD,EAAE,EACzB;IACjC,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAC,CAAC;IACzE,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,gCAAgC,CAAC;IAC5E,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,WAAW,CAAC;IAC/D,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,UAAoB,CAAC;IACzB,IAAI,CAAC;QACJ,UAAU,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;IACvE,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC;YACJ,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC;YACpC,IAAI,KAAK,CAAC,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBACtD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACP,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,CAAC;QACF,CAAC;QAAC,MAAM,CAAC;YACR,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;IACF,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;AAAA,CACtE;AAmCD;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,OAA6D,EAAkB;IACzG,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC;IACjC,MAAM,OAAO,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;IACpC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,mBAAmB,CAAC,OAAO,EAAE,EAAE,EAAE;YAC1C,gBAAgB,CAAC,EAAE,CAAC;gBACnB,CAAC,CAAC,kBAAkB,EAAE,8BAA8B;gBACpD,CAAC,CAAC,UAAU,EAAE,mFAAiF;SAChG,CAAC,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACpD,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,EAAE,uBAAuB,CAAC,CAAC;IAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAExF,MAAM,KAAK,GAAG,GAA0B,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;QACpD,yEAAyE;QACzE,2DAA2D;QAC3D,IAAI,YAAuC,CAAC;QAC5C,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACJ,YAAY,GAAG,yBAAyB,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;YAC1E,CAAC;YAAC,MAAM,CAAC;gBACR,YAAY,GAAG,SAAS,CAAC;YAC1B,CAAC;QACF,CAAC;QACD,IAAI,IAAmB,CAAC;QACxB,IAAI,kBAAsC,CAAC;QAC3C,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAChC,uEAAuE;YACvE,iEAAiE;YACjE,oEAAkE;YAClE,qDAAqD;YACrD,MAAM,MAAM,GAAG,4BAA4B,EAAE,CAAC;YAC9C,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC;gBACvC,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,QAAQ;gBACjB,YAAY,EAAE,yBAAyB;gBACvC,GAAG,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;aAC1D,CAAC,CAAC;YACH,IAAI,SAAS,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACnC,MAAM,IAAI,mBAAmB,CAAC,OAAO,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;YAChE,CAAC;YACD,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBACpC,IAAI,GAAG,YAAY,CAAC;YACrB,CAAC;iBAAM,CAAC;gBACP,MAAM,IAAI,GAAG,kBAAkB,CAC9B,YAAY,EACZ,QAAQ,EACR,EAAE,YAAY,EAAE,yBAAyB,EAAE,EAC3C,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CACrD,CAAC;gBACF,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;gBACjB,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,CAAC;gBAC7C,QAAQ,GAAG,IAAI,CAAC;YACjB,CAAC;QACF,CAAC;aAAM,CAAC;YACP,IAAI,GAAG,iBAAiB,CAAC,QAAQ,EAAE;gBAClC,QAAQ,EAAE,yBAAyB;gBACnC,GAAG,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;aAC1D,CAAC,CAAC;YACH,QAAQ,GAAG,IAAI,CAAC;QACjB,CAAC;QACD,yEAAyE;QACzE,sEAAsE;QACtE,4DAA4D;QAC5D,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,aAAa,CAAC,aAAa,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;QAClD,8FAAwD;QACxD,gGAAwC;QACxC,IAAI,QAAQ,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC5C,aAAa,CAAC,QAAQ,EAAE,6BAA6B,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QACtE,CAAC;QACD,OAAO;YACN,OAAO,EAAE,EAAE;YACX,YAAY,EAAE,UAAU,KAAK,WAAW;YACxC,IAAI;YACJ,GAAG,CAAC,kBAAkB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC;SACnE,CAAC;IAAA,CACF,CAAC;IAEF,OAAO;QACN,OAAO,EAAE,EAAE;QACX,OAAO;QACP,aAAa;QACb,QAAQ;QACR,QAAQ,EAAE,kBAAkB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,IAAI;QAC1D,KAAK;KACL,CAAC;AAAA,CACF;AAUD;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,eAAgC,EAAE,EAAU,EAAwB;IAC9G,MAAM,aAAa,GAA6B,EAAE,CAAC;IACnD,IAAI,eAAe,CAAC,kBAAkB,EAAE,CAAC,KAAK,KAAK,EAAE,EAAE,CAAC;QACvD,eAAe,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;QAC3C,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,eAAe,CAAC,iBAAiB,EAAE,CAAC,KAAK,KAAK,EAAE,EAAE,CAAC;QACtD,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACpC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;AAAA,CACvD","sourcesContent":["/**\n * Suite lifecycle operations (方案系统设计.md v2 §9, M4): create/clone,\n * delete (trash + release + sweep), reset, session reference scan, and\n * dangling settings cleanup.\n *\n * Every operation is deterministic given its inputs (`now` is injectable) and\n * reports refusal reasons as structured errors. Deletion only ever renames\n * the workspace into the trash directory — release and sweep are separate,\n * re-runnable steps — so recovery stays possible until the trash is released.\n * Memory purge is intentionally a hook: the Foundation purge gate lands with\n * M5; before that only suite assets are released.\n */\nimport { randomUUID } from \"node:crypto\";\nimport {\n\tcloseSync,\n\tcpSync,\n\texistsSync,\n\tmkdirSync,\n\topenSync,\n\treaddirSync,\n\treadFileSync,\n\treadSync,\n\trenameSync,\n\tstatSync,\n\twriteFileSync,\n} from \"node:fs\";\nimport { readdir, rm, stat } from \"node:fs/promises\";\nimport { basename, join } from \"node:path\";\nimport { StringDecoder } from \"node:string_decoder\";\nimport type { SettingsManager } from \"../core/settings-manager.ts\";\nimport { generateDiffString } from \"../core/tools/edit-diff.ts\";\nimport type { ProfileLockV1 } from \"../profile/lock.ts\";\nimport { createProfileLock, replaceProfileLock } from \"../profile/lock.ts\";\nimport { createProfileMigrationPolicy } from \"../profile/profile-migration.ts\";\nimport {\n\tBUILTIN_SUITE_CAPABILITIES,\n\tBUILTIN_SUITE_TOOLS,\n\tDEFAULT_ROLE_ASSOCIATIONS,\n\tFACTORY_CONTENTS_VERSION,\n\tgetBuiltinSuite,\n\tisBuiltinSuiteId,\n\tisValidSuiteId,\n\tSUITE_SCHEMA_VERSION,\n\ttype SuiteDefinition,\n\tserializeSuiteJson,\n} from \"./builtin-suites.ts\";\nimport {\n\tbuildSuiteProfileIdentity,\n\tgetSuitesRootDir,\n\tgetSuiteWorkspaceDir,\n\tloadSuiteWorkspace,\n\tparseSuiteProfileLockFile,\n\tSUITE_AGENTS_MD_FILENAME,\n\tSUITE_LOCK_FILENAME,\n\tSUITE_MANIFEST_FILENAME,\n\tSUITE_SESSION_ENTRY_TYPE,\n\tSuiteResolutionError,\n\ttype SuiteWorkspace,\n\tserializeSuiteProfileLockFile,\n\tsuiteManifestDigest,\n} from \"./suite-loader.ts\";\n\nexport const SUITE_TRASH_DIR_NAME = \".trash\";\n/** Trash retention for sweepSuiteTrash (M4 decision record). */\nexport const DEFAULT_SUITE_TRASH_RETENTION_MS = 7 * 24 * 60 * 60 * 1000;\n/**\n * Explicit programmatic authorization token for deleteSuite. The CLI confirms\n * interactively before calling; programmatic callers pass this token to prove\n * intent. Absent keeps the CLI-first flow working.\n */\nexport const SUITE_DELETE_CONFIRM_TOKEN = \"suite-delete\";\n/** lockedBy/authorizedBy stamped onto locks created by --suite-reset (2.7b). */\nexport const SUITE_RESET_AUTHORIZED_BY = \"suite-reset\";\n\nexport type SuiteLifecycleOperation = \"create\" | \"delete\" | \"reset\";\n\n/** Structured lifecycle refusal: operation, suite id, and every reason. */\nexport class SuiteLifecycleError extends Error {\n\treadonly operation: SuiteLifecycleOperation;\n\treadonly suiteId: string;\n\treadonly reasons: readonly string[];\n\n\tconstructor(operation: SuiteLifecycleOperation, suiteId: string, reasons: readonly string[]) {\n\t\tsuper(`Suite ${operation} failed for \"${suiteId}\": ${reasons.join(\"; \")}`);\n\t\tthis.name = \"SuiteLifecycleError\";\n\t\tthis.operation = operation;\n\t\tthis.suiteId = suiteId;\n\t\tthis.reasons = Object.freeze([...reasons]);\n\t}\n}\n\n// ---------------------------------------------------------------------------\n// Create / clone (设计 §9 创建)\n// ---------------------------------------------------------------------------\n\nexport interface SuiteCreateOptions {\n\treadonly agentDir: string;\n\treadonly id: string;\n\t/** Clone an existing suite workspace (builtin or user) instead of a fresh skeleton. */\n\treadonly cloneFrom?: string;\n\t/** Display name; defaults to the id (fresh) or \"<source name> clone\" (cloned). */\n\treadonly name?: string;\n\t/** Injectable clock for the clonedFrom timestamp. */\n\treadonly now?: () => number;\n}\n\nexport interface SuiteCreateResult {\n\treadonly suiteId: string;\n\treadonly suiteDir: string;\n\treadonly suiteJsonPath: string;\n\treadonly definition: SuiteDefinition;\n}\n\n/**\n * Creates a user suite workspace (设计 §9): `<agentDir>/suites/<id>/` with a\n * suite.json plus an empty agents.md skeleton, or — with `cloneFrom` — a copy\n * of the source workspace (effective definition, so a corrupted builtin\n * source clones its factory content) with the suite.json identity rewritten:\n * new id, `builtin: false`, and a `clonedFrom` record carrying the source id\n * and the digest of the source's effective suite.json value. The source's\n * `.profile-lock.json` is never copied: the clone is a new profile identity\n * whose lock is created on first assembly.\n */\nexport function createSuite(options: SuiteCreateOptions): SuiteCreateResult {\n\tconst { agentDir, id } = options;\n\tconst suiteDir = getSuiteWorkspaceDir(agentDir, id);\n\tconst suiteJsonPath = join(suiteDir, SUITE_MANIFEST_FILENAME);\n\n\tconst reasons: string[] = [];\n\tif (!isValidSuiteId(id)) {\n\t\treasons.push(\n\t\t\t`id must be a suite id (^[a-z0-9-]+$, no leading/trailing hyphen, Windows reserved names rejected), found ${JSON.stringify(id)}`,\n\t\t);\n\t}\n\tif (isBuiltinSuiteId(id)) {\n\t\treasons.push(\n\t\t\t`\"${id}\" is a builtin suite id; builtin workspaces are provisioned automatically and cannot be created`,\n\t\t);\n\t}\n\tif (existsSync(suiteDir)) {\n\t\treasons.push(`workspace directory ${suiteDir} already exists`);\n\t}\n\tif (reasons.length > 0) throw new SuiteLifecycleError(\"create\", id, reasons);\n\n\tlet definition: SuiteDefinition;\n\tif (options.cloneFrom === undefined) {\n\t\tdefinition = {\n\t\t\tschemaVersion: SUITE_SCHEMA_VERSION,\n\t\t\tid,\n\t\t\tname: options.name ?? id,\n\t\t\tbuiltin: false,\n\t\t\ttools: BUILTIN_SUITE_TOOLS,\n\t\t\tcapabilities: BUILTIN_SUITE_CAPABILITIES,\n\t\t\tassociations: { skills: [], mcp: [], plugins: [], roles: DEFAULT_ROLE_ASSOCIATIONS },\n\t\t\tinheritSystemAgentsMd: false,\n\t\t\tmemory: \"assistant\",\n\t\t\torientation: \"assistant\",\n\t\t\tmodel: null,\n\t\t\tthinking: null,\n\t\t\tclonedFrom: null,\n\t\t\tfactoryRevision: FACTORY_CONTENTS_VERSION,\n\t\t};\n\t\tmkdirSync(suiteDir, { recursive: true });\n\t\twriteFileSync(suiteJsonPath, serializeSuiteJson(definition), \"utf8\");\n\t\twriteFileSync(join(suiteDir, SUITE_AGENTS_MD_FILENAME), \"\", \"utf8\");\n\t} else {\n\t\tconst source = loadEffectiveSourceWorkspace(agentDir, options.cloneFrom);\n\t\tdefinition = {\n\t\t\t...source.suite,\n\t\t\tid,\n\t\t\tname: options.name ?? `${source.suite.name} clone`,\n\t\t\tbuiltin: false,\n\t\t\tclonedFrom: {\n\t\t\t\tid: source.suite.id,\n\t\t\t\tdigest: suiteManifestDigest(source.suite),\n\t\t\t\tat: options.now?.() ?? Date.now(),\n\t\t\t},\n\t\t\tfactoryRevision: FACTORY_CONTENTS_VERSION,\n\t\t};\n\t\t// Copy user assets (agents.md, skills, plugins, ...) but never the\n\t\t// source profile lock: the clone freezes its own identity on first\n\t\t// assembly.\n\t\tcpSync(source.suiteDir, suiteDir, {\n\t\t\trecursive: true,\n\t\t\tfilter: (sourcePath) => basename(sourcePath) !== SUITE_LOCK_FILENAME,\n\t\t});\n\t\twriteFileSync(suiteJsonPath, serializeSuiteJson(definition), \"utf8\");\n\t}\n\n\treturn { suiteId: id, suiteDir, suiteJsonPath, definition };\n}\n\nfunction loadEffectiveSourceWorkspace(agentDir: string, cloneFrom: string): SuiteWorkspace {\n\ttry {\n\t\treturn loadSuiteWorkspace({ agentDir, suiteId: cloneFrom });\n\t} catch (error) {\n\t\tif (error instanceof SuiteResolutionError) {\n\t\t\tthrow new SuiteLifecycleError(\"create\", cloneFrom, [`clone source \"${cloneFrom}\" does not exist`]);\n\t\t}\n\t\tthrow new SuiteLifecycleError(\"create\", cloneFrom, [\n\t\t\t`clone source \"${cloneFrom}\" is unusable: ${error instanceof Error ? error.message : String(error)}`,\n\t\t]);\n\t}\n}\n\n// ---------------------------------------------------------------------------\n// Session reference scan (设计 §9 删除前置检查)\n// ---------------------------------------------------------------------------\n\n/** One existing session bound to a suite via its creation-time custom entry. */\nexport interface SuiteSessionRef {\n\treadonly path: string;\n\treadonly sessionId: string;\n\treadonly cwd: string | undefined;\n\treadonly modified: Date;\n}\n\n/** Bounded head-scan window, aligned with the session header reader (1 MB). */\nconst SUITE_REF_SCAN_LIMIT_BYTES = 1024 * 1024;\nconst SUITE_REF_READ_BUFFER_SIZE = 64 * 1024;\n\ninterface SuiteRefScanOutcome {\n\treadonly sessionId: string | undefined;\n\treadonly cwd: string | undefined;\n\treadonly bound: boolean;\n}\n\n/**\n * Scans every session tree under `<agentDir>/sessions/<project>/*.jsonl` for\n * sessions whose creation-time custom entry (customType \"suite\") binds them\n * to `suiteId` (设计 §10.1). The suite entry sits in the first few lines of\n * the file, so a bounded head scan (1 MB, matching the session header reader)\n * is sufficient; a file whose binding line has been seen is decided — later\n * lines cannot change it. Unreadable, oversized, or malformed files are\n * skipped, never fatal. Custom session dirs (--session-dir) are out of scope.\n */\nexport function findSuiteSessionRefs(agentDir: string, suiteId: string): SuiteSessionRef[] {\n\tconst sessionsDir = join(agentDir, \"sessions\");\n\tif (!existsSync(sessionsDir)) return [];\n\tconst refs: SuiteSessionRef[] = [];\n\tfor (const projectEntry of readdirSync(sessionsDir, { withFileTypes: true })) {\n\t\tif (!projectEntry.isDirectory()) continue;\n\t\tconst projectDir = join(sessionsDir, projectEntry.name);\n\t\tlet files: string[];\n\t\ttry {\n\t\t\tfiles = readdirSync(projectDir).filter((file) => file.endsWith(\".jsonl\"));\n\t\t} catch {\n\t\t\tcontinue;\n\t\t}\n\t\tfor (const file of files) {\n\t\t\tconst path = join(projectDir, file);\n\t\t\ttry {\n\t\t\t\tconst outcome = scanSessionFileForSuiteBinding(path, suiteId);\n\t\t\t\tif (outcome.bound && outcome.sessionId !== undefined) {\n\t\t\t\t\trefs.push({\n\t\t\t\t\t\tpath,\n\t\t\t\t\t\tsessionId: outcome.sessionId,\n\t\t\t\t\t\tcwd: outcome.cwd,\n\t\t\t\t\t\tmodified: statSync(path).mtime,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t} catch {\n\t\t\t\t// Skip unreadable files; one bad file must not block deletion.\n\t\t\t}\n\t\t}\n\t}\n\treturn refs;\n}\n\nfunction scanSessionFileForSuiteBinding(path: string, suiteId: string): SuiteRefScanOutcome {\n\tconst fd = openSync(path, \"r\");\n\ttry {\n\t\tconst decoder = new StringDecoder(\"utf8\");\n\t\tconst buffer = Buffer.allocUnsafe(SUITE_REF_READ_BUFFER_SIZE);\n\t\tlet scannedBytes = 0;\n\t\tlet sessionId: string | undefined;\n\t\tlet cwd: string | undefined;\n\t\tlet leftover = \"\";\n\t\tlet bound = false;\n\t\tlet bindingDecided = false;\n\n\t\twhile (scannedBytes < SUITE_REF_SCAN_LIMIT_BYTES && !bindingDecided) {\n\t\t\tconst readLength = Math.min(buffer.length, SUITE_REF_SCAN_LIMIT_BYTES - scannedBytes);\n\t\t\tconst bytesRead = readSync(fd, buffer, 0, readLength, null);\n\t\t\tif (bytesRead === 0) break;\n\t\t\tscannedBytes += bytesRead;\n\t\t\tconst chunk = leftover + decoder.write(buffer.subarray(0, bytesRead));\n\t\t\tconst lines = chunk.split(\"\\n\");\n\t\t\tleftover = lines.pop() ?? \"\";\n\t\t\tfor (const line of lines) {\n\t\t\t\tconst entry = parseSuiteRefLine(line);\n\t\t\t\tif (entry === undefined) continue;\n\t\t\t\tif (entry.header !== undefined && sessionId === undefined) {\n\t\t\t\t\tsessionId = entry.header.id;\n\t\t\t\t\tcwd = entry.header.cwd;\n\t\t\t\t}\n\t\t\t\tif (entry.boundToSuite !== undefined) {\n\t\t\t\t\tbound = entry.boundToSuite === suiteId;\n\t\t\t\t\tbindingDecided = true;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\treturn { sessionId, cwd, bound };\n\t} finally {\n\t\tcloseSync(fd);\n\t}\n}\n\ninterface SuiteRefLineParseResult {\n\treadonly header?: { readonly id: string; readonly cwd: string | undefined };\n\t/** The suite id this session is bound to, when the line is the suite binding entry. */\n\treadonly boundToSuite?: string;\n}\n\nfunction parseSuiteRefLine(line: string): SuiteRefLineParseResult | undefined {\n\tconst trimmed = line.trim();\n\tif (trimmed.length === 0) return undefined;\n\tlet value: unknown;\n\ttry {\n\t\tvalue = JSON.parse(trimmed);\n\t} catch {\n\t\treturn undefined;\n\t}\n\tif (value === null || typeof value !== \"object\" || Array.isArray(value)) return undefined;\n\tconst record = value as Record<string, unknown>;\n\tif (record.type === \"session\" && typeof record.id === \"string\") {\n\t\treturn { header: { id: record.id, cwd: typeof record.cwd === \"string\" ? record.cwd : undefined } };\n\t}\n\tif (record.type === \"custom\" && record.customType === SUITE_SESSION_ENTRY_TYPE) {\n\t\tconst data = record.data;\n\t\tconst suiteId =\n\t\t\tdata !== null && typeof data === \"object\" && typeof (data as Record<string, unknown>).suiteId === \"string\"\n\t\t\t\t? ((data as Record<string, unknown>).suiteId as string)\n\t\t\t\t: undefined;\n\t\treturn suiteId === undefined ? {} : { boundToSuite: suiteId };\n\t}\n\treturn {};\n}\n\n// ---------------------------------------------------------------------------\n// Delete: trash rename, release, sweep (设计 §9 删除)\n// ---------------------------------------------------------------------------\n\nexport interface SuiteDeleteOptions {\n\treadonly agentDir: string;\n\treadonly id: string;\n\t/** Session references from findSuiteSessionRefs; a non-empty list refuses the delete. */\n\treadonly refs: readonly SuiteSessionRef[];\n\treadonly now?: () => number;\n\t/** Programmatic authorization; must equal SUITE_DELETE_CONFIRM_TOKEN when provided. */\n\treadonly confirmToken?: string;\n\t/**\n\t * Memory purge hook (M5 wiring point): invoked after the workspace is\n\t * isolated in the trash. M4 releases assets only; memory clearing goes\n\t * through the Foundation purge gate once M5 lands.\n\t */\n\treadonly purgeMemories?: (suiteId: string) => void;\n}\n\nexport interface SuiteDeleteResult {\n\treadonly trashPath: string;\n}\n\n/**\n * Moves a user suite workspace into `<agentDir>/suites/.trash/<id>-<UTC\n * compact timestamp>-<random>/`. Builtin suites are refused; the workspace\n * (directory + suite.json) must exist but does not need to parse; any\n * session reference refuses the delete with the full list. The rename keeps\n * the workspace recoverable; releaseTrashedSuite/sweepSuiteTrash do the\n * actual removal.\n */\nexport function deleteSuite(options: SuiteDeleteOptions): SuiteDeleteResult {\n\tconst { agentDir, id } = options;\n\tif (options.confirmToken !== undefined && options.confirmToken !== SUITE_DELETE_CONFIRM_TOKEN) {\n\t\tthrow new SuiteLifecycleError(\"delete\", id, [\n\t\t\t`confirmToken must be \"${SUITE_DELETE_CONFIRM_TOKEN}\" when provided`,\n\t\t]);\n\t}\n\tconst reasons: string[] = [];\n\tif (isBuiltinSuiteId(id)) {\n\t\treasons.push(`builtin suite \"${id}\" cannot be deleted`);\n\t}\n\tconst suiteDir = getSuiteWorkspaceDir(agentDir, id);\n\tconst suiteJsonPath = join(suiteDir, SUITE_MANIFEST_FILENAME);\n\tif (!existsSync(suiteDir)) {\n\t\treasons.push(`workspace directory ${suiteDir} does not exist`);\n\t} else if (!existsSync(suiteJsonPath)) {\n\t\treasons.push(`${suiteJsonPath} does not exist`);\n\t}\n\tif (reasons.length > 0) throw new SuiteLifecycleError(\"delete\", id, reasons);\n\n\tif (options.refs.length > 0) {\n\t\tthrow new SuiteLifecycleError(\n\t\t\t\"delete\",\n\t\t\tid,\n\t\t\toptions.refs.map((ref) => `session ${ref.sessionId} at ${ref.path} references this suite`),\n\t\t);\n\t}\n\n\tconst trashRoot = join(getSuitesRootDir(agentDir), SUITE_TRASH_DIR_NAME);\n\tmkdirSync(trashRoot, { recursive: true });\n\tconst trashPath = join(\n\t\ttrashRoot,\n\t\t`${id}-${formatTrashTimestamp(options.now?.() ?? Date.now())}-${randomUUID().replaceAll(\"-\", \"\").slice(0, 6)}`,\n\t);\n\trenameSync(suiteDir, trashPath);\n\toptions.purgeMemories?.(id);\n\treturn { trashPath };\n}\n\nfunction formatTrashTimestamp(ms: number): string {\n\t// UTC compact, sortable: \"20260907T123456789Z\".\n\treturn new Date(ms).toISOString().replace(/[-:]/g, \"\").replace(\".\", \"\");\n}\n\n/**\n * Fire-and-forget removal of one trash entry (Node's built-in Windows retry\n * semantics). Failures never throw: the entry simply remains for the next\n * sweepSuiteTrash run.\n */\nexport function releaseTrashedSuite(trashPath: string): void {\n\tvoid rm(trashPath, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 }).catch(() => {\n\t\t// Left for sweepSuiteTrash; release is re-runnable by structure.\n\t});\n}\n\nexport interface SuiteTrashSweepResult {\n\treadonly removed: readonly string[];\n\treadonly kept: readonly string[];\n}\n\n/**\n * Removes trash entries older than `retentionMs` (default 7 days, per the M4\n * decision record). Entries are aged by their mtime; unreadable entries are\n * kept. Deterministic given the injectable clock.\n */\nexport async function sweepSuiteTrash(\n\tagentDir: string,\n\toptions: { retentionMs?: number; now?: () => number } = {},\n): Promise<SuiteTrashSweepResult> {\n\tconst trashRoot = join(getSuitesRootDir(agentDir), SUITE_TRASH_DIR_NAME);\n\tconst retentionMs = options.retentionMs ?? DEFAULT_SUITE_TRASH_RETENTION_MS;\n\tconst cutoffMs = (options.now?.() ?? Date.now()) - retentionMs;\n\tconst removed: string[] = [];\n\tconst kept: string[] = [];\n\tlet entryNames: string[];\n\ttry {\n\t\tentryNames = await readdir(trashRoot);\n\t} catch {\n\t\treturn { removed: Object.freeze(removed), kept: Object.freeze(kept) };\n\t}\n\tfor (const name of entryNames) {\n\t\tconst entryPath = join(trashRoot, name);\n\t\ttry {\n\t\t\tconst stats = await stat(entryPath);\n\t\t\tif (stats.mtimeMs <= cutoffMs) {\n\t\t\t\tawait rm(entryPath, { recursive: true, force: true });\n\t\t\t\tremoved.push(name);\n\t\t\t} else {\n\t\t\t\tkept.push(name);\n\t\t\t}\n\t\t} catch {\n\t\t\tkept.push(name);\n\t\t}\n\t}\n\treturn { removed: Object.freeze(removed), kept: Object.freeze(kept) };\n}\n\n// ---------------------------------------------------------------------------\n// Reset (设计 §9 重置): factory contents + authorized lock migration (2.7b)\n// ---------------------------------------------------------------------------\n\nexport interface SuiteResetApplyResult {\n\treadonly suiteId: string;\n\t/** Whether the on-disk suite.json differed from the factory contents. */\n\treadonly wroteFactory: boolean;\n\t/** The lock now persisted in the workspace. */\n\treadonly lock: ProfileLockV1;\n\t/** Defined when an existing lock was replaced via 2.7b applyMigration. */\n\treadonly previousGeneration?: number;\n}\n\nexport interface SuiteResetPlan {\n\treadonly suiteId: string;\n\treadonly factory: SuiteDefinition;\n\treadonly suiteJsonPath: string;\n\treadonly lockPath: string;\n\t/** Display diff (edit-diff format) of the on-disk file vs the factory contents. */\n\treadonly diffText: string;\n\t/**\n\t * Applies the reset: writes the factory suite.json, then persists the\n\t * factory identity's lock. An existing lock goes through the 2.7b policy:\n\t * `applyMigration` (authorizedBy \"suite-reset\") decides current vs\n\t * non-current; a non-current lock is replaced via `replaceProfileLock`\n\t * (generation increments, `previousGeneration` reports the swap). A missing\n\t * or unreadable lock gets a fresh one. The replacement lock is evaluated\n\t * before any write, so a failure leaves the previous files untouched.\n\t */\n\tapply(): SuiteResetApplyResult;\n}\n\n/**\n * Plans a builtin suite reset (设计 §9 重置): diff the on-disk suite.json\n * against the factory declaration without touching anything. User suites are\n * refused — they have no factory contents to restore; remove them instead.\n */\nexport function resetSuite(options: { agentDir: string; id: string; now?: () => number }): SuiteResetPlan {\n\tconst { agentDir, id } = options;\n\tconst factory = getBuiltinSuite(id);\n\tif (factory === undefined) {\n\t\tthrow new SuiteLifecycleError(\"reset\", id, [\n\t\t\tisBuiltinSuiteId(id)\n\t\t\t\t? `builtin suite \"${id}\" has no factory declaration`\n\t\t\t\t: `suite \"${id}\" is not builtin; only builtin suites can be reset — delete user suites instead`,\n\t\t]);\n\t}\n\tconst suiteDir = getSuiteWorkspaceDir(agentDir, id);\n\tconst suiteJsonPath = join(suiteDir, SUITE_MANIFEST_FILENAME);\n\tconst lockPath = join(suiteDir, SUITE_LOCK_FILENAME);\n\tconst factoryJson = serializeSuiteJson(factory);\n\tconst currentRaw = existsSync(suiteJsonPath) ? readFileSync(suiteJsonPath, \"utf8\") : \"\";\n\n\tconst apply = (): SuiteResetApplyResult => {\n\t\tconst identity = buildSuiteProfileIdentity(factory);\n\t\t// Evaluate the replacement before any write (2.7b): a failure above this\n\t\t// point leaves the previous suite.json and lock untouched.\n\t\tlet previousLock: ProfileLockV1 | undefined;\n\t\tif (existsSync(lockPath)) {\n\t\t\ttry {\n\t\t\t\tpreviousLock = parseSuiteProfileLockFile(readFileSync(lockPath, \"utf8\"));\n\t\t\t} catch {\n\t\t\t\tpreviousLock = undefined;\n\t\t\t}\n\t\t}\n\t\tlet lock: ProfileLockV1;\n\t\tlet previousGeneration: number | undefined;\n\t\tlet replaced = false;\n\t\tif (previousLock !== undefined) {\n\t\t\t// Explicit authorized migration (2.7b): applyMigration decides whether\n\t\t\t// the stored lock is already current; only a non-current outcome\n\t\t\t// replaces the lock, through replaceProfileLock — the lock's only\n\t\t\t// authorized swap primitive (generation increments).\n\t\t\tconst policy = createProfileMigrationPolicy();\n\t\t\tconst migration = policy.applyMigration({\n\t\t\t\tlock: previousLock,\n\t\t\t\tcurrent: identity,\n\t\t\t\tauthorizedBy: SUITE_RESET_AUTHORIZED_BY,\n\t\t\t\t...(options.now === undefined ? {} : { now: options.now }),\n\t\t\t});\n\t\t\tif (migration.status === \"failed\") {\n\t\t\t\tthrow new SuiteLifecycleError(\"reset\", id, [migration.reason]);\n\t\t\t}\n\t\t\tif (migration.status === \"current\") {\n\t\t\t\tlock = previousLock;\n\t\t\t} else {\n\t\t\t\tconst swap = replaceProfileLock(\n\t\t\t\t\tpreviousLock,\n\t\t\t\t\tidentity,\n\t\t\t\t\t{ authorizedBy: SUITE_RESET_AUTHORIZED_BY },\n\t\t\t\t\toptions.now === undefined ? {} : { now: options.now },\n\t\t\t\t);\n\t\t\t\tlock = swap.lock;\n\t\t\t\tpreviousGeneration = swap.previousGeneration;\n\t\t\t\treplaced = true;\n\t\t\t}\n\t\t} else {\n\t\t\tlock = createProfileLock(identity, {\n\t\t\t\tlockedBy: SUITE_RESET_AUTHORIZED_BY,\n\t\t\t\t...(options.now === undefined ? {} : { now: options.now }),\n\t\t\t});\n\t\t\treplaced = true;\n\t\t}\n\t\t// The workspace may never have been assembled (first assembly provisions\n\t\t// it, loadSuiteWorkspace-style); create the directory so a reset of a\n\t\t// never-assembled builtin does not fail with a bare ENOENT.\n\t\tmkdirSync(suiteDir, { recursive: true });\n\t\twriteFileSync(suiteJsonPath, factoryJson, \"utf8\");\n\t\t// D-075 S4 第三批：reset 不再预种角色文件——种子由 subagent-delegate 插件\n\t\t// 注册期的幂等补缺承担（见 entry.ts）；方案重置只重写方案自身内容。\n\t\tif (replaced || previousLock === undefined) {\n\t\t\twriteFileSync(lockPath, serializeSuiteProfileLockFile(lock), \"utf8\");\n\t\t}\n\t\treturn {\n\t\t\tsuiteId: id,\n\t\t\twroteFactory: currentRaw !== factoryJson,\n\t\t\tlock,\n\t\t\t...(previousGeneration === undefined ? {} : { previousGeneration }),\n\t\t};\n\t};\n\n\treturn {\n\t\tsuiteId: id,\n\t\tfactory,\n\t\tsuiteJsonPath,\n\t\tlockPath,\n\t\tdiffText: generateDiffString(currentRaw, factoryJson).diff,\n\t\tapply,\n\t};\n}\n\n// ---------------------------------------------------------------------------\n// Dangling settings cleanup (设计 §9 删除连带)\n// ---------------------------------------------------------------------------\n\nexport interface SuiteSettingsCleanup {\n\treadonly clearedScopes: readonly (\"project\" | \"global\")[];\n}\n\n/**\n * Clears the project/global settings `suite` keys when they point at `id`\n * (设计 §9 删除连带). Keys pointing elsewhere are untouched.\n */\nexport function clearDanglingSuiteSettings(settingsManager: SettingsManager, id: string): SuiteSettingsCleanup {\n\tconst clearedScopes: (\"project\" | \"global\")[] = [];\n\tif (settingsManager.getProjectSettings().suite === id) {\n\t\tsettingsManager.setProjectSuite(undefined);\n\t\tclearedScopes.push(\"project\");\n\t}\n\tif (settingsManager.getGlobalSettings().suite === id) {\n\t\tsettingsManager.setSuite(undefined);\n\t\tclearedScopes.push(\"global\");\n\t}\n\treturn { clearedScopes: Object.freeze(clearedScopes) };\n}\n"]}