arkaos 5.9.0 → 5.10.0

package/THE-ARKAOS-GUIDE.md

@@ -1,6 +1,6 @@
 # The ArkaOS Guide
 
-> v5.9.0 — 89 agents, 17 departments, 340 skills, 306 commands, 20 ADRs.
+> v5.10.0 — 89 agents, 17 departments, 340 skills, 306 commands, 20 ADRs.
 > One file, everything you need to start. Generated by `scripts/guide_gen.py` — never hand-edited.
 
 ## What it is

package/VERSION

@@ -1 +1 @@
-5.9.0
+5.10.0

package/core/governance/evidence_checks.py

@@ -35,7 +35,8 @@ import subprocess
 import sys
 import time
 from dataclasses import asdict, dataclass, field, replace
-from pathlib import Path
+from pathlib import Path, PurePosixPath
+from xml.etree import ElementTree
 
 from core.governance.qg_digest import evidence_digest
 from core.shared.test_evidence import coverage_percent_from_xml
@@ -553,30 +554,172 @@ def _junit_result(junit: Path) -> CheckResult:
     )
 
 
+def _coverage_from_xml(
+    coverage_xml: Path, project_dir: Path, changed: list[str] | None,
+) -> CheckResult:
+    """Coverage verdict from an artefact, refusing one that cannot describe the diff."""
+    stale = _stale_coverage_reason(coverage_xml, project_dir, changed)
+    if stale is not None:
+        return CheckResult(
+            check="coverage", ran=True, passed=False,
+            command="parse:coverage.xml", exit_code=None,
+            summary=stale, details_path=str(coverage_xml),
+        )
+    percent = coverage_percent_from_xml(coverage_xml)
+    if percent is None:
+        return CheckResult(
+            check="coverage", ran=True, passed=None,
+            command="parse:coverage.xml", exit_code=None,
+            summary="coverage.xml present but unparseable",
+            details_path=str(coverage_xml),
+        )
+    return CheckResult(
+        check="coverage", ran=True,
+        passed=percent >= COVERAGE_THRESHOLD,
+        command="parse:coverage.xml", exit_code=None,
+        summary=f"coverage {percent:.1f}% (threshold {COVERAGE_THRESHOLD:.0f}%)",
+        details_path=str(coverage_xml),
+    )
+
+
+def _stale_coverage_reason(
+    coverage_xml: Path, project_dir: Path, changed: list[str] | None,
+) -> str | None:
+    """Reason the artefact cannot describe this diff, or None if it can.
+
+    A coverage.xml older than the newest changed source measured a different
+    codebase, and a green number then vouches for code it never executed.
+    """
+    try:
+        artefact_mtime = coverage_xml.stat().st_mtime
+    except OSError:
+        return "coverage.xml unreadable"
+
+    newest_name = _newest_changed_after(project_dir, changed, artefact_mtime)
+    if newest_name is not None:
+        return (
+            f"coverage.xml predates changed source ({newest_name}) — "
+            "regenerate it; it cannot describe this diff"
+        )
+    return _missing_module_reason(coverage_xml, changed, project_dir)
+
+
+def _missing_module_reason(
+    coverage_xml: Path, changed: list[str] | None, project_dir: Path,
+) -> str | None:
+    """Reason a changed module is absent from the artefact, or None."""
+    covered = _covered_paths(coverage_xml, project_dir)
+    missing = [
+        rel for rel in (changed or [])
+        if rel.endswith(".py")
+        and not rel.startswith("tests/")
+        and not _is_covered(rel, covered)
+    ]
+    if not missing:
+        return None
+    return (
+        f"coverage.xml has no entry for {len(missing)} changed module(s), "
+        f"first: {missing[0]}"
+    )
+
+
+def _newest_changed_after(
+    project_dir: Path, changed: list[str] | None, cutoff: float,
+) -> str | None:
+    """Name of the newest changed .py file modified after cutoff, else None.
+
+    Only executable source can invalidate a coverage artefact — treating
+    CHANGELOG.md as "changed source" forced a full regeneration for edits no
+    test could ever execute (same filter the module-presence check applies).
+    """
+    newest = cutoff
+    newest_name: str | None = None
+    for rel in changed or []:
+        if not rel.endswith(".py"):
+            continue
+        try:
+            mtime = (project_dir / rel).stat().st_mtime
+        except OSError:
+            continue
+        if mtime > newest:
+            newest, newest_name = mtime, rel
+    return newest_name
+
+
+def _covered_paths(coverage_xml: Path, project_dir: Path) -> set[str]:
+    """Covered files as paths relative to project_dir, exactly.
+
+    A ``class/@filename`` is relative to one of the ``sources/source``
+    roots, which are usually absolute and which the changed-file list never
+    carries. Each candidate is therefore rebuilt against every source and
+    re-expressed relative to the project, so comparison can be equality.
+
+    Suffix or stem matching is not good enough here: `core/` alone carries
+    14 colliding stems, this repo's own artefact yields five bare basenames,
+    and a suffix rule cannot tell `core/sync/engine.py` from
+    `vendor/core/sync/engine.py`. Equality can.
+    """
+    try:
+        root = ElementTree.parse(coverage_xml).getroot()
+    except (ElementTree.ParseError, OSError):
+        return set()
+    sources = [(el.text or "").strip() for el in root.iterfind("sources/source")]
+    try:
+        base = project_dir.resolve()
+    except OSError:
+        base = project_dir
+    return {
+        candidate
+        for cls in root.iter("class")
+        if cls.get("filename")
+        for candidate in _source_candidates(cls.get("filename", ""), sources, base)
+    }
+
+
+def _source_candidates(
+    filename: str, sources: list[str], base: Path,
+) -> set[str]:
+    """Project-relative spellings of one covered file, anchored.
+
+    With ``<source>`` roots declared, every candidate must resolve through
+    one of them into the project — the unanchored raw filename let another
+    checkout's artefact vouch for this project's files. The raw spelling is
+    a fallback only when no sources exist; a relative source resolves
+    against the project, never the CWD.
+    """
+    if not sources:
+        raw = PurePosixPath(filename)
+        return set() if raw.is_absolute() else {raw.as_posix()}
+
+    # Candidates must exist on disk; existence under more than one source
+    # is ambiguous — vouch for neither (fail closed).
+    found: set[str] = set()
+    for source in sources:
+        src = Path(source)
+        if not src.is_absolute():
+            src = base / src
+        try:
+            resolved = (src / filename).resolve()
+            if not resolved.is_file():
+                continue
+            found.add(PurePosixPath(resolved.relative_to(base)).as_posix())
+        except (OSError, ValueError):
+            continue
+    return found if len(found) == 1 else set()
+
+
+def _is_covered(rel: str, covered: set[str]) -> bool:
+    """True only when the artefact names exactly this project-relative path."""
+    return PurePosixPath(rel).as_posix() in covered
+
+
 def _check_coverage(
     project_dir: Path, changed: list[str] | None,
     test_command: str | None, timeout: int,
 ) -> CheckResult:
     coverage_xml = project_dir / "coverage.xml"
     if coverage_xml.is_file():
-        percent = coverage_percent_from_xml(coverage_xml)
-        if percent is None:
-            return CheckResult(
-                check="coverage", ran=True, passed=None,
-                command="parse:coverage.xml", exit_code=None,
-                summary="coverage.xml present but unparseable",
-                details_path=str(coverage_xml),
-            )
-        return CheckResult(
-            check="coverage", ran=True,
-            passed=percent >= COVERAGE_THRESHOLD,
-            command="parse:coverage.xml", exit_code=None,
-            summary=(
-                f"coverage {percent:.1f}% "
-                f"(threshold {COVERAGE_THRESHOLD:.0f}%)"
-            ),
-            details_path=str(coverage_xml),
-        )
+        return _coverage_from_xml(coverage_xml, project_dir, changed)
     junit = project_dir / "junit.xml"
     if junit.is_file():
         return _junit_result(junit)
@@ -767,9 +910,10 @@ def _check_spellcheck(
 def _spellcheck_inspected_count(project_dir: Path, md_files: list[str]) -> int:
     """How many of ``md_files`` codespell actually reads after `skip`.
 
-    Asks codespell itself (``--count`` on a per-file basis is too slow; a
-    skipped file simply produces no output for any planted probe), so instead
-    we replay its own glob semantics from the config.
+    Replays the config's skip globs with fnmatch rather than asking codespell
+    itself — per-file ``--count`` probing is too slow, and a skipped file
+    simply produces no output, so codespell cannot be asked which files it
+    ignored.
     """
     patterns = _codespell_skip_globs(project_dir)
     if not patterns:

package/core/sync/content_merger.py

@@ -23,7 +23,7 @@ _END_RE = re.compile(r"<!--\s*arkaos:managed:end\s*-->")
 class MergeResult:
     """Outcome of a managed-region merge operation."""
 
-    status: Literal["updated", "unchanged", "error"]
+    status: Literal["updated", "restamped", "drifted", "unchanged", "error"]
     new_text: str
     error: str | None = None
 
@@ -38,52 +38,103 @@ def merge_managed_content(
 ) -> MergeResult:
     """Merge managed_content into target_text inside the managed region.
 
-    Returns status "updated" when the file changes, "unchanged" when the
-    new hash matches the existing one, or "error" when markers are
-    unbalanced.
+    Returns "updated" when the managed content itself changes, "restamped"
+    when the verified-current content carries a stale stamp, "drifted" when
+    the block was edited in place (nothing is written), "unchanged" when
+    everything already matches, or "error" when markers are malformed.
     """
+    # Normalise once so the hash, the rendered block and the drift check all
+    # see the same bytes: hashing the unstripped input against a stripped
+    # body made the merger report `drifted` on output it wrote itself.
+    managed_content = managed_content.strip()
     starts = list(_START_RE.finditer(target_text))
     ends = list(_END_RE.finditer(target_text))
 
+    malformed = _validate_markers(starts, ends, target_text)
+    if malformed is not None:
+        return malformed
+
+    new_hash = compute_managed_hash(managed_content)
+    new_block = _render_block(managed_content, version, new_hash)
+
+    if not starts:
+        return _prepend_block(target_text, new_block)
+
+    start_match, end_match = starts[0], ends[0]
+    rewritten = (
+        target_text[: start_match.start()]
+        + new_block
+        + target_text[end_match.end() :]
+    )
+
+    body = target_text[start_match.end() : end_match.start()].strip()
+    return _decide(
+        stamped_hash=start_match.group("hash"),
+        stamped_version=start_match.group("version"),
+        body=body,
+        new_hash=new_hash,
+        version=version,
+        target_text=target_text,
+        rewritten=rewritten,
+    )
+
+
+def _decide(
+    *,
+    stamped_hash: str | None,
+    stamped_version: str | None,
+    body: str,
+    new_hash: str,
+    version: str,
+    target_text: str,
+    rewritten: str,
+) -> MergeResult:
+    """Choose the outcome for a well-formed block."""
+    if stamped_hash != new_hash:
+        return MergeResult(status="updated", new_text=rewritten)
+    # The stamp says the content matches canonical — but the stamp is a
+    # claim, not a measurement. Hash what is ACTUALLY between the markers
+    # before rewriting: an operator who edited inside the block leaves the
+    # stamp untouched, and a rewrite would delete their work to correct a
+    # version number.
+    if compute_managed_hash(body) != new_hash:
+        return MergeResult(
+            status="drifted",
+            new_text=target_text,
+            error="managed block was edited in place; left untouched",
+        )
+    if stamped_version == version:
+        return MergeResult(status="unchanged", new_text=target_text)
+    # Content verified current; only the stamp lags. Rewriting it keeps
+    # `version=` an honest record of the last sync that verified this file.
+    return MergeResult(status="restamped", new_text=rewritten)
+
+
+def _validate_markers(
+    starts: list[re.Match[str]],
+    ends: list[re.Match[str]],
+    target_text: str,
+) -> MergeResult | None:
+    """Return an error MergeResult when the marker pair is malformed."""
     if len(starts) != len(ends):
         return MergeResult(
             status="error",
             new_text=target_text,
             error=f"unbalanced markers: {len(starts)} starts, {len(ends)} ends",
         )
-
     if len(starts) > 1:
         return MergeResult(
             status="error",
             new_text=target_text,
             error="multiple managed blocks are not supported",
         )
-
-    new_hash = compute_managed_hash(managed_content)
-    new_block = _render_block(managed_content, version, new_hash)
-
-    if not starts:
-        return _prepend_block(target_text, new_block)
-
-    start_match = starts[0]
-    end_match = ends[0]
-    if end_match.start() < start_match.end():
+    if starts and ends[0].start() < starts[0].end():
         return MergeResult(
             status="error",
             new_text=target_text,
             error="end marker appears before start marker",
         )
-
-    existing_hash = start_match.group("hash")
-    if existing_hash == new_hash:
-        return MergeResult(status="unchanged", new_text=target_text)
-
-    new_text = (
-        target_text[: start_match.start()]
-        + new_block
-        + target_text[end_match.end() :]
-    )
-    return MergeResult(status="updated", new_text=new_text)
+    return None
 
 
 def _render_block(content: str, version: str, content_hash: str) -> str:

package/core/sync/content_syncer.py

@@ -19,6 +19,7 @@ from __future__ import annotations
 
 import os
 import shutil
+from dataclasses import dataclass, field
 from pathlib import Path
 
 import yaml
@@ -51,39 +52,64 @@ def _do_sync(project: Project) -> ContentSyncResult:
     project_claude = Path(project.path) / ".claude"
     project_claude.mkdir(parents=True, exist_ok=True)
 
-    updated: list[str] = []
-    unchanged: list[str] = []
-    errored: list[str] = []
-
-    _sync_claude_md(core, project, project_claude, version, updated, unchanged, errored)
-    _sync_rules(core, project_claude, updated, unchanged, errored)
-    _sync_stack_rules(core, project, project_claude, updated, unchanged, errored)
-    _sync_hooks(core, project_claude, updated, unchanged, errored)
-    _sync_constitution(core, project_claude, updated, unchanged, errored)
-
-    if errored:
-        status = "error"
-    elif updated:
-        status = "updated"
-    else:
-        status = "unchanged"
+    out = _Artefacts()
+    _sync_claude_md(core, project, project_claude, version, out)
+    _sync_rules(core, project_claude, out.updated, out.unchanged, out.errored)
+    _sync_stack_rules(
+        core, project, project_claude, out.updated, out.unchanged, out.errored
+    )
+    _sync_hooks(core, project_claude, out.updated, out.unchanged, out.errored)
+    _sync_constitution(core, project_claude, out.updated, out.unchanged, out.errored)
+
     return ContentSyncResult(
         path=project.path,
-        status=status,
-        artefacts_updated=updated,
-        artefacts_unchanged=unchanged,
-        artefacts_errored=errored,
+        status=out.status(),
+        artefacts_updated=out.updated,
+        artefacts_restamped=out.restamped,
+        artefacts_drifted=out.drifted,
+        artefacts_unchanged=out.unchanged,
+        artefacts_errored=out.errored,
     )
 
 
+@dataclass
+class _Artefacts:
+    """Per-project artefact outcomes, one list per status.
+
+    Passed as a single object rather than four parallel out-parameters —
+    adding a fifth status would otherwise mean editing every signature that
+    threads them through.
+    """
+
+    updated: list[str] = field(default_factory=list)
+    restamped: list[str] = field(default_factory=list)
+    drifted: list[str] = field(default_factory=list)
+    unchanged: list[str] = field(default_factory=list)
+    errored: list[str] = field(default_factory=list)
+
+    def status(self) -> str:
+        """Worst outcome wins: error > drift > real change > restamp > no-op.
+
+        Drift outranks a change because it needs the operator's judgement;
+        it is NOT an error — the merger deliberately preserved their edit.
+        """
+        if self.errored:
+            return "error"
+        if self.drifted:
+            return "drifted"
+        if self.updated:
+            return "updated"
+        if self.restamped:
+            return "restamped"
+        return "unchanged"
+
+
 def _sync_claude_md(
     core: Path,
     project: Project,
     project_claude: Path,
     version: str,
-    updated: list[str],
-    unchanged: list[str],
-    errored: list[str],
+    out: _Artefacts,
 ) -> None:
     # Stack conventions live in path-scoped rule files (_sync_stack_rules);
     # the managed block carries only the shared base.
@@ -92,18 +118,30 @@ def _sync_claude_md(
     )
     target_file = project_claude / "CLAUDE.md"
     target_text = target_file.read_text(encoding="utf-8") if target_file.exists() else ""
-
     result = merge_managed_content(target_text, managed_content, version)
+    _record_claude_md(result, target_file, managed_content, out)
+
+
+def _record_claude_md(result, target_file, managed_content: str, out) -> None:
+    """Apply one merge outcome: write, skip, or record without writing."""
     if result.status == "error":
-        errored.append(f"CLAUDE.md: {result.error}")
-        sidecar = target_file.with_suffix(".md.arkaos-new")
-        sidecar.write_text(managed_content, encoding="utf-8")
+        out.errored.append(f"CLAUDE.md: {result.error}")
+        target_file.with_suffix(".md.arkaos-new").write_text(
+            managed_content, encoding="utf-8"
+        )
+        return
+    if result.status == "drifted":
+        # The operator edited inside the managed block. Overwriting to fix a
+        # version number would delete their work; record it as drift — not as
+        # an error, because nothing failed.
+        out.drifted.append("CLAUDE.md")
         return
     if result.status == "unchanged":
-        unchanged.append("CLAUDE.md")
+        out.unchanged.append("CLAUDE.md")
         return
     target_file.write_text(result.new_text, encoding="utf-8")
-    updated.append("CLAUDE.md")
+    bucket = out.restamped if result.status == "restamped" else out.updated
+    bucket.append("CLAUDE.md")
 
 
 # Descriptor slug -> stack-rules basename (no .md). Slugs are case-folded first.

package/core/sync/engine.py

@@ -13,19 +13,20 @@ from pathlib import Path
 
 from core.runtime.user_paths import (
     ecosystems_file as resolve_ecosystems_file,
+)
+from core.runtime.user_paths import (
     projects_dir as resolve_projects_dir,
 )
-from core.sync.manifest import build_manifest
+from core.sync.agent_provisioner import sync_all_agents
+from core.sync.content_syncer import sync_all_content
+from core.sync.descriptor_syncer import sync_all_descriptors
 from core.sync.discovery import discover_all_projects
+from core.sync.manifest import build_manifest
 from core.sync.mcp_optimizer import optimize_all_mcps
 from core.sync.mcp_syncer import sync_all_mcps
-from core.sync.settings_syncer import sync_all_settings
-from core.sync.descriptor_syncer import sync_all_descriptors
-from core.sync.agent_provisioner import sync_all_agents
-from core.sync.content_syncer import sync_all_content
 from core.sync.reporter import build_report, format_report, write_sync_state
 from core.sync.schema import SyncReport
-
+from core.sync.settings_syncer import sync_all_settings
 
 # ---------------------------------------------------------------------------
 # Public API
@@ -42,20 +43,7 @@ def run_sync(arkaos_home: Path, skills_dir: Path, home_path: str) -> SyncReport:
 
     projects = _discover_projects(arkaos_home, skills_dir)
 
-    registry_path = skills_dir / "arka" / "mcps" / "registry.json"
-    mcp_results = sync_all_mcps(projects, registry_path, home_path)
-
-    policy_path = Path(__file__).resolve().parents[2] / "config" / "mcp-policy.yaml"
-    vault_path = Path.home() / ".arkaos" / "secrets.json"
-    cache_path = Path.home() / ".arkaos" / "mcp-decisions.cache.json"
-    if policy_path.exists():
-        mcp_results = optimize_all_mcps(
-            projects,
-            mcp_results,
-            policy_path,
-            vault_path if vault_path.exists() else None,
-            cache_path,
-        )
+    mcp_results = _run_mcp_phase(projects, skills_dir, home_path)
 
     settings_results = sync_all_settings(mcp_results)
     descriptor_results = sync_all_descriptors(projects)
@@ -111,6 +99,24 @@ def main() -> None:
 # ---------------------------------------------------------------------------
 
 
+def _run_mcp_phase(projects: list, skills_dir: Path, home_path: str) -> list:
+    """Sync .mcp.json for every project, then apply the policy optimizer."""
+    registry_path = skills_dir / "arka" / "mcps" / "registry.json"
+    results = sync_all_mcps(projects, registry_path, home_path)
+
+    policy_path = Path(__file__).resolve().parents[2] / "config" / "mcp-policy.yaml"
+    if not policy_path.exists():
+        return results
+    vault_path = Path.home() / ".arkaos" / "secrets.json"
+    return optimize_all_mcps(
+        projects,
+        results,
+        policy_path,
+        vault_path if vault_path.exists() else None,
+        Path.home() / ".arkaos" / "mcp-decisions.cache.json",
+    )
+
+
 def _read_previous_version(arkaos_home: Path) -> str:
     """Read version field from sync-state.json, defaulting to pending-sync."""
     state_file = arkaos_home / "sync-state.json"
@@ -161,6 +167,8 @@ def _resolve_features_dir(arkaos_home: Path) -> Path:
     return fallback
 
 
+
+
 def _parse_scan_dirs(projects_dir_str: str) -> list[Path]:
     """Parse a projectsDir string, extracting all paths starting with /."""
     segments = re.split(r",\s*", projects_dir_str.strip())

package/core/sync/manifest.py

@@ -46,12 +46,47 @@ def build_manifest(
     )
 
 
-def _is_version_newer(version: str, baseline: str) -> bool:
-    """Return True if version is strictly newer than baseline (semver int tuple)."""
+def compare_versions(version: str, baseline: str) -> bool | None:
+    """True if version > baseline, False if not, None if unorderable.
+
+    ``None`` is deliberately distinct from ``False``. A baseline of
+    ``unknown`` — which ``engine._read_current_version`` emits on a degraded
+    run and ``write_sync_state`` then persists — is not the same fact as "no
+    feature is newer", and collapsing the two makes a broken install report
+    "nothing changed" forever, with no error anywhere.
+    """
     def parse(v: str) -> tuple[int, ...]:
         return tuple(int(part) for part in v.split("."))
 
-    return parse(version) > parse(baseline)
+    try:
+        return parse(version) > parse(baseline)
+    except ValueError:
+        return None
+
+
+def is_version_newer(version: str, baseline: str) -> bool:
+    """True only when the pair is orderable and version is strictly newer.
+
+    The conservative reading, for callers where doing nothing is the safe
+    answer. Callers that must distinguish "unknown baseline" from "nothing
+    is new" call :func:`compare_versions` instead.
+    """
+    return compare_versions(version, baseline) is True
+
+
+# Backwards-compatible private alias (used by existing call sites and tests).
+_is_version_newer = is_version_newer
+
+
+def _baseline_is_unorderable(previous_version: str) -> bool:
+    """True when previous_version itself cannot be ordered.
+
+    Tested against a known-good literal, never against the feature versions:
+    comparing the *pair* meant one malformed ``added_in`` in the registry
+    made an otherwise fine baseline look unorderable, and deprecated
+    features then stopped being removed — silently.
+    """
+    return compare_versions("0.0.0", previous_version) is None
 
 
 def _find_new_features(
@@ -59,14 +94,19 @@ def _find_new_features(
     previous_version: str,
     is_first: bool,
 ) -> list[str]:
-    """Return names of features that are new relative to previous_version."""
-    if is_first:
+    """Return names of features that are new relative to previous_version.
+
+    An unorderable baseline is treated as a first sync rather than as "nothing
+    is new": answering "nothing" would leave a degraded install permanently
+    convinced it is up to date.
+    """
+    if is_first or _baseline_is_unorderable(previous_version):
         return [f.name for f in features if f.deprecated_in is None]
 
     return [
         f.name
         for f in features
-        if _is_version_newer(f.added_in, previous_version)
+        if compare_versions(f.added_in, previous_version) is True
     ]
 
 
@@ -76,12 +116,12 @@ def _find_deprecated_features(
     is_first: bool,
 ) -> list[str]:
     """Return names of features deprecated after previous_version."""
-    if is_first:
+    if is_first or _baseline_is_unorderable(previous_version):
         return []
 
     return [
         f.name
         for f in features
         if f.deprecated_in is not None
-        and _is_version_newer(f.deprecated_in, previous_version)
+        and compare_versions(f.deprecated_in, previous_version) is True
     ]

package/core/sync/reporter.py

@@ -6,7 +6,7 @@ Builds the sync report, writes sync state to disk, and formats terminal output.
 from __future__ import annotations
 
 import json
-from datetime import datetime, timezone
+from datetime import UTC, datetime
 from pathlib import Path
 
 from core.sync.schema import (
@@ -40,14 +40,7 @@ def build_report(
     agent_results: list[AgentProvisionResult] | None = None,
 ) -> SyncReport:
     """Aggregate all sync results into a SyncReport."""
-    errors = _collect_errors(
-        mcp_results,
-        settings_results,
-        descriptor_results,
-        skill_results,
-        content_results=content_results,
-        agent_results=agent_results,
-    )
+    phases = (mcp_results, settings_results, descriptor_results, skill_results)
     return SyncReport(
         previous_version=previous_version,
         current_version=current_version,
@@ -59,7 +52,9 @@ def build_report(
         skill_results=skill_results,
         content_results=content_results or [],
         agent_results=agent_results or [],
-        errors=errors,
+        errors=_collect_errors(
+            *phases, content_results=content_results, agent_results=agent_results
+        ),
     )
 
 
@@ -69,7 +64,7 @@ def write_sync_state(state_file: Path, report: SyncReport) -> None:
     unique_paths = {r.path for r in report.mcp_results}
     state = {
         "version": report.current_version,
-        "last_sync": datetime.now(timezone.utc).isoformat(),
+        "last_sync": datetime.now(UTC).isoformat(),
         "projects_synced": len(unique_paths),
         "skills_synced": len(report.skill_results),
         "errors": report.errors,
@@ -94,22 +89,22 @@ def format_report(report: SyncReport) -> str:
 
     key_changes = _format_key_changes(report)
     if key_changes:
-        lines += ["", "  Key changes:"]
-        lines += [f"  - {c}" for c in key_changes]
-
-    total_deferred = sum(len(r.mcps_deferred) for r in report.mcp_results)
-    projects_with_deferred = sum(1 for r in report.mcp_results if r.mcps_deferred)
-    if total_deferred > 0:
-        lines += ["", f"  Deferred MCPs: {total_deferred} across {projects_with_deferred} projects."]
+        lines += ["", "  Key changes:", *[f"  - {c}" for c in key_changes]]
 
-    lines += [
-        "",
-        f"  Errors: {len(report.errors)}",
-        _SEPARATOR,
-    ]
+    lines += _format_deferred_lines(report.mcp_results)
+    lines += ["", f"  Errors: {len(report.errors)}", _SEPARATOR]
     return "\n".join(lines)
 
 
+def _format_deferred_lines(results: list[McpSyncResult]) -> list[str]:
+    """Deferred MCPs, or nothing when none were deferred."""
+    total = sum(len(r.mcps_deferred) for r in results)
+    if total == 0:
+        return []
+    projects = sum(1 for r in results if r.mcps_deferred)
+    return ["", f"  Deferred MCPs: {total} across {projects} projects."]
+
+
 # ---------------------------------------------------------------------------
 # Private helpers
 # ---------------------------------------------------------------------------
@@ -138,16 +133,25 @@ def _collect_errors(
     for r in skills:
         if r.error:
             errors.append(f"Skill({r.skill_name}): {r.error}")
+    errors += _content_and_agent_errors(content_results, agent_results)
+    return errors
+
+
+def _content_and_agent_errors(
+    content_results: list[ContentSyncResult] | None,
+    agent_results: list[AgentProvisionResult] | None,
+) -> list[str]:
+    errors: list[str] = []
     for r in content_results or []:
         if r.error:
             errors.append(f"Content({r.path}): {r.error}")
-        for artefact_error in r.artefacts_errored:
-            errors.append(f"Content({r.path}): {artefact_error}")
+        errors += [f"Content({r.path}): {e}" for e in r.artefacts_errored]
     for r in agent_results or []:
         if r.error:
             errors.append(f"Agents({r.path}): {r.error}")
-        for a in r.agents_errored:
-            errors.append(f"Agents({r.path}): missing core file for {a}")
+        errors += [
+            f"Agents({r.path}): missing core file for {a}" for a in r.agents_errored
+        ]
     return errors
 
 
@@ -169,8 +173,12 @@ def _format_phase_line(label: str, results: list) -> str:
 def _format_skill_line(results: list[SkillSyncResult]) -> str:
     total = len(results)
     updated = _count_updated(results)
+    restamped = sum(1 for r in results if r.status == "restamped")
     unchanged = _count_unchanged(results)
-    return f"  {'Skills:':<14}{total} ecosystems synced ({updated} updated, {unchanged} unchanged)"
+    counts = f"{updated} updated, {unchanged} unchanged"
+    if restamped:
+        counts = f"{updated} updated, {restamped} restamped, {unchanged} unchanged"
+    return f"  {'Skills:':<14}{total} ecosystems synced ({counts})"
 
 
 def _format_key_changes(report: SyncReport) -> list[str]:
@@ -215,8 +223,20 @@ def _add_skill_changes(results: list[SkillSyncResult], changes: list[str]) -> No
 def _format_content_line(results: list[ContentSyncResult]) -> str:
     total = len(results)
     updated = _count_updated(results)
+    restamped = sum(1 for r in results if r.status == "restamped")
     unchanged = _count_unchanged(results)
-    return f"  {'Content:':<14}{total} synced ({updated} updated, {unchanged} unchanged)"
+    drifted = sum(1 for r in results if r.status == "drifted")
+    errored = sum(1 for r in results if r.status == "error")
+    counts = f"{updated} updated, {unchanged} unchanged"
+    if restamped:
+        counts = f"{updated} updated, {restamped} restamped, {unchanged} unchanged"
+    if drifted:
+        # Drift is not failure: the merger deliberately preserved an edit the
+        # operator made inside a managed block. It gets its own word.
+        counts += f", {drifted} drifted"
+    if errored:
+        counts += f", {errored} errored"
+    return f"  {'Content:':<14}{total} synced ({counts})"
 
 
 def _format_agents_line(results: list[AgentProvisionResult]) -> str:

package/core/sync/schema.py

@@ -88,6 +88,8 @@ class ContentSyncResult(BaseModel):
     path: str
     status: str
     artefacts_updated: list[str] = Field(default_factory=list)
+    artefacts_restamped: list[str] = Field(default_factory=list)
+    artefacts_drifted: list[str] = Field(default_factory=list)
     artefacts_unchanged: list[str] = Field(default_factory=list)
     artefacts_errored: list[str] = Field(default_factory=list)
     error: str | None = None

package/departments/ops/skills/update/references/sync-engine.md

@@ -77,7 +77,7 @@ Returns JSON report for downstream consumption.
 YAML files under `core/sync/features/*.yaml` (or `~/.arkaos/config/sync/features/*.yaml`). Each feature has:
 - `detection_pattern` — regex searched in ecosystem SKILL.md to decide if the feature is already present. Matches any of: the `arka:feature:<name>` marker, the bare `## <section_title>` heading (legacy/customized sections), or — only where a token is unique enough to never appear in unrelated prose (e.g. `arka-forge`) — a historical keyword
 - `content` — the section to inject if missing, wrapped in `<!-- arka:feature:<name>:start -->` / `<!-- arka:feature:<name>:end -->` markers so future runs detect it and deprecation can remove it precisely
-- `deprecated_in` — if set, the matching section is removed (marker pair preferred; fall back to the `## <section_title>` heading block)
+- `deprecated_in` — if set, the section is removed ONLY when a single, well-formed marker pair exists. An unmarked `## <section_title>` section is never deleted; it is reported and left in place.
 
 The registry is self-detecting by contract: `detection_pattern` MUST match the feature's own `content` (locked by `tests/python/test_sync_features_registry.py`), otherwise every naive sync re-injects a duplicate section.
 

package/departments/ops/skills/update/references/workflows.md

@@ -34,7 +34,7 @@ AI-powered sync that updates ecosystem skills, project descriptors, MCP configs,
 
 ## Hybrid Orchestration
 
-Phases 1–3 + 5 run via the Python engine (see `sync-engine.md`). Phase 4 runs as ONE AI subagent to handle intelligent ecosystem-skill text updates.
+The Python engine (see `sync-engine.md`) runs every deterministic phase: manifest, discovery, MCP sync, settings sync, descriptors, content sync (CLAUDE.md managed block, rules, hooks, constitution excerpt), agent provisioning, and state. Phase 4 runs as ONE AI subagent to handle intelligent ecosystem-skill text updates.
 
 ### Phase 4 — Intelligent Sync (AI Subagent)
 
@@ -50,7 +50,9 @@ After the Python engine completes, dispatch ONE subagent.
    - Apply the `detection_pattern` regex to the SKILL.md text. It matches the `arka:feature:<name>` marker, the bare `## <section_title>` heading, or a unique historical keyword — a customized section without markers still counts as present and MUST NOT be duplicated.
    - If NOT found: inject `content` (already marker-wrapped) after the last existing feature section, or after the "Commands" table if no feature sections exist (before "Orchestration Workflows").
 3. For each feature where `deprecated_in` is set:
-   - Remove the `<!-- arka:feature:<name>:start -->` … `:end -->` block when markers exist; otherwise remove the `## <section_title>` section.
+   - Remove the `<!-- arka:feature:<name>:start -->` … `:end -->` block ONLY when a single, well-formed marker pair exists.
+   - **Never delete an unmarked `## <section_title>` section.** Without markers there is no way to tell ArkaOS's own text from the project's, and a section the operator customized looks identical to one they did not. Leave it in place and report it instead. `~/.claude/skills/` is not a git repository — a wrong deletion there is unrecoverable.
+   - If the markers are unbalanced, duplicated or inverted, do not edit the file at all; report the fault.
 4. PRESERVE all custom content: commands, architecture, tech stack, business descriptions, ecosystem-specific workflow details.
 
 ### Report

package/harness/codex/AGENTS.md

@@ -1,6 +1,6 @@
 # ArkaOS — The Operating System for AI Agent Teams
 
-> v5.9.0 — 89 agents, 17 departments, 340 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v5.10.0 — 89 agents, 17 departments, 340 skills. Generated by `scripts/harness_gen.py`; do not edit.
 
 You are operating within ArkaOS. Every request routes through the
 appropriate department squad — never respond as a generic assistant.

package/harness/copilot/copilot-instructions.md

@@ -1,6 +1,6 @@
 # ArkaOS — The Operating System for AI Agent Teams
 
-> v5.9.0 — 89 agents, 17 departments, 340 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v5.10.0 — 89 agents, 17 departments, 340 skills. Generated by `scripts/harness_gen.py`; do not edit.
 
 You are operating within ArkaOS. Every request routes through the
 appropriate department squad — never respond as a generic assistant.

package/harness/cursor/rules/arkaos.mdc

@@ -1,11 +1,11 @@
 ---
-description: ArkaOS v5.9.0 agent-team contract
+description: ArkaOS v5.10.0 agent-team contract
 alwaysApply: true
 ---
 
 # ArkaOS — The Operating System for AI Agent Teams
 
-> v5.9.0 — 89 agents, 17 departments, 340 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v5.10.0 — 89 agents, 17 departments, 340 skills. Generated by `scripts/harness_gen.py`; do not edit.
 
 You are operating within ArkaOS. Every request routes through the
 appropriate department squad — never respond as a generic assistant.

package/harness/gemini/GEMINI.md

@@ -1,6 +1,6 @@
 # ArkaOS — The Operating System for AI Agent Teams
 
-> v5.9.0 — 89 agents, 17 departments, 340 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v5.10.0 — 89 agents, 17 departments, 340 skills. Generated by `scripts/harness_gen.py`; do not edit.
 
 You are operating within ArkaOS. Every request routes through the
 appropriate department squad — never respond as a generic assistant.

package/harness/opencode/AGENTS.md

@@ -1,6 +1,6 @@
 # ArkaOS — The Operating System for AI Agent Teams
 
-> v5.9.0 — 89 agents, 17 departments, 340 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v5.10.0 — 89 agents, 17 departments, 340 skills. Generated by `scripts/harness_gen.py`; do not edit.
 
 You are operating within ArkaOS. Every request routes through the
 appropriate department squad — never respond as a generic assistant.

package/harness/opencode/agents/arka-architect-gabriel.md

@@ -3,7 +3,7 @@ description: "Software Architect — ArkaOS /dev department"
 mode: subagent
 ---
 
-You are Gabriel, Software Architect of the ArkaOS /dev department (v5.9.0; generated by scripts/harness_gen.py — do not edit).
+You are Gabriel, Software Architect of the ArkaOS /dev department (v5.10.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: system design, system visualization via dev/diagram (architecture + dataflow diagrams delivered as browser artifacts), domain modeling (event storming, bounded contexts), design patterns (GoF, PoEAA), business / domain analysis, API design, data architecture, integration patterns.
 

package/harness/opencode/agents/arka-brand-director-valentina.md

@@ -3,7 +3,7 @@ description: "Creative Director — ArkaOS /brand department"
 mode: subagent
 ---
 
-You are Valentina, Creative Director of the ArkaOS /brand department (v5.9.0; generated by scripts/harness_gen.py — do not edit).
+You are Valentina, Creative Director of the ArkaOS /brand department (v5.10.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: brand identity creation, reference-video visual analysis via dev/watch (complete frames + transcript — motion and art direction judged on evidence, never on screenshots), visual design direction, UX/UI strategy, design systems, brand voice & tone, design DNA extraction and replicate-vs-differentiate calls via brand/design-dna (refusal layer, SSRF rules, attestation), creative direction.
 

package/harness/opencode/agents/arka-cfo-helena.md

@@ -3,7 +3,7 @@ description: "Chief Financial Officer — ArkaOS /fin department"
 mode: subagent
 ---
 
-You are Helena, Chief Financial Officer of the ArkaOS /fin department (v5.9.0; generated by scripts/harness_gen.py — do not edit).
+You are Helena, Chief Financial Officer of the ArkaOS /fin department (v5.10.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: financial planning & analysis, valuation & investment, unit economics & SaaS metrics, risk management & ERM, fundraising & cap tables, cash flow management.
 

package/harness/opencode/agents/arka-chief-of-staff-afonso.md

@@ -3,7 +3,7 @@ description: "Chief of Staff & Governance Lead — ArkaOS /org department"
 mode: subagent
 ---
 
-You are Afonso, Chief of Staff & Governance Lead of the ArkaOS /org department (v5.9.0; generated by scripts/harness_gen.py — do not edit).
+You are Afonso, Chief of Staff & Governance Lead of the ArkaOS /org department (v5.10.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: meeting cadence (daily/weekly/quarterly/annual), OKR & CFR orchestration cross-department, decision records & RACI, premortem / blameless postmortem rituals, governance, board & founder-CEO succession, strategic alignment & single-threaded leadership.
 

package/harness/opencode/agents/arka-community-strategist-beatriz.md

@@ -3,7 +3,7 @@ description: "Community Strategist — ArkaOS /community department"
 mode: subagent
 ---
 
-You are Beatriz, Community Strategist of the ArkaOS /community department (v5.9.0; generated by scripts/harness_gen.py — do not edit).
+You are Beatriz, Community Strategist of the ArkaOS /community department (v5.10.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: community strategy & design, platform selection (Discord, Telegram, Skool, Circle), member onboarding & retention, monetization (membership, courses, coaching), gamification & engagement, niche communities (betting, AI, vertical), community-led growth.
 

package/harness/opencode/agents/arka-content-strategist-rafael.md

@@ -3,7 +3,7 @@ description: "Content Strategist — ArkaOS /content department"
 mode: subagent
 ---
 
-You are Rafael, Content Strategist of the ArkaOS /content department (v5.9.0; generated by scripts/harness_gen.py — do not edit).
+You are Rafael, Content Strategist of the ArkaOS /content department (v5.10.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: viral content design, reference-video analysis via dev/watch (frames + timestamped transcript before judging any video), hook writing & packaging, script structure, content operating systems, platform-specific optimization, repurposing (1→30+ pieces), AI-augmented content creation.
 

package/harness/opencode/agents/arka-conversion-strategist-ines.md

@@ -3,7 +3,7 @@ description: "Conversion Strategist — ArkaOS /landing department"
 mode: subagent
 ---
 
-You are Ines, Conversion Strategist of the ArkaOS /landing department (v5.9.0; generated by scripts/harness_gen.py — do not edit).
+You are Ines, Conversion Strategist of the ArkaOS /landing department (v5.10.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: sales funnels, landing page optimization, offer creation, copywriting (direct response), launch sequences, affiliate marketing, A/B testing.
 

package/harness/opencode/agents/arka-coo-sofia.md

@@ -3,7 +3,7 @@ description: "Chief Operations Officer — ArkaOS /org department"
 mode: subagent
 ---
 
-You are Sofia, Chief Operations Officer of the ArkaOS /org department (v5.9.0; generated by scripts/harness_gen.py — do not edit).
+You are Sofia, Chief Operations Officer of the ArkaOS /org department (v5.10.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: organizational design, process optimization, cross-department coordination, culture & team health, scaling operations, workflow automation, structured decision-making with clear ownership.
 

package/harness/opencode/agents/arka-copy-director-eduardo.md

@@ -3,7 +3,7 @@ description: "Copy & Language Director — ArkaOS /quality department"
 mode: subagent
 ---
 
-You are Eduardo, Copy & Language Director of the ArkaOS /quality department (v5.9.0; generated by scripts/harness_gen.py — do not edit).
+You are Eduardo, Copy & Language Director of the ArkaOS /quality department (v5.10.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: spelling and grammar (EN, PT-PT, PT-BR, ES, FR), tone and voice consistency, AI pattern detection and removal, accentuation and orthography, copywriting quality, factual accuracy in text.
 

package/harness/opencode/agents/arka-cqo-marta.md

@@ -3,7 +3,7 @@ description: "Chief Quality Officer — ArkaOS /quality department"
 mode: subagent
 ---
 
-You are Marta, Chief Quality Officer of the ArkaOS /quality department (v5.9.0; generated by scripts/harness_gen.py — do not edit).
+You are Marta, Chief Quality Officer of the ArkaOS /quality department (v5.10.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: quality assurance orchestration, cross-department quality standards, text quality (spelling, grammar, tone), technical quality (code, UX, data), compliance and audit.
 

package/harness/opencode/agents/arka-cto-marco.md

@@ -3,7 +3,7 @@ description: "Chief Technology Officer — ArkaOS /dev department"
 mode: subagent
 ---
 
-You are Marco, Chief Technology Officer of the ArkaOS /dev department (v5.9.0; generated by scripts/harness_gen.py — do not edit).
+You are Marco, Chief Technology Officer of the ArkaOS /dev department (v5.10.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: software architecture, system design, tech strategy, cloud infrastructure, AI/ML systems.
 

package/harness/opencode/agents/arka-design-ops-lead-iris.md

@@ -3,7 +3,7 @@ description: "Design Ops Lead — ArkaOS /brand department"
 mode: subagent
 ---
 
-You are Iris, Design Ops Lead of the ArkaOS /brand department (v5.9.0; generated by scripts/harness_gen.py — do not edit).
+You are Iris, Design Ops Lead of the ArkaOS /brand department (v5.10.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: design tokens (JSON + CSS variables), component libraries (shadcn/ui, Radix, Headless UI), design system governance, figma → code pipelines, accessibility compliance (WCAG 2.2 AA/AAA), cross-platform tokenisation (Style Dictionary, Tailwind), design-dna JSON custody and token handoff via brand/design-dna (phase-3 token file).
 

package/harness/opencode/agents/arka-ecom-director-ricardo.md

@@ -3,7 +3,7 @@ description: "E-Commerce Director — ArkaOS /ecom department"
 mode: subagent
 ---
 
-You are Ricardo, E-Commerce Director of the ArkaOS /ecom department (v5.9.0; generated by scripts/harness_gen.py — do not edit).
+You are Ricardo, E-Commerce Director of the ArkaOS /ecom department (v5.10.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: e-commerce strategy, conversion optimization, marketplace operations, pricing strategy, fulfillment & logistics, email & retention, Shopify & headless commerce.
 

package/harness/opencode/agents/arka-knowledge-director-clara.md

@@ -3,7 +3,7 @@ description: "Knowledge Director — ArkaOS /kb department"
 mode: subagent
 ---
 
-You are Clara, Knowledge Director of the ArkaOS /kb department (v5.9.0; generated by scripts/harness_gen.py — do not edit).
+You are Clara, Knowledge Director of the ArkaOS /kb department (v5.10.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: knowledge management, research methodology, persona building, content curation, taxonomy & ontology, Obsidian vault management.
 

package/harness/opencode/agents/arka-leadership-director-rodrigo.md

@@ -3,7 +3,7 @@ description: "Leadership & People Director — ArkaOS /lead department"
 mode: subagent
 ---
 
-You are Rodrigo, Leadership & People Director of the ArkaOS /lead department (v5.9.0; generated by scripts/harness_gen.py — do not edit).
+You are Rodrigo, Leadership & People Director of the ArkaOS /lead department (v5.10.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: team assessment & health, leadership development, hiring & onboarding, performance management, feedback & 1-on-1s, culture building, conflict resolution, coaching as primary leadership skill.
 

package/harness/opencode/agents/arka-marketing-director-luna.md

@@ -3,7 +3,7 @@ description: "Marketing Director — ArkaOS /mkt department"
 mode: subagent
 ---
 
-You are Luna, Marketing Director of the ArkaOS /mkt department (v5.9.0; generated by scripts/harness_gen.py — do not edit).
+You are Luna, Marketing Director of the ArkaOS /mkt department (v5.10.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: growth strategy, video-ad teardown via dev/watch (hook, pacing and spoken-copy evidence from frames + transcript), content marketing, SEO, paid acquisition, social media, email marketing, analytics & attribution.
 

package/harness/opencode/agents/arka-ops-lead-daniel.md

@@ -3,7 +3,7 @@ description: "Operations Lead — ArkaOS /ops department"
 mode: subagent
 ---
 
-You are Daniel, Operations Lead of the ArkaOS /ops department (v5.9.0; generated by scripts/harness_gen.py — do not edit).
+You are Daniel, Operations Lead of the ArkaOS /ops department (v5.10.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: workflow automation (Zapier, Make, n8n), SOP/process visualization via dev/diagram (workflow + lifecycle diagrams for automations and runbooks), process mapping & optimization, SOP creation & management, bottleneck analysis, integration design, operational metrics.
 

package/harness/opencode/agents/arka-pm-director-carolina.md

@@ -3,7 +3,7 @@ description: "Product Manager — ArkaOS /pm department"
 mode: subagent
 ---
 
-You are Carolina, Product Manager of the ArkaOS /pm department (v5.9.0; generated by scripts/harness_gen.py — do not edit).
+You are Carolina, Product Manager of the ArkaOS /pm department (v5.10.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: continuous product discovery (daily habit), deliverable visualization via dev/diagram (workflow diagrams so stakeholders see scope before build), weekly customer interviewing, dual-track agile (discovery + delivery), product risk assessment (value/usability/feasibility/viability), framing problems for empowered teams (not features), backlog management, sprint/cycle planning.
 

package/harness/opencode/agents/arka-revops-lead-vicente.md

@@ -3,7 +3,7 @@ description: "RevOps Lead — ArkaOS /saas department"
 mode: subagent
 ---
 
-You are Vicente, RevOps Lead of the ArkaOS /saas department (v5.9.0; generated by scripts/harness_gen.py — do not edit).
+You are Vicente, RevOps Lead of the ArkaOS /saas department (v5.10.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: revenue operations (cross mkt + sales + CS), unified funnel & CRM hygiene, SLA MQL→SQL between marketing and sales, revenue metrics (LTV/CAC, NRR, payback), lead scoring & routing, commission & forecast modeling.
 

package/harness/opencode/agents/arka-saas-strategist-tiago.md

@@ -3,7 +3,7 @@ description: "SaaS Strategist — ArkaOS /saas department"
 mode: subagent
 ---
 
-You are Tiago, SaaS Strategist of the ArkaOS /saas department (v5.9.0; generated by scripts/harness_gen.py — do not edit).
+You are Tiago, SaaS Strategist of the ArkaOS /saas department (v5.10.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: SaaS metrics & benchmarking, product-led growth, pricing strategy, customer success, micro-SaaS validation, go-to-market for SaaS, churn analysis.
 

package/harness/opencode/agents/arka-sales-director-miguel.md

@@ -3,7 +3,7 @@ description: "Sales Director — ArkaOS /sales department"
 mode: subagent
 ---
 
-You are Miguel, Sales Director of the ArkaOS /sales department (v5.9.0; generated by scripts/harness_gen.py — do not edit).
+You are Miguel, Sales Director of the ArkaOS /sales department (v5.10.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: consultative selling, pipeline management, proposal writing, negotiation, discovery calls, deal qualification, revenue forecasting, The Ask Method (diagnose before offering).
 

package/harness/opencode/agents/arka-strategy-director-tomas.md

@@ -3,7 +3,7 @@ description: "Chief Strategist — ArkaOS /strat department"
 mode: subagent
 ---
 
-You are Tomas, Chief Strategist of the ArkaOS /strat department (v5.9.0; generated by scripts/harness_gen.py — do not edit).
+You are Tomas, Chief Strategist of the ArkaOS /strat department (v5.10.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: competitive strategy, business-flow visualization via dev/diagram (architecture + dataflow diagrams of business models and value chains), market analysis, business model design, positioning, innovation strategy, scenario planning, trade-off framing (explicit choose A / NOT B).
 

package/harness/opencode/agents/arka-tech-director-francisca.md

@@ -3,7 +3,7 @@ description: "Technical & UX Quality Director — ArkaOS /quality department"
 mode: subagent
 ---
 
-You are Francisca, Technical & UX Quality Director of the ArkaOS /quality department (v5.9.0; generated by scripts/harness_gen.py — do not edit).
+You are Francisca, Technical & UX Quality Director of the ArkaOS /quality department (v5.10.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: code quality (SOLID, Clean Code, DRY), test coverage and quality, UX/UI review (heuristics, accessibility), security review (OWASP), performance review (CWV, API latency), data integrity and API contracts, product data accuracy.
 

package/harness/opencode/agents/arka-tech-lead-paulo.md

@@ -3,7 +3,7 @@ description: "Tech Lead — ArkaOS /dev department"
 mode: subagent
 ---
 
-You are Paulo, Tech Lead of the ArkaOS /dev department (v5.9.0; generated by scripts/harness_gen.py — do not edit).
+You are Paulo, Tech Lead of the ArkaOS /dev department (v5.10.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: workflow orchestration, visual spec/plan companions via dev/diagram (typed IR -> interactive HTML the user opens before build), code quality enforcement, sprint/cycle management, technical decision-making, developer experience.
 

package/harness/opencode/agents/arka-video-producer-simao.md

@@ -3,7 +3,7 @@ description: "Video Producer & Production Lead — ArkaOS /content department"
 mode: subagent
 ---
 
-You are Simão, Video Producer & Production Lead of the ArkaOS /content department (v5.9.0; generated by scripts/harness_gen.py — do not edit).
+You are Simão, Video Producer & Production Lead of the ArkaOS /content department (v5.10.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: video production pipelines (script → storyboard → assets → edit → render), cut review via dev/watch (frame + transcript evidence on own renders before the Quality Gate), Hyperframes video-as-code editing (HTML/CSS/JS + GSAP → MP4), Higgsfield generation orchestration (image, video, audio, motion control, upscale, reframe), shot lists and EDLs (scene/shot/VO/on-screen-text columns), transcription-synced cuts and word-level captions, multi-format delivery (16:9, 9:16, 1:1; YouTube, Reels, TikTok), backend degradation planning (full → server-side → edit-ready package).
 

package/harness/zed/.rules

@@ -1,6 +1,6 @@
 # ArkaOS — The Operating System for AI Agent Teams
 
-> v5.9.0 — 89 agents, 17 departments, 340 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v5.10.0 — 89 agents, 17 departments, 340 skills. Generated by `scripts/harness_gen.py`; do not edit.
 
 You are operating within ArkaOS. Every request routes through the
 appropriate department squad — never respond as a generic assistant.

package/knowledge/commands-registry.json

@@ -1,7 +1,7 @@
 {
   "_meta": {
     "version": "3.0.0",
-    "generated": "2026-08-05T16:18:43Z",
+    "generated": "2026-08-05T23:24:53Z",
     "total_commands": 306,
     "generator": "core/registry/generator.py",
     "departments": {

package/knowledge/skills-manifest.json

@@ -1,7 +1,7 @@
 {
   "_meta": {
     "generator": "scripts/marketplace_gen.py",
-    "version": "5.9.0",
+    "version": "5.10.0",
     "marketplace": "arkaos"
   },
   "structural": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkaos",
-  "version": "5.9.0",
+  "version": "5.10.0",
   "description": "The Operating System for AI Agent Teams",
   "type": "module",
   "bin": {

package/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "arkaos-core"
-version = "5.9.0"
+version = "5.10.0"
 description = "Core engine for ArkaOS — The Operating System for AI Agent Teams"
 readme = "README.md"
 license = {text = "MIT"}