voc 0.1.1

Voc Agent — the Rust terminal cockpit for Vibecrafted
Documentation
use crate::launch::LaunchCommand;
use std::collections::BTreeMap;
use std::ffi::OsString;
use std::path::{Path, PathBuf};

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum SkillAgent {
    Claude,
    Codex,
    Gemini,
    Any,
}

impl SkillAgent {
    pub fn label(self) -> &'static str {
        match self {
            SkillAgent::Claude => "claude",
            SkillAgent::Codex => "codex",
            SkillAgent::Gemini => "gemini",
            SkillAgent::Any => "any",
        }
    }

    pub fn from_cli_token(raw: &str) -> Self {
        match raw {
            "claude" => SkillAgent::Claude,
            "gemini" => SkillAgent::Gemini,
            "codex" => SkillAgent::Codex,
            _ => SkillAgent::Any,
        }
    }

    pub fn resolved_cli_token(self, fallback: SkillAgent) -> &'static str {
        match self {
            SkillAgent::Claude => "claude",
            SkillAgent::Codex => "codex",
            SkillAgent::Gemini => "gemini",
            SkillAgent::Any => match fallback {
                SkillAgent::Claude => "claude",
                SkillAgent::Gemini => "gemini",
                _ => "codex",
            },
        }
    }
}

#[derive(Debug, Clone, PartialEq, Eq)]
pub enum SkillPayload {
    Prompt(String),
    File(PathBuf),
    None,
}

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum SkillPayloadKind {
    Optional,
    PromptOrFile,
    None,
}

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub struct SkillEntry {
    pub slug: &'static str,
    pub display: &'static str,
    pub one_line: &'static str,
    pub default_agent: SkillAgent,
    pub accepts: SkillPayloadKind,
}

impl SkillEntry {
    pub fn command_token(self) -> &'static str {
        self.slug
            .strip_prefix("vc-")
            .expect("catalog slugs must be vc-*")
    }

    pub fn emphasized(self) -> bool {
        self.slug == "vc-polarize"
    }
}

pub const CATALOG: &[SkillEntry] = &[
    SkillEntry {
        slug: "vc-init",
        display: "Init",
        one_line: "Technical due diligence",
        default_agent: SkillAgent::Any,
        accepts: SkillPayloadKind::Optional,
    },
    SkillEntry {
        slug: "vc-workflow",
        display: "Workflow",
        one_line: "Examine, research, implement",
        default_agent: SkillAgent::Any,
        accepts: SkillPayloadKind::PromptOrFile,
    },
    SkillEntry {
        slug: "vc-research",
        display: "Research",
        one_line: "Standalone research pass",
        default_agent: SkillAgent::Any,
        accepts: SkillPayloadKind::PromptOrFile,
    },
    SkillEntry {
        slug: "vc-review",
        display: "Review",
        one_line: "Bounded review pipeline",
        default_agent: SkillAgent::Any,
        accepts: SkillPayloadKind::PromptOrFile,
    },
    SkillEntry {
        slug: "vc-marbles",
        display: "Marbles",
        one_line: "Truth convergence loop",
        default_agent: SkillAgent::Any,
        accepts: SkillPayloadKind::PromptOrFile,
    },
    SkillEntry {
        slug: "vc-polarize",
        display: "Polarize",
        one_line: "One sharp truth after marbles",
        default_agent: SkillAgent::Codex,
        accepts: SkillPayloadKind::PromptOrFile,
    },
    SkillEntry {
        slug: "vc-dou",
        display: "DoU",
        one_line: "Definition of Undone audit",
        default_agent: SkillAgent::Any,
        accepts: SkillPayloadKind::PromptOrFile,
    },
    SkillEntry {
        slug: "vc-hydrate",
        display: "Hydrate",
        one_line: "Package and GTM hydration",
        default_agent: SkillAgent::Any,
        accepts: SkillPayloadKind::PromptOrFile,
    },
    SkillEntry {
        slug: "vc-decorate",
        display: "Decorate",
        one_line: "Late-stage visual finish",
        default_agent: SkillAgent::Any,
        accepts: SkillPayloadKind::PromptOrFile,
    },
    SkillEntry {
        slug: "vc-release",
        display: "Release",
        one_line: "Outward ship path",
        default_agent: SkillAgent::Any,
        accepts: SkillPayloadKind::PromptOrFile,
    },
    SkillEntry {
        slug: "vc-ownership",
        display: "Ownership",
        one_line: "Full-spectrum ownership mode",
        default_agent: SkillAgent::Any,
        accepts: SkillPayloadKind::PromptOrFile,
    },
    SkillEntry {
        slug: "vc-partner",
        display: "Partner",
        one_line: "Executive debugging partner",
        default_agent: SkillAgent::Any,
        accepts: SkillPayloadKind::PromptOrFile,
    },
    SkillEntry {
        slug: "vc-followup",
        display: "Followup",
        one_line: "Post-implementation audit",
        default_agent: SkillAgent::Any,
        accepts: SkillPayloadKind::PromptOrFile,
    },
    SkillEntry {
        slug: "vc-audit",
        display: "Audit",
        one_line: "Spec falsification of a plan",
        default_agent: SkillAgent::Any,
        accepts: SkillPayloadKind::PromptOrFile,
    },
    SkillEntry {
        slug: "vc-prune",
        display: "Prune",
        one_line: "Repository curation",
        default_agent: SkillAgent::Any,
        accepts: SkillPayloadKind::PromptOrFile,
    },
    SkillEntry {
        slug: "vc-intents",
        display: "Intents",
        one_line: "Intent-to-runtime truth audit",
        default_agent: SkillAgent::Any,
        accepts: SkillPayloadKind::PromptOrFile,
    },
    SkillEntry {
        slug: "vc-scaffold",
        display: "Scaffold",
        one_line: "Founder-first architecture plan",
        default_agent: SkillAgent::Any,
        accepts: SkillPayloadKind::PromptOrFile,
    },
    SkillEntry {
        slug: "vc-implement",
        display: "Implement",
        one_line: "End-to-end implementation",
        default_agent: SkillAgent::Any,
        accepts: SkillPayloadKind::PromptOrFile,
    },
    SkillEntry {
        slug: "vc-justdo",
        display: "JustDo",
        one_line: "Implement alias",
        default_agent: SkillAgent::Any,
        accepts: SkillPayloadKind::PromptOrFile,
    },
    SkillEntry {
        slug: "vc-delegate",
        display: "Delegate",
        one_line: "Bounded native delegation",
        default_agent: SkillAgent::Any,
        accepts: SkillPayloadKind::PromptOrFile,
    },
    SkillEntry {
        slug: "vc-agents",
        display: "Agents",
        one_line: "External agent fleet entry",
        default_agent: SkillAgent::Any,
        accepts: SkillPayloadKind::PromptOrFile,
    },
    SkillEntry {
        slug: "vc-skillaunch",
        display: "Skillaunch",
        one_line: "Distill a workflow into a skill",
        default_agent: SkillAgent::Any,
        accepts: SkillPayloadKind::PromptOrFile,
    },
];

pub fn catalog_entry(slug: &str) -> Option<&'static SkillEntry> {
    CATALOG.iter().find(|entry| entry.slug == slug)
}

pub fn build_skill_launch_command(
    deck: impl AsRef<Path>,
    skill: &str,
    agent: SkillAgent,
    fallback_agent: SkillAgent,
    payload: &SkillPayload,
    env: BTreeMap<String, OsString>,
) -> LaunchCommand {
    let command_skill = skill.strip_prefix("vc-").unwrap_or(skill);
    let mut args: Vec<OsString> = vec![
        command_skill.into(),
        agent.resolved_cli_token(fallback_agent).into(),
    ];
    match payload {
        SkillPayload::Prompt(prompt) if !prompt.trim().is_empty() => {
            args.push("--prompt".into());
            args.push(prompt.clone().into());
        }
        SkillPayload::File(path) => {
            args.push("--file".into());
            args.push(path.as_os_str().to_os_string());
        }
        SkillPayload::Prompt(_) | SkillPayload::None => {}
    }
    LaunchCommand {
        program: deck.as_ref().to_path_buf(),
        args,
        env,
    }
}