@backstage/plugin-catalog-backend-module-ai-model 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,14 @@
+# @backstage/plugin-catalog-backend-module-ai-model
+
+## 0.1.0
+
+### Minor Changes
+
+- 3664148: Introduced the `AiResource` catalog entity kind. Entity types, validators, type guards, and the model layer are exported from `@backstage/catalog-model/alpha`. Install `@backstage/plugin-catalog-backend-module-ai-model` in your backend to register the kind with the catalog.
+
+### Patch Changes
+
+- Updated dependencies
+  - @backstage/catalog-model@1.9.0
+  - @backstage/backend-plugin-api@1.9.1
+  - @backstage/plugin-catalog-node@2.2.1

package/README.md

@@ -0,0 +1,45 @@
+# @backstage/plugin-catalog-backend-module-ai-model
+
+Adds support for the `AiResource` entity kind to the catalog backend plugin. AI resources represent contextual information consumed by AI coding tools, such as skills and rules.
+
+## Installation
+
+Add the module to your backend:
+
+```ts
+backend.add(import('@backstage/plugin-catalog-backend-module-ai-model'));
+```
+
+## Entity shape
+
+```yaml
+apiVersion: backstage.io/v1alpha1
+kind: AiResource
+metadata:
+  name: frontend-design
+  description: Skill for creating production-grade frontend interfaces
+spec:
+  type: skill
+  lifecycle: production
+  owner: ai-platform-team
+  system: ai-tooling
+  disciplines:
+    - web
+  categories:
+    - framework
+  agents:
+    - claude-code
+  dependsOn:
+    - airesource:default/base-coding-standards
+```
+
+The `type` field determines which spec fields are available. Currently supported types:
+
+- **`skill`** — reusable contextual knowledge for AI coding tools. Supports additional fields: `disciplines`, `categories`, `agents`, `dependsOn`.
+- **`rule`** — governance rules and constraints for AI coding tools. Supports additional fields: `disciplines`, `category` (required), `rationale` (required).
+
+Any other `type` value is accepted with the base spec fields: `type`, `lifecycle`, `owner`, and optionally `system`.
+
+## Accessing skill and rule content
+
+The actual content of skills and rules is not stored in the entity spec. Instead, the source file is referenced via the standard `backstage.io/source-location` annotation, consistent with how other Backstage entities reference their source files. Entity providers that generate `AiResource` entities from `SKILL.md` or rule files should set this annotation to point to the source file.

package/dist/index.cjs.js

@@ -0,0 +1,10 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var module$1 = require('./module.cjs.js');
+
+
+
+exports.default = module$1.catalogModuleAiResourceEntityModel;
+//# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import * as _backstage_backend_plugin_api from '@backstage/backend-plugin-api';
+
+/**
+ * Registers support for the AiResource entity kind in the catalog.
+ *
+ * @public
+ */
+declare const catalogModuleAiResourceEntityModel: _backstage_backend_plugin_api.BackendFeature;
+
+export { catalogModuleAiResourceEntityModel as default };

package/dist/module.cjs.js

@@ -0,0 +1,28 @@
+'use strict';
+
+var backendPluginApi = require('@backstage/backend-plugin-api');
+var alpha$1 = require('@backstage/catalog-model/alpha');
+var alpha = require('@backstage/plugin-catalog-node/alpha');
+
+const catalogModuleAiResourceEntityModel = backendPluginApi.createBackendModule({
+  pluginId: "catalog",
+  moduleId: "ai-model",
+  register(reg) {
+    reg.registerInit({
+      deps: {
+        model: alpha.catalogModelExtensionPoint
+      },
+      async init({ model }) {
+        model.addModelSource(
+          alpha$1.CatalogModelSources.static([
+            alpha$1.aiResourceEntityModel,
+            alpha$1.mcpServerApiEntityModel
+          ])
+        );
+      }
+    });
+  }
+});
+
+exports.catalogModuleAiResourceEntityModel = catalogModuleAiResourceEntityModel;
+//# sourceMappingURL=module.cjs.js.map

package/dist/module.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.cjs.js","sources":["../src/module.ts"],"sourcesContent":["/*\n * Copyright 2026 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { createBackendModule } from '@backstage/backend-plugin-api';\nimport {\n  CatalogModelSources,\n  aiResourceEntityModel,\n  mcpServerApiEntityModel,\n} from '@backstage/catalog-model/alpha';\nimport { catalogModelExtensionPoint } from '@backstage/plugin-catalog-node/alpha';\n\n/**\n * Registers support for the AiResource entity kind in the catalog.\n *\n * @public\n */\nexport const catalogModuleAiResourceEntityModel = createBackendModule({\n  pluginId: 'catalog',\n  moduleId: 'ai-model',\n  register(reg) {\n    reg.registerInit({\n      deps: {\n        model: catalogModelExtensionPoint,\n      },\n      async init({ model }) {\n        model.addModelSource(\n          CatalogModelSources.static([\n            aiResourceEntityModel,\n            mcpServerApiEntityModel,\n          ]),\n        );\n      },\n    });\n  },\n});\n"],"names":["createBackendModule","catalogModelExtensionPoint","CatalogModelSources","aiResourceEntityModel","mcpServerApiEntityModel"],"mappings":";;;;;;AA6BO,MAAM,qCAAqCA,oCAAA,CAAoB;AAAA,EACpE,QAAA,EAAU,SAAA;AAAA,EACV,QAAA,EAAU,UAAA;AAAA,EACV,SAAS,GAAA,EAAK;AACZ,IAAA,GAAA,CAAI,YAAA,CAAa;AAAA,MACf,IAAA,EAAM;AAAA,QACJ,KAAA,EAAOC;AAAA,OACT;AAAA,MACA,MAAM,IAAA,CAAK,EAAE,KAAA,EAAM,EAAG;AACpB,QAAA,KAAA,CAAM,cAAA;AAAA,UACJC,4BAAoB,MAAA,CAAO;AAAA,YACzBC,6BAAA;AAAA,YACAC;AAAA,WACD;AAAA,SACH;AAAA,MACF;AAAA,KACD,CAAA;AAAA,EACH;AACF,CAAC;;;;"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@backstage/plugin-catalog-backend-module-ai-model",
+  "version": "0.1.0",
+  "description": "Adds support for the AiResource entity kind to the catalog backend plugin.",
+  "backstage": {
+    "role": "backend-plugin-module",
+    "pluginId": "catalog",
+    "pluginPackage": "@backstage/plugin-catalog-backend",
+    "features": {
+      ".": "@backstage/BackendFeature"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/backstage/backstage",
+    "directory": "plugins/catalog-backend-module-ai-model"
+  },
+  "license": "Apache-2.0",
+  "exports": {
+    ".": {
+      "backstage": "@backstage/BackendFeature",
+      "require": "./dist/index.cjs.js",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.cjs.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.cjs.js",
+  "types": "./dist/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "package.json": [
+        "package.json"
+      ]
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "backstage-cli package build",
+    "clean": "backstage-cli package clean",
+    "lint": "backstage-cli package lint",
+    "prepack": "backstage-cli package prepack",
+    "postpack": "backstage-cli package postpack",
+    "start": "backstage-cli package start",
+    "test": "backstage-cli package test"
+  },
+  "dependencies": {
+    "@backstage/backend-plugin-api": "^1.9.1",
+    "@backstage/catalog-model": "^1.9.0",
+    "@backstage/plugin-catalog-node": "^2.2.1"
+  },
+  "devDependencies": {
+    "@backstage/backend-test-utils": "^1.11.3",
+    "@backstage/cli": "^0.36.2"
+  }
+}