snipara-companion 2.0.1 → 2.0.3

package/README.md

@@ -72,6 +72,12 @@ blocked by default; use `--allow-sensitive` only when you intentionally need an
 exact local recovery artifact, and prefer the exact pack ID over `latest` in
 handoffs.
 
+Metadata-only context-pack receipts include token economy fields:
+`baseline_tokens`, `packed_tokens`, `retrieved_tokens`, and `saved_tokens`.
+Pack/reference receipts can claim saved tokens because only receipt metadata is
+uploaded; retrieve receipts set retrieved tokens to the local baseline so they
+do not overstate savings.
+
 ```mermaid
 flowchart LR
     Project["Local project"] --> Companion["snipara-companion"]
@@ -244,6 +250,15 @@ Project owners can configure Adaptive Work Routing in Project > Automation:
 `off`, `recommend`, or `catalog`; approval; planner-retained reasoning; allowed
 endpoint types (`cloud`, `local`, `self_hosted`); worker classes; and budget
 hints. `workflow run` reads that hosted policy and CLI flags cannot broaden it.
+Companion passes policy budgets into provider-neutral model requirements; the
+hosted gateway enforces project and provider daily/monthly budgets when receipt
+history is available.
+
+Approval is an MCP contract, not a dashboard-only UX path. When project policy
+requires approval, a coding agent calls `snipara_adaptive_routing_approve` with
+the routing card or handoff subject, approved write scopes, endpoint types, a
+stable `idempotency_key`, and optional cost/expiry bounds. Companion dry-runs
+surface the approval requirement but do not auto-approve or spawn workers.
 Project credentials stay server-side behind the hosted gateway; local endpoints
 such as Ollama, LM Studio, AnythingLLM, or other OpenAI-compatible servers must
 be reachable from the worker execution environment.

package/dist/index.d.ts

@@ -160,6 +160,10 @@ interface LocalContextPackReceiptPayload {
     tags: string[];
     bytes: number;
     line_count: number;
+    baseline_tokens?: number;
+    packed_tokens?: number;
+    retrieved_tokens?: number;
+    saved_tokens?: number;
     payload_digest?: string;
     sensitive: boolean;
     created_at: string;
@@ -537,6 +541,41 @@ interface EmitEventResult {
     sessionIds: string[];
     events: AutomationCheckpointSummary[];
 }
+type AdvisorInfluenceAgentDecision = "accepted" | "modified" | "ignored" | "blocked";
+type AdvisorInfluenceOutcomeLinkStatus = "pending" | "linked" | "missed" | "unevaluated";
+interface AdvisorInfluenceRecommendationInput {
+    id: string;
+    version?: "advisor-recommendation-v0";
+    source: string;
+    severity: string;
+    title: string;
+    rationale: string;
+    reasonCodes: string[];
+    historicalImpactSummary?: string | null;
+    reasonCodeReliability?: number | null;
+    recommendedVerification: string[];
+    expectedBehaviorChange: string;
+    evidence?: unknown[];
+    caveats?: string[];
+}
+interface RecordAdvisorInfluenceReceiptInput {
+    servedJudgmentId: string;
+    recommendation: AdvisorInfluenceRecommendationInput;
+    agentDecision: AdvisorInfluenceAgentDecision;
+    behaviorChange: string;
+    verificationExecuted: string[];
+    outcomeLinkStatus?: AdvisorInfluenceOutcomeLinkStatus;
+    metadata?: Record<string, unknown>;
+}
+interface RecordAdvisorInfluenceReceiptResult {
+    project: {
+        id: string;
+        name: string;
+        slug: string;
+    };
+    receipt: Record<string, unknown>;
+    advisorInfluence: Record<string, unknown>;
+}
 interface AutomationConfigFile {
     path: string;
     content: string;
@@ -1175,6 +1214,7 @@ declare class RLMClient {
         privacy_level: "standard" | "sensitive" | "restricted";
         payload?: Record<string, unknown>;
     }): Promise<EmitEventResult>;
+    recordAdvisorInfluenceReceipt(input: RecordAdvisorInfluenceReceiptInput): Promise<RecordAdvisorInfluenceReceiptResult>;
     getAutomationEvents(args?: {
         sessionId?: string;
         limit?: number;
@@ -2000,6 +2040,8 @@ interface ProjectRunCommandOptions {
     skipMemoryHealth?: boolean;
     skipGuard?: boolean;
     skipPackageReview?: boolean;
+    servedJudgmentId?: string;
+    skipAdvisorReceipts?: boolean;
     json?: boolean;
 }
 interface ProjectRunGuardResult {
@@ -2017,6 +2059,20 @@ interface ProjectRunPackageReview {
     data?: unknown;
     error?: string;
 }
+interface ProjectRunAdvisorReceiptWrite {
+    advisorRecommendationId: string;
+    status: "recorded" | "error";
+    result?: RecordAdvisorInfluenceReceiptResult;
+    error?: string;
+}
+interface ProjectRunAdvisorReceiptCapture {
+    status: "skipped" | "recorded" | "partial" | "error";
+    servedJudgmentId?: string;
+    attemptedCount: number;
+    recordedCount: number;
+    writes: ProjectRunAdvisorReceiptWrite[];
+    reason?: string;
+}
 interface ProjectIntelligenceRunResult {
     version: "project-intelligence.production-run.v1";
     generatedAt: string;
@@ -2024,6 +2080,7 @@ interface ProjectIntelligenceRunResult {
     brief: ProjectIntelligenceBrief;
     guard?: ProjectRunGuardResult;
     packageReview?: ProjectRunPackageReview;
+    advisorReceiptCapture?: ProjectRunAdvisorReceiptCapture;
     judgmentCard: ProjectIntelligenceJudgmentCard;
     suggestedCommands: string[];
 }
@@ -3017,6 +3074,8 @@ interface AdaptiveModelRequirements {
     preferredEndpointTypes?: string[];
     allowedEndpointTypes?: string[];
     catalogLimit?: number;
+    dailyBudgetCents?: number;
+    monthlyBudgetCents?: number;
     fallback: "main_agent";
 }
 interface AdaptiveRoutingCostEstimate {
@@ -3062,6 +3121,8 @@ interface AdaptiveWorkRoutingOptions {
     workerRole?: string;
     plannerRetainsReasoning?: boolean;
     catalogLimit?: number;
+    dailyBudgetCents?: number;
+    monthlyBudgetCents?: number;
 }
 interface OrchestratorHandoffArtifact {
     schemaVersion: "snipara.orchestrator.handoff.v1";

package/dist/index.js

@@ -953,6 +953,19 @@ var RLMClient = class {
       clearTimeout(timeoutId);
     }
   }
+  async recordAdvisorInfluenceReceipt(input) {
+    return this.dashboardProjectRequest(
+      "/project-intelligence/advisor-influence",
+      {
+        method: "POST",
+        body: input
+      },
+      {
+        invalidMessage: "Advisor influence receipt write failed",
+        validate: (data) => Boolean(data.receipt && data.advisorInfluence)
+      }
+    );
+  }
   async getAutomationEvents(args) {
     if (!this.config.apiKey) {
       throw new Error("API key not configured. Run 'npx -y snipara-companion@latest init' first.");
@@ -2683,9 +2696,19 @@ async function contextPackCleanCommand(options = {}) {
 function uniqueStrings2(values) {
   return Array.from(new Set(values.map((value) => value.trim()).filter(Boolean)));
 }
+function estimateTokensFromBytes(bytes) {
+  if (!Number.isFinite(bytes) || bytes <= 0) {
+    return 0;
+  }
+  return Math.ceil(bytes / 4);
+}
+function estimateReceiptTokens(value) {
+  return estimateTokensFromBytes(Buffer.byteLength(JSON.stringify(value), "utf8"));
+}
 function buildLocalContextPackReceipt(record, options = {}) {
   const operation = options.operation ?? "reference";
-  return {
+  const baselineTokens = estimateTokensFromBytes(record.bytes);
+  const baseReceipt = {
     version: "snipara.context_pack.receipt.v1",
     receipt_id: `${record.id}:${operation}:${record.updatedAt}`,
     pack_id: record.id,
@@ -2708,6 +2731,16 @@ function buildLocalContextPackReceipt(record, options = {}) {
       manifest_relative_path: record.storage.manifestRelativePath
     }
   };
+  const packedTokens = estimateReceiptTokens(baseReceipt);
+  const retrievedTokens = operation === "retrieve" ? baselineTokens : 0;
+  const savedTokens = Math.max(0, baselineTokens - packedTokens - retrievedTokens);
+  return {
+    ...baseReceipt,
+    baseline_tokens: baselineTokens,
+    packed_tokens: packedTokens,
+    retrieved_tokens: retrievedTokens,
+    saved_tokens: savedTokens
+  };
 }
 function buildLocalContextPackReceipts(options) {
   return uniqueStrings2(options.ids).slice(0, 20).map((id) => {
@@ -11543,6 +11576,158 @@ function outputPreview(value) {
   return `${value.slice(0, RAW_OUTPUT_PREVIEW_BYTES)}
 ...[truncated]`;
 }
+function stringValue4(value) {
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+function servedJudgmentIdFromUnknown(value, depth = 0) {
+  if (depth > 5 || value === null || value === void 0) {
+    return void 0;
+  }
+  if (!isRecord7(value)) {
+    if (Array.isArray(value)) {
+      for (const item of value.slice(0, 12)) {
+        const found = servedJudgmentIdFromUnknown(item, depth + 1);
+        if (found) return found;
+      }
+    }
+    return void 0;
+  }
+  const direct = stringValue4(value.servedJudgmentId) ?? stringValue4(value.served_judgment_id);
+  if (direct) {
+    return direct;
+  }
+  for (const key of [
+    "projectIntelligence",
+    "project_intelligence",
+    "brief",
+    "judgment",
+    "resumeContext",
+    "resume_context",
+    "data"
+  ]) {
+    const found = servedJudgmentIdFromUnknown(value[key], depth + 1);
+    if (found) return found;
+  }
+  return void 0;
+}
+function servedJudgmentIdForRun(options, brief) {
+  return stringValue4(options.servedJudgmentId) ?? servedJudgmentIdFromUnknown(brief.resumeContext) ?? servedJudgmentIdFromUnknown(brief.verificationPlan);
+}
+function normalizeAdvisorSource(value) {
+  if (value === "judgment" || value === "outcome_calibration" || value === "historical_impact" || value === "safety" || value === "verification" || value === "context_quality") {
+    return value;
+  }
+  return "judgment";
+}
+function normalizeAdvisorSeverity2(value) {
+  if (value === "info" || value === "watch" || value === "risk" || value === "block") {
+    return value;
+  }
+  return "watch";
+}
+function advisorReceiptRecommendation(recommendation) {
+  return {
+    id: recommendation.id,
+    version: "advisor-recommendation-v0",
+    source: normalizeAdvisorSource(recommendation.source),
+    severity: normalizeAdvisorSeverity2(recommendation.severity),
+    title: recommendation.title,
+    rationale: recommendation.rationale ?? recommendation.expectedBehaviorChange ?? `Snipara recommended ${recommendation.title}.`,
+    reasonCodes: recommendation.reasonCodes,
+    historicalImpactSummary: recommendation.historicalImpactSummary ?? null,
+    reasonCodeReliability: recommendation.reasonCodeReliability ?? null,
+    recommendedVerification: recommendation.recommendedVerification,
+    expectedBehaviorChange: recommendation.expectedBehaviorChange ?? `Adapt the visible plan according to ${recommendation.title}.`,
+    evidence: [],
+    caveats: ["First-party companion receipt records plan adaptation, not outcome proof."]
+  };
+}
+function advisorReceiptDecision(recommendation, judgmentCard) {
+  if (recommendation.severity === "block" && judgmentCard.canProceed === "block") {
+    return "blocked";
+  }
+  return "modified";
+}
+function advisorReceiptBehaviorChange(recommendation, judgmentCard) {
+  const verification = recommendation.recommendedVerification.slice(0, 3).join("; ");
+  const mode = recommendation.severity === "block" || recommendation.severity === "risk" ? "required action" : "advisory action";
+  return [
+    `snipara-companion run added a ${mode} from Project Advisor: ${recommendation.title}.`,
+    recommendation.expectedBehaviorChange ? `Expected adaptation: ${recommendation.expectedBehaviorChange}.` : null,
+    verification ? `Recommended verification to perform: ${verification}.` : null,
+    `Judgment state after adaptation: ${judgmentCard.state}.`
+  ].filter(Boolean).join(" ");
+}
+async function recordFirstPartyAdvisorReceipts(args) {
+  if (args.options.skipAdvisorReceipts) {
+    return {
+      status: "skipped",
+      attemptedCount: 0,
+      recordedCount: 0,
+      writes: [],
+      reason: "advisor receipt capture was explicitly skipped"
+    };
+  }
+  if (args.judgmentCard.advisorRecommendations.length === 0) {
+    return void 0;
+  }
+  const servedJudgmentId = servedJudgmentIdForRun(args.options, args.brief);
+  if (!servedJudgmentId) {
+    return {
+      status: "skipped",
+      attemptedCount: 0,
+      recordedCount: 0,
+      writes: [],
+      reason: "no served judgment id was available for first-party advisor receipts"
+    };
+  }
+  const client = createClient(1e4);
+  const recommendations = args.judgmentCard.advisorRecommendations.slice(0, 6);
+  const writes = await Promise.all(
+    recommendations.map(async (recommendation) => {
+      try {
+        const result = await client.recordAdvisorInfluenceReceipt({
+          servedJudgmentId,
+          recommendation: advisorReceiptRecommendation(recommendation),
+          agentDecision: advisorReceiptDecision(recommendation, args.judgmentCard),
+          behaviorChange: advisorReceiptBehaviorChange(recommendation, args.judgmentCard),
+          verificationExecuted: [],
+          outcomeLinkStatus: "pending",
+          metadata: {
+            source: "snipara-companion:run",
+            firstParty: true,
+            runVersion: "project-intelligence.production-run.v1",
+            generatedAt: args.judgmentCard.generatedAt,
+            release: Boolean(args.options.release),
+            branch: args.brief.branch ?? args.options.branch ?? null,
+            changedFiles: args.brief.changedFiles,
+            judgmentState: args.judgmentCard.state,
+            canProceed: args.judgmentCard.canProceed
+          }
+        });
+        return {
+          advisorRecommendationId: recommendation.id,
+          status: "recorded",
+          result
+        };
+      } catch (error) {
+        return {
+          advisorRecommendationId: recommendation.id,
+          status: "error",
+          error: error instanceof Error ? error.message : String(error)
+        };
+      }
+    })
+  );
+  const recordedCount = writes.filter((write) => write.status === "recorded").length;
+  return {
+    status: recordedCount === writes.length ? "recorded" : recordedCount > 0 ? "partial" : "error",
+    servedJudgmentId,
+    attemptedCount: writes.length,
+    recordedCount,
+    writes
+  };
+}
 function runGuard(options, changedFiles) {
   const cliPath = process.argv[1] || "snipara-companion";
   const args = [
@@ -11658,6 +11843,11 @@ async function buildProjectIntelligenceRun(options) {
     packageReview,
     errors: runErrors
   });
+  const advisorReceiptCapture = await recordFirstPartyAdvisorReceipts({
+    options,
+    brief,
+    judgmentCard
+  });
   const suggestedCommands = [
     ...brief.suggestedCommands,
     ...options.release ? [
@@ -11672,6 +11862,7 @@ async function buildProjectIntelligenceRun(options) {
     brief,
     ...guard ? { guard } : {},
     ...packageReview ? { packageReview } : {},
+    ...advisorReceiptCapture ? { advisorReceiptCapture } : {},
     judgmentCard,
     suggestedCommands: [...new Set(suggestedCommands)]
   };
@@ -11712,6 +11903,20 @@ async function projectIntelligenceRunCommand(options) {
       }
       console.log("");
     }
+    if (result.advisorReceiptCapture) {
+      console.log(import_chalk8.default.bold("Advisor Receipts"));
+      console.log(`Status: ${result.advisorReceiptCapture.status}`);
+      if (result.advisorReceiptCapture.servedJudgmentId) {
+        console.log(`Served judgment: ${result.advisorReceiptCapture.servedJudgmentId}`);
+      }
+      console.log(
+        `Recorded: ${result.advisorReceiptCapture.recordedCount}/${result.advisorReceiptCapture.attemptedCount}`
+      );
+      if (result.advisorReceiptCapture.reason) {
+        console.log(result.advisorReceiptCapture.reason);
+      }
+      console.log("");
+    }
     console.log(import_chalk8.default.bold("Suggested Commands"));
     for (const command of result.suggestedCommands.slice(0, 8)) {
       console.log(command);
@@ -11853,6 +12058,8 @@ function buildAdaptiveWorkRoutingRecommendation(options) {
     preferredEndpointTypes,
     allowedEndpointTypes,
     catalogLimit: options.catalogLimit,
+    dailyBudgetCents: options.dailyBudgetCents,
+    monthlyBudgetCents: options.monthlyBudgetCents,
     fallback: "main_agent"
   });
   const warnings = [
@@ -11980,7 +12187,7 @@ function inferAdaptiveEvidenceRequirements(query, risk) {
 function normalizeEndpointTypes(values) {
   return Array.from(
     new Set(
-      (values ?? []).map((value) => stringValue4(value)?.toLowerCase()).filter((value) => Boolean(value))
+      (values ?? []).map((value) => stringValue5(value)?.toLowerCase()).filter((value) => Boolean(value))
     )
   ).sort();
 }
@@ -12016,24 +12223,24 @@ function readWorkflowState(rootDir) {
   const runtimeBindings = Array.isArray(parsed.runtime?.sandbox?.bindings) ? parsed.runtime?.sandbox?.bindings.filter(isRecord8) : [];
   const runtimeSandboxPhases = phases.filter((phase) => phase.needsRuntime).map((phase) => {
     const binding = runtimeBindings.find(
-      (candidate) => stringValue4(candidate.phaseId) === phase.id
+      (candidate) => stringValue5(candidate.phaseId) === phase.id
     );
     const checkpoint = isRecord8(binding?.lastCheckpoint) ? binding.lastCheckpoint : void 0;
     return {
       phaseId: phase.id,
       title: phase.title,
-      bootstrapQuery: stringValue4(binding?.bootstrapQuery) ?? phase.query,
+      bootstrapQuery: stringValue5(binding?.bootstrapQuery) ?? phase.query,
       files: phase.files,
       artifacts: normalizeStringList3(
         Array.isArray(binding?.artifacts) ? binding.artifacts : Array.isArray(checkpoint?.artifacts) ? checkpoint.artifacts : void 0
       ),
       contextPacks: normalizeContextPackIds(checkpoint?.contextPackReceipts),
-      sessionId: stringValue4(binding?.sessionId) ?? null,
-      environment: stringValue4(binding?.environment) ?? stringValue4(checkpoint?.environment) ?? null,
-      profile: stringValue4(binding?.profile) ?? stringValue4(checkpoint?.profile) ?? null,
+      sessionId: stringValue5(binding?.sessionId) ?? null,
+      environment: stringValue5(binding?.environment) ?? stringValue5(checkpoint?.environment) ?? null,
+      profile: stringValue5(binding?.profile) ?? stringValue5(checkpoint?.profile) ?? null,
       hasCheckpoint: Boolean(checkpoint),
-      checkpointSummary: stringValue4(checkpoint?.summary) ?? null,
-      checkpointCapturedAt: stringValue4(checkpoint?.capturedAt) ?? null
+      checkpointSummary: stringValue5(checkpoint?.summary) ?? null,
+      checkpointCapturedAt: stringValue5(checkpoint?.capturedAt) ?? null
     };
   });
   return {
@@ -12049,18 +12256,18 @@ function normalizeContextPackIds(value) {
     return [];
   }
   return normalizeStringList3(
-    value.filter(isRecord8).map((receipt) => stringValue4(receipt.pack_id)).filter((packId) => Boolean(packId))
+    value.filter(isRecord8).map((receipt) => stringValue5(receipt.pack_id)).filter((packId) => Boolean(packId))
   );
 }
 function normalizeWorkflowPhase(phase, index) {
-  const id = stringValue4(phase.id) ?? `phase-${index + 1}`;
-  const title = stringValue4(phase.title) ?? id;
+  const id = stringValue5(phase.id) ?? `phase-${index + 1}`;
+  const title = stringValue5(phase.title) ?? id;
   return {
     id,
     title,
-    query: stringValue4(phase.query) ?? title,
-    status: stringValue4(phase.status) ?? "pending",
-    ...stringValue4(phase.acceptance) ? { acceptance: stringValue4(phase.acceptance) } : {},
+    query: stringValue5(phase.query) ?? title,
+    status: stringValue5(phase.status) ?? "pending",
+    ...stringValue5(phase.acceptance) ? { acceptance: stringValue5(phase.acceptance) } : {},
     files: normalizeStringList3(Array.isArray(phase.files) ? phase.files : void 0),
     gates: normalizeStringList3(Array.isArray(phase.gates) ? phase.gates : void 0),
     needsRuntime: Boolean(phase.needsRuntime)
@@ -12069,7 +12276,7 @@ function normalizeWorkflowPhase(phase, index) {
 function isRecord8(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
-function stringValue4(value) {
+function stringValue5(value) {
   return typeof value === "string" && value.trim() ? value.trim() : void 0;
 }
 function readGitValue(rootDir, args) {
@@ -12086,7 +12293,7 @@ function readGitValue(rootDir, args) {
 function normalizeStringList3(values) {
   return Array.from(
     new Set(
-      (values ?? []).map((value) => stringValue4(value)).filter((value) => Boolean(value))
+      (values ?? []).map((value) => stringValue5(value)).filter((value) => Boolean(value))
     )
   ).sort();
 }
@@ -15284,7 +15491,7 @@ function printKeyValue(label, value) {
 function isRecord9(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function stringValue5(value) {
+function stringValue6(value) {
   if (value === null || value === void 0) {
     return void 0;
   }
@@ -15295,7 +15502,7 @@ function numberValue5(value) {
   if (typeof value === "number" && Number.isFinite(value)) {
     return value;
   }
-  const text = stringValue5(value);
+  const text = stringValue6(value);
   if (!text) {
     return void 0;
   }
@@ -15306,10 +15513,10 @@ function uniqueStrings5(values) {
   return Array.from(new Set(values.filter((value) => value.trim().length > 0)));
 }
 function normalizeEnum(value) {
-  return stringValue5(value)?.replace(/[-\s]/g, "_").toUpperCase() ?? "";
+  return stringValue6(value)?.replace(/[-\s]/g, "_").toUpperCase() ?? "";
 }
 function parseIsoDate(value) {
-  const text = stringValue5(value);
+  const text = stringValue6(value);
   if (!text) {
     return void 0;
   }
@@ -15399,7 +15606,7 @@ function normalizeDocumentKind(value) {
   return void 0;
 }
 function normalizeDocumentFormat(value) {
-  return stringValue5(value)?.toLowerCase();
+  return stringValue6(value)?.toLowerCase();
 }
 function isSupportedDocumentFormat(kind, format) {
   if (!kind || !format) {
@@ -15646,7 +15853,7 @@ function collectPlanFileHints(plan) {
 function buildPlanRelevanceWarnings(plan, options) {
   const warnings = [];
   const fileHints = collectPlanFileHints(plan);
-  const query = compactWhitespace(options.query ?? stringValue5(plan.query) ?? "");
+  const query = compactWhitespace(options.query ?? stringValue6(plan.query) ?? "");
   if (fileHints.length === 0 || query.length === 0) {
     return warnings;
   }
@@ -15710,19 +15917,19 @@ function validatePlanResult(plan, options = {}) {
       issues.push(`Step ${index + 1} is not an object or string.`);
       return;
     }
-    const action = stringValue5(step.action);
+    const action = stringValue6(step.action);
     if (action) {
       actions.push(action);
       if (isPlaceholderPlanLabel(action, index)) {
         issues.push(`Step ${index + 1} has a placeholder action.`);
       }
     }
-    const labelSource = stringValue5(step.title) ?? stringValue5(step.name) ?? action ?? stringValue5(step.goal) ?? stringValue5(step.query) ?? stringValue5(step.description);
+    const labelSource = stringValue6(step.title) ?? stringValue6(step.name) ?? action ?? stringValue6(step.goal) ?? stringValue6(step.query) ?? stringValue6(step.description);
     if (!labelSource || isPlaceholderPlanLabel(labelSource, index)) {
       issues.push(`Step ${index + 1} is missing a useful title or action.`);
     }
-    const expectedOutput = stringValue5(step.expected_output);
-    if (!expectedOutput && !stringValue5(step.acceptance) && !stringValue5(step.verify)) {
+    const expectedOutput = stringValue6(step.expected_output);
+    if (!expectedOutput && !stringValue6(step.acceptance) && !stringValue6(step.verify)) {
       issues.push(`Step ${index + 1} is missing expected output or acceptance criteria.`);
     }
     const params = isRecord9(step.params) ? step.params : void 0;
@@ -15741,7 +15948,7 @@ function validatePlanResult(plan, options = {}) {
     warnings,
     stepCount: steps.length,
     actions,
-    ...stringValue5(plan.plan_id) ? { planId: stringValue5(plan.plan_id) } : {}
+    ...stringValue6(plan.plan_id) ? { planId: stringValue6(plan.plan_id) } : {}
   };
 }
 function readBootstrapEntryText(entry) {
@@ -15810,7 +16017,7 @@ function normalizeStringArray3(value) {
   if (!raw) {
     return void 0;
   }
-  const items = raw.map((item) => stringValue5(item)).filter((item) => Boolean(item));
+  const items = raw.map((item) => stringValue6(item)).filter((item) => Boolean(item));
   return items.length > 0 ? items : void 0;
 }
 function isUsableGeneratedStepQuery(value) {
@@ -15831,12 +16038,12 @@ function planStepToWorkflowStep(step, index, fallbackGoal) {
     };
   }
   const params = isRecord9(step.params) ? step.params : void 0;
-  const query = stringValue5(step.query) ?? stringValue5(step.goal) ?? stringValue5(step.description) ?? (isUsableGeneratedStepQuery(params?.query) ? params.query : void 0) ?? fallbackQuery;
-  const acceptance = stringValue5(step.acceptance) ?? stringValue5(step.expected_output) ?? stringValue5(step.done_when) ?? stringValue5(step.verify);
+  const query = stringValue6(step.query) ?? stringValue6(step.goal) ?? stringValue6(step.description) ?? (isUsableGeneratedStepQuery(params?.query) ? params.query : void 0) ?? fallbackQuery;
+  const acceptance = stringValue6(step.acceptance) ?? stringValue6(step.expected_output) ?? stringValue6(step.done_when) ?? stringValue6(step.verify);
   const likelyFiles = params && step.action === "implementation_map" ? normalizeStringArray3(params.likely_files) : normalizeStringArray3(step.files) ?? normalizeStringArray3(step.files_touched) ?? normalizeStringArray3(step.paths);
   return {
     id: sanitizeWorkflowId(
-      stringValue5(step.id) ?? stringValue5(step.phase_id) ?? stringValue5(step.key) ?? title,
+      stringValue6(step.id) ?? stringValue6(step.phase_id) ?? stringValue6(step.key) ?? title,
       `phase-${index + 1}`
     ),
     title,
@@ -15847,7 +16054,7 @@ function planStepToWorkflowStep(step, index, fallbackGoal) {
   };
 }
 function buildGeneratedWorkflowPlanDocument(plan, fallbackGoal) {
-  const goal = stringValue5(plan.query) ?? fallbackGoal;
+  const goal = stringValue6(plan.query) ?? fallbackGoal;
   const steps = findWorkflowSteps(plan).map(
     (step, index) => planStepToWorkflowStep(step, index, goal)
   );
@@ -15855,7 +16062,7 @@ function buildGeneratedWorkflowPlanDocument(plan, fallbackGoal) {
     mode: "full",
     goal,
     source: "snipara_plan",
-    ...stringValue5(plan.plan_id) ? { plan_id: stringValue5(plan.plan_id) } : {},
+    ...stringValue6(plan.plan_id) ? { plan_id: stringValue6(plan.plan_id) } : {},
     generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
     steps
   };
@@ -15882,7 +16089,7 @@ function booleanValue(value) {
   if (typeof value === "boolean") {
     return value;
   }
-  const text = stringValue5(value)?.toLowerCase();
+  const text = stringValue6(value)?.toLowerCase();
   if (!text) {
     return void 0;
   }
@@ -15900,7 +16107,7 @@ function uniqueStringList(values) {
   }
   const unique3 = Array.from(
     new Set(
-      values.map((value) => stringValue5(value)).filter((value) => Boolean(value))
+      values.map((value) => stringValue6(value)).filter((value) => Boolean(value))
     )
   );
   return unique3.length > 0 ? unique3 : void 0;
@@ -15959,15 +16166,15 @@ function normalizeWorkflowPhase2(step, index, usedIds, fallbackGoal) {
       status: "pending"
     };
   }
-  const title = stringValue5(step.title) ?? stringValue5(step.name) ?? stringValue5(step.action) ?? stringValue5(step.goal) ?? `Phase ${index + 1}`;
-  const query = stringValue5(step.query) ?? stringValue5(step.goal) ?? stringValue5(step.description) ?? stringValue5(step.action) ?? `${fallbackGoal}: ${title}`;
+  const title = stringValue6(step.title) ?? stringValue6(step.name) ?? stringValue6(step.action) ?? stringValue6(step.goal) ?? `Phase ${index + 1}`;
+  const query = stringValue6(step.query) ?? stringValue6(step.goal) ?? stringValue6(step.description) ?? stringValue6(step.action) ?? `${fallbackGoal}: ${title}`;
   const id = uniquePhaseId(
-    stringValue5(step.id) ?? stringValue5(step.phase_id) ?? stringValue5(step.key) ?? title,
+    stringValue6(step.id) ?? stringValue6(step.phase_id) ?? stringValue6(step.key) ?? title,
     index,
     usedIds
   );
   const files = normalizeStringArray3(step.files) ?? normalizeStringArray3(step.files_touched) ?? normalizeStringArray3(step.paths);
-  const acceptance = stringValue5(step.acceptance) ?? stringValue5(step.expected_output) ?? stringValue5(step.done_when) ?? stringValue5(step.verify);
+  const acceptance = stringValue6(step.acceptance) ?? stringValue6(step.expected_output) ?? stringValue6(step.done_when) ?? stringValue6(step.verify);
   return {
     id,
     title,
@@ -16465,7 +16672,7 @@ function runtimeCheckpointEventPayload(event) {
   if (!payload) {
     return void 0;
   }
-  const toolName = stringValue5(payload.tool_name ?? payload.toolName ?? payload.tool);
+  const toolName = stringValue6(payload.tool_name ?? payload.toolName ?? payload.tool);
   if (toolName !== "snipara_sandbox_runtime_checkpoint") {
     return void 0;
   }
@@ -16476,8 +16683,8 @@ function parseRuntimeCheckpointFromEvent(event, workflowId, phaseId) {
   if (!payload) {
     return void 0;
   }
-  const eventWorkflowId = stringValue5(payload.workflow_id);
-  const eventPhaseId = stringValue5(payload.workflow_phase_id);
+  const eventWorkflowId = stringValue6(payload.workflow_id);
+  const eventPhaseId = stringValue6(payload.workflow_phase_id);
   if (eventWorkflowId !== workflowId || eventPhaseId !== phaseId) {
     return void 0;
   }
@@ -16486,14 +16693,14 @@ function parseRuntimeCheckpointFromEvent(event, workflowId, phaseId) {
     return void 0;
   }
   return normalizeRuntimeCheckpointRecord({
-    summary: stringValue5(runtimeCheckpoint.summary) ?? stringValue5(payload.task) ?? "Runtime checkpoint captured",
-    capturedAt: stringValue5(runtimeCheckpoint.captured_at) ?? stringValue5(event.event.timestamp) ?? event.createdAt,
-    automationSessionId: stringValue5(runtimeCheckpoint.automation_session_id) ?? stringValue5(event.event.session_id) ?? void 0,
+    summary: stringValue6(runtimeCheckpoint.summary) ?? stringValue6(payload.task) ?? "Runtime checkpoint captured",
+    capturedAt: stringValue6(runtimeCheckpoint.captured_at) ?? stringValue6(event.event.timestamp) ?? event.createdAt,
+    automationSessionId: stringValue6(runtimeCheckpoint.automation_session_id) ?? stringValue6(event.event.session_id) ?? void 0,
     hostedEventId: event.id,
     hostedRecordedAt: event.createdAt,
-    environment: stringValue5(runtimeCheckpoint.environment),
-    profile: stringValue5(runtimeCheckpoint.profile),
-    bootstrapQuery: stringValue5(runtimeCheckpoint.bootstrap_query) ?? stringValue5(payload.task) ?? void 0,
+    environment: stringValue6(runtimeCheckpoint.environment),
+    profile: stringValue6(runtimeCheckpoint.profile),
+    bootstrapQuery: stringValue6(runtimeCheckpoint.bootstrap_query) ?? stringValue6(payload.task) ?? void 0,
     files: normalizeStringArray3(runtimeCheckpoint.files) ?? normalizeStringArray3(payload.files) ?? void 0,
     commands: normalizeStringArray3(runtimeCheckpoint.commands) ?? normalizeStringArray3(payload.commands) ?? void 0,
     artifacts: normalizeStringArray3(runtimeCheckpoint.artifacts) ?? void 0,
@@ -17131,7 +17338,7 @@ function commitsMatch(left, right) {
 }
 function stringArrayField(record, key) {
   const value = record[key];
-  return Array.isArray(value) ? value.map((item) => stringValue5(item)).filter((item) => Boolean(item)) : [];
+  return Array.isArray(value) ? value.map((item) => stringValue6(item)).filter((item) => Boolean(item)) : [];
 }
 function printCodeIndexFreshness(record) {
   const freshness = recordField(record, "index_freshness");
@@ -17139,8 +17346,8 @@ function printCodeIndexFreshness(record) {
     return;
   }
   const coverage = recordField(freshness, "coverage");
-  const indexedCommit = stringValue5(freshness.indexed_commit_sha);
-  const sourceCommit = stringValue5(freshness.source_commit_sha);
+  const indexedCommit = stringValue6(freshness.indexed_commit_sha);
+  const sourceCommit = stringValue6(freshness.source_commit_sha);
   const commit = indexedCommit ?? sourceCommit;
   const coverageText = coverage && coverage.coverage_percent !== void 0 ? `${coverage.coverage_percent}%` : void 0;
   const localGit = readLocalGitState();
@@ -17183,9 +17390,9 @@ function printCodeIndexFreshness(record) {
   console.log("");
 }
 function formatAction(record) {
-  const label = stringValue5(record.action) ?? stringValue5(record.code) ?? stringValue5(record.tool) ?? stringValue5(record.name) ?? "action";
-  const priority = stringValue5(record.priority ?? record.severity);
-  const reason = stringValue5(record.reason ?? record.message);
+  const label = stringValue6(record.action) ?? stringValue6(record.code) ?? stringValue6(record.tool) ?? stringValue6(record.name) ?? "action";
+  const priority = stringValue6(record.priority ?? record.severity);
+  const reason = stringValue6(record.reason ?? record.message);
   const targets = stringArrayField(record, "targets");
   const suffix = [
     priority ? `[${priority}]` : void 0,
@@ -17217,9 +17424,9 @@ function printSuggestedToolList(record) {
   }
   console.log(import_chalk9.default.bold("Suggested MCP Follow-ups"));
   for (const suggestion of suggestions.slice(0, 5)) {
-    const tool = stringValue5(suggestion.tool) ?? "snipara_code_*";
+    const tool = stringValue6(suggestion.tool) ?? "snipara_code_*";
     const args = recordField(suggestion, "arguments") ?? {};
-    const reason = stringValue5(suggestion.reason);
+    const reason = stringValue6(suggestion.reason);
     console.log(`- ${tool}(${JSON.stringify(args)})${reason ? ` - ${reason}` : ""}`);
   }
   console.log("");
@@ -17874,9 +18081,9 @@ async function enrichAdaptiveRoutingWithHostedCatalog(client, routing) {
     const gateway = {
       source: "hosted_mcp",
       success: gatewaySucceeded,
-      resolutionStatus: stringValue5(result.resolution?.status),
+      resolutionStatus: stringValue6(result.resolution?.status),
       candidateCount,
-      fallback: stringValue5(result.fallback) ?? stringValue5(result.resolution?.fallback) ?? "main_agent",
+      fallback: stringValue6(result.fallback) ?? stringValue6(result.resolution?.fallback) ?? "main_agent",
       warnings: gatewayWarnings
     };
     const reasons = [
@@ -17921,7 +18128,7 @@ function normalizeAdaptiveRoutingCatalog(value) {
     (candidate) => Boolean(candidate) && typeof candidate === "object" && !Array.isArray(candidate)
   ) : [];
   return {
-    version: stringValue5(record.version),
+    version: stringValue6(record.version),
     candidates
   };
 }
@@ -18526,7 +18733,7 @@ function normalizeSyncDocumentsPayload(payload) {
     const inferred = inferDocumentFormat(item.path);
     const kind = normalizeDocumentKind(item.kind) ?? inferred?.kind;
     const format = normalizeDocumentFormat(item.format) ?? inferred?.format;
-    const language = stringValue5(item.language) ?? void 0;
+    const language = stringValue6(item.language) ?? void 0;
     return {
       path: item.path,
       content: item.content,
@@ -18733,7 +18940,7 @@ var REPO_DOC_FILES = /* @__PURE__ */ new Set([
   "SECURITY.md"
 ]);
 function normalizeOnboardFolderMode(value) {
-  const normalized = stringValue5(value)?.replace(/[-\s]/g, "_").toLowerCase() ?? "auto";
+  const normalized = stringValue6(value)?.replace(/[-\s]/g, "_").toLowerCase() ?? "auto";
   if (normalized === "auto" || normalized === "business_context" || normalized === "code_project" || normalized === "mixed") {
     return normalized;
   }
@@ -19055,7 +19262,7 @@ function normalizeUsageMode(value) {
 function hasReferenceProvenance(metadata) {
   const referenceProvenance = metadata.referenceProvenance ?? metadata.reference_provenance;
   if (isRecord9(referenceProvenance)) {
-    return Object.values(referenceProvenance).some((value) => Boolean(stringValue5(value)));
+    return Object.values(referenceProvenance).some((value) => Boolean(stringValue6(value)));
   }
   return [
     metadata.clientId,
@@ -19094,7 +19301,7 @@ function validateDocumentForDryRun(document, now) {
   const reasons = [];
   const reviewReasons = [];
   const reuploadReasons = [];
-  const assetClass = stringValue5(metadata.assetClass ?? metadata.asset_class);
+  const assetClass = stringValue6(metadata.assetClass ?? metadata.asset_class);
   if (!isSupportedDocumentFormat(kind, format)) {
     reasons.push("invalid_document_format");
   }
@@ -19109,7 +19316,7 @@ function validateDocumentForDryRun(document, now) {
   if (usageModeRaw !== void 0 && !usageMode) {
     reasons.push("invalid_usage_mode");
   }
-  const sourceKind = stringValue5(metadata.sourceKind ?? metadata.source_kind);
+  const sourceKind = stringValue6(metadata.sourceKind ?? metadata.source_kind);
   if (sourceKind && !SOURCE_KINDS.has(sourceKind)) {
     reasons.push("invalid_source_kind");
   }
@@ -19118,8 +19325,8 @@ function validateDocumentForDryRun(document, now) {
   const sourceSnapshotAtRaw = metadata.sourceSnapshotAt ?? metadata.source_snapshot_at;
   const sourceModifiedAt = parseIsoDate(sourceModifiedAtRaw);
   const sourceSnapshotAt = parseIsoDate(sourceSnapshotAtRaw);
-  const sourceHash = stringValue5(metadata.sourceContentHash ?? metadata.source_content_hash);
-  const latestHash = stringValue5(
+  const sourceHash = stringValue6(metadata.sourceContentHash ?? metadata.source_content_hash);
+  const latestHash = stringValue6(
     metadata.latestSourceContentHash ?? metadata.currentSourceContentHash ?? metadata.manifestSourceContentHash
   );
   if (sourceModifiedAtRaw !== void 0 && !sourceModifiedAt) {
@@ -19673,9 +19880,11 @@ function buildWorkflowAdaptiveRouting(options, policy = null, intentWarnings = [
     allowedEndpointTypes,
     workerRole,
     plannerRetainsReasoning: options.plannerRetainsReasoning ?? policy?.plannerRetainsReasoning ?? (options.routeLocalWorkers ? true : void 0),
-    catalogLimit: policy?.catalogLimit ?? DEFAULT_ADAPTIVE_ROUTING_CATALOG_LIMIT
+    catalogLimit: policy?.catalogLimit ?? DEFAULT_ADAPTIVE_ROUTING_CATALOG_LIMIT,
+    dailyBudgetCents: policy?.dailyBudgetCents,
+    monthlyBudgetCents: policy?.monthlyBudgetCents
   });
-  const requestedWorkerRole = stringValue5(options.routingWorkerRole);
+  const requestedWorkerRole = stringValue6(options.routingWorkerRole);
   let routing = buildRecommendation(requestedWorkerRole);
   const allowedWorkerClasses = policy?.allowedWorkerClasses ?? [];
   if (allowedWorkerClasses.length > 0 && !isAdaptiveWorkerClassAllowed(routing.requirements.workerRole, allowedWorkerClasses)) {
@@ -19707,12 +19916,12 @@ function buildWorkflowAdaptiveRouting(options, policy = null, intentWarnings = [
 function normalizeRoutingEndpointTypes(values) {
   return Array.from(
     new Set(
-      (values ?? []).map((value) => stringValue5(value)?.toLowerCase()).filter((value) => Boolean(value))
+      (values ?? []).map((value) => stringValue6(value)?.toLowerCase()).filter((value) => Boolean(value))
     )
   ).sort();
 }
 function normalizeAdaptiveRoutingMode(value) {
-  const normalized = stringValue5(value)?.toLowerCase();
+  const normalized = stringValue6(value)?.toLowerCase();
   return normalized === "off" || normalized === "recommend" || normalized === "catalog" ? normalized : null;
 }
 function normalizeAdaptiveWorkerClasses(values) {
@@ -19739,7 +19948,7 @@ function intersectStrings(left, right) {
   return left.filter((value) => rightSet.has(value));
 }
 function canonicalAdaptiveWorkerClass(value) {
-  const normalized = stringValue5(value)?.toLowerCase().replace(/[-\s]/g, "_") ?? "execution";
+  const normalized = stringValue6(value)?.toLowerCase().replace(/[-\s]/g, "_") ?? "execution";
   if (normalized === "docs" || normalized === "doc") {
     return "documentation";
   }
@@ -20197,9 +20406,9 @@ async function workflowRuntimeCheckpointCommand(options) {
     summary: options.summary,
     capturedAt: now,
     automationSessionId: loadConfig().sessionId,
-    environment: stringValue5(options.environment) ?? binding.environment,
-    profile: stringValue5(options.profile) ?? binding.profile,
-    bootstrapQuery: stringValue5(options.bootstrapQuery) ?? binding.bootstrapQuery,
+    environment: stringValue6(options.environment) ?? binding.environment,
+    profile: stringValue6(options.profile) ?? binding.profile,
+    bootstrapQuery: stringValue6(options.bootstrapQuery) ?? binding.bootstrapQuery,
     files: uniqueStringList(options.files) ?? phase.files ?? [],
     commands: uniqueStringList(options.commands) ?? [],
     artifacts: uniqueStringList([...options.artifacts ?? [], ...contextPackArtifacts]) ?? binding.artifacts ?? [],
@@ -21012,7 +21221,7 @@ program.command("verify").description("Build a transparent verification plan fro
     json: Boolean(options.json)
   });
 });
-program.command("run").description("Run the production Project Intelligence judgment flow for a task or release").option("--task <task>", "Current task or change summary").option("--branch <branch>", "Branch to scope continuity signals").option("--changed-files <changedFiles...>", "Changed files to analyze").option("--recent-files <recentFiles...>", "Recently touched files for continuity lookup").option("--diff-summary <diffSummary>", "Natural-language summary for code impact").option("--max-tokens <number>", "Resume context token budget", "4000").option("--release", "Run release-oriented guard and package surface review").option("--skip-impact", "Do not run companion code impact").option("--skip-memory-health", "Do not call snipara_memory_health").option("--skip-guard", "Skip collaboration guard during release runs").option("--skip-package-review", "Skip npm package surface review").option("--json", "Print raw JSON").action(async (options) => {
+program.command("run").description("Run the production Project Intelligence judgment flow for a task or release").option("--task <task>", "Current task or change summary").option("--branch <branch>", "Branch to scope continuity signals").option("--changed-files <changedFiles...>", "Changed files to analyze").option("--recent-files <recentFiles...>", "Recently touched files for continuity lookup").option("--diff-summary <diffSummary>", "Natural-language summary for code impact").option("--max-tokens <number>", "Resume context token budget", "4000").option("--release", "Run release-oriented guard and package surface review").option("--skip-impact", "Do not run companion code impact").option("--skip-memory-health", "Do not call snipara_memory_health").option("--skip-guard", "Skip collaboration guard during release runs").option("--skip-package-review", "Skip npm package surface review").option("--served-judgment-id <id>", "Served judgment id to use for first-party advisor receipts").option("--skip-advisor-receipts", "Skip first-party advisor influence receipt capture").option("--json", "Print raw JSON").action(async (options) => {
   await projectIntelligenceRunCommand({
     task: options.task,
     branch: options.branch,
@@ -21025,6 +21234,8 @@ program.command("run").description("Run the production Project Intelligence judg
     skipMemoryHealth: Boolean(options.skipMemoryHealth),
     skipGuard: Boolean(options.skipGuard),
     skipPackageReview: Boolean(options.skipPackageReview),
+    servedJudgmentId: options.servedJudgmentId,
+    skipAdvisorReceipts: Boolean(options.skipAdvisorReceipts),
     json: Boolean(options.json)
   });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snipara-companion",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "Snipara Git-style companion CLI for local workflow continuity, hooks, hosted context, and Mini Snipara OSS workflows",
   "main": "dist/index.js",
   "bin": {