@maycombhq/atticus 0.0.0-stage → 2.0.0-beta.11

package/dist/chunk-ZHWSL6SR.js

@@ -0,0 +1,45 @@
+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 {
+  BASELINE_FILE,
+  baselineCommand,
+  readBaseline,
+  setupCommand,
+  setupSteps
+} from "./chunk-3WU7LVTL.js";
+import "./chunk-HR4DVO6X.js";
+import "./chunk-WCLAOKCH.js";
+import "./chunk-3G4YI4ZU.js";
+import "./chunk-LUPW4WLK.js";
+import "./chunk-NG5R2WIY.js";
+import "./chunk-6RGIM2ZH.js";
+import "./chunk-EV4TEFOD.js";
+import "./chunk-6N2GUZMZ.js";
+import "./chunk-T6ESD5KM.js";
+import "./chunk-3LU6YCSQ.js";
+import "./chunk-L7I5PKGD.js";
+import "./chunk-CAN3EBE5.js";
+import "./chunk-IILZ7J3L.js";
+import "./chunk-TEBBD4XH.js";
+import "./chunk-XPWSNKF3.js";
+import "./chunk-WIMOJMAK.js";
+import "./chunk-5V5BJACL.js";
+import "./chunk-GVFUEGGM.js";
+import "./chunk-XNRPCI23.js";
+import "./chunk-7RUMD56V.js";
+import "./chunk-XZJE6WIT.js";
+import "./chunk-FMRMTI7W.js";
+import "./chunk-BKFGGJKA.js";
+import "./chunk-JMOLB347.js";
+import "./chunk-MMB2OHUY.js";
+import "./chunk-TV45EUGM.js";
+export {
+  BASELINE_FILE,
+  baselineCommand,
+  readBaseline,
+  setupCommand,
+  setupSteps
+};

package/dist/chunk-ZJQUIG3A.js

@@ -0,0 +1,87 @@
+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-IA2RKC6I.js";
+import "./chunk-MYKQVS5W.js";
+import "./chunk-EBWIOODZ.js";
+import "./chunk-BA5DTXHQ.js";
+import "./chunk-VOGCSYOI.js";
+import "./chunk-IILZ7J3L.js";
+import "./chunk-TEBBD4XH.js";
+import "./chunk-XPWSNKF3.js";
+import "./chunk-WIMOJMAK.js";
+import "./chunk-5V5BJACL.js";
+import "./chunk-GVFUEGGM.js";
+import "./chunk-XZJE6WIT.js";
+import "./chunk-FMRMTI7W.js";
+import "./chunk-BKFGGJKA.js";
+import "./chunk-JMOLB347.js";
+import "./chunk-MMB2OHUY.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).",
+  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 (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-ZKUDS7JG.js

@@ -0,0 +1,310 @@
+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 {
+  nearRepos
+} from "./chunk-MKFYQQ5Q.js";
+import {
+  gitUser,
+  loadRepos
+} from "./chunk-XZJE6WIT.js";
+import {
+  ManifestEditError,
+  REPO_DESCRIPTION_MAX,
+  RecordId,
+  RepoDescription,
+  addManifestRepo,
+  descriptionLine,
+  factsDirOf,
+  manifestFiles,
+  parseFacts,
+  setManifestDescription
+} from "./chunk-JMOLB347.js";
+import "./chunk-MMB2OHUY.js";
+import "./chunk-TV45EUGM.js";
+
+// packages/cli/dist/repo-commands.js
+import { readFile, stat } from "node:fs/promises";
+import { basename, dirname, join, resolve } from "node:path";
+import { createInterface } from "node:readline/promises";
+import { stdin, stdout } from "node:process";
+var askOnTerminal = async (prompt) => {
+  if (!stdin.isTTY)
+    return void 0;
+  const rl = createInterface({ input: stdin, output: stdout });
+  try {
+    return (await rl.question(`${prompt} `)).trim() || void 0;
+  } finally {
+    rl.close();
+  }
+};
+var ASK = "What is this repo, in one line? (what it is for, who uses it; Enter to skip and write it later)";
+function idFromUrl(url) {
+  const last = url.replace(/[/\\]+$/, "").split(/[/\\:]/).pop() ?? "";
+  return last.replace(/\.git$/i, "").toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "") || "repo";
+}
+var trimmed = (t) => {
+  const s = t?.trim();
+  return s ? s.slice(0, REPO_DESCRIPTION_MAX) : void 0;
+};
+function written(text, by, now) {
+  return RepoDescription.parse({
+    text,
+    trust: "verified",
+    by,
+    at: now.toISOString().replace(/\.\d{3}Z$/, "Z")
+  });
+}
+async function declaredFrameworks(root, repo) {
+  const text = await readFile(join(factsDirOf(root), `${repo}.jsonl`), "utf8").catch(() => void 0);
+  if (text === void 0)
+    return [];
+  const p = parseFacts(text);
+  if (!p.ok)
+    return [];
+  return p.facts.flatMap((f) => f.kind === "framework" ? [{ name: f.name, cite: `${f.cite.file}:${f.cite.line}` }] : []);
+}
+async function typeOf(url, description, frameworks = []) {
+  if (/^[a-z][a-z0-9+.-]*:\/\//i.test(url) || /^[^/\\]+@/.test(url))
+    return void 0;
+  const dir = resolve(url);
+  if (!await stat(dir).then((s) => s.isDirectory(), () => false))
+    return void 0;
+  const [{ detectRepoType }, { fsRepo }] = await Promise.all([
+    import("./chunk-R6UTCLH5.js"),
+    import("./chunk-5NZSJ5ZG.js")
+  ]);
+  const d = await detectRepoType(fsRepo(basename(dir), dir, "0".repeat(40)), {
+    ...description ? { description } : {},
+    ...frameworks.length ? { 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;
+  try {
+    return (await gitUser(root)).handle;
+  } catch {
+    return "someone";
+  }
+}
+async function repoAdd(root, url, o, io, deps = {}) {
+  if (!url?.trim()) {
+    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.`);
+    return 2;
+  }
+  const files = await manifestFiles(root);
+  const platform = o.platform?.trim() || (files.length === 1 ? files[0].platform : void 0);
+  if (!platform) {
+    io.err(files.length ? `There are ${files.length} platform profiles (${files.map((f) => f.platform).join(", ")}): say which with --platform.` : "The org pack has no platform profile yet (org-pack/profiles/<platform>/repos.manifest.yaml). Run atticus repos discover <folder of clones>, or atticus init first.");
+    return 2;
+  }
+  let text = trimmed(o.description);
+  let asked = false;
+  if (!text && !o.noDescription && !o.json) {
+    text = trimmed(await (deps.ask ?? askOnTerminal)(`${id}: ${ASK}`));
+    asked = true;
+  }
+  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: 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, ...near.length ? { near } : {} }, null, 2));
+      return 0;
+    }
+    io.out(`Added ${id} to ${file.rel}: commit it in a pull request.`);
+    if (detected)
+      io.out(`Type: ${detected.type}, from ${detected.signals.join(", ")} (${detected.confidence} confidence). Change it in the manifest if it is wrong.`);
+    if (description)
+      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(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) {
+      io.err(e.message);
+      return e.code === "not-found" ? 2 : 1;
+    }
+    throw e;
+  }
+}
+async function undescribedRepos(root) {
+  const repos = await loadRepos(root).catch(() => []);
+  const missing = [];
+  const unconfirmed = [];
+  for (const r of repos) {
+    if (r.archived)
+      continue;
+    if (!r.description)
+      missing.push(r.id);
+    else if (r.description.trust === "suggested")
+      unconfirmed.push({ id: r.id, text: r.description.text });
+  }
+  return { missing, unconfirmed };
+}
+async function repoDescribe(root, repo, o, io, deps = {}) {
+  if (!repo?.trim()) {
+    const { missing, unconfirmed } = await undescribedRepos(root);
+    if (o.json) {
+      io.out(JSON.stringify({ missing, unconfirmed }, null, 2));
+      return 0;
+    }
+    if (!missing.length && !unconfirmed.length) {
+      io.out("Every repo of the manifests says what it is.");
+      return 0;
+    }
+    if (missing.length) {
+      io.out(`${missing.length} repo${missing.length === 1 ? " has" : "s have"} no description:`);
+      for (const id2 of missing)
+        io.out(`  ${id2}: atticus repo describe ${id2} --description "..."`);
+    }
+    if (unconfirmed.length) {
+      io.out(`${unconfirmed.length} description${unconfirmed.length === 1 ? " was" : "s were"} drafted by your assistant and nobody has confirmed ${unconfirmed.length === 1 ? "it" : "them"} yet:`);
+      for (const u of unconfirmed)
+        io.out(`  ${u.id}: "${u.text}" \u2014 atticus repo describe ${u.id} --accept`);
+    }
+    return 0;
+  }
+  const id = repo.trim();
+  const found = (await loadRepos(root).catch(() => [])).find((r) => r.id === id);
+  if (!found) {
+    io.err(`There is no repo ${id} in any repos.manifest.yaml.`);
+    return 2;
+  }
+  const now = deps.now ?? /* @__PURE__ */ new Date();
+  const at = now.toISOString().replace(/\.\d{3}Z$/, "Z");
+  if (o.drafted !== void 0) {
+    const cites = (o.cites ?? "").split(",").map((c) => c.trim()).filter(Boolean).flatMap((c) => {
+      const m = /^(.*):(\d+)$/.exec(c);
+      return m && Number(m[2]) > 0 ? [{ file: m[1], line: Number(m[2]) }] : [];
+    });
+    if (!cites.length) {
+      io.err(`Say where you read it: atticus repo describe ${id} --drafted "..." --cites <file>:<line> (several separated by commas), as a fact cites its line.`);
+      return 2;
+    }
+    const r = await keepDraftedDescription(root, id, { text: o.drafted, cites }, now);
+    if (o.json) {
+      io.out(JSON.stringify({ repo: id, ...r }, null, 2));
+      return r.kept ? 0 : 1;
+    }
+    if (!r.kept) {
+      io.err(`The draft wasn't kept: ${r.why ?? "it wasn't one line"}.`);
+      return 1;
+    }
+    io.out(`${id}: "${o.drafted.trim()}" \u2014 kept as a draft, unconfirmed, with the lines you read it from. A person confirms it (atticus repo describe ${id} --accept), changes it or drops it.`);
+    return 0;
+  }
+  let next;
+  if (o.reject) {
+    if (!found.description) {
+      io.err(`${id} has no description to reject.`);
+      return 2;
+    }
+    next = void 0;
+  } else {
+    let text = trimmed(o.description);
+    if (!text && o.accept) {
+      if (!found.description) {
+        io.err(`${id} has no description to confirm. Write one: atticus repo describe ${id} --description "what it is".`);
+        return 2;
+      }
+      text = found.description.text;
+    }
+    if (!text && !o.json)
+      text = trimmed(await (deps.ask ?? askOnTerminal)(`${id}: ${ASK}`));
+    if (!text) {
+      io.err(`Say what ${id} is: atticus repo describe ${id} --description "what it is" (or --accept to keep the draft, --reject to drop it).`);
+      return 2;
+    }
+    next = written(text, await whoFor(root, deps), now);
+  }
+  try {
+    const file = await setManifestDescription(root, id, next);
+    if (o.json) {
+      io.out(JSON.stringify({ repo: id, file: file.rel, description: next ?? null }, null, 2));
+      return 0;
+    }
+    io.out(next ? `${id}: ${descriptionLine(next)}` : `${id}: the description was dropped; nothing says what it is now.`);
+    io.out(`Written to ${file.rel} at ${at}: commit it in a pull request.`);
+    return 0;
+  } catch (e) {
+    if (e instanceof ManifestEditError) {
+      io.err(e.message);
+      return e.code === "not-found" ? 2 : 1;
+    }
+    throw e;
+  }
+}
+async function keepDraftedDescription(root, repo, draft, now) {
+  const found = (await loadRepos(root).catch(() => [])).find((r) => r.id === repo);
+  if (!found)
+    return { kept: false, why: `${repo} isn't in any repos.manifest.yaml` };
+  if (found.description)
+    return {
+      kept: false,
+      why: found.description.trust === "verified" ? `${repo} already says what it is, in a person's words` : `${repo} already has a drafted description waiting for a person`
+    };
+  const text = trimmed(draft.text);
+  if (!text)
+    return { kept: false, why: "the draft was empty" };
+  const d = RepoDescription.safeParse({
+    text,
+    trust: "suggested",
+    by: draft.by ?? "assistant",
+    at: now.toISOString().replace(/\.\d{3}Z$/, "Z"),
+    cites: (draft.cites ?? []).slice(0, 6)
+  });
+  if (!d.success)
+    return { kept: false, why: d.error.issues[0]?.message ?? "the draft wasn't one line" };
+  await setManifestDescription(root, repo, d.data);
+  return { kept: true };
+}
+export {
+  askOnTerminal,
+  idFromUrl,
+  keepDraftedDescription,
+  repoAdd,
+  repoDescribe,
+  undescribedRepos
+};