@waron97/prbot 3.1.0 → 3.1.1

package/agrippa_typings/__builtins__.pyi

@@ -75,6 +75,8 @@ FirstArg = TypeVar("FirstArg")
 
 def first(recordset: FirstArg) -> FirstArg: ...
 def format_exc() -> str: ...
+def b64encode(s: bytes) -> bytes: ...
+def b64decode(s: Union[str, bytes]) -> bytes: ...
 
 # --- Exceptions ---
 

package/agrippa_typings/odoo_environment.pyi

@@ -134,9 +134,9 @@ from odoo_records import _UomCategory, _UomUom, _UpdateCadastreData, _UtmCampaig
 from odoo_records import _UtmSource, _UtmStage, _UtmTag, _ValidateAccountMove, _VulnerabilityDashboard, _VulnerabilityDashboardLine
 from odoo_records import _VulnerabilityHistory, _VulnerabilityNotifyAdmissibility, _VulnerabilityNotifyAdmissibilityLine, _VulnerabilityNotifyOutgoing, _WalletImportWizard, _WalletManagementLine
 from odoo_records import _WatchlistAddWizard, _WatchlistDownloadWizard, _WatchlistRemoveWizard, _WebEditorAssets, _WebEditorConverterTest, _WebEditorConverterTestSub
-from odoo_records import _WebTourTour, _WelcomeAttachmentTable, _WelcomeLetterAttachmentMixin, _WizardIrModelMenuCreate, _WizardUploadVulnerability, _X
-from odoo_records import _XCcq, _XMktCom, _XPod, _XPrecheck, _XTopny, _XmlgeneratorDataAggregator
-from odoo_records import _XmlgeneratorDataField, _XmlgeneratorDataModel
+from odoo_records import _WebTourTour, _WelcomeAttachmentTable, _WizardIrModelMenuCreate, _WizardUploadVulnerability, _X, _XCcq
+from odoo_records import _XMktCom, _XPod, _XPrecheck, _XTopny, _XmlgeneratorDataAggregator, _XmlgeneratorDataField
+from odoo_records import _XmlgeneratorDataModel
 
 
 class OdooEnvironment:
@@ -1914,10 +1914,6 @@ class OdooEnvironment:
     @overload
     def __getitem__(self, model_name: Literal["welcome.attachment.table"]) -> _WelcomeAttachmentTable: ...
     @overload
-    def __getitem__(
-        self, model_name: Literal["welcome.letter.attachment.mixin"]
-    ) -> _WelcomeLetterAttachmentMixin: ...
-    @overload
     def __getitem__(self, model_name: Literal["wizard.ir.model.menu.create"]) -> _WizardIrModelMenuCreate: ...
     @overload
     def __getitem__(self, model_name: Literal["wizard.upload.vulnerability"]) -> _WizardUploadVulnerability: ...

package/agrippa_typings/odoo_records.pyi

@@ -7253,6 +7253,7 @@ class _CorrectionInvoice(Recordset):
     def _compute_code_supply_point(self): ...
     def _compute_currency(self): ...
     def _get_symphonie_url(self): ...
+    def download_invoice_data(self): ...
     def download_invoice_pdf(self): ...
 
 # --- create.case ---
@@ -9613,7 +9614,7 @@ class _HelpdeskTicket(Recordset):
     disconnect_date: Optional[_dt.date]
     distributor_charge: float
     distributor_code: str
-    distributor_id: str
+    distributor_id: "_ResPartner"
     distributor_name: str
     distributor_notes: str
     distributor_outcome_reception_date: Optional[_dt.date]
@@ -9790,6 +9791,7 @@ class _HelpdeskTicket(Recordset):
     meter_reading_message: str
     meter_reading_result: str
     meter_readings: str
+    meter_relocation_note: str
     migrated: bool
     mkt_comm_atti_autorizzativi: str
     mkt_comm_causal_code: str
@@ -10262,6 +10264,7 @@ class _HelpdeskTicket(Recordset):
     def ir_cron_registry_change_customer_privacy(self, triplet_code, days_delta, privacy_flag): ...
     def ir_cron_vulnerable_clients_missing_documentation(self): ...
     def kv_store(self) -> "_SymplePbProcessData": ...
+    def last_staging(self, process_name) -> "_SymplePbProcessData": ...
     def launch_cancel_case_wizard(self): ...
     def launch_connect_case_wizard(self): ...
     def launch_connect_parent_wizard(self): ...
@@ -12161,9 +12164,9 @@ class _IrConfigParameter(Recordset):
     def group_by_contract(self, service_point_array): ...
     def imperex_get_values(self): ...
     def patch_asset(self, asset_id, payload, additional_headers=False): ...
-    def prepare_m2c_passthrough_payload(self, case_id, triplet, is_client=True, is_get_client_extended=False, is_validity_date=False, is_split_payment=False, is_contratti_mandato=False, service_points=False, service_points_billing_profile_array=False, is_associazioneContrattoFornitura=False, is_domiciliazione=False, is_ccr=False, is_dpay=False, contatti_array=False, extra_contract_info=False, extra_forniture_info=False, causale_attivazione=False, contrattiDettaglio_array=False, forn_contatti_array=False, contrattiMandatoDettaglio_array=False, is_cCodiceDestinatario=False, is_cCodiceUfficioPA=False, is_cigCup=False, is_contratti=False, is_prodotti=False, causale_cessazione=False, fine_contratto=False, fine_contratto_fornitura=False, is_oneri=False, charge=False, charge_type=False, charge_description=False, cma_array=False, is_codice_offerta=False, garanzia=False, is_contratti_mandato_dInizioValidita=False, protocollo=False, is_rcu=False, oneri_case_type=False, mask=None, is_storno=False, data_storno=False, storno_case_type=False): ...
-    def prepare_m2c_passthrough_payload__nightly(self, case_id, triplet, is_client=True, is_get_client_extended=False, is_validity_date=False, is_split_payment=False, is_contratti_mandato=False, service_points=False, service_points_billing_profile_array=False, is_associazioneContrattoFornitura=False, is_domiciliazione=False, is_ccr=False, is_dpay=False, contatti_array=False, extra_contract_info=False, extra_forniture_info=False, causale_attivazione=False, contrattiDettaglio_array=False, forn_contatti_array=False, contrattiMandatoDettaglio_array=False, is_cCodiceDestinatario=False, is_cCodiceUfficioPA=False, is_cigCup=False, is_contratti=False, is_prodotti=False, causale_cessazione=False, fine_contratto=False, fine_contratto_fornitura=False, is_oneri=False, charge=False, charge_type=False, charge_description=False, cma_array=False, is_codice_offerta=False, garanzia=False, is_contratti_mandato_dInizioValidita=False, protocollo=False, is_rcu=False, oneri_case_type=False, mask=None, is_storno=False, data_storno=False, storno_case_type=False): ...
-    def prepare_m2c_payload(self, case_id, triplet, is_client=True, is_get_client_extended=False, is_validity_date=False, is_split_payment=False, is_contratti_mandato=False, service_points=False, service_points_billing_profile_array=False, is_associazioneContrattoFornitura=False, is_domiciliazione=False, is_ccr=False, is_dpay=False, contatti_array=False, extra_contract_info=False, extra_forniture_info=False, causale_attivazione=False, contrattiDettaglio_array=False, forn_contatti_array=False, contrattiMandatoDettaglio_array=False, is_cCodiceDestinatario=False, is_cCodiceUfficioPA=False, is_cigCup=False, is_contratti=False, is_prodotti=False, causale_cessazione=False, is_oneri=False, charge=False, charge_type=False, charge_description=False, fine_contratto=False, fine_contratto_fornitura=False, cma_array=False, is_codice_offerta=False, garanzia=False, is_contratti_mandato_dInizioValidita=False, protocollo=False, is_rcu=False, oneri_case_type=False, isContrattiOLDAsset=False, is_storno=False, storno_case_type=False, data_storno=False, mask=None): ...
+    def prepare_m2c_passthrough_payload(self, case_id, triplet, is_client=True, is_get_client_extended=False, is_validity_date=False, is_split_payment=False, is_contratti_mandato=False, service_points=False, service_points_billing_profile_array=False, is_associazioneContrattoFornitura=False, is_domiciliazione=False, is_ccr=False, is_dpay=False, contatti_array=False, extra_contract_info=False, extra_forniture_info=False, causale_attivazione=False, contrattiDettaglio_array=False, forn_contatti_array=False, contrattiMandatoDettaglio_array=False, is_cCodiceDestinatario=False, is_cCodiceUfficioPA=False, is_cigCup=False, is_contratti=False, is_prodotti=False, causale_cessazione=False, fine_contratto=False, fine_contratto_fornitura=False, is_oneri=False, charge=False, charge_type=False, charge_description=False, cma_array=False, is_codice_offerta=False, garanzia=False, is_contratti_mandato_dInizioValidita=False, protocollo=False, is_rcu=False, oneri_case_type=False, mask=None, is_storno=False, data_storno=False, storno_case_type=False, service_cell_index=False): ...
+    def prepare_m2c_passthrough_payload__nightly(self, case_id, triplet, is_client=True, is_get_client_extended=False, is_validity_date=False, is_split_payment=False, is_contratti_mandato=False, service_points=False, service_points_billing_profile_array=False, is_associazioneContrattoFornitura=False, is_domiciliazione=False, is_ccr=False, is_dpay=False, contatti_array=False, extra_contract_info=False, extra_forniture_info=False, causale_attivazione=False, contrattiDettaglio_array=False, forn_contatti_array=False, contrattiMandatoDettaglio_array=False, is_cCodiceDestinatario=False, is_cCodiceUfficioPA=False, is_cigCup=False, is_contratti=False, is_prodotti=False, causale_cessazione=False, fine_contratto=False, fine_contratto_fornitura=False, is_oneri=False, charge=False, charge_type=False, charge_description=False, cma_array=False, is_codice_offerta=False, garanzia=False, is_contratti_mandato_dInizioValidita=False, protocollo=False, is_rcu=False, oneri_case_type=False, mask=None, is_storno=False, data_storno=False, storno_case_type=False, service_cell_index=False): ...
+    def prepare_m2c_payload(self, case_id, triplet, is_client=True, is_get_client_extended=False, is_validity_date=False, is_split_payment=False, is_contratti_mandato=False, service_points=False, service_points_billing_profile_array=False, is_associazioneContrattoFornitura=False, is_domiciliazione=False, is_ccr=False, is_dpay=False, contatti_array=False, extra_contract_info=False, extra_forniture_info=False, causale_attivazione=False, contrattiDettaglio_array=False, forn_contatti_array=False, contrattiMandatoDettaglio_array=False, is_cCodiceDestinatario=False, is_cCodiceUfficioPA=False, is_cigCup=False, is_contratti=False, is_prodotti=False, causale_cessazione=False, is_oneri=False, charge=False, charge_type=False, charge_description=False, fine_contratto=False, fine_contratto_fornitura=False, cma_array=False, is_codice_offerta=False, garanzia=False, is_contratti_mandato_dInizioValidita=False, protocollo=False, is_rcu=False, oneri_case_type=False, isContrattiOLDAsset=False, is_storno=False, storno_case_type=False, data_storno=False, mask=None, cella=False): ...
     def process_attributes(self, family, supply_start_date, fonteprezzo): ...
     def process_child_products(self, components, supply_start_date): ...
     def process_family_attributes(self, families, supply_start_date, fonteprezzo): ...
@@ -14565,7 +14568,7 @@ class _M2cActivationDeactivationPayload(Recordset):
     def _M2CActivationDeactivationPayload__smart_patch(self, payload, key, value, on_missing='error'): ...
     def _check_valid_json(self): ...
     def get_payload_with_patch(self, patches=None, on_missing='error'): ...
-    def last(self, cod_pod, payload_type=None): ...
+    def last(self, cod_pod, payload_type=None) -> "_M2cActivationDeactivationPayload": ...
 
 # --- mail.activity ---
 
@@ -16924,7 +16927,7 @@ class _MarketCommEventLog(Recordset):
     def exists(self) -> "_MarketCommEventLog": ...
     def sudo(self) -> "_MarketCommEventLog": ...
     def with_context(self, ctx: Dict[str, Any] = ..., **kwargs: Any) -> "_MarketCommEventLog": ...
-    def last(self, flow_code=None, service_code=None): ...
+    def last(self, flow_code=None, service_code=None) -> "_MarketCommEventLog": ...
 
 # --- market.comm.event.log.cp.utente.filter ---
 
@@ -22540,7 +22543,7 @@ class _ResPartner(Recordset):
     def _avatar_get_placeholder_path(self): ...
     def _build_vat_error_message(self, country_code, wrong_vat, record_label): ...
     def _build_vcard(self): ...
-    def _calculate_service_cell(self): ...
+    def _calculate_service_cell(self, trigger_type='all'): ...
     def _cf_check_birth_data(self, fiscal_code, gender, birth_date): ...
     def _cf_check_city(self, fiscal_code, birth_city): ...
     def _cf_check_name(self, fiscal_code, surname, firstname): ...
@@ -22652,7 +22655,10 @@ class _ResPartner(Recordset):
     def _display_address(self, without_company=False): ...
     def _display_address_depends(self): ...
     def _email_send(self, email_from, subject, body, on_error=None): ...
-    def _evaluate_service_cell_rules(self, target_cell, old_cell, sixty_days, thirteen_months): ...
+    def _eval_cell_monthly_cron(self, target_cell, old_cell, thirteen_months): ...
+    def _eval_cell_realtime(self, target_cell, old_cell): ...
+    def _eval_cell_weekly_cron(self, target_cell, old_cell, sixty_days): ...
+    def _evaluate_service_cell_rules(self, target_cell, old_cell, sixty_days, thirteen_months, trigger_type='all'): ...
     def _fields_sync(self, values): ...
     def _fields_view_get_address(self, arch): ...
     def _find_accounting_partner(self, partner): ...
@@ -22719,6 +22725,7 @@ class _ResPartner(Recordset):
     def _run_vat_test(self, vat_number, default_country, partner_is_company=True): ...
     def _send_to_m2c_passthrough(self): ...
     def _set_calendar_last_notif_ack(self): ...
+    def _should_clear_mm(self, old_cell): ...
     def _signup_retrieve_partner(self, token, check_validity=False, raise_exception=False): ...
     def _sms_get_default_partners(self): ...
     def _split_vat(self, vat): ...
@@ -22804,6 +22811,7 @@ class _ResPartner(Recordset):
     def get_iva_rates(self): ...
     def get_mention_suggestions(self, search, limit=8, channel_id=None): ...
     def get_most_recent_termination_date(self): ...
+    def get_order_sending_date(self, apply_filter=True): ...
     def get_pod_ids_from_service_point_ids(self): ...
     def get_selection_name_value(self, _lang_='it_IT'): ...
     def get_update_client_payload(self, new_status): ...
@@ -30217,6 +30225,7 @@ class _SympleInteraction(Recordset):
     def exists(self) -> "_SympleInteraction": ...
     def sudo(self) -> "_SympleInteraction": ...
     def with_context(self, ctx: Dict[str, Any] = ..., **kwargs: Any) -> "_SympleInteraction": ...
+    def _check_complaint_start_date(self): ...
     def _check_multiple_contacts(self): ...
     def _check_tickets_before_close_interaction(self): ...
     def _checks_before_close_interaction(self): ...
@@ -30605,6 +30614,7 @@ class _SymplePbLauncher(Recordset):
     def _get_elements_eval_context(self, data, model, process, record, user): ...
     def get_event_html(self, res_model_name, res_id, process_key, instance_key): ...
     def get_html(self, model_name, record_id, data, user_id): ...
+    def get_process_elements(self, process_name, model_name, record_id, data, user_id): ...
     def initialize_process(self, process_key, payload): ...
     def which(self, model_name): ...
 
@@ -31311,7 +31321,8 @@ class _SympleRcuLine(Recordset):
     def _inverse_cod_pdr(self): ...
     def _inverse_cod_pod(self): ...
     def action_change_state(self): ...
-    def action_check_cases(self): ...
+    def action_check_activation_cases(self): ...
+    def action_check_deactivation_cases(self): ...
     def action_create_case_when_no_deactivation_cases(self): ...
     def action_refresh_activation(self): ...
     def action_refresh_deactivation(self): ...
@@ -33806,12 +33817,14 @@ class _WelcomeAttachmentTable(Recordset):
     client_type: str
     commodity: str
     dms_attachment_code: str
+    end_date: Optional[_dt.date]
     has_bit2publish_template: bool
     is_placet: bool
     is_unreachable: bool
     request_type: str
     sending_via: str
     show_bit2publish_button: bool
+    start_date: Optional[_dt.date]
     table_type: str
     tension: str
     def browse(self, ids: Union[int, List[int]]) -> "_WelcomeAttachmentTable": ...
@@ -33829,31 +33842,6 @@ class _WelcomeAttachmentTable(Recordset):
     def sudo(self) -> "_WelcomeAttachmentTable": ...
     def with_context(self, ctx: Dict[str, Any] = ..., **kwargs: Any) -> "_WelcomeAttachmentTable": ...
 
-# --- welcome.letter.attachment.mixin ---
-
-class _WelcomeLetterAttachmentMixin(Recordset):
-    bit2publish_template_ids: "_Bit2publishTemplate"
-    has_bit2publish_template: bool
-    show_bit2publish_button: bool
-    def browse(self, ids: Union[int, List[int]]) -> "_WelcomeLetterAttachmentMixin": ...
-    def search(
-        self,
-        domain: List[Any],
-        limit: Optional[int] = None,
-        order: Optional[str] = None,
-        offset: int = 0,
-    ) -> "_WelcomeLetterAttachmentMixin": ...
-    def create(self, vals: Dict[str, Any]) -> "_WelcomeLetterAttachmentMixin": ...
-    def filtered(self, func: Any) -> "_WelcomeLetterAttachmentMixin": ...
-    def sorted(self, key: Any = None, reverse: bool = False) -> "_WelcomeLetterAttachmentMixin": ...
-    def exists(self) -> "_WelcomeLetterAttachmentMixin": ...
-    def sudo(self) -> "_WelcomeLetterAttachmentMixin": ...
-    def with_context(self, ctx: Dict[str, Any] = ..., **kwargs: Any) -> "_WelcomeLetterAttachmentMixin": ...
-    def add_welcome_letter_attachment(self, attachment_codes): ...
-    def get_attachment_id_from_dms(self, path, attachment_name, b2w_url, b2w_token): ...
-    def get_welcome_letter_attachment_codes(self, event_id): ...
-    def welcome_letter_attachments(self, event_id): ...
-
 # --- wizard.ir.model.menu.create ---
 
 class _WizardIrModelMenuCreate(Recordset):

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@waron97/prbot",
-    "version": "3.1.0",
+    "version": "3.1.1",
     "description": "",
     "main": "index.js",
     "scripts": {

package/src/commands/exportEmailTemplates.js

@@ -2,10 +2,19 @@ import fs from 'fs/promises';
 import path from 'path';
 import fetch from 'node-fetch';
 import search from '@inquirer/search';
+import { select, confirm } from '@inquirer/prompts';
 import { getToken } from '../lib/auth.js';
 import { execGit } from '../lib/git.js';
 import { resolveAddonsPath } from '../lib/addons.js';
 import { fuzzyMatch } from '../lib/fuzzy.js';
+import { log, isSilent } from '../lib/logger.js';
+import { verbot } from './ver.js';
+import {
+    readEmailTemplateMappings,
+    detectEmailRenames,
+    computeMigrationVersion,
+    generateEmailPreMigrateScript,
+} from '../lib/premigrate.js';
 
 async function getWorkflows(token) {
     const url = `${process.env.RIP_URL}/symple.workflow/*`;
@@ -89,6 +98,21 @@ async function getModuleChoices() {
         .map((e) => ({ name: e.name, value: e.name }));
 }
 
+async function resolveManifestPath(module, ADDONS_PATH) {
+    for (const candidate of [
+        path.join(ADDONS_PATH, module, '__manifest__.py'),
+        path.join(ADDONS_PATH, 'config', module, '__manifest__.py'),
+    ]) {
+        try {
+            await fs.access(candidate);
+            return candidate;
+        } catch {
+            // try next
+        }
+    }
+    return null;
+}
+
 async function exportEmailTemplates(opts) {
     const token = await getToken();
 
@@ -104,7 +128,7 @@ async function exportEmailTemplates(opts) {
               },
           });
 
-    console.log('Fetching workflows...');
+    log('Fetching workflows...');
     const workflows = await getWorkflows(token);
     const choices = workflows.map((w) => ({ name: w.name, value: w.id }));
 
@@ -121,7 +145,7 @@ async function exportEmailTemplates(opts) {
               },
           });
 
-    console.log(`Fetching email templates for workflow ${workflowId}...`);
+    log(`Fetching email templates for workflow ${workflowId}...`);
     const excludes = opts.exclude ?? [];
     const templates = (await getEmailTemplates(workflowId, token))
         .filter((t) => t.template_code)
@@ -130,7 +154,7 @@ async function exportEmailTemplates(opts) {
         });
 
     if (!templates.length) {
-        console.log('No email templates found for this workflow.');
+        log('No email templates found for this workflow.');
         return;
     }
 
@@ -138,17 +162,75 @@ async function exportEmailTemplates(opts) {
     const dataDir = path.join(ADDONS_PATH, 'config', module, 'data');
     await fs.mkdir(dataDir, { recursive: true });
 
+    const oldMappings = await readEmailTemplateMappings(dataDir);
+
     const outPath = path.join(dataDir, 'mail_template.xml');
     await fs.writeFile(outPath, generateXml(templates), 'utf-8');
-    console.log(`Written: ${outPath}`);
-
-    if (opts.commit !== false) {
-        await execGit(['add', outPath], ADDONS_PATH);
-        await execGit(
-            ['commit', '-m', `[IMP][${module}] Export email templates`],
-            ADDONS_PATH,
-        );
-        console.log('Committed.');
+    log(`Written: ${outPath}`);
+
+    const newMappings = await readEmailTemplateMappings(dataDir);
+    const renamedCodes = detectEmailRenames(oldMappings, newMappings);
+
+    let bumpLevel = opts.bump;
+    if (!bumpLevel) {
+        bumpLevel = await select({
+            message: 'Bump version?',
+            choices: [
+                { name: 'No bump', value: 'none' },
+                { name: 'Patch', value: 'patch' },
+                { name: 'Minor', value: 'minor' },
+                { name: 'Major', value: 'major' },
+            ],
+        });
+    }
+
+    let preMigratePath = null;
+
+    if (renamedCodes.length > 0) {
+        log(`Renamed template_codes (${renamedCodes.length}): ${renamedCodes.join(', ')}`);
+
+        let shouldGenerate = opts.autoPremigrate;
+        if (!shouldGenerate && !isSilent()) {
+            shouldGenerate = await confirm({
+                message: `Detected ${renamedCodes.length} renamed template_code(s). Generate pre-migrate script?`,
+                default: true,
+            });
+        }
+
+        if (shouldGenerate) {
+            const manifestPath = await resolveManifestPath(module, ADDONS_PATH);
+            if (!manifestPath) {
+                log(`Warning: __manifest__.py not found for ${module}, skipping pre-migrate generation`);
+            } else {
+                const version = await computeMigrationVersion(manifestPath, bumpLevel);
+                const migrationDir = path.join(ADDONS_PATH, 'config', module, 'migrations', version);
+                preMigratePath = path.join(migrationDir, 'pre-migrate.py');
+                await fs.mkdir(migrationDir, { recursive: true });
+                await fs.writeFile(preMigratePath, generateEmailPreMigrateScript(renamedCodes));
+                log(`Wrote pre-migrate: ${preMigratePath}`);
+            }
+        }
+    }
+
+    if (opts.commit === false) {
+        if (bumpLevel && bumpLevel !== 'none') {
+            await verbot(module, bumpLevel, { ...opts, commit: false });
+        }
+        return;
+    }
+
+    const filesToAdd = [outPath];
+    if (preMigratePath) filesToAdd.push(preMigratePath);
+
+    for (const filePath of filesToAdd) {
+        await execGit(['add', filePath], ADDONS_PATH);
+    }
+
+    await execGit(['commit', '-m', `[IMP][${module}] Export email templates`], ADDONS_PATH);
+    log('Committed.');
+
+    if (bumpLevel && bumpLevel !== 'none') {
+        await verbot(module, bumpLevel, opts);
     }
 }
 

package/src/commands/exportImperex.js

@@ -6,6 +6,7 @@ import { getToken } from '../lib/auth.js';
 import { execGit } from '../lib/git.js';
 import { resolveAddonsPath } from '../lib/addons.js';
 import { fuzzyMatch } from '../lib/fuzzy.js';
+import { log } from '../lib/logger.js';
 
 const IMPEREX_REL = 'sorgenia_imperex_metadata/migrations/0.0.0/imperex';
 
@@ -56,7 +57,7 @@ async function exportImperex(opts) {
         },
     });
 
-    console.log(`Fetching records for ${model}...`);
+    log(`Fetching records for ${model}...`);
     const records = await listRecords(model, token);
     const recChoices = records.map((r) => ({ name: String(r.name ?? r.id), value: r.id }));
     const recordId = await search({
@@ -67,7 +68,7 @@ async function exportImperex(opts) {
         },
     });
 
-    console.log(`Exporting record ${recordId}...`);
+    log(`Exporting record ${recordId}...`);
     const { attachments } = await exportRecord(model, recordId, token);
 
     const modelDir = path.join(ADDONS_PATH, IMPEREX_REL, model);
@@ -78,7 +79,7 @@ async function exportImperex(opts) {
         if (att.name === '__manifest__.yaml') continue;
         const destPath = path.join(modelDir, path.basename(att.name));
         await fs.writeFile(destPath, att.content, 'utf-8');
-        console.log(`Written: ${destPath}`);
+        log(`Written: ${destPath}`);
         saved.push(destPath);
     }
 
@@ -90,7 +91,7 @@ async function exportImperex(opts) {
             ['commit', '-m', `[IMP][sorgenia_imperex_metadata] update ${model} record`],
             ADDONS_PATH,
         );
-        console.log('Committed.');
+        log('Committed.');
     }
 }
 

package/src/commands/exportLrp.js

@@ -5,10 +5,7 @@ import search from '@inquirer/search';
 import { getToken } from '../lib/auth.js';
 import { execGit } from '../lib/git.js';
 import { resolveAddonsPath } from '../lib/addons.js';
-import { fuzzyMatch } from '../lib/fuzzy.js';
-import { CONFIG_DIR } from '../config.js';
-
-const CACHE_FILE = path.join(CONFIG_DIR, 'lrp_processes_cache.json');
+import { log } from '../lib/logger.js';
 
 function getSymphonyBase() {
     const url = process.env.IMPORTEXPORT_URL;
@@ -17,13 +14,16 @@ function getSymphonyBase() {
     return `${parsed.protocol}//${parsed.host}`;
 }
 
-async function fetchProcessList(token, signal) {
+async function fetchProcesses(token, nameFilter, signal) {
     const base = getSymphonyBase();
-    const params = encodeURIComponent(JSON.stringify({ page: 1, size: 1000, sorters: [], filters: [] }));
+    const size = nameFilter ? 20 : 12;
+    const params = encodeURIComponent(
+        JSON.stringify({ page: 1, size, sorters: [], filters: [] })
+    );
     const otherfilters = encodeURIComponent(
         JSON.stringify([
             { field: 'id', type: '=', value: null },
-            { field: 'name', type: 'like', value: null },
+            { field: 'name', type: 'like', value: nameFilter ?? null },
             { field: 'tenantId', type: '=', value: null },
             { field: 'latestVersion', type: '=', value: true },
         ])
@@ -53,24 +53,6 @@ async function fetchProcessList(token, signal) {
     return items;
 }
 
-async function loadCache() {
-    try {
-        const data = await fs.readFile(CACHE_FILE, 'utf-8');
-        return JSON.parse(data);
-    } catch {
-        return null;
-    }
-}
-
-async function saveCache(items) {
-    try {
-        await fs.mkdir(path.dirname(CACHE_FILE), { recursive: true });
-        await fs.writeFile(CACHE_FILE, JSON.stringify(items));
-    } catch {
-        // non-fatal
-    }
-}
-
 async function fetchProcessDetail(id, token) {
     const base = getSymphonyBase();
     const url = `${base}/symphony/restInfo/ajax/tabulator/id/${id}?connector=SymphBpmnFileTabCon&modelroot=/management/development/edit`;
@@ -118,41 +100,30 @@ async function findExistingFile(baseDir, filename) {
 async function exportLrp(opts) {
     const token = await getToken();
 
-    // choices is a mutable ref so source() sees background updates live
-    let choices = [];
+    log('Fetching processes...');
+    const initialItems = await fetchProcesses(token, null);
+    const initialChoices = initialItems.map((p) => ({ name: p.name, value: p.id }));
 
-    const cached = await loadCache();
-
-    const bgController = new AbortController();
-
-    if (cached) {
-        choices = cached.map((p) => ({ name: p.name, value: p.id }));
-        console.log(`Loaded ${choices.length} processes from cache. Fetching fresh list in background (~1 min) — results update as you type.`);
-        fetchProcessList(token, bgController.signal)
-            .then(async (fresh) => {
-                await saveCache(fresh);
-                const updated = fresh.map((p) => ({ name: p.name, value: p.id }));
-                choices.length = 0;
-                choices.push(...updated);
-            })
-            .catch(() => {});
-    } else {
-        console.log('No cache found. Fetching process list (~1 min)...');
-        const items = await fetchProcessList(token);
-        await saveCache(items);
-        choices = items.map((p) => ({ name: p.name, value: p.id }));
-        console.log(`Loaded ${choices.length} processes.`);
-    }
+    let searchController = null;
 
     const selectedId = await search({
         message: 'Select LRP process to export:',
         source: async (input) => {
-            if (!input) return choices;
-            return choices.filter((c) => fuzzyMatch(c.name, input));
+            if (!input) return initialChoices;
+
+            if (searchController) searchController.abort();
+            searchController = new AbortController();
+
+            try {
+                const items = await fetchProcesses(token, input, searchController.signal);
+                return items.map((p) => ({ name: p.name, value: p.id }));
+            } catch {
+                return initialChoices;
+            }
         },
     });
 
-    console.log('Fetching process detail...');
+    log('Fetching process detail...');
     const jsText = await fetchProcessDetail(selectedId, token);
     const { xml, filename } = extractBpmnData(jsText);
     const bpmnFilename = `${filename.replace(/^B2WA_/, '')}.bpmn20.xml`;
@@ -165,21 +136,19 @@ async function exportLrp(opts) {
     if (existing) {
         savePath = existing;
         await fs.writeFile(savePath, xml, 'utf-8');
-        console.log(`Updated: ${savePath}`);
+        log(`Updated: ${savePath}`);
     } else {
         savePath = path.join(processesDir, 'all', bpmnFilename);
         await fs.mkdir(path.dirname(savePath), { recursive: true });
         await fs.writeFile(savePath, xml, 'utf-8');
-        console.log(`Created: ${savePath}`);
+        log(`Created: ${savePath}`);
     }
 
     if (opts.commit !== false) {
         await execGit(['add', savePath], ADDONS_PATH);
         await execGit(['commit', '-m', '[IMP][.cloudbuild] Update long running process'], ADDONS_PATH);
-        console.log('Committed.');
+        log('Committed.');
     }
-
-    bgController.abort();
 }
 
 export { exportLrp };

package/src/commands/exportPb.js

@@ -6,6 +6,7 @@ import { getToken } from '../lib/auth.js';
 import { execGit } from '../lib/git.js';
 import { resolveAddonsPath } from '../lib/addons.js';
 import { fuzzyMatch } from '../lib/fuzzy.js';
+import { log } from '../lib/logger.js';
 
 async function getProcessList(token) {
     const url = `${process.env.IMPORTEXPORT_URL}/object/process_builder?addLanguageParam=true`;
@@ -120,14 +121,14 @@ async function exportPb(opts) {
     const { guid, document_id } = selected;
     const filename = `${document_id}.zip`;
 
-    console.log(`Initiating export for ${document_id}...`);
+    log(`Initiating export for ${document_id}...`);
     const requestTime = Date.now();
     await initiateExport(guid, token);
 
-    console.log('Waiting for export to complete...');
+    log('Waiting for export to complete...');
     const requestId = await pollExportResult(guid, requestTime, token);
 
-    console.log(`Downloading ${filename}...`);
+    log(`Downloading ${filename}...`);
     const zipBuffer = await downloadZip(requestId, token);
 
     const ADDONS_PATH = resolveAddonsPath(process.env.ADDONS_PATH);
@@ -138,18 +139,18 @@ async function exportPb(opts) {
     if (existing) {
         savePath = existing;
         await fs.writeFile(savePath, zipBuffer);
-        console.log(`Updated existing file at ${savePath}`);
+        log(`Updated existing file at ${savePath}`);
     } else {
         savePath = path.join(processesDir, 'all', filename);
         await fs.mkdir(path.dirname(savePath), { recursive: true });
         await fs.writeFile(savePath, zipBuffer);
-        console.log(`Created new file at ${savePath}`);
+        log(`Created new file at ${savePath}`);
     }
 
     if (opts.commit !== false) {
         await execGit(['add', savePath], ADDONS_PATH);
         await execGit(['commit', '-m', '[IMP][.cloudbuild] Update wizard'], ADDONS_PATH);
-        console.log('Committed.');
+        log('Committed.');
     }
 }
 

package/src/commands/exportWorkflow.js

@@ -1,11 +1,19 @@
 import fs from 'fs/promises';
 import path from 'path';
 import search from '@inquirer/search';
-import { select } from '@inquirer/prompts';
+import { select, confirm } from '@inquirer/prompts';
 import { resolveAddonsPath } from '../lib/addons.js';
 import { fuzzyMatch } from '../lib/fuzzy.js';
+import { execGit } from '../lib/git.js';
+import { log, isSilent } from '../lib/logger.js';
 import { runPr } from './pr.js';
 import { verbot } from './ver.js';
+import {
+    readWorkflowMappings,
+    detectRenames,
+    computeMigrationVersion,
+    generatePreMigrateScript,
+} from '../lib/premigrate.js';
 
 async function getModuleChoices() {
     const ADDONS_PATH = resolveAddonsPath(process.env.ADDONS_PATH);
@@ -16,17 +24,46 @@ async function getModuleChoices() {
         .map((e) => ({ name: e.name, value: e.name }));
 }
 
+async function resolveManifestPath(module, ADDONS_PATH) {
+    for (const candidate of [
+        path.join(ADDONS_PATH, module, '__manifest__.py'),
+        path.join(ADDONS_PATH, 'config', module, '__manifest__.py'),
+    ]) {
+        try {
+            await fs.access(candidate);
+            return candidate;
+        } catch {
+            // try next
+        }
+    }
+    return null;
+}
+
 async function exportWorkflow(opts) {
-    const moduleChoices = await getModuleChoices();
-    const module = await search({
-        message: 'Select module:',
-        source: async (input) => {
-            if (!input) return moduleChoices;
-            return moduleChoices.filter((c) => fuzzyMatch(c.name, input));
-        },
-    });
+    let module;
+    if (opts.module) {
+        module = opts.module;
+    } else {
+        const moduleChoices = await getModuleChoices();
+        module = await search({
+            message: 'Select module:',
+            source: async (input) => {
+                if (!input) return moduleChoices;
+                return moduleChoices.filter((c) => fuzzyMatch(c.name, input));
+            },
+        });
+    }
 
-    await runPr(module, opts);
+    const ADDONS_PATH = resolveAddonsPath(process.env.ADDONS_PATH);
+    const dataDir = path.join(ADDONS_PATH, 'config', module, 'data');
+
+    const oldMappings = await readWorkflowMappings(dataDir);
+
+    await runPr(module, { ...opts, commit: false });
+
+    const newMappings = await readWorkflowMappings(dataDir);
+    const renames = detectRenames(oldMappings, newMappings);
+    const hasRenames = renames.stateCodes.length > 0 || renames.phaseCodes.length > 0;
 
     let bumpLevel = opts.bump;
     if (!bumpLevel) {
@@ -41,6 +78,60 @@ async function exportWorkflow(opts) {
         });
     }
 
+    let preMigratePath = null;
+
+    if (hasRenames) {
+        if (renames.stateCodes.length > 0) {
+            log(`Renamed state_codes (${renames.stateCodes.length}): ${renames.stateCodes.join(', ')}`);
+        }
+        if (renames.phaseCodes.length > 0) {
+            log(`Renamed phase_codes (${renames.phaseCodes.length}): ${renames.phaseCodes.join(', ')}`);
+        }
+
+        let shouldGenerate = opts.autoPremigrate;
+        if (!shouldGenerate && !isSilent()) {
+            shouldGenerate = await confirm({
+                message: `Detected ${renames.stateCodes.length} renamed state_code(s) and ${renames.phaseCodes.length} renamed phase_code(s). Generate pre-migrate script?`,
+                default: true,
+            });
+        }
+
+        if (shouldGenerate) {
+            const manifestPath = await resolveManifestPath(module, ADDONS_PATH);
+            if (!manifestPath) {
+                log(`Warning: __manifest__.py not found for ${module}, skipping pre-migrate generation`);
+            } else {
+                const version = await computeMigrationVersion(manifestPath, bumpLevel);
+                const migrationDir = path.join(ADDONS_PATH, 'config', module, 'migrations', version);
+                preMigratePath = path.join(migrationDir, 'pre-migrate.py');
+                await fs.mkdir(migrationDir, { recursive: true });
+                await fs.writeFile(preMigratePath, generatePreMigrateScript(renames.stateCodes, renames.phaseCodes));
+                log(`Wrote pre-migrate: ${preMigratePath}`);
+            }
+        }
+    }
+
+    if (opts.commit === false) {
+        if (bumpLevel && bumpLevel !== 'none') {
+            await verbot(module, bumpLevel, { ...opts, commit: false });
+        }
+        return;
+    }
+
+    const filesToAdd = [
+        path.join(dataDir, 'workflow_missing_relations.xml'),
+        path.join(dataDir, 'workflow_configuration.xml'),
+    ];
+    if (preMigratePath) filesToAdd.push(preMigratePath);
+
+    for (const filePath of filesToAdd) {
+        await execGit(['add', filePath], ADDONS_PATH);
+    }
+
+    const commitMessage = `[IMP][${module}] Update workflow`;
+    await execGit(['commit', '-m', commitMessage], ADDONS_PATH);
+    log(`Committed with message: ${commitMessage}`);
+
     if (bumpLevel && bumpLevel !== 'none') {
         await verbot(module, bumpLevel, opts);
     }

package/src/commands/pr.js

@@ -1,9 +1,10 @@
-import { execFile } from 'child_process';
 import fs from 'fs/promises';
 import path from 'path';
 import fetch from 'node-fetch';
 import { resolveAddonsPath } from '../lib/addons.js';
 import { getToken } from '../lib/auth.js';
+import { execGit } from '../lib/git.js';
+import { log } from '../lib/logger.js';
 
 async function getFiles(module_name, token) {
     const url = `${process.env.RIP_URL}/ir.model/xml_prbot`;
@@ -66,7 +67,7 @@ async function runPr(module_name, opts = {}) {
 
         await fs.mkdir(path.dirname(destPath), { recursive: true });
         await fs.writeFile(destPath, content);
-        console.log(`Processed: ${file.name} -> ${destPath}`);
+        log(`Processed: ${file.name} -> ${destPath}`);
     }
 
     if (opts.commit === false) return;
@@ -78,23 +79,13 @@ async function runPr(module_name, opts = {}) {
     ];
 
     for (const filePath of filesToAdd) {
-        await new Promise((resolve, reject) => {
-            execFile('git', ['add', filePath], { cwd: ADDONS_PATH }, (error) => {
-                if (error) reject(error);
-                else resolve();
-            });
-        });
+        await execGit(['add', filePath], ADDONS_PATH);
     }
 
     const commitMessage = `[IMP][${module_name}] Update workflow`;
-    await new Promise((resolve, reject) => {
-        execFile('git', ['commit', '-m', commitMessage], { cwd: ADDONS_PATH }, (error) => {
-            if (error) reject(error);
-            else resolve();
-        });
-    });
-
-    console.log(`Committed with message: ${commitMessage}`);
+    await execGit(['commit', '-m', commitMessage], ADDONS_PATH);
+
+    log(`Committed with message: ${commitMessage}`);
 }
 
 async function main(module_name) {

package/src/commands/routine.js

@@ -0,0 +1,99 @@
+import { existsSync, readFileSync } from 'fs';
+import path from 'path';
+import { parse } from 'yaml';
+import { select } from '@inquirer/prompts';
+import { CONFIG_DIR } from '../config.js';
+import { setSilent } from '../lib/logger.js';
+import { exportWorkflow } from './exportWorkflow.js';
+import { exportPb } from './exportPb.js';
+import { exportImperex } from './exportImperex.js';
+import { exportEmailTemplates } from './exportEmailTemplates.js';
+import { exportLrp } from './exportLrp.js';
+
+const ROUTINES_FILE = path.join(CONFIG_DIR, 'routines.yaml');
+const WORKSPACE_FILE = 'agrippa.yaml';
+
+const COMMAND_MAP = {
+    'export workflow': exportWorkflow,
+    'export pb': exportPb,
+    'export imperex': exportImperex,
+    'export lrp': exportLrp,
+    'export email-templates': exportEmailTemplates,
+};
+
+function loadRoutines() {
+    const routines = [];
+
+    if (existsSync(ROUTINES_FILE)) {
+        const config = parse(readFileSync(ROUTINES_FILE, 'utf-8'));
+        if (config?.routines) routines.push(...config.routines);
+    }
+
+    if (existsSync(WORKSPACE_FILE)) {
+        const config = parse(readFileSync(WORKSPACE_FILE, 'utf-8'));
+        if (config?.routines) routines.push(...config.routines);
+    }
+
+    return routines;
+}
+
+function stepOpts(step) {
+    const opts = { bump: step.bump ?? 'none' };
+    if (step.module) opts.module = step.module;
+    if (step.workflow) opts.workflow = step.workflow;
+    if (step.exclude) opts.exclude = step.exclude;
+    if (step.no_commit) opts.commit = false;
+    if (step.auto_premigrate) opts.autoPremigrate = true;
+    return opts;
+}
+
+function isNothingToCommit(err) {
+    return err?.gitOutput?.includes('nothing to commit');
+}
+
+async function runRoutine(routine) {
+    console.log(`Running Routine: ${routine.name}`);
+
+    for (const step of routine.steps) {
+        const label = `[${step.name}]`;
+        const fn = COMMAND_MAP[step.command];
+        if (!fn) {
+            console.log(`${label} Unknown command: ${step.command}`);
+            continue;
+        }
+
+        console.log(`${label} Job started`);
+        setSilent(true);
+
+        try {
+            await fn(stepOpts(step));
+            console.log(`${label} Done (committed)`);
+        } catch (err) {
+            if (isNothingToCommit(err)) {
+                console.log(`${label} Done (nothing to commit)`);
+            } else {
+                console.log(`${label} Failed: ${err.message}`);
+            }
+        } finally {
+            setSilent(false);
+        }
+    }
+}
+
+async function routine() {
+    const routines = loadRoutines();
+
+    if (!routines.length) {
+        console.log('No routines defined. Create ~/.config/prbot/routines.yaml or add routines: to agrippa.yaml.');
+        return;
+    }
+
+    const selected = await select({
+        message: 'Select routine:',
+        choices: routines.map((r) => ({ name: r.name, value: r })),
+    });
+
+    await runRoutine(selected);
+}
+
+export { routine };

package/src/commands/ver.js

@@ -1,7 +1,8 @@
-import { execFile } from 'child_process';
 import fs from 'fs/promises';
 import path from 'path';
 import { resolveAddonsPath } from '../lib/addons.js';
+import { execGit } from '../lib/git.js';
+import { log } from '../lib/logger.js';
 
 async function verbot(module_name, level, opts = {}) {
     if (!['major', 'minor', 'patch'].includes(level)) {
@@ -50,26 +51,16 @@ async function verbot(module_name, level, opts = {}) {
     );
 
     await fs.writeFile(manifestPath, newContent);
-    console.log(`Updated version: ${currentVersion} -> ${newVersion}`);
+    log(`Updated version: ${currentVersion} -> ${newVersion}`);
 
     if (opts.commit === false) return;
 
-    await new Promise((resolve, reject) => {
-        execFile('git', ['add', manifestPath], { cwd: ADDONS_PATH }, (error) => {
-            if (error) reject(error);
-            else resolve();
-        });
-    });
+    await execGit(['add', manifestPath], ADDONS_PATH);
 
     const commitMessage = `[VER][${module_name}] Bump`;
-    await new Promise((resolve, reject) => {
-        execFile('git', ['commit', '-m', commitMessage], { cwd: ADDONS_PATH }, (error) => {
-            if (error) reject(error);
-            else resolve();
-        });
-    });
+    await execGit(['commit', '-m', commitMessage], ADDONS_PATH);
 
-    console.log(`Committed with message: ${commitMessage}`);
+    log(`Committed with message: ${commitMessage}`);
 }
 
 export { verbot };

package/src/index.js

@@ -6,11 +6,13 @@ import { autopr } from './commands/autopr.js';
 import { changelog } from './commands/changelog.js';
 import { commit } from './commands/commit.js';
 import { exportPb, exportRip, exportImperex, exportEmailTemplates, exportWorkflow, exportLrp } from './commands/export.js';
+import { routine } from './commands/routine.js';
 import { init } from './commands/init.js';
 import { main as prMain } from './commands/pr.js';
 import { verbot } from './commands/ver.js';
 import { CONFIG_FILE } from './config.js';
 import { checkForUpdate, currentVersion } from './lib/updateCheck.js';
+import { setSilent } from './lib/logger.js';
 
 configDotenv({ path: CONFIG_FILE, quiet: true });
 
@@ -93,9 +95,13 @@ exportCmd
     .command('workflow')
     .option('--no-commit')
     .option('-b, --bump <level>', 'Version bump level (patch, minor, major)')
+    .option('-m, --module <id>', 'Module/workflow ID to export (skips interactive selection)')
+    .option('-s, --silent', 'Suppress all output and swallow errors')
+    .option('--auto-premigrate', 'Auto-generate pre-migrate script when XML ID renames are detected (no prompt)')
     .action((opts) => {
+        if (opts.silent) setSilent(true);
         exportWorkflow(opts).catch((err) => {
-            throw err;
+            if (!opts.silent) throw err;
         });
     });
 
@@ -104,42 +110,58 @@ exportCmd.command('rip').action(() => exportRip());
 exportCmd
     .command('pb')
     .option('--no-commit')
+    .option('-s, --silent', 'Suppress all output and swallow errors')
     .action((opts) => {
+        if (opts.silent) setSilent(true);
         exportPb(opts).catch((err) => {
-            throw err;
+            if (!opts.silent) throw err;
         });
     });
 
 exportCmd
     .command('imperex')
     .option('--no-commit')
+    .option('-s, --silent', 'Suppress all output and swallow errors')
     .action((opts) => {
+        if (opts.silent) setSilent(true);
         exportImperex(opts).catch((err) => {
-            throw err;
+            if (!opts.silent) throw err;
         });
     });
 
 exportCmd
     .command('lrp')
     .option('--no-commit')
+    .option('-s, --silent', 'Suppress all output and swallow errors')
     .action((opts) => {
+        if (opts.silent) setSilent(true);
         exportLrp(opts).catch((err) => {
-            throw err;
+            if (!opts.silent) throw err;
         });
     });
 
 exportCmd
     .command('email-templates')
     .option('--no-commit')
+    .option('-b, --bump <level>', 'Version bump level (patch, minor, major)')
     .option('-e, --exclude <value...>', 'exclude templates matching id, name, or template_code')
     .option('-m, --module <name>', 'module directory name (skip prompt)')
     .option('-w, --workflow <value>', 'workflow name or id (skip prompt)')
+    .option('-s, --silent', 'Suppress all output and swallow errors')
+    .option('--auto-premigrate', 'Auto-generate pre-migrate script when XML ID renames are detected (no prompt)')
     .action((opts) => {
+        if (opts.silent) setSilent(true);
         exportEmailTemplates(opts).catch((err) => {
-            throw err;
+            if (!opts.silent) throw err;
         });
     });
 
+program.command('routine').action(() => {
+    routine().catch((err) => {
+        throw err;
+    });
+});
+
 program.command('update').action(() => {
     console.log('Updating prbot...');
     execFile('npm', ['i', '-g', '@waron97/prbot'], (error, stdout, stderr) => {

package/src/lib/git.js

@@ -3,8 +3,12 @@ import { execFile } from 'child_process';
 function execGit(args, cwd) {
     return new Promise((resolve, reject) => {
         execFile('git', args, { cwd }, (error, stdout) => {
-            if (error) reject(error);
-            else resolve(stdout);
+            if (error) {
+                error.gitOutput = stdout;
+                reject(error);
+            } else {
+                resolve(stdout);
+            }
         });
     });
 }

package/src/lib/logger.js

@@ -0,0 +1,15 @@
+let silent = false;
+
+function setSilent(value) {
+    silent = value;
+}
+
+function isSilent() {
+    return silent;
+}
+
+function log(...args) {
+    if (!silent) console.log(...args);
+}
+
+export { setSilent, isSilent, log };

package/src/lib/premigrate.js

@@ -0,0 +1,223 @@
+import fs from 'fs/promises';
+import path from 'path';
+
+function parseXmlMappings(content) {
+    const phases = new Map();
+    const results = new Map();
+
+    const chunks = content.split('<record ');
+    for (const chunk of chunks) {
+        const idMatch = chunk.match(/^id="([^"]+)"/);
+        if (!idMatch) continue;
+        const xmlId = idMatch[1];
+
+        const modelMatch = chunk.match(/model="(symple\.triplet\.phase(?:\.result)?)"/);
+        if (!modelMatch) continue;
+        const model = modelMatch[1];
+
+        if (model === 'symple.triplet.phase') {
+            const codeMatch = chunk.match(/<field name="phase_code">([^<]+)<\/field>/);
+            if (codeMatch) phases.set(codeMatch[1].trim(), xmlId);
+        } else if (model === 'symple.triplet.phase.result') {
+            const codeMatch = chunk.match(/<field name="state_code">([^<]+)<\/field>/);
+            if (codeMatch) results.set(codeMatch[1].trim(), xmlId);
+        }
+    }
+
+    return { phases, results };
+}
+
+async function readWorkflowMappings(dataDir) {
+    const phases = new Map();
+    const results = new Map();
+
+    const files = ['workflow_configuration.xml', 'workflow_missing_relations.xml'];
+    for (const filename of files) {
+        try {
+            const content = await fs.readFile(path.join(dataDir, filename), 'utf-8');
+            const { phases: p, results: r } = parseXmlMappings(content);
+            for (const [k, v] of p) phases.set(k, v);
+            for (const [k, v] of r) results.set(k, v);
+        } catch {
+            // file doesn't exist yet; skip
+        }
+    }
+
+    return { phases, results };
+}
+
+function detectRenames(oldMaps, newMaps) {
+    const stateCodes = [];
+    const phaseCodes = [];
+
+    for (const [code, oldXmlId] of oldMaps.results) {
+        const newXmlId = newMaps.results.get(code);
+        if (newXmlId && newXmlId !== oldXmlId) stateCodes.push(code);
+    }
+
+    for (const [code, oldXmlId] of oldMaps.phases) {
+        const newXmlId = newMaps.phases.get(code);
+        if (newXmlId && newXmlId !== oldXmlId) phaseCodes.push(code);
+    }
+
+    return { stateCodes, phaseCodes };
+}
+
+async function computeMigrationVersion(manifestPath, bumpLevel) {
+    const content = await fs.readFile(manifestPath, 'utf-8');
+    const versionMatch = content.match(/"version":\s*"(15\.0\.\d+\.\d+\.\d+)"/);
+    if (!versionMatch) throw new Error('Version not found in manifest');
+
+    const parts = versionMatch[1].split('.');
+    const base = `${parts[0]}.${parts[1]}`;
+    const major = parseInt(parts[2]);
+    const minor = parseInt(parts[3]);
+    const patch = parseInt(parts[4]);
+
+    if (bumpLevel === 'major') return `${base}.${major + 1}.0.0`;
+    if (bumpLevel === 'minor') return `${base}.${major}.${minor + 1}.0`;
+    if (bumpLevel === 'patch') return `${base}.${major}.${minor}.${patch + 1}`;
+    return `${base}.${major}.${minor + 1}.0`;
+}
+
+function generatePreMigrateScript(stateCodes, phaseCodes) {
+    const lines = [
+        '# Copyright 2025-TODAY Symphonie Prime S.r.l. (www.symphonieprime.com)',
+        '# All rights reserved.',
+        '',
+        'from openupgradelib import openupgrade',
+        '',
+        '',
+        '@openupgrade.migrate()',
+        'def migrate(env, version):',
+        '    env.cr.execute(',
+        '        "SELECT 1 FROM information_schema.tables WHERE table_name = %s",',
+        '        ("symple_triplet_phase_result",),',
+        '    )',
+        '    if not env.cr.fetchone():',
+        '        return',
+    ];
+
+    if (stateCodes.length > 0) {
+        lines.push('');
+        if (stateCodes.length === 1) {
+            lines.push(`    state_codes = ("${stateCodes[0]}",)`);
+        } else {
+            lines.push('    state_codes = (');
+            for (const code of stateCodes) lines.push(`        "${code}",`);
+            lines.push('    )');
+        }
+        lines.push(
+            '    env.cr.execute(',
+            '        "DELETE FROM result_code_configurator WHERE triplet_phase_result_id IN (SELECT id FROM symple_triplet_phase_result WHERE state_code IN %s)",',
+            '        (state_codes,),',
+            '    )',
+            '    env.cr.execute(',
+            '        "DELETE FROM symple_triplet_phase_result WHERE state_code IN %s",',
+            '        (state_codes,),',
+            '    )',
+        );
+    }
+
+    if (phaseCodes.length > 0) {
+        lines.push('');
+        if (phaseCodes.length === 1) {
+            lines.push(`    phase_codes = ("${phaseCodes[0]}",)`);
+        } else {
+            lines.push('    phase_codes = (');
+            for (const code of phaseCodes) lines.push(`        "${code}",`);
+            lines.push('    )');
+        }
+        lines.push(
+            '    env.cr.execute(',
+            '        "DELETE FROM symple_triplet_phase WHERE phase_code IN %s",',
+            '        (phase_codes,),',
+            '    )',
+        );
+    }
+
+    return lines.join('\n') + '\n';
+}
+
+function parseEmailTemplateMappings(content) {
+    const templates = new Map();
+
+    const chunks = content.split('<record ');
+    for (const chunk of chunks) {
+        const idMatch = chunk.match(/^id="([^"]+)"/);
+        if (!idMatch) continue;
+        const xmlId = idMatch[1];
+
+        if (!chunk.match(/model="mail\.template"/)) continue;
+
+        const codeMatch = chunk.match(/<field name="template_code">([^<]+)<\/field>/);
+        if (codeMatch) templates.set(codeMatch[1].trim(), xmlId);
+    }
+
+    return templates;
+}
+
+async function readEmailTemplateMappings(dataDir) {
+    try {
+        const content = await fs.readFile(path.join(dataDir, 'mail_template.xml'), 'utf-8');
+        return parseEmailTemplateMappings(content);
+    } catch {
+        return new Map();
+    }
+}
+
+function detectEmailRenames(oldMap, newMap) {
+    const templateCodes = [];
+    for (const [code, oldXmlId] of oldMap) {
+        const newXmlId = newMap.get(code);
+        if (newXmlId && newXmlId !== oldXmlId) templateCodes.push(code);
+    }
+    return templateCodes;
+}
+
+function generateEmailPreMigrateScript(templateCodes) {
+    const lines = [
+        '# Copyright 2025-TODAY Symphonie Prime S.r.l. (www.symphonieprime.com)',
+        '# All rights reserved.',
+        '',
+        'from openupgradelib import openupgrade',
+        '',
+        '',
+        '@openupgrade.migrate()',
+        'def migrate(env, version):',
+        '    env.cr.execute(',
+        '        "SELECT 1 FROM information_schema.tables WHERE table_name = %s",',
+        '        ("mail_template",),',
+        '    )',
+        '    if not env.cr.fetchone():',
+        '        return',
+        '',
+    ];
+
+    if (templateCodes.length === 1) {
+        lines.push(`    template_codes = ("${templateCodes[0]}",)`);
+    } else {
+        lines.push('    template_codes = (');
+        for (const code of templateCodes) lines.push(`        "${code}",`);
+        lines.push('    )');
+    }
+
+    lines.push(
+        '    env.cr.execute(',
+        '        "DELETE FROM mail_template WHERE template_code IN %s",',
+        '        (template_codes,),',
+        '    )',
+    );
+
+    return lines.join('\n') + '\n';
+}
+
+export {
+    readWorkflowMappings,
+    detectRenames,
+    computeMigrationVersion,
+    generatePreMigrateScript,
+    readEmailTemplateMappings,
+    detectEmailRenames,
+    generateEmailPreMigrateScript,
+};