refactor: Rename lock file to docs-lock.json

.gitignore

@@ -7,7 +7,7 @@ pnpm-debug.log*
 npm-debug.log*
 yarn-debug.log*
 docs.config.json
-docs.lock
+/docs-lock.json
 coverage
 TODO.md
 .docs/

AGENTS.md

@@ -22,7 +22,7 @@ pnpm.
 ## Cache layout
 
 - Materialized sources live at `.docs/<id>/`.
-- Lock file lives next to `docs.config.json` as `docs.lock`.
+- Lock file lives next to `docs.config.json` as `docs-lock.json`.
 
 ## CLI architecture
 

README.md

@@ -15,7 +15,7 @@ Documentation is cached in a gitignored location, exposed to agent and tool targ
 ## Features
 
 - **Local only**: Cache lives in the directory `.docs` (or a custom location) and _should_ be gitignored.
-- **Deterministic**: `docs.lock` pins commits and file metadata.
+- **Deterministic**: `docs-lock.json` pins commits and file metadata.
 - **Fast**: Local cache avoids network roundtrips after sync.
 - **Flexible**: Cache full repos or just the subdirectories you need.
 

package.json

@@ -58,6 +58,7 @@
 	"dependencies": {
 		"@clack/prompts": "^1.0.0",
 		"cac": "^6.7.14",
+		"execa": "^9.6.1",
 		"fast-glob": "^3.3.2",
 		"picocolors": "^1.1.1",
 		"picomatch": "^2.3.1",

scripts/benchmarks/run.mjs

@@ -18,6 +18,7 @@ import {
 	verifyCache,
 } from "../../dist/api.mjs";
 import {
+	DEFAULT_LOCK_FILENAME,
 	readLock,
 	resolveLockPath,
 	validateLock,
@@ -286,7 +287,7 @@ const main = async () => {
 			() => {
 				const tempLock = path.join(
 					benchRoot,
-					`docs.lock.${Math.random().toString(36).slice(2)}`,
+					`${DEFAULT_LOCK_FILENAME}.${Math.random().toString(36).slice(2)}`,
 				);
 				return writeLock(tempLock, lockData);
 			},

src/api.ts

@@ -5,6 +5,7 @@ export { loadConfig } from "./config";
 export { redactRepoUrl } from "./git/redact";
 export { enforceHostAllowlist, parseLsRemote } from "./git/resolve-remote";
 export { initConfig } from "./init";
+export { DEFAULT_LOCK_FILENAME } from "./lock";
 export { pruneCache } from "./prune";
 export { removeSources } from "./remove";
 export { resolveRepoInput } from "./resolve-repo";