@callidescope/output 0.0.0-stage → 0.0.4

package/dist/src/index.js

@@ -0,0 +1,1137 @@
+import { ConsoleLogger as e, Global as t, Injectable as n, Module as r, Scope as i } from "@nestjs/common";
+import { DEFAULT_JSON_INDENTATION as a } from "@callidescope/configuration";
+import { existsSync as o, mkdirSync as s, readFileSync as c, writeFileSync as l } from "node:fs";
+import u from "node:path";
+import d from "pino";
+import { GraphModule as ee, PathsService as f, SignaturesModule as te, SignaturesService as p } from "@callidescope/graph";
+//#region packages/ic-suite/callidescope/callidescope-output/src/modules/report/report.constants.ts
+var m = "🚀", h = "└─>", ne = 80, g = "(…)", re = 120, _ = /[!.?](?=\s+[A-Z])/, ie = "…", ae = "⚠ deprecated", oe = "↳", se = "flowchart LR", ce = 300, le = "n", ue = /* @__PURE__ */ new Map([
+	["<", "#lt;"],
+	[">", "#gt;"],
+	["\"", "#quot;"]
+]), v = "| Measure | Value |\n| --- | --- |", y = "| Callable | Breadth | Calls directly | Location |\n| --- | --- | --- | --- |", b = "Call stacks over the depth limit", x = "Callables over the breadth limit", de = ".", fe = "| Project | Deepest | Limit | Headroom | Widest |\n| --- | --- | --- | --- | --- |", S = "| Headroom | Projects |\n| --- | --- |", pe = "Limits", me = "| Limit | Value |\n| --- | --- |", he = "What this project is judged against, as declared in its own `callidescope.config.ts`.", ge = ["maximumDepth", "maximumBreadth"], _e = "none", C = "over limit", w = "0 — at limit", ve = "1", T = "2–3", ye = "4+", E = "no stacks", D = [
+	C,
+	w,
+	"1",
+	T,
+	"4+",
+	E
+];
+//#endregion
+//#region \0@oxc-project+runtime@0.151.0/helpers/esm/decorateMetadata.js
+function O(e, t) {
+	if (typeof Reflect == "object" && typeof Reflect.metadata == "function") return Reflect.metadata(e, t);
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.151.0/helpers/esm/decorate.js
+function k(e, t, n, r) {
+	var i = arguments.length, a = i < 3 ? t : r === null ? r = Object.getOwnPropertyDescriptor(t, n) : r, o;
+	if (typeof Reflect == "object" && typeof Reflect.decorate == "function") a = Reflect.decorate(e, t, n, r);
+	else for (var s = e.length - 1; s >= 0; s--) (o = e[s]) && (a = (i < 3 ? o(a) : i > 3 ? o(t, n, a) : o(t, n)) || a);
+	return i > 3 && a && Object.defineProperty(t, n, a), a;
+}
+//#endregion
+//#region packages/ic-suite/callidescope/callidescope-output/src/modules/report/mermaid-report.service.ts
+var A = class {
+	constructor() {}
+	addFrame(e) {
+		let t = e.diagram.identifiersByCallable.get(e.frame.id);
+		if (t !== void 0) return t;
+		let n = `n${String(e.diagram.identifiersByCallable.size)}`, r = this.renderLabel(e.frame);
+		return e.diagram.identifiersByCallable.set(e.frame.id, n), e.diagram.nodes.push(e.isEntryPoint ? `  ${n}(["${r}"])` : `  ${n}["${r}"]`), n;
+	}
+	addStack(e) {
+		let { diagram: t } = e, n;
+		for (let [r, i] of e.stack.frames.entries()) {
+			let e = this.addFrame({
+				diagram: t,
+				frame: i,
+				isEntryPoint: r === 0
+			});
+			n !== void 0 && n !== e && t.edges.add(`  ${n} --> ${e}`), n = e;
+		}
+	}
+	countNewCallables(e) {
+		return new Set(e.stack.frames.map((e) => e.id).filter((t) => !e.diagram.identifiersByCallable.has(t))).size;
+	}
+	renderLabel(e) {
+		let t = e.displayName;
+		for (let [e, n] of ue) t = t.replaceAll(e, n);
+		return e.isCycle ? `${t} (cycle)` : t;
+	}
+	renderDiagram(e) {
+		if (e.diagram.nodes.length === 0) return "None.";
+		let t = [
+			"```mermaid",
+			se,
+			...e.diagram.nodes,
+			...e.diagram.edges,
+			"```"
+		].join("\n");
+		return e.omitted === 0 ? t : `${t}\n\n_${String(e.omitted)} further call stacks are not drawn: the diagram is at its 300-callable limit._`;
+	}
+	renderStacks(e) {
+		let t = {
+			edges: /* @__PURE__ */ new Set(),
+			identifiersByCallable: /* @__PURE__ */ new Map(),
+			nodes: []
+		}, n = 0;
+		for (let r of e.stacks) {
+			if (t.identifiersByCallable.size + this.countNewCallables({
+				diagram: t,
+				stack: r
+			}) > 300) {
+				n += 1;
+				continue;
+			}
+			this.addStack({
+				diagram: t,
+				stack: r
+			});
+		}
+		return this.renderDiagram({
+			diagram: t,
+			omitted: n
+		});
+	}
+};
+A = k([n(), O("design:paramtypes", [])], A);
+//#endregion
+//#region packages/ic-suite/callidescope/callidescope-output/src/modules/report/report.service.ts
+var j = class {
+	constructor() {}
+	readFirstSentence(e) {
+		let t = _.exec(e);
+		return t === null ? void 0 : e.slice(0, t.index + 1);
+	}
+	renderFrame(e) {
+		let t = "  ".repeat(e.depth), n = e.depth === 0 ? m : h, { filePath: r, line: i } = e.frame.location, a = `${t}${n} ${e.frame.displayName}${this.renderSignature(e.frame)}${this.renderMarkers(e.frame)} [${r}:${String(i)}]`, o = e.frame.documentation?.summary ?? "";
+		return o.length === 0 ? a : `${a}\n${t}   ↳ ${this.shortenSummary(o)}`;
+	}
+	renderMarkers(e) {
+		let t = e.isCycle ? " (cycle)" : "";
+		return e.documentation?.isDeprecated ?? !1 ? `${t} ${ae}` : t;
+	}
+	renderSignature(e) {
+		let { signature: t } = e;
+		return t === void 0 ? "()" : t.text.length <= 80 ? t.text : `${g}: ${t.returnType}`;
+	}
+	shortenSummary(e) {
+		if (e.length <= 120) return e;
+		let t = this.readFirstSentence(e);
+		if (t !== void 0 && t.length <= 120) return t;
+		let n = e.slice(0, 120), r = n.lastIndexOf(" ");
+		return `${(r === -1 ? n : n.slice(0, r)).trimEnd()}…`;
+	}
+	renderStackTree(e) {
+		return e.frames.map((e, t) => this.renderFrame({
+			depth: t,
+			frame: e
+		})).join("\n");
+	}
+};
+j = k([n(), O("design:paramtypes", [])], j);
+//#endregion
+//#region packages/ic-suite/callidescope/callidescope-output/src/modules/report/workspace-report.service.ts
+var M = class {
+	constructor() {}
+	bucketFor(e) {
+		return e.deepest === 0 ? E : e.headroom < 0 ? C : e.headroom === 0 ? w : e.headroom === 1 ? "1" : e.headroom <= 3 ? T : "4+";
+	}
+	widestBreadth(e) {
+		return e.callableBreadths.reduce((e, t) => Math.max(e, t.breadth), 0);
+	}
+	buildRows(e) {
+		return e.projects.map((t) => {
+			let n = this.limitsFor({
+				limits: e.limits,
+				projectName: t.projectName
+			}), r = t.summary.maximumDepth;
+			return {
+				deepest: r,
+				headroom: n.maximumDepth - r,
+				limit: n.maximumDepth,
+				projectName: t.projectName,
+				widest: this.widestBreadth(t)
+			};
+		}).toSorted((e, t) => e.headroom - t.headroom || e.projectName.localeCompare(t.projectName));
+	}
+	limitsFor(e) {
+		return e.limits.byProject.get(e.projectName) ?? e.limits.workspace;
+	}
+	renderHeadroom(e) {
+		let t = e.map((e) => this.bucketFor(e));
+		return [S, ...D.map((e) => {
+			let n = t.filter((t) => t === e).length;
+			return `| ${e} | ${String(n)} |`;
+		})].join("\n");
+	}
+	renderProjectIndex(e) {
+		let t = this.buildRows(e);
+		return t.length === 0 ? "None." : [fe, ...t.map((e) => `| \`${e.projectName === "" ? "." : e.projectName}\` | ${String(e.deepest)} | ${String(e.limit)} | ${String(e.headroom)} | ${String(e.widest)} |`)].join("\n");
+	}
+};
+M = k([n(), O("design:paramtypes", [])], M);
+//#endregion
+//#region packages/ic-suite/callidescope/callidescope-output/src/modules/report/markdown-report.service.ts
+var N = class {
+	mermaidReportService;
+	reportService;
+	workspaceReportService;
+	constructor(e, t, n) {
+		this.mermaidReportService = e, this.reportService = t, this.workspaceReportService = n;
+	}
+	renderCallableBreadths(e) {
+		let t = (e) => `| \`${e.displayName}\` | ${String(e.breadth)} | ${e.callees.map((e) => `\`${e.displayName}\``).join(", ")} | \`${e.location.filePath}:${String(e.location.line)}\` |`, n = e.reports.slice(0, e.previewCount), r = e.reports.slice(e.previewCount), i = this.renderTable({
+			header: y,
+			rows: n.map((e) => t(e))
+		});
+		return r.length === 0 ? i : [
+			i,
+			"",
+			"<details>",
+			`<summary>${String(r.length)} more callables</summary>`,
+			"",
+			this.renderTable({
+				header: y,
+				rows: r.map((e) => t(e))
+			}),
+			"",
+			"</details>"
+		].join("\n");
+	}
+	renderLimitCell(e) {
+		return e === void 0 ? _e : String(e);
+	}
+	renderProjectLimits(e) {
+		return [me, ...ge.map((t) => `| \`${t}\` | ${this.renderLimitCell(e[t])} |`)].join("\n");
+	}
+	renderStack(e) {
+		let { stack: t } = e, n = t.frames[0]?.displayName ?? "unknown", r = t.isLowerBound ? `≥ ${String(t.depth)}` : String(t.depth);
+		return [
+			`**${String(e.index + 1)}. \`${n}\`** — depth ${r} · ${t.entryPointKind}`,
+			"",
+			"```text",
+			this.reportService.renderStackTree(t),
+			"```"
+		].join("\n");
+	}
+	renderStacksAs(e) {
+		return e.rendering === "diagram" ? this.mermaidReportService.renderStacks({ stacks: e.stacks }) : this.renderStacks({
+			previewCount: e.previewCount,
+			stacks: e.stacks
+		});
+	}
+	renderSummaryTable(e) {
+		return [
+			v,
+			`| Callables | ${String(e.callableCount)} |`,
+			`| Files | ${String(e.fileCount)} |`,
+			`| Calls traced | ${String(e.edgeCount)} |`,
+			`| Call stacks | ${String(e.entryPointCount)} |`,
+			`| Deepest stack | ${String(e.maximumDepth)} |`,
+			`| Stacks through recursion | ${String(e.cyclicComponentCount)} |`,
+			`| Unfollowable calls | ${String(e.unresolvedCallCount)} |`
+		].join("\n");
+	}
+	renderTable(e) {
+		return e.rows.length === 0 ? "None." : `${e.header}\n${e.rows.join("\n")}`;
+	}
+	renderWideCallableLines(e) {
+		return e.length === 0 ? "None." : e.map((e) => `- \`${e.displayName}\` — ${String(e.breadth)} direct callees, limit ${String(e.limit)} (${e.location.filePath})`).join("\n");
+	}
+	subsectionPrefix(e) {
+		return "#".repeat((/^#+/.exec(e)?.[0].length ?? 1) + 1);
+	}
+	renderFindings(e) {
+		let { deepStacks: t, wideCallables: n } = e;
+		return [
+			`## ${b} (${String(t.length)})`,
+			"",
+			this.renderStacks({
+				previewCount: e.previewCount,
+				stacks: t
+			}),
+			"",
+			`## ${x} (${String(n.length)})`,
+			"",
+			this.renderWideCallableLines(n)
+		].join("\n");
+	}
+	renderProjectSection(e) {
+		let { report: t } = e;
+		return [
+			e.heading,
+			"",
+			`Call stacks traced through \`${t.projectName}\`, deepest first. Each frame shows what it takes, what it returns, and what its documentation says.`,
+			"",
+			this.renderSummaryTable(t.summary),
+			"",
+			`### ${pe}`,
+			"",
+			he,
+			"",
+			this.renderProjectLimits(this.workspaceReportService.limitsFor({
+				limits: e.limits,
+				projectName: t.projectName
+			})),
+			"",
+			"### Call stacks (depth)",
+			"",
+			this.renderStacksAs({
+				previewCount: e.previewCount,
+				rendering: e.rendering,
+				stacks: t.stacks
+			}),
+			"",
+			"### Breadth",
+			"",
+			this.renderCallableBreadths({
+				previewCount: e.previewCount,
+				reports: t.callableBreadths
+			})
+		].join("\n");
+	}
+	renderRun(e) {
+		let { result: t } = e, n = this.subsectionPrefix(e.heading), r = this.workspaceReportService.buildRows({
+			limits: e.limits,
+			projects: t.projects
+		});
+		return [
+			e.heading,
+			"",
+			...e.description === void 0 ? [] : [e.description, ""],
+			this.renderSummaryTable(t.summary),
+			"",
+			`${n} Projects`,
+			"",
+			this.workspaceReportService.renderProjectIndex({
+				limits: e.limits,
+				projects: t.projects
+			}),
+			"",
+			`${n} Depth headroom`,
+			"",
+			this.workspaceReportService.renderHeadroom(r),
+			"",
+			`${n} ${b} (${String(t.deepStacks.length)})`,
+			"",
+			this.renderStacksAs({
+				previewCount: e.previewCount,
+				rendering: e.rendering,
+				stacks: t.deepStacks
+			}),
+			"",
+			`${n} ${x} (${String(t.wideCallables.length)})`,
+			"",
+			this.renderCallableBreadths({
+				previewCount: e.previewCount,
+				reports: t.wideCallables
+			}),
+			""
+		].join("\n");
+	}
+	renderStacks(e) {
+		if (e.stacks.length === 0) return "None.";
+		let t = e.stacks.map((e, t) => this.renderStack({
+			index: t,
+			stack: e
+		})), n = t.slice(0, e.previewCount).join("\n\n"), r = t.slice(e.previewCount);
+		return r.length === 0 ? n : [
+			n,
+			"",
+			"<details>",
+			`<summary>${String(r.length)} more call stacks</summary>`,
+			"",
+			r.join("\n\n"),
+			"",
+			"</details>"
+		].join("\n");
+	}
+};
+N = k([n(), O("design:paramtypes", [
+	A === void 0 ? Object : A,
+	j === void 0 ? Object : j,
+	M === void 0 ? Object : M
+])], N);
+//#endregion
+//#region packages/ic-suite/callidescope/callidescope-output/src/modules/report/report.module.ts
+var P = class {};
+P = k([r({
+	controllers: [],
+	exports: [
+		N,
+		A,
+		j,
+		M
+	],
+	imports: [],
+	providers: [
+		N,
+		A,
+		j,
+		M
+	]
+})], P);
+//#endregion
+//#region packages/ic-suite/callidescope/callidescope-output/src/modules/address-report/address-report.service.ts
+var F = class {
+	mermaidReportService;
+	reportService;
+	constructor(e, t) {
+		this.mermaidReportService = e, this.reportService = t;
+	}
+	buildBreadthPayload(e) {
+		return {
+			address: e.address,
+			callable: e.displayName,
+			...e.directCalls
+		};
+	}
+	buildDepthPayload(e) {
+		return {
+			above: e.upward,
+			address: e.address,
+			below: e.downward
+		};
+	}
+	renderBreadthDiagram(e) {
+		let t = this.toFrame({
+			displayName: e.displayName,
+			id: e.id,
+			location: e.location
+		}), n = [
+			{ frames: [t] },
+			...e.directCalls.callees.map((e) => ({ frames: [t, this.toFrame(e)] })),
+			...e.directCalls.callers.map((e) => ({ frames: [this.toFrame(e), t] }))
+		];
+		return this.mermaidReportService.renderStacks({ stacks: n });
+	}
+	renderDepthStacks(e) {
+		let t = e.truncated ? "+" : "";
+		if (e.stacks.length === 0) return [
+			`### ${e.heading} (0)`,
+			"",
+			"None."
+		].join("\n");
+		let n = e.stacks.map((e, t) => {
+			let n = String(e.frames.length - 1), r = e.isLowerBound ? `≥ ${n}` : n;
+			return [
+				`**${String(t + 1)}.** depth ${r}`,
+				"",
+				"```text",
+				this.reportService.renderStackTree(e),
+				"```"
+			].join("\n");
+		});
+		return [
+			`### ${e.heading} (${String(e.stacks.length)}${t})`,
+			"",
+			n.join("\n\n")
+		].join("\n");
+	}
+	renderReferenceTable(e) {
+		if (e.references.length === 0) return [
+			`### ${e.heading} (0)`,
+			"",
+			"None."
+		].join("\n");
+		let t = e.references.map((e) => `| \`${e.displayName}\` | \`${e.location.filePath}:${String(e.location.line)}\` |`);
+		return [
+			`### ${e.heading} (${String(e.references.length)})`,
+			"",
+			"| Callable | Location |",
+			"| --- | --- |",
+			...t
+		].join("\n");
+	}
+	toFrame(e, t = !1) {
+		return {
+			displayName: e.displayName,
+			documentation: void 0,
+			id: e.id,
+			isCycle: t,
+			location: e.location,
+			signature: void 0
+		};
+	}
+	renderBreadth(e) {
+		return e.format === "json" ? `${JSON.stringify(this.buildBreadthPayload(e), null, a)}\n` : e.format === "mermaid" ? [
+			`# 🔭 Callidescope breadth — \`${e.address}\``,
+			"",
+			this.renderBreadthDiagram(e)
+		].join("\n") : [
+			`# 🔭 Callidescope breadth — \`${e.address}\``,
+			"",
+			this.renderReferenceTable({
+				heading: "Callees",
+				references: e.directCalls.callees
+			}),
+			"",
+			this.renderReferenceTable({
+				heading: "Callers",
+				references: e.directCalls.callers
+			})
+		].join("\n");
+	}
+	renderBreadthReports(e) {
+		return e.format === "json" ? `${JSON.stringify(e.reports.map((e) => this.buildBreadthPayload(e)), null, a)}\n` : e.reports.map((t) => this.renderBreadth({
+			...t,
+			format: e.format
+		})).join("\n\n");
+	}
+	renderDepth(e) {
+		return e.format === "json" ? `${JSON.stringify(this.buildDepthPayload(e), null, a)}\n` : e.format === "mermaid" ? [
+			`# 🔭 Callidescope depth — \`${e.address}\``,
+			"",
+			"## Above",
+			"",
+			this.mermaidReportService.renderStacks({ stacks: e.upward.stacks }),
+			"",
+			"## Below",
+			"",
+			this.mermaidReportService.renderStacks({ stacks: e.downward.stacks })
+		].join("\n") : [
+			`# 🔭 Callidescope depth — \`${e.address}\``,
+			"",
+			this.renderDepthStacks({
+				heading: "Above",
+				stacks: e.upward.stacks,
+				truncated: e.upward.truncated
+			}),
+			"",
+			this.renderDepthStacks({
+				heading: "Below",
+				stacks: e.downward.stacks,
+				truncated: e.downward.truncated
+			})
+		].join("\n");
+	}
+	renderDepthReports(e) {
+		return e.format === "json" ? `${JSON.stringify(e.reports.map((e) => this.buildDepthPayload(e)), null, a)}\n` : e.reports.map((t) => this.renderDepth({
+			...t,
+			format: e.format
+		})).join("\n\n");
+	}
+};
+F = k([n(), O("design:paramtypes", [A === void 0 ? Object : A, j === void 0 ? Object : j])], F);
+//#endregion
+//#region packages/ic-suite/callidescope/callidescope-output/src/modules/address-report/address-report.module.ts
+var I = class {};
+I = k([r({
+	controllers: [],
+	exports: [F],
+	imports: [P],
+	providers: [F]
+})], I);
+//#endregion
+//#region packages/logger/src/modules/logger/logger.constants.ts
+var be = /^(\p{Extended_Pictographic}️?(?:‍\p{Extended_Pictographic}️?)*)\s+/u, xe = /^([A-Za-z]+)/, Se = /* @__PURE__ */ new Set([
+	"built",
+	"cut",
+	"found",
+	"got",
+	"kept",
+	"left",
+	"lost",
+	"made",
+	"put",
+	"ran",
+	"read",
+	"rebuilt",
+	"sent",
+	"set",
+	"split",
+	"took",
+	"wrote"
+]), Ce = /* @__PURE__ */ new Set([
+	"CommandFactory",
+	"ExceptionHandler",
+	"GraphQLModule",
+	"InstanceLoader",
+	"NestApplication",
+	"NestFactory",
+	"RouterExplorer",
+	"RoutesResolver",
+	"TypeOrmModule"
+]), L, R = class extends e {
+	static {
+		L = this;
+	}
+	constructor() {
+		super();
+	}
+	static isProduction = process.env.NODE_ENV === "production";
+	static rootLogger;
+	static writesToStandardError = !1;
+	child = L.root;
+	static createRootLogger() {
+		let e = process.env.LOG_LEVEL ?? "info";
+		return L.isProduction ? L.writesToStandardError ? d({ level: e }, d.destination(2)) : d({ level: e }) : d({
+			level: e,
+			transport: {
+				options: {
+					colorize: !0,
+					destination: L.writesToStandardError ? 2 : 1,
+					ignore: "pid,hostname,emoji",
+					messageFormat: "{emoji} {msg}",
+					singleLine: !0
+				},
+				target: "pino-pretty"
+			}
+		});
+	}
+	static logToStandardError() {
+		if (L.rootLogger !== void 0) {
+			process.emitWarning("LoggerService.logToStandardError() was called after the first log line, so log lines still go to standard output and anything piping that stream will read them as data. Call it as the first statement of the application's bootstrap.");
+			return;
+		}
+		L.writesToStandardError = !0;
+	}
+	assertConventionalMessage(e) {
+		if (L.isProduction || this.shouldSkipConventionalMessageValidation(e.context)) return;
+		let t = this.getConventionalMessageViolation(e.parsed);
+		if (t !== void 0) throw Error(t);
+	}
+	buildBindings(e) {
+		return this.assertConventionalMessage({
+			context: e.context,
+			parsed: e.parsed
+		}), {
+			...e.data,
+			context: e.context,
+			...L.isProduction ? {} : { emoji: e.parsed.emoji }
+		};
+	}
+	getConventionalMessageViolation(e) {
+		let t = e.emoji, n = e.text;
+		if (t === void 0) return `Log message must start with an emoji naming its subject, then a verb: "${n}"`;
+		let r = xe.exec(n)?.[1];
+		if (r === void 0 || !this.isConventionalVerb(r)) return `Log message must begin with a verb in present progressive or past tense, got "${r ?? ""}": "${t} ${n}"`;
+	}
+	isConventionalVerb(e) {
+		let t = e.toLowerCase();
+		return t.endsWith("ing") || t.endsWith("ed") || Se.has(t);
+	}
+	parseMessage(e) {
+		let t = String(e), n = be.exec(t), r = n?.[1];
+		return r === void 0 ? {
+			emoji: void 0,
+			text: t
+		} : {
+			emoji: r,
+			text: t.slice(n?.[0].length)
+		};
+	}
+	shouldSkipConventionalMessageValidation(e) {
+		return e !== void 0 && Ce.has(e);
+	}
+	static get root() {
+		return L.rootLogger ??= L.createRootLogger(), L.rootLogger;
+	}
+	buildErrorLogEntry(e, t) {
+		let n = t instanceof Error ? t.stack || t.message : String(t);
+		return {
+			errorMessage: n,
+			logLine: `[${(/* @__PURE__ */ new Date()).toISOString()}] ${e}: ${n}\n`
+		};
+	}
+	createTimestampedOutputLogFilePath(e) {
+		let t = u.join(process.cwd(), "output");
+		return o(t) || s(t, { recursive: !0 }), u.join(t, `${e}-${(/* @__PURE__ */ new Date()).toISOString().replaceAll(/[:.]/g, "-")}.log`);
+	}
+	debug(e, t, n) {
+		let r = this.parseMessage(e);
+		this.child.debug(this.buildBindings({
+			context: t ?? this.context,
+			data: n,
+			parsed: r
+		}), r.text);
+	}
+	error(e, t, n) {
+		let r = this.parseMessage(e), i = typeof n == "object" ? n : void 0, a = typeof n == "string" ? n : this.context;
+		this.child.error({
+			...this.buildBindings({
+				context: a,
+				data: i,
+				parsed: r
+			}),
+			stack: t
+		}, r.text);
+	}
+	info(e, t, n) {
+		let r = this.parseMessage(e);
+		this.child.info(this.buildBindings({
+			context: t ?? this.context,
+			data: n,
+			parsed: r
+		}), r.text);
+	}
+	log(e, t, n) {
+		this.info(e, t, n);
+	}
+	setContext(e) {
+		super.setContext(e), this.child = L.root.child({ context: e });
+	}
+	verbose(e, t, n) {
+		let r = this.parseMessage(e);
+		this.child.trace(this.buildBindings({
+			context: t ?? this.context,
+			data: n,
+			parsed: r
+		}), r.text);
+	}
+	warn(e, t, n) {
+		let r = this.parseMessage(e);
+		this.child.warn(this.buildBindings({
+			context: t ?? this.context,
+			data: n,
+			parsed: r
+		}), r.text);
+	}
+};
+R = L = k([n({ scope: i.TRANSIENT }), O("design:paramtypes", [])], R);
+//#endregion
+//#region packages/logger/src/modules/logger/logger.module.ts
+var z = class {};
+z = k([t(), r({
+	controllers: [],
+	exports: [R],
+	imports: [],
+	providers: [R]
+})], z);
+//#endregion
+//#region packages/ic-suite/callidescope/callidescope-output/src/modules/output-json/output-json.service.ts
+var B, V = B = class {
+	logger;
+	constructor(e) {
+		this.logger = e, this.logger.setContext(B.name);
+	}
+	readExisting(e) {
+		try {
+			return c(u.resolve(e), "utf8");
+		} catch {
+			return "";
+		}
+	}
+	buildReport(e) {
+		return `${JSON.stringify(e.result, null, e.destination.indentation)}\n`;
+	}
+	sync(e) {
+		let t = u.resolve(e.destination.path), n = this.buildReport(e);
+		return e.check ? this.readExisting(e.destination.path) === n : (s(u.dirname(t), { recursive: !0 }), l(t, n, "utf8"), this.logger.info("🔭 Wrote a report", void 0, { path: t }), !0);
+	}
+};
+V = B = k([n(), O("design:paramtypes", [R === void 0 ? Object : R])], V);
+//#endregion
+//#region packages/ic-suite/callidescope/callidescope-output/src/modules/output-json/output-json.module.ts
+var H = class {};
+H = k([r({
+	controllers: [],
+	exports: [V],
+	imports: [z],
+	providers: [V]
+})], H);
+//#endregion
+//#region packages/ic-suite/callidescope/callidescope-output/src/modules/output-markdown/output-markdown.constants.ts
+var U = /<!--\s*(?:[A-Za-z0-9_-]+:start|[A-Z0-9_]+_START)\b/i, we = class extends Error {
+	constructor() {
+		super("No markdown path to write to. Set write.markdown.path, pass --markdown, or give syncAnchoredBlock a path of its own."), this.name = "MissingMarkdownPathError";
+	}
+}, W, G = W = class {
+	logger;
+	constructor(e) {
+		this.logger = e, this.logger.setContext(W.name);
+	}
+	appendBlock(e) {
+		let t = e.existing.trimEnd();
+		return `${t.length === 0 ? "" : `${t}\n\n`}${e.generated}\n`;
+	}
+	buildBlockPattern(e) {
+		return new RegExp(String.raw`${this.escapePattern(e.startMarker)}[\s\S]*?${this.escapePattern(e.endMarker)}`);
+	}
+	escapePattern(e) {
+		return e.replaceAll(/[.*+?^${}()|[\]\\]/g, String.raw`\$&`);
+	}
+	readExisting(e) {
+		try {
+			return c(e, "utf8");
+		} catch {
+			return "";
+		}
+	}
+	replaceOrphanedBlock(e) {
+		let t = e.startIndex + e.startMarker.length, n = U.exec(e.existing.slice(t)), r = n === null ? e.existing.length : t + n.index, i = e.existing.slice(0, e.startIndex).trimEnd(), a = e.existing.slice(r).trim(), o = i.length === 0 ? "" : `${i}\n\n`;
+		return a.length === 0 ? `${o}${e.generated}\n` : `${o}${e.generated}\n\n${a}\n`;
+	}
+	spliceBlock(e) {
+		if (e.pattern.test(e.existing)) return e.existing.replace(e.pattern, () => e.generated);
+		let t = e.existing.indexOf(e.destination.startMarker);
+		return t === -1 ? this.appendBlock({
+			existing: e.existing,
+			generated: e.generated
+		}) : this.replaceOrphanedBlock({
+			existing: e.existing,
+			generated: e.generated,
+			startIndex: t,
+			startMarker: e.destination.startMarker
+		});
+	}
+	buildHelpers(e) {
+		let { content: t } = e;
+		return {
+			endMarker: e.destination.endMarker,
+			startMarker: e.destination.startMarker,
+			syncAnchoredBlock: (n) => this.syncAnchoredBlock({
+				check: e.check,
+				content: n?.content ?? t,
+				destination: e.destination,
+				path: n?.path
+			}),
+			wrapInAnchors: (n) => this.wrapInAnchors({
+				content: n ?? t,
+				destination: e.destination
+			})
+		};
+	}
+	sync(e) {
+		let { content: t } = e, n = e.destination.writeBlock;
+		return n === void 0 ? this.syncAnchoredBlock({
+			check: e.check,
+			content: t,
+			destination: e.destination,
+			path: e.destination.path
+		}) : n({
+			check: e.check,
+			content: t,
+			helpers: this.buildHelpers(e),
+			path: e.destination.path,
+			result: e.result
+		});
+	}
+	syncAnchoredBlock(e) {
+		let t = e.path ?? e.destination.path;
+		if (t.length === 0) throw new we();
+		let n = u.resolve(t), r = this.readExisting(n), i = this.wrapInAnchors(e), a = this.buildBlockPattern(e.destination);
+		if (e.check) return a.exec(r)?.[0] === i;
+		let o = this.spliceBlock({
+			destination: e.destination,
+			existing: r,
+			generated: i,
+			pattern: a
+		});
+		return l(n, o, "utf8"), this.logger.info("🔭 Wrote a report", void 0, { path: n }), !0;
+	}
+	wrapInAnchors(e) {
+		return `${e.destination.startMarker}\n\n${e.content}\n${e.destination.endMarker}`;
+	}
+};
+G = W = k([n(), O("design:paramtypes", [R === void 0 ? Object : R])], G);
+//#endregion
+//#region packages/ic-suite/callidescope/callidescope-output/src/modules/output-markdown/output-markdown.module.ts
+var K = class {};
+K = k([r({
+	controllers: [],
+	exports: [G],
+	imports: [z],
+	providers: [G]
+})], K);
+//#endregion
+//#region packages/ic-suite/callidescope/callidescope-output/src/modules/project-reports/project-reports.constants.ts
+var Te = 2, q = class {
+	pathsService;
+	signaturesService;
+	constructor(e, t) {
+		this.pathsService = e, this.signaturesService = t;
+	}
+	buildCallableBreadths(e) {
+		let t = /* @__PURE__ */ new Map();
+		for (let [n, r] of e.callablesById) {
+			let i = e.breadthMeasurement.byCallable.get(n);
+			if (i === void 0 || i.breadth === 0) continue;
+			let a = i.calleeIds.flatMap((t) => {
+				let n = e.callablesById.get(t);
+				return n === void 0 ? [] : [{
+					displayName: n.node.displayName,
+					id: t
+				}];
+			}), o = t.get(r.node.projectName) ?? [];
+			o.push({
+				breadth: i.breadth,
+				callees: a,
+				displayName: r.node.displayName,
+				id: n,
+				location: r.node.location,
+				signature: this.signaturesService.read({
+					checker: r.projectProgram.checker,
+					declaration: r.declaration
+				})
+			}), t.set(r.node.projectName, o);
+		}
+		return t;
+	}
+	buildStacks(e) {
+		let t = /* @__PURE__ */ new Map();
+		for (let n of e.entryPoints.entryPoints) {
+			let r = e.callablesById.get(n.callableId), i = r === void 0 ? void 0 : this.readDepth({
+				callableId: n.callableId,
+				condensed: e.condensed,
+				measurement: e.measurement
+			});
+			if (r === void 0 || i === void 0) continue;
+			let a = this.pathsService.buildDeepestPath({
+				callablesById: e.callablesById,
+				condensed: e.condensed,
+				entryPointId: n.callableId,
+				measurement: e.measurement
+			});
+			if (a.length < 2) continue;
+			let o = t.get(r.node.projectName) ?? [];
+			o.push({
+				depth: i.depth,
+				entryPointKind: n.kind,
+				frames: a,
+				isLowerBound: i.reachesUnresolved
+			}), t.set(r.node.projectName, o);
+		}
+		return t;
+	}
+	buildSummary(e) {
+		let t = /* @__PURE__ */ new Set();
+		for (let [n, r] of e.callablesById) r.node.projectName === e.projectName && t.add(n);
+		return {
+			callableCount: t.size,
+			cyclicComponentCount: e.stacks.filter((e) => e.frames.some((e) => e.isCycle)).length,
+			edgeCount: e.graph.edges.filter((e) => t.has(e.callerId)).length,
+			entryPointCount: e.stacks.length,
+			fileCount: e.fileCount,
+			maximumDepth: e.stacks.reduce((e, t) => Math.max(e, t.depth), 0),
+			projectCount: 1,
+			unresolvedCallCount: e.graph.unresolvedCalls.filter((e) => t.has(e.callerId)).length
+		};
+	}
+	findProjectDeepStacks(e) {
+		return e.report.stacks.filter((t) => t.depth > e.limit).map((t) => ({
+			...t,
+			limit: e.limit
+		}));
+	}
+	findProjectWideCallables(e) {
+		return e.report.callableBreadths.filter((t) => t.breadth > e.limit).map((t) => ({
+			...t,
+			limit: e.limit
+		}));
+	}
+	readDepth(e) {
+		let t = e.condensed.componentIdByCallable.get(e.callableId);
+		if (t === void 0) return;
+		let n = e.measurement.byComponent[t];
+		return n === void 0 ? void 0 : {
+			depth: n.depth,
+			reachesUnresolved: n.reachesUnresolved
+		};
+	}
+	readProjectLimits(e) {
+		return e.limits.byProject.get(e.projectName) ?? e.limits.workspace;
+	}
+	build(e) {
+		let t = this.buildStacks(e), n = this.buildCallableBreadths(e);
+		return e.projectNames.map((r) => {
+			let i = (t.get(r) ?? []).toSorted((e, t) => t.depth - e.depth);
+			return {
+				callableBreadths: (n.get(r) ?? []).toSorted((e, t) => t.breadth - e.breadth),
+				projectName: r,
+				stacks: i,
+				summary: this.buildSummary({
+					callablesById: e.callablesById,
+					fileCount: e.fileCountByProject.get(r) ?? 0,
+					graph: e.graph,
+					projectName: r,
+					stacks: i
+				})
+			};
+		});
+	}
+	findDeepStacks(e) {
+		return e.reports.flatMap((t) => this.findProjectDeepStacks({
+			limit: this.readProjectLimits({
+				limits: e.limits,
+				projectName: t.projectName
+			}).maximumDepth,
+			report: t
+		})).toSorted((e, t) => t.depth - e.depth);
+	}
+	findOwnedFindings(e) {
+		let t = e.reports.filter((t) => e.projectNames.includes(t.projectName));
+		return {
+			deepStacks: this.findDeepStacks({
+				limits: e.limits,
+				reports: t
+			}),
+			wideCallables: this.findWideCallables({
+				limits: e.limits,
+				reports: t
+			})
+		};
+	}
+	findUnreadProjects(e) {
+		return e.projectNames.filter((t) => (e.reports.find((e) => e.projectName === t)?.summary.fileCount ?? 0) === 0);
+	}
+	findWideCallables(e) {
+		return e.reports.flatMap((t) => this.findProjectWideCallables({
+			limit: this.readProjectLimits({
+				limits: e.limits,
+				projectName: t.projectName
+			}).maximumBreadth ?? Infinity,
+			report: t
+		})).toSorted((e, t) => t.breadth - e.breadth);
+	}
+};
+q = k([n(), O("design:paramtypes", [f === void 0 ? Object : f, p === void 0 ? Object : p])], q);
+//#endregion
+//#region packages/ic-suite/callidescope/callidescope-output/src/modules/project-reports/project-reports.module.ts
+var J = class {};
+J = k([r({
+	controllers: [],
+	exports: [q],
+	imports: [ee, te],
+	providers: [q]
+})], J);
+//#endregion
+//#region packages/ic-suite/callidescope/callidescope-output/src/modules/report-findings/report-findings.service.ts
+var Y = class {
+	logger;
+	constructor(e) {
+		this.logger = e;
+	}
+	reportDeepStacks(e) {
+		let { deepStacks: t } = e.result;
+		return t.length !== 0 && (this.logger.error("🔭 Found call stacks too deep", void 0, {
+			count: t.length,
+			deepest: Math.max(...t.map((e) => e.depth)),
+			entryPoints: t.map((e) => e.frames[0]?.displayName)
+		}), e.mode.checksDepth);
+	}
+	reportEmptyTrace(e) {
+		return e.result.summary.callableCount > 0 ? !1 : (this.logger.error("🔭 Traced nothing", void 0, { projectCount: e.result.summary.projectCount }), !0);
+	}
+	reportStaleness(e) {
+		return e.stalePaths.length !== 0 && (this.logger.error("🔭 Found stale reports", void 0, { paths: e.stalePaths }), !0);
+	}
+	reportWideCallables(e) {
+		let { wideCallables: t } = e.result;
+		return t.length !== 0 && (this.logger.error("🔭 Found callables calling too much directly", void 0, {
+			callables: t.map((e) => e.displayName),
+			count: t.length,
+			widest: Math.max(...t.map((e) => e.breadth))
+		}), e.mode.checksBreadth);
+	}
+	reportFindings(e) {
+		let t = this.reportStaleness(e), n = this.reportDeepStacks(e), r = this.reportWideCallables(e), i = this.reportEmptyTrace(e);
+		(n || i || t || r) && (process.exitCode = 1);
+	}
+};
+Y = k([n(), O("design:paramtypes", [R === void 0 ? Object : R])], Y);
+//#endregion
+//#region packages/ic-suite/callidescope/callidescope-output/src/modules/report-findings/report-findings.module.ts
+var X = class {};
+X = k([r({
+	controllers: [],
+	exports: [Y],
+	imports: [z],
+	providers: [Y]
+})], X);
+//#endregion
+//#region packages/ic-suite/callidescope/callidescope-output/src/modules/write-destinations/write-destinations.constants.ts
+var Z = [["markdown", "tree"], ["mermaid", "diagram"]], Q = class {
+	markdownReportService;
+	outputJsonService;
+	outputMarkdownService;
+	constructor(e, t, n) {
+		this.markdownReportService = e, this.outputJsonService = t, this.outputMarkdownService = n;
+	}
+	syncProjectDestinations(e) {
+		let t = [];
+		for (let n of e.result.projects) {
+			let r = e.startingProjectRoots.get(n.projectName), i = e.writeByProject.get(n.projectName);
+			r !== void 0 && i !== void 0 && t.push(...this.syncProjectSections({
+				check: e.check,
+				projectLimits: e.projectLimits,
+				report: n,
+				result: e.result,
+				root: r,
+				write: i
+			}));
+		}
+		return t;
+	}
+	syncProjectSections(e) {
+		let t = [];
+		for (let [n, r] of Z) {
+			let i = e.write[n];
+			if (i === void 0) continue;
+			let a = {
+				...i,
+				path: u.join(e.root, i.path)
+			};
+			this.outputMarkdownService.sync({
+				check: e.check,
+				content: this.markdownReportService.renderProjectSection({
+					heading: i.heading,
+					limits: e.projectLimits,
+					previewCount: i.previewCount,
+					rendering: r,
+					report: e.report
+				}),
+				destination: a,
+				result: e.result
+			}) || t.push(a.path);
+		}
+		return t;
+	}
+	syncDestinations(e) {
+		let t = [], { json: n } = e.configuration.write;
+		n !== void 0 && !this.outputJsonService.sync({
+			check: e.check,
+			destination: n,
+			result: e.result
+		}) && t.push(n.path);
+		for (let [n, r] of Z) {
+			let i = e.configuration.write[n];
+			i !== void 0 && !this.outputMarkdownService.sync({
+				check: e.check,
+				content: this.markdownReportService.renderRun({
+					description: i.description,
+					heading: i.heading,
+					limits: e.projectLimits,
+					previewCount: i.previewCount,
+					rendering: r,
+					result: e.result
+				}),
+				destination: i,
+				result: e.result
+			}) && t.push(i.path);
+		}
+		return t.push(...this.syncProjectDestinations(e)), t;
+	}
+};
+Q = k([n(), O("design:paramtypes", [
+	N === void 0 ? Object : N,
+	V === void 0 ? Object : V,
+	G === void 0 ? Object : G
+])], Q);
+//#endregion
+//#region packages/ic-suite/callidescope/callidescope-output/src/modules/write-destinations/write-destinations.module.ts
+var $ = class {};
+$ = k([r({
+	controllers: [],
+	exports: [Q],
+	imports: [
+		H,
+		K,
+		P
+	],
+	providers: [Q]
+})], $);
+//#endregion
+export { I as AddressReportModule, F as AddressReportService, g as COLLAPSED_PARAMETERS, ae as DEPRECATED_MARKER, le as DIAGRAM_NODE_PREFIX, m as ENTRY_FRAME_PREFIX, U as FOREIGN_ANCHOR_PATTERN, w as HEADROOM_BUCKET_AT_LIMIT, ye as HEADROOM_BUCKET_FOUR_PLUS, ve as HEADROOM_BUCKET_ONE, D as HEADROOM_BUCKET_ORDER, C as HEADROOM_BUCKET_OVER_LIMIT, T as HEADROOM_BUCKET_TWO_TO_THREE, E as HEADROOM_BUCKET_UNMEASURED, b as MARKDOWN_DEEP_STACKS_HEADING, Z as MARKDOWN_DESTINATION_RENDERINGS, S as MARKDOWN_HEADROOM_HEADER, fe as MARKDOWN_PROJECT_INDEX_HEADER, v as MARKDOWN_SUMMARY_HEADER, y as MARKDOWN_WIDE_CALLABLES_HEADER, x as MARKDOWN_WIDE_CALLABLES_HEADING, ce as MAXIMUM_DIAGRAM_NODES, se as MERMAID_FLOWCHART_HEADER, ue as MERMAID_LABEL_ESCAPES, Te as MINIMUM_STACK_FRAMES, N as MarkdownReportService, A as MermaidReportService, we as MissingMarkdownPathError, h as NESTED_FRAME_PREFIX, H as OutputJsonModule, V as OutputJsonService, K as OutputMarkdownModule, G as OutputMarkdownService, J as ProjectReportsModule, q as ProjectReportsService, de as ROOT_PROJECT_LABEL, X as ReportFindingsModule, Y as ReportFindingsService, P as ReportModule, j as ReportService, _ as SENTENCE_END_PATTERN, ne as SIGNATURE_LIMIT, re as SUMMARY_LIMIT, oe as SUMMARY_PREFIX, ie as TRUNCATION_SUFFIX, M as WorkspaceReportService, $ as WriteDestinationsModule, Q as WriteDestinationsService };