iosm-cli 0.2.3 → 0.2.5

package/docs/cli-reference.md

@@ -137,6 +137,10 @@ These commands run inside interactive mode (`iosm`), not as top-level CLI subcom
   - consistency model: `Scopes -> Touches -> Locks -> Gates -> Done`
   - built-in scheduler guards: progress heuristic + conflict density guard
   - high-risk spawn candidates are confirmation-gated
+- `/orchestrate` — legacy manual team splitting remains available:
+  - in `--parallel` mode, omitted `--max-parallel` defaults to selected `--agents`
+  - if profiles are omitted for parallel assignments, runtime defaults workers to `meta` (except read-only host contexts)
+  - assignment hints include `delegate_parallel_hint` for nested delegate planning
 
 Migration notes:
 - `/blast` removed in favor of `/singular`
@@ -329,16 +333,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

@@ -110,6 +110,8 @@ In `/semantic setup`, the headers step is optional: press `Enter` on empty input
 `/contract` edits contract fields interactively (`goal`, scope, constraints, quality gates, DoD, risks, etc.), then writes JSON automatically.
 `/singular <request>` runs a two-pass feasibility analysis (baseline scan + standard agent pass), builds concrete implementation options, then prompts `Start with Swarm` / `Continue without Swarm` / `Cancel`.
 `/swarm` enforces `Scopes -> Touches -> Locks -> Gates -> Done`. If effective contract is missing, it blocks execution and opens a bootstrap menu (auto-draft, guided Q&A, or manual `/contract` editor).
+`/orchestrate --parallel` defaults `--max-parallel` to `--agents` when omitted and auto-selects `meta` workers when profiles are not explicitly set (outside read-only host contexts).
+For orchestrate assignments, `delegate_parallel_hint` is carried into child task calls; high hints should trigger nested delegate fan-out or explicit `DELEGATION_IMPOSSIBLE`.
 `/blast` and `/shadow` are removed from active interactive workflow.
 
 ### `/contract` Detailed Guide
@@ -289,7 +291,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 +339,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/docs/orchestration-and-subagents.md

@@ -146,6 +146,11 @@ Legacy orchestration remains available for existing workflows:
   Analyze security, optimize performance, verify IOSM compliance
 ```
 
+`/orchestrate` parallel defaults in current runtime:
+- if `--max-parallel` is omitted, it defaults to `--agents` (bounded by runtime limit)
+- if worker profiles are omitted, parallel assignments default to `meta` in non-read-only host contexts
+- assignments include `delegate_parallel_hint`; when hint is high, child tasks are expected to fan out with nested delegates (or emit explicit `DELEGATION_IMPOSSIBLE: <reason>`)
+
 Use legacy mode when you explicitly need old team-run semantics.
 
 ---

package/package.json

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