@kkmila/cpc 1.0.0

package/src/lib/agents.mjs

@@ -0,0 +1,36 @@
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import yaml from "js-yaml";
+import { expandHome } from "./fs.mjs";
+
+/**
+ * Load and parse registry.yaml.
+ */
+export function loadRegistry(repoRoot) {
+	const raw = readFileSync(resolve(repoRoot, "registry.yaml"), "utf8");
+	return yaml.load(raw);
+}
+
+/**
+ * Get all agent definitions from registry.
+ */
+export function getAgents(registry) {
+	return registry.agents || {};
+}
+
+/**
+ * Get a single agent definition.
+ */
+export function getAgent(registry, agentId) {
+	return registry.agents?.[agentId] || null;
+}
+
+/**
+ * Resolve ~ paths in agent definition.
+ */
+export function resolveAgentPaths(agent) {
+	return {
+		...agent,
+		home: expandHome(agent.home),
+	};
+}

package/src/lib/fs.mjs

@@ -0,0 +1,75 @@
+import { homedir } from "node:os";
+import {
+	existsSync,
+	mkdirSync,
+	readlinkSync,
+	lstatSync,
+	unlinkSync,
+	symlinkSync,
+	writeFileSync,
+	readFileSync,
+	readdirSync,
+	statSync,
+} from "node:fs";
+import { join } from "node:path";
+
+/**
+ * Expand ~ to the user's home directory.
+ */
+export function expandHome(p) {
+	if (!p) return p;
+	return p.replace(/^~/, homedir());
+}
+
+/**
+ * Ensure a directory exists (mkdir -p).
+ */
+export function ensureDir(dir) {
+	if (!existsSync(dir)) {
+		mkdirSync(dir, { recursive: true });
+	}
+}
+
+/**
+ * Check if a path exists as a symlink (even if target is broken).
+ * Unlike existsSync, this does NOT follow the symlink.
+ */
+function symlinkExists(p) {
+	try {
+		return lstatSync(p).isSymbolicLink();
+	} catch {
+		return false;
+	}
+}
+
+/**
+ * Create a symlink. Returns: 'already-linked' | 'replaced' | 'conflict' | 'created'
+ */
+export function ensureSymlink(src, dst) {
+	if (symlinkExists(dst)) {
+		const current = readlinkSync(dst);
+		if (current === src) return "already-linked";
+		// Stale or different target — replace
+		unlinkSync(dst);
+		symlinkSync(src, dst);
+		return "replaced";
+	}
+	if (existsSync(dst)) {
+		// Real file/dir exists — refuse to overwrite
+		return "conflict";
+	}
+	symlinkSync(src, dst);
+	return "created";
+}
+
+/**
+ * Remove a symlink. Returns: 'removed' | 'not-found' | 'not-symlink'
+ */
+export function removeSymlink(dst) {
+	if (!symlinkExists(dst)) {
+		if (existsSync(dst)) return "not-symlink";
+		return "not-found";
+	}
+	unlinkSync(dst);
+	return "removed";
+}

package/src/lib/repo.mjs

@@ -0,0 +1,13 @@
+import { realpathSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+/**
+ * Resolve the custom-provider-cli repo root from the CLI script location.
+ * Handles symlinked installations (npm link, /usr/local/bin, ~/.local/bin).
+ */
+export function resolveRepoRoot() {
+	const scriptDir = dirname(fileURLToPath(import.meta.url));
+	// cli/src/lib/ → repo root is 3 levels up (lib → src → cli → root)
+	return resolve(scriptDir, "..", "..", "..");
+}