arkaos 5.1.0 → 5.2.0

package/CONSTITUTION.md

@@ -115,7 +115,7 @@ Level re-tiering requires explicit operator approval and a recorded
 ## Compressed Context (Synapse L0)
 
 ```
-[Constitution] NON-NEGOTIABLE: branch-isolation, security-gate, mandatory-qa, evidence-flow, arkaos-not-yes-man, excellence-mandate | QUALITY-GATE: marta-cqo, eduardo-copy, francisca-tech-ux | MUST (28) incl.: squad-routing, spec-driven, conventional-commits, test-coverage, subagent-discipline, persona-vs-artifact
+[Constitution] NON-NEGOTIABLE: branch-isolation, security-gate, mandatory-qa, evidence-flow, arkaos-not-yes-man, excellence-mandate | QUALITY-GATE: marta-cqo, eduardo-copy, francisca-tech-ux | MUST (29) incl.: squad-routing, spec-driven, conventional-commits, test-coverage, subagent-discipline, persona-vs-artifact
 ```
 
 ---

package/THE-ARKAOS-GUIDE.md

@@ -1,6 +1,6 @@
 # The ArkaOS Guide
 
-> v5.1.0 — 89 agents, 17 departments, 333 skills, 298 commands, 19 ADRs.
+> v5.2.0 — 89 agents, 17 departments, 333 skills, 298 commands, 19 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.1.0
+5.2.0

package/arka/skills/comfyui/SKILL.md

@@ -82,7 +82,7 @@ The Forge for multi-agent planning before execution.
 - Phase 0.5: Forge analysis (after spec creation, before squad planning)
 - Complexity assessment: automatic via Synapse L8 (ForgeContextLayer)
 - Manual invocation: `/forge` command
-- Handoff: Forge outputs structured plan -> squad executes phases
+- Handoff: Forge outputs structured plan → squad executes phases
 <!-- arka:feature:forge-integration:end -->
 
 <!-- arka:feature:quality-gate:start -->
@@ -115,7 +115,7 @@ Three workflow tiers based on task complexity:
 | Tier | Phases | When |
 |------|--------|------|
 | Enterprise | 7-10 phases | Complex features, multi-file changes |
-| Focused | 3-5 phases | Medium tasks, single-domain changes |
+| Focused | 3-4 phases | Medium tasks, single-domain changes |
 | Specialist | 1-2 phases | Simple tasks, quick fixes |
 
 Tier selection is automatic based on complexity assessment.

package/core/governance/evidence_checks.py

@@ -323,6 +323,12 @@ def _check_lint(
     project_dir: Path, changed: list[str] | None,
     test_command: str | None, timeout: int,
 ) -> CheckResult:
+    if changed is not None and not changed:
+        # A KNOWN-empty diff must not inherit the project-wide baseline:
+        # a zero-write deliverable was gated on master's pre-existing
+        # ruff debt (QG 2026-08-04). None still means "scope unknown"
+        # and keeps the project-wide run.
+        return _skip("lint", "no changed files (empty diff)")
     if changed:
         scoped = _lint_scoped(project_dir, changed, timeout)
         if scoped is not None:
@@ -371,6 +377,11 @@ def _check_typecheck(
     project_dir: Path, changed: list[str] | None,
     test_command: str | None, timeout: int,
 ) -> CheckResult:
+    if changed is not None and not changed:
+        # Same zero-diff contract as lint: mypy/tsc run project-wide and
+        # never read the diff, so a known-empty diff would inherit
+        # master's type debt the moment tooling is configured.
+        return _skip("typecheck", "no changed files (empty diff)")
     if _mypy_configured(project_dir) and shutil.which("mypy"):
         return _run("typecheck", ["mypy", "."], project_dir, timeout)
     if (project_dir / "tsconfig.json").is_file():
@@ -1024,8 +1035,10 @@ def _build_parser() -> argparse.ArgumentParser:
 
 
 def _csv(value: str | None) -> list[str] | None:
-    if not value:
+    if value is None:
         return None
+    # `--changed-files ""` is a KNOWN-empty diff and maps to [] so the
+    # zero-diff skip fires; an omitted flag stays None (scope unknown).
     return [item.strip() for item in value.split(",") if item.strip()]
 
 

package/core/sync/features/forge.yaml

@@ -2,7 +2,7 @@ name: forge-integration
 added_in: "2.14.0"
 mandatory: true
 section_title: "Forge Integration"
-detection_pattern: "arka:feature:forge-integration|## Forge Integration|arka-forge"
+detection_pattern: "arka:feature:forge-integration|## Forge Integration|arka-forge(?![\\w-])"
 deprecated_in: null
 content: |
   <!-- arka:feature:forge-integration:start -->

package/core/sync/features/spec-gate.yaml

@@ -2,7 +2,7 @@ name: spec-driven-gate
 added_in: "2.13.0"
 mandatory: true
 section_title: "Spec-Driven Development"
-detection_pattern: "arka:feature:spec-driven-gate|## Spec-Driven Development|arka-spec"
+detection_pattern: "arka:feature:spec-driven-gate|## Spec-Driven Development|arka-spec(?![\\w-])"
 deprecated_in: null
 content: |
   <!-- arka:feature:spec-driven-gate:start -->

package/core/sync/features/workflow-tiers.yaml

@@ -13,7 +13,7 @@ content: |
   | Tier | Phases | When |
   |------|--------|------|
   | Enterprise | 7-10 phases | Complex features, multi-file changes |
-  | Focused | 3-5 phases | Medium tasks, single-domain changes |
+  | Focused | 3-4 phases | Medium tasks, single-domain changes |
   | Specialist | 1-2 phases | Simple tasks, quick fixes |
 
   Tier selection is automatic based on complexity assessment.

package/departments/brand/SKILL.md

@@ -2,7 +2,7 @@
 name: arka-brand
 description: >
   Brand & Design department. Full brand identity creation, UX/UI design, design systems,
-  visual identity, and brand strategy. 4-agent team applying Primal Branding, StoryBrand,
+  visual identity, and brand strategy. 10-agent team applying Primal Branding, StoryBrand,
   12 Archetypes, Nielsen Heuristics, Atomic Design, and Dieter Rams principles.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---

package/departments/dev/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: arka-dev
 description: >
-  Full-stack development department. Enterprise-grade 9-agent team with structured
+  Full-stack development department. Enterprise-grade 15-agent team with structured
   multi-phase workflows. Implements features, APIs, reviews code, manages architecture,
   security audits, CI/CD, database design, and AI-assisted development.
   Frameworks: Clean Architecture, DDD, TDD, DORA Metrics, OWASP Top 10.

package/harness/codex/AGENTS.md

@@ -1,6 +1,6 @@
 # ArkaOS — The Operating System for AI Agent Teams
 
-> v5.1.0 — 89 agents, 17 departments, 333 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v5.2.0 — 89 agents, 17 departments, 333 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.1.0 — 89 agents, 17 departments, 333 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v5.2.0 — 89 agents, 17 departments, 333 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.1.0 agent-team contract
+description: ArkaOS v5.2.0 agent-team contract
 alwaysApply: true
 ---
 
 # ArkaOS — The Operating System for AI Agent Teams
 
-> v5.1.0 — 89 agents, 17 departments, 333 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v5.2.0 — 89 agents, 17 departments, 333 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.1.0 — 89 agents, 17 departments, 333 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v5.2.0 — 89 agents, 17 departments, 333 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.1.0 — 89 agents, 17 departments, 333 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v5.2.0 — 89 agents, 17 departments, 333 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.1.0; generated by scripts/harness_gen.py — do not edit).
+You are Gabriel, Software Architect of the ArkaOS /dev department (v5.2.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.
 

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.1.0; generated by scripts/harness_gen.py — do not edit).
+You are Valentina, Creative Director of the ArkaOS /brand department (v5.2.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.
 

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.1.0; generated by scripts/harness_gen.py — do not edit).
+You are Helena, Chief Financial Officer of the ArkaOS /fin department (v5.2.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.1.0; generated by scripts/harness_gen.py — do not edit).
+You are Afonso, Chief of Staff & Governance Lead of the ArkaOS /org department (v5.2.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.1.0; generated by scripts/harness_gen.py — do not edit).
+You are Beatriz, Community Strategist of the ArkaOS /community department (v5.2.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).
 

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.1.0; generated by scripts/harness_gen.py — do not edit).
+You are Rafael, Content Strategist of the ArkaOS /content department (v5.2.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.
 

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.1.0; generated by scripts/harness_gen.py — do not edit).
+You are Ines, Conversion Strategist of the ArkaOS /landing department (v5.2.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.
 

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.1.0; generated by scripts/harness_gen.py — do not edit).
+You are Sofia, Chief Operations Officer of the ArkaOS /org department (v5.2.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.
 

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.1.0; generated by scripts/harness_gen.py — do not edit).
+You are Eduardo, Copy & Language Director of the ArkaOS /quality department (v5.2.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.1.0; generated by scripts/harness_gen.py — do not edit).
+You are Marta, Chief Quality Officer of the ArkaOS /quality department (v5.2.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.1.0; generated by scripts/harness_gen.py — do not edit).
+You are Marco, Chief Technology Officer of the ArkaOS /dev department (v5.2.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.1.0; generated by scripts/harness_gen.py — do not edit).
+You are Iris, Design Ops Lead of the ArkaOS /brand department (v5.2.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).
 

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.1.0; generated by scripts/harness_gen.py — do not edit).
+You are Ricardo, E-Commerce Director of the ArkaOS /ecom department (v5.2.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: e-commerce strategy, conversion optimization, marketplace operations, pricing strategy, fulfillment & logistics, email & retention.
 

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.1.0; generated by scripts/harness_gen.py — do not edit).
+You are Clara, Knowledge Director of the ArkaOS /kb department (v5.2.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.1.0; generated by scripts/harness_gen.py — do not edit).
+You are Rodrigo, Leadership & People Director of the ArkaOS /lead department (v5.2.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.
 

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.1.0; generated by scripts/harness_gen.py — do not edit).
+You are Luna, Marketing Director of the ArkaOS /mkt department (v5.2.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.
 

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.1.0; generated by scripts/harness_gen.py — do not edit).
+You are Daniel, Operations Lead of the ArkaOS /ops department (v5.2.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.
 

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.1.0; generated by scripts/harness_gen.py — do not edit).
+You are Carolina, Product Manager of the ArkaOS /pm department (v5.2.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).
 

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.1.0; generated by scripts/harness_gen.py — do not edit).
+You are Vicente, RevOps Lead of the ArkaOS /saas department (v5.2.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.1.0; generated by scripts/harness_gen.py — do not edit).
+You are Tiago, SaaS Strategist of the ArkaOS /saas department (v5.2.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.
 

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.1.0; generated by scripts/harness_gen.py — do not edit).
+You are Miguel, Sales Director of the ArkaOS /sales department (v5.2.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: consultative selling, pipeline management, proposal writing, negotiation, discovery calls, deal qualification.
 

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.1.0; generated by scripts/harness_gen.py — do not edit).
+You are Tomas, Chief Strategist of the ArkaOS /strat department (v5.2.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.
 

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.1.0; generated by scripts/harness_gen.py — do not edit).
+You are Francisca, Technical & UX Quality Director of the ArkaOS /quality department (v5.2.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.
 

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.1.0; generated by scripts/harness_gen.py — do not edit).
+You are Paulo, Tech Lead of the ArkaOS /dev department (v5.2.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.1.0; generated by scripts/harness_gen.py — do not edit).
+You are Simão, Video Producer & Production Lead of the ArkaOS /content department (v5.2.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.
 

package/harness/zed/.rules

@@ -1,6 +1,6 @@
 # ArkaOS — The Operating System for AI Agent Teams
 
-> v5.1.0 — 89 agents, 17 departments, 333 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v5.2.0 — 89 agents, 17 departments, 333 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/installer/claude-md.js

@@ -17,8 +17,8 @@
 
 import { createHash } from "node:crypto";
 import {
-  copyFileSync, existsSync, mkdirSync, readFileSync, realpathSync,
-  renameSync, writeFileSync,
+  chmodSync, copyFileSync, existsSync, lstatSync, mkdirSync, readFileSync,
+  realpathSync, renameSync, statSync, writeFileSync,
 } from "node:fs";
 import { join, dirname } from "node:path";
 
@@ -121,18 +121,55 @@ function planBlockReplace(existing, template, markers) {
   return { action: "replace-block", content };
 }
 
+// Temp names are PID-scoped so concurrent processes cannot collide on
+// the same temp path. Exported so the tests can assert the scoping
+// behaviourally — the name is unobservable after the rename.
+export function tempPathFor(real, pid = process.pid) {
+  return `${real}.arkaos-tmp-${pid}`;
+}
+
 // A crash mid-write must never leave a truncated CLAUDE.md, and a
 // symlinked file must keep pointing at its target — renaming onto the
 // LINK would replace the link itself (the C3 remediation lesson), so
 // the write lands on the resolved path. Known trade-off of temp+rename:
 // a HARD-linked twin keeps the old inode's content.
+// The rename carries the temp file's mode with it. When a file is
+// being REPLACED, the temp starts at 0600 (never readable by group or
+// other) and is chmod-ed to the existing file's mode before the rename
+// — a 0600 CLAUDE.md must not come back 0644 (CWE-732, C5 register
+// M1). A FRESH file is written plainly so the operator's umask applies
+// exactly as master's writeFileSync did — a hard-coded 0644 here
+// WIDENED a umask-077 operator's file (QG r1, Francisca B1).
 function writeAtomic(target, content) {
   const real = existsSync(target) ? realpathSync(target) : target;
-  const tmp = `${real}.arkaos-tmp-${process.pid}`;
-  writeFileSync(tmp, content);
+  const existingMode = existsSync(real) ? statSync(real).mode & 0o7777 : null;
+  const tmp = tempPathFor(real);
+  if (existingMode === null) {
+    writeFileSync(tmp, content);
+  } else {
+    writeFileSync(tmp, content, { mode: 0o600 });
+    chmodSync(tmp, existingMode);
+  }
   renameSync(tmp, real);
 }
 
+// existsSync FOLLOWS symlinks, so a dangling link reads as "no file
+// here" and the create path would silently replace the link itself
+// with a regular file (C5 register M3). lstat sees the link; refuse
+// and leave it exactly as found.
+function brokenSymlinkReason(target) {
+  let stat;
+  try {
+    stat = lstatSync(target);
+  } catch {
+    return null;
+  }
+  if (stat.isSymbolicLink() && !existsSync(target)) {
+    return "it is a symlink whose target does not exist — fix or remove the link first";
+  }
+  return null;
+}
+
 export function backupFile(target) {
   const stamp = new Date().toISOString().replace(/[-:.]/g, "");
   let dest = `${target}.arkaos-backup-${stamp}`;
@@ -168,6 +205,8 @@ export function syncUserClaudeMd({ home, templatePath }) {
   if (!existsSync(templatePath)) return { action: "no-template" };
   const template = readFileSync(templatePath, "utf-8");
   const target = join(home, ".claude", "CLAUDE.md");
+  const brokenLink = brokenSymlinkReason(target);
+  if (brokenLink) return { action: "refuse", reason: brokenLink };
   const raw = existsSync(target) ? readFileSync(target) : null;
   // Decoding a non-UTF-8 file replaces bytes with U+FFFD and writing
   // the decode back corrupts content OUTSIDE the block (QG C5 r1,
@@ -198,6 +237,8 @@ export function syncUserClaudeMd({ home, templatePath }) {
 export function installUserClaudeMd({ home, templatePath }) {
   if (!existsSync(templatePath)) return { action: "no-template" };
   const target = join(home, ".claude", "CLAUDE.md");
+  const brokenLink = brokenSymlinkReason(target);
+  if (brokenLink) return { action: "refuse", reason: brokenLink };
   if (existsSync(target)) return { action: "preserved" };
   mkdirSync(dirname(target), { recursive: true });
   writeAtomic(target, renderManagedBlock(readFileSync(templatePath, "utf-8")));
@@ -225,7 +266,7 @@ export function describeSyncResult(result) {
     "adopt-wrap": {
       level: "ok",
       message: result.preservedRemainder
-        ? "~/.claude/CLAUDE.md adopted into managed markers — your content preserved below the block"
+        ? "~/.claude/CLAUDE.md adopted into managed markers — your content preserved below the managed block"
         : "~/.claude/CLAUDE.md adopted into managed markers",
     },
     "adopt-prepend": {

package/knowledge/skills-manifest.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkaos",
-  "version": "5.1.0",
+  "version": "5.2.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.1.0"
+version = "5.2.0"
 description = "Core engine for ArkaOS — The Operating System for AI Agent Teams"
 readme = "README.md"
 license = {text = "MIT"}