29 Releases 31 Tags

RSS Feed

• v1.2.7 8ec7748ccb

  Compare

  v1.2.7 — Phase 18: Custom Persona Discovery & Docs

  cloudinit-bot released this 2026-07-28 19:51:44 +00:00 | 0 commits to main since this release

  Phase 18: Custom Persona Discovery & Docs (REQ-EXT-003)

  Added

  • Glob-based custom persona discovery from opencode/agents/ci-*.md in the source repo
  • discoverCustomPersonas() in PersonaLoader — fs.readdirSync + PERSONA_FILE_PATTERN filter, no glob dependency
  • Strict frontmatter validation — required name + domain fields; malformed files skipped at debug level (never fatal)
  • parseFrontmatter hardening — boolean coercion (active: false → boolean) and quote stripping for scalars
  • PersonaDefinition.phase?: number field for phase-scoped personas
  • applyPhaseActivation() — phase-specific personas active only when currentPhase === declared phase
  • PersonaLoader 3rd optional currentPhase constructor argument (backward-compatible 2-arg form preserved)
  • Custom persona authoring guide at docs/custom-personas.md with decision-ID traceability (D-130..D-143)
  • 23 new persona-system tests (discovery, validation, path fix, phase-specific, priority chain)

  Changed

  • Source-repo-canonical principle (D-130): agent/persona/workflow definitions live only in the source repo under opencode/; deployed ~/.config and .config are never read or written
  • PERSONA_SEARCH_PATHS reduced to ["opencode/agents"] — removed .config/opencode/agents
  • LLMBaseBackend.loadPersona/loadWorkflow dropped os.homedir()/.config candidate — source-repo opencode/ only
  • LLMBaseBackend.loadWorkflow path corrected to opencode/ci/workflows/ (P0 fix from review)
  • executor.ts passes context.phase to PersonaLoader
  • opencode.json now denies edits to ~/.config/**
  • .ciagent/ docs and opencode/ci/workflows/execute.md repointed from .config → opencode paths

  Requirements

  • REQ-EXT-003: Custom persona definitions via opencode/agents/*.md — complete

  Tests: 992 passing | Build: clean | Typecheck: clean

  Commits

  • 9a57e63 docs(init): validate Phase 18 specification
  • 333a685 decision(P18): clarification — 5 ambiguities resolved
  • 8ebff4b docs(P18): research custom persona discovery
  • cfcd26d docs(P18): research findings + PERSONAS.md
  • 2feb2a7 docs(P18): plan 5 waves
  • 87059d3 feat(P18): parser hardening, discovery, llm-base path, phase-specific
  • 550516b feat(P18): authoring guide + 23 tests, validation fix
  • 948eb47 verify(P18): 4-layer verification PASSED
  • 01aba94 verify(P18): code review — loadWorkflow P0 fix
  • c546d44 feat(P18): complete Phase 18, v1.2.7

  Downloads

  • Source Code (ZIP)
  • Source Code (TAR.GZ)