@theholocron/cli 2.0.0-alpha.55 → 2.0.0-alpha.57

package/README.md

@@ -25,7 +25,7 @@ Holocron reads `holocron.config.{json,js,ts}` from the project root
 ```jsonc
 // holocron.config.json
 {
-  "project": { "name": "my-app" },
+  "name": "my-app",
   "providers": {
     "vault": ["1password", { "vault": "my-app" }],
     "source": "github",
@@ -42,7 +42,7 @@ Holocron reads `holocron.config.{json,js,ts}` from the project root
 import { defineConfig } from "@theholocron/cli";
 
 export default defineConfig({
-  project: { name: "my-app" },
+  name: "my-app",
   providers: {
     vault: ["1password", { vault: "my-app" }],
     source: "github",
@@ -51,6 +51,29 @@ export default defineConfig({
 
 ```
 
+### Auto-derived fields
+
+`name` and `repo.name` are optional. When absent, Holocron fills them
+in at load time:
+
+| Field       | Derived from                                         | Fallback           |
+| ----------- | ---------------------------------------------------- | ------------------ |
+| `name`      | `package.json` → `name` field (scope stripped)       | directory basename |
+| `repo.name` | `git remote get-url origin` (parsed to `owner/repo`) | not set            |
+
+A minimal config — for repos with a `package.json` and a GitHub remote
+— only needs `providers`:
+
+<!-- prettier-ignore -->
+```jsonc
+{ "providers": { "source": "github" } }
+```
+
+Set `name` explicitly whenever the derived value would be wrong: content
+repos without a `package.json` (e.g. `.github`) will fall back to the
+directory basename, which may not match what your vault or deployment
+provider expects as a project identifier.
+
 ### Shareable configs
 
 **Level 1 — per-capability config packages.** Reference a published

package/dist/capabilities/index.d.mts

@@ -137,6 +137,11 @@ interface Source extends ProviderIdentity {
    * Optional — providers that don't support topics omit this.
    */
   syncTopics?(topics: string[]): Promise<string>;
+  /**
+   * Set the repository description.
+   * Optional — providers that don't support setting descriptions omit this.
+   */
+  syncDescription?(description: string): Promise<string>;
 }
 type CiRunStatus = "queued" | "in_progress" | "completed" | "cancelled" | "failure" | "success" | "skipped";
 interface CiRun {

package/dist/cli.mjs

@@ -7,9 +7,10 @@ import { ProviderApiError, ProviderApiError as ProviderApiError$1 } from "@theho
 import { Entry, findCredentials } from "@napi-rs/keyring";
 import { createHash } from "node:crypto";
 import { createGitHubClient } from "@theholocron/github-client";
-import { spawnSync } from "node:child_process";
-import { access, readFile, stat } from "node:fs/promises";
+import { execFile, spawnSync } from "node:child_process";
+import { access, readFile, stat, writeFile } from "node:fs/promises";
 import { pathToFileURL } from "node:url";
+import { promisify } from "node:util";
 //#region src/capabilities/index.ts
 const CARDINALITY = {
 	source: "single",
@@ -129,7 +130,7 @@ function resolveEntry(key, raw) {
 	};
 }
 function resolveConfig(raw) {
-	if (!raw.project?.name) throw new ConfigError("`project.name` is required");
+	if (!raw.name) throw new ConfigError("`name` is required");
 	if (!raw.providers || typeof raw.providers !== "object") throw new ConfigError("`providers` block is required");
 	const providers = {};
 	for (const [key, entry] of Object.entries(raw.providers)) {
@@ -138,7 +139,10 @@ function resolveConfig(raw) {
 	}
 	for (const required of REQUIRED_CAPABILITIES) if (!providers[required]) throw new ConfigError(`required capability \`${required}\` is missing from providers`);
 	return {
-		project: raw.project,
+		name: raw.name,
+		description: raw.description,
+		repo: raw.repo,
+		workflows: raw.workflows,
 		providers,
 		apps: raw.apps ?? [],
 		doctor: raw.doctor ?? {}
@@ -465,7 +469,7 @@ var PluginLoader = class {
 	*/
 	projectDefaults() {
 		const defaults = {};
-		if (this.config.project.repo) defaults.repo = this.config.project.repo.name;
+		if (this.config.repo?.name) defaults.repo = this.config.repo.name;
 		return defaults;
 	}
 };
@@ -527,7 +531,7 @@ async function runDoctor(input) {
 	await loader.load();
 	const rows = [];
 	const config = input.loaded.resolved;
-	print(`Holocron doctor — ${config.project.name}`);
+	print(`Holocron doctor — ${config.name}`);
 	print(`  config: ${input.loaded.filepath}`);
 	print("");
 	for (const key of loader.loadedKeys()) {
@@ -2009,7 +2013,7 @@ function generateThinCallerContent(name, withOverrides) {
 //#region src/commands/sync-github.ts
 const DEFAULT_REPO = "theholocron/.github";
 /**
-* Extracts the `project.workflows` array from a `holocron.config.ts` source string.
+* Extracts the `workflows` array from a `holocron.config.ts` source string.
 * Handles both plain string entries and `{ name, with }` object entries.
 * Falls back to an empty array if the array cannot be found or parsed.
 */
@@ -2180,7 +2184,7 @@ async function runSyncGithub(input) {
 		let entries = [];
 		try {
 			const data = await client.git.getContents(repo, "holocron.config.json");
-			entries = (JSON.parse(Buffer.from(data.content.replace(/\n/g, ""), "base64").toString("utf8"))?.project?.workflows ?? []).map((w) => typeof w === "string" ? { name: w } : w);
+			entries = (JSON.parse(Buffer.from(data.content.replace(/\n/g, ""), "base64").toString("utf8"))?.workflows ?? []).map((w) => typeof w === "string" ? { name: w } : w);
 		} catch (err) {
 			if (!(err instanceof ProviderApiError) || err.status !== 404) throw err;
 			try {
@@ -2449,7 +2453,7 @@ const defaultExec = async (cmd, args, opts) => {
 //#endregion
 //#region src/commands/plugin-create/template-inputs.ts
 /** Derive the standard defaults from a slug + vendor name. */
-function deriveDefaults(input) {
+function deriveDefaults$1(input) {
 	const vendorUpper = input.slug.toUpperCase().replace(/-/g, "_");
 	const capability = input.capability;
 	return {
@@ -3380,7 +3384,7 @@ function runPluginCreate(input) {
 	const packageDir = path.join(cwd, "packages", `holocron-plugin-${input.slug}`);
 	if (existsSync(packageDir)) throw new PluginCreateError(`\`${packageDir}\` already exists — edit in place or pick a different slug.`);
 	validateCapability(input.capability, print);
-	const derived = deriveDefaults({
+	const derived = deriveDefaults$1({
 		slug: input.slug,
 		vendorName: input.vendorName,
 		capability: input.capability
@@ -4009,9 +4013,9 @@ async function runSetup(input) {
 	const config = input.loaded.resolved;
 	const dryRun = input.context.dryRun ?? false;
 	const steps = [];
-	const repo = config.project.repo;
+	const repo = config.repo;
 	const effectivePreset = repo?.protection;
-	print(`Holocron setup — ${config.project.name}${dryRun ? " (dry-run)" : ""}`);
+	print(`Holocron setup — ${config.name}${dryRun ? " (dry-run)" : ""}`);
 	print(`  config: ${input.loaded.filepath}`);
 	print("");
 	if (loader.has("source")) {
@@ -4029,7 +4033,7 @@ async function runSetup(input) {
 			}));
 			print(formatStep(steps[steps.length - 1]));
 		}
-		const usesAdvancedCodeQL = (config.project.workflows ?? []).map((e) => typeof e === "string" ? e : e.name).includes("codeql");
+		const usesAdvancedCodeQL = (config.workflows ?? []).map((e) => typeof e === "string" ? e : e.name).includes("codeql");
 		steps.push(await runStep("source", usesAdvancedCodeQL ? "disableDefaultCodeScanning" : "enableCodeScanning", dryRun, async () => {
 			if (usesAdvancedCodeQL) await source.disableDefaultCodeScanning();
 			else return await source.enableCodeScanning();
@@ -4040,7 +4044,7 @@ async function runSetup(input) {
 				await source.updateRepoSettings(BALANCED_REPO_SETTINGS);
 			}));
 			print(formatStep(steps[steps.length - 1]));
-			const configuredWorkflowNames = (config.project.workflows ?? []).map((entry) => typeof entry === "string" ? entry : entry.name);
+			const configuredWorkflowNames = (config.workflows ?? []).map((entry) => typeof entry === "string" ? entry : entry.name);
 			const requiredChecks = effectivePreset === "strict" ? [
 				"DCO",
 				...configuredWorkflowNames.flatMap((name) => {
@@ -4053,7 +4057,7 @@ async function runSetup(input) {
 			print(formatStep(steps[steps.length - 1]));
 		}
 	}
-	const workflows = config.project.workflows;
+	const workflows = config.workflows;
 	if (loader.has("source") && workflows && workflows.length > 0) {
 		const source = loader.get("source");
 		print("  → workflows");
@@ -4076,7 +4080,7 @@ async function runSetup(input) {
 			print(formatStep(steps[steps.length - 1]));
 		}
 	}
-	if (loader.has("source") && (config.project.workflows ?? []).map((e) => typeof e === "string" ? e : e.name).includes("bookkeeping-pr")) {
+	if (loader.has("source") && (config.workflows ?? []).map((e) => typeof e === "string" ? e : e.name).includes("bookkeeping-pr")) {
 		const source = loader.get("source");
 		steps.push(await runStep("source", "write .github/labeler.yml", dryRun, async () => {
 			await source.writeRepoFile(".github/labeler.yml", labelerConfig());
@@ -4142,8 +4146,8 @@ async function runSetup(input) {
 	if (loader.has("deployment")) {
 		const deploy = loader.get("deployment");
 		print("  → deployment");
-		steps.push(await runStep("deployment", `ensureProject ${config.project.name}`, dryRun, async () => {
-			await deploy.ensureProject({ name: config.project.name });
+		steps.push(await runStep("deployment", `ensureProject ${config.name}`, dryRun, async () => {
+			await deploy.ensureProject({ name: config.name });
 		}));
 		print(formatStep(steps[steps.length - 1]));
 	}
@@ -4169,8 +4173,8 @@ async function runSetup(input) {
 		const vault = loader.get("vault");
 		print("  → vault");
 		if (vault.ensureProject) {
-			steps.push(await runStep("vault", `ensureProject ${config.project.name}`, dryRun, async () => {
-				return `project ${(await vault.ensureProject(config.project.name)).alreadyExists ? "exists" : "created"}`;
+			steps.push(await runStep("vault", `ensureProject ${config.name}`, dryRun, async () => {
+				return `project ${(await vault.ensureProject(config.name)).alreadyExists ? "exists" : "created"}`;
 			}));
 			print(formatStep(steps[steps.length - 1]));
 		}
@@ -4180,7 +4184,7 @@ async function runSetup(input) {
 			"prd"
 		]) {
 			steps.push(await runStep("vault", `ensureEnvironment ${envName}`, dryRun, async () => {
-				return `${envName} ${(await vault.ensureEnvironment(config.project.name, envName)).alreadyExists ? "exists" : "created"}`;
+				return `${envName} ${(await vault.ensureEnvironment(config.name, envName)).alreadyExists ? "exists" : "created"}`;
 			}));
 			print(formatStep(steps[steps.length - 1]));
 		}
@@ -4265,7 +4269,9 @@ function formatStep(step) {
 const SYNC_STEPS = [
 	"labels",
 	"properties",
-	"topics"
+	"topics",
+	"keywords",
+	"description"
 ];
 async function runSync(input) {
 	const print = input.print ?? ((line) => console.log(line));
@@ -4275,7 +4281,7 @@ async function runSync(input) {
 	const dryRun = input.context.dryRun ?? false;
 	const requestedSteps = input.steps;
 	const steps = [];
-	print(`Holocron sync — ${config.project.name}${dryRun ? " (dry-run)" : ""}`);
+	print(`Holocron sync — ${config.name}${dryRun ? " (dry-run)" : ""}`);
 	print(`  config: ${input.loaded.filepath}`);
 	print("");
 	if (loader.has("source")) {
@@ -4296,7 +4302,7 @@ async function runSync(input) {
 				print(formatSyncStep(steps[steps.length - 1]));
 			}
 			if (stepName === "properties") if (source.syncProperties) {
-				const repo = config.project.repo;
+				const repo = config.repo;
 				const properties = {};
 				const effectivePreset = repo?.protection;
 				if (effectivePreset && effectivePreset !== "none") properties["branch_protection_level"] = effectivePreset;
@@ -4319,7 +4325,7 @@ async function runSync(input) {
 				print(formatSyncStep(steps[steps.length - 1]));
 			}
 			if (stepName === "topics") {
-				const topics = config.project.repo?.topics ?? [];
+				const topics = config.repo?.topics ?? [];
 				if (topics.length === 0) {
 					steps.push({
 						capability: "source",
@@ -4341,6 +4347,47 @@ async function runSync(input) {
 					print(formatSyncStep(steps[steps.length - 1]));
 				}
 			}
+			if (stepName === "keywords") {
+				const topics = config.repo?.topics ?? [];
+				if (topics.length === 0) {
+					steps.push({
+						capability: "source",
+						step: "sync keywords",
+						status: "skip",
+						message: "no topics configured"
+					});
+					print(formatSyncStep(steps[steps.length - 1]));
+				} else {
+					steps.push(await runSyncStep("source", "sync keywords", dryRun, async () => {
+						return await writePackageJsonField(input.context.repoRoot, "keywords", topics) ? `${topics.length} keywords written` : `${topics.length} topics (no package.json)`;
+					}));
+					print(formatSyncStep(steps[steps.length - 1]));
+				}
+			}
+			if (stepName === "description") {
+				const description = config.description;
+				if (!description) {
+					steps.push({
+						capability: "source",
+						step: "sync description",
+						status: "skip",
+						message: "no description configured"
+					});
+					print(formatSyncStep(steps[steps.length - 1]));
+				} else {
+					steps.push(await runSyncStep("source", "sync description", dryRun, async () => {
+						const pkgWrote = await writePackageJsonField(input.context.repoRoot, "description", description);
+						const readmeWrote = await updateReadmeDescription(input.context.repoRoot, description);
+						if (source.syncDescription) await source.syncDescription(description);
+						const parts = [];
+						if (pkgWrote) parts.push("package.json");
+						if (readmeWrote) parts.push("README.md");
+						if (source.syncDescription) parts.push("GitHub");
+						return parts.length > 0 ? parts.join(", ") + " updated" : "description synced";
+					}));
+					print(formatSyncStep(steps[steps.length - 1]));
+				}
+			}
 		}
 		if (requestedSteps) {
 			for (const name of requestedSteps) if (!SYNC_STEPS.includes(name)) {
@@ -4402,6 +4449,44 @@ function formatSyncStep(step) {
 	const detail = step.message ? `  (${step.message})` : "";
 	return `    ${icon} ${step.step}${detail}`;
 }
+async function writePackageJsonField(repoRoot, field, value) {
+	const pkgPath = join(repoRoot, "package.json");
+	let content;
+	try {
+		content = await readFile(pkgPath, "utf8");
+	} catch {
+		return false;
+	}
+	const pkg = JSON.parse(content);
+	pkg[field] = value;
+	await writeFile(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf8");
+	return true;
+}
+const README_DESC_START = "<!-- holocron:description -->";
+const README_DESC_END = "<!-- /holocron:description -->";
+async function updateReadmeDescription(repoRoot, description) {
+	const readmePath = join(repoRoot, "README.md");
+	let content;
+	try {
+		content = await readFile(readmePath, "utf8");
+	} catch {
+		return false;
+	}
+	const lines = content.split("\n");
+	const startIdx = lines.findIndex((l) => l.trim() === README_DESC_START);
+	const endIdx = lines.findIndex((l) => l.trim() === README_DESC_END);
+	if (startIdx !== -1) {
+		if (endIdx === -1 || endIdx <= startIdx) return false;
+		lines.splice(startIdx + 1, endIdx - startIdx - 1, description);
+		await writeFile(readmePath, lines.join("\n"), "utf8");
+		return true;
+	}
+	const h1Index = lines.findIndex((l) => /^# /.test(l));
+	if (h1Index === -1) return false;
+	lines.splice(h1Index + 1, 0, "", README_DESC_START, description, README_DESC_END);
+	await writeFile(readmePath, lines.join("\n"), "utf8");
+	return true;
+}
 //#endregion
 //#region src/load-config.ts
 /**
@@ -4415,6 +4500,7 @@ function formatSyncStep(step) {
 * All three forms are validated through the same `resolveConfig` path.
 * Implements the lookup-order contract from issue #75 / #81.
 */
+const execFileAsync = promisify(execFile);
 const CANDIDATE_FILENAMES = [
 	"holocron.config.json",
 	"holocron.config.js",
@@ -4456,20 +4542,61 @@ async function loadJson(filepath) {
 	} catch (err) {
 		throw new ConfigError(`${filepath} is not valid JSON: ${err instanceof Error ? err.message : String(err)}`);
 	}
-	return resolveConfig(parsed);
+	return resolveConfig(await deriveDefaults(dirname(filepath), parsed));
 }
 async function loadJs(filepath) {
-	return extractAndResolve(filepath, await import(pathToFileURL(filepath).href));
+	const mod = await import(pathToFileURL(filepath).href);
+	return resolveConfig(await deriveDefaults(dirname(filepath), extractRaw(filepath, mod)));
 }
 async function loadTs(filepath) {
 	const { tsImport } = await import("tsx/esm/api");
-	return extractAndResolve(filepath, await tsImport(pathToFileURL(filepath).href, import.meta.url));
+	const mod = await tsImport(pathToFileURL(filepath).href, import.meta.url);
+	return resolveConfig(await deriveDefaults(dirname(filepath), extractRaw(filepath, mod)));
 }
-function extractAndResolve(filepath, mod) {
+function extractRaw(filepath, mod) {
 	const outer = mod.default;
 	const raw = outer?.__esModule === true ? outer.default : outer;
 	if (raw === void 0 || raw === null) throw new ConfigFileError(`${filepath} must have a default export (use \`export default defineConfig({…})\`)`);
-	return resolveConfig(raw);
+	return raw;
+}
+async function deriveDefaults(configDir, raw) {
+	const result = { ...raw };
+	if (!result.name) result.name = await readPackageJsonName(configDir) ?? basename(configDir);
+	if (result.repo && !result.repo.name) {
+		const repoName = await readGitRemote(configDir);
+		if (repoName) result.repo = {
+			...result.repo,
+			name: repoName
+		};
+	}
+	return result;
+}
+async function readPackageJsonName(dir) {
+	try {
+		const content = await readFile(join(dir, "package.json"), "utf8");
+		const pkg = JSON.parse(content);
+		return typeof pkg.name === "string" ? pkg.name.replace(/^@[^/]+\//, "") : void 0;
+	} catch {
+		return;
+	}
+}
+async function readGitRemote(dir) {
+	try {
+		const { stdout } = await execFileAsync("git", [
+			"remote",
+			"get-url",
+			"origin"
+		], { cwd: dir });
+		return parseGitRemoteUrl(stdout.trim());
+	} catch {
+		return;
+	}
+}
+function parseGitRemoteUrl(url) {
+	const httpsMatch = url.match(/github\.com\/([^/]+\/[^/]+?)(?:\.git)?$/);
+	if (httpsMatch) return httpsMatch[1];
+	const sshMatch = url.match(/github\.com:([^/]+\/[^/]+?)(?:\.git)?$/);
+	if (sshMatch) return sshMatch[1];
 }
 async function fileExists(path) {
 	try {

package/dist/index.d.mts

@@ -38,8 +38,8 @@ interface RepoProperties {
   uses_external_packages?: boolean;
 }
 interface RepoConfig {
-  /** "owner/name" — the GitHub repository coordinate. */
-  name: string;
+  /** "owner/name" — the GitHub repository coordinate. Derived from the git remote when absent. */
+  name?: string;
   /**
    * Branch protection preset applied by `holocron setup`. When omitted,
    * no protection is applied and no `branch_protection_level` property is set.
@@ -61,36 +61,35 @@ interface DoctorConfig {
   checks?: string[];
 }
 interface HolocronConfig {
-  project: {
+  /** Project name. Derived from package.json when absent. */
+  name?: string;
+  description?: string;
+  /**
+   * Repository identity and metadata. When set, `PluginLoader` injects
+   * `repo.name` into every plugin's `RuntimeContext.repo` so plugins that
+   * need a repo (github, etc.) don't require `--repo` on every invocation.
+   * `--repo` on the command line still overrides.
+   */
+  repo?: RepoConfig;
+  /**
+   * CI workflow names to install as thin wrappers during `holocron setup`.
+   * Each name maps to a reusable workflow in `theholocron/.github`.
+   * Use the object form to pass `with:` inputs to the reusable workflow.
+   *
+   * Supported values: "lint" | "test" | "typecheck" | "codeql" | "review" |
+   *   "release" | "stale" | "greetings" | "dependencies" | "bookkeeping-pr" | "audit"
+   *
+   * `holocron setup` writes `.github/workflows/<name>.yml` for each entry,
+   * calling the corresponding `ci-<name>.yml@main` reusable workflow.
+   * Files are overwritten on each run — they are generated artifacts.
+   *
+   * @example
+   * ["lint", { "name": "release", "with": { "run-build": false } }]
+   */
+  workflows?: Array<string | {
     name: string;
-    description?: string;
-    /**
-     * Repository identity and metadata. When set, `PluginLoader` injects
-     * `repo.name` into every plugin's `RuntimeContext.repo` so plugins that
-     * need a repo (github, etc.) don't require `--repo` on every invocation.
-     * `--repo` on the command line still overrides.
-     */
-    repo?: RepoConfig;
-    /**
-     * CI workflow names to install as thin wrappers during `holocron setup`.
-     * Each name maps to a reusable workflow in `theholocron/.github`.
-     * Use the object form to pass `with:` inputs to the reusable workflow.
-     *
-     * Supported values: "lint" | "test" | "typecheck" | "codeql" | "review" |
-     *   "release" | "stale" | "greetings" | "dependencies" | "bookkeeping-pr" | "audit"
-     *
-     * `holocron setup` writes `.github/workflows/<name>.yml` for each entry,
-     * calling the corresponding `ci-<name>.yml@main` reusable workflow.
-     * Files are overwritten on each run — they are generated artifacts.
-     *
-     * @example
-     * ["lint", { "name": "release", "with": { "run-build": false } }]
-     */
-    workflows?: Array<string | {
-      name: string;
-      with?: Record<string, unknown>;
-    }>;
-  };
+    with?: Record<string, unknown>;
+  }>;
   providers: RawProvidersConfig;
   apps?: AppConfig[];
   doctor?: DoctorConfig;
@@ -110,7 +109,13 @@ type ResolvedProviderEntry = {
 };
 type ResolvedProvidersConfig = Partial<Record<CapabilityKey, ResolvedProviderEntry>>;
 interface ResolvedHolocronConfig {
-  project: HolocronConfig["project"];
+  name: string;
+  description?: string;
+  repo?: RepoConfig;
+  workflows?: Array<string | {
+    name: string;
+    with?: Record<string, unknown>;
+  }>;
   providers: ResolvedProvidersConfig;
   apps: AppConfig[];
   doctor: DoctorConfig;

package/dist/index.mjs

@@ -1,9 +1,11 @@
 import { CARDINALITY, ProviderApiError, REQUIRED_CAPABILITIES, WebhookVerificationError, isMulti } from "./capabilities/index.mjs";
 import { AuthError, createResolveToken as createResolveToken$1, createRestClient } from "@theholocron/http-client";
 import { Entry, findCredentials } from "@napi-rs/keyring";
+import { execFile } from "node:child_process";
 import { readFile, stat } from "node:fs/promises";
-import { join } from "node:path";
+import { basename, dirname, join } from "node:path";
 import { pathToFileURL } from "node:url";
+import { promisify } from "node:util";
 //#region src/keyring.ts
 /**
 * Keyring-backed bootstrap credential store.
@@ -179,7 +181,7 @@ function resolveEntry(key, raw) {
 	};
 }
 function resolveConfig(raw) {
-	if (!raw.project?.name) throw new ConfigError("`project.name` is required");
+	if (!raw.name) throw new ConfigError("`name` is required");
 	if (!raw.providers || typeof raw.providers !== "object") throw new ConfigError("`providers` block is required");
 	const providers = {};
 	for (const [key, entry] of Object.entries(raw.providers)) {
@@ -188,7 +190,10 @@ function resolveConfig(raw) {
 	}
 	for (const required of REQUIRED_CAPABILITIES) if (!providers[required]) throw new ConfigError(`required capability \`${required}\` is missing from providers`);
 	return {
-		project: raw.project,
+		name: raw.name,
+		description: raw.description,
+		repo: raw.repo,
+		workflows: raw.workflows,
 		providers,
 		apps: raw.apps ?? [],
 		doctor: raw.doctor ?? {}
@@ -212,6 +217,7 @@ function defineConfig(config) {
 * All three forms are validated through the same `resolveConfig` path.
 * Implements the lookup-order contract from issue #75 / #81.
 */
+const execFileAsync = promisify(execFile);
 const CANDIDATE_FILENAMES = [
 	"holocron.config.json",
 	"holocron.config.js",
@@ -253,20 +259,61 @@ async function loadJson(filepath) {
 	} catch (err) {
 		throw new ConfigError(`${filepath} is not valid JSON: ${err instanceof Error ? err.message : String(err)}`);
 	}
-	return resolveConfig(parsed);
+	return resolveConfig(await deriveDefaults(dirname(filepath), parsed));
 }
 async function loadJs(filepath) {
-	return extractAndResolve(filepath, await import(pathToFileURL(filepath).href));
+	const mod = await import(pathToFileURL(filepath).href);
+	return resolveConfig(await deriveDefaults(dirname(filepath), extractRaw(filepath, mod)));
 }
 async function loadTs(filepath) {
 	const { tsImport } = await import("tsx/esm/api");
-	return extractAndResolve(filepath, await tsImport(pathToFileURL(filepath).href, import.meta.url));
+	const mod = await tsImport(pathToFileURL(filepath).href, import.meta.url);
+	return resolveConfig(await deriveDefaults(dirname(filepath), extractRaw(filepath, mod)));
 }
-function extractAndResolve(filepath, mod) {
+function extractRaw(filepath, mod) {
 	const outer = mod.default;
 	const raw = outer?.__esModule === true ? outer.default : outer;
 	if (raw === void 0 || raw === null) throw new ConfigFileError(`${filepath} must have a default export (use \`export default defineConfig({…})\`)`);
-	return resolveConfig(raw);
+	return raw;
+}
+async function deriveDefaults(configDir, raw) {
+	const result = { ...raw };
+	if (!result.name) result.name = await readPackageJsonName(configDir) ?? basename(configDir);
+	if (result.repo && !result.repo.name) {
+		const repoName = await readGitRemote(configDir);
+		if (repoName) result.repo = {
+			...result.repo,
+			name: repoName
+		};
+	}
+	return result;
+}
+async function readPackageJsonName(dir) {
+	try {
+		const content = await readFile(join(dir, "package.json"), "utf8");
+		const pkg = JSON.parse(content);
+		return typeof pkg.name === "string" ? pkg.name.replace(/^@[^/]+\//, "") : void 0;
+	} catch {
+		return;
+	}
+}
+async function readGitRemote(dir) {
+	try {
+		const { stdout } = await execFileAsync("git", [
+			"remote",
+			"get-url",
+			"origin"
+		], { cwd: dir });
+		return parseGitRemoteUrl(stdout.trim());
+	} catch {
+		return;
+	}
+}
+function parseGitRemoteUrl(url) {
+	const httpsMatch = url.match(/github\.com\/([^/]+\/[^/]+?)(?:\.git)?$/);
+	if (httpsMatch) return httpsMatch[1];
+	const sshMatch = url.match(/github\.com:([^/]+\/[^/]+?)(?:\.git)?$/);
+	if (sshMatch) return sshMatch[1];
 }
 async function fileExists(path) {
 	try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/cli",
-  "version": "2.0.0-alpha.55",
+  "version": "2.0.0-alpha.57",
   "description": "The Holocron CLI — a pluggable, capability-based orchestrator for spinning up and operating software projects.",
   "homepage": "https://github.com/theholocron/holocron/tree/main/packages/cli#readme",
   "bugs": "https://github.com/theholocron/holocron/issues",
@@ -34,15 +34,15 @@
   ],
   "dependencies": {
     "@napi-rs/keyring": "^1.3.0",
-    "@theholocron/github-client": "^0.7.0",
-    "@theholocron/http-client": "^0.7.0",
+    "@theholocron/github-client": "^0.11.3",
+    "@theholocron/http-client": "^0.11.3",
     "tsx": "^4.22.4",
     "yargs": "^18.0.0"
   },
   "devDependencies": {
-    "@theholocron/eslint-config": "^7.0.0",
-    "@theholocron/tsconfig": "^7.0.0",
-    "@theholocron/vitest-config": "^7.2.3",
+    "@theholocron/eslint-config": "^7.3.0",
+    "@theholocron/tsconfig": "^7.3.0",
+    "@theholocron/vitest-config": "^7.3.0",
     "@types/node": "^26",
     "@types/yargs": "^17.0.35",
     "@vitest/coverage-v8": "^4.1.10",