cdalkit 0.1.7 → 0.2.0

package/LICENSE.md

@@ -0,0 +1,14 @@
+# CDAL Free Tools License
+
+Copyright (c) 2026 Michał Sznurowski (CDAL Kit). All rights reserved.
+
+You may use this software free of charge, for any purpose, including
+commercial projects: run the CDAL audit and install CDAL Pro if you hold a
+license. You may not modify, publish, sell, sublicense or redistribute it,
+except as part of a project that depends on it through a package manager.
+
+The software is provided "as is", without warranty of any kind. The full terms
+are at https://cdalkit.tech/legal/terms.
+
+Versions of this package published before this license (0.1.x) remain
+available under the Apache License 2.0 under which they were released.

package/README.md

@@ -1,36 +1,28 @@
-# cdal
+# cdalkit
 
-**Stop AI agents from rewriting your tests.** `cdal` adds hard quality gates to Claude Code, Cursor, Windsurf and Antigravity: contracts as the single source of truth, role-scoped agents that physically can't edit tests (PreToolUse hook, exit 2), requirement-to-test traceability, and mutation tests for the gates themselves.
+CDAL is a ready-made method for building apps with AI agents in Claude Code, Cursor, Windsurf and Antigravity. You describe the idea; the agent plans it with you, asks before it guesses, and builds it step by step with tests it can't fake.
 
-## Free audit in 15 seconds
+This package gives you two things.
+
+## The free audit
 
 ```bash
 npx cdalkit audit
 ```
 
-Runs 100% offline — no code leaves your machine — and scores your repository 0–100 across 8 AI-hygiene checks: agent configuration and hooks, type silencing (`@ts-ignore`, `as any`), skipped tests, agents grading themselves, requirement traceability, CI gates, secret leaks and generated-file drift. Add `--html report.html` for a standalone report.
+Scans your repository offline in about 15 seconds and scores how safely AI agents work in it (0–100), with concrete fixes. Your code never leaves your machine.
+
+## The CDAL Pro installer
 
-## Set up the gates
+After buying CDAL Pro at [cdalkit.tech](https://cdalkit.tech/pricing), run this in your project. An empty folder works too:
 
 ```bash
-npx cdalkit init      # config, starter contracts, agent roles and hooks
-npx cdalkit verify    # the full deterministic gate: validate, codegen --check, typecheck, lint, test, trace, selftest
+npx cdalkit pro install          # CDAL Pro Solo
+npx cdalkit pro install --team   # CDAL Pro Team
 ```
 
-| Command | What it does |
-|---|---|
-| `cdal validate` | Check contract invariants |
-| `cdal codegen` | Generate TypeScript types and docs from contracts (`--check` for drift) |
-| `cdal trace --enforce` | Fail unless every requirement has a test tagged `// @REQ: <ID>` |
-| `cdal selftest` | Mutation-test the gates: every rule must fire red |
-| `cdal phase` | Check the git diff against the current loop phase (contract, red, green) |
-| `cdal sync` | Generate agent roles, commands and hooks for each runtime |
-| `cdal doctor` | Diagnose installation and hook wiring |
-
-## Links
+It downloads CDAL from the private repository you got access to, installs it into the project (`.cdal/vendor/`), sets it up and connects it to your editor. Commit the result so your teammates get the same setup.
 
-- Website and docs: https://cdalkit.tech
-- Getting started: https://cdalkit.tech/docs/getting-started
-- CLI reference: https://cdalkit.tech/docs/cli-reference
+Questions: contact@cdalkit.tech
 
-Apache-2.0 © Michał Sznurowski
+License: CDAL Free Tools License (see LICENSE.md). Versions 0.1.x were published under Apache-2.0.

package/dist/chunk-22BBUYVB.js

@@ -0,0 +1,132 @@
+// src/bootstrap.ts
+import { execFileSync } from "child_process";
+import {
+  copyFileSync,
+  existsSync,
+  mkdirSync,
+  mkdtempSync,
+  readFileSync,
+  readdirSync,
+  rmSync,
+  writeFileSync
+} from "fs";
+import { tmpdir } from "os";
+import { basename, join, resolve } from "path";
+var PRO_REPOSITORY_URL = "https://github.com/cdalkit/cdal-pro.git";
+var VENDOR_DIR = ".cdal/vendor";
+var BootstrapError = class extends Error {
+};
+var defaultExec = (command, args, cwd) => {
+  execFileSync(command, args, { cwd, stdio: "inherit" });
+};
+function readVendorManifest(sourceDir) {
+  const file = join(sourceDir, "vendor/manifest.json");
+  if (!existsSync(file)) {
+    throw new BootstrapError(
+      `${file} not found. This copy of CDAL Pro does not include the CDAL core; update it or contact contact@cdalkit.tech.`
+    );
+  }
+  const manifest = JSON.parse(readFileSync(file, "utf8"));
+  for (const tarball of Object.values(manifest.packages)) {
+    if (basename(tarball) !== tarball || !tarball.endsWith(".tgz")) {
+      throw new BootstrapError(`Invalid tarball name in vendor/manifest.json: ${tarball}`);
+    }
+  }
+  return manifest;
+}
+function vendorCore(sourceDir, projectDir) {
+  const manifest = readVendorManifest(sourceDir);
+  const vendorDir = join(projectDir, VENDOR_DIR);
+  mkdirSync(vendorDir, { recursive: true });
+  const wanted = new Set(Object.values(manifest.packages));
+  for (const file of readdirSync(vendorDir)) {
+    if (file.endsWith(".tgz") && !wanted.has(file)) rmSync(join(vendorDir, file));
+  }
+  for (const tarball of wanted) {
+    copyFileSync(join(sourceDir, "vendor", tarball), join(vendorDir, tarball));
+  }
+  const pkgPath = join(projectDir, "package.json");
+  const pkg = existsSync(pkgPath) ? JSON.parse(readFileSync(pkgPath, "utf8")) : {
+    name: basename(projectDir).toLowerCase().replace(/[^a-z0-9-]+/g, "-"),
+    private: true,
+    type: "module"
+  };
+  pkg.devDependencies = { ...pkg.devDependencies };
+  for (const [name, tarball] of Object.entries(manifest.packages)) {
+    pkg.devDependencies[name] = `file:${VENDOR_DIR}/${tarball}`;
+  }
+  pkg.devDependencies = Object.fromEntries(
+    Object.entries(pkg.devDependencies).sort(([a], [b]) => a.localeCompare(b))
+  );
+  writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}
+`);
+  return manifest;
+}
+function detectPackageManager(projectDir) {
+  if (existsSync(join(projectDir, "pnpm-lock.yaml"))) return "pnpm";
+  if (existsSync(join(projectDir, "yarn.lock"))) return "yarn";
+  return "npm";
+}
+function localCli(projectDir) {
+  return join(
+    projectDir,
+    "node_modules/.bin",
+    process.platform === "win32" ? "cdalkit.cmd" : "cdalkit"
+  );
+}
+function cloneSource(from) {
+  const local = resolve(from);
+  if (existsSync(local)) return { dir: local, cleanup: () => {
+  } };
+  const dir = mkdtempSync(join(tmpdir(), "cdal-pro-"));
+  const cleanup = () => rmSync(dir, { recursive: true, force: true });
+  try {
+    execFileSync("git", ["clone", "--depth", "1", "--quiet", from, dir], {
+      stdio: ["ignore", "ignore", "pipe"]
+    });
+  } catch {
+    cleanup();
+    throw new BootstrapError(
+      `Could not download CDAL Pro from ${from}.
+  CDAL Pro is delivered as a private GitHub repository: accept the invitation sent after your purchase, make sure git can access GitHub as that account, then run this command again.
+  Not a customer yet? https://cdalkit.tech/pricing`
+    );
+  }
+  return { dir, cleanup };
+}
+function installProWithCore(options) {
+  const exec = options.exec ?? defaultExec;
+  const log = options.log ?? (() => {
+  });
+  const cwd = resolve(options.cwd);
+  const source = cloneSource(options.from ?? PRO_REPOSITORY_URL);
+  try {
+    const manifest = vendorCore(source.dir, cwd);
+    log(`Installing the CDAL core ${manifest.version}\u2026`);
+    const pm = detectPackageManager(cwd);
+    exec(pm, ["install"], cwd);
+    const cli = localCli(cwd);
+    if (!existsSync(join(cwd, "cdal.config.mjs"))) exec(cli, ["init", "--yes"], cwd);
+    const force = options.force ? ["--force"] : [];
+    exec(cli, ["pro", "install", "--from", source.dir, ...force], cwd);
+    if (options.team) {
+      const teamFrom = options.teamFrom ? ["--from", options.teamFrom] : [];
+      exec(cli, ["pro", "install", "--team", ...teamFrom, ...force], cwd);
+    }
+    exec(cli, ["sync"], cwd);
+    return manifest;
+  } finally {
+    source.cleanup();
+  }
+}
+
+export {
+  PRO_REPOSITORY_URL,
+  VENDOR_DIR,
+  BootstrapError,
+  readVendorManifest,
+  vendorCore,
+  detectPackageManager,
+  localCli,
+  installProWithCore
+};

package/dist/cli.d.ts

@@ -1,3 +1,7 @@
-declare function runMain(): void;
+import * as citty from 'citty';
 
-export { runMain };
+/** Commands that belong to the paid CDAL core explain where they come from. */
+declare function proOnly(name: string): citty.CommandDef<citty.ArgsDef>;
+declare const runMain: () => Promise<void>;
+
+export { proOnly, runMain };