dravoice 0.1.0 → 0.1.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Dravoice contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Dravoice contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,21 +1,22 @@
-# Dravoice
-
-Dravoice is a local-first CLI for compiling Markdown, MDX, and plain-text
-writing corpora into reusable voice guidance and deterministic draft review
-notes.
-
-It is not an AI-authorship detector, grammar checker, prose linter, or
-third-party author imitation tool. It helps a writer inspect and reuse their
-own measurable rhythm, register, evidence habits, discourse shape, and
-structure.
-
-## Quick Start
-
-```bash
-npx --package dravoice drav learn --examples ./articles --out ./dravoice-voice
-npx --package dravoice drav inspect --voice ./dravoice-voice
+# Dravoice
+
+Dravoice is a local-first CLI for compiling Markdown, MDX, and plain-text
+writing corpora into reusable voice guidance and deterministic draft review
+notes.
+
+It is not an AI-authorship detector, grammar checker, prose linter, or
+third-party author imitation tool. It helps a writer inspect and reuse their
+own measurable rhythm, register, evidence habits, discourse shape, and
+structure.
+
+## Quick Start
+
+```bash
+npx --package dravoice drav learn --examples ./articles --out ./dravoice-voice
+npx --package dravoice drav inspect --voice ./dravoice-voice
 npx --package dravoice drav prompt --voice ./dravoice-voice --format agents --out AGENTS.md
 npx --package dravoice drav brief --voice ./dravoice-voice --topic "A new article topic" --evidence notes.md --out brief.md
+npx --package dravoice drav revise-plan draft.md --voice ./dravoice-voice
 npx --package dravoice drav review draft.md --voice ./dravoice-voice
 npx --package dravoice drav review draft.md --voice ./dravoice-voice --mode strict --format json
 ```
@@ -23,13 +24,14 @@ npx --package dravoice drav review draft.md --voice ./dravoice-voice --mode stri
 `learn` writes a schemaVersion 2 `profile.json` plus local metadata. `inspect`
 makes the learned feature families visible, `prompt` turns high-confidence
 observations into drafting guidance, `brief` creates an evidence-first article
-plan, and `review` reports family-level drift.
-
-## Fresh Install Smoke Test
-
-From a packed tarball:
-
-```bash
-npm pack
-npm exec --package ./dravoice-0.1.0.tgz -- drav --help
-```
+plan, `revise-plan` ranks calibrated stylometric revision actions, and `review`
+reports family-level drift.
+
+## Fresh Install Smoke Test
+
+From a packed tarball:
+
+```bash
+npm pack
+npm exec --package ./dravoice-0.1.1.tgz -- drav --help
+```

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dravoice",
-  "version": "0.1.0",
-  "description": "Compile article voice profiles into reusable LLM writing context, evidence-first briefs, and deterministic draft review notes.",
+  "version": "0.1.1",
+  "description": "Compile article voice profiles into reusable LLM writing context, evidence-first briefs, and deterministic draft review notes.",
   "type": "module",
   "bin": {
     "drav": "bin/dravoice.js"

package/src/index.js

@@ -1,25 +1,27 @@
-import fs from "node:fs";
-import path from "node:path";
-import {
-  prepareVoiceBenchmark,
-  renderBenchmarkReport,
-  scoreVoiceBenchmark,
-} from "./v2/benchmark.js";
-import { renderVoiceBriefV2, voiceArticleBriefV2 } from "./v2/brief.js";
-import { renderInspectV2 } from "./v2/inspect.js";
+import fs from "node:fs";
+import path from "node:path";
+import {
+  prepareVoiceBenchmark,
+  renderBenchmarkReport,
+  scoreVoiceBenchmark,
+} from "./v2/benchmark.js";
+import { renderVoiceBriefV2, voiceArticleBriefV2 } from "./v2/brief.js";
+import { renderInspectV2 } from "./v2/inspect.js";
 import { learnVoicePackV2, loadVoicePackV2 } from "./v2/profile.js";
 import { voicePromptPackV2 } from "./v2/prompt.js";
 import { renderVoiceReviewV2, reviewVoiceDraftV2 } from "./v2/review.js";
+import { renderRevisePlanV2, revisePlanDraftV2 } from "./v2/revise-plan.js";
 
 export {
   learnVoicePackV2 as learnVoicePack,
-  loadVoicePackV2 as loadVoicePack,
-  reviewVoiceDraftV2 as reviewVoiceDraft,
-  voicePromptPackV2 as voicePromptPack,
-};
-export { renderInspectV2, renderVoiceReviewV2 as renderVoiceReview };
-export { renderVoiceBriefV2 as renderVoiceBrief, voiceArticleBriefV2 as voiceArticleBrief };
-export { prepareVoiceBenchmark, renderBenchmarkReport, scoreVoiceBenchmark };
+  loadVoicePackV2 as loadVoicePack,
+  revisePlanDraftV2 as revisePlanDraft,
+  reviewVoiceDraftV2 as reviewVoiceDraft,
+  voicePromptPackV2 as voicePromptPack,
+};
+export { renderInspectV2, renderRevisePlanV2 as renderRevisePlan, renderVoiceReviewV2 as renderVoiceReview };
+export { renderVoiceBriefV2 as renderVoiceBrief, voiceArticleBriefV2 as voiceArticleBrief };
+export { prepareVoiceBenchmark, renderBenchmarkReport, scoreVoiceBenchmark };
 
 export async function runCli(args, io) {
   try {
@@ -39,7 +41,7 @@ export async function runCli(args, io) {
       return 0;
     }
 
-    if (command === "review") {
+    if (command === "review") {
       const { options, positional } = parseArgs(rest, ["voice", "mode", "format"]);
       const file = positional[0];
       if (!file) {
@@ -56,46 +58,65 @@ export async function runCli(args, io) {
       } else {
         io.stdout.write(renderVoiceReviewV2(result));
       }
-      return result.exitCode;
-    }
-
-    if (command === "prompt") {
-      const { options } = parseArgs(rest, ["voice", "format", "out"]);
-      const rendered = voicePromptPackV2({
-        voice: loadVoicePackV2(resolvePath(io.cwd, options.voice ?? ".")),
-        format: options.format ?? "agents",
-        outPath: options.out ? resolvePath(io.cwd, options.out) : undefined,
-      });
-      if (!options.out) {
-        io.stdout.write(rendered);
-      }
-      return 0;
+      return result.exitCode;
     }
 
-    if (command === "brief") {
-      const { options } = parseArgs(rest, ["voice", "topic", "evidence", "format", "out"]);
-      const result = voiceArticleBriefV2({
+    if (command === "revise-plan") {
+      const { options, positional } = parseArgs(rest, ["voice", "format"]);
+      const file = positional[0];
+      if (!file) {
+        throw new Error("Missing draft file path for revise-plan");
+      }
+      const result = revisePlanDraftV2({
+        file: resolvePath(io.cwd, file),
         voice: loadVoicePackV2(resolvePath(io.cwd, options.voice ?? ".")),
-        topic: requiredOption(options, "topic"),
-        evidence: options.evidence ? resolvePath(io.cwd, options.evidence) : undefined,
         cwd: io.cwd,
       });
-      const rendered = options.format === "json" ? `${JSON.stringify(result, null, 2)}\n` : renderVoiceBriefV2(result);
-      if (options.out) {
-        const outPath = resolvePath(io.cwd, options.out);
-        fs.mkdirSync(path.dirname(outPath), { recursive: true });
-        fs.writeFileSync(outPath, rendered, "utf8");
+      if (options.format === "json") {
+        io.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
       } else {
-        io.stdout.write(rendered);
+        io.stdout.write(renderRevisePlanV2(result));
       }
       return 0;
     }
 
-    if (command === "inspect") {
-      const { options } = parseArgs(rest, ["voice"]);
-      const profile = loadVoicePackV2(resolvePath(io.cwd, options.voice ?? "."));
-      io.stdout.write(renderInspectV2(profile));
-      return 0;
+    if (command === "prompt") {
+      const { options } = parseArgs(rest, ["voice", "format", "out"]);
+      const rendered = voicePromptPackV2({
+        voice: loadVoicePackV2(resolvePath(io.cwd, options.voice ?? ".")),
+        format: options.format ?? "agents",
+        outPath: options.out ? resolvePath(io.cwd, options.out) : undefined,
+      });
+      if (!options.out) {
+        io.stdout.write(rendered);
+      }
+      return 0;
+    }
+
+    if (command === "brief") {
+      const { options } = parseArgs(rest, ["voice", "topic", "evidence", "format", "out"]);
+      const result = voiceArticleBriefV2({
+        voice: loadVoicePackV2(resolvePath(io.cwd, options.voice ?? ".")),
+        topic: requiredOption(options, "topic"),
+        evidence: options.evidence ? resolvePath(io.cwd, options.evidence) : undefined,
+        cwd: io.cwd,
+      });
+      const rendered = options.format === "json" ? `${JSON.stringify(result, null, 2)}\n` : renderVoiceBriefV2(result);
+      if (options.out) {
+        const outPath = resolvePath(io.cwd, options.out);
+        fs.mkdirSync(path.dirname(outPath), { recursive: true });
+        fs.writeFileSync(outPath, rendered, "utf8");
+      } else {
+        io.stdout.write(rendered);
+      }
+      return 0;
+    }
+
+    if (command === "inspect") {
+      const { options } = parseArgs(rest, ["voice"]);
+      const profile = loadVoicePackV2(resolvePath(io.cwd, options.voice ?? "."));
+      io.stdout.write(renderInspectV2(profile));
+      return 0;
     }
 
     if (command === "benchmark") {
@@ -190,15 +211,16 @@ function resolvePath(cwd, value) {
   return path.isAbsolute(value) ? value : path.join(cwd, value);
 }
 
-function helpText() {
-  return [
-    "drav learn --examples ./articles --out ./dravoice-voice",
-    "drav inspect --voice ./dravoice-voice",
-    "drav prompt --voice ./dravoice-voice --format agents --out AGENTS.md",
+function helpText() {
+  return [
+    "drav learn --examples ./articles --out ./dravoice-voice",
+    "drav inspect --voice ./dravoice-voice",
+    "drav prompt --voice ./dravoice-voice --format agents --out AGENTS.md",
     "drav brief --voice ./dravoice-voice --topic \"New topic\" --evidence notes.md --out brief.md",
     "drav review draft.md --voice ./dravoice-voice --mode balanced --format text",
+    "drav revise-plan draft.md --voice ./dravoice-voice --format text",
     "drav benchmark prepare --examples ./articles --topic \"New topic\" --out ./bench-run --seed 42",
-    "drav benchmark score --run ./bench-run --judge ./bench-run/judge/judgment.json",
-    "",
-  ].join("\n");
-}
+    "drav benchmark score --run ./bench-run --judge ./bench-run/judge/judgment.json",
+    "",
+  ].join("\n");
+}

package/src/v2/analyzers/evidence.js

@@ -36,8 +36,12 @@ export function analyzeEvidence(documents) {
   };
 }
 
-export function evidenceTypes(text) {
-  return Object.entries(EVIDENCE_PATTERNS)
-    .filter(([, pattern]) => pattern.test(text))
-    .map(([type]) => type);
-}
+export function evidenceTypes(text) {
+  return Object.entries(EVIDENCE_PATTERNS)
+    .filter(([, pattern]) => pattern.test(text))
+    .map(([type]) => type);
+}
+
+export function isAbstractClaim(text) {
+  return ABSTRACT_CLAIM_RE.test(text);
+}

package/src/v2/benchmark.js

@@ -5,30 +5,22 @@ import { voicePromptPackV2 } from "./prompt.js";
 import { reviewVoiceDraftV2 } from "./review.js";
 import { clampScore } from "./text-utils.js";
 
-const BENCHMARK_SCHEMA_VERSION = 2;
-const GENERATED_BY = "dravoice-v2-benchmark";
-const VOICE_EXTENSIONS = new Set([".md", ".mdx", ".txt"]);
-const SKIP_DIRS = new Set([".git", "dist", "build", "node_modules", ".venv", "venv", "__pycache__"]);
-const SOURCE_SNAPSHOT_MARKER = ".dravoice-benchmark-sources";
-const BENCHMARK_ARTIFACT_DIRS = new Set(["prompts", "drafts", "judge"]);
-
-export function prepareVoiceBenchmark({ examplesDir, topic, outDir, seed = 1, cwd = process.cwd() }) {
-  const examplesRoot = path.resolve(resolvePath(cwd, examplesDir));
-  const outputRoot = path.resolve(resolvePath(cwd, outDir));
-  const normalizedSeed = normalizeSeed(seed);
-  const sourceFiles = walkVoiceFiles(examplesRoot);
-  if (sourceFiles.length === 0) {
-    throw new Error(`No Markdown, MDX, or text examples found at ${examplesDir}`);
-  }
-
-  const voicePackDir = path.join(outputRoot, "voice-pack");
-  const promptsDir = path.join(outputRoot, "prompts");
-  const draftsDir = path.join(outputRoot, "drafts");
-  fs.mkdirSync(promptsDir, { recursive: true });
-  fs.mkdirSync(draftsDir, { recursive: true });
-
-  const profile = learnVoicePackV2({ examplesDir: examplesRoot, outDir: voicePackDir });
-  const sources = sourceFiles.map((filePath, index) => sourceArticle(filePath, examplesRoot, index));
+const BENCHMARK_SCHEMA_VERSION = 2;
+const GENERATED_BY = "dravoice-v2-benchmark";
+
+export function prepareVoiceBenchmark({ examplesDir, topic, outDir, seed = 1, cwd = process.cwd() }) {
+  const examplesRoot = path.resolve(resolvePath(cwd, examplesDir));
+  const outputRoot = path.resolve(resolvePath(cwd, outDir));
+  const normalizedSeed = normalizeSeed(seed);
+
+  const voicePackDir = path.join(outputRoot, "voice-pack");
+  const promptsDir = path.join(outputRoot, "prompts");
+  const draftsDir = path.join(outputRoot, "drafts");
+  fs.mkdirSync(promptsDir, { recursive: true });
+  fs.mkdirSync(draftsDir, { recursive: true });
+
+  const profile = learnVoicePackV2({ examplesDir: examplesRoot, outDir: voicePackDir });
+  const sources = benchmarkSourcesFromProfile(profile);
   const blind = blindMapping(normalizedSeed);
   const benchmark = {
     schemaVersion: BENCHMARK_SCHEMA_VERSION,
@@ -538,58 +530,56 @@ function assertObject(value, field) {
   }
 }
 
-function sourceArticle(filePath, rootDir, index = 0) {
-  const contents = fs.readFileSync(filePath, "utf8");
-  const extension = path.extname(filePath).toLowerCase() || ".txt";
-  return {
-    id: `source-${index + 1}`,
-    path: `source-${index + 1}${extension}`,
-    title: `Source ${index + 1}`,
-    words: (contents.match(/[a-z][a-z0-9'-]*/gi) ?? []).length,
-  };
-}
-
-function benchmarkSources(benchmark, resolved) {
-  return resolved.corpus.files.map((file, index) => ({
-    id: file.id ?? `source-${index + 1}`,
-    path: file.path,
-    title: file.title ?? `Source ${index + 1}`,
-    words: file.words,
-  }));
-}
-
-function benchmarkDrafts(benchmark, resolved) {
-  return ["A", "B"].map((label) => {
-    const draftPath = benchmark.blind.draftFiles[label];
-    const resolvedDraftPath = resolved.blind.draftFiles[label];
-    return {
-      label,
-      path: draftPath,
-      words: fs.existsSync(resolvedDraftPath)
-        ? (fs.readFileSync(resolvedDraftPath, "utf8").match(/[a-z][a-z0-9'-]*/gi) ?? []).length
-        : 0,
-    };
-  });
-}
-
-function blindMapping(seed) {
-  const baselineIsA = seededRandom(seed) < 0.5;
-  const labels = {
-    baseline: baselineIsA ? "A" : "B",
-    voiceAssisted: baselineIsA ? "B" : "A",
-  };
-  return {
-    labels,
-    drafts: {
-      A: baselineIsA ? "baseline" : "voice-assisted",
-      B: baselineIsA ? "voice-assisted" : "baseline",
-    },
-    draftFiles: {
-      A: baselineIsA ? "drafts/baseline.md" : "drafts/voice-assisted.md",
-      B: baselineIsA ? "drafts/voice-assisted.md" : "drafts/baseline.md",
-    },
-  };
-}
+function benchmarkSourcesFromProfile(profile) {
+  return profile.source.files.map((file, index) => ({
+    id: file.id ?? `source-${index + 1}`,
+    path: `source-${index + 1}${file.extension || ".txt"}`,
+    title: `Source ${index + 1}`,
+    words: file.wordCount,
+  }));
+}
+
+function benchmarkSources(benchmark, resolved) {
+  return resolved.corpus.files.map((file, index) => ({
+    id: file.id ?? `source-${index + 1}`,
+    path: file.path,
+    title: file.title ?? `Source ${index + 1}`,
+    words: file.words,
+  }));
+}
+
+function benchmarkDrafts(benchmark, resolved) {
+  return ["A", "B"].map((label) => {
+    const draftPath = benchmark.blind.draftFiles[label];
+    const resolvedDraftPath = resolved.blind.draftFiles[label];
+    return {
+      label,
+      path: draftPath,
+      words: fs.existsSync(resolvedDraftPath)
+        ? (fs.readFileSync(resolvedDraftPath, "utf8").match(/[a-z][a-z0-9'-]*/gi) ?? []).length
+        : 0,
+    };
+  });
+}
+
+function blindMapping(seed) {
+  const baselineIsA = seededRandom(seed) < 0.5;
+  const labels = {
+    baseline: baselineIsA ? "A" : "B",
+    voiceAssisted: baselineIsA ? "B" : "A",
+  };
+  return {
+    labels,
+    drafts: {
+      A: baselineIsA ? "baseline" : "voice-assisted",
+      B: baselineIsA ? "voice-assisted" : "baseline",
+    },
+    draftFiles: {
+      A: baselineIsA ? "drafts/baseline.md" : "drafts/voice-assisted.md",
+      B: baselineIsA ? "drafts/voice-assisted.md" : "drafts/baseline.md",
+    },
+  };
+}
 
 function seededRandom(seed) {
   const next = (normalizeSeed(seed) * 1664525 + 1013904223) >>> 0;
@@ -608,66 +598,7 @@ function normalizeSeed(seed) {
   return Number(parsed);
 }
 
-function walkVoiceFiles(rootDir) {
-  if (!fs.existsSync(rootDir)) {
-    return [];
-  }
-  const result = [];
-  for (const entry of fs.readdirSync(rootDir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
-    const fullPath = path.join(rootDir, entry.name);
-    if (entry.isDirectory()) {
-      if (!isSkippedVoiceDir(fullPath, entry.name)) {
-        result.push(...walkVoiceFiles(fullPath));
-      }
-    } else if (VOICE_EXTENSIONS.has(path.extname(entry.name).toLowerCase()) && !isGeneratedBenchmarkMarkdown(fullPath)) {
-      result.push(fullPath);
-    }
-  }
-  return result.sort((a, b) => toPosix(path.relative(rootDir, a)).localeCompare(toPosix(path.relative(rootDir, b))));
-}
-
-function isSkippedVoiceDir(dirPath, name) {
-  if (SKIP_DIRS.has(name)) {
-    return true;
-  }
-  if (name === "voice-pack" || name === "dravoice-voice" || name === ".dravoice") {
-    return true;
-  }
-  if (fs.existsSync(path.join(dirPath, SOURCE_SNAPSHOT_MARKER))) {
-    return true;
-  }
-  if (isBenchmarkRunDir(dirPath)) {
-    return true;
-  }
-  if (BENCHMARK_ARTIFACT_DIRS.has(name) && isBenchmarkRunDir(path.dirname(dirPath))) {
-    return true;
-  }
-  return fs.existsSync(path.join(dirPath, "profile.json"));
-}
-
-function isBenchmarkRunDir(dirPath) {
-  const benchmarkPath = path.join(dirPath, "benchmark.json");
-  if (!fs.existsSync(benchmarkPath)) {
-    return false;
-  }
-  try {
-    const benchmark = JSON.parse(fs.readFileSync(benchmarkPath, "utf8"));
-    return benchmark?.generatedBy === GENERATED_BY;
-  } catch {
-    return false;
-  }
-}
-
-function isGeneratedBenchmarkMarkdown(filePath) {
-  const basename = path.basename(filePath).toLowerCase();
-  if (!["baseline-writer.md", "voice-writer.md", "judge.md", "report.md"].includes(basename)) {
-    return false;
-  }
-  const contents = fs.readFileSync(filePath, "utf8");
-  return /^# (?:Baseline Writer Prompt|Voice-Assisted Writer Prompt|Blind V2 Voice Benchmark Judge Prompt|Dravoice V2 Voice Benchmark Report)/m.test(contents);
-}
-
-function writeIfMissing(filePath, contents) {
+function writeIfMissing(filePath, contents) {
   if (!fs.existsSync(filePath)) {
     fs.writeFileSync(filePath, contents, "utf8");
   }