arkaos 4.14.0 → 4.14.1

package/VERSION

@@ -1 +1 @@
-4.14.0
+4.14.1

package/knowledge/skills-manifest.json

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

package/mcps/arka-prompts/commands.py

@@ -0,0 +1,451 @@
+"""
+ARKA OS — Command Registry for MCP Prompts Server.
+
+Data-driven registry of all department commands exposed as MCP prompts.
+Each command maps to a SKILL.md file that provides the full instruction set.
+"""
+
+COMMANDS: dict[str, dict] = {
+    # ── System (arka) ────────────────────────────────────────────────────────
+    "arka_standup": {
+        "department": "system",
+        "skill_dir": "arka",
+        "slash_command": "/arka standup",
+        "title": "ARKA — Daily Standup",
+        "description": "Daily standup: summarize active projects, tasks, meetings, and priorities.",
+        "arguments": [],
+    },
+    "arka_status": {
+        "department": "system",
+        "skill_dir": "arka",
+        "slash_command": "/arka status",
+        "title": "ARKA — System Status",
+        "description": "System status: version, departments, personas, skills, MCPs.",
+        "arguments": [],
+    },
+    # ── Dev ───────────────────────────────────────────────────────────────────
+    "dev_do": {
+        "department": "dev",
+        "skill_dir": "arka-dev",
+        "slash_command": "/dev do",
+        "title": "Dev — Smart Orchestrator",
+        "description": "Smart orchestrator that routes to the correct dev workflow.",
+        "arguments": [
+            {"name": "description", "description": "What you want to build or fix", "required": True},
+        ],
+    },
+    "dev_feature": {
+        "department": "dev",
+        "skill_dir": "arka-dev",
+        "slash_command": "/dev feature",
+        "title": "Dev — Implement Feature",
+        "description": "Implement a feature with the full 8-phase development workflow.",
+        "arguments": [
+            {"name": "description", "description": "Feature description", "required": True},
+        ],
+    },
+    "dev_api": {
+        "department": "dev",
+        "skill_dir": "arka-dev",
+        "slash_command": "/dev api",
+        "title": "Dev — Generate API",
+        "description": "Generate API endpoints with tests and documentation.",
+        "arguments": [
+            {"name": "spec", "description": "API specification or description", "required": True},
+        ],
+    },
+    "dev_plan": {
+        "department": "dev",
+        "skill_dir": "arka-dev",
+        "slash_command": "/dev plan",
+        "title": "Dev — Architecture Plan",
+        "description": "Architecture planning only (no code output).",
+        "arguments": [
+            {"name": "description", "description": "What to plan", "required": True},
+        ],
+    },
+    "dev_debug": {
+        "department": "dev",
+        "skill_dir": "arka-dev",
+        "slash_command": "/dev debug",
+        "title": "Dev — Debug Issue",
+        "description": "Diagnose and fix a bug.",
+        "arguments": [
+            {"name": "issue", "description": "Bug or issue description", "required": True},
+        ],
+    },
+    "dev_refactor": {
+        "department": "dev",
+        "skill_dir": "arka-dev",
+        "slash_command": "/dev refactor",
+        "title": "Dev — Refactor Code",
+        "description": "Refactor code with quality gates.",
+        "arguments": [
+            {"name": "target", "description": "Code or component to refactor", "required": True},
+        ],
+    },
+    "dev_db": {
+        "department": "dev",
+        "skill_dir": "arka-dev",
+        "slash_command": "/dev db",
+        "title": "Dev — Database Schema",
+        "description": "Database schema design and migrations.",
+        "arguments": [
+            {"name": "description", "description": "Schema or migration description", "required": True},
+        ],
+    },
+    "dev_review": {
+        "department": "dev",
+        "skill_dir": "arka-dev",
+        "slash_command": "/dev review",
+        "title": "Dev — Code Review",
+        "description": "Code review of current changes.",
+        "arguments": [],
+    },
+    "dev_test": {
+        "department": "dev",
+        "skill_dir": "arka-dev",
+        "slash_command": "/dev test",
+        "title": "Dev — Run Tests",
+        "description": "Generate and run test suite.",
+        "arguments": [],
+    },
+    "dev_deploy": {
+        "department": "dev",
+        "skill_dir": "arka-dev",
+        "slash_command": "/dev deploy",
+        "title": "Dev — Deploy",
+        "description": "Deploy to an environment.",
+        "arguments": [
+            {"name": "environment", "description": "Target environment (dev/staging/prod)", "required": True},
+        ],
+    },
+    "dev_docs": {
+        "department": "dev",
+        "skill_dir": "arka-dev",
+        "slash_command": "/dev docs",
+        "title": "Dev — Documentation",
+        "description": "Generate technical documentation.",
+        "arguments": [],
+    },
+    "dev_research": {
+        "department": "dev",
+        "skill_dir": "arka-dev",
+        "slash_command": "/dev research",
+        "title": "Dev — Research",
+        "description": "Research a library, framework, or integration.",
+        "arguments": [
+            {"name": "topic", "description": "Research topic", "required": True},
+        ],
+    },
+    "dev_scaffold": {
+        "department": "dev",
+        "skill_dir": "arka-scaffold",
+        "slash_command": "/dev scaffold",
+        "title": "Dev — Scaffold Project",
+        "description": "Create a new project from a starter template.",
+        "arguments": [
+            {"name": "type", "description": "Project type (laravel, nuxt-saas, nuxt-landing, vue-saas, react, nextjs, etc.)", "required": True},
+            {"name": "name", "description": "Project name", "required": True},
+        ],
+    },
+    # ── Marketing ─────────────────────────────────────────────────────────────
+    "mkt_social": {
+        "department": "mkt",
+        "skill_dir": "arka-marketing",
+        "slash_command": "/mkt social",
+        "title": "Mkt — Social Media Posts",
+        "description": "Generate social media posts for multiple platforms.",
+        "arguments": [
+            {"name": "topic", "description": "Content topic", "required": True},
+            {"name": "persona", "description": "Persona name for style (optional)", "required": False},
+        ],
+    },
+    "mkt_calendar": {
+        "department": "mkt",
+        "skill_dir": "arka-marketing",
+        "slash_command": "/mkt calendar",
+        "title": "Mkt — Content Calendar",
+        "description": "Create a content calendar for a week or month.",
+        "arguments": [
+            {"name": "period", "description": "Time period (week or month)", "required": True},
+        ],
+    },
+    "mkt_email": {
+        "department": "mkt",
+        "skill_dir": "arka-marketing",
+        "slash_command": "/mkt email",
+        "title": "Mkt — Email Sequence",
+        "description": "Create email sequences (welcome, nurture, launch, cart).",
+        "arguments": [
+            {"name": "type", "description": "Email type (welcome, nurture, launch, cart)", "required": True},
+            {"name": "topic", "description": "Email topic", "required": True},
+        ],
+    },
+    "mkt_landing": {
+        "department": "mkt",
+        "skill_dir": "arka-marketing",
+        "slash_command": "/mkt landing",
+        "title": "Mkt — Landing Page Copy",
+        "description": "Generate landing page copy for a product.",
+        "arguments": [
+            {"name": "product", "description": "Product name or description", "required": True},
+            {"name": "persona", "description": "Persona name for style (optional)", "required": False},
+        ],
+    },
+    "mkt_ads": {
+        "department": "mkt",
+        "skill_dir": "arka-marketing",
+        "slash_command": "/mkt ads",
+        "title": "Mkt — Ad Copy",
+        "description": "Generate ad copy for multiple platforms.",
+        "arguments": [
+            {"name": "product", "description": "Product name or description", "required": True},
+            {"name": "persona", "description": "Persona name for style (optional)", "required": False},
+        ],
+    },
+    "mkt_blog": {
+        "department": "mkt",
+        "skill_dir": "arka-marketing",
+        "slash_command": "/mkt blog",
+        "title": "Mkt — Blog Article",
+        "description": "Write an SEO-optimized blog article.",
+        "arguments": [
+            {"name": "topic", "description": "Blog topic", "required": True},
+            {"name": "persona", "description": "Persona name for style (optional)", "required": False},
+        ],
+    },
+    # ── E-commerce ────────────────────────────────────────────────────────────
+    "ecom_audit": {
+        "department": "ecom",
+        "skill_dir": "arka-ecommerce",
+        "slash_command": "/ecom audit",
+        "title": "Ecom — Store Audit",
+        "description": "Full e-commerce store audit with parallel analysis.",
+        "arguments": [
+            {"name": "url", "description": "Store URL", "required": True},
+        ],
+    },
+    "ecom_product": {
+        "department": "ecom",
+        "skill_dir": "arka-ecommerce",
+        "slash_command": "/ecom product",
+        "title": "Ecom — Product Listing",
+        "description": "Create an optimized product listing.",
+        "arguments": [
+            {"name": "description", "description": "Product description", "required": True},
+        ],
+    },
+    "ecom_pricing": {
+        "department": "ecom",
+        "skill_dir": "arka-ecommerce",
+        "slash_command": "/ecom pricing",
+        "title": "Ecom — Pricing Strategy",
+        "description": "Pricing strategy analysis for a product.",
+        "arguments": [
+            {"name": "product", "description": "Product name", "required": True},
+        ],
+    },
+    "ecom_launch": {
+        "department": "ecom",
+        "skill_dir": "arka-ecommerce",
+        "slash_command": "/ecom launch",
+        "title": "Ecom — Store Launch",
+        "description": "New store launch plan.",
+        "arguments": [
+            {"name": "store", "description": "Store name", "required": True},
+        ],
+    },
+    # ── Finance ───────────────────────────────────────────────────────────────
+    "fin_report": {
+        "department": "fin",
+        "skill_dir": "arka-finance",
+        "slash_command": "/fin report",
+        "title": "Fin — Financial Report",
+        "description": "Generate a financial report (monthly/quarterly).",
+        "arguments": [
+            {"name": "period", "description": "Report period (month or quarter)", "required": True},
+        ],
+    },
+    "fin_forecast": {
+        "department": "fin",
+        "skill_dir": "arka-finance",
+        "slash_command": "/fin forecast",
+        "title": "Fin — Revenue Forecast",
+        "description": "Revenue and expense forecast.",
+        "arguments": [
+            {"name": "months", "description": "Number of months to project", "required": True},
+        ],
+    },
+    "fin_budget": {
+        "department": "fin",
+        "skill_dir": "arka-finance",
+        "slash_command": "/fin budget",
+        "title": "Fin — Budget Planning",
+        "description": "Project budget planning.",
+        "arguments": [
+            {"name": "project", "description": "Project name", "required": True},
+        ],
+    },
+    "fin_negotiate": {
+        "department": "fin",
+        "skill_dir": "arka-finance",
+        "slash_command": "/fin negotiate",
+        "title": "Fin — Negotiation Prep",
+        "description": "Prepare for bank or investor negotiation.",
+        "arguments": [
+            {"name": "context", "description": "Negotiation context", "required": True},
+        ],
+    },
+    "fin_pitch": {
+        "department": "fin",
+        "skill_dir": "arka-finance",
+        "slash_command": "/fin pitch",
+        "title": "Fin — Investor Pitch",
+        "description": "Investor pitch preparation.",
+        "arguments": [
+            {"name": "investor", "description": "Investor name or type", "required": True},
+        ],
+    },
+    # ── Operations ────────────────────────────────────────────────────────────
+    "ops_tasks": {
+        "department": "ops",
+        "skill_dir": "arka-operations",
+        "slash_command": "/ops tasks",
+        "title": "Ops — Task Management",
+        "description": "View and manage tasks (via ClickUp).",
+        "arguments": [],
+    },
+    "ops_email": {
+        "department": "ops",
+        "skill_dir": "arka-operations",
+        "slash_command": "/ops email",
+        "title": "Ops — Email",
+        "description": "Send or draft emails (via Gmail).",
+        "arguments": [
+            {"name": "type", "description": "Email type or action", "required": True},
+        ],
+    },
+    "ops_calendar": {
+        "department": "ops",
+        "skill_dir": "arka-operations",
+        "slash_command": "/ops calendar",
+        "title": "Ops — Calendar",
+        "description": "View and manage schedule (via Google Calendar).",
+        "arguments": [],
+    },
+    "ops_meeting": {
+        "department": "ops",
+        "skill_dir": "arka-operations",
+        "slash_command": "/ops meeting",
+        "title": "Ops — Meeting",
+        "description": "Schedule and prepare a meeting.",
+        "arguments": [
+            {"name": "topic", "description": "Meeting topic", "required": True},
+        ],
+    },
+    "ops_automate": {
+        "department": "ops",
+        "skill_dir": "arka-operations",
+        "slash_command": "/ops automate",
+        "title": "Ops — Automate Process",
+        "description": "Create automation for a routine process.",
+        "arguments": [
+            {"name": "process", "description": "Process description", "required": True},
+        ],
+    },
+    # ── Strategy ──────────────────────────────────────────────────────────────
+    "strat_brainstorm": {
+        "department": "strat",
+        "skill_dir": "arka-strategy",
+        "slash_command": "/strat brainstorm",
+        "title": "Strat — Brainstorm",
+        "description": "Structured brainstorming with 5 perspectives.",
+        "arguments": [
+            {"name": "topic", "description": "Brainstorm topic", "required": True},
+        ],
+    },
+    "strat_market": {
+        "department": "strat",
+        "skill_dir": "arka-strategy",
+        "slash_command": "/strat market",
+        "title": "Strat — Market Analysis",
+        "description": "Market analysis and opportunity mapping.",
+        "arguments": [
+            {"name": "sector", "description": "Market sector", "required": True},
+        ],
+    },
+    "strat_competitor": {
+        "department": "strat",
+        "skill_dir": "arka-strategy",
+        "slash_command": "/strat competitor",
+        "title": "Strat — Competitive Analysis",
+        "description": "Competitive intelligence analysis.",
+        "arguments": [
+            {"name": "url", "description": "Competitor URL or name", "required": True},
+        ],
+    },
+    "strat_swot": {
+        "department": "strat",
+        "skill_dir": "arka-strategy",
+        "slash_command": "/strat swot",
+        "title": "Strat — SWOT Analysis",
+        "description": "SWOT analysis for a business.",
+        "arguments": [
+            {"name": "business", "description": "Business name", "required": True},
+        ],
+    },
+    "strat_evaluate": {
+        "department": "strat",
+        "skill_dir": "arka-strategy",
+        "slash_command": "/strat evaluate",
+        "title": "Strat — Evaluate Idea",
+        "description": "Evaluate a new idea (pros, cons, risks, ROI).",
+        "arguments": [
+            {"name": "idea", "description": "Idea description", "required": True},
+        ],
+    },
+    # ── Knowledge Base ────────────────────────────────────────────────────────
+    "kb_learn": {
+        "department": "kb",
+        "skill_dir": "arka-knowledge",
+        "slash_command": "/kb learn",
+        "title": "KB — Learn from Content",
+        "description": "Queue URLs for async download and transcription.",
+        "arguments": [
+            {"name": "urls", "description": "One or more URLs to learn from", "required": True},
+            {"name": "persona", "description": "Persona name to associate (optional)", "required": False},
+        ],
+    },
+    "kb_search": {
+        "department": "kb",
+        "skill_dir": "arka-knowledge",
+        "slash_command": "/kb search",
+        "title": "KB — Search Knowledge",
+        "description": "Search the knowledge base by topic.",
+        "arguments": [
+            {"name": "query", "description": "Search query", "required": True},
+        ],
+    },
+    "kb_persona": {
+        "department": "kb",
+        "skill_dir": "arka-knowledge",
+        "slash_command": "/kb persona",
+        "title": "KB — View Persona",
+        "description": "View or manage a persona profile.",
+        "arguments": [
+            {"name": "name", "description": "Persona name", "required": True},
+        ],
+    },
+    "kb_write": {
+        "department": "kb",
+        "skill_dir": "arka-knowledge",
+        "slash_command": "/kb write",
+        "title": "KB — Generate Content",
+        "description": "Generate content using a persona's style and knowledge.",
+        "arguments": [
+            {"name": "persona", "description": "Persona name", "required": True},
+            {"name": "type", "description": "Content type to generate", "required": True},
+        ],
+    },
+}

package/mcps/arka-prompts/pyproject.toml

@@ -0,0 +1,15 @@
+[project]
+name = "arka-prompts"
+version = "0.1.0"
+description = "ARKA OS department commands as MCP prompts"
+requires-python = ">=3.11"
+dependencies = [
+    "mcp[cli]>=1.2.0",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["."]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"

package/mcps/arka-prompts/server.py

@@ -0,0 +1,156 @@
+"""
+ARKA OS — MCP Prompts Server.
+
+Exposes all ARKA OS department commands as MCP prompts so they work in
+both Claude Code and Claude Desktop.
+
+Usage:
+    uv run server.py
+"""
+
+import os
+from pathlib import Path
+
+from mcp.server.fastmcp import FastMCP
+from mcp.server.fastmcp.prompts.base import Prompt, PromptArgument
+
+from commands import COMMANDS
+
+mcp = FastMCP(
+    "arka-prompts",
+    instructions="ARKA OS department commands. Select a prompt to run an ARKA OS command.",
+)
+
+
+def _find_skills_dir() -> Path:
+    """Resolve the base skills directory where SKILL.md files live.
+
+    Resolution order:
+    1. ARKA_OS env var  ->  parent dir is the skills root
+    2. ~/.claude/skills/arka/.repo-path  ->  dev mode (read repo path from file)
+    3. Fallback to ~/.claude/skills/
+    """
+    arka_os = os.environ.get("ARKA_OS")
+    if arka_os:
+        arka_path = Path(arka_os)
+        if arka_path.is_dir():
+            return arka_path.parent  # e.g. ~/.claude/skills/
+
+    # Dev mode: .repo-path points to the repo checkout
+    repo_path_file = Path.home() / ".claude" / "skills" / "arka" / ".repo-path"
+    if repo_path_file.exists():
+        repo_path = Path(repo_path_file.read_text().strip())
+        if repo_path.is_dir():
+            return repo_path  # Return repo root for dev mode resolution
+
+    return Path.home() / ".claude" / "skills"
+
+
+def _load_skill(skill_dir: str) -> str | None:
+    """Load SKILL.md content for the given skill directory name.
+
+    Tries installed location first, then falls back to dev repo layout.
+    """
+    skills_base = _find_skills_dir()
+
+    # Installed layout: ~/.claude/skills/<skill_dir>/SKILL.md
+    installed = skills_base / skill_dir / "SKILL.md"
+    if installed.is_file():
+        return installed.read_text(encoding="utf-8")
+
+    # Dev repo layout: <repo>/departments/<dept>/SKILL.md
+    # Map skill_dir names to department directories
+    dept_map = {
+        "arka": "arka",
+        "arka-dev": "departments/dev",
+        "arka-marketing": "departments/marketing",
+        "arka-ecommerce": "departments/ecommerce",
+        "arka-finance": "departments/finance",
+        "arka-operations": "departments/operations",
+        "arka-strategy": "departments/strategy",
+        "arka-knowledge": "departments/knowledge",
+        "arka-scaffold": "departments/dev/skills/scaffold",
+    }
+    if skill_dir in dept_map:
+        dev_path = skills_base / dept_map[skill_dir] / "SKILL.md"
+        if dev_path.is_file():
+            return dev_path.read_text(encoding="utf-8")
+
+    return None
+
+
+def _build_instruction(cmd_key: str, cmd: dict, user_args: dict[str, str]) -> str:
+    """Build the prompt message returned to the LLM."""
+    parts: list[str] = []
+
+    # Header with command context
+    parts.append(f"# ARKA OS — {cmd['title']}")
+    parts.append("")
+    parts.append(f"**Command:** `{cmd['slash_command']}`")
+
+    # Include user-provided arguments
+    if user_args:
+        parts.append("")
+        parts.append("**User input:**")
+        for arg_name, arg_value in user_args.items():
+            if arg_value:
+                parts.append(f"- **{arg_name}:** {arg_value}")
+
+    parts.append("")
+    parts.append("---")
+    parts.append("")
+
+    # Load and append the full SKILL.md
+    skill_content = _load_skill(cmd["skill_dir"])
+    if skill_content:
+        parts.append(skill_content)
+    else:
+        parts.append(
+            f"*SKILL.md not found for `{cmd['skill_dir']}`. "
+            f"Ensure ARKA OS is installed (`bash install.sh`).*"
+        )
+
+    parts.append("")
+    parts.append("---")
+    parts.append("")
+    parts.append(
+        f"Now execute the `{cmd['slash_command']}` command "
+        f"with the user input provided above."
+    )
+
+    return "\n".join(parts)
+
+
+def _make_prompt_fn(cmd_key: str, cmd: dict):
+    """Create a prompt handler function for a command."""
+    arg_names = [a["name"] for a in cmd["arguments"]]
+
+    def handler(**kwargs: str) -> str:
+        user_args = {name: kwargs.get(name, "") for name in arg_names}
+        return _build_instruction(cmd_key, cmd, user_args)
+
+    return handler
+
+
+# Register all commands as prompts
+for cmd_key, cmd_data in COMMANDS.items():
+    prompt_args = [
+        PromptArgument(
+            name=a["name"],
+            description=a["description"],
+            required=a["required"],
+        )
+        for a in cmd_data["arguments"]
+    ]
+
+    prompt = Prompt(
+        name=cmd_key,
+        description=f"{cmd_data['title']}: {cmd_data['description']}",
+        arguments=prompt_args or None,
+        fn=_make_prompt_fn(cmd_key, cmd_data),
+    )
+    mcp.add_prompt(prompt)
+
+
+if __name__ == "__main__":
+    mcp.run(transport="stdio")

package/mcps/arka-tools/pyproject.toml

@@ -0,0 +1,10 @@
+[project]
+name = "arka-tools"
+version = "1.0.0"
+description = "ArkaOS programmatic MCP tools — KB search, workflow state, Quality Gate, recipes, session memory, telemetry"
+requires-python = ">=3.11"
+dependencies = [
+    "mcp[cli]>=1.2.0",
+    "pydantic>=2.0",
+    "pyyaml>=6.0",
+]