@rness/cli 0.3.0 → 0.5.0

package/dist/chunk-4KNZT4G4.js

@@ -1,791 +0,0 @@
-// src/version.ts
-var VERSION = "0.3.0";
-
-// src/core/fs.ts
-import { access, lstat, readFile, rename, rm, writeFile } from "fs/promises";
-import { basename, dirname, join } from "path";
-async function exists(p) {
-  try {
-    await access(p);
-    return true;
-  } catch {
-    return false;
-  }
-}
-async function isSymlink(p) {
-  try {
-    return (await lstat(p)).isSymbolicLink();
-  } catch (e) {
-    if (e.code === "ENOENT") return false;
-    throw e;
-  }
-}
-async function readOrNull(p) {
-  try {
-    return await readFile(p, "utf8");
-  } catch (e) {
-    if (e.code === "ENOENT") return null;
-    throw e;
-  }
-}
-var sequence = 0;
-async function writeFileAtomic(p, text) {
-  sequence += 1;
-  const tmp = join(dirname(p), `.${basename(p)}.${process.pid}.${sequence}.tmp`);
-  await writeFile(tmp, text, "utf8");
-  try {
-    await rename(tmp, p);
-  } catch (e) {
-    await rm(tmp, { force: true }).catch(() => void 0);
-    throw e;
-  }
-}
-
-// src/core/workspace.ts
-import { dirname as dirname2, join as join2, parse, resolve } from "path";
-async function findWorkspace(startDir) {
-  const start = resolve(startDir);
-  const { root: fsRoot } = parse(start);
-  const ancestors = [];
-  for (let dir = start; ; dir = dirname2(dir)) {
-    ancestors.push(dir);
-    if (dir === fsRoot) break;
-  }
-  for (const dir of ancestors) {
-    if (await exists(join2(dir, ".rness", "rness.json"))) return { root: dir, rnessDir: join2(dir, ".rness") };
-  }
-  for (const dir of ancestors) {
-    if (await exists(join2(dir, "rness.json"))) return { root: dirname2(dir), rnessDir: dir };
-  }
-  throw new Error(`no rness workspace found above ${startDir}`);
-}
-
-// src/core/manifest.ts
-import { readFile as readFile2 } from "fs/promises";
-import { basename as basename2, join as join3 } from "path";
-var NAME = /^[a-z0-9][a-z0-9-]*$/;
-function fail(message) {
-  throw new Error(`rness.json: ${message}`);
-}
-function isRecord(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-function checkPath(scope, path) {
-  if (typeof path !== "string" || path === "") fail(`scope "${scope}" needs a string "path"`);
-  if (path.startsWith("/")) fail(`scope "${scope}" path must be relative`);
-  if (path.split("/").includes("..")) fail(`scope "${scope}" path must not contain ".."`);
-  if (path.split("/").some((segment) => segment === "")) fail(`scope "${scope}" path must not contain empty segments`);
-  return path;
-}
-function readOrg(value) {
-  if (value === void 0 || value === null) return null;
-  if (typeof value !== "string" || !NAME.test(value)) {
-    fail(`"org" must be a name matching [a-z0-9-] (got ${JSON.stringify(value)})`);
-  }
-  return value;
-}
-function resolveOrg(manifest, root) {
-  if (manifest.org !== null) return { org: manifest.org, warning: null };
-  const name = basename2(root);
-  return { org: name, warning: `rness.json: no "org"; using the directory name "${name}"` };
-}
-function readRepos(value) {
-  const raw = value ?? {};
-  if (!isRecord(raw)) fail('"repos" must be an object');
-  const repos = {};
-  for (const [name, entry] of Object.entries(raw)) {
-    if (!NAME.test(name)) fail(`repo name "${name}" is not [a-z0-9-]`);
-    if (!isRecord(entry) || typeof entry.url !== "string") fail(`repo "${name}" needs a string "url"`);
-    repos[name] = { url: entry.url };
-  }
-  return repos;
-}
-function readScopes(value) {
-  const raw = value ?? {};
-  if (!isRecord(raw)) fail('"scopes" must be an object');
-  const scopes = {};
-  for (const [name, entry] of Object.entries(raw)) {
-    if (!NAME.test(name)) fail(`scope name "${name}" is not [a-z0-9-]`);
-    if (!isRecord(entry)) fail(`scope "${name}" must be an object`);
-    const path = checkPath(name, entry.path);
-    const ext = entry.extends ?? [];
-    if (!Array.isArray(ext) || !ext.every((t) => typeof t === "string")) {
-      fail(`scope "${name}" extends must be an array of scope names`);
-    }
-    scopes[name] = { path, extends: ext };
-  }
-  for (const [name, entry] of Object.entries(scopes)) {
-    for (const target of entry.extends) {
-      if (!Object.hasOwn(scopes, target)) fail(`scope "${name}" extends unknown scope "${target}"`);
-    }
-  }
-  return scopes;
-}
-async function loadManifest(rnessDir) {
-  let raw;
-  try {
-    raw = await readFile2(join3(rnessDir, "rness.json"), "utf8");
-  } catch {
-    fail("not found");
-  }
-  let data;
-  try {
-    data = JSON.parse(raw);
-  } catch (e) {
-    fail(`invalid JSON (${e instanceof Error ? e.message : String(e)})`);
-  }
-  if (!isRecord(data)) fail("must be a JSON object");
-  if (data.contract !== 1) fail(`unsupported contract: ${JSON.stringify(data.contract)} (expected 1)`);
-  return { contract: 1, org: readOrg(data.org), repos: readRepos(data.repos), scopes: readScopes(data.scopes) };
-}
-
-// src/core/scope.ts
-function isPrefix(prefix, target) {
-  return prefix === target || target.startsWith(`${prefix}/`);
-}
-function resolveScope(manifest, relDir) {
-  let best = null;
-  let bestLen = -1;
-  for (const [name, entry] of Object.entries(manifest.scopes)) {
-    if (isPrefix(entry.path, relDir) && entry.path.length > bestLen) {
-      best = name;
-      bestLen = entry.path.length;
-    }
-  }
-  return best;
-}
-function scopeChain(manifest, scope) {
-  if (scope === null) return [];
-  const chain = [];
-  const seen = /* @__PURE__ */ new Set();
-  const visit = (name, stack) => {
-    if (stack.has(name)) throw new Error(`extends cycle at scope "${name}"`);
-    if (seen.has(name)) return;
-    seen.add(name);
-    chain.push(name);
-    stack.add(name);
-    const entry = Object.hasOwn(manifest.scopes, name) ? manifest.scopes[name] : void 0;
-    for (const target of entry?.extends ?? []) visit(target, stack);
-    stack.delete(name);
-  };
-  visit(scope, /* @__PURE__ */ new Set());
-  return chain;
-}
-
-// src/core/frontmatter.ts
-import { parse as parse2 } from "yaml";
-var FRONT_MATTER = /^---\r?\n(?:([\s\S]*?)\r?\n)?---(?:\r?\n|$)/;
-function fail2(message) {
-  throw new Error(`front matter: ${message}`);
-}
-function stripBom(source) {
-  return source.startsWith("\uFEFF") ? source.slice(1) : source;
-}
-function parseFrontMatter(source) {
-  const match = stripBom(source).match(FRONT_MATTER);
-  if (match === null) return null;
-  const block = match[1] ?? "";
-  if (block.trim() === "") return {};
-  let doc;
-  try {
-    doc = parse2(block, { logLevel: "error" });
-  } catch (e) {
-    fail2(e instanceof Error ? (e.message.split("\n")[0] ?? "invalid YAML").replace(/:$/, "") : "invalid YAML");
-  }
-  if (doc === null || doc === void 0) return {};
-  if (typeof doc !== "object" || Array.isArray(doc)) fail2("block must be a mapping of keys to values");
-  return doc;
-}
-function stripFrontMatter(source) {
-  const text = stripBom(source);
-  const match = text.match(FRONT_MATTER);
-  if (match === null) return text;
-  return text.slice(match[0].length).replace(/^(?:[ \t]*\r?\n)+/, "");
-}
-function extractTitle(source) {
-  return stripBom(source).match(/^# (.+)$/m)?.[1]?.trim() ?? null;
-}
-
-// src/core/collect.ts
-import { glob, readFile as readFile3 } from "fs/promises";
-import { join as join4, posix, sep } from "path";
-function toPosix(rel) {
-  return rel.split(sep).join(posix.sep);
-}
-async function collectMarkdown(dir) {
-  const rels = [];
-  for await (const rel of glob("**/*.md", { cwd: dir })) rels.push(toPosix(rel));
-  const items = await Promise.all(
-    rels.map(async (rel) => {
-      const path = join4(dir, ...rel.split(posix.sep));
-      const body = await readFile3(path, "utf8");
-      let fields = null;
-      let fieldsError = null;
-      try {
-        fields = parseFrontMatter(body);
-      } catch (e) {
-        fieldsError = e instanceof Error ? e.message : String(e);
-      }
-      return { path, rel, fields, fieldsError, title: extractTitle(body), body, content: stripFrontMatter(body) };
-    })
-  );
-  return items.sort((a, b) => a.rel < b.rel ? -1 : a.rel > b.rel ? 1 : 0);
-}
-
-// src/core/context.ts
-import { join as join5 } from "path";
-var COLLECTIONS = ["standards", "adr", "specs", "plans", "skills"];
-function ownerScope(rel) {
-  const slash = rel.indexOf("/");
-  return slash === -1 ? null : rel.slice(0, slash);
-}
-async function assembleCollection(dir, name, chain) {
-  const items = await collectMarkdown(dir);
-  const groups = new Map(chain.map((s) => [s, []]));
-  const rootFiles = [];
-  for (const item of items) {
-    const owner = ownerScope(item.rel);
-    if (owner === null) rootFiles.push({ ...item, scope: null });
-    else groups.get(owner)?.push({ ...item, scope: owner });
-  }
-  const files = [];
-  const push = (f) => {
-    files.push({ rel: f.rel, scope: f.scope, title: f.title, body: f.body, content: f.content });
-  };
-  for (const s of chain) for (const f of groups.get(s) ?? []) push(f);
-  for (const f of rootFiles) push(f);
-  return { name, files };
-}
-async function assembleContext({ rnessDir, manifest, scope }) {
-  const chain = scopeChain(manifest, scope);
-  const collections = await Promise.all(
-    COLLECTIONS.map((name) => assembleCollection(join5(rnessDir, name), name, chain))
-  );
-  return { scope, collections };
-}
-
-// src/report.ts
-function reportError(e) {
-  const debug = process.env["RNESS_DEBUG"] === "1";
-  if (debug && e instanceof Error && e.stack) {
-    process.stderr.write(`${e.stack}
-`);
-  } else {
-    const message = e instanceof Error ? e.message : String(e);
-    process.stderr.write(`${message}
-`);
-  }
-  return 1;
-}
-
-// src/commands/context.ts
-import { posix as posix2, relative, sep as sep2 } from "path";
-function renderMarkdown(ctx) {
-  const parts = [];
-  for (const collection of ctx.collections) {
-    if (collection.files.length === 0) continue;
-    parts.push(`## ${collection.name}
-`);
-    for (const file of collection.files) {
-      parts.push(`<!-- rness: ${collection.name}/${file.rel} -->
-${file.content.trim()}
-`);
-    }
-  }
-  return `${parts.join("\n")}
-`;
-}
-async function contextCommand(opts) {
-  const cwd = opts.cwd ?? process.cwd();
-  try {
-    const ws = await findWorkspace(cwd);
-    const manifest = await loadManifest(ws.rnessDir);
-    let scope;
-    if (opts.scope !== void 0) {
-      if (!Object.hasOwn(manifest.scopes, opts.scope)) {
-        process.stderr.write(`unknown scope: ${opts.scope}
-`);
-        return 1;
-      }
-      scope = opts.scope;
-    } else {
-      const rel = relative(ws.root, cwd).split(sep2).join(posix2.sep);
-      scope = resolveScope(manifest, rel);
-    }
-    const ctx = await assembleContext({ rnessDir: ws.rnessDir, manifest, scope });
-    process.stdout.write(opts.json ? `${JSON.stringify(ctx, null, 2)}
-` : renderMarkdown(ctx));
-    return 0;
-  } catch (e) {
-    return reportError(e);
-  }
-}
-
-// src/core/contract.ts
-import { join as join6 } from "path";
-var STATUSES = {
-  adr: ["Proposed", "Accepted", "Rejected", "Superseded"],
-  specs: ["Draft", "Proposed", "Approved", "Implemented", "Superseded", "Rejected"],
-  plans: ["Draft", "Ready", "In progress", "Blocked", "Completed", "Abandoned"]
-};
-var SKIP = /* @__PURE__ */ new Set(["adr/0000-template.md"]);
-var PLACEMENT_KEYS = ["scopes", "scope"];
-async function checkContract(rnessDir) {
-  const problems = [];
-  for (const name of COLLECTIONS) {
-    const allowed = STATUSES[name];
-    const items = await collectMarkdown(join6(rnessDir, name));
-    for (const item of items) {
-      const where = `${name}/${item.rel}`;
-      if (SKIP.has(where)) continue;
-      if (item.fieldsError !== null) {
-        problems.push(`${where}: invalid front matter (${item.fieldsError})`);
-        continue;
-      }
-      if (item.fields !== null) {
-        for (const key of PLACEMENT_KEYS) {
-          if (Object.hasOwn(item.fields, key)) {
-            problems.push(`${where}: front matter "${key}" is not supported \u2014 the directory decides the scope; move the file`);
-          }
-        }
-      }
-      if (allowed === void 0) continue;
-      if (item.fields === null) {
-        problems.push(`${where}: missing a front-matter block`);
-        continue;
-      }
-      if (item.title === null) problems.push(`${where}: missing a "# " title`);
-      const status = item.fields["status"];
-      if (status === void 0 || status === null || status === "") {
-        problems.push(`${where}: missing "status"`);
-      } else if (typeof status !== "string" || !allowed.includes(status)) {
-        problems.push(`${where}: unknown status ${JSON.stringify(status)} (expected ${allowed.join(", ")})`);
-      }
-    }
-  }
-  return problems;
-}
-
-// src/core/block.ts
-import { createHash } from "crypto";
-var BEGIN = "<!-- BEGIN rness -->";
-var END = "<!-- END rness -->";
-var BLOCK_SIZE_WARNING = 32 * 1024;
-var HEADER = /^<!-- rness (\S+) · scope: (\S+) · contract: 1 · hash: ([0-9a-f]{12}) · generated: run `rness sync`, never edit inside this block -->$/;
-function toLf(s) {
-  return s.replace(/\r\n?/g, "\n");
-}
-function blockHash(body) {
-  return createHash("sha256").update(toLf(body), "utf8").digest("hex").slice(0, 12);
-}
-function intro(scope, org, depth) {
-  if (scope === null) {
-    return [
-      `This is the root of rness workspace \`${org}\`. Full context lives in \`.rness/\` \u2014`,
-      "read `STATUS.md`, then task-relevant `adr/`, `specs/`, `plans/`; live: `rness context`.",
-      "Every `org/<repo>/` carries its own block with the rules that apply there."
-    ].join("\n");
-  }
-  const rel = `${"../".repeat(depth)}.rness/`;
-  return [
-    `This directory is scope \`${scope}\` of rness workspace \`${org}\`. Full context lives in`,
-    `\`${rel}\` \u2014 read \`STATUS.md\`, then task-relevant \`adr/\`, \`specs/\`, \`plans/\`;`,
-    `live: \`rness context --scope ${scope}\`. If \`.rness/\` is not reachable, this is a`,
-    "standalone clone: the rules below are all you have."
-  ].join("\n");
-}
-function header(version, scope, hash) {
-  return `<!-- rness ${version} \xB7 scope: ${scope ?? "global"} \xB7 contract: 1 \xB7 hash: ${hash} \xB7 generated: run \`rness sync\`, never edit inside this block -->`;
-}
-function renderBlock({ scope, org, depth, context, version }) {
-  const standards = context.collections.find((c) => c.name === "standards")?.files ?? [];
-  const rules = standards.length === 0 ? ["_No standards apply to this scope yet._"] : standards.map((f) => `<!-- rness: standards/${f.rel} -->
-${toLf(f.content).trim()}`);
-  const body = `${intro(scope, org, depth)}
-
-## Rules
-${rules.join("\n\n")}`;
-  const hash = blockHash(body);
-  const text = [BEGIN, header(version, scope, hash), body, END].join("\n");
-  return { text, hash, bytes: Buffer.byteLength(text, "utf8") };
-}
-function parseHeader(line) {
-  const m = HEADER.exec(line.trimEnd());
-  if (m === null) return null;
-  return { version: m[1] ?? "", scope: m[2] ?? "", hash: m[3] ?? "" };
-}
-function bodyOf(blockLines) {
-  return blockLines.slice(2, -1).join("\n");
-}
-
-// src/core/merge.ts
-import { join as join7 } from "path";
-function findBlock(lines) {
-  const begins = [];
-  const ends = [];
-  lines.forEach((line, i) => {
-    const l = line.trimEnd();
-    if (l === BEGIN) begins.push(i);
-    if (l === END) ends.push(i);
-  });
-  if (begins.length === 0 && ends.length === 0) return { kind: "none" };
-  const begin = begins[0];
-  const end = ends[0];
-  if (begins.length !== 1 || ends.length !== 1 || begin === void 0 || end === void 0) {
-    return { kind: "error", message: `expected exactly one ${BEGIN} \u2026 ${END} span, found ${begins.length} BEGIN and ${ends.length} END` };
-  }
-  if (end < begin) return { kind: "error", message: `${END} comes before ${BEGIN}` };
-  return { kind: "one", begin, end };
-}
-function mergeBlock(existing, block) {
-  if (existing === null) return { ok: true, text: `${block}
-`, changed: true };
-  const eol = existing.includes("\r\n") ? "\r\n" : "\n";
-  const lines = existing.split(/\r?\n/);
-  const found = findBlock(lines);
-  if (found.kind === "error") return { ok: false, error: found.message };
-  const rendered = block.split("\n").join(eol);
-  const starts = [0];
-  for (const m of existing.matchAll(/\r?\n/g)) starts.push((m.index ?? 0) + m[0].length);
-  const lineStart = (i) => starts[i] ?? existing.length;
-  let text;
-  if (found.kind === "one") {
-    const endLine = lines[found.end] ?? "";
-    const afterEnd = lineStart(found.end) + endLine.length;
-    text = `${existing.slice(0, lineStart(found.begin))}${rendered}${existing.slice(afterEnd)}`;
-  } else if (lines.length >= 3 && (lines[0] ?? "").startsWith("# ") && lines[1] === "") {
-    const at = lineStart(2);
-    text = `${existing.slice(0, at)}${rendered}${eol}${eol}${existing.slice(at)}`;
-  } else {
-    text = `${rendered}${eol}${eol}${existing}`;
-  }
-  return { ok: true, text, changed: text !== existing };
-}
-async function ensureClaudeMd(dir) {
-  const file = join7(dir, "CLAUDE.md");
-  if (await isSymlink(file)) return "unchanged";
-  const existing = await readOrNull(file);
-  if (existing === null) {
-    await writeFileAtomic(file, "@AGENTS.md\n");
-    return "created";
-  }
-  if (existing.split(/\r?\n/).some((l) => l.trim() === "@AGENTS.md")) return "unchanged";
-  const eol = existing.includes("\r\n") ? "\r\n" : "\n";
-  await writeFileAtomic(file, `@AGENTS.md${eol}${existing}`);
-  return "prepended";
-}
-
-// src/core/blocks.ts
-import { join as join8 } from "path";
-async function checkBlocks({ root, rnessDir, manifest, org }) {
-  const problems = [];
-  const warnings = [];
-  if (!await exists(join8(root, "org"))) return { problems, warnings };
-  const targets = [
-    { scope: null, dir: root, depth: 0, label: "AGENTS.md" }
-  ];
-  for (const [name, entry] of Object.entries(manifest.scopes)) {
-    const segments = entry.path.split("/");
-    targets.push({ scope: name, dir: join8(root, ...segments), depth: segments.length, label: `${entry.path}/AGENTS.md` });
-  }
-  for (const t of targets) {
-    if (!await exists(t.dir)) {
-      warnings.push(`${t.label}: directory not present, block not checked`);
-      continue;
-    }
-    const text = await readOrNull(join8(t.dir, "AGENTS.md"));
-    const lines = text === null ? [] : text.split(/\r?\n/);
-    const found = findBlock(lines);
-    if (found.kind === "none") {
-      warnings.push(`${t.label}: no rness block yet (run rness sync)`);
-      continue;
-    }
-    if (found.kind === "error") {
-      problems.push(`${t.label}: ${found.message}`);
-      continue;
-    }
-    const header2 = parseHeader(lines[found.begin + 1] ?? "");
-    const context = await assembleContext({ rnessDir, manifest, scope: t.scope });
-    const fresh = renderBlock({ scope: t.scope, org, depth: t.depth, context, version: VERSION });
-    const actual = blockHash(bodyOf(lines.slice(found.begin, found.end + 1)));
-    if (header2 === null || header2.hash !== fresh.hash || header2.hash !== actual) {
-      problems.push(`${t.label}: stale rness block (run rness sync)`);
-    }
-  }
-  return { problems, warnings };
-}
-
-// src/commands/validate.ts
-async function validateCommand(opts) {
-  const cwd = opts.cwd ?? process.cwd();
-  try {
-    const ws = await findWorkspace(cwd);
-    const manifest = await loadManifest(ws.rnessDir);
-    for (const s of Object.keys(manifest.scopes)) scopeChain(manifest, s);
-    const { org, warning } = resolveOrg(manifest, ws.root);
-    const warnings = warning === null ? [] : [warning];
-    const problems = await checkContract(ws.rnessDir);
-    const blocks = await checkBlocks({ root: ws.root, rnessDir: ws.rnessDir, manifest, org });
-    problems.push(...blocks.problems);
-    warnings.push(...blocks.warnings);
-    for (const p of problems) process.stderr.write(`${p}
-`);
-    for (const w of warnings) process.stderr.write(`warning: ${w}
-`);
-    if (problems.length > 0) return 1;
-    process.stdout.write("context ok\n");
-    return 0;
-  } catch (e) {
-    return reportError(e);
-  }
-}
-
-// src/commands/sync.ts
-import { join as join9 } from "path";
-
-// src/core/git.ts
-import { execFile } from "child_process";
-import { dirname as dirname3, resolve as resolve2 } from "path";
-import { promisify } from "util";
-var execFileP = promisify(execFile);
-async function git(args, cwd) {
-  try {
-    const { stdout } = await execFileP("git", [...args], {
-      ...cwd === void 0 ? {} : { cwd },
-      env: {
-        ...process.env,
-        GIT_TERMINAL_PROMPT: "0",
-        // Pin the command to `cwd` itself: without a ceiling, git walks up and
-        // a plain directory under `org/` would report — or be pulled into —
-        // whatever repository happens to sit above the workspace root. git
-        // ignores a relative ceiling entry, hence the resolve().
-        ...cwd === void 0 ? {} : { GIT_CEILING_DIRECTORIES: dirname3(resolve2(cwd)) }
-      },
-      maxBuffer: 16 * 1024 * 1024
-    });
-    return stdout;
-  } catch (e) {
-    const err = e;
-    const text = err.stderr !== void 0 && err.stderr !== "" ? err.stderr : err.message ?? "unknown error";
-    const first = text.split("\n").find((l) => l.trim() !== "") ?? "unknown error";
-    throw new Error(`git ${args[0] ?? ""} failed: ${first.trim()}`);
-  }
-}
-function positional(value, what) {
-  if (value.startsWith("-")) throw new Error(`refusing suspicious ${what}: ${value}`);
-  return value;
-}
-async function clone(url, dir) {
-  await git(["clone", "--quiet", "--", positional(url, "repository url"), positional(dir, "directory")]);
-}
-async function isClean(dir, ignore = []) {
-  const pathspec = ignore.map((p) => `:!${p}`);
-  return (await git(["status", "--porcelain", ...pathspec.length > 0 ? ["--", ...pathspec] : []], dir)).trim() === "";
-}
-async function pullFastForward(dir) {
-  await git(["pull", "--ff-only", "--quiet"], dir);
-}
-
-// src/commands/sync.ts
-var MANAGED_FILES = ["AGENTS.md", "CLAUDE.md"];
-function targetsOf(manifest, root, only) {
-  const targets = [];
-  if (only === void 0) targets.push({ scope: null, dir: root, depth: 0, label: "AGENTS.md" });
-  for (const [name, entry] of Object.entries(manifest.scopes)) {
-    if (only !== void 0 && name !== only) continue;
-    const segments = entry.path.split("/");
-    targets.push({ scope: name, dir: join9(root, ...segments), depth: segments.length, label: `${entry.path}/AGENTS.md` });
-  }
-  return targets;
-}
-async function confirmOrExit(org) {
-  if (!process.stdin.isTTY || !process.stdout.isTTY) {
-    process.stderr.write("rness sync writes files; pass --yes to run without a prompt\n");
-    return 2;
-  }
-  const { confirm, isCancel } = await import("@clack/prompts");
-  const answer = await confirm({ message: `Sync workspace \`${org}\`: clone missing repositories and rewrite the rness blocks?` });
-  if (isCancel(answer) || answer !== true) {
-    process.stderr.write("cancelled\n");
-    return 1;
-  }
-  return null;
-}
-async function syncCommand(opts) {
-  const cwd = opts.cwd ?? process.cwd();
-  const check = opts.check === true;
-  try {
-    const ws = await findWorkspace(cwd);
-    const manifest = await loadManifest(ws.rnessDir);
-    const { org, warning } = resolveOrg(manifest, ws.root);
-    if (warning !== null) process.stderr.write(`warning: ${warning}
-`);
-    if (opts.scope !== void 0 && !Object.hasOwn(manifest.scopes, opts.scope)) {
-      process.stderr.write(`unknown scope: ${opts.scope}
-`);
-      return 1;
-    }
-    if (!check && opts.yes !== true) {
-      const refused = await confirmOrExit(org);
-      if (refused !== null) return refused;
-    }
-    const lines = [];
-    const problems = [];
-    try {
-      for (const [name, repo] of Object.entries(manifest.repos)) {
-        const dir = join9(ws.root, "org", name);
-        const label = `org/${name}`;
-        if (!await exists(dir)) {
-          if (check) {
-            lines.push(`missing  ${label} (would clone ${repo.url})`);
-            continue;
-          }
-          try {
-            await clone(repo.url, dir);
-            lines.push(`cloned   ${label}`);
-          } catch (e) {
-            problems.push(`${label}: ${e instanceof Error ? e.message : String(e)}`);
-          }
-        } else if (opts.pull === true && !check) {
-          try {
-            if (!await isClean(dir, MANAGED_FILES)) {
-              lines.push(`skipped  ${label} (working tree not clean)`);
-              continue;
-            }
-            await pullFastForward(dir);
-            lines.push(`pulled   ${label}`);
-          } catch (e) {
-            problems.push(`${label}: ${e instanceof Error ? e.message : String(e)}`);
-          }
-        }
-      }
-      if (!await exists(join9(ws.root, "org"))) {
-        lines.push("skipped  blocks (no org/ directory here)");
-      } else {
-        let differences = 0;
-        for (const t of targetsOf(manifest, ws.root, opts.scope)) {
-          if (!await exists(t.dir)) {
-            lines.push(`skipped  ${t.label} (directory not present)`);
-            continue;
-          }
-          const linked = await Promise.all(MANAGED_FILES.map((f) => isSymlink(join9(t.dir, f))));
-          if (linked.includes(true)) {
-            lines.push(`skipped  ${t.label} (symlink)`);
-            continue;
-          }
-          const context = await assembleContext({ rnessDir: ws.rnessDir, manifest, scope: t.scope });
-          const block = renderBlock({ scope: t.scope, org, depth: t.depth, context, version: VERSION });
-          if (block.bytes > BLOCK_SIZE_WARNING) {
-            process.stderr.write(`warning: ${t.label}: block is ${Math.round(block.bytes / 1024)} KB (over 32 KB)
-`);
-          }
-          const file = join9(t.dir, "AGENTS.md");
-          const merged = mergeBlock(await readOrNull(file), block.text);
-          if (!merged.ok) {
-            problems.push(`${t.label}: ${merged.error}`);
-            continue;
-          }
-          if (!merged.changed) {
-            lines.push(`unchanged ${t.label}`);
-            if (!check) await ensureClaudeMd(t.dir);
-            continue;
-          }
-          if (check) {
-            lines.push(`stale    ${t.label}`);
-            differences += 1;
-            continue;
-          }
-          await writeFileAtomic(file, merged.text);
-          await ensureClaudeMd(t.dir);
-          lines.push(`updated  ${t.label}`);
-        }
-        if (check && differences > 0) problems.push(`${differences} block(s) out of date \u2014 run rness sync`);
-      }
-      return problems.length > 0 ? 1 : 0;
-    } finally {
-      for (const l of lines) process.stdout.write(`${l}
-`);
-      for (const p of problems) process.stderr.write(`${p}
-`);
-    }
-  } catch (e) {
-    return reportError(e);
-  }
-}
-
-// src/cli.ts
-import { Command, CommanderError, Option } from "commander";
-function buildProgram(state) {
-  const program = new Command().name("rness").description("Configuration-plane CLI for rness workspaces").version(VERSION, "-v, --version", "print the version").exitOverride().showHelpAfterError().configureOutput({
-    writeOut: (s) => {
-      process.stdout.write(s);
-    },
-    writeErr: (s) => {
-      process.stderr.write(s);
-    }
-  });
-  program.command("context").description("Resolve and print the context for a scope").option("--scope <name>", "scope to resolve (default: the scope owning the current directory)").option("--json", "print JSON instead of Markdown").addOption(new Option("--cwd <dir>").hideHelp()).action(async (opts) => {
-    state.code = await contextCommand(opts);
-  });
-  program.command("validate").description("Check the .rness/ tree against the contract and every generated block").addOption(new Option("--cwd <dir>").hideHelp()).action(async (opts) => {
-    state.code = await validateCommand(opts);
-  });
-  program.command("sync").description("Clone missing repositories and write the rness block into every AGENTS.md").option("--scope <name>", "only this scope (the root block is skipped)").option("--check", "render and compare only; exit 1 when a block is out of date").option("--pull", "git pull --ff-only in every clean clone").option("-y, --yes", "do not ask for confirmation").addOption(new Option("--cwd <dir>").hideHelp()).action(async (opts) => {
-    state.code = await syncCommand(opts);
-  });
-  return program;
-}
-async function run(argv) {
-  const state = { code: 0 };
-  const program = buildProgram(state);
-  if (argv.length === 0) {
-    process.stdout.write(program.helpInformation());
-    return 0;
-  }
-  try {
-    await program.parseAsync(argv, { from: "user" });
-  } catch (e) {
-    if (e instanceof CommanderError) {
-      return e.exitCode === 0 ? 0 : 2;
-    }
-    throw e;
-  }
-  return state.code;
-}
-
-export {
-  VERSION,
-  exists,
-  readOrNull,
-  writeFileAtomic,
-  findWorkspace,
-  NAME,
-  loadManifest,
-  resolveScope,
-  scopeChain,
-  parseFrontMatter,
-  extractTitle,
-  collectMarkdown,
-  COLLECTIONS,
-  assembleContext,
-  reportError,
-  renderMarkdown,
-  contextCommand,
-  STATUSES,
-  checkContract,
-  BEGIN,
-  END,
-  BLOCK_SIZE_WARNING,
-  blockHash,
-  renderBlock,
-  parseHeader,
-  bodyOf,
-  findBlock,
-  mergeBlock,
-  ensureClaudeMd,
-  checkBlocks,
-  validateCommand,
-  syncCommand,
-  run
-};
-//# sourceMappingURL=chunk-4KNZT4G4.js.map