runlist 0.0.0 → 0.94.1

package/src/check-collapse.mjs

@@ -0,0 +1,75 @@
+// F13 (0.37.0): collapse high-frequency auto-fixable `runlist check` warnings
+// into one-line remediation hints. Without this, bulk-fixable noise (43
+// `updated behind git history`, N singular-key deprecations) drowns out
+// structural findings in the per-doc list — and forces the reader to
+// reconstruct the fix command per category.
+//
+// Each category names the message regex to match, a short label for the
+// summary line, and the exact `runlist …` command that bulk-fixes it.
+
+const COLLAPSE_THRESHOLD = 3;
+
+const CATEGORIES = [
+  {
+    key: 'updated-behind-git',
+    match: /^frontmatter `updated:.*` is behind git history/,
+    label: 'docs have `updated` behind git history',
+    fix: 'runlist touch --git',
+  },
+  {
+    key: 'singular-module',
+    match: /^`module:` \(singular\) is deprecated.*Run `runlist lint --fix`/,
+    label: 'docs use deprecated singular `module:`',
+    fix: 'runlist lint --fix',
+  },
+  {
+    key: 'singular-surface',
+    match: /^`surface:` \(singular\) is deprecated.*Run `runlist lint --fix`/,
+    label: 'docs use deprecated singular `surface:`',
+    fix: 'runlist lint --fix',
+  },
+];
+
+function categoryFor(message) {
+  for (const cat of CATEGORIES) {
+    if (cat.match.test(message)) return cat;
+  }
+  return null;
+}
+
+// Split warnings into per-doc passthrough lines and collapsed summary buckets.
+// A category that hits ≥COLLAPSE_THRESHOLD warnings is summarized; below the
+// threshold each warning falls through as a normal per-doc line (small counts
+// don't gain from collapse and lose path information).
+export function categorizeWarnings(warnings) {
+  const buckets = new Map();
+  const orphans = [];
+
+  for (const w of warnings) {
+    const cat = categoryFor(w.message);
+    if (!cat) {
+      orphans.push(w);
+      continue;
+    }
+    if (!buckets.has(cat.key)) buckets.set(cat.key, { cat, items: [] });
+    buckets.get(cat.key).items.push(w);
+  }
+
+  const collapsed = [];
+  const passthrough = [...orphans];
+
+  for (const { cat, items } of buckets.values()) {
+    if (items.length >= COLLAPSE_THRESHOLD) {
+      collapsed.push({ key: cat.key, label: cat.label, fix: cat.fix, count: items.length });
+    } else {
+      passthrough.push(...items);
+    }
+  }
+
+  passthrough.sort((a, b) => a.path.localeCompare(b.path));
+  collapsed.sort((a, b) => b.count - a.count || a.key.localeCompare(b.key));
+
+  return { passthrough, collapsed };
+}
+
+export const _internalForTest = { COLLAPSE_THRESHOLD, CATEGORIES };

package/src/claude-commands.mjs

@@ -0,0 +1,75 @@
+import { existsSync, readdirSync, readFileSync, unlinkSync } from 'node:fs';
+import path from 'node:path';
+
+// runlist used to scaffold per-repo `.claude/commands/{plans,docs}.md` slash
+// commands — version-stamped, generated from each repo's status vocab, and
+// self-healed by `runlist hud`. That mechanism is RETIRED. The runlist Claude Code
+// plugin (plugins/runlist/skills/runlist/SKILL.md + bundled hooks) now carries the
+// canonical agent-facing workflow into every repo and every subagent, and
+// `runlist hud` injects the dynamic per-project status vocab at runtime. A static
+// skill + a runtime hook covers the full picture with no per-repo file to drift.
+//
+// The only job left in this module is teardown: delete the stale generated
+// command files runlist left behind so retired scaffolding stops shadowing the
+// plugin skill. Removal is banner-gated — files WITHOUT a generated marker are
+// hand-authored (e.g. a repo's own module-*.md / domain-*.md briefings) and are
+// NEVER touched. Every generated file is fair game, including legacy ones
+// runlist no longer generates (e.g. the old baton.md).
+
+// Nothing writes these files any more, so only the legacy banner can exist in
+// the wild; the current spelling is accepted too so a banner-gated teardown
+// never depends on which name stamped the file.
+const GENERATED_MARKERS = ['<!-- runlist-generated:', '<!-- dotmd-generated:'];
+
+// The marker sits just below the YAML frontmatter Claude Code surfaces as the
+// command description. That description can be long (the retired plans.md baked
+// the full per-type status vocab into it), pushing the banner well past the
+// first kilobyte — so classify against the whole file, not a head slice. These
+// are tiny command files, so reading them in full is cheap.
+function isGeneratedCommandFile(filePath) {
+  try {
+    const contents = readFileSync(filePath, 'utf8');
+    return GENERATED_MARKERS.some(marker => contents.includes(marker));
+  } catch {
+    return false;
+  }
+}
+
+// Remove every banner-stamped slash-command file under .claude/commands.
+// Returns [{ name, action: 'removed' }] for each file cleaned (or that would be
+// cleaned, in dry-run). Never throws — teardown must not break a hook or a
+// command. User-authored command files (no generated banner) survive untouched.
+export function removeGeneratedSlashCommands(cwd, opts = {}) {
+  const { dryRun = false } = opts;
+  const commandsDir = path.join(cwd, '.claude', 'commands');
+  if (!existsSync(commandsDir)) return [];
+  let entries;
+  try { entries = readdirSync(commandsDir); } catch { return []; }
+  const removed = [];
+  for (const name of entries) {
+    if (!name.endsWith('.md')) continue;
+    const filePath = path.join(commandsDir, name);
+    if (!isGeneratedCommandFile(filePath)) continue;
+    if (!dryRun) {
+      try { unlinkSync(filePath); } catch { continue; }
+    }
+    removed.push({ name, action: 'removed' });
+  }
+  return removed;
+}
+
+// Self-heal entrypoint for `runlist hud` (SessionStart hook). Was: regenerate
+// stale slash commands. Now: delete the retired generated files so the plugin
+// skill is the single source of truth. Returns only the removed entries; an
+// empty array preserves hud's silent-clean contract. Kept under the old name so
+// hud's call site (and its swallow-all-errors wrapper) is unchanged.
+export function refreshStaleSlashCommands(config) {
+  return removeGeneratedSlashCommands(config.repoRoot);
+}
+
+// Retained as a no-op for API stability. `runlist check` never warned on slash
+// commands (the old auto-heal made it pure noise), and now there is nothing to
+// generate at all. See git history for the retired scaffolder.
+export function checkClaudeCommands(_cwd, _opts = {}) {
+  return [];
+}

package/src/cli-editor.mjs

@@ -0,0 +1,8 @@
+import os from 'node:os';import path from 'node:path';import {createHash} from 'node:crypto';
+import {createSourceEditor,SourceEditError} from './source-editor.mjs';import {hostSessionSource} from './util.mjs';
+export function cliEditor(config,file,{env=process.env,domainPrepare=null}={}) {
+  const session=hostSessionSource(env),agent=session?.scope==='session';
+  if(session?.scope==='process')throw new SourceEditError('invalid-actor','An agent needs a session-scoped identity before recording an action.');
+  const actor=agent?{kind:'agent',id:session.id,session_id:session.id,label:session.host??session.id}:{kind:'human',id:`human:local:${createHash('sha256').update(`${os.userInfo().username}:${os.userInfo().uid}`).digest('hex').slice(0,24)}`,label:os.userInfo().username};
+  const editor=createSourceEditor({config,domainPrepare,legacyTypes:[...(config.validTypes??['plan','doc'])].filter(t=>t!=='prompt'),authenticate:()=>actor,authorize:({path:target})=>({allowed:target===file&&!path.relative(config.repoRoot,target).split(path.sep).some(p=>p==='prompts'||p==='.git'||config.excludeDirs?.has(p)),...(agent?{grant_id:`cli:record:${actor.session_id}:${path.relative(config.repoRoot,file)}`}:{})})});return {actor,editor};
+}