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

package/NOTICE

@@ -12,11 +12,13 @@ The catalog components below adapt text or code from the following MIT-licensed
 sources. Each source's copyright notice is reproduced here; the shared MIT
 permission notice (reproduced once, at the end of this section) applies to each.
 
-- **mattpocock/skills** — Copyright (c) Matt Pocock
+- **mattpocock/skills** — Copyright (c) 2026 Matt Pocock
   Source: https://github.com/mattpocock/skills
   Adapted by:
     - grill-ui — grill interview engine — one question at a time, decision-by-decision interrogation
     - grill-with-docs — grill workflow and decision-by-decision interview structure
+    - tdd — the red-green cycle, the behavior-over-implementation core principle, the vertical-slice ("tracer bullet") framing, mock-at-system-boundaries guidance, and the ADR three-tests nudge
+    - write-adr — ADR format — the three-tests rubric (hard to reverse / surprising / real trade-off), the record template, and the "what qualifies" guidance
 
 ### MIT License (applies to each source listed above)
 

package/catalog/VERSION

@@ -1 +1 @@
-0.1.1-alpha.1
+0.1.1-alpha.2

package/catalog/harness.config.schema.json

@@ -36,18 +36,6 @@
       "default": {},
       "type": "object",
       "properties": {
-        "state": {
-          "default": ".claude/state",
-          "type": "string"
-        },
-        "skills": {
-          "default": ".claude/skills",
-          "type": "string"
-        },
-        "agents": {
-          "default": ".claude/agents",
-          "type": "string"
-        },
         "playbooks": {
           "default": "docs/playbooks",
           "type": "string"

package/catalog/skills/grill-ui/SKILL.md

@@ -9,6 +9,7 @@ attribution:
     author: Matt Pocock
     url: https://github.com/mattpocock/skills
     license: MIT
+    copyright: Copyright (c) 2026 Matt Pocock
     relationship: derived-from
     note: grill interview engine — one question at a time, decision-by-decision interrogation
 ---

package/catalog/skills/grill-with-docs/SKILL.md

@@ -9,6 +9,7 @@ attribution:
     author: Matt Pocock
     url: https://github.com/mattpocock/skills
     license: MIT
+    copyright: Copyright (c) 2026 Matt Pocock
     relationship: derived-from
     note: grill workflow and decision-by-decision interview structure
 ---

package/catalog/skills/tdd/SKILL.md

@@ -5,6 +5,14 @@ origin: vendor
 vendor_version: '{{vendor_version}}'
 phase: during-implementation
 invoked-by: [implementer]
+attribution:
+  - source: mattpocock/skills
+    author: Matt Pocock
+    url: https://github.com/mattpocock/skills
+    license: MIT
+    copyright: Copyright (c) 2026 Matt Pocock
+    relationship: derived-from
+    note: the red-green cycle, the behavior-over-implementation core principle, the vertical-slice ("tracer bullet") framing, mock-at-system-boundaries guidance, and the ADR three-tests nudge
 ---
 
 # Test-Driven Development

package/catalog/skills/write-adr/SKILL.md

@@ -5,6 +5,14 @@ origin: vendor
 vendor_version: '{{vendor_version}}'
 invoked-by: [architect]
 trigger-condition: a resolved decision is worth recording (a discovery resolution, or an explicit request)
+attribution:
+  - source: mattpocock/skills
+    author: Matt Pocock
+    url: https://github.com/mattpocock/skills
+    license: MIT
+    copyright: Copyright (c) 2026 Matt Pocock
+    relationship: derived-from
+    note: ADR format — the three-tests rubric (hard to reverse / surprising / real trade-off), the record template, and the "what qualifies" guidance
 ---
 
 # Write ADR

package/catalog/templates/claude-code/harness.config.yml.tpl

@@ -19,9 +19,6 @@ task_storage:
 
 # Paths (relative; defaults shown — declare only overrides).
 paths:
-  state: .claude/state
-  skills: .claude/skills
-  agents: .claude/agents
   # Project-local playbooks (how-to-build patterns). Looked up by convention
   # `<topic>.md`, local then global; the local entry overrides the global one.
   # The require/suggest hooks read these two keys directly on every fire, so a

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";
@@ -18,6 +18,11 @@ const appendEvent = async (eventsPath, event) => {
 //#region src/config/config.constant.ts
 const HARNESS_CONFIG_FILENAME = "harness.config.yml";
 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"];
@@ -26,9 +31,6 @@ const TASK_STORAGE_REPO_PATTERN = /^[^\s/]+\/[^\s/]+$/;
 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"
 };
@@ -97,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({});
@@ -139,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;
@@ -194,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) => {
@@ -216,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();
@@ -389,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)) {
@@ -444,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,
@@ -2211,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;
@@ -2275,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",
@@ -2671,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
@@ -3061,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");
@@ -3317,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");
@@ -3450,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);
@@ -3515,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";
@@ -3775,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;
@@ -3925,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,
@@ -4071,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)
@@ -4118,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) => {
@@ -4176,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 {
@@ -4191,7 +4206,7 @@ const runInstall = async (options) => {
 		filesWritten: [
 			...vendorPaths,
 			...stateFiles,
-			settingsRelPath,
+			SETTINGS_FILE,
 			...gitignore ? [gitignore] : [],
 			configFile
 		],
@@ -4266,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({
@@ -4407,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;
@@ -4419,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.1",
+  "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,