@oevery/rsp 3.2.0 → 4.0.0

package/dist/chunk-SEGJLWRE.mjs

@@ -1,1158 +0,0 @@
-#!/usr/bin/env node
-
-// src/core/config.ts
-import { readFile as readFile2 } from "fs/promises";
-import { dirname as dirname3, join as join4 } from "path";
-import { fileURLToPath } from "url";
-import pc from "picocolors";
-
-// src/core/decisions.ts
-import { existsSync } from "fs";
-import { mkdir, readdir as readdir2, realpath, stat } from "fs/promises";
-import { dirname, isAbsolute, join as join2, posix, relative, resolve, sep } from "path";
-
-// src/core/managed-path.ts
-import { lstatSync } from "fs";
-import { readdir, writeFile } from "fs/promises";
-import { join } from "path";
-var ManagedPathError = class extends Error {
-  constructor(path, message) {
-    super(message);
-    this.path = path;
-    this.name = "ManagedPathError";
-  }
-  path;
-};
-function inspectManagedDirectory(path, label, options = {}) {
-  try {
-    const stats = lstatSync(path);
-    if (stats.isDirectory())
-      return { exists: true, issue: null };
-    return {
-      exists: true,
-      issue: new ManagedPathError(path, `${label} must be a real directory: ${path}`)
-    };
-  } catch (error) {
-    if (error.code === "ENOENT") {
-      if (options.allowMissing)
-        return { exists: false, issue: null };
-      return {
-        exists: false,
-        issue: new ManagedPathError(path, `${label} must be a real directory: ${path}`)
-      };
-    }
-    const message = error instanceof Error ? error.message : String(error);
-    return {
-      exists: false,
-      issue: new ManagedPathError(path, `unable to inspect ${label} ${path}: ${message}`)
-    };
-  }
-}
-function requireManagedDirectory(path, label, options = {}) {
-  const inspection = inspectManagedDirectory(path, label, options);
-  if (inspection.issue)
-    throw inspection.issue;
-  return inspection.exists;
-}
-function inspectManagedFile(path, label, options = {}) {
-  try {
-    const stats = lstatSync(path);
-    if (stats.isFile())
-      return { exists: true, issue: null };
-    return {
-      exists: true,
-      issue: new ManagedPathError(path, `${label} must be a regular file: ${path}`)
-    };
-  } catch (error) {
-    if (error.code === "ENOENT") {
-      if (options.allowMissing)
-        return { exists: false, issue: null };
-      return {
-        exists: false,
-        issue: new ManagedPathError(path, `${label} must be a regular file: ${path}`)
-      };
-    }
-    const message = error instanceof Error ? error.message : String(error);
-    return {
-      exists: false,
-      issue: new ManagedPathError(path, `unable to inspect ${label} ${path}: ${message}`)
-    };
-  }
-}
-function requireManagedFile(path, label, options = {}) {
-  const inspection = inspectManagedFile(path, label, options);
-  if (inspection.issue)
-    throw inspection.issue;
-  return inspection.exists;
-}
-async function ensureManagedFile(path, content, label) {
-  if (requireManagedFile(path, label, { allowMissing: true }))
-    return false;
-  await writeFile(path, content, { flag: "wx" });
-  return true;
-}
-async function writeManagedFile(path, content, label) {
-  const exists = requireManagedFile(path, label, { allowMissing: true });
-  if (exists)
-    await writeFile(path, content);
-  else
-    await writeFile(path, content, { flag: "wx" });
-}
-function resolveManagedDirectoryChain(root, segments, label) {
-  requireManagedDirectory(root, `${label} root`);
-  let current = root;
-  for (const segment of segments) {
-    if (!segment || segment === "." || segment === ".." || segment.includes("/") || segment.includes("\\"))
-      throw new ManagedPathError(current, `${label} contains an invalid directory segment: ${segment}`);
-    current = join(current, segment);
-    requireManagedDirectory(current, label, { allowMissing: true });
-  }
-  return current;
-}
-async function inspectManagedFileTree(root, label, options = {}) {
-  const result = { rootExists: false, files: [], issues: [] };
-  const rootInspection = inspectManagedDirectory(root, `${label} root`, options);
-  if (rootInspection.issue) {
-    result.issues.push(rootInspection.issue);
-    return result;
-  }
-  if (!rootInspection.exists)
-    return result;
-  result.rootExists = true;
-  await collectManagedFiles(root, label, result);
-  result.files.sort();
-  return result;
-}
-async function collectManagedFiles(directory, label, result) {
-  let entries;
-  try {
-    entries = await readdir(directory, { withFileTypes: true });
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    result.issues.push(new ManagedPathError(directory, `unable to inspect the ${label} tree at ${directory}: ${message}`));
-    return;
-  }
-  for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
-    if (entry.name.startsWith("."))
-      continue;
-    const path = join(directory, entry.name);
-    if (entry.isDirectory()) {
-      await collectManagedFiles(path, label, result);
-      continue;
-    }
-    if (entry.isFile()) {
-      result.files.push(path);
-      continue;
-    }
-    result.issues.push(new ManagedPathError(path, `unsupported entry in the ${label} tree: ${path}`));
-  }
-}
-
-// src/core/decisions.ts
-var DEFAULT_DECISION_RECORDS_PATH = ".rsp/specs/decisions";
-function normalizeDecisionRecordsPath(pathValue) {
-  return posix.normalize(pathValue.trim().replace(/\\/g, "/")).replace(/^\.\//, "").replace(/\/$/, "");
-}
-function validateDecisionRecordsPath(pathValue) {
-  if (typeof pathValue !== "string" || pathValue.trim() === "")
-    return 'config.yaml field "decisions.path" must be a non-empty string';
-  const raw = pathValue.trim();
-  const portable = raw.replace(/\\/g, "/");
-  if (isAbsolute(raw) || posix.isAbsolute(portable) || /^[a-z]:[\\/]/i.test(raw))
-    return 'config.yaml field "decisions.path" must be project-relative';
-  const normalized = normalizeDecisionRecordsPath(raw);
-  if (normalized === "." || normalized === ".." || normalized.startsWith("../"))
-    return 'config.yaml field "decisions.path" must stay inside the Host Project';
-  if ((normalized === ".rsp" || normalized.startsWith(".rsp/")) && normalized !== DEFAULT_DECISION_RECORDS_PATH)
-    return `config.yaml field "decisions.path" must use ${DEFAULT_DECISION_RECORDS_PATH} or a path outside .rsp/`;
-  return null;
-}
-function getDecisionRecordsConfigIssue(config) {
-  if (!("decisions" in config))
-    return null;
-  const decisions = config.decisions;
-  if (!decisions || typeof decisions !== "object" || Array.isArray(decisions))
-    return 'config.yaml field "decisions" must be a mapping with one path';
-  const keys = Object.keys(decisions);
-  if (keys.length !== 1 || keys[0] !== "path")
-    return 'config.yaml field "decisions" supports only "path"';
-  return validateDecisionRecordsPath(decisions.path);
-}
-function resolveDecisionRecordsPath(config) {
-  const configured = config.decisions?.path;
-  return configured && validateDecisionRecordsPath(configured) === null ? normalizeDecisionRecordsPath(configured) : DEFAULT_DECISION_RECORDS_PATH;
-}
-async function ensureDecisionRecordsDirectory(pathValue) {
-  const filesystemError = await validateDecisionRecordsFilesystemPath(pathValue);
-  if (filesystemError)
-    throw new Error(filesystemError);
-  const existed = existsSync(pathValue);
-  await mkdir(pathValue, { recursive: true });
-  const entries = await readdir2(pathValue);
-  if (entries.length === 0) {
-    await ensureManagedFile(join2(pathValue, ".gitkeep"), "", "Decision Record placeholder");
-    return true;
-  }
-  if (entries.includes(".gitkeep"))
-    requireManagedFile(join2(pathValue, ".gitkeep"), "Decision Record placeholder");
-  return !existed;
-}
-async function validateDecisionRecordsFilesystemPath(pathValue) {
-  const projectRoot = await realpath(".");
-  let existingAncestor = resolve(pathValue);
-  while (!existsSync(existingAncestor)) {
-    const parent = dirname(existingAncestor);
-    if (parent === existingAncestor)
-      return `Decision Record path "${pathValue}" has no accessible Host Project ancestor`;
-    existingAncestor = parent;
-  }
-  const resolvedAncestor = await realpath(existingAncestor);
-  const rel = relative(projectRoot, resolvedAncestor);
-  if (rel === ".." || rel.startsWith(`..${sep}`) || isAbsolute(rel))
-    return `Decision Record path "${pathValue}" resolves outside the Host Project through ${existingAncestor}`;
-  if (existsSync(resolve(pathValue)) && !(await stat(resolve(pathValue))).isDirectory())
-    return `Decision Record path "${pathValue}" must be a directory`;
-  return null;
-}
-
-// src/core/document-model.ts
-var CHANGE_DOCUMENT_SCHEMA = {
-  titlePrefix: "# Change:",
-  sections: [
-    { id: "proposal", heading: "Proposal" },
-    { id: "spec", heading: "Spec" },
-    { id: "design", heading: "Design" },
-    { id: "tasks", heading: "Tasks" },
-    { id: "verify", heading: "Verify" },
-    { id: "blockers", heading: "Blockers" }
-  ]
-};
-var GROUP_BRIEF_DOCUMENT_SCHEMA = {
-  titlePrefix: "# Change Group:",
-  sections: [
-    { id: "goal", heading: "Goal" },
-    { id: "scope", heading: "Scope" },
-    { id: "sharedConstraints", heading: "Shared Constraints" },
-    { id: "slices", heading: "Slices" },
-    { id: "completionConditions", heading: "Completion Conditions" },
-    { id: "durableOutcomes", heading: "Durable Outcomes" },
-    { id: "blockers", heading: "Blockers" }
-  ]
-};
-var DocumentSectionCardinalityError = class extends Error {
-  constructor(sectionId, count) {
-    super(`document must contain exactly one ${sectionId} section; found ${count}`);
-    this.sectionId = sectionId;
-    this.count = count;
-    this.name = "DocumentSectionCardinalityError";
-  }
-  sectionId;
-  count;
-};
-function parseRspDocument(source, schema) {
-  const definitionsByHeading = new Map(schema.sections.map((definition) => [definition.heading, definition]));
-  const observedHeadings = collectLevelTwoHeadings(source);
-  const sections = /* @__PURE__ */ new Map();
-  const unknownHeadings = [];
-  for (let index = 0; index < observedHeadings.length; index++) {
-    const observed = observedHeadings[index];
-    const definition = definitionsByHeading.get(observed.heading);
-    if (!definition) {
-      unknownHeadings.push(observed.heading);
-      continue;
-    }
-    const nextHeading = observedHeadings[index + 1];
-    const bodyEnd = nextHeading ? lineBreakStart(source, nextHeading.start) : source.length;
-    const section = {
-      id: definition.id,
-      heading: definition.heading,
-      canonical: observed.canonical,
-      body: source.slice(observed.end, bodyEnd).trim(),
-      headingStart: observed.start,
-      headingEnd: observed.end,
-      bodyStart: observed.end,
-      bodyEnd
-    };
-    const matches = sections.get(definition.id) ?? [];
-    matches.push(section);
-    sections.set(definition.id, matches);
-  }
-  const missingSections = schema.sections.filter((definition) => !sections.has(definition.id)).map((definition) => definition.id);
-  const duplicateSections = schema.sections.filter((definition) => (sections.get(definition.id)?.length ?? 0) > 1).map((definition) => definition.id);
-  const titleOccurrences = collectDocumentTitles(source, schema.titlePrefix);
-  const titles = titleOccurrences.map((title) => title.value);
-  return {
-    source,
-    schema,
-    title: titles[0] ?? null,
-    titles,
-    titleOccurrences,
-    sections,
-    unknownHeadings,
-    missingSections,
-    duplicateSections
-  };
-}
-function getDocumentTitles(document, compatibility = "broad") {
-  if (compatibility === "broad")
-    return document.titles;
-  return document.titleOccurrences.filter((title) => compatibility === "identity" ? title.identityCompatible : title.spaced).map((title) => title.value);
-}
-function getDocumentTitle(document, compatibility = "broad") {
-  return getDocumentTitles(document, compatibility)[0] ?? null;
-}
-function getDocumentSections(document, sectionId) {
-  return document.sections.get(sectionId) ?? [];
-}
-function getDocumentSection(document, sectionId) {
-  return getDocumentSections(document, sectionId)[0];
-}
-function getDocumentSectionBody(document, sectionId) {
-  return getDocumentSection(document, sectionId)?.body ?? "";
-}
-function getDocumentSectionDefinitionByHeading(schema, heading) {
-  return schema.sections.find((candidate) => candidate.heading === heading);
-}
-function getCanonicalSectionHeadings(schema) {
-  return schema.sections.map((section) => section.heading);
-}
-function renderDocumentSectionHeading(schema, sectionId) {
-  const definition = schema.sections.find((candidate) => candidate.id === sectionId);
-  if (!definition)
-    throw new Error(`unknown document section: ${sectionId}`);
-  return `## ${definition.heading}`;
-}
-function renderDocumentTitle(schema, title) {
-  return `${schema.titlePrefix} ${title}`;
-}
-function appendDocumentSectionItem(document, sectionId, item) {
-  const matches = getDocumentSections(document, sectionId);
-  if (matches.length !== 1)
-    throw new DocumentSectionCardinalityError(sectionId, matches.length);
-  const insertAt = matches[0].bodyEnd;
-  const before = document.source.slice(0, insertAt);
-  const separator = before.endsWith("\n\n") ? "" : before.endsWith("\n") ? "\n" : "\n\n";
-  return `${before}${separator}${item}
-${document.source.slice(insertAt)}`;
-}
-function collectLevelTwoHeadings(source) {
-  const headings = [];
-  const pattern = /^## ([^\r\n]+)\r?$/gm;
-  let match;
-  while ((match = pattern.exec(source)) !== null) {
-    const heading = match[1].trimEnd();
-    headings.push({
-      heading,
-      canonical: heading === match[1],
-      start: match.index,
-      end: match.index + match[0].length
-    });
-  }
-  return headings;
-}
-function collectDocumentTitles(source, prefix) {
-  const titles = [];
-  for (const line of source.split(/\r?\n/)) {
-    const trimmed = line.trim();
-    if (!trimmed.startsWith(prefix))
-      continue;
-    const identity = line.startsWith(prefix) ? line.slice(prefix.length).match(/^\s+(\S+)\s*$/) : null;
-    titles.push({
-      value: trimmed.slice(prefix.length).trim(),
-      identityCompatible: identity !== null,
-      spaced: line.startsWith(`${prefix} `)
-    });
-  }
-  return titles;
-}
-function lineBreakStart(source, headingStart) {
-  if (headingStart > 0 && source[headingStart - 1] === "\n")
-    return headingStart - 1;
-  return headingStart;
-}
-
-// src/core/helpers.ts
-import { existsSync as existsSync2 } from "fs";
-import { readdir as readdir3, readFile, rmdir } from "fs/promises";
-import { basename, dirname as dirname2, join as join3, relative as relative2, sep as sep2 } from "path";
-import { parse } from "yaml";
-var RSP_AGENTS_BEGIN = "<!-- rsp:begin -->";
-var RSP_AGENTS_END = "<!-- rsp:end -->";
-function parseYamlText(text) {
-  const parsed = parse(text);
-  if (parsed === null || parsed === void 0)
-    return {};
-  if (typeof parsed !== "object" || Array.isArray(parsed))
-    throw new Error("YAML document must be a mapping/object");
-  return parsed;
-}
-function parseFrontmatter(content) {
-  const m = content.match(/^---\r?\n([\s\S]*?)\r?\n(?:---|\.\.\.)\r?\n/);
-  if (!m)
-    return null;
-  return parseYamlText(m[1]);
-}
-function countCheckboxes(content) {
-  const todo = (content.match(/\[ \]/g) || []).length;
-  const progress = (content.match(/\[\/\]/g) || []).length;
-  const done = (content.match(/\[x\]/g) || []).length;
-  const dropped = (content.match(/\[-\]/g) || []).length;
-  return { todo, progress, done, dropped, total: todo + progress + done + dropped };
-}
-async function walkMarkdownFiles(dir, options = {}) {
-  const all = await walkFiles(dir, options);
-  return all.filter((f) => f.endsWith(".md"));
-}
-async function inspectUnsupportedRules() {
-  const rulesDir = join3(RSP_DIR, "rules");
-  const diagnostics = [];
-  const rawEntries = await walkAllEntries(rulesDir, diagnostics);
-  const entries = rawEntries.filter((entry) => entry.path !== OBSOLETE_RSP_RULES_PATH).map((entry) => ({
-    path: normalizeLogicalPath(relative2(rulesDir, entry.path)),
-    kind: entry.kind
-  }));
-  const obsoleteFallbackPresent = existsSync2(OBSOLETE_RSP_RULES_PATH);
-  return {
-    entries,
-    diagnostics,
-    directoryRemaining: existsSync2(rulesDir) && (!obsoleteFallbackPresent || entries.length > 0)
-  };
-}
-async function walkAllEntries(dir, diagnostics) {
-  const entries = [];
-  try {
-    const items = await readdir3(dir, { withFileTypes: true });
-    for (const item of items) {
-      const path = join3(dir, item.name);
-      const kind = item.isDirectory() ? "directory" : "file";
-      entries.push({ path, kind });
-      if (kind === "directory")
-        entries.push(...await walkAllEntries(path, diagnostics));
-    }
-  } catch (error) {
-    if (error.code !== "ENOENT") {
-      diagnostics.push({
-        code: "walk_failed",
-        operation: "readdir",
-        path: dir,
-        message: toErrorMessage(error)
-      });
-    }
-  }
-  return entries;
-}
-async function walkFiles(dir, options = {}) {
-  const files = [];
-  try {
-    const items = await readdir3(dir, { withFileTypes: true });
-    for (const item of items) {
-      if (item.name.startsWith("."))
-        continue;
-      const filePath = join3(dir, item.name);
-      if (item.isDirectory())
-        files.push(...await walkFiles(filePath, options));
-      else
-        files.push(filePath);
-    }
-  } catch (error) {
-    if (error.code !== "ENOENT") {
-      options.onError?.({
-        code: "walk_failed",
-        operation: "readdir",
-        path: dir,
-        message: toErrorMessage(error)
-      });
-    }
-  }
-  return files;
-}
-function normalizeLogicalPath(pathValue) {
-  return pathValue.split(sep2).join("/").replace(/\\/g, "/");
-}
-function generateChangeContent(name, summary = "", kind, options = {}) {
-  const placeholder = "<\u2026>";
-  const proposalSummary = summary || placeholder;
-  const issueFrontmatter = renderIssueFrontmatter(options.issues ?? []);
-  if (name === "project-setup") {
-    return `---
-kind: ops
-${issueFrontmatter}---
-
-${renderDocumentTitle(CHANGE_DOCUMENT_SCHEMA, "project-setup")}
-
-${changeSectionHeading("proposal")}
-- Outcome: ${proposalSummary}
-- Why:
-  - ${placeholder}
-- Scope:
-  - ${placeholder}
-- Non-goals:
-  - ${placeholder}
-
-${changeSectionHeading("spec")}
-### ADDED
-- Requirement: ${placeholder}
-  - ${placeholder}
-
-### Acceptance
-#### Scenario: ${placeholder}
-- GIVEN ${placeholder}
-- WHEN ${placeholder}
-- THEN ${placeholder}
-
-${changeSectionHeading("design")}
-- Approach:
-  - ${placeholder}
-- Boundaries:
-  - ${placeholder}
-- Affected areas:
-  - .rsp/specs/design.md
-  - CONTEXT.md
-  - AGENTS.md
-- Durable outcome targets:
-  - Current facts: ${placeholder}
-  - Lasting rationale: ${placeholder}
-- Constraints:
-  - ${placeholder}
-
-${changeSectionHeading("tasks")}
-- [ ] .rsp/specs/design.md: ${placeholder}
-- [ ] CONTEXT.md: ${placeholder}
-- [ ] AGENTS.md: ${placeholder}
-
-${changeSectionHeading("verify")}
-- Automated:
-  - [ ] rsp doctor \u2014 proves: ${placeholder}
-- Manual or environment:
-  - [ ] ${placeholder}
-- Coverage:
-  - ${placeholder}
-
-${changeSectionHeading("blockers")}
-- none
-`;
-  }
-  const frontmatterKind = kind ?? "<choose: feature | fix | refactor | docs | ops | research>";
-  if (options.lite)
-    return generateLiteChangeContent(name, proposalSummary, frontmatterKind, issueFrontmatter);
-  const template = getChangeTemplateByKind(kind);
-  return `---
-kind: "${frontmatterKind}"
-${issueFrontmatter}---
-
-${renderDocumentTitle(CHANGE_DOCUMENT_SCHEMA, name)}
-
-${changeSectionHeading("proposal")}
-- Outcome: ${proposalSummary}
-- Why:
-  - ${template.why}
-- Scope:
-  - ${template.scope}
-- Non-goals:
-  - ${template.nonGoals}
-
-${changeSectionHeading("spec")}
-${template.specSection}
-
-### Acceptance
-${template.acceptanceSection}
-
-${changeSectionHeading("design")}
-- Approach:
-  - ${template.approach}
-- Boundaries:
-  - ${placeholder}
-- Affected areas:
-  - ${template.affectedArea1}
-  - ${template.affectedArea2}
-- Constraints:
-  - ${template.constraints}
-
-${changeSectionHeading("tasks")}
-- [ ] ${template.task}
-
-${changeSectionHeading("verify")}
-- Automated:
-  - [ ] ${template.automatedVerify} \u2014 proves: ${placeholder}
-- Manual or environment:
-  - [ ] ${template.manualVerify}
-- Coverage:
-  - ${placeholder}
-
-${changeSectionHeading("blockers")}
-- none
-`;
-}
-function generateLiteChangeContent(name, proposalSummary, frontmatterKind, issueFrontmatter) {
-  const placeholder = "<\u2026>";
-  return `---
-kind: "${frontmatterKind}"
-${issueFrontmatter}---
-
-${renderDocumentTitle(CHANGE_DOCUMENT_SCHEMA, name)}
-
-${changeSectionHeading("proposal")}
-- Outcome: ${proposalSummary}
-- Why:
-  - ${placeholder}
-- Scope:
-  - ${placeholder}
-- Non-goals:
-  - none
-
-${changeSectionHeading("spec")}
-### MODIFIED
-- Requirement: ${placeholder}
-  - ${placeholder}
-
-### Acceptance
-#### Scenario: ${placeholder}
-- GIVEN ${placeholder}
-- WHEN ${placeholder}
-- THEN ${placeholder}
-
-${changeSectionHeading("design")}
-- Approach:
-  - ${placeholder}
-- Boundaries:
-  - ${placeholder}
-- Affected areas:
-  - ${placeholder}
-- Constraints:
-  - ${placeholder}
-
-${changeSectionHeading("tasks")}
-- [ ] ${placeholder}
-
-${changeSectionHeading("verify")}
-- Automated:
-  - [ ] ${placeholder} \u2014 proves: ${placeholder}
-- Manual or environment:
-  - [ ] ${placeholder}
-- Coverage:
-  - ${placeholder}
-
-${changeSectionHeading("blockers")}
-- none
-`;
-}
-function renderIssueFrontmatter(issues) {
-  if (issues.length === 0)
-    return "";
-  return `issues:
-${issues.map((issue) => `  - url: ${JSON.stringify(issue.url)}
-    relation: ${issue.relation}`).join("\n")}
-`;
-}
-function getChangeTemplateByKind(kind) {
-  const placeholder = "<\u2026>";
-  const delta = kind === "feature" || kind === "research" || kind === void 0 ? "ADDED" : "MODIFIED";
-  return {
-    why: placeholder,
-    scope: placeholder,
-    nonGoals: placeholder,
-    specSection: `### ${delta}
-- Requirement: ${placeholder}
-  - ${placeholder}`,
-    acceptanceSection: `#### Scenario: ${placeholder}
-- GIVEN ${placeholder}
-- WHEN ${placeholder}
-- THEN ${placeholder}`,
-    approach: placeholder,
-    affectedArea1: placeholder,
-    affectedArea2: placeholder,
-    constraints: placeholder,
-    task: placeholder,
-    automatedVerify: placeholder,
-    manualVerify: placeholder
-  };
-}
-function changeSectionHeading(sectionId) {
-  return renderDocumentSectionHeading(CHANGE_DOCUMENT_SCHEMA, sectionId);
-}
-function renderRspAgentsBlock() {
-  return `${RSP_AGENTS_BEGIN}
-## RSP Entry
-
-RSP tracks current work, stable specs, and archives under \`.rsp/\`.
-
-Read in order:
-1. Nearest \`AGENTS.md\` for project or module instructions.
-2. Root \`CONTEXT-MAP.md\` if present, then the relevant nearest \`CONTEXT.md\`.
-3. Use the project \`rsp\` Skill at \`.agents/skills/rsp/SKILL.md\`; hosts may load it through Skill discovery or read it directly. Only when it is absent or cannot be used, read \`.rsp/rsp-rules.md\` as the fallback protocol.
-4. \`.rsp/focus.d/\`; for grouped work read the sibling Group Brief, then the explicitly selected focused Change.
-5. Only the relevant Specs and Decision Records under the configured authoritative path.
-
-If \`.rsp/focus.d/\` is empty and the user has not provided a concrete task, ask what to work on or suggest \`npx -y @oevery/rsp create <name>\` for tracked work.
-Do not treat \`.rsp/specs/\` or \`.rsp/changes/\` as replacements for nearest \`AGENTS.md\` or \`CONTEXT.md\`.
-${RSP_AGENTS_END}`;
-}
-function upsertRspAgentsBlock(content) {
-  const block = renderRspAgentsBlock();
-  const managedRe = /<!-- rsp:begin -->[\s\S]*?<!-- rsp:end -->/;
-  if (managedRe.test(content)) {
-    const next2 = content.replace(managedRe, block);
-    return { content: next2, changed: next2 !== content };
-  }
-  const trimmed = content.trimStart();
-  const next = trimmed ? `${block}
-
-${trimmed}` : `${block}
-`;
-  return { content: next, changed: true };
-}
-function hasRspAgentsBlock(content) {
-  return content.includes(RSP_AGENTS_BEGIN) && content.includes(RSP_AGENTS_END);
-}
-var SPEC_NAME_RE = /^[a-z0-9-]+(?:\/[a-z0-9-]+)*$/;
-function isValidSpecName(name) {
-  return SPEC_NAME_RE.test(name);
-}
-function guardRspInitialized() {
-  const designPath = join3(RSP_DIR, "specs", "design.md");
-  const rules = inspectManagedFile(RSP_RULES_PATH, "fallback protocol", { allowMissing: true });
-  const design = inspectManagedFile(designPath, "design Spec", { allowMissing: true });
-  if (rules.issue || design.issue || !rules.exists || !design.exists) {
-    const initialized = existsSync2(RSP_DIR);
-    console.error(`  ${pc.red("Error:")} ${initialized ? "RSP project requires an update" : "RSP is not initialized in this project"}`);
-    console.error(`  ${pc.dim(initialized ? "Run: rsp update" : "Run: rsp init")}`);
-    process.exit(1);
-  }
-}
-function getOpenCheckboxes(sectionText) {
-  return sectionText.split("\n").map((line) => line.trim()).filter((line) => /^- \[[ /]\]/.test(line));
-}
-async function cleanupEmptyParentDirs(path, stopDir) {
-  let parent = dirname2(path);
-  while (parent !== stopDir) {
-    try {
-      const remaining = await readdir3(parent);
-      if (remaining.length === 0)
-        await rmdir(parent);
-      else
-        break;
-    } catch {
-      break;
-    }
-    parent = dirname2(parent);
-  }
-}
-async function detectProjectName() {
-  try {
-    if (existsSync2("package.json")) {
-      const raw = await readFile("package.json", "utf-8");
-      const pkg = JSON.parse(raw);
-      if (pkg.name && pkg.name !== "")
-        return pkg.name;
-    }
-  } catch {
-  }
-  return basename(process.cwd());
-}
-function generateDesignContent(projectName) {
-  const placeholder = "<\u2026>";
-  return `# Project Design: ${projectName}
-
-## Purpose
-- ${placeholder}
-
-## Stable Facts
-- ${placeholder}
-
-## Boundaries
-- In scope:
-  - ${placeholder}
-- Out of scope:
-  - ${placeholder}
-
-## Structure
-- ${placeholder}
-
-## Constraints
-- ${placeholder}
-`;
-}
-function generateSpecContent(name) {
-  const title = toTitleCase(name);
-  const placeholder = "<\u2026>";
-  return `# ${title}
-
-## Purpose
-- ${placeholder}
-
-## Stable Facts
-- ${placeholder}
-
-## Boundaries
-- In scope:
-  - ${placeholder}
-- Out of scope:
-  - ${placeholder}
-
-## Constraints
-- ${placeholder}
-`;
-}
-function toTitleCase(value) {
-  return value.split(/[-/]/g).filter(Boolean).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(" ");
-}
-function extractBlockerLines(content) {
-  const document = parseRspDocument(content, CHANGE_DOCUMENT_SCHEMA);
-  return normalizeBlockerBody(getDocumentSectionBody(document, "blockers"));
-}
-function hasMeaningfulBlockerBody(body) {
-  return hasMeaningfulBlockerLines(normalizeBlockerBody(body));
-}
-function normalizeBlockerBody(body) {
-  return body.replace(/<!--[\s\S]*?-->/g, "").split("\n").map((line) => line.trim()).filter(Boolean);
-}
-function hasMeaningfulBlockers(content) {
-  return hasMeaningfulBlockerLines(extractBlockerLines(content));
-}
-function hasMeaningfulBlockerLines(lines) {
-  if (lines.length === 0)
-    return false;
-  return lines.some((line) => !/^[-*]\s*(?:none)?$/i.test(line) && !/^none$/i.test(line));
-}
-function detectDeltaSections(content) {
-  const document = parseRspDocument(content, CHANGE_DOCUMENT_SCHEMA);
-  const body = getDocumentSectionBody(document, "spec");
-  return {
-    added: /^###\s*ADDED/im.test(body),
-    modified: /^###\s*MODIFIED/im.test(body),
-    removed: /^###\s*REMOVED/im.test(body)
-  };
-}
-function collectArchiveReadiness(content, options = {}) {
-  const warnings = [];
-  const document = parseRspDocument(content, CHANGE_DOCUMENT_SCHEMA);
-  const tasksSection = getDocumentSectionBody(document, "tasks");
-  const verifySection = getDocumentSectionBody(document, "verify");
-  const taskTodos = getOpenCheckboxes(tasksSection);
-  if (taskTodos.length > 0)
-    warnings.push(`${taskTodos.length} task item(s) still incomplete`);
-  const verifyTodos = getOpenCheckboxes(verifySection);
-  if (verifyTodos.length > 0)
-    warnings.push(`${verifyTodos.length} Verify checklist item(s) are still incomplete`);
-  const activeBlockers = options.activeBlockers ?? hasMeaningfulBlockers(content);
-  if (activeBlockers)
-    warnings.push("active blockers are present in the change file");
-  const scenarios = parseScenarios(content);
-  const missingScenarios = scenarios.length === 0;
-  if (missingScenarios)
-    warnings.push("no Scenario blocks found (some changes do not need them)");
-  const archiveReady = activeBlockers ? "no" : warnings.length === 0 ? "yes" : "judgment";
-  return {
-    taskTodos,
-    verifyTodos,
-    activeBlockers,
-    scenarioCount: scenarios.length,
-    missingScenarios,
-    deterministic: warnings.length === 0 ? "pass" : "warnings",
-    semantic: "needs-review",
-    archiveReady,
-    warnings
-  };
-}
-function buildDurableReviewGuidance(factCandidateTargets, decisionRecordsPath) {
-  return {
-    required: true,
-    factDecisions: [
-      "No current-fact update needed",
-      "Update existing spec or scoped instruction",
-      "Create a new durable spec"
-    ],
-    rationaleDecisions: [
-      "No Decision Record needed",
-      "Create or update a Decision Record"
-    ],
-    factCandidateTargets,
-    decisionRecordsPath,
-    note: "Semantic review decides current-fact and lasting-rationale updates independently. The CLI never infers scoped instruction or Decision Record filenames and never promotes Change content automatically."
-  };
-}
-function getDurableReviewCandidateTargets() {
-  return [".rsp/specs/design.md"];
-}
-function collectArchiveChecklist(content, options = {}) {
-  return collectArchiveReadiness(content, options).warnings;
-}
-function parseScenarios(content) {
-  const scenarios = [];
-  const regex = /^#{3,4}\s*Scenario:\s*(.+)$/gim;
-  let match;
-  while ((match = regex.exec(content)) !== null) {
-    const heading = match[1].trim();
-    const startPos = match.index + match[0].length;
-    const restContent = content.slice(startPos);
-    const nextSection = restContent.match(/^#{3,4}\s/m);
-    const block = nextSection ? restContent.slice(0, nextSection.index) : restContent;
-    const steps = block.split("\n").map((s) => s.trim()).filter((s) => s.startsWith("-") && /GIVEN|WHEN|THEN|AND|BUT/i.test(s)).map((s) => s.replace(/^[-*]\s*/, ""));
-    if (steps.length > 0)
-      scenarios.push({ heading, steps });
-  }
-  return scenarios;
-}
-
-// src/core/config.ts
-var __dirname = dirname3(fileURLToPath(import.meta.url));
-var PKG_ROOT = join4(__dirname, "..");
-var RSP_DIR = ".rsp";
-var RSP_RULES_PATH = join4(RSP_DIR, "rsp-rules.md");
-var OBSOLETE_RSP_RULES_PATH = join4(RSP_DIR, "rules", "rsp-rules.md");
-var CHANGES_DIR = join4(RSP_DIR, "changes");
-var FOCUS_DIR = join4(RSP_DIR, "focus.d");
-var ARCHIVES_DIR = join4(RSP_DIR, "archives");
-var LOCK_PATH = join4(RSP_DIR, ".lock");
-var CONFIG_PATH = join4(RSP_DIR, "config.yaml");
-var VALID_KINDS = ["feature", "fix", "refactor", "docs", "ops", "research"];
-var DEFAULT_REQUIRED_SECTIONS = getCanonicalSectionHeadings(CHANGE_DOCUMENT_SCHEMA);
-var DEFAULT_MANAGE_POLICY = { activation: "explicit", closeout: "local" };
-var FAILED_CLOSED_MANAGE_POLICY = { activation: "explicit", closeout: "manual" };
-var MANAGE_ACTIVATIONS = ["explicit", "auto"];
-var MANAGE_CLOSEOUTS = ["manual", "lifecycle", "local"];
-var _configCache = null;
-async function loadRspConfig() {
-  const inspection = await inspectRspConfig();
-  if (inspection.issues.length > 0)
-    throw new Error(inspection.issues.join("; "));
-  return inspection.config;
-}
-async function inspectRspConfig() {
-  const cwd = process.cwd();
-  if (_configCache?.cwd === cwd)
-    return _configCache.inspection;
-  const configFile = inspectManagedFile(CONFIG_PATH, "config file", { allowMissing: true });
-  if (configFile.issue)
-    throw configFile.issue;
-  if (!configFile.exists) {
-    const inspection2 = { config: {}, issues: [] };
-    _configCache = { cwd, inspection: inspection2 };
-    return inspection2;
-  }
-  const raw = await readFile2(CONFIG_PATH, "utf-8");
-  const parsed = parseYamlText(raw);
-  const issues = validateRspConfig(parsed);
-  const decisions = parsed.decisions && typeof parsed.decisions === "object" && !Array.isArray(parsed.decisions) ? parsed.decisions : void 0;
-  const decisionPath = decisions?.path;
-  const manageValue = parsed.manage && typeof parsed.manage === "object" && !Array.isArray(parsed.manage) ? parsed.manage : void 0;
-  const languageValue = parsed.language && typeof parsed.language === "object" && !Array.isArray(parsed.language) ? parsed.language : void 0;
-  const activation = MANAGE_ACTIVATIONS.includes(manageValue?.activation) ? manageValue?.activation : void 0;
-  const closeout = MANAGE_CLOSEOUTS.includes(manageValue?.closeout) ? manageValue?.closeout : void 0;
-  const kinds = Array.isArray(parsed.kinds) && parsed.kinds.every((value) => typeof value === "string" && value.trim() !== "") ? parsed.kinds.map((value) => value.trim()) : void 0;
-  const decisionRecordsIssue = getDecisionRecordsConfigIssue(parsed);
-  const inspection = {
-    config: {
-      kinds,
-      decisions: decisionRecordsIssue === null && validateDecisionRecordsPath(decisionPath) === null ? { path: normalizeDecisionRecordsPath(String(decisionPath)) } : void 0,
-      manage: manageValue ? { activation, closeout } : void 0,
-      language: parseLanguageConfig(languageValue)
-    },
-    issues
-  };
-  _configCache = { cwd, inspection };
-  return inspection;
-}
-function validateRspConfig(parsed) {
-  const issues = [];
-  const supported = /* @__PURE__ */ new Set(["kinds", "decisions", "manage", "language"]);
-  for (const key of Object.keys(parsed)) {
-    if (key === "required_sections") {
-      issues.push('config.yaml field "required_sections" is no longer supported');
-    } else if (!supported.has(key)) {
-      issues.push(`config.yaml field "${key}" is not supported`);
-    }
-  }
-  if ("kinds" in parsed) {
-    if (!Array.isArray(parsed.kinds)) {
-      issues.push('config.yaml field "kinds" must be a YAML list');
-    } else if (!parsed.kinds.every((value) => typeof value === "string" && value.trim() !== "")) {
-      issues.push('config.yaml field "kinds" must contain only non-empty strings');
-    } else {
-      const kinds = parsed.kinds.map((value) => value.trim());
-      const duplicates = [...new Set(kinds.filter((value, index) => kinds.indexOf(value) !== index))];
-      if (duplicates.length > 0)
-        issues.push(`config.yaml field "kinds" contains duplicate entries: ${duplicates.join(", ")}`);
-    }
-  }
-  const decisionRecordsIssue = getDecisionRecordsConfigIssue(parsed);
-  if (decisionRecordsIssue)
-    issues.push(decisionRecordsIssue);
-  if ("manage" in parsed) {
-    if (!parsed.manage || typeof parsed.manage !== "object" || Array.isArray(parsed.manage)) {
-      issues.push('config.yaml field "manage" must be a YAML mapping');
-    } else {
-      const manage = parsed.manage;
-      const supportedManageFields = /* @__PURE__ */ new Set(["activation", "closeout"]);
-      for (const key of Object.keys(manage)) {
-        if (!supportedManageFields.has(key))
-          issues.push(`config.yaml field "manage.${key}" is not supported`);
-      }
-      if ("activation" in manage && !MANAGE_ACTIVATIONS.includes(manage.activation))
-        issues.push('config.yaml field "manage.activation" must be one of: explicit, auto');
-      if ("closeout" in manage && !MANAGE_CLOSEOUTS.includes(manage.closeout))
-        issues.push('config.yaml field "manage.closeout" must be one of: manual, lifecycle, local');
-    }
-  }
-  if ("language" in parsed) {
-    if (!parsed.language || typeof parsed.language !== "object" || Array.isArray(parsed.language)) {
-      issues.push('config.yaml field "language" must be a YAML mapping');
-    } else {
-      const language = parsed.language;
-      const supportedLanguageFields = /* @__PURE__ */ new Set(["default", "artifacts", "commit"]);
-      for (const key of Object.keys(language)) {
-        if (!supportedLanguageFields.has(key))
-          issues.push(`config.yaml field "language.${key}" is not supported`);
-      }
-      if (!("default" in language))
-        issues.push('config.yaml field "language.default" is required when language is configured');
-      for (const key of supportedLanguageFields) {
-        if (key in language && canonicalizeLanguageTag(language[key]) === null)
-          issues.push(`config.yaml field "language.${key}" must be a non-empty valid BCP 47 language tag`);
-      }
-    }
-  }
-  return issues;
-}
-function clearConfigCache() {
-  _configCache = null;
-}
-function resolveKinds(config) {
-  return config.kinds && config.kinds.length > 0 ? config.kinds : [...VALID_KINDS];
-}
-function resolveRequiredSections(_config) {
-  return [...DEFAULT_REQUIRED_SECTIONS];
-}
-function resolveManagePolicy(config, options = {}) {
-  if (options.configValid === false)
-    return { ...FAILED_CLOSED_MANAGE_POLICY };
-  return {
-    activation: config.manage?.activation ?? DEFAULT_MANAGE_POLICY.activation,
-    closeout: config.manage?.closeout ?? DEFAULT_MANAGE_POLICY.closeout
-  };
-}
-function resolveLanguagePolicy(config, options = {}) {
-  if (options.configValid === false || !config.language)
-    return { artifacts: null, commit: null };
-  return {
-    artifacts: config.language.artifacts ?? config.language.default,
-    commit: config.language.commit ?? config.language.default
-  };
-}
-function parseLanguageConfig(value) {
-  if (!value)
-    return void 0;
-  const defaultLanguage = canonicalizeLanguageTag(value.default);
-  if (defaultLanguage === null)
-    return void 0;
-  const artifacts = canonicalizeLanguageTag(value.artifacts);
-  const commit = canonicalizeLanguageTag(value.commit);
-  return {
-    default: defaultLanguage,
-    artifacts: artifacts ?? void 0,
-    commit: commit ?? void 0
-  };
-}
-function canonicalizeLanguageTag(value) {
-  if (typeof value !== "string" || value.trim() === "")
-    return null;
-  try {
-    return Intl.getCanonicalLocales(value.trim())[0] ?? null;
-  } catch {
-    return null;
-  }
-}
-async function getVersion() {
-  const { version } = JSON.parse(await readFile2(join4(PKG_ROOT, "package.json"), "utf-8"));
-  return version;
-}
-
-// src/core/output.ts
-function toErrorMessage(error) {
-  return error instanceof Error ? error.message : String(error);
-}
-function emitJson(data, options = {}) {
-  const indentation = options.compact ? void 0 : 2;
-  process.stdout.write(`${JSON.stringify(data, null, indentation)}
-`);
-}
-function recordRuntimeDiagnostic(runtime, diagnostic, verbose = false) {
-  runtime.push(diagnostic);
-  if (verbose) {
-    console.error(`  ${pc.dim(`[verbose] ${diagnostic.operation} ${diagnostic.path}: ${diagnostic.message}`)}`);
-  }
-}
-
-export {
-  ManagedPathError,
-  inspectManagedDirectory,
-  requireManagedDirectory,
-  inspectManagedFile,
-  requireManagedFile,
-  ensureManagedFile,
-  writeManagedFile,
-  resolveManagedDirectoryChain,
-  inspectManagedFileTree,
-  DEFAULT_DECISION_RECORDS_PATH,
-  resolveDecisionRecordsPath,
-  ensureDecisionRecordsDirectory,
-  validateDecisionRecordsFilesystemPath,
-  CHANGE_DOCUMENT_SCHEMA,
-  GROUP_BRIEF_DOCUMENT_SCHEMA,
-  DocumentSectionCardinalityError,
-  parseRspDocument,
-  getDocumentTitles,
-  getDocumentTitle,
-  getDocumentSections,
-  getDocumentSectionBody,
-  getDocumentSectionDefinitionByHeading,
-  getCanonicalSectionHeadings,
-  renderDocumentSectionHeading,
-  renderDocumentTitle,
-  appendDocumentSectionItem,
-  toErrorMessage,
-  emitJson,
-  recordRuntimeDiagnostic,
-  parseFrontmatter,
-  countCheckboxes,
-  walkMarkdownFiles,
-  inspectUnsupportedRules,
-  normalizeLogicalPath,
-  generateChangeContent,
-  upsertRspAgentsBlock,
-  hasRspAgentsBlock,
-  isValidSpecName,
-  guardRspInitialized,
-  cleanupEmptyParentDirs,
-  detectProjectName,
-  generateDesignContent,
-  generateSpecContent,
-  extractBlockerLines,
-  hasMeaningfulBlockerBody,
-  hasMeaningfulBlockers,
-  detectDeltaSections,
-  collectArchiveReadiness,
-  buildDurableReviewGuidance,
-  getDurableReviewCandidateTargets,
-  collectArchiveChecklist,
-  parseScenarios,
-  pc,
-  PKG_ROOT,
-  RSP_DIR,
-  RSP_RULES_PATH,
-  OBSOLETE_RSP_RULES_PATH,
-  CHANGES_DIR,
-  FOCUS_DIR,
-  ARCHIVES_DIR,
-  LOCK_PATH,
-  CONFIG_PATH,
-  VALID_KINDS,
-  loadRspConfig,
-  inspectRspConfig,
-  clearConfigCache,
-  resolveKinds,
-  resolveRequiredSections,
-  resolveManagePolicy,
-  resolveLanguagePolicy,
-  getVersion
-};