pixivflow 2.8.0 → 2.10.0

package/dist/tags/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/tags/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tags/types.ts"],"names":[],"mappings":""}

package/dist/topic/TopicCache.d.ts

@@ -0,0 +1,23 @@
+import type { TopicContentType, TopicSpace } from './types';
+/**
+ * Durable Topic cache stored beside the SQLite database (which lives on the
+ * persistent data volume in Docker). One small JSON file per
+ * `<topic, contentType>`, written atomically. No extra database or service.
+ *
+ * Daily scheduler runs normally hit the fresh cache; only a missing/expired
+ * entry triggers discovery. A stale entry is kept and reused if refresh fails.
+ */
+export declare class TopicCache {
+    private readonly directory;
+    private readonly now;
+    constructor(directory: string, now?: () => number);
+    static forDatabase(databasePath: string): TopicCache;
+    private pathFor;
+    private read;
+    /** Returns a cached space only if it has not expired. */
+    loadFresh(topic: string, contentType: TopicContentType): Promise<TopicSpace | undefined>;
+    /** Returns a cached space even if expired (used for graceful fallback). */
+    loadAny(topic: string, contentType: TopicContentType): Promise<TopicSpace | undefined>;
+    save(space: TopicSpace): Promise<string>;
+}
+//# sourceMappingURL=TopicCache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TopicCache.d.ts","sourceRoot":"","sources":["../../src/topic/TopicCache.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE5D;;;;;;;GAOG;AACH,qBAAa,UAAU;IAEnB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG;gBADH,SAAS,EAAE,MAAM,EACjB,GAAG,GAAE,MAAM,MAAiB;IAG/C,MAAM,CAAC,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,UAAU;IAMpD,OAAO,CAAC,OAAO;YAQD,IAAI;IAYlB,yDAAyD;IACnD,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAQ9F,2EAA2E;IACrE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAItF,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;CAa/C"}

package/dist/topic/TopicCache.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TopicCache = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_crypto_1 = require("node:crypto");
+/**
+ * Durable Topic cache stored beside the SQLite database (which lives on the
+ * persistent data volume in Docker). One small JSON file per
+ * `<topic, contentType>`, written atomically. No extra database or service.
+ *
+ * Daily scheduler runs normally hit the fresh cache; only a missing/expired
+ * entry triggers discovery. A stale entry is kept and reused if refresh fails.
+ */
+class TopicCache {
+    directory;
+    now;
+    constructor(directory, now = Date.now) {
+        this.directory = directory;
+        this.now = now;
+    }
+    static forDatabase(databasePath) {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const { dirname } = require('node:path');
+        return new TopicCache((0, node_path_1.join)(dirname(databasePath), 'topic-cache'));
+    }
+    pathFor(topic, contentType) {
+        const digest = (0, node_crypto_1.createHash)('sha256')
+            .update(`${contentType}:${topic.trim().normalize('NFKC').toLocaleLowerCase()}`)
+            .digest('hex')
+            .slice(0, 16);
+        return (0, node_path_1.join)(this.directory, `topic-${digest}.json`);
+    }
+    async read(path) {
+        try {
+            const space = JSON.parse(await node_fs_1.promises.readFile(path, 'utf8'));
+            if (space.version !== 1 || !space.topic || !Array.isArray(space.tags))
+                return undefined;
+            return space;
+        }
+        catch (error) {
+            const code = error.code;
+            if (code === 'ENOENT' || error instanceof SyntaxError)
+                return undefined;
+            throw error;
+        }
+    }
+    /** Returns a cached space only if it has not expired. */
+    async loadFresh(topic, contentType) {
+        const space = await this.read(this.pathFor(topic, contentType));
+        if (!space)
+            return undefined;
+        const expires = Date.parse(space.expiresAt);
+        if (!Number.isFinite(expires) || expires <= this.now())
+            return undefined;
+        return space;
+    }
+    /** Returns a cached space even if expired (used for graceful fallback). */
+    async loadAny(topic, contentType) {
+        return this.read(this.pathFor(topic, contentType));
+    }
+    async save(space) {
+        await node_fs_1.promises.mkdir(this.directory, { recursive: true });
+        const path = this.pathFor(space.topic, space.contentType);
+        const tmp = `${path}.${process.pid}.${(0, node_crypto_1.createHash)('sha256').update(path + space.createdAt).digest('hex').slice(0, 8)}.tmp`;
+        try {
+            await node_fs_1.promises.writeFile(tmp, `${JSON.stringify(space, null, 2)}\n`, 'utf8');
+            await node_fs_1.promises.rename(tmp, path);
+        }
+        catch (error) {
+            await node_fs_1.promises.unlink(tmp).catch(() => undefined);
+            throw error;
+        }
+        return path;
+    }
+}
+exports.TopicCache = TopicCache;
+//# sourceMappingURL=TopicCache.js.map

package/dist/topic/TopicCache.js.map

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

package/dist/topic/TopicPipeline.d.ts

@@ -0,0 +1,49 @@
+import type { TargetConfig } from '../config';
+import type { TopicResolver } from './TopicResolver';
+import type { TopicCandidate, TopicClient, TopicCollectOptions, TopicContentType, TopicDiscoveryOptions, WorkLike } from './types';
+export interface TopicSelection {
+    candidates: TopicCandidate[];
+    selected: TopicCandidate[];
+    resolvedTagCount: number;
+    rawCount: number;
+    dedupedCount: number;
+    acceptedCount: number;
+}
+/**
+ * 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.
+ */
+export declare class TopicPipeline {
+    private readonly client;
+    private readonly resolver;
+    private readonly requestDelayMs;
+    constructor(client: TopicClient, resolver: TopicResolver, requestDelayMs?: number);
+    selectWorks<T extends WorkLike>(target: TargetConfig, contentType: TopicContentType, day: string, limit: number, discovery: TopicDiscoveryOptions, collect: TopicCollectOptions): Promise<{
+        works: T[];
+        selection: TopicSelection;
+    }>;
+    private searchDay;
+    private toCandidate;
+    /**
+     * 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.
+     */
+    private metadataScore;
+    /**
+     * 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.
+     */
+    private relevanceTier;
+    private rankCompare;
+    private topByPopularity;
+    private onDay;
+    private normalize;
+    private key;
+    private bound;
+}
+//# sourceMappingURL=TopicPipeline.d.ts.map

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