@oevery/rsp 3.1.0-beta.3 → 3.1.0-beta.5

package/dist/cli.mjs

@@ -4,14 +4,18 @@ import {
   installPackagedSkills,
   printPackagedSkillInventory,
   printSkillInstallResult
-} from "./chunk-NX55NIC3.mjs";
+} from "./chunk-3X2V6IEW.mjs";
 import {
   ArchiveHistoryError,
   GROUP_BRIEF_FILENAME,
+  GROUP_REOPEN_COMPLETION_PREFIX,
   HISTORY_DEFAULT_LIMIT,
   HISTORY_MAX_LIMIT,
+  IssueRelationshipError,
   WorkRefError,
+  createIssueRelationship,
   generateGroupBriefContent,
+  getGroupReopenEvidence,
   hasArchivedGroupBrief,
   historyInspectionComplete,
   inspectArchiveHistory,
@@ -21,6 +25,9 @@ import {
   inspectFocusTree,
   inspectProjectStatus,
   inspectWorkTree,
+  normalizeExecutableWorkRef,
+  normalizeWorkRefSegment,
+  parseIssueRelationships,
   projectDependencyForest,
   queryArchiveHistory,
   readArchiveHistoryDetail,
@@ -28,20 +35,26 @@ import {
   resolveExecutableChange,
   resolveFocusMarkerPath,
   resolveWorkRef,
-  selectArchiveHistoryRecord
-} from "./chunk-7KKAUBKN.mjs";
+  selectArchiveHistoryRecord,
+  selectArchivedGroupBrief
+} from "./chunk-ZKZVWJQ7.mjs";
 import {
   ARCHIVES_DIR,
   CHANGES_DIR,
+  CHANGE_DOCUMENT_SCHEMA,
   CONFIG_PATH,
   DEFAULT_DECISION_RECORDS_PATH,
+  DocumentSectionCardinalityError,
   FOCUS_DIR,
+  GROUP_BRIEF_DOCUMENT_SCHEMA,
   LOCK_PATH,
+  ManagedPathError,
   OBSOLETE_RSP_RULES_PATH,
   PKG_ROOT,
   RSP_DIR,
   RSP_RULES_PATH,
   VALID_KINDS,
+  appendDocumentSectionItem,
   buildDurableReviewGuidance,
   cleanupEmptyParentDirs,
   clearConfigCache,
@@ -56,6 +69,10 @@ import {
   generateChangeContent,
   generateDesignContent,
   generateSpecContent,
+  getDocumentSectionBody,
+  getDocumentSectionDefinitionByHeading,
+  getDocumentSections,
+  getDocumentTitles,
   getDurableReviewCandidateTargets,
   getVersion,
   guardRspInitialized,
@@ -70,6 +87,7 @@ import {
   loadRspConfig,
   normalizeLogicalPath,
   parseFrontmatter,
+  parseRspDocument,
   parseScenarios,
   pc,
   recordRuntimeDiagnostic,
@@ -83,7 +101,7 @@ import {
   validateDecisionRecordsFilesystemPath,
   walkMarkdownFiles,
   writeManagedFile
-} from "./chunk-OTJFL6XH.mjs";
+} from "./chunk-UVYEXKYS.mjs";
 
 // src/cli.ts
 import { resolve } from "path";
@@ -418,7 +436,7 @@ async function addSpec(name, projectName = "project") {
 }
 
 // src/commands/archive.ts
-import { existsSync } from "fs";
+import { existsSync, readdirSync } from "fs";
 import { mkdir as mkdir3, readFile as readFile3, rename, unlink as unlink4 } from "fs/promises";
 import { basename as basename2, join as join3 } from "path";
 async function archiveChange(name) {
@@ -436,7 +454,7 @@ async function archiveChange(name) {
       const content = await readFile3(srcPath, "utf-8");
       const dependencyInspection = await inspectChangeDependencies();
       const checklist = collectArchiveChecklist(content, {
-        activeBlockers: dependencyInspection.activeBlockers.get(name)
+        activeBlockers: dependencyInspection.activeBlockers.get(workRef.name)
       });
       for (const line of checklist)
         console.log(`  ${pc.yellow("\u26A0")} ${line}`);
@@ -491,12 +509,12 @@ ${clearedMsg}`);
 }
 function resolveArchiveName(archiveSubdir, date, base) {
   const initialName = `${date}_${base}.md`;
-  if (!existsSync(join3(archiveSubdir, initialName)))
+  if (!archiveNameExists(archiveSubdir, initialName))
     return initialName;
   const MAX_SUFFIX = 9999;
   for (let index = 2; index <= MAX_SUFFIX; index++) {
     const candidate = `${date}_${base}-${index}.md`;
-    if (!existsSync(join3(archiveSubdir, candidate)))
+    if (!archiveNameExists(archiveSubdir, candidate))
       return candidate;
   }
   throw new WorkRefError(
@@ -505,6 +523,22 @@ function resolveArchiveName(archiveSubdir, date, base) {
     base
   );
 }
+function archiveNameExists(archiveSubdir, name) {
+  if (!existsSync(archiveSubdir))
+    return false;
+  return readdirSync(archiveSubdir).some((entry) => {
+    if (entry.normalize("NFC") !== name)
+      return false;
+    if (entry !== name) {
+      throw new WorkRefError(
+        "work_ref_collision",
+        `archive name has a Unicode normalization collision: ${entry} and ${name}`,
+        name
+      );
+    }
+    return true;
+  });
+}
 
 // src/commands/check.ts
 import { readFile as readFile4 } from "fs/promises";
@@ -696,8 +730,10 @@ async function runCheck(options = {}) {
         message: "missing YAML frontmatter"
       });
     }
+    const document = parseRspDocument(content, CHANGE_DOCUMENT_SCHEMA);
     for (const section of requiredSections) {
-      if (!new RegExp(`^## ${section}$`, "m").test(content)) {
+      const definition = getDocumentSectionDefinitionByHeading(CHANGE_DOCUMENT_SCHEMA, section);
+      if (!definition || !getDocumentSections(document, definition.id).some((candidate) => candidate.canonical)) {
         addDiagnostic({
           severity: "error",
           code: "missing_section",
@@ -708,6 +744,17 @@ async function runCheck(options = {}) {
       }
     }
     if (fm) {
+      try {
+        parseIssueRelationships(fm);
+      } catch (error) {
+        addDiagnostic({
+          severity: "error",
+          code: error instanceof IssueRelationshipError ? error.code : "invalid_issue_metadata",
+          change: name,
+          path: fp,
+          message: error instanceof Error ? error.message : String(error)
+        });
+      }
       if (!("kind" in fm)) {
         addDiagnostic({
           severity: "error",
@@ -734,16 +781,14 @@ async function runCheck(options = {}) {
         });
       }
     }
-    const headingLine = content.split("\n").map((line) => line.trim()).find((line) => line.startsWith("# Change:"));
-    if (headingLine) {
-      const heading = headingLine.slice("# Change:".length).trim();
-      if (heading !== name) {
+    if (document.title !== null) {
+      if (document.title !== name) {
         addDiagnostic({
           severity: "error",
           code: "heading_mismatch",
           change: name,
           path: fp,
-          message: `# Change: heading "${heading}" differs from change name`
+          message: `# Change: heading "${document.title}" differs from change name`
         });
       }
     } else {
@@ -866,7 +911,7 @@ async function runCheck(options = {}) {
   return result;
 }
 function findUnfinishedTemplateLines(content) {
-  const placeholderRe = /<[^>\n]*(?:choose:|one-line|what |why |which |who |how |new |updated |expected |actual |specific |concrete |exact |verifiable |user |capability |behavior |context |action |path|directory|module|subsystem|command|scenario|constraint|requirement|question|uncertainty|implementation)[^>\n]*>/i;
+  const placeholderRe = /<(?:…|[^>\n]*(?:choose:|one-line|what |why |which |who |how |new |updated |expected |actual |specific |concrete |exact |verifiable |user |capability |behavior |context |action|path|directory|module|subsystem|command|scenario|constraint|requirement|question|uncertainty|implementation)[^>\n]*)>/i;
   return collectMatchingLines(content, (line) => {
     const trimmed = stripInlineCodeSpans(line).trim();
     return trimmed.startsWith("<!--") === false && placeholderRe.test(trimmed);
@@ -898,15 +943,21 @@ async function createChange(name, summary = "", kind, options = {}) {
     console.error(`  ${pc.red("Usage:")} rsp create <name> [summary]`);
     process.exit(1);
   }
+  const hasIssueOption = options.issue !== void 0;
+  if (options.issueRelation && !hasIssueOption)
+    throw new Error("--issue-relation requires --issue");
+  const issues = options.issue !== void 0 ? [createIssueRelationship(options.issue, options.issueRelation)] : [];
   guardRspInitialized();
   try {
     return await withRspLock("create-change", async () => {
       const workRef = await resolveExecutableChange(name);
       const changePath = workRef.path;
       const existed = existsSync2(changePath);
+      if (existed && hasIssueOption)
+        throw new Error(`Change already exists; --issue cannot update ${workRef.name}`);
       if (!existed) {
         const focusEntry = resolveFocusMarkerPath(workRef);
-        const content = generateChangeContent(name, summary, kind, { lite: Boolean(options.lite) });
+        const content = generateChangeContent(workRef.name, summary, kind, { lite: Boolean(options.lite), issues });
         await mkdir4(dirname2(changePath), { recursive: true });
         let changeCreated = false;
         try {
@@ -929,9 +980,9 @@ async function createChange(name, summary = "", kind, options = {}) {
       const label = existed ? "Using" : pc.green("Created");
       console.log(`  ${label}: ${changePath}`);
       if (existed)
-        console.log(`  ${pc.dim("Unchanged focus.")} Run: rsp focus ${name}`);
+        console.log(`  ${pc.dim("Unchanged focus.")} Run: rsp focus ${workRef.name}`);
       else
-        console.log(`  ${pc.dim("focused via focus.d")} \u2192 ${name}`);
+        console.log(`  ${pc.dim("focused via focus.d")} \u2192 ${workRef.name}`);
       console.log(`  ${pc.cyan("Next:")} ${options.lite ? "fill the lite change details, then implement and verify" : "fill proposal/spec/design first, then implement and complete the tasks"}
 `);
     });
@@ -1565,8 +1616,8 @@ async function focusChange(name) {
       await mkdir6(FOCUS_DIR, { recursive: true });
       await mkdir6(dirname3(focusEntry), { recursive: true });
       await writeManagedFile(focusEntry, "", "focus marker");
-      console.log(`  ${pc.green("Focused:")} ${name}`);
-      console.log(`  ${pc.dim("focus.d")} \u2192 ${name}`);
+      console.log(`  ${pc.green("Focused:")} ${workRef.name}`);
+      console.log(`  ${pc.dim("focus.d")} \u2192 ${workRef.name}`);
       console.log();
     });
   } catch (error) {
@@ -1587,8 +1638,8 @@ async function unfocusChange(name) {
         throw new WorkRefError("focus_marker_not_found", `.rsp/focus.d/${name}`, name);
       await unlink7(focusEntry);
       await cleanupEmptyParentDirs(focusEntry, FOCUS_DIR);
-      console.log(`  ${pc.green("Unfocused:")} ${name}`);
-      console.log(`  ${pc.dim("focus.d cleared")} \u2192 ${name}`);
+      console.log(`  ${pc.green("Unfocused:")} ${workRef.name}`);
+      console.log(`  ${pc.dim("focus.d cleared")} \u2192 ${workRef.name}`);
       console.log();
     });
   } catch (error) {
@@ -1607,7 +1658,9 @@ function exitWorkRefError(error) {
 }
 
 // src/commands/group.ts
-import { mkdir as mkdir7, rename as rename2, writeFile as writeFile4 } from "fs/promises";
+import { randomUUID } from "crypto";
+import { existsSync as existsSync6 } from "fs";
+import { link, mkdir as mkdir7, readdir as readdir2, readFile as readFile8, rename as rename2, unlink as unlink8, writeFile as writeFile4 } from "fs/promises";
 import { join as join7 } from "path";
 var ChangeGroupError = class extends Error {
   name = "ChangeGroupError";
@@ -1623,20 +1676,21 @@ async function createChangeGroup(name, goal = "") {
       const ref = resolveWorkRef(`${name}/brief`);
       if (ref.kind !== "group-brief")
         throw new WorkRefError("invalid_work_ref", `invalid Change Group name: ${name}`, name);
-      if (await hasArchivedGroupBrief(name))
-        throw new ChangeGroupError(`archived Change Group cannot be reopened: ${name}`);
-      const groupDirectory = resolveManagedDirectoryChain(CHANGES_DIR, [name], "Change Group path");
+      const groupName = ref.group;
+      if (await hasArchivedGroupBrief(groupName))
+        throw new ChangeGroupError(`archived Change Group cannot be reopened: ${groupName}`);
+      const groupDirectory = resolveManagedDirectoryChain(CHANGES_DIR, [groupName], "Change Group path");
       await mkdir7(groupDirectory, { recursive: true });
       try {
-        await writeFile4(ref.path, generateGroupBriefContent(name, goal), { flag: "wx" });
+        await writeFile4(ref.path, generateGroupBriefContent(groupName, goal), { flag: "wx" });
       } catch (error) {
         if (error.code === "EEXIST")
-          throw new ChangeGroupError(`Change Group already exists: ${name}`);
+          throw new ChangeGroupError(`Change Group already exists: ${groupName}`);
         throw error;
       }
-      console.log(`  ${pc.green("Created Change Group:")} ${name}`);
+      console.log(`  ${pc.green("Created Change Group:")} ${groupName}`);
       console.log(`  ${pc.dim("Unfocused Group Brief:")} ${ref.path}`);
-      console.log(`  ${pc.cyan("Next:")} fill the brief, then create direct child Changes with rsp create ${name}/<change>
+      console.log(`  ${pc.cyan("Next:")} fill the brief, then create direct child Changes with rsp create ${groupName}/<change>
 `);
     });
   } catch (error) {
@@ -1659,12 +1713,13 @@ async function closeChangeGroup(name) {
       if (ref.kind !== "group-brief")
         throw new ChangeGroupError(`invalid Change Group name: ${name}`);
       const inspection = await inspectChangeGroups();
-      const group = inspection.groups.find((candidate) => candidate.name === name);
+      const groupName = ref.group;
+      const group = inspection.groups.find((candidate) => candidate.name === groupName);
       if (!group)
-        throw new ChangeGroupError(`Change Group not found: ${name}`);
-      const reasons = collectCloseReasons(group, inspection.diagnostics.filter((diagnostic) => diagnostic.change === name && diagnostic.severity === "error").map((diagnostic) => diagnostic.message));
+        throw new ChangeGroupError(`Change Group not found: ${groupName}`);
+      const reasons = collectCloseReasons(group, inspection.diagnostics.filter((diagnostic) => diagnostic.change === groupName && diagnostic.severity === "error").map((diagnostic) => diagnostic.message));
       if (reasons.length > 0)
-        throw new ChangeGroupError(`Change Group "${name}" is not ready to close: ${reasons.join("; ")}`);
+        throw new ChangeGroupError(`Change Group "${groupName}" is not ready to close: ${reasons.join("; ")}`);
       const archiveDirectory = resolveArchiveDirectory(ref);
       const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
       const archiveName = resolveArchiveName(archiveDirectory, date, "brief");
@@ -1676,7 +1731,7 @@ async function closeChangeGroup(name) {
       } catch (error) {
         warnings.push(`changes directory cleanup failed: ${toErrorMessage(error)}`);
       }
-      console.log(`  ${pc.green("Closed Change Group:")} ${name}`);
+      console.log(`  ${pc.green("Closed Change Group:")} ${groupName}`);
       console.log(`  ${pc.dim("Archived Group Brief:")} ${join7(archiveDirectory, archiveName)}
 `);
       for (const warning of warnings)
@@ -1693,6 +1748,136 @@ async function closeChangeGroup(name) {
     throw error;
   }
 }
+async function reopenChangeGroup(name, options) {
+  if (!name) {
+    console.error(`  ${pc.red("Usage:")} rsp group reopen <name> --reason <text> [--from <archive-path>]`);
+    process.exit(1);
+  }
+  const reason = options.reason?.trim();
+  if (!reason || /[\r\n]/.test(reason)) {
+    console.error(`  ${pc.red("Error:")} --reason must be one non-empty line`);
+    process.exit(1);
+  }
+  guardRspInitialized();
+  try {
+    await withRspLock("reopen-change-group", async () => {
+      const groupName = normalizeWorkRefSegment(name);
+      await requireEmptyGroupRecoverySubtree(join7(CHANGES_DIR, groupName), `Change Group work subtree for ${groupName}`);
+      await requireEmptyGroupRecoverySubtree(join7(FOCUS_DIR, groupName), `Change Group focus subtree for ${groupName}`);
+      const ref = resolveWorkRef(`${groupName}/brief`);
+      if (ref.kind !== "group-brief")
+        throw new ChangeGroupError(`invalid Change Group name: ${name}`);
+      const inspection = await inspectArchiveHistory();
+      if (!historyInspectionComplete(inspection)) {
+        throw new ArchiveHistoryError(
+          "archive_inspection_incomplete",
+          "archive history inspection is incomplete; resolve the reported diagnostics before reopening a Change Group"
+        );
+      }
+      const record = selectArchivedGroupBrief(
+        inspection.groupBriefs,
+        options.from ? { path: options.from } : { group: groupName }
+      );
+      if (record.group !== groupName) {
+        throw new ArchiveHistoryError(
+          "archive_identity_mismatch",
+          `selected archived Change Group belongs to ${record.group}, not ${groupName}`
+        );
+      }
+      if (existsSync6(ref.path))
+        throw new ArchiveHistoryError("open_group_exists", `open Change Group already exists: ${groupName}`);
+      const archivedContent = await readFile8(record.sourcePath, "utf-8");
+      const document = parseRspDocument(archivedContent, GROUP_BRIEF_DOCUMENT_SCHEMA);
+      validateArchivedGroupBrief(document, groupName);
+      const evidenceKey = `${GROUP_REOPEN_COMPLETION_PREFIX} \`${record.path}\`: ${reason}`;
+      const retainedEvidence = /* @__PURE__ */ new Set();
+      for (const retained of inspection.groupBriefs.filter((candidate) => candidate.group === groupName)) {
+        const content = retained.sourcePath === record.sourcePath ? archivedContent : await readFile8(retained.sourcePath, "utf-8");
+        for (const item of getGroupReopenEvidence(content))
+          retainedEvidence.add(item.key);
+      }
+      if (retainedEvidence.has(evidenceKey)) {
+        throw new ArchiveHistoryError(
+          "archive_reopen_evidence_replayed",
+          `reopen evidence already exists in retained Change Group history; choose a fresh reason or a different exact archive: ${record.path}`
+        );
+      }
+      const reopenedContent = appendDocumentSectionItem(
+        document,
+        "completionConditions",
+        `- [ ] ${evidenceKey}`
+      );
+      const groupDirectory = resolveManagedDirectoryChain(CHANGES_DIR, [groupName], "Change Group path");
+      await mkdir7(groupDirectory, { recursive: true });
+      const temporaryPath = join7(RSP_DIR, `.group-reopen-${process.pid}-${randomUUID()}.tmp`);
+      let mutationError;
+      try {
+        await writeFile4(temporaryPath, reopenedContent, { flag: "wx" });
+        await link(temporaryPath, ref.path);
+      } catch (error) {
+        mutationError = error;
+      }
+      try {
+        await unlink8(temporaryPath);
+      } catch (error) {
+        if (!mutationError)
+          console.log(`  ${pc.yellow("\u26A0")} temporary reopen file cleanup failed: ${toErrorMessage(error)}`);
+      }
+      if (mutationError) {
+        try {
+          await cleanupEmptyParentDirs(ref.path, CHANGES_DIR);
+        } catch {
+        }
+        if (mutationError.code === "EEXIST")
+          throw new ArchiveHistoryError("open_group_exists", `open Change Group already exists: ${groupName}`);
+        throw mutationError;
+      }
+      console.log(`  ${pc.green("Reopened Change Group:")} ${groupName}`);
+      console.log(`  ${pc.dim("retained archive")} \u2192 ${record.path}`);
+      console.log(`  ${pc.dim("unfocused Group Brief")} \u2192 ${ref.path}`);
+      console.log(`  ${pc.cyan("Next:")} run rsp reopen ${groupName}/<change> --reason <text> only for an incomplete archived child
+`);
+    });
+  } catch (error) {
+    if (error instanceof ArchiveHistoryError || error instanceof WorkRefError || error instanceof ChangeGroupError || error instanceof ManagedPathError) {
+      console.error(`  ${pc.red("Error:")} ${error.message}`);
+      if (error instanceof ArchiveHistoryError) {
+        for (const candidate of error.candidates)
+          console.error(`    ${candidate}`);
+        if (error.candidatesTruncated)
+          console.error(`    ... ${error.candidateTotal - error.candidates.length} more`);
+      }
+      process.exit(1);
+    }
+    throw error;
+  }
+}
+async function requireEmptyGroupRecoverySubtree(path, label) {
+  if (!requireManagedDirectory(path, label, { allowMissing: true }))
+    return;
+  let entries;
+  try {
+    entries = await readdir2(path);
+  } catch (error) {
+    throw new ChangeGroupError(`unable to inspect ${label}: ${toErrorMessage(error)}`);
+  }
+  if (entries.length > 0)
+    throw new ChangeGroupError(`${label} must be absent or empty before reopen; found: ${entries.sort().join(", ")}`);
+}
+function validateArchivedGroupBrief(document, group) {
+  const titles = getDocumentTitles(document, "identity");
+  if (titles.length !== 1 || titles[0] !== group)
+    throw new ArchiveHistoryError("archive_heading_invalid", `archived Change Group must contain exactly one canonical identity heading for ${group}`);
+  for (const section of GROUP_BRIEF_DOCUMENT_SCHEMA.sections) {
+    const matches = getDocumentSections(document, section.id);
+    if (matches.length !== 1 || !matches[0].canonical || !getDocumentSectionBody(document, section.id)) {
+      throw new ArchiveHistoryError(
+        "archive_section_invalid",
+        `archived Change Group must contain exactly one canonical required section: ${section.heading}`
+      );
+    }
+  }
+}
 function collectCloseReasons(group, errors) {
   const reasons = [...errors, ...group.warnings];
   const open = group.slices.filter((slice) => slice.state === "open").map((slice) => slice.name);
@@ -1712,8 +1897,6 @@ function collectCloseReasons(group, errors) {
 
 // src/commands/history.ts
 var DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
-var GROUP_RE = /^[a-z0-9-]+$/;
-var WORK_REF_RE = /^[a-z0-9-]+(?:\/[a-z0-9-]+)?$/;
 async function showHistory(input = {}, options = {}) {
   guardRspInitialized();
   const mode = input.workRef ? "detail" : "list";
@@ -1727,15 +1910,15 @@ async function showHistory(input = {}, options = {}) {
       message: "archive history inspection is incomplete; resolve the reported diagnostics before querying history"
     }, inspection.diagnostics, inspection.diagnosticSummary, inspection.runtime, options);
   }
-  if (input.workRef) {
+  if (validation.workRef) {
     try {
-      const selected = selectArchiveHistoryRecord(inspection.records, { workRef: input.workRef });
+      const selected = selectArchiveHistoryRecord(inspection.records, { workRef: validation.workRef });
       const record = await readArchiveHistoryDetail(selected);
       const result2 = {
         command: "history",
         ok: true,
         mode: "detail",
-        query: { workRef: input.workRef },
+        query: { workRef: validation.workRef },
         record,
         diagnostics: [],
         diagnosticSummary: emptyCollectionSummary(),
@@ -1788,11 +1971,15 @@ function validateHistoryQuery(input) {
   if ((input.positionalCount ?? (input.workRef ? 1 : 0)) > 1)
     return invalid("history_positional_args_unsupported", "history accepts at most one positional WorkRef");
   if (input.workRef) {
-    if (!WORK_REF_RE.test(input.workRef) || input.workRef.endsWith("/brief") || input.workRef.endsWith("/00-brief"))
+    let workRef;
+    try {
+      workRef = normalizeExecutableWorkRef(input.workRef);
+    } catch {
       return invalid("invalid_history_work_ref", "history WorkRef must be a flat or one-Group-level executable Change identity");
+    }
     if (input.limit !== void 0 || input.since !== void 0 || input.until !== void 0 || input.kind !== void 0 || input.group !== void 0 || input.search !== void 0)
       return invalid("history_detail_filters_unsupported", "list filters cannot be combined with an exact history detail lookup");
-    return { ok: true, query: {} };
+    return { ok: true, query: {}, workRef };
   }
   const limit = input.limit === void 0 ? HISTORY_DEFAULT_LIMIT : Number(input.limit);
   if (input.limit !== void 0 && !/^[1-9]\d*$/.test(input.limit) || !Number.isInteger(limit) || limit < 1 || limit > HISTORY_MAX_LIMIT)
@@ -1805,8 +1992,14 @@ function validateHistoryQuery(input) {
     return invalid("invalid_history_date_range", "--since must be on or before --until");
   if (input.kind !== void 0 && input.kind.trim() === "")
     return invalid("invalid_history_kind", "--kind must be a non-empty exact historical kind");
-  if (input.group !== void 0 && !GROUP_RE.test(input.group))
-    return invalid("invalid_history_group", "--group must be one lowercase kebab-case Group name");
+  let group = input.group;
+  if (group !== void 0) {
+    try {
+      group = normalizeWorkRefSegment(group);
+    } catch {
+      return invalid("invalid_history_group", "--group must be one safe Unicode Group name");
+    }
+  }
   if (input.search !== void 0 && input.search.trim() === "")
     return invalid("invalid_history_search", "--search must be non-empty");
   return {
@@ -1816,7 +2009,7 @@ function validateHistoryQuery(input) {
       since: input.since,
       until: input.until,
       kind: input.kind?.trim(),
-      group: input.group,
+      group,
       search: input.search?.trim()
     }
   };
@@ -1892,6 +2085,11 @@ function printHistoryDetail(result) {
   console.log(`  ${pc.dim("Kind:")} ${record.kind}`);
   console.log(`  ${pc.dim("Path:")} ${record.path}`);
   console.log(`  ${pc.dim("Summary:")} ${record.summary}${record.summaryTruncated ? "\u2026" : ""}`);
+  if ((record.issues?.length ?? 0) > 0) {
+    console.log(`  ${pc.dim("Issues:")}`);
+    for (const issue of record.issues ?? [])
+      console.log(`    ${issue.relation} ${issue.url}`);
+  }
   console.log(`  ${pc.dim("Scenarios:")} ${record.scenarioCount}`);
   console.log(`  ${pc.dim("Tasks:")} ${record.checkboxes.tasks.done}/${record.checkboxes.tasks.total}`);
   console.log(`  ${pc.dim("Verify:")} ${record.checkboxes.verify.done}/${record.checkboxes.verify.total}`);
@@ -1909,8 +2107,8 @@ function printHistoryDetail(result) {
 }
 
 // src/commands/init.ts
-import { existsSync as existsSync6 } from "fs";
-import { mkdir as mkdir8, readFile as readFile8 } from "fs/promises";
+import { existsSync as existsSync7 } from "fs";
+import { mkdir as mkdir8, readFile as readFile9 } from "fs/promises";
 import { join as join8 } from "path";
 function generateConfigTemplate() {
   const fmtList = (items, indent) => items.map((i) => `${" ".repeat(indent)}# - ${i}`).join("\n");
@@ -1925,6 +2123,13 @@ function generateConfigTemplate() {
 # kinds:
 ${fmtList(VALID_KINDS, 0)}
 
+# Set one shared project default for durable artifact and commit prose.
+# Optional artifacts or commit values override that durable surface independently.
+# Response language remains user/session-owned and is never read from this project mapping.
+# Omit this mapping to keep durable language selection under scoped project authority.
+# language:
+#   default: en
+
 # New projects default to automatic Manage routing with lifecycle-only closeout.
 # Use activation: explicit to require a named managed request.
 # closeout accepts manual, lifecycle, or local; local routes a qualified clean terminal non-small boundary to one local commit but never push or publication.
@@ -1945,7 +2150,7 @@ function toTitle(projectName) {
   return projectName.startsWith("@") ? projectName.split("/")[1] || projectName : projectName;
 }
 async function initProject(args = {}) {
-  const isNew = !existsSync6(RSP_DIR);
+  const isNew = !existsSync7(RSP_DIR);
   const projectName = await detectProjectName();
   const mode = args.agentsMode ?? "managed";
   if (mode !== "managed" && mode !== "print") {
@@ -1960,7 +2165,7 @@ async function initProject(args = {}) {
     const agentsInspection = inspectManagedFile(agentsPath, "AGENTS.md", { allowMissing: true });
     if (agentsInspection.issue)
       throw agentsInspection.issue;
-    if (existsSync6(CONFIG_PATH)) {
+    if (existsSync7(CONFIG_PATH)) {
       clearConfigCache();
       const existingConfig = await inspectRspConfig();
       if (existingConfig.issues.length > 0)
@@ -1981,7 +2186,7 @@ async function initProject(args = {}) {
     for (const directory of dirs)
       await mkdir8(directory.path, { recursive: true });
     let created = false;
-    const bundledRules = await readFile8(join8(PKG_ROOT, "rules", "rsp-rules.md"), "utf-8");
+    const bundledRules = await readFile9(join8(PKG_ROOT, "rules", "rsp-rules.md"), "utf-8");
     created = await ensureFile(RSP_RULES_PATH, bundledRules) || created;
     created = await ensureFile(join8(RSP_DIR, "config.yaml"), generateConfigTemplate()) || created;
     clearConfigCache();
@@ -2014,7 +2219,7 @@ ${upsertRspAgentsBlock("").content}
       created = true;
       agentsUpdated = true;
     } else {
-      const existing = await readFile8(agentsPath, "utf-8");
+      const existing = await readFile9(agentsPath, "utf-8");
       const next = upsertRspAgentsBlock(existing);
       if (next.changed) {
         await writeManagedFile(agentsPath, next.content, "AGENTS.md");
@@ -2023,7 +2228,7 @@ ${upsertRspAgentsBlock("").content}
       }
     }
     if (mode === "print") {
-      const managed = await readFile8(agentsPath, "utf-8");
+      const managed = await readFile9(agentsPath, "utf-8");
       console.log(`
 ${managed}
 `);
@@ -2062,7 +2267,7 @@ ${managed}
 }
 
 // src/commands/ready.ts
-import { readFile as readFile9 } from "fs/promises";
+import { readFile as readFile10 } from "fs/promises";
 function exitReadyError(name, error, options) {
   if (options.json) {
     emitJson({
@@ -2097,7 +2302,7 @@ async function showReady(name, options = {}) {
   const runtime = [];
   let content;
   try {
-    content = await readFile9(srcPath, "utf-8");
+    content = await readFile10(srcPath, "utf-8");
   } catch {
     console.error(`  ${pc.red("Error:")} unable to read .rsp/changes/${name}.md`);
     process.exit(1);
@@ -2180,8 +2385,8 @@ function formatArchiveReady(value) {
 }
 
 // src/commands/reopen.ts
-import { existsSync as existsSync7 } from "fs";
-import { mkdir as mkdir9, readFile as readFile10, unlink as unlink8, writeFile as writeFile5 } from "fs/promises";
+import { existsSync as existsSync8 } from "fs";
+import { mkdir as mkdir9, readFile as readFile11, unlink as unlink9, writeFile as writeFile5 } from "fs/promises";
 import { dirname as dirname4 } from "path";
 async function reopenChange(name, options) {
   if (!name) {
@@ -2196,6 +2401,7 @@ async function reopenChange(name, options) {
   guardRspInitialized();
   try {
     await withRspLock("reopen-change", async () => {
+      const normalizedName = normalizeExecutableWorkRef(name);
       const inspection = await inspectArchiveHistory();
       if (!historyInspectionComplete(inspection)) {
         throw new ArchiveHistoryError(
@@ -2205,17 +2411,17 @@ async function reopenChange(name, options) {
       }
       const record = selectArchiveHistoryRecord(
         inspection.records,
-        options.from ? { path: options.from } : { workRef: name }
+        options.from ? { path: options.from } : { workRef: normalizedName }
       );
-      if (record.workRef !== name) {
+      if (record.workRef !== normalizedName) {
         throw new ArchiveHistoryError(
           "archive_identity_mismatch",
-          `selected archive belongs to ${record.workRef}, not ${name}`
+          `selected archive belongs to ${record.workRef}, not ${normalizedName}`
         );
       }
       let workRef;
       try {
-        workRef = resolveWorkRef(name, { executable: true });
+        workRef = resolveWorkRef(normalizedName, { executable: true });
       } catch (error) {
         if (error instanceof WorkRefError && error.code === "group_brief_missing") {
           throw new ArchiveHistoryError(
@@ -2225,15 +2431,15 @@ async function reopenChange(name, options) {
         }
         throw error;
       }
-      if (existsSync7(workRef.path))
+      if (existsSync8(workRef.path))
         throw new ArchiveHistoryError("open_change_exists", `open Change already exists: ${name}`);
       const focusEntry = resolveFocusMarkerPath(workRef);
-      if (existsSync7(focusEntry))
+      if (existsSync8(focusEntry))
         throw new ArchiveHistoryError("focus_marker_exists", `focus marker already exists for non-open Change: ${name}; run rsp doctor`);
-      const archivedContent = await readFile10(record.sourcePath, "utf-8");
+      const archivedContent = await readFile11(record.sourcePath, "utf-8");
       const reopenedContent = appendChecklistItem(
-        appendChecklistItem(archivedContent, "Tasks", `- [ ] Resolve reopened concern: ${reason}`),
-        "Verify",
+        appendChecklistItem(archivedContent, "tasks", `- [ ] Resolve reopened concern: ${reason}`),
+        "verify",
         `- [ ] Verify reopened concern: ${reason}`
       );
       await mkdir9(dirname4(workRef.path), { recursive: true });
@@ -2247,19 +2453,19 @@ async function reopenChange(name, options) {
       } catch (error) {
         if (changeCreated) {
           try {
-            await unlink8(workRef.path);
+            await unlink9(workRef.path);
             await cleanupEmptyParentDirs(workRef.path, CHANGES_DIR);
           } catch {
           }
         }
         throw error;
       }
-      console.log(`  ${pc.green("Reopened:")} ${name}`);
+      console.log(`  ${pc.green("Reopened:")} ${workRef.name}`);
       console.log(`  ${pc.dim("retained archive")} \u2192 ${record.path}`);
-      console.log(`  ${pc.dim("focused via focus.d")} \u2192 ${name}`);
+      console.log(`  ${pc.dim("focused via focus.d")} \u2192 ${workRef.name}`);
       console.log(`  ${pc.cyan("Next:")} refine the reopened Task and Verify evidence, then resolve the concern
 `);
-      if (existsSync7(".git")) {
+      if (existsSync8(".git")) {
         console.log(`  ${pc.cyan("Git delivery:")}`);
         console.log(`    git status --short`);
         console.log(`    Inspect the complete reopen transition; stage and commit only with separate Git authority.`);
@@ -2280,25 +2486,22 @@ async function reopenChange(name, options) {
     throw error;
   }
 }
-function appendChecklistItem(content, heading, item) {
-  const headings = [...content.matchAll(new RegExp(`^## ${heading}[ \\t]*\\r?$`, "gm"))];
-  if (headings.length !== 1) {
+function appendChecklistItem(content, sectionId, item) {
+  try {
+    return appendDocumentSectionItem(parseRspDocument(content, CHANGE_DOCUMENT_SCHEMA), sectionId, item);
+  } catch (error) {
+    if (!(error instanceof DocumentSectionCardinalityError))
+      throw error;
+    const heading = CHANGE_DOCUMENT_SCHEMA.sections.find((section) => section.id === sectionId).heading;
     throw new ArchiveHistoryError(
       "archive_section_invalid",
       `archived Change must contain exactly one required section: ${heading}`
     );
   }
-  const sectionBodyStart = headings[0].index + headings[0][0].length;
-  const nextHeading = content.indexOf("\n## ", sectionBodyStart);
-  const insertAt = nextHeading < 0 ? content.length : nextHeading;
-  const before = content.slice(0, insertAt);
-  const separator = before.endsWith("\n\n") ? "" : before.endsWith("\n") ? "\n" : "\n\n";
-  return `${before}${separator}${item}
-${content.slice(insertAt)}`;
 }
 
 // src/commands/show.ts
-import { readFile as readFile11 } from "fs/promises";
+import { readFile as readFile12 } from "fs/promises";
 function exitShowError(error, options) {
   const nextActions = error.code === "no_focused_change" ? ["Run: rsp status", "Run: rsp focus <name>", "Or run: rsp create <name>"] : [];
   if (options.json) {
@@ -2356,15 +2559,19 @@ async function showChange(nameOrFocused, options = {}) {
   const srcPath = workRef.path;
   let content;
   try {
-    content = await readFile11(srcPath, "utf-8");
+    content = await readFile12(srcPath, "utf-8");
   } catch {
     exitShowError({ code: "change_read_failed", message: `unable to read .rsp/changes/${name}.md` }, options);
   }
   let kind = "\u2014";
+  let issues = [];
   try {
     const fm = parseFrontmatter(content);
     kind = fm?.kind ? String(fm.kind) : "\u2014";
+    issues = parseIssueRelationships(fm);
   } catch (error) {
+    if (error instanceof IssueRelationshipError)
+      exitShowError({ code: error.code, message: error.message }, options);
     kind = "(invalid)";
     reportRuntime({
       code: "frontmatter_parse_failed",
@@ -2411,6 +2618,7 @@ async function showChange(nameOrFocused, options = {}) {
       name,
       path: normalizeLogicalPath(srcPath),
       kind,
+      issues,
       isFocused,
       progress: { done: cb.done, total: cb.total },
       blockers,
@@ -2429,6 +2637,11 @@ async function showChange(nameOrFocused, options = {}) {
   console.log(`  ${pc.bold("Change:")} ${pc.cyan(name)}`);
   console.log(`  ${pc.dim("Path:")} ${normalizeLogicalPath(srcPath)}`);
   console.log(`  ${pc.dim("Kind:")} ${kind}`);
+  if (issues.length > 0) {
+    console.log(`  ${pc.dim("Issues:")}`);
+    for (const issue of issues)
+      console.log(`    ${issue.relation} ${issue.url}`);
+  }
   console.log(`  ${pc.dim("Focused:")} ${isFocused ? pc.green("yes") : pc.dim("no")}`);
   console.log(`  ${pc.dim("Progress:")} ${cb.done}/${cb.total}`);
   console.log(`  ${pc.dim("Blockers:")} ${blockers ? pc.yellow("yes") : pc.green("no")}`);
@@ -2488,6 +2701,7 @@ function deriveStatusView(snapshot, options = {}) {
   const nextActions = ok ? buildStatusNextActions(snapshot.focused.length, snapshot.records.map((record) => record.output), snapshot.groups, filtered) : ["Run: rsp doctor"];
   return {
     manage: snapshot.manage,
+    language: snapshot.language,
     query,
     focused: snapshot.focused,
     records,
@@ -2584,6 +2798,8 @@ function printStatusPlain(view) {
   console.log(`  ${pc.bold("RSP status")}`);
   console.log();
   console.log(`  ${pc.bold("Manage:")} activation ${view.manage.activation} \xB7 closeout ${view.manage.closeout}`);
+  if (view.language.artifacts !== null || view.language.commit !== null)
+    console.log(`  ${pc.bold("Language:")} artifacts ${view.language.artifacts ?? "unset"} \xB7 commit ${view.language.commit ?? "unset"}`);
   console.log();
   for (const diagnostic of view.diagnostics) {
     const label = diagnostic.change ?? diagnostic.path;
@@ -2703,6 +2919,7 @@ function toStatusJson(view) {
     command: "status",
     ok: view.ok,
     manage: view.manage,
+    language: view.language,
     filters: view.query,
     focused: view.focused,
     records: view.records.map((record) => record.output),
@@ -2720,6 +2937,7 @@ function toStatusJsonError(error, options) {
     command: "status",
     ok: false,
     manage: { activation: "explicit", closeout: "manual" },
+    language: { artifacts: null, commit: null },
     filters: {
       focused: options.focused,
       blocked: options.blocked,
@@ -2828,24 +3046,36 @@ var createCommand = defineCommand({
     description: "Create .rsp/changes/<name>.md [summary]"
   },
   args: {
-    name: {
+    "name": {
       type: "positional",
       description: "Change name",
       required: true
     },
-    kind: {
+    "kind": {
       type: "string",
       description: "Optional kind for a kind-aware template (feature, fix, refactor, docs, ops, research)"
     },
-    lite: {
+    "lite": {
       type: "boolean",
       description: "Use a shorter change template while keeping the required RSP sections",
       default: false
+    },
+    "issue": {
+      type: "string",
+      description: "Attach one external issue URL without fetching it"
+    },
+    "issue-relation": {
+      type: "string",
+      description: "Issue relationship: relates (default) or closes; requires --issue"
     }
   },
   async run({ args }) {
     const summary = Array.isArray(args._) && args._.length > 1 ? args._.slice(1).join(" ") : "";
-    await createChange(args.name, summary, args.kind, { lite: Boolean(args.lite) });
+    await createChange(args.name, summary, args.kind, {
+      lite: Boolean(args.lite),
+      issue: args.issue,
+      issueRelation: args.issueRelation
+    });
   }
 });
 var groupCreateCommand = defineCommand({
@@ -2868,7 +3098,7 @@ var groupCreateCommand = defineCommand({
 var groupCommand = defineCommand({
   meta: {
     name: "group",
-    description: "Create and close shallow Change Groups"
+    description: "Create, close, and explicitly reopen shallow Change Groups"
   },
   subCommands: {
     create: groupCreateCommand,
@@ -2887,6 +3117,31 @@ var groupCommand = defineCommand({
       async run({ args }) {
         await closeChangeGroup(args.name);
       }
+    }),
+    reopen: defineCommand({
+      meta: {
+        name: "reopen",
+        description: "Restore one archived Group Brief while retaining history"
+      },
+      args: {
+        name: {
+          type: "positional",
+          description: "Archived Change Group name",
+          required: true
+        },
+        from: {
+          type: "string",
+          description: "Exact .rsp/archives/... path when the Group has multiple archives"
+        },
+        reason: {
+          type: "string",
+          description: "One-line concern that makes Group completion unfinished",
+          required: true
+        }
+      },
+      async run({ args }) {
+        await reopenChangeGroup(args.name, { from: args.from, reason: args.reason });
+      }
     })
   }
 });
@@ -3352,7 +3607,7 @@ async function runCli(rawArgs = process.argv.slice(2)) {
   if (shouldLaunchSkillsUi(rawArgs, terminalEnvironment)) {
     const { resolveUiLocale } = await import("./locale-HT44UIUP.mjs");
     const locale = resolveUiLocale("auto", process.env.RSP_UI_LANG, process.env.LC_ALL ?? process.env.LC_MESSAGES ?? process.env.LANG ?? new Intl.DateTimeFormat().resolvedOptions().locale);
-    const { runSkillsTui } = await import("./entry-WZDVKDUM.mjs");
+    const { runSkillsTui } = await import("./entry-BKEJDNOQ.mjs");
     const selection = await runSkillsTui(locale);
     if (selection.kind === "confirmed") {
       const result = await installPackagedSkills({ names: selection.names, force: selection.force });
@@ -3370,7 +3625,7 @@ async function runCli(rawArgs = process.argv.slice(2)) {
     } else {
       const { resolveUiLocale } = await import("./locale-HT44UIUP.mjs");
       const locale = resolveUiLocale(lang, process.env.RSP_UI_LANG, process.env.LC_ALL ?? process.env.LC_MESSAGES ?? process.env.LANG ?? new Intl.DateTimeFormat().resolvedOptions().locale);
-      const { runTui } = await import("./entry-X23GPCVS.mjs");
+      const { runTui } = await import("./entry-ETZGIFKP.mjs");
       const exitCode = await runTui(locale);
       if (exitCode !== 0)
         process.exitCode = exitCode;