fix(installer): tolerate missing agent docs

Author: rldyourmnd

.opencode/commands/index.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.2.0",
+  "version": "1.2.1",
   "generated_by": "scripts/generate_commands_index.py",
   "count": 11,
   "commands": [

.opencode/plugins/index.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.2.0",
+  "version": "1.2.1",
   "generated_by": "scripts/generate_plugins_index.py",
   "count": 10,
   "plugins": [

.opencode/skills/index.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.2.0",
+  "version": "1.2.1",
   "generated_by": "scripts/generate_skills_index.py",
   "count": 38,
   "skills": [

CHANGELOG.md

@@ -8,6 +8,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
 
 
+## [1.2.1] - 2026-06-12
+
+### Fixed
+
+- Tighten system install convergence and Gemini native settings validation. Preserve documented `opencode-ai` `1.17.3`, `@opencode-ai/plugin` `1.17.3`, and `@opencode-ai/sdk` `1.17.3` baseline evidence.
+
 ## [1.2.0] - 2026-06-12
 
 ### Added

SECURITY.md

@@ -8,7 +8,7 @@ historical patch in the line.
 
 | Version | Supported |
 |---|---|
-| Current exact tag `1.2.0` | yes |
+| Current exact tag `1.2.1` | yes |
 | Older `1.1.*` tags | no; upgrade to current exact tag |
 | Older minor / major lines | no |
 

VERSION

@@ -1 +1 @@
-1.2.0
+1.2.1

references/mcp-profiles.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$comment": "Machine-readable MCP server profiles. Each server in opencode.json.mcp belongs to exactly one profile. Profiles are used by scripts/validate_mcp_profiles.py to enforce skill.requires_mcp coverage and by scripts/smoke_mcp_capabilities.py --mode to bound CI smoke probes. The descriptive trust matrix lives in docs/security/mcp-trust-boundaries.md and stays in sync via the validator.",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "updated": "2026-06-12",
   "profiles": {
     "base": {

references/opencode-baseline.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$comment": "Single source of truth for every pinned dependency the marketplace targets. Validators read this file and compare against opencode.json, .opencode/package.json, .opencode/bun.lock, workflow installations, and README/CHANGELOG text. Any drift fails CI. Bump these values in one place and let `scripts/check_baseline_consistency.py` find every reference that needs updating.",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "updated": "2026-06-11",
   "source_of_truth": {
     "runtime_latest_channel": "npm:opencode-ai",

references/rldyour-contract.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$comment": "Machine-readable rldyour workflow contract for the OpenCode adapter. Sister tool repos should map the same canonical IDs to their own native surfaces.",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "updated": "2026-06-07",
   "adapter": "opencode",
   "security": {

scripts/install_system_opencode.sh

@@ -104,6 +104,7 @@ global_paths = [
     (Path("references"), Path("references")),
 ]
 source_paths = project_paths + (global_paths if global_config else [])
+optional_source_paths = {Path("AGENTS.md")}
 excluded_parts = {"node_modules", "__pycache__", ".pytest_cache", ".mypy_cache", ".ruff_cache", "cache"}
 excluded_suffixes = {".pyc"}
 # macOS-only orchestrator skills: cmux (manaflow-ai/cmux) is a macOS
@@ -171,6 +172,9 @@ for src_rel, dst_rel in source_paths:
     src = source_root / src_rel
     dst = target / dst_rel
     if not src.exists():
+        if src_rel in optional_source_paths:
+            actions.append(f"skip optional missing {src_rel}; restore fullrepo to install this agent-only file")
+            continue
         raise SystemExit(f"missing source path: {src}")
     if dst.resolve() == src.resolve():
         actions.append(f"unchanged self path {dst_rel}")