multimodel-dev-os 0.8.0 → 1.1.0

package/docs/support-policy.md

@@ -0,0 +1,26 @@
+# Support Policy
+
+This document defines the lifecycle, support channels, and bug-triaging guidelines for the MultiModel Dev OS.
+
+---
+
+## 1. Support Lifecycle
+
+We are committed to maintaining a stable experience for developers:
+- **Long-Term Support (LTS)**: The frozen `v1.0.0` protocol and CLI will receive security updates and critical bug fixes for at least 12 months post-release.
+- **Backward Compatibility Guarantee**: All `1.x` minor releases will remain fully backward compatible with configurations created under `v1.0.0`.
+
+---
+
+## 2. Issue Triage and Bug Reports
+
+If you encounter issues with the scaffolding or validation commands:
+1. Run `multimodel-dev-os doctor` to run advisory diagnostics.
+2. Ensure your local folder structure complies with the specifications defined in `docs/stable-protocol.md`.
+3. Submit bug reports using our GitHub Issue templates under the `.github/ISSUE_TEMPLATE/` directory.
+
+---
+
+## 3. Security Vulnerability Disclosures
+
+Please do not open public issues for security bugs. Report vulnerabilities directly to the maintainers as described in the `SECURITY.md` file in the repository root.

package/docs/template-qa.md

@@ -0,0 +1,40 @@
+# Template Quality Assurance Blueprint
+
+To guarantee that all built-in and community templates scaffold cleanly and operate with zero syntax errors, templates must satisfy the following strict QA criteria before packaging.
+
+---
+
+## 1. Core QA Acceptance Checklist
+
+All template profiles (Next.js SaaS, WordPress Site, SEO Landing Page, E-Commerce, General App) must pass these automated assertions:
+
+### A. Initialization Check
+- [ ] Running `npx multimodel-dev-os init --template <name>` scaffolds all required folders and root files cleanly.
+- [ ] No empty write errors, name drifts, or file conflicts occur when executed in an empty target path.
+
+### B. Validation & Doctor Checks
+- [ ] Scaffolding outputs must return 100% successful passes when audited using the local validation linter:
+  ```bash
+  npx multimodel-dev-os validate
+  ```
+- [ ] Running the advisor must return zero warnings or compatibility alerts:
+  ```bash
+  npx multimodel-dev-os doctor
+  ```
+
+### C. Caveman Mode Compatibility
+- [ ] The template must include functional minimal-token variants inside its `.ai/templates/` folder.
+- [ ] Toggling `--caveman` writes successfully, creating compressed files without loss of structural boundaries.
+
+### D. Adapter Installation Check
+- [ ] The template must support native adapter mounts.
+- [ ] Running `init --adapter cursor --adapter claude` copies the corresponding rule files and updates `.ai/config.yaml` to `true` instantly.
+
+---
+
+## 2. New Template Acceptance Criteria
+
+When contributing custom team templates:
+1. **Generic but Realistic:** Templates must not include personal branding, fake metrics, or unverified benchmarks.
+2. **Zero Dependencies:** Templates must configure purely within the defined root and `.ai/` schema layers, introducing zero package dependencies.
+3. **Structured Context:** Project briefs and model maps must align with the official protocol specifications.

package/docs/templates-guide.md

@@ -63,3 +63,9 @@ node bin/multimodel-dev-os.js show-template nextjs-saas
 # Bootstrap target using a template
 node bin/multimodel-dev-os.js init --target ../my-new-app --template nextjs-saas
 ```
+
+---
+
+## Template Quality Assurance
+
+To ensure all contributed templates meet our rigorous quality standards before packaging, refer to our [Template Quality Assurance Blueprint](/template-qa).

package/docs/v1-checklist.md

@@ -0,0 +1,31 @@
+# v1.0.0 Release Checklist
+
+A strict checklist of quality gates and tests that must be run locally before the final release.
+
+---
+
+## 1. Quality Checklist
+
+- [ ] All Layer 1 files exist (`AGENTS.md`, `MEMORY.md`, `TASKS.md`, `RUNBOOK.md`).
+- [ ] Schema files (`config.schema.json`, `template.schema.json`, `adapter.schema.json`) exist under `.ai/schema/`.
+- [ ] No external third-party dependencies are added to the core runtime of the CLI utility.
+- [ ] Verify script runs without issues (`npm run verify`).
+- [ ] Documentation builds without errors (`npm run docs:build`).
+- [ ] Package whitelist filters have been reviewed to ensure `node_modules` and compiled VitePress distribution/caches are excluded.
+
+---
+
+## 2. CLI Execution Audits
+
+Verify that the binary executable behaves identically across target systems:
+```bash
+node bin/multimodel-dev-os.js --help
+node bin/multimodel-dev-os.js templates
+node bin/multimodel-dev-os.js validate --target .
+node bin/multimodel-dev-os.js doctor --target .
+```
+
+Verify dry-runs execute safely:
+```bash
+node bin/multimodel-dev-os.js init --template nextjs-saas --dry-run
+```

package/docs/v1-readiness.md

@@ -0,0 +1,29 @@
+# v1.0.0 Readiness Checklist
+
+A strict quality playbook defining the core milestones and checks that must be satisfied before freezing the public MultiModel Dev OS protocol at `v1.0.0`.
+
+---
+
+## 1. Core API & Protocol Freeze
+- [x] **Protocol Specification Freeze:** officially release the specification (`protocol.md`), locking the four root contracts (`AGENTS.md`, `MEMORY.md`, `TASKS.md`, `RUNBOOK.md`).
+- [x] **JSON Schema Validation:** Complete standard JSON schema files under `.ai/schema/` to enforce config and template layouts.
+- [x] **Command API Freeze:** Lock the core subcommands (`init`, `verify`, `validate`, `doctor`, `templates`) with consistent signatures, preventing breaking options in future minor versions.
+
+---
+
+## 2. Documentation & Visual Assets
+- [x] **Navigation Menu Parity:** Assure that all nested guidelines, compatibility playbooks, and migration maps are integrated into the hosted VitePress documentation navigation.
+- [x] **High-Fidelity SVGs:** Confirm lightweight, responsive vector assets exist in both root folders and docs public caches.
+- [x] **Before/After Case Studies:** Complete 5 generic but realistic studies demonstrating context sync gains.
+
+---
+
+## 3. CLI Hardening & Error Handling
+- [x] **Descriptive Warning Pathways:** Ensure the CLI logs descriptive error prompts when scaffolding directories, catching template mismatch errors and conflicts cleanly.
+- [x] **Zero Dependency Limits:** Protect the CLI's pure-Node setup, assuring that zero runtime external packages are added.
+
+---
+
+## 4. Package Hygiene & Security
+- [x] **Tarball audit:** Ensure `npm pack --dry-run` reports unpacked sizes under `~260kB` and compressed releases under `~76kB`.
+- [x] **Ignored Cache verification:** Assert that local compiler caches (`docs/.vitepress/dist` and `docs/.vitepress/cache`) and `node_modules/` are strictly excluded from the packaging files whitelist.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "multimodel-dev-os",
-  "version": "0.8.0",
+  "version": "1.1.0",
   "bin": {
     "multimodel-dev-os": "bin/multimodel-dev-os.js"
   },

package/scripts/verify.js

@@ -194,6 +194,42 @@ checkFile('docs/faq.md');
 checkFile('docs/testing-v0.2.md');
 checkFile('docs/npm-publishing.md');
 checkFile('docs/templates-guide.md');
+checkFile('docs/protocol.md');
+checkFile('docs/compatibility.md');
+checkFile('docs/migration-guide.md');
+checkFile('docs/template-qa.md');
+checkFile('docs/v1-readiness.md');
+checkFile('docs/stable-protocol.md');
+checkFile('docs/release-policy.md');
+checkFile('docs/support-policy.md');
+checkFile('docs/final-launch.md');
+checkFile('docs/v1-checklist.md');
+
+// --- JSON Schemas ---
+console.log('\nJSON Schemas:');
+checkFile('.ai/schema/config.schema.json');
+checkFile('.ai/schema/template.schema.json');
+checkFile('.ai/schema/adapter.schema.json');
+
+// --- Test Blueprints ---
+console.log('\nTest Manuals:');
+checkFile('tests/README.md');
+checkFile('tests/fixtures/README.md');
+checkFile('tests/smoke/README.md');
+
+// --- Visual & AI Discovery Assets ---
+console.log('\nVisual & AI Discovery Assets:');
+checkFile('assets/favicon.png');
+checkFile('assets/logo.png');
+checkFile('docs/public/favicon.png');
+checkFile('docs/public/logo.png');
+checkFile('docs/public/llms.txt');
+checkFile('docs/public/llms-full.txt');
+checkFile('docs/public/robots.txt');
+checkFile('docs/public/sitemap.xml');
+checkFile('docs/public/assets/social-preview.svg');
+checkFile('docs/public/assets/terminal-demo.svg');
+checkFile('docs/public/assets/architecture-preview.svg');
 
 // --- CLI & Packaging Pre-Flight Tests ---
 console.log('\nRunning CLI & Packaging Pre-Flight Tests...');