minimal-vibe-coding-kit 0.5.0 → 0.5.1

package/.agents/skills/tutien/scripts/response-brief.mjs

@@ -0,0 +1,103 @@
+// Compact, aggregate-only handoff between the deterministic analyzer and the
+// agent-authored response. It carries facts and constraints, never stock prose.
+
+const localizeMissing = (reason, language) => {
+  if (language !== 'vi') return reason;
+  if (reason === 'token usage coverage below 60%; supply provider usage metadata to compute a realm') {
+    return 'Độ phủ số liệu token dưới 60%; cần bổ sung dữ liệu sử dụng từ nhà cung cấp để tính cảnh giới.';
+  }
+  return reason;
+};
+
+function localized(value, language) {
+  if (!value || typeof value !== 'object') return value ?? null;
+  return value[language] ?? value.en ?? value.vi ?? null;
+}
+
+function problemEvidence(problem) {
+  const evidence = problem.evidence ?? {};
+  if (problem.problemType === 'repeated-failure' || problem.problemType === 'too-many-prompts') return { repeatCount: evidence.repeatCount ?? 0 };
+  if (problem.problemType === 'conflicting-instructions') return { count: evidence.count ?? 0 };
+  if (problem.problemType === 'unrecovered-failure') return { count: evidence.count ?? 0 };
+  if (problem.problemType === 'work-without-proof') return { commits: evidence.commits ?? 0 };
+  return {};
+}
+
+export function buildResponseBrief(model, options = {}) {
+  const language = options.language === 'vi' ? 'vi' : 'en';
+  const profile = options.profile ?? {};
+  const classification = model.cultivation?.classification ?? null;
+  const progression = model.cultivation?.progression ?? null;
+  return {
+    schema: 'tutien-response-brief-v1',
+    semanticNamespace: model.experience.semanticNamespace,
+    language,
+    tone: model.tone,
+    policy: {
+      state: model.policyState,
+      suppressGamification: model.suppressGamification
+    },
+    project: {
+      id: profile.projectId ?? 'repo',
+      type: profile.projectType ?? null,
+      primaryLanguage: profile.primaryLanguage ?? null,
+      domains: profile.domains ?? [],
+      stack: profile.stack ?? [],
+      packageManager: profile.packageManager ?? null,
+      validationCommands: profile.validationCommands ?? [],
+      recommendedValidation: profile.recommendedValidation ?? null,
+      metadataSources: profile.metadataSources ?? [],
+      kitInstalled: profile.kitInstalled === true
+    },
+    evidence: {
+      coverage: model.coverage,
+      tokens: model.tokens,
+      realm: model.realm ? { name: model.realm.name, score: model.score } : null,
+      enoughEvidence: model.enoughEvidence,
+      missing: (model.missing ?? []).map((reason) => localizeMissing(reason, language)),
+      dimensions: model.dimensions
+    },
+    cultivation: classification ? {
+      faction: classification.faction?.id ?? null,
+      affiliation: classification.affiliation?.id ?? null,
+      paths: (classification.paths ?? []).map((item) => item.id),
+      progression: progression ? {
+        tuVi: progression.tuVi?.window ?? 0,
+        congDuc: progression.congDuc?.window ?? 0,
+        nghiepLuc: progression.nghiepLuc?.window ?? 0,
+        daoHanhWindows: progression.daoHanh?.windows ?? 0
+      } : null
+    } : null,
+    findings: (model.problems ?? []).map((problem) => ({
+      type: problem.problemType,
+      confidence: problem.confidence,
+      priority: problem.priority,
+      evidence: problemEvidence(problem),
+      counterTechnique: localized(problem.counterTechnique, language),
+      projectHelp: problem.projectHelp ?? null,
+      microQuest: localized(problem.microQuest, language),
+      victory: localized(problem.victory, language)
+    })),
+    nextPractice: model.ifThen ? localized(model.ifThen, language) : null,
+    story: options.storyContext ? {
+      evidenceKey: options.storyContext.evidenceKey,
+      language: options.storyContext.language,
+      style: options.storyContext.style,
+      focus: options.storyContext.focus,
+      canWriteChapter: options.storyContext.canWriteChapter
+    } : null,
+    artifacts: { evidenceLedger: options.ledgerPath ?? null },
+    composition: {
+      finalResponse: 'agent-authored',
+      evidenceLedgerIsNotFinalResponse: true,
+      deriveFrom: ['current-user-request', 'project-facts', 'approved-evidence', 'living-chronicle', 'recent-response-rhythm'],
+      preserve: model.composition.preserve,
+      vary: model.composition.vary,
+      prohibitions: ['stock-heading-sequence', 'stock-opening', 'stock-closing', 'raw-prompt-text', 'raw-event-ids'],
+      vietnameseEndingIntent: language === 'vi'
+        ? 'Kết cà khịa, luôn giáo huấn, không tâng bốc và kéo dài dư âm vai diễn.'
+        : null
+    }
+  };
+}
+

package/.agents/skills/tutien/scripts/run-tutien.mjs

@@ -5,12 +5,21 @@ import process from 'node:process';
 import crypto from 'node:crypto';
 import { fileURLToPath } from 'node:url';
 import { spawnSync } from 'node:child_process';
-import { parseInvocation, TUTIEN_EXPERIENCE } from './command.mjs';
+import {
+  normalizeStoryFocus,
+  normalizeStoryLanguage,
+  normalizeStoryStyle,
+  parseInvocation,
+  TUTIEN_EXPERIENCE
+} from './command.mjs';
 import { analyze } from './analyze-history.mjs';
 import { renderReport, resolveLanguage, renderClassificationMarkdown } from './render-report.mjs';
 import { buildSnapshot, snapshotsToPrune } from './snapshot.mjs';
 import { compareSnapshots } from './compare.mjs';
 import { classifyProject } from './classify.mjs';
+import { buildStoryContext, storyPaths, validateStoryTree, writeStoryContext } from './story-ledger.mjs';
+import { buildProjectProfile, inventoryProjectMetadata } from './project-profile.mjs';
+import { buildResponseBrief } from './response-brief.mjs';
 
 // End-to-end executor for the advertised /tutien actions. All state lives
 // under the git-ignored .vibekit/reports/tutien/ of the current repo; the
@@ -41,6 +50,20 @@ function saveState(state) {
   fs.writeFileSync(stateFile, `${JSON.stringify(state, null, 2)}\n`);
 }
 
+function resolveStoryPreferences(state, options, providedOptions = []) {
+  const provided = new Set(providedOptions);
+  const prior = state.storyPreferences ?? {};
+  const choose = (key, optionKey, fallback) => provided.has(key) ? options[optionKey] : (prior[optionKey] ?? options[optionKey] ?? fallback);
+  const preferences = {
+    story: choose('story', 'story', 'on') === 'off' ? 'off' : 'on',
+    storyLanguage: normalizeStoryLanguage(choose('story-language', 'storyLanguage', 'auto')),
+    storyStyle: normalizeStoryStyle(choose('story-style', 'storyStyle', 'auto')),
+    storyFocus: normalizeStoryFocus(choose('story-focus', 'storyFocus', 'balanced'))
+  };
+  state.storyPreferences = preferences;
+  return preferences;
+}
+
 function classifySources(sources) {
   const spec = { jsonlFiles: [], transcriptFiles: [], gitRoot: null };
   for (const s of sources) {
@@ -51,61 +74,60 @@ function classifySources(sources) {
   return spec;
 }
 
-const scopeToken = (sources, range) => sha16(JSON.stringify({ sources: [...sources].sort(), range }));
+const scopeToken = (sources, range, metadata = inventoryProjectMetadata(root)) => sha16(JSON.stringify({
+  sources: [...sources].sort(),
+  range,
+  metadata: metadata.map(({ path: file, size, mtimeMs }) => ({ path: file, size, mtimeMs }))
+}));
 
-// Project profile for classification: repo metadata only (backbone.yml
-// fields plus a distinct-commit-author COUNT — no names or emails are kept)
-// merged with explicit declarations from the invocation.
+// Project profile for classification: a bounded set of known manifests plus a
+// distinct-commit-author COUNT. Script bodies, names, emails, and file content
+// are never returned or persisted.
 function repoProfile(options) {
-  let description = null;
-  let primaryLanguage = null;
-  let projectType = null;
-  try {
-    const text = fs.readFileSync(path.join(root, 'backbone.yml'), 'utf8');
-    const grab = (re) => {
-      const m = text.match(re);
-      return m ? m[1].trim().replace(/^["']|["']$/g, '') : null;
-    };
-    description = grab(/^\s*description:\s*(.+)$/m);
-    primaryLanguage = grab(/^\s*primary_language:\s*(.+)$/m);
-    projectType = grab(/^\s*type:\s*(.+)$/m);
-  } catch {}
+  const profile = buildProjectProfile(root, options);
   // Author identifiers are read transiently (mailmap-collapsed) and reduced to
   // a distinct COUNT immediately; no email or name is retained or returned.
   let authorsCount = null;
   const res = spawnSync('git', ['log', '--use-mailmap', '--format=%aE'], { cwd: root, encoding: 'utf8' });
   if (res.status === 0) authorsCount = new Set(res.stdout.split('\n').filter(Boolean)).size;
-  return {
-    description,
-    primaryLanguage,
-    projectType,
-    domains: options.domains ?? [],
-    authorization: options.authorization ?? null,
-    authorsCount,
-    declared: { faction: options.faction, affiliation: options.affiliation, paths: options.paths }
-  };
+  return { ...profile, authorsCount };
 }
 
 // Preview inspects no content: file existence and size only, plus the git
 // toplevel path. Nothing is parsed and nothing is written except the pending
 // approval in the state file.
-function previewLines(options) {
-  const lines = ['tutien preview — the observatory is open, but no scroll has been read; nothing is analyzed until this exact scope is approved.'];
-  if (options.sources.length === 0) lines.push('- (no sources; pass sources=git,/path/to/export.jsonl)');
+function previewLines(options, language = 'en') {
+  const vi = language === 'vi';
+  const metadata = inventoryProjectMetadata(root);
+  const lines = [vi
+    ? 'Xem trước phạm vi tu tiên: đài quan sát đã mở nhưng chưa đọc cuộn thư nào. Chỉ phân tích sau khi phạm vi chính xác này được phê duyệt.'
+    : 'tutien preview — the observatory is open, but no scroll has been read; nothing is analyzed until this exact scope is approved.'];
+  if (options.sources.length === 0) lines.push(vi ? '- Chưa có nguồn. Hãy truyền `sources=git,/duong-dan/export.jsonl`.' : '- (no sources; pass sources=git,/path/to/export.jsonl)');
   for (const s of options.sources) {
     if (s === 'git') {
-      lines.push(`- git: commit metadata of ${root} (read-only git log, current repository only)`);
+      lines.push(vi ? `- Git: chỉ đọc siêu dữ liệu bản ghi của kho hiện tại tại ${root}.` : `- git: commit metadata of ${root} (read-only git log, current repository only)`);
     } else {
       let size = null;
       try {
         size = fs.statSync(s).size;
       } catch {}
-      lines.push(size == null ? `- file: ${s} (NOT FOUND)` : `- file: ${s} (${size} bytes)`);
+      lines.push(size == null
+        ? (vi ? `- Tệp: ${s} (không tìm thấy)` : `- file: ${s} (NOT FOUND)`)
+        : (vi ? `- Tệp: ${s} (${size} byte)` : `- file: ${s} (${size} bytes)`));
     }
   }
-  lines.push(`- range: ${options.range}`);
-  const token = scopeToken(options.sources, options.range);
-  lines.push(`To approve exactly this scope: analyze approve=${token} sources=${options.sources.join(',')}`);
+  if (metadata.length) {
+    lines.push(vi
+      ? `- Metadata dự án: ${metadata.map((item) => `${item.path} (${item.size} byte)`).join(', ')}; chỉ đọc nội dung sau khi phê duyệt.`
+      : `- project metadata: ${metadata.map((item) => `${item.path} (${item.size} bytes)`).join(', ')}; content is read only after approval.`);
+  } else {
+    lines.push(vi ? '- Metadata dự án: không tìm thấy manifest đã biết.' : '- project metadata: no known manifest found.');
+  }
+  lines.push(vi ? `- Phạm vi thời gian: ${options.range}` : `- range: ${options.range}`);
+  const token = scopeToken(options.sources, options.range, metadata);
+  lines.push(vi
+    ? `Để phê duyệt đúng phạm vi này: \`analyze approve=${token} sources=${options.sources.join(',')}\``
+    : `To approve exactly this scope: analyze approve=${token} sources=${options.sources.join(',')}`);
   return { lines, token };
 }
 
@@ -118,33 +140,50 @@ const EXPLAIN = {
   realm: 'Weighted dimension score (delivery 30%, validation 25%, clarity 15%, recovery 15%, safety 10%, automation 5%) mapped to the realm ladder; requires >= 60% known-token coverage, otherwise "Chưa đủ thiên cơ".'
 };
 
+const EXPLAIN_VI = {
+  reportedTotal: 'Tổng số token hợp lệ do nhà cung cấp báo cáo. Bản ghi luồng tích lũy có cùng `requestId` chỉ được tính một lần theo giá trị cuối; các đoạn độc lập được cộng riêng. Bản ghi không có tổng dương hợp lệ sẽ không được tính.',
+  estimatedTotal: 'Tổng số token hợp lệ được ước lượng cục bộ; không bao giờ gộp vào `reportedTotal`.',
+  unknownTurns: 'Số lượt trả lời của trợ lý không có dữ liệu sử dụng hoặc không có tổng hợp lệ. Tuyên bố độ chính xác mà thiếu số liệu vẫn được tính là chưa rõ.',
+  retryLoops: 'Chuỗi từ ba lời yêu cầu giống hoặc gần giống nhau trong cùng một nhiệm vụ, xen giữa bởi phản hồi của trợ lý hay công cụ; đây là các dấu hiệu có chấm mức tin cậy.',
+  conflicts: 'Một chỉ thị dạng “không bao giờ” hoặc “không làm X”, sau đó trong cùng nhiệm vụ xuất hiện lời yêu cầu làm X; cặp mã sự kiện có độ tin cậy 0,6.',
+  realm: 'Điểm có trọng số từ sáu chiều được ánh xạ vào thang cảnh giới. Cần ít nhất 60% độ phủ token đã biết; nếu thiếu sẽ trả về “Chưa đủ thiên cơ”.'
+};
+
 export function run(argsString = '') {
-  const { action, explicitAction, options } = parseInvocation(argsString);
+  const { action, explicitAction, options, providedOptions } = parseInvocation(argsString);
   const state = loadState();
+  const storyPreferences = resolveStoryPreferences(state, options, providedOptions);
+  const uiLanguage = resolveLanguage(options.language, { invocationText: argsString });
+  const say = (vi, en) => uiLanguage === 'vi' ? vi : en;
   const refuse = (msg) => ({ code: 2, out: [msg] });
 
   if (action === 'off') {
     state.mode = 'off';
     delete state.pendingApproval;
     saveState(state);
-    return { code: 0, out: ['Tutien mode is off. Normal kit writing style restored.'] };
+    return { code: 0, out: [say('Chế độ tu tiên đã tắt. Văn phong bình thường của bộ công cụ đã được khôi phục.', 'Tutien mode is off. Normal kit writing style restored.')] };
   }
   if (action === 'on') {
     state.mode = 'on';
     saveState(state);
-    return { code: 0, out: ['Tutien mode is on — the mountain gate is open. Run preview to see the exact scope before any analysis.'] };
+    return { code: 0, out: [say('Chế độ tu tiên đã bật. Sơn môn đã mở; hãy chạy `preview` để xem phạm vi chính xác trước khi phân tích.', 'Tutien mode is on — the mountain gate is open. Run preview to see the exact scope before any analysis.')] };
   }
   if (action === 'status') {
     const snaps = fs.existsSync(snapDir) ? fs.readdirSync(snapDir).length : 0;
+    const storyStatus = validateStoryTree(root);
     return {
       code: 0,
       out: [
-        `mode: ${state.mode ?? 'off'}`,
-        `experience: ${TUTIEN_EXPERIENCE.kind}`,
-        `voice: ${TUTIEN_EXPERIENCE.narrativeStyle}`,
-        `semantic namespace: ${TUTIEN_EXPERIENCE.semanticNamespace}`,
-        `pending approval: ${state.pendingApproval ?? 'none'}`,
-        `snapshots: ${snaps}`
+        say(`chế độ: ${(state.mode ?? 'off') === 'on' ? 'bật' : 'tắt'}`, `mode: ${state.mode ?? 'off'}`),
+        say(`trải nghiệm: \`${TUTIEN_EXPERIENCE.kind}\``, `experience: ${TUTIEN_EXPERIENCE.kind}`),
+        say(`giọng văn: \`${TUTIEN_EXPERIENCE.narrativeStyle}\``, `voice: ${TUTIEN_EXPERIENCE.narrativeStyle}`),
+        say(`không gian ngữ nghĩa: \`${TUTIEN_EXPERIENCE.semanticNamespace}\``, `semantic namespace: ${TUTIEN_EXPERIENCE.semanticNamespace}`),
+        say(`phê duyệt đang chờ: ${state.pendingApproval ?? 'không có'}`, `pending approval: ${state.pendingApproval ?? 'none'}`),
+        say(`ảnh chụp tổng hợp: ${snaps}`, `snapshots: ${snaps}`),
+        say(`trường thiên: ${storyPreferences.story === 'on' ? 'bật' : 'tắt'} (${storyPreferences.storyLanguage}, ${storyPreferences.storyStyle}, ${storyPreferences.storyFocus})`, `story: ${storyPreferences.story} (${storyPreferences.storyLanguage}, ${storyPreferences.storyStyle}, ${storyPreferences.storyFocus})`),
+        say(`số chương: ${storyStatus.chapters}`, `story chapters: ${storyStatus.chapters}`),
+        say(`tổng cương: ${path.relative(root, storyPaths(root).plot)}`, `story plot: ${path.relative(root, storyPaths(root).plot)}`),
+        say(`sổ chương: ${storyStatus.ok ? 'hợp lệ' : `cần xem lại (${storyStatus.errors.length} lỗi)`}`, `story ledger: ${storyStatus.ok ? 'valid' : `needs attention (${storyStatus.errors.length})`}`)
       ]
     };
   }
@@ -152,21 +191,24 @@ export function run(argsString = '') {
   // Report actions. A bare `/tutien` re-activates the mode; an explicit
   // report action while off is refused (off-mode suppression).
   if ((state.mode ?? 'off') !== 'on') {
-    if (explicitAction) return refuse("tutien mode is off; run 'on' (or bare /tutien) first.");
+    if (explicitAction) return refuse(say('Chế độ tu tiên đang tắt. Hãy chạy `on` hoặc gọi `/tutien` trước.', "tutien mode is off; run 'on' (or bare /tutien) first."));
     state.mode = 'on';
   }
 
   if (action === 'preview') {
-    const { lines, token } = previewLines(options);
+    const { lines, token } = previewLines(options, uiLanguage);
+    lines.push(say(
+      `- Trường thiên: ${storyPreferences.story === 'on' ? 'bật' : 'tắt'}; ngôn ngữ ${storyPreferences.storyLanguage}, phong cách ${storyPreferences.storyStyle}, trọng tâm ${storyPreferences.storyFocus}.`,
+      `- living chronicle: ${storyPreferences.story} (language=${storyPreferences.storyLanguage}, style=${storyPreferences.storyStyle}, focus=${storyPreferences.storyFocus})`
+    ));
     state.pendingApproval = token;
     saveState(state);
     return { code: 0, out: lines };
   }
 
   if (action === 'classify') {
-    // classify is a metadata-only action (no history content): it reads
-    // backbone.yml fields and a transient distinct-author count of the current
-    // repo. It states that scope before producing the classification.
+    // classify is a metadata-only action (no history content): it reads only
+    // the known manifests advertised below and a transient author count.
     let classification;
     try {
       classification = classifyProject(repoProfile(options));
@@ -175,37 +217,38 @@ export function run(argsString = '') {
     }
     saveState(state);
     const language = resolveLanguage(options.language, { invocationText: argsString });
+    const sources = inventoryProjectMetadata(root).map((item) => item.path).join(', ') || 'none';
     const scope = language === 'vi'
-      ? 'Phạm vi classify: chỉ đọc metadata (backbone.yml + số lượng tác giả commit của repo hiện tại) — không đọc nội dung lịch sử, không tính tiến cảnh (tiến cảnh cần `analyze`).'
-      : 'classify scope: metadata only (backbone.yml + a distinct commit-author count of the current repo) — no history content is read, and no progression is computed (progression needs `analyze`).';
+      ? `Phạm vi classify: chỉ đọc manifest đã biết (${sources}) và số lượng tác giả Git; không đọc nội dung lịch sử, không tính tiến cảnh (tiến cảnh cần \`analyze\`).`
+      : `classify scope: known manifests only (${sources}) plus a distinct Git-author count; no history content is read, and no progression is computed (progression needs \`analyze\`).`;
     return { code: 0, out: [scope, '', renderClassificationMarkdown(classification, language)] };
   }
 
   if (action === 'explain') {
     if (options.metric && EXPLAIN[options.metric]) {
-      return { code: 0, out: [`A note from the Dao ledger — ${options.metric}: ${EXPLAIN[options.metric]}`] };
+      return { code: 0, out: [say(`Ghi chú từ đạo ký về \`${options.metric}\`: ${EXPLAIN_VI[options.metric]}`, `A note from the Dao ledger — ${options.metric}: ${EXPLAIN[options.metric]}`)] };
     }
-    return { code: 0, out: [`The Dao ledger can explain: ${Object.keys(EXPLAIN).join(', ')} (pass metric=<name>).`] };
+    return { code: 0, out: [say(`Đạo ký có thể giải thích: ${Object.keys(EXPLAIN).map((key) => `\`${key}\``).join(', ')}. Hãy truyền \`metric=<tên>\`.`, `The Dao ledger can explain: ${Object.keys(EXPLAIN).join(', ')} (pass metric=<name>).`)] };
   }
 
   if (action === 'compare') {
     const files = fs.existsSync(snapDir) ? fs.readdirSync(snapDir).filter((f) => f.endsWith('.json')).sort() : [];
-    if (files.length < 2) return refuse('need at least two snapshots to compare; run analyze snapshot=true first.');
+    if (files.length < 2) return refuse(say('Cần ít nhất hai ảnh chụp tổng hợp để so sánh. Hãy chạy `analyze snapshot=true` trước.', 'need at least two snapshots to compare; run analyze snapshot=true first.'));
     const load = (f) => JSON.parse(fs.readFileSync(path.join(snapDir, f), 'utf8'));
     const result = compareSnapshots(load(files[files.length - 2]), load(files[files.length - 1]));
     return {
       code: 0,
-      out: ['Two cultivation records rest beneath the same lamp; the figures below show only what changed.', JSON.stringify(result, null, 2)]
+      out: [say('Hai bản tu luyện cùng đặt dưới một ngọn đèn; số liệu dưới đây chỉ cho thấy phần đã thay đổi.', 'Two cultivation records rest beneath the same lamp; the figures below show only what changed.'), JSON.stringify(result, null, 2)]
     };
   }
 
   if (action === 'analyze') {
-    const token = scopeToken(options.sources, options.range);
+    const token = scopeToken(options.sources, options.range, inventoryProjectMetadata(root));
     if (!options.approve) {
-      return refuse('analysis requires explicit approval: run preview, then pass the approve=<token> it printed.');
+      return refuse(say('Phân tích cần được phê duyệt rõ ràng. Hãy chạy `preview`, rồi truyền lại `approve=<token>` đã nhận.', 'analysis requires explicit approval: run preview, then pass the approve=<token> it printed.'));
     }
     if (options.approve !== token || state.pendingApproval !== token) {
-      return refuse('approval token does not match the previewed scope; run preview again and approve that exact scope.');
+      return refuse(say('Token phê duyệt không khớp phạm vi đã xem trước. Hãy chạy lại `preview` và phê duyệt đúng phạm vi đó.', 'approval token does not match the previewed scope; run preview again and approve that exact scope.'));
     }
     delete state.pendingApproval;
 
@@ -249,19 +292,54 @@ export function run(argsString = '') {
       });
       const file = path.join(snapDir, `${createdAt.replace(/[:.]/g, '-')}.json`);
       fs.writeFileSync(file, `${JSON.stringify(snap, null, 2)}\n`);
-      out.push(`snapshot written: ${path.relative(root, file)}`);
+      out.push(say(`Đã ghi ảnh chụp tổng hợp: ${path.relative(root, file)}`, `snapshot written: ${path.relative(root, file)}`));
       const prune = snapshotsToPrune(fs.readdirSync(snapDir).filter((f) => f.endsWith('.json')), 20);
       if (prune.length) {
-        out.push(`retention: remove old snapshots with: trash ${prune.map((f) => path.relative(root, path.join(snapDir, f))).join(' ')}`);
+        out.push(say(`Lưu giữ: có thể chuyển các ảnh chụp cũ vào thùng rác bằng lệnh \`trash ${prune.map((f) => path.relative(root, path.join(snapDir, f))).join(' ')}\`.`, `retention: remove old snapshots with: trash ${prune.map((f) => path.relative(root, path.join(snapDir, f))).join(' ')}`));
+      }
+    }
+    let storyContext = null;
+    if (storyPreferences.story === 'on') {
+      if (model.suppressGamification) {
+        out.push(say(`Trường thiên tạm dừng: trạng thái chính sách \`${model.policyState}\` không cho phép viết cốt truyện.`, `living chronicle paused: policy state ${model.policyState} does not permit lore.`));
+      } else {
+        storyContext = buildStoryContext(model, {
+          profile,
+          range: options.range,
+          language: storyPreferences.storyLanguage,
+          invocationText: argsString,
+          conversationLanguage: language,
+          style: storyPreferences.storyStyle,
+          focus: storyPreferences.storyFocus
+        });
+        const contextFile = writeStoryContext(root, storyContext);
+        out.push(say(`Đã ghi ngữ cảnh trường thiên: ${path.relative(root, contextFile)}; bằng chứng \`${storyContext.evidenceKey}\`.`, `story context written: ${path.relative(root, contextFile)} (evidence ${storyContext.evidenceKey})`));
       }
     }
     fs.mkdirSync(reportDir, { recursive: true });
-    fs.writeFileSync(path.join(reportDir, 'latest.md'), `${markdown}\n`);
+    const ledgerFile = path.join(reportDir, 'latest.md');
+    const briefFile = path.join(reportDir, 'latest-brief.json');
+    fs.writeFileSync(ledgerFile, `${markdown}\n`);
+    const brief = buildResponseBrief(model, {
+      language,
+      profile,
+      storyContext,
+      ledgerPath: path.relative(root, ledgerFile)
+    });
+    fs.writeFileSync(briefFile, `${JSON.stringify(brief, null, 2)}\n`);
+    out.push(say(
+      `Đã ghi đạo ký chứng cứ: ${path.relative(root, ledgerFile)}.`,
+      `evidence ledger written: ${path.relative(root, ledgerFile)}.`
+    ));
+    out.push(say(
+      `Gói sáng tác đã sẵn sàng: ${path.relative(root, briefFile)}; hãy dùng dữ kiện này để viết phản hồi linh hoạt theo dự án, không sao chép bố cục đạo ký.`,
+      `response brief ready: ${path.relative(root, briefFile)}; compose adaptively from it instead of copying the ledger structure.`
+    ));
     saveState(state);
-    return { code: 0, out: [...out, markdown] };
+    return { code: 0, out: options.output === 'ledger' ? [...out, markdown] : out };
   }
 
-  return refuse(`unknown action "${action}"`);
+  return refuse(say(`Không nhận ra hành động "${action}".`, `unknown action "${action}"`));
 }
 
 const isMain = process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url);