iosm-cli 0.2.3 → 0.2.4

package/docs/cli-reference.md

@@ -329,16 +329,20 @@ iosm --no-extensions --no-skills --no-prompt-templates
 | `full` | Default — all tools, full capabilities |
 | `plan` | Read-only architecture/planning |
 | `iosm` | IOSM artifact context and synchronization |
+| `meta` | Full tools + orchestration-first execution contract |
 | `explore` | Exploratory analysis |
 | `iosm_analyst` | IOSM metric deep-dive |
 | `iosm_verifier` | IOSM verification specialist |
 | `cycle_planner` | Cycle planning specialist |
 
+**Meta mode quality note:** for complex orchestration use modern models with large context windows (`>=128k`, ideally `>=200k`) and high token limits. Smaller models degrade orchestration stability and synthesis quality.
+
 **Examples:**
 
 ```bash
 iosm --profile plan                  # Planning mode
 iosm --profile iosm                  # IOSM mode
+iosm --profile meta                  # Orchestration-first mode
 iosm --offline                       # No network
 iosm --session-trace                 # Enable tracing
 iosm --verbose                       # Verbose startup

package/docs/configuration.md

@@ -248,6 +248,7 @@ Profiles control the agent's behavior, available tools, and system prompt.
 | `full` | All built-ins (read, bash, edit, write, grep, find, ls, rg, fd, ast_grep, comby, jq, yq, semgrep, sed, semantic_search) | Default full development capabilities |
 | `plan` | Read-only (read, grep, find, ls) | Architecture planning and code review |
 | `iosm` | All + IOSM context | IOSM cycle execution with artifact synchronization |
+| `meta` | Full tools + orchestration-first contract | Adaptive multi-agent/delegate execution with verification closure |
 
 ### Advanced Profiles
 
@@ -258,15 +259,18 @@ Profiles control the agent's behavior, available tools, and system prompt.
 | `iosm_verifier` | IOSM quality gate verification |
 | `cycle_planner` | IOSM cycle planning specialist |
 
+> `meta` profile recommendation: for orchestration-heavy work, prefer modern models with large context windows (`>=128k`, ideally `>=200k`) and high output limits. This improves delegate routing, contract retention, and synthesis reliability.
+
 ### Usage
 
 ```bash
 # CLI flag
 iosm --profile plan
 iosm --profile iosm
+iosm --profile meta
 
 # Interactive: cycle with Shift+Tab
-# full → plan → iosm → full → ...
+# full → plan → iosm → meta → full → ...
 
 # In orchestration
 /orchestrate --profiles explore,full,iosm_verifier

package/docs/interactive-mode.md

@@ -289,7 +289,7 @@ Runtime artifacts:
 
 | Key | Action |
 |-----|--------|
-| `Shift+Tab` | Cycle profile (full → plan → iosm) |
+| `Shift+Tab` | Cycle profile (full → plan → iosm → meta) |
 | `Shift+Ctrl+T` | Cycle thinking level |
 | `Ctrl+P` | Next model in rotation |
 | `Shift+Ctrl+P` | Previous model in rotation |
@@ -337,6 +337,10 @@ Profiles change the agent's behavior, available tools, and system prompt:
 | `full` | All built-ins (read, bash, edit, write, grep, find, ls, rg, fd, ast_grep, comby, jq, yq, semgrep, sed, semantic_search) | Default development work |
 | `plan` | Read-only (read, grep, find, ls) | Architecture planning, code review |
 | `iosm` | All + IOSM context | IOSM cycle execution with artifact sync |
+| `meta` | Full toolset + orchestration-first contract | Adaptive multi-agent/delegate execution with verification closure |
+
+> `meta` profile recommendation: use modern high-capability models with large context windows (`>=128k`, ideally `>=200k`) and high output limits.  
+> This directly impacts orchestration quality (delegate fan-out, constraint retention, and final synthesis reliability).
 
 ### Advanced Profiles (via `--profile` or orchestration)
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "iosm-cli",
-	"version": "0.2.3",
+	"version": "0.2.4",
 	"description": "Standalone IOSM CLI with agent tooling, session management, and IOSM artifact orchestration",
 	"type": "module",
 	"iosmConfig": {