claudeos-core 2.4.4 → 2.5.1

package/pass-prompts/templates/java-spring/pass3.md

@@ -68,7 +68,8 @@ Generation targets:
    Content within each section adapts to this project based on pass2-merged.json.
    The scaffold's validation checklist MUST pass.
 
-   Stack-specific hints for this project (Java Spring Boot):
+   Stack-specific hints for this project (Java Spring — Boot, or Spring Framework
+   without Boot when `project-analysis.json` says `framework: "spring-framework"`):
    - Project type for Section 1 PROJECT_CONTEXT: "Backend Application" or "REST API Server"
    - Architecture diagram (Section 4): layered architecture (Controller → Service → Mapper/Repository)
    - Section 2 should include: JDK version, Gradle/Maven, DB, session/cache, server port
@@ -89,7 +90,7 @@ Generation targets:
    - 30.security-db/01.security-auth.md — Authentication, authorization, CORS
    - 30.security-db/02.database-schema.md — DDL, migrations, audit columns
    - 30.security-db/03.common-utilities.md — Common utilities, constants, Base classes
-   - 40.infra/01.environment-config.md — Profiles, environment variables, configuration management
+   - 40.infra/01.environment-config.md — Profiles, environment variables, configuration management, build scripts (`build.gradle` / `build.gradle.kts` / `pom.xml`) and the Gradle version catalog
    - 40.infra/02.logging-monitoring.md — Logging standards, monitoring, alerts
    - 40.infra/03.cicd-deployment.md — CI/CD pipeline, deployment strategy
    - 80.verification/01.development-verification.md — Build, startup, API testing
@@ -113,7 +114,7 @@ Generation targets:
      - `00.core/*` rules: `paths: ["**/*"]` — always loaded (architecture, naming are universally needed)
      - `10.backend/*` rules: `paths: ["**/*"]` — always loaded (backend rules needed for any source editing)
      - `30.security-db/*` rules: `paths: ["**/*"]` — always loaded (cross-cutting concerns)
-     - `40.infra/01.environment-config-rules.md` paths: `["**/*.properties", "**/*.yml", "**/*.yaml", "**/.env*", "**/config/**", "**/application*.properties"]` — Spring config files
+     - `40.infra/01.environment-config-rules.md` paths: `["**/*.properties", "**/*.yml", "**/*.yaml", "**/.env*", "**/config/**", "**/application*.properties", "**/*.gradle", "**/*.gradle.kts", "**/gradle/libs.versions.toml", "**/pom.xml"]` — Spring config files + build scripts (Groovy and Kotlin DSL) + version catalog
      - `40.infra/02.logging-monitoring-rules.md` paths: `["**/*.java", "**/logback*.xml", "**/logback*.groovy", "**/log4j*.xml", "**/log4j*.properties", "**/log4jdbc*.properties"]` — source code where logs live + log config (covers Logback XML/Groovy DSL, Log4j/Log4j2 XML/properties, and log4jdbc JDBC-logging adapter properties)
      - `40.infra/03.cicd-deployment-rules.md` paths: `["**/*.yml", "**/*.yaml", "**/Dockerfile*", "**/*.gradle*", "**/pom.xml", "**/*.java"]` — CI / build config + source
      - `50.sync/*` rules: `paths: ["**/claudeos-core/**", "**/.claude/**"]` — loaded only when editing claudeos-core files
@@ -155,7 +156,7 @@ Generation targets:
      List only the standard files that were actually generated above. Include frontend standards only if frontend was detected. NOTE: `00.core/04.doc-writing-guide.md` is a FORWARD REFERENCE — Pass 4 will generate it; include it anyway. Do NOT add a "DO NOT Read" section here — that information lives in CLAUDE.md Section 7 (the single source of truth).
 
 4. .claude/rules/50.sync/ (2 sync rules — AI fallback reminders)
-   - NOTE: These rules remind AI to run `npx claudeos-core refresh` after modifying standard/rules/skills files.
+   - NOTE: These rules remind AI to keep standard ↔ rules ↔ MANIFEST in sync when it edits any of them (`npx claudeos-core health` reports drift). Do NOT reference `npx claudeos-core refresh` — it is a no-op since v2.1.0.
    - 01.doc-sync.md — Bidirectional standard ↔ rules sync reminder (both directions in ONE rule).
      Do NOT generate a separate 02.rules-sync.md mirror file — redundant.
      Express the mapping as a naming convention (standard/<N>.<dir>/<M>.<n>.md ↔

package/pass-prompts/templates/kotlin-spring/pass3.md

@@ -118,7 +118,7 @@ Generation targets:
      - `00.core/*` rules: `paths: ["**/*"]` — always loaded (architecture, naming are universally needed)
      - `10.backend/*` rules: `paths: ["**/*"]` — always loaded (backend rules needed for any source editing)
      - `30.security-db/*` rules: `paths: ["**/*"]` — always loaded (cross-cutting concerns)
-     - `40.infra/01.environment-config-rules.md` paths: `["**/*.properties", "**/*.yml", "**/*.yaml", "**/.env*", "**/config/**", "**/application*.properties"]` — Spring config files
+     - `40.infra/01.environment-config-rules.md` paths: `["**/*.properties", "**/*.yml", "**/*.yaml", "**/.env*", "**/config/**", "**/application*.properties", "**/*.gradle", "**/*.gradle.kts", "**/gradle/libs.versions.toml", "**/pom.xml"]` — Spring config files + build scripts (Groovy and Kotlin DSL) + version catalog
      - `40.infra/02.logging-monitoring-rules.md` paths: `["**/*.kt", "**/*.kts", "**/logback*.xml", "**/logback*.groovy", "**/log4j*.xml", "**/log4j*.properties", "**/log4jdbc*.properties"]` — source code where logs live + log config (covers Logback XML/Groovy DSL, Log4j/Log4j2 XML/properties, and log4jdbc JDBC-logging adapter properties)
      - `40.infra/03.cicd-deployment-rules.md` paths: `["**/*.yml", "**/*.yaml", "**/Dockerfile*", "**/*.gradle*", "**/*.kt", "**/*.kts"]` — CI / build config + source
      - `50.sync/*` rules: `paths: ["**/claudeos-core/**", "**/.claude/**"]` — loaded only when editing claudeos-core files
@@ -162,7 +162,7 @@ Generation targets:
      List only the standard files that were actually generated above. Include frontend standards only if frontend was detected. NOTE: `00.core/04.doc-writing-guide.md` is a FORWARD REFERENCE — Pass 4 will generate it; include it anyway. Do NOT add a "DO NOT Read" section here — that information lives in CLAUDE.md Section 7 (the single source of truth).
 
 4. .claude/rules/50.sync/ (2 sync rules — AI fallback reminders)
-   - NOTE: These rules remind AI to run `npx claudeos-core refresh` after modifying standard/rules/skills files.
+   - NOTE: These rules remind AI to keep standard ↔ rules ↔ MANIFEST in sync when it edits any of them (`npx claudeos-core health` reports drift). Do NOT reference `npx claudeos-core refresh` — it is a no-op since v2.1.0.
    - 01.doc-sync.md — Bidirectional standard ↔ rules sync reminder (both directions in ONE rule).
      Do NOT generate a separate 02.rules-sync.md mirror file — redundant.
      Express the mapping as a naming convention (standard/<N>.<dir>/<M>.<n>.md ↔

package/pass-prompts/templates/node-express/pass3.md

@@ -130,7 +130,7 @@ Generation targets:
      List only the standard files that were actually generated above. NOTE: `00.core/04.doc-writing-guide.md` is a FORWARD REFERENCE — Pass 4 will generate it; include it anyway. Do NOT add a "DO NOT Read" section here — that information lives in CLAUDE.md Section 7 (the single source of truth).
 
 4. .claude/rules/50.sync/ (2 sync rules — AI fallback reminders)
-   - NOTE: These rules remind AI to run `npx claudeos-core refresh` after modifying standard/rules/skills files.
+   - NOTE: These rules remind AI to keep standard ↔ rules ↔ MANIFEST in sync when it edits any of them (`npx claudeos-core health` reports drift). Do NOT reference `npx claudeos-core refresh` — it is a no-op since v2.1.0.
    - 01.doc-sync.md — Bidirectional standard ↔ rules sync reminder (both directions in ONE rule).
      Do NOT generate a separate 02.rules-sync.md mirror file — redundant.
      Express the mapping as a naming convention (standard/<N>.<dir>/<M>.<n>.md ↔

package/pass-prompts/templates/node-fastify/pass3.md

@@ -89,6 +89,7 @@ Generation targets:
      - `60.memory/*` rules: forward reference — Pass 4 will generate 4 files (01.decision-log, 02.failure-patterns, 03.compaction, 04.auto-rule-update), each with file-specific `paths`. Pass 3 must STILL list ```.claude/rules/60.memory/*``` as a row in CLAUDE.md Section 6 Rules table so developers/Claude see the category exists.
      - `70.domains/*` rules (multi-domain projects only): per-domain rules at `.claude/rules/70.domains/{type}/{domain}-rules.md` (where `{type}` is `backend` or `frontend`, ALWAYS present even in single-stack projects for uniform layout + zero-migration future-proofing), each with a `paths:` glob scoped to that domain's source directories so the rule auto-loads only when editing files within the relevant domain. Folder name is PLURAL (`domains/`) — collection of N per-domain files — and each file inside uses the SINGULAR domain name (`{domain}-rules.md`). DO NOT use `60.domains/` (collides with `60.memory/`) and DO NOT skip the `{type}/` sub-folder. See pass3-footer.md "Per-domain folder convention" for the full rationale.
    - MUST generate `.claude/rules/00.core/00.standard-reference.md` as a directory of all standard files
+     (paths only, grouped by category). Include the FORWARD REFERENCE `claudeos-core/standard/00.core/04.doc-writing-guide.md` under `## Core` — Pass 4 generates it; omitting it leaves an index gap the moment Pass 4 runs. Do NOT add a "DO NOT Read" section here — CLAUDE.md Section 7 is the single source of truth.
 
 4. .claude/rules/50.sync/ (2 sync rules)
    - 01.doc-sync.md — Bidirectional standard ↔ rules sync reminder (both directions in ONE rule).

package/pass-prompts/templates/node-nestjs/pass3.md

@@ -97,6 +97,7 @@ Generation targets:
      - `60.memory/*` rules: forward reference — Pass 4 will generate 4 files (01.decision-log, 02.failure-patterns, 03.compaction, 04.auto-rule-update), each with file-specific `paths`. Pass 3 must STILL list ```.claude/rules/60.memory/*``` as a row in CLAUDE.md Section 6 Rules table so developers/Claude see the category exists.
      - `70.domains/*` rules (multi-domain projects only): per-domain rules at `.claude/rules/70.domains/{type}/{domain}-rules.md` (where `{type}` is `backend` or `frontend`, ALWAYS present even in single-stack projects for uniform layout + zero-migration future-proofing), each with a `paths:` glob scoped to that domain's source directories so the rule auto-loads only when editing files within the relevant domain. Folder name is PLURAL (`domains/`) — collection of N per-domain files — and each file inside uses the SINGULAR domain name (`{domain}-rules.md`). DO NOT use `60.domains/` (collides with `60.memory/`) and DO NOT skip the `{type}/` sub-folder. See pass3-footer.md "Per-domain folder convention" for the full rationale.
    - MUST generate `.claude/rules/00.core/00.standard-reference.md` — directory of all standard files.
+     (paths only, grouped by category). Include the FORWARD REFERENCE `claudeos-core/standard/00.core/04.doc-writing-guide.md` under `## Core` — Pass 4 generates it; omitting it leaves an index gap the moment Pass 4 runs. Do NOT add a "DO NOT Read" section here — CLAUDE.md Section 7 is the single source of truth.
      List only the standard files that were actually generated above.
 
 4. .claude/rules/50.sync/ (2 sync rules)

package/pass-prompts/templates/node-nextjs/pass3.md

@@ -132,7 +132,7 @@ Generation targets:
      List only the standard files that were actually generated above. NOTE: `00.core/04.doc-writing-guide.md` is a FORWARD REFERENCE — Pass 4 will generate it; include it anyway. Do NOT add a "DO NOT Read" section here — that information lives in CLAUDE.md Section 7 (the single source of truth).
 
 4. .claude/rules/50.sync/ (2 sync rules — AI fallback reminders)
-   - NOTE: These rules remind AI to run `npx claudeos-core refresh` after modifying standard/rules/skills files.
+   - NOTE: These rules remind AI to keep standard ↔ rules ↔ MANIFEST in sync when it edits any of them (`npx claudeos-core health` reports drift). Do NOT reference `npx claudeos-core refresh` — it is a no-op since v2.1.0.
    - 01.doc-sync.md — Bidirectional standard ↔ rules sync reminder (both directions in ONE rule).
      Do NOT generate a separate 02.rules-sync.md mirror file — redundant.
      Express the mapping as a naming convention (standard/<N>.<dir>/<M>.<n>.md ↔

package/pass-prompts/templates/node-vite/pass3.md

@@ -83,6 +83,7 @@ Generation targets:
      - `60.memory/*` rules: forward reference — Pass 4 will generate 4 files (01.decision-log, 02.failure-patterns, 03.compaction, 04.auto-rule-update), each with file-specific `paths`. Pass 3 must STILL list ```.claude/rules/60.memory/*``` as a row in CLAUDE.md Section 6 Rules table so developers/Claude see the category exists.
      - `70.domains/*` rules (multi-domain projects only): per-domain rules at `.claude/rules/70.domains/{type}/{domain}-rules.md` (where `{type}` is `backend` or `frontend`, ALWAYS present even in single-stack projects for uniform layout + zero-migration future-proofing), each with a `paths:` glob scoped to that domain's source directories so the rule auto-loads only when editing files within the relevant domain. Folder name is PLURAL (`domains/`) — collection of N per-domain files — and each file inside uses the SINGULAR domain name (`{domain}-rules.md`). DO NOT use `60.domains/` (collides with `60.memory/`) and DO NOT skip the `{type}/` sub-folder. See pass3-footer.md "Per-domain folder convention" for the full rationale.
    - MUST generate `.claude/rules/00.core/00.standard-reference.md` — directory of all standard files.
+     (paths only, grouped by category). Include the FORWARD REFERENCE `claudeos-core/standard/00.core/04.doc-writing-guide.md` under `## Core` — Pass 4 generates it; omitting it leaves an index gap the moment Pass 4 runs. Do NOT add a "DO NOT Read" section here — CLAUDE.md Section 7 is the single source of truth.
 
 4. .claude/rules/50.sync/ (2 sync rules)
    - 01.doc-sync.md — Bidirectional standard ↔ rules sync reminder (both directions in ONE rule).

package/pass-prompts/templates/python-django/pass3.md

@@ -131,7 +131,7 @@ Generation targets:
      List only the standard files that were actually generated above. NOTE: `00.core/04.doc-writing-guide.md` is a FORWARD REFERENCE — Pass 4 will generate it; include it anyway. Do NOT add a "DO NOT Read" section here — that information lives in CLAUDE.md Section 7 (the single source of truth).
 
 4. .claude/rules/50.sync/ (2 sync rules — AI fallback reminders)
-   - NOTE: These rules remind AI to run `npx claudeos-core refresh` after modifying standard/rules/skills files.
+   - NOTE: These rules remind AI to keep standard ↔ rules ↔ MANIFEST in sync when it edits any of them (`npx claudeos-core health` reports drift). Do NOT reference `npx claudeos-core refresh` — it is a no-op since v2.1.0.
    - 01.doc-sync.md — Bidirectional standard ↔ rules sync reminder (both directions in ONE rule).
      Do NOT generate a separate 02.rules-sync.md mirror file — redundant.
      Express the mapping as a naming convention (standard/<N>.<dir>/<M>.<n>.md ↔

package/pass-prompts/templates/python-fastapi/pass3.md

@@ -132,7 +132,7 @@ Generation targets:
      List only the standard files that were actually generated above. NOTE: `00.core/04.doc-writing-guide.md` is a FORWARD REFERENCE — Pass 4 will generate it; include it anyway. Do NOT add a "DO NOT Read" section here — that information lives in CLAUDE.md Section 7 (the single source of truth).
 
 4. .claude/rules/50.sync/ (2 sync rules — AI fallback reminders)
-   - NOTE: These rules remind AI to run `npx claudeos-core refresh` after modifying standard/rules/skills files.
+   - NOTE: These rules remind AI to keep standard ↔ rules ↔ MANIFEST in sync when it edits any of them (`npx claudeos-core health` reports drift). Do NOT reference `npx claudeos-core refresh` — it is a no-op since v2.1.0.
    - 01.doc-sync.md — Bidirectional standard ↔ rules sync reminder (both directions in ONE rule).
      Do NOT generate a separate 02.rules-sync.md mirror file — redundant.
      Express the mapping as a naming convention (standard/<N>.<dir>/<M>.<n>.md ↔

package/pass-prompts/templates/python-flask/pass3.md

@@ -84,6 +84,7 @@ Generation targets:
      - `60.memory/*` rules: forward reference — Pass 4 will generate 4 files (01.decision-log, 02.failure-patterns, 03.compaction, 04.auto-rule-update), each with file-specific `paths`. Pass 3 must STILL list ```.claude/rules/60.memory/*``` as a row in CLAUDE.md Section 6 Rules table so developers/Claude see the category exists.
      - `70.domains/*` rules (multi-domain projects only): per-domain rules at `.claude/rules/70.domains/{type}/{domain}-rules.md` (where `{type}` is `backend` or `frontend`, ALWAYS present even in single-stack projects for uniform layout + zero-migration future-proofing), each with a `paths:` glob scoped to that domain's source directories so the rule auto-loads only when editing files within the relevant domain. Folder name is PLURAL (`domains/`) — collection of N per-domain files — and each file inside uses the SINGULAR domain name (`{domain}-rules.md`). DO NOT use `60.domains/` (collides with `60.memory/`) and DO NOT skip the `{type}/` sub-folder. See pass3-footer.md "Per-domain folder convention" for the full rationale.
    - MUST generate `.claude/rules/00.core/00.standard-reference.md` — directory of all standard files
+     (paths only, grouped by category). Include the FORWARD REFERENCE `claudeos-core/standard/00.core/04.doc-writing-guide.md` under `## Core` — Pass 4 generates it; omitting it leaves an index gap the moment Pass 4 runs. Do NOT add a "DO NOT Read" section here — CLAUDE.md Section 7 is the single source of truth.
 
 4. .claude/rules/50.sync/ (2 sync rules)
    - 01.doc-sync.md — Bidirectional standard ↔ rules sync reminder (both directions in ONE rule).

package/pass-prompts/templates/vue-nuxt/pass3.md

@@ -82,6 +82,7 @@ Generation targets:
      - `60.memory/*` rules: forward reference — Pass 4 will generate 4 files (01.decision-log, 02.failure-patterns, 03.compaction, 04.auto-rule-update), each with file-specific `paths`. Pass 3 must STILL list ```.claude/rules/60.memory/*``` as a row in CLAUDE.md Section 6 Rules table so developers/Claude see the category exists.
      - `70.domains/*` rules (multi-domain projects only): per-domain rules at `.claude/rules/70.domains/{type}/{domain}-rules.md` (where `{type}` is `backend` or `frontend`, ALWAYS present even in single-stack projects for uniform layout + zero-migration future-proofing), each with a `paths:` glob scoped to that domain's source directories so the rule auto-loads only when editing files within the relevant domain. Folder name is PLURAL (`domains/`) — collection of N per-domain files — and each file inside uses the SINGULAR domain name (`{domain}-rules.md`). DO NOT use `60.domains/` (collides with `60.memory/`) and DO NOT skip the `{type}/` sub-folder. See pass3-footer.md "Per-domain folder convention" for the full rationale.
    - MUST generate `.claude/rules/00.core/00.standard-reference.md` — directory of all standard files
+     (paths only, grouped by category). Include the FORWARD REFERENCE `claudeos-core/standard/00.core/04.doc-writing-guide.md` under `## Core` — Pass 4 generates it; omitting it leaves an index gap the moment Pass 4 runs. Do NOT add a "DO NOT Read" section here — CLAUDE.md Section 7 is the single source of truth.
 
 4. .claude/rules/50.sync/ (2 sync rules)
    - 01.doc-sync.md — Bidirectional standard ↔ rules sync reminder (both directions in ONE rule).

package/plan-installer/domain-grouper.js

@@ -103,7 +103,10 @@ function selectTemplates(stack) {
   if (stack.frontend === "nextjs") {
     templates.frontend = "node-nextjs";
   } else if (stack.frontend === "react") {
-    templates.frontend = stack.framework === "vite" ? "node-vite" : "node-nextjs";
+    // `framework === "vite"` only when no backend framework was detected;
+    // `frontendBundler === "vite"` (v2.5.0) covers Spring/Django + React/Vite
+    // repos (root or `frontend/` sub-directory) where `framework` is the backend.
+    templates.frontend = (stack.framework === "vite" || stack.frontendBundler === "vite") ? "node-vite" : "node-nextjs";
   } else if (stack.frontend === "vue") {
     templates.frontend = "vue-nuxt";
   } else if (stack.frontend === "angular") {

package/plan-installer/index.js

@@ -37,7 +37,7 @@ async function main() {
   if (!stack.language && !stack.framework) {
     console.warn("\n  ⚠️  No language or framework detected.");
     console.warn("  Supported: Java, Kotlin, TypeScript, JavaScript, Python");
-    console.warn("  Ensure you have build.gradle, package.json, pyproject.toml, or requirements.txt in the project root.\n");
+    console.warn("  Ensure you have build.gradle(.kts), pom.xml, package.json, pyproject.toml, or requirements.txt in the project root.\n");
   }
   console.log(`    Frontend:    ${stack.frontend || "none"} ${stack.frontendVersion || ""}`);
   // v2.4.0 — when a project ships more than one DB driver (e.g. Oracle +
@@ -115,7 +115,7 @@ async function main() {
   // Phase 6: Prompt generation
   const lang = process.env.CLAUDEOS_LANG || "en";
   console.log(`  [Phase 6] Generating prompts (lang: ${lang})...`);
-  generatePrompts(templates, lang, TEMPLATES_DIR, GENERATED_DIR);
+  generatePrompts(templates, lang, TEMPLATES_DIR, GENERATED_DIR, stack);
   console.log();
 
   // Save outputs
@@ -127,15 +127,34 @@ async function main() {
   //      the project declares no port of its own. This is a last-resort
   //      default; prefer that stack-detector extract it from .env.example
   //      to keep CLAUDE.md truthful to what the project actually runs.
-  const defaultPort = (stack.framework === "fastapi" || stack.framework === "django") ? 8000
+  //
+  // v2.5.0 — backend port and frontend dev-server port are resolved
+  // SEPARATELY. Pre-v2.5.0 the single chain (`stack.frontend === "angular"
+  // ? 4200 …`) handed a Spring/Django backend the Angular/Next dev-server
+  // port whenever a SPA lived beside it. Now:
+  //   stack.port         — the backend's port when a backend exists; for a
+  //                        frontend-only project it is the dev-server port.
+  //   stack.frontendPort — the SPA's dev-server port whenever a frontend
+  //                        exists: sub-directory `.env*` (stack-detector) →
+  //                        root `.env*` PORT for a root SPA → convention.
+  // Same definition as stack-detector's env-port split: a JVM/Python project
+  // is a backend even when no framework was recognized (plain Maven/Gradle
+  // project without Spring Boot coordinates).
+  const hasBackend = (!!stack.framework && stack.framework !== "vite") || ["java", "kotlin", "python"].includes(stack.language);
+  const backendDefaultPort = (stack.framework === "fastapi" || stack.framework === "django") ? 8000
     : stack.framework === "flask" ? 5000
-    : stack.framework === "vite" ? 5173
-    : stack.frontend === "angular" ? 4200
-    : stack.frontend === "nextjs" ? 3000
     : (stack.framework === "express" || stack.framework === "nestjs" || stack.framework === "fastify") ? 3000 : 8080;
+  const frontendDefaultPort = (stack.frontendBundler === "vite" || stack.framework === "vite") ? 5173
+    : stack.frontend === "angular" ? 4200
+    : 3000;
+  const frontendPort = !stack.frontend ? null
+    : stack.frontendPort ? stack.frontendPort
+    : (!hasBackend && stack.port) ? stack.port
+    : frontendDefaultPort;
+  const defaultPort = hasBackend ? backendDefaultPort : (stack.frontend ? frontendPort : backendDefaultPort);
   const analysis = {
     analyzedAt: new Date().toISOString(), lang,
-    stack: { ...stack, port: stack.port || defaultPort },
+    stack: { ...stack, port: stack.port || defaultPort, ...(frontendPort ? { frontendPort } : {}) },
     templates, isMultiStack, rootPackage,
     domains, backendDomains, frontendDomains, frontend,
     activeDomains: active,