@xopcai/xopc 0.0.127 → 0.0.129

package/dist/src/goals/goal-contract-draft.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-contract-draft.js","names":[],"sources":["../../../src/goals/goal-contract-draft.ts"],"sourcesContent":["import type { UserMessage } from '@earendil-works/pi-ai';\nimport { complete } from '@earendil-works/pi-ai/compat';\n\nimport { getApiKey, resolveModel } from '../providers/index.js';\nimport type { GoalContractInput } from './types.js';\n\nconst MAX_ITEMS = 7;\n\nexport type GoalContractDraftInput = {\n  title: string;\n  context?: string;\n  criteria?: string[];\n  uiLocale?: 'en' | 'zh';\n  modelRef?: string;\n  signal?: AbortSignal;\n};\n\nexport type GoalContractDraftResult = {\n  contract: GoalContractInput;\n  generated: boolean;\n  warning?: string;\n};\n\nfunction stringList(value: unknown): string[] {\n  if (!Array.isArray(value)) return [];\n  const seen = new Set<string>();\n  const items: string[] = [];\n  for (const item of value) {\n    if (typeof item !== 'string') continue;\n    const text = item.trim();\n    const key = text.toLocaleLowerCase();\n    if (!text || seen.has(key)) continue;\n    seen.add(key);\n    items.push(text);\n    if (items.length >= MAX_ITEMS) break;\n  }\n  return items;\n}\n\nfunction extractText(content: unknown): string {\n  if (!Array.isArray(content)) return '';\n  return content\n    .filter((block): block is { type: string; text?: unknown } => Boolean(block && typeof block === 'object'))\n    .filter((block) => block.type === 'text' && typeof block.text === 'string')\n    .map((block) => block.text as string)\n    .join('')\n    .trim();\n}\n\nfunction parseJson(raw: string): Record<string, unknown> | null {\n  const text = raw.trim().replace(/^```(?:json)?\\s*/i, '').replace(/\\s*```$/, '');\n  try {\n    return JSON.parse(text) as Record<string, unknown>;\n  } catch {\n    const start = text.indexOf('{');\n    const end = text.lastIndexOf('}');\n    if (start < 0 || end <= start) return null;\n    try {\n      return JSON.parse(text.slice(start, end + 1)) as Record<string, unknown>;\n    } catch {\n      return null;\n    }\n  }\n}\n\nfunction fallbackContract(input: GoalContractDraftInput): GoalContractInput {\n  const title = input.title.trim();\n  const criteria = stringList(input.criteria);\n  const isChinese = input.uiLocale === 'zh';\n  return {\n    objective: title,\n    scopeBoundary: input.context?.trim() || undefined,\n    criteria: criteria.length\n      ? criteria\n      : isChinese\n        ? [\n            `“${title}”具有清晰且可由用户验证的最终结果。`,\n            `“${title}”在约定范围内完成所需工作。`,\n          ]\n        : [\n            `${title} has a clear, user-verifiable outcome.`,\n            `The required work for ${title} is complete within the stated scope.`,\n          ],\n    evidencePlan: [isChinese\n      ? '提供可检查的测试结果、产物、链接或报告，以证明目标完成。'\n      : 'Record an inspectable test result, artifact, link, or report that proves completion.'],\n  };\n}\n\nfunction normalizedModelContract(data: Record<string, unknown>, fallback: GoalContractInput): GoalContractInput {\n  const objective = typeof data.objective === 'string' && data.objective.trim()\n    ? data.objective.trim()\n    : fallback.objective;\n  const scopeBoundary = typeof data.scopeBoundary === 'string' && data.scopeBoundary.trim()\n    ? data.scopeBoundary.trim()\n    : fallback.scopeBoundary;\n  const criteria = stringList(data.criteria);\n  const evidencePlan = stringList(data.evidencePlan);\n  return {\n    objective,\n    scopeBoundary,\n    criteria: criteria.length ? criteria : fallback.criteria,\n    evidencePlan: evidencePlan.length ? evidencePlan : fallback.evidencePlan,\n  };\n}\n\nexport async function draftGoalContract(input: GoalContractDraftInput): Promise<GoalContractDraftResult> {\n  const fallback = fallbackContract(input);\n  if (!input.modelRef?.trim()) {\n    return {\n      contract: fallback,\n      generated: false,\n      warning: input.uiLocale === 'zh' ? '未配置用于定义目标的模型，已生成可编辑的本地草案。' : 'No model is configured for goal drafting.',\n    };\n  }\n\n  try {\n    const model = resolveModel(input.modelRef.trim());\n    const apiKey = await getApiKey(model.provider);\n    const prompt = [\n      'Turn the explicitly requested persistent goal into a concise, measurable goal contract.',\n      'Preserve the user intent. Do not claim work is done. Do not include markdown or commentary.',\n      'Return only one JSON object with objective, scopeBoundary, criteria, and evidencePlan.',\n      'criteria and evidencePlan must each contain 1 to 7 concrete, observable strings.',\n      'The scope boundary must state material exclusions when possible.',\n      input.uiLocale === 'zh' ? 'Return every string value in Simplified Chinese.' : 'Return every string value in English.',\n      '',\n      `Goal title: ${input.title.trim()}`,\n      `Context: ${input.context?.trim() || '(none)'}`,\n      `Existing acceptance criteria: ${stringList(input.criteria).join(' | ') || '(none)'}`,\n    ].join('\\n');\n    const message: UserMessage = { role: 'user', content: prompt, timestamp: Date.now() };\n    const result = await complete(model, { messages: [message] }, {\n      apiKey,\n      maxTokens: 1200,\n      temperature: 0,\n      signal: input.signal,\n    });\n    const parsed = parseJson(extractText(result.content));\n    if (!parsed) return {\n      contract: fallback,\n      generated: false,\n      warning: input.uiLocale === 'zh' ? '模型未返回有效的目标契约，已生成可编辑的本地草案。' : 'The model did not return a valid goal contract.',\n    };\n    return { contract: normalizedModelContract(parsed, fallback), generated: true };\n  } catch {\n    return {\n      contract: fallback,\n      generated: false,\n      warning: input.uiLocale === 'zh' ? '目标定义暂不可用，已生成可编辑的本地草案。' : 'Goal drafting is unavailable; a local draft was prepared instead.',\n    };\n  }\n}\n"],"mappings":"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"}

package/dist/src/goals/goal-evidence-review.d.ts

@@ -0,0 +1,15 @@
+import type { GoalEvidence, GoalEvidenceRequirement } from './types.js';
+export type GoalEvidenceReviewVerdict = 'approved' | 'needs_more_evidence' | 'rejected';
+export type GoalEvidenceReviewResult = {
+    verdict: GoalEvidenceReviewVerdict;
+    reason: string;
+    confidence?: number;
+    generated: boolean;
+    warning?: string;
+};
+export declare function reviewGoalEvidenceRequirement(input: {
+    requirement: GoalEvidenceRequirement;
+    evidence: GoalEvidence[];
+    modelRef?: string;
+    signal?: AbortSignal;
+}): Promise<GoalEvidenceReviewResult>;

package/dist/src/goals/goal-evidence-review.js

@@ -0,0 +1,91 @@
+import { getApiKey, init_providers, resolveModel } from "../providers/index.js";
+import { complete } from "@earendil-works/pi-ai/compat";
+//#region src/goals/goal-evidence-review.ts
+init_providers();
+function extractText(content) {
+	if (!Array.isArray(content)) return "";
+	return content.filter((block) => Boolean(block && typeof block === "object")).filter((block) => block.type === "text" && typeof block.text === "string").map((block) => block.text).join("").trim();
+}
+function parseJson(raw) {
+	const text = raw.trim().replace(/^```(?:json)?\s*/i, "").replace(/\s*```$/, "");
+	try {
+		return JSON.parse(text);
+	} catch {
+		const start = text.indexOf("{");
+		const end = text.lastIndexOf("}");
+		if (start < 0 || end <= start) return null;
+		try {
+			return JSON.parse(text.slice(start, end + 1));
+		} catch {
+			return null;
+		}
+	}
+}
+function localReview(requirement, evidence) {
+	if (!evidence.length) return {
+		verdict: "needs_more_evidence",
+		reason: `No evidence is linked to the requirement: ${requirement.text}`,
+		generated: false
+	};
+	return {
+		verdict: "needs_more_evidence",
+		reason: `${evidence.length} evidence item(s) are linked. Configure a goal judge model to assess whether they prove this requirement, then approve the result manually.`,
+		generated: false,
+		warning: "No model is configured for evidence review."
+	};
+}
+async function reviewGoalEvidenceRequirement(input) {
+	const fallback = localReview(input.requirement, input.evidence);
+	if (!input.modelRef?.trim() || input.evidence.length === 0) return fallback;
+	try {
+		const model = resolveModel(input.modelRef.trim());
+		const apiKey = await getApiKey(model.provider);
+		const parsed = parseJson(extractText((await complete(model, { messages: [{
+			role: "user",
+			content: [
+				"Assess whether the linked evidence proves the single goal requirement.",
+				"Be conservative: never infer facts that are absent from the supplied evidence.",
+				"Return only JSON with verdict (approved, needs_more_evidence, or rejected), reason, and confidence (0 to 1).",
+				"An approved result is advisory and still needs a human approval before goal completion.",
+				"",
+				`Requirement: ${input.requirement.text}`,
+				"Linked evidence:",
+				...input.evidence.map((item, index) => [
+					`${index + 1}. kind=${item.kind}; title=${item.title}`,
+					item.summary ? `summary=${item.summary}` : "",
+					item.uri ? `uri=${item.uri}` : ""
+				].filter(Boolean).join("; "))
+			].join("\n"),
+			timestamp: Date.now()
+		}] }, {
+			apiKey,
+			maxTokens: 700,
+			temperature: 0,
+			signal: input.signal
+		})).content));
+		if (!parsed) return {
+			...fallback,
+			warning: "The model did not return a valid evidence review."
+		};
+		const verdict = parsed.verdict;
+		if (verdict !== "approved" && verdict !== "needs_more_evidence" && verdict !== "rejected") return {
+			...fallback,
+			warning: "The model returned an unsupported evidence verdict."
+		};
+		return {
+			verdict,
+			reason: typeof parsed.reason === "string" && parsed.reason.trim() ? parsed.reason.trim() : "The model did not provide a review rationale.",
+			confidence: typeof parsed.confidence === "number" && Number.isFinite(parsed.confidence) ? Math.min(1, Math.max(0, parsed.confidence)) : void 0,
+			generated: true
+		};
+	} catch {
+		return {
+			...fallback,
+			warning: "Evidence review is unavailable; manual approval remains available."
+		};
+	}
+}
+//#endregion
+export { reviewGoalEvidenceRequirement };
+
+//# sourceMappingURL=goal-evidence-review.js.map

package/dist/src/goals/goal-evidence-review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-evidence-review.js","names":[],"sources":["../../../src/goals/goal-evidence-review.ts"],"sourcesContent":["import type { UserMessage } from '@earendil-works/pi-ai';\nimport { complete } from '@earendil-works/pi-ai/compat';\n\nimport { getApiKey, resolveModel } from '../providers/index.js';\nimport type { GoalEvidence, GoalEvidenceRequirement } from './types.js';\n\nexport type GoalEvidenceReviewVerdict = 'approved' | 'needs_more_evidence' | 'rejected';\n\nexport type GoalEvidenceReviewResult = {\n  verdict: GoalEvidenceReviewVerdict;\n  reason: string;\n  confidence?: number;\n  generated: boolean;\n  warning?: string;\n};\n\nfunction extractText(content: unknown): string {\n  if (!Array.isArray(content)) return '';\n  return content\n    .filter((block): block is { type: string; text?: unknown } => Boolean(block && typeof block === 'object'))\n    .filter((block) => block.type === 'text' && typeof block.text === 'string')\n    .map((block) => block.text as string)\n    .join('')\n    .trim();\n}\n\nfunction parseJson(raw: string): Record<string, unknown> | null {\n  const text = raw.trim().replace(/^```(?:json)?\\s*/i, '').replace(/\\s*```$/, '');\n  try {\n    return JSON.parse(text) as Record<string, unknown>;\n  } catch {\n    const start = text.indexOf('{');\n    const end = text.lastIndexOf('}');\n    if (start < 0 || end <= start) return null;\n    try {\n      return JSON.parse(text.slice(start, end + 1)) as Record<string, unknown>;\n    } catch {\n      return null;\n    }\n  }\n}\n\nfunction localReview(requirement: GoalEvidenceRequirement, evidence: GoalEvidence[]): GoalEvidenceReviewResult {\n  if (!evidence.length) {\n    return {\n      verdict: 'needs_more_evidence',\n      reason: `No evidence is linked to the requirement: ${requirement.text}`,\n      generated: false,\n    };\n  }\n  return {\n    verdict: 'needs_more_evidence',\n    reason: `${evidence.length} evidence item(s) are linked. Configure a goal judge model to assess whether they prove this requirement, then approve the result manually.`,\n    generated: false,\n    warning: 'No model is configured for evidence review.',\n  };\n}\n\nexport async function reviewGoalEvidenceRequirement(input: {\n  requirement: GoalEvidenceRequirement;\n  evidence: GoalEvidence[];\n  modelRef?: string;\n  signal?: AbortSignal;\n}): Promise<GoalEvidenceReviewResult> {\n  const fallback = localReview(input.requirement, input.evidence);\n  if (!input.modelRef?.trim() || input.evidence.length === 0) return fallback;\n  try {\n    const model = resolveModel(input.modelRef.trim());\n    const apiKey = await getApiKey(model.provider);\n    const prompt = [\n      'Assess whether the linked evidence proves the single goal requirement.',\n      'Be conservative: never infer facts that are absent from the supplied evidence.',\n      'Return only JSON with verdict (approved, needs_more_evidence, or rejected), reason, and confidence (0 to 1).',\n      'An approved result is advisory and still needs a human approval before goal completion.',\n      '',\n      `Requirement: ${input.requirement.text}`,\n      'Linked evidence:',\n      ...input.evidence.map((item, index) => [\n        `${index + 1}. kind=${item.kind}; title=${item.title}`,\n        item.summary ? `summary=${item.summary}` : '',\n        item.uri ? `uri=${item.uri}` : '',\n      ].filter(Boolean).join('; ')),\n    ].join('\\n');\n    const message: UserMessage = { role: 'user', content: prompt, timestamp: Date.now() };\n    const response = await complete(model, { messages: [message] }, {\n      apiKey,\n      maxTokens: 700,\n      temperature: 0,\n      signal: input.signal,\n    });\n    const parsed = parseJson(extractText(response.content));\n    if (!parsed) return { ...fallback, warning: 'The model did not return a valid evidence review.' };\n    const verdict = parsed.verdict;\n    if (verdict !== 'approved' && verdict !== 'needs_more_evidence' && verdict !== 'rejected') {\n      return { ...fallback, warning: 'The model returned an unsupported evidence verdict.' };\n    }\n    const reason = typeof parsed.reason === 'string' && parsed.reason.trim()\n      ? parsed.reason.trim()\n      : 'The model did not provide a review rationale.';\n    const confidence = typeof parsed.confidence === 'number' && Number.isFinite(parsed.confidence)\n      ? Math.min(1, Math.max(0, parsed.confidence))\n      : undefined;\n    return { verdict, reason, confidence, generated: true };\n  } catch {\n    return { ...fallback, warning: 'Evidence review is unavailable; manual approval remains available.' };\n  }\n}\n"],"mappings":";;;gBAGgE;AAahE,SAAS,YAAY,SAA0B;AAC7C,KAAI,CAAC,MAAM,QAAQ,QAAQ,CAAE,QAAO;AACpC,QAAO,QACJ,QAAQ,UAAqD,QAAQ,SAAS,OAAO,UAAU,SAAS,CAAC,CACzG,QAAQ,UAAU,MAAM,SAAS,UAAU,OAAO,MAAM,SAAS,SAAS,CAC1E,KAAK,UAAU,MAAM,KAAe,CACpC,KAAK,GAAG,CACR,MAAM;;AAGX,SAAS,UAAU,KAA6C;CAC9D,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,qBAAqB,GAAG,CAAC,QAAQ,WAAW,GAAG;AAC/E,KAAI;AACF,SAAO,KAAK,MAAM,KAAK;SACjB;EACN,MAAM,QAAQ,KAAK,QAAQ,IAAI;EAC/B,MAAM,MAAM,KAAK,YAAY,IAAI;AACjC,MAAI,QAAQ,KAAK,OAAO,MAAO,QAAO;AACtC,MAAI;AACF,UAAO,KAAK,MAAM,KAAK,MAAM,OAAO,MAAM,EAAE,CAAC;UACvC;AACN,UAAO;;;;AAKb,SAAS,YAAY,aAAsC,UAAoD;AAC7G,KAAI,CAAC,SAAS,OACZ,QAAO;EACL,SAAS;EACT,QAAQ,6CAA6C,YAAY;EACjE,WAAW;EACZ;AAEH,QAAO;EACL,SAAS;EACT,QAAQ,GAAG,SAAS,OAAO;EAC3B,WAAW;EACX,SAAS;EACV;;AAGH,eAAsB,8BAA8B,OAKd;CACpC,MAAM,WAAW,YAAY,MAAM,aAAa,MAAM,SAAS;AAC/D,KAAI,CAAC,MAAM,UAAU,MAAM,IAAI,MAAM,SAAS,WAAW,EAAG,QAAO;AACnE,KAAI;EACF,MAAM,QAAQ,aAAa,MAAM,SAAS,MAAM,CAAC;EACjD,MAAM,SAAS,MAAM,UAAU,MAAM,SAAS;EAsB9C,MAAM,SAAS,UAAU,aAAY,MANd,SAAS,OAAO,EAAE,UAAU,CAAC;GADrB,MAAM;GAAQ,SAd9B;IACb;IACA;IACA;IACA;IACA;IACA,gBAAgB,MAAM,YAAY;IAClC;IACA,GAAG,MAAM,SAAS,KAAK,MAAM,UAAU;KACrC,GAAG,QAAQ,EAAE,SAAS,KAAK,KAAK,UAAU,KAAK;KAC/C,KAAK,UAAU,WAAW,KAAK,YAAY;KAC3C,KAAK,MAAM,OAAO,KAAK,QAAQ;KAChC,CAAC,OAAO,QAAQ,CAAC,KAAK,KAAK,CAAC;IAC9B,CAAC,KAAK,KACqD;GAAE,WAAW,KAAK,KAAK;GACxB,CAAC,EAAE,EAAE;GAC9D;GACA,WAAW;GACX,aAAa;GACb,QAAQ,MAAM;GACf,CAAC,EAC4C,QAAQ,CAAC;AACvD,MAAI,CAAC,OAAQ,QAAO;GAAE,GAAG;GAAU,SAAS;GAAqD;EACjG,MAAM,UAAU,OAAO;AACvB,MAAI,YAAY,cAAc,YAAY,yBAAyB,YAAY,WAC7E,QAAO;GAAE,GAAG;GAAU,SAAS;GAAuD;AAQxF,SAAO;GAAE;GAAS,QANH,OAAO,OAAO,WAAW,YAAY,OAAO,OAAO,MAAM,GACpE,OAAO,OAAO,MAAM,GACpB;GAIsB,YAHP,OAAO,OAAO,eAAe,YAAY,OAAO,SAAS,OAAO,WAAW,GAC1F,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,OAAO,WAAW,CAAC,GAC3C,KAAA;GACkC,WAAW;GAAM;SACjD;AACN,SAAO;GAAE,GAAG;GAAU,SAAS;GAAsE"}

package/dist/src/goals/goal-runner.js

@@ -11,7 +11,9 @@ function terminalGoalStatus(status) {
 }
 function buildInitialGoalTurn(goal) {
 	const context = goal.contextMessage;
-	const parts = [`Goal:\n${goal.title}`];
+	const parts = [`Goal:\n${goal.contract?.objective || goal.title}`];
+	if (goal.contract?.scopeBoundary) parts.push(`Scope boundary:\n${goal.contract.scopeBoundary}`);
+	if (goal.contract?.evidencePlan.length) parts.push(`Expected completion evidence:\n${goal.contract.evidencePlan.map((item) => `- ${item}`).join("\n")}`);
 	if (context?.text.trim()) parts.push(`Context:\n${context.text.trim()}`);
 	if (goal.checklist.length > 0) parts.push(`User-provided acceptance criteria:\n${goal.checklist.map((item, index) => `${index + 1}. ${item.text}`).join("\n")}`);
 	return {

package/dist/src/goals/goal-runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"goal-runner.js","names":[],"sources":["../../../src/goals/goal-runner.ts"],"sourcesContent":["import { GoalQueueStore } from './goal-queue-store.js';\nimport { GoalService } from './goal-service.js';\nimport type { EnqueueGoalRunOptions, GoalQueueItemSnapshot, GoalQueueStatus, GoalRunnerOptions } from './goal-queue-types.js';\nimport type { GoalWithDetails } from './types.js';\nimport { mediaRefsToUserTurnAttachments, type UserTurnInput } from '../gateway/user-turn-input.js';\nimport { createLogger } from '../utils/logger.js';\n\nconst log = createLogger('GoalRunner');\n\nfunction terminalGoalStatus(status: GoalWithDetails['status']): boolean {\n  return status === 'done' || status === 'archived';\n}\n\nfunction buildInitialGoalTurn(goal: GoalWithDetails): UserTurnInput {\n  const context = goal.contextMessage;\n  const parts = [`Goal:\\n${goal.title}`];\n  if (context?.text.trim()) {\n    parts.push(`Context:\\n${context.text.trim()}`);\n  }\n  if (goal.checklist.length > 0) {\n    parts.push(`User-provided acceptance criteria:\\n${goal.checklist.map((item, index) => `${index + 1}. ${item.text}`).join('\\n')}`);\n  }\n  return {\n    text: parts.join('\\n\\n'),\n    attachments: mediaRefsToUserTurnAttachments(context?.attachments),\n    clientCreatedAtMs: Date.now(),\n  };\n}\n\nfunction buildFollowupGoalTurn(goal: GoalWithDetails): UserTurnInput {\n  return {\n    text: goal.nextAction || goal.title,\n    clientCreatedAtMs: Date.now(),\n  };\n}\n\nexport class GoalRunner {\n  private readonly goals = new GoalService();\n  private readonly store = new GoalQueueStore();\n  private active = 0;\n  private pumpTimer: ReturnType<typeof setTimeout> | null = null;\n\n  constructor(private readonly opts: GoalRunnerOptions) {\n    this.store.resetRunningToRetry();\n    this.schedulePump(0);\n  }\n\n  enqueue(goalId: string, options: EnqueueGoalRunOptions = {}): GoalQueueItemSnapshot {\n    const item = this.store.enqueue({\n      goalId,\n      maxRetries: Math.max(0, Math.floor(options.maxRetries ?? this.opts.defaultMaxRetries ?? 2)),\n      userTurn: options.userTurn && (options.userTurn.text.trim() || options.userTurn.attachments?.length)\n        ? {\n            ...options.userTurn,\n            text: options.userTurn.text.trim(),\n            clientCreatedAtMs: options.userTurn.clientCreatedAtMs ?? Date.now(),\n          }\n        : undefined,\n      source: options.source ?? 'api',\n    });\n    this.emit('goal.queue.updated', item);\n    this.schedulePump(0);\n    return item;\n  }\n\n  snapshot(): GoalQueueItemSnapshot[] {\n    return this.store.list();\n  }\n\n  private schedulePump(delayMs: number): void {\n    if (this.pumpTimer) return;\n    this.pumpTimer = setTimeout(() => {\n      this.pumpTimer = null;\n      void this.pump();\n    }, delayMs);\n  }\n\n  private async pump(): Promise<void> {\n    const maxConcurrent = Math.max(1, Math.floor(this.opts.maxConcurrent ?? 1));\n    while (this.active < maxConcurrent) {\n      const item = this.store.claimNext();\n      if (!item) break;\n      this.active += 1;\n      void this.runItem(item).finally(() => {\n        this.active -= 1;\n        this.schedulePump(0);\n      });\n    }\n\n    const nextRetry = this.store.list()\n      .filter((item) => item.status === 'retry_waiting' && item.nextRunAt)\n      .sort((a, b) => (a.nextRunAt ?? 0) - (b.nextRunAt ?? 0))[0];\n    if (nextRetry) this.schedulePump(Math.max(0, (nextRetry.nextRunAt ?? Date.now()) - Date.now()));\n  }\n\n  private async runItem(item: GoalQueueItemSnapshot): Promise<void> {\n    this.emit('goal.queue.updated', item);\n    try {\n      const goal = this.goals.get(item.goalId);\n      if (!goal) {\n        this.finish(item, 'failed', 'Goal not found');\n        return;\n      }\n      if (terminalGoalStatus(goal.status)) {\n        this.finish(item, 'skipped', `Goal is ${goal.status}`);\n        return;\n      }\n      const activeGoal =\n        goal.status === 'paused' || goal.status === 'blocked' || goal.status === 'needs_input'\n          ? this.goals.resume(goal.id)\n          : goal;\n      if (!activeGoal) {\n        this.finish(item, 'failed', 'Goal not found');\n        return;\n      }\n      const sessionKey = activeGoal.activeSessionKey ?? (await this.opts.ensureSession(activeGoal));\n      item = this.store.setSessionKey(item.id, sessionKey) ?? { ...item, sessionKey };\n      if (this.opts.hasActiveRun(sessionKey)) {\n        this.retry(item, 'Goal session already has an active run');\n        return;\n      }\n      const userTurn = item.userTurn ?? (activeGoal.turnsUsed === 0 ? buildInitialGoalTurn(activeGoal) : buildFollowupGoalTurn(activeGoal));\n      await this.opts.runTurn(sessionKey, userTurn);\n      this.finish(item, 'succeeded');\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      if (item.attempts <= item.maxRetries) {\n        this.retry(item, message);\n      } else {\n        this.finish(item, 'failed', message);\n      }\n    }\n  }\n\n  private retry(item: GoalQueueItemSnapshot, error: string): void {\n    const base = Math.max(1_000, this.opts.retryBaseMs ?? 5_000);\n    item.status = 'retry_waiting';\n    item.lastError = error;\n    item.nextRunAt = Date.now() + base * 2 ** Math.max(0, item.attempts - 1);\n    item = this.store.markRetry(item.id, error, item.nextRunAt) ?? item;\n    log.warn({ goalId: item.goalId, attempts: item.attempts, nextRunAt: item.nextRunAt, errorMessage: error }, `Goal run queued for retry: ${error}`);\n    this.emit('goal.queue.updated', item);\n    this.schedulePump(Math.max(0, item.nextRunAt - Date.now()));\n  }\n\n  private finish(item: GoalQueueItemSnapshot, status: GoalQueueStatus, error?: string): void {\n    item = this.store.markFinished(item.id, status, error) ?? { ...item, status, finishedAt: Date.now(), lastError: error };\n    if (status === 'failed') {\n      log.warn({ goalId: item.goalId, attempts: item.attempts, errorMessage: error }, `Goal run failed: ${error}`);\n    }\n    this.emit('goal.queue.updated', item);\n  }\n\n  private emit(type: string, item: GoalQueueItemSnapshot): void {\n    this.opts.emit?.(type, { item: { ...item } });\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"goal-runner.js","names":[],"sources":["../../../src/goals/goal-runner.ts"],"sourcesContent":["import { GoalQueueStore } from './goal-queue-store.js';\nimport { GoalService } from './goal-service.js';\nimport type { EnqueueGoalRunOptions, GoalQueueItemSnapshot, GoalQueueStatus, GoalRunnerOptions } from './goal-queue-types.js';\nimport type { GoalWithDetails } from './types.js';\nimport { mediaRefsToUserTurnAttachments, type UserTurnInput } from '../gateway/user-turn-input.js';\nimport { createLogger } from '../utils/logger.js';\n\nconst log = createLogger('GoalRunner');\n\nfunction terminalGoalStatus(status: GoalWithDetails['status']): boolean {\n  return status === 'done' || status === 'archived';\n}\n\nfunction buildInitialGoalTurn(goal: GoalWithDetails): UserTurnInput {\n  const context = goal.contextMessage;\n  const parts = [`Goal:\\n${goal.contract?.objective || goal.title}`];\n  if (goal.contract?.scopeBoundary) {\n    parts.push(`Scope boundary:\\n${goal.contract.scopeBoundary}`);\n  }\n  if (goal.contract?.evidencePlan.length) {\n    parts.push(`Expected completion evidence:\\n${goal.contract.evidencePlan.map((item) => `- ${item}`).join('\\n')}`);\n  }\n  if (context?.text.trim()) {\n    parts.push(`Context:\\n${context.text.trim()}`);\n  }\n  if (goal.checklist.length > 0) {\n    parts.push(`User-provided acceptance criteria:\\n${goal.checklist.map((item, index) => `${index + 1}. ${item.text}`).join('\\n')}`);\n  }\n  return {\n    text: parts.join('\\n\\n'),\n    attachments: mediaRefsToUserTurnAttachments(context?.attachments),\n    clientCreatedAtMs: Date.now(),\n  };\n}\n\nfunction buildFollowupGoalTurn(goal: GoalWithDetails): UserTurnInput {\n  return {\n    text: goal.nextAction || goal.title,\n    clientCreatedAtMs: Date.now(),\n  };\n}\n\nexport class GoalRunner {\n  private readonly goals = new GoalService();\n  private readonly store = new GoalQueueStore();\n  private active = 0;\n  private pumpTimer: ReturnType<typeof setTimeout> | null = null;\n\n  constructor(private readonly opts: GoalRunnerOptions) {\n    this.store.resetRunningToRetry();\n    this.schedulePump(0);\n  }\n\n  enqueue(goalId: string, options: EnqueueGoalRunOptions = {}): GoalQueueItemSnapshot {\n    const item = this.store.enqueue({\n      goalId,\n      maxRetries: Math.max(0, Math.floor(options.maxRetries ?? this.opts.defaultMaxRetries ?? 2)),\n      userTurn: options.userTurn && (options.userTurn.text.trim() || options.userTurn.attachments?.length)\n        ? {\n            ...options.userTurn,\n            text: options.userTurn.text.trim(),\n            clientCreatedAtMs: options.userTurn.clientCreatedAtMs ?? Date.now(),\n          }\n        : undefined,\n      source: options.source ?? 'api',\n    });\n    this.emit('goal.queue.updated', item);\n    this.schedulePump(0);\n    return item;\n  }\n\n  snapshot(): GoalQueueItemSnapshot[] {\n    return this.store.list();\n  }\n\n  private schedulePump(delayMs: number): void {\n    if (this.pumpTimer) return;\n    this.pumpTimer = setTimeout(() => {\n      this.pumpTimer = null;\n      void this.pump();\n    }, delayMs);\n  }\n\n  private async pump(): Promise<void> {\n    const maxConcurrent = Math.max(1, Math.floor(this.opts.maxConcurrent ?? 1));\n    while (this.active < maxConcurrent) {\n      const item = this.store.claimNext();\n      if (!item) break;\n      this.active += 1;\n      void this.runItem(item).finally(() => {\n        this.active -= 1;\n        this.schedulePump(0);\n      });\n    }\n\n    const nextRetry = this.store.list()\n      .filter((item) => item.status === 'retry_waiting' && item.nextRunAt)\n      .sort((a, b) => (a.nextRunAt ?? 0) - (b.nextRunAt ?? 0))[0];\n    if (nextRetry) this.schedulePump(Math.max(0, (nextRetry.nextRunAt ?? Date.now()) - Date.now()));\n  }\n\n  private async runItem(item: GoalQueueItemSnapshot): Promise<void> {\n    this.emit('goal.queue.updated', item);\n    try {\n      const goal = this.goals.get(item.goalId);\n      if (!goal) {\n        this.finish(item, 'failed', 'Goal not found');\n        return;\n      }\n      if (terminalGoalStatus(goal.status)) {\n        this.finish(item, 'skipped', `Goal is ${goal.status}`);\n        return;\n      }\n      const activeGoal =\n        goal.status === 'paused' || goal.status === 'blocked' || goal.status === 'needs_input'\n          ? this.goals.resume(goal.id)\n          : goal;\n      if (!activeGoal) {\n        this.finish(item, 'failed', 'Goal not found');\n        return;\n      }\n      const sessionKey = activeGoal.activeSessionKey ?? (await this.opts.ensureSession(activeGoal));\n      item = this.store.setSessionKey(item.id, sessionKey) ?? { ...item, sessionKey };\n      if (this.opts.hasActiveRun(sessionKey)) {\n        this.retry(item, 'Goal session already has an active run');\n        return;\n      }\n      const userTurn = item.userTurn ?? (activeGoal.turnsUsed === 0 ? buildInitialGoalTurn(activeGoal) : buildFollowupGoalTurn(activeGoal));\n      await this.opts.runTurn(sessionKey, userTurn);\n      this.finish(item, 'succeeded');\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      if (item.attempts <= item.maxRetries) {\n        this.retry(item, message);\n      } else {\n        this.finish(item, 'failed', message);\n      }\n    }\n  }\n\n  private retry(item: GoalQueueItemSnapshot, error: string): void {\n    const base = Math.max(1_000, this.opts.retryBaseMs ?? 5_000);\n    item.status = 'retry_waiting';\n    item.lastError = error;\n    item.nextRunAt = Date.now() + base * 2 ** Math.max(0, item.attempts - 1);\n    item = this.store.markRetry(item.id, error, item.nextRunAt) ?? item;\n    log.warn({ goalId: item.goalId, attempts: item.attempts, nextRunAt: item.nextRunAt, errorMessage: error }, `Goal run queued for retry: ${error}`);\n    this.emit('goal.queue.updated', item);\n    this.schedulePump(Math.max(0, item.nextRunAt - Date.now()));\n  }\n\n  private finish(item: GoalQueueItemSnapshot, status: GoalQueueStatus, error?: string): void {\n    item = this.store.markFinished(item.id, status, error) ?? { ...item, status, finishedAt: Date.now(), lastError: error };\n    if (status === 'failed') {\n      log.warn({ goalId: item.goalId, attempts: item.attempts, errorMessage: error }, `Goal run failed: ${error}`);\n    }\n    this.emit('goal.queue.updated', item);\n  }\n\n  private emit(type: string, item: GoalQueueItemSnapshot): void {\n    this.opts.emit?.(type, { item: { ...item } });\n  }\n}\n"],"mappings":"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"}

package/dist/src/goals/goal-service.d.ts

@@ -1,6 +1,6 @@
 import type { Config } from '../config/schema.js';
 import { GoalStore } from './goal-store.js';
-import type { CreateGoalInput, Goal, GoalChecklistAddedBy, GoalChecklistStatus, GoalContextAttachment, GoalJudgeDecision, GoalListQuery, GoalSource, GoalStatus, GoalUiLocale, GoalWithDetails } from './types.js';
+import type { CreateGoalInput, Goal, GoalChecklistAddedBy, GoalChecklistStatus, GoalContextAttachment, GoalContractInput, GoalEvidenceRequirementStatus, GoalEvidenceReviewSource, GoalJudgeDecision, GoalListQuery, GoalSource, GoalStatus, GoalUiLocale, GoalWithDetails } from './types.js';
 export declare class GoalService {
     private readonly store;
     constructor(store?: GoalStore);
@@ -17,6 +17,7 @@ export declare class GoalService {
         text: string;
         attachments?: GoalContextAttachment[];
     }): GoalWithDetails | null;
+    setContract(goalId: string, input: GoalContractInput): GoalWithDetails | null;
     update(goalId: string, patch: Partial<Pick<Goal, 'title' | 'description' | 'priority' | 'deadlineAt' | 'maxTurns' | 'judgeModelRef' | 'nextAction' | 'blockedReason' | 'activeSessionKey' | 'uiLocale' | 'projectId'>>): GoalWithDetails | null;
     setStatus(goalId: string, status: GoalStatus, opts?: {
         reason?: string;
@@ -78,5 +79,20 @@ export declare class GoalService {
     listEvents(goalId: string, limit?: number): import("./types.js").GoalEvent[];
     addEvidence(input: Parameters<GoalStore['addEvidence']>[0]): import("./types.js").GoalEvidence;
     listEvidence(goalId: string, limit?: number): import("./types.js").GoalEvidence[];
+    listEvidenceRequirements(goalId: string): import("./types.js").GoalEvidenceRequirement[];
+    linkEvidenceRequirement(input: Parameters<GoalStore['linkEvidenceRequirement']>[0]): import("./types.js").GoalEvidenceRequirement;
+    reviewEvidenceRequirement(input: {
+        goalId: string;
+        requirementId: string;
+        status: GoalEvidenceRequirementStatus;
+        reason: string;
+        confidence?: number;
+        reviewedBy: GoalEvidenceReviewSource;
+    }): import("./types.js").GoalEvidenceRequirement;
+    getCompletionReadiness(goalId: string): {
+        ready: boolean;
+        missingEvidence: string[];
+        pendingApproval: string[];
+    } | null;
 }
 export declare function normalizeGoalUiLocale(raw: unknown): GoalUiLocale | undefined;

package/dist/src/goals/goal-service.js

@@ -55,7 +55,8 @@ var GoalService = class {
 			maxTurns: input.maxTurns ?? defaultMaxTurns(cfg),
 			uiLocale: input.uiLocale,
 			source: input.source,
-			projectId: input.projectId
+			projectId: input.projectId,
+			contract: input.contract
 		});
 		publishGoalEvent("goal.created", goal);
 		return goal;
@@ -67,7 +68,9 @@ var GoalService = class {
 			...goal,
 			checklist: this.store.listChecklist(goalId),
 			latestRun: this.store.listRuns(goalId, 1)[0],
-			contextMessage: this.store.getContextMessage(goalId) ?? void 0
+			contextMessage: this.store.getContextMessage(goalId) ?? void 0,
+			contract: this.store.getContract(goalId) ?? void 0,
+			evidenceRequirements: this.store.listEvidenceRequirements(goalId)
 		};
 	}
 	getActiveForSession(sessionKey) {
@@ -79,7 +82,9 @@ var GoalService = class {
 			...goal,
 			checklist: this.store.listChecklist(goal.id),
 			latestRun: this.store.listRuns(goal.id, 1)[0],
-			contextMessage: this.store.getContextMessage(goal.id) ?? void 0
+			contextMessage: this.store.getContextMessage(goal.id) ?? void 0,
+			contract: this.store.getContract(goal.id) ?? void 0,
+			evidenceRequirements: this.store.listEvidenceRequirements(goal.id)
 		}));
 	}
 	setContextMessage(input) {
@@ -87,6 +92,16 @@ var GoalService = class {
 		this.store.setContextMessage(input);
 		return this.get(input.goalId);
 	}
+	setContract(goalId, input) {
+		if (!this.store.get(goalId)) return null;
+		this.store.setContract(goalId, input);
+		if (input.criteria) this.store.replaceChecklist(goalId, input.criteria.map((text) => text.trim()).filter(Boolean).map((text) => ({
+			text,
+			status: "pending",
+			addedBy: "user"
+		})));
+		return this.get(goalId);
+	}
 	update(goalId, patch) {
 		const normalized = { ...patch };
 		if (typeof normalized.title === "string") normalized.title = normalizeTitle(normalized.title);
@@ -295,6 +310,32 @@ var GoalService = class {
 	listEvidence(goalId, limit) {
 		return this.store.listEvidence(goalId, limit);
 	}
+	listEvidenceRequirements(goalId) {
+		return this.store.listEvidenceRequirements(goalId);
+	}
+	linkEvidenceRequirement(input) {
+		return this.store.linkEvidenceRequirement(input);
+	}
+	reviewEvidenceRequirement(input) {
+		return this.store.reviewEvidenceRequirement(input);
+	}
+	getCompletionReadiness(goalId) {
+		const goal = this.get(goalId);
+		if (!goal) return null;
+		const required = goal.evidenceRequirements;
+		if (!required.length) return {
+			ready: true,
+			missingEvidence: [],
+			pendingApproval: []
+		};
+		const missingEvidence = required.filter((item) => item.evidenceIds.length === 0).map((item) => item.text);
+		const pendingApproval = required.filter((item) => item.evidenceIds.length > 0 && item.status !== "approved").map((item) => item.text);
+		return {
+			ready: missingEvidence.length === 0 && pendingApproval.length === 0,
+			missingEvidence,
+			pendingApproval
+		};
+	}
 };
 function normalizeGoalUiLocale(raw) {
 	return raw === "en" || raw === "zh" ? raw : void 0;

package/dist/src/goals/goal-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"goal-service.js","names":[],"sources":["../../../src/goals/goal-service.ts"],"sourcesContent":["import type { Config } from '../config/schema.js';\nimport { defaultMaxTurns } from '../agent/goals/state.js';\nimport { publishAutomationProductEvent } from '../automations/product-events.js';\nimport { GoalStore } from './goal-store.js';\nimport type {\n  CreateGoalInput,\n  Goal,\n  GoalChecklistAddedBy,\n  GoalChecklistStatus,\n  GoalContextAttachment,\n  GoalJudgeDecision,\n  GoalListQuery,\n  GoalSource,\n  GoalStatus,\n  GoalUiLocale,\n  GoalWithDetails,\n} from './types.js';\n\nfunction normalizeTitle(title: string): string {\n  const t = title.trim();\n  if (!t) throw new Error('Goal title is required');\n  return t;\n}\n\nfunction toTerminalStatus(verdict: GoalJudgeDecision['verdict']): GoalStatus {\n  if (verdict === 'done') return 'done';\n  if (verdict === 'blocked') return 'blocked';\n  if (verdict === 'needs_input') return 'needs_input';\n  return 'active';\n}\n\nfunction publishGoalEvent(\n  type: 'goal.created' | 'goal.status_changed',\n  goal: Goal,\n  extra?: Record<string, unknown>,\n): void {\n  publishAutomationProductEvent({\n    type,\n    source: 'goals',\n    payload: {\n      goalId: goal.id,\n      title: goal.title,\n      status: goal.status,\n      priority: goal.priority,\n      sessionKey: goal.activeSessionKey,\n      agentId: goal.agentId,\n      source: goal.source,\n      ...extra,\n    },\n  });\n}\n\nfunction publishGoalStatusEvent(\n  goal: Goal,\n  previousStatus?: GoalStatus,\n  reason?: string,\n): void {\n  if (previousStatus === goal.status) return;\n  publishGoalEvent('goal.status_changed', goal, {\n    previousStatus,\n    reason,\n  });\n}\n\nexport class GoalService {\n  private readonly store: GoalStore;\n\n  constructor(store = new GoalStore()) {\n    this.store = store;\n  }\n\n  create(input: Omit<CreateGoalInput, 'maxTurns' | 'agentId'> & {\n    maxTurns?: number;\n    agentId?: string;\n    config?: Config;\n  }): Goal {\n    const sessionKey = input.sessionKey;\n    const cfg = input.config?.goals;\n    const goal = this.store.create({\n      title: normalizeTitle(input.title),\n      description: input.description,\n      agentId: input.agentId ?? 'main',\n      sessionKey,\n      priority: input.priority,\n      deadlineAt: input.deadlineAt,\n      judgeModelRef: input.judgeModelRef ?? cfg?.judgeModelRef,\n      maxTurns: input.maxTurns ?? defaultMaxTurns(cfg),\n      uiLocale: input.uiLocale,\n      source: input.source,\n      projectId: input.projectId,\n    });\n    publishGoalEvent('goal.created', goal);\n    return goal;\n  }\n\n  get(goalId: string): GoalWithDetails | null {\n    const goal = this.store.get(goalId);\n    if (!goal) return null;\n    return {\n      ...goal,\n      checklist: this.store.listChecklist(goalId),\n      latestRun: this.store.listRuns(goalId, 1)[0],\n      contextMessage: this.store.getContextMessage(goalId) ?? undefined,\n    };\n  }\n\n  getActiveForSession(sessionKey: string): GoalWithDetails | null {\n    const goal = this.store.getActiveForSession(sessionKey);\n    return goal ? this.get(goal.id) : null;\n  }\n\n  list(query: GoalListQuery = {}): GoalWithDetails[] {\n    return this.store.list(query).map((goal) => ({\n      ...goal,\n      checklist: this.store.listChecklist(goal.id),\n      latestRun: this.store.listRuns(goal.id, 1)[0],\n      contextMessage: this.store.getContextMessage(goal.id) ?? undefined,\n    }));\n  }\n\n  setContextMessage(input: {\n    goalId: string;\n    text: string;\n    attachments?: GoalContextAttachment[];\n  }): GoalWithDetails | null {\n    if (!this.store.get(input.goalId)) return null;\n    this.store.setContextMessage(input);\n    return this.get(input.goalId);\n  }\n\n  update(goalId: string, patch: Partial<Pick<\n    Goal,\n    | 'title'\n    | 'description'\n    | 'priority'\n    | 'deadlineAt'\n    | 'maxTurns'\n    | 'judgeModelRef'\n    | 'nextAction'\n    | 'blockedReason'\n    | 'activeSessionKey'\n    | 'uiLocale'\n    | 'projectId'\n  >>): GoalWithDetails | null {\n    const normalized: typeof patch = { ...patch };\n    if (typeof normalized.title === 'string') {\n      normalized.title = normalizeTitle(normalized.title);\n    }\n    if (typeof normalized.description === 'string') {\n      normalized.description = normalized.description.trim() || undefined;\n    }\n    if (typeof normalized.judgeModelRef === 'string') {\n      normalized.judgeModelRef = normalized.judgeModelRef.trim() || undefined;\n    }\n    if (typeof normalized.nextAction === 'string') {\n      normalized.nextAction = normalized.nextAction.trim() || undefined;\n    }\n    if (typeof normalized.blockedReason === 'string') {\n      normalized.blockedReason = normalized.blockedReason.trim() || undefined;\n    }\n    if (typeof normalized.maxTurns === 'number') {\n      normalized.maxTurns = Math.max(1, Math.min(500, Math.floor(normalized.maxTurns)));\n    }\n    const goal = this.store.update(goalId, normalized);\n    return goal ? this.get(goal.id) : null;\n  }\n\n  setStatus(goalId: string, status: GoalStatus, opts?: { reason?: string }): GoalWithDetails | null {\n    const previous = this.store.get(goalId);\n    const now = Date.now();\n    const goal = this.store.update(goalId, {\n      status,\n      completedAt: status === 'done' ? now : undefined,\n      archivedAt: status === 'archived' ? now : undefined,\n      blockedReason: status === 'blocked' || status === 'needs_input' ? opts?.reason : undefined,\n    });\n    if (goal) publishGoalStatusEvent(goal, previous?.status, opts?.reason);\n    return goal ? this.get(goal.id) : null;\n  }\n\n  pause(goalId: string, reason = 'user-paused'): GoalWithDetails | null {\n    const previous = this.store.get(goalId);\n    const goal = this.store.update(goalId, {\n      status: 'paused',\n      blockedReason: reason,\n      completedAt: undefined,\n      archivedAt: undefined,\n    });\n    if (goal) publishGoalStatusEvent(goal, previous?.status, reason);\n    return goal ? this.get(goal.id) : null;\n  }\n\n  resume(goalId: string): GoalWithDetails | null {\n    const previous = this.store.get(goalId);\n    const goal = this.store.update(goalId, {\n      status: 'active',\n      blockedReason: undefined,\n      completedAt: undefined,\n      archivedAt: undefined,\n      turnsUsed: 0,\n    });\n    if (goal) publishGoalStatusEvent(goal, previous?.status);\n    return goal ? this.get(goal.id) : null;\n  }\n\n  reopen(goalId: string): GoalWithDetails | null {\n    const previous = this.store.get(goalId);\n    const goal = this.store.update(goalId, {\n      status: 'active',\n      blockedReason: undefined,\n      completedAt: undefined,\n      archivedAt: undefined,\n      turnsUsed: 0,\n    });\n    if (goal) publishGoalStatusEvent(goal, previous?.status);\n    return goal ? this.get(goal.id) : null;\n  }\n\n  complete(goalId: string): GoalWithDetails | null {\n    return this.setStatus(goalId, 'done');\n  }\n\n  archive(goalId: string): GoalWithDetails | null {\n    return this.setStatus(goalId, 'archived');\n  }\n\n  unarchive(goalId: string): GoalWithDetails | null {\n    const previous = this.store.get(goalId);\n    const goal = this.store.update(goalId, {\n      status: 'paused',\n      archivedAt: undefined,\n      completedAt: undefined,\n      blockedReason: undefined,\n    });\n    if (goal) publishGoalStatusEvent(goal, previous?.status);\n    return goal ? this.get(goal.id) : null;\n  }\n\n  attachSession(goalId: string, sessionKey: string): GoalWithDetails | null {\n    const goal = this.store.update(goalId, { activeSessionKey: sessionKey });\n    return goal ? this.get(goal.id) : null;\n  }\n\n  updateChecklist(goalId: string, op: {\n    type: 'add';\n    text: string;\n    addedBy?: GoalChecklistAddedBy;\n  } | {\n    type: 'mark';\n    itemId: string;\n    status: GoalChecklistStatus;\n    evidenceSummary?: string;\n  } | {\n    type: 'remove';\n    itemId: string;\n  } | {\n    type: 'reset';\n  }): GoalWithDetails | null {\n    if (op.type === 'add') {\n      const text = op.text.trim();\n      if (!text) throw new Error('Checklist item text is required');\n      this.store.addChecklistItem({ goalId, text, addedBy: op.addedBy ?? 'user' });\n    } else if (op.type === 'mark') {\n      this.store.updateChecklistItem(op.itemId, {\n        status: op.status,\n        evidenceSummary: op.evidenceSummary,\n      });\n    } else if (op.type === 'remove') {\n      this.store.removeChecklistItem(op.itemId);\n    } else {\n      this.store.clearChecklist(goalId);\n    }\n    return this.get(goalId);\n  }\n\n  recordJudgeDecision(input: {\n    goalId: string;\n    sessionKey: string;\n    source: GoalSource;\n    decision: GoalJudgeDecision;\n  }): GoalWithDetails | null {\n    const goal = this.store.get(input.goalId);\n    if (!goal) return null;\n    const previousStatus = goal.status;\n    const nextStatus = toTerminalStatus(input.decision.verdict);\n    const turnsUsed = goal.turnsUsed + 1;\n    const status = turnsUsed >= goal.maxTurns && nextStatus === 'active' ? 'paused' : nextStatus;\n    const reason =\n      status === 'paused' && turnsUsed >= goal.maxTurns\n        ? `turn budget exhausted (${turnsUsed}/${goal.maxTurns})`\n        : input.decision.reason;\n\n    const run = this.store.appendRun({\n      goalId: input.goalId,\n      sessionKey: input.sessionKey,\n      source: input.source,\n      status: 'succeeded',\n      finishedAt: Date.now(),\n      verdict: input.decision.verdict,\n      reason: input.decision.reason,\n      nextAction: input.decision.nextAction,\n      assistantPreview: input.decision.assistantPreview,\n      checklistProgress: input.decision.checklistProgress,\n      confidence: input.decision.confidence,\n      missingEvidence: input.decision.missingEvidence,\n      userQuestion: input.decision.userQuestion,\n      completedChecklistItemIds: input.decision.completedChecklistItemIds,\n    });\n\n    const updated = this.store.update(input.goalId, {\n      status,\n      turnsUsed,\n      currentRunId: run.id,\n      nextAction: input.decision.nextAction,\n      blockedReason: status === 'blocked' || status === 'needs_input' || status === 'paused' ? reason : undefined,\n      completedAt: status === 'done' ? Date.now() : undefined,\n    });\n    if (updated) publishGoalStatusEvent(updated, previousStatus, reason);\n\n    return this.get(input.goalId);\n  }\n\n  syncPostTurnState(input: {\n    goalId: string;\n    sessionKey: string;\n    source: GoalSource;\n    status: GoalStatus;\n    turnsUsed: number;\n    maxTurns: number;\n    reason?: string;\n    nextAction?: string;\n    assistantPreview?: string;\n    verdict: 'continue' | 'done' | 'blocked' | 'needs_input' | 'decompose';\n    confidence?: number;\n    missingEvidence?: string[];\n    userQuestion?: string;\n    completedChecklistItemIds?: string[];\n    checklist?: Array<{\n      text: string;\n      status: 'pending' | 'completed' | 'impossible';\n      addedBy: 'user' | 'judge';\n      addedAt?: number;\n      completedAt?: number;\n      evidenceSummary?: string;\n    }>;\n  }): GoalWithDetails | null {\n    const goal = this.store.get(input.goalId);\n    if (!goal) return null;\n    const previousStatus = goal.status;\n    if (input.checklist) {\n      this.store.replaceChecklist(input.goalId, input.checklist);\n    }\n    const total = input.checklist?.length ?? this.store.listChecklist(input.goalId).length;\n    const done = (input.checklist ?? this.store.listChecklist(input.goalId)).filter(\n      (it) => it.status === 'completed' || it.status === 'impossible',\n    ).length;\n    const run = this.store.appendRun({\n      goalId: input.goalId,\n      sessionKey: input.sessionKey,\n      source: input.source,\n      status: 'succeeded',\n      finishedAt: Date.now(),\n      verdict: input.verdict,\n      reason: input.reason,\n      nextAction: input.nextAction,\n      assistantPreview: input.assistantPreview,\n      checklistProgress: total > 0 ? { done, total } : undefined,\n      confidence: input.confidence,\n      missingEvidence: input.missingEvidence,\n      userQuestion: input.userQuestion,\n      completedChecklistItemIds: input.completedChecklistItemIds,\n    });\n    for (const item of input.checklist ?? []) {\n      if ((item.status === 'completed' || item.status === 'impossible') && item.evidenceSummary?.trim()) {\n        this.store.addEvidence({\n          goalId: input.goalId,\n          runId: run.id,\n          kind: 'message',\n          title: `Checklist evidence: ${item.text.slice(0, 80)}`,\n          summary: item.evidenceSummary.trim(),\n        });\n      }\n    }\n    for (const missing of input.missingEvidence ?? []) {\n      if (!missing.trim()) continue;\n      this.store.addEvidence({\n        goalId: input.goalId,\n        runId: run.id,\n        kind: 'message',\n        title: `Missing evidence: ${missing.slice(0, 80)}`,\n        summary: missing,\n      });\n    }\n    if (input.userQuestion?.trim()) {\n      this.store.addEvidence({\n        goalId: input.goalId,\n        runId: run.id,\n        kind: 'message',\n        title: 'User input requested',\n        summary: input.userQuestion.trim(),\n      });\n    }\n    const updated = this.store.update(input.goalId, {\n      status: input.status,\n      turnsUsed: input.turnsUsed,\n      maxTurns: input.maxTurns,\n      currentRunId: run.id,\n      nextAction: input.nextAction,\n      blockedReason:\n        input.status === 'blocked' || input.status === 'needs_input' || input.status === 'paused'\n          ? input.reason\n          : undefined,\n      completedAt: input.status === 'done' ? Date.now() : undefined,\n    });\n    if (updated) publishGoalStatusEvent(updated, previousStatus, input.reason);\n    return this.get(input.goalId);\n  }\n\n  listRuns(goalId: string, limit?: number) {\n    return this.store.listRuns(goalId, limit);\n  }\n\n  listRunsForSession(sessionKey: string, limit?: number) {\n    return this.store.listRunsForSession(sessionKey, limit);\n  }\n\n  listEvents(goalId: string, limit?: number) {\n    return this.store.listEvents(goalId, limit);\n  }\n\n  addEvidence(input: Parameters<GoalStore['addEvidence']>[0]) {\n    return this.store.addEvidence(input);\n  }\n\n  listEvidence(goalId: string, limit?: number) {\n    return this.store.listEvidence(goalId, limit);\n  }\n}\n\nexport function normalizeGoalUiLocale(raw: unknown): GoalUiLocale | undefined {\n  return raw === 'en' || raw === 'zh' ? raw : undefined;\n}\n"],"mappings":"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"}
+{"version":3,"file":"goal-service.js","names":[],"sources":["../../../src/goals/goal-service.ts"],"sourcesContent":["import type { Config } from '../config/schema.js';\nimport { defaultMaxTurns } from '../agent/goals/state.js';\nimport { publishAutomationProductEvent } from '../automations/product-events.js';\nimport { GoalStore } from './goal-store.js';\nimport type {\n  CreateGoalInput,\n  Goal,\n  GoalChecklistAddedBy,\n  GoalChecklistStatus,\n  GoalContextAttachment,\n  GoalContractInput,\n  GoalEvidenceRequirementStatus,\n  GoalEvidenceReviewSource,\n  GoalJudgeDecision,\n  GoalListQuery,\n  GoalSource,\n  GoalStatus,\n  GoalUiLocale,\n  GoalWithDetails,\n} from './types.js';\n\nfunction normalizeTitle(title: string): string {\n  const t = title.trim();\n  if (!t) throw new Error('Goal title is required');\n  return t;\n}\n\nfunction toTerminalStatus(verdict: GoalJudgeDecision['verdict']): GoalStatus {\n  if (verdict === 'done') return 'done';\n  if (verdict === 'blocked') return 'blocked';\n  if (verdict === 'needs_input') return 'needs_input';\n  return 'active';\n}\n\nfunction publishGoalEvent(\n  type: 'goal.created' | 'goal.status_changed',\n  goal: Goal,\n  extra?: Record<string, unknown>,\n): void {\n  publishAutomationProductEvent({\n    type,\n    source: 'goals',\n    payload: {\n      goalId: goal.id,\n      title: goal.title,\n      status: goal.status,\n      priority: goal.priority,\n      sessionKey: goal.activeSessionKey,\n      agentId: goal.agentId,\n      source: goal.source,\n      ...extra,\n    },\n  });\n}\n\nfunction publishGoalStatusEvent(\n  goal: Goal,\n  previousStatus?: GoalStatus,\n  reason?: string,\n): void {\n  if (previousStatus === goal.status) return;\n  publishGoalEvent('goal.status_changed', goal, {\n    previousStatus,\n    reason,\n  });\n}\n\nexport class GoalService {\n  private readonly store: GoalStore;\n\n  constructor(store = new GoalStore()) {\n    this.store = store;\n  }\n\n  create(input: Omit<CreateGoalInput, 'maxTurns' | 'agentId'> & {\n    maxTurns?: number;\n    agentId?: string;\n    config?: Config;\n  }): Goal {\n    const sessionKey = input.sessionKey;\n    const cfg = input.config?.goals;\n    const goal = this.store.create({\n      title: normalizeTitle(input.title),\n      description: input.description,\n      agentId: input.agentId ?? 'main',\n      sessionKey,\n      priority: input.priority,\n      deadlineAt: input.deadlineAt,\n      judgeModelRef: input.judgeModelRef ?? cfg?.judgeModelRef,\n      maxTurns: input.maxTurns ?? defaultMaxTurns(cfg),\n      uiLocale: input.uiLocale,\n      source: input.source,\n      projectId: input.projectId,\n      contract: input.contract,\n    });\n    publishGoalEvent('goal.created', goal);\n    return goal;\n  }\n\n  get(goalId: string): GoalWithDetails | null {\n    const goal = this.store.get(goalId);\n    if (!goal) return null;\n    return {\n      ...goal,\n      checklist: this.store.listChecklist(goalId),\n      latestRun: this.store.listRuns(goalId, 1)[0],\n      contextMessage: this.store.getContextMessage(goalId) ?? undefined,\n      contract: this.store.getContract(goalId) ?? undefined,\n      evidenceRequirements: this.store.listEvidenceRequirements(goalId),\n    };\n  }\n\n  getActiveForSession(sessionKey: string): GoalWithDetails | null {\n    const goal = this.store.getActiveForSession(sessionKey);\n    return goal ? this.get(goal.id) : null;\n  }\n\n  list(query: GoalListQuery = {}): GoalWithDetails[] {\n    return this.store.list(query).map((goal) => ({\n      ...goal,\n      checklist: this.store.listChecklist(goal.id),\n      latestRun: this.store.listRuns(goal.id, 1)[0],\n      contextMessage: this.store.getContextMessage(goal.id) ?? undefined,\n      contract: this.store.getContract(goal.id) ?? undefined,\n      evidenceRequirements: this.store.listEvidenceRequirements(goal.id),\n    }));\n  }\n\n  setContextMessage(input: {\n    goalId: string;\n    text: string;\n    attachments?: GoalContextAttachment[];\n  }): GoalWithDetails | null {\n    if (!this.store.get(input.goalId)) return null;\n    this.store.setContextMessage(input);\n    return this.get(input.goalId);\n  }\n\n  setContract(goalId: string, input: GoalContractInput): GoalWithDetails | null {\n    if (!this.store.get(goalId)) return null;\n    this.store.setContract(goalId, input);\n    if (input.criteria) {\n      this.store.replaceChecklist(\n        goalId,\n        input.criteria\n          .map((text) => text.trim())\n          .filter(Boolean)\n          .map((text) => ({ text, status: 'pending', addedBy: 'user' })),\n      );\n    }\n    return this.get(goalId);\n  }\n\n  update(goalId: string, patch: Partial<Pick<\n    Goal,\n    | 'title'\n    | 'description'\n    | 'priority'\n    | 'deadlineAt'\n    | 'maxTurns'\n    | 'judgeModelRef'\n    | 'nextAction'\n    | 'blockedReason'\n    | 'activeSessionKey'\n    | 'uiLocale'\n    | 'projectId'\n  >>): GoalWithDetails | null {\n    const normalized: typeof patch = { ...patch };\n    if (typeof normalized.title === 'string') {\n      normalized.title = normalizeTitle(normalized.title);\n    }\n    if (typeof normalized.description === 'string') {\n      normalized.description = normalized.description.trim() || undefined;\n    }\n    if (typeof normalized.judgeModelRef === 'string') {\n      normalized.judgeModelRef = normalized.judgeModelRef.trim() || undefined;\n    }\n    if (typeof normalized.nextAction === 'string') {\n      normalized.nextAction = normalized.nextAction.trim() || undefined;\n    }\n    if (typeof normalized.blockedReason === 'string') {\n      normalized.blockedReason = normalized.blockedReason.trim() || undefined;\n    }\n    if (typeof normalized.maxTurns === 'number') {\n      normalized.maxTurns = Math.max(1, Math.min(500, Math.floor(normalized.maxTurns)));\n    }\n    const goal = this.store.update(goalId, normalized);\n    return goal ? this.get(goal.id) : null;\n  }\n\n  setStatus(goalId: string, status: GoalStatus, opts?: { reason?: string }): GoalWithDetails | null {\n    const previous = this.store.get(goalId);\n    const now = Date.now();\n    const goal = this.store.update(goalId, {\n      status,\n      completedAt: status === 'done' ? now : undefined,\n      archivedAt: status === 'archived' ? now : undefined,\n      blockedReason: status === 'blocked' || status === 'needs_input' ? opts?.reason : undefined,\n    });\n    if (goal) publishGoalStatusEvent(goal, previous?.status, opts?.reason);\n    return goal ? this.get(goal.id) : null;\n  }\n\n  pause(goalId: string, reason = 'user-paused'): GoalWithDetails | null {\n    const previous = this.store.get(goalId);\n    const goal = this.store.update(goalId, {\n      status: 'paused',\n      blockedReason: reason,\n      completedAt: undefined,\n      archivedAt: undefined,\n    });\n    if (goal) publishGoalStatusEvent(goal, previous?.status, reason);\n    return goal ? this.get(goal.id) : null;\n  }\n\n  resume(goalId: string): GoalWithDetails | null {\n    const previous = this.store.get(goalId);\n    const goal = this.store.update(goalId, {\n      status: 'active',\n      blockedReason: undefined,\n      completedAt: undefined,\n      archivedAt: undefined,\n      turnsUsed: 0,\n    });\n    if (goal) publishGoalStatusEvent(goal, previous?.status);\n    return goal ? this.get(goal.id) : null;\n  }\n\n  reopen(goalId: string): GoalWithDetails | null {\n    const previous = this.store.get(goalId);\n    const goal = this.store.update(goalId, {\n      status: 'active',\n      blockedReason: undefined,\n      completedAt: undefined,\n      archivedAt: undefined,\n      turnsUsed: 0,\n    });\n    if (goal) publishGoalStatusEvent(goal, previous?.status);\n    return goal ? this.get(goal.id) : null;\n  }\n\n  complete(goalId: string): GoalWithDetails | null {\n    return this.setStatus(goalId, 'done');\n  }\n\n  archive(goalId: string): GoalWithDetails | null {\n    return this.setStatus(goalId, 'archived');\n  }\n\n  unarchive(goalId: string): GoalWithDetails | null {\n    const previous = this.store.get(goalId);\n    const goal = this.store.update(goalId, {\n      status: 'paused',\n      archivedAt: undefined,\n      completedAt: undefined,\n      blockedReason: undefined,\n    });\n    if (goal) publishGoalStatusEvent(goal, previous?.status);\n    return goal ? this.get(goal.id) : null;\n  }\n\n  attachSession(goalId: string, sessionKey: string): GoalWithDetails | null {\n    const goal = this.store.update(goalId, { activeSessionKey: sessionKey });\n    return goal ? this.get(goal.id) : null;\n  }\n\n  updateChecklist(goalId: string, op: {\n    type: 'add';\n    text: string;\n    addedBy?: GoalChecklistAddedBy;\n  } | {\n    type: 'mark';\n    itemId: string;\n    status: GoalChecklistStatus;\n    evidenceSummary?: string;\n  } | {\n    type: 'remove';\n    itemId: string;\n  } | {\n    type: 'reset';\n  }): GoalWithDetails | null {\n    if (op.type === 'add') {\n      const text = op.text.trim();\n      if (!text) throw new Error('Checklist item text is required');\n      this.store.addChecklistItem({ goalId, text, addedBy: op.addedBy ?? 'user' });\n    } else if (op.type === 'mark') {\n      this.store.updateChecklistItem(op.itemId, {\n        status: op.status,\n        evidenceSummary: op.evidenceSummary,\n      });\n    } else if (op.type === 'remove') {\n      this.store.removeChecklistItem(op.itemId);\n    } else {\n      this.store.clearChecklist(goalId);\n    }\n    return this.get(goalId);\n  }\n\n  recordJudgeDecision(input: {\n    goalId: string;\n    sessionKey: string;\n    source: GoalSource;\n    decision: GoalJudgeDecision;\n  }): GoalWithDetails | null {\n    const goal = this.store.get(input.goalId);\n    if (!goal) return null;\n    const previousStatus = goal.status;\n    const nextStatus = toTerminalStatus(input.decision.verdict);\n    const turnsUsed = goal.turnsUsed + 1;\n    const status = turnsUsed >= goal.maxTurns && nextStatus === 'active' ? 'paused' : nextStatus;\n    const reason =\n      status === 'paused' && turnsUsed >= goal.maxTurns\n        ? `turn budget exhausted (${turnsUsed}/${goal.maxTurns})`\n        : input.decision.reason;\n\n    const run = this.store.appendRun({\n      goalId: input.goalId,\n      sessionKey: input.sessionKey,\n      source: input.source,\n      status: 'succeeded',\n      finishedAt: Date.now(),\n      verdict: input.decision.verdict,\n      reason: input.decision.reason,\n      nextAction: input.decision.nextAction,\n      assistantPreview: input.decision.assistantPreview,\n      checklistProgress: input.decision.checklistProgress,\n      confidence: input.decision.confidence,\n      missingEvidence: input.decision.missingEvidence,\n      userQuestion: input.decision.userQuestion,\n      completedChecklistItemIds: input.decision.completedChecklistItemIds,\n    });\n\n    const updated = this.store.update(input.goalId, {\n      status,\n      turnsUsed,\n      currentRunId: run.id,\n      nextAction: input.decision.nextAction,\n      blockedReason: status === 'blocked' || status === 'needs_input' || status === 'paused' ? reason : undefined,\n      completedAt: status === 'done' ? Date.now() : undefined,\n    });\n    if (updated) publishGoalStatusEvent(updated, previousStatus, reason);\n\n    return this.get(input.goalId);\n  }\n\n  syncPostTurnState(input: {\n    goalId: string;\n    sessionKey: string;\n    source: GoalSource;\n    status: GoalStatus;\n    turnsUsed: number;\n    maxTurns: number;\n    reason?: string;\n    nextAction?: string;\n    assistantPreview?: string;\n    verdict: 'continue' | 'done' | 'blocked' | 'needs_input' | 'decompose';\n    confidence?: number;\n    missingEvidence?: string[];\n    userQuestion?: string;\n    completedChecklistItemIds?: string[];\n    checklist?: Array<{\n      text: string;\n      status: 'pending' | 'completed' | 'impossible';\n      addedBy: 'user' | 'judge';\n      addedAt?: number;\n      completedAt?: number;\n      evidenceSummary?: string;\n    }>;\n  }): GoalWithDetails | null {\n    const goal = this.store.get(input.goalId);\n    if (!goal) return null;\n    const previousStatus = goal.status;\n    if (input.checklist) {\n      this.store.replaceChecklist(input.goalId, input.checklist);\n    }\n    const total = input.checklist?.length ?? this.store.listChecklist(input.goalId).length;\n    const done = (input.checklist ?? this.store.listChecklist(input.goalId)).filter(\n      (it) => it.status === 'completed' || it.status === 'impossible',\n    ).length;\n    const run = this.store.appendRun({\n      goalId: input.goalId,\n      sessionKey: input.sessionKey,\n      source: input.source,\n      status: 'succeeded',\n      finishedAt: Date.now(),\n      verdict: input.verdict,\n      reason: input.reason,\n      nextAction: input.nextAction,\n      assistantPreview: input.assistantPreview,\n      checklistProgress: total > 0 ? { done, total } : undefined,\n      confidence: input.confidence,\n      missingEvidence: input.missingEvidence,\n      userQuestion: input.userQuestion,\n      completedChecklistItemIds: input.completedChecklistItemIds,\n    });\n    for (const item of input.checklist ?? []) {\n      if ((item.status === 'completed' || item.status === 'impossible') && item.evidenceSummary?.trim()) {\n        this.store.addEvidence({\n          goalId: input.goalId,\n          runId: run.id,\n          kind: 'message',\n          title: `Checklist evidence: ${item.text.slice(0, 80)}`,\n          summary: item.evidenceSummary.trim(),\n        });\n      }\n    }\n    for (const missing of input.missingEvidence ?? []) {\n      if (!missing.trim()) continue;\n      this.store.addEvidence({\n        goalId: input.goalId,\n        runId: run.id,\n        kind: 'message',\n        title: `Missing evidence: ${missing.slice(0, 80)}`,\n        summary: missing,\n      });\n    }\n    if (input.userQuestion?.trim()) {\n      this.store.addEvidence({\n        goalId: input.goalId,\n        runId: run.id,\n        kind: 'message',\n        title: 'User input requested',\n        summary: input.userQuestion.trim(),\n      });\n    }\n    const updated = this.store.update(input.goalId, {\n      status: input.status,\n      turnsUsed: input.turnsUsed,\n      maxTurns: input.maxTurns,\n      currentRunId: run.id,\n      nextAction: input.nextAction,\n      blockedReason:\n        input.status === 'blocked' || input.status === 'needs_input' || input.status === 'paused'\n          ? input.reason\n          : undefined,\n      completedAt: input.status === 'done' ? Date.now() : undefined,\n    });\n    if (updated) publishGoalStatusEvent(updated, previousStatus, input.reason);\n    return this.get(input.goalId);\n  }\n\n  listRuns(goalId: string, limit?: number) {\n    return this.store.listRuns(goalId, limit);\n  }\n\n  listRunsForSession(sessionKey: string, limit?: number) {\n    return this.store.listRunsForSession(sessionKey, limit);\n  }\n\n  listEvents(goalId: string, limit?: number) {\n    return this.store.listEvents(goalId, limit);\n  }\n\n  addEvidence(input: Parameters<GoalStore['addEvidence']>[0]) {\n    return this.store.addEvidence(input);\n  }\n\n  listEvidence(goalId: string, limit?: number) {\n    return this.store.listEvidence(goalId, limit);\n  }\n\n  listEvidenceRequirements(goalId: string) {\n    return this.store.listEvidenceRequirements(goalId);\n  }\n\n  linkEvidenceRequirement(input: Parameters<GoalStore['linkEvidenceRequirement']>[0]) {\n    return this.store.linkEvidenceRequirement(input);\n  }\n\n  reviewEvidenceRequirement(input: {\n    goalId: string;\n    requirementId: string;\n    status: GoalEvidenceRequirementStatus;\n    reason: string;\n    confidence?: number;\n    reviewedBy: GoalEvidenceReviewSource;\n  }) {\n    return this.store.reviewEvidenceRequirement(input);\n  }\n\n  getCompletionReadiness(goalId: string): { ready: boolean; missingEvidence: string[]; pendingApproval: string[] } | null {\n    const goal = this.get(goalId);\n    if (!goal) return null;\n    const required = goal.evidenceRequirements;\n    if (!required.length) return { ready: true, missingEvidence: [], pendingApproval: [] };\n    const missingEvidence = required.filter((item) => item.evidenceIds.length === 0).map((item) => item.text);\n    const pendingApproval = required\n      .filter((item) => item.evidenceIds.length > 0 && item.status !== 'approved')\n      .map((item) => item.text);\n    return {\n      ready: missingEvidence.length === 0 && pendingApproval.length === 0,\n      missingEvidence,\n      pendingApproval,\n    };\n  }\n}\n\nexport function normalizeGoalUiLocale(raw: unknown): GoalUiLocale | undefined {\n  return raw === 'en' || raw === 'zh' ? raw : undefined;\n}\n"],"mappings":"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"}

package/dist/src/goals/goal-store.d.ts

@@ -1,4 +1,4 @@
-import type { CreateGoalInput, Goal, GoalChecklistAddedBy, GoalChecklistItem, GoalChecklistStatus, GoalContextAttachment, GoalContextMessage, GoalEvent, GoalEvidence, GoalListQuery, GoalRun } from './types.js';
+import type { CreateGoalInput, Goal, GoalChecklistAddedBy, GoalChecklistItem, GoalChecklistStatus, GoalContextAttachment, GoalContextMessage, GoalContract, GoalContractInput, GoalEvent, GoalEvidence, GoalEvidenceRequirement, GoalEvidenceRequirementStatus, GoalEvidenceReviewSource, GoalListQuery, GoalRun } from './types.js';
 export declare class GoalStore {
     create(input: CreateGoalInput): Goal;
     get(goalId: string): Goal | null;
@@ -8,6 +8,8 @@ export declare class GoalStore {
         attachments?: GoalContextAttachment[];
     }): GoalContextMessage;
     getContextMessage(goalId: string): GoalContextMessage | null;
+    getContract(goalId: string): GoalContract | null;
+    setContract(goalId: string, input: GoalContractInput): GoalContract | null;
     getActiveForSession(sessionKey: string): Goal | null;
     list(query?: GoalListQuery): Goal[];
     update(goalId: string, patch: Partial<Pick<Goal, 'title' | 'description' | 'status' | 'priority' | 'deadlineAt' | 'completedAt' | 'archivedAt' | 'activeSessionKey' | 'currentRunId' | 'nextAction' | 'blockedReason' | 'judgeModelRef' | 'maxTurns' | 'turnsUsed' | 'uiLocale' | 'projectId'>>): Goal | null;
@@ -41,4 +43,19 @@ export declare class GoalStore {
         createdAt?: number;
     }): GoalEvidence;
     listEvidence(goalId: string, limit?: number): GoalEvidence[];
+    listEvidenceRequirements(goalId: string): GoalEvidenceRequirement[];
+    linkEvidenceRequirement(input: {
+        goalId: string;
+        requirementId: string;
+        evidenceId: string;
+        linkedBy: 'user' | 'agent' | 'system';
+    }): GoalEvidenceRequirement | null;
+    reviewEvidenceRequirement(input: {
+        goalId: string;
+        requirementId: string;
+        status: GoalEvidenceRequirementStatus;
+        reason: string;
+        confidence?: number;
+        reviewedBy: GoalEvidenceReviewSource;
+    }): GoalEvidenceRequirement | null;
 }