@djolex999/vir-cli 0.1.0 → 0.1.1

package/src/config.ts

@@ -1,89 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { dirname, join } from "node:path";
-import { z } from "zod";
-
-export const ConfigSchema = z
-  .object({
-    vaultPath: z.string().min(1),
-    outputDir: z.string().min(1).default("vir"),
-    claudeProjectsDir: z.string().min(1),
-    cadenceHours: z.number().positive().default(4),
-    provider: z.enum(["anthropic", "kie"]).default("anthropic"),
-    anthropicApiKey: z.string().optional(),
-    kieApiKey: z.string().optional(),
-    filterThreshold: z.number().min(0).max(1).default(0.4),
-    models: z
-      .object({
-        classify: z.string().default("claude-haiku-4-5-20251001"),
-        distill: z.string().default("claude-sonnet-4-6"),
-      })
-      .default({
-        classify: "claude-haiku-4-5-20251001",
-        distill: "claude-sonnet-4-6",
-      }),
-  })
-  .superRefine((val, ctx) => {
-    if (val.provider === "anthropic" && !val.anthropicApiKey) {
-      ctx.addIssue({
-        code: z.ZodIssueCode.custom,
-        path: ["anthropicApiKey"],
-        message: "anthropicApiKey is required when provider is 'anthropic'",
-      });
-    }
-    if (val.provider === "kie" && !val.kieApiKey) {
-      ctx.addIssue({
-        code: z.ZodIssueCode.custom,
-        path: ["kieApiKey"],
-        message: "kieApiKey is required when provider is 'kie'",
-      });
-    }
-  });
-
-export type Config = z.infer<typeof ConfigSchema>;
-
-export const VIR_DIR = join(homedir(), ".vir");
-export const CONFIG_PATH = join(VIR_DIR, "config.json");
-export const STATE_PATH = join(VIR_DIR, "vir.db");
-// One-shot migration: older builds used `state.db`. If only the old file
-// exists, rename it on startup so the docs match reality. Never overwrites
-// an existing `vir.db`.
-export const LEGACY_STATE_PATH = join(VIR_DIR, "state.db");
-export const DAEMON_LOG_PATH = join(VIR_DIR, "daemon.log");
-
-export function expandHome(p: string): string {
-  if (p.startsWith("~/")) return join(homedir(), p.slice(2));
-  if (p === "~") return homedir();
-  return p;
-}
-
-export function ensureVirDir(): void {
-  if (!existsSync(VIR_DIR)) mkdirSync(VIR_DIR, { recursive: true });
-}
-
-export function configExists(): boolean {
-  return existsSync(CONFIG_PATH);
-}
-
-export function loadConfig(): Config {
-  if (!existsSync(CONFIG_PATH)) {
-    throw new Error(
-      `Config not found at ${CONFIG_PATH}. Run \`vir init\` first.`,
-    );
-  }
-  const raw = readFileSync(CONFIG_PATH, "utf8");
-  const parsed = ConfigSchema.parse(JSON.parse(raw));
-  return {
-    ...parsed,
-    vaultPath: expandHome(parsed.vaultPath),
-    claudeProjectsDir: expandHome(parsed.claudeProjectsDir),
-  };
-}
-
-export function saveConfig(cfg: Config): void {
-  ensureVirDir();
-  if (!existsSync(dirname(CONFIG_PATH))) {
-    mkdirSync(dirname(CONFIG_PATH), { recursive: true });
-  }
-  writeFileSync(CONFIG_PATH, JSON.stringify(cfg, null, 2));
-}

package/src/daemon/launchd.ts

@@ -1,115 +0,0 @@
-import { spawnSync } from "node:child_process";
-import { existsSync, mkdirSync, unlinkSync, writeFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { dirname, join } from "node:path";
-import { DAEMON_LOG_PATH } from "../config.js";
-
-export const LABEL = "lab.growthq.vir";
-const LAUNCH_AGENTS_DIR = join(homedir(), "Library", "LaunchAgents");
-const PLIST_PATH = join(LAUNCH_AGENTS_DIR, `${LABEL}.plist`);
-
-export function plistPath(): string {
-  return PLIST_PATH;
-}
-
-function escapeXml(s: string): string {
-  return s
-    .replace(/&/g, "&")
-    .replace(/</g, "&lt;")
-    .replace(/>/g, "&gt;")
-    .replace(/"/g, "&quot;")
-    .replace(/'/g, "&apos;");
-}
-
-export function renderPlist(opts: {
-  nodePath: string;
-  cliPath: string;
-  intervalSeconds: number;
-  logPath: string;
-}): string {
-  return `<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-  <key>Label</key>
-  <string>${escapeXml(LABEL)}</string>
-  <key>ProgramArguments</key>
-  <array>
-    <string>${escapeXml(opts.nodePath)}</string>
-    <string>${escapeXml(opts.cliPath)}</string>
-    <string>run</string>
-    <string>--daemon</string>
-  </array>
-  <key>StartInterval</key>
-  <integer>${opts.intervalSeconds}</integer>
-  <key>RunAtLoad</key>
-  <true/>
-  <key>StandardOutPath</key>
-  <string>${escapeXml(opts.logPath)}</string>
-  <key>StandardErrorPath</key>
-  <string>${escapeXml(opts.logPath)}</string>
-  <key>EnvironmentVariables</key>
-  <dict>
-    <key>PATH</key>
-    <string>/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin</string>
-  </dict>
-</dict>
-</plist>
-`;
-}
-
-function launchctl(args: string[]): { code: number; stderr: string } {
-  const res = spawnSync("launchctl", args, { encoding: "utf8" });
-  return { code: res.status ?? -1, stderr: res.stderr ?? "" };
-}
-
-export function installPlist(opts: {
-  nodePath: string;
-  cliPath: string;
-  cadenceHours: number;
-}): { plistPath: string; loaded: boolean } {
-  if (!existsSync(LAUNCH_AGENTS_DIR)) {
-    mkdirSync(LAUNCH_AGENTS_DIR, { recursive: true });
-  }
-  const logDir = dirname(DAEMON_LOG_PATH);
-  if (!existsSync(logDir)) mkdirSync(logDir, { recursive: true });
-
-  const xml = renderPlist({
-    nodePath: opts.nodePath,
-    cliPath: opts.cliPath,
-    intervalSeconds: Math.max(60, Math.round(opts.cadenceHours * 3600)),
-    logPath: DAEMON_LOG_PATH,
-  });
-
-  writeFileSync(PLIST_PATH, xml);
-
-  // unload first in case it exists; ignore failure
-  launchctl(["unload", PLIST_PATH]);
-  const loadRes = launchctl(["load", PLIST_PATH]);
-  if (loadRes.code !== 0) {
-    throw new Error(`launchctl load failed: ${loadRes.stderr.trim()}`);
-  }
-
-  return { plistPath: PLIST_PATH, loaded: true };
-}
-
-export function uninstallPlist(): { removed: boolean } {
-  if (!existsSync(PLIST_PATH)) return { removed: false };
-  launchctl(["unload", PLIST_PATH]);
-  unlinkSync(PLIST_PATH);
-  return { removed: true };
-}
-
-export function daemonStatus(): {
-  installed: boolean;
-  loaded: boolean;
-  plistPath: string;
-} {
-  const installed = existsSync(PLIST_PATH);
-  let loaded = false;
-  const res = spawnSync("launchctl", ["list"], { encoding: "utf8" });
-  if (res.status === 0 && typeof res.stdout === "string") {
-    loaded = res.stdout.includes(LABEL);
-  }
-  return { installed, loaded, plistPath: PLIST_PATH };
-}

package/src/dedupe/detector.ts

@@ -1,197 +0,0 @@
-import type { Config } from "../config.js";
-import type { DistilledRow, StateDb } from "../state/db.js";
-import {
-  buildAnthropicClient,
-  callLLM,
-  normalizeModelName,
-  withRateLimitRetry,
-} from "../pipeline/distiller.js";
-import { kebab } from "../pipeline/writer.js";
-
-const MAX_CANDIDATE_PAIRS = 30;
-const MIN_DUP_CONFIDENCE = 0.7;
-const STOPWORDS = new Set([
-  "the",
-  "a",
-  "an",
-  "is",
-  "are",
-  "was",
-  "were",
-  "it",
-  "this",
-  "that",
-  "to",
-  "of",
-  "in",
-  "on",
-  "and",
-  "or",
-  "for",
-  "with",
-  "as",
-  "by",
-]);
-
-export interface DuplicatePair {
-  a: DistilledRow;
-  b: DistilledRow;
-  isDuplicate: true;
-  confidence: number;
-  reason: string;
-  keepWhich: "A" | "B" | "merge";
-}
-
-interface CandidatePair {
-  a: DistilledRow;
-  b: DistilledRow;
-  score: number;
-}
-
-export function findCandidatePairs(rows: DistilledRow[]): CandidatePair[] {
-  const pairs: CandidatePair[] = [];
-  for (let i = 0; i < rows.length; i += 1) {
-    const a = rows[i];
-    if (!a) continue;
-    for (let j = i + 1; j < rows.length; j += 1) {
-      const b = rows[j];
-      if (!b) continue;
-      const score = scoreCandidate(a, b);
-      if (score > 0) pairs.push({ a, b, score });
-    }
-  }
-  pairs.sort((x, y) => y.score - x.score);
-  return pairs.slice(0, MAX_CANDIDATE_PAIRS);
-}
-
-function scoreCandidate(a: DistilledRow, b: DistilledRow): number {
-  const aSlug = kebab(a.topic);
-  const bSlug = kebab(b.topic);
-  const aTokens = aSlug.split("-").filter((t) => t.length >= 3);
-  const bTokens = bSlug.split("-").filter((t) => t.length >= 3);
-  const bSet = new Set(bTokens);
-
-  const shared = aTokens.filter((t) => bSet.has(t)).length;
-  const union = new Set([...aTokens, ...bTokens]).size;
-  const jaccard = union === 0 ? 0 : shared / union;
-
-  const sameProjCat =
-    kebab(a.project) === kebab(b.project) && a.category === b.category;
-
-  const aWords = significantWords(a.content);
-  const bWords = significantWords(b.content);
-  let sharedSig = 0;
-  for (const w of aWords) if (bWords.has(w)) sharedSig += 1;
-
-  let score = 0;
-  if (sameProjCat && shared >= 2) score += 5;
-  if (jaccard > 0.7) score += 4;
-  if (sharedSig >= 3) score += Math.min(3, sharedSig - 2);
-
-  // Tie-breaker: more shared structure ranks higher.
-  score += shared * 0.5;
-  return score;
-}
-
-function significantWords(content: string): Set<string> {
-  const head = content.slice(0, 100).toLowerCase();
-  const tokens = head.split(/\W+/).filter((t) => t.length >= 3);
-  return new Set(tokens.filter((t) => !STOPWORDS.has(t)));
-}
-
-export async function detectDuplicates(
-  cfg: Config,
-  db: StateDb,
-): Promise<{ checked: number; duplicates: DuplicatePair[] }> {
-  const rows = db.listDistilled();
-  const pairs = findCandidatePairs(rows);
-
-  if (pairs.length === 0) return { checked: 0, duplicates: [] };
-
-  const client = buildAnthropicClient(cfg);
-  const model = normalizeModelName(cfg.models.classify, cfg.provider);
-  const duplicates: DuplicatePair[] = [];
-
-  for (const pair of pairs) {
-    const prompt = `Are these two knowledge notes duplicates or near-duplicates?
-They are duplicates if they teach the same lesson or describe the same pattern/gotcha, even if worded differently.
-
-Answer JSON only:
-{
-  "isDuplicate": boolean,
-  "confidence": number (0..1),
-  "reason": "string (max 20 words)",
-  "keepWhich": "A" | "B" | "merge"
-}
-
-keepWhich: "A" if A is more detailed/recent, "B" if B is, "merge" if both have unique value worth combining.
-
-Note A (topic: ${pair.a.topic}, date: ${pair.a.startedAt ?? "?"}, confidence: ${pair.a.confidence}):
-${headOf(pair.a.content, 400)}
-
-Note B (topic: ${pair.b.topic}, date: ${pair.b.startedAt ?? "?"}, confidence: ${pair.b.confidence}):
-${headOf(pair.b.content, 400)}`;
-
-    try {
-      const text = await withRateLimitRetry(() =>
-        callLLM(cfg, client, { prompt, model, maxTokens: 250 }),
-      );
-      const parsed = parseResponse(text);
-      if (parsed.isDuplicate && parsed.confidence >= MIN_DUP_CONFIDENCE) {
-        duplicates.push({
-          a: pair.a,
-          b: pair.b,
-          isDuplicate: true,
-          confidence: parsed.confidence,
-          reason: parsed.reason,
-          keepWhich: parsed.keepWhich,
-        });
-      }
-    } catch {
-      // single failure shouldn't kill the run
-    }
-  }
-
-  return { checked: pairs.length, duplicates };
-}
-
-function headOf(s: string, n: number): string {
-  return s.replace(/\s+/g, " ").trim().slice(0, n);
-}
-
-function parseResponse(text: string): {
-  isDuplicate: boolean;
-  confidence: number;
-  reason: string;
-  keepWhich: "A" | "B" | "merge";
-} {
-  const match = text.match(/\{[\s\S]*\}/);
-  const fallback = {
-    isDuplicate: false,
-    confidence: 0,
-    reason: "",
-    keepWhich: "merge" as const,
-  };
-  if (!match) return fallback;
-  try {
-    const obj = JSON.parse(match[0]) as Record<string, unknown>;
-    const rawKeep = obj.keepWhich;
-    const keepWhich: "A" | "B" | "merge" =
-      rawKeep === "A" || rawKeep === "B" || rawKeep === "merge"
-        ? rawKeep
-        : "merge";
-    return {
-      isDuplicate: obj.isDuplicate === true,
-      confidence: clamp01(Number(obj.confidence ?? 0)),
-      reason: typeof obj.reason === "string" ? obj.reason : "",
-      keepWhich,
-    };
-  } catch {
-    return fallback;
-  }
-}
-
-function clamp01(n: number): number {
-  if (!Number.isFinite(n)) return 0;
-  return Math.max(0, Math.min(1, n));
-}

package/src/dedupe/merger.ts

@@ -1,172 +0,0 @@
-import {
-  appendFileSync,
-  existsSync,
-  mkdirSync,
-  readFileSync,
-  renameSync,
-  writeFileSync,
-} from "node:fs";
-import { basename, join } from "node:path";
-import type { Config } from "../config.js";
-import type { DistilledRow, StateDb } from "../state/db.js";
-import {
-  buildAnthropicClient,
-  callLLM,
-  normalizeModelName,
-  withRateLimitRetry,
-} from "../pipeline/distiller.js";
-import { kebab } from "../pipeline/writer.js";
-
-const CATEGORY_DIRS: Record<string, string> = {
-  pattern: "patterns",
-  gotcha: "gotchas",
-  decision: "decisions",
-  tool: "tools",
-};
-
-export interface MergeOutcome {
-  winnerPath: string;
-  archivedPath: string;
-  action: "keep-a" | "keep-b" | "merge";
-}
-
-export async function mergeNotes(
-  cfg: Config,
-  db: StateDb,
-  a: DistilledRow,
-  b: DistilledRow,
-  keepWhich: "A" | "B" | "merge",
-): Promise<MergeOutcome> {
-  const root = join(cfg.vaultPath, cfg.outputDir);
-  const archivedDir = join(root, "archived");
-  if (!existsSync(archivedDir)) mkdirSync(archivedDir, { recursive: true });
-
-  const aFile = resolveNotePath(root, a);
-  const bFile = resolveNotePath(root, b);
-
-  if (keepWhich === "merge") {
-    return doMerge(cfg, db, root, archivedDir, a, b, aFile, bFile);
-  }
-
-  const loser = keepWhich === "A" ? b : a;
-  const winnerFile = keepWhich === "A" ? aFile : bFile;
-  const loserFile = keepWhich === "A" ? bFile : aFile;
-
-  const archivedPath = archiveFile(archivedDir, loserFile);
-  appendArchivedSection(winnerFile, archivedPath);
-  db.archive(loser.path);
-
-  return {
-    winnerPath: winnerFile,
-    archivedPath,
-    action: keepWhich === "A" ? "keep-a" : "keep-b",
-  };
-}
-
-async function doMerge(
-  cfg: Config,
-  db: StateDb,
-  root: string,
-  archivedDir: string,
-  a: DistilledRow,
-  b: DistilledRow,
-  aFile: string,
-  bFile: string,
-): Promise<MergeOutcome> {
-  // Higher-confidence row wins the file path (and DB content); tie → A.
-  const aWins = a.confidence >= b.confidence;
-  const winner = aWins ? a : b;
-  const loser = aWins ? b : a;
-  const winnerFile = aWins ? aFile : bFile;
-  const loserFile = aWins ? bFile : aFile;
-
-  const prompt = `Merge these two knowledge notes into one superior note.
-Keep all unique insights from both. Use the better structure.
-Output only the merged markdown body, no frontmatter.
-
-Note A:
-${a.content}
-
-Note B:
-${b.content}`;
-
-  const client = buildAnthropicClient(cfg);
-  const model = normalizeModelName(cfg.models.distill, cfg.provider);
-  const merged = (
-    await withRateLimitRetry(() =>
-      callLLM(cfg, client, { prompt, model, maxTokens: 2000 }),
-    )
-  ).trim();
-
-  rewriteWinnerBody(winnerFile, merged);
-  db.updateContent(winner.path, merged);
-
-  const archivedPath = archiveFile(archivedDir, loserFile);
-  appendArchivedSection(winnerFile, archivedPath);
-  db.archive(loser.path);
-  void root;
-
-  return { winnerPath: winnerFile, archivedPath, action: "merge" };
-}
-
-function resolveNotePath(root: string, r: DistilledRow): string {
-  const dir = CATEGORY_DIRS[r.category] ?? `${r.category}s`;
-  const slug = kebab(r.topic);
-  const suffix = r.sessionId.slice(0, 8);
-  return join(root, dir, `${slug}-${suffix}.md`);
-}
-
-function archiveFile(archivedDir: string, sourcePath: string): string {
-  if (!existsSync(sourcePath)) {
-    // Nothing to move on disk; still record what the target *would* have been.
-    return join(archivedDir, basename(sourcePath));
-  }
-  const dest = uniquePath(join(archivedDir, basename(sourcePath)));
-  renameSync(sourcePath, dest);
-  return dest;
-}
-
-function uniquePath(p: string): string {
-  if (!existsSync(p)) return p;
-  const dot = p.lastIndexOf(".");
-  const base = dot === -1 ? p : p.slice(0, dot);
-  const ext = dot === -1 ? "" : p.slice(dot);
-  let i = 1;
-  while (existsSync(`${base}-${i}${ext}`)) i += 1;
-  return `${base}-${i}${ext}`;
-}
-
-function appendArchivedSection(winnerFile: string, archivedPath: string): void {
-  if (!existsSync(winnerFile)) return;
-  const loserSlug = basename(archivedPath, ".md");
-  const link = `- [[${loserSlug}]]`;
-
-  const current = readFileSync(winnerFile, "utf8");
-  if (current.includes("## Archived Duplicates")) {
-    // Append the bullet under the existing section.
-    const updated = current.replace(
-      /(## Archived Duplicates\n(?:[\s\S]*?))(\n##|\n*$)/,
-      (_match, body: string, tail: string) =>
-        `${body}${body.endsWith("\n") ? "" : "\n"}${link}\n${tail}`,
-    );
-    writeFileSync(winnerFile, updated);
-  } else {
-    appendFileSync(winnerFile, `\n## Archived Duplicates\n${link}\n`);
-  }
-}
-
-// Replaces the body (everything after the YAML frontmatter) with merged
-// markdown. Preserves the original frontmatter block.
-function rewriteWinnerBody(winnerFile: string, mergedBody: string): void {
-  if (!existsSync(winnerFile)) {
-    writeFileSync(winnerFile, mergedBody + "\n");
-    return;
-  }
-  const current = readFileSync(winnerFile, "utf8");
-  const fmMatch = current.match(/^(---\n[\s\S]*?\n---\n)/);
-  if (!fmMatch) {
-    writeFileSync(winnerFile, mergedBody + "\n");
-    return;
-  }
-  writeFileSync(winnerFile, `${fmMatch[1]}\n${mergedBody}\n`);
-}