feat(cli): improve progress output with live updates

AGENTS.md

@@ -38,6 +38,9 @@ pnpm.
 
 - Use `node:` specifiers for built-in modules.
 - Keep modules small and single-purpose; prefer focused helpers in `src/`.
+- Prefer early returns to reduce nested control flow.
+- Avoid `else if` branches when early returns or separate conditionals are clearer.
+- Avoid type casts when a safe type guard or discriminated union can be used.
 - Place shared types in `src/types/` and import them via `import type`.
 - Use `index.ts` barrels for public entrypoints.
 

build.config.ts

@@ -4,7 +4,7 @@ export default defineBuildConfig({
 	entries: [
 		{ input: "src/cli/index", name: "cli" },
 		{ input: "src/api", name: "api" },
-		{ input: "src/lock", name: "lock" },
+		{ input: "src/cache/lock", name: "lock" },
 	],
 	declaration: true,
 	clean: true,

docs.config.schema.json

@@ -58,14 +58,6 @@
 				"ignoreHidden": {
 					"type": "boolean"
 				},
-				"allowHosts": {
-					"minItems": 1,
-					"type": "array",
-					"items": {
-						"type": "string",
-						"minLength": 1
-					}
-				},
 				"toc": {
 					"anyOf": [
 						{
@@ -79,6 +71,14 @@
 				},
 				"unwrapSingleRootDir": {
 					"type": "boolean"
+				},
+				"allowHosts": {
+					"minItems": 1,
+					"type": "array",
+					"items": {
+						"type": "string",
+						"minLength": 1
+					}
 				}
 			},
 			"additionalProperties": false
@@ -88,22 +88,6 @@
 			"items": {
 				"type": "object",
 				"properties": {
-					"id": {
-						"type": "string",
-						"minLength": 1
-					},
-					"repo": {
-						"type": "string",
-						"minLength": 1
-					},
-					"targetDir": {
-						"type": "string",
-						"minLength": 1
-					},
-					"targetMode": {
-						"type": "string",
-						"enum": ["symlink", "copy"]
-					},
 					"ref": {
 						"type": "string",
 						"minLength": 1
@@ -113,6 +97,7 @@
 						"enum": ["materialize"]
 					},
 					"include": {
+						"minItems": 1,
 						"type": "array",
 						"items": {
 							"type": "string",
@@ -126,6 +111,10 @@
 							"minLength": 1
 						}
 					},
+					"targetMode": {
+						"type": "string",
+						"enum": ["symlink", "copy"]
+					},
 					"required": {
 						"type": "boolean"
 					},
@@ -140,6 +129,32 @@
 					"ignoreHidden": {
 						"type": "boolean"
 					},
+					"toc": {
+						"anyOf": [
+							{
+								"type": "boolean"
+							},
+							{
+								"type": "string",
+								"enum": ["tree", "compressed"]
+							}
+						]
+					},
+					"unwrapSingleRootDir": {
+						"type": "boolean"
+					},
+					"id": {
+						"type": "string",
+						"minLength": 1
+					},
+					"repo": {
+						"type": "string",
+						"minLength": 1
+					},
+					"targetDir": {
+						"type": "string",
+						"minLength": 1
+					},
 					"integrity": {
 						"type": "object",
 						"properties": {
@@ -160,20 +175,6 @@
 						},
 						"required": ["type", "value"],
 						"additionalProperties": false
-					},
-					"toc": {
-						"anyOf": [
-							{
-								"type": "boolean"
-							},
-							{
-								"type": "string",
-								"enum": ["tree", "compressed"]
-							}
-						]
-					},
-					"unwrapSingleRootDir": {
-						"type": "boolean"
 					}
 				},
 				"required": ["id", "repo"],

package.json

@@ -2,6 +2,15 @@
 	"name": "docs-cache",
 	"private": false,
 	"type": "module",
+	"imports": {
+		"#cache/*": "./src/cache/*.ts",
+		"#cli/*": "./src/cli/*.ts",
+		"#commands/*": "./src/commands/*.ts",
+		"#core/*": "./src/*.ts",
+		"#config": "./src/config/index.ts",
+		"#config/*": "./src/config/*.ts",
+		"#git/*": "./src/git/*.ts"
+	},
 	"version": "0.4.3",
 	"packageManager": "pnpm@10.14.0+sha512.ad27a79641b49c3e481a16a805baa71817a04bbe06a38d17e60e2eaee83f6a146c6a688125f5792e48dd5ba30e7da52a5cda4c3992b9ccf333f9ce223af84748",
 	"description": "CLI for deterministic local caching of external documentation for agents and tools",
@@ -49,6 +58,7 @@
 		"test": "pnpm build && node --test",
 		"test:coverage": "pnpm build && c8 --include dist --exclude bin --reporter=text node --test",
 		"bench": "pnpm build && node scripts/benchmarks/run.mjs",
+		"complexity": "node scripts/complexity/run.mjs",
 		"schema:build": "node scripts/generate-schema.mjs",
 		"size": "size-limit",
 		"test:watch": "node --test --watch",
@@ -58,8 +68,10 @@
 	"dependencies": {
 		"@clack/prompts": "^1.0.0",
 		"cac": "^6.7.14",
+		"cli-truncate": "^4.0.0",
 		"execa": "^9.6.1",
 		"fast-glob": "^3.3.2",
+		"log-update": "^5.0.1",
 		"picocolors": "^1.1.1",
 		"picomatch": "^2.3.1",
 		"zod": "^4.3.6"
@@ -75,6 +87,7 @@
 		"simple-git-hooks": "^2.13.1",
 		"size-limit": "^11.2.0",
 		"tinybench": "^6.0.0",
+		"ts-complex": "^1.0.0",
 		"typescript": "^5.9.3",
 		"unbuild": "^3.6.1"
 	},
@@ -84,6 +97,11 @@
 			"limit": "10 kB"
 		}
 	],
+	"complexity": {
+		"maxCyclomatic": 20,
+		"minMaintainability": 60,
+		"top": 10
+	},
 	"simple-git-hooks": {
 		"pre-commit": "pnpm lint-staged && pnpm typecheck"
 	},