cohorte 3.0.0-dev.0 → 3.0.0-dev.2

package/dist/chunks/scan-8Gy_B6kI.mjs

@@ -0,0 +1,122 @@
+import { readFile, readdir } from "node:fs/promises";
+import { join, relative } from "node:path";
+//#region ../../packages/project-model/src/scan/index.ts
+async function filesUnder(root) {
+	const found = [];
+	const visit = async (dir) => {
+		try {
+			const entries = await readdir(dir, { withFileTypes: true });
+			for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
+				if (entry.name === ".git" || entry.name === "node_modules" || entry.name === ".cohorte" || entry.name === ".pi" || entry.name === ".build" || entry.name === "dist" || entry.name === "coverage") continue;
+				const path = join(dir, entry.name);
+				if (entry.isDirectory()) await visit(path);
+				else if (entry.isFile()) found.push(relative(root, path).split("\\").join("/"));
+			}
+		} catch {
+			return;
+		}
+	};
+	await visit(root);
+	return found.sort();
+}
+function field(value, detector, sources, className = "observed") {
+	return {
+		value,
+		class: className,
+		provenance: {
+			detector,
+			sources
+		}
+	};
+}
+async function scanRepository(root, options) {
+	const files = await filesUnder(root);
+	const packagePath = join(root, "package.json");
+	let pkg = {};
+	try {
+		pkg = JSON.parse(await readFile(packagePath, "utf8"));
+	} catch {}
+	const ext = /* @__PURE__ */ new Map([
+		[".ts", "typescript"],
+		[".tsx", "typescript"],
+		[".js", "javascript"],
+		[".jsx", "javascript"],
+		[".py", "python"],
+		[".go", "go"],
+		[".rs", "rust"],
+		[".java", "java"]
+	]);
+	const languages = [...new Set(files.map((file) => ext.get(file.slice(file.lastIndexOf(".")))).filter((value) => value !== void 0))].sort();
+	const supportedLocks = [
+		"pnpm-lock.yaml",
+		"package-lock.json",
+		"yarn.lock",
+		"bun.lockb"
+	];
+	const locks = files.filter((file) => supportedLocks.includes(file));
+	const lock = locks.length === 1 ? locks[0] : void 0;
+	const packageManager = lock === void 0 ? pkg.packageManager?.split("@")[0] ?? null : lock === "pnpm-lock.yaml" ? "pnpm" : lock === "package-lock.json" ? "npm" : lock === "yarn.lock" ? "yarn" : "bun";
+	const deps = {
+		...pkg.dependencies ?? {},
+		...pkg.devDependencies ?? {}
+	};
+	const frameworks = Object.keys(deps).filter((name) => /^(react|vue|angular|svelte|next|nuxt|express|nestjs|fastify|vite|vitest|jest|playwright)/i.test(name)).sort();
+	const scripts = pkg.scripts ?? {};
+	const commands = {};
+	for (const name of Object.keys(scripts).sort()) {
+		const command = scripts[name];
+		if (command !== void 0) commands[name] = field(command.split(/\s+/u), "package-json", ["package.json"]);
+	}
+	const testLocations = files.filter((file) => /(^|\/)(test|tests|__tests__)(\/|$)|\.(test|spec)\./u.test(file));
+	const surfaces = {};
+	const topLevel = [...new Set(files.map((file) => file.split("/")[0]).filter((name) => Boolean(name && !name.startsWith("."))))];
+	for (const name of topLevel.sort()) {
+		const paths = files.filter((file) => file === name || file.startsWith(`${name}/`));
+		if (paths.length) surfaces[name.replace(/[^A-Za-z0-9_.-]/g, "_")] = { paths: field([`${name}/**`], "workspace-layout", paths) };
+	}
+	const id = pkg.name?.replace(/^@[^/]+\//u, "") ?? (relative(process.cwd(), root).replace(/[^A-Za-z0-9_.-]/g, "_") || "project");
+	const unknowns = locks.length > 1 ? [{
+		id: "package-manager",
+		question: "more than one supported lockfile was detected; which package manager is authoritative?",
+		candidates: [...locks].sort(),
+		sources: [...locks].sort()
+	}] : [];
+	return {
+		schemaVersion: 1,
+		project: {
+			id: field(id, "package-json", ["package.json"], "human"),
+			root: field(root, "filesystem", [])
+		},
+		stack: {
+			languages: field(languages, "file-extensions", files),
+			packageManager: field(packageManager, "lockfile", lock ? [lock] : []),
+			frameworks: field(frameworks, "package-json", ["package.json"])
+		},
+		surfaces,
+		commands,
+		testStrategy: field({
+			runner: scripts.test ? scripts.test.split(/\s+/u)[0] ?? null : null,
+			locations: testLocations
+		}, "package-json", ["package.json"]),
+		deploymentHints: field(files.filter((file) => /(^|\/)(Dockerfile|Procfile|vercel\.json|fly\.toml)$/u.test(file)), "file-presence", files),
+		ownership: field({ codeowners: files.includes(".github/CODEOWNERS") ? ".github/CODEOWNERS" : null }, "file-presence", [".github/CODEOWNERS"]),
+		risks: packageManager === null ? [{
+			id: "missing-lockfile",
+			severity: "medium",
+			message: "no supported lockfile was detected",
+			sources: []
+		}] : [],
+		conventions: field(files.filter((file) => /(^|\/)(CONTRIBUTING|conventions)\.(md|yaml)$/iu.test(file)), "file-presence", files),
+		generatedArtifacts: field(["manifest.yaml", "project.yaml"], "manifest", [".cohorte/manifest.yaml"]),
+		unknowns,
+		provenance: {
+			generatedAt: options.clock.now(),
+			toolVersion: options.toolVersion,
+			analysis: "deterministic"
+		}
+	};
+}
+//#endregion
+export { scanRepository as t };
+
+//# sourceMappingURL=scan-8Gy_B6kI.mjs.map

package/dist/chunks/scan-8Gy_B6kI.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-8Gy_B6kI.mjs","names":[],"sources":["../../../../packages/project-model/src/scan/index.ts"],"sourcesContent":["// Deterministic repository scan: bounded filesystem observations, never guessed semantics.\n\nimport { readdir, readFile } from 'node:fs/promises';\nimport { join, relative } from 'node:path';\nimport type { Clock } from '@cohorte/base';\nimport type { ProjectModel } from '../contract.ts';\n\nexport interface ScanOptions {\n  clock: Clock;\n  /** stamped into `provenance.toolVersion` */\n  toolVersion: string;\n}\n\nasync function filesUnder(root: string): Promise<string[]> {\n  const found: string[] = [];\n  const visit = async (dir: string): Promise<void> => {\n    try {\n      const entries = await readdir(dir, { withFileTypes: true });\n      for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {\n        if (\n          entry.name === '.git' ||\n          entry.name === 'node_modules' ||\n          entry.name === '.cohorte' ||\n          entry.name === '.pi' ||\n          entry.name === '.build' ||\n          entry.name === 'dist' ||\n          entry.name === 'coverage'\n        )\n          continue;\n        const path = join(dir, entry.name);\n        if (entry.isDirectory()) await visit(path);\n        else if (entry.isFile()) found.push(relative(root, path).split('\\\\').join('/'));\n      }\n    } catch {\n      return;\n    }\n  };\n  await visit(root);\n  return found.sort();\n}\n\nfunction field<T>(\n  value: T,\n  detector: string,\n  sources: string[],\n  className: ProjectModel['project']['id']['class'] = 'observed',\n) {\n  return { value, class: className, provenance: { detector, sources } };\n}\n\nexport async function scanRepository(root: string, options: ScanOptions): Promise<ProjectModel> {\n  const files = await filesUnder(root);\n  const packagePath = join(root, 'package.json');\n  let pkg: {\n    name?: string;\n    packageManager?: string;\n    scripts?: Record<string, string>;\n    dependencies?: Record<string, string>;\n    devDependencies?: Record<string, string>;\n  } = {};\n  try {\n    pkg = JSON.parse(await readFile(packagePath, 'utf8')) as typeof pkg;\n  } catch {\n    /* absent or invalid package.json is an observation */\n  }\n  const ext = new Map<string, string>([\n    ['.ts', 'typescript'],\n    ['.tsx', 'typescript'],\n    ['.js', 'javascript'],\n    ['.jsx', 'javascript'],\n    ['.py', 'python'],\n    ['.go', 'go'],\n    ['.rs', 'rust'],\n    ['.java', 'java'],\n  ]);\n  const languages = [\n    ...new Set(\n      files\n        .map((file) => ext.get(file.slice(file.lastIndexOf('.'))))\n        .filter((value): value is string => value !== undefined),\n    ),\n  ].sort();\n  const supportedLocks = ['pnpm-lock.yaml', 'package-lock.json', 'yarn.lock', 'bun.lockb'];\n  const locks = files.filter((file) => supportedLocks.includes(file));\n  const lock = locks.length === 1 ? locks[0] : undefined;\n  const packageManager =\n    lock === undefined\n      ? (pkg.packageManager?.split('@')[0] ?? null)\n      : lock === 'pnpm-lock.yaml'\n        ? 'pnpm'\n        : lock === 'package-lock.json'\n          ? 'npm'\n          : lock === 'yarn.lock'\n            ? 'yarn'\n            : 'bun';\n  const deps = { ...(pkg.dependencies ?? {}), ...(pkg.devDependencies ?? {}) };\n  const frameworks = Object.keys(deps)\n    .filter((name) =>\n      /^(react|vue|angular|svelte|next|nuxt|express|nestjs|fastify|vite|vitest|jest|playwright)/i.test(name),\n    )\n    .sort();\n  const scripts = pkg.scripts ?? {};\n  const commands: Record<string, ReturnType<typeof field<string[]>>> = {};\n  for (const name of Object.keys(scripts).sort()) {\n    const command = scripts[name];\n    if (command !== undefined) commands[name] = field(command.split(/\\s+/u), 'package-json', ['package.json']);\n  }\n  const testLocations = files.filter((file) => /(^|\\/)(test|tests|__tests__)(\\/|$)|\\.(test|spec)\\./u.test(file));\n  const surfaces: ProjectModel['surfaces'] = {};\n  const topLevel: string[] = [\n    ...new Set(\n      files.map((file) => file.split('/')[0]).filter((name): name is string => Boolean(name && !name.startsWith('.'))),\n    ),\n  ];\n  for (const name of topLevel.sort()) {\n    const paths = files.filter((file) => file === name || file.startsWith(`${name}/`));\n    if (paths.length)\n      surfaces[name.replace(/[^A-Za-z0-9_.-]/g, '_')] = { paths: field([`${name}/**`], 'workspace-layout', paths) };\n  }\n  const id =\n    pkg.name?.replace(/^@[^/]+\\//u, '') ??\n    (relative(process.cwd(), root).replace(/[^A-Za-z0-9_.-]/g, '_') || 'project');\n  const unknowns =\n    locks.length > 1\n      ? [\n          {\n            id: 'package-manager',\n            question: 'more than one supported lockfile was detected; which package manager is authoritative?',\n            candidates: [...locks].sort(),\n            sources: [...locks].sort(),\n          },\n        ]\n      : [];\n  return {\n    schemaVersion: 1,\n    project: { id: field(id, 'package-json', ['package.json'], 'human'), root: field(root, 'filesystem', []) },\n    stack: {\n      languages: field(languages, 'file-extensions', files),\n      packageManager: field(packageManager, 'lockfile', lock ? [lock] : []),\n      frameworks: field(frameworks, 'package-json', ['package.json']),\n    },\n    surfaces,\n    commands,\n    testStrategy: field(\n      { runner: scripts.test ? (scripts.test.split(/\\s+/u)[0] ?? null) : null, locations: testLocations },\n      'package-json',\n      ['package.json'],\n    ),\n    deploymentHints: field(\n      files.filter((file) => /(^|\\/)(Dockerfile|Procfile|vercel\\.json|fly\\.toml)$/u.test(file)),\n      'file-presence',\n      files,\n    ),\n    ownership: field(\n      { codeowners: files.includes('.github/CODEOWNERS') ? '.github/CODEOWNERS' : null },\n      'file-presence',\n      ['.github/CODEOWNERS'],\n    ),\n    risks:\n      packageManager === null\n        ? [{ id: 'missing-lockfile', severity: 'medium', message: 'no supported lockfile was detected', sources: [] }]\n        : [],\n    conventions: field(\n      files.filter((file) => /(^|\\/)(CONTRIBUTING|conventions)\\.(md|yaml)$/iu.test(file)),\n      'file-presence',\n      files,\n    ),\n    generatedArtifacts: field(['manifest.yaml', 'project.yaml'], 'manifest', ['.cohorte/manifest.yaml']),\n    unknowns,\n    provenance: { generatedAt: options.clock.now(), toolVersion: options.toolVersion, analysis: 'deterministic' },\n  };\n}\n"],"mappings":";;;AAaA,eAAe,WAAW,MAAiC;CACzD,MAAM,QAAkB,CAAC;CACzB,MAAM,QAAQ,OAAO,QAA+B;EAClD,IAAI;GACF,MAAM,UAAU,MAAM,QAAQ,KAAK,EAAE,eAAe,KAAK,CAAC;GAC1D,KAAK,MAAM,SAAS,QAAQ,MAAM,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,IAAI,CAAC,GAAG;IACxE,IACE,MAAM,SAAS,UACf,MAAM,SAAS,kBACf,MAAM,SAAS,cACf,MAAM,SAAS,SACf,MAAM,SAAS,YACf,MAAM,SAAS,UACf,MAAM,SAAS,YAEf;IACF,MAAM,OAAO,KAAK,KAAK,MAAM,IAAI;IACjC,IAAI,MAAM,YAAY,GAAG,MAAM,MAAM,IAAI;SACpC,IAAI,MAAM,OAAO,GAAG,MAAM,KAAK,SAAS,MAAM,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC;GAChF;EACF,QAAQ;GACN;EACF;CACF;CACA,MAAM,MAAM,IAAI;CAChB,OAAO,MAAM,KAAK;AACpB;AAEA,SAAS,MACP,OACA,UACA,SACA,YAAoD,YACpD;CACA,OAAO;EAAE;EAAO,OAAO;EAAW,YAAY;GAAE;GAAU;EAAQ;CAAE;AACtE;AAEA,eAAsB,eAAe,MAAc,SAA6C;CAC9F,MAAM,QAAQ,MAAM,WAAW,IAAI;CACnC,MAAM,cAAc,KAAK,MAAM,cAAc;CAC7C,IAAI,MAMA,CAAC;CACL,IAAI;EACF,MAAM,KAAK,MAAM,MAAM,SAAS,aAAa,MAAM,CAAC;CACtD,QAAQ,CAER;CACA,MAAM,sBAAM,IAAI,IAAoB;EAClC,CAAC,OAAO,YAAY;EACpB,CAAC,QAAQ,YAAY;EACrB,CAAC,OAAO,YAAY;EACpB,CAAC,QAAQ,YAAY;EACrB,CAAC,OAAO,QAAQ;EAChB,CAAC,OAAO,IAAI;EACZ,CAAC,OAAO,MAAM;EACd,CAAC,SAAS,MAAM;CAClB,CAAC;CACD,MAAM,YAAY,CAChB,GAAG,IAAI,IACL,MACG,KAAK,SAAS,IAAI,IAAI,KAAK,MAAM,KAAK,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,CACzD,QAAQ,UAA2B,UAAU,KAAA,CAAS,CAC3D,CACF,CAAC,CAAC,KAAK;CACP,MAAM,iBAAiB;EAAC;EAAkB;EAAqB;EAAa;CAAW;CACvF,MAAM,QAAQ,MAAM,QAAQ,SAAS,eAAe,SAAS,IAAI,CAAC;CAClE,MAAM,OAAO,MAAM,WAAW,IAAI,MAAM,KAAK,KAAA;CAC7C,MAAM,iBACJ,SAAS,KAAA,IACJ,IAAI,gBAAgB,MAAM,GAAG,CAAC,CAAC,MAAM,OACtC,SAAS,mBACP,SACA,SAAS,sBACP,QACA,SAAS,cACP,SACA;CACZ,MAAM,OAAO;EAAE,GAAI,IAAI,gBAAgB,CAAC;EAAI,GAAI,IAAI,mBAAmB,CAAC;CAAG;CAC3E,MAAM,aAAa,OAAO,KAAK,IAAI,CAAC,CACjC,QAAQ,SACP,4FAA4F,KAAK,IAAI,CACvG,CAAC,CACA,KAAK;CACR,MAAM,UAAU,IAAI,WAAW,CAAC;CAChC,MAAM,WAA+D,CAAC;CACtE,KAAK,MAAM,QAAQ,OAAO,KAAK,OAAO,CAAC,CAAC,KAAK,GAAG;EAC9C,MAAM,UAAU,QAAQ;EACxB,IAAI,YAAY,KAAA,GAAW,SAAS,QAAQ,MAAM,QAAQ,MAAM,MAAM,GAAG,gBAAgB,CAAC,cAAc,CAAC;CAC3G;CACA,MAAM,gBAAgB,MAAM,QAAQ,SAAS,sDAAsD,KAAK,IAAI,CAAC;CAC7G,MAAM,WAAqC,CAAC;CAC5C,MAAM,WAAqB,CACzB,GAAG,IAAI,IACL,MAAM,KAAK,SAAS,KAAK,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,SAAyB,QAAQ,QAAQ,CAAC,KAAK,WAAW,GAAG,CAAC,CAAC,CACjH,CACF;CACA,KAAK,MAAM,QAAQ,SAAS,KAAK,GAAG;EAClC,MAAM,QAAQ,MAAM,QAAQ,SAAS,SAAS,QAAQ,KAAK,WAAW,GAAG,KAAK,EAAE,CAAC;EACjF,IAAI,MAAM,QACR,SAAS,KAAK,QAAQ,oBAAoB,GAAG,KAAK,EAAE,OAAO,MAAM,CAAC,GAAG,KAAK,IAAI,GAAG,oBAAoB,KAAK,EAAE;CAChH;CACA,MAAM,KACJ,IAAI,MAAM,QAAQ,cAAc,EAAE,MACjC,SAAS,QAAQ,IAAI,GAAG,IAAI,CAAC,CAAC,QAAQ,oBAAoB,GAAG,KAAK;CACrE,MAAM,WACJ,MAAM,SAAS,IACX,CACE;EACE,IAAI;EACJ,UAAU;EACV,YAAY,CAAC,GAAG,KAAK,CAAC,CAAC,KAAK;EAC5B,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC,KAAK;CAC3B,CACF,IACA,CAAC;CACP,OAAO;EACL,eAAe;EACf,SAAS;GAAE,IAAI,MAAM,IAAI,gBAAgB,CAAC,cAAc,GAAG,OAAO;GAAG,MAAM,MAAM,MAAM,cAAc,CAAC,CAAC;EAAE;EACzG,OAAO;GACL,WAAW,MAAM,WAAW,mBAAmB,KAAK;GACpD,gBAAgB,MAAM,gBAAgB,YAAY,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC;GACpE,YAAY,MAAM,YAAY,gBAAgB,CAAC,cAAc,CAAC;EAChE;EACA;EACA;EACA,cAAc,MACZ;GAAE,QAAQ,QAAQ,OAAQ,QAAQ,KAAK,MAAM,MAAM,CAAC,CAAC,MAAM,OAAQ;GAAM,WAAW;EAAc,GAClG,gBACA,CAAC,cAAc,CACjB;EACA,iBAAiB,MACf,MAAM,QAAQ,SAAS,uDAAuD,KAAK,IAAI,CAAC,GACxF,iBACA,KACF;EACA,WAAW,MACT,EAAE,YAAY,MAAM,SAAS,oBAAoB,IAAI,uBAAuB,KAAK,GACjF,iBACA,CAAC,oBAAoB,CACvB;EACA,OACE,mBAAmB,OACf,CAAC;GAAE,IAAI;GAAoB,UAAU;GAAU,SAAS;GAAsC,SAAS,CAAC;EAAE,CAAC,IAC3G,CAAC;EACP,aAAa,MACX,MAAM,QAAQ,SAAS,iDAAiD,KAAK,IAAI,CAAC,GAClF,iBACA,KACF;EACA,oBAAoB,MAAM,CAAC,iBAAiB,cAAc,GAAG,YAAY,CAAC,wBAAwB,CAAC;EACnG;EACA,YAAY;GAAE,aAAa,QAAQ,MAAM,IAAI;GAAG,aAAa,QAAQ;GAAa,UAAU;EAAgB;CAC9G;AACF"}