@aigne/afs-index 1.12.0-beta.5

package/dist/keys/registry.cjs

@@ -0,0 +1,45 @@
+const require_exact = require('./exact.cjs');
+const require_location = require('./location.cjs');
+const require_person = require('./person.cjs');
+const require_time = require('./time.cjs');
+const require_topic = require('./topic.cjs');
+
+//#region src/keys/registry.ts
+/**
+* The 4 anchor types with a built-in, multi-dimensional key generator
+* (registered in the constructor below). Manifest-declared or discovered
+* fields sharing one of these names must NOT overwrite the built-in — see
+* `KeyGeneratorRegistry.isBuiltin` and issue #934 P0 regression (a manifest
+* `fields.time` declaration silently replaced `generateTimeKeys`'s 8-dimension
+* bucketing with a flat normalizedValue generator, killing month-bucket
+* queries like `time:2026-06`).
+*/
+const BUILTIN_ANCHOR_TYPES = [
+	"time",
+	"location",
+	"person",
+	"topic"
+];
+var KeyGeneratorRegistry = class {
+	generators = /* @__PURE__ */ new Map();
+	builtins = new Set(BUILTIN_ANCHOR_TYPES);
+	constructor() {
+		this.generators.set("time", require_time.generateTimeKeys);
+		this.generators.set("location", require_location.generateLocationKeys);
+		this.generators.set("person", require_person.generatePersonKeys);
+		this.generators.set("topic", require_topic.generateTopicKeys);
+	}
+	/** True for the 4 built-in anchor types registered in the constructor. */
+	isBuiltin(type) {
+		return this.builtins.has(type);
+	}
+	register(type, generator) {
+		this.generators.set(type, generator);
+	}
+	generateKeys(anchor) {
+		return (this.generators.get(anchor.type) ?? require_exact.generateExactKeys)(anchor);
+	}
+};
+
+//#endregion
+exports.KeyGeneratorRegistry = KeyGeneratorRegistry;

package/dist/keys/registry.d.cts

@@ -0,0 +1,15 @@
+import { Anchor, KeyGenerator } from "../types.cjs";
+
+//#region src/keys/registry.d.ts
+declare class KeyGeneratorRegistry {
+  private readonly generators;
+  private readonly builtins;
+  constructor();
+  /** True for the 4 built-in anchor types registered in the constructor. */
+  isBuiltin(type: string): boolean;
+  register(type: string, generator: KeyGenerator): void;
+  generateKeys(anchor: Anchor): string[];
+}
+//#endregion
+export { KeyGeneratorRegistry };
+//# sourceMappingURL=registry.d.cts.map

package/dist/keys/registry.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.cts","names":[],"sources":["../../src/keys/registry.ts"],"mappings":";;;cAwBa,oBAAA;EAAA,iBACM,UAAA;EAAA,iBACA,QAAA;;;EAUjB,SAAA,CAAU,IAAA;EAIV,QAAA,CAAS,IAAA,UAAc,SAAA,EAAW,YAAA;EAIlC,YAAA,CAAa,MAAA,EAAQ,MAAA;AAAA"}

package/dist/keys/registry.d.mts

@@ -0,0 +1,15 @@
+import { Anchor, KeyGenerator } from "../types.mjs";
+
+//#region src/keys/registry.d.ts
+declare class KeyGeneratorRegistry {
+  private readonly generators;
+  private readonly builtins;
+  constructor();
+  /** True for the 4 built-in anchor types registered in the constructor. */
+  isBuiltin(type: string): boolean;
+  register(type: string, generator: KeyGenerator): void;
+  generateKeys(anchor: Anchor): string[];
+}
+//#endregion
+export { KeyGeneratorRegistry };
+//# sourceMappingURL=registry.d.mts.map

package/dist/keys/registry.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.mts","names":[],"sources":["../../src/keys/registry.ts"],"mappings":";;;cAwBa,oBAAA;EAAA,iBACM,UAAA;EAAA,iBACA,QAAA;;;EAUjB,SAAA,CAAU,IAAA;EAIV,QAAA,CAAS,IAAA,UAAc,SAAA,EAAW,YAAA;EAIlC,YAAA,CAAa,MAAA,EAAQ,MAAA;AAAA"}

package/dist/keys/registry.mjs

@@ -0,0 +1,46 @@
+import { generateExactKeys } from "./exact.mjs";
+import { generateLocationKeys } from "./location.mjs";
+import { generatePersonKeys } from "./person.mjs";
+import { generateTimeKeys } from "./time.mjs";
+import { generateTopicKeys } from "./topic.mjs";
+
+//#region src/keys/registry.ts
+/**
+* The 4 anchor types with a built-in, multi-dimensional key generator
+* (registered in the constructor below). Manifest-declared or discovered
+* fields sharing one of these names must NOT overwrite the built-in — see
+* `KeyGeneratorRegistry.isBuiltin` and issue #934 P0 regression (a manifest
+* `fields.time` declaration silently replaced `generateTimeKeys`'s 8-dimension
+* bucketing with a flat normalizedValue generator, killing month-bucket
+* queries like `time:2026-06`).
+*/
+const BUILTIN_ANCHOR_TYPES = [
+	"time",
+	"location",
+	"person",
+	"topic"
+];
+var KeyGeneratorRegistry = class {
+	generators = /* @__PURE__ */ new Map();
+	builtins = new Set(BUILTIN_ANCHOR_TYPES);
+	constructor() {
+		this.generators.set("time", generateTimeKeys);
+		this.generators.set("location", generateLocationKeys);
+		this.generators.set("person", generatePersonKeys);
+		this.generators.set("topic", generateTopicKeys);
+	}
+	/** True for the 4 built-in anchor types registered in the constructor. */
+	isBuiltin(type) {
+		return this.builtins.has(type);
+	}
+	register(type, generator) {
+		this.generators.set(type, generator);
+	}
+	generateKeys(anchor) {
+		return (this.generators.get(anchor.type) ?? generateExactKeys)(anchor);
+	}
+};
+
+//#endregion
+export { KeyGeneratorRegistry };
+//# sourceMappingURL=registry.mjs.map

package/dist/keys/registry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.mjs","names":[],"sources":["../../src/keys/registry.ts"],"sourcesContent":["/**\n * Key Generator Registry — maps anchor types to their key generation functions.\n *\n * Built-in generators: time, location, person, topic.\n * Unknown types fall back to exact match.\n */\nimport type { Anchor, KeyGenerator } from \"../types.js\";\nimport { generateExactKeys } from \"./exact.js\";\nimport { generateLocationKeys } from \"./location.js\";\nimport { generatePersonKeys } from \"./person.js\";\nimport { generateTimeKeys } from \"./time.js\";\nimport { generateTopicKeys } from \"./topic.js\";\n\n/**\n * The 4 anchor types with a built-in, multi-dimensional key generator\n * (registered in the constructor below). Manifest-declared or discovered\n * fields sharing one of these names must NOT overwrite the built-in — see\n * `KeyGeneratorRegistry.isBuiltin` and issue #934 P0 regression (a manifest\n * `fields.time` declaration silently replaced `generateTimeKeys`'s 8-dimension\n * bucketing with a flat normalizedValue generator, killing month-bucket\n * queries like `time:2026-06`).\n */\nexport const BUILTIN_ANCHOR_TYPES = [\"time\", \"location\", \"person\", \"topic\"] as const;\n\nexport class KeyGeneratorRegistry {\n  private readonly generators = new Map<string, KeyGenerator>();\n  private readonly builtins = new Set<string>(BUILTIN_ANCHOR_TYPES);\n\n  constructor() {\n    this.generators.set(\"time\", generateTimeKeys);\n    this.generators.set(\"location\", generateLocationKeys);\n    this.generators.set(\"person\", generatePersonKeys);\n    this.generators.set(\"topic\", generateTopicKeys);\n  }\n\n  /** True for the 4 built-in anchor types registered in the constructor. */\n  isBuiltin(type: string): boolean {\n    return this.builtins.has(type);\n  }\n\n  register(type: string, generator: KeyGenerator): void {\n    this.generators.set(type, generator);\n  }\n\n  generateKeys(anchor: Anchor): string[] {\n    const generator = this.generators.get(anchor.type) ?? generateExactKeys;\n    return generator(anchor);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAsBA,MAAa,uBAAuB;CAAC;CAAQ;CAAY;CAAU;CAAQ;AAE3E,IAAa,uBAAb,MAAkC;CAChC,AAAiB,6BAAa,IAAI,KAA2B;CAC7D,AAAiB,WAAW,IAAI,IAAY,qBAAqB;CAEjE,cAAc;AACZ,OAAK,WAAW,IAAI,QAAQ,iBAAiB;AAC7C,OAAK,WAAW,IAAI,YAAY,qBAAqB;AACrD,OAAK,WAAW,IAAI,UAAU,mBAAmB;AACjD,OAAK,WAAW,IAAI,SAAS,kBAAkB;;;CAIjD,UAAU,MAAuB;AAC/B,SAAO,KAAK,SAAS,IAAI,KAAK;;CAGhC,SAAS,MAAc,WAA+B;AACpD,OAAK,WAAW,IAAI,MAAM,UAAU;;CAGtC,aAAa,QAA0B;AAErC,UADkB,KAAK,WAAW,IAAI,OAAO,KAAK,IAAI,mBACrC,OAAO"}

package/dist/keys/time.cjs

@@ -0,0 +1,128 @@
+
+//#region src/keys/time.ts
+const WEEKDAYS = [
+	"sun",
+	"mon",
+	"tue",
+	"wed",
+	"thu",
+	"fri",
+	"sat"
+];
+const SEASONS_NORTH = {
+	1: "winter",
+	2: "winter",
+	3: "spring",
+	4: "spring",
+	5: "spring",
+	6: "summer",
+	7: "summer",
+	8: "summer",
+	9: "autumn",
+	10: "autumn",
+	11: "autumn",
+	12: "winter"
+};
+const SEASONS_SOUTH = {
+	1: "summer",
+	2: "summer",
+	3: "autumn",
+	4: "autumn",
+	5: "autumn",
+	6: "winter",
+	7: "winter",
+	8: "winter",
+	9: "spring",
+	10: "spring",
+	11: "spring",
+	12: "summer"
+};
+function getSeason(month, hemisphere) {
+	return (hemisphere === "south" ? SEASONS_SOUTH : SEASONS_NORTH)[month];
+}
+function getDaytime(hour) {
+	if (hour >= 5 && hour < 12) return "morning";
+	if (hour >= 12 && hour < 17) return "afternoon";
+	if (hour >= 17 && hour < 21) return "evening";
+	return "night";
+}
+function getISOWeek(year, month, day) {
+	const d = new Date(Date.UTC(year, month - 1, day));
+	d.setUTCDate(d.getUTCDate() + 4 - (d.getUTCDay() || 7));
+	const yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
+	return Math.ceil(((d.getTime() - yearStart.getTime()) / 864e5 + 1) / 7);
+}
+function getQuarter(month) {
+	return Math.ceil(month / 3);
+}
+/**
+* Resolve date components in the user's local timezone (if provided) or UTC.
+*
+* When a timezone is given (e.g., "Asia/Shanghai"), the date, weekday, hour
+* are computed in that timezone. This matters because "2026-03-10T01:00:00+08:00"
+* is March 10 locally but March 9 in UTC — the date, weekday, and daytime
+* would all be wrong without timezone awareness.
+*/
+function resolveComponents(date, timezone) {
+	if (timezone) {
+		const fmt = new Intl.DateTimeFormat("en-US", {
+			timeZone: timezone,
+			year: "numeric",
+			month: "2-digit",
+			day: "2-digit",
+			weekday: "short",
+			hour: "2-digit",
+			hour12: false
+		});
+		const parts = Object.fromEntries(fmt.formatToParts(date).map((p) => [p.type, p.value]));
+		return {
+			year: Number(parts.year),
+			month: Number(parts.month),
+			day: Number(parts.day),
+			weekday: [
+				"sun",
+				"mon",
+				"tue",
+				"wed",
+				"thu",
+				"fri",
+				"sat"
+			][new Date(Date.UTC(Number(parts.year), Number(parts.month) - 1, Number(parts.day))).getUTCDay()],
+			hour: Number(parts.hour)
+		};
+	}
+	return {
+		year: date.getUTCFullYear(),
+		month: date.getUTCMonth() + 1,
+		day: date.getUTCDate(),
+		weekday: WEEKDAYS[date.getUTCDay()],
+		hour: date.getUTCHours()
+	};
+}
+function generateTimeKeys(anchor, include) {
+	const timestamp = anchor.timestamp;
+	if (!timestamp) return [];
+	const date = new Date(timestamp);
+	if (Number.isNaN(date.getTime())) return [];
+	const timezone = anchor.timezone;
+	const hemisphere = anchor.hemisphere;
+	const { year, month, day, weekday, hour } = resolveComponents(date, timezone);
+	const week = getISOWeek(year, month, day);
+	const quarter = getQuarter(month);
+	const season = getSeason(month, hemisphere);
+	const candidates = [
+		["year", `time:${year}`],
+		["month", `time:${year}-${String(month).padStart(2, "0")}`],
+		["day", `time:${year}-${String(month).padStart(2, "0")}-${String(day).padStart(2, "0")}`],
+		["quarter", `time:${year}-Q${quarter}`],
+		["week", `time:${year}-W${week}`],
+		["season", `time:${year}-${season}`],
+		["weekday", `time:weekday:${weekday}`]
+	];
+	if (timestamp.includes("T")) candidates.push(["daytime", `time:daytime:${getDaytime(hour)}`]);
+	if (!include) return candidates.map(([, key]) => key);
+	return candidates.filter(([g]) => include.has(g)).map(([, key]) => key);
+}
+
+//#endregion
+exports.generateTimeKeys = generateTimeKeys;

package/dist/keys/time.mjs

@@ -0,0 +1,128 @@
+//#region src/keys/time.ts
+const WEEKDAYS = [
+	"sun",
+	"mon",
+	"tue",
+	"wed",
+	"thu",
+	"fri",
+	"sat"
+];
+const SEASONS_NORTH = {
+	1: "winter",
+	2: "winter",
+	3: "spring",
+	4: "spring",
+	5: "spring",
+	6: "summer",
+	7: "summer",
+	8: "summer",
+	9: "autumn",
+	10: "autumn",
+	11: "autumn",
+	12: "winter"
+};
+const SEASONS_SOUTH = {
+	1: "summer",
+	2: "summer",
+	3: "autumn",
+	4: "autumn",
+	5: "autumn",
+	6: "winter",
+	7: "winter",
+	8: "winter",
+	9: "spring",
+	10: "spring",
+	11: "spring",
+	12: "summer"
+};
+function getSeason(month, hemisphere) {
+	return (hemisphere === "south" ? SEASONS_SOUTH : SEASONS_NORTH)[month];
+}
+function getDaytime(hour) {
+	if (hour >= 5 && hour < 12) return "morning";
+	if (hour >= 12 && hour < 17) return "afternoon";
+	if (hour >= 17 && hour < 21) return "evening";
+	return "night";
+}
+function getISOWeek(year, month, day) {
+	const d = new Date(Date.UTC(year, month - 1, day));
+	d.setUTCDate(d.getUTCDate() + 4 - (d.getUTCDay() || 7));
+	const yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
+	return Math.ceil(((d.getTime() - yearStart.getTime()) / 864e5 + 1) / 7);
+}
+function getQuarter(month) {
+	return Math.ceil(month / 3);
+}
+/**
+* Resolve date components in the user's local timezone (if provided) or UTC.
+*
+* When a timezone is given (e.g., "Asia/Shanghai"), the date, weekday, hour
+* are computed in that timezone. This matters because "2026-03-10T01:00:00+08:00"
+* is March 10 locally but March 9 in UTC — the date, weekday, and daytime
+* would all be wrong without timezone awareness.
+*/
+function resolveComponents(date, timezone) {
+	if (timezone) {
+		const fmt = new Intl.DateTimeFormat("en-US", {
+			timeZone: timezone,
+			year: "numeric",
+			month: "2-digit",
+			day: "2-digit",
+			weekday: "short",
+			hour: "2-digit",
+			hour12: false
+		});
+		const parts = Object.fromEntries(fmt.formatToParts(date).map((p) => [p.type, p.value]));
+		return {
+			year: Number(parts.year),
+			month: Number(parts.month),
+			day: Number(parts.day),
+			weekday: [
+				"sun",
+				"mon",
+				"tue",
+				"wed",
+				"thu",
+				"fri",
+				"sat"
+			][new Date(Date.UTC(Number(parts.year), Number(parts.month) - 1, Number(parts.day))).getUTCDay()],
+			hour: Number(parts.hour)
+		};
+	}
+	return {
+		year: date.getUTCFullYear(),
+		month: date.getUTCMonth() + 1,
+		day: date.getUTCDate(),
+		weekday: WEEKDAYS[date.getUTCDay()],
+		hour: date.getUTCHours()
+	};
+}
+function generateTimeKeys(anchor, include) {
+	const timestamp = anchor.timestamp;
+	if (!timestamp) return [];
+	const date = new Date(timestamp);
+	if (Number.isNaN(date.getTime())) return [];
+	const timezone = anchor.timezone;
+	const hemisphere = anchor.hemisphere;
+	const { year, month, day, weekday, hour } = resolveComponents(date, timezone);
+	const week = getISOWeek(year, month, day);
+	const quarter = getQuarter(month);
+	const season = getSeason(month, hemisphere);
+	const candidates = [
+		["year", `time:${year}`],
+		["month", `time:${year}-${String(month).padStart(2, "0")}`],
+		["day", `time:${year}-${String(month).padStart(2, "0")}-${String(day).padStart(2, "0")}`],
+		["quarter", `time:${year}-Q${quarter}`],
+		["week", `time:${year}-W${week}`],
+		["season", `time:${year}-${season}`],
+		["weekday", `time:weekday:${weekday}`]
+	];
+	if (timestamp.includes("T")) candidates.push(["daytime", `time:daytime:${getDaytime(hour)}`]);
+	if (!include) return candidates.map(([, key]) => key);
+	return candidates.filter(([g]) => include.has(g)).map(([, key]) => key);
+}
+
+//#endregion
+export { generateTimeKeys };
+//# sourceMappingURL=time.mjs.map

package/dist/keys/time.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.mjs","names":[],"sources":["../../src/keys/time.ts"],"sourcesContent":["/**\n * Time key generator — expands a timestamp into multi-dimensional index keys.\n *\n * Generates up to 8 keys covering: year, month, day, quarter, ISO week,\n * season, weekday, and daytime period.\n */\nimport type { Anchor, TimeKeyGranularity } from \"../types.js\";\n\nconst WEEKDAYS = [\"sun\", \"mon\", \"tue\", \"wed\", \"thu\", \"fri\", \"sat\"] as const;\n\nconst SEASONS_NORTH: Record<number, string> = {\n  1: \"winter\",\n  2: \"winter\",\n  3: \"spring\",\n  4: \"spring\",\n  5: \"spring\",\n  6: \"summer\",\n  7: \"summer\",\n  8: \"summer\",\n  9: \"autumn\",\n  10: \"autumn\",\n  11: \"autumn\",\n  12: \"winter\",\n};\n\nconst SEASONS_SOUTH: Record<number, string> = {\n  1: \"summer\",\n  2: \"summer\",\n  3: \"autumn\",\n  4: \"autumn\",\n  5: \"autumn\",\n  6: \"winter\",\n  7: \"winter\",\n  8: \"winter\",\n  9: \"spring\",\n  10: \"spring\",\n  11: \"spring\",\n  12: \"summer\",\n};\n\nfunction getSeason(month: number, hemisphere?: string): string {\n  const table = hemisphere === \"south\" ? SEASONS_SOUTH : SEASONS_NORTH;\n  return table[month]!;\n}\n\nfunction getDaytime(hour: number): string {\n  if (hour >= 5 && hour < 12) return \"morning\";\n  if (hour >= 12 && hour < 17) return \"afternoon\";\n  if (hour >= 17 && hour < 21) return \"evening\";\n  return \"night\";\n}\n\nfunction getISOWeek(year: number, month: number, day: number): number {\n  const d = new Date(Date.UTC(year, month - 1, day));\n  d.setUTCDate(d.getUTCDate() + 4 - (d.getUTCDay() || 7));\n  const yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));\n  return Math.ceil(((d.getTime() - yearStart.getTime()) / 86400000 + 1) / 7);\n}\n\nfunction getQuarter(month: number): number {\n  return Math.ceil(month / 3);\n}\n\n/**\n * Resolve date components in the user's local timezone (if provided) or UTC.\n *\n * When a timezone is given (e.g., \"Asia/Shanghai\"), the date, weekday, hour\n * are computed in that timezone. This matters because \"2026-03-10T01:00:00+08:00\"\n * is March 10 locally but March 9 in UTC — the date, weekday, and daytime\n * would all be wrong without timezone awareness.\n */\nfunction resolveComponents(date: Date, timezone?: string) {\n  if (timezone) {\n    // Use Intl.DateTimeFormat to extract local components\n    const fmt = new Intl.DateTimeFormat(\"en-US\", {\n      timeZone: timezone,\n      year: \"numeric\",\n      month: \"2-digit\",\n      day: \"2-digit\",\n      weekday: \"short\",\n      hour: \"2-digit\",\n      hour12: false,\n    });\n    const parts = Object.fromEntries(fmt.formatToParts(date).map((p) => [p.type, p.value]));\n    return {\n      year: Number(parts.year),\n      month: Number(parts.month),\n      day: Number(parts.day),\n      weekday: ([\"sun\", \"mon\", \"tue\", \"wed\", \"thu\", \"fri\", \"sat\"] as const)[\n        new Date(\n          Date.UTC(Number(parts.year), Number(parts.month) - 1, Number(parts.day)),\n        ).getUTCDay()\n      ]!,\n      hour: Number(parts.hour),\n    };\n  }\n  return {\n    year: date.getUTCFullYear(),\n    month: date.getUTCMonth() + 1,\n    day: date.getUTCDate(),\n    weekday: WEEKDAYS[date.getUTCDay()]!,\n    hour: date.getUTCHours(),\n  };\n}\n\nexport function generateTimeKeys(anchor: Anchor, include?: Set<TimeKeyGranularity>): string[] {\n  const timestamp = anchor.timestamp as string | undefined;\n  if (!timestamp) return [];\n\n  const date = new Date(timestamp);\n  if (Number.isNaN(date.getTime())) return [];\n\n  const timezone = anchor.timezone as string | undefined;\n  const hemisphere = anchor.hemisphere as string | undefined;\n  const { year, month, day, weekday, hour } = resolveComponents(date, timezone);\n  const week = getISOWeek(year, month, day);\n  const quarter = getQuarter(month);\n  const season = getSeason(month, hemisphere);\n\n  const candidates: Array<[TimeKeyGranularity, string]> = [\n    [\"year\", `time:${year}`],\n    [\"month\", `time:${year}-${String(month).padStart(2, \"0\")}`],\n    [\"day\", `time:${year}-${String(month).padStart(2, \"0\")}-${String(day).padStart(2, \"0\")}`],\n    [\"quarter\", `time:${year}-Q${quarter}`],\n    [\"week\", `time:${year}-W${week}`],\n    [\"season\", `time:${year}-${season}`],\n    [\"weekday\", `time:weekday:${weekday}`],\n  ];\n\n  // Only add daytime if timestamp includes time component (contains 'T')\n  const hasTime = timestamp.includes(\"T\");\n  if (hasTime) {\n    candidates.push([\"daytime\", `time:daytime:${getDaytime(hour)}`]);\n  }\n\n  if (!include) return candidates.map(([, key]) => key);\n  return candidates.filter(([g]) => include.has(g)).map(([, key]) => key);\n}\n"],"mappings":"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"}

package/dist/keys/topic.cjs

@@ -0,0 +1,23 @@
+
+//#region src/keys/topic.ts
+function generateTopicKeys(anchor) {
+	const keys = [];
+	const seen = /* @__PURE__ */ new Set();
+	const push = (raw) => {
+		if (typeof raw !== "string") return;
+		const topic = raw.trim().toLowerCase();
+		if (!topic || seen.has(topic)) return;
+		seen.add(topic);
+		keys.push(`topic:${topic}`);
+	};
+	const arr = anchor.values;
+	if (Array.isArray(arr)) {
+		for (const v of arr) if (typeof v === "string") for (const seg of v.split(",")) push(seg);
+	}
+	const single = anchor.value;
+	if (typeof single === "string") for (const seg of single.split(",")) push(seg);
+	return keys;
+}
+
+//#endregion
+exports.generateTopicKeys = generateTopicKeys;

package/dist/keys/topic.mjs

@@ -0,0 +1,23 @@
+//#region src/keys/topic.ts
+function generateTopicKeys(anchor) {
+	const keys = [];
+	const seen = /* @__PURE__ */ new Set();
+	const push = (raw) => {
+		if (typeof raw !== "string") return;
+		const topic = raw.trim().toLowerCase();
+		if (!topic || seen.has(topic)) return;
+		seen.add(topic);
+		keys.push(`topic:${topic}`);
+	};
+	const arr = anchor.values;
+	if (Array.isArray(arr)) {
+		for (const v of arr) if (typeof v === "string") for (const seg of v.split(",")) push(seg);
+	}
+	const single = anchor.value;
+	if (typeof single === "string") for (const seg of single.split(",")) push(seg);
+	return keys;
+}
+
+//#endregion
+export { generateTopicKeys };
+//# sourceMappingURL=topic.mjs.map

package/dist/keys/topic.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"topic.mjs","names":[],"sources":["../../src/keys/topic.ts"],"sourcesContent":["/**\n * Topic key generator — generates normalized keys for topic anchors.\n *\n * Two input shapes coexist (query-side and indexer side both treat\n * topics as multi-valued):\n *\n *   - `value: \"fundraising,investment\"` (legacy single-string with\n *     comma-separated values).\n *   - `values: [\"fundraising\", \"investment\"]` (canonical array; what\n *     `queryAnchors` already expects on the matching side).\n *\n * Without supporting `values`, every topic anchor written via the\n * standard `{ type: \"topic\", values: [...] }` shape produced ZERO\n * `idx_anchor_key` rows — `idx_anchor_data` had the raw blob but the lookup\n * table was empty, so `queryAnchors` never matched anything. The\n * retrieval bench surfaced this as a silent gap.\n */\nimport type { Anchor } from \"../types.js\";\n\nexport function generateTopicKeys(anchor: Anchor): string[] {\n  const keys: string[] = [];\n  const seen = new Set<string>();\n\n  const push = (raw: unknown): void => {\n    if (typeof raw !== \"string\") return;\n    const topic = raw.trim().toLowerCase();\n    if (!topic || seen.has(topic)) return;\n    seen.add(topic);\n    keys.push(`topic:${topic}`);\n  };\n\n  // Canonical array shape — preferred. Each element may itself be a\n  // comma list for back-compat, so split before pushing.\n  const arr = anchor.values as unknown;\n  if (Array.isArray(arr)) {\n    for (const v of arr) {\n      if (typeof v === \"string\") {\n        for (const seg of v.split(\",\")) push(seg);\n      }\n    }\n  }\n\n  // Legacy single-string shape — `value: \"a,b\"`.\n  const single = anchor.value;\n  if (typeof single === \"string\") {\n    for (const seg of single.split(\",\")) push(seg);\n  }\n\n  return keys;\n}\n"],"mappings":";AAmBA,SAAgB,kBAAkB,QAA0B;CAC1D,MAAM,OAAiB,EAAE;CACzB,MAAM,uBAAO,IAAI,KAAa;CAE9B,MAAM,QAAQ,QAAuB;AACnC,MAAI,OAAO,QAAQ,SAAU;EAC7B,MAAM,QAAQ,IAAI,MAAM,CAAC,aAAa;AACtC,MAAI,CAAC,SAAS,KAAK,IAAI,MAAM,CAAE;AAC/B,OAAK,IAAI,MAAM;AACf,OAAK,KAAK,SAAS,QAAQ;;CAK7B,MAAM,MAAM,OAAO;AACnB,KAAI,MAAM,QAAQ,IAAI,EACpB;OAAK,MAAM,KAAK,IACd,KAAI,OAAO,MAAM,SACf,MAAK,MAAM,OAAO,EAAE,MAAM,IAAI,CAAE,MAAK,IAAI;;CAM/C,MAAM,SAAS,OAAO;AACtB,KAAI,OAAO,WAAW,SACpB,MAAK,MAAM,OAAO,OAAO,MAAM,IAAI,CAAE,MAAK,IAAI;AAGhD,QAAO"}

package/dist/manifest-index.cjs

@@ -0,0 +1,29 @@
+
+//#region src/manifest-index.ts
+/**
+* Project a single manifest domain declaration to a DomainRegistration.
+* Does NOT write any files — returns plain data structures for the caller to use.
+*/
+function projectDomain(domain) {
+	const anchorTypes = [];
+	if (domain.fields) for (const fieldName of Object.keys(domain.fields)) anchorTypes.push({ name: fieldName });
+	const config = { ...domain.indexable ? { indexable: domain.indexable } : {} };
+	return {
+		name: domain.name,
+		...domain.scope ? { scope: domain.scope } : {},
+		config,
+		anchorTypes
+	};
+}
+/**
+* Project all domains in a `BlockletIndex` declaration.
+* Returns one `DomainRegistration` per domain, ready to be passed to
+* `register-domain` exec actions on the index provider.
+*/
+function projectManifestIndex(index) {
+	return index.domains.map(projectDomain);
+}
+
+//#endregion
+exports.projectDomain = projectDomain;
+exports.projectManifestIndex = projectManifestIndex;

package/dist/manifest-index.d.cts

@@ -0,0 +1,24 @@
+import { AnchorTypeDefinition, IndexConfig } from "./types.cjs";
+import { BlockletIndex, BlockletIndexDomain } from "@aigne/afs";
+
+//#region src/manifest-index.d.ts
+interface DomainRegistration {
+  name: string;
+  scope?: string;
+  config: IndexConfig;
+  anchorTypes: AnchorTypeDefinition[];
+}
+/**
+ * Project a single manifest domain declaration to a DomainRegistration.
+ * Does NOT write any files — returns plain data structures for the caller to use.
+ */
+declare function projectDomain(domain: BlockletIndexDomain): DomainRegistration;
+/**
+ * Project all domains in a `BlockletIndex` declaration.
+ * Returns one `DomainRegistration` per domain, ready to be passed to
+ * `register-domain` exec actions on the index provider.
+ */
+declare function projectManifestIndex(index: BlockletIndex): DomainRegistration[];
+//#endregion
+export { DomainRegistration, projectDomain, projectManifestIndex };
+//# sourceMappingURL=manifest-index.d.cts.map

package/dist/manifest-index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-index.d.cts","names":[],"sources":["../src/manifest-index.ts"],"mappings":";;;;UAgBiB,kBAAA;EACf,IAAA;EACA,KAAA;EACA,MAAA,EAAQ,WAAA;EACR,WAAA,EAAa,oBAAA;AAAA;;;;;iBAOC,aAAA,CAAc,MAAA,EAAQ,mBAAA,GAAsB,kBAAA;;;;;;iBA0B5C,oBAAA,CAAqB,KAAA,EAAO,aAAA,GAAgB,kBAAA"}

package/dist/manifest-index.d.mts

@@ -0,0 +1,24 @@
+import { AnchorTypeDefinition, IndexConfig } from "./types.mjs";
+import { BlockletIndex, BlockletIndexDomain } from "@aigne/afs";
+
+//#region src/manifest-index.d.ts
+interface DomainRegistration {
+  name: string;
+  scope?: string;
+  config: IndexConfig;
+  anchorTypes: AnchorTypeDefinition[];
+}
+/**
+ * Project a single manifest domain declaration to a DomainRegistration.
+ * Does NOT write any files — returns plain data structures for the caller to use.
+ */
+declare function projectDomain(domain: BlockletIndexDomain): DomainRegistration;
+/**
+ * Project all domains in a `BlockletIndex` declaration.
+ * Returns one `DomainRegistration` per domain, ready to be passed to
+ * `register-domain` exec actions on the index provider.
+ */
+declare function projectManifestIndex(index: BlockletIndex): DomainRegistration[];
+//#endregion
+export { DomainRegistration, projectDomain, projectManifestIndex };
+//# sourceMappingURL=manifest-index.d.mts.map

package/dist/manifest-index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-index.d.mts","names":[],"sources":["../src/manifest-index.ts"],"mappings":";;;;UAgBiB,kBAAA;EACf,IAAA;EACA,KAAA;EACA,MAAA,EAAQ,WAAA;EACR,WAAA,EAAa,oBAAA;AAAA;;;;;iBAOC,aAAA,CAAc,MAAA,EAAQ,mBAAA,GAAsB,kBAAA;;;;;;iBA0B5C,oBAAA,CAAqB,KAAA,EAAO,aAAA,GAAgB,kBAAA"}

package/dist/manifest-index.mjs

@@ -0,0 +1,28 @@
+//#region src/manifest-index.ts
+/**
+* Project a single manifest domain declaration to a DomainRegistration.
+* Does NOT write any files — returns plain data structures for the caller to use.
+*/
+function projectDomain(domain) {
+	const anchorTypes = [];
+	if (domain.fields) for (const fieldName of Object.keys(domain.fields)) anchorTypes.push({ name: fieldName });
+	const config = { ...domain.indexable ? { indexable: domain.indexable } : {} };
+	return {
+		name: domain.name,
+		...domain.scope ? { scope: domain.scope } : {},
+		config,
+		anchorTypes
+	};
+}
+/**
+* Project all domains in a `BlockletIndex` declaration.
+* Returns one `DomainRegistration` per domain, ready to be passed to
+* `register-domain` exec actions on the index provider.
+*/
+function projectManifestIndex(index) {
+	return index.domains.map(projectDomain);
+}
+
+//#endregion
+export { projectDomain, projectManifestIndex };
+//# sourceMappingURL=manifest-index.mjs.map

package/dist/manifest-index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-index.mjs","names":[],"sources":["../src/manifest-index.ts"],"sourcesContent":["/**\n * manifest-index.ts — bridge between blocklet.yaml `index:` declarations and\n * the AFSIndex register-domain action.\n *\n * Given a parsed `BlockletIndex` (from parseBlockletManifest), this module\n * produces the `register-domain` call arguments for each declared domain so\n * that the CF/Node session-view wiring code can register them at startup.\n *\n * Each field entry in the manifest becomes an AnchorTypeDefinition with the\n * default `normalizedValue` key generator (the index provider wires this\n * automatically for types without an explicit keyGenerator — see discoverProvider\n * wiring in index-provider.ts:1117-1124).\n */\nimport type { BlockletIndex, BlockletIndexDomain } from \"@aigne/afs\";\nimport type { AnchorTypeDefinition, IndexConfig } from \"./types.js\";\n\nexport interface DomainRegistration {\n  name: string;\n  scope?: string;\n  config: IndexConfig;\n  anchorTypes: AnchorTypeDefinition[];\n}\n\n/**\n * Project a single manifest domain declaration to a DomainRegistration.\n * Does NOT write any files — returns plain data structures for the caller to use.\n */\nexport function projectDomain(domain: BlockletIndexDomain): DomainRegistration {\n  const anchorTypes: AnchorTypeDefinition[] = [];\n\n  if (domain.fields) {\n    for (const fieldName of Object.keys(domain.fields)) {\n      anchorTypes.push({ name: fieldName });\n    }\n  }\n\n  const config: IndexConfig = {\n    ...(domain.indexable ? { indexable: domain.indexable } : {}),\n  };\n\n  return {\n    name: domain.name,\n    ...(domain.scope ? { scope: domain.scope } : {}),\n    config,\n    anchorTypes,\n  };\n}\n\n/**\n * Project all domains in a `BlockletIndex` declaration.\n * Returns one `DomainRegistration` per domain, ready to be passed to\n * `register-domain` exec actions on the index provider.\n */\nexport function projectManifestIndex(index: BlockletIndex): DomainRegistration[] {\n  return index.domains.map(projectDomain);\n}\n"],"mappings":";;;;;AA2BA,SAAgB,cAAc,QAAiD;CAC7E,MAAM,cAAsC,EAAE;AAE9C,KAAI,OAAO,OACT,MAAK,MAAM,aAAa,OAAO,KAAK,OAAO,OAAO,CAChD,aAAY,KAAK,EAAE,MAAM,WAAW,CAAC;CAIzC,MAAM,SAAsB,EAC1B,GAAI,OAAO,YAAY,EAAE,WAAW,OAAO,WAAW,GAAG,EAAE,EAC5D;AAED,QAAO;EACL,MAAM,OAAO;EACb,GAAI,OAAO,QAAQ,EAAE,OAAO,OAAO,OAAO,GAAG,EAAE;EAC/C;EACA;EACD;;;;;;;AAQH,SAAgB,qBAAqB,OAA4C;AAC/E,QAAO,MAAM,QAAQ,IAAI,cAAc"}

package/dist/offline-rebuild.cjs

@@ -0,0 +1,48 @@
+const require_time = require('./keys/time.cjs');
+const require_registry = require('./keys/registry.cjs');
+const require_follower = require('./follower.cjs');
+
+//#region src/offline-rebuild.ts
+async function offlineRebuildScope(opts) {
+	const { backend, spaceAfs, domains, livePaths, timeKeyGranularity } = opts;
+	if (timeKeyGranularity?.length && backend.setKeyRegistry) {
+		const registry = new require_registry.KeyGeneratorRegistry();
+		const include = new Set(timeKeyGranularity);
+		registry.register("time", (anchor) => require_time.generateTimeKeys(anchor, include));
+		backend.setKeyRegistry(registry);
+	}
+	let cleared = 0;
+	const boundDomains = domains.map((d) => d.name);
+	const existing = backend.listEntries ? await backend.listEntries({ boundDomains }) : [];
+	if (existing.length > 0 && backend.purgeEntries) {
+		opts.onProgress?.({
+			phase: "clear",
+			done: 0,
+			total: existing.length
+		});
+		cleared = await backend.purgeEntries(existing.map((e) => e.entryPath), { skipVector: true });
+		opts.onProgress?.({
+			phase: "clear",
+			done: cleared,
+			total: existing.length
+		});
+	}
+	const { indexed, failed, skipped } = await new require_follower.IndexFollower({
+		spaceAfs,
+		backend,
+		domains
+	}).reindexPaths(livePaths, (done, total) => opts.onProgress?.({
+		phase: "rebuild",
+		done,
+		total
+	}));
+	return {
+		cleared,
+		indexed,
+		failed,
+		skipped
+	};
+}
+
+//#endregion
+exports.offlineRebuildScope = offlineRebuildScope;