aiup-alfresco

Runs AIUP Alfresco extension workflow steps (requirements, scaffold, content-model, web-scripts, docker-compose, test, and more). Use when the user asks to execute an AIUP command or develop Alfresco extensions following AGENTS.md.

Generate Share share-config-custom.xml (META-INF/), DocLib UI actions, rule-action UI, evaluators, indicators, forms, and related web-extension files for legacy Share UI.

Validates custom Alfresco audit application XML for well-formedness, correct audit model namespace, application key matching the enable property, and every RecordValue dataExtractor/dataGenerator referencing a declared and registered bean. Trigger automatically after generating or editing a *-audit.xml or an audit *DataExtractor.java / *DataGenerator.java file.

Generate a custom Alfresco audit application (audit XML + data extractors/generators + enable properties) and optional query Web Script. In-Process SDK (Maven) only.

Validates Alfresco content model XML files for correct namespace URI format, mandatory type/aspect declarations, valid property data types, and absence of reserved prefixes (sys:, cm:, app:). Trigger automatically when generating or editing *-model*.xml or *-context.xml files.

Scaffold a custom Alfresco ContentStore connector (extending AbstractContentStore, optionally wrapping a caching or encrypting store) with its reader/writer, Spring wiring, and unit test. In-Process SDK (Maven) only.

Scaffold a custom Alfresco metadata extractor/embedder (extending AbstractMappingMetadataExtracter) with a properties mapping file, Spring registration, and unit test. In-Process SDK (Maven) only.

Validates custom Alfresco permission model XML for well-formedness, no collision with built-in permission group names, correct permissionSet binding, and that any dynamic authority is registered and implements DynamicAuthority. Trigger automatically after generating or editing a *permissionDefinitions.xml or a *DynamicAuthority.java file.

Generate custom Alfresco permission groups and permissions (permissionDefinitions.xml extension) plus optional dynamic authorities, Spring registration, and unit test. In-Process SDK (Maven) only.

Generate a modern ACS v1 Public REST API resource (annotation-based @EntityResource / @RelationshipResource with @WebApiDescription) plus model POJO, Spring registration, and unit test. In-Process SDK (Maven) only.

Validates Alfresco v1 Public REST API resources for correct annotations (@EntityResource / @RelationshipResource), required @WebApiDescription on every action method, a single @UniqueId on the model POJO, paged collection returns, and absence of classic Web Script anti-patterns. Trigger automatically after generating or editing files under a rest/ package or any class annotated @EntityResource / @RelationshipResource.

Scaffold a custom Alfresco subsystem (ChildApplicationContextFactory + default/instance properties) or, in authentication mode, configure a custom authentication chain / external IdP (LDAP, identity-service/OIDC, external). In-Process SDK (Maven) / config.

Scaffold a full ACA/ADW UI extension: plugin.json descriptor, provideExtension() providers function, NgRx actions and effects, Angular standalone components for the requested extension points (page, sidebar, context menu, toolbar), HTTP service, and integration patch instructions for extensions.module.ts, project.json, and app.config.json.

Scaffold Alfresco ActionExecuter classes with Spring bean registration. In-Process SDK (Maven) only.

Generate Share Aikau page and dashlet artefacts for legacy Share UI customizations.

Scaffold Alfresco behaviour/policy classes with Spring bean wiring. In-Process SDK (Maven) only.

Generate an AbstractModuleComponent data bootstrap loader that creates initial folders, categories, or reference data exactly once per module version. In-Process SDK (Maven) only.

Generate Alfresco content model XML and Spring context file from requirements.

Generate a Docker Compose file with full ACS stack.

Generate an Out-of-Process Spring Boot event listener for Alfresco Java Event API.

Generate an AbstractPatch repository patch that migrates existing data or structure between module versions, runs exactly once per repository, and is recorded in alf_applied_patch. In-Process SDK (Maven) only.

Gather and structure requirements for an Alfresco extension as user stories with acceptance criteria.

Generate a custom Alfresco rule condition evaluator with parameter definitions, Spring bean registration, and unit test. In-Process SDK (Maven) only.

Scaffolds one deployable project or a mixed multi-project repository from REQUIREMENTS.md: pom.xml(s), module.properties, module-context.xml, Share-tier base structure, and Spring Boot Application class. Supports Platform JAR (in-process), Share JAR (web-tier), Event Handler (out-of-process), and mixed architectures. Run this first, before /content-model.

Generate a cluster-safe Quartz scheduled job with configurable cron expression, separate executer bean, Spring scheduler registration, and unit test. In-Process SDK (Maven) only.

Generate Share Surf extension artefacts for legacy Share pages, components, templates, and extension metadata.

Generate integration tests for Alfresco extensions using Testcontainers (self-contained, no pre-running ACS required).

Register a custom rendition definition (Platform JAR) and, when no built-in transform covers the required source/target mimetype pair, scaffold a custom Transform Engine (Spring Boot, Out-of-Process). Optionally registers a new MIME type.

Generate Alfresco Web Script descriptors, controllers, and FreeMarker templates. In-Process SDK (Maven) only.

Generate Activiti BPMN 2.0 process definition, workflow task content model, Spring bootstrap registration, i18n message bundle, and optional Java task listener. In-Process SDK (Maven) only.

Given a business requirement, proposes full Alfresco extension architecture including content types, behaviours, REST endpoints, events, and deployment model. Produces an Architecture Decision Record.

Given an Alfresco stack trace or log snippet, searches documentation and known issues to diagnose the root cause and suggest a fix. Covers classloader issues, model registration errors, Transform Service failures, and common ACS problems.

Analyses an existing Alfresco AMP or JAR extension, identifies deprecated APIs and outdated patterns, and produces a migration plan with concrete code diffs.

Ensures every service in a Docker Compose file has a healthcheck block and depends_on uses condition: service_healthy. Trigger when generating or editing compose.yaml.

Validates ActiveMQ topic names and consumer group patterns against Alfresco event API conventions. Applies to Out-of-Process SDK (Spring Boot) only. Trigger when generating event-driven code with /events.

Detects deprecated Alfresco API usage and suggests modern equivalents. Trigger when analysing existing Alfresco extension code.

Warns when CMIS or Alfresco Query Language queries may bypass ACLs. Suggests SearchService with authority context instead. Trigger when generating search or query code.

Reads pom.xml, detects which Alfresco SDK is in use (In-Process Maven SDK or Out-of-Process Spring Boot SDK), and adjusts generated code accordingly. Trigger when generating Java code for Alfresco extensions.

Validates Alfresco Activiti BPMN 2.0 process definition files and companion workflow model XML for structural correctness: required namespaces, task assignees, variable naming conventions, process variable promotion pattern, formKey alignment, and forbidden Activiti 6/Flowable patterns. Trigger automatically when generating or editing *.bpmn files or *-workflow-model.xml files.