@mozole/cli 1.4.0 → 1.4.1

package/CHANGELOG.md

@@ -1,7 +1,16 @@
 # Changelog
 
+## 1.4.1
+
+- Make `adopt` reconcile legacy and previously optimized projects with the current canonical project system without requiring an integration flag.
+- Archive Mozole-owned legacy state and managed files during migration, preserve unrelated user integrations and design exports, and restore managed changes if installation fails.
+- Refresh managed instruction blocks, standalone verification/QA scripts, PHP templates, tooling pins and configured project verifiers idempotently.
+- Keep CCE, governor, telemetry and token-optimization layers strictly opt-in through explicit integration flags.
+
 ## 1.4.0
 
+- Add provider-neutral design handoff and shared AGENTS.md guardrails for spacing, typography, contrast, assets and responsive validation; preserve user exports under docs/design/.
+
 - Make default scaffolds independent of the CLI: no CCE, governor, telemetry, caches, MCP, hooks, or optimization dependency. Environment variables cannot enable integration mode.
 - Keep useful basic AGENTS.md and CLAUDE.md guidance in plain projects. Require explicit integration flags for new/adopt; refresh managed agent blocks and hook definitions while preserving user content.
 - Track CCE retrieval through PostToolUse MCP events and provide a valid reason from the visual QA workflow.
@@ -10,4 +19,4 @@
 - Preserve failed creation logs before staging cleanup.
 - Add standalone browser QA and integration coverage for plain, PHP, and optimized scaffolds; provision PHP in Windows/Linux CI.
 
-Migration: default generated projects use standalone npm scripts rather than a project-local `mozole` executable. Use the globally installed CLI when desired, or pass `--cce-install` to generate the optional integration mode. Plain adoption preserves existing user integrations and requires the flag to update an already optimized project.
+Migration: default generated projects use standalone npm scripts rather than a project-local `mozole` executable. Use the globally installed CLI when desired, or pass `--cce-install` to generate the optional integration mode. Plain adoption migrates previously optimized projects to the current standalone system, archiving Mozole-owned integration remnants and preserving unrelated user integrations. Explicit flags select optimized adoption. Legacy PHP templates, managed scripts, instruction blocks and tooling pins are reconciled; customized backend files receive a review notice. Failed installation restores managed files and moved state.

package/README.md

@@ -29,6 +29,10 @@ npm run qa:visual
 
 React Router uses `ssr: false` and `prerender: true`. The starter builds real HTML for `/`, `/about`, and `/contact` into `build/client/`, plus `__spa-fallback.html`. Production requires no Node server. See [React Router prerendering](https://reactrouter.com/how-to/pre-rendering).
 
+## Design references and assets
+
+Place exported `design.md`, images, icons, fonts and reference screens under `docs/design/`. Generated `AGENTS.md` treats these as design evidence, preserves their intent, and requires checks for spacing, loaded fonts, foreground/background contrast, responsive behavior and interaction states. It permits justified corrections instead of blindly copying tokens. `docs/design/README.md` explains the handoff; no provider-specific design is generated. Existing exports remain untouched during adoption. Routine QA stays screenshot-free; visual comparison remains opt-in.
+
 ## PHP backend
 
 ```sh
@@ -75,7 +79,7 @@ Optimized verification/QA reuses matching successful evidence. Use `--force` for
 mozole adopt ../existing-app
 ```
 
-Plain adoption adds standalone verification/QA, basic agent guidance, and missing test tools to a React project using Vite or React Router. Application source and existing user integrations are preserved. It never enables optimization tooling. An already optimized project requires `--cce-install` for managed integration updates rather than silently removing previously enabled integrations. Changed package metadata is backed up under `.mozole/backups/`; managed files are restored on failure.
+Adoption reconciles a React/Vite or React Router project with the current project system. Without `--cce-install`, it removes Mozole-owned CCE integrations, optimization hooks and state, including from previously optimized projects, and installs standalone verification/QA. The flag explicitly selects the optimized system. User instructions, unrelated integrations, application source and design exports are preserved. Recognized unchanged legacy PHP templates are upgraded; customized backend files are retained with a review notice. Replaced files and obsolete state are archived under `.mozole/backups/adopt-*`; managed files are restored if installation fails. Tooling versions and npm dependencies are reconciled on every adoption. Custom verifier commands and configured QA servers remain in use. Repeating adoption does not duplicate managed instruction blocks.
 
 ## CLI commands
 

package/dist/commands/adopt.d.ts

@@ -1,6 +1,6 @@
 import type { Output } from "../output.js";
 import { type ProgressState } from "../progress.js";
-export declare function detectRoutes(source: string): string[];
+export { detectRoutes } from "../scaffold/routes.js";
 export declare function adoptCommand(input: string | undefined, cwd: string, output?: Output, options?: {
     cceInstall?: boolean | undefined;
     verbose?: boolean | undefined;

package/dist/commands/adopt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adopt.d.ts","sourceRoot":"","sources":["../../src/commands/adopt.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,OAAO,EAAE,KAAK,aAAa,EAAgB,MAAM,gBAAgB,CAAC;AAyFlE,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAKrD;AA+KD,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,MAAgB,EACxB,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,UAAU,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACtD,GACL,OAAO,CAAC,MAAM,CAAC,CA6TjB"}
+{"version":3,"file":"adopt.d.ts","sourceRoot":"","sources":["../../src/commands/adopt.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,OAAO,EAAE,KAAK,aAAa,EAAgB,MAAM,gBAAgB,CAAC;AAgGlE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AA+JrD,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,MAAgB,EACxB,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,UAAU,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACtD,GACL,OAAO,CAAC,MAAM,CAAC,CA0XjB"}