diff --git a/.gitignore b/.gitignore index 731fef84..29ffa9d5 100644 --- a/.gitignore +++ b/.gitignore @@ -75,6 +75,9 @@ !bin/mutate-changes !bin/mutate_changes/ !bin/mutate_changes/*.py +!bin/project-config +!bin/project_config/ +!bin/project_config/*.py !bin/rank_todo.py !bin/reading-cost !bin/reading_cost/ diff --git a/CHANGELOG.md b/CHANGELOG.md index 440955f3..96696309 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,7 @@ ## Unreleased +- Each project now has a config, `~/.claude-projects//config.toml`, that names its checkout and the path of every file the loop keeps for it. `project-config` prints those paths, and fails naming each setting a config leaves out. README → Install → "Set up a project" shows how to write one. The other tools don't read the config yet. - larv-review takes an item as a floor item only where its tagline opens with `Reach the comprehension floor:`. A tagline that quotes the floor elsewhere, such as in a decision title, no longer makes its chunk due a scoring run. Reword each open floor item's tagline in every project's `todo.md` to open with the phrase. ## 0.9.0 diff --git a/README.md b/README.md index c89638fe..a97af583 100644 --- a/README.md +++ b/README.md @@ -75,6 +75,37 @@ Link `loop-claude` and `loop-inbox` onto `PATH`: `ln -s ~/.claude/bin/loop-claud To get loop-claude's questions and stops as Mattermost DMs from a bot, write the server, the bot's token and your username into `~/.claude/.env`, in the keys `~/.claude/bin/mattermost-dm --help` names, and run `chmod 600 ~/.claude/.env`. Without that file, loop-claude sends no DM. +### Set up a project + +Each project the loop runs in has a config, `~/.claude-projects//config.toml`, where `` is the project's name. The folder is a git repo of its own, so the config has a history and a client's files never enter this repo. A project is a whole git checkout, never a subfolder of one. + +The config names the project's main checkout and the path of every file the loop keeps for it. No setting has a default: `project-config` fails and names each setting a config leaves out. A path is `checkout:` inside the checkout, `folder:` inside the config's folder, or one that starts with `/` or `~/`. A project of your own keeps every file in its checkout: + +```toml +checkout = "~/code/log" +plan = "checkout:todo.md" +working-rules = "checkout:AGENTS.md" +decisions = "checkout:docs/decisions.md" +score-anchors = "checkout:docs/score-anchors.md" +comprehension-history = "checkout:docs/comprehension-history.md" +reading-cost = "checkout:docs/reading-cost.md" +changelog = "checkout:CHANGELOG.md" +goals-and-audience = "checkout:README.md" +principles = "~/.claude/principles" +``` + +For a client's project, use one sandbox VM per client, so that one client's code, transcripts and credentials never share a machine with another's. Keep what the client's repo should not hold in the config's folder: write those paths as `folder:`, as `project-config --help` shows. + +```sh +mkdir -p ~/.claude-projects/acme && cd ~/.claude-projects/acme +git init +$EDITOR config.toml +git add config.toml && git commit -m "Add the config" +cd ~/code/acme-billing && ~/.claude/bin/project-config +``` + +The last line prints each setting's path once the config is complete. Today only `project-config` reads the config: every other tool still reads each file at the place the example above gives it. + ## Update Move `~/.claude` to the newest release: @@ -112,6 +143,7 @@ Install puts only `loop-claude` and `loop-inbox` on `PATH`; call the others by t - `mattermost-dm []` sends a message, or else stdin, from the Mattermost bot to the human; `~/.claude/.env` names the server, the bot's token and the human, and `mattermost-dm --help` names its keys. `loop-claude --help` says when loop-claude sends one. - `metric-bench [history]` benches cheap static metrics of a project's Python against the places its comprehension history names as hardest; `metric-bench --help` states the metrics and the scores. - `mutate-changes [--base ] [--prefix ] [--jobs ]` mutation-tests the lines a branch changes and prints each mutant its tests don't kill; `mutate-changes --help` says which tool it runs for each language. +- `project-config []` prints the paths a project's config sets, or the one asked for, and fails naming each setting the config leaves out; Install → "Set up a project" shows a config. - `rank_todo.py [--check] [todo.md]` scores and ranks a project's `todo.md`; `rank_todo.py --help` states the format. - `reading-cost [--reset] [record]` appends a figure for each chunk `loop-claude` finished to a project's `docs/reading-cost.md`, and says whether the figures rise; `reading-cost --help` states the measure. - `review-replay ` replays a review pass's archived rounds from the projects run on the model, on the code each reviewed, and prints the lowest rung below the project's that, like each rung above it, qualifies: it finds no less of the 🔴 and 🟡 findings than two replays on the project's rung find, within a margin, and misses no 🔴 that both found. `review-replay --help` states the replay. With `--omit-claude-md` it tests instead whether the pass's reviewer may start without `CLAUDE.md`: it replays each round three times as archived and once without the instruction files, and prints whether the reviewer passes: whether the last replay missed no more findings than the most an unchanged replay missed, with each count and each finding it missed. Each replayed reviewer skips every permission prompt, stability-reviewer has Bash, and an archived prompt may name paths on the host. diff --git a/bin/project-config b/bin/project-config new file mode 100755 index 00000000..b7f57b3d --- /dev/null +++ b/bin/project-config @@ -0,0 +1,9 @@ +#!/usr/bin/env python3 +import pathlib +import sys + +sys.path.insert(0, str(pathlib.Path(__file__).resolve().parent)) + +from project_config import main + +sys.exit(main.main(sys.argv[1:])) diff --git a/bin/project_config/__init__.py b/bin/project_config/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/bin/project_config/main.py b/bin/project_config/main.py new file mode 100644 index 00000000..b3f08a27 --- /dev/null +++ b/bin/project_config/main.py @@ -0,0 +1,57 @@ +"""Print the paths a project's config sets. + +usage: project-config [] + +Run inside a checkout, or a worktree of one. It finds the config that names the checkout, +~/.claude-projects//config.toml, and prints each setting and its absolute path, as in +`plan: /home/me/code/acme/todo.md`. Given a setting, it prints only that setting's path. + +The config is TOML. `checkout` names the project's main checkout, and every other setting is a path: +"checkout:" inside the checkout, "folder:" inside the config's own folder, or one that +starts with / or ~/. In a worktree, a "checkout:" path is the worktree's own file. + + checkout = "~/code/acme-billing" + plan = "folder:todo.md" + working-rules = "folder:AGENTS.md" + decisions = "folder:docs/decisions.md" + score-anchors = "folder:docs/score-anchors.md" + comprehension-history = "folder:docs/comprehension-history.md" + reading-cost = "folder:docs/reading-cost.md" + changelog = "checkout:CHANGELOG.md" + goals-and-audience = "folder:goals.md" + principles = "folder:principles" + +Exit 1, naming each fault on stderr, where no config names the checkout, or its config leaves out a +setting, names an unknown one or misspells a path. No setting has a default. +""" +import pathlib +import sys + +from failure import Failure +from git_cli.git_repo import git +from project_config.settings import load, ProjectConfig, SETTINGS + + +def main(argv: list[str]) -> int: + if argv[:1] in (["-h"], ["--help"]): + print(__doc__.strip()) + return 0 + if len(argv) > 1 or (argv and argv[0] not in SETTINGS): + print(f"usage: project-config [], where is one of {', '.join(SETTINGS)}", file=sys.stderr) + return 1 + config = located() + if isinstance(config, Failure): + print(config.reason, file=sys.stderr) + return 1 + print(config.paths[argv[0]] if argv else "\n".join(f"{name}: {config.paths[name]}" for name in SETTINGS)) + return 0 + + +def located() -> ProjectConfig | Failure: + found = git("rev-parse", "--path-format=absolute", "--show-toplevel", "--git-common-dir") + if isinstance(found, Failure): + return found + if len(lines := found.splitlines()) != 2: + return Failure(f"git rev-parse printed {found!r}, not a checkout's top folder and git directory on two lines") + # The common dir is the main checkout's .git, whichever worktree runs this. + return load(pathlib.Path(lines[0]), pathlib.Path(lines[1]).parent, pathlib.Path.home()) diff --git a/bin/project_config/settings.py b/bin/project_config/settings.py new file mode 100644 index 00000000..0f97c721 --- /dev/null +++ b/bin/project_config/settings.py @@ -0,0 +1,79 @@ +"""A project's settings, read from the one config that names its checkout: `~/.claude-projects//config.toml`. + +No setting has a default, so that a client's project never runs on another project's files: a missing config or setting is a Failure that names it.""" +import dataclasses +import pathlib +import tomllib + +from failure import Failure + +PROJECTS = ".claude-projects" +CONFIG = "config.toml" +# Every path a project sets, by its role. The syntax panel picked role names over file names, which a client's project doesn't share. +SETTINGS = ("plan", "working-rules", "decisions", "score-anchors", "comprehension-history", "reading-cost", "changelog", "goals-and-audience", "principles") +# The panel also picked a prefix on every path over bare relative paths: each line says its own place, and a path with no prefix fails instead of landing somewhere by default. +SPELLING = '"checkout:" for a path in the checkout, "folder:" for one in the config\'s folder, or a path that starts with / or ~/' + + +@dataclasses.dataclass(frozen=True) +class ProjectConfig: + """folder is `~/.claude-projects/`, and paths holds each of SETTINGS as an absolute path.""" + key: str + folder: pathlib.Path + paths: dict[str, pathlib.Path] + + +def load(top: pathlib.Path, main: pathlib.Path, home: pathlib.Path) -> ProjectConfig | Failure: + """The config that names main, the project's main checkout. A `checkout:` path lands in top, the worktree that asks, which is main itself outside a worktree. + + A config that cannot be read fails every project, since it may be the one that names main.""" + named: list[tuple[pathlib.Path, dict[str, object]]] = [] + for file in sorted((home / PROJECTS).glob(f"*/{CONFIG}")): + values = read(file, home) + if isinstance(values, Failure): + return values + if values.pop("checkout") == main: + named.append((file, values)) + if not named: + return Failure(f"no config names the checkout {main}: write ~/{PROJECTS}//{CONFIG}, as README.md → Install shows") + if len(named) > 1: + return Failure(f"{' and '.join(str(file) for file, _ in named)} both name the checkout {main}; one config may") + file, values = named[0] + paths = {name: placed(values[name], top, file.parent, home) for name in SETTINGS if name in values} + faults = [ + *(f"`{name}` is missing" for name in SETTINGS if name not in values), + *(f"`{name}` is not a setting" for name in values if name not in SETTINGS), + *(f"`{name}` is {values[name]!r}, not {SPELLING}" for name, path in paths.items() if path is None), + ] + if faults: + return Failure(f"{file}: {'; '.join(faults)}. The settings are {', '.join(SETTINGS)}.") + return ProjectConfig(file.parent.name, file.parent, {name: path for name, path in paths.items() if path}) + + +def read(file: pathlib.Path, home: pathlib.Path) -> dict[str, object] | Failure: + """The config's values, its checkout as an absolute path.""" + try: + values = tomllib.loads(file.read_text(encoding="utf-8")) + except (OSError, UnicodeDecodeError, tomllib.TOMLDecodeError) as failure: + return Failure(f"cannot read {file}: {failure}") + checkout = anywhere(values.get("checkout"), home) + if checkout is None: + return Failure(f'{file}: `checkout` names the project\'s main checkout as a path that starts with / or ~/, such as "~/code/acme-billing", not {values.get("checkout")!r}') + return {**values, "checkout": checkout} + + +def placed(value: object, top: pathlib.Path, folder: pathlib.Path, home: pathlib.Path) -> pathlib.Path | None: + """The path a setting's value spells, or None where it doesn't spell one. A prefixed path stays inside its place.""" + if not isinstance(value, str): + return None + for prefix, place in (("checkout:", top), ("folder:", folder)): + if value.startswith(prefix): + inside = pathlib.PurePosixPath(value.removeprefix(prefix)) + return None if inside.is_absolute() or ".." in inside.parts or not inside.parts else place / inside + return anywhere(value, home) + + +def anywhere(value: object, home: pathlib.Path) -> pathlib.Path | None: + if isinstance(value, str) and value.startswith("~/"): + return home / value.removeprefix("~/") + return pathlib.Path(value) if isinstance(value, str) and value.startswith("/") else None diff --git a/bin/project_config/test_project_config.py b/bin/project_config/test_project_config.py new file mode 100644 index 00000000..f71fc515 --- /dev/null +++ b/bin/project_config/test_project_config.py @@ -0,0 +1,167 @@ +import pathlib +import subprocess +import sys +import tempfile +import unittest + +sys.path.insert(0, str(pathlib.Path(__file__).resolve().parents[1])) + +from failure import Failure +from test_env import isolated_env +from project_config.settings import load, ProjectConfig + +TOOL = pathlib.Path(__file__).resolve().parents[1] / "project-config" + +CLIENT = """checkout = "~/code/acme-billing" +plan = "folder:todo.md" +working-rules = "folder:AGENTS.md" +decisions = "folder:docs/decisions.md" +score-anchors = "folder:docs/score-anchors.md" +comprehension-history = "folder:docs/comprehension-history.md" +reading-cost = "folder:docs/reading-cost.md" +changelog = "checkout:CHANGELOG.md" +goals-and-audience = "folder:goals.md" +principles = "~/.claude/principles" +""" + + +class ConfigCase(unittest.TestCase): + def setUp(self) -> None: + made = tempfile.TemporaryDirectory() + self.addCleanup(made.cleanup) + self.home = pathlib.Path(made.name).resolve() + self.checkout = self.home / "code" / "acme-billing" + self.checkout.mkdir(parents=True) + + def write(self, key: str, text: str) -> pathlib.Path: + folder = self.home / ".claude-projects" / key + folder.mkdir(parents=True) + (folder / "config.toml").write_text(text, encoding="utf-8") + return folder + + +class LoadTest(ConfigCase): + def failure(self, top: pathlib.Path | None = None) -> str: + found = load(top or self.checkout, self.checkout, self.home) + assert isinstance(found, Failure), found + return found.reason + + def test_resolves_each_setting_by_its_prefix(self) -> None: + folder = self.write("acme", CLIENT) + self.write("other", CLIENT.replace("acme-billing", "other")) + found = load(self.checkout, self.checkout, self.home) + assert isinstance(found, ProjectConfig), found + self.assertEqual((found.key, found.folder), ("acme", folder)) + self.assertEqual(found.paths["plan"], folder / "todo.md") + self.assertEqual(found.paths["decisions"], folder / "docs" / "decisions.md") + self.assertEqual(found.paths["changelog"], self.checkout / "CHANGELOG.md") + self.assertEqual(found.paths["principles"], self.home / ".claude" / "principles") + self.assertEqual(len(found.paths), 9) + + def test_a_worktree_finds_the_main_checkouts_config_and_reads_its_own_files(self) -> None: + self.write("acme", CLIENT) + worktree = self.home / "code" / "acme-billing-item-3" + found = load(worktree, self.checkout, self.home) + assert isinstance(found, ProjectConfig), found + self.assertEqual(found.paths["changelog"], worktree / "CHANGELOG.md") + + def test_an_absolute_checkout_and_path_are_taken_as_written(self) -> None: + self.write("acme", CLIENT.replace("~/code/acme-billing", str(self.checkout)).replace("~/.claude/principles", "/srv/principles")) + found = load(self.checkout, self.checkout, self.home) + assert isinstance(found, ProjectConfig), found + self.assertEqual(found.paths["principles"], pathlib.Path("/srv/principles")) + + def test_no_config_fails_naming_the_checkout_and_the_file_to_write(self) -> None: + for write_other in (False, True): + with self.subTest(write_other=write_other): + if write_other: + self.write("other", CLIENT.replace("acme-billing", "other")) + reason = self.failure() + self.assertIn(str(self.checkout), reason) + self.assertIn("~/.claude-projects//config.toml", reason) + + def test_every_missing_setting_is_named(self) -> None: + kept = "".join(line + "\n" for line in CLIENT.splitlines() if not line.startswith(("plan", "changelog", "principles"))) + self.write("acme", kept) + reason = self.failure() + for name in ("plan", "changelog", "principles"): + self.assertIn(f"`{name}`", reason) + self.assertNotIn("`decisions`", reason) + self.assertIn("acme/config.toml", reason) + + def test_every_fault_in_one_config_is_named_together(self) -> None: + cases = { + "an unknown setting": ('readme = "checkout:README.md"\n', "`readme`"), + "a path with no prefix": ('plan = "todo.md"\n', "`plan`"), + "a path with an unknown prefix": ('plan = "repo:todo.md"\n', "`plan`"), + "a value that is not text": ("plan = 3\n", "`plan`"), + "a path that leaves the folder": ('plan = "folder:../other/todo.md"\n', "`plan`"), + "a path that leaves the checkout": ('plan = "checkout:../todo.md"\n', "`plan`"), + "an empty path": ('plan = "folder:"\n', "`plan`"), + } + for case, (line, named) in cases.items(): + with self.subTest(case=case), tempfile.TemporaryDirectory() as made: + self.home = pathlib.Path(made).resolve() + self.checkout = self.home / "code" / "acme-billing" + text = "".join(kept + "\n" for kept in CLIENT.splitlines() if not kept.startswith(("plan", "decisions"))) + self.write("acme", text + line) + reason = self.failure() + self.assertIn(named, reason) + self.assertIn("`decisions`", reason) + + def test_two_configs_naming_one_checkout_fail_naming_both(self) -> None: + self.write("acme", CLIENT) + self.write("acme-copy", CLIENT) + reason = self.failure() + self.assertIn("acme/config.toml", reason) + self.assertIn("acme-copy/config.toml", reason) + + def test_a_config_that_cannot_be_read_fails_whichever_checkout_asks(self) -> None: + cases = {"not TOML": "checkout = ", "no checkout": 'plan = "folder:todo.md"\n', "a checkout that is not text": "checkout = 3\n", "a relative checkout": 'checkout = "code/acme"\n'} + for case, text in cases.items(): + with self.subTest(case=case), tempfile.TemporaryDirectory() as made: + self.home = pathlib.Path(made).resolve() + self.write("acme", CLIENT) + self.write("broken", text) + self.assertIn("broken/config.toml", self.failure()) + + def test_a_folder_with_no_config_is_skipped(self) -> None: + self.write("acme", CLIENT) + (self.home / ".claude-projects" / "notes").mkdir() + self.assertIsInstance(load(self.checkout, self.checkout, self.home), ProjectConfig) + + +class ToolTest(ConfigCase): + def run_tool(self, *args: str, cwd: pathlib.Path | None = None) -> subprocess.CompletedProcess[str]: + return subprocess.run([sys.executable, str(TOOL), *args], cwd=cwd or self.checkout, env={**isolated_env(), "HOME": str(self.home)}, capture_output=True, text=True) + + def setUp(self) -> None: + super().setUp() + subprocess.run(["git", "init", "-q", str(self.checkout)], check=True, env=isolated_env()) + + def test_prints_every_setting_or_the_one_asked_for(self) -> None: + folder = self.write("acme", CLIENT) + everything = self.run_tool() + self.assertEqual((everything.returncode, everything.stderr), (0, "")) + self.assertEqual(everything.stdout.splitlines()[0], f"plan: {folder}/todo.md") + self.assertEqual(len(everything.stdout.splitlines()), 9) + (self.checkout / "src").mkdir() + one = self.run_tool("changelog", cwd=self.checkout / "src") + self.assertEqual((one.returncode, one.stdout), (0, f"{self.checkout}/CHANGELOG.md\n")) + + def test_fails_on_stderr(self) -> None: + cases = {"no config": ((), "no config names the checkout"), "an unknown setting": (("readme",), "usage:"), "two arguments": (("plan", "changelog"), "usage:")} + for case, (args, said) in cases.items(): + with self.subTest(case=case): + ran = self.run_tool(*args) + self.assertEqual((ran.returncode, ran.stdout), (1, "")) + self.assertIn(said, ran.stderr) + + def test_help_shows_a_config(self) -> None: + ran = self.run_tool("--help") + self.assertEqual(ran.returncode, 0) + self.assertIn('plan = "folder:todo.md"', ran.stdout) + + +if __name__ == "__main__": + unittest.main() diff --git a/docs/reading-cost.md b/docs/reading-cost.md index 17da790e..6c8c0085 100644 --- a/docs/reading-cost.md +++ b/docs/reading-cost.md @@ -1816,3 +1816,18 @@ Read most (opens and searches): - `docs/decisions.md` 2 - `README.md` 1 - `bin/review_replay/rounds.py` 1 + +## Reading cost, chunk ca20477ddb82, finished 2026-11-12T21:48:43Z + +63685 new input tokens before the first commit. + +Read most (opens and searches): + +- `bin/review_replay/test_review_replay.py` 4 +- `bin/review_replay/main.py` 3 +- `README.md` 2 +- `todo.md` 2 +- `bin/review-replay` 1 +- `bin/review_replay/rounds.py` 1 +- `ci.sh` 1 +- `docs/decisions.md` 1 diff --git a/todo.md b/todo.md index a24d8506..8089725f 100644 --- a/todo.md +++ b/todo.md @@ -12,21 +12,20 @@ | ID | Release | Blocked by | Exempt | Item | L | E | I | R | S | Moves | Score | |---|---|---|---|---|---|---|---|---|---|---|---| -| 343 | 0.10.0 | | | **Read every setting a project needs from one explicit config in the project's own git repo, `~/.claude-projects//`, found from the checkout's path, and fail naming each setting the config leaves out.** | 4 | 2 | 3 | 7 | 4 | 1.6 by 6 | 1.6 | -| 347 | 0.10.0 | 343 | | **Hand reviewers the technical principles from the folder a project's config names, in place of `~/.claude/principles/`.** | 2 | 2 | 3 | 5 | 2 | 1.6 by 6 | 2.2 | -| 346 | 0.10.0 | 343 | | **Read a project's goals and audience from the file its config names, in place of `README.md`'s `## Goals` and `## Audience`.** | 2 | 2 | 3 | 5 | 3 | 1.6 by 6 | 2.0 | -| 344 | 0.10.0 | 343 | | **Read and write the plan, `AGENTS.md`, the records and the changelog at the paths a project's config names, in every tool, prompt, rule and skill.** | 4 | 2 | 3 | 7 | 6 | 1.6 by 7 | 0.9 | +| 347 | 0.10.0 | | | **Hand reviewers the technical principles from the folder a project's config names, in place of `~/.claude/principles/`.** | 2 | 2 | 3 | 5 | 2 | 1.6 by 6 | 2.2 | +| 346 | 0.10.0 | | | **Read a project's goals and audience from the file its config names, in place of `README.md`'s `## Goals` and `## Audience`.** | 2 | 2 | 3 | 5 | 3 | 1.6 by 6 | 2.0 | +| 344 | 0.10.0 | | | **Read and write the plan, `AGENTS.md`, the records and the changelog at the paths a project's config names, in every tool, prompt, rule and skill.** | 4 | 2 | 3 | 7 | 6 | 1.6 by 7 | 0.9 | | 345 | 0.10.0 | 344 | | **Commit each change a chunk makes to a plan or record outside the checkout into the project's `~/.claude-projects//` repo, titled like the chunk's own commits.** | 3 | 2 | 3 | 6 | 4 | 1.6 by 4 | 1.1 | -| 348 | 0.11.0 | 343 | | **Read each project's credentials from the env file its config names, fail naming each missing key, and keep every value out of prompts, transcripts, logs and the archive.** | 2 | 2 | 4 | 6 | 3 | 1.6 by 2, 4 by 5 | 6.9 | +| 348 | 0.11.0 | | | **Read each project's credentials from the env file its config names, fail naming each missing key, and keep every value out of prompts, transcripts, logs and the archive.** | 2 | 2 | 4 | 6 | 3 | 1.6 by 2, 4 by 5 | 6.9 | | 354 | 0.11.0 | 344 | | **Read and write the decisions, score anchors, comprehension history, reading cost and changelog each through the backend its project's config names, with markdown files as one backend.** | 3 | 2 | 3 | 6 | 6 | 1.6 by 4, code health by 1 | 1.2 | | 364 | 0.11.0 | 354 | | **Read a client repo's own `CLAUDE.md` and `AGENTS.md`, propose to its team each change that aligns them with this setup, and record each conflict left as a decision in the project's records.** | 2 | 2 | 2 | 4 | 2 | 1.6 by 4, 1.2 by 2 | 2.2 | -| 360 | 0.11.0 | 343 | | **Make `chunk-pr merge` wait for the human approvals a project's config requires, as part of the gate, before it merges.** | 2 | 2 | 3 | 5 | 3 | 1.6 by 5 | 1.6 | -| 357 | 0.11.0 | 343 | | **Write prose in the language a project's config names, and title its commits, pull requests and branches by the templates it names.** | 3 | 2 | 3 | 6 | 4 | 1.6 by 5 | 1.4 | +| 360 | 0.11.0 | | | **Make `chunk-pr merge` wait for the human approvals a project's config requires, as part of the gate, before it merges.** | 2 | 2 | 3 | 5 | 3 | 1.6 by 5 | 1.6 | +| 357 | 0.11.0 | | | **Write prose in the language a project's config names, and title its commits, pull requests and branches by the templates it names.** | 3 | 2 | 3 | 6 | 4 | 1.6 by 5 | 1.4 | | 350 | 0.11.0 | 344 | | **Route every read and write of the plan, by tools and by agents, through one plan-store interface and `todo-item`, with the markdown file as one backend.** | 4 | 2 | 3 | 7 | 7 | 1.6 by 4, code health by 2 | 1.1 | | 349 | 0.11.0 | | | **Convert markdown to ADF and back with `@larvit/adf-codec`'s portable calls, through a pinned Node shim run in a container with a memory limit.** | 2 | 1 | 2 | 3 | 2 | 1.6 by 3 | 1.1 | | 351 | 0.11.0 | 348, 349, 350 | | **Read a project's plan from the child issues of a Jira Cloud epic its config names, ranked in Jira's backlog order.** | 3 | 2 | 3 | 6 | 5 | 1.6 by 6 | 1.2 | | 353 | 0.11.0 | 346, 351 | | **Let a project's config take its goals and audience from a Jira epic's description, under the same two headings.** | 2 | 2 | 3 | 5 | 3 | 1.6 by 4 | 1.3 | -| 358 | 0.11.0 | 343 | | **Let a project's config allow its runtime and tests on the host, and set the comprehension floor that marks code health very important.** | 2 | 2 | 3 | 5 | 3 | 1.6 by 4 | 1.3 | +| 358 | 0.11.0 | | | **Let a project's config allow its runtime and tests on the host, and set the comprehension floor that marks code health very important.** | 2 | 2 | 3 | 5 | 3 | 1.6 by 4 | 1.3 | | 362 | 0.11.0 | 348 | | **Send loop-claude's notices through the notifier a project's config names, with Mattermost as the first backend.** | 2 | 1 | 2 | 3 | 3 | 1.6 by 3 | 1.0 | | 363 | 0.11.0 | 362 | | **Add a Slack backend to the notifier, sending each notice as a DM from a bot.** | 2 | 1 | 2 | 3 | 3 | 1.6 by 4 | 1.3 | | 352 | 0.11.0 | 351 | | **Write a project's plan to its Jira epic: file items as child issues, edit those the loop filed, score unscored issues with a comment, and move a finished item to the status its config names.** | 3 | 2 | 3 | 6 | 5 | 1.6 by 6 | 1.2 | @@ -91,12 +90,6 @@ ## Details -### 343. Read every setting a project needs from one explicit config in the project's own git repo, `~/.claude-projects//`, found from the checkout's path, and fail naming each setting the config leaves out. - -lilleman's calls, 2026-11-12. 0.10.0 is the bare minimum to run loop-claude on a client's legacy project: the plan, the records, the goals and audience and the principles move to paths the config names, and nothing else becomes pluggable yet. Each project has a folder `~/.claude-projects//`, where `` is the project's name, and the folder is a git repo of its own. It holds the config, and for a client project the files the config points at. The config names the checkout it belongs to, so a tool run inside a checkout finds its config. A project is always a whole git checkout, never a subfolder. - -No setting has a built-in default: a missing config, or a missing setting in one, fails and names what is missing. 0.10.0's settings are the paths of `todo.md`, `AGENTS.md`, `docs/decisions.md`, `docs/score-anchors.md`, `docs/comprehension-history.md`, `docs/reading-cost.md` and `CHANGELOG.md`, the goals-and-audience file (item 346), and the principles folder (item 347). A path may point into the checkout or into the project's folder. This chunk also writes a config for every project under `~/code` that names the files each one uses today, so each keeps running unchanged. The config's spelling is a syntax lilleman writes, so a panel seated as lilleman picks it before it ships. README → Install says how to set up a client project, on one sandbox VM per client. - ### 347. Hand reviewers the technical principles from the folder a project's config names, in place of `~/.claude/principles/`. lilleman's call, 2026-11-12: every project must set this folder. It replaces `~/.claude/principles/` and doesn't add to it, so the projects under `~/code` name `~/.claude/principles/`. The `Applies to` line works inside the named folder. Readers: larv-review's principles pass, the reviewers under `agents/`, and `CLAUDE.md` and the skills wherever they name `~/.claude/principles/`.