planr 2.0.0-beta.1 → 2.0.1

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "planr",
-  "version": "2.0.0-beta.1",
+  "version": "2.0.1",
   "description": "Small planning layer for agent-built products: Markdown task graph, CLI, board.",
   "author": {
     "name": "instructa"

package/CHANGELOG.md

@@ -3,6 +3,19 @@
 This file follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 Versions follow [Semantic Versioning](https://semver.org/).
 
+## [2.0.1] - 2026-10-20
+
+### Fixed
+
+- Run history is rebuilt in linear time: `check` and `board` take 0.3 s instead of 3 s on a repository
+  with 2,700 commits and stay under 10 s at ten times that size. Output is unchanged.
+- A failed Git history read now reports `history: … runs unavailable` instead of an empty history.
+
+## [2.0.0] - 2026-10-05
+
+First stable release of planr 2.0, unchanged from 2.0.0-beta.1; see the entry below for the changes.
+Version 1.x remains available as `planr@1` on npm and `instructa/tap/planr@1` on Homebrew.
+
 ## [2.0.0-beta.1] - 2026-10-05
 
 ### Changed

package/README.md

@@ -2,10 +2,6 @@
 
 A small planning layer for agent-built products, using Markdown files in Git.
 
-During the 2.0 beta, use `npm install -g planr@next` or `npx planr@next`; plain `planr` installs 1.x
-until 2.0.0 ships.
-Plugin installs get the beta through the pinned marketplaces.
-
 When several coding agents work on one product, planr shows what is ready,
 blocked, waiting on you & what changed. Tasks & their dependencies live in a
 planning repository, usually separate from your code & often private.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "planr",
-  "version": "2.0.0-beta.1",
+  "version": "2.0.1",
   "description": "Small planning layer for agent-built products: Markdown task graph, CLI, board.",
   "type": "module",
   "bin": { "planr": "skills/planr/scripts/planr.mjs" },

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "planr",
-  "version": "2.0.0-beta.1",
+  "version": "2.0.1",
   "description": "Small planning layer for agent-built products: Markdown task graph, CLI, board.",
   "author": {
     "name": "instructa"

package/skills/planr/SKILL.md

@@ -3,7 +3,7 @@ name: planr
 license: MIT
 description: Plan and track product work as a Markdown task graph in a planning repository - see what is ready, blocked or waiting on a decision, change task status safely, and work through one approved goal with the project's orchestrator. Use when the project keeps tasks as tasks/<ID>.md and goals as plans/<name>-goal.md, or when asked what is next, about task status, ready or blocked tasks, or to "work goal <name>". Not for building code itself.
 metadata:
-  version: "2.0.0-beta.1"
+  version: "2.0.1"
 ---
 
 # planr

package/skills/planr/scripts/lib/graph.mjs

@@ -4,8 +4,8 @@ import { join, resolve, relative, dirname } from 'node:path';
 
 export const statuses = ['open', 'in-progress', 'review', 'blocked', 'decision', 'done', 'dropped'];
 export const states = ['draft', 'approved', 'running', 'done', 'review'];
-export const compare = (a, b) =>
-  a.localeCompare(b, 'en', { numeric: true }) || (a < b ? -1 : a > b ? 1 : 0);
+const collator = new Intl.Collator('en', { numeric: true });
+export const compare = (a, b) => collator.compare(a, b) || (a < b ? -1 : a > b ? 1 : 0);
 export const json = value => JSON.stringify(value, null, 2) + '\n';
 
 export function config(root, defaults = JSON.parse(readFileSync(
@@ -197,16 +197,23 @@ export function buildIndex(root, c = config(root), read = file => readFileSync(f
     }
     t.openDeps = t.depends.filter(d => !['review', 'done'].includes(byId.get(d)?.status));
     t.ready = t.status === 'open' && !t.openDeps.length;
-    t.waitingOn = tasks
-      .filter(x => !['done', 'dropped'].includes(x.status) && x.depends.includes(t.id))
-      .map(x => x.id);
+  }
+  // Reverse edges in one pass; tasks are sorted, so each list keeps the sorted order.
+  const waitingOn = new Map(tasks.map(t => [t.id, []]));
+  const unlocks = new Map();
+  for (const x of tasks) {
+    if (!['done', 'dropped'].includes(x.status)) {
+      for (const d of new Set(x.depends)) {
+        waitingOn.get(d)?.push(x.id);
+      }
+    }
+    if (x.status === 'open' && x.openDeps.length === 1) {
+      unlocks.set(x.openDeps[0], (unlocks.get(x.openDeps[0]) ?? 0) + 1);
+    }
   }
   for (const t of tasks) {
-    t.unlocks = ['review', 'done', 'dropped'].includes(t.status)
-      ? 0
-      : tasks.filter(x =>
-          x.status === 'open' && x.openDeps.length === 1 && x.openDeps[0] === t.id
-        ).length;
+    t.waitingOn = [...waitingOn.get(t.id)];
+    t.unlocks = ['review', 'done', 'dropped'].includes(t.status) ? 0 : unlocks.get(t.id) ?? 0;
   }
   const visited = new Set();
   const active = [];

package/skills/planr/scripts/lib/runs.mjs

@@ -1,4 +1,4 @@
-import { execFileSync } from 'node:child_process';
+import { execFileSync, spawnSync } from 'node:child_process';
 import { posix } from 'node:path';
 import { compare, taskFile, taskStatus } from './graph.mjs';
 
@@ -17,6 +17,16 @@ export function git(root, args, input) {
   }
 }
 
+// History reads must fail loudly: a silently empty or truncated read would rewrite every run.
+function strict(root, args, input) {
+  const out = spawnSync('git', args, { cwd: root, input, maxBuffer: 1 << 30 });
+  if (out.error || out.status !== 0) {
+    const reason = out.error?.message ?? String(out.stderr).trim().split('\n')[0];
+    throw new Error(`git ${args[0]} failed: ${reason}`);
+  }
+  return out.stdout;
+}
+
 export function runs(root, index, c, now = new Date().toISOString()) {
   const mode = git(root, ['rev-parse', '--is-shallow-repository']);
   const warnings = mode === 'false' ? [] : [
@@ -25,10 +35,18 @@ export function runs(root, index, c, now = new Date().toISOString()) {
   ];
   const prefix = git(root, ['rev-parse', '--show-prefix']) +
     posix.normalize(c.tasksDir).replace(/\/$/, '') + '/';
-  const log = mode ? git(root, [
-    'log', '--first-parent', '--reverse', '--format=%x00PLANR%x09%H%x09%cI%x09%s',
-    '--raw', '-z', '--no-abbrev', '--no-renames', '--root', '--diff-merges=first-parent', '--', c.tasksDir,
-  ]) : '';
+  let log = '';
+  let batch = Buffer.alloc(0);
+  let failed = false;
+  try {
+    log = mode && git(root, ['rev-parse', '--verify', '--quiet', 'HEAD']) ? strict(root, [
+      'log', '--first-parent', '--reverse', '--format=%x00PLANR%x09%H%x09%cI%x09%s', '--raw', '-z',
+      '--no-abbrev', '--no-renames', '--root', '--diff-merges=first-parent', '--', c.tasksDir,
+    ]).toString('utf8').trimEnd() : '';
+  } catch (e) {
+    warnings.push(`history: ${e.message}; runs unavailable`);
+    failed = true;
+  }
   const records = [];
   const parts = log.split('\0');
   for (let i = 0; i < parts.length; i++) {
@@ -47,9 +65,13 @@ export function runs(root, index, c, now = new Date().toISOString()) {
   const hashes = [...new Set(records.flatMap(r =>
     r.files.filter(f => !f.removed).map(f => f.blob)
   ))];
-  const batch = hashes.length
-    ? git(root, ['cat-file', '--batch'], hashes.join('\n') + '\n')
-    : Buffer.alloc(0);
+  try {
+    batch = hashes.length ? strict(root, ['cat-file', '--batch'], hashes.join('\n') + '\n') : batch;
+  } catch (e) {
+    warnings.push(`history: ${e.message}; runs unavailable`);
+    failed = true;
+    records.length = 0;
+  }
   const blobs = new Map();
   let cursor = 0;
   while (cursor < batch.length) {
@@ -67,13 +89,14 @@ export function runs(root, index, c, now = new Date().toISOString()) {
   }
   const result = [];
   const history = new Map(index.tasks.map(t => [t.id, []]));
-  let previous = new Map();
-  const changesBetween = current => [...new Set([...previous.keys(), ...current.keys()])]
-    .sort(compare)
-    .filter(id => current.get(id) !== previous.get(id))
-    .map(id => ({ id, from: previous.get(id) ?? null, to: current.get(id) ?? 'removed' }));
-  const append = (s, current) => {
-    const changes = changesBetween(current);
+  // One status map is updated in place per commit; only the IDs a commit touched are compared and sorted.
+  const current = new Map();
+  const append = (s, before) => {
+    const changes = [...before]
+      .filter(([id, from]) => current.get(id) !== from)
+      .map(([id]) => id)
+      .sort(compare)
+      .map(id => ({ id, from: before.get(id) ?? null, to: current.get(id) ?? 'removed' }));
     if (changes.length) {
       const initial = !result.length;
       result.push({
@@ -92,12 +115,14 @@ export function runs(root, index, c, now = new Date().toISOString()) {
         history.get(change.id)?.push({ run: result.length - 1, from: change.from, to: change.to });
       }
     }
-    previous = current;
   };
   for (const record of records) {
-    const current = new Map(previous);
+    const before = new Map();
     for (const f of record.files) {
       const id = f.file.slice(prefix.length, -3);
+      if (!before.has(id)) {
+        before.set(id, current.get(id));
+      }
       if (f.removed) {
         current.delete(id);
       } else {
@@ -108,11 +133,20 @@ export function runs(root, index, c, now = new Date().toISOString()) {
         }
       }
     }
-    append(record, current);
+    append(record, before);
   }
-  if (mode) {
-    append({ commit: null, date: now, subject: 'Uncommitted changes' },
-      new Map(index.tasks.map(t => [t.id, t.status])));
+  if (mode && !failed) {
+    const before = new Map(current);
+    current.clear();
+    for (const t of index.tasks) {
+      current.set(t.id, t.status);
+    }
+    for (const id of current.keys()) {
+      if (!before.has(id)) {
+        before.set(id, undefined);
+      }
+    }
+    append({ commit: null, date: now, subject: 'Uncommitted changes' }, before);
   }
   const tasks = index.tasks.map(t => {
     const h = history.get(t.id);