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

package/dist/chunk-ITY3VJRX.js

@@ -0,0 +1,285 @@
+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 {
+  gitUser,
+  loadRepos
+} from "./chunk-KJPMEAI4.js";
+import {
+  ManifestEditError,
+  REPO_DESCRIPTION_MAX,
+  RecordId,
+  RepoDescription,
+  addManifestRepo,
+  descriptionLine,
+  factsDirOf,
+  manifestFiles,
+  parseFacts,
+  setManifestDescription
+} from "./chunk-S2A7YC3Q.js";
+import "./chunk-D3PO4DOZ.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 { 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-A7KZKIZX.js"),
+    import("./chunk-HFQCFSJR.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 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 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));
+  try {
+    const file = await addManifestRepo(root, platform, {
+      id,
+      url: url.trim(),
+      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 } : {}
+    });
+    if (o.json) {
+      io.out(JSON.stringify({ repo: id, platform, file: file.rel, description }, 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(`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
+};

package/dist/chunk-JBTK5OP2.js

@@ -0,0 +1,55 @@
+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 {
+  external_exports,
+  require_dist
+} from "./chunk-S2A7YC3Q.js";
+import {
+  ensureLocalIgnore
+} from "./chunk-D3PO4DOZ.js";
+import {
+  __toESM
+} from "./chunk-TV45EUGM.js";
+
+// packages/cli/dist/me-file.js
+var import_yaml = __toESM(require_dist(), 1);
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+var ME_FILE = ".atticus/me.yaml";
+var MeNotify = external_exports.object({
+  /** Where the digest goes; default a direct message to the person. */
+  channel: external_exports.string().min(1).optional(),
+  /** How often the person wants the digest; Atticus sends it only when they (or their own scheduled job) ask. */
+  digest: external_exports.enum(["off", "daily", "weekly"]).default("off")
+});
+var MeFile = external_exports.object({
+  notify: MeNotify.optional(),
+  /** Changes the person follows: the digest and the editors say how each is doing. */
+  watch: external_exports.array(external_exports.string().min(1)).default([])
+});
+async function readMe(root) {
+  try {
+    const r = MeFile.safeParse((0, import_yaml.parse)(await readFile(join(root, ME_FILE), "utf8")) ?? {});
+    return r.success ? r.data : { watch: [] };
+  } catch {
+    return { watch: [] };
+  }
+}
+async function writeMe(root, me) {
+  await ensureLocalIgnore(root);
+  const file = join(root, ME_FILE);
+  await mkdir(dirname(file), { recursive: true });
+  await writeFile(file, (0, import_yaml.stringify)({
+    ...me.notify ? { notify: me.notify } : {},
+    ...me.watch.length ? { watch: [...new Set(me.watch)].sort() } : {}
+  }), "utf8");
+}
+
+export {
+  ME_FILE,
+  readMe,
+  writeMe
+};

package/dist/chunk-JPGCERE2.js

@@ -0,0 +1,26 @@
+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));
+
+// packages/cli/dist/version.js
+var VERSION = "2.0.0-beta.3";
+function versionAtLeast(v, min) {
+  const a = v.replace(/^v/, "").split(/[.+-]/).map(Number);
+  const b = min.split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    const x = a[i] ?? 0;
+    const y = b[i] ?? 0;
+    if (Number.isNaN(x))
+      return false;
+    if (x !== y)
+      return x > y;
+  }
+  return true;
+}
+
+export {
+  VERSION,
+  versionAtLeast
+};

package/dist/chunk-JQDNHIBC.js

@@ -0,0 +1,38 @@
+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 {
+  changeEstimateCommand,
+  estimateOf
+} from "./chunk-CHWTETW7.js";
+import "./chunk-GRMR5TRQ.js";
+import "./chunk-RYSCLMU3.js";
+import "./chunk-ZUIAOKXI.js";
+import "./chunk-2UIQBDJO.js";
+import "./chunk-6SCVQZX5.js";
+import "./chunk-65NYPGRC.js";
+import "./chunk-VPTTCYOC.js";
+import "./chunk-L6SGQIR3.js";
+import "./chunk-7UFQZXZA.js";
+import "./chunk-56YQ6ROQ.js";
+import "./chunk-4AK7IBVP.js";
+import "./chunk-7JUKDRSZ.js";
+import "./chunk-OLWFG75W.js";
+import "./chunk-L24C55VN.js";
+import "./chunk-PAMPPUR6.js";
+import "./chunk-23W7VWKR.js";
+import "./chunk-7EKXJZ2Y.js";
+import "./chunk-MC3H7736.js";
+import "./chunk-T6AIP7H5.js";
+import "./chunk-KJPMEAI4.js";
+import "./chunk-GQ4N4WKF.js";
+import "./chunk-CNUKCS2T.js";
+import "./chunk-S2A7YC3Q.js";
+import "./chunk-D3PO4DOZ.js";
+import "./chunk-TV45EUGM.js";
+export {
+  changeEstimateCommand,
+  estimateOf
+};