@sourcepress/cli 0.1.0

package/src/commands/stale.ts

@@ -0,0 +1,40 @@
+import type { ContentFile } from "@sourcepress/core";
+import type { EngineContext } from "@sourcepress/server";
+
+export async function stale(engine: EngineContext): Promise<void> {
+	console.log("Checking for stale content...\n");
+
+	const collections = engine.listCollections();
+	let staleCount = 0;
+
+	for (const name of collections) {
+		let files: ContentFile[];
+		try {
+			files = await engine.listContent(name);
+		} catch (err) {
+			console.error(`  ${name}: error — ${err instanceof Error ? err.message : String(err)}`);
+			continue;
+		}
+
+		for (const file of files) {
+			const generatedAt = file.frontmatter?.generated_at as string | undefined;
+			const staleSources = file.frontmatter?.stale_sources as string[] | undefined;
+
+			if (staleSources && staleSources.length > 0) {
+				console.log(`  [stale] ${file.path}`);
+				console.log(`    Stale sources: ${staleSources.join(", ")}`);
+				if (generatedAt) {
+					console.log(`    Generated at:  ${generatedAt}`);
+				}
+				staleCount++;
+			}
+		}
+	}
+
+	if (staleCount === 0) {
+		console.log("All content is up to date.");
+	} else {
+		console.log(`\n${staleCount} stale file${staleCount !== 1 ? "s" : ""} found.`);
+		console.log("Run `sourcepress eval --run` to regenerate stale content.");
+	}
+}

package/src/commands/status.ts

@@ -0,0 +1,37 @@
+import type { SourcePressConfig } from "@sourcepress/core";
+import type { EngineContext } from "@sourcepress/server";
+
+export async function status(engine: EngineContext, config: SourcePressConfig): Promise<void> {
+	console.log("SourcePress status\n");
+
+	console.log(`  Repository:  ${config.repository.owner}/${config.repository.repo}`);
+	console.log(`  Branch:      ${config.repository.branch}`);
+	console.log(`  AI provider: ${config.ai.provider} (${config.ai.model})`);
+	console.log(`  GitHub:      ${process.env.GITHUB_TOKEN ? "configured" : "MISSING"}`);
+	console.log(`  AI key:      ${process.env.AI_API_KEY ? "configured" : "not set"}`);
+
+	const collections = engine.listCollections();
+	console.log(
+		`  Collections: ${collections.length}${collections.length > 0 ? ` (${collections.join(", ")})` : ""}`,
+	);
+
+	// Knowledge graph summary
+	try {
+		const knowledgeFiles = await engine.knowledgeStore.list();
+		console.log(
+			`  Knowledge:   ${knowledgeFiles.length} file${knowledgeFiles.length !== 1 ? "s" : ""}`,
+		);
+	} catch {
+		console.log("  Knowledge:   unavailable");
+	}
+
+	// Cache info
+	const cacheBackend = config.cache?.backend ?? "memory";
+	console.log(`  Cache:       ${cacheBackend}`);
+
+	// Jobs
+	const jobsBackend = config.jobs?.backend ?? "in-process";
+	console.log(`  Jobs:        ${jobsBackend}`);
+
+	console.log("");
+}

package/src/commands/sync.ts

@@ -0,0 +1,28 @@
+import type { EngineContext } from "@sourcepress/server";
+
+export async function sync(engine: EngineContext): Promise<void> {
+	console.log("Syncing content from GitHub...\n");
+
+	const collections = engine.listCollections();
+
+	if (collections.length === 0) {
+		console.log("  No collections configured.");
+		console.log("\nSync complete.");
+		return;
+	}
+
+	let total = 0;
+	for (const name of collections) {
+		try {
+			const files = await engine.listContent(name);
+			console.log(`  ${name}: ${files.length} file${files.length !== 1 ? "s" : ""}`);
+			total += files.length;
+		} catch (err) {
+			console.error(`  ${name}: error — ${err instanceof Error ? err.message : String(err)}`);
+		}
+	}
+
+	console.log(
+		`\nSync complete. ${total} file${total !== 1 ? "s" : ""} across ${collections.length} collection${collections.length !== 1 ? "s" : ""}.`,
+	);
+}

package/src/config.ts

@@ -0,0 +1,47 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import { validateConfig } from "@sourcepress/core";
+import type { SourcePressConfig } from "@sourcepress/core";
+
+async function importTsFile(fullPath: string): Promise<unknown> {
+	const { tsImport } = await import("tsx/esm/api");
+	return tsImport(pathToFileURL(fullPath).href, import.meta.url);
+}
+
+export async function loadConfig(cwd: string): Promise<SourcePressConfig | null> {
+	const candidates = ["sourcepress.config.ts", "sourcepress.config.js"];
+	for (const name of candidates) {
+		const fullPath = join(cwd, name);
+		if (existsSync(fullPath)) {
+			let mod: unknown;
+			try {
+				if (name.endsWith(".ts")) {
+					mod = await importTsFile(fullPath);
+				} else {
+					mod = await import(pathToFileURL(fullPath).href);
+				}
+			} catch (err) {
+				throw new Error(
+					`Failed to load ${name}: ${err instanceof Error ? err.message : String(err)}`,
+				);
+			}
+			let raw =
+				mod != null && typeof mod === "object" && "default" in mod
+					? (mod as { default: unknown }).default
+					: mod;
+			// tsx wraps modules with an extra layer — unwrap if needed
+			if (raw != null && typeof raw === "object" && "default" in raw) {
+				raw = (raw as { default: unknown }).default;
+			}
+			const result = validateConfig(raw);
+			if (!result.success) {
+				throw new Error(
+					`Invalid sourcepress config in ${name}:\n${result.errors.map((e) => `  - ${e}`).join("\n")}`,
+				);
+			}
+			return result.data as SourcePressConfig;
+		}
+	}
+	return null;
+}

package/src/engine-boot.ts

@@ -0,0 +1,17 @@
+import type { SourcePressConfig } from "@sourcepress/core";
+import { createEngine } from "@sourcepress/server";
+import type { EngineContext } from "@sourcepress/server";
+
+export async function bootEngine(config: SourcePressConfig): Promise<EngineContext> {
+	const githubToken = process.env.GITHUB_TOKEN;
+	if (!githubToken) {
+		console.error("Error: GITHUB_TOKEN environment variable is required.");
+		console.error("Set it: export GITHUB_TOKEN=ghp_...");
+		process.exit(1);
+	}
+	return createEngine({
+		config,
+		githubToken,
+		aiApiKey: process.env.AI_API_KEY,
+	});
+}

package/src/index.ts

@@ -0,0 +1,146 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import type { SourcePressConfig } from "@sourcepress/core";
+import { build } from "./commands/build.js";
+import { dev } from "./commands/dev.js";
+import { evalCmd } from "./commands/eval.js";
+import { gaps } from "./commands/gaps.js";
+import { graph } from "./commands/graph.js";
+import { init } from "./commands/init.js";
+import { stale } from "./commands/stale.js";
+import { status } from "./commands/status.js";
+import { sync } from "./commands/sync.js";
+import { loadConfig } from "./config.js";
+import { bootEngine } from "./engine-boot.js";
+
+function loadEnvFile(dir: string): void {
+	const envPath = join(dir, ".env");
+	if (!existsSync(envPath)) return;
+
+	const content = readFileSync(envPath, "utf-8");
+	for (const line of content.split("\n")) {
+		const trimmed = line.trim();
+		if (!trimmed || trimmed.startsWith("#")) continue;
+		const eqIndex = trimmed.indexOf("=");
+		if (eqIndex === -1) continue;
+		const key = trimmed.slice(0, eqIndex).trim();
+		let value = trimmed.slice(eqIndex + 1).trim();
+		if (
+			(value.startsWith('"') && value.endsWith('"')) ||
+			(value.startsWith("'") && value.endsWith("'"))
+		) {
+			value = value.slice(1, -1);
+		}
+		if (!(key in process.env)) {
+			process.env[key] = value;
+		}
+	}
+}
+
+const COMMANDS_NEEDING_CONFIG = [
+	"dev",
+	"build",
+	"sync",
+	"graph",
+	"stale",
+	"eval",
+	"status",
+	"gaps",
+];
+
+function printHelp(): void {
+	console.log("sourcepress — Open source Content Engine with knowledge graph\n");
+	console.log("Commands:");
+	console.log("  init      Initialize a new SourcePress project");
+	console.log("  dev       Start the Content Engine server");
+	console.log("  build     Sync content + build site");
+	console.log("  sync      Sync content from GitHub");
+	console.log("  graph     Show/rebuild knowledge graph");
+	console.log("  stale     List stale content");
+	console.log("  eval      Run evals");
+	console.log("  status    Health check");
+	console.log("  gaps      List knowledge gaps");
+	console.log("\nOptions:");
+	console.log("  --help    Show this help");
+	console.log("  --version Show version");
+}
+
+function printVersion(): void {
+	console.log("0.1.0");
+}
+
+async function main(): Promise<void> {
+	loadEnvFile(process.cwd());
+	const args = process.argv.slice(2);
+	const command = args[0];
+
+	if (command === "init") {
+		init(process.cwd());
+		return;
+	}
+
+	if (!command || command === "--help") {
+		printHelp();
+		return;
+	}
+
+	if (command === "--version") {
+		printVersion();
+		return;
+	}
+
+	if (COMMANDS_NEEDING_CONFIG.includes(command)) {
+		let config: SourcePressConfig | null;
+		try {
+			config = await loadConfig(process.cwd());
+		} catch (err) {
+			console.error(err instanceof Error ? err.message : String(err));
+			process.exit(1);
+		}
+
+		if (!config) {
+			console.error("No sourcepress.config.ts found. Run `sourcepress init` first.");
+			process.exit(1);
+		}
+
+		const engine = await bootEngine(config);
+
+		// Command dispatch
+		switch (command) {
+			case "dev":
+				await dev(engine, args.slice(1));
+				break;
+			case "build":
+				await build(engine, process.cwd());
+				break;
+			case "sync":
+				await sync(engine);
+				break;
+			case "graph":
+				await graph(engine, args.slice(1));
+				break;
+			case "stale":
+				await stale(engine);
+				break;
+			case "eval":
+				await evalCmd(engine, args.slice(1));
+				break;
+			case "status":
+				await status(engine, config);
+				break;
+			case "gaps":
+				await gaps(engine);
+				break;
+		}
+		return;
+	}
+
+	console.error(`Unknown command: ${command}`);
+	console.error("Run `sourcepress --help` for usage.");
+	process.exit(1);
+}
+
+main().catch((err: unknown) => {
+	console.error(err instanceof Error ? err.message : String(err));
+	process.exit(1);
+});

package/tsconfig.json

@@ -0,0 +1,5 @@
+{
+	"extends": "../../tsconfig.json",
+	"compilerOptions": { "outDir": "dist", "rootDir": "src", "types": ["node"] },
+	"include": ["src"]
+}