docsgov 0.1.0 → 0.1.1

package/dist/dedup/dedup.index.test.js

@@ -62,7 +62,7 @@ function writeFiles(repoRoot, files) {
     }
 }
 function dbPathOf(repoRoot) {
-    return join(repoRoot, ".docgov", "dedup", "index.db");
+    return join(repoRoot, ".docsgov", "dedup", "index.db");
 }
 const noProgress = () => { };
 beforeEach(() => {
@@ -71,16 +71,16 @@ beforeEach(() => {
     // Index() calls Embedder.newEmbedder() with no explicit cacheDir, which would
     // resolve to the host ~/.cache. Point it at a throwaway temp dir so the test
     // never writes to the real home cache.
-    savedModelCache = process.env.DOCGOV_MODEL_CACHE;
+    savedModelCache = process.env.docsgov_MODEL_CACHE;
     const modelCache = mkdtempSync(join(tmpdir(), "dedup-index-model-"));
     tmpDirs.push(modelCache);
-    process.env.DOCGOV_MODEL_CACHE = modelCache;
+    process.env.docsgov_MODEL_CACHE = modelCache;
 });
 afterEach(() => {
     if (savedModelCache === undefined)
-        delete process.env.DOCGOV_MODEL_CACHE;
+        delete process.env.docsgov_MODEL_CACHE;
     else
-        process.env.DOCGOV_MODEL_CACHE = savedModelCache;
+        process.env.docsgov_MODEL_CACHE = savedModelCache;
     for (const d of tmpDirs.splice(0))
         rmSync(d, { recursive: true, force: true });
 });
@@ -140,7 +140,7 @@ describe("dedup.Index error wiring", () => {
         const repoRoot = newRepoRoot();
         writeFiles(repoRoot, {
             // thresh_high out of (0,1) range → validate() throws inside Load.
-            ".docgov/dedup/config.yml": "analyzer:\n  thresh_high: 5\n",
+            ".docsgov/dedup/config.yml": "analyzer:\n  thresh_high: 5\n",
             "docs/a.md": "## A\n\nThis is a sufficiently long paragraph of prose used purely to make the section eligible.\n",
         });
         await expect(Index(repoRoot, noProgress)).rejects.toThrow(/dedup\.Index: load config/);
@@ -162,7 +162,7 @@ describe("dedup.Index error wiring", () => {
     it("wraps an open-db failure on a corrupt index file", async () => {
         const repoRoot = newRepoRoot();
         writeFiles(repoRoot, {
-            ".docgov/dedup/index.db": "this is not a sqlite database",
+            ".docsgov/dedup/index.db": "this is not a sqlite database",
             "docs/a.md": "## A\n\nThis is a sufficiently long paragraph of prose used purely to make the section eligible.\n",
         });
         await expect(Index(repoRoot, noProgress)).rejects.toThrow(/dedup\.Index: open db/);
@@ -186,7 +186,7 @@ describe("dedup.Analyze error wiring", () => {
         });
         await Index(repoRoot, noProgress);
         writeFiles(repoRoot, {
-            ".docgov/dedup/config.yml": "analyzer:\n  thresh_high: 5\n",
+            ".docsgov/dedup/config.yml": "analyzer:\n  thresh_high: 5\n",
         });
         await expect(Analyze(repoRoot)).rejects.toThrow(/dedup\.Analyze: load config/);
     });
@@ -196,7 +196,7 @@ describe("dedup.Analyze error wiring", () => {
     it("wraps an open-db failure on a corrupt index file", async () => {
         const repoRoot = newRepoRoot();
         writeFiles(repoRoot, {
-            ".docgov/dedup/index.db": "this is not a sqlite database",
+            ".docsgov/dedup/index.db": "this is not a sqlite database",
         });
         await expect(Analyze(repoRoot)).rejects.toThrow(/dedup\.Analyze: open db/);
     });

package/dist/dedup/dedup.js

@@ -1,9 +1,9 @@
-// Top-level facade for the docgov dedup subsystem: the Index and Analyze entry
+// Top-level facade for the docsgov dedup subsystem: the Index and Analyze entry
 // points the CLI calls.
 //
 // Ported from internal/dedup/dedup.go. Index walks <repoRoot>/docs/, extracts
 // eligible sections, embeds new/changed ones, and persists the index to
-// .docgov/dedup/index.db. Analyze loads that index and runs the layered
+// .docsgov/dedup/index.db. Analyze loads that index and runs the layered
 // duplicate-detection algorithm, returning a structured Report.
 //
 // Reconciling the mixed sync/async stack vs Go:
@@ -24,11 +24,11 @@ import { Load } from "./configload.js";
 import { ensureDedupGitignore } from "./gitignore.js";
 /** dbPathOf returns the index DB path under repoRoot (Go inlines this twice). */
 function dbPathOf(repoRoot) {
-    return path.join(repoRoot, ".docgov", "dedup", "index.db");
+    return path.join(repoRoot, ".docsgov", "dedup", "index.db");
 }
 /**
  * Index walks <repoRoot>/docs/, extracts eligible sections, embeds new and
- * changed ones, and persists the index to .docgov/dedup/index.db.
+ * changed ones, and persists the index to .docsgov/dedup/index.db.
  *
  * progress receives one-line status messages; pass a no-op for silence (Go's
  * io.Discard) or one that writes to stderr from the CLI.
@@ -92,7 +92,7 @@ export async function Index(repoRoot, progress) {
     }
 }
 /**
- * Analyze loads the index from .docgov/dedup/index.db, runs the layered
+ * Analyze loads the index from .docsgov/dedup/index.db, runs the layered
  * duplicate-detection algorithm, and returns a structured Report.
  *
  * Throws ErrIndexMissing (wrapped) when the index DB does not exist.

package/dist/dedup/dedup.test.js

@@ -76,7 +76,7 @@ function writeFiles(repoRoot, files) {
 }
 /** dbPathOf mirrors the facade's index DB location. */
 function dbPathOf(repoRoot) {
-    return join(repoRoot, ".docgov", "dedup", "index.db");
+    return join(repoRoot, ".docsgov", "dedup", "index.db");
 }
 /** createEmptyIndexDB opens (and immediately closes) a valid empty index DB. */
 function createEmptyIndexDB(repoRoot) {
@@ -90,7 +90,7 @@ describe("dedup.Analyze", () => {
     // WHY: a missing index must be a distinct, matchable error so the CLI can
     // prompt the user to index first rather than reporting a generic failure.
     it("throws ErrIndexMissing when the index DB does not exist", async () => {
-        const repoRoot = newRepoRoot(); // empty, no .docgov/dedup/index.db
+        const repoRoot = newRepoRoot(); // empty, no .docsgov/dedup/index.db
         await expect(Analyze(repoRoot)).rejects.toBeInstanceOf(ErrIndexMissing);
     });
     // WHY: an existing but empty index is a valid "no duplicates" state — Analyze
@@ -189,9 +189,9 @@ describe("dedup facade end-to-end (fake embedder)", () => {
 });
 describe("dedup.Index (real embedder)", () => {
     // WHY: the Index path itself (real embedder, real walk, real persist) is only
-    // meaningful with the model. Gated behind DOCGOV_E2E so CI never downloads
+    // meaningful with the model. Gated behind docsgov_E2E so CI never downloads
     // ~1GB — the single allowed env-skip per the porting conventions.
-    const runE2E = process.env["DOCGOV_E2E"] === "1";
+    const runE2E = process.env["docsgov_E2E"] === "1";
     it.skipIf(!runE2E)("indexes a corpus and persists sections", async () => {
         const repoRoot = newRepoRoot();
         writeFiles(repoRoot, {

package/dist/dedup/dedupcfg/config.js

@@ -3,7 +3,7 @@
 // indexer can import it without creating an import cycle with the top-level
 // dedup facade.
 //
-// The YAML overlay (Default() merged with .docgov/dedup/config.yml) lives in
+// The YAML overlay (Default() merged with .docsgov/dedup/config.yml) lives in
 // the parent dedup package; this leaf only declares the shapes and defaults.
 // Because that overlay deserializes raw YAML keys onto these shapes, every
 // property name here keeps its EXACT YAML serialized spelling (snake_case),
@@ -44,7 +44,7 @@ export function defaultConfig() {
                 "build",
                 ".next",
                 ".cache",
-                ".docgov",
+                ".docsgov",
                 "dedup-poc",
                 ".venv",
             ],

package/dist/dedup/embedder/cache.js

@@ -4,8 +4,8 @@ import { Model } from "./constants.js";
 /**
  * cacheDir returns the resolved model cache directory in precedence order:
  *  1. explicit (the WithCacheDir option equivalent)
- *  2. DOCGOV_MODEL_CACHE env var
- *  3. ~/.cache/docgov/models/<sanitized-model-name>/
+ *  2. docsgov_MODEL_CACHE env var
+ *  3. ~/.cache/docsgov/models/<sanitized-model-name>/
  *
  * The returned path is not guaranteed to exist; the caller creates it.
  */
@@ -13,11 +13,11 @@ export function cacheDir(explicit) {
     if (explicit !== "") {
         return explicit;
     }
-    const env = process.env.DOCGOV_MODEL_CACHE;
+    const env = process.env.docsgov_MODEL_CACHE;
     if (env !== undefined && env !== "") {
         return env;
     }
     // Sanitize the model name: replace / with _ for filesystem safety.
     const sanitized = Model.replaceAll("/", "_");
-    return join(homedir(), ".cache", "docgov", "models", sanitized);
+    return join(homedir(), ".cache", "docsgov", "models", sanitized);
 }

package/dist/dedup/embedder/cache.test.js

@@ -3,40 +3,40 @@ import { join } from "node:path";
 import { afterEach, beforeEach, expect, test } from "vitest";
 import { cacheDir } from "./cache.js";
 import { Model } from "./constants.js";
-// Snapshot/restore DOCGOV_MODEL_CACHE so tests don't leak into each other or
+// Snapshot/restore docsgov_MODEL_CACHE so tests don't leak into each other or
 // the host env.
 let savedEnv;
 beforeEach(() => {
-    savedEnv = process.env.DOCGOV_MODEL_CACHE;
-    delete process.env.DOCGOV_MODEL_CACHE;
+    savedEnv = process.env.docsgov_MODEL_CACHE;
+    delete process.env.docsgov_MODEL_CACHE;
 });
 afterEach(() => {
     if (savedEnv === undefined) {
-        delete process.env.DOCGOV_MODEL_CACHE;
+        delete process.env.docsgov_MODEL_CACHE;
     }
     else {
-        process.env.DOCGOV_MODEL_CACHE = savedEnv;
+        process.env.docsgov_MODEL_CACHE = savedEnv;
     }
 });
 // WHY: tests pass an explicit cache dir (a temp dir) so CI never races on the
 // shared host cache. The explicit option MUST win over both the env var and
 // the default, or that isolation guarantee breaks.
 test("explicit cache dir wins over env var and default", () => {
-    process.env.DOCGOV_MODEL_CACHE = "/from/env";
+    process.env.docsgov_MODEL_CACHE = "/from/env";
     expect(cacheDir("/explicit/dir")).toBe("/explicit/dir");
 });
-// WHY: DOCGOV_MODEL_CACHE lets operators relocate the multi-hundred-MB model
+// WHY: docsgov_MODEL_CACHE lets operators relocate the multi-hundred-MB model
 // off the home partition. It must be honored when no explicit dir is given.
-test("DOCGOV_MODEL_CACHE is used when no explicit dir is given", () => {
-    process.env.DOCGOV_MODEL_CACHE = "/from/env";
+test("docsgov_MODEL_CACHE is used when no explicit dir is given", () => {
+    process.env.docsgov_MODEL_CACHE = "/from/env";
     expect(cacheDir("")).toBe("/from/env");
 });
 // WHY: an empty env var must NOT shadow the default (Go checks `env != ""`).
-// A stray `DOCGOV_MODEL_CACHE=` in a shell would otherwise route the cache to
+// A stray `docsgov_MODEL_CACHE=` in a shell would otherwise route the cache to
 // the empty path.
-test("empty DOCGOV_MODEL_CACHE falls through to the default", () => {
-    process.env.DOCGOV_MODEL_CACHE = "";
-    const want = join(homedir(), ".cache", "docgov", "models", Model.replaceAll("/", "_"));
+test("empty docsgov_MODEL_CACHE falls through to the default", () => {
+    process.env.docsgov_MODEL_CACHE = "";
+    const want = join(homedir(), ".cache", "docsgov", "models", Model.replaceAll("/", "_"));
     expect(cacheDir("")).toBe(want);
 });
 // WHY: the default path sanitizes the model name by replacing "/" with "_".

package/dist/dedup/embedder/embedder.js

@@ -3,8 +3,8 @@
 // sentence-transformers/paraphrase-multilingual-mpnet-base-v2 model.
 //
 // The embedder model is auto-downloaded on first use to a configurable cache
-// directory (see NewOptions.cacheDir, the DOCGOV_MODEL_CACHE env var, or the
-// default ~/.cache/docgov/models/<sanitized-model-name>/).
+// directory (see NewOptions.cacheDir, the docsgov_MODEL_CACHE env var, or the
+// default ~/.cache/docsgov/models/<sanitized-model-name>/).
 import { cacheDir } from "./cache.js";
 import { Dimension, Model } from "./constants.js";
 import { InferenceError } from "./errors.js";

package/dist/dedup/embedder/embedder.mock.test.js

@@ -1,6 +1,6 @@
 // Behavior tests for Embedder, the public facade over Session, with the model
 // mocked so no ~1GB download happens. The real-model parity/golden gate stays
-// in embedder.test.ts (DOCGOV_EMBED_E2E) and is intentionally untouched.
+// in embedder.test.ts (docsgov_EMBED_E2E) and is intentionally untouched.
 //
 // vi.mock is hoisted above the imports and intercepts the dynamic
 // `await import("@huggingface/transformers")` inside session.ts, so

package/dist/dedup/embedder/embedder.test.js

@@ -26,15 +26,15 @@ function cosine(a, b) {
         dot += (a[i] ?? 0) * (b[i] ?? 0);
     return dot;
 }
-// E2E inference is gated by DOCGOV_EMBED_E2E because it downloads the model
+// E2E inference is gated by docsgov_EMBED_E2E because it downloads the model
 // (~1GB). Bit-parity vs Go is already proven (maxAbsDiff 3.6e-8 in the spike),
 // so default CI runs only the fast unit suites above and below.
-const e2e = process.env.DOCGOV_EMBED_E2E ? describe : describe.skip;
-e2e("real inference (DOCGOV_EMBED_E2E)", () => {
+const e2e = process.env.docsgov_EMBED_E2E ? describe : describe.skip;
+e2e("real inference (docsgov_EMBED_E2E)", () => {
     let emb;
     let dir;
     beforeEach(async () => {
-        dir = join(tmpdir(), `docgov-embed-${process.pid}-${Date.now()}`);
+        dir = join(tmpdir(), `docsgov-embed-${process.pid}-${Date.now()}`);
         emb = await Embedder.newEmbedder({ cacheDir: dir });
     });
     afterEach(async () => {

package/dist/dedup/embedder/session.test.js

@@ -1,6 +1,6 @@
 // Behavior tests for Session, the transformers.js pipeline wrapper, with the
 // model mocked so no ~1GB download happens. The real-model parity gate lives in
-// embedder.test.ts (DOCGOV_EMBED_E2E) and is intentionally untouched.
+// embedder.test.ts (docsgov_EMBED_E2E) and is intentionally untouched.
 //
 // vi.mock is hoisted above the imports and intercepts BOTH the static and the
 // dynamic `await import("@huggingface/transformers")` that session.ts performs,

package/dist/dedup/gitignore.js

@@ -1,4 +1,4 @@
-// Manages the docgov-owned block in .docgov/dedup/.gitignore that keeps the
+// Manages the docsgov-owned block in .docsgov/dedup/.gitignore that keeps the
 // local SQLite index cache out of git.
 //
 // Ported from internal/dedup/gitignore.go. Go's os.ReadFile/WriteFile become
@@ -9,8 +9,8 @@
 // are preserved verbatim.
 import { readFile, writeFile } from "node:fs/promises";
 import * as path from "node:path";
-/** dedupGitignoreHeader labels the block docgov manages in .docgov/dedup/.gitignore. */
-export const dedupGitignoreHeader = "# docgov dedup index cache — local, rebuilt by `docgov dedup`.";
+/** dedupGitignoreHeader labels the block docsgov manages in .docsgov/dedup/.gitignore. */
+export const dedupGitignoreHeader = "# docsgov dedup index cache — local, rebuilt by `docsgov dedup`.";
 /**
  * dedupGitignoreRules are the patterns that keep the local SQLite index cache out
  * of git: the DB plus its WAL-mode sidecars. config.yml and the .gitignore itself
@@ -24,7 +24,7 @@ function isNotExist(err) {
         err.code === "ENOENT");
 }
 /**
- * ensureDedupGitignore makes sure .docgov/dedup/.gitignore excludes the index
+ * ensureDedupGitignore makes sure .docsgov/dedup/.gitignore excludes the index
  * cache. It is a no-op when every rule is already present (matched as an exact,
  * trimmed line — comments and blanks ignored); otherwise it creates the file or
  * appends only the missing rules, leaving any existing content intact so a user's
@@ -75,7 +75,7 @@ export function gitignoreLineSet(body) {
     return set;
 }
 /**
- * appendGitignoreBlock returns existing followed by the docgov header and the
+ * appendGitignoreBlock returns existing followed by the docsgov header and the
  * missing rules. When existing is empty the block stands alone; otherwise it is
  * separated from prior content by a blank line, and a trailing newline is added
  * first if needed so the header never glues onto a user's last line.

package/dist/dedup/gitignore.test.js

@@ -1,5 +1,5 @@
 /**
- * Behavior-encoding tests for the docgov-owned .docgov/dedup/.gitignore block,
+ * Behavior-encoding tests for the docsgov-owned .docsgov/dedup/.gitignore block,
  * ported from internal/dedup/gitignore_test.go.
  *
  * WHY each case matters: this file decides what stays out of git. The exact
@@ -49,7 +49,7 @@ describe("ensureDedupGitignore", () => {
         const dir = newDir();
         await ensureDedupGitignore(dir);
         const got = readGitignore(dir);
-        const want = "# docgov dedup index cache — local, rebuilt by `docgov dedup`.\n" +
+        const want = "# docsgov dedup index cache — local, rebuilt by `docsgov dedup`.\n" +
             "index.db\nindex.db-wal\nindex.db-shm\n";
         expect(got).toBe(want);
         const set = gitignoreLineSet(got);

package/dist/dedup/indexdb/indexdb.js

@@ -1,9 +1,9 @@
 /**
  * Manages the dedup section index stored in a SQLite database.
  *
- * The DB lives at <repo_root>/.docgov/dedup/index.db. Callers resolve the repo
+ * The DB lives at <repo_root>/.docsgov/dedup/index.db. Callers resolve the repo
  * root and pass the absolute DB path to open — this package never walks for
- * .docgov or touches the sentinel constant (that stays in internal/repo).
+ * .docsgov or touches the sentinel constant (that stays in internal/repo).
  *
  * Ported from internal/dedup/indexdb. node:sqlite is synchronous, so Go's
  * context.Context / database/sql async plumbing is dropped: open/close/queries

package/dist/repo/exists.test.js

@@ -8,7 +8,7 @@ describe("exists: exact-case file presence for the docs guard", () => {
     // WHY: the docs guard calls exists to verify a referenced file is present.
     // A false negative would flag a valid reference as a violation.
     test("returns true for a file present at the exact-case path", async () => {
-        const root = await makeDir(".docgov", "docs/adr");
+        const root = await makeDir(".docsgov", "docs/adr");
         await nodefs.writeFile(path.join(root, "docs", "adr", "0001-foo.md"), "hello");
         const r = await find(root);
         expect(await r.exists("docs/adr/0001-foo.md")).toBe(true);
@@ -16,7 +16,7 @@ describe("exists: exact-case file presence for the docs guard", () => {
     // WHY: a reference to a non-existent file is the most common docs guard
     // violation; exists must detect absence.
     test("returns false for a missing file", async () => {
-        const root = await makeDir(".docgov", "docs/adr");
+        const root = await makeDir(".docsgov", "docs/adr");
         const r = await find(root);
         expect(await r.exists("docs/adr/nonexistent.md")).toBe(false);
     });
@@ -24,7 +24,7 @@ describe("exists: exact-case file presence for the docs guard", () => {
     // pass case-mismatched references. The segment-by-segment walk matches each
     // entry by exact case so reports are byte-identical across platforms.
     test("rejects a wrong-case filename segment", async () => {
-        const root = await makeDir(".docgov", "docs/adr");
+        const root = await makeDir(".docsgov", "docs/adr");
         await nodefs.writeFile(path.join(root, "docs", "adr", "0001-foo.md"), "hello");
         const r = await find(root);
         expect(await r.exists("docs/adr/0001-FOO.md")).toBe(false);
@@ -32,7 +32,7 @@ describe("exists: exact-case file presence for the docs guard", () => {
     // WHY: the exact-case rule must hold at EVERY segment, not just the filename;
     // a wrong-case directory prefix must fail too.
     test("rejects a wrong-case directory segment", async () => {
-        const root = await makeDir(".docgov", "docs/adr");
+        const root = await makeDir(".docsgov", "docs/adr");
         await nodefs.writeFile(path.join(root, "docs", "adr", "0001-foo.md"), "hello");
         const r = await find(root);
         expect(await r.exists("Docs/adr/0001-foo.md")).toBe(false);
@@ -40,7 +40,7 @@ describe("exists: exact-case file presence for the docs guard", () => {
     // WHY: the docs guard checks FILE references; a directory path is not a valid
     // file reference and must not pass.
     test("returns false for a directory path", async () => {
-        const root = await makeDir(".docgov", "docs/adr");
+        const root = await makeDir(".docsgov", "docs/adr");
         const r = await find(root);
         expect(await r.exists("docs/adr")).toBe(false);
     });
@@ -48,7 +48,7 @@ describe("exists: exact-case file presence for the docs guard", () => {
     // would abort on every reference to a file that doesn't exist yet, which is
     // the guard's core purpose.
     test("treats a missing path as false without throwing", async () => {
-        const root = await makeDir(".docgov");
+        const root = await makeDir(".docsgov");
         const r = await find(root);
         await expect(r.exists("does/not/exist.md")).resolves.toBe(false);
     });
@@ -58,7 +58,7 @@ describe("exists: exact-case file presence for the docs guard", () => {
     const isRoot = typeof process.getuid === "function" && process.getuid() === 0;
     const ioErrorTest = isRoot || os.platform() === "win32" ? test.skip : test;
     ioErrorTest("propagates a real I/O error rather than swallowing it as absent", async () => {
-        const root = await makeDir(".docgov", "docs");
+        const root = await makeDir(".docsgov", "docs");
         const r = await find(root);
         const docsPath = path.join(root, "docs");
         await nodefs.chmod(docsPath, 0o000);

package/dist/repo/index.js

@@ -1,4 +1,4 @@
-// Public surface of the repo package — the OS boundary for docgov.
+// Public surface of the repo package — the OS boundary for docsgov.
 export { Repo, PendingWrite, find } from "./repo.js";
 export { RealFS, isNotExist } from "./fs.js";
 export { OverlayFS } from "./overlay.js";

package/dist/repo/overlay.test.js

@@ -12,7 +12,7 @@ describe("withOverlay: single-path in-memory intercept", () => {
     // Core contract: the check sees the flipped bytes even though the real file
     // on disk still holds the original.
     test("overlaid path returns the injected content, not the on-disk bytes", async () => {
-        const root = await makeDir(".docgov", "docs");
+        const root = await makeDir(".docsgov", "docs");
         const r = await find(root);
         await r.writeFile("docs/a.md", enc.encode("---\nstatus: planning\n---\n"));
         const injected = enc.encode("---\nstatus: implemented\n---\n");
@@ -22,7 +22,7 @@ describe("withOverlay: single-path in-memory intercept", () => {
     // The resolver reads source files (non-overlaid); if the overlay intercepted
     // those, the resolver would see wrong data.
     test("non-overlaid path delegates to the base on-disk content", async () => {
-        const root = await makeDir(".docgov", "docs", "pkg");
+        const root = await makeDir(".docsgov", "docs", "pkg");
         const r = await find(root);
         await r.writeFile("docs/a.md", enc.encode("original\n"));
         await r.writeFile("pkg/foo.go", enc.encode("package foo\n"));
@@ -32,7 +32,7 @@ describe("withOverlay: single-path in-memory intercept", () => {
     // The check pipeline reads files via fs() too (direct reads and the markdown
     // walk); the overlay FS must agree with overlay readFile.
     test("fs() serves the injected content for the overlaid path", async () => {
-        const root = await makeDir(".docgov", "docs");
+        const root = await makeDir(".docsgov", "docs");
         const r = await find(root);
         await r.writeFile("docs/a.md", enc.encode("on-disk\n"));
         const injected = enc.encode("overlay\n");
@@ -42,7 +42,7 @@ describe("withOverlay: single-path in-memory intercept", () => {
     // If withOverlay mutated the base repo's FS, the real file would be
     // effectively overwritten in memory — the exact problem being avoided.
     test("creating an overlay does not mutate the base repo", async () => {
-        const root = await makeDir(".docgov", "docs");
+        const root = await makeDir(".docsgov", "docs");
         const r = await find(root);
         await r.writeFile("docs/a.md", enc.encode("status: planning\n"));
         r.withOverlay("docs/a.md", enc.encode("status: implemented\n"));
@@ -53,7 +53,7 @@ describe("withOverlay: single-path in-memory intercept", () => {
     // real on-disk tree (including the overlaid file). If readDir intercepted
     // anything, the walk would miss or duplicate files.
     test("readDir delegates to the base so the overlaid file is still enumerated", async () => {
-        const root = await makeDir(".docgov", "docs");
+        const root = await makeDir(".docsgov", "docs");
         const r = await find(root);
         await r.writeFile("docs/a.md", enc.encode("on-disk\n"));
         await r.writeFile("docs/b.md", enc.encode("other\n"));
@@ -68,7 +68,7 @@ describe("withOverlay: single-path in-memory intercept", () => {
     // the overlay's content rule — a sub() that diverged from base would make a
     // nested read return the wrong bytes for non-overlaid files.
     test("sub descends into the base subtree", async () => {
-        const root = await makeDir(".docgov", "docs", "pkg");
+        const root = await makeDir(".docsgov", "docs", "pkg");
         const r = await find(root);
         await r.writeFile("docs/a.md", enc.encode("on-disk\n"));
         await r.writeFile("pkg/foo.go", enc.encode("package foo\n"));

package/dist/repo/repo.js

@@ -1,10 +1,10 @@
-// Package repo is the OS boundary for docgov. It is the only package that
+// Package repo is the OS boundary for docsgov. It is the only package that
 // touches the real filesystem directly and owns OS path handling. Everything
 // else works with slash paths and the FS interface.
 //
 // Responsibilities:
-//   - Walk CWD up to the nearest ancestor containing a .docgov/ directory.
-//   - Fall back to the supplied directory when no .docgov/ exists (gen/add
+//   - Walk CWD up to the nearest ancestor containing a .docsgov/ directory.
+//   - Fall back to the supplied directory when no .docsgov/ exists (gen/add
 //     bootstrapping mode).
 //   - Return a Repo that exposes an FS and the OS root path.
 //   - CRLF -> LF normalisation on every file read.
@@ -12,8 +12,8 @@ import * as nodefs from "node:fs/promises";
 import * as path from "node:path";
 import { isNotExist, RealFS } from "./fs.js";
 import { OverlayFS } from "./overlay.js";
-// sentinel is the directory name that marks a docgov repository root.
-const sentinel = ".docgov";
+// sentinel is the directory name that marks a docsgov repository root.
+const sentinel = ".docsgov";
 /**
  * Holds the resolved repository root. It is the sole owner of the OS path; all
  * callers work through the {@link FS} interface or the slash-path readFile
@@ -209,7 +209,7 @@ export class Repo {
     }
     /**
      * Writes `content` to a temp file that is a sibling of the file at
-     * `slashPath` (same directory, ".docgov-flip.tmp" suffix), then returns a
+     * `slashPath` (same directory, ".docsgov-flip.tmp" suffix), then returns a
      * {@link PendingWrite}. The caller calls commit to either rename the temp
      * into place (ok=true) or remove it (ok=false). The temp file is always in
      * the same directory as the target so the rename stays atomic on a single
@@ -223,7 +223,7 @@ export class Repo {
         catch (err) {
             throw new Error(`repo.atomicWriteFile: mkdir parents for ${JSON.stringify(slashPath)}: ${errMsg(err)}`);
         }
-        const tmpAbs = abs + ".docgov-flip.tmp";
+        const tmpAbs = abs + ".docsgov-flip.tmp";
         try {
             await nodefs.writeFile(tmpAbs, content);
         }
@@ -298,9 +298,9 @@ export class PendingWrite {
     }
 }
 /**
- * Walks up from `dir` to locate the nearest ancestor containing a .docgov/
+ * Walks up from `dir` to locate the nearest ancestor containing a .docsgov/
  * directory. If none is found it falls back to `dir` itself (so gen and add can
- * bootstrap a repo that has no .docgov/ yet). `dir` is resolved to an absolute
+ * bootstrap a repo that has no .docsgov/ yet). `dir` is resolved to an absolute
  * OS path first.
  */
 export async function find(dir) {
@@ -322,7 +322,7 @@ export async function find(dir) {
         }
         const parent = path.dirname(current);
         if (parent === current) {
-            // Reached the filesystem root without finding .docgov/. Fall back to the
+            // Reached the filesystem root without finding .docsgov/. Fall back to the
             // original dir (bootstrapping mode).
             return new Repo(abs, new RealFS(abs));
         }