@printpractical/cruze 0.0.13 → 0.0.15

package/src/domain/versions/cruze_version.ts

@@ -36,15 +36,9 @@ export function versionSkew(cli: string, recorded: string | undefined): VersionS
  * after `version:`, so the file's comments and layout survive.
  */
 export function withRecordedVersion(configText: string, version: string): string {
-  return withVersionLine(configText, "cruze", version);
-}
-
-/** The config text with a top-level version key, such as `cruze:` or `standards:`, set in place. */
-export function withVersionLine(configText: string, key: "cruze" | "standards", version: string): string {
-  const line = `${key}: ${JSON.stringify(version)}`;
-  const existing = new RegExp(`^${key}:.*$`, "m");
-  if (existing.test(configText)) return configText.replace(existing, line);
-  const anchor = key === "standards" ? /^cruze:.*$/m.exec(configText) ?? /^version:.*$/m.exec(configText) : /^version:.*$/m.exec(configText);
+  const line = `cruze: ${JSON.stringify(version)}`;
+  if (/^cruze:.*$/m.test(configText)) return configText.replace(/^cruze:.*$/m, line);
+  const anchor = /^version:.*$/m.exec(configText);
   if (anchor === null) return `${line}\n${configText}`;
   const end = anchor.index + anchor[0].length;
   return `${configText.slice(0, end)}\n${line}${configText.slice(end)}`;

package/src/main.ts

@@ -10,7 +10,7 @@ import { ProcessAgentRunner } from "./adapters/outbound/process_agent_runner.ts"
 import { SystemClock } from "./adapters/outbound/system_clock.ts";
 import { DefaultAnswerPrompter, TerminalPrompter } from "./adapters/outbound/terminal_prompter.ts";
 
-// A reader that stops early, such as `cruze journal list | head`, closes the pipe; that is not an error worth a stack trace.
+// A reader that stops early, such as `cruze status --text | head`, closes the pipe; that is not an error worth a stack trace.
 process.stdout.on("error", (error: NodeJS.ErrnoException) => {
   if (error.code === "EPIPE") process.exit(0);
   throw error;

package/templates/init/AGENTS.md

@@ -1,28 +1,20 @@
 # {{project_name}}
 
-Instructions for coding agents working in this repository. Cruze keeps the managed sections current as changes land; edit everything else freely.
+Instructions for coding agents working in this repository.
 
 ## Workflow
 
-This project uses [Cruze](https://github.com/PrintPractical/cruze) for spec-driven development. Durable documents live in `docs/`: vision, glossary, architecture, ADRs, specs and roadmap. Work in progress lives in `.cruze/`. Before changing code, read the design the change builds with `cruze show <change>`, once it exists. Each Cruze step runs in a new session, so its context holds what the step reads and nothing else. The Cruze skills run the `cruze` command; when it is missing, install it as https://github.com/PrintPractical/cruze#quick-start describes.
+This project uses [Cruze](https://github.com/PrintPractical/cruze). `docs/vision.md` says what the product is for and which features the release holds; `docs/architecture.md` maps its ports, adapters and runtime; each `docs/features/<slug>.md` holds one feature's behaviour, public API and stack sketch, approved by the user before it is built. Run `cruze next` to see what comes next. The Cruze skills run the `cruze` command; when it is missing, install it as https://github.com/PrintPractical/cruze#quick-start describes.
 
 ## Commands
 
-<!-- cruze:managed -->
-No build or test commands yet. `cruze land` fills this in when the foundation change lands.
-<!-- /cruze:managed -->
+No build or test commands yet. The foundation feature fills this in.
 
 ## Layout
 
-<!-- cruze:managed -->
-Not defined yet. `cruze land` fills this in from the module map in `docs/architecture.md`.
-<!-- /cruze:managed -->
+Not defined yet. The foundation feature fills this in from `docs/architecture.md`.
 
 ## Conventions
 
 - Commit messages follow [Conventional Commits](https://www.conventionalcommits.org/).
 - Record notable changes under `[Unreleased]` in `CHANGELOG.md`.
-
-## Known pitfalls
-
-None recorded yet. `land` adds a line here when the same review finding or defect about this project's code happens twice.

package/templates/init/ci.yml

@@ -13,11 +13,11 @@ jobs:
       - uses: actions/setup-node@v5
         with:
           node-version: 22
-      # The foundation change adds the language's format, lint, build and
-      # test steps here, from `commands:` in .cruze/config.yaml.
+      # The foundation feature adds the language's format, lint, build and
+      # test steps here, with a coverage gate.
       - name: Documents match the Cruze formats
         run: npx --yes --package={{cruze_package}} cruze validate
       - name: Layer rules and file budgets
         run: npx --yes --package={{cruze_package}} cruze check --ci
       - name: Every built scenario has a test
-        run: npx --yes --package={{cruze_package}} cruze trace --all
+        run: npx --yes --package={{cruze_package}} cruze trace

package/templates/init/config.yaml

@@ -1,33 +1,24 @@
 # Cruze project configuration, created by cruze {{cruze_version}}.
-# The format is described in .agents/skills/cruze-formats/reference/config.md.
-version: 1
+# The format is described in .agents/skills/cruze-formats/config.md.
+version: 2
 # The Cruze whose skills this project installed. `cruze install` keeps it current.
 cruze: "{{cruze_version}}"
-# The Cruze whose expectations the code meets. `realign` moves it forward.
-standards: "{{cruze_version}}"
 project: {{project_name_quoted}}
 
-# Where work items are tracked. V1 supports markdown in the repository only.
-tracker: markdown
-
-# Source files `cruze check` inspects, and files `cruze trace` searches for
-# scenario IDs. Project-scope architecture design sets these.
+# Source files `cruze check` inspects, and test files `cruze trace` searches
+# for scenario IDs. The foundation feature sets these.
 source: []
 tests: []
 
-# Budgets enforced by `cruze check`: a backstop against a file that has
-# outgrown one responsibility, not a size to design to. List a file under
-# exceptions, with a reason, to allow it past a budget.
+# Budgets `cruze check` warns on: a backstop against a file that has outgrown
+# one responsibility, not a size to design to. List a file under exceptions,
+# with a reason, to allow it past a budget.
 check:
   max_lines: 600
   max_types: 12
   exceptions: []
 
-# Layer rules, written by project-scope architecture design from the module map.
+# Layer rules from docs/architecture.md: which layer may import which.
 layers: []
 
-# The project's commands, by name, such as `test: cargo test`. The
-# foundation change fills them in; `cruze land` copies them into AGENTS.md.
-commands: {}
-
 {{review_setting}}

package/templates/init/review/claude.yaml

@@ -1,7 +1,7 @@
 # How `cruze review` starts an agent in a fresh context to run a role, with the
 # prompt on standard input. This lets Claude Code read the project and run git
-# and cruze. The verifier runs the system, so add the project's build and run
-# commands, such as "Bash(cargo:*)". Without review.command, your agent runs each
+# and cruze. To let the reviewer run the tests, add the project's test
+# command, such as "Bash(cargo test:*)". Without review.command, your agent runs each
 # role in a helper of its own.
 review:
   command: ["claude", "-p", "--allowedTools", "Read Grep Glob Bash(git diff:*) Bash(git log:*) Bash(git show:*) Bash(cruze:*)"]

package/dist/adapters/inbound/cli/argument_files.js

@@ -1,29 +0,0 @@
-import { mkdir, readFile, writeFile } from "node:fs/promises";
-import { dirname, resolve } from "node:path";
-import { UsageError } from "./cli_context.js";
-
-// Files a person or agent names on the command line, such as a scratch file of review blockers or
-// the path for an exported bundle. They may be anywhere, unlike project files, and relative paths
-// resolve against the working directory.
-
-export async function readArgumentFile(path        )                  {
-  try {
-    return await readFile(resolve(path), "utf8");
-  } catch (error) {
-    throw new UsageError(`cannot read ${path}: ${reason(error)}`);
-  }
-}
-
-export async function writeArgumentFile(path        , text        )                {
-  try {
-    await mkdir(dirname(resolve(path)), { recursive: true });
-    await writeFile(resolve(path), text, "utf8");
-  } catch (error) {
-    throw new UsageError(`cannot write ${path}: ${reason(error)}`);
-  }
-}
-
-function reason(error         )         {
-  if (error instanceof Error && "code" in error && typeof error.code === "string") return error.code;
-  return error instanceof Error ? error.message : String(error);
-}

package/dist/adapters/inbound/cli/commands/diff.js

@@ -1,23 +0,0 @@
-import { upstreamDiff,                         } from "../../../../app/use_cases/upstream_diff.js";
-import { requireArgs,                                     } from "../cli_context.js";
-
-export async function runDiff(context            , args          )                         {
-  requireArgs(args, ["ref"]);
-  const report = await upstreamDiff(context, args[0] ?? "");
-  return { json: report, human: render(report) };
-}
-
-function render(report                    )         {
-  const lines = [`${report.artifact}: ${report.state}`];
-  if (report.changes.length === 0) lines.push("Nothing it cites changed since its approval.");
-  for (const change of report.changes) {
-    lines.push("", `${change.key}${change.path === undefined ? "" : ` in ${change.path}`}:`);
-    lines.push(...(change.diff ?? [change.note ?? ""]).map((line) => `  ${line}`));
-  }
-  if (report.rebase.length > 0) {
-    lines.push("", `Its delta changes ${report.rebase.join(", ")}: rewrite the delta to keep the new text, then approve with ${report.rebase.map((id) => `--rebase ${id}`).join(" ")}.`);
-  } else if (report.ref !== undefined && report.state === "upstream-changed") {
-    lines.push("", `No rebase needed. When the work still holds against this, re-stamp it with cruze approve ${report.ref} --restamp-unchanged.`);
-  }
-  return lines.join("\n");
-}

package/dist/adapters/inbound/cli/commands/journal.js

@@ -1,32 +0,0 @@
-import { exportFeedback, listEvents, recordEvent } from "../../../../app/use_cases/journal_events.js";
-import { writeArgumentFile } from "../argument_files.js";
-import { UsageError, requireArgs,                                                   } from "../cli_context.js";
-
-export async function runJournal(context            , args          , options         )                         {
-  requireArgs(args, ["add|list"]);
-  if (args[0] === "add") {
-    requireArgs(args, ["add", "event"]);
-    const fields = Object.fromEntries(options.set.map((pair) => {
-      const at = pair.indexOf("=");
-      if (at < 1) throw new UsageError(`--set takes key=value, not "${pair}"`);
-      return [pair.slice(0, at), pair.slice(at + 1)];
-    }));
-    const entry = await recordEvent(context, args[1] ?? "", fields, options.item);
-    return { json: entry, human: `Recorded ${entry.event}.` };
-  }
-  if (args[0] === "list") {
-    const entries = await listEvents(context, options.event, options.item, options.all);
-    return { json: entries, human: entries.map((e) => `${e.at} ${e.event} ${JSON.stringify({ ...e, at: undefined, event: undefined, by: undefined })}`).join("\n") || "No entries." };
-  }
-  throw new UsageError(`cruze journal takes add or list, not "${args[0]}"`);
-}
-
-export async function runFeedback(context            , args          , options         )                         {
-  if (args[0] !== "export") throw new UsageError("usage: cruze feedback export [--out <file>] [--no-redact]");
-  const bundle = await exportFeedback(context, options.redact);
-  if (options.out !== undefined) {
-    await writeArgumentFile(options.out, `${JSON.stringify(bundle, null, 2)}\n`);
-    return { json: { out: options.out, entries: bundle.entries.length }, human: `Wrote ${bundle.entries.length} entries to ${options.out}.` };
-  }
-  return { json: bundle, human: `${bundle.entries.length} journal entries${bundle.redacted ? ", redacted" : ""}.` };
-}

package/dist/adapters/inbound/cli/commands/progress.js

@@ -1,55 +0,0 @@
-import { addFutureFeature, completeTask, dropFutureFeature, updateFeatureSummary, pruneRoadmap, recordDeviation, reopenTask } from "../../../../app/use_cases/record_progress.js";
-import { abandonWork } from "../../../../app/use_cases/abandon_work.js";
-import { UsageError, requireArgs, requireOption,                                                   } from "../cli_context.js";
-
-export async function runTask(context            , args          , options         )                         {
-  requireArgs(args, ["done|deviation|reopen", "task"]);
-  const change = options.change === undefined ? {} : { change: options.change };
-  if (args[0] === "done") {
-    const report = await completeTask(context, args[1] ?? "", { ...change, ...(options.commit === undefined ? {} : { commit: options.commit }) });
-    return { json: report, human: `${report.task} done in ${report.change} (${report.done}/${report.total}).` };
-  }
-  if (args[0] === "deviation") {
-    requireArgs(args, ["deviation", "task", "text"]);
-    const report = await recordDeviation(context, args[1] ?? "", args.slice(2).join(" "), change);
-    return { json: report, human: `Recorded a deviation on ${report.task} in ${report.change}.` };
-  }
-  if (args[0] === "reopen") {
-    requireArgs(args, ["reopen", "task", "reason"]);
-    const report = await reopenTask(context, args[1] ?? "", args.slice(2).join(" "), change);
-    return { json: report, human: `Reopened ${report.task} in ${report.change}.` };
-  }
-  throw new UsageError(`cruze task takes done, deviation or reopen, not "${args[0]}"`);
-}
-
-export async function runFeatures(context            , args          , options         )                         {
-  requireArgs(args, ["add|update|drop", "slug"]);
-  if (args[0] === "add") {
-    const goals = (options.goals ?? "").split(",").map((g) => g.trim()).filter((g) => g !== "");
-    const report = await addFutureFeature(context, args[1] ?? "", requireOption(options.summary, "--summary"), goals);
-    return { json: report, human: `Added ${report.feature} to the future list.` };
-  }
-  if (args[0] === "update") {
-    const report = await updateFeatureSummary(context, args[1] ?? "", requireOption(options.summary, "--summary"));
-    return { json: report, human: `Updated the summary of ${report.feature} on the ${report.list === "Future" ? "future" : "implemented"} list.` };
-  }
-  if (args[0] === "drop") {
-    const report = await dropFutureFeature(context, args[1] ?? "", requireOption(options.reason, "--reason"));
-    return { json: report, human: `Dropped ${report.feature} from the future list.` };
-  }
-  throw new UsageError(`cruze features takes add, update or drop, not "${args[0]}"`);
-}
-
-export async function runRoadmap(context            , args          )                         {
-  requireArgs(args, ["prune"]);
-  if (args[0] !== "prune") throw new UsageError(`cruze roadmap takes prune, not "${args[0]}"`);
-  const report = await pruneRoadmap(context);
-  return { json: report, human: report.removed.length === 0 ? "No landed items to clear." : `Cleared ${report.removed.join(", ")} from the roadmap status.` };
-}
-
-export async function runAbandon(context            , args          , options         )                         {
-  requireArgs(args, ["ref"]);
-  const report = await abandonWork(context, args[0] ?? "", requireOption(options.reason, "--reason"));
-  const back = report.futureList === undefined ? "" : ` ${report.futureList} is back on the future list.`;
-  return { json: report, human: `Abandoned ${report.ref}; archived to ${report.archivedTo}.${back}` };
-}

package/dist/adapters/inbound/cli/commands/realign.js

@@ -1,28 +0,0 @@
-import { realignDone } from "../../../../app/use_cases/realign_done.js";
-import { realignStatus } from "../../../../app/use_cases/realign_status.js";
-import { UsageError, requireArgs,                                                   } from "../cli_context.js";
-
-export async function runRealign(context            , args          , options         )                         {
-  requireArgs(args, ["status|done"]);
-  if (args[0] === "status") {
-    const report = await realignStatus(context, { full: options.full });
-    const lines = [`Code meets Cruze ${report.standards}; the installed skills are ${report.target}${report.full ? " (full audit)" : ""}.`];
-    for (const note of report.notes) {
-      const open = note.findings.filter((f) => !f.waived);
-      const how = note.detect !== undefined ? `${open.length} open finding(s) from ${note.detect}` : `for the auditor: ${note.ask ?? ""}`;
-      lines.push(`${note.version} ${note.id}: ${note.title} (${how})`);
-      for (const f of open) lines.push(`  ${f.path}${f.line === undefined ? "" : `:${f.line}`} ${f.message}`);
-    }
-    if (report.newWorkOnly.length > 0) lines.push(`New work only, nothing to move: ${report.newWorkOnly.join(", ")}`);
-    if (report.notes.length === 0) lines.push("Nothing to realign.");
-    return { json: report, human: lines.join("\n") };
-  }
-  if (args[0] === "done") {
-    const report = await realignDone(context, options.change === undefined ? {} : { change: options.change });
-    const lines = [report.from === report.to ? `The code already meets Cruze ${report.to}.` : `The code now meets Cruze ${report.to}, up from ${report.from}.`];
-    if (report.scheduled !== undefined) lines.push(`${report.scheduled} fixes the rest.`);
-    if (report.excepted.length > 0) lines.push(`Listed under check.exceptions until it lands: ${report.excepted.join(", ")}`);
-    return { json: report, human: lines.join("\n") };
-  }
-  throw new UsageError(`cruze realign takes status or done, not "${args[0]}"`);
-}

package/dist/adapters/inbound/cli/commands/show.js

@@ -1,96 +0,0 @@
-import { showElements, showIndex } from "../../../../app/use_cases/show_elements.js";
-import { showNotes } from "../../../../app/use_cases/show_notes.js";
-                                                                          
-import { showScope,                  } from "../../../../app/use_cases/show_scope.js";
-import { isId } from "../../../../domain/ids.js";
-                                                                                 
-                                                                             
-import { UsageError, requireArgs,                                                   } from "../cli_context.js";
-
-export async function runShow(context            , args          , options         )                         {
-  if (options.notes) {
-    if (args.length > 1 || options.index) throw new UsageError("--notes takes at most one target: project, a step, a feature slug or a context");
-    const report = await showNotes(context, args[0]);
-    return { json: report, human: "target" in report ? renderNotesFor(report).join("\n").trimEnd() : renderNotes(report.notes) };
-  }
-  if (options.index) {
-    if (args.length > 1) throw new UsageError("--index takes at most one context or capability");
-    const index = await showIndex(context, args[0]);
-    return { json: index, human: renderIndex(index) };
-  }
-  requireArgs(args, ["ref"]);
-  if (args.every(isId)) {
-    const report = await showElements(context, args);
-    return { json: report, human: blocks(report.elements).join("\n").trimEnd() };
-  }
-  if (args.length > 1) throw new UsageError("show takes one feature or change, or one or more element IDs");
-  const report = await showScope(context, args[0] ?? "");
-  return { json: report, human: render(report) };
-}
-
-/** The index as a list an agent scans for what exists, before fetching bodies with `cruze show <ID>`. */
-function renderIndex(index              )         {
-  const { architecture, specs } = index.words;
-  const lines = [`# Elements`, "", `docs/architecture.md holds ${architecture} words, and docs/specs/ ${specs}. Read an element's body with \`cruze show <ID>\`.`];
-  let source = "";
-  for (const entry of [...index.entries].sort((a, b) => Number(a.addedBy !== undefined) - Number(b.addedBy !== undefined))) {
-    const heading = entry.addedBy === undefined ? entry.source : "In flight, not yet merged";
-    if (heading !== source) lines.push("", `## ${heading}`, "");
-    source = heading;
-    const facts = [
-      entry.status,
-      entry.place,
-      entry.scenarios === undefined ? undefined : `${entry.scenarios} scenarios`,
-      entry.addedBy === undefined ? undefined : `added by ${entry.addedBy}`,
-      entry.changedBy.length === 0 ? undefined : `changed by ${entry.changedBy.join(", ")}`,
-    ].filter((f) => f !== undefined);
-    lines.push(`- ${entry.id}: ${entry.title}${facts.length === 0 ? "" : ` (${facts.join("; ")})`}`);
-  }
-  return lines.join("\n");
-}
-
-/** The scope as a document an agent reads in place of the living docs. */
-function render(report             )         {
-  const lines = [`# ${report.ref}${report.feature === undefined ? "" : ` (feature ${report.feature})`}`, ""];
-  lines.push("## Elements", "", ...blocks(report.elements), "## Scenarios", "", ...blocks(report.scenarios));
-  lines.push("## Cited, not shown", "");
-  lines.push(...(report.cited.length === 0 ? ["None."] : report.cited.map((c) => `- ${c.id}: ${c.title} (${c.source})`)), "");
-  if (report.feature === undefined) lines.push("## Settled decisions", "", ...(report.decisions.length === 0 ? ["None."] : report.decisions), "");
-  else {
-    lines.push("## Settled decisions of the feature", "", ...(report.decisions.length === 0 ? ["None."] : report.decisions), "");
-    lines.push("## Settled decisions of the change", "", ...(report.changeDecisions.length === 0 ? ["None."] : report.changeDecisions), "");
-  }
-  lines.push("## Dispositions", "");
-  lines.push(...(report.dispositions.length === 0 ? ["None."] : report.dispositions.map((d) => `- [${d.disposition}, ${d.review}] ${d.finding}: ${d.reason}`)), "");
-  if (report.references.length > 0) lines.push("## References", "", ...report.references.map((r) => `- \`${r.path}\`: ${r.use}`), "");
-  lines.push(...renderNotesFor(report.notes));
-  if (report.missing.length > 0) lines.push("## Missing", "", ...report.missing.map((id) => `- ${id} is defined nowhere`), "");
-  return lines.join("\n").trimEnd();
-}
-
-function blocks(elements                )           {
-  if (elements.length === 0) return ["None.", ""];
-  return elements.flatMap((element) => [`<!-- ${element.source} -->`, ...element.body.join("\n").trimEnd().split("\n"), ""]);
-}
-
-/** The notes about a piece of work and the parts of the user's input handed to it; nothing when there are none. */
-function renderNotesFor(found          )           {
-  if (found.notes.length === 0 && found.handoffs.length === 0) return [];
-  return [
-    "## Notes",
-    "",
-    ...found.notes.map((n) => `- \`${n.path}\`: ${n.title}${n.kind === undefined ? "" : ` (${n.kind})`}`),
-    ...found.handoffs.map((h) => `- ${h.part}, from ${h.source} (${h.status}, handed off in \`${h.note}\`)`),
-    "",
-  ];
-}
-
-function renderNotes(notes        )         {
-  if (notes.length === 0) return "No notes.";
-  return notes
-    .flatMap((n) => [
-      `- \`${n.path}\`: ${n.title} (${n.kind ?? "no kind"}; about ${n.about.length === 0 ? "nothing named" : n.about.join(", ")})`,
-      ...n.handoff.map((h) => `  - ${h.part} goes to ${h.goesTo} (${h.status})`),
-    ])
-    .join("\n");
-}

package/dist/app/use_cases/abandon_work.js

@@ -1,42 +0,0 @@
-import { CruzeError } from "../../domain/cruze_error.js";
-import { readRows, upsertRow } from "../../domain/edits/managed_tables.js";
-import { resolveArtifact } from "../../domain/project/artifact_ref.js";
-import { PATHS } from "../../domain/project/layout.js";
-import { appendJournal, loadView,                  } from "../project_context.js";
-
-                                
-              
-                     
-                                                                             
-                      
- 
-
-/**
- * Stops a feature or standalone change for good: archives its folder with the reason, marks it
- * abandoned on the roadmap, and puts a feature back on the future list. Changes that already
- * landed stay in the living docs.
- */
-export async function abandonWork(deps             , ref        , reason        )                         {
-  if (reason.trim() === "") throw new CruzeError("missing-reason", "abandoning work needs a reason");
-  const view = await loadView(deps.files);
-  const { item } = resolveArtifact(view, ref);
-  if (item === undefined || item.archived) throw new CruzeError("not-found", `"${ref}" is not an active feature or standalone change`);
-  if (item.kind === "change") throw new CruzeError("not-abandonable", `${item.ref} belongs to a feature; remove it from the feature's Changes table through rethink instead`);
-
-  const slug = typeof item.doc.frontmatter?.["roadmap"] === "string" ? item.doc.frontmatter["roadmap"] : undefined;
-  const roadmap = view.snapshot.get(PATHS.roadmap);
-  if (slug !== undefined && roadmap !== undefined && roadmap.includes("## Status")) {
-    await deps.files.writeText(PATHS.roadmap, upsertRow(roadmap, "Status", [slug, item.folderName, "abandoned"]));
-  }
-  const report                = { ref: item.ref, archivedTo: `${PATHS.archiveDir}/${item.folderName}` };
-  const vision = view.snapshot.get(PATHS.vision);
-  if (item.kind === "feature" && slug !== undefined && vision !== undefined && vision.includes("### Future")) {
-    if (!readRows(vision, "Future").some((row) => row[0] === slug)) {
-      await deps.files.writeText(PATHS.vision, upsertRow(vision, "Future", [slug, String(item.doc.frontmatter?.["title"] ?? slug), ""]));
-    }
-    report.futureList = slug;
-  }
-  await appendJournal(deps, item.folder, "abandon", { item: item.ref, reason: reason.trim() });
-  await deps.files.move(item.folder, report.archivedTo);
-  return report;
-}