etymd 0.1.0

package/dist/init-V627UXKU.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+import { planWorkflow, applyFiles } from './chunk-FXL4554F.js';
+import { scanProject, PACK_VERSION } from './chunk-TCWKIMCU.js';
+import { VERSION } from './chunk-U33XLT5I.js';
+import { writeCachedFacts, deriveProfile, writeBaseline, CACHE_DIR } from './chunk-SMM2TW35.js';
+import { theme, renderFacts, print, renderPlan, git, section, glyph, readText } from './chunk-WVYKYPKS.js';
+import { promises } from 'node:fs';
+import path from 'node:path';
+import { intro, spinner, select, confirm, outro, isCancel, cancel } from '@clack/prompts';
+
+function bail() {
+  cancel("Onboarding cancelled \u2014 no changes made.");
+  process.exit(0);
+}
+function guard(value) {
+  if (isCancel(value)) bail();
+  return value;
+}
+async function ensureCacheIgnored(root) {
+  const target = path.join(root, ".gitignore");
+  const line = `${CACHE_DIR}/`;
+  const existing = await readText(target);
+  if (existing?.split("\n").some((l) => l.trim() === line || l.trim() === CACHE_DIR)) return false;
+  const next = existing ? `${existing.replace(/\n?$/, "\n")}${line}
+` : `${line}
+`;
+  await promises.writeFile(target, next, "utf8");
+  return true;
+}
+async function run(opts) {
+  intro(`${theme.brand("etymd")} ${theme.dim("\xB7 keep your agent instructions true")}`);
+  const s = spinner();
+  s.start("Reckoning the project");
+  const facts = await scanProject(opts.cwd);
+  await writeCachedFacts(opts.cwd, facts);
+  s.stop(`Reckoned ${theme.brand(facts.name)}`);
+  renderFacts(facts);
+  print();
+  const detectedProfile = deriveProfile(facts);
+  let profile = detectedProfile;
+  if (!opts.yes) {
+    profile = guard(
+      await select({
+        message: `Workflow profile ${theme.dim(`(detected: ${detectedProfile}, from recent commit authors)`)}`,
+        initialValue: detectedProfile,
+        options: [
+          { value: "solo", label: "Solo", hint: "one developer" },
+          { value: "team", label: "Team", hint: "several committers" }
+        ]
+      })
+    );
+  }
+  const hasContract = facts.artifacts.some((a) => a.id === "agents" && a.exists);
+  let scaffoldAgents = false;
+  if (!hasContract) {
+    scaffoldAgents = opts.yes ? true : guard(
+      await confirm({
+        message: "No AGENTS.md found \u2014 scaffold a minimal one from the reckoning?",
+        initialValue: true
+      })
+    );
+  }
+  let gates = false;
+  if (facts.git.isRepo && facts.hooks.source === "none") {
+    gates = opts.yes ? true : guard(
+      await confirm({
+        message: "No git hooks found \u2014 install the local gates (pre-commit + pre-push)?",
+        initialValue: true
+      })
+    );
+  }
+  const files = await planWorkflow(opts.cwd, facts, { agents: scaffoldAgents, gates });
+  if (files.length) {
+    renderPlan(files);
+    if (!opts.yes) {
+      const go = guard(
+        await confirm({
+          message: `Write ${files.filter((f) => !f.exists).length} file(s) now?`,
+          initialValue: true
+        })
+      );
+      if (!go) bail();
+    }
+  }
+  const result = await applyFiles(opts.cwd, files);
+  if (gates && facts.git.isRepo) await git(opts.cwd, ["config", "core.hooksPath", ".githooks"]);
+  const approved = result.written.length ? await scanProject(opts.cwd) : facts;
+  await writeBaseline(opts.cwd, {
+    packVersion: PACK_VERSION,
+    etymdVersion: VERSION,
+    approvedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    profile,
+    facts: approved
+  });
+  const ignored = facts.git.isRepo ? await ensureCacheIgnored(opts.cwd) : false;
+  section("Onboarded");
+  for (const w of result.written) print(`  ${glyph.ok} ${theme.dim("wrote")} ${theme.info(w)}`);
+  for (const sk of result.skipped) print(`  ${glyph.bullet} ${theme.dim("kept")} ${theme.dim(sk)}`);
+  print(
+    `  ${glyph.ok} ${theme.dim("baseline approved \u2192")} ${theme.info(".etymd/baseline.json")} ${theme.dim("(commit it \u2014 drift is measured against it)")}`
+  );
+  if (ignored)
+    print(
+      `  ${glyph.ok} ${theme.dim("gitignored the transient cache")} ${theme.info(CACHE_DIR + "/")}`
+    );
+  outro(
+    [
+      `${theme.ok("Truth guard armed.")} Next:`,
+      `  1. Commit ${theme.code(".etymd/baseline.json")}${scaffoldAgents ? ` and complete ${theme.code("AGENTS.md")} (or run ${theme.code("etymd brief")})` : ""}.`,
+      `  2. Run ${theme.code("etymd audit")} \u2014 it verifies every instruction claim against the repo.`,
+      `  3. Gate CI on it: ${theme.code("etymd audit --fail-on risk")}.`
+    ].join("\n")
+  );
+}
+
+export { run };

package/dist/ledger-YFTYCOIC.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+import { readLedger, resolveEntry, writeLedger } from './chunk-N64ZTBCW.js';
+import { print, renderLedger, glyph, theme } from './chunk-WVYKYPKS.js';
+
+// src/commands/ledger.ts
+async function list(opts) {
+  const ledger = await readLedger(opts.cwd);
+  if (opts.json) {
+    print(JSON.stringify(ledger, null, 2));
+    return;
+  }
+  renderLedger(ledger);
+}
+async function resolve(opts, status) {
+  if (status === "dismissed" && !opts.reason?.trim()) {
+    throw new Error('dismiss needs a reason: etymd dismiss <finding-id> --reason "\u2026"');
+  }
+  const ledger = await readLedger(opts.cwd);
+  const { ledger: next, entry } = resolveEntry(ledger, opts.id, status, opts.reason?.trim());
+  if (!entry) {
+    throw new Error(
+      `no finding \`${opts.id}\` in the ledger \u2014 run \`etymd audit\` first so it is recorded, then retry`
+    );
+  }
+  await writeLedger(opts.cwd, next);
+  const verb = status === "dismissed" ? "dismissed" : "accepted";
+  print(
+    `  ${glyph.ok} ${theme.dim(verb)} ${theme.info(entry.id)}${entry.reason ? theme.dim(` \u2014 \u201C${entry.reason}\u201D`) : ""}`
+  );
+  print(`  ${theme.dim("hidden from future audits until it disappears (then counted resolved).")}`);
+}
+async function dismiss(opts) {
+  await resolve(opts, "dismissed");
+}
+async function accept(opts) {
+  await resolve(opts, "accepted");
+}
+
+export { accept, dismiss, list };

package/dist/scan-YL7JHLUA.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+import { scanProject } from './chunk-TCWKIMCU.js';
+import './chunk-U33XLT5I.js';
+import { writeCachedFacts } from './chunk-SMM2TW35.js';
+import { print, renderFacts, theme } from './chunk-WVYKYPKS.js';
+
+// src/commands/scan.ts
+async function run(opts) {
+  const facts = await scanProject(opts.cwd);
+  if (opts.json) {
+    print(JSON.stringify(facts, null, 2));
+    return;
+  }
+  renderFacts(facts);
+  if (opts.save !== false) {
+    const target = await writeCachedFacts(opts.cwd, facts);
+    print();
+    print(`  ${theme.dim("cached reckoning \u2192")} ${theme.info(target)}`);
+  }
+}
+
+export { run };

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "etymd",
+  "version": "0.1.0",
+  "description": "Keep your agent instructions true — verify AGENTS.md, CLAUDE.md, rules & skills against the actual repo, with drift caught over time and a regression ledger.",
+  "keywords": [
+    "cli",
+    "ai",
+    "agents",
+    "agents-md",
+    "claude-md",
+    "instructions",
+    "lint",
+    "drift",
+    "context-engineering",
+    "truth",
+    "developer-tools"
+  ],
+  "license": "MIT",
+  "author": "Alkis Yuv",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/triartleet/etymd.git"
+  },
+  "homepage": "https://github.com/triartleet/etymd#readme",
+  "bugs": {
+    "url": "https://github.com/triartleet/etymd/issues"
+  },
+  "type": "module",
+  "bin": {
+    "etymd": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=18.17"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "start": "node dist/cli.js",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "format": "prettier --write . && npm run guard:md",
+    "format:check": "prettier --check . && npm run guard:md",
+    "guard:md": "! grep -rnF --include=*.md --exclude-dir=node_modules --exclude-dir=dist --exclude-dir=.git '\\*\\*' .",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build",
+    "changeset": "changeset",
+    "version:packages": "changeset version",
+    "release": "npm run build && changeset publish"
+  },
+  "dependencies": {
+    "@clack/prompts": "0.7.0",
+    "commander": "12.1.0",
+    "picocolors": "1.1.1",
+    "yaml": "2.7.0"
+  },
+  "devDependencies": {
+    "@changesets/cli": "2.27.11",
+    "@types/node": "22.10.2",
+    "prettier": "3.4.2",
+    "tsup": "8.3.5",
+    "typescript": "5.7.2",
+    "vitest": "2.1.8"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}