@jahia/agentic 0.3.0 → 0.4.1

package/dist/codex/.agents/skills/jahia-content-organize/SKILL.md

@@ -1,209 +0,0 @@
----
-name: jahia-content-organize
-description: Moves, copies, renames, reorders, and deletes Jahia content via MCP tools. Use when asked to reorganize a site structure, duplicate content, or manage the deletion lifecycle.
----
-
-# Skill: jahia-content-organize
-
-Covers structural content-tree operations using MCP tools via the `jahia` MCP server.
-
-> **Never call Jahia's GraphQL API directly.** Use only MCP tools. If a capability is missing, report it — do not work around with curl/GraphQL.
-
----
-
-## Move content
-
-```
-tool: content.move
-args: {
-  "path": "/sites/SITE_KEY/home/blog/main/old-article",
-  "destParentPath": "/sites/SITE_KEY/home/archive/main",
-  "newName": "archived-article"
-}
-```
-
-- `newName` is optional
-- the entire subtree moves with the node
-- the move happens in EDIT; publish afterward
-
-## Copy content
-
-```
-tool: content.copy
-args: {
-  "path": "/sites/SITE_KEY/home/templates/main/hero-banner",
-  "destParentPath": "/sites/SITE_KEY/home/landing/main"
-}
-```
-
-- deep copy, including children and properties
-- the copy gets a new UUID
-- use `excludeChildTypes` when you need to skip specific child node types
-
-## Rename content
-
-```
-tool: content.rename
-args: {
-  "path": "/sites/SITE_KEY/home/about/main/old-name",
-  "newName": "new-name"
-}
-```
-
-Use `content.update` on `jcr:title` when you need to change the display title rather than the node name.
-
-## Reorder siblings
-
-```
-tool: content.reorder
-args: {
-  "parentPath": "/sites/SITE_KEY/home/blog/main",
-  "nodeName": "featured-post",
-  "position": "FIRST"
-}
-```
-
-Place a node before a specific sibling:
-
-```
-tool: content.reorder
-args: {
-  "parentPath": "/sites/SITE_KEY/home/blog/main",
-  "nodeName": "featured-post",
-  "position": "INPLACE",
-  "beforeNodeName": "second-post"
-}
-```
-
----
-
-## Delete content
-
-### Draft-only content
-
-Hard delete immediately:
-
-```
-tool: content.delete
-args: { "path": "/sites/SITE_KEY/home/draft-page/main/temp-node" }
-```
-
-### Published content
-
-Mark the node for deletion first:
-
-```
-tool: content.markForDeletion
-args: { "path": "/sites/SITE_KEY/home/blog/main/old-post" }
-```
-
-Publish the deletion to propagate it to LIVE:
-
-```
-tool: publication.publish
-args: {
-  "path": "/sites/SITE_KEY/home/blog/main/old-post",
-  "languages": ["en"]
-}
-```
-
-Undo the mark if needed:
-
-```
-tool: content.unmarkForDeletion
-args: { "path": "/sites/SITE_KEY/home/blog/main/old-post" }
-```
-
-You cannot hard-delete already published content without first going through the deletion lifecycle.
-
----
-
-## Reorganization patterns
-
-### Move several items into a new section
-
-```
-# 1. Audit the current branch
-tool: content.list
-args: { "parentPath": "/sites/SITE_KEY/home/news/main" }
-
-# 2. Move items
-tool: content.move
-args: {
-  "path": "/sites/SITE_KEY/home/news/main/item-1",
-  "destParentPath": "/sites/SITE_KEY/home/archive/main"
-}
-
-tool: content.move
-args: {
-  "path": "/sites/SITE_KEY/home/news/main/item-2",
-  "destParentPath": "/sites/SITE_KEY/home/archive/main"
-}
-
-# 3. Publish the affected branch
-tool: publication.publish
-args: {
-  "path": "/sites/SITE_KEY/home/archive",
-  "languages": ["en"]
-}
-```
-
-### Duplicate a page structure
-
-```
-# 1. Copy the page
-tool: content.copy
-args: {
-  "path": "/sites/SITE_KEY/home/template-page",
-  "destParentPath": "/sites/SITE_KEY/home"
-}
-
-# 2. Rename the copy
-tool: content.rename
-args: {
-  "path": "/sites/SITE_KEY/home/template-page1",
-  "newName": "new-section"
-}
-
-# 3. Update the page title
-tool: content.update
-args: {
-  "path": "/sites/SITE_KEY/home/new-section",
-  "locale": "en",
-  "properties": {
-    "jcr:title": "New Section"
-  }
-}
-```
-
----
-
-## Key rules
-
-| Rule | Detail |
-|------|--------|
-| Publish after reorganization | Moves, copies, renames, and reorders affect EDIT first |
-| No hard-delete of published nodes | Use `content.markForDeletion` plus `publication.publish` |
-| Move includes the subtree | Children move with the selected node |
-| Name conflicts fail | Moves and renames validate uniqueness |
-| Reorder stays within one parent | Use `content.move` to change parents, `content.reorder` to change sibling order |
-
----
-
-## Common errors
-
-| Error | Cause | Fix |
-|-------|-------|-----|
-| `NODE_NOT_FOUND` | Source path does not exist | Verify with `content.get` or `content.list` |
-| `NODE_EXISTS` | Target name already exists | Choose a different `newName` |
-| `CANNOT_DELETE_PUBLISHED` | Attempted hard delete on published content | Use `content.markForDeletion` |
-| `DEST_NOT_FOUND` | Destination parent does not exist | Verify with `content.get` |
-
----
-
-## Related skills
-
-- `/jahia-content-explore-structure` — inspect the tree before reorganizing it
-- `/jahia-content-publish` — publish after moves, copies, reorders, or deletions
-- `/jahia-content-move-content` — focused move and deletion workflow for an existing branch
-

package/dist/codex/.agents/skills/jahia-content-publish/SKILL.md

@@ -1,181 +0,0 @@
----
-name: jahia-content-publish
-description: Publishes and unpublishes Jahia content via MCP tools. Use when asked to make edits live, remove content from live, or check whether a page or subtree is ready for publication.
----
-
-# Skill: jahia-content-publish
-
-Handles publication workflows using MCP tools via the `jahia` MCP server.
-
-> **Never call Jahia's GraphQL API directly.** Use only MCP tools. If a capability is missing, report it — do not work around with curl/GraphQL.
-
----
-
-## Core concepts
-
-- **EDIT workspace** — where authors create and modify draft content
-- **LIVE workspace** — what public visitors see
-- **Publication is language-scoped** — you publish specific language versions
-- **Publishing a parent can include its subtree**
-- **Workflow may apply** — `publication.publish` may start approval instead of publishing directly
-
----
-
-## Step 1 — Check publication status
-
-```
-tool: publication.status
-args: {
-  "path": "/sites/SITE_KEY/home/about",
-  "language": "en",
-  "subNodes": true,
-  "references": true
-}
-```
-
-This tells you:
-- whether the node or subtree is already published
-- whether descendants are modified or unpublished
-- whether references may block publication
-- whether the current user can publish
-
----
-
-## Step 2 — Publish
-
-```
-tool: publication.publish
-args: {
-  "path": "/sites/SITE_KEY/home/about",
-  "languages": ["en", "fr"]
-}
-```
-
-Possible outcomes:
-- direct publish to LIVE
-- workflow started for approval
-
----
-
-## Step 3 — If approval workflow starts, complete it
-
-List pending tasks:
-
-```
-tool: workflow.tasks
-args: {}
-```
-
-Approve:
-
-```
-tool: workflow.complete
-args: {
-  "taskId": "TASK_ID",
-  "outcome": "accept",
-  "comment": "Approved — reviewed and ready"
-}
-```
-
-Reject:
-
-```
-tool: workflow.complete
-args: {
-  "taskId": "TASK_ID",
-  "outcome": "reject",
-  "comment": "Needs revision"
-}
-```
-
----
-
-## Step 4 — Unpublish
-
-Remove content from LIVE while keeping EDIT:
-
-```
-tool: publication.unpublish
-args: {
-  "path": "/sites/SITE_KEY/home/about/main/outdated-section",
-  "languages": ["en"]
-}
-```
-
----
-
-## Common publication patterns
-
-### Publish a newly created page and its content
-
-```
-tool: publication.publish
-args: {
-  "path": "/sites/SITE_KEY/home/new-page",
-  "languages": ["en"]
-}
-```
-
-### Publish translated content
-
-```
-tool: publication.publish
-args: {
-  "path": "/sites/SITE_KEY/home/about",
-  "languages": ["fr"]
-}
-```
-
-### Publish a deletion after `content.markForDeletion`
-
-```
-tool: publication.publish
-args: {
-  "path": "/sites/SITE_KEY/home/old-page",
-  "languages": ["en"]
-}
-```
-
-### Check whether a subtree is ready
-
-```
-tool: publication.status
-args: {
-  "path": "/sites/SITE_KEY/home",
-  "language": "en",
-  "subNodes": true,
-  "references": true
-}
-```
-
----
-
-## Key rules
-
-| Rule | Detail |
-|------|--------|
-| Always specify languages | Publication is language-scoped |
-| Publish is subtree-aware | Publishing a page includes its content areas and descendants |
-| Workflow is automatic | `publication.publish` decides whether it can publish directly |
-| References matter | Use `references: true` in status checks when media or linked content is involved |
-| Mark-for-deletion needs publish | The deletion becomes live only after publication |
-
----
-
-## Common errors
-
-| Error | Cause | Fix |
-|-------|-------|-----|
-| `NODE_NOT_FOUND` | The path does not exist in EDIT | Verify with `content.get` |
-| `NO_PUBLISH_PERMISSION` | User lacks publishing rights | Check the user's roles |
-| Workflow started but content is still not live | Approval is still pending | Complete the task via `workflow.tasks` and `workflow.complete` |
-| `MANDATORY_LANGUAGE_UNPUBLISHABLE` | Required language content is missing | Add the missing translation first |
-
----
-
-## Related skills
-
-- `/jahia-content-create-content` — create pages and content before publishing them
-- `/jahia-content-translate-content` — translate content before publishing new locales
-- `/jahia-content-organize` — publish after moves, copies, reorders, or deletions
-

package/dist/codex/.agents/skills/jahia-content-query-content/SKILL.md

@@ -1,174 +0,0 @@
----
-name: jahia-content-query-content
-description: Queries JCR content from a running Jahia instance via MCP tools. Use when asked to list, inspect, or retrieve content nodes, check what content exists, or audit a site's content.
----
-
-# Skill: jahia-content-query-content
-
-Retrieves JCR content from a running Jahia instance using MCP tools (via the `jahia` MCP server).
-
-> **Never call Jahia's GraphQL API directly.** Use only MCP tools. If a capability is missing, report it — do not work around with curl/GraphQL.
-
----
-
-## Prerequisites
-
-- MCP server `jahia` connected with a valid API token
-- Know the target **siteKey** (call `site.list` if unsure)
-
----
-
-## Query patterns
-
-### 1 — Get a node by path
-
-```
-tool: content.get
-args: { "path": "/sites/mySite/home/about/main/intro-text" }
-```
-
-Returns all readable properties, mixins, and metadata. Also accepts `uuid`.
-
-### 2 — List children of a node
-
-```
-tool: content.list
-args: {
-  "parentPath": "/sites/mySite/home/about/main",
-  "limit": 50
-}
-```
-
-Optional: `childNodeType` to filter, `projectProperties` to include specific properties.
-
-### 3 — Search by node type
-
-```
-tool: content.search
-args: {
-  "siteKey": "mySite",
-  "nodeType": "mymodule:article",
-  "locale": "en",
-  "sortBy": "jcr:created",
-  "order": "desc",
-  "limit": 10
-}
-```
-
-### 4 — Full-text search
-
-```
-tool: content.search
-args: {
-  "siteKey": "mySite",
-  "nodeType": "jmix:droppableContent",
-  "locale": "en",
-  "fullText": "insurance",
-  "sortBy": "_score",
-  "order": "desc"
-}
-```
-
-### 5 — Filter by property value
-
-```
-tool: content.search
-args: {
-  "siteKey": "mySite",
-  "nodeType": "mymodule:article",
-  "locale": "en",
-  "properties": [
-    { "name": "jcr:createdBy", "op": "eq", "value": "root" }
-  ]
-}
-```
-
-Operators: `eq`, `like`, `gt`, `gte`, `lt`, `lte`, `isNull`, `isNotNull`
-
-### 6 — List all sites
-
-```
-tool: site.list
-```
-
-### 7 — List all pages
-
-```
-tool: page.list
-args: { "siteKey": "mySite" }
-```
-
-Supports: `templateName`, `titleContains`, `createdAfter`, `modifiedAfter`, `sortBy`, `order`.
-
-### 8 — Check publication status
-
-```
-tool: publication.status
-args: {
-  "path": "/sites/mySite/home/about",
-  "language": "en",
-  "subNodes": true
-}
-```
-
-Returns publication status, lock/WIP flags, and permission info.
-
----
-
-## content.search parameter reference
-
-**Required:**
-- `siteKey` — scopes search under `/sites/<siteKey>`
-- `nodeType` — JCR type (e.g. `jnt:page`, `jnt:file`, `jmix:droppableContent`)
-
-**Optional:**
-- `locale` — locale for i18n property resolution (e.g. `"en"`)
-- `fullText` — full-text expression (phrase `"..."`, OR, exclusion `-term`)
-- `fullTextField` — scope full-text to one property
-- `basePath` — restrict to a subtree
-- `properties` — array of property filters (AND-combined)
-- `projectProperties` — properties to include in results
-- `sortBy` — property name (default: `"jcr:lastModified"`) or `"_score"` with fullText
-- `order` — `"asc"` or `"desc"` (default: `"desc"`)
-- `offset` — skip N results (default: 0)
-- `limit` — max results 1–100 (default: 20)
-
----
-
-## Common search patterns
-
-Last 5 created contents:
-```
-tool: content.search
-args: {
-  "siteKey": "mySite",
-  "nodeType": "jmix:droppableContent",
-  "locale": "en",
-  "sortBy": "jcr:created",
-  "order": "desc",
-  "limit": 5
-}
-```
-
-Recently modified pages:
-```
-tool: content.search
-args: {
-  "siteKey": "mySite",
-  "nodeType": "jnt:page",
-  "locale": "en",
-  "sortBy": "jcr:lastModified",
-  "order": "desc",
-  "limit": 10
-}
-```
-
----
-
-## Common errors
-
-| Error | Cause | Fix |
-|-------|-------|-----|
-| `PATH_NOT_FOUND` | Node doesn't exist at given path | Verify path with `content.list` on parent |
-| No results returned | Wrong `nodeType` or `siteKey` | Check available types with `site.types` |
-| Missing i18n properties | `locale` not passed | Always include `locale` for i18n content |