@jahia/agentic 0.0.0

package/dist/windsurf/.windsurf/skills/jahia-dev-ui-extension/SKILL.md

@@ -0,0 +1,559 @@
+---
+name: jahia-dev-ui-extension
+description: Conventions and patterns for building Jahia OSGi UI extensions — modules that extend the jcontent back-office (actions, panels, dialogs) using React 18, Webpack/Module Federation, and the @jahia/ui-extender registry. Distinct from JS template sets (React 19, Vite).
+---
+
+# SKILL — Jahia OSGi UI Extension
+
+## When this skill applies
+
+You are extending the **jcontent back-office** — adding toolbar actions, admin panels, dialogs, or sidebar panels that editors see inside jcontent / Page Builder. This is **not** about rendering the public-facing site (that is the JS template set track).
+
+Key indicators:
+- `@jahia/ui-extender` in `package.json`
+- `@jahia/webpack-config` / `webpack.config.js` (not Vite)
+- Output to `src/main/resources/javascript/apps/`
+- React 18, not React 19
+
+---
+
+## React version distinction — critical
+
+| Module type | React version | Build tool | Library |
+|---|---|---|---|
+| **JS template set** (public site) | React **19** | Vite | `@jahia/javascript-modules-library` |
+| **OSGi UI extension** (back-office) | React **18** | Webpack + Module Federation | `@jahia/ui-extender` |
+
+Never mix them. A UI extension that imports React 19 APIs will silently break in jcontent. A template set that uses `@jahia/ui-extender` won't work in the page renderer.
+
+---
+
+## Scaffold a new UI extension module
+
+Use archetype **4** (`jahia-reactjs-admin-module-archetype`) which scaffolds the Webpack/Module Federation wiring automatically.
+
+```bash
+mvn archetype:generate -Dfilter=org.jahia.archetypes:
+```
+
+At the prompts:
+1. Enter `4` → `jahia-reactjs-admin-module-archetype` (Jahia DXP >= 8)
+2. Enter the latest version
+3. Fill in the properties, then confirm with `Y`
+
+| Property | Example | Notes |
+|---|---|---|
+| `artifactId` | `my-ui-extension` | Maven artifact ID and folder name |
+| `moduleName` | `My UI Extension` | Human-readable name shown in Jahia UI |
+| `groupId` | `org.example.modules` | Java package root |
+| `jahiaVersion` | `8.2.0.0` | **Always `8.2.0.0`** — the archetype default is outdated |
+| `version` | `1.0.0-SNAPSHOT` | Module version |
+| `package` | `org.example.modules` | Java package |
+
+> ⚠️ After generation, update `react` and `react-dom` in `package.json` to `^18.3.1`. The archetype may scaffold an older React 18 minor — always pin to the latest React 18.x.
+
+Build to verify:
+
+```bash
+cd <artifactId>
+mvn clean install   # runs yarn build:production via frontend-maven-plugin
+```
+
+---
+
+## Module structure
+
+```
+<module>/
+├── pom.xml                                   # Maven OSGi bundle
+├── package.json                              # Webpack/JS config
+├── webpack.config.js
+├── babel.config.js
+├── src/
+│   ├── javascript/                           # React / JS sources
+│   │   ├── index.js                          # Entry point — registers jahiaApp-init callback
+│   │   ├── init.js                           # Async init — loads i18n, calls register functions
+│   │   ├── <Feature>/
+│   │   │   ├── <Feature>.jsx                 # React component
+│   │   │   ├── register<Feature>.js          # registry.add() call
+│   │   │   ├── dialogManager.js              # Portal pattern (if feature has a dialog)
+│   │   │   └── gql/
+│   │   │       └── <Feature>.mutations.js    # Apollo mutations
+│   │   └── AdminPanel/                       # Optional admin panel
+│   │       ├── AdminPanel.jsx
+│   │       └── AdminPanel.routes.jsx
+│   └── main/
+│       ├── java/org/jahia/<org>/<module>/
+│       │   ├── actions/                      # Java Actions (@Component service = Action.class)
+│       │   └── services/                     # OSGi services (@Component)
+│       └── resources/
+│           ├── META-INF/configurations/      # OSGi .cfg files
+│           └── javascript/
+│               ├── apps/                     # Webpack output (do not edit)
+│               └── locales/                  # i18n JSON files
+│                   ├── en.json
+│                   └── fr.json
+```
+
+---
+
+## Build stack
+
+### package.json key fields
+
+```json
+{
+  "jahia": {
+    "remotes": {
+      "jahia": "javascript/apps/remoteEntry.js"
+    }
+  },
+  "dependencies": {
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "@jahia/ui-extender": "^1.x",
+    "@jahia/moonstone": "^2.x",
+    "@jahia/data-helper": "^1.x",
+    "@apollo/client": "^3.x"
+  },
+  "devDependencies": {
+    "@jahia/webpack-config": "^1.x"
+  }
+}
+```
+
+### webpack.config.js
+
+```javascript
+const { getModuleFederationConfig } = require('@jahia/webpack-config');
+const packageJson = require('./package.json');
+const ModuleFederationPlugin = require('webpack/lib/container/ModuleFederationPlugin');
+
+module.exports = (env, argv) => ({
+    entry: { main: './src/javascript/index' },
+    output: {
+        path: path.join(__dirname, 'src/main/resources/javascript/apps/'),
+        publicPath: 'auto',
+        filename: 'jahia.bundle.js',
+        chunkFilename: '[name].jahia.[chunkhash:6].js',
+    },
+    module: {
+        rules: [
+            { test: /\.(js|jsx)$/, use: 'babel-loader', exclude: /node_modules/ },
+            { test: /\.module\.css$/, use: ['style-loader', { loader: 'css-loader', options: { modules: true } }] },
+            { test: /\.css$/, exclude: /\.module\.css$/, use: ['style-loader', 'css-loader'] },
+        ],
+    },
+    plugins: [
+        new ModuleFederationPlugin(getModuleFederationConfig(packageJson)),
+    ],
+});
+```
+
+`@jahia/webpack-config/getModuleFederationConfig` reads the `jahia.remotes` field from `package.json` and configures shared dependencies (React, MUI, Apollo) as singletons — this is what prevents version conflicts with jcontent's own React 18 instance.
+
+### Maven — frontend-maven-plugin
+
+```xml
+<plugin>
+    <groupId>com.github.eirslett</groupId>
+    <artifactId>frontend-maven-plugin</artifactId>
+    <executions>
+        <execution>
+            <id>install-node-and-yarn</id>
+            <goals><goal>install-node-and-yarn</goal></goals>
+            <configuration>
+                <nodeVersion>v20.x.x</nodeVersion>
+                <yarnVersion>v1.22.x</yarnVersion>
+            </configuration>
+        </execution>
+        <execution>
+            <id>yarn-install</id>
+            <goals><goal>yarn</goal></goals>
+        </execution>
+        <execution>
+            <id>yarn-build</id>
+            <goals><goal>yarn</goal></goals>
+            <configuration>
+                <arguments>build:production</arguments>
+            </configuration>
+        </execution>
+    </executions>
+</plugin>
+```
+
+Build scripts in `package.json`:
+- `build`: `yarn lint && webpack` (dev — fast, no minification)
+- `build:production`: `webpack --mode=production` (for Maven/CI)
+- `dev`: `webpack --watch` (interactive dev only — never run from an agent)
+
+### Deploy
+
+```bash
+# Always use this for agentic builds
+mvn clean install -pl .
+
+# Or if a deployer script is configured:
+yarn build && mvn install -DskipTests
+```
+
+---
+
+## Registering UI extensions (JavaScript side)
+
+### Entry point pattern
+
+```javascript
+// src/javascript/index.js
+import { registry } from '@jahia/ui-extender';
+
+export default function () {
+    registry.add('callback', 'my-module', {
+        targets: ['jahiaApp-init:50'],   // runs early in jcontent lifecycle
+        callback: async () => {
+            const { default: register } = await import('./init');
+            register();
+        }
+    });
+}
+```
+
+```javascript
+// src/javascript/init.js
+import i18next from 'i18next';
+import { registerMyAction } from './MyAction';
+
+export default async function () {
+    await i18next.loadNamespaces('my-module');   // load translations before registering UI
+    registerMyAction();
+}
+```
+
+The `jahiaApp-init:N` priority controls load order. Use 50 for normal modules; use lower numbers only if another module must see your registry entries at init time.
+
+> **SelectorType registration** uses the same `registry.add` mechanism — `registry.add('selectorType', 'MyKey', { cmp, dataType, adaptValue, initValue })` — wired to a CND property via a JSON fieldset override in `settings/content-editor-forms/fieldsets/`.
+
+### Action registration
+
+```javascript
+// src/javascript/MyAction/registerMyAction.js
+import React from 'react';
+import { registry } from '@jahia/ui-extender';
+import { Download } from '@jahia/moonstone';
+import { MyAction } from './MyAction';
+
+export const registerMyAction = () => {
+    registry.addOrReplace('action', 'myActionName', {
+        targets: ['contentActions:900'],    // toolbar position (higher number = lower priority)
+        buttonIcon: <Download />,
+        buttonLabel: 'my-module:action.myAction.label',
+        showOnNodeTypes: ['jnt:page'],      // visibility filter
+        component: MyAction,
+    });
+};
+```
+
+Common targets:
+- `contentActions:N` — jcontent content toolbar
+- `headerPrimaryActions:N` — jcontent header
+- `publishMenu:N` — publish menu
+- `contextualMenu:N` — right-click menu
+
+### Action component pattern
+
+```jsx
+// src/javascript/MyAction/MyAction.jsx
+import React from 'react';
+import { Language } from '@jahia/moonstone';
+import { useNodeChecks } from '@jahia/data-helper';
+
+export const MyAction = ({ path, render: Render, ...otherProps }) => {
+    const { checksResult } = useNodeChecks({ path, Language }, {
+        showOnNodeTypes: ['jnt:page'],
+        hideOnNodeTypes: ['jmix:someExcludedMixin'],
+        hideForPaths: ['^/sites/((?!/).)+/SomeFolder/?$'],  // regex supported
+        requiredPermission: ['myPermission'],                // always an array
+        requireModuleInstalledOnSite: ['my-module'],
+    });
+
+    if (Render && checksResult) {
+        return <Render {...otherProps} onClick={handleClick} />;
+    }
+
+    return null;
+};
+```
+
+`useNodeChecks` returns `checksResult: true` only when all declared conditions pass. When `false`, the action is hidden from the UI.
+
+> ⚠️ **Always include `requireModuleInstalledOnSite`** — without it, the action appears on every Jahia site regardless of whether the module is installed there. This is the primary guard that scopes a UI extension to sites where it is relevant.
+
+### `useNodeChecks` — full options
+
+All options are optional. An action is visible only when all provided conditions pass.
+
+```jsx
+const { checksResult } = useNodeChecks({ path, Language }, {
+  showOnNodeTypes: ['jnt:page', 'jnt:file'],
+  hideOnNodeTypes: ['jmix:externalLink'],
+  requiredPermission: ['jcr:write'],               // always use arrays
+  requiredSitePermission: 'adminTemplates',
+  requireModuleInstalledOnSite: ['my-module'],     // always include — scopes to active sites
+  showForPaths: ['/sites/mySite/home'],
+  hideForPaths: ['^/sites/((?!/).)+/Drafts/?$'],   // regex supported
+  hideOnExternal: true,
+});
+```
+
+---
+
+## Dialog pattern
+
+When an action opens a dialog, use a portal manager — the dialog must be rendered outside the jcontent component tree to avoid focus-trap and z-index issues.
+
+```javascript
+// dialogManager.js
+import React from 'react';
+import ReactDOM from 'react-dom/client';
+import { ApolloProvider } from '@apollo/client';
+import { I18nextProvider } from 'react-i18next';
+import i18next from 'i18next';
+import { MyDialog } from './MyDialog';
+
+class DialogManager {
+    _init() {
+        if (!this.root) {
+            const container = document.createElement('div');
+            container.id = 'my-module-dialog-root';
+            document.body.appendChild(container);
+            this.root = ReactDOM.createRoot(container);
+        }
+    }
+
+    open({ path, language, apolloClient }) {
+        this._init();
+        this.root.render(
+            <ApolloProvider client={apolloClient}>
+                <I18nextProvider i18n={i18next}>
+                    <MyDialog path={path} language={language} onClose={() => this.close()} />
+                </I18nextProvider>
+            </ApolloProvider>
+        );
+    }
+
+    close() {
+        this.root?.render(null);
+    }
+}
+
+export default new DialogManager();
+```
+
+> ⚠️ **Always use `<Dialog disableEnforceFocus>`** when rendering in a portal. Without it, MUI's FocusTrap fights with jcontent's own focus management and causes an infinite loop.
+
+```jsx
+// MyDialog.jsx
+import { Dialog, DialogTitle, DialogContent, DialogActions, Button } from '@mui/material';
+
+export const MyDialog = ({ path, language, onClose }) => (
+    <Dialog open fullWidth maxWidth="sm" disableEnforceFocus onClose={onClose}>
+        <DialogTitle>...</DialogTitle>
+        <DialogContent>...</DialogContent>
+        <DialogActions>
+            <Button onClick={onClose}>Cancel</Button>
+            <Button variant="contained" onClick={handleAction}>Confirm</Button>
+        </DialogActions>
+    </Dialog>
+);
+```
+
+---
+
+## Runtime APIs (window.jahia.*)
+
+These are injected by jcontent at runtime. Always check for existence before calling.
+
+```javascript
+// Toast notification
+if (window.jahia?.toastDispatcher) {
+    window.jahia.toastDispatcher.add({
+        message: t('myMessage'),
+        variant: 'success'   // 'success' | 'error' | 'warning' | 'info'
+    });
+}
+
+// JCR node/folder picker
+if (window.CE_API?.openPicker) {
+    window.CE_API.openPicker({
+        type: 'folder',           // 'folder' | 'image' | 'file' | 'page' | 'content'
+        isMultiple: false,
+        site: window.contextJsParameters?.siteKey,
+        lang: window.contextJsParameters?.uilang,
+        initialSelectedItem: [],
+        setValue: ([selected]) => {
+            if (selected?.path) setPath(selected.path);
+        }
+    });
+}
+
+// Runtime context
+const { siteKey, uilang, currentUser } = window.contextJsParameters ?? {};
+```
+
+---
+
+## i18n conventions
+
+Locale files live at `src/main/resources/javascript/locales/<lang>.json`. The top-level key is the module namespace. Always load the namespace before registering UI:
+
+```json
+{
+  "my-module": { "label": "My Module" },
+  "action": { "myAction": { "label": "Do Something" } },
+  "dialog": {
+    "title": "...",
+    "button": { "cancel": "Cancel", "confirm": "Confirm" }
+  }
+}
+```
+
+Use `useTranslation('my-module')` in components.
+
+---
+
+## Java Action pattern
+
+```java
+@Component(service = Action.class)
+public class MyAction extends Action {
+
+    @Override
+    public String getName() {
+        return "myActionName";   // matches CSRF whitelist key
+    }
+
+    @Override
+    public ActionResult doExecute(
+            HttpServletRequest request,
+            RenderContext renderContext,
+            Resource resource,
+            JCRSessionWrapper session,
+            Map<String, List<String>> parameters,
+            URLResolver urlResolver) throws Exception {
+
+        String param = readParameter(parameters, "paramName", null);
+
+        // Return binary response
+        HttpServletResponse response = renderContext.getResponse();
+        response.setStatus(HttpServletResponse.SC_OK);
+        response.setContentType("application/pdf");
+        response.getOutputStream().write(bytes);
+        return ActionResult.OK;
+
+        // OR return JSON:
+        // JSONObject result = new JSONObject();
+        // result.put("key", "value");
+        // return new ActionResult(HttpServletResponse.SC_OK, null, result);
+    }
+}
+```
+
+Action endpoint URL: `POST /cms/render/default/{language}{nodePath}.{actionName}.do`
+
+### CSRF guard configuration
+
+```properties
+# src/main/resources/META-INF/configurations/org.jahia.modules.jahiacsrfguard-<moduleName>.cfg
+whitelist = *.myActionName.do
+```
+
+---
+
+## RenderContext setup
+
+When an Action needs to render a page to HTML, the `RenderContext` fields must be set in this exact order:
+
+```java
+Resource htmlResource = new Resource(node, "html", null, Resource.CONFIGURATION_PAGE);
+RenderContext ctx = new RenderContext(request, response, renderContext.getUser());
+ctx.setSite(renderContext.getSite());          // 1. site first
+ctx.setWorkspace("live");                      // 2. then workspace
+ctx.setServletPath("/live");                   // 3. then servlet path (must match workspace)
+ctx.setMainResource(htmlResource);             // 4. main resource last
+String html = renderService.render(htmlResource, ctx);
+```
+
+> ⚠️ Order matters. Setting workspace before site or mainResource before workspace causes silent rendering errors.
+
+---
+
+## Embedding third-party libraries in the bundle
+
+When a library is not provided by Jahia at runtime:
+
+```xml
+<dependency>
+    <groupId>org.jsoup</groupId>
+    <artifactId>jsoup</artifactId>
+    <version>1.17.2</version>
+</dependency>
+
+<plugin>
+    <groupId>org.apache.felix</groupId>
+    <artifactId>maven-bundle-plugin</artifactId>
+    <configuration>
+        <instructions>
+            <Embed-Dependency>jsoup;inline=false</Embed-Dependency>
+            <DynamicImport-Package>*</DynamicImport-Package>
+        </instructions>
+    </configuration>
+</plugin>
+```
+
+For libraries using the Java `ServiceLoader` SPI, instantiate their classes directly using the **bundle's own classloader** — not via global registries that become stale after bundle refresh.
+
+Switch the Thread Context ClassLoader (TCCL) for any library that uses `Thread.currentThread().getContextClassLoader()` internally:
+
+```java
+ClassLoader original = Thread.currentThread().getContextClassLoader();
+Thread.currentThread().setContextClassLoader(getClass().getClassLoader());
+try {
+    // ... call to embedded library
+} finally {
+    Thread.currentThread().setContextClassLoader(original);
+}
+```
+
+---
+
+## Validation checklist
+
+### JavaScript side
+- [ ] `package.json` lists React 18, not 19
+- [ ] `@jahia/webpack-config` used for Module Federation
+- [ ] Entry point registers at `jahiaApp-init:N` via `registry.add('callback', ...)`
+- [ ] i18n namespace loaded (awaited) before registering UI
+- [ ] Action component uses `useNodeChecks` for visibility
+- [ ] `requireModuleInstalledOnSite` included in all `useNodeChecks` calls
+- [ ] Dialog rendered via portal manager (outside jcontent tree)
+- [ ] `<Dialog disableEnforceFocus>` on all MUI dialogs in portals
+- [ ] `window.jahia.*` APIs guarded with optional chaining (`?.`)
+- [ ] Webpack output goes to `src/main/resources/javascript/apps/`
+
+### Java side
+- [ ] Action class: `@Component(service = Action.class)`, `getName()` matches CSRF whitelist key
+- [ ] CSRF Guard config file present and correctly named
+- [ ] RenderContext set in order: site → workspace → servletPath → mainResource
+- [ ] All JCR access runs as the calling user (no system session escalation)
+- [ ] OSGi config `.cfg` file present for every configurable service
+- [ ] `Embed-Dependency` declared in BND config for every embedded lib
+
+---
+
+## References
+
+- jcontent UI extension API: https://academy.jahia.com/documentation/developer/jahia/8
+- @jahia/ui-extender: https://github.com/Jahia/ui-extender
+- @jahia/moonstone component library: https://moonstone.jahia.com
+- @jahia/data-helper: https://github.com/Jahia/data-helper
+- Module Federation docs: https://webpack.js.org/concepts/module-federation/

package/dist/windsurf/AGENTS.md

@@ -0,0 +1,89 @@
+# AGENTS.md
+<!-- Generated by APM CLI from distributed .apm/ primitives -->
+<!-- Build ID: c847df74747b -->
+<!-- APM Version: 0.14.1 -->
+<!-- Source: local -->
+
+## Global Instructions
+
+<!-- Source: local .apm/instructions/jahia.instructions.md -->
+# Jahia JavaScript Module Development
+
+## Context
+
+You are helping develop a **Jahia JavaScript Module** — a React-based template set for Jahia 8+. The module renders content from Jahia's JCR (Java Content Repository) using server-side React components (`.server.tsx`) and optional client-side islands (`.client.tsx`). Content is modelled in CND files, managed via Page Builder or jContent, and queried with JCR-SQL2 or GraphQL.
+
+## Agent Principles
+
+1. **Always invoke a skill before any Jahia task** — skills are the canonical source of patterns, gotchas, and API syntax. Never operate from memory alone.
+2. **Never use `yarn dev` from an agent** — it is an interactive file watcher for human developers only. Always deploy with `yarn build && yarn jahia-deploy` (one-shot, non-interactive).
+3. **Never hardcode URLs** — all navigable links must come from contributed content (JCR nodes, `j:linkType`, `buildNodeUrl`). This is a CMS: content owns the URLs.
+4. **Never use `j:linkType: "external"` for internal pages** — use `"internal"` + `j:linknode`. External URLs break on environment changes, language switches, and vanity URL rewrites.
+5. **Always verify before creating** — check that content types are deployed, site keys are correct, and area structures exist before attempting GraphQL mutations.
+6. **All props are optional at runtime** — even mandatory CND fields. Always guard against `undefined` in views.
+7. **Always include `-H "Origin: http://localhost:8080"` in every GraphQL curl** — omitting it returns `Permission denied` even with correct credentials.
+8. **Accessibility is mandatory** — every component must pass WCAG 2.1 AA. After building any component or completing a task, invoke `/jahia-dev-accessibility` to run an axe-core audit and fix all `critical` and `serious` violations before declaring work done.
+
+## Skill Map
+
+Start with `/jahia` if unsure where to begin.
+
+### Development
+
+| Skill | Purpose |
+|-------|---------|
+| `/jahia-dev` | Entry point — detect project state, guide to next step |
+| `/jahia-dev-create-template-set` | Scaffold a new Jahia JS module |
+| `/jahia-dev-start-local` | Start Jahia locally (Docker or bare metal) |
+| `/jahia-dev-build-component` | Build a complete component (CND + view) — start here |
+| `/jahia-dev-define-content-type` | Define a CND content type + types.ts |
+| `/jahia-dev-create-view` | Implement a React view (.server.tsx + CSS Module) |
+| `/jahia-dev-create-page-template` | Create a page template with Areas |
+| `/jahia-dev-query-content` | Write JCR-SQL2 queries and useJCRQuery |
+| `/jahia-dev-review` | Code review: 8 critical checks, 9 warnings, 11 suggestions |
+| `/jahia-dev-accessibility` | Audit live pages with axe-core, fix WCAG 2.1 AA violations |
+| `/jahia-dev-screenshot` | Screenshot reference + local render for visual comparison |
+| `/jahia-dev-debug` | Debug build/deploy/runtime errors end-to-end |
+
+### Content Management
+
+| Skill | Purpose |
+|-------|---------|
+| `/jahia-content` | Entry point — detect site state, route to content operations |
+| `/jahia-content-explore-structure` | Map content types, properties, enums on an unknown site |
+| `/jahia-content-query-content` | List and inspect content via GraphQL |
+| `/jahia-content-create-content` | Create nodes, folders, articles, bulk-populate |
+| `/jahia-content-move-content` | Restructure the content tree |
+| `/jahia-content-translate-content` | Translate existing nodes to a new language and publish |
+
+## Canonical References
+
+Always fetch these when uncertain about version-sensitive topics:
+
+| Topic | URL |
+|-------|-----|
+| Getting started / dev environment | https://academy.jahia.com/tutorials-get-started/front-end-developer/setting-up-your-dev-environment |
+| Hero section tutorial | https://academy.jahia.com/tutorials-get-started/front-end-developer/making-a-hero-section |
+| Blog / content listing | https://academy.jahia.com/tutorials-get-started/front-end-developer/making-a-blog |
+| Page templates | https://academy.jahia.com/tutorials-get-started/front-end-developer/the-about-us-page |
+| i18n (CND attribute, useTranslation, language switcher) | https://academy.jahia.com/documentation/jahia-cms/jahia-8-2/developer/javascript-module-development/preparing-for-internationalization-i18n |
+| GraphQL API | https://academy.jahia.com/documentation/developer/jahia/8/api-documentation/graphql-api |
+| Native Jahia mixins & node types | https://github.com/Jahia/jahia/tree/master/war/src/main/webapp/WEB-INF/etc/repository/nodetypes |
+| JavaScript modules monorepo | https://github.com/Jahia/javascript-modules |
+| Developer training | https://github.com/Jahia/developer-training/blob/main/js-training/slides.md |
+| Integration best practices | https://github.com/Jahia/gautier-braindump/blob/main/articles/integration-best-practices/README.md |
+
+## Local Development URLs
+
+When Jahia is running at `http://localhost:8080` (default credentials: `root` / `root1234`):
+
+- **Login**: http://localhost:8080/cms/login
+- **Page Builder**: http://localhost:8080/jahia/page-builder
+- **jContent**: http://localhost:8080/jahia/jcontent
+- **GraphQL playground**: http://localhost:8080/modules/graphql
+- **JCR browser**: http://localhost:8080/modules/tools/jcrBrowser.jsp
+- **Definitions browser**: http://localhost:8080/modules/tools/definitionsBrowser.jsp
+
+---
+*This file was generated by APM CLI. Do not edit manually.*
+*To regenerate: `apm compile`*

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@jahia/agentic",
+  "version": "0.0.0",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "bin": "./dist/index.js",
+  "scripts": {
+    "benchmark": "node src/benchmark/index.ts",
+    "build": "node src/build/index.ts",
+    "build:website": "node src/benchmark/build-website.ts",
+    "format": "oxfmt",
+    "lint": "tsc --noEmit && oxlint"
+  },
+  "devDependencies": {
+    "@axe-core/playwright": "^4.11.3",
+    "@chachalog/types": "^0.5.1",
+    "@clack/prompts": "^1.4.0",
+    "@types/node": "^25.9.1",
+    "lighthouse": "^13.3.0",
+    "oxfmt": "^0.51.0",
+    "oxlint": "^1.66.0",
+    "playwright": "^1.60.0",
+    "rolldown": "^1.0.1",
+    "typescript": "^6.0.3"
+  }
+}