Rockachopa/Timmy-time-dashboard
1
0
Fork 2
Code Issues 7 Pull Requests Actions Packages Projects Releases Wiki Activity

[Refactor] Refactor ops-helpers.sh into Modulated Command-Line Interface #1416

New Issue
Closed
opened 2026-03-24 13:04:30 +00:00 by Timmy · 1 comment
Timmy commented 2026-03-24 13:04:30 +00:00
Owner
Copy Link

Context: Shell scripts alias are difficult to test and structure organically.

Acceptance Criteria:

  • Rewrite the core ops behaviors into Python using typer or click.
  • Install via pip install -e offering a unified CLI command (e.g., hermes <command>).
**Context:** Shell scripts alias are difficult to test and structure organically. **Acceptance Criteria:** - Rewrite the core ops behaviors into Python using `typer` or `click`. - Install via `pip install -e` offering a unified CLI command (e.g., `hermes <command>`).
Timmy commented 2026-03-24 15:07:06 +00:00
Author
Owner
Copy Link

KIMI IMPLEMENTATION INSTRUCTIONS:

Refactor ops-helpers.sh into a modern Python CLI using typer. This will make operations testable and more maintainable.

FILES TO CREATE:

src/cli/__init__.py
src/cli/main.py
src/cli/commands/__init__.py
src/cli/commands/ops.py
src/cli/commands/agents.py
src/cli/commands/monitoring.py
tests/cli/test_main.py
tests/cli/test_ops_commands.py

FILES TO MODIFY:

pyproject.toml (add console_scripts entry)
scripts/ops-helpers.sh (deprecation notice)

STEP-BY-STEP IMPLEMENTATION:

  1. Create CLI Structure (src/cli/main.py):

    • Use typer for the main CLI application
    • Add hermes as the main command with subcommands
    • Include proper help text and version information
    • Add common options (--verbose, --config-path)

  2. Migrate Shell Functions (src/cli/commands/ops.py):

    • Convert each ops-helpers.sh function to a typer command
    • Preserve exact behavior but with proper error handling
    • Add input validation and type hints
    • Include proper logging and output formatting

  3. Add Agent Commands (src/cli/commands/agents.py):

    • Commands for starting/stopping agent loops
    • Status checking and health monitoring
    • Log viewing and debugging helpers

  4. Update Installation (pyproject.toml):

    • Add console_scripts entry: hermes = src.cli.main:app
    • Add typer dependency to requirements
    • Ensure proper package structure

  5. Add Comprehensive Tests (tests/cli/):

    • Test all CLI commands with various inputs
    • Test error conditions and edge cases
    • Use typer's testing utilities
    • Ensure backward compatibility

CLI STRUCTURE:

hermes --help
hermes ops --help (replaces ops-helpers.sh functions)
hermes agents start/stop/status
hermes monitoring dashboard/logs/health

VERIFICATION:

  • pip install -e . should install hermes command
  • hermes --help should show all subcommands
  • All previous ops-helpers.sh functionality should work via hermes ops
  • Run tox -e unit - all tests must pass

CRITICAL: Preserve all existing functionality while making it testable and maintainable.

PROCEED WITH IMPLEMENTATION.

**KIMI IMPLEMENTATION INSTRUCTIONS:** Refactor ops-helpers.sh into a modern Python CLI using typer. This will make operations testable and more maintainable. **FILES TO CREATE:** ``` src/cli/__init__.py src/cli/main.py src/cli/commands/__init__.py src/cli/commands/ops.py src/cli/commands/agents.py src/cli/commands/monitoring.py tests/cli/test_main.py tests/cli/test_ops_commands.py ``` **FILES TO MODIFY:** ``` pyproject.toml (add console_scripts entry) scripts/ops-helpers.sh (deprecation notice) ``` **STEP-BY-STEP IMPLEMENTATION:** 1. **Create CLI Structure** (`src/cli/main.py`): - Use typer for the main CLI application - Add `hermes` as the main command with subcommands - Include proper help text and version information - Add common options (--verbose, --config-path) 2. **Migrate Shell Functions** (`src/cli/commands/ops.py`): - Convert each ops-helpers.sh function to a typer command - Preserve exact behavior but with proper error handling - Add input validation and type hints - Include proper logging and output formatting 3. **Add Agent Commands** (`src/cli/commands/agents.py`): - Commands for starting/stopping agent loops - Status checking and health monitoring - Log viewing and debugging helpers 4. **Update Installation** (`pyproject.toml`): - Add console_scripts entry: `hermes = src.cli.main:app` - Add typer dependency to requirements - Ensure proper package structure 5. **Add Comprehensive Tests** (`tests/cli/`): - Test all CLI commands with various inputs - Test error conditions and edge cases - Use typer's testing utilities - Ensure backward compatibility **CLI STRUCTURE:** ``` hermes --help hermes ops --help (replaces ops-helpers.sh functions) hermes agents start/stop/status hermes monitoring dashboard/logs/health ``` **VERIFICATION:** - `pip install -e .` should install `hermes` command - `hermes --help` should show all subcommands - All previous ops-helpers.sh functionality should work via `hermes ops` - Run `tox -e unit` - all tests must pass **CRITICAL:** Preserve all existing functionality while making it testable and maintainable. PROCEED WITH IMPLEMENTATION.
kimi was assigned by Timmy 2026-03-24 15:07:14 +00:00
kimi was unassigned by Timmy 2026-03-24 19:32:20 +00:00
Timmy closed this issue 2026-03-24 21:54:09 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
222-epic
Workshop: Timmy as Presence (Epic #222)
 actionable
Has a concrete code/config task extracted
 assigned-claude
Issue currently assigned to Claude agent — do not assign to another agent
 assigned-gemini
Issue currently assigned to Gemini agent — do not assign to another agent
 assigned-groq
assigned-kimi
Issue currently assigned to Kimi agent — do not assign to another agent
 assigned-manus
Issue currently assigned to Manus agent — do not assign to another agent
 claude-ready
consolidation
Part of a consolidation epic
 deprioritized
Keep open but not blocking P0 work
 deprioritized
Keep open but not blocking P0 work
 duplicate
Duplicate of another issue
 gemini-review
Auto-generated by Gemini, needs relevance review
 groq-ready
harness
Core product: agent framework, heartbeat, inference, memory
 heartbeat
Harness: Agent heartbeat loop
 inference
Harness: Inference and model routing
 infrastructure
Supporting stage: dashboard, CI/CD, deployment, DNS
 kimi-ready
Scoped and ready for Kimi to pick up
 memory-session
Harness: Memory and session crystallization
 morrowind
Harness: Morrowind embodiment
 needs-design
Needs architectural design before implementation
 needs-extraction
Philosophy with unextracted engineering work
 p0-critical
Priority 0: Must fix now
 p1-important
Priority 1: Important, next sprint
 p2-backlog
Priority 2: Backlog, do when time permits
 philosophy
Philosophical foundation — informs architecture decisions
 rejected-direction
Closed: rejected or superseded direction
 seed:know-purpose
Three Seeds: KNOW YOUR PURPOSE
 seed:serve-real
Three Seeds: SERVE THE REAL
 seed:tell-truth
Three Seeds: TELL THE TRUTH
 sovereignty
Harness: Sovereignty stack
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
Timmy claude grok kimi manus perplexity Rockachopa
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Rockachopa/Timmy-time-dashboard#1416
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?