@lemoncode/lemony 0.1.1-alpha.0 → 0.1.1-alpha.2

package/dist/cli.mjs

@@ -5,7 +5,7 @@ import { delimiter, dirname, extname, join, relative, resolve, sep } from "node:
 import { argv, cwd, env, exit, stderr, stdin, stdout } from "node:process";
 import { createInterface } from "node:readline/promises";
 import { promisify } from "node:util";
-import { parse, parseDocument } from "yaml";
+import { isMap, parse, parseDocument } from "yaml";
 import { z } from "zod";
 import { createHash, randomBytes } from "node:crypto";
 import { constants } from "node:fs";
@@ -17,27 +17,20 @@ const appendEvent = async (eventsPath, event) => {
 //#endregion
 //#region src/config/config.constant.ts
 const HARNESS_CONFIG_FILENAME = "harness.config.yml";
-const DEPRECATED_CONFIG_KEYS = ["profile"];
+const DEPRECATED_CONFIG_KEYS = ["profile", "agents"];
+const DEPRECATED_PATHS_KEYS = [
+	"state",
+	"skills",
+	"agents"
+];
 const HARNESS_CONFIG_SCHEMA_FILENAME = "harness.config.schema.json";
 const TASK_STORAGE_REPO_PLACEHOLDER = "OWNER/REPO";
 const TARGETS = ["claude-code"];
 const TASK_STORAGE_TYPES = ["github"];
 const TASK_STORAGE_REPO_PATTERN = /^[^\s/]+\/[^\s/]+$/;
-const AGENTS = [
-	"orchestrator",
-	"spec-author",
-	"implementer",
-	"reviewer",
-	"architect",
-	"ui-designer"
-];
-const REQUIRED_AGENT = "orchestrator";
 const VENDOR_VERSION_REGEX = /^\d+\.\d+\.\d+(-(alpha|beta|rc)\.\d+)?$/;
 const VENDOR_VERSION_EXAMPLE = "0.1.0-alpha.0";
 const PATHS_DEFAULTS = {
-	state: ".claude/state",
-	skills: ".claude/skills",
-	agents: ".claude/agents",
 	playbooks: "docs/playbooks",
 	playbooks_global: "~/.claude/playbooks"
 };
@@ -106,9 +99,6 @@ const levenshtein = (a, b) => {
 //#endregion
 //#region src/config/config.schema.ts
 const pathsSchema = z.object({
-	state: z.string().default(PATHS_DEFAULTS.state),
-	skills: z.string().default(PATHS_DEFAULTS.skills),
-	agents: z.string().default(PATHS_DEFAULTS.agents),
 	playbooks: z.string().default(PATHS_DEFAULTS.playbooks),
 	playbooks_global: z.string().default(PATHS_DEFAULTS.playbooks_global)
 }).strict().prefault({});
@@ -123,7 +113,6 @@ const harnessConfigSchema = z.object({
 	vendor_version: z.string().regex(VENDOR_VERSION_REGEX),
 	target: z.enum(TARGETS),
 	task_storage: taskStorageSchema,
-	agents: z.array(z.enum(AGENTS)).refine((agents) => agents.includes(REQUIRED_AGENT), { error: `agents must include "${REQUIRED_AGENT}" (the orchestrator is the hat).` }),
 	paths: pathsSchema,
 	rollback: rollbackSchema,
 	telemetry: telemetrySchema,
@@ -149,6 +138,12 @@ const readHarnessConfig = async (repoRoot) => {
 	if (!parsed || typeof parsed !== "object") throw new Error(`${HARNESS_CONFIG_FILENAME} is empty or malformed.`);
 	const candidate = { ...parsed };
 	for (const key of DEPRECATED_CONFIG_KEYS) delete candidate[key];
+	const paths = candidate.paths;
+	if (paths && typeof paths === "object" && !Array.isArray(paths)) {
+		const pathsCandidate = { ...paths };
+		for (const key of DEPRECATED_PATHS_KEYS) delete pathsCandidate[key];
+		candidate.paths = pathsCandidate;
+	}
 	const result = harnessConfigSchema.safeParse(candidate);
 	if (!result.success) throw new Error(`${HARNESS_CONFIG_FILENAME} is invalid:\n${formatConfigError(harnessConfigSchema, result.error)}`);
 	return result.data;
@@ -204,6 +199,9 @@ const setConfigValues = (rawYaml, updates) => {
 	const doc = parseDocument(rawYaml);
 	for (const [key, value] of Object.entries(updates)) if (doc.has(key)) doc.set(key, value);
 	for (const key of DEPRECATED_CONFIG_KEYS) if (doc.has(key)) doc.delete(key);
+	for (const key of DEPRECATED_PATHS_KEYS) if (doc.hasIn(["paths", key])) doc.deleteIn(["paths", key]);
+	const pathsNode = doc.get("paths", true);
+	if (isMap(pathsNode) && pathsNode.items.length === 0) doc.delete("paths");
 	return doc.toString();
 };
 const writeConfigValues = async (repoRoot, updates) => {
@@ -226,6 +224,19 @@ const pointerFrontmatterSchema = z.object({
 });
 Object.keys(pointerFrontmatterSchema.shape);
 //#endregion
+//#region src/paths/claude-paths.constant.ts
+const CLAUDE_DIR = ".claude";
+const STATE_DIR = join(CLAUDE_DIR, "state");
+const SKILLS_DIR = join(CLAUDE_DIR, "skills");
+const AGENTS_DIR = join(CLAUDE_DIR, "agents");
+const HOOKS_DIR = join(CLAUDE_DIR, "hooks");
+const COMMANDS_DIR = join(CLAUDE_DIR, "commands");
+const SETTINGS_FILE = join(CLAUDE_DIR, "settings.json");
+const HARNESS_DIR = join(CLAUDE_DIR, ".harness");
+const BASELINE_ROOT_REL = join(HARNESS_DIR, "baseline");
+const SNAPSHOTS_ROOT_REL = join(HARNESS_DIR, "snapshots");
+const EVENTS_RELPATH = join(STATE_DIR, "events.jsonl");
+//#endregion
 //#region src/events/envelope.ts
 const buildEnvelope = (input) => {
 	const ts = (input.now ?? /* @__PURE__ */ new Date()).toISOString();
@@ -399,7 +410,6 @@ const NUMERIC_FIELDS = /* @__PURE__ */ new Set([
 	"review_iterations"
 ]);
 const BOOLEAN_FIELDS = /* @__PURE__ */ new Set(["auto_close"]);
-const EVENTS_RELPATH$1 = join(".claude", "state", "events.jsonl");
 const isEventType = (value) => EVENT_TYPES.includes(value);
 const coerceField = (key, raw) => {
 	if (NUMERIC_FIELDS.has(key)) {
@@ -454,7 +464,7 @@ const runEmit = async (options) => {
 		const issues = parsed.error.issues.map((issue) => `  - ${issue.path.join(".") || "(root)"}: ${issue.message}`).join("\n");
 		throw new Error(`Event validation failed for type "${rawType}":\n${issues}`);
 	}
-	const eventsPath = join(repoRoot, EVENTS_RELPATH$1);
+	const eventsPath = join(repoRoot, EVENTS_RELPATH);
 	await appendEvent(eventsPath, parsed.data);
 	return {
 		event: parsed.data,
@@ -2221,9 +2231,8 @@ const sanitizeLine = (raw, tier) => {
 };
 //#endregion
 //#region src/telemetry/telemetry.constant.ts
-const EVENTS_RELPATH = join(".claude", "state", "events.jsonl");
-const CURSOR_RELPATH = join(".claude", "state", "telemetry-cursor.json");
-const REJECTED_RELPATH = join(".claude", "state", "telemetry-rejected.jsonl");
+const CURSOR_RELPATH = join(STATE_DIR, "telemetry-cursor.json");
+const REJECTED_RELPATH = join(STATE_DIR, "telemetry-rejected.jsonl");
 const PAYLOAD_CAP_BYTES = 1e6;
 const DEFAULT_TIMEOUT_MS = 3e3;
 const PRUNE_THRESHOLD_BYTES = 5e6;
@@ -2285,7 +2294,7 @@ const chunkTail = (rawTail, tier, capBytes = PAYLOAD_CAP_BYTES) => {
 };
 //#endregion
 //#region src/telemetry/consent.constant.ts
-const CONSENT_RELPATH = join(".claude", "state", "telemetry-consent.json");
+const CONSENT_RELPATH = join(STATE_DIR, "telemetry-consent.json");
 const ENV_DISABLE_VALUES = [
 	"1",
 	"true",
@@ -2681,7 +2690,7 @@ const formatTelemetryShow = (report) => {
 };
 //#endregion
 //#region src/telemetry/telemetry-notice.constant.ts
-const NOTICE_SENTINEL_RELPATH = join(".claude", "state", ".telemetry-notice-shown");
+const NOTICE_SENTINEL_RELPATH = join(STATE_DIR, ".telemetry-notice-shown");
 const NOTICE_MESSAGE = "Anonymous telemetry is ON — run `lemony telemetry disable` to opt out. See PRIVACY.md.";
 //#endregion
 //#region src/telemetry/telemetry-notice.ts
@@ -3071,7 +3080,7 @@ const checkLabels = async (deps, config) => {
 };
 const checkHooks = async (repoRoot) => {
 	const name = "hooks";
-	const settingsPath = join(repoRoot, ".claude", "settings.json");
+	const settingsPath = join(repoRoot, SETTINGS_FILE);
 	let raw;
 	try {
 		raw = await readFile(settingsPath, "utf8");
@@ -3327,7 +3336,7 @@ const readPointer = async (repoRoot, readGitUserEmail) => {
 	if (!email) return empty;
 	const slug = email.split("@")[0] ?? "";
 	if (!slug || slug.includes("/") || slug.includes("\\") || slug.includes("..")) return empty;
-	const pointerPath = join(repoRoot, ".claude", "state", `current-${slug}.md`);
+	const pointerPath = join(repoRoot, STATE_DIR, `current-${slug}.md`);
 	let raw;
 	try {
 		raw = await readFile(pointerPath, "utf8");
@@ -3460,7 +3469,6 @@ const renderTemplate = (template, vars) => template.replace(PLACEHOLDER, (_match
 });
 //#endregion
 //#region src/baseline/baseline.ts
-const BASELINE_ROOT_REL = join(".claude", ".harness", "baseline");
 const STAGING_DIR$1 = ".staging";
 const isENOENT$1 = (error) => typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
 const baselineRootDir = (repoRoot) => join(repoRoot, BASELINE_ROOT_REL);
@@ -3525,7 +3533,6 @@ const findBaselineVersion = async (repoRoot) => {
 };
 //#endregion
 //#region src/snapshot/snapshot.ts
-const SNAPSHOTS_ROOT_REL = join(".claude", ".harness", "snapshots");
 const STAGING_DIR = ".staging";
 const WORKING_SUBDIR = "working";
 const BASELINE_SUBDIR = "baseline";
@@ -3785,12 +3792,11 @@ const lcsMatches = (base, other) => {
 };
 //#endregion
 //#region src/update/engine.ts
-const SKILLS_PREFIX = join(".claude", "skills");
 const cohesionKey = (relPath) => {
-	const prefix = SKILLS_PREFIX + sep;
+	const prefix = SKILLS_DIR + sep;
 	if (!relPath.startsWith(prefix)) return relPath;
 	const name = relPath.slice(prefix.length).split(sep)[0];
-	return name ? join(SKILLS_PREFIX, name) : relPath;
+	return name ? join(SKILLS_DIR, name) : relPath;
 };
 const runEngine = async (inputs) => {
 	const { baseline, readClient, onConflict } = inputs;
@@ -3935,23 +3941,23 @@ const materializeVendorFiles = async (ctx) => {
 	const templateRoot = join(vendorRoot, "templates", target);
 	const vendorVersion = vars.vendor_version ?? "";
 	const entryProtocol = await renderFile(join(templateRoot, "agents.md.tpl"), "agents.md", vars);
-	const agentFiles = await Promise.all(CORE_AGENTS.map(async (role) => withAssetFrontmatter(await renderFile(join(vendorRoot, "agents", `${role}.md`), join(".claude", "agents", `${role}.md`), {
+	const agentFiles = await Promise.all(CORE_AGENTS.map(async (role) => withAssetFrontmatter(await renderFile(join(vendorRoot, "agents", `${role}.md`), join(AGENTS_DIR, `${role}.md`), {
 		SKILLS: renderRoleSkills(skills, role),
 		vendor_version: vendorVersion
 	}), vendorVersion)));
-	const fitAssessment = await copyFileEntry(join(vendorRoot, "agents", "fit-assessment.md"), join(".claude", "agents", "fit-assessment.md"));
+	const fitAssessment = await copyFileEntry(join(vendorRoot, "agents", "fit-assessment.md"), join(AGENTS_DIR, "fit-assessment.md"));
 	const skillFiles = (await Promise.all(skills.map(async (skill) => {
 		const skillDir = join(vendorRoot, "skills", skill.name);
 		const rels = await listFiles(skillDir);
-		return Promise.all(rels.map(async (rel) => withAssetFrontmatter(await copyFileEntry(join(skillDir, rel), join(".claude", "skills", skill.name, rel)), vendorVersion)));
+		return Promise.all(rels.map(async (rel) => withAssetFrontmatter(await copyFileEntry(join(skillDir, rel), join(SKILLS_DIR, skill.name, rel)), vendorVersion)));
 	}))).flat();
 	const playbooksReadme = await renderFile(join(templateRoot, "docs", "playbooks", "README.md.tpl"), join("docs", "playbooks", "README.md"), vars);
 	const hooksSrc = join(vendorRoot, "hooks");
-	const hookFiles = await Promise.all((await listFiles(hooksSrc)).filter((rel) => rel.endsWith(".sh") && !rel.includes(sep)).map((rel) => copyFileEntry(join(hooksSrc, rel), join(".claude", "hooks", rel), true)));
+	const hookFiles = await Promise.all((await listFiles(hooksSrc)).filter((rel) => rel.endsWith(".sh") && !rel.includes(sep)).map((rel) => copyFileEntry(join(hooksSrc, rel), join(HOOKS_DIR, rel), true)));
 	const hookLibSrc = join(hooksSrc, "lib");
-	const hookLibFiles = await pathExists(hookLibSrc) ? await Promise.all((await listFiles(hookLibSrc)).filter((rel) => rel.endsWith(".sh")).map((rel) => copyFileEntry(join(hookLibSrc, rel), join(".claude", "hooks", "lib", rel), true))) : [];
+	const hookLibFiles = await pathExists(hookLibSrc) ? await Promise.all((await listFiles(hookLibSrc)).filter((rel) => rel.endsWith(".sh")).map((rel) => copyFileEntry(join(hookLibSrc, rel), join(HOOKS_DIR, "lib", rel), true))) : [];
 	const commandsSrc = join(vendorRoot, "commands");
-	const commandFiles = await pathExists(commandsSrc) ? await Promise.all((await listFiles(commandsSrc)).map(async (rel) => withAssetFrontmatter(await copyFileEntry(join(commandsSrc, rel), join(".claude", "commands", rel)), vendorVersion))) : [];
+	const commandFiles = await pathExists(commandsSrc) ? await Promise.all((await listFiles(commandsSrc)).map(async (rel) => withAssetFrontmatter(await copyFileEntry(join(commandsSrc, rel), join(COMMANDS_DIR, rel)), vendorVersion))) : [];
 	const configSchema = await copyFileEntry(join(vendorRoot, HARNESS_CONFIG_SCHEMA_FILENAME), HARNESS_CONFIG_SCHEMA_FILENAME);
 	return [
 		entryProtocol,
@@ -4081,7 +4087,7 @@ const diffLostCommands = (existingHooks, templateHooks) => {
 //#endregion
 //#region src/install/resync.ts
 const resyncSpecialCased = async (repoRoot, templateRoot) => {
-	const { lostCommands } = await mergeSettingsHooks(join(templateRoot, ".claude", "settings.json.tpl"), join(repoRoot, ".claude", "settings.json"));
+	const { lostCommands } = await mergeSettingsHooks(join(templateRoot, CLAUDE_DIR, "settings.json.tpl"), join(repoRoot, SETTINGS_FILE));
 	return {
 		lostHookCommands: lostCommands,
 		gitignorePath: await appendGitignoreBlock(repoRoot)
@@ -4128,11 +4134,11 @@ const runInstall = async (options) => {
 	});
 	await assertNoSymlinkTraversal(repoRoot, [
 		...vendorFiles.map((file) => file.relPath),
-		join(".claude", "settings.json"),
+		SETTINGS_FILE,
 		".gitignore",
-		join(".claude", "state", "history.md"),
-		join(".claude", "state", "sessions"),
-		...COMMITTED_STATE_DIRS.map((dir) => join(".claude", "state", dir, ".gitkeep")),
+		join(STATE_DIR, "history.md"),
+		join(STATE_DIR, "sessions"),
+		...COMMITTED_STATE_DIRS.map((dir) => join(STATE_DIR, dir, ".gitkeep")),
 		HARNESS_CONFIG_FILENAME
 	]);
 	const readClient = async (relPath) => {
@@ -4186,9 +4192,8 @@ const runInstall = async (options) => {
 	await writeBaseline(repoRoot, vendorVersion, vendorFiles);
 	const claudeMdPresent = await pathExists(join(repoRoot, CLAUDE_MD_FILENAME));
 	const devDependencyMissing = await inspectDevDependency(repoRoot) === "missing";
-	const stateFiles = await Promise.all([writeOut(repoRoot, join(".claude", "state", "history.md"), renderTemplate(await readFile(join(templateRoot, "state", "history.md.tpl"), "utf8"), vars)), ...COMMITTED_STATE_DIRS.map((dir) => writeOut(repoRoot, join(".claude", "state", dir, ".gitkeep"), ""))]);
-	await mkdir(join(repoRoot, ".claude", "state", "sessions"), { recursive: true });
-	const settingsRelPath = join(".claude", "settings.json");
+	const stateFiles = await Promise.all([writeOut(repoRoot, join(STATE_DIR, "history.md"), renderTemplate(await readFile(join(templateRoot, "state", "history.md.tpl"), "utf8"), vars)), ...COMMITTED_STATE_DIRS.map((dir) => writeOut(repoRoot, join(STATE_DIR, dir, ".gitkeep"), ""))]);
+	await mkdir(join(repoRoot, STATE_DIR, "sessions"), { recursive: true });
 	const { lostHookCommands, gitignorePath: gitignore } = await resyncSpecialCased(repoRoot, templateRoot);
 	const configFile = await writeOut(repoRoot, HARNESS_CONFIG_FILENAME, renderTemplate(await readFile(join(templateRoot, "harness.config.yml.tpl"), "utf8"), vars));
 	return {
@@ -4201,7 +4206,7 @@ const runInstall = async (options) => {
 		filesWritten: [
 			...vendorPaths,
 			...stateFiles,
-			settingsRelPath,
+			SETTINGS_FILE,
 			...gitignore ? [gitignore] : [],
 			configFile
 		],
@@ -4276,7 +4281,7 @@ const runReconcile = async (inputs) => {
 	await refuseOnResidualMarkers(managedPaths, readClient);
 	await assertNoSymlinkTraversal(repoRoot, [
 		...managedPaths,
-		join(".claude", "settings.json"),
+		SETTINGS_FILE,
 		".gitignore"
 	]);
 	const actions = await runEngine({
@@ -4417,8 +4422,6 @@ const runRepair = async (options) => {
 };
 //#endregion
 //#region src/uninstall/uninstall.ts
-const HARNESS_DIR = join(".claude", ".harness");
-const SETTINGS_RELPATH = join(".claude", "settings.json");
 const DOCS_PREFIX = `docs${sep}`;
 const runUninstall = async (options) => {
 	const { repoRoot } = options;
@@ -4429,14 +4432,14 @@ const runUninstall = async (options) => {
 	const removedFiles = [...(await readBaseline(repoRoot, baselineVersion)).keys()].filter((relPath) => !relPath.startsWith(DOCS_PREFIX)).toSorted();
 	await assertNoSymlinkTraversal(repoRoot, [
 		...removedFiles,
-		SETTINGS_RELPATH,
+		SETTINGS_FILE,
 		".gitignore",
 		HARNESS_DIR,
 		HARNESS_CONFIG_FILENAME
 	]);
 	await Promise.all(removedFiles.map((relPath) => rm(join(repoRoot, relPath), { force: true })));
 	await pruneEmptyDirs(repoRoot, removedFiles);
-	const settings = await removeSettingsHooks(join(repoRoot, SETTINGS_RELPATH));
+	const settings = await removeSettingsHooks(join(repoRoot, SETTINGS_FILE));
 	const gitignoreStripped = await removeGitignoreBlock(repoRoot) !== null;
 	await rm(join(repoRoot, HARNESS_DIR), {
 		recursive: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lemoncode/lemony",
-  "version": "0.1.1-alpha.0",
+  "version": "0.1.1-alpha.2",
   "description": "Lemony — a Harness for AI Coding. Vendor package: installer, agent role catalog, generic skill catalog, hooks, and templates for a Spec-Driven Development workflow.",
   "type": "module",
   "private": false,