@jaimevalasek/aioson 1.7.2 → 1.8.0

package/CHANGELOG.md

@@ -4,6 +4,41 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+### Added
+- **@pentester agent**: adversarial security review agent with structured findings output (`security-findings-{slug}.json`) and Gate D blocking capability for MEDIUM projects.
+- **@discover agent**: system discovery and semantic knowledge cache bootstrap for brownfield projects.
+- **git:guard**: pre-commit guardrail that blocks forbidden files (`node_modules/`, secrets, build artifacts) from being staged or committed. Supports `--install-hook` for persistent protection.
+- **commit:prepare**: automated commit preparation command that collects staged diffs, runs `git:guard`, and generates `commit-prep.json` ready for `@committer`.
+- **compress:agents**: token-reduction command with structural (free) and semantic (`--llm`) modes. Backs up originals to `.original.md` and supports `--restore`.
+- **tmux launcher**: `live:start` now supports tmux for persistent terminal sessions with compact ANSI status bars.
+- **Runner system**: `runner:run`, `runner:queue`, `runner:plan`, and `runner:daemon` commands for persistent background job execution.
+- **Design-docs governance**: modular code governance system with 5 best-practice files (`folder-structure`, `componentization`, `code-reuse`, `naming`, `file-size`) distributed automatically on install and loaded unconditionally by `@dev` and `@deyvin`.
+- **SDLC process upgrade**: gates and handoff protocol enhancements across the workflow engine.
+- **Feature closure automation**: `feature:close` now auto-triggers `feature:archive` on `--verdict=PASS`, moving all feature artefacts (`prd-`, `spec-`, `requirements-`, etc.) to `.aioson/context/done/{slug}/` and updating `done/MANIFEST.md`. No manual steps required.
+- **Feature archive command**: `feature:archive` with `--dry-run`, `--restore`, and `--force` for retrospective archival and archive restoration. Replaces the legacy `context:trim` workflow.
+- **Agent awareness of archived features**: `@cypher`, `@discover`, `@neo`, and `@sheldon` now read `.aioson/context/done/MANIFEST.md` to avoid loading full archived files.
+
+### Changed
+- **i18n architecture**: decoupled interaction language from agent prompts. Agent instruction files are now canonical English only; `conversation_language` in `project.context.md` controls user-facing language. Removed localized agent packs in favor of single canonical source.
+- **Agent manifests**: moved `.manifest.json` files to `.aioson/agents/manifests/` subfolder to reduce clutter.
+- **Core agents refactored**: `@product`, `@sheldon`, `@dev`, `@deyvin`, `@ux-ui`, and `@squad` split into deterministic on-demand modules for better context efficiency.
+- **@committer**: enhanced with terminal checkbox UI, robust prepare fallback, and optimized workflow.
+- **@squad**: enhanced with domain classification gate, investigation handoff, language policy, and package contract restoration.
+- **Installer pipeline**: hardened with pentester agent integration and improved integrity checks.
+
+### Fixed
+- `@dev` pt-BR locale realignment with canonical prompt flow.
+- `@squad` genome bindings and package contract restoration.
+- Legacy process safeguards restored across agents.
+- Safe canonical English agent sources restored after i18n decoupling.
+- Accidentally tracked local directories removed from git tracking.
+
+## [1.7.3] - 2026-04-13
+### Fixed
+- `@dev` pt-BR locale pack realigned with the canonical prompt flow, restoring the proper cold-start fallback when `dev-state.md` is already `done` and another feature is still `in_progress` in `features.md`.
+- Added a regression test to keep the `@dev` prompt synchronized between the canonical file and the pt-BR locale pack, preventing future drift in the distributed template.
+- Setup prompt templates now reference the current `aioson_version` (`1.7.3`) instead of the stale `1.5.1` example.
+
 ## [1.7.2] - 2026-04-07
 ### Fixed
 - Removed 5 spurious Windows alternate data stream files (`SKILL.md:Zone.Identifier`) from `template/.aioson/skills/design-system/` that leaked from a local Windows copy operation and were never tracked by git.

package/README.md

@@ -114,7 +114,15 @@ npx @jaimevalasek/aioson update
           └───────────┼───────────┘
                       ▼
               ┌───────────────┐
+              │ /pentester    │  ← Adversarial security review (MEDIUM)
+              └───────┬───────┘
+                      ▼
+              ┌───────────────┐
               │    /qa        │  ← Review, tests, browser QA
+              └───────┬───────┘
+                      ▼
+              ┌───────────────┐
+              │   /tester     │  ← Systematic test engineering (when needed)
               └───────────────┘
 ```
 
@@ -509,23 +517,31 @@ aioson squad:dashboard              # real-time web monitoring panel
 | Agent | Role | Best for |
 |-------|------|----------|
 | `/setup` | Project onboarding & context | First step on any project |
+| `/product` | Product decisions & PRD | Feature scope, user stories |
+| `/sheldon` | Deep technical reasoning & PRD hardening | Hard engineering problems, spec review |
 | `/analyst` | Domain discovery & entity mapping | Understanding the problem space |
 | `/architect` | Project structure & technical decisions | Architecture, stack choices |
-| `/product` | Product decisions & PRD | Feature scope, user stories |
 | `/ux-ui` | UI/UX design system & component specs | Dashboards, flows, components |
 | `/pm` | Backlog & user stories | Sprint planning, task breakdown |
-| `/deyvin` / `/pair` | Feature implementation | Coding — greenfield or brownfield |
+| `/orchestrator` | Session protocol & parallel execution | Multi-agent coordination |
 | `/dev` | Feature implementation (any stack) | Focused dev tasks |
+| `/deyvin` / `/pair` | Pair programming & continuity | Coding — greenfield or brownfield |
 | `/qa` | Risk-first review & test generation | Quality gates before ship |
-| `/orchestrator` | Session protocol & parallel execution | Multi-agent coordination |
+| `/tester` | Systematic test engineering | Coverage gaps, legacy code testing |
+| `/pentester` | Adversarial security review | Security gates before release |
 | `/squad` | Parallel agent squads | Large feature sets in parallel |
 | `/genome` | Agent knowledge & learning | Adaptive squad intelligence |
-| `/sheldon` | Deep technical reasoning | Hard engineering problems |
-| `/orache` | Orchestration & routing | Complex multi-step pipelines |
-| `/profiler-researcher` | Research & profiling | External data gathering |
-| `/profiler-enricher` | Profile enrichment | Data augmentation |
-| `/profiler-forge` | Profile generation | Structured output creation |
+| `/committer` | Semantic commit messages | High-quality Git commits |
+| `/cypher` | Plan → structured briefing | Pre-production planning |
+| `/copywriter` | Conversion copy & content | Marketing pages, VSL scripts |
+| `/discover` | System discovery & semantic cache | Brownfield mapping, knowledge bootstrap |
+| `/neo` | Onboarding & next steps | "Where do I start?" guidance |
+| `/orache` | Market research & competitors | External data gathering |
+| `/profiler-researcher` | Persona research & profiling | DNA mental research |
+| `/profiler-enricher` | Profile enrichment | Cognitive analysis |
+| `/profiler-forge` | Profile generation | Genome 3.0 advisor creation |
 | `/site-forge` | Site cloning & design extraction | Clone, harvest, blend, or forge skills from any URL |
+| `/validator` | Deliverable validation | Pre-gate verification |
 
 ---
 
@@ -605,6 +621,28 @@ aioson live:close . --agent=qa --summary="QA complete, shipped"
 
 ---
 
+## AIOSON Store
+
+Package, publish, and distribute squads, genomes, skills, and full systems through the AIOSON Store.
+
+```bash
+# Package and publish your system/boilerplate
+aioson system:package .
+aioson system:publish . --name=my-stack
+
+# Publish squads, genomes, and skills
+aioson squad:publish . --squad=marketing --version=1.0.0
+aioson genome:publish . --slug=fintech --version=1.0.0
+aioson skill:publish . --slug=vue-spa --version=1.0.0
+
+# Install from the Store
+aioson squad:install . --slug=marketing --version=1.0.0
+aioson genome:install . --slug=fintech
+aioson system:install . --slug=laravel-saas
+```
+
+Authentication via `auth:login` and workspace management via `workspace:*` commands are supported for cloud features.
+
 ## Commands
 
 <details>
@@ -613,12 +651,12 @@ aioson live:close . --agent=qa --summary="QA complete, shipped"
 ```bash
 aioson init <project-name> [--lang=en|pt-BR|es|fr] [--tool=codex|claude|gemini|opencode]
 aioson install [path] [--lang=en|pt-BR|es|fr] [--tool=codex|claude|gemini|opencode]
-aioson update [path] [--lang=en|pt-BR|es|fr]
+aioson update [path] [--lang=en|pt-BR|es|fr] [--all]
 aioson info [path] [--json]
 aioson doctor [path] [--fix] [--dry-run] [--json]
 aioson setup:context [path] [--defaults] [--framework=<name>] [--lang=en|pt-BR|es|fr]
 aioson context:validate [path] [--json]
-aioson scan:project [path] [--provider=<name>] [--dry-run] [--json]
+aioson scan:project [path] [--folder=src] [--with-llm] [--provider=<name>] [--dry-run] [--json]
 ```
 
 </details>
@@ -630,6 +668,26 @@ aioson scan:project [path] [--provider=<name>] [--dry-run] [--json]
 aioson agents
 aioson agent:prompt <agent> [--tool=codex|claude|gemini|opencode]
 aioson workflow:plan [path] [--classification=MICRO|SMALL|MEDIUM] [--json]
+aioson workflow:next [path] [--complete] [--auto-heal] [--force]
+aioson workflow:heal [path] --stage=<agent>
+aioson workflow:harden [path] [--dry-run]
+aioson workflow:execute [path] [--dry-run] [--start-from=<agent>]
+```
+
+</details>
+
+<details>
+<summary><strong>SDD automation & gates</strong></summary>
+
+```bash
+aioson preflight [path] [--json]
+aioson classify [path] [--json]
+aioson gate:check [path] --gate=A|B|C|D [--json]
+aioson artifact:validate [path] --feature=<slug> [--json]
+aioson detect:test-runner [path] [--json]
+aioson agent:audit [path] [--json]
+aioson brief:gen [path] --feature=<slug> [--json]
+aioson verify:gate [path] --feature=<slug> [--json]
 ```
 
 </details>
@@ -646,6 +704,21 @@ aioson parallel:doctor [path] [--workers=2..6] [--fix] [--force] [--dry-run] [--
 
 </details>
 
+<details>
+<summary><strong>Live sessions & runtime</strong></summary>
+
+```bash
+aioson live:start [path] --tool=codex|claude|gemini|opencode --agent=<agent> [--plan=<file>] [--no-launch]
+aioson live:handoff [path] --agent=<agent> --to=<next-agent> --reason="..."
+aioson live:status [path] [--watch=<seconds>]
+aioson live:close [path] --agent=<agent> --summary="..."
+aioson runtime:emit [path] --agent=<agent> --type=<event> --summary="..."
+```
+
+`live:start` supports tmux for persistent terminal sessions. Use `--no-launch` to only prepare the tracked envelope without starting the client.
+
+</details>
+
 <details>
 <summary><strong>MCP</strong></summary>
 
@@ -671,6 +744,58 @@ aioson qa:doctor [path] [--json]
 
 </details>
 
+<details>
+<summary><strong>Squads</strong></summary>
+
+```bash
+aioson squad:status [path]
+aioson squad:doctor [path] --squad=<slug>
+aioson squad:validate [path] --squad=<slug>
+aioson squad:export [path] --squad=<slug>
+aioson squad:bus [path] --squad=<slug> --sub=post|read|watch|summary|list|clear
+aioson squad:autorun [path] --squad=<slug> --goal="..."
+aioson squad:daemon [path] --squad=<slug> --sub=start|stop|status
+aioson squad:worker [path] --squad=<slug> --sub=list|run
+aioson squad:dashboard [--port=4180] [--squad=<slug>]
+```
+
+</details>
+
+<details>
+<summary><strong>Store & cloud</strong></summary>
+
+```bash
+aioson auth:login --token ...
+aioson auth:status
+aioson workspace:init [path] --name=<slug>
+aioson system:package [path]
+aioson system:publish [path] --name=<slug>
+aioson squad:publish [path] --squad=<slug> [--paid]
+aioson squad:install [path] --slug=<slug>
+aioson genome:publish [path] --slug=<slug>
+aioson genome:install [path] --slug=<slug>
+aioson skill:publish [path] --slug=<slug>
+```
+
+</details>
+
+<details>
+<summary><strong>Context optimization</strong></summary>
+
+```bash
+aioson context:pack [path] [--agent=<agent>] [--goal="..."] [--module=<folder>]
+aioson context:health [path]
+aioson feature:archive [path] --feature=<slug> [--dry-run] [--restore] [--force]
+aioson context:monitor [path] [--budget=<n>] [--tokens=<n>]
+aioson context:search:index [path]
+aioson context:search [path] --query="..."
+aioson context:cache:save --label=<name>
+aioson context:cache:restore --label=<name>
+aioson compress:agents [path] [--agent=<name>] [--rules] [--dry-run] [--restore]
+```
+
+</details>
+
 <details>
 <summary><strong>i18n & locale</strong></summary>
 
@@ -683,10 +808,24 @@ Built-in locales: `en`, `pt-BR`, `es`, `fr`. Use `--lang` or `AIOS_LITE_LOCALE`
 
 </details>
 
+<details>
+<summary><strong>Git & committer</strong></summary>
+
+```bash
+aioson commit:prepare [path] [--json]
+aioson git:guard [path] [--install-hook] [--json]
+```
+
+`commit:prepare` collects staged diffs, runs `git:guard`, and generates a `commit-prep.json` ready for `@committer`.
+`git:guard` blocks commits with forbidden files (`node_modules/`, secrets, etc.) and can install a pre-commit hook.
+
+</details>
+
 <details>
 <summary><strong>Testing & CI</strong></summary>
 
 ```bash
+aioson test:agents [path]
 aioson test:smoke [workspace-path] [--lang=en|pt-BR|es|fr] [--web3=ethereum|solana|cardano] [--profile=standard|mixed|parallel] [--keep] [--json]
 aioson test:package [source-path] [--keep] [--dry-run] [--json]
 ```
@@ -768,6 +907,10 @@ aioson scan:project --json
 - [Agent sharding](docs/pt/agent-sharding.md)
 - [Guia do engenheiro](docs/pt/guia-engineer.md)
 - [Squad Dashboard (PT)](docs/pt/squad-dashboard.md)
+- [SDD automation scripts](docs/pt/sdd-automation-scripts.md)
+- [Motor hardening](docs/pt/motor-hardening.md)
+- [Design-docs governance](docs/pt/design-docs-governance.md)
+- [Runner system](docs/pt/runner-system.md)
 
 ---
 

package/docs/en/cli-reference.md

@@ -313,7 +313,7 @@ Once the project is set up, each new feature follows a shorter sequence — no `
 @product → @analyst → @dev → @qa
 ```
 
-`@product` creates a feature-scoped `prd-{slug}.md` and registers the feature in `features.md`. `@analyst` produces `requirements-{slug}.md` and `spec-{slug}.md`. `@dev` reads the feature spec. `@qa` closes the feature by updating `spec-{slug}.md` with a QA sign-off and marking it `done` in `features.md`.
+`@product` creates a feature-scoped `prd-{slug}.md` and registers the feature in `features.md`. `@analyst` produces `requirements-{slug}.md` and `spec-{slug}.md`. `@dev` reads the feature spec. `@qa` closes the feature by running `feature:close --verdict=PASS`, which updates `spec-{slug}.md` with a QA sign-off, marks it `done` in `features.md`, and automatically archives all feature artefacts to `.aioson/context/done/{slug}/`.
 
 The `SMALL` and MEDIUM outputs include a note reminding you of this sequence.
 
@@ -345,6 +345,61 @@ aioson workflow:next ./my-project --skip=dev
 
 ---
 
+## feature:close
+
+Close a feature after QA sign-off, updating the spec, features registry, and project pulse — and automatically archive all feature artefacts on PASS.
+
+```bash
+aioson feature:close . --feature=checkout --verdict=PASS --residual="none"
+aioson feature:close . --feature=checkout --verdict=FAIL --notes="critical auth bug"
+aioson feature:close . --feature=checkout --verdict=PASS --no-archive
+```
+
+**Options:**
+- `--feature=<slug>` — feature identifier (required).
+- `--verdict=PASS|FAIL` — QA result (required).
+- `--residual="..."` — residual risks or open notes for PASS (optional).
+- `--notes="..."` — failure reason for FAIL (optional).
+- `--no-archive` — skip automatic archival (useful for idempotent re-runs).
+- `--json` — structured JSON output.
+
+**What it does:**
+1. Appends a `## QA sign-off` section to `spec-{slug}.md`.
+2. Updates `features.md` with the new status (`done` or `qa_failed`) and completed date.
+3. Clears active work from `project-pulse.md`.
+4. If `verdict=PASS` and `--no-archive` is not set, calls `feature:archive` automatically to move all artefacts to `.aioson/context/done/{slug}/`.
+
+**When to use:** run by `@qa` automatically when QA is approved. Can also be run manually.
+
+---
+
+## feature:archive
+
+Move feature artefacts to the archive directory and maintain a manifest for lightweight historical lookup.
+
+```bash
+aioson feature:archive . --feature=checkout
+aioson feature:archive . --feature=checkout --dry-run
+aioson feature:archive . --feature=checkout --restore
+aioson feature:archive . --feature=checkout --restore --dry-run
+aioson feature:archive . --feature=checkout --force
+```
+
+**Options:**
+- `--feature=<slug>` — feature identifier (required).
+- `--dry-run` — preview what would be moved or restored without making changes.
+- `--restore` — move artefacts back from `.aioson/context/done/{slug}/` to the context root.
+- `--force` — archive even if the feature is not registered in `features.md` or is still `in_progress`.
+- `--json` — structured JSON output with `moved`, `skipped`, `archiveDir`, and `manifestEntry`.
+
+**What it moves:** any file in the root of `.aioson/context/` whose name contains the feature slug: `prd-{slug}.md`, `spec-{slug}.md`, `requirements-{slug}.md`, `sheldon-enrichment-{slug}.md`, `qa-report-{slug}.md`, `conformance-{slug}.yaml`, etc.
+
+**What it never moves:** global files (`project.context.md`, `project-pulse.md`, `features.md`, `discovery.md`, etc.) and subdirectories (`bootstrap/`, `forensics/`, `parallel/`, `done/`).
+
+**Manifest:** after each archive run, `.aioson/context/done/MANIFEST.md` is updated with a row summarizing the feature. Agents like `@cypher`, `@neo`, `@discover`, and `@sheldon` read this manifest instead of loading full archived files.
+
+---
+
 ## test:smoke
 
 End-to-end integration test that installs AIOSON in a temporary directory, runs all major commands, and verifies the output. Used for CI and release validation.

package/docs/en/i18n.md

@@ -1,26 +1,30 @@
 # i18n Guide
 
-AIOSON CLI supports localization through message dictionaries.
+AIOSON CLI supports localization through message dictionaries and a decoupled interaction language system.
 
 ## How it works
+
+### CLI localization
 - Dictionaries are stored in `src/i18n/messages/`.
 - `src/i18n/index.js` resolves locale and fallback behavior.
 - Commands use translation keys instead of hardcoded strings.
-- Agent templates read `conversation_language` from `.aioson/context/project.context.md` and should use it for interaction/output language.
-- Localized agent packs live in `.aioson/locales/<locale>/agents/` and can be applied to active prompts with `aioson locale:apply`.
+- The CLI locale is controlled by `--locale=<lang>` or `AIOS_LITE_LOCALE` env var.
+
+### Agent interaction language (decoupled)
+Agent instruction files are maintained in **canonical English** only. The interaction language is decoupled from the agent prompts:
+
+- `conversation_language` in `.aioson/context/project.context.md` tells agents which language to use for **interaction and output** with the user.
+- Agent **prompts and reasoning instructions** remain in English to ensure consistency and reduce drift across locales.
+- `locale:apply` updates the agent files to reflect the chosen interaction language, but does **not** translate the core reasoning prompts.
+
+This architecture (introduced in v1.7.3+) replaces the previous "localized agent packs" system. Localized agent packs in `.aioson/locales/<locale>/agents/` were removed in favor of a single canonical source + interaction-language metadata.
 
 ## Runtime selection
-- CLI option: `--locale=en`
-- Env var: `AIOS_LITE_LOCALE=en`
+- CLI option: `--locale=en|pt-BR|es|fr`
+- Env var: `AIOS_LITE_LOCALE=en|pt-BR|es|fr`
 - Default: `en`
 
-Built-in locales:
-- `en`
-- `pt-BR`
-- `es`
-- `fr`
-
-Built-in localized agent packs:
+Built-in CLI locales:
 - `en`
 - `pt-BR`
 - `es`
@@ -32,12 +36,8 @@ Resolution behavior:
 - `fr-CA` and other `fr-*` variants resolve to `fr`.
 - Unknown locales fall back to `en`.
 
-## Create a locale scaffold
-```bash
-aioson i18n:add fr
-```
+## Apply interaction language to agents
 
-## Apply localized agent prompts
 ```bash
 # Use language from project.context.md
 aioson locale:apply
@@ -46,7 +46,7 @@ aioson locale:apply
 aioson locale:apply --lang=pt-BR
 ```
 
-## Add a new locale
+## Add a new CLI locale
 1. Run `aioson i18n:add <locale>`.
 2. Replace English strings in `src/i18n/messages/<locale>.js`.
 3. Add tests for locale resolution and fallback behavior.

package/docs/en/schemas/index.json

@@ -107,6 +107,16 @@
       "command": "aioson parallel:doctor --json",
       "file": "parallel-doctor.schema.json"
     },
+    {
+      "id": "parallel_merge",
+      "command": "aioson parallel:merge --json",
+      "file": "parallel-merge.schema.json"
+    },
+    {
+      "id": "parallel_guard",
+      "command": "aioson parallel:guard --json",
+      "file": "parallel-guard.schema.json"
+    },
     {
       "id": "cli_error",
       "command": "aioson <unknown> --json",

package/docs/en/schemas/parallel-assign.schema.json

@@ -51,6 +51,15 @@
     "filesUpdated": {
       "type": "array",
       "items": { "type": "string" }
+    },
+    "machineFiles": {
+      "type": "object",
+      "properties": {
+        "workspaceManifest": { "type": "string" },
+        "ownershipMap": { "type": "string" },
+        "mergePlan": { "type": "string" }
+      },
+      "additionalProperties": true
     }
   },
   "additionalProperties": true

package/docs/en/schemas/parallel-doctor.schema.json

@@ -40,6 +40,9 @@
         "parallelDir": { "type": "string" },
         "dirExists": { "type": "boolean" },
         "sharedExists": { "type": "boolean" },
+        "manifestExists": { "type": "boolean" },
+        "ownershipExists": { "type": "boolean" },
+        "mergePlanExists": { "type": "boolean" },
         "laneFiles": {
           "type": "array",
           "items": { "type": "string" }
@@ -55,6 +58,39 @@
       },
       "additionalProperties": true
     },
+    "analysis": {
+      "type": "object",
+      "properties": {
+        "ownershipConflicts": {
+          "type": "array",
+          "items": { "type": "object", "additionalProperties": true }
+        },
+        "dependencies": {
+          "type": "object",
+          "properties": {
+            "declaredCount": { "type": "integer", "minimum": 0 },
+            "invalidCount": { "type": "integer", "minimum": 0 },
+            "blockedCount": { "type": "integer", "minimum": 0 },
+            "orderViolationCount": { "type": "integer", "minimum": 0 }
+          },
+          "additionalProperties": true
+        },
+        "sync": {
+          "type": "object",
+          "properties": {
+            "workspaceManifestInSync": { "type": "boolean" },
+            "ownershipMapInSync": { "type": "boolean" },
+            "mergePlanInSync": { "type": "boolean" },
+            "staleFiles": {
+              "type": "array",
+              "items": { "type": "string" }
+            }
+          },
+          "additionalProperties": true
+        }
+      },
+      "additionalProperties": true
+    },
     "checks": {
       "type": "array",
       "items": {

package/docs/en/schemas/parallel-guard.schema.json

@@ -0,0 +1,63 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiosforge.dev/schemas/parallel-guard.schema.json",
+  "title": "AIOSON parallel:guard --json output",
+  "type": "object",
+  "required": [
+    "ok",
+    "targetDir",
+    "parallelDir",
+    "lane",
+    "requestedCount",
+    "laneWritePathCount",
+    "writeScope",
+    "results",
+    "allowedCount",
+    "deniedCount",
+    "denied"
+  ],
+  "properties": {
+    "ok": { "type": "boolean" },
+    "targetDir": { "type": "string" },
+    "parallelDir": { "type": "string" },
+    "lane": { "type": "integer", "minimum": 1 },
+    "requestedCount": { "type": "integer", "minimum": 1 },
+    "laneWritePathCount": { "type": "integer", "minimum": 0 },
+    "writeScope": {
+      "type": "object",
+      "properties": {
+        "laneCount": { "type": "integer", "minimum": 0 },
+        "totalPathCount": { "type": "integer", "minimum": 0 },
+        "invalidPatternCount": { "type": "integer", "minimum": 0 },
+        "conflictCount": { "type": "integer", "minimum": 0 }
+      },
+      "additionalProperties": true
+    },
+    "results": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["path", "ok", "reason", "matchedLanes"],
+        "properties": {
+          "path": { "type": "string" },
+          "normalizedPath": { "type": ["string", "null"] },
+          "ok": { "type": "boolean" },
+          "reason": { "type": "string" },
+          "ownerLane": { "type": "integer", "minimum": 1 },
+          "matchedLanes": {
+            "type": "array",
+            "items": { "type": "integer", "minimum": 1 }
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "allowedCount": { "type": "integer", "minimum": 0 },
+    "deniedCount": { "type": "integer", "minimum": 0 },
+    "denied": {
+      "type": "array",
+      "items": { "type": "object", "additionalProperties": true }
+    }
+  },
+  "additionalProperties": true
+}

package/docs/en/schemas/parallel-merge.schema.json

@@ -0,0 +1,84 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aiosforge.dev/schemas/parallel-merge.schema.json",
+  "title": "AIOSON parallel:merge --json output",
+  "type": "object",
+  "required": [
+    "ok",
+    "targetDir",
+    "apply",
+    "generatedAt",
+    "laneCount",
+    "structural",
+    "merge",
+    "filesUpdated",
+    "sharedDecisionUpdated"
+  ],
+  "properties": {
+    "ok": { "type": "boolean" },
+    "targetDir": { "type": "string" },
+    "apply": { "type": "boolean" },
+    "generatedAt": { "type": "string" },
+    "laneCount": { "type": "integer", "minimum": 1 },
+    "structural": {
+      "type": "object",
+      "properties": {
+        "sharedDecisionsExists": { "type": "boolean" },
+        "machineFiles": { "type": "object", "additionalProperties": true },
+        "missingMachineFiles": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "sync": {
+          "type": "object",
+          "properties": {
+            "workspaceManifestInSync": { "type": "boolean" },
+            "ownershipMapInSync": { "type": "boolean" },
+            "mergePlanInSync": { "type": "boolean" },
+            "staleFiles": {
+              "type": "array",
+              "items": { "type": "string" }
+            }
+          },
+          "additionalProperties": true
+        },
+        "ownershipConflictCount": { "type": "integer", "minimum": 0 },
+        "writeScopeConflictCount": { "type": "integer", "minimum": 0 },
+        "invalidWritePathCount": { "type": "integer", "minimum": 0 },
+        "invalidDependencyCount": { "type": "integer", "minimum": 0 },
+        "blockedDependencyCount": { "type": "integer", "minimum": 0 },
+        "orderViolationCount": { "type": "integer", "minimum": 0 }
+      },
+      "additionalProperties": true
+    },
+    "merge": {
+      "type": "object",
+      "properties": {
+        "strategy": { "type": "string" },
+        "order": {
+          "type": "array",
+          "items": { "type": "integer", "minimum": 1 }
+        },
+        "readyToApply": { "type": "boolean" },
+        "readyLaneCount": { "type": "integer", "minimum": 0 },
+        "alreadyMergedCount": { "type": "integer", "minimum": 0 },
+        "blockedCount": { "type": "integer", "minimum": 0 },
+        "blocked": {
+          "type": "array",
+          "items": { "type": "object", "additionalProperties": true }
+        },
+        "plan": {
+          "type": "array",
+          "items": { "type": "object", "additionalProperties": true }
+        }
+      },
+      "additionalProperties": true
+    },
+    "filesUpdated": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "sharedDecisionUpdated": { "type": "boolean" }
+  },
+  "additionalProperties": true
+}