@kaitranntt/ccs 8.10.0-dev.17 → 8.10.0-dev.19

package/dist/cliproxy/accounts/claude-pool-policy-state.js

@@ -0,0 +1,205 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildClaudePoolPolicyStatus = exports.confirmClaudePoolClass = exports.effectiveClaudePoolClass = exports.claudePoolClassPriority = exports.writeClaudePoolPolicyState = exports.readClaudePoolPolicyState = exports.createClaudePoolPolicyState = exports.getClaudePoolPolicyStatePath = exports.CLAUDE_POOL_RECONCILE_MS = exports.CLAUDE_POOL_CLASS_MAX_AGE_MS = void 0;
+const error_types_1 = require("../../errors/error-types");
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const config_manager_1 = require("../../utils/config-manager");
+exports.CLAUDE_POOL_CLASS_MAX_AGE_MS = 6 * 60 * 60000;
+exports.CLAUDE_POOL_RECONCILE_MS = 60000;
+function getClaudePoolPolicyStatePath() {
+    return path.join((0, config_manager_1.getCcsDir)(), 'cache', 'claude-pool-order.json');
+}
+exports.getClaudePoolPolicyStatePath = getClaudePoolPolicyStatePath;
+function createClaudePoolPolicyState(target) {
+    return {
+        version: 1,
+        target,
+        previousDrainOrder: null,
+        entries: {},
+        lastReconciledAt: null,
+        status: 'inactive',
+    };
+}
+exports.createClaudePoolPolicyState = createClaudePoolPolicyState;
+/** Corrupt ownership records must never be silently replaced before mutation. */
+function readClaudePoolPolicyState(file = getClaudePoolPolicyStatePath()) {
+    let raw;
+    try {
+        raw = fs.readFileSync(file, 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return null;
+        throw new error_types_1.ConfigError('Cannot read Claude pool ownership state. Check its file permissions.');
+    }
+    try {
+        const state = JSON.parse(raw);
+        if (state.version !== 1 ||
+            typeof state.target !== 'string' ||
+            !['inactive', 'pending', 'active', 'degraded'].includes(state.status) ||
+            (state.lastReconciledAt !== null && !Number.isFinite(state.lastReconciledAt)) ||
+            (state.restoring !== undefined && typeof state.restoring !== 'boolean') ||
+            !state.entries ||
+            typeof state.entries !== 'object' ||
+            Array.isArray(state.entries)) {
+            throw new error_types_1.ConfigError('invalid state');
+        }
+        for (const entry of Object.values(state.entries)) {
+            if (!entry ||
+                typeof entry.tokenFile !== 'string' ||
+                !['five-hour-only', 'five-hour-weekly', 'weekly-only', 'unknown'].includes(entry.class) ||
+                typeof entry.ownsPriority !== 'boolean' ||
+                !isPriority(entry.originalPriority) ||
+                !isPriority(entry.lastAppliedPriority) ||
+                (entry.pendingPriority !== undefined && !isPriority(entry.pendingPriority)) ||
+                (entry.confirmedAt !== null && !Number.isFinite(entry.confirmedAt))) {
+                throw new error_types_1.ConfigError('invalid entry');
+            }
+        }
+        return state;
+    }
+    catch {
+        throw new error_types_1.ConfigError('Claude pool ownership state is invalid. Preserve it and repair it before changing priorities.');
+    }
+}
+exports.readClaudePoolPolicyState = readClaudePoolPolicyState;
+function isPriority(value) {
+    return value === null || (typeof value === 'number' && Number.isSafeInteger(value));
+}
+function writeClaudePoolPolicyState(state, file = getClaudePoolPolicyStatePath()) {
+    fs.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });
+    const temporary = `${file}.${process.pid}.tmp`;
+    try {
+        fs.writeFileSync(temporary, JSON.stringify(state), { mode: 0o600 });
+        fs.renameSync(temporary, file);
+    }
+    finally {
+        try {
+            fs.unlinkSync(temporary);
+        }
+        catch {
+            // A successful rename has already removed the temporary file.
+        }
+    }
+}
+exports.writeClaudePoolPolicyState = writeClaudePoolPolicyState;
+function claudePoolClassPriority(value) {
+    switch (value) {
+        case 'five-hour-only':
+            return 4;
+        case 'five-hour-weekly':
+            return 3;
+        case 'weekly-only':
+            return 2;
+        default:
+            return 1;
+    }
+}
+exports.claudePoolClassPriority = claudePoolClassPriority;
+function effectiveClaudePoolClass(entry, now) {
+    return entry.confirmedAt !== null &&
+        entry.confirmedAt <= now &&
+        now - entry.confirmedAt < exports.CLAUDE_POOL_CLASS_MAX_AGE_MS
+        ? entry.class
+        : 'unknown';
+}
+exports.effectiveClaudePoolClass = effectiveClaudePoolClass;
+/** Only fresh, complete provider observations confirm shape, never filtered stale windows. */
+function confirmClaudePoolClass(previous, quota, now) {
+    const presence = quota.generalWindowPresence;
+    if (!quota.success ||
+        quota.stale ||
+        !presence ||
+        !['present', 'absent', 'unknown'].includes(presence.fiveHour) ||
+        !['present', 'absent', 'unknown'].includes(presence.weekly) ||
+        presence.fiveHour === 'unknown' ||
+        presence.weekly === 'unknown' ||
+        !Number.isFinite(quota.lastUpdated) ||
+        quota.lastUpdated > now ||
+        now - quota.lastUpdated >= exports.CLAUDE_POOL_CLASS_MAX_AGE_MS ||
+        (previous.confirmedAt !== null && quota.lastUpdated < previous.confirmedAt))
+        return previous;
+    const hasFiveHour = presence.fiveHour === 'present';
+    const hasWeekly = presence.weekly === 'present';
+    const quotaClass = hasFiveHour
+        ? hasWeekly
+            ? 'five-hour-weekly'
+            : 'five-hour-only'
+        : hasWeekly
+            ? 'weekly-only'
+            : 'unknown';
+    return { class: quotaClass, confirmedAt: quota.lastUpdated };
+}
+exports.confirmClaudePoolClass = confirmClaudePoolClass;
+function buildClaudePoolPolicyStatus(enabled, controllerActive, state, inputAccounts, now, startedAt) {
+    const accounts = inputAccounts.map((account) => {
+        const entry = state && Object.prototype.hasOwnProperty.call(state.entries, account.id)
+            ? state.entries[account.id]
+            : undefined;
+        const quotaClass = entry ? effectiveClaudePoolClass(entry, now) : 'unknown';
+        return {
+            accountId: account.id,
+            class: quotaClass,
+            confirmedAt: entry?.confirmedAt ?? null,
+            desiredPriority: claudePoolClassPriority(quotaClass),
+            effectivePriority: entry?.effectivePriority !== undefined
+                ? entry.effectivePriority
+                : (entry?.lastAppliedPriority ?? null),
+            state: account.paused
+                ? 'paused'
+                : (entry?.state ?? (entry?.ownsPriority ? 'applied' : 'pending')),
+        };
+    });
+    let status = enabled
+        ? !controllerActive
+            ? 'pending'
+            : (state?.status ?? 'pending')
+        : state?.restoring || state?.status === 'degraded'
+            ? 'degraded'
+            : 'inactive';
+    if (enabled && status === 'active') {
+        if (state?.lastReconciledAt === null ||
+            (startedAt !== undefined && (state?.lastReconciledAt ?? 0) < startedAt) ||
+            accounts.some((account) => account.state !== 'paused' && account.effectivePriority !== account.desiredPriority))
+            status = 'pending';
+    }
+    return {
+        enabled,
+        status,
+        controllerActive,
+        lastReconciledAt: state?.lastReconciledAt ?? null,
+        ...(state?.error ? { error: state.error } : {}),
+        ...(!controllerActive && enabled
+            ? {
+                error: 'No persistent CCS controller is available. Run the dashboard or integrated Docker service.',
+            }
+            : {}),
+        accounts,
+    };
+}
+exports.buildClaudePoolPolicyStatus = buildClaudePoolPolicyStatus;
+//# sourceMappingURL=claude-pool-policy-state.js.map

package/dist/cliproxy/accounts/claude-pool-policy-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-pool-policy-state.js","sourceRoot":"","sources":["../../../src/cliproxy/accounts/claude-pool-policy-state.ts"],"names":[],"mappings":"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"}

package/dist/cliproxy/accounts/claude-pool-policy.d.ts

@@ -0,0 +1,48 @@
+import type { ClaudePoolPolicyStatus } from '../../shared/claude-pool-policy';
+import { type ClaudePoolPolicyDependencies } from './claude-pool-policy-runtime';
+export type { ClaudePoolPolicyDependencies } from './claude-pool-policy-runtime';
+/** A controller lease and a separate mutation mutex coordinate different CCS processes. */
+export declare class ClaudePoolPolicyController {
+    private readonly deps;
+    private readonly owner;
+    private releaseLeadership;
+    private heartbeat;
+    private interval;
+    private stopped;
+    private compromised;
+    private busy;
+    private activeCycle;
+    private readonly activeMutations;
+    private startedAt;
+    private lifecycleAbort;
+    private readonly manualMutation;
+    constructor(overrides?: Partial<ClaudePoolPolicyDependencies>);
+    private get leaseFile();
+    private get ownerFile();
+    private get mutationFile();
+    private readState;
+    private writeState;
+    private reconciliationContext;
+    private controllerActive;
+    private renewLease;
+    private withMutation;
+    private verifiedApi;
+    getStatus(): ClaudePoolPolicyStatus;
+    setEnabled(enabled: boolean): Promise<ClaudePoolPolicyStatus>;
+    /** Explicit manual changes supersede this policy without restoring over the chosen order. */
+    relinquishForManualOrder(): Promise<void>;
+    /** Keep the mutex through validation, priority application and manual-config commit. */
+    withManualOrder<T>(operation: () => Promise<T>): Promise<T>;
+    /** Public deterministic cycle used by lifecycle hooks and synthetic tests. */
+    reconcile(valid?: () => boolean): Promise<void>;
+    private release;
+    private tick;
+    private launchTick;
+    /** Wake a running controller without overlapping its current cycle. */
+    wake(): Promise<void>;
+    start(): () => Promise<void>;
+    stop(): Promise<void>;
+}
+export declare function getClaudePoolPolicyController(): ClaudePoolPolicyController;
+export declare function startClaudePoolPolicyController(): () => Promise<void>;
+//# sourceMappingURL=claude-pool-policy.d.ts.map

package/dist/cliproxy/accounts/claude-pool-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-pool-policy.d.ts","sourceRoot":"","sources":["../../../src/cliproxy/accounts/claude-pool-policy.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAa9E,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,8BAA8B,CAAC;AAMtC,YAAY,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAwBjF,2FAA2F;AAC3F,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA+B;IACpD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,iBAAiB,CAAsC;IAC/D,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,QAAQ,CAA+C;IAC/D,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA4B;IAC5D,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoC;gBAEvD,SAAS,GAAE,OAAO,CAAC,4BAA4B,CAAM;IAIjE,OAAO,KAAK,SAAS,GAEpB;IACD,OAAO,KAAK,SAAS,GAEpB;IACD,OAAO,KAAK,YAAY,GAEvB;IAED,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,qBAAqB;IAS7B,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,UAAU;YAaJ,YAAY;YAqCZ,WAAW;IAiBzB,SAAS,IAAI,sBAAsB;IA8B7B,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,sBAAsB,CAAC;IA0DnE,6FAA6F;IACvF,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB/C,wFAAwF;IAClF,eAAe,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIjE,8EAA8E;IACxE,SAAS,CAAC,KAAK,GAAE,MAAM,OAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;YAuBnD,OAAO;YAgBP,IAAI;IA4ClB,OAAO,CAAC,UAAU;IAOlB,uEAAuE;IACjE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,KAAK,IAAI,MAAM,OAAO,CAAC,IAAI,CAAC;IAatB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAS5B;AAID,wBAAgB,6BAA6B,IAAI,0BAA0B,CAQ1E;AAED,wBAAgB,+BAA+B,IAAI,MAAM,OAAO,CAAC,IAAI,CAAC,CAErE"}

package/dist/cliproxy/accounts/claude-pool-policy.js

@@ -0,0 +1,401 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startClaudePoolPolicyController = exports.getClaudePoolPolicyController = exports.ClaudePoolPolicyController = void 0;
+const error_types_1 = require("../../errors/error-types");
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const os = __importStar(require("node:os"));
+const node_crypto_1 = require("node:crypto");
+const node_async_hooks_1 = require("node:async_hooks");
+const lockfile = __importStar(require("proper-lockfile"));
+const claude_pool_policy_state_1 = require("./claude-pool-policy-state");
+const claude_pool_policy_runtime_1 = require("./claude-pool-policy-runtime");
+const claude_pool_policy_reconciliation_1 = require("./claude-pool-policy-reconciliation");
+const claude_pool_policy_lease_1 = require("./claude-pool-policy-lease");
+const LEASE_STALE_MS = 30000;
+const HEARTBEAT_MS = 5000;
+function targetKey(target) {
+    return `${target.protocol}://${target.host}:${target.port}`;
+}
+function ensureLockTarget(file) {
+    fs.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });
+    try {
+        fs.writeFileSync(file, '', { flag: 'wx', mode: 0o600 });
+    }
+    catch (error) {
+        if (error.code !== 'EEXIST')
+            throw error;
+    }
+}
+/** A controller lease and a separate mutation mutex coordinate different CCS processes. */
+class ClaudePoolPolicyController {
+    constructor(overrides = {}) {
+        this.owner = (0, node_crypto_1.randomUUID)();
+        this.releaseLeadership = null;
+        this.heartbeat = null;
+        this.interval = null;
+        this.stopped = true;
+        this.compromised = false;
+        this.busy = false;
+        this.activeCycle = null;
+        this.activeMutations = new Set();
+        this.startedAt = 0;
+        this.lifecycleAbort = new AbortController();
+        this.manualMutation = new node_async_hooks_1.AsyncLocalStorage();
+        this.deps = (0, claude_pool_policy_runtime_1.createClaudePoolPolicyDependencies)(overrides);
+    }
+    get leaseFile() {
+        return `${this.deps.file}.controller`;
+    }
+    get ownerFile() {
+        return `${this.leaseFile}.owner`;
+    }
+    get mutationFile() {
+        return `${this.deps.file}.mutation`;
+    }
+    readState() {
+        return (0, claude_pool_policy_state_1.readClaudePoolPolicyState)(this.deps.file);
+    }
+    writeState(state) {
+        (0, claude_pool_policy_state_1.writeClaudePoolPolicyState)(state, this.deps.file);
+    }
+    reconciliationContext() {
+        return {
+            deps: this.deps,
+            readState: () => this.readState(),
+            writeState: (state) => this.writeState(state),
+            signal: this.lifecycleAbort.signal,
+        };
+    }
+    controllerActive() {
+        return ((0, claude_pool_policy_lease_1.readActiveClaudePoolControllerLease)(this.ownerFile, targetKey(this.deps.target()), this.deps.now(), LEASE_STALE_MS) !== null);
+    }
+    renewLease() {
+        if (!this.releaseLeadership || this.compromised)
+            return;
+        const lease = {
+            owner: this.owner,
+            pid: process.pid,
+            hostname: os.hostname(),
+            target: targetKey(this.deps.target()),
+            updatedAt: this.deps.now(),
+            startedAt: this.startedAt,
+        };
+        (0, claude_pool_policy_lease_1.writeClaudePoolControllerLease)(this.ownerFile, lease);
+    }
+    async withMutation(operation) {
+        let complete = () => { };
+        const completion = new Promise((resolve) => {
+            complete = resolve;
+        });
+        this.activeMutations.add(completion);
+        try {
+            ensureLockTarget(this.mutationFile);
+            let compromised = false;
+            const release = await lockfile
+                .lock(this.mutationFile, {
+                realpath: false,
+                stale: LEASE_STALE_MS,
+                update: HEARTBEAT_MS,
+                retries: { retries: 50, minTimeout: 100, maxTimeout: 100 },
+                onCompromised: () => {
+                    compromised = true;
+                },
+            })
+                .catch(() => {
+                throw new error_types_1.ConfigError('Another CCS process is updating Claude pool order. Retry after the current operation finishes.');
+            });
+            try {
+                if (compromised)
+                    throw new error_types_1.ConfigError('Claude pool mutation ownership was lost. Retry the operation.');
+                return await operation(() => !compromised);
+            }
+            finally {
+                await release().catch(() => { });
+            }
+        }
+        finally {
+            complete();
+            this.activeMutations.delete(completion);
+        }
+    }
+    async verifiedApi() {
+        const target = this.deps.target();
+        if (target.isRemote || !['127.0.0.1', 'localhost', '::1'].includes(target.host)) {
+            throw new error_types_1.ConfigError('Claude quota ordering must be configured on the host running the local proxy.');
+        }
+        if (!(await this.deps.verifyProxy(target))) {
+            throw new error_types_1.ConfigError('The local proxy must be running and verified before changing Claude quota ordering.');
+        }
+        const api = this.deps.management(target, this.lifecycleAbort.signal);
+        await api.checkCapabilities();
+        return { api, target };
+    }
+    getStatus() {
+        const enabled = this.deps.drainOrder()?.mode === 'quota';
+        const controllerActive = this.controllerActive();
+        try {
+            const lease = (0, claude_pool_policy_lease_1.readActiveClaudePoolControllerLease)(this.ownerFile, targetKey(this.deps.target()), this.deps.now(), LEASE_STALE_MS);
+            return (0, claude_pool_policy_state_1.buildClaudePoolPolicyStatus)(enabled, controllerActive, this.readState(), this.deps.accounts(), this.deps.now(), lease?.startedAt);
+        }
+        catch (error) {
+            return {
+                enabled,
+                status: 'degraded',
+                controllerActive,
+                lastReconciledAt: null,
+                error: error.message,
+                accounts: [],
+            };
+        }
+    }
+    async setEnabled(enabled) {
+        await this.withMutation(async (valid) => {
+            const { api, target } = await this.verifiedApi();
+            if (enabled) {
+                if (!this.deps.poolEnabled())
+                    throw new error_types_1.ConfigError('Enable pool routing before enabling Claude quota ordering.');
+                if (!this.controllerActive())
+                    throw new error_types_1.ConfigError('Start a persistent CCS dashboard or integrated Docker service before enabling quota ordering.');
+                if (this.deps.drainOrder()?.mode !== 'quota') {
+                    const retained = this.readState();
+                    if (retained?.restoring)
+                        throw new error_types_1.ConfigError('Previous Claude priority restoration is pending. Resolve it before enabling the policy.');
+                    const state = (0, claude_pool_policy_state_1.createClaudePoolPolicyState)(targetKey(target));
+                    state.previousDrainOrder = this.deps.drainOrder() ?? null;
+                    state.status = 'pending';
+                    // Commit the ownership snapshot before enabling the config or writing any priority.
+                    this.writeState(state);
+                    this.deps.saveDrainOrder({ mode: 'quota' });
+                    try {
+                        await this.deps.regenerate(target);
+                    }
+                    catch (error) {
+                        this.deps.saveDrainOrder(state.previousDrainOrder);
+                        state.status = 'degraded';
+                        state.error =
+                            'Could not regenerate proxy configuration. The quota policy was not enabled.';
+                        this.writeState(state);
+                        throw error;
+                    }
+                }
+                await (0, claude_pool_policy_reconciliation_1.reconcileClaudePoolPriorities)(this.reconciliationContext(), api, target, valid);
+            }
+            else {
+                const state = this.readState();
+                if (!state) {
+                    if (this.deps.drainOrder()?.mode === 'quota')
+                        throw new error_types_1.ConfigError('Claude quota ownership state is missing. Preserve priorities and repair state before disabling.');
+                    return;
+                }
+                if (state.target !== targetKey(target))
+                    throw new error_types_1.ConfigError('Restore the original local proxy target before restoring Claude pool priorities.');
+                if (this.deps.drainOrder()?.mode === 'quota')
+                    this.deps.saveDrainOrder(state.previousDrainOrder);
+                state.restoring = true;
+                this.writeState(state);
+                await this.deps.regenerate(target);
+                await (0, claude_pool_policy_reconciliation_1.restoreClaudePoolPriorities)(this.reconciliationContext(), state, api, valid);
+            }
+        });
+        return this.getStatus();
+    }
+    /** Explicit manual changes supersede this policy without restoring over the chosen order. */
+    async relinquishForManualOrder() {
+        const relinquish = async () => {
+            if (this.deps.drainOrder()?.mode !== 'quota' && !this.readState()?.restoring)
+                return;
+            const state = this.readState();
+            if (state && state.target !== targetKey(this.deps.target()))
+                throw new error_types_1.ConfigError('Restore the original local proxy target before changing Claude pool ownership.');
+            this.deps.saveDrainOrder(null);
+            if (state) {
+                for (const entry of Object.values(state.entries)) {
+                    entry.ownsPriority = false;
+                    delete entry.pendingPriority;
+                }
+                state.restoring = false;
+                state.status = 'inactive';
+                delete state.error;
+                this.writeState(state);
+            }
+            await this.deps.regenerate(this.deps.target());
+        };
+        if (this.manualMutation.getStore())
+            await relinquish();
+        else
+            await this.withMutation(relinquish);
+    }
+    /** Keep the mutex through validation, priority application and manual-config commit. */
+    async withManualOrder(operation) {
+        return this.withMutation(async () => this.manualMutation.run(true, operation));
+    }
+    /** Public deterministic cycle used by lifecycle hooks and synthetic tests. */
+    async reconcile(valid = () => true) {
+        await this.withMutation(async (mutationValid) => {
+            if (this.deps.drainOrder()?.mode !== 'quota' && !this.readState()?.restoring)
+                return;
+            try {
+                const { api, target } = await this.verifiedApi();
+                await (0, claude_pool_policy_reconciliation_1.reconcileClaudePoolPriorities)(this.reconciliationContext(), api, target, () => valid() && mutationValid());
+            }
+            catch (error) {
+                const state = this.readState();
+                if (state) {
+                    state.status = 'degraded';
+                    state.error = error.message;
+                    this.writeState(state);
+                }
+                throw error;
+            }
+        });
+    }
+    async release() {
+        const release = this.releaseLeadership;
+        this.releaseLeadership = null;
+        if (this.heartbeat)
+            clearInterval(this.heartbeat);
+        this.heartbeat = null;
+        try {
+            const owner = JSON.parse(fs.readFileSync(this.ownerFile, 'utf8'));
+            if (owner.owner === this.owner)
+                fs.unlinkSync(this.ownerFile);
+        }
+        catch {
+            /* Another owner or process cleanup already removed the lease. */
+        }
+        if (release)
+            await release().catch(() => { });
+    }
+    async tick() {
+        if (this.stopped || this.busy)
+            return;
+        this.busy = true;
+        try {
+            if (this.deps.target().isRemote) {
+                await this.release();
+                return;
+            }
+            if (!this.releaseLeadership) {
+                ensureLockTarget(this.leaseFile);
+                try {
+                    this.compromised = false;
+                    this.releaseLeadership = await lockfile.lock(this.leaseFile, {
+                        realpath: false,
+                        stale: LEASE_STALE_MS,
+                        update: HEARTBEAT_MS,
+                        retries: 0,
+                        onCompromised: () => {
+                            this.compromised = true;
+                        },
+                    });
+                }
+                catch {
+                    return;
+                }
+                this.renewLease();
+                this.heartbeat = setInterval(() => {
+                    try {
+                        this.renewLease();
+                    }
+                    catch {
+                        this.compromised = true;
+                    }
+                }, HEARTBEAT_MS);
+                this.heartbeat.unref();
+            }
+            const valid = () => !this.stopped && !this.compromised && this.releaseLeadership !== null;
+            if (valid())
+                await this.reconcile(valid);
+        }
+        catch {
+            // The persisted status carries the actionable error; the next cycle retries safely.
+        }
+        finally {
+            this.busy = false;
+            if (this.stopped || this.compromised)
+                await this.release();
+        }
+    }
+    launchTick() {
+        if (this.activeCycle)
+            return;
+        this.activeCycle = this.tick().finally(() => {
+            this.activeCycle = null;
+        });
+    }
+    /** Wake a running controller without overlapping its current cycle. */
+    async wake() {
+        if (this.stopped)
+            return;
+        this.launchTick();
+        if (this.activeCycle)
+            await this.activeCycle;
+    }
+    start() {
+        if (!this.stopped)
+            return () => this.stop();
+        this.stopped = false;
+        if (this.lifecycleAbort.signal.aborted)
+            this.lifecycleAbort = new AbortController();
+        this.startedAt = this.deps.now();
+        this.launchTick();
+        this.interval = setInterval(() => {
+            this.launchTick();
+        }, claude_pool_policy_state_1.CLAUDE_POOL_RECONCILE_MS);
+        this.interval.unref();
+        return () => this.stop();
+    }
+    async stop() {
+        this.stopped = true;
+        this.lifecycleAbort.abort();
+        if (this.interval)
+            clearInterval(this.interval);
+        this.interval = null;
+        if (this.activeCycle)
+            await this.activeCycle;
+        while (this.activeMutations.size > 0)
+            await Promise.all([...this.activeMutations]);
+        await this.release();
+    }
+}
+exports.ClaudePoolPolicyController = ClaudePoolPolicyController;
+const controllers = new Map();
+function getClaudePoolPolicyController() {
+    const file = (0, claude_pool_policy_state_1.getClaudePoolPolicyStatePath)();
+    let controller = controllers.get(file);
+    if (!controller) {
+        controller = new ClaudePoolPolicyController({ file });
+        controllers.set(file, controller);
+    }
+    return controller;
+}
+exports.getClaudePoolPolicyController = getClaudePoolPolicyController;
+function startClaudePoolPolicyController() {
+    return getClaudePoolPolicyController().start();
+}
+exports.startClaudePoolPolicyController = startClaudePoolPolicyController;
+//# sourceMappingURL=claude-pool-policy.js.map