@skyf0xx/hedgehog-core-full-stack-app 1.0.0 → 1.0.5

package/README.md

@@ -39,3 +39,42 @@ A Hedgehog installation depends on this package for the `full-stack-app`
 core rather than carrying its content directly. See the Hedgehog engine
 (`@skyf0xx/hedgehog`) for the installer and build-graph tooling that
 consumes it.
+
+## Working on this core
+
+This is a versioned npm package that the Hedgehog engine's `init` fetches
+by name, carrying `full-stack-app`'s own agents, skills, a pre-built
+workspace, and the `hedgehog-core.yaml` manifest that names all three to
+the engine. See the engine repo
+([`skyf0xx/hedgehog`](https://github.com/skyf0xx/hedgehog)) and its
+[`ARCHITECTURE.md`](https://github.com/skyf0xx/hedgehog/blob/master/ARCHITECTURE.md)
+for how `init` resolves and fetches a core package — that mechanism lives
+there, not here.
+
+No root `CLAUDE.md` lives in this repo. `CLAUDE.core.md` is a payload
+file: its content is installed into a *consuming project's* generated
+`CLAUDE.md`, filling that project's `{{CORE_SECTION}}` placeholder. A
+plain root `CLAUDE.md` here would auto-load into any coding agent working
+on this package itself, bleeding project-build context into a repo where
+no Hedgehog build ever runs — build guidance for a project using this
+core lives in that project's own generated `CLAUDE.md`, never here.
+
+Changing this core means editing one of: the `workspace/` template (the
+scaffold a Hedgehog install copies into a project's repo root), an agent
+under `agents/`, a skill under `skills/`, or the vendored asset set under
+`vendor-skills/GSAP`. `scripts/regenerate-full-stack-app-core.sh` is the
+deterministic generator that rebuilds `workspace/` from scratch — run it
+by hand after bumping a workspace dependency, then diff the result before
+committing. A change here is a release of this package, not of the
+engine: bump `package.json`'s version, commit, and merge to `main` — this
+repo's own `publish.yml` tags and publishes from there.
+
+When `workspace/`'s template needs a new piece of repeatable boilerplate
+— a new module shape, a new generated file type — prefer building or
+extending a generator over hand-authoring the output once. This core
+already models the pattern: `workspace/tools/generators/` carries Nx
+generators for every domain-module layer (`schema`, `contract`,
+`repository`, `service`, `controller`, `hook`, `screen`) that
+`nx-generate` drives instead of an agent writing that boilerplate
+freehand. Other cores and future add-ons should model new scaffolding
+against this one.

package/hedgehog-core.yaml

@@ -2,16 +2,6 @@ name: full-stack-app
 flag: --ts-full-stack-app
 language: typescript
 engine: "^5.0.0"
-selects_when: >
-  The description names persistent domain data with its own lifecycle:
-  something that gets created, changes state, gets queried back later, or
-  needs accounts/auth, background jobs, or a real app beyond a single
-  page. Data that gets stored is this core at any size — a todo list, a
-  notes app, a tracker of any kind — never talked down to browser-local
-  storage or a single-file page for sounding small. If the project has
-  both a marketing page and a real app behind it, this is still
-  full-stack-app: the page becomes routes inside apps/web, not a
-  separate project.
 workspace: workspace/
 template: CLAUDE.core.md
 agents: [backend-eng, ux-planner, front-end-eng]

package/package.json

@@ -1,8 +1,11 @@
 {
   "name": "@skyf0xx/hedgehog-core-full-stack-app",
-  "version": "1.0.0",
+  "version": "1.0.5",
   "description": "Hedgehog's full-stack-app core: an Nx/pnpm/NestJS/Next.js workspace, backend-first domain module build discipline, and the agents and skills that drive it.",
   "type": "module",
+  "scripts": {
+    "release": "npm version patch -m \"chore: bump version to %s\""
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/skyf0xx/hedgehog-core-full-stack-app.git"

package/workspace/package.json

@@ -10,6 +10,7 @@
     "@commitlint/cli": "^21.2.1",
     "@commitlint/config-conventional": "^21.2.0",
     "@eslint/js": "^10.0.1",
+    "@hedgehog/generators": "workspace:*",
     "@nestjs/schematics": "^11.0.0",
     "@nestjs/testing": "^11.0.0",
     "@next/eslint-plugin-next": "^16.1.6",
@@ -89,6 +90,7 @@
       "brace-expansion@2": "^2.1.4",
       "brace-expansion@5": "^5.0.9",
       "fast-uri": "^3.1.5",
+      "image-size": "^1.2.1",
       "js-yaml@3": "^3.15.1",
       "js-yaml@4": "^4.3.1",
       "nanoid": "^3.3.17",