@agent-teams/engineering-foundation 0.1.0 → 0.2.0

package/dist/strict-yaml.js

@@ -0,0 +1,99 @@
+import { readFile, realpath, stat } from "node:fs/promises";
+import { isAbsolute, relative, resolve, sep } from "node:path";
+import { isAlias, isMap, isNode, isPair, parseDocument, visit } from "yaml";
+import { CapabilityInputError } from "./capability-runtime.js";
+const MAX_CONFIG_BYTES = 1024 * 1024;
+function inputError(code, message, phase) {
+    throw new CapabilityInputError({ code, message, phase, retryable: false });
+}
+export function assertNotCancelled(signal) {
+    if (signal?.aborted === true) {
+        throw new CapabilityInputError({
+            code: "EXECUTION_CANCELLED",
+            message: "Foundation check was cancelled.",
+            phase: "execution",
+            retryable: false
+        });
+    }
+}
+export function assertRepositoryRelativePath(path, phase) {
+    const segments = path.split("/");
+    if (path.length === 0 ||
+        isAbsolute(path) ||
+        path.includes("\\") ||
+        segments.some((segment) => segment === "" || segment === "." || segment === "..")) {
+        inputError("CONFIG_PATH_INVALID", "Configuration paths must be normalized repository-relative POSIX paths.", phase);
+    }
+}
+export async function resolveContainedFile(consumerRoot, repositoryPath, phase) {
+    assertRepositoryRelativePath(repositoryPath, phase);
+    const canonicalRoot = await realpath(consumerRoot);
+    const candidate = resolve(canonicalRoot, repositoryPath);
+    let canonicalCandidate;
+    try {
+        canonicalCandidate = await realpath(candidate);
+    }
+    catch {
+        inputError("CONFIG_FILE_UNAVAILABLE", `Required configuration file is unavailable: ${repositoryPath}.`, phase);
+    }
+    const relation = relative(canonicalRoot, canonicalCandidate);
+    if (relation === ".." || relation.startsWith(`..${sep}`) || isAbsolute(relation)) {
+        inputError("CONFIG_PATH_ESCAPE", `Configuration path escapes the consumer repository: ${repositoryPath}.`, phase);
+    }
+    const metadata = await stat(canonicalCandidate);
+    if (!metadata.isFile() || metadata.size > MAX_CONFIG_BYTES) {
+        inputError("CONFIG_FILE_INVALID", `Configuration file must be a regular file no larger than ${MAX_CONFIG_BYTES} bytes: ${repositoryPath}.`, phase);
+    }
+    return canonicalCandidate;
+}
+export function parseStrictYaml(source, phase) {
+    const document = parseDocument(source, {
+        customTags: [],
+        merge: false,
+        schema: "core",
+        uniqueKeys: true
+    });
+    if (document.errors.length > 0 || document.warnings.length > 0) {
+        const problem = [...document.errors, ...document.warnings]
+            .slice(0, 8)
+            .map((error) => error.message)
+            .join("; ")
+            .slice(0, 1000);
+        inputError("YAML_INVALID", problem || "YAML input is invalid.", phase);
+    }
+    let forbidden;
+    visit(document, (_key, node) => {
+        if (isAlias(node)) {
+            forbidden = "YAML aliases are prohibited.";
+            return visit.BREAK;
+        }
+        if (isNode(node) && (node.anchor !== undefined || node.tag !== undefined)) {
+            forbidden = "YAML anchors and explicit tags are prohibited.";
+            return visit.BREAK;
+        }
+        if (isPair(node) &&
+            isNode(node.key) &&
+            "value" in node.key &&
+            node.key.value === "<<") {
+            forbidden = "YAML merge keys are prohibited.";
+            return visit.BREAK;
+        }
+        if (isMap(node) && node.items.length > 10_000) {
+            forbidden = "YAML mapping exceeds the supported size limit.";
+            return visit.BREAK;
+        }
+        return;
+    });
+    if (forbidden !== undefined) {
+        inputError("YAML_FEATURE_PROHIBITED", forbidden, phase);
+    }
+    return document.toJS({ maxAliasCount: 0 });
+}
+export async function loadStrictYamlFile(consumerRoot, repositoryPath, phase, signal) {
+    assertNotCancelled(signal);
+    const path = await resolveContainedFile(consumerRoot, repositoryPath, phase);
+    const source = await readFile(path, "utf8");
+    assertNotCancelled(signal);
+    return parseStrictYaml(source, phase);
+}
+//# sourceMappingURL=strict-yaml.js.map

package/dist/strict-yaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strict-yaml.js","sourceRoot":"","sources":["../src/strict-yaml.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-teams/engineering-foundation",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Versioned engineering policy, tooling, and conformance for Agent Teams repositories.",
   "license": "Apache-2.0",
   "type": "module",
@@ -17,10 +17,14 @@
       "types": "./dist/local-mode/index.d.ts",
       "import": "./dist/local-mode/index.js"
     },
+    "./schemas/*": "./schemas/*",
+    "./presets/*": "./presets/*",
     "./package.json": "./package.json"
   },
   "files": [
     "dist",
+    "presets",
+    "schemas",
     "LICENSE",
     "README.md"
   ],
@@ -50,6 +54,7 @@
     ]
   },
   "dependencies": {
+    "ajv": "8.20.0",
     "proper-lockfile": "4.1.2",
     "yaml": "2.9.0"
   }

package/presets/oxlint/base.json

@@ -0,0 +1,39 @@
+{
+  "categories": {
+    "correctness": "error",
+    "suspicious": "error"
+  },
+  "options": {
+    "reportUnusedDisableDirectives": "error",
+    "respectEslintDisableDirectives": false,
+    "typeAware": false,
+    "typeCheck": false
+  },
+  "plugins": [
+    "eslint",
+    "typescript",
+    "oxc",
+    "unicorn",
+    "import",
+    "promise"
+  ],
+  "rules": {
+    "array-callback-return": "error",
+    "curly": "error",
+    "eqeqeq": "error",
+    "import/no-duplicates": "error",
+    "import/no-mutable-exports": "error",
+    "import/no-self-import": "error",
+    "no-eval": "error",
+    "no-implied-eval": "error",
+    "no-new-func": "error",
+    "no-promise-executor-return": "error",
+    "no-prototype-builtins": "error",
+    "oxc/no-accumulating-spread": "error",
+    "promise/no-return-wrap": "error",
+    "promise/param-names": "error",
+    "unicorn/error-message": "error",
+    "unicorn/no-abusive-eslint-disable": "error",
+    "unicorn/no-useless-undefined": "error"
+  }
+}

package/presets/oxlint/node.json

@@ -0,0 +1,8 @@
+{
+  "extends": ["./base.json"],
+  "plugins": ["node"],
+  "rules": {
+    "node/no-path-concat": "error",
+    "unicorn/prefer-node-protocol": "error"
+  }
+}

package/presets/typescript/base.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "allowUnreachableCode": false,
+    "allowUnusedLabels": false,
+    "exactOptionalPropertyTypes": true,
+    "forceConsistentCasingInFileNames": true,
+    "moduleDetection": "force",
+    "noFallthroughCasesInSwitch": true,
+    "noImplicitOverride": true,
+    "noImplicitReturns": true,
+    "noUncheckedIndexedAccess": true,
+    "noUncheckedSideEffectImports": true,
+    "strict": true,
+    "useUnknownInCatchVariables": true,
+    "verbatimModuleSyntax": true
+  }
+}

package/presets/typescript/node.json

@@ -0,0 +1,9 @@
+{
+  "extends": "./base.json",
+  "compilerOptions": {
+    "lib": ["ES2024"],
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "target": "ES2024"
+  }
+}

package/schemas/foundation-check-report/v1.schema.json

@@ -0,0 +1,138 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.agent-teams.ai/engineering-foundation/foundation-check-report/v1",
+  "title": "Agent Teams Engineering Foundation check report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "reportSchemaVersion",
+    "foundationVersion",
+    "coverage",
+    "outcome",
+    "summary",
+    "capabilities"
+  ],
+  "properties": {
+    "reportSchemaVersion": { "const": 1 },
+    "foundationVersion": { "type": "string" },
+    "coverage": { "const": "full" },
+    "outcome": { "$ref": "#/$defs/outcome" },
+    "summary": { "$ref": "#/$defs/summary" },
+    "capabilities": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/capabilityReport" }
+    },
+    "problem": { "$ref": "#/$defs/problem" }
+  },
+  "$defs": {
+    "outcome": {
+      "enum": ["passed", "violations", "invalid-input", "failed", "cancelled"]
+    },
+    "severity": {
+      "enum": ["error", "warning", "info"]
+    },
+    "summary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["errors", "warnings", "infos"],
+      "properties": {
+        "errors": { "type": "integer", "minimum": 0 },
+        "warnings": { "type": "integer", "minimum": 0 },
+        "infos": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "position": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["line", "column"],
+      "properties": {
+        "line": { "type": "integer", "minimum": 1 },
+        "column": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "location": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path"],
+      "properties": {
+        "path": { "type": "string", "minLength": 1 },
+        "start": { "$ref": "#/$defs/position" },
+        "end": { "$ref": "#/$defs/position" }
+      }
+    },
+    "evidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "value"],
+      "properties": {
+        "kind": { "type": "string", "minLength": 1 },
+        "value": { "type": "string", "maxLength": 500 }
+      }
+    },
+    "diagnostic": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "ruleId",
+        "severity",
+        "subject",
+        "message",
+        "location",
+        "relatedLocations",
+        "evidence",
+        "remediation",
+        "requiresArchitectureReview"
+      ],
+      "properties": {
+        "ruleId": { "type": "string", "minLength": 1 },
+        "severity": { "$ref": "#/$defs/severity" },
+        "subject": { "type": "string", "minLength": 1 },
+        "message": { "type": "string", "minLength": 1, "maxLength": 1000 },
+        "location": { "$ref": "#/$defs/location" },
+        "relatedLocations": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/location" }
+        },
+        "evidence": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/evidence" }
+        },
+        "remediation": { "type": "string", "minLength": 1, "maxLength": 1000 },
+        "requiresArchitectureReview": { "type": "boolean" }
+      }
+    },
+    "problem": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "message", "phase", "retryable"],
+      "properties": {
+        "code": { "type": "string", "minLength": 1 },
+        "message": { "type": "string", "minLength": 1, "maxLength": 1000 },
+        "phase": { "type": "string", "minLength": 1 },
+        "retryable": { "type": "boolean" }
+      }
+    },
+    "capabilityReport": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "capabilityId",
+        "capabilityConfigSchemaVersion",
+        "outcome",
+        "summary",
+        "diagnostics"
+      ],
+      "properties": {
+        "capabilityId": { "type": "string", "minLength": 1 },
+        "capabilityConfigSchemaVersion": { "type": "integer", "minimum": 1 },
+        "outcome": { "$ref": "#/$defs/outcome" },
+        "summary": { "$ref": "#/$defs/summary" },
+        "diagnostics": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/diagnostic" }
+        },
+        "problem": { "$ref": "#/$defs/problem" }
+      }
+    }
+  }
+}

package/schemas/foundation-config/v1.schema.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.agent-teams.ai/engineering-foundation/foundation-config/v1",
+  "title": "Agent Teams Engineering Foundation configuration",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "project", "capabilities"],
+  "properties": {
+    "schemaVersion": {
+      "const": 1
+    },
+    "project": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$"
+        }
+      }
+    },
+    "capabilities": {
+      "type": "object",
+      "additionalProperties": false,
+      "minProperties": 1,
+      "properties": {
+        "workspace.dependency-declarations": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["configPath"],
+          "properties": {
+            "configPath": {
+              "$ref": "#/$defs/repositoryRelativeYamlPath"
+            }
+          }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "repositoryRelativeYamlPath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 240,
+      "pattern": "^(?!/)(?!.*\\\\)(?!.*(?:^|/)\\.\\.(?:/|$)).+\\.ya?ml$"
+    }
+  }
+}

package/schemas/workspace-dependency-declarations/v1.schema.json

@@ -0,0 +1,61 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.agent-teams.ai/engineering-foundation/workspace-dependency-declarations/v1",
+  "title": "Workspace dependency declarations capability configuration",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "packageManager", "policies"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "packageManager": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "workspaceManifest"],
+      "properties": {
+        "kind": { "const": "pnpm" },
+        "workspaceManifest": { "const": "pnpm-workspace.yaml" }
+      }
+    },
+    "policies": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "externalDependencies",
+        "catalogVersions",
+        "internalDependencies",
+        "reservedScopes",
+        "developmentOnlyPackages",
+        "exactRegistryDevelopmentOnlyPackages"
+      ],
+      "properties": {
+        "externalDependencies": { "const": "catalog" },
+        "catalogVersions": { "const": "exact" },
+        "internalDependencies": { "const": "workspace-protocol" },
+        "reservedScopes": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "pattern": "^@[a-z0-9][a-z0-9._-]*/$"
+          }
+        },
+        "developmentOnlyPackages": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "pattern": "^(?:@[a-z0-9][a-z0-9._-]*/)?[a-z0-9][a-z0-9._-]*$"
+          }
+        },
+        "exactRegistryDevelopmentOnlyPackages": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "pattern": "^(?:@[a-z0-9][a-z0-9._-]*/)?[a-z0-9][a-z0-9._-]*$"
+          }
+        }
+      }
+    }
+  }
+}

package/dist/config.d.ts

@@ -1,18 +0,0 @@
-export declare const FOUNDATION_CONFIG_SCHEMA_VERSION: 1;
-export declare const FOUNDATION_CAPABILITIES: readonly ["architecture", "documentation", "lint", "reliability", "security"];
-export declare const FOUNDATION_PROJECT_KINDS: readonly ["client", "runtime", "service", "tooling"];
-export type FoundationCapabilityName = (typeof FOUNDATION_CAPABILITIES)[number];
-export type FoundationProjectKind = (typeof FOUNDATION_PROJECT_KINDS)[number];
-export interface FoundationCapabilityConfig {
-    readonly enabled: boolean;
-    readonly configPath?: string;
-}
-export interface FoundationConfig {
-    readonly schemaVersion: typeof FOUNDATION_CONFIG_SCHEMA_VERSION;
-    readonly projectId: string;
-    readonly projectKind: FoundationProjectKind;
-    readonly capabilities: Readonly<Partial<Record<FoundationCapabilityName, FoundationCapabilityConfig>>>;
-}
-export declare function parseFoundationConfig(input: unknown): FoundationConfig;
-export declare function defineFoundationConfig(input: FoundationConfig): FoundationConfig;
-//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,gCAAgC,EAAG,CAAU,CAAC;AAE3D,eAAO,MAAM,uBAAuB,YAClC,cAAc,EACd,eAAe,EACf,MAAM,EACN,aAAa,EACb,UAAU,CACF,CAAC;AAEX,eAAO,MAAM,wBAAwB,YACnC,QAAQ,EACR,SAAS,EACT,SAAS,EACT,SAAS,CACD,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAChF,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9E,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,aAAa,EAAE,OAAO,gCAAgC,CAAC;IAChE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC;IAC5C,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAC7B,OAAO,CAAC,MAAM,CAAC,wBAAwB,EAAE,0BAA0B,CAAC,CAAC,CACtE,CAAC;CACH;AAiGD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAkDtE;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,gBAAgB,GACtB,gBAAgB,CAElB"}

package/dist/config.js

@@ -1,106 +0,0 @@
-import { isAbsolute, normalize, sep } from "node:path";
-import { FoundationError } from "./errors.js";
-export const FOUNDATION_CONFIG_SCHEMA_VERSION = 1;
-export const FOUNDATION_CAPABILITIES = [
-    "architecture",
-    "documentation",
-    "lint",
-    "reliability",
-    "security"
-];
-export const FOUNDATION_PROJECT_KINDS = [
-    "client",
-    "runtime",
-    "service",
-    "tooling"
-];
-const PROJECT_ID_PATTERN = /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/;
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function isProjectKind(value) {
-    return (typeof value === "string" &&
-        FOUNDATION_PROJECT_KINDS.some((candidate) => candidate === value));
-}
-function isCapabilityName(value) {
-    return FOUNDATION_CAPABILITIES.some((candidate) => candidate === value);
-}
-function validateConfigPath(value, capability) {
-    if (value === undefined) {
-        return undefined;
-    }
-    if (typeof value !== "string" || value.length === 0) {
-        throw new FoundationError("CONFIG_INVALID", `Capability ${capability} configPath must be a non-empty relative path.`);
-    }
-    const normalized = normalize(value);
-    if (isAbsolute(value) ||
-        normalized === ".." ||
-        normalized.startsWith(`..${sep}`)) {
-        throw new FoundationError("CONFIG_INVALID", `Capability ${capability} configPath cannot escape the consumer repository.`);
-    }
-    return value;
-}
-function parseCapabilities(value) {
-    if (!isRecord(value)) {
-        throw new FoundationError("CONFIG_INVALID", "Foundation capabilities must be an object.");
-    }
-    const entries = Object.entries(value);
-    if (entries.length === 0) {
-        throw new FoundationError("CONFIG_INVALID", "At least one foundation capability must be declared.");
-    }
-    const parsed = {};
-    for (const [name, candidate] of entries) {
-        if (!isCapabilityName(name)) {
-            throw new FoundationError("CONFIG_INVALID", `Unknown foundation capability: ${name}.`);
-        }
-        if (!isRecord(candidate) || typeof candidate.enabled !== "boolean") {
-            throw new FoundationError("CONFIG_INVALID", `Capability ${name} must declare an enabled boolean.`);
-        }
-        const allowedKeys = new Set(["configPath", "enabled"]);
-        const unknownKey = Object.keys(candidate).find((key) => !allowedKeys.has(key));
-        if (unknownKey !== undefined) {
-            throw new FoundationError("CONFIG_INVALID", `Capability ${name} contains unknown field: ${unknownKey}.`);
-        }
-        const configPath = validateConfigPath(candidate.configPath, name);
-        parsed[name] = Object.freeze({
-            enabled: candidate.enabled,
-            ...(configPath === undefined ? {} : { configPath })
-        });
-    }
-    return Object.freeze(parsed);
-}
-export function parseFoundationConfig(input) {
-    if (!isRecord(input)) {
-        throw new FoundationError("CONFIG_INVALID", "Foundation configuration must be an object.");
-    }
-    const allowedKeys = new Set([
-        "capabilities",
-        "projectId",
-        "projectKind",
-        "schemaVersion"
-    ]);
-    const unknownKey = Object.keys(input).find((key) => !allowedKeys.has(key));
-    if (unknownKey !== undefined) {
-        throw new FoundationError("CONFIG_INVALID", `Foundation configuration contains unknown field: ${unknownKey}.`);
-    }
-    if (input.schemaVersion !== FOUNDATION_CONFIG_SCHEMA_VERSION) {
-        throw new FoundationError("CONFIG_INVALID", `Unsupported foundation schemaVersion: ${String(input.schemaVersion)}.`);
-    }
-    if (typeof input.projectId !== "string" ||
-        !PROJECT_ID_PATTERN.test(input.projectId)) {
-        throw new FoundationError("CONFIG_INVALID", "projectId must be a lowercase kebab-case identifier up to 63 characters.");
-    }
-    if (!isProjectKind(input.projectKind)) {
-        throw new FoundationError("CONFIG_INVALID", `Unknown projectKind: ${String(input.projectKind)}.`);
-    }
-    return Object.freeze({
-        schemaVersion: FOUNDATION_CONFIG_SCHEMA_VERSION,
-        projectId: input.projectId,
-        projectKind: input.projectKind,
-        capabilities: parseCapabilities(input.capabilities)
-    });
-}
-export function defineFoundationConfig(input) {
-    return parseFoundationConfig(input);
-}
-//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}