📦 @goodandready/dsh-goal

---

⚡ Overview & The Problem

Complex engineering tasks require multi-step autonomy: decomposing high-level objectives into milestones, executing successive iterations without manual user re-prompting, and maintaining clear visibility into task progress.

@goodandready/dsh-goal brings autonomous goal execution to DeepSeek Harness via the /goal command:

• 🎯 Sticky Top Goal Banner: Pinned status header with live timer (• 2s, • 1m 45s), active goal title, and interactive control buttons.
• ⏸️ Play / Pause / Cancel: Instantly pause the autonomous loop or resume execution on demand.
• 📋 Milestone Breakdown Drawer: Interactive checklist showing sub-tasks, percentage completion, and iteration logs.
• 🤖 Autonomous Agent Tools: Provides goal_set_milestones, goal_update_progress, and goal_finish tools directly to the agent.
• 🛡️ Safety Guardrails: Configurable maxIterations limit to prevent runaway loops.

---

🏛️ Architecture

graph TD
    subgraph Input ["User Interaction"]
        Cmd["Slash Command: /goal <objective>"]
        API["REST API: POST /dsh-goal/action"]
    end

    subgraph GoalEngine ["Goal Lifecycle Engine (lib/index.js)"]
        State["State Manager (IDLE, RUNNING, PAUSED, COMPLETED)"]
        Milestones["Milestone Tracker & Decomposition"]
        Disk["Persistence Store (~/.dsh/goal-state.json)"]
    end

    subgraph AgentLoop ["Autonomous Agent Drive"]
        ToolSet["goal_set_milestones"]
        ToolProgress["goal_update_progress"]
        ToolFinish["goal_finish"]
        LimitGuard{"maxIterations Guard"}
    end

    subgraph UI ["DSH Web Interface"]
        Banner["Sticky Top Goal Banner"]
        Timer["Live Elapsed Timer"]
        Drawer["Milestone Checklist Modal"]
        Settings["Settings Card (Schemastery)"]
    end

    Cmd --> GoalEngine
    API --> GoalEngine
    GoalEngine --> State
    State --> Disk
    State --> Banner
    State --> Drawer
    GoalEngine --> AgentLoop
    AgentLoop --> LimitGuard
    ToolSet --> GoalEngine
    ToolProgress --> GoalEngine
    ToolFinish --> GoalEngine

---

📦 Installation

dsh plugin --profile web add @goodandready/dsh-goal

Restart your DeepSeek Harness instance and refresh the browser.

---

💬 Usage & Quick Start

Start a goal directly in chat:

/goal Refactor the authentication middleware and add integration tests

Or trigger via REST API:

curl -X POST http://localhost:3080/dsh-goal/action \
  -H "Content-Type: application/json" \
  -d '{"action":"start","title":"Optimize database queries"}'

---

⚙️ Configuration Reference (settings.yaml)

dsh-goal:
  maxIterations: 25
  autoDrive: true
  enableSound: true

Parameter	Type	Default	Description
maxIterations	number	25	Safety limit: maximum autonomous iterations per goal
autoDrive	boolean	true	Keep the autonomous agent loop running between turns
enableSound	boolean	true	Play completion audio chime when a goal finishes

---

🧪 Testing

Run the automated test suite:

npm test

---

📄 License

MIT © GooDAnDReaDY