arkaos 5.2.0 → 5.4.0

package/knowledge/commands-registry.json

@@ -1,15 +1,15 @@
 {
   "_meta": {
     "version": "3.0.0",
-    "generated": "2026-08-03T12:09:34Z",
-    "total_commands": 298,
+    "generated": "2026-08-04T22:58:29Z",
+    "total_commands": 299,
     "generator": "core/registry/generator.py",
     "departments": {
       "arka": 22,
       "brand": 12,
       "community": 15,
       "content": 20,
-      "dev": 36,
+      "dev": 37,
       "ecom": 18,
       "fin": 10,
       "kb": 23,
@@ -1744,6 +1744,38 @@
       "requires_branch": false,
       "modifies_code": false
     },
+    {
+      "id": "dev-research",
+      "command": "/dev research <topic>",
+      "department": "dev",
+      "description": "Library evaluation and pattern discovery (KB + Context7 + gh-grep + web)",
+      "lead_agent": "arka-dev",
+      "keywords": [
+        "research",
+        "evaluate library",
+        "compare frameworks",
+        "investigate",
+        "look into",
+        "real-world examples",
+        "exemplos reais",
+        "como implementam os outros",
+        "how do others implement",
+        "search github code",
+        "prior art"
+      ],
+      "examples": [
+        "research payment gateways",
+        "compare React vs Vue",
+        "evaluate Stripe vs PayPal",
+        "look into GraphQL",
+        "como é que outros repos usam esta API",
+        "procura exemplos reais de uso do ScrollTrigger"
+      ],
+      "source": "builtin",
+      "tier": 2,
+      "requires_branch": false,
+      "modifies_code": false
+    },
     {
       "id": "dev-spec",
       "command": "/dev spec <description>",

package/knowledge/skills-manifest.json

@@ -1,7 +1,7 @@
 {
   "_meta": {
     "generator": "scripts/marketplace_gen.py",
-    "version": "5.2.0",
+    "version": "5.4.0",
     "marketplace": "arkaos"
   },
   "structural": {
@@ -1109,6 +1109,21 @@
         "origin": "arkaos"
       }
     },
+    "design-dna": {
+      "depts": [
+        "brand"
+      ],
+      "curated": false,
+      "plugins": [
+        "arkaos-brand@arkaos"
+      ],
+      "collision": false,
+      "provenance": {
+        "origin": "community",
+        "source": "https://github.com/zanwei/design-dna",
+        "license": "MIT"
+      }
+    },
     "design-review": {
       "depts": [
         "brand"

package/package.json

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

package/scripts/skills_catalog_gen.py

@@ -1,7 +1,7 @@
 """Skills catalog generator — every SKILL.md in the system, one page.
 
-Documents the complete skill surface: 318 department skills plus the 15
-``/arka`` meta skills (333 total). Single source of truth: the SKILL.md
+Documents the complete skill surface: every department skill plus the
+``/arka`` meta skills. Single source of truth: the SKILL.md
 files themselves (``departments/*/skills/*/SKILL.md`` and
 ``arka/skills/*/SKILL.md``), never hand-typed counts. This script
 GENERATES:
@@ -80,7 +80,16 @@ def _clean_description(raw: str | None, fallback: str) -> str:
     text = re.sub(r"\s+", " ", text).strip()
     text = re.sub(r"\s+\.", ".", text)
     if len(text) > 180:
-        text = text[:177].rstrip() + "..."
+        head = text[:177]
+        # Cut on a word boundary: a mid-word slice leaves a truncated word
+        # that spellcheckers report as a misspelling of the whole one, so
+        # every catalog regeneration used to redden the codespell gate.
+        boundary = head.rfind(" ")
+        cut = (head[:boundary] if boundary > 0 else head).rstrip(" ,;:—-")
+        # `or head` guards the degenerate case where the whole cut is
+        # separators: emitting a bare "..." would lose a description
+        # master rendered in full.
+        text = (cut or head) + "..."
     return text or fallback
 
 
@@ -112,7 +121,7 @@ def _dept_skills() -> dict[str, list[dict]]:
 
     Matches docs_stats.py semantics: the department hub
     (``departments/<dept>/SKILL.md``) IS counted as a skill, so the
-    grand total reconciles with the canonical 333 headline.
+    grand total reconciles with the headline docs_stats reports.
     """
     result: dict[str, list[dict]] = {}
     for dept_dir in (REPO_ROOT / "departments").iterdir():
@@ -137,8 +146,8 @@ def _dept_skills() -> dict[str, list[dict]]:
 
 
 def _arka_skills() -> list[dict]:
-    """The 15 /arka meta skills: the master orchestrator plus the 14
-    sub-skills under arka/skills/*/SKILL.md."""
+    """The /arka meta skills: the master orchestrator plus every
+    sub-skill under arka/skills/*/SKILL.md."""
     master = REPO_ROOT / "arka" / "SKILL.md"
     entries = []
     if master.is_file():