feat(x2a): change the project to be source-technology agnostic (#2953)

* feat(x2a): change the project to be source-technology agnostic

Rephrasing all texts from being Chef-oriented to more generic variants.
There is explicit mapping from free-form agentic findings to a new SourceTechnology enum (normalizeSourceTechnology.ts).

Signed-off-by: Marek Libra <marek.libra@gmail.com>

* Stick to 'existing automation' and prune source technologies

* forgotten renames

---------

Signed-off-by: Marek Libra <marek.libra@gmail.com>

Author: mareklibra

workspaces/x2a/.changeset/shaggy-beers-fry.md

@@ -0,0 +1,9 @@
+---
+'@red-hat-developer-hub/backstage-plugin-scaffolder-backend-module-x2a': patch
+'@red-hat-developer-hub/backstage-plugin-x2a-backend': patch
+'@red-hat-developer-hub/backstage-plugin-x2a-common': patch
+'@red-hat-developer-hub/backstage-plugin-x2a-node': patch
+'@red-hat-developer-hub/backstage-plugin-x2a': patch
+---
+
+Changed the project to be source-technology agnostic. Rephrasing all texts from being Chef-oriented to more generic variants. There is explicit mapping from free-form agentic findings to the new SourceTechnology enum (normalizeSourceTechnology.ts).

workspaces/x2a/docs/csv-bulk-import.md

@@ -5,7 +5,7 @@ The CSV bulk import lets the user create multiple conversion projects at once by
 ## How to Access
 
 1. Open the Backstage instance and navigate to `/create`.
-2. Select the **Chef-to-Ansible Conversion Project** template (`chef-conversion-project-template`).
+2. Select the **Infrastructure Conversion Project** template (`x2a-conversion-project-template`).
 3. On the first page, choose **CSV upload** as the input method.
 4. Upload the CSV file and proceed through the wizard.
 
@@ -21,7 +21,7 @@ The file must be UTF-8 encoded with a header row. Column order does not matter,
 | ------------------ | --------------------------------------------------------------------------------------------------------- |
 | `name`             | Unique project name                                                                                       |
 | `abbreviation`     | Short project identifier, 1-5 alphanumeric characters matching `^([a-zA-Z][a-zA-Z0-9]*)(-[a-zA-Z0-9]+)*$` |
-| `sourceRepoUrl`    | URL of the repository containing the Chef cookbook to convert                                             |
+| `sourceRepoUrl`    | URL of the source repository to convert                                                                   |
 | `sourceRepoBranch` | Branch to read from in the source repository                                                              |
 | `targetRepoBranch` | Branch to write converted Ansible output to                                                               |
 

workspaces/x2a/plugins/scaffolder-backend-module-x2a/templates/conversion-project-template.yaml

@@ -1,9 +1,9 @@
 apiVersion: scaffolder.backstage.io/v1beta3
 kind: Template
 metadata:
-  name: chef-conversion-project-template
-  title: Chef-to-Ansible Conversion Project
-  description: Initiate a conversion of a Chef cookbook or directory into a new Ansible Playbook repository.
+  name: x2a-conversion-project-template
+  title: Infrastructure Conversion Project
+  description: Initiate a conversion of existing automation (e.g. Chef, Puppet, Salt, Powershell) into a new Ansible Playbook repository.
 spec:
   type: service
 
@@ -121,7 +121,7 @@ spec:
                   sourceRepoUrl:
                     title: Conversion source repository
                     description: |
-                      The Owner should be your SCM (Source Code Management) username. The repository name should be a name that already exists in your SCM account and contains a Chef cookbook or directory to convert.
+                      The Owner should be your SCM (Source Code Management) username. The repository name should be a name that already exists in your SCM account and contains the existing automation (like Chef cookbook, Puppet module, Salt, Powershell DSC, etc.) to convert.
                     type: string
                     ui:field: RepoUrlPicker
                     ui:options:

workspaces/x2a/plugins/x2a-backend/README.md

@@ -209,7 +209,7 @@ curl -X POST http://localhost:7007/api/x2a/projects \
   -H "Content-Type: application/json" \
   -H "Authorization: Bearer ${TOKEN}" \
   -d '{
-    "name": "My Chef Migration",
+    "name": "My source automation project migration",
     "description": "Test migration",
     "abbreviation": "TEST"
   }'

workspaces/x2a/plugins/x2a-backend/migrations/2025012402_add_modules_technology.ts

@@ -0,0 +1,39 @@
+/*
+ * Copyright Red Hat, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import type { Knex } from 'knex';
+
+/**
+ * Adds the technology column to the modules table.
+ *
+ * @public
+ */
+export async function up(knex: Knex): Promise<void> {
+  await knex.schema.alterTable('modules', table => {
+    table.string('technology').nullable();
+  });
+}
+
+/**
+ * Removes the technology column from the modules table.
+ *
+ * @public
+ */
+export async function down(knex: Knex): Promise<void> {
+  await knex.schema.alterTable('modules', table => {
+    table.dropColumn('technology');
+  });
+}

workspaces/x2a/plugins/x2a-backend/public/sample-projects.csv

@@ -1,2 +1,2 @@
 name,description,abbreviation,ownedByGroup,sourceRepoUrl,sourceRepoBranch,targetRepoUrl,targetRepoBranch
-my-examples,Convert chef-examples to Ansible,mex,,https://github.com/x2ansible/chef-examples,main,https://github.com/my-converted-projects/my-examples,target
+my-examples,Convert existing automation to Ansible,mex,,https://github.com/x2ansible/config-examples,main,https://github.com/my-converted-projects/my-examples,target

workspaces/x2a/plugins/x2a-backend/src/router/collectArtifactsActions.test.ts

@@ -96,11 +96,13 @@ describe('collectArtifacts routes (actions & signatures)', () => {
         name: 'module-a',
         sourcePath: '/cookbooks/a',
         projectId,
+        technology: 'chef',
       });
       expect(mockDeps.x2aDatabase.createModule).toHaveBeenCalledWith({
         name: 'module-b',
         sourcePath: '/cookbooks/b',
         projectId,
+        technology: 'chef',
       });
     });
 
@@ -164,6 +166,7 @@ describe('collectArtifacts routes (actions & signatures)', () => {
         name: 'new-module',
         sourcePath: '/cookbooks/new',
         projectId,
+        technology: undefined,
       });
       expect(mockDeps.x2aDatabase.deleteModule).toHaveBeenCalledTimes(1);
       expect(mockDeps.x2aDatabase.deleteModule).toHaveBeenCalledWith({

workspaces/x2a/plugins/x2a-backend/src/router/modules.ts

@@ -305,6 +305,7 @@ export function registerModuleRoutes(
         callbackUrl,
         moduleId,
         moduleName: module.name,
+        sourceTechnology: module.technology,
         sourceRepo: {
           url: project.sourceRepoUrl,
           branch: project.sourceRepoBranch,

workspaces/x2a/plugins/x2a-backend/src/router/phaseActions.test.ts

@@ -74,11 +74,13 @@ describe('phaseActions', () => {
         name: 'cookbook-a',
         sourcePath: '/cookbooks/a',
         projectId,
+        technology: 'chef',
       });
       expect(context.x2aDatabase.createModule).toHaveBeenCalledWith({
         name: 'cookbook-b',
         sourcePath: '/cookbooks/b',
         projectId,
+        technology: 'chef',
       });
     });
 
@@ -116,6 +118,7 @@ describe('phaseActions', () => {
         name: 'added',
         sourcePath: '/cookbooks/added',
         projectId,
+        technology: undefined,
       });
     });
 

workspaces/x2a/plugins/x2a-backend/src/router/phaseActions.ts

@@ -19,6 +19,7 @@ import type {
   Artifact,
   MigrationPhase,
 } from '@red-hat-developer-hub/backstage-plugin-x2a-common';
+import { normalizeSourceTechnology } from '@red-hat-developer-hub/backstage-plugin-x2a-common';
 
 import type { RouterDeps } from './types';
 
@@ -86,11 +87,20 @@ class InitPhaseAction implements PhaseAction {
 
     await Promise.all(
       toAdd.map(m => {
-        logger.info(`Creating module "${m.name}" for project ${projectId}`);
+        const technology = normalizeSourceTechnology(m.technology);
+        if (m.technology && !technology) {
+          logger.warn(
+            `Unrecognized source technology "${m.technology}" for module "${m.name}" - storing as undefined`,
+          );
+        }
+        logger.info(
+          `Creating module "${m.name}" for project ${projectId} with technology ${technology}`,
+        );
         return x2aDatabase.createModule({
           name: m.name,
           sourcePath: m.path,
           projectId,
+          technology,
         });
       }),
     );