@maycombhq/atticus 2.0.0-beta.2 → 2.0.0-beta.22

package/dist/{chunk-2ANOROX3.js → chunk-BTGPE6CR.js}

@@ -7,11 +7,11 @@ import {
   buildStub,
   generate,
   parseSpec
-} from "./chunk-65NYPGRC.js";
+} from "./chunk-MUWDB4R4.js";
 import {
   loadPlanContext,
   parseStory
-} from "./chunk-CKSITVS4.js";
+} from "./chunk-R7NYHMUU.js";
 import {
   docOf,
   fingerprint,
@@ -20,20 +20,20 @@ import {
   roundsOf,
   sectionLines,
   writeFinding
-} from "./chunk-3HI6Z55Y.js";
+} from "./chunk-S4PMJU6H.js";
 import {
   changeFolder
-} from "./chunk-XY3P7JW7.js";
+} from "./chunk-IDKCWSM5.js";
 import {
   baseClonePath,
   changeWorktreesDir,
   readChangeRepos,
   worktreePath
-} from "./chunk-EFHQ3TWP.js";
+} from "./chunk-PKBHS4AA.js";
 import {
   buildContextPack,
   toRunSummary
-} from "./chunk-CNUKCS2T.js";
+} from "./chunk-P32RUW3B.js";
 import {
   AgentDefinition,
   ChecklistPack,
@@ -42,13 +42,15 @@ import {
   changeBranch,
   external_exports,
   normalizePath,
-  require_dist,
   taskBranch,
   toCanonicalYaml
-} from "./chunk-S2A7YC3Q.js";
+} from "./chunk-Q2TECDIT.js";
 import {
   writeFileAtomic
-} from "./chunk-D3PO4DOZ.js";
+} from "./chunk-TUULXQRW.js";
+import {
+  require_dist
+} from "./chunk-BQGDB6ZL.js";
 import {
   __toESM
 } from "./chunk-TV45EUGM.js";

package/dist/chunk-BTY3HZBO.js

@@ -0,0 +1,93 @@
+import { createRequire as __atticusCreateRequire } from "node:module";
+import { fileURLToPath as __atticusFileURLToPath } from "node:url";
+var require = __atticusCreateRequire(import.meta.url);
+var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
+var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
+import {
+  contractCheckOf
+} from "./chunk-T6DQR5TV.js";
+import "./chunk-SFUP7TTO.js";
+import "./chunk-7FTTA3HD.js";
+import "./chunk-ZQ3ON2VQ.js";
+import "./chunk-VOGCSYOI.js";
+import "./chunk-J2JAKCIW.js";
+import "./chunk-745DAZ4L.js";
+import "./chunk-CXJ6FUKN.js";
+import "./chunk-QKUJMING.js";
+import "./chunk-6ZGLAACW.js";
+import "./chunk-CQDGOPGH.js";
+import "./chunk-3NFFJL5D.js";
+import "./chunk-F3P7N7SF.js";
+import "./chunk-PKBHS4AA.js";
+import "./chunk-P32RUW3B.js";
+import "./chunk-QA4O2GGC.js";
+import "./chunk-Q2TECDIT.js";
+import "./chunk-TUULXQRW.js";
+import "./chunk-BQGDB6ZL.js";
+import "./chunk-TV45EUGM.js";
+
+// packages/cli/dist/contracts-commands.js
+var CONTRACTS_WORDS = {
+  head: (links, compared) => `${links} link${links === 1 ? "" : "s"} checked; ${compared} had a payload on both sides to compare.`,
+  counts: (m, u) => m === 0 && u === 0 ? "No mismatches." : `${m} mismatch${m === 1 ? "" : "es"}, ${u} unconfirmed (a mapping on the way isn't traced).`,
+  none: "No link has a payload on both sides yet: the field facts say what a call sends and an entry takes (atticus map <repo>), and a spec on file says what an API publishes (verify --write reads a repo's specs; atticus intake add takes a vendor's or a team's).",
+  unlinked: (n) => `${n} call${n === 1 ? " joins" : "s join"} nothing yet, so ${n === 1 ? "its" : "their"} payload isn't checked against the other side: answer their target questions or re-read them (atticus doctor --counts says why each is left).`,
+  mismatches: "Mismatches:",
+  unconfirmed: "Unconfirmed:",
+  link: (l) => `${l.call.repo} ${[l.method, l.path].filter(Boolean).join(" ")} \u2192 ${l.entry ? l.entry.repo : l.system}${l.through.length ? ` via ${l.through.join(", ")}` : ""}`,
+  item: (f) => `    ${f.kind}: ${f.message}`,
+  via: (via) => `      through ${via.join(", ")}`,
+  notes: "Left out:",
+  readOnly: "Nothing was written."
+};
+async function joinContracts(root, o, io) {
+  const { result, notes, newBySystem } = await contractCheckOf(root);
+  if (o.json) {
+    io.out(JSON.stringify({
+      ...result,
+      newBySystem: Object.fromEntries([...newBySystem].map(([k, v]) => [k, v.map((f) => f.id)])),
+      notes
+    }, null, 2));
+    return 0;
+  }
+  const W = CONTRACTS_WORDS;
+  if (!result.counts.compared)
+    io.out(W.none);
+  else {
+    io.out(W.head(result.counts.links, result.counts.compared));
+    io.out(W.counts(result.counts.mismatches, result.counts.unconfirmed));
+    for (const [title, status] of [
+      [W.mismatches, "mismatch"],
+      [W.unconfirmed, "unconfirmed"]
+    ]) {
+      const list = result.findings.filter((f) => f.status === status);
+      if (!list.length)
+        continue;
+      io.out(title);
+      for (const l of result.links) {
+        const mine = list.filter((f) => f.id.startsWith(`${l.key}#`));
+        if (!mine.length)
+          continue;
+        io.out(`  ${W.link(l)}`);
+        for (const f of mine) {
+          io.out(W.item(f));
+          if (f.via?.length)
+            io.out(W.via(f.via));
+        }
+      }
+    }
+  }
+  if (result.counts.unlinked)
+    io.out(W.unlinked(result.counts.unlinked));
+  if (notes.length) {
+    io.out(W.notes);
+    for (const n of notes)
+      io.out(`  ${n}`);
+  }
+  io.out(W.readOnly);
+  return 0;
+}
+export {
+  CONTRACTS_WORDS,
+  joinContracts
+};

package/dist/{chunk-DPZHZQKE.js → chunk-BXYMYEJ4.js}

@@ -3,10 +3,13 @@ import { fileURLToPath as __atticusFileURLToPath } from "node:url";
 var require = __atticusCreateRequire(import.meta.url);
 var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
 var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
+import {
+  nearRepos
+} from "./chunk-4U276ICE.js";
 import {
   gitUser,
   loadRepos
-} from "./chunk-EFHQ3TWP.js";
+} from "./chunk-PKBHS4AA.js";
 import {
   ManifestEditError,
   REPO_DESCRIPTION_MAX,
@@ -18,13 +21,16 @@ import {
   manifestFiles,
   parseFacts,
   setManifestDescription
-} from "./chunk-S2A7YC3Q.js";
-import "./chunk-D3PO4DOZ.js";
+} from "./chunk-Q2TECDIT.js";
+import {
+  FileChangedError
+} from "./chunk-TUULXQRW.js";
+import "./chunk-BQGDB6ZL.js";
 import "./chunk-TV45EUGM.js";
 
 // packages/cli/dist/repo-commands.js
 import { readFile, stat } from "node:fs/promises";
-import { basename, join, resolve } from "node:path";
+import { basename, dirname, join, resolve } from "node:path";
 import { createInterface } from "node:readline/promises";
 import { stdin, stdout } from "node:process";
 var askOnTerminal = async (prompt) => {
@@ -70,8 +76,8 @@ async function typeOf(url, description, frameworks = []) {
   if (!await stat(dir).then((s) => s.isDirectory(), () => false))
     return void 0;
   const [{ detectRepoType }, { fsRepo }] = await Promise.all([
-    import("./chunk-R77KLRB3.js"),
-    import("./chunk-HFQCFSJR.js")
+    import("./chunk-FFLNS6VP.js"),
+    import("./chunk-CX4RZ2KS.js")
   ]);
   const d = await detectRepoType(fsRepo(basename(dir), dir, "0".repeat(40)), {
     ...description ? { description } : {},
@@ -79,6 +85,22 @@ async function typeOf(url, description, frameworks = []) {
   });
   return d.type === "unknown" ? void 0 : { type: d.type, signals: d.signals, confidence: d.confidence };
 }
+async function cloneAt(url) {
+  if (/^[a-z][a-z0-9+.-]*:\/\//i.test(url) || /^[^/\\]+@/.test(url))
+    return void 0;
+  const dir = resolve(url);
+  if (!await stat(join(dir, ".git")).catch(() => void 0))
+    return void 0;
+  const { execFile } = await import("node:child_process");
+  const git = (...args) => new Promise((done) => execFile("git", args, { cwd: dir }, (e, out) => done(e ? "" : String(out).trim())));
+  const origin = await git("config", "--get", "remote.origin.url");
+  const branch = await git("rev-parse", "--abbrev-ref", "HEAD");
+  return {
+    dir,
+    ...origin ? { origin } : {},
+    ...branch && branch !== "HEAD" ? { branch } : {}
+  };
+}
 async function whoFor(root, d) {
   if (d.by)
     return d.by;
@@ -93,6 +115,7 @@ async function repoAdd(root, url, o, io, deps = {}) {
     io.err('Usage: atticus repo add <clone URL or path> [--id id] [--type repo type] [--owner team] [--description "what it is"].');
     return 2;
   }
+  const clone = await cloneAt(url.trim());
   const id = o.id?.trim() || idFromUrl(url.trim());
   if (!RecordId.safeParse(id).success) {
     io.err(`${id} isn't a repo id: ids are lowercase slugs (a-z, 0-9, '.', '_' and '-'). Give one with --id.`);
@@ -113,18 +136,23 @@ async function repoAdd(root, url, o, io, deps = {}) {
   const by = await whoFor(root, deps);
   const description = text ? written(text, by, deps.now ?? /* @__PURE__ */ new Date()) : void 0;
   const detected = o.type?.trim() ? void 0 : await typeOf(url.trim(), text, await declaredFrameworks(root, id));
+  const listed = await loadRepos(root).catch(() => []);
+  const near = nearRepos({ id, url: clone?.origin ?? url.trim() }, listed);
   try {
     const file = await addManifestRepo(root, platform, {
       id,
-      url: url.trim(),
+      url: clone?.origin ?? url.trim(),
+      ...clone?.branch ? { defaultBranch: clone.branch } : {},
       type: o.type?.trim() || detected?.type || "unknown",
       owner: o.owner?.trim() || "unassigned",
       ...o.system?.trim() ? { system: o.system.trim() } : {},
       ...o.component?.trim() ? { component: o.component.trim() } : {},
       ...description ? { description } : {}
     });
+    for (const n of near)
+      io.err(`Warning: ${id} looks like ${n.id}, already listed (${n.why}). If they are one repo, remove this entry from ${file.rel}, or keep one id: atticus repo rename <old> <new>.`);
     if (o.json) {
-      io.out(JSON.stringify({ repo: id, platform, file: file.rel, description }, null, 2));
+      io.out(JSON.stringify({ repo: id, platform, file: file.rel, description, ...near.length ? { near } : {} }, null, 2));
       return 0;
     }
     io.out(`Added ${id} to ${file.rel}: commit it in a pull request.`);
@@ -134,7 +162,7 @@ async function repoAdd(root, url, o, io, deps = {}) {
       io.out(`What it is: ${description.text}`);
     else
       io.out(`${id} has no description yet${asked ? "" : " (--description, or atticus repo describe)"}: atticus repo describe ${id} --description "what it is". Until then its reading prompts, the join's questions and the views have only its id to go on.`);
-    io.out(`Next: atticus workspace sync, then read it: /atticus-map ${id}.`);
+    io.out(clone?.origin ? `From your clone: ${clone.origin}, branch ${clone.branch ?? "main"}. Next: atticus workspace sync --from "${dirname(clone.dir)}" --repos ${id} (copied from it, no network), then read it: /atticus-map ${id}.` : `Next: atticus workspace sync, then read it: /atticus-map ${id}.`);
     return 0;
   } catch (e) {
     if (e instanceof ManifestEditError) {
@@ -272,7 +300,13 @@ async function keepDraftedDescription(root, repo, draft, now) {
   });
   if (!d.success)
     return { kept: false, why: d.error.issues[0]?.message ?? "the draft wasn't one line" };
-  await setManifestDescription(root, repo, d.data);
+  try {
+    await setManifestDescription(root, repo, d.data);
+  } catch (e) {
+    if (e instanceof FileChangedError)
+      return { kept: false, why: e.message };
+    throw e;
+  }
   return { kept: true };
 }
 export {