feat: automation opportunity finder (#170) #193

Closed
Rockachopa wants to merge 0 commits from burn/170-1776263897 into main
Owner

Closes #170.

What

Scans the fleet for manual processes that could be automated. Analyzes 5 sources and outputs ranked proposals.

Sources Analyzed

  1. Cron jobs — disabled jobs, erroring jobs, delivery failures, overly frequent schedules
  2. Documentation — TODO/FIXME/MANUAL markers, sequential step patterns, manual keywords
  3. Scripts — repeated shell commands across files (3+ occurrences)
  4. Session transcripts — repeated tool-call sequences (2-3 length patterns)
  5. Shell history — frequently repeated commands

Output

  • Human-readable report with ranked proposals (impact × confidence)
  • JSON mode (--json) for machine consumption
  • Min confidence filter (--min-confidence 0.3)
  • Category filter (--categories cron docs scripts sessions shell)

Usage

# Full report
python3 scripts/automation_opportunity_finder.py --hermes-home ~/.hermes

# JSON output
python3 scripts/automation_opportunity_finder.py --hermes-home ~/.hermes --json

# Save to file
python3 scripts/automation_opportunity_finder.py --hermes-home ~/.hermes --output proposals.json --json

# Docs only
python3 scripts/automation_opportunity_finder.py --hermes-home ~/.hermes --categories docs

Verified

  • 8/8 unit tests pass
  • Produces real findings on live hermes-home (50 proposals found)
  • Completes in ~80s on full hermes-home scan (with directory exclusions)
  • Follows repo conventions (argparse, type hints, --json flag)

Acceptance Criteria

  • Analyzes: cron jobs, manual steps in docs, repeated patterns
  • Identifies: automation candidates with confidence scores
  • Output: automation proposals (JSON + text)
  • Monthly: can be scheduled as cron job with --json --output

Labels

pipeline, automation

Closes #170. ## What Scans the fleet for manual processes that could be automated. Analyzes 5 sources and outputs ranked proposals. ## Sources Analyzed 1. **Cron jobs** — disabled jobs, erroring jobs, delivery failures, overly frequent schedules 2. **Documentation** — TODO/FIXME/MANUAL markers, sequential step patterns, manual keywords 3. **Scripts** — repeated shell commands across files (3+ occurrences) 4. **Session transcripts** — repeated tool-call sequences (2-3 length patterns) 5. **Shell history** — frequently repeated commands ## Output - Human-readable report with ranked proposals (impact × confidence) - JSON mode (`--json`) for machine consumption - Min confidence filter (`--min-confidence 0.3`) - Category filter (`--categories cron docs scripts sessions shell`) ## Usage ```bash # Full report python3 scripts/automation_opportunity_finder.py --hermes-home ~/.hermes # JSON output python3 scripts/automation_opportunity_finder.py --hermes-home ~/.hermes --json # Save to file python3 scripts/automation_opportunity_finder.py --hermes-home ~/.hermes --output proposals.json --json # Docs only python3 scripts/automation_opportunity_finder.py --hermes-home ~/.hermes --categories docs ``` ## Verified - 8/8 unit tests pass - Produces real findings on live hermes-home (50 proposals found) - Completes in ~80s on full hermes-home scan (with directory exclusions) - Follows repo conventions (argparse, type hints, `--json` flag) ## Acceptance Criteria - [x] Analyzes: cron jobs, manual steps in docs, repeated patterns - [x] Identifies: automation candidates with confidence scores - [x] Output: automation proposals (JSON + text) - [x] Monthly: can be scheduled as cron job with `--json --output` ## Labels `pipeline`, `automation`
Rockachopa added 3 commits 2026-04-15 15:11:35 +00:00
Analyzes cron jobs, docs, scripts, session transcripts, and shell history to find manual processes that could be automated.

Outputs ranked proposals with confidence scores and impact ratings.
Timmy approved these changes 2026-04-15 16:33:11 +00:00
Timmy left a comment
Owner

LGTM. Automation opportunity finder scans for manual processes across cron jobs, docs, scripts, and session transcripts. Well-structured analysis with pattern detection for TODO/FIXME/manual-step markers and shell command sequences. Approved.

LGTM. Automation opportunity finder scans for manual processes across cron jobs, docs, scripts, and session transcripts. Well-structured analysis with pattern detection for TODO/FIXME/manual-step markers and shell command sequences. Approved.
Author
Owner

Closing as this PR cannot be merged (branch protection or conflicts). Please reopen if needed.

Closing as this PR cannot be merged (branch protection or conflicts). Please reopen if needed.
Rockachopa closed this pull request 2026-04-16 01:42:06 +00:00
Author
Owner

Closing as this PR cannot be merged (branch protection or conflicts). Please reopen if needed.

Closing as this PR cannot be merged (branch protection or conflicts). Please reopen if needed.
Author
Owner

Closing: unmergeable due to conflicts or branch protection. Reopen if needed.

Closing: unmergeable due to conflicts or branch protection. Reopen if needed.
Author
Owner

Closing: unmergeable due to conflicts or branch protection. Reopen if needed.

Closing: unmergeable due to conflicts or branch protection. Reopen if needed.
Author
Owner

Closing: unmergeable due to conflicts or branch protection. Reopen if needed.

Closing: unmergeable due to conflicts or branch protection. Reopen if needed.
Rockachopa reopened this pull request 2026-04-16 02:03:28 +00:00
Rockachopa closed this pull request 2026-04-16 02:14:03 +00:00
Rockachopa reopened this pull request 2026-04-16 02:42:10 +00:00
Rockachopa closed this pull request 2026-04-16 02:52:35 +00:00

Pull request closed

Sign in to join this conversation.