@mantajs/core 0.2.0-beta.0 → 0.2.0-beta.10

package/skills/mantajs/SKILL.md

@@ -0,0 +1,67 @@
+---
+name: mantajs
+description: Use when working inside a Manta/Mantajs project: creating models, services, commands, queries, workflows, dashboards/SPAs, adapters, plugins, hosts, tests, or deployment config. Loads the canonical framework documentation shipped by @mantajs/core.
+---
+
+# Mantajs
+
+Before changing Manta code in an application, read the project root `AGENT.md` if it exists. It contains project-specific conventions plus links to the framework docs.
+
+The canonical framework documentation is shipped with `@mantajs/core`:
+
+```
+node_modules/@mantajs/core/docs/
+```
+
+If this skill was installed or refreshed by the Manta CLI, it should live at:
+
+```
+.codex/skills/mantajs/SKILL.md
+.claude/skills/mantajs/SKILL.md
+```
+
+`manta init` writes the skill for new projects. `manta dev` refreshes it for existing projects so it stays aligned with the installed `@mantajs/core` docs.
+
+## Workflow
+
+1. Identify the primitive or area involved.
+2. Read only the matching doc file from `node_modules/@mantajs/core/docs/`.
+3. Follow the existing project structure and generated `AGENT.md`.
+4. Prefer Manta primitives over hand-written routes or custom framework glue.
+
+## Doc Map
+
+| Need | Read |
+| --- | --- |
+| Mental model, project structure | `00-overview.md` |
+| First project or scaffolded layout | `01-getting-started.md` |
+| Entities and fields | `02-models.md` |
+| Services and repositories | `03-services.md` |
+| Users, auth, sessions | `04-users.md` |
+| Commands, workflows, long-running runs | `05-commands.md` |
+| Queries and external query graph | `06-queries.md` |
+| Events, jobs, workflows | `07-events.md` |
+| Links and relations | `08-links.md` |
+| AI agents and typed LLM steps | `09-agents.md` |
+| SPA generation, dashboard mount path, SDK | `10-spa.md` |
+| `defineConfig`, CLI, presets, release config | `11-config.md` |
+| Constraints and validation rules | `12-constraints.md` |
+| Tests and conformance suites | `13-testing.md` |
+| Adapter authoring | `14-adapters.md` |
+| Host authoring and production bootstrap | `15-hosts.md` |
+| API surface reference | `16-reference.md` |
+| Dashboard specs, pages, forms, blocks | `17-dashboard.md` |
+
+## Current SPA Rules
+
+- Standalone/Nitro SPAs live in `src/spa/{name}/`.
+- The default mount path is `/{name}`; set `spa.{name}.mountPath = "/"` in `manta.config.ts` for a root-mounted SPA on a dedicated subdomain.
+- `@mantajs/dashboard/index.css` is the public dashboard stylesheet export.
+- Root-mounted SPAs must not capture `/api/*`; keep API routes under `/api`.
+
+## Hard Rules
+
+- Do not create ad hoc API routes for business behavior; use `defineCommand()` or `defineQuery()`.
+- Do not bypass generated services for simple entity writes.
+- Keep module entities/services together under `src/modules/{module}/entities/{entity}/`.
+- Read the relevant doc before inventing a new pattern.

package/skills/mantajs/agents/openai.yaml

@@ -0,0 +1,3 @@
+display_name: Mantajs
+short_description: Work with Mantajs projects using the docs shipped by @mantajs/core.
+default_prompt: Read the Mantajs project AGENT.md, then use the relevant @mantajs/core docs before changing code.