Refactor package layout for PyPI distribution

Author: TimeLovercc

.gitignore

@@ -1 +1,6 @@
 __pycache__/
+*.egg-info/
+dist/
+build/
+venv/
+/venv/

CLAUDE_CODE_REDESIGN.md

@@ -24,7 +24,7 @@ Redesign the Sleepless Agent to use **Claude Code CLI** instead of direct Claude
 - `src/monitor.py` - Health monitoring (no changes)
 - `src/results.py` - Result storage (no changes)
 - `src/models.py` - Data models (minor additions)
-- `src/daemon.py` - Main loop (changes for new executor)
+- `sleepless_agent/daemon.py` - Main loop (changes for new executor)
 
 ## What Changes
 
@@ -399,7 +399,7 @@ Remove `ClaudeConfig` with API key requirement.
 
 ### 5. Daemon Integration Changes
 
-#### Updated `src/daemon.py` - `SleepleassAgent.__init__()`
+#### Updated `sleepless_agent/daemon.py` - `SleepleassAgent.__init__()`
 
 ```python
 def __init__(self):
@@ -433,7 +433,7 @@ def __init__(self):
     # ... rest of initialization
 ```
 
-#### Updated `src/daemon.py` - `_execute_task()`
+#### Updated `sleepless_agent/daemon.py` - `_execute_task()`
 
 ```python
 async def _execute_task(self, task):

GETTING_STARTED.md

@@ -70,7 +70,7 @@ Fill in:
 ### 5. Run Agent
 
 ```bash
-python -m src.daemon
+python -m sleepless_agent.daemon
 ```
 
 You should see:
@@ -311,7 +311,7 @@ Filename: idea_{task_id}_{timestamp}.md
 cat .env | grep -E "SLACK|ANTHROPIC"
 
 # 2. Bot is running
-pgrep -f "src.daemon"
+pgrep -f "sleepless_agent.daemon"
 
 # 3. Logs
 tail -50 logs/agent.log | grep ERROR
@@ -328,7 +328,7 @@ ls -la ./workspace
 # Should be readable/writable
 
 # Try manual tool test:
-python -c "from src.tools import ToolExecutor; t = ToolExecutor('./workspace'); print(t.list_files())"
+python -c "from sleepless_agent.tools import ToolExecutor; t = ToolExecutor('./workspace'); print(t.list_files())"
 ```
 
 ### Git commits fail

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Context Machine Lab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

Makefile

@@ -21,17 +21,17 @@ setup:
 	@echo "✓ Setup complete. Edit .env with your tokens"
 
 run:
-	python -m src.daemon
+	python -m sleepless_agent.daemon
 
 dev:
-	PYTHONUNBUFFERED=1 python -m src.daemon
+	PYTHONUNBUFFERED=1 python -m sleepless_agent.daemon
 
 logs:
 	tail -f logs/agent.log
 
 test:
 	@echo "Testing imports..."
-	python -c "from src.daemon import SleepleassAgent; print('✓ Imports OK')"
+	python -c "from sleepless_agent.daemon import SleepleassAgent; print('✓ Imports OK')"
 
 db:
 	sqlite3 data/tasks.db "SELECT id, description, status, priority FROM tasks LIMIT 10;"
@@ -78,7 +78,7 @@ stats:
 
 status:
 	@echo "=== Agent Status ==="
-	@pgrep -f "src.daemon" > /dev/null && echo "✓ Daemon running" || echo "✗ Daemon not running"
+	@pgrep -f "sleepless_agent.daemon" > /dev/null && echo "✓ Daemon running" || echo "✗ Daemon not running"
 	@test -f .env && echo "✓ .env configured" || echo "✗ .env missing"
 	@test -f data/tasks.db && echo "✓ Database exists" || echo "✗ Database missing"
 	@echo ""

QUICK_REFERENCE.md

@@ -30,7 +30,7 @@ cp .env.example .env
 nano .env  # Add SLACK and ANTHROPIC tokens
 
 # 3. Run
-python -m src.daemon
+python -m sleepless_agent.daemon
 ```
 
 ## Slack App Setup
@@ -67,17 +67,19 @@ Slack → SlackBot → TaskQueue (SQLite)
 
 ```
 src/
-├── daemon.py          Main event loop
-├── bot.py             Slack interface
-├── task_queue.py      Task management
-├── claude_executor.py Claude API + tools
-├── tools.py           File/bash operations
-├── scheduler.py       Smart scheduling
-├── git_manager.py     Git automation
-├── monitor.py         Health & metrics
-├── models.py          Database models
-├── config.py          Config management
-├── results.py         Result storage
+└── sleepless_agent/
+    ├── __init__.py          Package metadata
+    ├── daemon.py            Main event loop
+    ├── bot.py               Slack interface
+    ├── task_queue.py        Task management
+    ├── claude_executor.py   Claude API + tools
+    ├── claude_code_executor.py  Claude CLI wrapper
+    ├── tools.py             File/bash operations
+    ├── scheduler.py         Smart scheduling
+    ├── git_manager.py       Git automation
+    ├── monitor.py           Health & metrics
+    ├── models.py            Database models
+    └── results.py           Result storage
 ```
 
 ## Configuration
@@ -237,7 +239,7 @@ DEBUG=false
 
 1. Read GETTING_STARTED.md for detailed setup
 2. Configure .env with your tokens
-3. Run: `python -m src.daemon`
+3. Run: `python -m sleepless_agent.daemon`
 4. Test commands in Slack
 5. Deploy as service using Makefile
 6. Monitor with `/health` and `/metrics`

README.md

@@ -2,6 +2,12 @@
 
 A 24/7 AI assistant daemon that continuously works on tasks via Slack. Uses Claude Code CLI to process both random thoughts and serious jobs automatically with isolated workspaces.
 
+## About
+- Maintained by Context Machine Lab
+- Ships as `sleepless-agent` on PyPI (`pip install sleepless-agent`)
+- Automates task intake, execution, and reporting via Slack + Claude integration
+- Designed for continuous operation with isolated workspaces and automated git hygiene
+
 ## Features
 
 - 🤖 **Continuous Operation**: Runs 24/7 daemon, always ready for new tasks
@@ -68,12 +74,17 @@ Optional:
 
 ```bash
 # Terminal 1: Start the daemon
-python -m src.daemon
+python -m sleepless_agent.daemon
 
 # Terminal 2 (optional): Monitor logs
 tail -f logs/agent.log
 ```
 
+## Releases
+- Latest stable: **0.1.0** – published on [PyPI](https://pypi.org/project/sleepless-agent/0.1.0/)
+- Install or upgrade with `pip install -U sleepless-agent`
+- Release notes and changelog are tracked via GitHub Releases (tag `v0.1.0` onward)
+
 ## Slack Commands
 
 ### Task Management
@@ -265,8 +276,7 @@ sqlite3 data/tasks.db "SELECT * FROM tasks;"
 
 **Database locked?**
 - Close all other connections to tasks.db
-- Try: `rm data/tasks.db && python -m src.daemon`
+- Try: `rm data/tasks.db && python -m sleepless_agent.daemon`
 
 ## License
-
-MIT
+- Released under the [MIT License](LICENSE)

com.sleepless-agent.plist

@@ -8,7 +8,7 @@
 	<array>
 		<string>/usr/local/bin/python3</string>
 		<string>-m</string>
-		<string>src.daemon</string>
+		<string>sleepless_agent.daemon</string>
 	</array>
 	<key>WorkingDirectory</key>
 	<string>/Users/YOUR_USERNAME/projects/sleepless-agent</string>

pyproject.toml

@@ -6,6 +6,20 @@ build-backend = "setuptools.build_meta"
 name = "sleepless-agent"
 version = "0.1.0"
 description = "24/7 AI agent that maximizes Claude usage via Slack interface"
+readme = "README.md"
+authors = [{name = "Sleepless Agent Maintainers"}]
+license = {file = "LICENSE"}
+keywords = ["ai", "automation", "agents", "slack", "anthropic"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "License :: OSI Approved :: MIT License",
+    "Topic :: Communications :: Chat",
+    "Topic :: Office/Business",
+]
 requires-python = ">=3.11"
 dependencies = [
     "anthropic>=0.34.4",
@@ -19,4 +33,15 @@ dependencies = [
 ]
 
 [project.scripts]
-sleepless-agent = "src.daemon:main"
+sleepless-agent = "sleepless_agent.daemon:main"
+
+[project.urls]
+Homepage = "https://github.com/context-machine-lab/sleepless-agent"
+Repository = "https://github.com/context-machine-lab/sleepless-agent"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["sleepless_agent*"]

sleepless-agent.service

@@ -6,7 +6,7 @@ After=network.target
 Type=simple
 User=sleepless
 WorkingDirectory=/opt/sleepless-agent
-ExecStart=/opt/sleepless-agent/venv/bin/python -m src.daemon
+ExecStart=/opt/sleepless-agent/venv/bin/python -m sleepless_agent.daemon
 Restart=on-failure
 RestartSec=10
 StandardOutput=journal