swarm: Command for Claude Code

/submit_paper

Submit a paper to ClawXiv and/or AgentXiv with validation, credential checks, and rate-limit retry.

Usage

/submit_paper <paper_name> [--platform clawxiv|agentxiv|both] [--dry-run]

Where <paper_name> is one of the paper stems (e.g. distributional_agi_safety, governance_mechanisms, collusion_dynamics) or all for batch submission.

Pre-flight Checks (run ALL before any submission)

1. Credential validation

   • ClawXiv: load key from ~/.config/clawxiv/swarmsafety.json or .credentials/agent_platforms.md
   • AgentXiv: load key from ~/.config/agentxiv/credentials.json (current entry)
   • For AgentXiv, call GET /api/v1/agents/status and verify status is claimed or active. If pending_claim, STOP and tell the user to claim the account first.

2. Author attribution check

   • Grep the submission .tex for \author{} content.
   • If the author is NOT "SWARM Research Collective", auto-replace it to "SWARM Research Collective" in the submission copy (docs/papers/<name>_submission.tex) and inform the user (do not ask — the canonical docs/papers/<name>.tex source is not modified).
   • This avoids a blocking question on every submission. The user can pass --keep-author to skip the replacement.

3. Category validation

   • ClawXiv valid categories: cs.MA, cs.AI, cs.CL, cs.LG, cs.CR, cs.SE (check via API if unsure)
   • AgentXiv valid categories: general, agent-behavior, agent-communication, tool-use, reasoning, memory, planning, meta-cognition, alignment, emergent-behavior, human-agent-interaction, multi-agent-systems

4. Source validation

   • Validate using the exact API below (avoids rediscovery after context compaction):

   from swarm.research.submission import SubmissionValidator
   from swarm.research.platforms import Paper
   paper = Paper(title=..., abstract=..., source=tex, categories=['cs.MA', 'cs.AI'])
   sv = SubmissionValidator()          # instance, not classmethod
   result = sv.validate(paper)         # returns ValidationResult
   # result.passed (bool) — True if no errors
   # result.issues (list[ValidationIssue]) — each has .severity.value, .code, .message
   # result.quality_score (float) — 0-100
   

   • Auto-fix section names: If the source contains \section{Experimental Setup}, rename it to \section{Methods} before validation. Similarly rename \section{Experimental Methods} to \section{Methods}. The validator requires \section{Methods} or \section{Experiments} exactly.
   • The validator also requires a \section{Conclusion}. If missing, add a brief one to the submission copy before validating.
   • For papers with \includegraphics, verify all referenced figures exist