Method enqueueFile

src/scan-service.js:422–607

(filePath, sourceRoot)

        };
    }
    async enqueueFile(filePath, sourceRoot) {
        const startedAt = this.now();
        this.logSkillScanStart({
            phase: "queue",
            path: filePath,
            sourceRoot,
        });
        this.clearCooldownIfElapsed();
        if (this.isCooldownActive()) {
            const durationMs = this.now() - startedAt;
            this.params.logger.warn("claw-aegis: 冷却期间已跳过 skill 扫描", {
                event: "skill_scan_skipped",
                state: "cooldown",
                path: filePath,
                durationMs,
            });
            this.logSkillScanFinish({
                phase: "queue",
                path: filePath,
                sourceRoot,
                result: "skipped_cooldown",
                durationMs,
            });
            return { status: "skipped-cooldown" };
        }
        if (path.basename(filePath) !== SKILL_SCAN_TARGET_FILENAME) {
            const durationMs = this.now() - startedAt;
            this.logSkillScanResult({
                phase: "queue",
                path: filePath,
                sourceRoot,
                result: "ignored_non_skill_file",
                durationMs,
            });
            this.logSkillScanFinish({
                phase: "queue",
                path: filePath,
                sourceRoot,
                result: "ignored_non_skill_file",
                durationMs,
            });
            return { status: "already-reviewed" };
        }
        let prepared;
        try {
            prepared = await this.prepareSkillFile(filePath, sourceRoot);
        }
        catch {
            prepared = null;
        }
        if (!prepared) {
            const durationMs = this.now() - startedAt;
            this.logSkillScanResult({
                phase: "queue",
                path: filePath,
                sourceRoot,
                result: "ignored_unreadable",
                durationMs,