@printpractical/cruze 0.0.13 → 0.0.15

package/dist/app/use_cases/approve_artifact.js

@@ -1,197 +0,0 @@
-import { requirePlanReviewClosed, requireUnchangedSinceApproval,                 } from "../../domain/approvals/agent_approval.js";
-import { evaluateApproval } from "../../domain/approvals/evaluate.js";
-import { fingerprint, isApprovable } from "../../domain/approvals/fingerprint.js";
-import { rebaseNeeded } from "../../domain/approvals/rebase.js";
-import { serializeApprovals, withApproval } from "../../domain/approvals/records.js";
-import { CruzeError } from "../../domain/cruze_error.js";
-import { updateProgress } from "../../domain/edits/progress_block.js";
-import { setStatus, stampMissingStatuses } from "../../domain/edits/status_lines.js";
-import { statusOf } from "../../domain/elements.js";
-import { elementHash } from "../../domain/hashing.js";
-import { parseMarkdown } from "../../domain/markdown.js";
-import { resolveArtifact } from "../../domain/project/artifact_ref.js";
-import { readDelta } from "../../domain/project/deltas.js";
-import { PATHS } from "../../domain/project/layout.js";
-import { isPlanned, readChangesTable } from "../../domain/project/plan_parts.js";
-import { readProgress } from "../../domain/project/progress.js";
-import { approvalFolder, approvalsPath,                  } from "../../domain/project/project_view.js";
-import { featureOf,               } from "../../domain/project/work_items.js";
-                                                                  
-import { SIZE_RULES } from "../../domain/validation/size_rules.js";
-import { validateProject } from "../../domain/validation/validate_project.js";
-import { appendJournal, loadView, withFiles,                  } from "../project_context.js";
-
-                                
-                   
-               
-                     
-                                                   
-                    
-                                                                       
-                 
-                                                                                          
-                      
-                                                                                        
-                    
-                                                                    
-                     
-                                                                        
-                       
- 
-
-                                 
-                                                                                                         
-                    
-                                                                                                                                     
-                    
-                                                                                                   
-                     
- 
-
-/**
- * Records a person's approval of a document: its design hash and the hashes of everything
- * upstream it relies on. Refuses invalid documents and documents whose upstream isn't approved.
- */
-export async function approveArtifact(deps             , ref        , options                 = {})                         {
-  let view = await loadView(deps.files);
-  const { path, item } = resolveArtifact(view, ref);
-  if (!isApprovable(view, path)) throw new CruzeError("not-approvable", `${path} is not something you approve; it changes through approved work`);
-  requireUpstreamApproved(view, path);
-  if (item?.kind === "feature" && readChangesTable(item.doc).length === 0) {
-    throw new CruzeError("not-designed", `${path} has no changes yet; architect designs and splits it before approval`);
-  }
-  if (item !== undefined && item.kind !== "feature" && !isPlanned(item.doc)) {
-    throw new CruzeError("not-planned", `${path} has no test plan or tasks yet; plan it before approving`);
-  }
-  const before = evaluateApproval(view, path);
-  if (options.agent === "plan-review") requirePlanReviewClosed(view.journal, item ?? notWork(path));
-  if (options.agent === "rethink") requireUnchangedSinceApproval(view.journal, item, path, before);
-
-  const edits = new Map                ();
-  let text = view.snapshot.get(path) ?? "";
-  let stamped           = [];
-  if (path === PATHS.architecture) ({ text, stamped } = stampMissingStatuses(text));
-  const replanned = options.replan ?? [];
-  if (replanned.length > 0 && path !== PATHS.architecture) throw new CruzeError("replan-architecture-only", "--replan applies to the architecture");
-  for (const id of replanned) {
-    const element = view.living.elements.get(id);
-    if (element?.path !== PATHS.architecture || statusOf(element.doc, element.element) !== "built") {
-      throw new CruzeError("not-built", `${id} is not a built element of ${PATHS.architecture}`);
-    }
-    text = setStatus(text, id, "planned");
-  }
-  let bound                    ;
-  if (item !== undefined && item.kind !== "feature" && readProgress(parseMarkdown(text)).branch === undefined) {
-    bound = (await deps.repository.currentBranch()) ?? undefined;
-    text = updateProgress(text, (progress) => {
-      if (bound !== undefined) progress.branch = bound;
-    });
-  }
-  if (text !== view.snapshot.get(path)) edits.set(path, text);
-  view = withFiles(view, edits);
-
-  const problems = validateProject(view).filter((p) => p.path === path);
-  const errors = problems.filter((p) => p.severity === "error");
-  if (errors.length > 0) {
-    const listing = errors.map((p) => `  ${p.path}:${p.line ?? ""} ${p.message}`).join("\n");
-    throw new CruzeError("invalid", `${path} has ${errors.length} problem(s) to fix before approval:\n${listing}`);
-  }
-  requireSizesAccepted(problems, path);
-  if (item !== undefined) requireNoDecisionCitations(problems, path);
-
-  const { hash, upstream } = fingerprint(view, path, parseMarkdown(text));
-  const folder = approvalFolder(view, path);
-  const current = view.approvals.get(folder) ?? { version: 1, approvals: [], merged: {} };
-  const rebased = options.rebase ?? [];
-  const deltaIds = item === undefined || item.kind === "change" ? new Set        () : readDelta(item.doc).ids;
-  if (item !== undefined) requireRebased(view, item, rebased);
-  const merged = { ...current.merged };
-  for (const id of rebased) {
-    const living = view.living.elements.get(id);
-    if (living === undefined || (merged[id] === undefined && !deltaIds.has(id))) {
-      throw new CruzeError("not-in-delta", `${id} is not a living element that ${item?.ref ?? path} changes or merged`);
-    }
-    if (merged[id] !== undefined) merged[id] = elementHash(living.doc, living.element);
-  }
-  const approvals = withApproval({ ...current, merged }, {
-    artifact: path,
-    hash,
-    upstream,
-    approvedAt: deps.clock.now().toISOString(),
-    by: (await deps.repository.userName()) ?? "unknown",
-    ...(options.agent === undefined ? {} : { basis: options.agent }),
-  });
-  for (const [changed, content] of edits) await deps.files.writeText(changed, content);
-  await deps.files.writeText(approvalsPath(folder), serializeApprovals(approvals));
-  const restamped = options.agent === "rethink" ? before.changed : undefined;
-  await appendJournal(deps, folder, "approve", {
-    artifact: path,
-    hash,
-    ...(replanned.length > 0 ? { replanned } : {}),
-    ...(rebased.length > 0 ? { rebased } : {}),
-    ...(options.agent === undefined ? {} : { basis: options.agent }),
-    ...(restamped === undefined ? {} : { restamped }),
-  });
-  const report                = { artifact: path, hash, upstream: Object.keys(upstream), stamped, replanned, rebased };
-  if (bound !== undefined) report.bound = bound;
-  if (options.agent !== undefined) report.basis = options.agent;
-  if (restamped !== undefined) report.restamped = restamped;
-  return report;
-}
-
-/**
- * A feature or standalone change whose delta changes an element must have been written against
- * that element's current text. When the living element changed since the last approval, through
- * a rethink or another land, the delta would overwrite that edit, so approval waits until the
- * delta is reconciled and the element is named with --rebase.
- */
-function requireRebased(view             , item          , rebased          )       {
-  const moved = rebaseNeeded(view, item).filter((id) => !rebased.includes(id));
-  if (moved.length > 0) {
-    throw new CruzeError(
-      "rebase-required",
-      `the living text of ${moved.join(", ")} changed since the last approval, and this work's delta changes ${moved.length === 1 ? "it" : "them"}. Rewrite the delta to keep that change, then approve with ${moved.map((id) => `--rebase ${id}`).join(" ")}`,
-    );
-  }
-}
-
-/**
- * A size warning stands until the work is split or the user accepts it under `changes.exceptions`.
- * A 28-task change approved over its warning went on to 26 deviations, so approval waits for one or the other.
- */
-function requireSizesAccepted(problems           , path        )       {
-  const standing = problems.filter((p) => SIZE_RULES.includes(p.rule));
-  if (standing.length === 0) return;
-  const listing = standing.map((p) => `  ${p.message} [${p.rule}]`).join("\n");
-  throw new CruzeError(
-    "size-unaccepted",
-    `${path} has ${standing.length} size warning(s). Split the work through rethink, or record the user's acceptance under changes.exceptions in .cruze/config.yaml, as the item's ref and their reason:\n${listing}`,
-  );
-}
-
-/**
- * A delta that cites decisions by number would merge them into the living docs, where they dangle once
- * the work is archived. Existing docs only warn, so approval of new or redesigned work is where it stops.
- */
-function requireNoDecisionCitations(problems           , path        )       {
-  const standing = problems.filter((p) => p.rule === "decision-citation");
-  if (standing.length === 0) return;
-  const listing = standing.map((p) => `  ${p.path}:${p.line ?? ""} ${p.message}`).join("\n");
-  throw new CruzeError("decision-cited", `${path} cites decisions by number in its delta, which merges into the living docs:\n${listing}`);
-}
-
-function notWork(path        )        {
-  throw new CruzeError("needs-user", `${path} is a project document, so the user approves it`);
-}
-
-/** A change needs its feature approved; a feature or standalone change needs the architecture approved. */
-function requireUpstreamApproved(view             , path        )       {
-  const item = view.items.find((i) => i.path === path);
-  if (item === undefined) return;
-  const upstream = item.kind === "change" ? featureOf(view.items, item)?.path : view.snapshot.has(PATHS.architecture) ? PATHS.architecture : undefined;
-  if (upstream === undefined) return;
-  const status = evaluateApproval(view, upstream);
-  if (status.state !== "approved") {
-    throw new CruzeError("upstream-not-approved", `approve ${upstream} first; it is ${status.state}${status.changed.length > 0 ? ` (${status.changed.join(", ")})` : ""}`);
-  }
-}

package/dist/app/use_cases/journal_events.js

@@ -1,64 +0,0 @@
-import { CruzeError } from "../../domain/cruze_error.js";
-import { knownPitfalls } from "../../domain/edits/agents_file.js";
-import { journalPath, parseJournal, recordedEventProblems, recordedFields,                   } from "../../domain/journal.js";
-import { resolveArtifact } from "../../domain/project/artifact_ref.js";
-import { appendJournal, loadView,                  } from "../project_context.js";
-
-/** Records an event a skill observed: a rethink, a review round, a disposition, an override or a bug. */
-export async function recordEvent(deps             , event        , fields                        , item         )                        {
-  const problems = recordedEventProblems(event, fields);
-  if (problems.length > 0) throw new CruzeError("invalid-event", problems.join("; "));
-  let folder = ".cruze";
-  let recorded = recordedFields(fields);
-  if (item !== undefined) {
-    const resolved = resolveArtifact(await loadView(deps.files), item).item;
-    if (resolved === undefined) throw new CruzeError("not-found", `"${item}" is not a feature or change`);
-    folder = resolved.folder;
-    recorded = { ...recorded, item: resolved.ref };
-  }
-  return appendJournal(deps, folder, event, { ...recorded, cruze: deps.bundle.version });
-}
-
-/**
- * The journal of the work in flight and the project, or of one feature or change (a feature's changes' too).
- * Landed work's entries are history, listed only with `all`, since every entry ever recorded is too much to read.
- */
-export async function listEvents(deps             , event         , item         , all = false)                          {
-  const view = await loadView(deps.files);
-  let folders = [".cruze", ...view.items.filter((i) => all || !i.archived).map((i) => i.folder)];
-  if (item !== undefined) {
-    const resolved = resolveArtifact(view, item).item;
-    if (resolved === undefined) throw new CruzeError("not-found", `"${item}" is not a feature or change`);
-    folders = [resolved, ...view.items.filter((i) => resolved.kind === "feature" && i.featureRef === resolved.ref)].map((part) => part.folder);
-  }
-  const entries = folders.flatMap((folder) => parseJournal(view.snapshot.get(journalPath(folder))).entries).sort((a, b) => a.at.localeCompare(b.at));
-  return event === undefined ? entries : entries.filter((entry) => entry.event === event);
-}
-
-                                 
-                             
-                
-                      
-                    
-                          
-                                                                                                                      
-                     
- 
-
-/**
- * Bundles the journal, and the project's known pitfalls, for the framework feedback loop. By default the project name and
- * the approver's identity are redacted, since the bundle may leave the project.
- */
-export async function exportFeedback(deps             , redact         )                          {
-  const view = await loadView(deps.files);
-  const project = view.config?.config?.project ?? "";
-  const scrub = (value         )          => {
-    if (typeof value === "string") return project === "" ? value : value.split(project).join("<project>");
-    if (Array.isArray(value)) return value.map(scrub);
-    if (value !== null && typeof value === "object") return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, scrub(v)]));
-    return value;
-  };
-  const entries = redact ? view.journal.map((entry) => ({ ...(scrub(entry)                ), by: "<redacted>" })) : view.journal;
-  const pitfalls = knownPitfalls((await deps.files.readText("AGENTS.md")) ?? "").map((line) => (redact ? (scrub(line)          ) : line));
-  return { format: "cruze-feedback/1", cruze: deps.bundle.version, exported_at: deps.clock.now().toISOString(), redacted: redact, entries, pitfalls };
-}

package/dist/app/use_cases/land_change.js

@@ -1,134 +0,0 @@
-import { evaluateApproval } from "../../domain/approvals/evaluate.js";
-import { fingerprint } from "../../domain/approvals/fingerprint.js";
-import { serializeApprovals, withApproval,                    } from "../../domain/approvals/records.js";
-import { CruzeError } from "../../domain/cruze_error.js";
-import { renderAgentsFile } from "../../domain/edits/agents_file.js";
-import { applyBookkeeping } from "../../domain/land/bookkeeping.js";
-import { planMerge } from "../../domain/land/merge_plan.js";
-import { parseMarkdown } from "../../domain/markdown.js";
-import { resolveChange } from "../../domain/project/artifact_ref.js";
-import { PATHS } from "../../domain/project/layout.js";
-import { readTasks } from "../../domain/project/plan_parts.js";
-import { readProgress } from "../../domain/project/progress.js";
-import { approvalFolder, approvalsPath,                  } from "../../domain/project/project_view.js";
-import { changesOf, featureOf,               } from "../../domain/project/work_items.js";
-import { isVerified } from "../../domain/status/verification.js";
-import { activeChange } from "../../domain/status/work_status.js";
-import { validateProject } from "../../domain/validation/validate_project.js";
-import { withoutScheduledExceptions } from "../../domain/versions/scheduled_exceptions.js";
-import { appendJournal, loadView, withFiles,                  } from "../project_context.js";
-
-const AGENTS_FILE = "AGENTS.md";
-
-                             
-                 
-                   
-                  
-                    
-                      
-                    
-                                                                                                            
-                       
-                      
- 
-
-/**
- * Lands a finished change: merges its work into the living docs, re-stamps the approvals the
- * merge would otherwise make stale, records the land, and archives the work once it is finished.
- * Nothing is written unless the merged docs still validate.
- */
-export async function landChange(deps             , ref         , options                        = {})                      {
-  const view = await loadView(deps.files);
-  const change = ref !== undefined ? resolveChange(view, ref) : activeChange(view, await deps.repository.currentBranch());
-  if (change === undefined) throw new CruzeError("no-active-change", "no change is bound to this branch; name one to land");
-  const source = change.kind === "change" ? featureOf(view.items, change) : change;
-  if (source === undefined) throw new CruzeError("orphan-change", `${change.ref} has no feature.md`);
-  requireReady(view, change, source);
-  const verified = isVerified(view.journal, change);
-  if (!verified && (options.override ?? "").trim() === "") {
-    throw new CruzeError("not-verified", `${change.ref} has no accepted verification; run verify, or land with --override <reason>`);
-  }
-
-  const restamp = [PATHS.architecture, source.path, ...(source === change ? [] : changesOf(view.items, source).map((c) => c.path))]
-    .filter((path, i, all) => all.indexOf(path) === i && view.snapshot.has(path) && evaluateApproval(view, path).state === "approved");
-
-  const plan = planMerge(view, change, source);
-  const commit = await deps.repository.headCommit();
-  const landed = `${deps.clock.today()}${commit === null ? "" : ` (${commit})`}`;
-  const books = applyBookkeeping(view, change, source, landed, plan.files);
-  const merged = withFiles(view, plan.files);
-  const recorded = { ...(merged.approvals.get(source.folder) ?? { version: 1, approvals: [], merged: {} }), merged: plan.merged };
-  const checked = withFiles(merged, new Map([[approvalsPath(source.folder), serializeApprovals(recorded)]]));
-  requireStillValid(view, checked, [source.path, ...changesOf(view.items, source).map((c) => c.path)]);
-
-  const approvals = new Map                       ();
-  const by = (await deps.repository.userName()) ?? "unknown";
-  for (const path of restamp) {
-    const folder = approvalFolder(merged, path);
-    const { hash, upstream } = fingerprint(merged, path, parseMarkdown(merged.snapshot.get(path) ?? ""));
-    const file = approvals.get(folder) ?? merged.approvals.get(folder) ?? { version: 1, approvals: [], merged: {} };
-    approvals.set(folder, withApproval(file, { artifact: path, hash, upstream, approvedAt: deps.clock.now().toISOString(), by, basis: `land ${change.ref}` }));
-  }
-  const sourceApprovals = approvals.get(source.folder) ?? merged.approvals.get(source.folder) ?? { version: 1, approvals: [], merged: {} };
-  approvals.set(source.folder, { ...sourceApprovals, merged: plan.merged });
-
-  for (const [path, text] of plan.files) await deps.files.writeText(path, text);
-  for (const [folder, file] of approvals) await deps.files.writeText(approvalsPath(folder), serializeApprovals(file));
-  for (const path of restamp) {
-    const record = approvals.get(approvalFolder(merged, path))?.approvals.find((r) => r.artifact === path);
-    await appendJournal(deps, approvalFolder(merged, path), "approve", { artifact: path, hash: record?.hash, basis: `land ${change.ref}` });
-  }
-  if (!verified) await appendJournal(deps, source.folder, "override", { gate: "land", reason: options.override, item: change.ref });
-  await appendJournal(deps, source.folder, "land", { change: change.ref, merged: plan.mergedIds, built: plan.built, removed: plan.removed, release: books.release, commit });
-  if (books.archive !== undefined) await deps.files.move(books.archive.from, books.archive.to);
-  const agents = await deps.files.readText(AGENTS_FILE);
-  if (agents !== undefined) {
-    const rendered = renderAgentsFile(agents, merged);
-    if (rendered !== agents) await deps.files.writeText(AGENTS_FILE, rendered);
-  }
-  const unexcepted = await clearScheduledExceptions(deps, [change.ref, source.ref]);
-
-  const report             = { change: change.ref, merged: plan.mergedIds, built: plan.built, removed: plan.removed, restamped: restamp, finished: books.finished, unexcepted };
-  if (books.archive !== undefined) report.archivedTo = books.archive.to;
-  return report;
-}
-
-/** The change, its feature and the architecture are approved and current, valid, and every task is done. */
-function requireReady(view             , change          , source          )       {
-  const reasons           = [];
-  for (const path of [change.path, source.path, PATHS.architecture].filter((p, i, all) => all.indexOf(p) === i && view.snapshot.has(p))) {
-    const status = evaluateApproval(view, path);
-    if (status.state !== "approved") reasons.push(`${path} is ${status.state}${status.changed.length > 0 ? ` (${status.changed.join(", ")})` : ""}`);
-  }
-  const errors = validateProject(view).filter((p) => p.severity === "error" && (p.path === change.path || p.path === source.path));
-  reasons.push(...errors.map((p) => `${p.path}:${p.line ?? ""} ${p.message}`));
-  const progress = readProgress(change.doc);
-  const open = readTasks(change.doc).tasks.filter((task) => (progress.tasks.get(task.number) ?? null) === null).map((task) => task.number);
-  if (open.length > 0) reasons.push(`tasks not done: ${open.join(", ")}`);
-  if (reasons.length > 0) throw new CruzeError("not-ready", `${change.ref} cannot land yet:\n  ${reasons.join("\n  ")}`);
-}
-
-/** The merge may not introduce errors into the living docs, or into the work it lands, such as a citation of an ID it removes. */
-function requireStillValid(before             , after             , work          )       {
-  const key = (p                                   )         => `${p.path}|${p.message}`;
-  const existing = new Set(validateProject(before).map(key));
-  const watched = (path        )          => path.startsWith("docs/") || work.includes(path);
-  const introduced = validateProject(after).filter((p) => p.severity === "error" && watched(p.path) && !existing.has(key(p)));
-  if (introduced.length > 0) {
-    throw new CruzeError("merge-invalid", `landing would leave errors behind; nothing was written:\n  ${introduced.map((p) => `${p.path}:${p.line ?? ""} ${p.message}`).join("\n  ")}`);
-  }
-}
-
-/** Removes the exceptions `realign` scheduled in the landed work, so CI checks those files again. */
-async function clearScheduledExceptions(deps             , refs          )                    {
-  let text = await deps.files.readText(PATHS.config);
-  if (text === undefined) return [];
-  const removed           = [];
-  for (const ref of [...new Set(refs)]) {
-    const result = withoutScheduledExceptions(text, ref);
-    text = result.text;
-    removed.push(...result.removed);
-  }
-  if (removed.length > 0) await deps.files.writeText(PATHS.config, text);
-  return removed;
-}

package/dist/app/use_cases/new_project_doc.js

@@ -1,48 +0,0 @@
-import { CruzeError } from "../../domain/cruze_error.js";
-import { PATHS } from "../../domain/project/layout.js";
-import { NOTE_KINDS } from "../../domain/project/notes.js";
-import { requireSlug } from "../../domain/project/new_items.js";
-import { renderTemplate } from "../../domain/scaffold.js";
-import { appendJournal, loadView,                  } from "../project_context.js";
-
-                                                                                
-
-export const PROJECT_DOC_KINDS                            = ["vision", "glossary", "architecture", "roadmap"];
-
-                               
-                                
-               
- 
-
-/** Creates one of the project's living documents from its template, named for the project. */
-export async function createProjectDoc(deps             , kind                )                        {
-  const view = await loadView(deps.files);
-  const path = PATHS[kind];
-  if (view.snapshot.has(path)) throw new CruzeError("exists", `${path} already exists`);
-  const project = view.config?.config?.project ?? "";
-  if (project === "") throw new CruzeError("no-config", `${PATHS.config} is missing or has no project name; run cruze init first`);
-  const values = { project_name: project, id: "", title: "", date: deps.clock.today() };
-  await deps.files.writeText(path, renderTemplate(await deps.bundle.formatTemplate(`${kind}.md`), values));
-  await appendJournal(deps, ".cruze", "new", { kind, ref: path });
-  return { kind, path };
-}
-
-/** Creates a dated note in `.cruze/notes/`, such as a captured explore session or research evidence. */
-/**
- * A dated note, saying what kind it is and what it is about, so `cruze show` finds it for the work it
- * informs: `project`, feature slugs, or context and capability names.
- */
-export async function createNote(deps             , slug        , title        , kind        , about        )                        {
-  requireSlug(slug);
-  if (title.trim() === "") throw new CruzeError("missing-title", "a title is required");
-  if (!(NOTE_KINDS                     ).includes(kind)) throw new CruzeError("note-kind", `a note's kind is one of ${NOTE_KINDS.join(", ")}`);
-  const subjects = about.split(",").map((a) => a.trim()).filter((a) => a !== "");
-  if (subjects.length === 0) throw new CruzeError("note-about", "name what the note is about: project, feature slugs, or contexts, comma-separated");
-  const view = await loadView(deps.files);
-  const date = deps.clock.today();
-  const base = `${PATHS.notesDir}/${date}-${slug}`;
-  let path = `${base}.md`;
-  for (let n = 2; view.snapshot.has(path); n++) path = `${base}-${n}.md`;
-  await deps.files.writeText(path, `# ${title}\n\n- Date: ${date}\n- Kind: ${kind}\n- About: ${subjects.join(", ")}\n\n`);
-  return { kind: "note", path };
-}

package/dist/app/use_cases/new_work_item.js

@@ -1,75 +0,0 @@
-import { CruzeError } from "../../domain/cruze_error.js";
-import { upsertRow } from "../../domain/edits/managed_tables.js";
-import { resolveArtifact } from "../../domain/project/artifact_ref.js";
-import { PATHS } from "../../domain/project/layout.js";
-import { allocateId, changeRow, fillTemplate, requireSlug } from "../../domain/project/new_items.js";
-import { renderTemplate } from "../../domain/scaffold.js";
-import { appendJournal, loadView,                  } from "../project_context.js";
-
-                                                   
-
-                             
-                
-               
-                
-                                                                                        
-                   
-                                                                                           
-                   
- 
-
-                            
-                                                    
-              
-               
- 
-
-/** Creates a feature, change or ADR from its template, with a fresh ID. */
-export async function createWorkItem(deps             , request            )                     {
-  const view = await loadView(deps.files);
-  const date = deps.clock.today();
-  const values = { id: "", title: request.title, title_quoted: JSON.stringify(request.title), date, project_name: "" };
-  if (request.title.trim() === "") throw new CruzeError("missing-title", "a title is required");
-
-  if (request.kind === "adr") {
-    requireSlug(request.slug);
-    const path = `${PATHS.adrDir}/${date}-${request.slug}.md`;
-    if (view.snapshot.has(path)) throw new CruzeError("exists", `${path} already exists`);
-    const text = renderTemplate(await deps.bundle.formatTemplate("adr.md"), values).replace(/^# .*$/m, `# ${request.title}`);
-    await deps.files.writeText(path, text);
-    await appendJournal(deps, ".cruze", "new", { kind: "adr", ref: path });
-    return { kind: "adr", ref: `ADR-${date}-${request.slug}`, path };
-  }
-
-  if (request.kind === "change" && request.feature !== undefined) {
-    const { item: feature } = resolveArtifact(view, request.feature);
-    if (feature === undefined || feature.kind !== "feature" || feature.archived) throw new CruzeError("not-a-feature", `"${request.feature}" is not an active feature`);
-    const row = changeRow(view, feature, request.slug);
-    const folder = `${feature.folder}/changes/${row.change}`;
-    const template = renderTemplate(await deps.bundle.formatTemplate("change.md"), { ...values, id: row.change });
-    await deps.files.writeText(`${folder}/change.md`, fillTemplate(template, { delivers: row.delivers, builds: [...row.builds, ...row.removes] }));
-    await appendJournal(deps, feature.folder, "new", { kind: "change", ref: `${feature.ref}/${row.change}` });
-    return { kind: "change", ref: `${feature.ref}/${row.change}`, path: `${folder}/change.md` };
-  }
-
-  const kind = request.kind === "feature" ? "feature" : "standalone";
-  const id = allocateId(view, date, request.slug);
-  const folder = `${kind === "feature" ? PATHS.featuresDir : PATHS.changesDir}/${id}`;
-  const roadmap = request.roadmap ?? (roadmapHasItem(view.snapshot.get(PATHS.roadmap), request.slug) ? request.slug : undefined);
-  const template = renderTemplate(await deps.bundle.formatTemplate(kind === "feature" ? "feature.md" : "standalone-change.md"), { ...values, id });
-  const path = `${folder}/${kind === "feature" ? "feature.md" : "change.md"}`;
-  await deps.files.writeText(path, fillTemplate(template, roadmap === undefined ? {} : { roadmap }));
-  const roadmapText = view.snapshot.get(PATHS.roadmap);
-  if (roadmap !== undefined && roadmapText !== undefined) {
-    await deps.files.writeText(PATHS.roadmap, upsertRow(roadmapText, "Status", [roadmap, id, "designing"]));
-  }
-  await appendJournal(deps, folder, "new", { kind, ref: id });
-  return { kind, ref: id, path };
-}
-
-/** Whether a roadmap phase lists this slug as an item. */
-function roadmapHasItem(roadmap                    , slug        )          {
-  if (roadmap === undefined) return false;
-  const phases = roadmap.split(/^## /m).find((section) => section.startsWith("Phases")) ?? "";
-  return phases.split("\n").some((line) => line.startsWith(`| ${slug} |`));
-}

package/dist/app/use_cases/realign_done.js

@@ -1,45 +0,0 @@
-import { CruzeError } from "../../domain/cruze_error.js";
-import { resolveArtifact } from "../../domain/project/artifact_ref.js";
-import { PATHS } from "../../domain/project/layout.js";
-import { withVersionLine } from "../../domain/versions/cruze_version.js";
-import { withScheduledExceptions } from "../../domain/versions/scheduled_exceptions.js";
-import { appendJournal, loadView,                  } from "../project_context.js";
-import { realignStatus } from "./realign_status.js";
-
-                              
-               
-             
-                                                                    
-                     
-                                                                       
-                     
- 
-
-/**
- * Moves `standards:` up to the installed Cruze once every mechanical finding is fixed, waived,
- * or scheduled in a change. A scheduled `check` finding becomes an exception naming that change,
- * so CI stays green until it lands, and landing it removes the exception.
- */
-export async function realignDone(deps             , options                     )                       {
-  const status = await realignStatus(deps, { full: false });
-  if (status.standards === status.target) return { from: status.standards, to: status.target, excepted: [] };
-  const open = status.notes.flatMap((note) => note.findings.filter((f) => !f.waived).map((f) => ({ note, finding: f })));
-  let scheduled                    ;
-  if (open.length > 0) {
-    if (options.change === undefined) {
-      const list = open.map(({ note, finding }) => `${note.id}: ${finding.path}${finding.line === undefined ? "" : `:${finding.line}`}`);
-      throw new CruzeError("realign-open", `fix, waive or schedule these first, then pass --change <ref> for the change that fixes the rest:\n  ${list.join("\n  ")}`);
-    }
-    const item = resolveArtifact(await loadView(deps.files), options.change).item;
-    if (item === undefined) throw new CruzeError("not-found", `"${options.change}" is not a feature or change; create the prefactor change first`);
-    scheduled = item.ref;
-  }
-
-  const excepted = open.filter(({ note }) => note.detect?.startsWith("check:") === true).map(({ note, finding }) => ({ path: finding.path, note: note.id }));
-  const config = (await deps.files.readText(PATHS.config)) ?? "";
-  const withExceptions = scheduled === undefined ? config : withScheduledExceptions(config, status.target, scheduled, excepted);
-  await deps.files.writeText(PATHS.config, withVersionLine(withExceptions, "standards", status.target));
-  const paths = [...new Set(excepted.map((e) => e.path))];
-  await appendJournal(deps, ".cruze", "realign", { from: status.standards, to: status.target, ...(scheduled === undefined ? {} : { scheduled }), excepted: paths });
-  return { from: status.standards, to: status.target, ...(scheduled === undefined ? {} : { scheduled }), excepted: paths };
-}