vstack 0.45.0

vstack 0.45.0

Organizational behavior, practiced on AI agents. vstack is a curated library
of 34 diagnostic patterns drawn from organizational behavior, social psychology,
and group dynamics — each rewritten for the domain of AI agents rather than
human teams.

Install

pip install valanistack==0.45.0

Optional extras: [anthropic], [openai], [ollama], [mcp], [api],
[browser], [langchain], [langgraph], [crewai], [llamaindex],
[pydantic-ai], [adapters], [all].

Docker:

docker pull ghcr.io/valani9/vstack:0.45.0

What changed in this release

A new invocation surface: vstack now ships as a GitHub Action to gate
agent quality in CI. Thirteen invocation surfaces.

Added

• GitHub Action (uses: valani9/vstack@v0.45.0) — a composite action
  that installs vstack, runs vstack-diagnose on a trace, and fails the
  build when any finding is at or above a fail-on severity threshold
  (none…critical). Inputs: trace, fail-on, mode, recipe,
  client, shape, version, python-version. Outputs: max-severity,
  findings-count, report. Writes a findings table to the job summary.
  client: none (default) runs the deterministic analyzers with no API key
  — a free smoke gate; set a provider for full LLM-backed findings.
  • action.yml (repo root) + .github/action/gate.py (gate logic, reuses
    vstack's own severity_rank) + 9 unit tests, wired into CI.
  • Example consumer workflow:
    examples/github-action/agent-quality-gate.yml.

Compatibility

• All tests pass. No breaking changes.

Verify the install

vstack-doctor          # 25+ install checks
vstack-hello           # 30-second end-to-end demo

Resources

• Docs — hosted mkdocs site
• CHANGELOG — full history
• Patterns index — all 34 patterns + literature anchors
• Security policy