feat(cli): refresh initial map metadata during init

Author: oscabriel

apps/cli/package.json

@@ -1,91 +1,91 @@
 {
-  "name": "offworld",
-  "version": "0.3.2",
-  "description": "Offworld CLI - Repository reference generation for AI coding agents",
-  "keywords": [
-    "ai",
-    "ai-agents",
-    "amp",
-    "anthropic",
-    "claude",
-    "claude-code",
-    "cli",
-    "codex",
-    "coding-agent",
-    "context",
-    "cursor",
-    "dependencies",
-    "developer-tools",
-    "documentation",
-    "git",
-    "llm",
-    "monorepo",
-    "offworld",
-    "opencode",
-    "reference",
-    "repository",
-    "skill",
-    "typescript"
-  ],
-  "homepage": "https://offworld.sh",
-  "bugs": {
-    "url": "https://github.com/oscabriel/offworld/issues"
-  },
-  "license": "MIT",
-  "author": "Oscar Gabriel",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/oscabriel/offworld.git",
-    "directory": "apps/cli"
-  },
-  "bin": {
-    "offworld": "./dist/cli.mjs",
-    "ow": "./dist/cli.mjs"
-  },
-  "files": [
-    "dist",
-    "LICENSE",
-    "README.md"
-  ],
-  "type": "module",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.mts",
-      "import": "./dist/index.mjs"
-    }
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "build": "tsdown && chmod +x ./dist/cli.mjs",
-    "dev": "tsdown --watch",
-    "ow:dev": "bun run src/cli.ts",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "prepublishOnly": "npm run build",
-    "check": "oxlint && oxfmt --write"
-  },
-  "dependencies": {
-    "@clack/prompts": "^1.0.0",
-    "@offworld/sdk": "workspace:*",
-    "@offworld/types": "workspace:*",
-    "@opencode-ai/sdk": "^1.1.51",
-    "@orpc/server": "^1.13.4",
-    "convex": "catalog:",
-    "open": "^11.0.0",
-    "picocolors": "^1.1.1",
-    "trpc-cli": "^0.12.2",
-    "zod": "catalog:"
-  },
-  "devDependencies": {
-    "@types/node": "catalog:",
-    "tsdown": "catalog:",
-    "typescript": "catalog:",
-    "vitest": "catalog:"
-  },
-  "engines": {
-    "node": ">=18"
-  }
+	"name": "offworld",
+	"version": "0.3.2",
+	"description": "Offworld CLI - Repository reference generation for AI coding agents",
+	"keywords": [
+		"ai",
+		"ai-agents",
+		"amp",
+		"anthropic",
+		"claude",
+		"claude-code",
+		"cli",
+		"codex",
+		"coding-agent",
+		"context",
+		"cursor",
+		"dependencies",
+		"developer-tools",
+		"documentation",
+		"git",
+		"llm",
+		"monorepo",
+		"offworld",
+		"opencode",
+		"reference",
+		"repository",
+		"skill",
+		"typescript"
+	],
+	"homepage": "https://offworld.sh",
+	"bugs": {
+		"url": "https://github.com/oscabriel/offworld/issues"
+	},
+	"license": "MIT",
+	"author": "Oscar Gabriel",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/oscabriel/offworld.git",
+		"directory": "apps/cli"
+	},
+	"bin": {
+		"offworld": "./dist/cli.mjs",
+		"ow": "./dist/cli.mjs"
+	},
+	"files": [
+		"dist",
+		"LICENSE",
+		"README.md"
+	],
+	"type": "module",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.mts",
+			"import": "./dist/index.mjs"
+		}
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"scripts": {
+		"build": "tsdown && chmod +x ./dist/cli.mjs",
+		"dev": "tsdown --watch",
+		"ow:dev": "bun run src/cli.ts",
+		"typecheck": "tsc --noEmit",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"prepublishOnly": "npm run build",
+		"check": "oxlint && oxfmt --write"
+	},
+	"dependencies": {
+		"@clack/prompts": "^1.0.0",
+		"@offworld/sdk": "workspace:*",
+		"@offworld/types": "workspace:*",
+		"@opencode-ai/sdk": "^1.1.51",
+		"@orpc/server": "^1.13.4",
+		"convex": "catalog:",
+		"open": "^11.0.0",
+		"picocolors": "^1.1.1",
+		"trpc-cli": "^0.12.2",
+		"zod": "catalog:"
+	},
+	"devDependencies": {
+		"@types/node": "catalog:",
+		"tsdown": "catalog:",
+		"typescript": "catalog:",
+		"vitest": "catalog:"
+	},
+	"engines": {
+		"node": ">=18"
+	}
 }

apps/cli/src/handlers/init.ts

@@ -1,12 +1,13 @@
 import * as p from "@clack/prompts";
 import { existsSync } from "node:fs";
 import { homedir } from "node:os";
-import { resolve, join, dirname } from "node:path";
+import { resolve, join, dirname, basename } from "node:path";
 import {
 	loadConfig,
 	saveConfig,
 	getConfigPath,
 	getMetaRoot,
+	getReferencePath,
 	Paths,
 	detectInstalledAgents,
 	getAllAgentConfigs,
@@ -16,6 +17,9 @@ import {
 	getProvider,
 	validateProviderModel,
 	discoverRepos,
+	readGlobalMap,
+	writeGlobalMap,
+	resolveReferenceKeywords,
 	type ProviderInfo,
 	type ModelInfo,
 } from "@offworld/sdk/internal";
@@ -85,18 +89,19 @@ function detectProjectRoot(): string | null {
 }
 
 const BANNER = `
- ██████╗ ███████╗███████╗██╗    ██╗ ██████╗ ██████╗ ██╗     ██████╗ 
+ ██████╗ ███████╗███████╗██╗    ██╗ ██████╗ ██████╗ ██╗     ██████╗
 ██╔═══██╗██╔════╝██╔════╝██║    ██║██╔═══██╗██╔══██╗██║     ██╔══██╗
 ██║   ██║█████╗  █████╗  ██║ █╗ ██║██║   ██║██████╔╝██║     ██║  ██║
 ██║   ██║██╔══╝  ██╔══╝  ██║███╗██║██║   ██║██╔══██╗██║     ██║  ██║
 ╚██████╔╝██║     ██║     ╚███╔███╔╝╚██████╔╝██║  ██║███████╗██████╔╝
- ╚═════╝ ╚═╝     ╚═╝      ╚══╝╚══╝  ╚═════╝ ╚═╝  ╚═╝╚══════╝╚═════╝ 
+ ╚═════╝ ╚═╝     ╚═╝      ╚══╝╚══╝  ╚═════╝ ╚═╝  ╚═╝╚══════╝╚═════╝
 `;
 
 export async function initHandler(options: InitOptions = {}): Promise<InitResult> {
 	const configPath = getConfigPath();
 	const existingConfig = loadConfig();
 	const configExists = existsSync(configPath);
+	const mapExistedBeforeInit = existsSync(Paths.offworldGlobalMapPath);
 	const projectRoot = detectProjectRoot();
 
 	console.log(BANNER);
@@ -338,7 +343,7 @@ export async function initHandler(options: InitOptions = {}): Promise<InitResult
 			let shouldDiscover = options.yes;
 			if (!options.yes) {
 				const confirmDiscover = await p.confirm({
-					message: "Add them to your clone map? (they will be marked as not referenced)",
+					message: "Add them to your clone map?",
 					initialValue: true,
 				});
 				if (!p.isCancel(confirmDiscover)) {
@@ -349,6 +354,46 @@ export async function initHandler(options: InitOptions = {}): Promise<InitResult
 			if (shouldDiscover) {
 				const result = await discoverRepos({ repoRoot: expandedRepoRoot });
 				p.log.success(`Added ${result.discovered.length} repos to clone map`);
+
+				if (!mapExistedBeforeInit && result.discovered.length > 0) {
+					const refreshSpinner = p.spinner();
+					refreshSpinner.start("Building map.json...");
+
+					const map = readGlobalMap();
+					let refreshedCount = 0;
+					let withReferenceCount = 0;
+
+					for (const repo of result.discovered) {
+						const existingEntry = map.repos[repo.qualifiedName];
+						if (!existingEntry) continue;
+
+						const keywords = await resolveReferenceKeywords(repo.fullName, repo.localPath);
+						const referencePath = getReferencePath(repo.fullName);
+						const referenceFile = existsSync(referencePath) ? basename(referencePath) : "";
+						const references = referenceFile
+							? Array.from(new Set([...(existingEntry.references ?? []), referenceFile]))
+							: existingEntry.references;
+
+						if (referenceFile) {
+							withReferenceCount++;
+						}
+
+						map.repos[repo.qualifiedName] = {
+							...existingEntry,
+							references,
+							primary: referenceFile || existingEntry.primary,
+							keywords,
+							updatedAt: new Date().toISOString(),
+						};
+
+						refreshedCount++;
+					}
+
+					writeGlobalMap(map);
+					refreshSpinner.stop(
+						`Refreshed ${refreshedCount} map entries (${withReferenceCount} with references)`,
+					);
+				}
 			}
 		}
 	}