@sayansr26/agent-os 0.5.2 → 0.5.3

package/.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "Context engineering and agent tooling for Claude Code.",
-    "version": "0.4.0"
+    "version": "0.4.1"
   },
   "plugins": [
     {

package/CHANGELOG.md

@@ -5,11 +5,29 @@ All notable changes to this project are documented here.
 The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [0.5.1] — 2026-09-15
+## [0.5.3] — 2026-09-15
 
-Found by running 0.5.0 against a real repository that already had six
-path-scoped rules and a hand-written `AGENTS.md`. It overwrote the
-`AGENTS.md`. 0.5.0 was never published.
+### Added
+- **`init` finishes the Claude Code project setup.** Two things that are
+  neither rules nor plugin, both written at project scope only:
+  `.claude/settings.json` gets `env.CLAUDE_CODE_ENABLE_TODO_TOOLS = "1"`,
+  merged into the existing keys rather than replacing the file; and `CLAUDE.md`
+  gets the task-tracking rule, inserted under `## Operator preferences` when
+  the project keeps that heading. Both are idempotent, an existing truthy value
+  for the flag is left as the user set it, and `CLAUDE.md` is never created — a
+  project's always-loaded context should not be invented by a CLI. Nothing
+  writes to `~/.claude/`; a project setup tool has no business editing the
+  machine's global config.
+- **The validator checks release hygiene.** `package.json`'s version must have
+  a matching `## [x.y.z]` changelog section, and it must be the newest one.
+  0.5.2 shipped with no entry of its own; a deterministic check belongs in a
+  script rather than in a habit.
+
+### Changed
+- Plugin 0.4.1: the audit no longer misreports a generated rules directory as a
+  legacy store to fold into `CLAUDE.md` and delete.
+
+## [0.5.2] — 2026-09-15
 
 ### Added
 - **`init` installs the Claude Code plugin.** When Claude Code is detected it
@@ -19,6 +37,11 @@ path-scoped rules and a hand-written `AGENTS.md`. It overwrote the
   commands instead. `--no-plugin` skips it, and the rules are written either
   way — the compiler never depends on the plugin step succeeding.
 
+## [0.5.1] — 2026-09-15
+
+Found by running 0.5.0 against a real repository that already had six
+path-scoped rules and a hand-written `AGENTS.md`. It overwrote the `AGENTS.md`.
+
 ### Fixed
 - **`init` scaffolded over projects that already had rules.** It wrote a
   placeholder `AGENTS.md` and an `example.md` rule regardless of what was

package/README.md

@@ -76,12 +76,15 @@ Every command below is `npx @sayansr26/agent-os <command>`. Install it once —
 
 `--root <dir>` to target another directory, `--dry-run` to preview.
 
-**`init` sets up Claude Code completely.** When it detects Claude Code it also
-installs the plugin — the agents, skills, per-agent memory and session hook —
-with `claude plugin marketplace add` and `claude plugin install --yes` at
-project scope, so it travels with the repo. `--no-plugin` skips it. Every other
-detected tool gets its rules in its own schema; the plugin layer is Claude Code
-only because no other tool has anywhere to put it.
+**`init` sets up Claude Code completely.** Beyond the rules it installs the
+plugin — agents, skills, per-agent memory, session hook — with
+`claude plugin marketplace add` and `claude plugin install --yes`, enables the
+task tools in `.claude/settings.json`, and adds the task-tracking rule to
+`CLAUDE.md` if it is not already there. All of it at **project scope**, so the
+setup travels with the repo and nothing writes to `~/.claude/`. `--no-plugin`
+skips the plugin step. Every other detected tool gets its rules in its own
+schema; the plugin layer is Claude Code only because no other tool has anywhere
+to put it.
 
 **On an existing project, `init` adopts rather than scaffolds.** It takes your
 current `AGENTS.md` and the first rules directory it recognises as the source,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sayansr26/agent-os",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "description": "One source of truth for AI coding agent config. Write your rules once; compile them to Claude Code, Cursor, Cline, Windsurf, Antigravity, Gemini CLI, OpenCode and Kilo.",
   "keywords": [
     "ai",

package/plugins/agent-os/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "agent-os",
   "description": "A context-engineered agent system for Claude Code. Ships a durable per-project memory layer, a cartographer that maps your codebase once and remembers it, and a coordinated agent set that reads your project's rules rather than hardcoding them.",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "author": {
     "name": "Sayan Choudhury",
     "email": "sayan.choudhury.in@gmail.com"

package/src/claude-setup.mjs

@@ -0,0 +1,81 @@
+/**
+ * The two Claude Code settings that are not rules and not a plugin.
+ *
+ * Both are written at PROJECT scope only — `.claude/settings.json` and the
+ * project's `CLAUDE.md`. Nothing here touches `~/.claude/`: a project setup
+ * tool that edits the machine's global config is overreach, and the point is
+ * that the setup travels with the repository.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { write } from "./source.mjs";
+
+export const TODO_ENV = "CLAUDE_CODE_ENABLE_TODO_TOOLS";
+
+export const TASK_RULE = `- **Always track work with the task tool (TaskCreate / TaskUpdate).** Any request
+  with more than one step gets a task list before work starts: one task per
+  deliverable, marked \`in_progress\` when started and \`completed\` only when
+  verified. Keep it current as scope changes, including work delegated to
+  subagents, so I can see what is done, running and left at any moment.`;
+
+/**
+ * Turn on the todo tools in project settings, preserving every other key.
+ * Returns "added" | "present" | "conflict" | "invalid".
+ */
+export function ensureTodoEnv(root, { dry = false } = {}) {
+  const rel = ".claude/settings.json";
+  const p = join(root, rel);
+  let settings = {};
+  if (existsSync(p)) {
+    try { settings = JSON.parse(readFileSync(p, "utf8")); }
+    catch { return { status: "invalid", rel }; }
+  }
+  const env = settings.env || {};
+  const current = env[TODO_ENV];
+
+  // "true" and "1" are both truthy to Claude Code; an existing truthy value is
+  // the user's choice and is left alone rather than normalised.
+  if (current !== undefined) {
+    const on = current === "1" || current === "true" || current === true;
+    return { status: on ? "present" : "conflict", rel, current };
+  }
+
+  settings.env = { ...env, [TODO_ENV]: "1" };
+  if (!dry) write(root, rel, JSON.stringify(settings, null, 2) + "\n");
+  return { status: "added", rel };
+}
+
+/**
+ * Put the task-tracking rule in CLAUDE.md if it is not already there.
+ * Never creates CLAUDE.md — that file is the project's own always-loaded
+ * context, and inventing one from a CLI is how a project ends up with a stub
+ * nobody owns. Returns "added" | "present" | "no-file".
+ */
+export function ensureTaskRule(root, { dry = false } = {}) {
+  const rel = "CLAUDE.md";
+  const p = join(root, rel);
+  if (!existsSync(p)) return { status: "no-file", rel };
+
+  const text = readFileSync(p, "utf8");
+  if (/TaskCreate/.test(text)) return { status: "present", rel };
+
+  // Prefer the operator-preferences section if the project keeps one, so the
+  // rule lands with the other instructions about how to work rather than
+  // orphaned at the bottom of the file.
+  const heading = text.match(/^##\s+Operator preferences\s*$/m);
+  let next;
+  if (heading) {
+    const start = heading.index + heading[0].length;
+    const rest = text.slice(start);
+    const nextHeading = rest.search(/^##\s+/m);
+    const end = nextHeading === -1 ? text.length : start + nextHeading;
+    const before = text.slice(0, end).replace(/\s*$/, "");
+    next = `${before}\n\n${TASK_RULE}\n\n${text.slice(end)}`;
+  } else {
+    next = `${text.replace(/\s*$/, "")}\n\n## Working agreement\n\n${TASK_RULE}\n`;
+  }
+  next = next.replace(/\n{4,}/g, "\n\n\n");
+
+  if (!dry) write(root, rel, next);
+  return { status: "added", rel, section: heading ? "Operator preferences" : "Working agreement" };
+}

package/src/cli.mjs

@@ -6,6 +6,7 @@ import { detect, summarise, TOOLS } from "./detect.mjs";
 import { load, write, readIfExists, matches, BANNER, DIR } from "./source.mjs";
 import { adopt } from "./adopt.mjs";
 import { installPlugin, MARKETPLACE, MARKETPLACE_NAME, PLUGIN } from "./plugin.mjs";
+import { ensureTodoEnv, ensureTaskRule, TODO_ENV } from "./claude-setup.mjs";
 import { compile, TARGETS } from "./targets.mjs";
 
 const bold = (s) => `\x1b[1m${s}\x1b[0m`;
@@ -210,6 +211,27 @@ Pick one:
     // The rules are done and safe at this point. The Claude Code plugin is the
     // other half — agents, skills, per-agent memory, the session hook — and it
     // installs from the same repo. Only on `init`, never on `sync`.
+    if (cmd === "init" && targets.includes("claude-code")) {
+      console.log(`\n${bold("Claude Code setup")}\n`);
+
+      const e = ensureTodoEnv(root, { dry });
+      const eMsg = {
+        added: `  ${e.rel}  ${dim(`env.${TODO_ENV} = "1"`)}`,
+        present: `  ${e.rel}  ${dim(`env.${TODO_ENV} already set`)}`,
+        conflict: `  ${e.rel}  ${dim(`env.${TODO_ENV} is "${e.current}" — left as you set it`)}`,
+        invalid: `  ${e.rel}  ${dim("is not valid JSON — left alone, fix it and re-run")}`,
+      }[e.status];
+      console.log(eMsg);
+
+      const t = ensureTaskRule(root, { dry });
+      const tMsg = {
+        added: `  ${t.rel}  ${dim(`task-tracking rule added under ${t.section}`)}`,
+        present: `  ${t.rel}  ${dim("task-tracking rule already there")}`,
+        "no-file": `  ${t.rel}  ${dim("absent — run /agent-os:init inside Claude Code to build it")}`,
+      }[t.status];
+      console.log(tMsg);
+    }
+
     if (cmd === "init" && targets.includes("claude-code") && !argv.includes("--no-plugin")) {
       console.log(`\n${bold("Claude Code plugin")} ${dim(`${PLUGIN}@${MARKETPLACE_NAME}`)}\n`);
       const r = installPlugin({ dry });

package/src/selftest.mjs

@@ -114,6 +114,47 @@ try {
     rmSync(r3, { recursive: true, force: true });
   }
 
+  console.log("\n  Claude Code project setup");
+  {
+    const r5 = mkdtempSync(join(tmpdir(), "agent-os-cc-"));
+    mkdirSync(join(r5, ".claude"), { recursive: true });
+    // An existing settings.json with unrelated keys must survive untouched.
+    writeFileSync(join(r5, ".claude/settings.json"),
+      JSON.stringify({ permissions: { deny: ["Bash(git push *)"] }, env: { FOO: "bar" } }, null, 2));
+    writeFileSync(join(r5, "CLAUDE.md"),
+      "# CLAUDE.md\n\nStack notes.\n\n## Operator preferences\n\n- Never run git unasked.\n\n## Verification\n\nRun make test.\n");
+
+    cli(["init", "--no-plugin"], r5);
+    const st = JSON.parse(readFileSync(join(r5, ".claude/settings.json"), "utf8"));
+    ok(st.env.CLAUDE_CODE_ENABLE_TODO_TOOLS === "1", "todo tools enabled in project settings");
+    ok(st.env.FOO === "bar", "existing env keys preserved");
+    ok(st.permissions?.deny?.[0] === "Bash(git push *)", "existing permissions preserved");
+
+    const cm = readFileSync(join(r5, "CLAUDE.md"), "utf8");
+    ok(cm.includes("TaskCreate / TaskUpdate"), "task-tracking rule added to CLAUDE.md");
+    ok(cm.indexOf("TaskCreate") > cm.indexOf("## Operator preferences") &&
+       cm.indexOf("TaskCreate") < cm.indexOf("## Verification"),
+       "rule lands inside Operator preferences, not at the end");
+    ok(cm.includes("Never run git unasked."), "existing CLAUDE.md content preserved");
+
+    // Idempotent: a second init must not duplicate either.
+    cli(["init", "--no-plugin"], r5);
+    const cm2 = readFileSync(join(r5, "CLAUDE.md"), "utf8");
+    ok(cm2.split("TaskCreate").length - 1 === 1, "second init does not duplicate the rule");
+
+    // A user who set the flag their own way keeps their value.
+    const r6 = mkdtempSync(join(tmpdir(), "agent-os-cc2-"));
+    mkdirSync(join(r6, ".claude"), { recursive: true });
+    writeFileSync(join(r6, ".claude/settings.json"),
+      JSON.stringify({ env: { CLAUDE_CODE_ENABLE_TODO_TOOLS: "true" } }, null, 2));
+    cli(["init", "--no-plugin"], r6);
+    ok(JSON.parse(readFileSync(join(r6, ".claude/settings.json"), "utf8"))
+       .env.CLAUDE_CODE_ENABLE_TODO_TOOLS === "true", "an existing truthy value is left as the user set it");
+
+    rmSync(r5, { recursive: true, force: true });
+    rmSync(r6, { recursive: true, force: true });
+  }
+
   console.log("\n  merge, not overwrite");
   writeFileSync(join(root, "opencode.json"), JSON.stringify({ model: "anthropic/x", instructions: ["KEEP.md"] }, null, 2));
   cli(["sync"], root);