@ooneex/cli 1.37.0 → 1.38.1

package/dist/index.js

@@ -10876,6 +10876,192 @@ git commit -m "chore(common): Update dependencies and cache package"
 Apply all coding conventions from the \`optimize\` skill.
 `;
 
+// src/templates/claude/skills/issue.create.md.txt
+var issue_create_md_default = "---\nname: issue:create\ndescription: Create a new YAML issue file in modules/<module>/issues/ by gathering title, state, priority, labels, description, and module from the user, then running oo issue:create.\n---\n\n# Issue Create\n\nGather issue details from the user and create a new YAML issue file using the `oo issue:create` command.\n\n## Important\n\nAlways run all commands from the **root of the project** (the monorepo root), not from inside individual packages.\n\n## Workflow\n\n### 1. Gather Issue Details\n\nCollect the following from the user (ask only for missing values; infer reasonable defaults for the rest):\n\n| Field | Default | Valid values |\n|-------|---------|--------------|\n| `title` | \u2014 (required) | Any non-empty string |\n| `module` | `shared` | Any module name under `modules/` |\n| `state` | `Todo` | `Backlog`, `Todo`, `In Progress`, `In Review`, `Done`, `Cancelled` |\n| `priority` | `Medium` | `Low`, `Medium`, `High`, `Urgent` |\n| `labels` | `[]` | Comma-separated list |\n| `description` | `null` | Free-form text |\n\nIf the user provides a free-form description, use it as-is \u2014 `/issue:improve` will structure it later.\n\n### 2. Run the Create Command\n\n```bash\noo issue:create \\\n  --title=\"<title>\" \\\n  --module=<module> \\\n  --state=\"<state>\" \\\n  --priority=\"<priority>\" \\\n  [--labels=\"<label1>,<label2>\"] \\\n  [--description=\"<description>\"]\n```\n\nThe command writes a YAML skeleton to `modules/<module>/issues/<ID>.yml` where `<ID>` is an auto-generated identifier (e.g. `ABC-012345`).\n\n### 3. Confirm Creation\n\nReport the path of the created file (e.g. `modules/shared/issues/ABC-012345.yml`) and the assigned ID.\n\n### 4. Suggest Next Steps\n\nAfter creating the file, suggest:\n\n- `/issue:improve` \u2014 to rewrite the description into a structured format with Context, Goal, Acceptance Criteria, and optional Technical Notes\n- `/issue:fix` \u2014 to implement the issue once it is ready\n\n## YAML Structure Reference\n\n```yaml\nid: \"ABC-012345\"\ntitle: \"Add user validation\"\nstate: \"Todo\"\npriority: \"Medium\"\ndescription: null\nlabels: []\n```\n\n## Notes\n\n- If the user already provided all required details, skip interactive prompting and run the command directly.\n- Never invent a title \u2014 always use exactly what the user provided.\n- If `--module` is unknown, default to `shared` and inform the user.\n";
+
+// src/templates/claude/skills/issue.fix.txt
+var issue_fix_default = `---
+name: issue:fix
+description: Find an issue by ID in a module and implement it. Reads modules/<module>/issues/<ID>.yml, then creates or updates entities, repositories, services, controllers/commands, and optional resources.
+---
+
+# Issue Fix
+
+Locate the issue YAML file for the provided module and ID, then implement it.
+
+## Important
+
+Always run all commands from the **root of the project** (the monorepo root), not from inside individual packages.
+
+## Steps
+
+### 1. Locate and read the issue YML
+
+The user must provide:
+- \`--module\` \u2014 the module name (e.g. \`user\`, \`company\`, \`shared\`)
+- \`--id\` \u2014 the issue identifier (e.g. \`ENG-45\`, \`OON-123456\`)
+
+Read the file at:
+
+\`\`\`
+modules/<module>/issues/<ID>.yml
+\`\`\`
+
+If the file does not exist, stop and tell the user the exact path that was checked.
+
+An issue YML looks like:
+
+\`\`\`yaml
+id: "ENG-45"
+title: "Add organization create feature"
+state: "In Progress"
+priority: "High"
+description: |
+  ## Context
+  \u2026
+  ## Goal
+  \u2026
+  ## Acceptance Criteria
+  - [ ] \u2026
+  ## Technical Notes
+  \u2026
+labels:
+  - "Feature"
+  - "API"
+resources:
+  entity: OrganizationEntity
+  repository: OrganizationRepository
+  service: OrganizationCreateService
+  controller: OrganizationCreateController
+  permission: OrganizationPermission
+spec:
+  name: "organization.create"
+  entity: "organization"
+  roles:
+    - super_admin
+    - admin
+  permissions:
+    - name: "organization:create"
+      description: "Grants the ability to create a new organization"
+\`\`\`
+
+### 2. Analyse the issue
+
+Extract:
+
+- \`spec.name\` \u2014 dot-notation identifier (e.g. \`"user.create"\`)
+- \`spec.entity\` \u2014 the resource being acted on (e.g. \`"user"\`)
+- \`description\` \u2014 what the issue requires
+- \`spec.roles\` \u2014 list of roles with access; check \`modules/shared/src/roles.yml\` to map role slugs to their canonical values
+- \`spec.permissions\` \u2014 list of objects with \`name\` (\`"entity:action"\` format) and optional \`description\`
+- \`resources\` \u2014 map of resource keys to PascalCase class names; this is the authoritative list of what to create
+
+Derive the HTTP method from the action part of \`spec.name\`:
+- \`.create\` \u2192 \`post\`
+- \`.read\` / \`.list\` / \`.search\` \u2192 \`get\`
+- \`.update\` \u2192 \`put\` or \`patch\`
+- \`.delete\` \u2192 \`delete\`
+
+### 3. Create or update the entity
+
+Only if \`resources.entity\` is present.
+
+\`\`\`
+/make:entity --name=<resources.entity> --module=<module>
+\`\`\`
+
+### 4. Create migrations for schema changes
+
+If the entity introduces new columns, tables, or relations, create a migration using the \`/make:migration\` skill:
+
+\`\`\`
+/make:migration --module=<module>
+\`\`\`
+
+Implement the \`up()\` method with the required DDL (CREATE TABLE, ALTER TABLE, etc.) and the \`down()\` method to reverse it.
+
+### 5. Create or update the repository
+
+Only if \`resources.repository\` is present.
+
+\`\`\`
+/make:repository --name=<resources.repository> --module=<module>
+\`\`\`
+
+Retain only the CRUD methods that are needed by this issue (e.g. \`.create\` needs \`save\`; \`.read\` needs \`findById\`; \`.list\` needs \`find\`; \`.delete\` needs \`delete\`).
+
+### 6. Create or update the service
+
+Only if \`resources.service\` is present.
+
+\`\`\`
+/make:service --name=<resources.service> --module=<module>
+\`\`\`
+
+Inject the repository into the service via the constructor and implement \`execute()\` with the business logic described by the issue.
+
+### 7. Create or update the controller or command
+
+**Controller** \u2014 only if \`resources.controller\` is present:
+
+\`\`\`
+/make:controller --name=<resources.controller> --module=<module> --route-name=<spec.name> --route-path=<derived-path> --route-method=<derived-method>
+\`\`\`
+
+Derive the route path from the entity and action (e.g. \`"user.create"\` \u2192 \`/users\`, \`"user.read"\` \u2192 \`/users/:id\`).
+
+Inject the service into the controller. Set \`roles\` in the \`@Route\` decorator from \`spec.roles\` as uppercase string literals (e.g., \`"ROLE_USER"\`, \`"ROLE_ADMIN"\`). Apply each permission \`name\` from \`spec.permissions\` to the route decorator when a \`permissions\` field is available on \`@Route\`.
+
+**Command** \u2014 only if \`resources.command\` is present:
+
+\`\`\`
+/make:command --name=<resources.command> --module=<module>
+\`\`\`
+
+Inject the service into the command. Set \`getName()\` to \`"<entity>:<action>"\` format.
+
+### 8. Create or update optional resources
+
+Create each resource that is present in \`resources\` beyond the core four. Use the class name from the \`resources\` map as the \`--name\` value. Do not create resources that are absent from the map.
+
+| \`resources\` key  | Skill                                                                       |
+|------------------|-----------------------------------------------------------------------------|
+| \`permission\`     | \`/make:permission --name=<resources.permission> --module=<module>\`          |
+| \`middleware\`     | \`/make:middleware --name=<resources.middleware> --module=<module>\`          |
+| \`cache\`          | \`/make:cache --name=<resources.cache> --module=<module>\`                    |
+| \`pubsub\`         | \`/make:pubsub --name=<resources.pubsub> --module=<module>\`                  |
+| \`mailer\`         | \`/make:mailer --name=<resources.mailer> --module=<module>\`                  |
+| \`logger\`         | \`/make:logger --name=<resources.logger> --module=<module>\`                  |
+| \`analytics\`      | \`/make:analytics --name=<resources.analytics> --module=<module>\`            |
+| \`storage\`        | \`/make:storage --name=<resources.storage> --module=<module>\`                |
+| \`cron\`           | \`/make:cron --name=<resources.cron> --module=<module>\`                      |
+| \`ai\`             | \`/make:ai --name=<resources.ai> --module=<module>\`                          |
+| \`database\`       | \`/make:database --name=<resources.database> --module=<module>\`              |
+| \`vectorDatabase\` | \`/make:vector-database --name=<resources.vectorDatabase> --module=<module>\` |
+
+### 9. Lint and format
+
+\`\`\`bash
+bun run fmt
+bun run lint
+\`\`\`
+
+### 10. Confirm
+
+Report:
+
+- Issue \`id\` and \`title\` implemented
+- Resources created or updated (list each key and class name from \`resources\`)
+- Any step that was skipped and why
+
+## Notes
+
+- The \`resources\` map is the single source of truth for what to create \u2014 do not infer additional resources beyond what is listed.
+- If a resource already exists, update it rather than overwrite it \u2014 add new methods, columns, or routes without removing existing ones unless they conflict.
+- Derive all names, paths, and methods from the issue; never ask the user for values that can be inferred.
+- Apply all coding conventions from the \`optimize\` skill to every generated file.
+`;
+
 // src/templates/claude/skills/issue.improve.md.txt
 var issue_improve_md_default = `---
 name: issue:improve
@@ -14199,6 +14385,8 @@ var skills = {
   "make.service": make_service_md_default,
   "make.storage": make_storage_md_default,
   "make.vector-database": make_vector_database_md_default,
+  "issue.create": issue_create_md_default,
+  "issue.fix": issue_fix_default,
   "issue.improve": issue_improve_md_default,
   commit: commit_md_default,
   optimize: optimize_md_default
@@ -14715,181 +14903,10 @@ import { decorator as decorator9 } from "@ooneex/command";
 import { TerminalLogger as TerminalLogger9 } from "@ooneex/logger";
 
 // src/templates/completions/_oo.txt
-var _oo_default = `#compdef oo ooneex
-
-_oo_modules() {
-  local -a modules
-  if [[ -d modules ]]; then
-    modules=(\${(@f)"$(command ls -1 modules 2>/dev/null)"})
-    compadd -a modules
-  fi
-}
-
-_oo_custom_commands() {
-  local -a cmds
-  if [[ -d modules ]]; then
-    cmds=(\${(@f)"$(command grep -rh -A1 'getName' modules/*/src/commands/*Command.ts 2>/dev/null | sed -n 's/.*return "\\(.*\\)".*/\\1/p' | sort -u)"})
-    compadd -a cmds
-  fi
-}
+var _oo_default = `#compdef oo
 
 _oo() {
-  local -a commands
-  commands=(
-    'app\\:build:Build the application'
-    'app\\:create:Create a new application'
-    'app\\:init:Initialize an application'
-    'app\\:start:Start the application'
-    'app\\:stop:Stop the application'
-    'claude\\:skill\\:create:Generate Claude skills from templates'
-    'command\\:run:Run a custom command from a module'
-    'completion\\:zsh:Install Zsh completion for oo command'
-    'help:Show available commands'
-    'issue\\:create:Create a YAML skeleton file for a new issue'
-    'issue\\:pull:Pull an issue from Linear and save it as a YAML file'
-    'issue\\:push:Push a local issue YAML to Linear (create or update)'
-    'make\\:ai:Generate a new AI class'
-    'make\\:analytics:Generate a new analytics class'
-    'make\\:cache:Generate a new cache class'
-    'make\\:command:Generate a new command class'
-    'make\\:controller:Generate a new controller class'
-    'make\\:cron:Generate a new cron class'
-    'make\\:database:Generate a new database class'
-    'make\\:docker:Add a docker service to docker-compose.yml'
-    'make\\:entity:Generate a new entity class'
-    'make\\:logger:Generate a new logger class'
-    'make\\:mailer:Generate a new mailer class'
-    'make\\:middleware:Generate a new middleware class'
-    'make\\:permission:Generate a new permission class'
-    'make\\:pubsub:Generate a new PubSub event class'
-    'make\\:release:Release packages with version bump, changelog, and git tag'
-    'make\\:repository:Generate a new repository class'
-    'make\\:resource\\:book:Generate book resource (entity, migration, repository)'
-    'make\\:service:Generate a new service class'
-    'make\\:storage:Generate a new storage class'
-    'make\\:vector-database:Generate a new vector database class'
-    'migration\\:create:Generate a new migration file'
-    'migration\\:up:Run migrations for all modules'
-    'module\\:create:Generate a new module'
-    'module\\:lock:Lock module migrations by hashing their content into a yml file'
-    'module\\:remove:Remove an existing module'
-    'seed\\:create:Generate a new seed file'
-    'seed\\:run:Run seeds for all modules'
-  )
-
-  _arguments -s \\
-    '1:command:->cmds' \\
-    '*::options:->opts' \\
-    && return 0
-
-  case "$state" in
-    cmds)
-      _describe -t commands 'oo command' commands
-      ;;
-    opts)
-      case "$words[1]" in
-        app:build|app:start|app:stop|claude:skill:create|completion:zsh|help|make:release|make:resource:book)
-          ;;
-        app:create)
-          _arguments -s \\
-            '--name=[Name of the resource]:name' \\
-            '--destination=[Destination path]:destination:_files -/'
-          ;;
-        app:init)
-          _arguments -s \\
-            '--name=[Name of the resource]:name' \\
-            '--destination=[Destination path]:destination:_files -/' \\
-            '--app-type=[Application type]:type:(cli api)'
-          ;;
-        command:run)
-          _arguments -s \\
-            '1:command name:_oo_custom_commands'
-          ;;
-        issue:create)
-          _arguments -s \\
-            '--title=[Issue title]:title' \\
-            '--state=[Issue state]:state:(Backlog Todo "In Progress" "In Review" Done Cancelled)' \\
-            '--priority=[Issue priority]:priority:(Low Medium High Urgent)' \\
-            '--description=[Issue description]:description' \\
-            '*--labels=[Label (repeatable)]:label' \\
-            '--module=[Module name]:module:_oo_modules' \\
-            '--interactive[Prompt for all fields]'
-          ;;
-        issue:pull)
-          _arguments -s \\
-            '--id=[Linear issue ID or identifier]:id' \\
-            '--module=[Module name]:module:_oo_modules'
-          ;;
-        issue:push)
-          _arguments -s \\
-            '--id=[Local issue ID to push]:id' \\
-            '--module=[Module name]:module:_oo_modules'
-          ;;
-        make:ai|make:analytics|make:cache|make:command|make:cron|make:database|make:logger|make:mailer|make:permission|make:repository|make:service|make:storage|make:vector-database)
-          _arguments -s \\
-            '--name=[Name of the resource]:name' \\
-            '--module=[Module name]:module:_oo_modules'
-          ;;
-        make:controller)
-          _arguments -s \\
-            '--name=[Name of the resource]:name' \\
-            '--module=[Module name]:module:_oo_modules' \\
-            '--route-name=[Route name]:route_name' \\
-            '--route-path=[Route path]:route_path' \\
-            '--route-method=[Route HTTP method]:method:(GET POST PUT PATCH DELETE HEAD OPTIONS)' \\
-            '--is-socket[Socket mode]'
-          ;;
-        make:docker)
-          _arguments -s \\
-            '--name=[Docker service name]:name:(clickhouse elasticsearch grafana jaeger keycloak libretranslate maildev memcached minio mongodb mysql nats postgres prometheus rabbitmq redis temporal vault)'
-          ;;
-        make:entity)
-          _arguments -s \\
-            '--name=[Name of the resource]:name' \\
-            '--module=[Module name]:module:_oo_modules' \\
-            '--table-name=[Database table name]:table_name'
-          ;;
-        make:middleware)
-          _arguments -s \\
-            '--name=[Name of the resource]:name' \\
-            '--module=[Module name]:module:_oo_modules' \\
-            '--is-socket[Socket mode]'
-          ;;
-        make:pubsub)
-          _arguments -s \\
-            '--name=[Name of the resource]:name' \\
-            '--module=[Module name]:module:_oo_modules' \\
-            '--channel=[Channel name]:channel'
-          ;;
-        migration:create)
-          _arguments -s \\
-            '--module=[Module name]:module:_oo_modules'
-          ;;
-        migration:up|seed:run)
-          _arguments -s \\
-            '--drop[Drop the database before running]'
-          ;;
-        module:create)
-          _arguments -s \\
-            '--name=[Name of the resource]:name'
-          ;;
-        module:lock)
-          _arguments -s \\
-            '--module=[Module name]:module:_oo_modules' \\
-            '--override[Override already registered migrations]'
-          ;;
-        module:remove)
-          _arguments -s \\
-            '--name=[Module name]:name:_oo_modules'
-          ;;
-        seed:create)
-          _arguments -s \\
-            '--name=[Name of the resource]:name' \\
-            '--module=[Module name]:module:_oo_modules'
-          ;;
-      esac
-      ;;
-  esac
+  _ooneex "$@"
 }
 
 _oo "$@"
@@ -100312,4 +100329,4 @@ SeedRunCommand = __legacyDecorateClassTS([
 // src/index.ts
 await run();
 
-//# debugId=D7A46627B064367C64756E2164756E21
+//# debugId=5D565F8BCFA6DAC564756E2164756E21