pactwright 0.0.1

package/dist/validation.js

@@ -0,0 +1,83 @@
+/**
+ * Collects problems for one file. Every `expect*` helper records a problem
+ * and returns `undefined` on failure so parsers can keep going and report
+ * everything wrong with a file in one pass.
+ */
+export class Checker {
+    path;
+    problems = [];
+    constructor(path) {
+        this.path = path;
+    }
+    fail(code, message) {
+        this.problems.push({ code, message, path: this.path });
+        return undefined;
+    }
+    get ok() {
+        return this.problems.length === 0;
+    }
+}
+export function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/*
+ * Every `expect*` helper treats `undefined` (an absent key) as already
+ * reported: `requireKeys` owns the missing-field problem, so a required
+ * field never produces two problems.
+ */
+export function expectRecord(c, value, label) {
+    if (value === undefined)
+        return undefined;
+    if (!isRecord(value))
+        return c.fail("invalid-type", `${label} must be a mapping`);
+    return value;
+}
+export function expectString(c, value, label) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "string" || value.length === 0) {
+        return c.fail("invalid-type", `${label} must be a non-empty string`);
+    }
+    return value;
+}
+export function expectInteger(c, value, label) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "number" || !Number.isInteger(value)) {
+        return c.fail("invalid-type", `${label} must be an integer`);
+    }
+    return value;
+}
+export function expectBoolean(c, value, label) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "boolean")
+        return c.fail("invalid-type", `${label} must be a boolean`);
+    return value;
+}
+export function expectEnum(c, value, label, allowed) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "string" || !allowed.includes(value)) {
+        return c.fail("invalid-value", `${label} must be one of: ${allowed.join(", ")}`);
+    }
+    return value;
+}
+export function expectVersion(c, value, label, expected) {
+    const version = expectInteger(c, value, label);
+    if (version !== undefined && version !== expected) {
+        c.fail("unsupported-version", `${label} must be ${expected}, found ${version}`);
+    }
+}
+export function requireKeys(c, record, label, keys) {
+    for (const key of keys) {
+        if (!(key in record))
+            c.fail("missing-field", `${label} is missing required field "${key}"`);
+    }
+}
+export function rejectUnknownKeys(c, record, label, allowed) {
+    for (const key of Object.keys(record)) {
+        if (!allowed.includes(key))
+            c.fail("unknown-field", `${label} has unknown field "${key}"`);
+    }
+}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+/** The runtime package version, read from the package manifest shipped with the build. */
+export declare function runtimeVersion(): string;

package/dist/version.js

@@ -0,0 +1,8 @@
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+/** The runtime package version, read from the package manifest shipped with the build. */
+export function runtimeVersion() {
+    const manifestPath = fileURLToPath(new URL("../package.json", import.meta.url));
+    const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
+    return manifest.version;
+}

package/dist/yaml.d.ts

@@ -0,0 +1,12 @@
+import type { Problem } from "./errors.js";
+export interface YamlReadResult {
+    readonly value: unknown;
+    readonly problems: readonly Problem[];
+}
+/**
+ * Parses YAML text with the YAML core schema: no timestamp, merge or
+ * binary coercion, so `created: 2026-01-01` stays a string.
+ * Returns problems instead of throwing so callers can aggregate.
+ */
+export declare function parseYaml(text: string, path: string): YamlReadResult;
+export declare function readYamlFile(path: string): YamlReadResult;

package/dist/yaml.js

@@ -0,0 +1,32 @@
+import { readFileSync } from "node:fs";
+import { CORE_SCHEMA, load, YAMLException } from "js-yaml";
+/**
+ * Parses YAML text with the YAML core schema: no timestamp, merge or
+ * binary coercion, so `created: 2026-01-01` stays a string.
+ * Returns problems instead of throwing so callers can aggregate.
+ */
+export function parseYaml(text, path) {
+    try {
+        const value = load(text, { schema: CORE_SCHEMA, filename: path });
+        return { value: value === undefined ? null : value, problems: [] };
+    }
+    catch (error) {
+        const message = error instanceof YAMLException ? error.reason : String(error);
+        return {
+            value: null,
+            problems: [{ code: "invalid-yaml", message: `invalid YAML: ${message}`, path }],
+        };
+    }
+}
+export function readYamlFile(path) {
+    let text;
+    try {
+        text = readFileSync(path, "utf8");
+    }
+    catch (error) {
+        const code = error.code;
+        const message = code === "ENOENT" ? "file not found" : `cannot read file: ${String(error)}`;
+        return { value: null, problems: [{ code: "missing-file", message, path }] };
+    }
+    return parseYaml(text, path);
+}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "pactwright",
+  "version": "0.0.1",
+  "description": "Graph-native AI software delivery: intent, decision, contract, brief and evidence recorded in the repository.",
+  "keywords": [
+    "pactwright",
+    "delivery",
+    "spec-graph",
+    "claude-code"
+  ],
+  "license": "Apache-2.0",
+  "private": false,
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sb-dev/pactwright.git"
+  },
+  "homepage": "https://github.com/sb-dev/pactwright#readme",
+  "bugs": {
+    "url": "https://github.com/sb-dev/pactwright/issues"
+  },
+  "engines": {
+    "node": ">=22 <23 || >=24 <25"
+  },
+  "bin": {
+    "pactwright": "dist/cli.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "dependencies": {
+    "js-yaml": "^4.1.0",
+    "@pactwright/standard": "0.0.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.0.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.15.0",
+    "eslint": "^9.0.0",
+    "prettier": "^3.6.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.8.0",
+    "typescript-eslint": "^8.0.0"
+  },
+  "scripts": {
+    "build": "pnpm --filter @pactwright/standard build && tsc -p tsconfig.build.json",
+    "pactwright": "node dist/cli.js",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit",
+    "test": "node --test --import tsx tests/*.test.ts",
+    "verify": "pnpm format:check && pnpm lint && pnpm typecheck && pnpm test && pnpm build"
+  }
+}