;
+ const technique = String(record.technique ?? record.name ?? "").trim();
+ if (!technique) continue;
+ const noteValue = record.note ?? record.boundary ?? record.effect_on_confidence;
+ const note = typeof noteValue === "string" ? noteValue.trim().slice(0, 320) : "";
+ rows.push({
+ technique: technique.slice(0, 160),
+ status: parseTechniqueAuditStatus(String(record.status ?? "")),
+ ...(note ? { note } : {}),
+ });
+ }
+ return rows.length > 0 ? rows : undefined;
+}
+
+export function splitSpokenAnswerAndTechniqueAudit(text: string): SpokenAnswerAndTechniqueAudit {
+ const lines = text.replace(/\r\n/g, "\n").split("\n");
+ let headerIndex = -1;
+ for (let index = 0; index < lines.length; index += 1) {
+ if (AUDIT_HEADER.test(lines[index].trim())) headerIndex = index;
+ }
+ if (headerIndex < 0) {
+ return { spoken: text.replace(/\s+$/, ""), rows: [], complete: true };
+ }
+
+ const spoken = lines.slice(0, headerIndex).join("\n").replace(/\s+$/, "");
+ const tableLines = lines.slice(headerIndex).map((line) => line.trim());
+ const separator = tableLines[1] && AUDIT_SEPARATOR.test(tableLines[1]) ? tableLines[1] : null;
+ if (!separator) {
+ return { spoken, rows: [], complete: false };
+ }
+
+ const rows: TechniqueAuditRow[] = [];
+ for (const line of tableLines.slice(2)) {
+ if (!line) break;
+ if (!line.startsWith("|")) break;
+ const cells = splitGfmRow(line);
+ if (cells.length < 3) return { spoken, rows, complete: false };
+ const technique = cells[0]?.trim() ?? "";
+ if (!technique) continue;
+ const note = cells.slice(2).join(" | ").trim().slice(0, 320);
+ rows.push({
+ technique: technique.slice(0, 160),
+ status: parseTechniqueAuditStatus(cells[1] ?? ""),
+ ...(note ? { note } : {}),
+ });
+ }
+
+ return { spoken, rows, complete: rows.length > 0 };
+}
+
+export function resolveTechniqueAuditRows(
+ split: SpokenAnswerAndTechniqueAudit,
+ delivered?: readonly TechniqueAuditRow[],
+): readonly TechniqueAuditRow[] {
+ if (split.complete && split.rows.length > 0) return split.rows;
+ return delivered && delivered.length > 0 ? delivered : [];
+}
+
+function splitGfmRow(line: string): string[] {
+ return line.replace(/^\|/, "").replace(/\|$/, "").split("|").map((cell) => cell.trim());
+}
diff --git a/frontend/src/mastra/consultation-tools.ts b/frontend/src/mastra/consultation-tools.ts
index c2c7a616..9a2adb7d 100644
--- a/frontend/src/mastra/consultation-tools.ts
+++ b/frontend/src/mastra/consultation-tools.ts
@@ -10,7 +10,8 @@ import { applyBirthTimeModeToWorkflowContext, type ConsultationBirthTimeMode } f
import { consultationMethodologyForDomains } from "../lib/consultation-methodology.ts";
import type { ServerChartConsultation } from "../lib/consultation-route-service.ts";
import { createConsultationPlan, type ConsultationPlan } from "../lib/consultation-plan.ts";
-import type { WorkflowReceipt } from "../lib/consultation-agent-events.ts";
+import type { TechniqueAuditRow, WorkflowReceipt } from "../lib/consultation-agent-events.ts";
+import { normalizeTechniqueAuditRows } from "../lib/consultation-technique-audit.ts";
import type { AgentModelFinishReason } from "../lib/agent-observability.ts";
import {
consultationEvidencePacketSchema,
@@ -106,6 +107,7 @@ export type ConsultationRuntimeState = {
consultationToolDurationMs?: number;
workflowReceipt?: WorkflowReceipt;
techniqueTruth?: string;
+ techniqueAuditTable?: TechniqueAuditRow[];
steps: ConsultationRuntimeStep[];
stepBudget: ConsultationStepBudget;
stepsTruncated: boolean;
@@ -579,6 +581,9 @@ export function createConsultationTools(ctx: ConsultationAgentContext) {
appendConsultationRuntimeStep(ctx.state, { kind: "tool", name: "run-jyotish-consultation", status: "completed", durationMs: ctx.state.consultationToolDurationMs });
const modelContext = toModelDomainPlanContext(executions, omittedDomains);
ctx.state.methodologySectionCount = modelContext.methodology?.sections.length ?? 0;
+ ctx.state.techniqueAuditTable = normalizeTechniqueAuditRows(
+ modelContext.evidence_contract?.technique_audit_table,
+ );
return modelContext;
} catch (error) {
ctx.state.consultationToolDurationMs = now() - startedAt;
diff --git a/frontend/src/mastra/index.ts b/frontend/src/mastra/index.ts
index b86d887d..fccdae20 100644
--- a/frontend/src/mastra/index.ts
+++ b/frontend/src/mastra/index.ts
@@ -28,7 +28,7 @@ Treat the server-provided current time as authoritative for words such as today,
Treat the tool result's top-level status and evidence_contract as the authoritative answer policy:
- When status is ready and evidence_contract.answer_policy.can_answer_direction is true, answer the user's actual question directly. Do not begin with infrastructure or confidence disclaimers.
- An unavailable optional provider or external cross-check is not a calculation failure. Never call it an internal error.
-- Do not mention VedAstro, snapshot, fallback, gateway, archive, provider, MEVG, or calibration unless the user explicitly asks about methodology, or the missing layer materially blocks the exact claim they requested. The required Technique Audit Table may list those rows by their delivered labels without discussing provider internals.
+- Do not mention VedAstro, snapshot, fallback, gateway, archive, provider, MEVG, or calibration unless the user explicitly asks about methodology, or the missing layer materially blocks the exact claim they requested. The collapsed Technique Audit Table may list those rows by their delivered labels without discussing provider internals.
When reference_transparency is present:
- Present candidate_windows and exact_triggers when relevant, but describe exact_triggers as technical trigger points, never guaranteed events.
@@ -44,7 +44,7 @@ When reference_transparency is present:
- Only say the chart calculation failed when evidence_contract.hard_blockers is non-empty.
- Never claim D2, D11, D9, D10, A10, UL, Narayana Dasha, a delivered Varga, or a delivered Western layer is missing when it appears in evidence_contract.available_layers, evidence_contract.varga_spectrum, evidence_contract.western_spectrum, chart, or local_layers.
- evidence_contract.technique_audit_table is the invocation record for this run. Use every executed layer that is relevant to the question. Status executed means the server ran it; blocked means it could not; not_applicable means it does not apply. Never treat an omitted row as permission to invent the technique, and never silently skip an executed layer the question needs.
-- The visible answer must end with that Technique Audit Table in spoken Chinese labels (已执行 / 阻塞 / 不适用). This is the one table VISIBLE VOICE requires; do not also dump JSON.
+- Do not paste that Technique Audit Table into the spoken answer. The product UI renders it collapsed from the delivered rows. This is the one audit surface; do not also dump JSON.
- local_layers.dasha_sub_periods carries the antardasha boundaries inside the running mahadasha. When it is present, use those boundaries and never say sub-periods were not calculated; when it is absent, say so once instead of implying the calculation broke.
- Treat evidence_contract.answer_policy as a hard output contract. When can_answer_precise_timing is false, provide only direction or structure and do not state a month, date, or guaranteed timing outcome.
- Treat answer_policy.deterministic_claims_forbidden_for as a hard prohibition. Do not use a restricted technique to make a deterministic conclusion. reference_only, partial, blocked, research_only_blocked, and partial_registry_only are commercial claim boundaries, not validated capabilities.
diff --git a/frontend/src/mastra/product-voice.ts b/frontend/src/mastra/product-voice.ts
index 3a6709e9..5cb4fc34 100644
--- a/frontend/src/mastra/product-voice.ts
+++ b/frontend/src/mastra/product-voice.ts
@@ -5,16 +5,16 @@ Write spoken Simplified Chinese, addressing the reader as 你.
- Answer the user's actual question in the first sentence.
- Then use the delivered evidence the way the local skill does: unified parameters and raw structure first (degrees, houses, vargas, Dasha boundaries, Shadbala/AV, functional benefic/malefic, Western layers), then parallel systems, conflicts, and only then a conditional synthesis.
- Gloss a technical term once in plain Chinese (婚姻分盘（D9）, 当前大运) before using the everyday phrase.
-- Prefer paragraphs. Use Markdown to compare concrete options, to show raw structure that would otherwise be a wall of numbers, and for the required Technique Audit Table at the end.
-- If a limitation materially changes the claim, put it in one short closing sentence before the table; otherwise omit it.
+- Prefer paragraphs. Use Markdown to compare concrete options or to show raw structure that would otherwise be a wall of numbers. Do not paste the Technique Audit Table into the spoken answer; the product UI renders those delivered rows in a collapsed control.
+- If a limitation materially changes the claim, put it in one short closing sentence; otherwise omit it.
-After the spoken answer, include exactly one compact Markdown Technique Audit Table with columns 技法 / 状态 / 说明. Copy rows from the delivered technique_audit_table. Translate status to 已执行 / 阻塞 / 不适用. Do not invent, omit, or upgrade a row. Do not dump JSON keys or YAML.
+Do not copy the delivered technique_audit_table into the spoken answer. The product UI renders it collapsed from the server-delivered rows. Still obey every row: do not invent, omit, or upgrade a technique. Translate nothing into JSON or YAML. Status labels in that UI are 已执行 / 阻塞 / 不适用.
Never do these in the visible answer:
- Quote JSON keys, English status codes, or field names (core_status, blocked, ready, consumer_context, missing_layers, omitted_domains).
- Say 根据系统计算, 根据当前计算结果, 综合来看, 需要指出的是, 当前状态为, 本轮未完整计算, or 从星盘来看 as an opener.
- Restate the user's question, pad to a template length, or use a fixed 首先 / 其次 / 最后 skeleton.
-- Dump YAML, JSON, or a second inventory besides that one table.
+- Dump YAML, JSON, or a Technique Audit Table in the spoken answer.
- Skip an executed layer the question needs in order to keep the answer short.
Bad: 根据当前计算结果，事业方向总体偏稳定，但副运细节与行运触发未在本轮完整计算。
diff --git a/frontend/tests/chat-bundle-splitting-contract.test.ts b/frontend/tests/chat-bundle-splitting-contract.test.ts
index 36ff39c4..aa334bdb 100644
--- a/frontend/tests/chat-bundle-splitting-contract.test.ts
+++ b/frontend/tests/chat-bundle-splitting-contract.test.ts
@@ -45,8 +45,10 @@ test("the pre-markdown fallback renders prose but never raw markdown", () => {
// And: one stable wrapper serves both paths, so no styling or caret is lost on upgrade.
assert.equal(contentSource.match(/className="message-markdown"/g)?.length, 1);
+ assert.match(contentSource, /className="message-answer"/);
+ assert.match(contentSource, /TechniqueAuditDisclosure/);
assert.match(contentSource, /\{paragraph\}<\/p>/);
- assert.match(contentSource, /plainParagraphs\(text\) \?\? \[\]/);
+ assert.match(contentSource, /plainParagraphs\(spoken\) \?\? \[\]/);
});
test("gsap loads on demand while keeping the reduced-motion gate", () => {
diff --git a/frontend/tests/consultation-technique-audit.test.ts b/frontend/tests/consultation-technique-audit.test.ts
new file mode 100644
index 00000000..8c6a8f07
--- /dev/null
+++ b/frontend/tests/consultation-technique-audit.test.ts
@@ -0,0 +1,112 @@
+import assert from "node:assert/strict";
+import { readFileSync } from "node:fs";
+import test from "node:test";
+
+import { agentExecutionReceiptSchema } from "../src/lib/consultation-agent-events.ts";
+import {
+ displayTechniqueAuditLabel,
+ displayTechniqueAuditNote,
+ normalizeTechniqueAuditRows,
+ resolveTechniqueAuditRows,
+ splitSpokenAnswerAndTechniqueAudit,
+ techniqueAuditStatusLabel,
+} from "../src/lib/consultation-technique-audit.ts";
+
+const disclosureSource = readFileSync(new URL("../src/components/technique-audit-disclosure.tsx", import.meta.url), "utf8");
+const contentSource = readFileSync(new URL("../src/components/chat-message-content.tsx", import.meta.url), "utf8");
+const toolsSource = readFileSync(new URL("../src/mastra/consultation-tools.ts", import.meta.url), "utf8");
+const routeSource = readFileSync(new URL("../src/app/api/consult/route.ts", import.meta.url), "utf8");
+const globalStyles = readFileSync(new URL("../src/app/globals.css", import.meta.url), "utf8");
+
+const spoken = [
+ "今天适合推进沟通，不适合拍板承诺。",
+ "",
+ "| 适合推进 | 需要避开 |",
+ "|---|---|",
+ "| 汇报、提案、写作 | 冲动承诺、夸大其词 |",
+ "",
+ "给一个现在就能做的行动。",
+].join("\n");
+
+const auditTable = [
+ "| 技法 | 状态 | 说明 |",
+ "|---|---|---|",
+ "| VedAstro 云状态 | 阻塞 | 未经核验的官方云证据，置信度封顶 |",
+ "| 功能吉凶星 | 已执行 | 功能属性与自然属性冲突时降置信 |",
+ "| 问卦盘（Prashna） | 不适用 | 本轮为本命咨询 |",
+].join("\n");
+
+test("a trailing technique audit table is split out of the spoken answer", () => {
+ const split = splitSpokenAnswerAndTechniqueAudit(`${spoken}\n\n${auditTable}`);
+ assert.equal(split.complete, true);
+ assert.equal(split.spoken, spoken);
+ assert.equal(split.spoken.includes("适合推进"), true);
+ assert.equal(split.spoken.includes("技法"), false);
+ assert.deepEqual(split.rows, [
+ { technique: "VedAstro 云状态", status: "blocked", note: "未经核验的官方云证据，置信度封顶" },
+ { technique: "功能吉凶星", status: "executed", note: "功能属性与自然属性冲突时降置信" },
+ { technique: "问卦盘（Prashna）", status: "not_applicable", note: "本轮为本命咨询" },
+ ]);
+});
+
+test("an incomplete streaming audit table is hidden rather than shown as pipes", () => {
+ const split = splitSpokenAnswerAndTechniqueAudit(`${spoken}\n\n| 技法 | 状态 | 说明 |\n|---|---|---|\n| VedAstro 云状态 | 阻塞 |`);
+ assert.equal(split.complete, false);
+ assert.equal(split.spoken, spoken);
+ assert.deepEqual(split.rows, []);
+});
+
+test("delivered receipt rows fill the folded table when the spoken answer has no dump", () => {
+ const delivered = normalizeTechniqueAuditRows([
+ { technique: "VedAstro Cloud State", status: "blocked", boundary: "confidence_capped_without_verified_official_cloud" },
+ { technique: "Formal Vargas D1–D60", status: "executed", boundary: "20/20 named traditional charts; remaining D-N are separate" },
+ { technique: "Western transits", status: "used", note: "layer_not_materialized" },
+ ]);
+ assert.deepEqual(delivered, [
+ { technique: "VedAstro Cloud State", status: "blocked", note: "confidence_capped_without_verified_official_cloud" },
+ { technique: "Formal Vargas D1–D60", status: "executed", note: "20/20 named traditional charts; remaining D-N are separate" },
+ { technique: "Western transits", status: "executed", note: "layer_not_materialized" },
+ ]);
+ assert.equal(displayTechniqueAuditLabel("VedAstro Cloud State"), "VedAstro 云状态");
+ assert.equal(displayTechniqueAuditLabel("Western transits"), "西洋行运");
+ assert.equal(displayTechniqueAuditNote("confidence_capped_without_verified_official_cloud"), "未经核验的官方云证据，置信度封顶");
+ assert.equal(displayTechniqueAuditNote("20/20 named traditional charts; remaining D-N are separate"), "20/20 传统命名分盘");
+ assert.equal(displayTechniqueAuditNote("layer_not_materialized"), "本层未物化");
+ assert.equal(displayTechniqueAuditNote("unmapped_machine_key"), "");
+ assert.equal(techniqueAuditStatusLabel("blocked"), "阻塞");
+
+ const split = splitSpokenAnswerAndTechniqueAudit(spoken);
+ assert.deepEqual(resolveTechniqueAuditRows(split, delivered), delivered);
+});
+
+test("the public receipt may carry the audit rows and still rejects internal diagnostics", () => {
+ const receipt = agentExecutionReceiptSchema.parse({
+ runId: "run",
+ runtime: "mastra-agentic",
+ skill: { name: "jyotish-vedic-astrology", loaded: true, referenceReads: 0, methodologySections: 0 },
+ steps: [{ sequence: 1, kind: "skill", name: "jyotish-vedic-astrology", status: "completed" }],
+ workflow: { route: "timing", status: "ready", preciseTiming: "allowed", missingLayers: [] },
+ techniqueAuditTable: [
+ { technique: "Narayana Dasha", status: "executed", note: "本轮无独立当前读数" },
+ ],
+ });
+ assert.equal(receipt.techniqueAuditTable?.[0]?.technique, "Narayana Dasha");
+ assert.throws(() => agentExecutionReceiptSchema.parse({
+ ...receipt,
+ techniqueAuditTable: [{ technique: "Narayana Dasha", status: "used" }],
+ }));
+});
+
+test("the folded audit control stays closed and never remounts the internal panel", () => {
+ assert.match(disclosureSource, //);
+ assert.doesNotMatch(disclosureSource, /]*\sopen/);
+ assert.doesNotMatch(disclosureSource, /EvidenceAuditPanel/);
+ assert.doesNotMatch(disclosureSource, /techniqueTruth|workflowReceipt|rawReceipt/);
+ assert.match(contentSource, /splitSpokenAnswerAndTechniqueAudit/);
+ assert.match(contentSource, /TechniqueAuditDisclosure/);
+ assert.match(toolsSource, /ctx\.state\.techniqueAuditTable = normalizeTechniqueAuditRows/);
+ assert.match(routeSource, /techniqueAuditTable: state\.techniqueAuditTable/);
+ assert.match(globalStyles, /\.markdown-table/);
+ assert.match(globalStyles, /\.technique-audit >/);
+ assert.match(globalStyles, /\.markdown-table th,/);
+});
diff --git a/frontend/tests/consultation-voice-contract.test.ts b/frontend/tests/consultation-voice-contract.test.ts
index c0f6bcf4..744ba92e 100644
--- a/frontend/tests/consultation-voice-contract.test.ts
+++ b/frontend/tests/consultation-voice-contract.test.ts
@@ -12,7 +12,7 @@ test("product voice keeps skill technique density without dumping JSON", () => {
assert.match(voice, /governs METHOD, TECHNIQUE INVOCATION, and TRUTH BOUNDARIES/);
assert.match(voice, /must not drop techniques, raw structures, or audit rows/);
assert.match(voice, /unified parameters and raw structure first/);
- assert.match(voice, /required Technique Audit Table/);
+ assert.match(voice, /Do not paste the Technique Audit Table/);
assert.match(voice, /已执行 \/ 阻塞 \/ 不适用/);
assert.match(voice, /Answer the user's actual question in the first sentence/);
assert.match(voice, /本轮未完整计算/);
@@ -26,6 +26,7 @@ test("product voice keeps skill technique density without dumping JSON", () => {
assert.match(binding, /never quote it, reveal it, or present its report template as the chat format/);
assert.match(mastra, /The bound skill method is this product's answering contract/);
assert.match(mastra, /Do not use a restricted technique/);
+ assert.match(mastra, /Do not paste that Technique Audit Table into the spoken answer/);
assert.match(mastra, /Do not announce a skipped-domain inventory/);
assert.doesNotMatch(mastra, /Name the domains you did cover, say plainly that the remaining ones were not calculated/);
assert.doesNotMatch(mastra, /2-5 short paragraphs/);
@@ -37,6 +38,6 @@ test("consult user turn no longer dumps tool JSON that the model would parrot",
assert.match(chartBranch, /请直接用口语回答下面的问题[\s\S]*?resolvedQuestion\.modelQuestion/);
assert.doesNotMatch(chartBranch, /JSON\.stringify\(toolInput\)/);
assert.doesNotMatch(chartBranch, /经过服务端校验的工具参数/);
- assert.match(route, /请用口语直接回答；回答末尾附上技法审计表，不要复述内部字段/);
+ assert.match(route, /请用口语直接回答；不要把技法审计表写进正文，不要复述内部字段/);
assert.match(chartBranch, /await runConsultationWorkflow\(toolInput/);
});
diff --git a/frontend/tests/evidence-audit-panel.test.ts b/frontend/tests/evidence-audit-panel.test.ts
index 46ef1ee7..fe8436fe 100644
--- a/frontend/tests/evidence-audit-panel.test.ts
+++ b/frontend/tests/evidence-audit-panel.test.ts
@@ -3,14 +3,17 @@ import { readFileSync } from "node:fs";
import test from "node:test";
const rowSource = readFileSync(new URL("../src/components/chat-message-row.tsx", import.meta.url), "utf8");
+const contentSource = readFileSync(new URL("../src/components/chat-message-content.tsx", import.meta.url), "utf8");
const panelSource = readFileSync(new URL("../src/components/evidence-audit-panel.tsx", import.meta.url), "utf8");
const pageSource = readFileSync(new URL("../src/app/page.tsx", import.meta.url), "utf8");
const globalStyles = readFileSync(new URL("../src/app/globals.css", import.meta.url), "utf8");
-test("assistant messages do not expose the internal Technique Audit Table", () => {
+test("assistant messages fold the user-facing Technique Audit Table and never remount the internal panel", () => {
assert.doesNotMatch(rowSource, /EvidenceAuditPanel/);
assert.doesNotMatch(rowSource, /claimStatus=\{message\.techniqueTruth\}/);
assert.doesNotMatch(rowSource, /workflowReceipt=\{message\.workflowReceipt\}/);
+ assert.match(contentSource, /TechniqueAuditDisclosure/);
+ assert.match(rowSource, /auditRows=\{message\.agentExecutionReceipt\?\.techniqueAuditTable\}/);
assert.match(panelSource, /Technique Audit Table/);
assert.match(panelSource, /Workflow route:/);
assert.match(panelSource, /Precise timing:/);
@@ -25,6 +28,8 @@ test("assistant messages do not expose the internal Technique Audit Table", () =
assert.match(panelSource, /查看非敏感 raw receipt/);
assert.match(globalStyles, /\.evidence-audit-panel/);
assert.match(globalStyles, /\.raw-evidence-receipt/);
+ assert.match(globalStyles, /\.technique-audit >/);
+ assert.match(globalStyles, /\.markdown-table/);
});
test("consult responses persist workflow receipt headers for evidence rendering", () => {
diff --git a/frontend/tests/skill-binding.test.ts b/frontend/tests/skill-binding.test.ts
index cafda5bf..5a9ec3b4 100644
--- a/frontend/tests/skill-binding.test.ts
+++ b/frontend/tests/skill-binding.test.ts
@@ -60,7 +60,7 @@ test("the bound method is the runtime excerpt, not the maintainer manual", () =>
assert.ok(body.includes(heading), heading);
assert.ok(bound.includes(heading), heading);
}
- for (const phrase of ["全谱系真实调用", "P0/P1 观察层", "网页对话在口语回答末尾给出 Technique Audit Table", "静态分析10步"]) {
+ for (const phrase of ["全谱系真实调用", "P0/P1 观察层", "网页对话的技法审计表由界面折叠展示", "静态分析10步"]) {
assert.ok(bound.includes(phrase), phrase);
}
for (const heading of ["施工判断原则", "冲顶路线", "37大子命令", "验证与错题体系", "开源复用边界冻结"]) {