@mastra/factory 0.8.0-alpha.9 → 0.8.0

package/dist/routes/knowledge.js

@@ -0,0 +1,442 @@
+import { Route } from "./route.js";
+import { registerApiRoute } from "@mastra/core/server";
+import { canonicalizeKnowledgeScope, isKnowledgeScopeVisible, knowledgeScopeKey, parseKnowledgeWikilinks } from "@mastra/core/storage";
+//#region src/routes/knowledge.ts
+/** Reserved node that anchors pinned records (see subconscious/pinned.ts). */
+const PINNED_NODE_NAME = "pinned";
+/** Hover-card budget for record text shipped in the graph payload. */
+const RECORD_TEXT_LIMIT = 240;
+function truncateRecordText(text) {
+	return text.length > RECORD_TEXT_LIMIT ? `${text.slice(0, RECORD_TEXT_LIMIT - 1)}…` : text;
+}
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const DEFAULT_LIMITS = {
+	maxNodes: 500,
+	maxRecords: 2e3,
+	maxFallbackLookups: 100
+};
+function loose(c) {
+	return c;
+}
+function deepestRung(scope) {
+	let rung = "org";
+	for (const entry of scope) {
+		const ns = entry.slice(0, entry.indexOf(":"));
+		if (ns === "thread") return "thread";
+		if (ns === "resource") rung = "resource";
+	}
+	return rung;
+}
+function boundedThreadId(raw) {
+	if (!raw) return void 0;
+	const trimmed = raw.trim();
+	return trimmed.length > 0 && trimmed.length <= 512 ? trimmed : void 0;
+}
+/**
+* In-record + capped-fallback wikilink resolver, shared by both endpoints.
+* Resolution uses the store's own algorithm: a descending-prefix walk over the
+* record's canonical scope matching canonical name + exact scope key at each
+* prefix, so an edge never depends on whether the target landed in the window.
+*/
+var WikilinkResolver = class {
+	/** exact `${scopeKey}\u0000${lowerName}` → node, from the fetched window. */
+	#inWindow = /* @__PURE__ */ new Map();
+	#windowIds = /* @__PURE__ */ new Set();
+	/** `${recordScopeKey}\u0000${lowerName}` → fallback result (null = dangling). */
+	#fallbackCache = /* @__PURE__ */ new Map();
+	#fallbackLookups = 0;
+	#store;
+	#maxFallbackLookups;
+	outOfWindow = /* @__PURE__ */ new Map();
+	cappedNames = [];
+	#cappedSeen = /* @__PURE__ */ new Set();
+	constructor(store, nodes, maxFallbackLookups) {
+		this.#store = store;
+		this.#maxFallbackLookups = maxFallbackLookups;
+		for (const node of nodes) {
+			this.#inWindow.set(`${knowledgeScopeKey(node.scope)}\u0000${node.name.trim().toLocaleLowerCase()}`, node);
+			this.#windowIds.add(node.id);
+		}
+	}
+	inWindowId(id) {
+		return this.#windowIds.has(id);
+	}
+	/** Resolve a wikilink name from a knowledge record's scope. Returns the node or null (dangling/capped). */
+	async resolve(name, recordScope) {
+		const canonical = canonicalizeKnowledgeScope(recordScope);
+		const lower = name.trim().toLocaleLowerCase();
+		for (let length = canonical.length; length > 0; length--) {
+			const hit = this.#inWindow.get(`${knowledgeScopeKey(canonical.slice(0, length))}\u0000${lower}`);
+			if (hit) return hit;
+		}
+		const cacheKey = `${knowledgeScopeKey(canonical)}\u0000${lower}`;
+		if (this.#fallbackCache.has(cacheKey)) return this.#trackOutOfWindow(this.#fallbackCache.get(cacheKey) ?? null);
+		if (this.#fallbackLookups >= this.#maxFallbackLookups) {
+			if (!this.#cappedSeen.has(lower) && this.cappedNames.length < 100) {
+				this.#cappedSeen.add(lower);
+				this.cappedNames.push(name.trim());
+			} else if (!this.#cappedSeen.has(lower)) this.#cappedSeen.add(lower);
+			return null;
+		}
+		this.#fallbackLookups += 1;
+		let resolved = null;
+		try {
+			resolved = await this.#store.resolveNode({
+				name,
+				scope: canonical
+			});
+		} catch {
+			resolved = null;
+		}
+		this.#fallbackCache.set(cacheKey, resolved);
+		return this.#trackOutOfWindow(resolved);
+	}
+	#trackOutOfWindow(node) {
+		if (node && !this.#windowIds.has(node.id)) this.outOfWindow.set(node.id, {
+			id: node.id,
+			name: node.name
+		});
+		return node;
+	}
+	get cappedCount() {
+		return this.#cappedSeen.size;
+	}
+};
+var KnowledgeRoutes = class extends Route {
+	#limits;
+	constructor(deps) {
+		super(deps);
+		this.#limits = {
+			...DEFAULT_LIMITS,
+			...deps.limits
+		};
+	}
+	/** Resolve the `(orgId, userId)` tenant or a ready-to-return error response. */
+	async #resolveTenant(c) {
+		await this.deps.auth.ensureUser(c);
+		const tenant = this.deps.auth.tenant(c);
+		if (!tenant) return { response: c.json({ error: "unauthorized" }, 401) };
+		if (!tenant.orgId) return { response: c.json({
+			error: "organization_required",
+			message: "The knowledge graph requires an organization."
+		}, 403) };
+		return {
+			orgId: tenant.orgId,
+			userId: tenant.userId
+		};
+	}
+	/**
+	* Resolve tenant + org-owned project + knowledge store + the active view's
+	* query scope. The ONE seam both endpoints share, so the default/thread view
+	* scope and the pin rungs cannot drift between them.
+	*
+	* threadId validation runs a single `listRecordsBySource` lookup with
+	* `limit: 1` AT THE CANDIDATE SCOPE `[org, resource, thread:<id>]` — the
+	* store's own visibility predicate is the authorization: the thread's own
+	* records (equal scope key) and its project/org captures (prefix) match, while
+	* a cross-org thread's records match nothing → zero rows → 404.
+	*/
+	async #resolveView(c) {
+		const tenant = await this.#resolveTenant(c);
+		if ("response" in tenant) return tenant;
+		const projectId = c.req.param("id");
+		if (!projectId || !UUID_RE.test(projectId)) return { response: c.json({ error: "Project not found" }, 404) };
+		const { projects } = this.deps;
+		await projects.ensureReady();
+		if (!await projects.get({
+			orgId: tenant.orgId,
+			id: projectId
+		})) return { response: c.json({ error: "Project not found" }, 404) };
+		const store = await this.deps.knowledge();
+		if (!store) return { response: c.json({
+			error: "knowledge_unavailable",
+			message: "The knowledge storage domain is not configured."
+		}, 503) };
+		const defaultScope = [`org:${tenant.orgId}`, `resource:${projectId}`];
+		const resourceRungScope = defaultScope;
+		const threadId = boundedThreadId(c.req.query("threadId"));
+		if (c.req.query("threadId") !== void 0 && !threadId) return { response: c.json({ error: "thread_not_found" }, 404) };
+		if (!threadId) return {
+			...tenant,
+			factoryProjectId: projectId,
+			store,
+			view: "project",
+			scope: defaultScope,
+			pinRungs: [{
+				rung: "resource",
+				scope: resourceRungScope
+			}]
+		};
+		const candidateScope = [...defaultScope, `thread:${threadId}`];
+		if ((await store.knowledgeBySource({
+			sourceThreadId: threadId,
+			scope: candidateScope,
+			limit: 1
+		})).records.length === 0) return { response: c.json({ error: "thread_not_found" }, 404) };
+		return {
+			...tenant,
+			factoryProjectId: projectId,
+			store,
+			view: "thread",
+			threadId,
+			scope: candidateScope,
+			pinRungs: [{
+				rung: "resource",
+				scope: resourceRungScope
+			}, {
+				rung: "thread",
+				scope: candidateScope
+			}]
+		};
+	}
+	/** Reserved `pinned` node ids at the active view's rungs (one exact-scope lookup per rung). */
+	async #pinnedNodeIds(view) {
+		const out = [];
+		for (const { rung, scope } of view.pinRungs) {
+			const node = await view.store.getNodeByName({
+				name: PINNED_NODE_NAME,
+				scope
+			});
+			if (node && !node.mergedInto) out.push({
+				rung,
+				id: node.id
+			});
+		}
+		return out;
+	}
+	/** Non-deleted pinned records for the given pinned-node ids, visible in the view. */
+	async #pinnedRecords(view, pinnedNodeIds) {
+		const out = [];
+		for (const { rung, id } of pinnedNodeIds) {
+			const { records } = await view.store.listKnowledgeAbout({
+				node: id,
+				scope: view.scope,
+				limit: 200
+			});
+			for (const record of records) out.push({
+				rung,
+				record
+			});
+		}
+		return out;
+	}
+	routes() {
+		return [
+			registerApiRoute("/web/factory/projects/:id/knowledge/graph", {
+				method: "GET",
+				requiresAuth: false,
+				handler: async (c) => {
+					const view = await this.#resolveView(loose(c));
+					if ("response" in view) return view.response;
+					const { store, scope } = view;
+					const limits = this.#limits;
+					const fetched = await store.listNodes({
+						scope,
+						limit: limits.maxNodes + 1
+					});
+					let truncated = fetched.length > limits.maxNodes;
+					const pinnedNodeIds = await this.#pinnedNodeIds(view);
+					const pinnedNodeIdSet = new Set(pinnedNodeIds.map((p) => p.id));
+					const nodes = fetched.slice(0, limits.maxNodes).filter((node) => !pinnedNodeIdSet.has(node.id));
+					const recordWindow = [];
+					for (const node of nodes) {
+						if (recordWindow.length > limits.maxRecords) break;
+						const { records } = await store.listKnowledgeAbout({
+							node: node.id,
+							scope,
+							limit: limits.maxRecords + 1 - recordWindow.length
+						});
+						recordWindow.push(...records);
+					}
+					recordWindow.sort((a, b) => b.id.localeCompare(a.id));
+					if (recordWindow.length > limits.maxRecords) {
+						truncated = true;
+						recordWindow.length = limits.maxRecords;
+					}
+					const resolver = new WikilinkResolver(store, nodes, limits.maxFallbackLookups);
+					const edges = [];
+					const graphRecords = [];
+					const edgeSeen = /* @__PURE__ */ new Set();
+					const recordCounts = /* @__PURE__ */ new Map();
+					for (const record of recordWindow) {
+						recordCounts.set(record.node, (recordCounts.get(record.node) ?? 0) + 1);
+						const nodeIds = [record.node];
+						for (const name of parseKnowledgeWikilinks(record.text)) {
+							const target = await resolver.resolve(name, record.scope);
+							if (!target) continue;
+							if (target.id === record.node) continue;
+							if (!resolver.inWindowId(target.id)) continue;
+							if (!nodeIds.includes(target.id)) nodeIds.push(target.id);
+							const key = `${record.node}\u0000${target.id}`;
+							if (edgeSeen.has(key)) continue;
+							edgeSeen.add(key);
+							edges.push({
+								id: `wikilink:${record.node}:${target.id}`,
+								source: record.node,
+								target: target.id,
+								type: "wikilink",
+								recordId: record.id
+							});
+						}
+						graphRecords.push({
+							id: record.id,
+							nodeIds,
+							pinned: false,
+							text: truncateRecordText(record.text)
+						});
+					}
+					const pinnedRecords = await this.#pinnedRecords(view, pinnedNodeIds);
+					const accented = /* @__PURE__ */ new Set();
+					for (const { record } of pinnedRecords) {
+						const targets = [];
+						for (const name of parseKnowledgeWikilinks(record.text)) {
+							const target = await resolver.resolve(name, record.scope);
+							if (target && resolver.inWindowId(target.id) && !targets.includes(target.id)) targets.push(target.id);
+						}
+						graphRecords.push({
+							id: record.id,
+							nodeIds: targets,
+							pinned: true,
+							text: truncateRecordText(record.text)
+						});
+						if (targets.length === 1) {
+							accented.add(targets[0]);
+							continue;
+						}
+						for (let a = 0; a < targets.length; a += 1) for (let b = a + 1; b < targets.length; b += 1) {
+							const key = `${targets[a]}\u0000${targets[b]}\u0000pin`;
+							if (edgeSeen.has(key)) continue;
+							edgeSeen.add(key);
+							edges.push({
+								id: `pin:${record.id}:${targets[a]}:${targets[b]}`,
+								source: targets[a],
+								target: targets[b],
+								type: "wikilink",
+								recordId: record.id,
+								pinned: true
+							});
+						}
+					}
+					const pinCensus = {
+						resource: pinnedRecords.filter((p) => p.rung === "resource").length,
+						thread: view.view === "thread" ? pinnedRecords.filter((p) => p.rung === "thread").length : null
+					};
+					const activity = await store.listActivity({
+						scope,
+						limit: 1
+					});
+					const payload = {
+						view: view.view,
+						...view.threadId ? { threadId: view.threadId } : {},
+						nodes: nodes.map((node) => ({
+							id: node.id,
+							name: node.name,
+							kind: node.kind,
+							scope: node.scope,
+							rung: deepestRung(node.scope),
+							pinned: accented.has(node.id),
+							recordCount: recordCounts.get(node.id) ?? 0,
+							createdAt: node.createdAt.toISOString(),
+							updatedAt: node.updatedAt.toISOString()
+						})),
+						edges,
+						records: graphRecords,
+						truncated,
+						outOfWindow: [...resolver.outOfWindow.values()],
+						unresolvedCapped: {
+							count: resolver.cappedCount,
+							names: resolver.cappedNames
+						},
+						pinCensus,
+						version: activity[0]?.id ?? null
+					};
+					return c.json(payload);
+				}
+			}),
+			registerApiRoute("/web/factory/projects/:id/knowledge/nodes/:nodeId", {
+				method: "GET",
+				requiresAuth: false,
+				handler: async (c) => {
+					const view = await this.#resolveView(loose(c));
+					if ("response" in view) return view.response;
+					const { store, scope } = view;
+					const nodeId = loose(c).req.param("nodeId");
+					if (!nodeId || nodeId.length > 512) return c.json({ error: "node_not_found" }, 404);
+					const node = await store.getNode(nodeId);
+					if (!node || !isKnowledgeScopeVisible(node.scope, scope)) return c.json({ error: "node_not_found" }, 404);
+					const pinnedNodeIds = await this.#pinnedNodeIds(view);
+					const pinnedNodeIdSet = new Set(pinnedNodeIds.map((p) => p.id));
+					const [owned, mentioning] = await Promise.all([store.listKnowledgeAbout({
+						node: node.id,
+						scope,
+						limit: 200
+					}), store.listKnowledgeMentioning({
+						node: node.id,
+						scope,
+						limit: 200
+					})]);
+					const seen = /* @__PURE__ */ new Set();
+					const records = [];
+					const push = (record, relation) => {
+						if (seen.has(record.id)) return;
+						seen.add(record.id);
+						records.push({
+							id: record.id,
+							node: record.node,
+							relation,
+							text: record.text,
+							scope: record.scope,
+							rung: deepestRung(record.scope),
+							sourceThreadId: record.sourceThreadId,
+							capturedAt: record.capturedAt.toISOString(),
+							...record.when ? { when: record.when.toISOString() } : {},
+							pinned: pinnedNodeIdSet.has(record.node),
+							...record.metadata ? { metadata: record.metadata } : {}
+						});
+					};
+					for (const record of [...owned.records].sort((a, b) => b.id.localeCompare(a.id))) push(record, "owned");
+					for (const record of [...mentioning.records].sort((a, b) => b.id.localeCompare(a.id))) push(record, "mentions");
+					const payload = {
+						node: {
+							id: node.id,
+							name: node.name,
+							kind: node.kind,
+							content: node.content ?? "",
+							scope: node.scope,
+							rung: deepestRung(node.scope),
+							createdAt: node.createdAt.toISOString(),
+							updatedAt: node.updatedAt.toISOString()
+						},
+						records
+					};
+					return c.json(payload);
+				}
+			}),
+			registerApiRoute("/web/factory/projects/:id/knowledge/activity", {
+				method: "GET",
+				requiresAuth: false,
+				handler: async (c) => {
+					const view = await this.#resolveView(loose(c));
+					if ("response" in view) return view.response;
+					const events = await view.store.listActivity({
+						scope: view.scope,
+						limit: 100
+					});
+					return c.json({ events: events.map((event) => ({
+						id: event.id,
+						action: event.action,
+						recordType: event.recordType,
+						recordId: event.recordId,
+						scope: event.scope,
+						...event.sourceThreadId ? { sourceThreadId: event.sourceThreadId } : {},
+						createdAt: event.createdAt.toISOString()
+					})) });
+				}
+			})
+		];
+	}
+};
+//#endregion
+export { KnowledgeRoutes };
+
+//# sourceMappingURL=knowledge.js.map

package/dist/routes/knowledge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.js","names":["#inWindow","#windowIds","#fallbackCache","#store","#maxFallbackLookups","#trackOutOfWindow","#fallbackLookups","#cappedSeen","#limits","#resolveTenant","#resolveView","#pinnedNodeIds","#pinnedRecords"],"sources":["../../src/routes/knowledge.ts"],"sourcesContent":["/**\n * Read-only Mastra `apiRoutes` exposing the factory project's knowledge graph.\n *\n * Serves the Knowledge page in factory-ui: a polling graph snapshot (nodes\n * as nodes, wikilink edges derived from record text), a node flyout payload\n * with per-record provenance, and the recent activity feed. Every endpoint is a\n * GET — this module never writes knowledge.\n *\n * Scoping is fail-closed: the org and resource rungs are derived server-side\n * from the authenticated caller and the validated `:id` project. The DEFAULT\n * view queries `[org:<orgId>, resource:<projectId>]` (org + project records).\n * Thread-scoped records are reachable ONLY via an explicit, server-validated\n * `threadId` query parameter (the drill-down view), which appends the thread\n * rung to the query scope. A thread is drillable iff it produced knowledge\n * visible under the caller's org/project prefix; unknown or cross-org threads\n * 404 — never a silent fallback to the default view.\n */\n\nimport type { ApiRoute } from '@mastra/core/server';\nimport { registerApiRoute } from '@mastra/core/server';\nimport type { KnowledgeNode, KnowledgeRecord, KnowledgeScope, KnowledgeStorage } from '@mastra/core/storage';\nimport {\n  canonicalizeKnowledgeScope,\n  isKnowledgeScopeVisible,\n  knowledgeScopeKey,\n  parseKnowledgeWikilinks,\n} from '@mastra/core/storage';\nimport type { Context } from 'hono';\n\nimport type { FactoryProjectsStorage } from '../storage/domains/projects/base.js';\nimport type { RouteDependencies } from './route.js';\nimport { Route } from './route.js';\n\n/** Reserved node that anchors pinned records (see subconscious/pinned.ts). */\nconst PINNED_NODE_NAME = 'pinned';\n\n/** Hover-card budget for record text shipped in the graph payload. */\nconst RECORD_TEXT_LIMIT = 240;\n\nfunction truncateRecordText(text: string): string {\n  return text.length > RECORD_TEXT_LIMIT ? `${text.slice(0, RECORD_TEXT_LIMIT - 1)}…` : text;\n}\n\nconst UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n\n/** Window caps. Injectable at construction only — never per-request. */\nexport interface KnowledgeRouteLimits {\n  /** Max nodes in a graph snapshot (newest-first). */\n  maxNodes: number;\n  /** Max records parsed for edges per snapshot (newest-first). */\n  maxRecords: number;\n  /** Max fallback `resolveNode` store lookups per request (deduped per unique name+scope). */\n  maxFallbackLookups: number;\n}\n\nconst DEFAULT_LIMITS: KnowledgeRouteLimits = { maxNodes: 500, maxRecords: 2000, maxFallbackLookups: 100 };\n\nexport interface KnowledgeRoutesDeps extends RouteDependencies {\n  /** Factory projects domain — validates the `:id` project belongs to the caller's org. */\n  projects: FactoryProjectsStorage;\n  /** Lazy handle to the knowledge storage domain; endpoints 503 when absent. */\n  knowledge: () => Promise<KnowledgeStorage | undefined>;\n  limits?: Partial<KnowledgeRouteLimits>;\n}\n\n/** A graph node. `recordCount` is window-derived (records inside the snapshot window only). */\nexport interface KnowledgeGraphNode {\n  id: string;\n  name: string;\n  kind: string;\n  scope: KnowledgeScope;\n  /** Deepest rung of the record's scope: org | resource | thread. */\n  rung: 'org' | 'resource' | 'thread';\n  /**\n   * True when a non-deleted pinned record's wikilinks reference ONLY this\n   * node (A9: multi-target pins mark their edges instead — the pin is\n   * about the relationship; a single-target pin has no edge to carry it).\n   */\n  pinned: boolean;\n  /** Records owned by this node INSIDE the snapshot window (not a total). */\n  recordCount: number;\n  createdAt: string;\n  updatedAt: string;\n}\n\nexport interface KnowledgeGraphEdge {\n  id: string;\n  /** The owning node of the record (its `node`). */\n  source: string;\n  /** The wikilink-resolved node. */\n  target: string;\n  /**\n   * Always 'wikilink': the record's `node` is the edge SOURCE, so the\n   * plan's \"parent link\" collapses into the wikilink edge — nodes carry no\n   * separate parent field to derive a second edge type from.\n   */\n  type: 'wikilink';\n  /** The record whose text produced the edge. */\n  recordId: string;\n  /**\n   * True when the edge is derived from a PINNED record linking two nodes —\n   * the pin marks the relationship, so the accent lives on the edge (A9).\n   */\n  pinned?: boolean;\n}\n\n/**\n * A knowledge record as a first-class graph element (A11): every record in the window,\n * with the in-window nodes it touches. The client renders by arity —\n * 1 node: a small dot linked to it; 2: the connecting line; 3+: a midpoint\n * junction splitting to each node. Pin records have their hidden reserved\n * owner omitted, so their arity comes purely from wikilink targets.\n */\nexport interface KnowledgeGraphRecord {\n  /** The record id. */\n  id: string;\n  /** Owner node first (omitted for pins), then resolved wikilink targets. */\n  nodeIds: string[];\n  pinned: boolean;\n  /** Record text, truncated for hover cards. */\n  text: string;\n}\n\nexport interface KnowledgeGraphPayload {\n  view: 'project' | 'thread';\n  threadId?: string;\n  nodes: KnowledgeGraphNode[];\n  edges: KnowledgeGraphEdge[];\n  records: KnowledgeGraphRecord[];\n  /** True when the node or record window cap was hit (newest-first window). */\n  truncated: boolean;\n  /** Wikilink targets that resolved in the store but fell outside the node window. */\n  outOfWindow: Array<{ id: string; name: string }>;\n  /** Unique unknown names skipped once the fallback-lookup cap was hit. */\n  unresolvedCapped: { count: number; names: string[] };\n  /** Pin counts per rung of the active view (thread is null in the default view). */\n  pinCensus: { resource: number; thread: number | null };\n  /** Change hint: newest knowledge activity id (per-process monotonic — hint only). */\n  version: string | null;\n}\n\nexport interface KnowledgeNodeRecordPayload {\n  id: string;\n  node: string;\n  /** 'owned' when the node is the record's parent, 'mentions' when it only wikilinks it. */\n  relation: 'owned' | 'mentions';\n  text: string;\n  scope: KnowledgeScope;\n  rung: 'org' | 'resource' | 'thread';\n  sourceThreadId: string;\n  capturedAt: string;\n  when?: string;\n  pinned: boolean;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface KnowledgeNodePayload {\n  node: {\n    id: string;\n    name: string;\n    kind: string;\n    content: string;\n    scope: KnowledgeScope;\n    rung: 'org' | 'resource' | 'thread';\n    createdAt: string;\n    updatedAt: string;\n  };\n  records: KnowledgeNodeRecordPayload[];\n}\n\nfunction loose(c: unknown): Context {\n  return c as Context;\n}\n\nfunction deepestRung(scope: KnowledgeScope): 'org' | 'resource' | 'thread' {\n  let rung: 'org' | 'resource' | 'thread' = 'org';\n  for (const entry of scope) {\n    const ns = entry.slice(0, entry.indexOf(':'));\n    if (ns === 'thread') return 'thread';\n    if (ns === 'resource') rung = 'resource';\n  }\n  return rung;\n}\n\nfunction boundedThreadId(raw: string | undefined): string | undefined {\n  if (!raw) return undefined;\n  const trimmed = raw.trim();\n  return trimmed.length > 0 && trimmed.length <= 512 ? trimmed : undefined;\n}\n\ninterface ResolvedView {\n  orgId: string;\n  userId: string;\n  factoryProjectId: string;\n  store: KnowledgeStorage;\n  view: 'project' | 'thread';\n  threadId?: string;\n  /** The query scope for the active view. */\n  scope: KnowledgeScope;\n  /** Exact scopes where a reserved `pinned` node may live for this view. */\n  pinRungs: Array<{ rung: 'resource' | 'thread'; scope: KnowledgeScope }>;\n}\n\n/**\n * In-record + capped-fallback wikilink resolver, shared by both endpoints.\n * Resolution uses the store's own algorithm: a descending-prefix walk over the\n * record's canonical scope matching canonical name + exact scope key at each\n * prefix, so an edge never depends on whether the target landed in the window.\n */\nclass WikilinkResolver {\n  /** exact `${scopeKey}\\u0000${lowerName}` → node, from the fetched window. */\n  readonly #inWindow = new Map<string, KnowledgeNode>();\n  readonly #windowIds = new Set<string>();\n  /** `${recordScopeKey}\\u0000${lowerName}` → fallback result (null = dangling). */\n  readonly #fallbackCache = new Map<string, KnowledgeNode | null>();\n  #fallbackLookups = 0;\n  readonly #store: KnowledgeStorage;\n  readonly #maxFallbackLookups: number;\n  readonly outOfWindow = new Map<string, { id: string; name: string }>();\n  readonly cappedNames: string[] = [];\n  #cappedSeen = new Set<string>();\n\n  constructor(store: KnowledgeStorage, nodes: KnowledgeNode[], maxFallbackLookups: number) {\n    this.#store = store;\n    this.#maxFallbackLookups = maxFallbackLookups;\n    for (const node of nodes) {\n      this.#inWindow.set(`${knowledgeScopeKey(node.scope)}\\u0000${node.name.trim().toLocaleLowerCase()}`, node);\n      this.#windowIds.add(node.id);\n    }\n  }\n\n  inWindowId(id: string): boolean {\n    return this.#windowIds.has(id);\n  }\n\n  /** Resolve a wikilink name from a knowledge record's scope. Returns the node or null (dangling/capped). */\n  async resolve(name: string, recordScope: KnowledgeScope): Promise<KnowledgeNode | null> {\n    const canonical = canonicalizeKnowledgeScope(recordScope);\n    const lower = name.trim().toLocaleLowerCase();\n    for (let length = canonical.length; length > 0; length--) {\n      const hit = this.#inWindow.get(`${knowledgeScopeKey(canonical.slice(0, length))}\\u0000${lower}`);\n      if (hit) return hit;\n    }\n    const cacheKey = `${knowledgeScopeKey(canonical)}\\u0000${lower}`;\n    if (this.#fallbackCache.has(cacheKey)) {\n      return this.#trackOutOfWindow(this.#fallbackCache.get(cacheKey) ?? null);\n    }\n    if (this.#fallbackLookups >= this.#maxFallbackLookups) {\n      if (!this.#cappedSeen.has(lower) && this.cappedNames.length < 100) {\n        this.#cappedSeen.add(lower);\n        this.cappedNames.push(name.trim());\n      } else if (!this.#cappedSeen.has(lower)) {\n        this.#cappedSeen.add(lower);\n      }\n      return null;\n    }\n    this.#fallbackLookups += 1;\n    let resolved: KnowledgeNode | null = null;\n    try {\n      resolved = await this.#store.resolveNode({ name, scope: canonical });\n    } catch {\n      resolved = null;\n    }\n    this.#fallbackCache.set(cacheKey, resolved);\n    return this.#trackOutOfWindow(resolved);\n  }\n\n  #trackOutOfWindow(node: KnowledgeNode | null): KnowledgeNode | null {\n    if (node && !this.#windowIds.has(node.id)) {\n      this.outOfWindow.set(node.id, { id: node.id, name: node.name });\n    }\n    return node;\n  }\n\n  get cappedCount(): number {\n    return this.#cappedSeen.size;\n  }\n}\n\nexport class KnowledgeRoutes extends Route<KnowledgeRoutesDeps> {\n  readonly #limits: KnowledgeRouteLimits;\n\n  constructor(deps: KnowledgeRoutesDeps) {\n    super(deps);\n    this.#limits = { ...DEFAULT_LIMITS, ...deps.limits };\n  }\n\n  /** Resolve the `(orgId, userId)` tenant or a ready-to-return error response. */\n  async #resolveTenant(c: Context): Promise<{ orgId: string; userId: string } | { response: Response }> {\n    await this.deps.auth.ensureUser(c);\n    const tenant = this.deps.auth.tenant(c);\n    if (!tenant) return { response: c.json({ error: 'unauthorized' }, 401) };\n    if (!tenant.orgId) {\n      return {\n        response: c.json(\n          { error: 'organization_required', message: 'The knowledge graph requires an organization.' },\n          403,\n        ),\n      };\n    }\n    return { orgId: tenant.orgId, userId: tenant.userId };\n  }\n\n  /**\n   * Resolve tenant + org-owned project + knowledge store + the active view's\n   * query scope. The ONE seam both endpoints share, so the default/thread view\n   * scope and the pin rungs cannot drift between them.\n   *\n   * threadId validation runs a single `listRecordsBySource` lookup with\n   * `limit: 1` AT THE CANDIDATE SCOPE `[org, resource, thread:<id>]` — the\n   * store's own visibility predicate is the authorization: the thread's own\n   * records (equal scope key) and its project/org captures (prefix) match, while\n   * a cross-org thread's records match nothing → zero rows → 404.\n   */\n  async #resolveView(c: Context): Promise<ResolvedView | { response: Response }> {\n    const tenant = await this.#resolveTenant(c);\n    if ('response' in tenant) return tenant;\n\n    const projectId = c.req.param('id');\n    if (!projectId || !UUID_RE.test(projectId)) {\n      return { response: c.json({ error: 'Project not found' }, 404) };\n    }\n    const { projects } = this.deps;\n    await projects.ensureReady();\n    const project = await projects.get({ orgId: tenant.orgId, id: projectId });\n    if (!project) {\n      return { response: c.json({ error: 'Project not found' }, 404) };\n    }\n\n    const store = await this.deps.knowledge();\n    if (!store) {\n      return {\n        response: c.json(\n          { error: 'knowledge_unavailable', message: 'The knowledge storage domain is not configured.' },\n          503,\n        ),\n      };\n    }\n\n    const defaultScope: KnowledgeScope = [`org:${tenant.orgId}`, `resource:${projectId}`];\n    const resourceRungScope = defaultScope;\n\n    const threadId = boundedThreadId(c.req.query('threadId'));\n    if (c.req.query('threadId') !== undefined && !threadId) {\n      return { response: c.json({ error: 'thread_not_found' }, 404) };\n    }\n    if (!threadId) {\n      return {\n        ...tenant,\n        factoryProjectId: projectId,\n        store,\n        view: 'project',\n        scope: defaultScope,\n        pinRungs: [{ rung: 'resource', scope: resourceRungScope }],\n      };\n    }\n\n    const candidateScope: KnowledgeScope = [...defaultScope, `thread:${threadId}`];\n    const probe = await store.knowledgeBySource({ sourceThreadId: threadId, scope: candidateScope, limit: 1 });\n    if (probe.records.length === 0) {\n      return { response: c.json({ error: 'thread_not_found' }, 404) };\n    }\n    return {\n      ...tenant,\n      factoryProjectId: projectId,\n      store,\n      view: 'thread',\n      threadId,\n      scope: candidateScope,\n      pinRungs: [\n        { rung: 'resource', scope: resourceRungScope },\n        { rung: 'thread', scope: candidateScope },\n      ],\n    };\n  }\n\n  /** Reserved `pinned` node ids at the active view's rungs (one exact-scope lookup per rung). */\n  async #pinnedNodeIds(view: ResolvedView): Promise<Array<{ rung: 'resource' | 'thread'; id: string }>> {\n    const out: Array<{ rung: 'resource' | 'thread'; id: string }> = [];\n    for (const { rung, scope } of view.pinRungs) {\n      const node = await view.store.getNodeByName({ name: PINNED_NODE_NAME, scope });\n      if (node && !node.mergedInto) out.push({ rung, id: node.id });\n    }\n    return out;\n  }\n\n  /** Non-deleted pinned records for the given pinned-node ids, visible in the view. */\n  async #pinnedRecords(\n    view: ResolvedView,\n    pinnedNodeIds: Array<{ rung: 'resource' | 'thread'; id: string }>,\n  ): Promise<Array<{ rung: 'resource' | 'thread'; record: KnowledgeRecord }>> {\n    const out: Array<{ rung: 'resource' | 'thread'; record: KnowledgeRecord }> = [];\n    for (const { rung, id } of pinnedNodeIds) {\n      const { records } = await view.store.listKnowledgeAbout({ node: id, scope: view.scope, limit: 200 });\n      for (const record of records) out.push({ rung, record });\n    }\n    return out;\n  }\n\n  routes(): ApiRoute[] {\n    return [\n      // ── Graph snapshot: nodes + derived edges, polled by the page ──────────\n      registerApiRoute('/web/factory/projects/:id/knowledge/graph', {\n        method: 'GET',\n        requiresAuth: false,\n        handler: async c => {\n          const view = await this.#resolveView(loose(c));\n          if ('response' in view) return view.response;\n          const { store, scope } = view;\n          const limits = this.#limits;\n\n          // Nodes, newest-first; +1 to detect truncation.\n          const fetched = await store.listNodes({ scope, limit: limits.maxNodes + 1 });\n          let truncated = fetched.length > limits.maxNodes;\n          const pinnedNodeIds = await this.#pinnedNodeIds(view);\n          const pinnedNodeIdSet = new Set(pinnedNodeIds.map(p => p.id));\n          const nodes = fetched.slice(0, limits.maxNodes).filter(node => !pinnedNodeIdSet.has(node.id));\n\n          // Record window: per-node owned records, then newest-first overall.\n          const recordWindow: KnowledgeRecord[] = [];\n          for (const node of nodes) {\n            if (recordWindow.length > limits.maxRecords) break;\n            const { records } = await store.listKnowledgeAbout({\n              node: node.id,\n              scope,\n              limit: limits.maxRecords + 1 - recordWindow.length,\n            });\n            recordWindow.push(...records);\n          }\n          // Record ids are ULIDs — descending id = newest-first.\n          recordWindow.sort((a, b) => b.id.localeCompare(a.id));\n          if (recordWindow.length > limits.maxRecords) {\n            truncated = true;\n            recordWindow.length = limits.maxRecords;\n          }\n\n          const resolver = new WikilinkResolver(store, nodes, limits.maxFallbackLookups);\n\n          // Edges: owner node (the record's parent link) → wikilinked node.\n          // Graph records: every windowed record with its in-window node set,\n          // owner first. The client renders dots, lines, or junctions by arity.\n          const edges: KnowledgeGraphEdge[] = [];\n          const graphRecords: KnowledgeGraphRecord[] = [];\n          const edgeSeen = new Set<string>();\n          const recordCounts = new Map<string, number>();\n          for (const record of recordWindow) {\n            recordCounts.set(record.node, (recordCounts.get(record.node) ?? 0) + 1);\n            const nodeIds = [record.node];\n            for (const name of parseKnowledgeWikilinks(record.text)) {\n              const target = await resolver.resolve(name, record.scope);\n              if (!target) continue;\n              if (target.id === record.node) continue;\n              if (!resolver.inWindowId(target.id)) continue;\n              if (!nodeIds.includes(target.id)) nodeIds.push(target.id);\n              const key = `${record.node}\\u0000${target.id}`;\n              if (edgeSeen.has(key)) continue;\n              edgeSeen.add(key);\n              edges.push({\n                id: `wikilink:${record.node}:${target.id}`,\n                source: record.node,\n                target: target.id,\n                type: 'wikilink',\n                recordId: record.id,\n              });\n            }\n            graphRecords.push({ id: record.id, nodeIds, pinned: false, text: truncateRecordText(record.text) });\n          }\n\n          // Pins mark relationships. The reserved owner node is omitted, so\n          // arity comes purely from wikilink targets.\n          const pinnedRecords = await this.#pinnedRecords(view, pinnedNodeIds);\n          const accented = new Set<string>();\n          for (const { record } of pinnedRecords) {\n            const targets: string[] = [];\n            for (const name of parseKnowledgeWikilinks(record.text)) {\n              const target = await resolver.resolve(name, record.scope);\n              if (target && resolver.inWindowId(target.id) && !targets.includes(target.id)) {\n                targets.push(target.id);\n              }\n            }\n            graphRecords.push({ id: record.id, nodeIds: targets, pinned: true, text: truncateRecordText(record.text) });\n            if (targets.length === 1) {\n              accented.add(targets[0]!);\n              continue;\n            }\n            for (let a = 0; a < targets.length; a += 1) {\n              for (let b = a + 1; b < targets.length; b += 1) {\n                const key = `${targets[a]}\\u0000${targets[b]}\\u0000pin`;\n                if (edgeSeen.has(key)) continue;\n                edgeSeen.add(key);\n                edges.push({\n                  id: `pin:${record.id}:${targets[a]}:${targets[b]}`,\n                  source: targets[a]!,\n                  target: targets[b]!,\n                  type: 'wikilink',\n                  recordId: record.id,\n                  pinned: true,\n                });\n              }\n            }\n          }\n          const pinCensus = {\n            resource: pinnedRecords.filter(p => p.rung === 'resource').length,\n            thread: view.view === 'thread' ? pinnedRecords.filter(p => p.rung === 'thread').length : null,\n          };\n\n          const activity = await store.listActivity({ scope, limit: 1 });\n\n          const payload: KnowledgeGraphPayload = {\n            view: view.view,\n            ...(view.threadId ? { threadId: view.threadId } : {}),\n            nodes: nodes.map(node => ({\n              id: node.id,\n              name: node.name,\n              kind: node.kind,\n              scope: node.scope,\n              rung: deepestRung(node.scope),\n              pinned: accented.has(node.id),\n              recordCount: recordCounts.get(node.id) ?? 0,\n              createdAt: node.createdAt.toISOString(),\n              updatedAt: node.updatedAt.toISOString(),\n            })),\n            edges,\n            records: graphRecords,\n            truncated,\n            outOfWindow: [...resolver.outOfWindow.values()],\n            unresolvedCapped: { count: resolver.cappedCount, names: resolver.cappedNames },\n            pinCensus,\n            version: activity[0]?.id ?? null,\n          };\n          return c.json(payload);\n        },\n      }),\n\n      // ── Node flyout payload: details + provenance-rich records ───────────────\n      registerApiRoute('/web/factory/projects/:id/knowledge/nodes/:nodeId', {\n        method: 'GET',\n        requiresAuth: false,\n        handler: async c => {\n          const view = await this.#resolveView(loose(c));\n          if ('response' in view) return view.response;\n          const { store, scope } = view;\n          const nodeId = loose(c).req.param('nodeId');\n          if (!nodeId || nodeId.length > 512) return c.json({ error: 'node_not_found' }, 404);\n\n          const node = await store.getNode(nodeId);\n          // getNode is a bare id lookup with no scope predicate. This explicit\n          // visibility check prevents an IDOR.\n          if (!node || !isKnowledgeScopeVisible(node.scope, scope)) {\n            return c.json({ error: 'node_not_found' }, 404);\n          }\n\n          const pinnedNodeIds = await this.#pinnedNodeIds(view);\n          const pinnedNodeIdSet = new Set(pinnedNodeIds.map(p => p.id));\n\n          const [owned, mentioning] = await Promise.all([\n            store.listKnowledgeAbout({ node: node.id, scope, limit: 200 }),\n            store.listKnowledgeMentioning({ node: node.id, scope, limit: 200 }),\n          ]);\n          const seen = new Set<string>();\n          const records: KnowledgeNodeRecordPayload[] = [];\n          const push = (record: KnowledgeRecord, relation: 'owned' | 'mentions') => {\n            if (seen.has(record.id)) return;\n            seen.add(record.id);\n            records.push({\n              id: record.id,\n              node: record.node,\n              relation,\n              text: record.text,\n              scope: record.scope,\n              rung: deepestRung(record.scope),\n              sourceThreadId: record.sourceThreadId,\n              capturedAt: record.capturedAt.toISOString(),\n              ...(record.when ? { when: record.when.toISOString() } : {}),\n              pinned: pinnedNodeIdSet.has(record.node),\n              ...(record.metadata ? { metadata: record.metadata } : {}),\n            });\n          };\n          // Owned first, newest-first within each group. Record ids are ULIDs.\n          for (const record of [...owned.records].sort((a, b) => b.id.localeCompare(a.id))) push(record, 'owned');\n          for (const record of [...mentioning.records].sort((a, b) => b.id.localeCompare(a.id))) {\n            push(record, 'mentions');\n          }\n\n          const payload: KnowledgeNodePayload = {\n            node: {\n              id: node.id,\n              name: node.name,\n              kind: node.kind,\n              content: node.content ?? '',\n              scope: node.scope,\n              rung: deepestRung(node.scope),\n              createdAt: node.createdAt.toISOString(),\n              updatedAt: node.updatedAt.toISOString(),\n            },\n            records,\n          };\n          return c.json(payload);\n        },\n      }),\n\n      // ── Recent activity feed for the live-arrival affordance ───────────────\n      registerApiRoute('/web/factory/projects/:id/knowledge/activity', {\n        method: 'GET',\n        requiresAuth: false,\n        handler: async c => {\n          const view = await this.#resolveView(loose(c));\n          if ('response' in view) return view.response;\n          const events = await view.store.listActivity({ scope: view.scope, limit: 100 });\n          return c.json({\n            events: events.map(event => ({\n              id: event.id,\n              action: event.action,\n              recordType: event.recordType,\n              recordId: event.recordId,\n              scope: event.scope,\n              ...(event.sourceThreadId ? { sourceThreadId: event.sourceThreadId } : {}),\n              createdAt: event.createdAt.toISOString(),\n            })),\n          });\n        },\n      }),\n    ];\n  }\n}\n"],"mappings":"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"}

package/dist/routes/projects.d.ts

@@ -1,7 +1,7 @@
 import type { ApiRoute } from '@mastra/core/server';
 import type { SessionRetirementCoordinator } from '../sandbox/session-retirement.js';
 import type { FactoryProjectsStorage } from '../storage/domains/projects/base.js';
-import type { SourceControlStorage } from '../storage/domains/source-control/base.js';
+import type { ProjectRepository, SourceControlStorage } from '../storage/domains/source-control/base.js';
 import type { RouteDependencies } from './route.js';
 import { Route } from './route.js';
 export interface ProjectRoutesDeps extends RouteDependencies {
@@ -11,6 +11,14 @@ export interface ProjectRoutesDeps extends RouteDependencies {
     sourceControl: SourceControlStorage;
     /** Integration ids allowed as source-control connection targets. */
     versionControlIntegrationIds?: string[];
+    /**
+     * Fire-and-forget hook invoked after a repository is linked to a project —
+     * kicks the initial base-checkpoint build. Must never throw.
+     */
+    onProjectRepositoryLinked?: (args: {
+        orgId: string;
+        projectRepository: ProjectRepository;
+    }) => void;
     /** Shared lifecycle for retiring sessions before their owning records are deleted. */
     sessionRetirement?: SessionRetirementCoordinator;
 }

package/dist/routes/projects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/routes/projects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAIpD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAC;AACrF,OAAO,KAAK,EAEV,sBAAsB,EAEvB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAEV,oBAAoB,EAGrB,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAkKnC,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IAC1D,wDAAwD;IACxD,QAAQ,EAAE,sBAAsB,CAAC;IACjC,2EAA2E;IAC3E,aAAa,EAAE,oBAAoB,CAAC;IACpC,oEAAoE;IACpE,4BAA4B,CAAC,EAAE,MAAM,EAAE,CAAC;IACxC,sFAAsF;IACtF,iBAAiB,CAAC,EAAE,4BAA4B,CAAC;CAClD;AAED,qBAAa,aAAc,SAAQ,KAAK,CAAC,iBAAiB,CAAC;;gBAG7C,IAAI,EAAE,iBAAiB;IA8EnC,MAAM,IAAI,QAAQ,EAAE;CAuPrB"}
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/routes/projects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAIpD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAC;AACrF,OAAO,KAAK,EAEV,sBAAsB,EAEvB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EAGrB,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAkKnC,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IAC1D,wDAAwD;IACxD,QAAQ,EAAE,sBAAsB,CAAC;IACjC,2EAA2E;IAC3E,aAAa,EAAE,oBAAoB,CAAC;IACpC,oEAAoE;IACpE,4BAA4B,CAAC,EAAE,MAAM,EAAE,CAAC;IACxC;;;OAGG;IACH,yBAAyB,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,iBAAiB,CAAA;KAAE,KAAK,IAAI,CAAC;IACpG,sFAAsF;IACtF,iBAAiB,CAAC,EAAE,4BAA4B,CAAC;CAClD;AAED,qBAAa,aAAc,SAAQ,KAAK,CAAC,iBAAiB,CAAC;;gBAG7C,IAAI,EAAE,iBAAiB;IA8EnC,MAAM,IAAI,QAAQ,EAAE;CA4PrB"}

package/dist/routes/projects.js

@@ -434,6 +434,14 @@ var ProjectRoutes = class extends Route {
 						createdByUserId: tenant.userId,
 						...input
 					});
+					try {
+						this.deps.onProjectRepositoryLinked?.({
+							orgId: tenant.orgId,
+							projectRepository
+						});
+					} catch (error) {
+						console.warn("[factory] onProjectRepositoryLinked failed after a successful repository link:", error);
+					}
 					return context.json({ projectRepository: await this.#repositoryPayload(found.handle, tenant.orgId, projectRepository) }, 201);
 				}
 			}),