multimodel-dev-os 2.0.0 β 2.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +10 -10
- package/bin/multimodel-dev-os.js +28 -4
- package/docs/.vitepress/config.js +1 -1
- package/docs/cli-roadmap.md +14 -22
- package/docs/faq.md +1 -1
- package/docs/index.md +5 -5
- package/docs/npm-publishing.md +16 -16
- package/docs/public/llms-full.txt +1 -1
- package/docs/public/llms.txt +1 -1
- package/docs/public/sitemap.xml +51 -1
- package/docs/quickstart.md +8 -16
- package/docs/release-policy.md +5 -22
- package/docs/templates-guide.md +3 -3
- package/docs/v2-release-checklist.md +1 -1
- package/docs/v2-roadmap.md +1 -1
- package/package.json +1 -1
- package/scripts/install.ps1 +1 -1
- package/scripts/install.sh +1 -1
- package/scripts/prepublish-guard.js +3 -3
package/README.md
CHANGED
|
@@ -127,23 +127,23 @@ Cuts prompt rules overhead down by **~79%** using highly optimized short-hand de
|
|
|
127
127
|
npx multimodel-dev-os@latest init --caveman
|
|
128
128
|
```
|
|
129
129
|
|
|
130
|
-
### 4. Registry & Model Commands (
|
|
131
|
-
|
|
130
|
+
### 4. Registry & Model Commands (v2.0.0 Stable Release)
|
|
131
|
+
Run model capabilities registries, adapter registers, and scaffold mobile templates directly:
|
|
132
132
|
```bash
|
|
133
133
|
# List model or adapter registries
|
|
134
|
-
|
|
135
|
-
|
|
134
|
+
npx multimodel-dev-os@latest models
|
|
135
|
+
npx multimodel-dev-os@latest adapters
|
|
136
136
|
|
|
137
137
|
# Scaffold the Android Expo template
|
|
138
|
-
|
|
138
|
+
npx multimodel-dev-os@latest init --template expo-react-native-android
|
|
139
139
|
```
|
|
140
140
|
|
|
141
|
-
For more details
|
|
141
|
+
For more details, see the [Model Capabilities Registry Guide](https://rizvee.github.io/multimodel-dev-os/model-compatibility).
|
|
142
142
|
|
|
143
143
|
### 5. Quality Gates
|
|
144
144
|
Run assertions and diagnostic checkups:
|
|
145
|
-
- **`validate`** (Strict schema checkup): `
|
|
146
|
-
- **`doctor`** (Advisory compatibility warning): `
|
|
145
|
+
- **`validate`** (Strict schema checkup): `npx multimodel-dev-os@latest validate`
|
|
146
|
+
- **`doctor`** (Advisory compatibility warning): `npx multimodel-dev-os@latest doctor`
|
|
147
147
|
|
|
148
148
|
---
|
|
149
149
|
|
|
@@ -184,8 +184,8 @@ Discover how engineering teams deploy MultiModel Dev OS:
|
|
|
184
184
|
|
|
185
185
|
## Stable Protocol Specification & Roadmap
|
|
186
186
|
|
|
187
|
-
MultiModel Dev OS
|
|
188
|
-
-
|
|
187
|
+
MultiModel Dev OS v2.x packages the stable Layer 1, Layer 2, and Layer 3 specifications alongside the Model Compatibility and Template Galaxy registries.
|
|
188
|
+
- π [v2 Release Checklist](/docs/v2-release-checklist.md) (Release quality checklist)
|
|
189
189
|
- π‘οΈ [Stable Protocol Specification](https://rizvee.github.io/multimodel-dev-os/stable-protocol)
|
|
190
190
|
- π [Multi-Agent Compatibility Guides](https://rizvee.github.io/multimodel-dev-os/compatibility)
|
|
191
191
|
- π [Upgrade & Migration Guide](https://rizvee.github.io/multimodel-dev-os/migration-guide)
|
package/bin/multimodel-dev-os.js
CHANGED
|
@@ -13,7 +13,7 @@ const __filename = fileURLToPath(import.meta.url);
|
|
|
13
13
|
const __dirname = dirname(__filename);
|
|
14
14
|
const sourceRoot = resolve(__dirname, '..');
|
|
15
15
|
|
|
16
|
-
let version = '2.0.
|
|
16
|
+
let version = '2.0.1';
|
|
17
17
|
try {
|
|
18
18
|
const pkgData = JSON.parse(readFileSync(resolve(sourceRoot, 'package.json'), 'utf8'));
|
|
19
19
|
version = pkgData.version;
|
|
@@ -316,8 +316,9 @@ function handleInit(options) {
|
|
|
316
316
|
// Check if requested template is planned
|
|
317
317
|
const tInfo = TEMPLATES[options.template];
|
|
318
318
|
if (tInfo && tInfo.status === 'planned') {
|
|
319
|
-
console.warn(` \x1b[33m[WARNING] Template '${options.template}' is a
|
|
320
|
-
console.warn(`
|
|
319
|
+
console.warn(` \x1b[33m[WARNING] Template '${options.template}' is planned for a future release and is not yet available.\x1b[0m`);
|
|
320
|
+
console.warn(` To view available templates, run: \x1b[36mnpx multimodel-dev-os templates\x1b[0m`);
|
|
321
|
+
console.warn(` Falling back to the stable \x1b[32m'general-app'\x1b[0m profile...\n`);
|
|
321
322
|
options.template = 'general-app';
|
|
322
323
|
}
|
|
323
324
|
|
|
@@ -331,7 +332,9 @@ function handleInit(options) {
|
|
|
331
332
|
// Source path mapping for core files
|
|
332
333
|
let templateDir = join(sourceRoot, 'examples', options.template);
|
|
333
334
|
if (!existsSync(templateDir)) {
|
|
334
|
-
console.warn(` \x1b[33m[WARNING] Template '${options.template}'
|
|
335
|
+
console.warn(` \x1b[33m[WARNING] Template '${options.template}' source files could not be found.\x1b[0m`);
|
|
336
|
+
console.warn(` To view available templates, run: \x1b[36mnpx multimodel-dev-os templates\x1b[0m`);
|
|
337
|
+
console.warn(` Falling back to the stable \x1b[32m'general-app'\x1b[0m profile...\n`);
|
|
335
338
|
templateDir = join(sourceRoot, 'examples', 'general-app');
|
|
336
339
|
}
|
|
337
340
|
|
|
@@ -501,6 +504,27 @@ function handleInit(options) {
|
|
|
501
504
|
}
|
|
502
505
|
|
|
503
506
|
console.log(`\n\x1b[32mβ Project initialized successfully! [Total Operations: ${operations.length}]\x1b[0m\n`);
|
|
507
|
+
console.log(`\x1b[36mNext Steps to Complete Integration:\x1b[0m`);
|
|
508
|
+
console.log(` 1. \x1b[1mEdit AGENTS.md\x1b[0m in your project root to document your stack context.`);
|
|
509
|
+
console.log(` 2. \x1b[1mEdit .ai/config.yaml\x1b[0m to configure active model routing presets.`);
|
|
510
|
+
if (options.adapters.length > 0) {
|
|
511
|
+
console.log(` 3. \x1b[1mActivate IDE / Agent Rules:\x1b[0m`);
|
|
512
|
+
console.log(` Ensure adapter configuration files are copied or linked to the root of your workspace:`);
|
|
513
|
+
options.adapters.forEach(adapter => {
|
|
514
|
+
const a = ADAPTERS[adapter];
|
|
515
|
+
if (a && a.rules_file) {
|
|
516
|
+
console.log(` - For \x1b[32m${a.name || adapter}\x1b[0m: Check the root-level \x1b[33m${a.rules_file}\x1b[0m file`);
|
|
517
|
+
}
|
|
518
|
+
});
|
|
519
|
+
} else {
|
|
520
|
+
console.log(` 3. \x1b[1mSelect IDE / Tool Adapters:\x1b[0m`);
|
|
521
|
+
console.log(` To generate rules for Cursor, Claude Code, etc., run:`);
|
|
522
|
+
console.log(` \x1b[36mnpx multimodel-dev-os init --adapter cursor --adapter claude\x1b[0m`);
|
|
523
|
+
}
|
|
524
|
+
console.log(` 4. \x1b[1mRun Diagnostics:\x1b[0m`);
|
|
525
|
+
console.log(` Verify your workspace structural compliance:`);
|
|
526
|
+
console.log(` \x1b[36mnpx multimodel-dev-os validate\x1b[0m`);
|
|
527
|
+
console.log(` \x1b[36mnpx multimodel-dev-os doctor\x1b[0m\n`);
|
|
504
528
|
}
|
|
505
529
|
|
|
506
530
|
function handleVerify(options) {
|
|
@@ -32,7 +32,7 @@ export default {
|
|
|
32
32
|
'license': 'https://opensource.org/licenses/MIT',
|
|
33
33
|
'url': 'https://github.com/rizvee/multimodel-dev-os',
|
|
34
34
|
'downloadUrl': 'https://www.npmjs.com/package/multimodel-dev-os',
|
|
35
|
-
'softwareVersion': '2.0.
|
|
35
|
+
'softwareVersion': '2.0.1',
|
|
36
36
|
'description': 'Portable, vendor-neutral AI Developer OS for multi-agent coding workflows.'
|
|
37
37
|
})
|
|
38
38
|
]
|
package/docs/cli-roadmap.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# CLI Roadmap
|
|
2
2
|
|
|
3
|
-
> The zero-dependency CLI utility is fully integrated with `npm` and `npx` in
|
|
3
|
+
> The zero-dependency CLI utility is fully integrated with `npm` and `npx` in v2.0.0!
|
|
4
4
|
|
|
5
5
|
## Current CLI Usage
|
|
6
6
|
|
|
@@ -23,7 +23,7 @@ npx multimodel-dev-os@latest init --force
|
|
|
23
23
|
npx multimodel-dev-os@latest verify
|
|
24
24
|
```
|
|
25
25
|
|
|
26
|
-
Alternatively, you can run the CLI
|
|
26
|
+
Alternatively, you can run the CLI directly from cloned source during development:
|
|
27
27
|
```bash
|
|
28
28
|
node bin/multimodel-dev-os.js init
|
|
29
29
|
node bin/multimodel-dev-os.js verify
|
|
@@ -37,25 +37,17 @@ node bin/multimodel-dev-os.js verify
|
|
|
37
37
|
| `show-template` | Inspect stack specifications of a template | v0.5.0 | β
Completed |
|
|
38
38
|
| `doctor` | Advisory checkup of workspace compatibility | v0.5.0 | β
Completed |
|
|
39
39
|
| `validate` | Strict directory schema compliance checks | v0.5.0 | β
Completed |
|
|
40
|
-
| `
|
|
41
|
-
| `
|
|
42
|
-
| `
|
|
43
|
-
| `
|
|
44
|
-
| `
|
|
45
|
-
| `
|
|
46
|
-
| `
|
|
47
|
-
| `show-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
> All new `v1.2.0` subcommands listed as **Source Only** are fully implemented in the source code but are unreleased on the npm package registry. To run them, execute from a clone of the GitHub repository. They will be packaged officially in the `v2.0.0` stable release.
|
|
53
|
-
|
|
54
|
-
## CLI v2.0.0 Stabilization Goal
|
|
55
|
-
|
|
56
|
-
Ahead of the `v2.0.0` release, we will run a comprehensive compatibility pass:
|
|
57
|
-
* **Backward Compatibility**: Ensure that all new registries configurations and subcommand syntax do not break the stable `v1.0.0` and `v1.1.0` CLI behaviors.
|
|
58
|
-
* **Unified Quality Gates**: Integrate model registry and adapter configuration validation parameters directly into the standard `validate` and `doctor` command pipelines.
|
|
59
|
-
* **Cross-Platform Hardening**: Audit all commands on Windows (PowerShell/CMD), macOS, and Linux bash environments before resuming npm package publishing.
|
|
40
|
+
| `models` | List configured model registry entries | v2.0.0 | β
Completed |
|
|
41
|
+
| `show-model` | Inspect settings for a model registry entry | v2.0.0 | β
Completed |
|
|
42
|
+
| `providers` | List configured model registry providers | v2.0.0 | β
Completed |
|
|
43
|
+
| `route-model`| Route a target prompt based on presets | v2.0.0 | β
Completed |
|
|
44
|
+
| `adapters` | List configured adapter registry entries | v2.0.0 | β
Completed |
|
|
45
|
+
| `show-adapter`| Inspect settings for an adapter registry entry | v2.0.0 | β
Completed |
|
|
46
|
+
| `skills` | List configured skill registry entries | v2.0.0 | β
Completed |
|
|
47
|
+
| `show-skill` | Inspect settings for a skill registry entry | v2.0.0 | β
Completed |
|
|
48
|
+
|
|
49
|
+
## CLI v2.0.0 Stabilization & Beyond
|
|
50
|
+
|
|
51
|
+
The `v2.0.0` stabilization milestone was completed successfully, hardening registries configurations, custom skill checking tools, and token size overrides. Any future subcommands or adapter sync mechanisms will follow SemVer guidelines to ensure full backward compatibility.
|
|
60
52
|
|
|
61
53
|
|
package/docs/faq.md
CHANGED
|
@@ -62,6 +62,6 @@ Yes, for tools that auto-detect specific files:
|
|
|
62
62
|
## Protocol & Migration
|
|
63
63
|
|
|
64
64
|
**Is the MultiModel Dev OS protocol stable?**
|
|
65
|
-
Yes. As of version `v1.1.0`, the core specifications are officially frozen and backward-compatible. This ensures that
|
|
65
|
+
Yes. As of version `v1.1.0`, the core specifications are officially frozen and backward-compatible. This ensures that codebases prepared using `v1.1.0` or later operate seamlessly inside all `1.x` and `2.x` ecosystems.
|
|
66
66
|
|
|
67
67
|
Explore our [Stable Protocol Specification](/stable-protocol) or [Upgrade & Migration Guide](/migration-guide) for details.
|
package/docs/index.md
CHANGED
|
@@ -16,8 +16,8 @@ hero:
|
|
|
16
16
|
text: Stable Protocol Specs
|
|
17
17
|
link: /stable-protocol
|
|
18
18
|
- theme: alt
|
|
19
|
-
text:
|
|
20
|
-
link: /
|
|
19
|
+
text: v2 Release Checklist
|
|
20
|
+
link: /v2-release-checklist
|
|
21
21
|
- theme: alt
|
|
22
22
|
text: View Case Studies
|
|
23
23
|
link: /case-studies/
|
|
@@ -141,9 +141,9 @@ MultiModel Dev OS maps repository context directly to all major developer tools
|
|
|
141
141
|
<div class="card-title">π Migration Playbook</div>
|
|
142
142
|
<div class="card-desc">Upgrade older workspaces to v1.1.0 standards cleanly.</div>
|
|
143
143
|
</a>
|
|
144
|
-
<a href="/
|
|
145
|
-
<div class="card-title">π Release Checklist</div>
|
|
146
|
-
<div class="card-desc">Audit repository compliance with the strict release quality gates.</div>
|
|
144
|
+
<a href="/v2-release-checklist" class="card-item">
|
|
145
|
+
<div class="card-title">π v2 Release Checklist</div>
|
|
146
|
+
<div class="card-desc">Audit repository compliance with the strict v2 release quality gates.</div>
|
|
147
147
|
</a>
|
|
148
148
|
<a href="/llms.txt" class="card-item" target="_blank">
|
|
149
149
|
<div class="card-title">π€ AI Discovery (llms.txt)</div>
|
package/docs/npm-publishing.md
CHANGED
|
@@ -12,13 +12,13 @@ Before publishing, always test the built package locally by compiling a compress
|
|
|
12
12
|
```bash
|
|
13
13
|
npm pack
|
|
14
14
|
```
|
|
15
|
-
This creates a file named like `multimodel-dev-os-0.
|
|
15
|
+
This creates a file named like `multimodel-dev-os-2.0.1.tgz` in your directory root.
|
|
16
16
|
|
|
17
17
|
2. **Verify bundle contents:**
|
|
18
18
|
Create an empty temporary workspace, extract the tarball, and confirm that only required scaffold folders are included (no `.github/`, test configurations, or local system files):
|
|
19
19
|
```bash
|
|
20
20
|
mkdir -p /tmp/package-test && cd /tmp/package-test
|
|
21
|
-
tar -xzf /path/to/multimodel-dev-os-0.
|
|
21
|
+
tar -xzf /path/to/multimodel-dev-os-2.0.1.tgz
|
|
22
22
|
ls -la package/
|
|
23
23
|
```
|
|
24
24
|
|
|
@@ -61,34 +61,34 @@ Execute these validation actions strictly in sequence before triggering a releas
|
|
|
61
61
|
## 3. Versioning & Rollback Strategy
|
|
62
62
|
|
|
63
63
|
* **Semantic Versioning (SemVer) Discipline:**
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
64
|
+
* **Patch Release (e.g. 2.0.1):** Backward-compatible bug fixes or documentation updates.
|
|
65
|
+
* **Minor Release (e.g. 2.1.0):** Backward-compatible new features (like new adapter sync mechanisms).
|
|
66
|
+
* **Major Release (e.g. 3.0.0):** Breaking changes to core specification files.
|
|
67
67
|
|
|
68
68
|
* **Rollback & Deprecation Guidelines:**
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
69
|
+
* Since published versions cannot be republished or overwritten, **never unpublish** unless absolutely necessary.
|
|
70
|
+
* If a critical bug is discovered, immediately publish a new patch version (e.g. `v2.0.1`).
|
|
71
|
+
* If a version is broken, flag it as deprecated to inform downstream installers:
|
|
72
|
+
```bash
|
|
73
|
+
npm deprecate multimodel-dev-os@2.0.0 "Critical bug found, please use v2.0.1 instead."
|
|
74
|
+
```
|
|
75
75
|
|
|
76
76
|
---
|
|
77
77
|
|
|
78
|
-
## 4. Prepublish Safety Guard (v2.0.
|
|
78
|
+
## 4. Prepublish Safety Guard (v2.0.1 Stable)
|
|
79
79
|
|
|
80
80
|
> [!IMPORTANT]
|
|
81
|
-
> **v2.0.
|
|
81
|
+
> **v2.0.1 is the active stable release.** NPM publishing is no longer paused.
|
|
82
82
|
|
|
83
83
|
### Source vs. Registry Strategy
|
|
84
|
-
* **GitHub main branch (Source)**: Contains the current stable `v2.0.
|
|
84
|
+
* **GitHub main branch (Source)**: Contains the current stable `v2.0.1` codebase.
|
|
85
85
|
* **npm latest (Registry)**: Pulled and installed globally or via npx.
|
|
86
86
|
|
|
87
87
|
### Prepublish Safety Guard
|
|
88
88
|
To prevent accidental `npm publish` executions on developer environments, a local validation script has been added to package hooks. If you run `npm publish`, it is blocked by default.
|
|
89
89
|
|
|
90
|
-
To bypass this check during
|
|
91
|
-
1. Ensure the version in `package.json` starts with `2.` (e.g. `2.0.
|
|
90
|
+
To bypass this check during approved release windows:
|
|
91
|
+
1. Ensure the version in `package.json` starts with `2.` (e.g. `2.0.1`).
|
|
92
92
|
2. Run publication with the override env variable:
|
|
93
93
|
```powershell
|
|
94
94
|
# PowerShell
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# MultiModel Dev OS β Comprehensive AI Assistant Discoverability Guide (v2.0.
|
|
1
|
+
# MultiModel Dev OS β Comprehensive AI Assistant Discoverability Guide (v2.0.1 Stable Release)
|
|
2
2
|
|
|
3
3
|
MultiModel Dev OS is a repository-level porting specification designed to align context and instructions across diverse developer tools and AI models.
|
|
4
4
|
|
package/docs/public/llms.txt
CHANGED
package/docs/public/sitemap.xml
CHANGED
|
@@ -61,8 +61,58 @@
|
|
|
61
61
|
<priority>0.6</priority>
|
|
62
62
|
</url>
|
|
63
63
|
<url>
|
|
64
|
-
<loc>https://rizvee.github.io/multimodel-dev-os/
|
|
64
|
+
<loc>https://rizvee.github.io/multimodel-dev-os/v2-release-checklist</loc>
|
|
65
65
|
<changefreq>weekly</changefreq>
|
|
66
66
|
<priority>0.6</priority>
|
|
67
67
|
</url>
|
|
68
|
+
<url>
|
|
69
|
+
<loc>https://rizvee.github.io/multimodel-dev-os/model-routing</loc>
|
|
70
|
+
<changefreq>weekly</changefreq>
|
|
71
|
+
<priority>0.7</priority>
|
|
72
|
+
</url>
|
|
73
|
+
<url>
|
|
74
|
+
<loc>https://rizvee.github.io/multimodel-dev-os/local-models</loc>
|
|
75
|
+
<changefreq>weekly</changefreq>
|
|
76
|
+
<priority>0.7</priority>
|
|
77
|
+
</url>
|
|
78
|
+
<url>
|
|
79
|
+
<loc>https://rizvee.github.io/multimodel-dev-os/provider-strategy</loc>
|
|
80
|
+
<changefreq>weekly</changefreq>
|
|
81
|
+
<priority>0.7</priority>
|
|
82
|
+
</url>
|
|
83
|
+
<url>
|
|
84
|
+
<loc>https://rizvee.github.io/multimodel-dev-os/agent-compatibility</loc>
|
|
85
|
+
<changefreq>weekly</changefreq>
|
|
86
|
+
<priority>0.7</priority>
|
|
87
|
+
</url>
|
|
88
|
+
<url>
|
|
89
|
+
<loc>https://rizvee.github.io/multimodel-dev-os/adapter-authoring</loc>
|
|
90
|
+
<changefreq>weekly</changefreq>
|
|
91
|
+
<priority>0.7</priority>
|
|
92
|
+
</url>
|
|
93
|
+
<url>
|
|
94
|
+
<loc>https://rizvee.github.io/multimodel-dev-os/template-authoring</loc>
|
|
95
|
+
<changefreq>weekly</changefreq>
|
|
96
|
+
<priority>0.7</priority>
|
|
97
|
+
</url>
|
|
98
|
+
<url>
|
|
99
|
+
<loc>https://rizvee.github.io/multimodel-dev-os/skill-authoring</loc>
|
|
100
|
+
<changefreq>weekly</changefreq>
|
|
101
|
+
<priority>0.7</priority>
|
|
102
|
+
</url>
|
|
103
|
+
<url>
|
|
104
|
+
<loc>https://rizvee.github.io/multimodel-dev-os/v2-migration</loc>
|
|
105
|
+
<changefreq>weekly</changefreq>
|
|
106
|
+
<priority>0.7</priority>
|
|
107
|
+
</url>
|
|
108
|
+
<url>
|
|
109
|
+
<loc>https://rizvee.github.io/multimodel-dev-os/package-safety</loc>
|
|
110
|
+
<changefreq>weekly</changefreq>
|
|
111
|
+
<priority>0.7</priority>
|
|
112
|
+
</url>
|
|
113
|
+
<url>
|
|
114
|
+
<loc>https://rizvee.github.io/multimodel-dev-os/registry-contribution</loc>
|
|
115
|
+
<changefreq>weekly</changefreq>
|
|
116
|
+
<priority>0.7</priority>
|
|
117
|
+
</url>
|
|
68
118
|
</urlset>
|
package/docs/quickstart.md
CHANGED
|
@@ -8,7 +8,7 @@ Get the MultiModel Dev OS integrated into your codebase in under 2 minutes to sy
|
|
|
8
8
|
|
|
9
9
|
## Option A: NPX Scaffolding (Stable Packages)
|
|
10
10
|
|
|
11
|
-
Initialize any project instantly using our public npm registry. Note that this pulls the latest stable npm-published release (`v2.0.
|
|
11
|
+
Initialize any project instantly using our public npm registry. Note that this pulls the latest stable npm-published release (`v2.0.1`):
|
|
12
12
|
|
|
13
13
|
```bash
|
|
14
14
|
# Standard interactive initialization in the current directory
|
|
@@ -49,18 +49,13 @@ curl -fsSL https://raw.githubusercontent.com/rizvee/multimodel-dev-os/main/scrip
|
|
|
49
49
|
|
|
50
50
|
---
|
|
51
51
|
|
|
52
|
-
## Option D:
|
|
52
|
+
## Option D: Scaffold Target Directory (NPX Direct)
|
|
53
53
|
|
|
54
|
-
If you prefer to
|
|
54
|
+
If you prefer to initialize a target project path directly:
|
|
55
55
|
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
```
|
|
60
|
-
2. Run the CLI directly from the cloned repository source:
|
|
61
|
-
```bash
|
|
62
|
-
node bin/multimodel-dev-os.js init --target /path/to/your-project --template nextjs-saas --adapter cursor
|
|
63
|
-
```
|
|
56
|
+
```bash
|
|
57
|
+
npx multimodel-dev-os@latest init --target /path/to/your-project --template nextjs-saas --adapter cursor
|
|
58
|
+
```
|
|
64
59
|
|
|
65
60
|
---
|
|
66
61
|
|
|
@@ -82,13 +77,10 @@ You can run our strict validation check or advisory doctor checkup to validate s
|
|
|
82
77
|
|
|
83
78
|
```bash
|
|
84
79
|
# Strict directory schema validation
|
|
85
|
-
|
|
80
|
+
npx multimodel-dev-os validate
|
|
86
81
|
|
|
87
82
|
# Advisory doctor workspace compatibility audit
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
# Verify repository structure checks
|
|
91
|
-
npm run verify
|
|
83
|
+
npx multimodel-dev-os doctor
|
|
92
84
|
```
|
|
93
85
|
|
|
94
86
|
Explore our canonical [Stable Protocol Specification](/stable-protocol) or [Upgrade & Migration Guide](/migration-guide) for details.
|
package/docs/release-policy.md
CHANGED
|
@@ -34,26 +34,9 @@ No package shall be merged or released without:
|
|
|
34
34
|
|
|
35
35
|
---
|
|
36
36
|
|
|
37
|
-
## 4.
|
|
38
|
-
|
|
39
|
-
To ensure high stability and thorough testing of the Template Galaxy and Model Compatibility Layers, package publishing to the public npm registry is paused during all `v1.2.x` minor releases:
|
|
40
|
-
* **GitHub Repository (Source)**: Serve as the primary, active source branch containing unreleased v1.2+ features (such as template extensions, model registries, and CLI expansions).
|
|
41
|
-
* **NPM Registry (Latest)**: Remains on the last approved stable version.
|
|
42
|
-
* **v2.0.0 (Next Target)**: Will serve as the next stable release published to the npm registry, packaging the hardened registries and Template Galaxy features.
|
|
43
|
-
|
|
44
|
-
### Local Source & Verification Procedures
|
|
45
|
-
|
|
46
|
-
Contributors and developers must verify and test unreleased `v1.2.x` features locally rather than running publication steps:
|
|
47
|
-
1. **Execute commands from the source binary:**
|
|
48
|
-
```bash
|
|
49
|
-
node bin/multimodel-dev-os.js init
|
|
50
|
-
node bin/multimodel-dev-os.js verify
|
|
51
|
-
```
|
|
52
|
-
2. **Compile and test the package bundle locally:**
|
|
53
|
-
```bash
|
|
54
|
-
npm pack
|
|
55
|
-
```
|
|
56
|
-
This generates a local `.tgz` archive. Install it in a target test project to run validations.
|
|
57
|
-
|
|
58
|
-
Never execute `npm publish` in the main workspace unless actively packaging the approved `v2.0.0` release.
|
|
37
|
+
## 4. Release Channel & Staging Controls
|
|
59
38
|
|
|
39
|
+
MultiModel Dev OS releases new versions directly to the public NPM registry:
|
|
40
|
+
* **Stable Releases (`npx multimodel-dev-os`)**: Published to the public registry under semantic version categories (e.g. `2.0.0`, `2.0.1`).
|
|
41
|
+
* **Release Candidates**: Built and validated locally via the automated verification script (`scripts/verify.js`) before tags or packaging runs.
|
|
42
|
+
* **Staging Verification**: To test new configurations prior to publishing, package the bundle locally (`npm pack`) and run CLI checkups in clean test directories.
|
package/docs/templates-guide.md
CHANGED
|
@@ -55,13 +55,13 @@ To view and list templates directly from your shell:
|
|
|
55
55
|
|
|
56
56
|
```bash
|
|
57
57
|
# List all templates
|
|
58
|
-
|
|
58
|
+
npx multimodel-dev-os templates
|
|
59
59
|
|
|
60
60
|
# Inspect nextjs-saas layout details
|
|
61
|
-
|
|
61
|
+
npx multimodel-dev-os show-template nextjs-saas
|
|
62
62
|
|
|
63
63
|
# Bootstrap target using a template
|
|
64
|
-
|
|
64
|
+
npx multimodel-dev-os init --target ../my-new-app --template nextjs-saas
|
|
65
65
|
```
|
|
66
66
|
|
|
67
67
|
---
|
|
@@ -4,7 +4,7 @@ Use this checklist to verify compliance before publishing `multimodel-dev-os` to
|
|
|
4
4
|
|
|
5
5
|
## Pre-Flight Requirements
|
|
6
6
|
|
|
7
|
-
- [x] Ensure version string in `package.json` is set to `2.0.
|
|
7
|
+
- [x] Ensure version string in `package.json` is set to `2.0.1`.
|
|
8
8
|
- [x] Verify version strings in documentation and install scripts (`scripts/install.sh`, `scripts/install.ps1`) align with the release.
|
|
9
9
|
- [x] Run full release verification:
|
|
10
10
|
```bash
|
package/docs/v2-roadmap.md
CHANGED
|
@@ -9,7 +9,7 @@ This document outlines the development path, stabilization targets, and migratio
|
|
|
9
9
|
The primary goal of the **v2.0.0 release** is to promote the experimental features introduced in `v1.2.0` (Template Galaxy, Model Compatibility Layer, and Android Expo template) into officially frozen, production-grade core components, and resume stable package publication to the public npm registry.
|
|
10
10
|
|
|
11
11
|
> [!IMPORTANT]
|
|
12
|
-
> **v2.0.
|
|
12
|
+
> **v2.0.1 is the active stable release.** NPM publishing is resumed, consolidating the Template Galaxy and Model registries.
|
|
13
13
|
|
|
14
14
|
---
|
|
15
15
|
|
package/package.json
CHANGED
package/scripts/install.ps1
CHANGED
package/scripts/install.sh
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
/**
|
|
4
4
|
* MultiModel Dev OS - Prepublish Guard
|
|
5
|
-
* Blocks accidental npm publications
|
|
5
|
+
* Blocks accidental npm publications.
|
|
6
6
|
*/
|
|
7
7
|
|
|
8
8
|
import { readFileSync, existsSync } from 'fs';
|
|
@@ -15,8 +15,8 @@ const projectRoot = join(__dirname, '..');
|
|
|
15
15
|
|
|
16
16
|
// 1. Check environment variable override
|
|
17
17
|
if (process.env.MMDO_ALLOW_PUBLISH !== 'true') {
|
|
18
|
-
console.error('\n\x1b[31m[ABORT]
|
|
19
|
-
console.error('To override this guard during the approved
|
|
18
|
+
console.error('\n\x1b[31m[ABORT] Publishing requires explicit release approval. Set MMDO_ALLOW_PUBLISH=true only during an approved npm publish.\x1b[0m');
|
|
19
|
+
console.error('To override this guard during the approved release, set the environment variable:');
|
|
20
20
|
console.log(' \x1b[33mMMDO_ALLOW_PUBLISH=true\x1b[0m\n');
|
|
21
21
|
process.exit(1);
|
|
22
22
|
}
|