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

package/dist/chunk-MGYZM27B.js

@@ -0,0 +1,205 @@
+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 {
+  intakeContext
+} from "./chunk-ZNCEKR4J.js";
+import "./chunk-VOGCSYOI.js";
+import {
+  estateFacts,
+  estateRepos,
+  joinReposOf
+} from "./chunk-27NKUS3X.js";
+import "./chunk-L24C55VN.js";
+import "./chunk-PAMPPUR6.js";
+import {
+  readVendorSpec,
+  slug,
+  vendorImpact
+} from "./chunk-23W7VWKR.js";
+import "./chunk-7EKXJZ2Y.js";
+import "./chunk-MC3H7736.js";
+import "./chunk-EFHQ3TWP.js";
+import "./chunk-GQ4N4WKF.js";
+import "./chunk-CNUKCS2T.js";
+import {
+  inputsDirOf,
+  readFlow,
+  specFlowFiles
+} from "./chunk-S2A7YC3Q.js";
+import "./chunk-D3PO4DOZ.js";
+import "./chunk-TV45EUGM.js";
+
+// packages/cli/dist/vendor-impact-commands.js
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { isAbsolute, join, relative, resolve, sep } from "node:path";
+var IMPACT_WORDS = {
+  usage: "Name the vendor spec: atticus intake impact <spec> [--json]",
+  noSuchSpec: (spec) => `There is no ${spec} in inputs/. atticus intake list shows what is there.`,
+  notASpec: (path) => `${path} isn't an OpenAPI 3 or Swagger 2 spec, so it has no operations to compare.`,
+  noOtherVersion: (path) => `${path} has no other version beside it in inputs/, so there is nothing to compare. Add each version of a vendor's spec beside the last (atticus intake add), never over it.`,
+  noSystem: (path) => `${path} isn't linked to a system yet, so its operations belong to nobody. atticus triage asks which system it is.`,
+  header: (name, older, newer) => `${name}: ${older.path}${older.version ? ` (${older.version})` : ""} \u2192 ${newer.path}${newer.version ? ` (${newer.version})` : ""}`,
+  counts: (all, breaking) => all === 0 ? "The two versions publish the same operations, fields and auth." : `${all} change${all === 1 ? "" : "s"}: ${breaking} breaking, ${all - breaking} additive.`,
+  severity: { breaking: "Breaking", additive: "Additive" },
+  reachesNothing: "Nothing in the estate reaches it.",
+  gap: (message, where2) => `Forwarded, but not in the older version either: ${message} (${where2}).`,
+  ask: (question) => `Asked: ${question}`,
+  affected: (repos, flows) => `Affected: ${repos.join(", ")}${flows.length ? `; flows ${flows.join(", ")}` : ""}.`,
+  nothingAffected: "Nothing in the estate reaches these changes.",
+  start: (spec) => `Start a change with this as its footprint: atticus change new "<title>" --type <type> --impact ${spec}`,
+  docTitle: (name, version) => `# What ${name} ${version} changes, and what in the estate it reaches`,
+  started: (name, version, i, attached) => `Its footprint is what ${name} ${version} reaches: ${i.repos.length} repo${i.repos.length === 1 ? "" : "s"}, ${i.flows.length} flow${i.flows.length === 1 ? "" : "s"}, ${i.interfaces.length} Interface${i.interfaces.length === 1 ? "" : "s"}. The impact is attached as ${attached}.`
+};
+var posix = (p) => p.split(sep).join("/");
+var SPECS = /* @__PURE__ */ new Set(["openapi", "swagger"]);
+function findDocument(root, docs, spec) {
+  const kept = docs.filter((d) => d.id);
+  if (!isAbsolute(spec) && spec.includes("/") && existsSync(resolve(spec)))
+    spec = resolve(spec);
+  const rel = isAbsolute(spec) ? `inputs/${posix(relative(inputsDirOf(root), spec))}` : posix(spec);
+  return kept.find((d) => d.path === rel) ?? kept.find((d) => d.path === `inputs/${rel}`) ?? kept.find((d) => d.id === spec) ?? (() => {
+    const named = kept.filter((d) => d.path.split("/").pop() === rel);
+    return named.length === 1 ? named[0] : void 0;
+  })();
+}
+async function loadVendorImpact(root, spec, io) {
+  const { op, inputs } = await intakeContext(root, io);
+  const doc = findDocument(root, inputs.documents, spec);
+  if (!doc)
+    return { error: IMPACT_WORDS.noSuchSpec(spec) };
+  if (!SPECS.has(doc.classification))
+    return { error: IMPACT_WORDS.notASpec(doc.path) };
+  const byId = new Map(inputs.documents.filter((d) => d.id).map((d) => [d.id, d]));
+  const older = doc.supersededBy ? doc : inputs.documents.find((d) => d.supersededBy === doc.id && SPECS.has(d.classification));
+  const newer = doc.supersededBy ? byId.get(doc.supersededBy) : doc;
+  if (!older || !newer || !SPECS.has(newer.classification))
+    return { error: IMPACT_WORDS.noOtherVersion(doc.path) };
+  const systemId = newer.systems[0] ?? older.systems[0];
+  const system = op.profiles.flatMap((p) => p.profile?.systems ?? []).find((s) => s.id === systemId);
+  if (!systemId || !system)
+    return { error: IMPACT_WORDS.noSystem(newer.path) };
+  const inputsDir = inputsDirOf(root);
+  const read = async (d) => readVendorSpec(d.path, await readFile(join(inputsDir, ...d.path.split("/").slice(1)), "utf8"), systemId);
+  const [olderSpec, newerSpec] = [await read(older), await read(newer)];
+  if (!olderSpec)
+    return { error: IMPACT_WORDS.notASpec(older.path) };
+  if (!newerSpec)
+    return { error: IMPACT_WORDS.notASpec(newer.path) };
+  const estate = await estateFacts(root, op, "");
+  const repos = joinReposOf(op, estate.repos);
+  const flows = [];
+  for (const [id, f] of await specFlowFiles(root).catch(() => /* @__PURE__ */ new Map())) {
+    const flow = await readFlow(root, f.repo, id).catch(() => void 0);
+    if (!flow)
+      continue;
+    flows.push({
+      id,
+      repo: f.repo,
+      ...flow.trigger.ref ? { trigger: flow.trigger.ref } : {},
+      refs: flow.steps.flatMap((s) => s.refs ?? [])
+    });
+  }
+  const systemOfRepo = Object.fromEntries(estateRepos(op).flatMap((r) => r.system ? [[r.id, r.system]] : []));
+  const { diff, impact } = vendorImpact({
+    vendor: { system: systemId, names: [system.name, ...system.aliases] },
+    older: { id: older.id, spec: olderSpec },
+    newer: { id: newer.id, spec: newerSpec },
+    repos,
+    targets: estate.targets,
+    flows,
+    systemOfRepo
+  });
+  const facts = /* @__PURE__ */ new Map();
+  for (const r of estate.repos)
+    for (const f of r.facts)
+      facts.set(`${r.repo}\0${f.id}`, f);
+  return { name: system.name, diff, impact, notes: estate.notes, facts };
+}
+var where = (e) => `${e.repo} ${e.at}`;
+function impactLines(l) {
+  const { impact, diff } = l;
+  const out = [];
+  out.push(IMPACT_WORDS.header(l.name, impact.older, impact.newer));
+  out.push(IMPACT_WORDS.counts(diff.length, diff.filter((c) => c.severity === "breaking").length));
+  const byId = new Map(diff.map((c) => [c.id, c]));
+  for (const c of impact.changes) {
+    const d = byId.get(c.id);
+    out.push("");
+    out.push(`${IMPACT_WORDS.severity[c.severity]}: ${c.says}`);
+    const cites = [
+      ...d.before ? [`was ${d.before.cite}`] : [],
+      ...d.after ? [`now ${d.after.cite}`] : []
+    ];
+    if (cites.length)
+      out.push(`  ${cites.join(", ")}`);
+    if (!c.forwards.length)
+      out.push(`  ${IMPACT_WORDS.reachesNothing}`);
+    for (const f of c.forwards) {
+      const call = l.facts.get(`${f.call.repo}\0${f.call.fact}`);
+      const what = call?.kind === "call" ? [call.method?.toUpperCase(), call.path].filter(Boolean).join(" ") : f.call.fact;
+      const to = f.tie ? `to ${l.name} through ${f.tie.at}` : `to ${l.name}`;
+      out.push(`  forwarded by ${f.call.component}: ${what}, ${where(f.call)} (${to})`);
+      for (const s of f.callers) {
+        const field = s.field ? s.field.uses === "sends" || s.field.uses === "reads" ? `, ${s.field.uses} ${d.field}${s.field.at ? ` (${s.field.at})` : ""}` : `, ${s.field.uses === "does-not-send" ? "doesn't send" : "doesn't read"} ${d.field}` : "";
+        const via = s.via?.length ? `, through ${s.via.join(" \u2192 ")}` : "";
+        out.push(`    called by ${s.call.component}: ${where(s.call)}${field}${via}`);
+        if (s.under)
+          out.push(`      under ${where(s.under)}`);
+        for (const u of s.upstream) {
+          const uvia = u.via?.length ? `, through ${u.via.join(" \u2192 ")}` : "";
+          out.push(`      \u2190 ${u.call.component}: ${where(u.call)}${uvia}${u.under ? `, under ${where(u.under)}` : ""}`);
+        }
+      }
+    }
+  }
+  if (impact.gaps.length || impact.asks.length)
+    out.push("");
+  for (const g of impact.gaps)
+    out.push(IMPACT_WORDS.gap(g.message, where(g.call)));
+  for (const a of impact.asks)
+    out.push(IMPACT_WORDS.ask(a.question));
+  out.push("");
+  out.push(impact.repos.length ? IMPACT_WORDS.affected(impact.repos, impact.flows.map((f) => f.id)) : IMPACT_WORDS.nothingAffected);
+  return out;
+}
+async function intakeImpact(root, spec, o, io) {
+  if (!spec) {
+    io.err(IMPACT_WORDS.usage);
+    return 2;
+  }
+  const l = await loadVendorImpact(root, spec, io);
+  if ("error" in l) {
+    io.err(l.error);
+    return 1;
+  }
+  for (const n of l.notes)
+    io.err(n);
+  const reaches = l.impact.changes.some((c) => c.severity === "breaking" && c.forwards.length > 0);
+  if (o.json) {
+    io.out(JSON.stringify({ diff: l.diff, impact: l.impact }, null, 2));
+    return reaches ? 1 : 0;
+  }
+  for (const line of impactLines(l))
+    io.out(line);
+  if (l.impact.repos.length)
+    io.out(IMPACT_WORDS.start(l.impact.newer.path));
+  return reaches ? 1 : 0;
+}
+function impactDocument(l) {
+  const version = l.impact.newer.version ?? l.impact.newer.id;
+  return {
+    name: `${slug(`${l.name} ${version}`)}-impact.md`,
+    text: [IMPACT_WORDS.docTitle(l.name, version), "", ...impactLines(l), ""].join("\n")
+  };
+}
+export {
+  IMPACT_WORDS,
+  impactDocument,
+  impactLines,
+  intakeImpact,
+  loadVendorImpact
+};

package/dist/chunk-MMOSZPWJ.js

@@ -0,0 +1,273 @@
+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 {
+  BACKEND_EXTRACTORS,
+  BUILT_IN_EXTRACTORS,
+  CLIENT_PACKAGES,
+  DATA_EXTRACTORS,
+  Evaluator,
+  LANG_OF,
+  MODEL_READERS,
+  PLATFORM_EXTRACTORS,
+  PREFIX_CONVENTIONS,
+  READ_ANNOTATIONS,
+  SHIPPED_DIALECTS_DIR,
+  SOURCE_GLOBS,
+  SOURCE_SKIP,
+  SPECKIT_EXTRACTORS,
+  SPECKIT_EXTRACTOR_VERSION,
+  SYNTAX_LANGUAGES,
+  SourceFile,
+  SyntaxQueryError,
+  VOCAB_EXTRACTORS,
+  accessExtractor,
+  addEntry,
+  apigeeExtractor,
+  applyAnnotations,
+  applyPipelineModels,
+  appsExtractor,
+  asyncapiExtractor,
+  attr,
+  attrs,
+  attrsShown,
+  batchExtractor,
+  cloudStoresExtractor,
+  componentExtractor,
+  componentFor,
+  componentOf,
+  dataPipelinesExtractor,
+  declarationOutline,
+  detectModules,
+  dialectExtractor,
+  dotnetExtractor,
+  envOf,
+  evidence,
+  findAnnotation,
+  flattenConfig,
+  flattenProperties,
+  flattenYaml,
+  flattenYamlDocuments,
+  frameworkNameOf,
+  frameworkTestLine,
+  frontendExtractor,
+  gcpExtractor,
+  goExtractor,
+  grammarFile,
+  graphqlExtractor,
+  groovyCalls,
+  grpcExtractor,
+  houseDependencies,
+  houseExtractor,
+  importsInText,
+  infraExtractor,
+  ingressExtractor,
+  isWellKnownModule,
+  learnFramework,
+  learnFrameworkFromJar,
+  learnJsFramework,
+  learnJsFrameworkFromTarball,
+  listDialectFiles,
+  listShippedDialects,
+  liveTrees,
+  loadManifests,
+  loadShippedDialects,
+  loadTerraform,
+  looksLikeSql,
+  looseEnd,
+  mainframeExtractor,
+  meshExtractor,
+  migrationsExtractor,
+  mlExtractor,
+  modelCovers,
+  modelValues,
+  modelsFor,
+  nodeExtractor,
+  observabilityAssetId,
+  observabilityExtractor,
+  openapiExtractor,
+  openshiftExtractor,
+  ormExtractor,
+  parseDdl,
+  parseGraphql,
+  parseHcl,
+  parseJava,
+  parseJavaClasses,
+  parseJavaMembers,
+  parseJavaTree,
+  parseMd,
+  parseProto,
+  parseSyntax,
+  parseXml,
+  pipelinesExtractor,
+  pythonExtractor,
+  querySyntax,
+  readOpenApiDocument,
+  readSpecKitFeatures,
+  readYamlDocs,
+  realtimeExtractor,
+  relaxedKey,
+  repoConfig,
+  repoConfigFor,
+  repoImports,
+  resolvePlaceholders,
+  restEndpoint,
+  runDialectTests,
+  runFrameworkTests,
+  select,
+  selectText,
+  serverlessExtractor,
+  settingSlug,
+  speckitExtractor,
+  splitUrl,
+  springExtractor,
+  springName,
+  syntaxLanguageOf,
+  syntaxOutline,
+  tablesInQuery,
+  templateMatches,
+  topicsExtractor,
+  unmodelledFrameworks,
+  useSyntaxTree,
+  webhooksExtractor,
+  wrapperCalls,
+  yamlKeyLine
+} from "./chunk-MC3H7736.js";
+import "./chunk-GQ4N4WKF.js";
+import "./chunk-S2A7YC3Q.js";
+import "./chunk-D3PO4DOZ.js";
+import "./chunk-TV45EUGM.js";
+export {
+  BACKEND_EXTRACTORS,
+  BUILT_IN_EXTRACTORS,
+  CLIENT_PACKAGES,
+  DATA_EXTRACTORS,
+  Evaluator,
+  LANG_OF,
+  MODEL_READERS,
+  PLATFORM_EXTRACTORS,
+  PREFIX_CONVENTIONS,
+  READ_ANNOTATIONS,
+  SHIPPED_DIALECTS_DIR,
+  SOURCE_GLOBS,
+  SOURCE_SKIP,
+  SPECKIT_EXTRACTORS,
+  SPECKIT_EXTRACTOR_VERSION,
+  SYNTAX_LANGUAGES,
+  SourceFile,
+  SyntaxQueryError,
+  VOCAB_EXTRACTORS,
+  accessExtractor,
+  addEntry,
+  apigeeExtractor,
+  applyAnnotations,
+  applyPipelineModels,
+  appsExtractor,
+  asyncapiExtractor,
+  attr,
+  attrs,
+  attrsShown,
+  batchExtractor,
+  cloudStoresExtractor,
+  componentExtractor,
+  componentFor,
+  componentOf,
+  dataPipelinesExtractor,
+  declarationOutline,
+  detectModules,
+  dialectExtractor,
+  dotnetExtractor,
+  envOf,
+  evidence,
+  findAnnotation,
+  flattenConfig,
+  flattenProperties,
+  flattenYaml,
+  flattenYamlDocuments,
+  frameworkNameOf,
+  frameworkTestLine,
+  frontendExtractor,
+  gcpExtractor,
+  goExtractor,
+  grammarFile,
+  graphqlExtractor,
+  groovyCalls,
+  grpcExtractor,
+  houseDependencies,
+  houseExtractor,
+  importsInText,
+  infraExtractor,
+  ingressExtractor,
+  isWellKnownModule,
+  learnFramework,
+  learnFrameworkFromJar,
+  learnJsFramework,
+  learnJsFrameworkFromTarball,
+  listDialectFiles,
+  listShippedDialects,
+  liveTrees,
+  loadManifests,
+  loadShippedDialects,
+  loadTerraform,
+  looksLikeSql,
+  looseEnd,
+  mainframeExtractor,
+  meshExtractor,
+  migrationsExtractor,
+  mlExtractor,
+  modelCovers,
+  modelValues,
+  modelsFor,
+  nodeExtractor,
+  observabilityAssetId,
+  observabilityExtractor,
+  openapiExtractor,
+  openshiftExtractor,
+  ormExtractor,
+  parseDdl,
+  parseGraphql,
+  parseHcl,
+  parseJava,
+  parseJavaClasses,
+  parseJavaMembers,
+  parseJavaTree,
+  parseMd,
+  parseProto,
+  parseSyntax,
+  parseXml,
+  pipelinesExtractor,
+  pythonExtractor,
+  querySyntax,
+  readOpenApiDocument,
+  readSpecKitFeatures,
+  readYamlDocs,
+  realtimeExtractor,
+  relaxedKey,
+  repoConfig,
+  repoConfigFor,
+  repoImports,
+  resolvePlaceholders,
+  restEndpoint,
+  runDialectTests,
+  runFrameworkTests,
+  select,
+  selectText,
+  serverlessExtractor,
+  settingSlug,
+  speckitExtractor,
+  splitUrl,
+  springExtractor,
+  springName,
+  syntaxLanguageOf,
+  syntaxOutline,
+  tablesInQuery,
+  templateMatches,
+  topicsExtractor,
+  unmodelledFrameworks,
+  useSyntaxTree,
+  webhooksExtractor,
+  wrapperCalls,
+  yamlKeyLine
+};