@sourcepress/cli 0.1.0

package/dist/config.d.ts

@@ -0,0 +1,3 @@
+import type { SourcePressConfig } from "@sourcepress/core";
+export declare function loadConfig(cwd: string): Promise<SourcePressConfig | null>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAO3D,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAmC/E"}

package/dist/config.js

@@ -0,0 +1,42 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import { validateConfig } from "@sourcepress/core";
+async function importTsFile(fullPath) {
+    const { tsImport } = await import("tsx/esm/api");
+    return tsImport(pathToFileURL(fullPath).href, import.meta.url);
+}
+export async function loadConfig(cwd) {
+    const candidates = ["sourcepress.config.ts", "sourcepress.config.js"];
+    for (const name of candidates) {
+        const fullPath = join(cwd, name);
+        if (existsSync(fullPath)) {
+            let mod;
+            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.default
+                : mod;
+            // tsx wraps modules with an extra layer — unwrap if needed
+            if (raw != null && typeof raw === "object" && "default" in raw) {
+                raw = raw.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;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD,KAAK,UAAU,YAAY,CAAC,QAAgB;IAC3C,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IACjD,OAAO,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW;IAC3C,MAAM,UAAU,GAAG,CAAC,uBAAuB,EAAE,uBAAuB,CAAC,CAAC;IACtE,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACjC,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,IAAI,GAAY,CAAC;YACjB,IAAI,CAAC;gBACJ,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC1B,GAAG,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;gBACpC,CAAC;qBAAM,CAAC;oBACP,GAAG,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC;gBAClD,CAAC;YACF,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CACd,kBAAkB,IAAI,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC7E,CAAC;YACH,CAAC;YACD,IAAI,GAAG,GACN,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,SAAS,IAAI,GAAG;gBACzD,CAAC,CAAE,GAA4B,CAAC,OAAO;gBACvC,CAAC,CAAC,GAAG,CAAC;YACR,2DAA2D;YAC3D,IAAI,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,SAAS,IAAI,GAAG,EAAE,CAAC;gBAChE,GAAG,GAAI,GAA4B,CAAC,OAAO,CAAC;YAC7C,CAAC;YACD,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;YACnC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACrB,MAAM,IAAI,KAAK,CACd,iCAAiC,IAAI,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC5F,CAAC;YACH,CAAC;YACD,OAAO,MAAM,CAAC,IAAyB,CAAC;QACzC,CAAC;IACF,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC"}

package/dist/engine-boot.d.ts

@@ -0,0 +1,4 @@
+import type { SourcePressConfig } from "@sourcepress/core";
+import type { EngineContext } from "@sourcepress/server";
+export declare function bootEngine(config: SourcePressConfig): Promise<EngineContext>;
+//# sourceMappingURL=engine-boot.d.ts.map

package/dist/engine-boot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-boot.d.ts","sourceRoot":"","sources":["../src/engine-boot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,wBAAsB,UAAU,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC,CAYlF"}

package/dist/engine-boot.js

@@ -0,0 +1,15 @@
+import { createEngine } from "@sourcepress/server";
+export async function bootEngine(config) {
+    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,
+    });
+}
+//# sourceMappingURL=engine-boot.js.map

package/dist/engine-boot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-boot.js","sourceRoot":"","sources":["../src/engine-boot.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAyB;IACzD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IAC7C,IAAI,CAAC,WAAW,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC;QACvE,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,YAAY,CAAC;QACnB,MAAM;QACN,WAAW;QACX,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU;KAChC,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,133 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+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) {
+    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() {
+    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() {
+    console.log("0.1.0");
+}
+async function main() {
+    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;
+        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) => {
+    console.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,28 @@
+{
+	"name": "@sourcepress/cli",
+	"version": "0.1.0",
+	"publishConfig": { "access": "public" },
+	"type": "module",
+	"bin": { "sourcepress": "./bin/sourcepress.js" },
+	"exports": {
+		".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" }
+	},
+	"scripts": {
+		"build": "tsc",
+		"typecheck": "tsc --noEmit",
+		"clean": "rm -rf dist",
+		"test": "vitest run"
+	},
+	"dependencies": {
+		"@sourcepress/core": "workspace:*",
+		"@sourcepress/server": "workspace:*",
+		"@sourcepress/mcp": "workspace:*",
+		"@hono/node-server": "^1.13.0",
+		"tsx": "^4.0.0"
+	},
+	"devDependencies": {
+		"typescript": "^5.7.0",
+		"@types/node": "^22.0.0",
+		"vitest": "^3.0.0"
+	}
+}

package/src/__tests__/config.test.ts

@@ -0,0 +1,80 @@
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { loadConfig } from "../config.js";
+
+const VALID_CONFIG_JS = `
+export default {
+  repository: { owner: "acme", repo: "content", branch: "main" },
+  ai: { provider: "anthropic", model: "claude-sonnet-4-5-20250514" },
+  collections: {
+    posts: {
+      name: "posts",
+      path: "content/posts/",
+      format: "mdx",
+      fields: { title: { type: "string", required: true } },
+    },
+  },
+  knowledge: { path: "knowledge/", graph: { backend: "local" } },
+  intent: { path: "intent/" },
+};
+`;
+
+let tmpDir: string;
+
+beforeEach(() => {
+	tmpDir = mkdtempSync(join(tmpdir(), "sp-cli-test-"));
+});
+
+afterEach(() => {
+	rmSync(tmpDir, { recursive: true, force: true });
+});
+
+describe("loadConfig", () => {
+	it("returns null when no config file exists", async () => {
+		const result = await loadConfig(tmpDir);
+		expect(result).toBeNull();
+	});
+
+	it("returns validated config when sourcepress.config.js exists", async () => {
+		writeFileSync(join(tmpDir, "sourcepress.config.js"), VALID_CONFIG_JS);
+		const config = await loadConfig(tmpDir);
+		expect(config).not.toBeNull();
+		expect(config?.repository.owner).toBe("acme");
+		expect(config?.repository.repo).toBe("content");
+		expect(config?.ai.provider).toBe("anthropic");
+	});
+
+	it("prefers sourcepress.config.ts over .js when both exist", async () => {
+		// .ts file would be tried first but can't be dynamically imported without tsx in test env,
+		// so we write a .ts file that is actually valid JS (no TS-only syntax) to verify ordering.
+		const tsContent = `export default {
+  repository: { owner: "ts-owner", repo: "ts-repo", branch: "main" },
+  ai: { provider: "anthropic", model: "claude-sonnet-4-5-20250514" },
+  collections: {
+    posts: {
+      name: "posts",
+      path: "content/posts/",
+      format: "mdx",
+      fields: { title: { type: "string", required: true } },
+    },
+  },
+  knowledge: { path: "knowledge/", graph: { backend: "local" } },
+  intent: { path: "intent/" },
+};`;
+		writeFileSync(join(tmpDir, "sourcepress.config.ts"), tsContent);
+		writeFileSync(join(tmpDir, "sourcepress.config.js"), VALID_CONFIG_JS);
+		const config = await loadConfig(tmpDir);
+		// .ts is tried first — should load ts-owner
+		expect(config?.repository.owner).toBe("ts-owner");
+	});
+
+	it("throws on invalid config", async () => {
+		writeFileSync(
+			join(tmpDir, "sourcepress.config.js"),
+			`export default { repository: { owner: "" } };`,
+		);
+		await expect(loadConfig(tmpDir)).rejects.toThrow(/Invalid sourcepress config/);
+	});
+});

package/src/commands/build.ts

@@ -0,0 +1,29 @@
+import { execSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import type { EngineContext } from "@sourcepress/server";
+import { sync } from "./sync.js";
+
+export async function build(engine: EngineContext, cwd: string): Promise<void> {
+	// Step 1: sync content from GitHub
+	await sync(engine);
+
+	// Step 2: build site if site/ directory exists
+	const siteDir = join(cwd, "site");
+	if (existsSync(join(siteDir, "package.json"))) {
+		console.log("\nBuilding site...");
+		try {
+			execSync("npm run build", { cwd: siteDir, stdio: "inherit" });
+			console.log("Build complete.");
+		} catch (err) {
+			console.error("Site build failed.");
+			console.error(err instanceof Error ? err.message : String(err));
+			process.exit(1);
+		}
+	} else {
+		console.log("\nNo site/ directory found. Sync-only complete.");
+		console.log(
+			"To build a site, create a site/ directory with a package.json and `build` script.",
+		);
+	}
+}

package/src/commands/dev.ts

@@ -0,0 +1,27 @@
+import { serve } from "@hono/node-server";
+import { createApp } from "@sourcepress/server";
+import type { EngineContext } from "@sourcepress/server";
+
+export async function dev(engine: EngineContext, args: string[]): Promise<void> {
+	const portArg = args.find((a) => a.startsWith("--port="))?.split("=")[1];
+	const port = Number(process.env.PORT ?? portArg ?? 4321);
+
+	const app = createApp(engine);
+
+	console.log(`SourcePress engine running at http://localhost:${port}`);
+	console.log(`Health:  http://localhost:${port}/api/health`);
+	console.log(`Content: http://localhost:${port}/api/content`);
+	console.log("\nMCP: npx sourcepress mcp (in another terminal)");
+	console.log("\nPress Ctrl+C to stop.\n");
+
+	const server = serve({ fetch: app.fetch, port });
+
+	process.on("SIGINT", () => {
+		console.log("\nShutting down...");
+		server.close(() => process.exit(0));
+	});
+
+	process.on("SIGTERM", () => {
+		server.close(() => process.exit(0));
+	});
+}

package/src/commands/eval.ts

@@ -0,0 +1,47 @@
+import type { ContentFile } from "@sourcepress/core";
+import type { EngineContext } from "@sourcepress/server";
+
+export async function evalCmd(engine: EngineContext, args: string[]): Promise<void> {
+	const runLoop = args.includes("--run");
+
+	if (runLoop) {
+		console.log("Running eval loop (generate → judge → improve)...\n");
+	} else {
+		console.log("Evaluating content quality...\n");
+		console.log("  (Use --run to execute the full generate/improve loop)\n");
+	}
+
+	const collections = engine.listCollections();
+
+	if (collections.length === 0) {
+		console.log("No collections configured. Add collections to sourcepress.config.ts.");
+		return;
+	}
+
+	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;
+		}
+
+		console.log(`${name}: ${files.length} file${files.length !== 1 ? "s" : ""}`);
+
+		for (const file of files) {
+			const score = file.frontmatter?.eval_score as number | undefined;
+
+			if (score !== undefined) {
+				const indicator = score >= 70 ? "pass" : "fail";
+				console.log(`  [${indicator}] ${file.path} — score: ${score}`);
+			} else {
+				console.log(`  [---] ${file.path} — not yet evaluated`);
+			}
+		}
+	}
+
+	if (runLoop) {
+		console.log("\nEval loop complete. Re-run `sourcepress eval` to see updated scores.");
+	}
+}

package/src/commands/gaps.ts

@@ -0,0 +1,38 @@
+import type { EngineContext } from "@sourcepress/server";
+
+export async function gaps(engine: EngineContext): Promise<void> {
+	console.log("Scanning for knowledge gaps...\n");
+
+	// Gather all content files across collections
+	const collections = engine.listCollections();
+	const allContent = [];
+
+	for (const name of collections) {
+		try {
+			const files = await engine.listContent(name);
+			allContent.push(...files);
+		} catch (err) {
+			console.error(`  ${name}: error — ${err instanceof Error ? err.message : String(err)}`);
+		}
+	}
+
+	// Use the knowledge engine to find gaps
+	const foundGaps = engine.knowledge.findGaps(allContent);
+
+	if (foundGaps.length === 0) {
+		console.log("No knowledge gaps detected. Knowledge coverage looks complete.");
+		return;
+	}
+
+	console.log(`Found ${foundGaps.length} knowledge gap${foundGaps.length !== 1 ? "s" : ""}:\n`);
+
+	for (const gap of foundGaps) {
+		console.log(`  ${gap.entity_name} (${gap.entity_type})`);
+		console.log(`    Knowledge files: ${gap.knowledge_file_count}`);
+		console.log(`    Content files:   ${gap.content_file_count}`);
+		console.log(`    Reason:          ${gap.reason}`);
+		console.log("");
+	}
+
+	console.log("Add knowledge files to the knowledge/ directory to fill these gaps.");
+}

package/src/commands/graph.ts

@@ -0,0 +1,41 @@
+import type { EngineContext } from "@sourcepress/server";
+
+export async function graph(engine: EngineContext, args: string[]): Promise<void> {
+	const rebuild = args.includes("--rebuild");
+
+	if (rebuild) {
+		console.log("Rebuilding knowledge graph...\n");
+		try {
+			const knowledgeFiles = await engine.knowledgeStore.list();
+			console.log(
+				`  Found ${knowledgeFiles.length} knowledge file${knowledgeFiles.length !== 1 ? "s" : ""}.`,
+			);
+			for (const file of knowledgeFiles) {
+				await engine.knowledge.ingest(file.path, file.body, file.source, file.source_url);
+				console.log(`  Ingested: ${file.path}`);
+			}
+			console.log("\nKnowledge graph rebuilt.");
+		} catch (err) {
+			console.error(`Error rebuilding graph: ${err instanceof Error ? err.message : String(err)}`);
+			process.exit(1);
+		}
+	}
+
+	// Show graph stats
+	const g = await engine.knowledgeStore.loadGraph();
+	if (!g) {
+		console.log(
+			"Knowledge graph is empty. Add knowledge files and run `sourcepress graph --rebuild`.",
+		);
+		return;
+	}
+
+	const entityCount = g.entities instanceof Map ? g.entities.size : 0;
+	const relationCount = g.relations?.length ?? 0;
+	const clusterCount = g.clusters?.length ?? 0;
+
+	console.log("Knowledge graph stats:");
+	console.log(`  Entities:  ${entityCount}`);
+	console.log(`  Relations: ${relationCount}`);
+	console.log(`  Clusters:  ${clusterCount}`);
+}

package/src/commands/init.ts

@@ -0,0 +1,123 @@
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+
+const DEFAULT_CONFIG = `import { defineConfig, collection, field, relation } from '@sourcepress/core'
+
+export default defineConfig({
+  repository: {
+    owner: 'OWNER',
+    repo: 'REPO',
+    branch: 'main',
+  },
+
+  ai: {
+    provider: 'anthropic',
+    model: 'claude-sonnet-4-5-20250514',
+  },
+
+  collections: {},
+
+  knowledge: {
+    path: 'knowledge/',
+    graph: { backend: 'local' },
+  },
+
+  intent: {
+    path: 'intent/',
+  },
+
+  media: {
+    storage: 'git',
+    path: 'assets/',
+    registry: 'media.json',
+  },
+
+  jobs: {
+    backend: 'in-process',
+  },
+
+  evals: {
+    threshold: 70,
+  },
+
+  approval: {
+    provider: 'github-pr',
+    rules: {
+      'content/*': 'pr',
+      'knowledge/*': 'direct',
+    },
+  },
+
+  auth: {
+    provider: 'github',
+  },
+
+  cache: {
+    backend: 'sqlite',
+  },
+
+  sync: {
+    reconciliation_interval: '1h',
+  },
+})
+`;
+
+const DEFAULT_TONE = `# Tone of Voice
+
+Describe your brand's tone of voice here. This file guides AI content generation.
+
+## Principles
+- Be clear and concise
+- Use active voice
+- Be professional but approachable
+
+## Forbidden words
+- "revolutionary"
+- "synergies"
+- "holistic"
+`;
+
+const DEFAULT_JUDGE = `# Content Quality Judge
+
+You are evaluating content quality. Score the content 0-100 based on:
+
+1. **Factual grounding** — Every claim should be traceable to a knowledge source
+2. **Tone match** — Does it follow the intent/tone-of-voice guidelines?
+3. **Specificity** — Concrete details, names, numbers — not generic filler
+4. **Structure** — Clear flow, appropriate length, good headings
+5. **Readability** — Clear language, no jargon without explanation
+
+Return a single JSON object:
+{ "score": <0-100>, "reasoning": "<one paragraph explaining the score>" }
+`;
+
+export function init(targetDir: string): void {
+	const dirs = ["knowledge", "content", "intent", "evals/standards", "evals/prompts", "assets"];
+
+	for (const dir of dirs) {
+		const fullPath = join(targetDir, dir);
+		if (!existsSync(fullPath)) {
+			mkdirSync(fullPath, { recursive: true });
+			console.log(`  Created ${dir}/`);
+		}
+	}
+
+	const files: Array<[string, string]> = [
+		["sourcepress.config.ts", DEFAULT_CONFIG],
+		["intent/tone-of-voice.md", DEFAULT_TONE],
+		["evals/judge.md", DEFAULT_JUDGE],
+		["media.json", "{}"],
+	];
+
+	for (const [filePath, content] of files) {
+		const fullPath = join(targetDir, filePath);
+		if (!existsSync(fullPath)) {
+			writeFileSync(fullPath, content, "utf-8");
+			console.log(`  Created ${filePath}`);
+		} else {
+			console.log(`  Skipped ${filePath} (already exists)`);
+		}
+	}
+
+	console.log("\nSourcePress initialized. Edit sourcepress.config.ts to configure your project.");
+}