@agent-teams/engineering-foundation 0.2.1 → 0.4.0

package/dist/workspace-inventory/application/ports/workspace-inventory-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-inventory-reader.d.ts","sourceRoot":"","sources":["../../../../src/workspace-inventory/application/ports/workspace-inventory-reader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,MAAM,WAAW,wBAAwB;IACvC,IAAI,CACF,YAAY,EAAE,MAAM,EACpB,qBAAqB,EAAE,MAAM,EAC7B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAChC"}

package/dist/workspace-inventory/application/ports/workspace-inventory-reader.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=workspace-inventory-reader.js.map

package/dist/workspace-inventory/application/ports/workspace-inventory-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-inventory-reader.js","sourceRoot":"","sources":["../../../../src/workspace-inventory/application/ports/workspace-inventory-reader.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-teams/engineering-foundation",
-  "version": "0.2.1",
+  "version": "0.4.0",
   "description": "Versioned engineering policy, tooling, and conformance for Agent Teams repositories.",
   "license": "Apache-2.0",
   "type": "module",
@@ -54,8 +54,14 @@
     ]
   },
   "dependencies": {
+    "@microsoft/api-extractor": "7.58.12",
+    "@microsoft/api-extractor-model": "7.33.10",
     "ajv": "8.20.0",
+    "oxc-parser": "0.142.0",
     "proper-lockfile": "4.1.2",
     "yaml": "2.9.0"
+  },
+  "scripts": {
+    "build": "tsc --build tsconfig.json --pretty false"
   }
 }

package/presets/oxlint/base.json

@@ -21,6 +21,7 @@
     "array-callback-return": "error",
     "curly": "error",
     "eqeqeq": "error",
+    "import/no-cycle": "error",
     "import/no-duplicates": "error",
     "import/no-mutable-exports": "error",
     "import/no-self-import": "error",
@@ -30,6 +31,7 @@
     "no-promise-executor-return": "error",
     "no-prototype-builtins": "error",
     "oxc/no-accumulating-spread": "error",
+    "promise/no-multiple-resolved": "error",
     "promise/no-return-wrap": "error",
     "promise/param-names": "error",
     "unicorn/error-message": "error",

package/presets/oxlint/type-aware.json

@@ -0,0 +1,39 @@
+{
+  "extends": ["./node.json"],
+  "options": {
+    "typeAware": true,
+    "typeCheck": false
+  },
+  "rules": {
+    "typescript/await-thenable": "error",
+    "typescript/consistent-return": "off",
+    "typescript/no-array-delete": "error",
+    "typescript/no-base-to-string": "error",
+    "typescript/no-confusing-void-expression": "error",
+    "typescript/no-deprecated": "error",
+    "typescript/no-floating-promises": "error",
+    "typescript/no-for-in-array": "error",
+    "typescript/no-misused-promises": "error",
+    "typescript/no-misused-spread": "error",
+    "typescript/no-unnecessary-condition": "error",
+    "typescript/no-unnecessary-type-assertion": "error",
+    "typescript/no-unsafe-argument": "error",
+    "typescript/no-unsafe-assignment": "error",
+    "typescript/no-unsafe-call": "error",
+    "typescript/no-unsafe-declaration-merging": "error",
+    "typescript/no-unsafe-enum-comparison": "error",
+    "typescript/no-unsafe-function-type": "error",
+    "typescript/no-unsafe-member-access": "error",
+    "typescript/no-unsafe-return": "error",
+    "typescript/no-unsafe-type-assertion": "off",
+    "typescript/no-unsafe-unary-minus": "error",
+    "typescript/only-throw-error": "error",
+    "typescript/prefer-readonly": "error",
+    "typescript/require-array-sort-compare": "error",
+    "typescript/restrict-template-expressions": "error",
+    "typescript/strict-boolean-expressions": "error",
+    "typescript/switch-exhaustiveness-check": "error",
+    "typescript/unbound-method": "error",
+    "typescript/use-unknown-in-catch-callback-variable": "error"
+  }
+}

package/schemas/architecture-source-dependencies/v1.schema.json

@@ -0,0 +1,97 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.agent-teams.ai/engineering-foundation/architecture-source-dependencies/v1",
+  "title": "Source dependency architecture capability configuration",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "workspace", "governedRoots", "boundaries"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "workspace": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "manifest"],
+      "properties": {
+        "kind": { "const": "pnpm" },
+        "manifest": { "const": "pnpm-workspace.yaml" }
+      }
+    },
+    "governedRoots": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/repositoryDirectory" }
+    },
+    "boundaries": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 5000,
+      "items": { "$ref": "#/$defs/boundary" }
+    }
+  },
+  "$defs": {
+    "repositoryDirectory": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 240,
+      "pattern": "^(?!/)(?!.*\\\\)(?!.*(?:^|/)\\.{1,2}(?:/|$))[^*?{}[\\]]+$"
+    },
+    "boundaryId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 120,
+      "pattern": "^[a-z0-9](?:[a-z0-9._-]{0,118}[a-z0-9])?$"
+    },
+    "packageName": {
+      "type": "string",
+      "pattern": "^(?:@[a-z0-9][a-z0-9._-]*/)?[a-z0-9][a-z0-9._-]*$"
+    },
+    "builtinName": {
+      "type": "string",
+      "pattern": "^node:[a-z0-9_./-]+$"
+    },
+    "boundary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "roots", "allow"],
+      "properties": {
+        "id": { "$ref": "#/$defs/boundaryId" },
+        "roots": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": { "$ref": "#/$defs/repositoryDirectory" }
+        },
+        "allow": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["boundaries", "packages", "builtins", "runtimeReferences"],
+          "properties": {
+            "boundaries": {
+              "type": "array",
+              "uniqueItems": true,
+              "items": { "$ref": "#/$defs/boundaryId" }
+            },
+            "packages": {
+              "type": "array",
+              "uniqueItems": true,
+              "items": { "$ref": "#/$defs/packageName" }
+            },
+            "builtins": {
+              "type": "array",
+              "uniqueItems": true,
+              "items": { "$ref": "#/$defs/builtinName" }
+            },
+            "runtimeReferences": {
+              "type": "array",
+              "uniqueItems": true,
+              "items": {
+                "enum": ["commonjs", "dynamic", "type-query"]
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

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

@@ -25,6 +25,46 @@
       "additionalProperties": false,
       "minProperties": 1,
       "properties": {
+        "package.public-api-compatibility": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["configPath"],
+          "properties": {
+            "configPath": {
+              "$ref": "#/$defs/repositoryRelativeYamlPath"
+            }
+          }
+        },
+        "quality.suppression-governance": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["configPath"],
+          "properties": {
+            "configPath": {
+              "$ref": "#/$defs/repositoryRelativeYamlPath"
+            }
+          }
+        },
+        "repository.security-baseline": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["configPath"],
+          "properties": {
+            "configPath": {
+              "$ref": "#/$defs/repositoryRelativeYamlPath"
+            }
+          }
+        },
+        "architecture.source-dependencies": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["configPath"],
+          "properties": {
+            "configPath": {
+              "$ref": "#/$defs/repositoryRelativeYamlPath"
+            }
+          }
+        },
         "workspace.dependency-declarations": {
           "type": "object",
           "additionalProperties": false,

package/schemas/package-public-api-baseline/v1.schema.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.agent-teams.ai/engineering-foundation/package-public-api-baseline/v1",
+  "title": "Released public API baseline",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "packageName",
+    "packageVersion",
+    "extractorVersion",
+    "items"
+  ],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "packageName": { "type": "string", "minLength": 1, "maxLength": 214 },
+    "packageVersion": {
+      "type": "string",
+      "pattern": "^(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)(?:-(?:(?:0|[1-9][0-9]*|[0-9]*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9][0-9]*|[0-9]*[A-Za-z-][0-9A-Za-z-]*))*))?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$"
+    },
+    "extractorVersion": { "type": "string", "minLength": 1, "maxLength": 40 },
+    "items": {
+      "type": "array",
+      "maxItems": 100000,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["canonicalReference", "kind", "parentKind", "signature"],
+        "properties": {
+          "canonicalReference": { "type": "string", "minLength": 1, "maxLength": 1000 },
+          "kind": { "type": "string", "minLength": 1, "maxLength": 80 },
+          "parentReference": { "type": "string", "minLength": 1, "maxLength": 1000 },
+          "parentKind": { "type": "string", "minLength": 1, "maxLength": 80 },
+          "signature": { "type": "string", "minLength": 1, "maxLength": 10000 }
+        }
+      }
+    }
+  }
+}

package/schemas/package-public-api-compatibility/v1.schema.json

@@ -0,0 +1,70 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.agent-teams.ai/engineering-foundation/package-public-api-compatibility/v1",
+  "title": "Public API compatibility capability configuration",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "changesetDirectory", "packages"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "changesetDirectory": { "$ref": "#/$defs/repositoryPath" },
+    "packages": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 100,
+      "items": { "$ref": "#/$defs/package" }
+    }
+  },
+  "$defs": {
+    "repositoryPath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 300,
+      "pattern": "^(?!/)(?!.*\\\\)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*[*?{}[\\]]).+$"
+    },
+    "packageName": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 214,
+      "pattern": "^(?:@[a-z0-9][a-z0-9._-]*/)?[a-z0-9][a-z0-9._-]*$"
+    },
+    "fingerprint": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "package": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "packageName",
+        "packageRoot",
+        "manifestPath",
+        "declarationEntryPoint",
+        "tsconfigPath",
+        "releasedBaselinePath",
+        "approvedBreakingChanges"
+      ],
+      "properties": {
+        "packageName": { "$ref": "#/$defs/packageName" },
+        "packageRoot": { "$ref": "#/$defs/repositoryPath" },
+        "manifestPath": { "$ref": "#/$defs/repositoryPath" },
+        "declarationEntryPoint": { "$ref": "#/$defs/repositoryPath" },
+        "tsconfigPath": { "$ref": "#/$defs/repositoryPath" },
+        "releasedBaselinePath": { "$ref": "#/$defs/repositoryPath" },
+        "approvedBreakingChanges": {
+          "type": "array",
+          "maxItems": 100,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["fingerprint", "decisionPath"],
+            "properties": {
+              "fingerprint": { "$ref": "#/$defs/fingerprint" },
+              "decisionPath": { "$ref": "#/$defs/repositoryPath" }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/quality-suppression-governance/v1.schema.json

@@ -0,0 +1,109 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.agent-teams.ai/engineering-foundation/quality-suppression-governance/v1",
+  "title": "Suppression governance capability configuration",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "governedRoots", "nonWaivableRulePrefixes", "waivers"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "governedRoots": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 100,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/repositoryPath" }
+    },
+    "nonWaivableRulePrefixes": {
+      "type": "array",
+      "maxItems": 100,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "minLength": 2,
+        "maxLength": 100,
+        "pattern": "^[a-z0-9][a-z0-9./-]*[.-]$"
+      }
+    },
+    "waivers": {
+      "type": "array",
+      "maxItems": 10000,
+      "items": { "$ref": "#/$defs/waiver" }
+    }
+  },
+  "$defs": {
+    "repositoryPath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 300,
+      "pattern": "^(?!/)(?!.*\\\\)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*[*?{}[\\]]).+$"
+    },
+    "waiverId": {
+      "type": "string",
+      "minLength": 5,
+      "maxLength": 80,
+      "pattern": "^[A-Z][A-Z0-9]*(?:-[A-Z0-9]+)+$"
+    },
+    "ruleId": {
+      "type": "string",
+      "minLength": 2,
+      "maxLength": 160,
+      "pattern": "^[a-z0-9@][a-zA-Z0-9@/._:-]*$"
+    },
+    "waiver": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "path",
+        "line",
+        "directive",
+        "rules",
+        "owner",
+        "reason",
+        "createdOn",
+        "expiresOn",
+        "decisionRef"
+      ],
+      "properties": {
+        "id": { "$ref": "#/$defs/waiverId" },
+        "path": { "$ref": "#/$defs/repositoryPath" },
+        "line": { "type": "integer", "minimum": 1, "maximum": 10000000 },
+        "directive": {
+          "enum": [
+            "oxlint-disable-line",
+            "oxlint-disable-next-line",
+            "typescript-expect-error",
+            "ast-grep-ignore"
+          ]
+        },
+        "rules": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 50,
+          "uniqueItems": true,
+          "items": { "$ref": "#/$defs/ruleId" }
+        },
+        "owner": {
+          "type": "string",
+          "minLength": 2,
+          "maxLength": 120,
+          "pattern": "^[a-z0-9][a-z0-9./-]*$"
+        },
+        "reason": { "type": "string", "minLength": 20, "maxLength": 500 },
+        "createdOn": { "$ref": "#/$defs/date" },
+        "expiresOn": { "$ref": "#/$defs/date" },
+        "decisionRef": {
+          "type": "string",
+          "minLength": 3,
+          "maxLength": 240,
+          "pattern": "^[^\\s]+$"
+        }
+      }
+    },
+    "date": {
+      "type": "string",
+      "pattern": "^20[0-9]{2}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])$"
+    }
+  }
+}

package/schemas/repository-security-baseline/v1.schema.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.agent-teams.ai/engineering-foundation/repository-security-baseline/v1",
+  "title": "Repository security baseline capability configuration",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "workflowDirectory",
+    "dependencyReviewWorkflow",
+    "sbomWorkflow",
+    "privilegedJobs",
+    "publishablePackageManifests"
+  ],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "workflowDirectory": { "$ref": "#/$defs/repositoryPath" },
+    "dependencyReviewWorkflow": { "$ref": "#/$defs/repositoryPath" },
+    "sbomWorkflow": { "$ref": "#/$defs/repositoryPath" },
+    "privilegedJobs": {
+      "type": "array",
+      "maxItems": 100,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["workflowPath", "jobId", "permissions"],
+        "properties": {
+          "workflowPath": { "$ref": "#/$defs/repositoryPath" },
+          "jobId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" },
+          "permissions": { "$ref": "#/$defs/permissions" }
+        }
+      }
+    },
+    "publishablePackageManifests": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 100,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/repositoryPath" }
+    }
+  },
+  "$defs": {
+    "repositoryPath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 500,
+      "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*\\\\)(?!.*//)[^\\u0000]+$"
+    },
+    "permissions": {
+      "type": "object",
+      "minProperties": 1,
+      "maxProperties": 30,
+      "propertyNames": { "pattern": "^[a-z-]{1,50}$" },
+      "additionalProperties": { "enum": ["none", "read", "write"] }
+    }
+  }
+}