Short (~25s), silent, caption-burned screen recording of systats for social media / YouTube: launches the real installed app, records the real running window (real host data, no staged scenario -- Rule 14), and burns timed captions via infrastructure-screencast's captions module. Window find/move/focus is infrastructure-screencast; the one click (expand the top ranked cause) is tools-gui-harness's hardware input.
| Tier | tools |
| Role | unclassified (baselined) |
| Path | crates/tools/demo-systats |
| Edition | 2021 |
| Targets | tools-demo-systats, tools_demo_systats |
| Public items | 3 across 0 modules |
| Tests | 4 |
What it is for
Pure timing/content plan for the systats demo recording. Kept separate from main.rs's I/O orchestration (launch, window control, recording, caption burn) so the schedule itself is unit-tested without touching a display, ffmpeg, or the app (Gate 2: TDD the decidable logic).
Capabilities
crate root
Pure timing/content plan for the systats demo recording. Kept separate
| Item |
|---|
pub const RECORDING_SECS: f64 |
pub const EXPAND_TOP_CAUSE_AT_SECS: f64 |
fn caption_schedule() -> Vec <Caption> |
How to use it
No examples/ target and no doctest in this crate's rustdoc. The tests listed under Verification are the closest executable usage.
Module structure
No public modules: the crate root is its whole surface.
Public surface
`crate root`
| Item | What it is |
|---|---|
pub const RECORDING_SECS: f64 | Total recording length the schedule is designed for |
pub const EXPAND_TOP_CAUSE_AT_SECS: f64 | When (seconds into the recording) the one demo action -- expanding the top "Ranked causes" node -- should fire |
fn caption_schedule() -> Vec <Caption> | The caption schedule for the short (~25s) silent demo cut |
No pub use re-exports: every item above is declared in this crate.
Boundary
Reaches into infrastructure.
Shares tier tools with 84 other crates: tools-advisory-reach, tools-archive-guard, tools-artifact-scaffold, tools-ask-ai-core, tools-ask-ais, tools-ask-gemini, tools-book, tools-book-report, … (84 total).
_What this crate deliberately does NOT own is a judgment. No committed registry records one for it, so none is stated here._
Where it sits
| Tier (ontology) | tools |
| Architectural role (taxonomy) | unclassified (baselined) |
| Location | crates/tools/demo-systats |
| Vocabulary in force (lexicon) | current |
Tier flow. Which tiers this crate's own edges cross.
flowchart LR n_tools["tools"] --> n_infrastructure["infrastructure"]
Dependencies
Runtime, in this workspace.
| Crate | Tier | Optional | Only on |
|---|---|---|---|
| `infrastructure-screencast` | infrastructure | no | always |
| `tools-gui-harness` | tools | no | always |
Runtime, from outside the workspace.
| Crate | Requirement | Features | Optional | Only on |
|---|---|---|---|---|
anyhow | ^1 | — | no | always |
Development. None.
Build. None.
Depended on by. Nothing in this workspace.
Signal flow — what reaches this crate, and what it reaches.
flowchart LR SELF["tools-demo-systats"] SELF -->|runtime| n_infrastructure_screencast["infrastructure-screencast"] SELF -->|runtime| n_tools_gui_harness["tools-gui-harness"] classDef self fill:#1f883d,stroke:#1f883d,color:#fff; class SELF self;
Feature flags
No Cargo features are defined: every capability is unconditional, so no consumer can receive a half-wired crate.
Targets
| Kind | Name | Source |
|---|---|---|
| bin | tools-demo-systats | `src/main.rs` |
| lib | tools_demo_systats | `src/lib.rs` |
Error model
No public error type was detected: no public item declares a type named *Error, and no public signature returns one.
Operational characteristics
| Property | Evidence |
|---|---|
| async public surface | none detected |
| async runtime | none detected |
| database access | none detected |
| network I/O | none detected |
| unsafe code | none detected |
| environment variables | yes |
No unsafe block, unsafe fn, unsafe impl or unsafe trait was found by the parser anywhere in this crate's source.
Configuration
| Variable | Read in |
|---|---|
HOME | src/main.rs |
Related capabilities
No workspace crate depends on this one.
Verification
| Kind | Count |
|---|---|
| Unit tests | 4 |
| Integration tests | 0 |
| Examples | 0 |
| Doctests | 0 |
Evidence by module. How often each public module is named by something executable.
| Module | Tests | Examples | Consumers |
|---|---|---|---|
crate root | 3 | 0 | 0 |
What the tests establish, by name:
boundary_schedule_fits_within_recording_length—src/lib.rsconstraint_captions_never_overlap—src/lib.rsvalid_expand_action_happens_during_its_own_caption_window—src/lib.rsvalid_schedule_has_six_beats_in_order—src/lib.rs
Documentation coverage
| Measure | Documented | Total |
|---|---|---|
| Public items with rustdoc | 3 | 3 |
Public modules with a //! block | 0 | 0 |
pie showData
title Public items with rustdoc
"Documented" : 3
"No rustdoc detected" : 0
Metrics
| Metric | Value |
|---|---|
| Rust source files | 2 |
| Source lines | 243 |
| Code lines | 178 |
| Public API items | 3 |
| Public modules | 0 |
| Tests | 4 |
| Examples | 0 |
| Cargo features | 0 |
| Direct runtime dependencies | 3 |
| Workspace reverse dependencies | 0 |
pie showData
title Public API by kind
"constant" : 2
"function" : 1
pie showData
title Rust source composition
"Code" : 178
"Blank or comment" : 65
Generation
Rendered by tools-corpus corpus readme from repository evidence alone, renderer schema 2, lexicon current. No model, network service or database was consulted. Regenerate with tools-corpus corpus readme --write; verify with --check.