pyproject.toml

[project]
name = "valanistack"
version = "0.54.0"
description = "Organizational behavior, practiced on AI agents."
readme = "README.md"
requires-python = ">=3.11"
license = { file = "LICENSE" }
authors = [{ name = "Ilhan Valani", email = "valani@bu.edu" }]
keywords = [
    "ai",
    "agents",
    "after-action-review",
    "organizational-behavior",
    "multi-agent",
    "lencioni",
    "edmondson",
    "psychological-safety",
    "feedback",
    "devils-advocate",
    "lewin",
    "attribution",
    "trust",
    "social-loafing",
    "groupthink",
    "polarization",
    "process-loss",
    "smart-goals",
    "orchestration",
    "decision-making",
    "fist-to-five",
    "schein",
    "culture",
    "strengths",
    "plus-delta",
    "robbins-judge",
    "superflocks",
    "yerkes-dodson",
    "workload",
    "org-structure",
    "galbraith",
    "mintzberg",
    "motivation",
    "saxberg",
    "conversational-intelligence",
    "glaser",
    "goleman",
    "emotional-intelligence",
    "self-determination-theory",
    "deci-ryan",
    "span-of-control",
    "centralization",
    "danva",
    "nowicki-duke",
    "emotion-recognition",
    "gross",
    "cognitive-reappraisal",
    "emotion-regulation",
    "hexaco",
    "lee-ashton",
    "personality",
    "vroom",
    "expectancy",
    "agent-debugging",
    "agent-observability",
    "agent-evaluation",
    "llm-evaluation",
    "prompt-engineering",
    "post-mortem",
    "after-action-report",
    "retrospective",
    "agent-failure-modes",
    "multi-agent-systems",
    "model-context-protocol",
    "mcp-server",
    "llmops",
    "agent-ops",
]
classifiers = [
    "Development Status :: 4 - Beta",
    "Intended Audience :: Developers",
    "License :: OSI Approved :: MIT License",
    "Operating System :: OS Independent",
    "Programming Language :: Python :: 3",
    "Programming Language :: Python :: 3 :: Only",
    "Programming Language :: Python :: 3.11",
    "Programming Language :: Python :: 3.12",
    "Programming Language :: Python :: 3.13",
    "Topic :: Software Development :: Libraries :: Python Modules",
    "Topic :: Scientific/Engineering :: Artificial Intelligence",
    "Typing :: Typed",
]
dependencies = [
    "pydantic>=2.6.0",
]

[project.optional-dependencies]
anthropic = ["anthropic>=0.40.0"]
openai = ["openai>=1.50.0"]
ollama = ["httpx>=0.27.0"]
mcp = ["mcp>=1.20.0"]
api = ["fastapi>=0.115.0", "uvicorn[standard]>=0.30.0"]
browser = ["mcp>=1.20.0"]
langchain = ["langchain-core>=0.3.0"]
langgraph = ["langgraph>=0.2.0"]
crewai = ["crewai>=0.70.0"]
llamaindex = ["llama-index-core>=0.12.0"]
pydantic_ai = ["pydantic-ai>=0.0.20"]
smolagents = ["smolagents>=1.0.0"]
adk = ["google-adk>=1.0.0"]
strands = ["strands-agents>=0.1.0"]
# `adapters` bundles the lighter adapters; adk (heavy google-cloud deps)
# and strands install as their own extras.
adapters = ["valanistack[langchain,langgraph,crewai,llamaindex,pydantic_ai,smolagents]"]
docs = ["mkdocs>=1.5.0", "mkdocs-material>=9.5.0"]
all = ["valanistack[anthropic,openai,ollama,mcp,api,browser,adapters]"]
dev = [
    "pytest>=8.0.0",
    "pytest-cov>=5.0.0",
    "ruff>=0.6.0",
    "mypy>=1.11.0",
    "bandit[toml]>=1.7.10",
    "pip-audit>=2.7.0",
    "pre-commit>=3.5.0",
    "build>=1.2.0",
    "fastapi>=0.115.0",
    "httpx>=0.27.0",
    "mcp>=1.20.0",
]

[project.urls]
Homepage = "https://github.com/valani9/vstack"
Repository = "https://github.com/valani9/vstack"
Issues = "https://github.com/valani9/vstack/issues"
Changelog = "https://github.com/valani9/vstack/blob/main/CHANGELOG.md"
"Bug Tracker" = "https://github.com/valani9/vstack/issues"
"Security" = "https://github.com/valani9/vstack/security/policy"

[project.scripts]
vstack = "vstack.aar.cli:main"
vstack-mcp = "vstack.mcp.cli:main"
vstack-api = "vstack.api.cli:main"
vstack-config = "vstack.memory.cli:main"
vstack-upgrade = "vstack.upgrade.cli:main"
vstack-learn = "vstack.learnings.cli:main"
vstack-analytics = "vstack.analytics.cli:main"
vstack-browser = "vstack.browser.cli:main"
vstack-gbrain = "vstack.gbrain.cli:main"
vstack-bench = "vstack.benchmarks.cli:main"
vstack-doctor = "vstack.doctor.cli:main"
vstack-hello = "vstack.hello.cli:main"
vstack-dashboard = "vstack.dashboard.cli:main"
vstack-scorecard = "vstack.scorecard._cli:main"
vstack-trace-zoo = "vstack.trace_zoo._cli:main"
vstack-diagnose = "vstack.diagnose.cli:main"
vstack-recipes = "vstack.diagnose.recipes_cli:main"
vstack-redaction = "vstack.redaction._cli:main"
vstack-export = "vstack.export._cli:main"
vstack-aggregate = "vstack.aggregate._cli:main"
vstack-findings-db = "vstack.findings_db._cli:main"
vstack-trace-diff = "vstack.trace_diff._cli:main"
vstack-heatmap = "vstack.heatmap._cli:main"
vstack-timeline = "vstack.timeline._cli:main"
vstack-synth = "vstack.synth._cli:main"
vstack-vdiff = "vstack.vdiff._cli:main"
vstack-import = "vstack.ingest._cli:main"
vstack-lewin = "vstack.lewin.cli:main"
vstack-goleman = "vstack.goleman_ei.cli:main"
vstack-johari = "vstack.johari.cli:main"
vstack-danva = "vstack.danva_emotion.cli:main"
vstack-reappraisal = "vstack.cognitive_reappraisal.cli:main"
vstack-yerkes = "vstack.yerkes_dodson.cli:main"
vstack-hexaco = "vstack.hexaco.cli:main"
vstack-grant = "vstack.grant_strengths.cli:main"
vstack-motivation = "vstack.motivation_traps.cli:main"
vstack-sdt = "vstack.sdt_reward.cli:main"
vstack-mcgregor = "vstack.mcgregor.cli:main"
vstack-vroom = "vstack.vroom_expectancy.cli:main"
vstack-grpi = "vstack.grpi.cli:main"
vstack-process = "vstack.process_gain_loss.cli:main"
vstack-loafing = "vstack.social_loafing.cli:main"
vstack-superflocks = "vstack.superflocks.cli:main"
vstack-lencioni = "vstack.lencioni.cli:main"
vstack-trust-triangle = "vstack.trust_triangle.cli:main"
vstack-mcallister = "vstack.mcallister_trust.cli:main"
vstack-psych-safety = "vstack.psych_safety.cli:main"
vstack-glaser = "vstack.glaser_conversation.cli:main"
vstack-feedback-triggers = "vstack.feedback_triggers.cli:main"
vstack-plus-delta = "vstack.plus_delta.cli:main"
vstack-smart-goal = "vstack.smart_goal.cli:main"
vstack-group-decision = "vstack.group_decision.cli:main"
vstack-debate-pathology = "vstack.debate_pathology.cli:main"
vstack-bias-stack = "vstack.bias_stack.cli:main"
vstack-devils-advocate = "vstack.devils_advocate.cli:main"
vstack-thomas-kilmann = "vstack.thomas_kilmann.cli:main"
vstack-schein-culture = "vstack.schein_culture.cli:main"
vstack-robbins-culture = "vstack.robbins_culture.cli:main"
vstack-org-structure = "vstack.org_structure.cli:main"
vstack-span-of-control = "vstack.span_of_control.cli:main"

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

# The repo is organized by module + pattern number (module-2-team/30-...)
# but the published Python package presents the conventional `vstack.*`
# import surface. `force-include` rewrites the paths at build time so the
# wheel ships `vstack/aar/...` even though the source lives elsewhere.
# New patterns add another entry here on the same pattern.
[tool.hatch.build.targets.wheel]
only-include = []

[tool.hatch.build.targets.wheel.force-include]
"_packaging/vstack/__init__.py" = "vstack/__init__.py"
"_packaging/vstack/py.typed" = "vstack/py.typed"
"_diagnose/lib" = "vstack/diagnose"
"_mcp/lib" = "vstack/mcp"
"_memory/lib" = "vstack/memory"
"_upgrade/lib" = "vstack/upgrade"
"_api/lib" = "vstack/api"
"_adapters/lib" = "vstack/adapters"
"_learnings/lib" = "vstack/learnings"
"_analytics/lib" = "vstack/analytics"
"_browser/lib" = "vstack/browser"
"_gbrain/lib" = "vstack/gbrain"
"_benchmarks/lib" = "vstack/benchmarks"
"_security/lib" = "vstack/security"
"_cache/lib" = "vstack/cache"
"_observability/lib" = "vstack/observability"
"_doctor/lib" = "vstack/doctor"
"_hello/lib" = "vstack/hello"
"_dashboard/lib" = "vstack/dashboard"
"_scorecard/lib" = "vstack/scorecard"
"_budget/lib" = "vstack/budget"
"_trace_zoo/lib" = "vstack/trace_zoo"
"_replay/lib" = "vstack/replay"
"_vcache/lib" = "vstack/vcache"
"_otel/lib" = "vstack/otel"
"_compose/lib" = "vstack/compose"
"_vdiff/lib" = "vstack/vdiff"
"_calibrate/lib" = "vstack/calibrate"
"_streaming/lib" = "vstack/streaming"
"_vbench/lib" = "vstack/vbench"
"_markers/lib" = "vstack/markers"
"_signing/lib" = "vstack/signing"
"_synth/lib" = "vstack/synth"
"_veval/lib" = "vstack/veval"
"_recipes_dsl/lib" = "vstack/recipes_dsl"
"_heatmap/lib" = "vstack/heatmap"
"_policy/lib" = "vstack/policy"
"_budgeter/lib" = "vstack/budgeter"
"_tracer/lib" = "vstack/tracer"
"_export/lib" = "vstack/export"
"_findings_db/lib" = "vstack/findings_db"
"_trace_diff/lib" = "vstack/trace_diff"
"_timeline/lib" = "vstack/timeline"
"_cost_sim/lib" = "vstack/cost_sim"
"_findings_router/lib" = "vstack/findings_router"
"_alerting/lib" = "vstack/alerting"
"_eval_gates/lib" = "vstack/eval_gates"
"_intervention_tracker/lib" = "vstack/intervention_tracker"
"_redaction/lib" = "vstack/redaction"
"_health/lib" = "vstack/health"
"_priority_queue/lib" = "vstack/priority_queue"
"_snippet/lib" = "vstack/snippet"
"_aggregate/lib" = "vstack/aggregate"
"_ingest/lib" = "vstack/ingest"
# Claude Code skill bundle — shipped inside the wheel so
# `vstack-config install-skills` works for `pip install` users, not just
# repo checkouts. Resolved first by `_resolve_skills_source`.
"_skills" = "vstack/_skills"
"module-2-team/30-aar-generator/lib" = "vstack/aar"
"module-2-team/17-lencioni-diagnostic/lib" = "vstack/lencioni"
"module-2-team/18-trust-triangle-audit/lib" = "vstack/trust_triangle"
"module-1-individual/03-johari-window/lib" = "vstack/johari"
"module-2-team/13-grpi-working-agreement/lib" = "vstack/grpi"
"module-2-team/27-bias-stack-detector/lib" = "vstack/bias_stack"
"module-2-team/20-edmondson-psych-safety/lib" = "vstack/psych_safety"
"module-2-team/29-thomas-kilmann-selector/lib" = "vstack/thomas_kilmann"
"module-2-team/22-stone-heen-feedback-triggers/lib" = "vstack/feedback_triggers"
"module-2-team/28-devils-advocate-separator/lib" = "vstack/devils_advocate"
"module-1-individual/01-lewin-formula/lib" = "vstack/lewin"
"module-2-team/19-mcallister-trust-dimensions/lib" = "vstack/mcallister_trust"
"module-2-team/15-social-loafing-detector/lib" = "vstack/social_loafing"
"module-2-team/26-groupthink-polarization-contagion/lib" = "vstack/debate_pathology"
"module-2-team/14-process-gain-loss-detector/lib" = "vstack/process_gain_loss"
"module-2-team/24-smart-goal-generator/lib" = "vstack/smart_goal"
"module-1-individual/11-mcgregor-orchestrator-mode/lib" = "vstack/mcgregor"
"module-2-team/25-group-decision-models/lib" = "vstack/group_decision"
"module-3-organization/31-schein-iceberg-culture/lib" = "vstack/schein_culture"
"module-1-individual/08-grant-strengths-as-weaknesses/lib" = "vstack/grant_strengths"
"module-2-team/23-plus-delta-feedback-format/lib" = "vstack/plus_delta"
"module-3-organization/32-robbins-judge-7-culture/lib" = "vstack/robbins_culture"
"module-2-team/16-heffernan-superflocks-detector/lib" = "vstack/superflocks"
"module-1-individual/06-yerkes-dodson-workload/lib" = "vstack/yerkes_dodson"
"module-3-organization/33-org-structure-matrix/lib" = "vstack/org_structure"
"module-1-individual/09-motivation-traps/lib" = "vstack/motivation_traps"
"module-2-team/21-glaser-conversation-steering/lib" = "vstack/glaser_conversation"
"module-1-individual/02-goleman-ei-audit/lib" = "vstack/goleman_ei"
"module-1-individual/10-sdt-intrinsic-reward/lib" = "vstack/sdt_reward"
"module-3-organization/34-span-of-control/lib" = "vstack/span_of_control"
"module-1-individual/04-danva-emotion-reader/lib" = "vstack/danva_emotion"
"module-1-individual/05-cognitive-reappraisal/lib" = "vstack/cognitive_reappraisal"
"module-1-individual/07-hexaco-personality/lib" = "vstack/hexaco"
"module-1-individual/12-vroom-expectancy/lib" = "vstack/vroom_expectancy"

[tool.ruff]
line-length = 100
target-version = "py311"

[tool.ruff.format]
quote-style = "double"

[tool.mypy]
python_version = "3.11"
strict = true
warn_return_any = true
warn_unused_configs = true

# numpy (a transitive dep of some optional framework extras) ships inline
# stubs that use the 3.12 `type X = ...` statement. Because we type-check
# against python_version 3.11, mypy can't parse those stubs and aborts
# ("Type statement is only supported in Python 3.12 and greater"). vstack
# does not depend on numpy directly, so skip following it entirely.
[[tool.mypy.overrides]]
module = ["numpy", "numpy.*"]
follow_imports = "skip"
follow_imports_for_stubs = true

[tool.pytest.ini_options]
minversion = "8.0"
testpaths = [
    "module-1-individual",
    "module-2-team",
    "module-3-organization",
    "_diagnose",
    "_mcp",
    "_memory",
    "_upgrade",
    "_api",
    "_adapters",
    "_learnings",
    "_analytics",
    "_browser",
    "_gbrain",
    "_benchmarks",
    "_security",
    "_cache",
    "_observability",
    "_doctor",
    "_hello",
    "_dashboard",
    "_scorecard",
    "_budget",
    "_trace_zoo",
    "_replay",
    "_vcache",
    "_otel",
    "_compose",
    "_vdiff",
    "_calibrate",
    "_streaming",
    "_vbench",
    "_markers",
    "_signing",
    "_synth",
    "_veval",
    "_recipes_dsl",
    "_heatmap",
    "_policy",
    "_budgeter",
    "_tracer",
    "_export",
    "_findings_db",
    "_trace_diff",
    "_timeline",
    "_cost_sim",
    "_findings_router",
    "_alerting",
    "_eval_gates",
    "_intervention_tracker",
    "_redaction",
    "_health",
    "_priority_queue",
    "_snippet",
    "_aggregate",
    "_ingest",
]
addopts = "-ra --tb=short --strict-markers"
filterwarnings = [
    "error",
    "ignore::DeprecationWarning:pydantic.*",
]

[tool.coverage.run]
source = ["vstack"]
omit = [
    "*/tests/*",
    "*/demo/*",
    "*/benchmark/*",
    "*/_perf/*",
]

[tool.coverage.report]
exclude_lines = [
    "pragma: no cover",
    "raise NotImplementedError",
    "if __name__ == .__main__.:",
    "if TYPE_CHECKING:",
]

[tool.bandit]
# Library code only; tests + demos exercise canned fixtures.
exclude_dirs = [".venv", ".git", "dist", "tests", "demo", "examples", "benchmarks"]
skips = ["B101"]  # asserts are OK in library code; they're not security gates