stackvitals 0.1.0__py3-none-any.whl

stackvitals/web/site/site.css

@@ -0,0 +1,68 @@
+/* The project site: one static landing page in the app's look (same font, colours and radii), no scripts. */
+@font-face { font-family: "Plus Jakarta Sans"; font-style: normal; font-display: swap; font-weight: 200 800;
+  src: url("../app/fonts/plus-jakarta-sans.woff2") format("woff2-variations"), url("../app/fonts/plus-jakarta-sans.woff2") format("woff2"); }
+:root {
+  --bg: #F3F4F6; --surface: #FFFFFF; --surface-2: #F6F7F9; --ink: #1B1F24; --ink-2: #4F5763; --ink-3: #626A76;
+  --line: #E0E3E8; --accent: #2160C4; --accent-ink: #FFFFFF; --accent-soft: #E5EDFA; --good: #146F40;
+  --code-bg: #1E242C; --code-ink: #E6EBF1; --logo-tile: #2160C4; --logo-fg: #FFFFFF; --logo-acc: #7CF0B6;
+  --font: "Plus Jakarta Sans", system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
+  --mono: ui-monospace, "SF Mono", "Cascadia Mono", Consolas, monospace;
+  --r-lg: 20px; --r-md: 14px; --r-sm: 10px; color-scheme: light;
+}
+@media (prefers-color-scheme: dark) {
+  :root { --bg: #0E141B; --surface: #17202A; --surface-2: #1C2631; --ink: #E8EDF3; --ink-2: #AEB8C4; --ink-3: #95A0AD;
+    --line: #273342; --accent: #79AEFF; --accent-ink: #0B1A30; --accent-soft: #1B2B42; --good: #6FD39C; --logo-tile: #2F6FD6; color-scheme: dark; }
+}
+* { box-sizing: border-box; }
+body { margin: 0; background: var(--bg); color: var(--ink); font: 16px/1.6 var(--font); -webkit-font-smoothing: antialiased; }
+a { color: var(--accent); }
+code { font-family: var(--mono); font-size: .9em; background: var(--surface-2); border: 1px solid var(--line); border-radius: 6px; padding: 1px 6px; }
+.wrap { max-width: 1080px; margin: 0 auto; padding: 0 16px; }
+.mute { color: var(--ink-3); }
+.small { font-size: 14px; }
+
+.site-top { position: sticky; top: 0; z-index: 2; background: color-mix(in srgb, var(--bg) 88%, transparent); backdrop-filter: blur(12px);
+  border-bottom: 1px solid var(--line); }
+.site-top nav { display: flex; flex-wrap: wrap; align-items: center; gap: 8px 20px; min-height: 60px; }
+.mark { display: inline-flex; align-items: center; gap: 10px; font-weight: 700; color: var(--ink); text-decoration: none; }
+.mark svg { flex: none; }
+.links { display: flex; flex-wrap: wrap; gap: 4px 18px; margin-right: auto; }
+.links a { color: var(--ink-2); text-decoration: none; font-weight: 500; }
+.links a:hover { color: var(--ink); }
+.btn { display: inline-flex; align-items: center; justify-content: center; min-height: 40px; padding: 0 16px; border-radius: 999px;
+  font-weight: 600; text-decoration: none; color: var(--accent); background: var(--accent-soft); }
+.btn.primary { background: var(--accent); color: var(--accent-ink); }
+.btn.big { min-height: 48px; padding: 0 22px; font-size: 17px; }
+.btn:focus-visible, a:focus-visible, summary:focus-visible { outline: 3px solid var(--accent); outline-offset: 2px; }
+
+.hero { padding: 72px 0 48px; }
+.hero h1 { font-size: clamp(32px, 5vw, 52px); line-height: 1.12; letter-spacing: -.02em; margin: 0 0 18px; max-width: 18ch; }
+.lede { font-size: 18px; color: var(--ink-2); max-width: 62ch; margin: 0 0 24px; }
+.cta-row { display: flex; flex-wrap: wrap; gap: 12px; }
+
+.band { padding: 48px 0; border-top: 1px solid var(--line); }
+.band h2 { font-size: clamp(24px, 3vw, 32px); letter-spacing: -.01em; line-height: 1.2; margin: 0 0 12px; }
+.grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(260px, 1fr)); gap: 16px; }
+.card { background: var(--surface); border: 1px solid var(--line); border-radius: var(--r-lg); padding: 20px; }
+.card h3 { font-size: 18px; margin: 0 0 6px; }
+.card p { margin: 0 0 8px; color: var(--ink-2); }
+.card .covers { font-size: 14px; color: var(--ink-3); margin: 0; }
+.receipt b { display: block; font-size: 32px; letter-spacing: -.02em; }
+.receipt span { display: block; }
+.receipt .source { font-size: 14px; color: var(--ink-3); margin-top: 6px; }
+.steps { list-style: none; padding: 0; margin: 0 0 24px; display: grid; grid-template-columns: repeat(auto-fit, minmax(180px, 1fr)); gap: 12px; }
+.steps li { background: var(--surface); border: 1px solid var(--line); border-radius: var(--r-md); padding: 14px 16px; display: grid; gap: 2px; }
+.steps .n { display: inline-grid; place-items: center; width: 28px; height: 28px; border-radius: 50%; background: var(--accent-soft); color: var(--accent); font-weight: 700; }
+.steps .time { color: var(--ink-3); font-size: 14px; }
+.tbl { overflow-x: auto; background: var(--surface); border: 1px solid var(--line); border-radius: var(--r-lg); }
+table { border-collapse: collapse; width: 100%; min-width: 560px; font-size: 15px; }
+th, td { text-align: left; padding: 12px 16px; border-bottom: 1px solid var(--line); vertical-align: top; }
+tr:last-child td { border-bottom: 0; }
+th { font-weight: 650; color: var(--ink-2); }
+.faq details { background: var(--surface); border: 1px solid var(--line); border-radius: var(--r-md); padding: 0 18px; margin-bottom: 10px; }
+.faq summary { cursor: pointer; font-weight: 600; padding: 14px 0; }
+.faq p { margin: 0 0 16px; color: var(--ink-2); }
+.site-foot { border-top: 1px solid var(--line); padding: 28px 0 40px; }
+.site-foot .wrap { display: flex; flex-wrap: wrap; gap: 10px 24px; align-items: center; }
+@media (max-width: 640px) { .hero { padding: 40px 0 32px; } .site-top .links { order: 3; width: 100%; } }
+.after { margin-top: 24px; }

stackvitals-0.1.0.dist-info/METADATA

@@ -0,0 +1,134 @@
+Metadata-Version: 2.5
+Name: stackvitals
+Version: 0.1.0
+Summary: Free, open-source developer suite: CI health, team flow, dependencies, community, and MergeScout for contributors.
+License-Expression: Apache-2.0
+License-File: LICENSE
+License-File: NOTICE
+Keywords: ci,developer-tools,flaky-tests,github-actions,mcp
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.11
+Requires-Dist: defusedxml>=0.7
+Requires-Dist: httpx>=0.27
+Requires-Dist: mcp<3,>=2.3
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: tzdata>=2024.1; sys_platform == 'win32'
+Requires-Dist: zstandard>=0.23
+Provides-Extra: crawl
+Requires-Dist: orjson>=3.10; extra == 'crawl'
+Requires-Dist: pyarrow>=17; extra == 'crawl'
+Provides-Extra: dev
+Requires-Dist: duckdb<3,>=1.3; extra == 'dev'
+Requires-Dist: orjson>=3.10; extra == 'dev'
+Requires-Dist: pyarrow>=17; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: pytz; extra == 'dev'
+Provides-Extra: pipeline
+Requires-Dist: duckdb<3,>=1.3; extra == 'pipeline'
+Requires-Dist: orjson>=3.10; extra == 'pipeline'
+Requires-Dist: pyarrow>=17; extra == 'pipeline'
+Requires-Dist: pytz; extra == 'pipeline'
+Provides-Extra: sql
+Requires-Dist: duckdb<3,>=1.3; extra == 'sql'
+Description-Content-Type: text/markdown
+
+# StackVitals
+
+[![PyPI](https://img.shields.io/pypi/v/stackvitals)](https://pypi.org/project/stackvitals/)
+[![GitHub Marketplace](https://img.shields.io/badge/Marketplace-StackVitals-green?logo=github)](https://github.com/marketplace/actions/stackvitals)
+[![Tests](https://github.com/stackvitals/stackvitals/actions/workflows/tests.yml/badge.svg)](https://github.com/stackvitals/stackvitals/actions/workflows/tests.yml)
+
+A free, open-source developer suite for GitHub: CI health and flaky tests, pull request flow, delivery and DORA,
+dependencies, community health and an org portal. It runs in your own GitHub Actions and keeps its history in your own
+repo: no StackVitals-hosted backend, account or subscription, and optional integrations use services and keys you
+choose. GitHub's built-in token covers every module in a repo; an org's private repos in the Portal need a read-only
+App, and org-wide Copilot usage an org token. Actions minutes on private repos are billed by GitHub as usual
+([docs/scaling.md](docs/scaling.md#actions-minutes-private-repos)). The rules behind its verdicts are checked on public
+data, with the losses published.
+
+Every run publishes an app on your repo's GitHub Pages (or `stackvitals ui owner/repo` on your machine): one page per
+module, decisions and settings saved straight from the browser, setup for more repos in a few clicks once GitHub is
+connected (connecting takes one token, made from a prefilled GitHub page; Pages are turned on for public repos), and a demo at
+`?demo=1`. [docs/app.md](docs/app.md) walks through it.
+
+Install it as the GitHub Action `stackvitals/stackvitals@v0` (also on the
+[GitHub Marketplace](https://github.com/marketplace/actions/stackvitals)), or the CLI and MCP server from PyPI:
+`pip install stackvitals` (or run it without installing: `uvx stackvitals`).
+
+<!-- mcp-name: io.github.stackvitals/stackvitals -->
+
+## Three things it gets right that others get wrong
+
+Measured on public repos beside the rules other tools use ([docs/accuracy.md](docs/accuracy.md)):
+
+- **Where you deploy from.** With no setup, StackVitals named the right deployment source for 53 of 60 repos (30 of
+  35 held out). On the same 60, DevLake's default pattern got 9 and a pattern a user would typically write got 22. A
+  wrong source makes every DORA number wrong.
+- **Who answered an issue.** Of the first comments by non-maintainers that the github/issue-metrics action counts as
+  the answer, 46% are drive-bys (40-52%, held-out repos). StackVitals counts the project's answers: maintainers,
+  regular responders and triagers.
+- **Whether AI help changed anything.** Agents' pull requests look 9 points less likely than people's to be merged by someone else.
+  Compared within the same repo, month and size, the gap is +0.5 points (0.0 to +1.1): most of the raw gap comes
+  from which repos agents work in and the size of their changes.
+
+It publishes what failed too. Of the failures an old rule called safe to re-run, 44% (15 of 34) were caused by the
+change. The tightened rule still got 13 of 81 held-out calls wrong (16%). A stricter one (a flake's sign in the log,
+no changed file named) got none of 4 fresh calls wrong, too few to show 5%, so nothing is called safe: likely flakes
+are re-run, never passed by the check. Each sample was labelled by two
+model families (Claude and Gemini); no person has audited the labels.
+
+## What you see first
+
+When CI fails on a pull request, one comment sorts each failure, from the repo's own CI history:
+
+> **StackVitals: about this CI failure**
+> 1 of 3 failure(s) look like flakes; the rest need a look.
+>
+> | Verdict | What failed | Why |
+> |---|---|---|
+> | Likely flaky | test `t::flaky_one` | flaked 6 times in 80 runs in the last 30 days, last 2026-10-20, and the message shows a flake's sign ("TimeoutError"): looks like a flake, check the error, then re-run it |
+> | New | test `t::new_one` | no earlier flakes: likely from this change (fails with "assert result == 2") |
+> | Already failing on main | test `t::broken_one` | also failing on the default branch, not caused by this change |
+
+The verdict check still blocks until CI is green: a known flake is re-run, never waved through.
+
+## Modules
+
+| Module | What it answers | Status |
+|---|---|---|
+| **[CI Health](docs/modules.md#ci-health)** | Which jobs and tests are flaky or slowing down, who owns them, coverage and patch coverage | stable |
+| **[Team Flow](docs/modules.md#team-flow)** | Who has to act next on each pull request, and how long reviews take | stable |
+| **[Delivery](docs/modules.md#delivery-cycle-time-and-dora)** | Cycle time split into coding, pickup, review and deploy (LinearB's phases), DORA's five metrics, AI-assisted work compared like with like | stable |
+| **[Insights](docs/modules.md#insights-what-to-fix-first)** | What to fix first across modules, ranked by hours lost, with alerts and a weekly digest | stable |
+| **[Dependency Steward](docs/modules.md#dependency-steward)** | Known vulnerabilities and malware in the lockfiles OSV-Scanner reads (npm, PyPI, Go, Rust, Maven, Ruby, .NET, PHP and more; 65 of 100 sampled repos had one); whether to add, keep or upgrade a package, with upgrade evidence from public repos | preview |
+| **[Community](docs/modules.md#community)** | Where newcomers drop out, how fast they get an answer, who carries the work | stable |
+| **[Portal](docs/modules.md#portal)** | A lightweight catalog on GitHub alone: what an org owns, who owns it (checked), scorecards, golden paths and an org-wide view | preview |
+| **Explore** | SQL over your repo's data in the browser, with links to share a query | preview |
+| **[Contribute](docs/modules.md#contribute-mergescout)** | Open-source issues an outsider can realistically get merged | stable |
+
+Stable: measured, reviewed and used on the sandbox for every release. Preview: built and tested, but newer or measured on
+less; its behaviour may still change.
+
+**Works with** Jira Cloud, Linear, PagerDuty, incident.io, Copilot usage reports, Slack, Teams, Discord, Discourse,
+test reports from other CI systems, Backstage, and DevLake's tables ([docs/connectors.md](docs/connectors.md)). AI
+agents get every module through one MCP server (11 core tools by default, all 35 with `--tools all`).
+
+## Start
+
+- **Five minutes:** [docs/quickstart.md](docs/quickstart.md). Try CI Health on any public repo first (needs
+  [uv](https://docs.astral.sh/uv/) and `gh auth login` or a `GITHUB_TOKEN`):
+  `uvx stackvitals ci report owner/repo --days 14 --html ./ci-report`.
+- **By role:** [engineering managers](docs/guides/manager.md), [maintainers](docs/guides/maintainer.md),
+  [platform teams](docs/guides/platform.md).
+- **Before you rely on it:** [what each rule does](docs/rules.md), [known limitations](docs/limitations.md),
+  [what leaves your repo](docs/privacy.md), [threat model](docs/threat-model.md), [enterprise controls](docs/enterprise.md).
+- **More:** [FAQ](docs/faq.md), [how it works](docs/architecture.md), [roadmap](docs/roadmap.md),
+  [contributing](CONTRIBUTING.md), [governance](GOVERNANCE.md), [security](SECURITY.md).