@jahia/agentic 0.4.0 → 0.4.1

package/dist/opencode/.agents/skills/jahia-dev-java/references/backend.md

@@ -1,331 +0,0 @@
-# Jahia Backend Capabilities Reference
-
-## Table of Contents
-1. [Drools rule engine](#1-drools-rule-engine)
-2. [JCR event listeners](#2-jcr-event-listeners)
-3. [JCR SQL2 cheat sheet](#3-jcr-sql2-cheat-sheet)
-4. [Queries and search indexing](#4-queries-and-search-indexing)
-5. [External data sources (Provider API)](#5-external-data-sources-provider-api)
-6. [Permissions and roles](#6-permissions-and-roles)
-
----
-
-## 1. Drools rule engine
-
-Jahia uses JBoss Drools 6 for a rules engine that reacts to JCR events.
-
-### Rule file locations
-
-| File | Scope |
-|------|-------|
-| `META-INF/rules.drl` | All workspaces (default and live) |
-| `META-INF/default-rules.drl` | Edit/preview workspace only |
-| `META-INF/live-rules.drl` | Live workspace only |
-| `META-INF/rules.dsl` | Custom DSL extensions |
-
-### Basic rule structure
-
-```drools
-package org.example.mymodule.rules
-
-import org.jahia.services.content.rules.*
-import org.jahia.services.content.JCRContentUtils
-import org.slf4j.Logger
-
-global User user
-global Service service
-global Logger logger
-global MyService myService
-
-rule "Log new article creation"
-    when
-        A new node is created
-        - the node has the type jnt:article
-    then
-        Log "New article created: " + node.getName() at INFO level
-end
-
-rule "Notify on page publish"
-    salience 100
-    when
-        A node is published
-        - the node has the type jnt:page
-    then
-        myService.notifyPublish(node)
-end
-```
-
-**Critical rules:** Rule titles are globally unique across the platform — never reuse rule names between modules.
-
-**Package names:** Use a unique package per module — do not share package names across modules.
-
-### Built-in DSL conditions (excerpt)
-
-```drools
-A new node is created             # AddedNodeFact
-A node is published               # PublishedNodeFact
-A node is deleted                 # DeletedNodeFact
-A node is modified                # ChangedPropertyFact
-- the node has the type {type}    # Checks primaryType or mixin
-```
-
-### Built-in global objects
-
-| Global | Type | Description |
-|--------|------|-------------|
-| `user` | `org.jahia.services.content.rules.User` | Current user context |
-| `service` | `org.jahia.services.content.rules.Service` | Core JCR service shortcuts |
-| `logger` | `org.slf4j.Logger` | SLF4J logger |
-| `imageService` | `org.jahia.services.content.rules.ImageService` | Image operations |
-| `extractionService` | `org.jahia.services.content.rules.ExtractionService` | Content extraction |
-
-### Registering a custom service as a rules global
-
-Step 1 — Declare the service component:
-```java
-@Component(service = MyService.class)
-public class MyService {
-    public void doSomething(AddedNodeFact node) throws RepositoryException { }
-}
-```
-
-Step 2 — Register as a global rules object:
-```java
-@Component(service = ModuleGlobalObject.class)
-public class MyRulesGlobalObjects extends ModuleGlobalObject {
-    @Reference
-    public void setMyService(MyService myService) {
-        getGlobalRulesObject().put("myService", myService);
-    }
-    public void unsetMyService(MyService myService) {
-        getGlobalRulesObject().remove("myService");
-    }
-}
-```
-
-Step 3 — Declare global and import in rules.drl:
-```drools
-import org.example.mymodule.MyService
-global MyService myService
-```
-
-**Important:** Export the package containing `MyService` so other modules can import it in DRL files.
-
-### Custom DSL extensions (rules.dsl)
-
-```drools
-[condition][]A new article is created=node : AddedNodeFact (types contains "jnt:article")
-[consequence][]Notify publish for {node}=myService.notifyPublish({node});
-```
-
----
-
-## 2. JCR event listeners
-
-Extend `DefaultEventListener` to react to JCR node events:
-
-```java
-public class MyJCREventListener extends DefaultEventListener {
-
-    @Override
-    public int getEventTypes() {
-        return Event.NODE_ADDED | Event.NODE_REMOVED | Event.PROPERTY_CHANGED;
-    }
-
-    @Override
-    public String getPath() {
-        return "/sites";
-    }
-
-    @Override
-    public void onEvent(EventIterator events) {
-        while (events.hasNext()) {
-            Event event = events.nextEvent();
-            try {
-                String path = event.getPath();
-            } catch (RepositoryException e) {
-                logger.error("Error processing event", e);
-            }
-        }
-    }
-}
-```
-
-**JCR Event types:** `Event.NODE_ADDED`, `Event.NODE_REMOVED`, `Event.PROPERTY_ADDED`, `Event.PROPERTY_CHANGED`, `Event.PROPERTY_REMOVED`, `Event.NODE_MOVED`
-
----
-
-## 3. JCR SQL2 cheat sheet
-
-JCR SQL2 syntax: `SELECT * FROM [nodeType] AS alias WHERE conditions ORDER BY alias.[prop]`
-
-### Querying node types
-
-```sql
--- Prefer jmix:searchable over nt:base for broad queries
-SELECT * FROM [jmix:searchable] AS node
-
-SELECT * FROM [jnt:page] AS page
-SELECT * FROM [jnt:file] AS file
-SELECT * FROM [jnt:article] AS article
-```
-
-### Path constraints (always include for performance)
-
-```sql
-SELECT * FROM [jnt:article] AS node
-WHERE ISDESCENDANTNODE(node, '/sites/mySite')
-
-SELECT * FROM [jnt:page] AS child
-WHERE ISCHILDNODE(child, '/sites/mySite/home')
-```
-
-### String matching
-
-```sql
-SELECT * FROM [jnt:content] AS node WHERE node.[jcr:title] = 'My Title'
-SELECT * FROM [jnt:content] AS node WHERE node.[jcr:title] LIKE '%news%'
-SELECT * FROM [jnt:page] AS node WHERE LOWER(node.[jcr:title]) = 'home'
-SELECT * FROM [jnt:page] AS page WHERE page.[jcr:title] IS NOT NULL
-SELECT * FROM [jnt:content] AS node WHERE CONTAINS(node.*, 'digital')
-```
-
-### Property and type queries
-
-```sql
-SELECT * FROM [jnt:page] AS page WHERE page.[j:published] > CAST('true' AS BOOLEAN)
-SELECT * FROM [jnt:page] AS page
-WHERE page.[j:published] > CAST('2021-01-01T00:00:01.000Z' AS DATE)
-```
-
-### Ordering and templates
-
-```sql
-SELECT * FROM [jnt:page] AS page ORDER BY page.[j:lastModified] DESC
-SELECT * FROM [jnt:page] AS page WHERE page.[j:templateName] = 'home'
-```
-
-### Non-query lookups (use instead of queries for performance)
-
-```java
-// By UUID (preferred over UUID query)
-session.getNodeByIdentifier("the-uuid-string");
-
-// Set result limit (no LIMIT keyword in JCR SQL2)
-QueryObjectModelImpl qom = ...;
-qom.setLimit(20);
-qom.setOffset(0);
-```
-
----
-
-## 4. Queries and search indexing
-
-### Executing a JCR SQL2 query in Java
-
-```java
-JCRSessionWrapper session = JCRSessionFactory.getInstance()
-    .getCurrentUserSession("default", Locale.ENGLISH);
-
-QueryManager queryManager = session.getWorkspace().getQueryManager();
-Query query = queryManager.createQuery(
-    "SELECT * FROM [jnt:article] WHERE ISDESCENDANTNODE('/sites/mySite')",
-    Query.JCR_SQL2
-);
-QueryResult result = query.execute();
-NodeIterator nodes = result.getNodes();
-while (nodes.hasNext()) {
-    JCRNodeWrapper node = (JCRNodeWrapper) nodes.nextNode();
-}
-```
-
-### Index tuning via CND keywords
-
-```cnd
-- title (string) i18n boost=3.0          # Higher search relevance
-- code (string) analyzer=keyword          # Index as single token
-- internalNotes (string) nofulltext       # Indexed but not in full-text search
-- binaryData (binary) indexed=no          # Not indexed at all
-- category (string) facetable            # Enables faceted search
-```
-
----
-
-## 5. External data sources (Provider API)
-
-The External Provider API allows exposing non-JCR data as virtual JCR nodes.
-
-### Key interfaces
-
-| Interface | Purpose |
-|-----------|---------|
-| `ExternalDataSource` | Main interface to implement for external data |
-| `ExternalDataSource.Searchable` | Add search support |
-| `ExternalDataSource.Writable` | Add write support |
-| `ExternalContentStoreProvider` | OSGi service to mount the provider |
-
-### Minimal ExternalDataSource implementation
-
-```java
-@Component(service = ExternalDataSource.class)
-public class MyExternalDataSource implements ExternalDataSource {
-
-    @Override
-    public List<String> getChildren(String path) throws PathNotFoundException {
-        return Arrays.asList("item1", "item2");
-    }
-
-    @Override
-    public ExternalData getItemByPath(String path) throws PathNotFoundException {
-        ExternalData data = new ExternalData("unique-id", path, "jnt:content",
-            new HashMap<String, String[]>());
-        data.getProperties().put("jcr:title", new String[]{"My Title"});
-        return data;
-    }
-
-    @Override
-    public ExternalData getItemByIdentifier(String identifier) throws ItemNotFoundException {
-        return null;
-    }
-
-    @Override
-    public Set<String> getSupportedNodeTypes() {
-        return Collections.singleton("jnt:content");
-    }
-
-    @Override public boolean isSupportsUuid() { return false; }
-    @Override public boolean isSupportsHierarchicalIdentifiers() { return false; }
-    @Override public boolean itemExists(String path) { return true; }
-}
-```
-
----
-
-## 6. Permissions and roles
-
-### Permission hierarchy
-
-| Level | Description |
-|-------|-------------|
-| Server level | Global roles (e.g., Server Administrator) |
-| Site level | Site-specific roles (e.g., Site Administrator, Editor) |
-| Node level | Per-node ACL inheritance |
-
-### Checking permissions in code
-
-```java
-if (currentNode.hasPermission("jcr:write")) { }
-
-// In JSP
-<c:if test="${jcr:hasPermission(currentNode, 'jcr:write')}">...</c:if>
-```
-
-### Standard JCR permissions
-
-| Permission | Description |
-|------------|-------------|
-| `jcr:read` | Read node and properties |
-| `jcr:write` | Modify properties and children |
-| `jcr:addChildNodes` | Add child nodes |
-| `jcr:removeNode` | Delete the node |
-| `jcr:modifyProperties` | Modify properties |

package/dist/opencode/.agents/skills/jahia-dev-java/references/content-types.md

@@ -1,273 +0,0 @@
-# Jahia Content Types (CND) Reference
-
-## Table of Contents
-1. [CND file basics](#1-cnd-file-basics)
-2. [Property types and selectors](#2-property-types-and-selectors)
-3. [Property keywords](#3-property-keywords)
-4. [Child node declarations](#4-child-node-declarations)
-5. [Mixins](#5-mixins)
-6. [Key built-in mixins reference](#6-key-built-in-mixins-reference)
-7. [Choicelist initializers](#7-choicelist-initializers)
-8. [Enhancing content types for editors](#8-enhancing-content-types-for-editors)
-9. [Modifying existing definitions](#9-modifying-existing-definitions)
-10. [Module definition checks](#10-module-definition-checks)
-
----
-
-## 1. CND file basics
-
-CND = Compact Namespace and Node Type Definition (Apache Jackrabbit standard).
-
-File location: `src/main/resources/META-INF/definitions.cnd`
-
-### Namespace declaration (required first)
-```cnd
-<ns = 'http://www.example.org/ns/1.0'>
-```
-
-Jahia built-in namespaces:
-- `<jnt = 'http://www.jahia.org/jahia/nt/1.0'>` — node types
-- `<jmix = 'http://www.jahia.org/jahia/mix/1.0'>` — mixins
-- `<j = 'http://www.jahia.org/jahia/1.0'>` — core properties
-- `<mix = 'http://www.jcp.org/jcr/mix/1.0'>` — JCR standard mixins
-
-### Minimal content type definition
-```cnd
-<myns = 'http://www.example.org/myns/1.0'>
-
-[myns:myContent] > jnt:content, jmix:editorialContent
-- title (string) i18n mandatory
-- body (string, richtext) i18n
-- publishDate (date)
-```
-
-All user-editable content types MUST inherit from `jnt:content`.
-Add `jmix:editorialContent` to make the type visible in jContent.
-
----
-
-## 2. Property types and selectors
-
-### Base property types
-
-| CND type | Content Editor renders as |
-|----------|--------------------------|
-| `string` | Text input |
-| `long` | Number field (integer) |
-| `double` | Number field (decimal) |
-| `boolean` | Checkbox |
-| `date` | Date picker |
-| `weakreference` | Node picker (UUID reference, not enforced) |
-
-### String selectors
-
-| Selector | Renders as |
-|----------|-----------|
-| `string` | Plain text input |
-| `string, textarea` | Multi-line textarea |
-| `string, richtext` | CKEditor WYSIWYG |
-| `string, choicelist` | Dropdown list |
-| `string, color` | Color picker |
-
-### Date selectors
-
-| Selector | Renders as |
-|----------|-----------|
-| `date, datetimepicker` | Date + time picker |
-| `date, datepicker` | Date-only picker |
-
----
-
-## 3. Property keywords
-
-| Keyword | Effect |
-|---------|--------|
-| `i18n` / `internationalized` | Property has separate value per language |
-| `mandatory` | Field required before saving |
-| `multiple` | Allows multiple values |
-| `hidden` | Not shown in UI; only set programmatically |
-| `protected` | Read-only in UI; only set programmatically |
-| `autocreated` | Automatically created with default or blank value |
-| `primary` | Used as node label in JCR browser |
-| `indexed=no` | Not indexed for search |
-| `nofulltext` | Indexed but excluded from full-text search |
-| `boost=N` | Search weight multiplier (1.0–5.0) |
-| `analyzer=keyword` | Indexed word-by-word |
-| `facetable` | Enables faceted search on this property |
-
----
-
-## 4. Child node declarations
-
-```cnd
-[myns:article] > jnt:content, jmix:editorialContent
-+ * (jmix:droppableContent) = jmix:droppableContent version  # Any droppable content
-+ media (jnt:file)                                            # Single named child
-+ * (jnt:paragraph)                                          # Multiple children
-+ section1 (jnt:contentList)                                 # Named child list
-```
-
----
-
-## 5. Mixins
-
-A mixin adds properties/child nodes to a type without inheritance conflicts:
-
-```cnd
-[myns:myMixin] mixin
-- extraProp (string) i18n
-```
-
-Apply to a content type:
-```cnd
-[myns:article] > jnt:content, jmix:editorialContent, myns:myMixin
-```
-
-Create a custom component category:
-```cnd
-<mymix = 'http://example.org/mymix/1.0'>
-
-[mymix:myComponents] > jmix:droppableContent mixin
-```
-
----
-
-## 6. Key built-in mixins reference
-
-### Content visibility / organization
-
-| Mixin | Purpose |
-|-------|---------|
-| `jmix:editorialContent` | Makes type visible in jContent; enables versioning |
-| `jmix:droppableContent` | Base for component category folders |
-| `jmix:list` | Declares a list component with built-in mechanisms |
-| `mix:title` | Syncs system name with `jcr:title` |
-| `jmix:mainResource` | Enables full-page display |
-| `jmix:hiddenNode` | Node not visible in Jahia managers |
-
-### Content behavior
-
-| Mixin | Purpose |
-|-------|---------|
-| `jmix:cache` | Exposes cache expiration controls in the editor UI |
-| `jmix:bindedComponent` | Defines a component that binds/links to another component |
-
-### Component categories (out-of-the-box)
-
-| Mixin | Component folder |
-|-------|-----------------|
-| `jmix:basicContent` | Content > Basic |
-| `jmix:multimediaContent` | Content > Multimedia |
-| `jmix:structuredContent` | Content > Structured |
-| `jmix:listContent` | Lists |
-| `jmix:siteComponent` | Site Components |
-| `jmix:editorialContent` | All editorial content |
-
----
-
-## 7. Choicelist initializers
-
-### Built-in initializers
-
-```cnd
-# Static values from resource bundle
-- contract (string, choicelist[resourceBundle]) < contract1, contract2, contract3
-
-# JCR node tree
-- theme (weakreference, choicelist[nodes='$currentSite/files/themes;jnt:folder'])
-- category (weakreference, choicelist[nodes='/sites/systemsite/categories;jnt:category'])
-
-# Chained initializers
-- view (string, choicelist[templates,resourceBundle,image])
-```
-
-**Resource bundle keys format:**
-```properties
-jnt_article.contract.contract1 = Fixed-term contract
-jnt_article.contract.contract2 = Indefinite duration
-```
-Format: `{nodeTypeName_with_colon_as_underscore}.{propertyName}.{value} = Label`
-
-### Custom choicelist initializer
-
-```java
-@Component(service = {ModuleChoiceListInitializer.class})
-public class MyChoiceListInitializer implements ModuleChoiceListInitializer {
-
-    @Override
-    public String getKey() {
-        return "myCustomList";  // Used in CND as choicelist[myCustomList]
-    }
-
-    @Override
-    public List<ChoiceListValue> getChoiceListValues(
-            ExtendedPropertyDefinition epd, String param,
-            List<ChoiceListValue> values, Locale locale,
-            Map<String, Object> context) {
-        List<ChoiceListValue> result = new ArrayList<>();
-        result.add(new ChoiceListValue("Display Label", "storedValue"));
-        return result;
-    }
-}
-```
-
----
-
-## 8. Enhancing content types for editors
-
-### Labels and i18n
-
-```properties
-# In src/main/resources/resources/ModuleName.properties
-myns_myContent.title = Title
-myns_myContent.body = Body text
-myns_myContent.publishDate = Publication date
-```
-
-### Icons
-Place at `src/main/resources/icons/myns_myContent.png` (replace `:` with `_`).
-
-### Constraints
-```cnd
-- size (string) < 'small', 'medium', 'large'
-- rating (long) < '[1,5]'
-```
-
----
-
-## 9. Modifying existing definitions
-
-### Safe modifications (non-destructive)
-- Adding new optional properties to an existing type
-- Adding a new mixin to an existing type
-- Adding new child node definitions
-- Changing property constraints or default values
-
-### Dangerous modifications (require migration)
-- Renaming a property
-- Changing a property type (e.g., string to date)
-- Removing a property that has existing content
-- Changing the supertype hierarchy
-
-### Overriding built-in definitions
-
-```cnd
-[myns:pageExtension] mixin
-  extends = jnt:page
-- myCustomProp (string) i18n
-```
-
-### Migration scripts
-
-Groovy scripts in `src/main/resources/META-INF/patches/` run once on deployment.
-Naming convention: `7.0.0.0-SNAPSHOT-1_myMigration.groovy`
-
----
-
-## 10. Module definition checks
-
-When deploying a module, Jahia checks CND changes. To bypass during development (NOT for production):
-```properties
-# In jahia.properties
-jahia.jackrabbit.overrideNodeTypes = true
-```