pixivflow 2.9.0 → 2.10.0

package/dist/topic/TopicPipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TopicPipeline.d.ts","sourceRoot":"","sources":["../../src/topic/TopicPipeline.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,QAAQ,EACT,MAAM,SAAS,CAAC;AAYjB,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAFd,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,aAAa,EACvB,cAAc,SAAM;IAGjC,WAAW,CAAC,CAAC,SAAS,QAAQ,EAClC,MAAM,EAAE,YAAY,EACpB,WAAW,EAAE,gBAAgB,EAC7B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,qBAAqB,EAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC;QAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QAAC,SAAS,EAAE,cAAc,CAAA;KAAE,CAAC;YAgEvC,SAAS;IAmBvB,OAAO,CAAC,WAAW;IAenB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAmCrB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,KAAK;IAKb,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,KAAK;CAKd"}

package/dist/topic/TopicPipeline.js

@@ -0,0 +1,224 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TopicPipeline = void 0;
+const promises_1 = require("node:timers/promises");
+const logger_1 = require("../logger");
+const pixiv_utils_1 = require("../utils/pixiv-utils");
+const COLLECT_DEFAULTS = { maxPerTag: 40, maxCandidates: 250, minMetadataScore: 0.35 };
+/** Small, platform-level tags that are never evidence of topic membership. */
+const STOP_TAGS = new Set([
+    'r-18', 'r-18g', 'r-15', 'original', 'オリジナル', '創作', '女の子', '男の子',
+    'イラスト', '漫画', 'manga', 'illustration', 'artwork', '落書き', 'らくがき',
+    '1000users入り', '5000users入り', '10000users入り', '500users入り', '100users入り',
+    'pixiv', 'commission', 'skeb', '依頼絵', '仕事絵',
+]);
+/**
+ * Resolves a topic to a tag space, collects that day's works across the tags,
+ * filters by lightweight metadata relevance and ranks by local popularity, then
+ * returns only the chosen full work objects for the existing download pipeline.
+ * Serial, bounded, low-memory: the retained set is `limit` items; the pool is
+ * capped at maxCandidates and released after selection.
+ */
+class TopicPipeline {
+    client;
+    resolver;
+    requestDelayMs;
+    constructor(client, resolver, requestDelayMs = 500) {
+        this.client = client;
+        this.resolver = resolver;
+        this.requestDelayMs = requestDelayMs;
+    }
+    async selectWorks(target, contentType, day, limit, discovery, collect) {
+        const topic = (target.topic ?? '').trim();
+        const { space } = await this.resolver.resolve(topic, contentType, discovery);
+        const tagScores = new Map(space.tags.map((t) => [this.key(t.name), t.score]));
+        const maxPerTag = this.bound(collect.maxPerTag, COLLECT_DEFAULTS.maxPerTag, 5, 100);
+        const maxCandidates = this.bound(collect.maxCandidates, COLLECT_DEFAULTS.maxCandidates, 20, 500);
+        const minMetadataScore = collect.minMetadataScore ?? COLLECT_DEFAULTS.minMetadataScore;
+        const byId = new Map();
+        let rawCount = 0;
+        const tagNames = space.tags.map((t) => t.name);
+        for (let i = 0; i < tagNames.length; i++) {
+            if (byId.size >= maxCandidates)
+                break;
+            const tag = tagNames[i];
+            const works = await this.searchDay(contentType, tag, day, maxPerTag);
+            rawCount += works.length;
+            for (const work of works) {
+                if (byId.has(work.id))
+                    continue;
+                byId.set(work.id, { work, candidate: this.toCandidate(work, contentType) });
+                if (byId.size >= maxCandidates)
+                    break;
+            }
+            logger_1.logger.debug('[TopicCollector] type=' + contentType + ' tag=' + tag + ' day=' + day + ' fetched=' + works.length + ' pool=' + byId.size);
+            if (i < tagNames.length - 1 && this.requestDelayMs > 0)
+                await (0, promises_1.setTimeout)(this.requestDelayMs);
+        }
+        const dedupedCount = byId.size;
+        logger_1.logger.info('[TopicCollector] type=' + contentType + ' raw=' + rawCount + ' deduplicated=' + dedupedCount);
+        const seedKey = this.key(topic);
+        const accepted = [];
+        for (const entry of byId.values()) {
+            entry.candidate.metadataScore = this.metadataScore(entry.candidate, seedKey, tagScores);
+            if (entry.candidate.metadataScore >= minMetadataScore)
+                accepted.push(entry);
+        }
+        if (accepted.length === 0 && byId.size > 0) {
+            const fallback = [...byId.values()]
+                .filter((e) => e.candidate.tags.some((t) => this.key(t) === seedKey))
+                .sort((a, b) => b.candidate.popularity - a.candidate.popularity);
+            accepted.push(...fallback.slice(0, Math.max(limit, 1)));
+            logger_1.logger.warn('[MetadataTopicFilter] type=' + contentType + ' none above threshold ' + minMetadataScore + '; kept ' + accepted.length + ' seed-tag fallback');
+        }
+        const chosen = this.topByPopularity(accepted, limit);
+        const selected = chosen.map((e) => e.candidate);
+        logger_1.logger.info('[MetadataTopicFilter] accepted=' + accepted.length);
+        if (selected[0]) {
+            logger_1.logger.info('[PopularityRanker] selected=' + selected[0].id + ' popularity=' + selected[0].popularity.toFixed(1) + ' meta=' + selected[0].metadataScore.toFixed(2) + ' title=' + selected[0].title);
+        }
+        return {
+            works: chosen.map((e) => e.work),
+            selection: {
+                candidates: [...byId.values()].map((e) => e.candidate),
+                selected,
+                resolvedTagCount: space.tags.length,
+                rawCount,
+                dedupedCount,
+                acceptedCount: accepted.length,
+            },
+        };
+    }
+    async searchDay(contentType, tag, day, limit) {
+        try {
+            const opts = { startDate: day, endDate: day };
+            const works = contentType === 'illustration'
+                ? await this.client.searchIllustrationsForTags(tag, limit, opts)
+                : await this.client.searchNovelsForTags(tag, limit, opts);
+            // Date is already enforced server-side + pager stop; keep a cheap guard.
+            return works.filter((w) => this.onDay(w.create_date, day));
+        }
+        catch (error) {
+            logger_1.logger.warn('[TopicCollector] search failed tag=' + tag + ' type=' + contentType + ': ' + (error instanceof Error ? error.message : String(error)));
+            return [];
+        }
+    }
+    toCandidate(work, type) {
+        const popularity = (0, pixiv_utils_1.calculatePopularityScore)(work);
+        return {
+            id: work.id,
+            type,
+            title: work.title ?? '',
+            caption: work.caption ?? '',
+            tags: (work.tags ?? []).map((t) => t.name).filter(Boolean),
+            bookmarks: Number(work.total_bookmarks ?? work.bookmark_count ?? 0) || 0,
+            views: Number(work.total_view ?? work.view_count ?? 0) || 0,
+            popularity,
+            metadataScore: 0,
+        };
+    }
+    /**
+     * Lightweight metadata relevance. Tags dominate (Pixiv's own taxonomy);
+     * title/caption add smaller boosts. The seed tag is strong evidence.
+     * No text model — case/symbol-insensitive substring matching only.
+     */
+    metadataScore(candidate, seedKey, tagScores) {
+        let seedHit = false;
+        let relatedSum = 0;
+        let relatedHits = 0;
+        for (const tag of candidate.tags) {
+            const k = this.key(tag);
+            if (STOP_TAGS.has(k))
+                continue;
+            if (k === seedKey) {
+                seedHit = true;
+                continue;
+            }
+            const related = tagScores.get(k);
+            if (related !== undefined) {
+                relatedSum += Math.min(related, 0.6);
+                relatedHits += 1;
+            }
+        }
+        const hayTitle = this.normalize(candidate.title);
+        const hayCaption = this.normalize(candidate.caption);
+        const titleSeed = !!seedKey && hayTitle.includes(seedKey);
+        const captionSeed = !!seedKey && hayCaption.includes(seedKey);
+        if (seedHit) {
+            // Core topic work: the seed tag itself is the strongest evidence.
+            let score = 1.0 + Math.min(relatedSum, 0.5);
+            if (titleSeed)
+                score += 0.4;
+            return score;
+        }
+        // No seed tag: the work must show several independent related tags (or a
+        // high-weight one plus text) to count as on-topic. A single marginal tag
+        // deliberately does NOT clear the bar, so a hugely popular tangential work
+        // cannot crowd out core topic works.
+        let score = 0;
+        const strongRelated = [...tagScores.entries()].some(([k, w]) => w >= 0.6 && candidate.tags.some((t) => this.key(t) === k));
+        if (titleSeed)
+            score += 0.8;
+        if (captionSeed)
+            score += 0.4;
+        if (strongRelated)
+            score += 0.5;
+        score += Math.min(relatedSum, 0.6) * (relatedHits >= 2 ? 1 : 0.5);
+        return score;
+    }
+    /**
+     * Rank primarily by topic relevance tier, then by local popularity within a
+     * tier. Relevance wins because the goal is "belongs to the topic", with
+     * popularity deciding which on-topic work to download.
+     */
+    relevanceTier(c) {
+        if (c.metadataScore >= 1.0)
+            return 3; // carries the seed tag / strong evidence
+        if (c.metadataScore >= 0.7)
+            return 2;
+        return 1;
+    }
+    rankCompare(a, b) {
+        const tier = this.relevanceTier(b) - this.relevanceTier(a);
+        if (tier !== 0)
+            return tier;
+        return b.popularity - a.popularity;
+    }
+    topByPopularity(items, limit) {
+        if (items.length <= limit)
+            return items.sort((a, b) => this.rankCompare(a.candidate, b.candidate));
+        // O(n) top-`limit` selection (limit is tiny, e.g. 1); avoids a full sort.
+        const top = [];
+        for (const item of items) {
+            if (top.length < limit) {
+                top.push(item);
+                top.sort((a, b) => this.rankCompare(a.candidate, b.candidate));
+            }
+            else if (this.rankCompare(item.candidate, top[top.length - 1].candidate) < 0) {
+                top[top.length - 1] = item;
+                top.sort((a, b) => this.rankCompare(a.candidate, b.candidate));
+            }
+        }
+        return top;
+    }
+    onDay(createDate, day) {
+        if (!createDate)
+            return true;
+        return createDate.slice(0, 10) === day;
+    }
+    normalize(value) {
+        return value.toLowerCase().normalize('NFKC');
+    }
+    key(value) {
+        return value.trim().normalize('NFKC').toLocaleLowerCase();
+    }
+    bound(value, fallback, min, max) {
+        const resolved = value ?? fallback;
+        if (!Number.isInteger(resolved) || resolved < min || resolved > max)
+            return fallback;
+        return resolved;
+    }
+}
+exports.TopicPipeline = TopicPipeline;
+function seedText(key) { return key; }
+//# sourceMappingURL=TopicPipeline.js.map

package/dist/topic/TopicPipeline.js.map

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

package/dist/topic/TopicResolver.d.ts

@@ -0,0 +1,31 @@
+import { TopicCache } from './TopicCache';
+import type { TopicClient, TopicContentType, TopicDiscoveryOptions, TopicSpace } from './types';
+/**
+ * Resolves a user topic into a bounded, cached set of related Pixiv tags.
+ *
+ * Discovery is intentionally one-hop around the ORIGINAL seed only (depth = 1):
+ * related tags never become new seeds, so the topic cannot drift outward. All
+ * network use is bounded and serial. Refresh failures degrade gracefully to a
+ * stale cache, then to the seed tag alone.
+ */
+export declare class TopicResolver {
+    private readonly client;
+    private readonly cache;
+    private readonly requestDelayMs;
+    private readonly scorer;
+    constructor(client: TopicClient, cache: TopicCache, requestDelayMs?: number);
+    /** Resolve tags for a topic+type, using cache when fresh. Never throws for
+     *  discovery errors: it always returns at least the seed tag. */
+    resolve(topic: string, contentType: TopicContentType, options?: TopicDiscoveryOptions): Promise<{
+        space: TopicSpace;
+        fromCache: boolean;
+        degraded: boolean;
+    }>;
+    private discover;
+    /** Serial, bounded fetches: autocomplete → topic sample → small background. */
+    private gatherSamples;
+    private seedOnly;
+    private ageDays;
+    private bound;
+}
+//# sourceMappingURL=TopicResolver.d.ts.map

package/dist/topic/TopicResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TopicResolver.d.ts","sourceRoot":"","sources":["../../src/topic/TopicResolver.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,KAAK,EAEV,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,UAAU,EAEX,MAAM,SAAS,CAAC;AAiBjB;;;;;;;GAOG;AACH,qBAAa,aAAa;IAItB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,cAAc;IALjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;gBAG5B,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,UAAU,EACjB,cAAc,SAAM;IAGvC;qEACiE;IAC3D,OAAO,CACX,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,gBAAgB,EAC7B,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;YAyC1D,QAAQ;IA+CtB,+EAA+E;YACjE,aAAa;IAsB3B,OAAO,CAAC,QAAQ;IAchB,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,KAAK;CAOd"}

package/dist/topic/TopicResolver.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TopicResolver = void 0;
+const promises_1 = require("node:timers/promises");
+const logger_1 = require("../logger");
+const TopicTagScorer_1 = require("./TopicTagScorer");
+/** Platform-wide tags never worth searching as topic keys or scoring metadata. */
+const STOP_TAGS = new Set([
+    'r-18', 'r-18g', 'r-15', 'original', 'オリジナル', '創作', '女の子', '男の子',
+    'イラスト', '漫画', 'manga', 'illustration', 'artwork', '落書き', 'らくがき',
+    '1000users入り', '5000users入り', '10000users入り', '500users入り', '100users入り',
+    'pixiv', 'commission', 'skeb', '依頼絵', '仕事絵', 'aiイラスト',
+]);
+const DEFAULTS = {
+    maxTags: 12,
+    sampleWorks: 100,
+    cacheDays: 7,
+    minScore: 0.22,
+};
+/**
+ * Resolves a user topic into a bounded, cached set of related Pixiv tags.
+ *
+ * Discovery is intentionally one-hop around the ORIGINAL seed only (depth = 1):
+ * related tags never become new seeds, so the topic cannot drift outward. All
+ * network use is bounded and serial. Refresh failures degrade gracefully to a
+ * stale cache, then to the seed tag alone.
+ */
+class TopicResolver {
+    client;
+    cache;
+    requestDelayMs;
+    scorer = new TopicTagScorer_1.TopicTagScorer();
+    constructor(client, cache, requestDelayMs = 500) {
+        this.client = client;
+        this.cache = cache;
+        this.requestDelayMs = requestDelayMs;
+    }
+    /** Resolve tags for a topic+type, using cache when fresh. Never throws for
+     *  discovery errors: it always returns at least the seed tag. */
+    async resolve(topic, contentType, options = {}) {
+        const seed = topic.trim();
+        if (!seed)
+            throw new Error('Topic must not be empty');
+        const maxTags = this.bound(options.maxTags, DEFAULTS.maxTags, 1, 40, 'maxTags');
+        const sampleWorks = this.bound(options.sampleWorks, DEFAULTS.sampleWorks, 10, 200, 'sampleWorks');
+        const cacheDays = this.bound(options.cacheDays, DEFAULTS.cacheDays, 1, 90, 'cacheDays');
+        const minScore = options.minScore ?? DEFAULTS.minScore;
+        if (!options.refresh) {
+            const fresh = await this.cache.loadFresh(seed, contentType);
+            if (fresh) {
+                logger_1.logger.info(`[TopicResolver] topic=${seed} type=${contentType} cache hit age=${this.ageDays(fresh)}d tags=${fresh.tags.length}`);
+                return { space: fresh, fromCache: true, degraded: false };
+            }
+        }
+        logger_1.logger.info(`[TopicResolver] refreshing topic=${seed} type=${contentType}`);
+        try {
+            const space = await this.discover(seed, contentType, { maxTags, sampleWorks, cacheDays, minScore });
+            await this.cache.save(space);
+            logger_1.logger.info(`[TopicResolver] topic=${seed} type=${contentType} resolvedTags=${space.tags.length} sampled=${space.sampledWorks}`);
+            for (const tag of space.tags.slice(0, maxTags)) {
+                logger_1.logger.debug(`[TopicResolver] tag=${tag.name} score=${tag.score} occ=${tag.occurrences} spec=${tag.specificity}`);
+            }
+            return { space, fromCache: false, degraded: false };
+        }
+        catch (error) {
+            const stale = await this.cache.loadAny(seed, contentType);
+            if (stale) {
+                logger_1.logger.warn(`[TopicResolver] refresh failed, using stale cache topic=${seed}`, {
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                return { space: stale, fromCache: true, degraded: true };
+            }
+            logger_1.logger.warn(`[TopicResolver] refresh failed with no cache, falling back to seed topic=${seed}`, {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return { space: this.seedOnly(seed, contentType, cacheDays), fromCache: false, degraded: true };
+        }
+    }
+    async discover(seed, contentType, cfg) {
+        const [suggested, topicWorks, backgroundWorks] = await this.gatherSamples(seed, contentType, cfg.sampleWorks);
+        const suggestedNames = new Set(suggested.map((t) => this.scorer.key(t.name)).filter(Boolean));
+        const related = this.scorer.score({
+            seed,
+            topicWorks,
+            backgroundWorks,
+            suggestedNames,
+        });
+        // Seed tag always leads the space with score 1.0; keep related tags above
+        // the relevance floor and cap the total.
+        const seedTag = {
+            name: seed,
+            translatedName: suggested.find((t) => this.scorer.key(t.name) === this.scorer.key(seed))?.translated_name,
+            score: 1,
+            occurrences: topicWorks.length,
+            coverage: 1,
+            specificity: 1,
+            suggested: suggestedNames.has(this.scorer.key(seed)),
+            seed: true,
+        };
+        const accepted = related
+            .filter((tag) => tag.score >= cfg.minScore)
+            .filter((tag) => !STOP_TAGS.has(this.scorer.key(tag.name)))
+            .slice(0, cfg.maxTags - 1);
+        const tags = [seedTag, ...accepted];
+        const now = Date.now();
+        return {
+            version: 1,
+            topic: seed,
+            contentType,
+            createdAt: new Date(now).toISOString(),
+            expiresAt: new Date(now + cfg.cacheDays * 24 * 60 * 60_000).toISOString(),
+            sampleSize: cfg.sampleWorks,
+            sampledWorks: topicWorks.length,
+            tags,
+        };
+    }
+    /** Serial, bounded fetches: autocomplete → topic sample → small background. */
+    async gatherSamples(seed, contentType, sampleWorks) {
+        const suggested = await this.client.getTagAutocomplete(seed).catch(() => []);
+        if (this.requestDelayMs > 0)
+            await (0, promises_1.setTimeout)(this.requestDelayMs);
+        const topicWorks = contentType === 'illustration'
+            ? await this.client.searchIllustrationsForTags(seed, sampleWorks)
+            : await this.client.searchNovelsForTags(seed, sampleWorks);
+        // A small, cheap background sample (a common platform tag) estimates how
+        // generic a co-occurring tag is. Bounded to keep requests/memory low.
+        if (this.requestDelayMs > 0)
+            await (0, promises_1.setTimeout)(this.requestDelayMs);
+        const backgroundWorks = contentType === 'illustration'
+            ? await this.client.searchIllustrationsForTags('イラスト', 40).catch(() => [])
+            : await this.client.searchNovelsForTags('小説', 40).catch(() => []);
+        return [suggested, topicWorks, backgroundWorks];
+    }
+    seedOnly(seed, contentType, cacheDays) {
+        const now = Date.now();
+        return {
+            version: 1,
+            topic: seed,
+            contentType,
+            createdAt: new Date(now).toISOString(),
+            expiresAt: new Date(now + cacheDays * 24 * 60 * 60_000).toISOString(),
+            sampleSize: 0,
+            sampledWorks: 0,
+            tags: [{ name: seed, score: 1, occurrences: 0, coverage: 1, specificity: 1, suggested: false, seed: true }],
+        };
+    }
+    ageDays(space) {
+        const created = Date.parse(space.createdAt);
+        if (!Number.isFinite(created))
+            return 0;
+        return Math.max(0, Math.round((Date.now() - created) / 86_400_000));
+    }
+    bound(value, fallback, min, max, name) {
+        const resolved = value ?? fallback;
+        if (!Number.isInteger(resolved) || resolved < min || resolved > max) {
+            throw new Error(`topicDiscovery.${name} must be an integer between ${min} and ${max}`);
+        }
+        return resolved;
+    }
+}
+exports.TopicResolver = TopicResolver;
+//# sourceMappingURL=TopicResolver.js.map

package/dist/topic/TopicResolver.js.map

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

package/dist/topic/TopicTagScorer.d.ts

@@ -0,0 +1,13 @@
+import type { ResolvedTag, WorkLike } from './types';
+export interface ScorerInput {
+    seed: string;
+    topicWorks: WorkLike[];
+    backgroundWorks: WorkLike[];
+    suggestedNames: Set<string>;
+}
+export declare class TopicTagScorer {
+    /** Normalize for matching/keys: trim, NFKC, lower-case. */
+    key(value: string): string;
+    score(input: ScorerInput): ResolvedTag[];
+}
+//# sourceMappingURL=TopicTagScorer.d.ts.map

package/dist/topic/TopicTagScorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TopicTagScorer.d.ts","sourceRoot":"","sources":["../../src/topic/TopicTagScorer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAoCrD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,QAAQ,EAAE,CAAC;IACvB,eAAe,EAAE,QAAQ,EAAE,CAAC;IAC5B,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED,qBAAa,cAAc;IACzB,2DAA2D;IAC3D,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAI1B,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,EAAE;CA+EzC"}

package/dist/topic/TopicTagScorer.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TopicTagScorer = void 0;
+/**
+ * Lightweight, explainable tag relatedness. No ML — pure co-occurrence stats
+ * over the small, bounded samples the resolver fetches.
+ *
+ *   score = coverage * specificity * suggestionWeight
+ *
+ * - coverage:      fraction of the seed-topic sample that carries the tag.
+ * - specificity:   how much more often the tag appears with the topic than in
+ *                  the background. High-frequency but topic-agnostic tags
+ *                  (R-18, オリジナル, 女の子…) get pushed down automatically.
+ * - suggestionWeight: a modest boost when Pixiv autocomplete also returns it.
+ *
+ * The background document frequency is estimated from a cheap background
+ * sample (a recent, unrelated search) when available, falling back to a small
+ * curated set of platform-wide tags. We deliberately keep that list tiny — the
+ * specificity score does the real denoising.
+ */
+/** Platform-level tags that are almost never topic-specific. */
+const GENERIC_TAG_PENALTY = new Set([
+    'r-18', 'r-18g', 'r-15', 'original', 'オリジナル', '創作', '女の子', '男の子',
+    'イラスト', '漫画', 'manga', 'illustration', 'artwork', '落書き', 'らくがき',
+    '1000users入り', '5000users入り', '10000users入り', '500users入り', '100users入り',
+    'pixiv', 'commission', 'skeb', '依頼絵', '仕事絵',
+]);
+class TopicTagScorer {
+    /** Normalize for matching/keys: trim, NFKC, lower-case. */
+    key(value) {
+        return value.trim().normalize('NFKC').toLocaleLowerCase();
+    }
+    score(input) {
+        const seedKey = this.key(input.seed);
+        const topicSize = Math.max(input.topicWorks.length, 1);
+        const backgroundSize = Math.max(input.backgroundWorks.length, 1);
+        const stats = new Map();
+        const accumulate = (works, bucket) => {
+            for (const work of works) {
+                const seen = new Set();
+                for (const tag of work.tags ?? []) {
+                    const name = tag.name?.trim();
+                    const k = this.key(name ?? '');
+                    if (!k || seen.has(k))
+                        continue;
+                    seen.add(k);
+                    let stat = stats.get(k);
+                    if (!stat) {
+                        stat = { name: name, translatedName: tag.translated_name?.trim() || undefined, topicDocs: 0, backgroundDocs: 0, suggested: false };
+                        stats.set(k, stat);
+                    }
+                    else if (!stat.translatedName && tag.translated_name?.trim()) {
+                        stat.translatedName = tag.translated_name.trim();
+                    }
+                    stat[bucket] += 1;
+                }
+            }
+        };
+        accumulate(input.topicWorks, 'topicDocs');
+        accumulate(input.backgroundWorks, 'backgroundDocs');
+        for (const name of input.suggestedNames) {
+            const k = this.key(name);
+            const stat = stats.get(k);
+            if (stat)
+                stat.suggested = true;
+        }
+        const resolved = [];
+        for (const [k, stat] of stats) {
+            if (k === seedKey)
+                continue; // seed is added separately with score 1
+            const coverage = stat.topicDocs / topicSize;
+            if (stat.topicDocs <= 0)
+                continue;
+            // Background frequency of the tag in the unrelated sample. Tags that are
+            // common everywhere (R-18, オリジナル…) have high backgroundFreq; tags
+            // that only travel with the topic have ~0.
+            const backgroundFreq = stat.backgroundDocs / backgroundSize;
+            // PMI-style lift: how much more the tag appears with the topic than at
+            // large. Positive (and growing for background-absent tags), near/below 0
+            // for generic tags. Additive smoothing prevents divide-by-zero blowups.
+            const lift = Math.log((coverage + 0.03) / (backgroundFreq + 0.03));
+            // Map lift to a 0..1+ specificity via a logistic-ish squish; a lift of ~0
+            // (equally common in background) maps to ~0.5 and strongly generic tags
+            // fall below it.
+            const specificity = Math.max(0, Math.min(1.2, lift / 3 + 0.5));
+            // Final score rewards both co-occurrence (recall) and specificity
+            // (precision), so rare-but-exclusive tags can still surface while
+            // ubiquitous tags are suppressed.
+            const recall = Math.sqrt(coverage); // dampen so mid-coverage can win
+            const suggestionWeight = stat.suggested ? 1.1 : 1.0;
+            const genericPenalty = GENERIC_TAG_PENALTY.has(k) ? 0.4 : 1.0;
+            const raw = recall * specificity * suggestionWeight * genericPenalty;
+            resolved.push({
+                name: stat.name,
+                translatedName: stat.translatedName,
+                score: Number(raw.toFixed(4)),
+                occurrences: stat.topicDocs,
+                coverage: Number(coverage.toFixed(4)),
+                specificity: Number(specificity.toFixed(4)),
+                suggested: stat.suggested,
+                seed: false,
+            });
+        }
+        resolved.sort((a, b) => b.score - a.score || b.occurrences - a.occurrences || a.name.localeCompare(b.name));
+        return resolved;
+    }
+}
+exports.TopicTagScorer = TopicTagScorer;
+//# sourceMappingURL=TopicTagScorer.js.map

package/dist/topic/TopicTagScorer.js.map

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

package/dist/topic/createTopicPipeline.d.ts

@@ -0,0 +1,12 @@
+import type { IPixivClient } from '../interfaces/IPixivClient';
+import { TopicPipeline } from './TopicPipeline';
+export type TopicPipelineFactory = () => TopicPipeline;
+/**
+ * Builds the topic pipeline with a persistent cache beside the SQLite database
+ * (which lives on the data volume in Docker, so it survives container rebuilds).
+ * One instance is shared across targets within a download run.
+ */
+export declare function createTopicPipeline(client: IPixivClient, databasePath: string | undefined, requestDelayMs?: number): TopicPipeline;
+/** Lazily builds one shared pipeline per download run (cache + resolver). */
+export declare function createTopicPipelineFactory(client: IPixivClient, databasePath: string | undefined, requestDelayMs?: number): TopicPipelineFactory;
+//# sourceMappingURL=createTopicPipeline.d.ts.map

package/dist/topic/createTopicPipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTopicPipeline.d.ts","sourceRoot":"","sources":["../../src/topic/createTopicPipeline.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,MAAM,MAAM,oBAAoB,GAAG,MAAM,aAAa,CAAC;AAEvD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,cAAc,SAAM,GAAG,aAAa,CAO/H;AAED,6EAA6E;AAC7E,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,cAAc,SAAM,GAAG,oBAAoB,CAM7I"}