@mulmoclaude/core 0.8.1 → 0.8.2

package/dist/{ingestTypes-BtMZogMX.js.map → ingestTypes-CmJeOUJc.js.map}

@@ -1 +1 @@
-{"version":3,"file":"ingestTypes-BtMZogMX.js","names":[],"sources":["../src/feeds/ingestTypes.ts"],"sourcesContent":["// Declarative retrieval config for the \"Feeds\" mechanism. A Feed is a\n// CollectionSchema plus this `ingest` block, registered as data (NOT as\n// a skill) under `<workspace>/feeds/<slug>/schema.json`. The host's\n// retrieval engine reads it to periodically refill the collection's\n// records via the shared collections io layer.\n//\n// The ingest vocab (INGEST_KINDS / FEED_SCHEDULES + their literal-union types)\n// lives in the sibling `../collection` subpath alongside the schema contract, so\n// the package's schema validator can enforce it. Re-exported here so the feeds\n// engine's existing importers resolve them unchanged.\nimport { type CollectionIngest, INGEST_KINDS, FEED_SCHEDULES, type IngestKind, type FeedSchedule } from \"../collection/index.js\";\n//\n// Two flavours: the declarative kinds (`rss`/`atom`/`http-json`) fetch-and-map,\n// and `agent` dispatches a hidden worker. The `code` kind (LLM-generated\n// deterministic transform) is still reserved for a future retriever.\n\n// The agent ingest kind. Defined HERE (not imported from `../collection`) on\n// purpose: the engine only needs the literal to branch, and re-importing it as a\n// VALUE keeps this module free of a value dependency on the collection vocab.\n// Core owns its own copy for the schema validator; this matches the same literal.\nexport const AGENT_INGEST_KIND = \"agent\" as const;\nexport type AgentIngestKind = typeof AGENT_INGEST_KIND;\n\nexport { INGEST_KINDS, FEED_SCHEDULES, type IngestKind, type FeedSchedule };\n\nconst FEED_SCHEDULE_SET: ReadonlySet<string> = new Set(FEED_SCHEDULES);\n\nexport function isFeedSchedule(value: unknown): value is FeedSchedule {\n  return typeof value === \"string\" && FEED_SCHEDULE_SET.has(value);\n}\n\n/** Default cap on stored records per feed when `ingest.maxItems` is\n *  omitted. Keeps high-volume feeds (news / podcasts) bounded. */\nexport const DEFAULT_FEED_MAX_ITEMS = 100;\n\n/** Declarative field map: target collection field name → source path\n *  into the raw item (dot/bracket path, e.g. `\"title\"` or\n *  `\"data.name\"`). */\nexport type IngestFieldMap = Record<string, string>;\n\n/** Declarative retrieval (`rss`/`atom`/`http-json`): the host fetches `url`\n *  and projects each item through `map`. The canonical schema (in\n *  `../collection`) only promises the minimal `CollectionIngest`; this\n *  feeds-only subtype narrows those + adds the retrieval fields the engine\n *  needs. */\nexport interface DeclarativeIngestSpec extends CollectionIngest {\n  /** Which declarative retriever handles this feed. */\n  kind: IngestKind;\n  /** Endpoint to fetch (http/https). */\n  url: string;\n  /** Refresh cadence. */\n  schedule: FeedSchedule;\n  /** `http-json` only: dot/bracket path to the array of items in the\n   *  response (e.g. `\"hourly[]\"` or `\"data.results[]\"`). Ignored for\n   *  `rss`/`atom`, which yield items natively. */\n  itemsAt?: string;\n  /** target field → source path. Projects each raw item into a record\n   *  whose keys match the schema's `fields`. */\n  map: IngestFieldMap;\n  /** Optional source path used to derive the primaryKey value when the\n   *  mapped record's primaryKey is empty (e.g. `\"feedId\"`). Falls back\n   *  to a content hash of the record. */\n  idFrom?: string;\n  /** Cap on stored records. After each fetch the feed keeps only the\n   *  newest `maxItems` (ordered by the schema's first `date` field) and\n   *  deletes the rest. Defaults to {@link DEFAULT_FEED_MAX_ITEMS} when\n   *  omitted; `0` disables the cap (keep everything). Pruning is skipped\n   *  when the schema has no `date` field to order by. */\n  maxItems?: number;\n}\n\n/** Agent-performed retrieval (`kind: \"agent\"`). No `url`/`map`: the host seeds\n *  a hidden background worker (origin `system`) in `role` with `template` + a\n *  summary of every record, and the worker edits the records itself via the\n *  collections io layer. Valid on any collection (primarily skill-backed). */\nexport interface AgentIngestSpec extends CollectionIngest {\n  kind: AgentIngestKind;\n  /** Refresh cadence (same vocabulary as declarative feeds). */\n  schedule: FeedSchedule;\n  /** Role id the scheduled hidden worker runs in. */\n  role: string;\n  /** Skill-relative template path (under `templates/`) seeding the worker. */\n  template: string;\n}\n\n/** The `ingest` block carried on a `CollectionSchema`, discriminated on `kind`. */\nexport type IngestSpec = DeclarativeIngestSpec | AgentIngestSpec;\n"],"mappings":";;;AAoBA,IAAa,oBAAoB;AAKjC,IAAM,oBAAyC,IAAI,IAAI,cAAc;AAErE,SAAgB,eAAe,OAAuC;CACpE,OAAO,OAAO,UAAU,YAAY,kBAAkB,IAAI,KAAK;AACjE;;;AAIA,IAAa,yBAAyB"}
+{"version":3,"file":"ingestTypes-CmJeOUJc.js","names":[],"sources":["../src/feeds/ingestTypes.ts"],"sourcesContent":["// Declarative retrieval config for the \"Feeds\" mechanism. A Feed is a\n// CollectionSchema plus this `ingest` block, registered as data (NOT as\n// a skill) under `<workspace>/feeds/<slug>/schema.json`. The host's\n// retrieval engine reads it to periodically refill the collection's\n// records via the shared collections io layer.\n//\n// The ingest vocab (INGEST_KINDS / FEED_SCHEDULES + their literal-union types)\n// lives in the sibling `../collection` subpath alongside the schema contract, so\n// the package's schema validator can enforce it. Re-exported here so the feeds\n// engine's existing importers resolve them unchanged.\nimport { type CollectionIngest, INGEST_KINDS, FEED_SCHEDULES, type IngestKind, type FeedSchedule } from \"../collection/index.js\";\n//\n// Two flavours: the declarative kinds (`rss`/`atom`/`http-json`) fetch-and-map,\n// and `agent` dispatches a hidden worker. The `code` kind (LLM-generated\n// deterministic transform) is still reserved for a future retriever.\n\n// The agent ingest kind. Defined HERE (not imported from `../collection`) on\n// purpose: the engine only needs the literal to branch, and re-importing it as a\n// VALUE keeps this module free of a value dependency on the collection vocab.\n// Core owns its own copy for the schema validator; this matches the same literal.\nexport const AGENT_INGEST_KIND = \"agent\" as const;\nexport type AgentIngestKind = typeof AGENT_INGEST_KIND;\n\nexport { INGEST_KINDS, FEED_SCHEDULES, type IngestKind, type FeedSchedule };\n\nconst FEED_SCHEDULE_SET: ReadonlySet<string> = new Set(FEED_SCHEDULES);\n\nexport function isFeedSchedule(value: unknown): value is FeedSchedule {\n  return typeof value === \"string\" && FEED_SCHEDULE_SET.has(value);\n}\n\n/** Default cap on stored records per feed when `ingest.maxItems` is\n *  omitted. Keeps high-volume feeds (news / podcasts) bounded. */\nexport const DEFAULT_FEED_MAX_ITEMS = 100;\n\n/** Declarative field map: target collection field name → source path\n *  into the raw item (dot/bracket path, e.g. `\"title\"` or\n *  `\"data.name\"`). */\nexport type IngestFieldMap = Record<string, string>;\n\n/** Declarative retrieval (`rss`/`atom`/`http-json`): the host fetches `url`\n *  and projects each item through `map`. The canonical schema (in\n *  `../collection`) only promises the minimal `CollectionIngest`; this\n *  feeds-only subtype narrows those + adds the retrieval fields the engine\n *  needs. */\nexport interface DeclarativeIngestSpec extends CollectionIngest {\n  /** Which declarative retriever handles this feed. */\n  kind: IngestKind;\n  /** Endpoint to fetch (http/https). */\n  url: string;\n  /** Refresh cadence. */\n  schedule: FeedSchedule;\n  /** `http-json` only: dot/bracket path to the array of items in the\n   *  response (e.g. `\"hourly[]\"` or `\"data.results[]\"`). Ignored for\n   *  `rss`/`atom`, which yield items natively. */\n  itemsAt?: string;\n  /** target field → source path. Projects each raw item into a record\n   *  whose keys match the schema's `fields`. */\n  map: IngestFieldMap;\n  /** Optional source path used to derive the primaryKey value when the\n   *  mapped record's primaryKey is empty (e.g. `\"feedId\"`). Falls back\n   *  to a content hash of the record. */\n  idFrom?: string;\n  /** Cap on stored records. After each fetch the feed keeps only the\n   *  newest `maxItems` (ordered by the schema's first `date` field) and\n   *  deletes the rest. Defaults to {@link DEFAULT_FEED_MAX_ITEMS} when\n   *  omitted; `0` disables the cap (keep everything). Pruning is skipped\n   *  when the schema has no `date` field to order by. */\n  maxItems?: number;\n}\n\n/** Agent-performed retrieval (`kind: \"agent\"`). No `url`/`map`: the host seeds\n *  a hidden background worker (origin `system`) in `role` with `template` + a\n *  summary of every record, and the worker edits the records itself via the\n *  collections io layer. Valid on any collection (primarily skill-backed). */\nexport interface AgentIngestSpec extends CollectionIngest {\n  kind: AgentIngestKind;\n  /** Refresh cadence (same vocabulary as declarative feeds). */\n  schedule: FeedSchedule;\n  /** Role id the scheduled hidden worker runs in. */\n  role: string;\n  /** Skill-relative template path (under `templates/`) seeding the worker. */\n  template: string;\n}\n\n/** The `ingest` block carried on a `CollectionSchema`, discriminated on `kind`. */\nexport type IngestSpec = DeclarativeIngestSpec | AgentIngestSpec;\n"],"mappings":";;;AAoBA,IAAa,oBAAoB;AAKjC,IAAM,oBAAyC,IAAI,IAAI,cAAc;AAErE,SAAgB,eAAe,OAAuC;CACpE,OAAO,OAAO,UAAU,YAAY,kBAAkB,IAAI,KAAK;AACjE;;;AAIA,IAAa,yBAAyB"}

package/dist/{server-BDxrLT41.js → server-DKXXFTbw.js}

@@ -1,4 +1,4 @@
-import { a as FEED_SCHEDULES, c as isFieldDrivenEvery, i as AGENT_INGEST_KIND, o as INGEST_KINDS, s as embedTargetId, t as deriveAll } from "./deriveAll-D3wFH4Tw.js";
+import { a as resolveIcon, c as AGENT_INGEST_KIND, d as embedTargetId, f as isFieldDrivenEvery, i as firstDateField, l as FEED_SCHEDULES, o as selectDynamicRecord, t as deriveAll, u as INGEST_KINDS } from "./deriveAll-CMFXDQ_G.js";
 import { isSafeActionTemplatePath, isSafeCustomViewI18nPath, isSafeCustomViewPath } from "./collection/paths.js";
 import path from "node:path";
 import { promises, realpathSync } from "node:fs";
@@ -970,6 +970,51 @@ var AgentIngestZ = z.object({
 	template: z.string().trim().min(1).refine(isSafeActionTemplatePath, "must be a safe path under `templates/` (e.g. `templates/refresh.md`; no `..`, no leading `/`, no backslash)")
 });
 var IngestSchemaZ = z.discriminatedUnion("kind", [DeclarativeIngestZ, AgentIngestZ]);
+var ValueRefZ = z.object({
+	record: z.string().trim().min(1).optional(),
+	field: z.string().trim().min(1)
+});
+var WhereCondZ = z.object({
+	field: z.string().trim().min(1),
+	op: z.enum([
+		"eq",
+		"ne",
+		"in",
+		"gt",
+		"gte",
+		"lt",
+		"lte",
+		"contains"
+	]),
+	value: z.union([z.string(), z.array(z.string())]).optional(),
+	valueFrom: ValueRefZ.optional()
+}).refine((cond) => cond.value !== void 0 !== (cond.valueFrom !== void 0), {
+	message: "a where condition must declare exactly one of `value` (a literal) or `valueFrom` (a reference to another record's field), never both or neither",
+	path: ["value"]
+}).refine((cond) => cond.value === void 0 || cond.op === "in" === Array.isArray(cond.value), {
+	message: "`in` requires an array `value` (the allowed set); every other op requires a single string `value`",
+	path: ["value"]
+});
+var WhereZ = z.array(WhereCondZ);
+var DynamicIconSourceZ = z.object({
+	collection: z.string().trim().min(1),
+	from: z.enum([
+		"latest",
+		"first",
+		"when"
+	]).optional(),
+	orderBy: z.string().trim().min(1).optional(),
+	where: WhereZ.optional()
+});
+var DynamicIconRuleZ = z.object({
+	where: WhereZ,
+	icon: z.string().trim().min(1)
+});
+var DynamicIconSpecZ = z.object({
+	source: DynamicIconSourceZ,
+	rules: z.array(DynamicIconRuleZ),
+	fallback: z.string().trim().min(1).optional()
+});
 var CollectionSchemaZ = z.object({
 	title: z.string().min(1),
 	icon: z.string().min(1),
@@ -991,7 +1036,8 @@ var CollectionSchemaZ = z.object({
 	kanbanField: z.string().trim().min(1).optional(),
 	views: z.array(CustomViewSchema).optional(),
 	notifyWhen: WhenSchema.optional(),
-	ingest: IngestSchemaZ.optional()
+	ingest: IngestSchemaZ.optional(),
+	dynamicIcon: DynamicIconSpecZ.optional()
 }).refine((schema) => schema.singleton === void 0 || safeRecordId(schema.singleton) !== null, {
 	message: "schema `singleton` must be a valid item id (alphanumeric / hyphen / underscore / interior dot, no `..` or path separators)",
 	path: ["singleton"]
@@ -1347,6 +1393,52 @@ async function enrichItems(collection, items, opts = {}) {
 	return items.map((item) => projectComputed(schema, deriveAll(schema, item, refRecords), linked));
 }
 //#endregion
+//#region src/collection/server/dynamicIcon.ts
+/** Index `items` by their `primaryKey` value — the `recordsById` map a
+*  `valueFrom` reference (e.g. `_config.defaultCity`) resolves against.
+*  Items whose primary key isn't a string (shouldn't happen for a valid
+*  schema, but records are untyped storage) are skipped rather than
+*  coerced, so a broken key never silently shadows a real one. */
+function buildRecordsById(items, primaryKey) {
+	const entries = items.filter((item) => typeof item[primaryKey] === "string").map((item) => [String(item[primaryKey]), item]);
+	return Object.fromEntries(entries);
+}
+/** Order records by their `primaryKey` so record selection is deterministic:
+*  `listItems` returns filesystem `readdir` order (arbitrary across machines),
+*  which would let `from: "first"`, the no-`orderBy` `latest`, and `orderBy`
+*  ties pick a different record — and thus a different icon — between
+*  reconciles. A stable id sort pins one answer. */
+function sortByPrimaryKey(items, primaryKey) {
+	return [...items].sort((left, right) => String(left[primaryKey] ?? "").localeCompare(String(right[primaryKey] ?? "")));
+}
+/** Compute the effective launcher icon for `collection`: its static
+*  `schema.icon` when it declares no `dynamicIcon`, else the icon
+*  resolved from `dynamicIcon.source`'s RAW stored records (no
+*  derive/enrich — the icon rules match against stored values) via the
+*  pure resolver. Fails soft on any read/discovery error (missing source
+*  collection, filesystem error): falls back to `dynamicIcon.fallback ??
+*  schema.icon` rather than surfacing to the collections list. */
+async function computeCollectionIcon(collection, opts = {}) {
+	const { schema } = collection;
+	const spec = schema.dynamicIcon;
+	if (!spec) return schema.icon;
+	try {
+		const source = await loadCollection(spec.source.collection, opts);
+		if (!source) return spec.fallback ?? schema.icon;
+		const ordered = sortByPrimaryKey(await listItems(source.dataDir, { workspaceRoot: opts.workspaceRoot }), source.schema.primaryKey);
+		const orderBy = spec.source.orderBy ?? firstDateField(source.schema);
+		const recordsById = buildRecordsById(ordered, source.schema.primaryKey);
+		return resolveIcon(selectDynamicRecord(ordered, spec.source, orderBy, recordsById), spec, schema.icon, recordsById);
+	} catch (err) {
+		log.warn("collections", "dynamic icon compute failed, falling back", {
+			slug: collection.slug,
+			source: spec.source.collection,
+			error: String(err)
+		});
+		return spec.fallback ?? schema.icon;
+	}
+}
+//#endregion
 //#region src/collection/server/util.ts
 /** Human-readable message from an unknown thrown value. */
 function errorMessage(err) {
@@ -1823,6 +1915,6 @@ async function deleteCustomView(collection, viewId, opts = {}) {
 	};
 }
 //#endregion
-export { promptPathsFor as A, isContainedInWorkspace as B, validateCollectionRecords as C, deleteItem as D, buildCollectionActionSeedPrompt as E, resolveCreateItemId as F, safeSlugName as G, resolveDataDir as H, writeItem as I, getWorkspaceRoot as J, collectionsRegistriesConfigPath as K, writeFileAtomic as L, readCustomViewI18n as M, readItem as N, generateItemId as O, readSkillTemplate as P, SCHEMA_FILE as R, COMPUTED_TYPES as S, buildActionSeedPrompt as T, resolveTemplatePath as U, itemFilePath as V, safeRecordId as W, publishCollectionChange as X, log as Y, setCollectionChangePublisher as Z, acceptParsedSchema as _, computeSuccessor as a, toDetail as b, isTriggerDue as c, resolveEvery as d, successorId as f, CollectionSchemaZ as g, enrichItems as h, advanceTriggerDate as i, readCustomViewHtml as j, listItems as k, maybeSpawnSuccessor as l, errorMessage as m, deleteCollection as n, daysInMonth as o, ONE_SECOND_MS as p, configureCollectionHost as q, deleteCollectionRefusalMessage as r, formatCivil as s, deleteCustomView as t, parseCivil as u, discoverCollections as v, validateRecordObject as w, toSummary as x, loadCollection as y, isContainedInRoot as z };
+export { listItems as A, isContainedInRoot as B, COMPUTED_TYPES as C, buildCollectionActionSeedPrompt as D, buildActionSeedPrompt as E, readSkillTemplate as F, safeRecordId as G, itemFilePath as H, resolveCreateItemId as I, configureCollectionHost as J, safeSlugName as K, writeItem as L, readCustomViewHtml as M, readCustomViewI18n as N, deleteItem as O, readItem as P, setCollectionChangePublisher as Q, writeFileAtomic as R, toSummary as S, validateRecordObject as T, resolveDataDir as U, isContainedInWorkspace as V, resolveTemplatePath as W, log as X, getWorkspaceRoot as Y, publishCollectionChange as Z, CollectionSchemaZ as _, computeSuccessor as a, loadCollection as b, isTriggerDue as c, resolveEvery as d, successorId as f, enrichItems as g, computeCollectionIcon as h, advanceTriggerDate as i, promptPathsFor as j, generateItemId as k, maybeSpawnSuccessor as l, errorMessage as m, deleteCollection as n, daysInMonth as o, ONE_SECOND_MS as p, collectionsRegistriesConfigPath as q, deleteCollectionRefusalMessage as r, formatCivil as s, deleteCustomView as t, parseCivil as u, acceptParsedSchema as v, validateCollectionRecords as w, toDetail as x, discoverCollections as y, SCHEMA_FILE as z };
 
-//# sourceMappingURL=server-BDxrLT41.js.map
+//# sourceMappingURL=server-DKXXFTbw.js.map