@newlogic-digital/cli 1.5.0-next.2 → 1.5.0-next.4

package/index.mjs

@@ -3,10 +3,11 @@
 import init from './src/commands/init/index.mjs'
 import cms from './src/commands/cms/index.mjs'
 import blocks from './src/commands/blocks/index.mjs'
+import skills from './src/commands/skills/index.mjs'
 import { styleText } from 'node:util'
 import { version, name } from './src/utils.mjs'
 
-const knownCommands = ['init', 'cms', 'blocks']
+const knownCommands = ['init', 'cms', 'blocks', 'skills']
 
 function normalizeOptionName(name) {
   return name.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase())
@@ -158,6 +159,9 @@ if (!command) {
     ${styleText('green', 'newlogic blocks remove')} ${styleText('yellow', 'about-accordion')}
     ${styleText('green', 'newlogic blocks remove')} ${styleText('yellow', 'header-nav-left hero-floating-text')}
     ${styleText('green', 'newlogic blocks update')}
+
+    -- skills --
+    ${styleText('green', 'newlogic skills install')} - Installs the bundled ${styleText('yellow', 'newlogic-cli')} skill via ${styleText('blue', 'npx skills add')}
   `)
 
   process.exit(0)
@@ -187,6 +191,13 @@ if (command === 'blocks') {
   await blocks(action, names)
 }
 
+if (command === 'skills') {
+  const { positionals } = parseCommandArgs(rawArgs.slice(1))
+  const action = positionals[0]
+
+  await skills(action)
+}
+
 if (command && !knownCommands.includes(command)) {
   printUnknownCommand(command)
   process.exit(1)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@newlogic-digital/cli",
-  "version": "1.5.0-next.2",
+  "version": "1.5.0-next.4",
   "main": "index.mjs",
   "bin": {
     "newlogic-cli": "index.mjs",
@@ -22,6 +22,7 @@
   },
   "files": [
     "index.js",
+    "skills",
     "src"
   ],
   "engines": {

package/skills/newlogic-cli/SKILL.md

@@ -0,0 +1,89 @@
+---
+name: newlogic-cli
+description: Use the installed Newlogic CLI when Codex needs to run `newlogic`, scaffold `@newlogic-digital/ui` or `@newlogic-digital/cms` projects, prepare CMS templates and components, or manage installable blocks through `newlogic.config.json`. Trigger this skill for tasks involving the commands `init`, `cms`, or `blocks`, especially when an agent should run the CLI safely and non-interactively.
+---
+
+# Newlogic CLI
+
+## Quick Rules
+
+- Run commands from the target project directory. `cms` and `blocks` operate on the current working tree.
+- Prefer explicit flags to prompts. For automated runs, pass `-y` and any necessary options.
+- Do not probe for `newlogic` in advance. Install it only after a real command fails because the binary is missing.
+- Expect Node `>=22` and npm `>=10`.
+- Use `newlogic` in user-facing examples.
+
+## Commands
+
+### `init`
+
+Use to scaffold a new project.
+
+- `newlogic init`
+- `newlogic init ui <directory>`
+- `newlogic init cms <directory>`
+
+Useful non-interactive options:
+
+- `--branch=main|dev`
+- `--clone=ssh|https`
+- `--scope=default|blank` for `ui`
+- `--variant=cms-web|cms-eshop` for `cms`
+- `--git`, `--remote=<git-url>`, `--install`
+- `--prepare`, `--dev`, `--migrations` for `cms`
+- `-y` to accept defaults without prompts
+
+Examples:
+
+```bash
+newlogic init ui demo --branch=dev --clone=https --scope=blank --git --remote=git@github.com:org/demo.git --install -y
+newlogic init cms demo --branch=dev --clone=https --variant=cms-web --install --prepare --dev --migrations -y
+```
+
+### `cms`
+
+Use inside a CMS project.
+
+- `newlogic cms prepare`
+- `newlogic cms prepare views`
+- `newlogic cms prepare components`
+- `newlogic cms new-component <name>`
+
+Notes:
+
+- `prepare` copies templates and components from a UI project into CMS structure.
+- `new-component` creates PHP component scaffolding and clears `temp/cache` if present.
+- Deprecated aliases such as `new-section` still exist in code, but prefer `new-component`.
+
+### `blocks`
+
+Use to manage installable blocks in a project root.
+
+- `newlogic blocks list`
+- `newlogic blocks add <name...>`
+- `newlogic blocks remove <name...>`
+- `newlogic blocks update`
+
+Notes:
+
+- `list` prints all installable blocks with short descriptions so the agent can discover valid names before making changes.
+- `add` accepts kebab-case or PascalCase block names.
+- Installed blocks are recorded in `newlogic.config.json`.
+- `update` reinstalls all configured blocks from `newlogic.config.json`.
+- `add` and `remove` may modify files and install npm or composer dependencies.
+
+Recommended flow:
+
+1. Run `newlogic blocks list` to discover what blocks exist.
+2. Match the user request to one or more listed block names.
+3. Run `newlogic blocks add <name...>` only after the names are confirmed by the list output.
+4. Use `remove` only when the user wants to delete blocks that are already installed in the current project.
+5. Use `update` when the goal is to reinstall everything already tracked in `newlogic.config.json`.
+
+## Agent Workflow
+
+1. Choose the command based on intent: scaffold with `init`, sync CMS artifacts with `cms`, manage reusable blocks with `blocks`.
+2. Run it from the correct working directory.
+3. If the command fails because `newlogic` is missing, install it with `npm i -g @newlogic-digital/cli` and retry.
+4. Prefer explicit flags and `-y` for deterministic execution.
+5. After mutation commands, inspect changed files and report side effects such as generated folders, dependency installs, or `newlogic.config.json` updates.

package/skills/newlogic-cli/agents/openai.yaml

@@ -0,0 +1,6 @@
+interface:
+  display_name: "Newlogic CLI"
+  short_description: "Use installed Newlogic CLI for init, cms, and blocks."
+  icon_small: "./assets/favicon.svg"
+  icon_large: "./assets/maskable.png"
+  default_prompt: "Use $newlogic-cli to run Newlogic init, cms, or blocks commands safely and non-interactively."

package/skills/newlogic-cli/assets/favicon.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="120" height="120" viewBox="0 0 120 120">
+  <path fill="#000" d="M89,0,62.68,26.36,36.32,0H0V120H31L57.32,93.64,83.68,120H120V0Zm0,8.53V52.72l-22.1-22.1Zm6,58.75V6H114V109.7L10.3,6H33.82ZM31,111.47V67.28l22.1,22.1Zm-6-58.75V114H6V10.29L109.7,114H86.18Z"/>
+</svg>

package/src/commands/skills/index.mjs

@@ -0,0 +1,62 @@
+import childProcess from 'node:child_process'
+import fs from 'node:fs'
+import { styleText } from 'node:util'
+import { packageRoot, resolveInside } from '../../utils.mjs'
+
+function label(color, text) {
+  return styleText([color, 'bold'], text)
+}
+
+function printSkillsUsage() {
+  console.log([
+    styleText(['blue', 'bold'], 'newlogic skills'),
+    '',
+    styleText(['white', 'bold'], 'Usage:'),
+    '',
+    `  ${styleText('green', 'newlogic skills install')} - Installs the bundled ${styleText('yellow', 'newlogic-cli')} skill`,
+    '',
+    styleText(['white', 'bold'], 'Notes:'),
+    '',
+    `  ${styleText('dim', 'Resolves the installed CLI location automatically and runs:')}`,
+    `  ${styleText('cyan', 'npx skills add <resolved-path>/skills/newlogic-cli')}`,
+  ].join('\n'))
+}
+
+function getBundledSkillPath(skillName = 'newlogic-cli') {
+  return resolveInside(packageRoot, 'skills', skillName)
+}
+
+function installBundledSkill(skillName = 'newlogic-cli', options = {}) {
+  const { execFileSync = childProcess.execFileSync } = options
+  const skillPath = getBundledSkillPath(skillName)
+
+  if (!fs.existsSync(skillPath)) {
+    throw new Error(`Bundled skill "${skillName}" not found at ${skillPath}`)
+  }
+
+  execFileSync('npx', ['skills', 'add', skillPath], { stdio: 'inherit' })
+
+  return skillPath
+}
+
+export { getBundledSkillPath, installBundledSkill }
+
+export default async function skills(action) {
+  if (!action || action === 'help' || action === '--help') {
+    printSkillsUsage()
+    return
+  }
+
+  try {
+    if (action === 'install') {
+      installBundledSkill()
+      return
+    }
+
+    throw new Error(`Unknown skills action "${action}"`)
+  }
+  catch (error) {
+    console.log(`${label('red', 'error')} ${error.message}`)
+    process.exit(1)
+  }
+}

package/src/utils.mjs

@@ -3,7 +3,8 @@ import fs from 'fs'
 import path from 'path'
 import { fileURLToPath } from 'url'
 
-const { version, name } = JSON.parse(fs.readFileSync(path.resolve(path.dirname((fileURLToPath(import.meta.url))), '../package.json')).toString())
+const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+const { version, name } = JSON.parse(fs.readFileSync(path.resolve(packageRoot, 'package.json')).toString())
 
 const execSync = (cmd) => {
   try {
@@ -45,4 +46,4 @@ function resolveInside(rootDir, ...segments) {
   return nextPath
 }
 
-export { execSync, stripIndent, resolveInside, version, name }
+export { execSync, stripIndent, resolveInside, version, name, packageRoot }