dravoice 0.1.2 → 0.1.3

package/src/v2/brief.js

@@ -1,146 +1,154 @@
-import fs from "node:fs";
-import path from "node:path";
-import { evidenceTypes } from "./analyzers/evidence.js";
-import { parseDocument } from "./document-model.js";
-import { loadVoicePackV2 } from "./profile.js";
-
-export function voiceArticleBriefV2({ voice, topic, evidence, cwd = process.cwd() }) {
-  const profile = typeof voice === "string" ? loadVoicePackV2(resolvePath(cwd, voice)) : voice;
-  const evidenceResult = evidence ? evidenceAnchorsFromFile({ evidence, cwd }) : {
-    source: null,
-    anchors: [],
-  };
-
-  return {
-    schemaVersion: 2,
-    generatedBy: "dravoice-v2-brief",
-    topic,
-    voice: {
-      corpusConfidence: profile.source.confidence,
-      sourceFileCount: profile.source.documentCount,
-      sourceWordCount: profile.source.wordCount,
-      primaryRegister: profile.families.register.features.primary.value,
-      evidenceSentenceRate: profile.families.evidence.features.evidenceSentenceRate,
-      featureFamilies: Object.keys(profile.families),
-      draftingRules: profile.guidance.draftingRules.slice(0, 5),
-    },
-    workingThesis: `Draft a grounded article about ${topic}. Let the supplied evidence set the size of each claim before broadening the lesson.`,
-    evidence: evidenceResult,
-    missingEvidence: missingEvidenceFor({ topic, evidenceAnchors: evidenceResult.anchors }),
-    outline: outlineFor(profile),
-    voiceCautions: [
-      ...profile.guidance.avoid,
-      "Mark unsupported claims as [specific evidence needed] instead of inventing proof.",
-    ].slice(0, 5),
-  };
-}
-
-export function renderVoiceBriefV2(brief) {
-  const lines = [
-    `# Article Brief: ${brief.topic}`,
-    "",
-    "## Voice Source",
-    "",
-    `- Corpus confidence: ${capitalize(brief.voice.corpusConfidence.band)} - ${brief.voice.corpusConfidence.message}`,
-    `- Source files: ${brief.voice.sourceFileCount}`,
-    `- Primary register: ${brief.voice.primaryRegister}`,
-    `- Evidence sentence rate: ${brief.voice.evidenceSentenceRate}`,
-    "",
-    "## Working Thesis",
-    "",
-    `- ${brief.workingThesis}`,
-    "",
-    "## Evidence Anchors",
-    "",
-  ];
-
-  if (brief.evidence.anchors.length) {
-    for (const item of brief.evidence.anchors) {
-      const typeList = item.types.length ? ` (${item.types.join(", ")})` : "";
-      lines.push(`- ${brief.evidence.source}:${item.line}${typeList} - ${item.text}`);
-    }
-  } else {
-    lines.push("- [specific evidence needed] Add notes, dates, quotes, examples, or source links before drafting broad claims.");
-  }
-
-  lines.push("", "## Missing Evidence", "");
-  lines.push(...brief.missingEvidence.map((item) => `- ${item}`));
-
-  lines.push("", "## Outline", "");
-  lines.push(...brief.outline.map((item, index) => `${index + 1}. ${item}`));
-
-  lines.push("", "## Voice Cautions", "");
-  lines.push(...brief.voiceCautions.map((item) => `- ${item}`));
-
-  lines.push(
-    "",
-    "## Drafting Prompt",
-    "",
-    `Write the article about ${brief.topic} using the evidence anchors above. Keep claims close to concrete support, follow the voice cautions, and write [specific evidence needed] anywhere the brief does not supply enough ground.`,
-    "",
-  );
-
-  return lines.join("\n");
-}
-
-function evidenceAnchorsFromFile({ evidence, cwd }) {
-  const evidencePath = resolvePath(cwd, evidence);
-  const contents = fs.readFileSync(evidencePath, "utf8");
-  const document = parseDocument({
-    filePath: evidencePath,
-    rootDir: cwd,
-    contents,
-  });
-
-  return {
-    source: displayPath(evidencePath, cwd),
-    anchors: document.sentences
-      .map((sentence) => ({
-        line: sentence.line,
-        text: sentence.text,
-        types: evidenceTypes(sentence.text),
-      }))
-      .filter((sentence) => sentence.types.length > 0)
-      .slice(0, 8),
-  };
-}
-
-function missingEvidenceFor({ topic, evidenceAnchors }) {
-  const items = [
-    `Add [specific evidence needed] for the central claim about ${topic}.`,
-    "Add [specific evidence needed] for any number, date, quote, source, or example the article depends on.",
-  ];
-  if (evidenceAnchors.length === 0) {
-    items.unshift("No evidence anchors were detected; collect concrete notes before asking for a full draft.");
-  }
-  return items;
-}
-
-function outlineFor(profile) {
-  const opening = profile.families.rhetoricalShape.features.openingMoves.slice(0, 3).join(" -> ");
-  const sentenceMedian = profile.families.rhythm.features.sentenceWords.median;
-  return [
-    opening
-      ? `Start from a concrete artifact or observation, keeping the opening shape compatible with: ${opening}.`
-      : "Start from a concrete artifact or observation before making the larger claim.",
-    "Name the pressure, question, or practical stakes that make the evidence matter.",
-    `Develop the article in the learned register with sentence pacing near the ${sentenceMedian}-word median where it fits.`,
-    "Close by returning to the evidence and leaving the reader with a practical handle, not a generic conclusion.",
-  ];
-}
-
-function resolvePath(cwd, value) {
-  return path.isAbsolute(value) ? value : path.join(cwd, value);
-}
-
-function displayPath(filePath, rootDir) {
-  const relative = path.relative(rootDir, filePath);
-  if (relative && !relative.startsWith("..") && !path.isAbsolute(relative)) {
-    return relative.split(path.sep).join("/");
-  }
-  return filePath.split(path.sep).join("/");
-}
-
-function capitalize(value) {
-  return String(value ?? "").charAt(0).toUpperCase() + String(value ?? "").slice(1);
-}
+import path from "node:path";
+import { evidenceTypes } from "./analyzers/evidence.js";
+import { parseDocument } from "./document-model.js";
+import { readUtf8FileBounded } from "./io-utils.js";
+import { loadVoicePackV2 } from "./profile.js";
+
+export function voiceArticleBriefV2({ voice, topic, evidence, cwd = process.cwd() }) {
+  const profile = typeof voice === "string" ? loadVoicePackV2(resolvePath(cwd, voice)) : voice;
+  const evidenceResult = evidence ? evidenceAnchorsFromFile({ evidence, cwd }) : {
+    source: null,
+    anchors: [],
+  };
+
+  return {
+    schemaVersion: 2,
+    generatedBy: "dravoice-v2-brief",
+    topic,
+    voice: {
+      corpusConfidence: profile.source.confidence,
+      sourceFileCount: profile.source.documentCount,
+      sourceWordCount: profile.source.wordCount,
+      primaryRegister: profile.families.register.features.primary.value,
+      evidenceSentenceRate: profile.families.evidence.features.evidenceSentenceRate,
+      featureFamilies: Object.keys(profile.families),
+      draftingRules: profile.guidance.draftingRules.slice(0, 5),
+    },
+    workingThesis: `Draft a grounded article about ${topic}. Let the supplied evidence set the size of each claim before broadening the lesson.`,
+    evidence: evidenceResult,
+    missingEvidence: missingEvidenceFor({ topic, evidenceAnchors: evidenceResult.anchors }),
+    outline: outlineFor(profile),
+    voiceCautions: [
+      ...profile.guidance.avoid,
+      "Mark unsupported claims as [specific evidence needed] instead of inventing proof.",
+    ].slice(0, 5),
+  };
+}
+
+export function renderVoiceBriefV2(brief) {
+  const lines = [
+    `# Article Brief: ${safeInline(brief.topic)}`,
+    "",
+    "## Voice Source",
+    "",
+    `- Corpus confidence: ${capitalize(brief.voice.corpusConfidence.band)} - ${brief.voice.corpusConfidence.message}`,
+    `- Source files: ${brief.voice.sourceFileCount}`,
+    `- Primary register: ${brief.voice.primaryRegister}`,
+    `- Evidence sentence rate: ${brief.voice.evidenceSentenceRate}`,
+    "",
+    "## Working Thesis",
+    "",
+    `- ${safeInline(brief.workingThesis)}`,
+    "",
+    "## Evidence Anchors",
+    "",
+  ];
+
+  if (brief.evidence.anchors.length) {
+    for (const item of brief.evidence.anchors) {
+      const typeList = item.types.length ? ` (${item.types.join(", ")})` : "";
+      lines.push(`- ${safeInline(brief.evidence.source)}:${item.line}${typeList} - ${safeInline(item.text)}`);
+    }
+  } else {
+    lines.push("- [specific evidence needed] Add notes, dates, quotes, examples, or source links before drafting broad claims.");
+  }
+
+  lines.push("", "## Missing Evidence", "");
+  lines.push(...brief.missingEvidence.map((item) => `- ${safeInline(item)}`));
+
+  lines.push("", "## Outline", "");
+  lines.push(...brief.outline.map((item, index) => `${index + 1}. ${safeInline(item)}`));
+
+  lines.push("", "## Voice Cautions", "");
+  lines.push(...brief.voiceCautions.map((item) => `- ${safeInline(item)}`));
+
+  lines.push(
+    "",
+    "## Drafting Prompt",
+    "",
+    `Write the article about ${safeInline(brief.topic)} using the evidence anchors above. Keep claims close to concrete support, follow the voice cautions, and write [specific evidence needed] anywhere the brief does not supply enough ground.`,
+    "",
+  );
+
+  return lines.join("\n");
+}
+
+function evidenceAnchorsFromFile({ evidence, cwd }) {
+  const evidencePath = resolvePath(cwd, evidence);
+  const contents = readUtf8FileBounded(evidencePath, { label: "Evidence file", maxBytes: 1024 * 1024 });
+  const document = parseDocument({
+    filePath: evidencePath,
+    rootDir: cwd,
+    contents,
+  });
+
+  return {
+    source: displayPath(evidencePath, cwd),
+    anchors: document.sentences
+      .map((sentence) => ({
+        line: sentence.line,
+        text: sentence.text,
+        types: evidenceTypes(sentence.text),
+      }))
+      .filter((sentence) => sentence.types.length > 0)
+      .slice(0, 8),
+  };
+}
+
+function missingEvidenceFor({ topic, evidenceAnchors }) {
+  const items = [
+    `Add [specific evidence needed] for the central claim about ${topic}.`,
+    "Add [specific evidence needed] for any number, date, quote, source, or example the article depends on.",
+  ];
+  if (evidenceAnchors.length === 0) {
+    items.unshift("No evidence anchors were detected; collect concrete notes before asking for a full draft.");
+  }
+  return items;
+}
+
+function outlineFor(profile) {
+  const opening = profile.families.rhetoricalShape.features.openingMoves.slice(0, 3).join(" -> ");
+  const sentenceMedian = profile.families.rhythm.features.sentenceWords.median;
+  return [
+    opening
+      ? `Start from a concrete artifact or observation, keeping the opening shape compatible with: ${opening}.`
+      : "Start from a concrete artifact or observation before making the larger claim.",
+    "Name the pressure, question, or practical stakes that make the evidence matter.",
+    `Develop the article in the learned register with sentence pacing near the ${sentenceMedian}-word median where it fits.`,
+    "Close by returning to the evidence and leaving the reader with a practical handle, not a generic conclusion.",
+  ];
+}
+
+function resolvePath(cwd, value) {
+  return path.isAbsolute(value) ? value : path.join(cwd, value);
+}
+
+function displayPath(filePath, rootDir) {
+  const relative = path.relative(rootDir, filePath);
+  if (relative && !relative.startsWith("..") && !path.isAbsolute(relative)) {
+    return relative.split(path.sep).join("/");
+  }
+  return filePath.split(path.sep).join("/");
+}
+
+function capitalize(value) {
+  return String(value ?? "").charAt(0).toUpperCase() + String(value ?? "").slice(1);
+}
+
+function safeInline(value) {
+  return String(value ?? "")
+    .replace(/[\0-\x08\x0b\x0c\x0e-\x1f\x7f]/g, "")
+    .replace(/\s+/g, " ")
+    .replace(/`/g, "'")
+    .trim();
+}

package/src/v2/config.js

@@ -0,0 +1,78 @@
+import fs from "node:fs";
+import path from "node:path";
+import { writeUtf8FileSafely } from "./io-utils.js";
+
+export const DEFAULT_EXAMPLES_DIR = "./articles";
+export const DEFAULT_VOICE_DIR = "./dravoice-voice";
+export const DEFAULT_PROMPT_FORMAT = "agents";
+export const DEFAULT_PROMPT_OUT = "AGENTS.md";
+
+const CONFIG_FILE = ".dravoice.yml";
+
+export function configPathFor(cwd) {
+  return path.join(cwd, CONFIG_FILE);
+}
+
+export function loadProjectConfig(cwd) {
+  const configPath = configPathFor(cwd);
+  if (!fs.existsSync(configPath)) {
+    return {};
+  }
+  const config = {};
+  const contents = fs.readFileSync(configPath, "utf8");
+  for (const rawLine of contents.split(/\r?\n/)) {
+    const line = rawLine.trim();
+    if (!line || line.startsWith("#")) {
+      continue;
+    }
+    const match = /^([A-Za-z][A-Za-z0-9_-]*):\s*(.*)$/.exec(rawLine);
+    if (!match) {
+      continue;
+    }
+    const [, key, value] = match;
+    if (["voice", "examples", "promptFormat", "promptOut"].includes(key)) {
+      config[key] = unquoteYamlScalar(value.trim());
+    }
+  }
+  return config;
+}
+
+export function writeProjectConfig(cwd, updates = {}) {
+  const existing = loadProjectConfig(cwd);
+  const config = {
+    voice: updates.voice ?? existing.voice ?? DEFAULT_VOICE_DIR,
+    examples: updates.examples ?? existing.examples ?? DEFAULT_EXAMPLES_DIR,
+    promptFormat: updates.promptFormat ?? existing.promptFormat ?? DEFAULT_PROMPT_FORMAT,
+    promptOut: updates.promptOut ?? existing.promptOut ?? DEFAULT_PROMPT_OUT,
+  };
+  writeUtf8FileSafely(
+    configPathFor(cwd),
+    [
+      "# Dravoice project defaults",
+      `voice: ${displayPath(config.voice)}`,
+      `examples: ${displayPath(config.examples)}`,
+      `promptFormat: ${config.promptFormat}`,
+      `promptOut: ${displayPath(config.promptOut)}`,
+      "",
+    ].join("\n"),
+  );
+  return config;
+}
+
+export function resolveConfiguredPath(cwd, value) {
+  if (!value) {
+    return undefined;
+  }
+  return path.isAbsolute(value) ? value : path.join(cwd, value);
+}
+
+export function displayPath(value) {
+  return String(value).replace(/[\\/]+/g, "/");
+}
+
+function unquoteYamlScalar(value) {
+  if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+    return value.slice(1, -1);
+  }
+  return value;
+}