dsh-tacit 0.2.2 → 0.3.0

package/docs/README.md

@@ -9,13 +9,13 @@ Pick the question you have:
 
 | I want to… | Read |
 | --- | --- |
-| Install it and see it working in five minutes | [Getting started](getting-started.md) |
+| Install it and see it working in five minutes | [Getting started](getting-started.md) ([中文](getting-started.zh.md)) |
 | Understand what it does, step by step, and what the words mean | [How it works](how-it-works.md) |
 | Know what leaves my machine, what it costs, and what it can't do yet | [Privacy, cost & limitations](privacy-and-cost.md) |
 | Change a setting | [Configuration](configuration.md) |
-| Read or change the code | [Architecture](architecture.md) · [Contributing](../CONTRIBUTING.md) |
+| Read or change the code | [Architecture](architecture.md) · [Contributing](../CONTRIBUTING.md) ([中文](CONTRIBUTING.zh.md)) |
 | See what changed between versions | [Changelog](../CHANGELOG.md) |
 
 Reading order for a newcomer: Getting started → How it works → Privacy & cost.
 
-中文：[README.zh.md](README.zh.md)（仅 README 有中文版）。
+中文：[README.zh.md](README.zh.md) · [快速开始](getting-started.zh.md) · [贡献指南](CONTRIBUTING.zh.md)（其余文档为英文）。

package/docs/README.zh.md

@@ -45,7 +45,7 @@ DeepSeek API Key（Tacit 从不读取它）。
 | **零点击学习** | 不顺的轮次和你自己的纠正会在后台被分析，并带上上一轮作为上下文；自动分析每天有上限（默认 30 次） | 每次 $0.001–0.003 |
 | **指令要靠表现留下** | 学到的指令作为一小段系统提示注入，你可以查看、编辑、开关或删除；新指令先是*候选*，如果你的不顺轮次比例变差就会退役 | 免费 |
 | **✨ 改进** | 输入框里的按钮，用 Tacit 学到的东西重写当前草稿，带前后对比预览和 👍/👎 | 每次点击 $0.001–0.002 |
-| **测量而非猜测** | 设置页显示你的真实趋势：不顺轮次比例和每轮 token 数，最早 20 轮 vs 最近 20 轮 | 免费 |
+| **测量而非猜测** | 设置页显示你的真实趋势：不顺轮次比例和每轮 token 数，最早 20 轮 vs 最近 20 轮——以及 Tacit 自己的花费：每次调用都被计量并按目录价定价，显示在设置页里 | 免费 |
 
 ## 它是怎么工作的
 
@@ -63,20 +63,21 @@ DeepSeek API Key（Tacit 从不读取它）。
 
 Tacit 从不接触你的 API Key（所有调用都经过 harness 自己的模型服务），只通过你会话
 自己的 provider 路由调用白名单里的官方模型，报告和指令都存放在
-`~/.dsh/storages/tacit/`，拒绝对自身路由的跨站请求，除了自己的报告之外从不删除任何
-东西。美元数字是按公开价格的估算；`dsh-cost-meter` 这样的成本插件会显示真实花费。
+`~/.dsh/storages/tacit/`，拒绝对自身路由的跨站请求，除了自己的报告和过期的用量记录
+之外从不删除任何东西。美元数字是按公开价格的估算；`dsh-cost-meter` 这样的成本插件会显示真实花费。
 完整的数据流与成本表、以及坦白的限制清单（英文）：
 [Privacy, cost & limitations](https://github.com/hackernotfound/dsh-tacit/blob/main/docs/privacy-and-cost.md)。
 
-## 文档（均为英文）
+## 文档（除标注外均为英文）
 
 | | |
 | --- | --- |
-| [Getting started](https://github.com/hackernotfound/dsh-tacit/blob/main/docs/getting-started.md) | 安装、确认已启用、快速起步、界面各处在哪、排障 |
+| [快速开始](https://github.com/hackernotfound/dsh-tacit/blob/main/docs/getting-started.zh.md)（[English](https://github.com/hackernotfound/dsh-tacit/blob/main/docs/getting-started.md)） | 安装、确认已启用、快速起步、界面各处在哪、排障 |
 | [How it works](https://github.com/hackernotfound/dsh-tacit/blob/main/docs/how-it-works.md) | 逐步流程，带图和术语表 |
 | [Privacy, cost & limitations](https://github.com/hackernotfound/dsh-tacit/blob/main/docs/privacy-and-cost.md) | 什么留在本地、什么会发出去、每次调用的花费、目前做不到的事 |
 | [Configuration](https://github.com/hackernotfound/dsh-tacit/blob/main/docs/configuration.md) | 所有设置项、默认值和取值范围 |
 | [Architecture](https://github.com/hackernotfound/dsh-tacit/blob/main/docs/architecture.md) | 面向贡献者：模块、钩子、路由、存储 |
-| [Contributing](https://github.com/hackernotfound/dsh-tacit/blob/main/CONTRIBUTING.md) · [Changelog](https://github.com/hackernotfound/dsh-tacit/blob/main/CHANGELOG.md) | |
+| [贡献指南](https://github.com/hackernotfound/dsh-tacit/blob/main/docs/CONTRIBUTING.zh.md)（[English](https://github.com/hackernotfound/dsh-tacit/blob/main/CONTRIBUTING.md)） | fork → 分支 → PR 的流程、测试、基本规则；欢迎提 issue 和 PR |
+| [Changelog](https://github.com/hackernotfound/dsh-tacit/blob/main/CHANGELOG.md) | 各版本的变更 |
 
 MIT © hackernotfound

package/lib/analyze.js

@@ -40,6 +40,25 @@ export function clipSafe(value, max) {
   return text.slice(0, end)
 }
 
+/**
+ * Clip a directive to `max` characters without ever cutting mid-word: prefer
+ * the last sentence end at or after `min`, else the last space, and mark a
+ * mid-sentence cut with an ellipsis. Text within the limit is returned as is.
+ */
+export function clipDirective(value, max = DIRECTIVE_MAX_CHARS, min = 60) {
+  const text = (typeof value === 'string' ? value : '').trim()
+  if (text.length <= max) return text
+  const head = clipSafe(text, max)
+  const sentenceEnd = Math.max(...['. ', '! ', '? ', '; ', '。', '！', '？', '；'].map((mark) => {
+    const at = head.lastIndexOf(mark)
+    return at >= min ? at + mark.trim().length : -1
+  }))
+  if (sentenceEnd > 0) return head.slice(0, sentenceEnd).trim()
+  const space = head.lastIndexOf(' ')
+  const cut = space >= min ? head.slice(0, space) : clipSafe(head, max - 1)
+  return cut.replace(/[\s,;:–—-]+$/u, '') + '…'
+}
+
 // ── Structured output: the model answers by CALLING one tool whose arguments
 // are the payload (the harness has no JSON mode; tool arguments are the
 // reliable structured channel). Text JSON is still accepted as a fallback.
@@ -71,11 +90,11 @@ export const ANALYSIS_TOOL = {
 
 export const IMPROVE_TOOL = {
   name: 'improved',
-  description: 'Submit the rewritten draft.',
+  description: 'Submit the final rewritten draft, or the draft verbatim when it is already complete.',
   parameters: {
     type: 'object',
     properties: {
-      improved: { type: 'string', description: 'the rewritten prompt' },
+      improved: { type: 'string', description: 'the final prompt (the draft verbatim if already complete)' },
       rationale: { type: 'string', description: '1-2 sentences on what changed and why' },
     },
     required: ['improved', 'rationale'],
@@ -88,11 +107,31 @@ export const DIRECTIVE_TOOL = {
   parameters: {
     type: 'object',
     properties: {
-      directives: { type: 'array', items: { type: 'string' }, minItems: 1, maxItems: 4 },
+      directives: {
+        type: 'array',
+        minItems: 1,
+        maxItems: 4,
+        items: {
+          type: 'object',
+          properties: {
+            text: { type: 'string', maxLength: 220, description: 'one sentence, at most 25 words' },
+            workspace: { type: 'string', description: 'only when the habit shows up in exactly one workspace: that workspace name as written in the evidence' },
+          },
+          required: ['text'],
+        },
+      },
     },
     required: ['directives'],
   },
 }
+export const MAX_WORKSPACE_DIRECTIVES = 4
+
+/** The last path segment of a workspace directory — what a person calls the project. */
+export function workspaceLabel(cwd) {
+  if (typeof cwd !== 'string' || cwd.length === 0) return ''
+  const parts = cwd.split(/[\\/]+/).filter((part) => part.length > 0)
+  return parts.length > 0 ? parts[parts.length - 1] : ''
+}
 export const DIRECTIVE_MAX_TOKENS = 1500
 export const DIRECTIVE_TIMEOUT_MS = 30000
 export const MAX_DIRECTIVES = 8
@@ -137,7 +176,7 @@ export function buildEnrichUserText({ draft, profile, recentContext }) {
     .filter((entry) => entry !== null && typeof entry === 'object' && entry.enabled !== false && typeof entry.text === 'string')
   if (directives.length > 0) {
     lines.push('=== WHAT THE COACH KNOWS ABOUT THIS USER ===')
-    for (const entry of directives.slice(0, MAX_DIRECTIVES)) lines.push('- ' + clipSafe(entry.text, DIRECTIVE_MAX_CHARS))
+    for (const entry of directives.slice(0, MAX_DIRECTIVES)) lines.push('- ' + clipDirective(entry.text))
     lines.push('')
   }
   const patterns = Array.isArray(profile?.patterns) ? profile.patterns.slice(0, 6) : []
@@ -226,6 +265,47 @@ const improveShape = z.object({
   rationale: z.string().default(''),
 })
 
+/**
+ * Learning from a recovery: the turn went cleanly right after a messy one in
+ * the same conversation. One small call names what the user supplied this
+ * time, in the same problem taxonomy, so the distiller knows what this user
+ * CAN state when reminded.
+ */
+export const GOOD_TOOL = {
+  name: 'report',
+  description: 'What the clean prompt supplied that the previous, messy one lacked.',
+  parameters: {
+    type: 'object',
+    properties: {
+      strengths: {
+        type: 'array',
+        maxItems: 4,
+        items: {
+          type: 'object',
+          properties: {
+            kind: { type: 'string', description: 'same categories as problems: missing-constraints|ambiguous-goal|missing-context|wrong-scope|...' },
+            what: { type: 'string', description: 'one sentence: what the prompt included this time' },
+          },
+          required: ['kind', 'what'],
+        },
+      },
+      lesson: { type: 'string', description: 'one sentence, about the user: what they included the second time that made the difference' },
+    },
+    required: ['strengths', 'lesson'],
+  },
+}
+export const GOOD_SYSTEM_PROMPT = [
+  'You coach prompt writing inside DeepSeek Harness. The previous turn of this',
+  'conversation went badly (retries, tool errors, a correction).',
+  'This turn went well. Compare the two prompts and the trajectory: what did the user',
+  'INCLUDE this time that the earlier prompt lacked — a file path, a constraint,',
+  'a scope, an acceptance criterion, an example? Report 1-4 strengths in the same',
+  'categories used for problems, and ONE sentence about the user ("They fix',
+  'wandering by naming the target file up front."). If the clean turn was',
+  'trivially easy or merely a continuation, return an empty strengths list and',
+  'an empty lesson. Never praise; state facts. Reply in the language of the prompt.',
+].join('\n')
+
 export const ANALYSIS_SYSTEM_PROMPT = [
   'You are a strict but friendly prompt-engineering coach inside DeepSeek Harness.',
   'You are given ONE past user prompt plus a digest of everything that happened',
@@ -267,18 +347,52 @@ export const ANALYSIS_SYSTEM_PROMPT = [
 
 export const IMPROVE_SYSTEM_PROMPT = [
   'You are a prompt-improvement assistant inside DeepSeek Harness.',
-  'The user typed a draft prompt into the composer. Rewrite it to be more',
-  'precise, complete, and token-efficient, while PRESERVING its intent.',
-  'Do not add requirements the user did not ask for; fill in only what is',
-  'genuinely underspecified (scope, constraints, format, acceptance criteria).',
-  'Learn from the user\'s recurring mistake patterns when provided.',
+  'The user typed a draft prompt for a coding agent into the composer. You get',
+  'ONE pass: return the prompt the user would arrive at after several rounds of',
+  'editing. Leave nothing for a second pass.',
+  '',
+  'A finished prompt has every item below (skip an item only when the draft or',
+  'context makes it obviously unnecessary):',
+  '- GOAL — one sentence: the outcome and what "done" looks like.',
+  '- CONTEXT — the concrete facts the agent would otherwise have to discover:',
+  '  file paths, URLs, names, versions, decisions already made. Take them from',
+  '  the draft and from RECENT CONVERSATION CONTEXT. Never invent facts.',
+  '- SCOPE — what is in and out; what to leave untouched.',
+  '- CONSTRAINTS — what not to do, limits, style, language, budget.',
+  '- OUTPUT FORMAT — the shape of the answer: list, table, diff, code only,',
+  '  prioritized, length.',
+  '- EFFICIENCY — what the agent need not explore or verify, so it finishes',
+  '  in fewer steps and tool calls.',
+  '',
+  'Rules:',
+  '- Preserve the user\'s intent; add nothing they did not ask for or clearly',
+  '  imply.',
+  '- Only fill what is genuinely underspecified. Keep the draft\'s wording where',
+  '  it already works.',
+  '- Be as short as completeness allows: no filler, no role preambles ("You are',
+  '  an expert…"), no restating what the agent already knows.',
+  '- Follow the STYLE RULES, NEGATIVE FEEDBACK and RECURRING MISTAKE PATTERNS',
+  '  when provided; they describe this user\'s habits.',
+  '- Silently check the draft against every item first, then write the whole',
+  '  prompt once.',
+  '- FIXED POINT: if the draft already satisfies every item, return it',
+  '  VERBATIM (character for character) with the rationale "Already complete."',
+  '  Never make cosmetic edits — a prompt you improved must come back',
+  '  unchanged when improved again.',
+  '',
+  'Example',
+  'draft: what do you think we can do to market our plugin today',
+  'context: the plugin was just published at https://github.com/x/y',
+  'improved: The plugin is now public at https://github.com/x/y. How do we',
+  'market it and get it noticed? Give a prioritized list of concrete actions,',
+  'easiest first, biggest impact last, with the expected effort for each.',
   '',
   'RESPONSE FORMAT — this is mandatory and machine-parsed:',
   'Your ENTIRE response must be ONE JSON object and nothing else. No preamble,',
   'no narration, no explanations outside the JSON, no markdown fences.',
   'Start directly with "{" and end with "}".',
   '{',
-  '  "improved": "<the rewritten prompt>",',
+  '  "improved": "<the final prompt — the draft verbatim if already complete>",',
   '  "rationale": "<1-2 sentences on what you changed and why>"',
   '}',
   '',
@@ -354,13 +468,23 @@ export const DIRECTIVE_SYSTEM_PROMPT = [
   '"continue" — that is fine; the conversation is the context).',
   'Directives must GENERALIZE across future tasks: never mention a specific',
   'task, file, feature, number, or test from one past prompt — describe the',
-  'habit and the compensation. Prefer the most frequent habits. 2-4 directives,',
-  'one sentence each, imperative mood, addressed to the agent. You are writing',
+  'habit and the compensation. One exception: when every piece of evidence for',
+  'a habit carries the same [workspace: name] tag, return that directive with',
+  '"workspace" set to exactly that name; it may then refer to that project\'s',
+  'layout ("check apps/web first"). Leave "workspace" out for everything else.',
+  'Prefer the most frequent habits. 2-4 directives,',
+  'ONE sentence each of at most 25 words (under 180 characters), imperative',
+  'mood, addressed to the agent. A directive that needs a second sentence is two',
+  'directives or too specific. You are writing',
   'the COMPLETE new set: keep existing directives that still hold (reworded if',
   'sharper), drop ones that were one-off, add what is missing. No preamble.',
 ].join('\n')
 
-export function buildDirectiveUserText(profile, recentReports = []) {
+export function buildDirectiveUserText(profile, recentReports = [], { labelOf = workspaceLabel } = {}) {
+  const tagOf = (cwd) => {
+    const label = typeof cwd === 'string' && cwd.length > 0 ? labelOf(cwd) : ''
+    return label.length > 0 ? '[workspace: ' + label + '] ' : ''
+  }
   const lines = ['=== RECURRING PROMPT HABITS (kind, times seen, latest example) ===']
   const patterns = Array.isArray(profile?.patterns) ? profile.patterns.slice(0, 12) : []
   if (patterns.length === 0) lines.push('(none yet)')
@@ -373,9 +497,27 @@ export function buildDirectiveUserText(profile, recentReports = []) {
   if (corrections.length > 0) {
     lines.push('', '=== RECENT CORRECTIONS (prompt → what the user said next) ===')
     for (const report of corrections) {
-      lines.push('- "' + clipSafe(String(report.promptExcerpt ?? ''), 120) + '" → "' + clipSafe(report.followUp, 200) + '"')
+      lines.push('- ' + tagOf(report.cwd) + '"' + clipSafe(String(report.promptExcerpt ?? ''), 120) + '" → "' + clipSafe(report.followUp, 200) + '"')
     }
   }
+  const lessons = (Array.isArray(recentReports) ? recentReports : [])
+    .filter((report) => typeof report?.lesson === 'string' && report.lesson.length > 0)
+    .slice(-5)
+  if (lessons.length > 0) {
+    lines.push('', '=== WHAT WORKED (a clean prompt right after a messy turn — what the user included this time) ===')
+    for (const report of lessons) {
+      lines.push('- ' + tagOf(report.cwd) + '"' + clipSafe(String(report.promptExcerpt ?? ''), 120) + '": ' + clipSafe(report.lesson, 300))
+    }
+  }
+  const byWorkspace = new Map()
+  for (const report of Array.isArray(recentReports) ? recentReports : []) {
+    const label = typeof report?.cwd === 'string' && report.cwd.length > 0 ? labelOf(report.cwd) : ''
+    if (label.length > 0) byWorkspace.set(label, (byWorkspace.get(label) ?? 0) + 1)
+  }
+  if (byWorkspace.size > 0) {
+    lines.push('', '=== WORKSPACES IN THE RECENT ANALYSES (name, analyses) ===')
+    for (const [label, count] of byWorkspace) lines.push('- ' + label + ' (' + count + ')')
+  }
   const rules = Array.isArray(profile?.styleRules) ? profile.styleRules.filter((rule) => typeof rule?.rule === 'string' && rule.rule.length > 0) : []
   if (rules.length > 0) {
     lines.push('', '=== STYLE RULES THE USER CONFIRMED ===')
@@ -384,9 +526,9 @@ export function buildDirectiveUserText(profile, recentReports = []) {
   const existing = Array.isArray(profile?.directives) ? profile.directives.filter((entry) => typeof entry?.text === 'string' && entry.text.length > 0) : []
   if (existing.length > 0) {
     lines.push('', '=== CURRENT DIRECTIVES (keep the ones that still hold) ===')
-    for (const entry of existing) lines.push('- ' + clipSafe(entry.text, DIRECTIVE_MAX_CHARS))
+    for (const entry of existing) lines.push('- ' + clipDirective(entry.text) + (typeof entry.workspace === 'string' && entry.workspace.length > 0 ? ' [workspace: ' + labelOf(entry.workspace) + ']' : ''))
   }
-  lines.push('', 'Write 2-4 directives for the agent about this user.')
+  lines.push('', 'Write 2-4 directives for the agent about this user. A habit the user has', 'shown they can fix themselves is still worth a directive: the agent should', 'compensate for it when it is missing, not ask.')
   return lines.join('\n')
 }
 
@@ -405,30 +547,42 @@ export function classifyDirectives(text) {
   const kept = []
   const rejected = []
   for (const item of raw) {
-    if (typeof item !== 'string') continue
-    const value = clipSafe(item.trim(), DIRECTIVE_MAX_CHARS)
-    const key = value.toLowerCase()
+    // Both shapes are accepted: a bare sentence, or { text, workspace? }.
+    const source = typeof item === 'string' ? item : (item !== null && typeof item === 'object' && typeof item.text === 'string' ? item.text : null)
+    if (source === null) continue
+    const value = clipDirective(source)
+    const workspace = typeof item === 'object' && item !== null && typeof item.workspace === 'string' && item.workspace.trim().length > 0
+      ? clipSafe(item.workspace.trim(), 200)
+      : undefined
+    const key = (workspace ?? '') + '\n' + value.toLowerCase()
     if (value.length === 0 || seen.has(key)) continue
     seen.add(key)
     if (ASKS_USER_RE.test(value)) {
       rejected.push(value)
       continue
     }
-    kept.push(value)
+    kept.push(workspace === undefined ? { text: value } : { text: value, workspace })
     if (kept.length >= 4) break
   }
   return { kept, rejected }
 }
 
 /**
- * The system-prompt section: what the agent is told about this user.
- * '' when nothing is enabled (an empty section contributes nothing).
+ * The system-prompt section: what the agent is told about this user, plus the
+ * ids of the directives that actually made it into the text (the directive
+ * cap and the character budget can drop enabled ones). `text` is '' when
+ * nothing is enabled (an empty section contributes nothing).
  */
-export function renderSteeringSection(profile) {
-  const enabled = (Array.isArray(profile?.directives) ? profile.directives : [])
+export function buildSteeringSection(profile, { cwd } = {}) {
+  const here = typeof cwd === 'string' && cwd.length > 0 ? cwd : null
+  const scopeOf = (entry) => (typeof entry.workspace === 'string' && entry.workspace.length > 0 ? entry.workspace : null)
+  const candidates = (Array.isArray(profile?.directives) ? profile.directives : [])
     .filter((entry) => entry !== null && typeof entry === 'object' && entry.enabled !== false && entry.status !== 'retired'
       && typeof entry.text === 'string' && entry.text.trim().length > 0)
-  if (enabled.length === 0) return ''
+    .filter((entry) => scopeOf(entry) === null || scopeOf(entry) === here)
+  // This workspace's own directives first: they are the more specific ones.
+  const enabled = [...candidates.filter((entry) => scopeOf(entry) !== null), ...candidates.filter((entry) => scopeOf(entry) === null)]
+  if (enabled.length === 0) return { text: '', ids: [] }
   const header = [
     '## About this user (learned by Tacit from their past prompts)',
     'This user tends to leave the following unsaid. Compensate silently when the',
@@ -436,14 +590,21 @@ export function renderSteeringSection(profile) {
     'the prompt always win over these notes.',
   ]
   const lines = [...header]
+  const ids = []
   let length = lines.join('\n').length
   for (const entry of enabled.slice(0, MAX_DIRECTIVES)) {
-    const line = '- ' + clipSafe(entry.text.trim(), DIRECTIVE_MAX_CHARS)
+    const line = '- ' + clipDirective(entry.text)
     if (length + line.length + 1 > STEERING_MAX_CHARS) break
     lines.push(line)
+    if (typeof entry.id === 'string') ids.push(entry.id)
     length += line.length + 1
   }
-  return lines.length > header.length ? lines.join('\n') : ''
+  return lines.length > header.length ? { text: lines.join('\n'), ids } : { text: '', ids: [] }
+}
+
+/** The steering section text alone. */
+export function renderSteeringSection(profile, options = {}) {
+  return buildSteeringSection(profile, options).text
 }
 
 /** Build the distillation user text from verbatim rejected-improvement reasons. */
@@ -653,6 +814,27 @@ const clipText = (value, max) => {
 }
 
 /** Shape a parsed analysis object into a report (falls back gracefully). */
+/** Shape a good-prompt call into a report: no problems, the original prompt kept, the lesson as explanation. */
+export function normalizeGoodReport(parsed, { turn, time, model, prompt }) {
+  const raw = parsed !== null && typeof parsed === 'object' ? parsed : {}
+  const strengths = (Array.isArray(raw.strengths) ? raw.strengths : [])
+    .filter((item) => item !== null && typeof item === 'object' && typeof item.what === 'string' && item.what.trim().length > 0)
+    .slice(0, 4)
+    .map((item) => ({ kind: clipText(typeof item.kind === 'string' ? item.kind : 'general', 60) || 'general', what: clipText(item.what, 600) }))
+  const lesson = typeof raw.lesson === 'string' ? clipText(raw.lesson.trim(), 300) : ''
+  return reportSchema.parse({
+    ok: true,
+    turn,
+    time,
+    model,
+    problems: [],
+    improvedPrompt: typeof prompt === 'string' ? clipText(prompt, 4000) : '',
+    explanation: lesson,
+    strengths,
+    lesson,
+  })
+}
+
 export function normalizeReport(parsed, { turn, time, model, rawText }) {
   if (parsed === null) {
     return {
@@ -729,9 +911,16 @@ export function aggregateProfile(prev, report, maxPatterns, options = {}) {
         rejected: counterOf(pattern, 'rejected'),
         verified: counterOf(pattern, 'verified'),
         unverified: counterOf(pattern, 'unverified'),
+        resolved: counterOf(pattern, 'resolved'),
       })
     }
   }
+  // A good-prompt report says which habits the user overcame on their own this time.
+  for (const strength of Array.isArray(report?.strengths) ? report.strengths : []) {
+    if (strength === null || typeof strength !== 'object') continue
+    const current = patterns.get(normalizeKind(strength.kind))
+    if (current !== undefined) current.resolved += 1
+  }
   const problems = Array.isArray(report?.problems) ? report.problems : []
   for (const problem of problems) {
     if (problem === null || typeof problem !== 'object') continue
@@ -745,6 +934,7 @@ export function aggregateProfile(prev, report, maxPatterns, options = {}) {
       rejected: 0,
       verified: 0,
       unverified: 0,
+      resolved: 0,
     }
     current.count += 1
     if (typeof problem.what === 'string' && problem.what.length > 0) current.lastExample = problem.what.slice(0, 200)
@@ -833,8 +1023,12 @@ export function lastDownReasons(profile, n = 3) {
  * NEVER returned as the answer (chain of thought is not a report). A
  * deployment that rejects the reasoning effort gets one retry without it.
  * Returns the answer text ('' when the model produced nothing usable).
+ *
+ * When `onUsage(record)` is given, it is called once per underlying `run()`
+ * (twice on the reasoning-effort retry) with a usage/cost record. A sink
+ * that throws never fails the model call.
  */
-export async function callCoachModel(ctx, { provider, model, system, userText, maxTokens, timeoutMs, tool, sessionId, reasoningEffort = COACH_REASONING_EFFORT }) {
+export async function callCoachModel(ctx, { provider, model, system, userText, maxTokens, timeoutMs, tool, sessionId, reasoningEffort = COACH_REASONING_EFFORT, onUsage }) {
   const llm = ctx.get !== undefined && typeof ctx.get === 'function' ? ctx.get('llm') : undefined
   if (llm === undefined || typeof llm.stream !== 'function') {
     const error = new Error('the harness LLM service is unavailable')
@@ -847,35 +1041,81 @@ export async function callCoachModel(ctx, { provider, model, system, userText, m
     content: [{ type: 'text', text: userText }],
     source: { kind: 'plugin', plugin: 'dsh-tacit' },
   })
+  const toCount = (value) => (Number.isFinite(value) && value >= 0 ? value : 0)
   const run = async (effort) => {
+    const startedAt = Date.now()
     let text = ''
     let toolArgs = ''
     let toolDeltas = ''
-    let finish = ''
-    for await (const chunk of llm.stream({
-      provider,
-      model,
-      messages: [message],
-      system,
-      maxTokens,
-      signal: controller.signal,
-      ...(effort !== undefined ? { reasoningEffort: effort } : {}),
-      ...(tool !== undefined ? { tools: [tool] } : {}),
-      ...(typeof sessionId === 'string' && sessionId.length > 0 ? { sessionId } : {}),
-    })) {
-      if (chunk === null || typeof chunk !== 'object') continue
-      if (chunk.type === 'finish' && typeof chunk.reason === 'string') finish = chunk.reason
-      if (chunk.type === 'text-delta' && typeof chunk.text === 'string') text += chunk.text
-      else if (chunk.type === 'tool-call-delta' && typeof chunk.argumentsDelta === 'string') toolDeltas += chunk.argumentsDelta
-      else if (chunk.type === 'block-end' && chunk.block !== null && typeof chunk.block === 'object'
-        && chunk.block.type === 'tool-call' && typeof chunk.block.arguments === 'string' && toolArgs === '') {
-        toolArgs = chunk.block.arguments
+    let finishKind = ''
+    let failure = null
+    let usage = null
+    let thrown = null
+    try {
+      for await (const chunk of llm.stream({
+        provider,
+        model,
+        messages: [message],
+        system,
+        maxTokens,
+        signal: controller.signal,
+        ...(effort !== undefined ? { reasoningEffort: effort } : {}),
+        ...(tool !== undefined ? { tools: [tool] } : {}),
+        ...(typeof sessionId === 'string' && sessionId.length > 0 ? { sessionId } : {}),
+      })) {
+        if (chunk === null || typeof chunk !== 'object') continue
+        if (chunk.type === 'usage' && chunk.usage !== null && typeof chunk.usage === 'object') {
+          usage = {
+            inputTokens: toCount(chunk.usage.inputTokens),
+            outputTokens: toCount(chunk.usage.outputTokens),
+            cacheReadTokens: toCount(chunk.usage.cacheReadTokens),
+            cacheWriteTokens: toCount(chunk.usage.cacheWriteTokens),
+            reasoningTokens: toCount(chunk.usage.reasoningTokens),
+          }
+        } else if (chunk.type === 'finish') {
+          finishKind = typeof chunk.reason === 'string' ? chunk.reason : (chunk.reason?.kind ?? '')
+          failure = chunk.reason?.failure ?? null
+        } else if (chunk.type === 'text-delta' && typeof chunk.text === 'string') text += chunk.text
+        else if (chunk.type === 'tool-call-delta' && typeof chunk.argumentsDelta === 'string') toolDeltas += chunk.argumentsDelta
+        else if (chunk.type === 'block-end' && chunk.block !== null && typeof chunk.block === 'object'
+          && chunk.block.type === 'tool-call' && typeof chunk.block.arguments === 'string' && toolArgs === '') {
+          toolArgs = chunk.block.arguments
+        }
+      }
+      if (finishKind === 'error' || finishKind === 'aborted') {
+        thrown = Object.assign(new Error(failure?.message ?? finishKind), { code: failure?.code ?? finishKind.toUpperCase() })
+        throw thrown
+      }
+    } catch (error) {
+      thrown = thrown ?? error
+      throw error
+    } finally {
+      if (typeof onUsage === 'function') {
+        const code = (thrown !== null && typeof thrown === 'object' ? thrown.code : undefined) ?? failure?.code ?? ''
+        const status = thrown !== null || finishKind === 'error' || finishKind === 'aborted'
+          ? 'failed'
+          : (usage === null ? 'unmetered' : 'ok')
+        try {
+          onUsage({
+            startedAt,
+            durationMs: Date.now() - startedAt,
+            model,
+            provider,
+            reasoningEffort: effort ?? null,
+            finish: finishKind,
+            status,
+            code,
+            usage,
+          })
+        } catch {
+          // a sink bug must never fail a model call
+        }
       }
     }
     if (toolArgs.length > 0) return toolArgs
     if (toolDeltas.length > 0) return toolDeltas
-    if (text.length === 0 && finish.length > 0 && finish !== 'stop') {
-      console.warn('[tacit] model call ended without an answer (finish: ' + finish + ', maxTokens: ' + String(maxTokens) + ')')
+    if (text.length === 0 && finishKind.length > 0 && finishKind !== 'stop') {
+      console.warn('[tacit] model call ended without an answer (finish: ' + finishKind + ', maxTokens: ' + String(maxTokens) + ')')
     }
     return text
   }

package/lib/index.js

@@ -80,7 +80,22 @@ export function apply(ctx, config) {
     if (typeof off === 'function') ctx.effect(() => off, 'tacit: pre-step enrichment')
   }
 
+  // One line so an audit can tell from the logs alone that Tacit is loaded
+  // and what it is currently injecting.
+  try {
+    const cfg = effectiveConfig()
+    const directives = store.profile().directives
+    const count = (status) => directives.filter((entry) => entry.status === status).length
+    console.info('[tacit] loaded — directives: ' + count('active') + ' active, ' + count('candidate') + ' candidates, '
+      + count('retired') + ' retired; steering ' + (cfg.steerAgent ? 'on' : 'off') + '; auto-analysis '
+      + (cfg.autoAnalyze ? 'on (cap ' + cfg.autoDailyBudget + '/day)' : 'off'))
+  } catch {
+    // Logging must never keep the plugin from loading.
+  }
+
   ctx.effect(() => () => {
-    // Nothing to flush: all writes are atomic and complete at call time.
+    // Reports and the profile are written atomically at call time; only the
+    // usage ledger keeps debounced state, so an unload flushes it.
+    service.usage.flush()
   }, 'tacit: dispose')
 }