product-manager-agent 0.3.0__tar.gz

product_manager_agent-0.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024–2026 sm-me-uwe
+
+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.

product_manager_agent-0.3.0/PKG-INFO

@@ -0,0 +1,224 @@
+Metadata-Version: 2.4
+Name: product-manager-agent
+Version: 0.3.0
+Summary: Stateful Technical PM Agent — multi-project CLI with persistent per-project context
+Author-email: Sm_mE <mohammad79eshrati@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/sm-me-dev/pm-agent
+Project-URL: Source, https://github.com/sm-me-dev/pm-agent
+Project-URL: Issues, https://github.com/sm-me-dev/pm-agent/issues
+Project-URL: Changelog, https://github.com/sm-me-dev/pm-agent/blob/main/CHANGELOG.md
+Keywords: ai,agent,pm,orchestrator,llm,project-management
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development
+Classifier: Environment :: Console
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: openai>=1.60.0
+Requires-Dist: prompt-toolkit>=3.0.48
+Requires-Dist: rich>=13.7.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Requires-Dist: ruff>=0.4.0; extra == "dev"
+Requires-Dist: mypy>=1.8.0; extra == "dev"
+Dynamic: license-file
+
+# PM-Agent
+
+**Stateful Technical PM Agent** — a CLI tool that brings persistent project-management
+context to AI-assisted development. Each project gets its own configuration, memory,
+decision log, and action audit trail in a local SQLite database.
+
+## Status
+
+Alpha — under active development. The CLI is stable for daily use; the schema and API
+may change before a 1.0 release.
+
+## Key Concepts
+
+```
+my-project/
+  .pm-agent/        ← created by `pm-agent init`
+    project.toml    ← machine-readable project config (commit this)
+    memory.md       ← human-editable notes (commit this)
+    state.db        ← SQLite state DB (gitignored, auto-created)
+    logs/           ← action error logs (gitignored)
+```
+
+### Project Discovery
+
+`pm-agent` walks up from your current directory looking for `.pm-agent/`. If
+found, that directory becomes the project root. If not found, it looks for a
+`.git` directory as a fallback. This means:
+
+- Run `pm-agent status` from any subdirectory of your project.
+- Pass `--project-root /path` to pin an exact root (bypasses discovery).
+- Pass `--repo /path` to set a different starting point for discovery.
+
+### Commands
+
+| Command | Description |
+|---|---|
+| `pm-agent init` | Initialize `.pm-agent/` in the current repo |
+| `pm-agent` / `pm-agent repl` | Start the interactive REPL |
+| `pm-agent status` | Show project state and active config |
+| `pm-agent doctor` | Check environment, config, and permissions |
+| `pm-agent spec show` | Display the project specification |
+| `pm-agent memory show` | Display project memory |
+| `pm-agent memory add <text>` | Append a dated memory entry |
+| `pm-agent migrate` | Import legacy global DB into `.pm-agent/state.db` |
+
+## Installation
+
+Requires **Python 3.12+** and an OpenAI-compatible chat endpoint
+(Ollama, OpenAI, or any compatible API).
+
+### Quick install (recommended)
+
+**Linux / macOS:**
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/sm-me-dev/pm-agent/main/scripts/install.sh | bash
+```
+
+To pin a version:
+
+```bash
+PM_AGENT_VERSION=0.3.0 curl -fsSL https://raw.githubusercontent.com/sm-me-dev/pm-agent/main/scripts/install.sh | bash
+```
+
+**Windows (PowerShell):**
+
+```powershell
+irm https://raw.githubusercontent.com/sm-me-dev/pm-agent/main/scripts/install.ps1 | iex
+```
+
+To pin a version:
+
+```powershell
+$env:PM_AGENT_VERSION = "0.3.0"; irm https://raw.githubusercontent.com/sm-me-dev/pm-agent/main/scripts/install.ps1 | iex
+```
+
+> **Security note:** piping from the web to your shell is convenient but skips
+> normal verification. Review the script before running:
+> - [install.sh](scripts/install.sh)
+> - [install.ps1](scripts/install.ps1)
+
+The installer detects or installs [pipx](https://github.com/pypa/pipx) and
+uses it to install `pm-agent` into an isolated environment.
+
+### pipx (any platform)
+
+```bash
+pipx install product-manager-agent
+```
+
+### From source
+
+```bash
+git clone https://github.com/sm-me-dev/pm-agent.git
+cd pm-agent
+pip install -e ".[dev]"
+```
+
+### Verify
+
+```bash
+pm-agent --help
+```
+
+## Quickstart
+
+```bash
+cd /path/to/your/repo
+pm-agent init            # creates .pm-agent/
+pm-agent                 # starts the REPL
+```
+
+```bash
+pm-agent status          # inspect project state
+pm-agent doctor          # run diagnostics
+pm-agent migrate         # import legacy data if you used pm-agent before v0.3
+```
+
+## Configuration Precedence
+
+1. CLI flags (`--model`, `--db`, `--repo`, etc.)
+2. Environment variables (`PM_AGENT_*`)
+3. `.pm-agent/project.toml` (per-project)
+4. `~/.config/pm-agent/config.toml` (user-global)
+5. Built-in defaults
+
+### Key Environment Variables
+
+| Variable | Default | Description |
+|---|---|---|
+| `PM_AGENT_MODEL` | `glm-5.2` | Model name |
+| `PM_AGENT_BASE_URL` | `http://localhost:11434/v1` | API endpoint |
+| `PM_AGENT_API_KEY` | — | API key |
+| `PM_AGENT_HISTORY_LIMIT` | `75` | Messages in context window |
+| `PM_AGENT_ALWAYS_APPROVE` | `false` | Auto-approve all actions |
+
+## Project Config (`project.toml`)
+
+```toml
+[project]
+name = "my-project"
+language = "python"
+test_command = "pytest"
+lint_command = "ruff check"
+build_command = ""
+
+[constraints]
+allowed_paths = []
+approval_default = "prompt"
+blocked_actions = []
+
+[paths]
+# context_dir = ""
+# error_log_path = ""
+```
+
+## Migration from Legacy Global DB
+
+If you previously used pm-agent with a global state database at
+`~/.local/share/pm-agent/state.db`, migrate to project-local storage:
+
+```bash
+cd /path/to/your/repo
+pm-agent init       # one-time setup
+pm-agent migrate    # copy existing data into .pm-agent/state.db
+```
+
+The migration is idempotent — running it multiple times is safe.
+
+## Safety
+
+- Repository access is read-only by default.
+- External actions require per-payload approval (configurable via rules).
+- All actions are logged with an immutable audit trail.
+
+## Development
+
+```bash
+git clone https://github.com/sm-me-dev/pm-agent.git
+cd pm-agent
+pip install -e ".[dev]"
+pytest
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for full development workflow.
+
+## Release
+
+See [RELEASE.md](RELEASE.md) for the release process.
+
+## License
+
+MIT

product_manager_agent-0.3.0/README.md

@@ -0,0 +1,193 @@
+# PM-Agent
+
+**Stateful Technical PM Agent** — a CLI tool that brings persistent project-management
+context to AI-assisted development. Each project gets its own configuration, memory,
+decision log, and action audit trail in a local SQLite database.
+
+## Status
+
+Alpha — under active development. The CLI is stable for daily use; the schema and API
+may change before a 1.0 release.
+
+## Key Concepts
+
+```
+my-project/
+  .pm-agent/        ← created by `pm-agent init`
+    project.toml    ← machine-readable project config (commit this)
+    memory.md       ← human-editable notes (commit this)
+    state.db        ← SQLite state DB (gitignored, auto-created)
+    logs/           ← action error logs (gitignored)
+```
+
+### Project Discovery
+
+`pm-agent` walks up from your current directory looking for `.pm-agent/`. If
+found, that directory becomes the project root. If not found, it looks for a
+`.git` directory as a fallback. This means:
+
+- Run `pm-agent status` from any subdirectory of your project.
+- Pass `--project-root /path` to pin an exact root (bypasses discovery).
+- Pass `--repo /path` to set a different starting point for discovery.
+
+### Commands
+
+| Command | Description |
+|---|---|
+| `pm-agent init` | Initialize `.pm-agent/` in the current repo |
+| `pm-agent` / `pm-agent repl` | Start the interactive REPL |
+| `pm-agent status` | Show project state and active config |
+| `pm-agent doctor` | Check environment, config, and permissions |
+| `pm-agent spec show` | Display the project specification |
+| `pm-agent memory show` | Display project memory |
+| `pm-agent memory add <text>` | Append a dated memory entry |
+| `pm-agent migrate` | Import legacy global DB into `.pm-agent/state.db` |
+
+## Installation
+
+Requires **Python 3.12+** and an OpenAI-compatible chat endpoint
+(Ollama, OpenAI, or any compatible API).
+
+### Quick install (recommended)
+
+**Linux / macOS:**
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/sm-me-dev/pm-agent/main/scripts/install.sh | bash
+```
+
+To pin a version:
+
+```bash
+PM_AGENT_VERSION=0.3.0 curl -fsSL https://raw.githubusercontent.com/sm-me-dev/pm-agent/main/scripts/install.sh | bash
+```
+
+**Windows (PowerShell):**
+
+```powershell
+irm https://raw.githubusercontent.com/sm-me-dev/pm-agent/main/scripts/install.ps1 | iex
+```
+
+To pin a version:
+
+```powershell
+$env:PM_AGENT_VERSION = "0.3.0"; irm https://raw.githubusercontent.com/sm-me-dev/pm-agent/main/scripts/install.ps1 | iex
+```
+
+> **Security note:** piping from the web to your shell is convenient but skips
+> normal verification. Review the script before running:
+> - [install.sh](scripts/install.sh)
+> - [install.ps1](scripts/install.ps1)
+
+The installer detects or installs [pipx](https://github.com/pypa/pipx) and
+uses it to install `pm-agent` into an isolated environment.
+
+### pipx (any platform)
+
+```bash
+pipx install product-manager-agent
+```
+
+### From source
+
+```bash
+git clone https://github.com/sm-me-dev/pm-agent.git
+cd pm-agent
+pip install -e ".[dev]"
+```
+
+### Verify
+
+```bash
+pm-agent --help
+```
+
+## Quickstart
+
+```bash
+cd /path/to/your/repo
+pm-agent init            # creates .pm-agent/
+pm-agent                 # starts the REPL
+```
+
+```bash
+pm-agent status          # inspect project state
+pm-agent doctor          # run diagnostics
+pm-agent migrate         # import legacy data if you used pm-agent before v0.3
+```
+
+## Configuration Precedence
+
+1. CLI flags (`--model`, `--db`, `--repo`, etc.)
+2. Environment variables (`PM_AGENT_*`)
+3. `.pm-agent/project.toml` (per-project)
+4. `~/.config/pm-agent/config.toml` (user-global)
+5. Built-in defaults
+
+### Key Environment Variables
+
+| Variable | Default | Description |
+|---|---|---|
+| `PM_AGENT_MODEL` | `glm-5.2` | Model name |
+| `PM_AGENT_BASE_URL` | `http://localhost:11434/v1` | API endpoint |
+| `PM_AGENT_API_KEY` | — | API key |
+| `PM_AGENT_HISTORY_LIMIT` | `75` | Messages in context window |
+| `PM_AGENT_ALWAYS_APPROVE` | `false` | Auto-approve all actions |
+
+## Project Config (`project.toml`)
+
+```toml
+[project]
+name = "my-project"
+language = "python"
+test_command = "pytest"
+lint_command = "ruff check"
+build_command = ""
+
+[constraints]
+allowed_paths = []
+approval_default = "prompt"
+blocked_actions = []
+
+[paths]
+# context_dir = ""
+# error_log_path = ""
+```
+
+## Migration from Legacy Global DB
+
+If you previously used pm-agent with a global state database at
+`~/.local/share/pm-agent/state.db`, migrate to project-local storage:
+
+```bash
+cd /path/to/your/repo
+pm-agent init       # one-time setup
+pm-agent migrate    # copy existing data into .pm-agent/state.db
+```
+
+The migration is idempotent — running it multiple times is safe.
+
+## Safety
+
+- Repository access is read-only by default.
+- External actions require per-payload approval (configurable via rules).
+- All actions are logged with an immutable audit trail.
+
+## Development
+
+```bash
+git clone https://github.com/sm-me-dev/pm-agent.git
+cd pm-agent
+pip install -e ".[dev]"
+pytest
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for full development workflow.
+
+## Release
+
+See [RELEASE.md](RELEASE.md) for the release process.
+
+## License
+
+MIT

product_manager_agent-0.3.0/pyproject.toml

@@ -0,0 +1,109 @@
+[build-system]
+requires = ["setuptools >= 77.0.3"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "product-manager-agent"
+version = "0.3.0"
+description = "Stateful Technical PM Agent — multi-project CLI with persistent per-project context"
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+license-files = ["LICEN[CS]E*"]
+authors = [{ name = "Sm_mE", email = "mohammad79eshrati@gmail.com" }]
+keywords = ["ai", "agent", "pm", "orchestrator", "llm", "project-management"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development",
+    "Environment :: Console",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "openai>=1.60.0",
+    "prompt-toolkit>=3.0.48",
+    "rich>=13.7.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/sm-me-dev/pm-agent"
+Source = "https://github.com/sm-me-dev/pm-agent"
+Issues = "https://github.com/sm-me-dev/pm-agent/issues"
+Changelog = "https://github.com/sm-me-dev/pm-agent/blob/main/CHANGELOG.md"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-cov>=5.0",
+    "ruff>=0.4.0",
+    "mypy>=1.8.0",
+]
+
+[project.scripts]
+pm-agent = "pm_agent.__main__:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+"pm_agent.prompts" = ["*.md", "*.json"]
+"pm_agent.infrastructure.sqlite.schema" = ["*.sql"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-q --strict-markers"
+pythonpath = ["src", "."]
+filterwarnings = [
+    "error::DeprecationWarning",
+]
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B", "UP", "W"]
+ignore = ["E501"]
+
+[tool.mypy]
+python_version = "3.12"
+strict = false
+warn_unused_ignores = true
+ignore_missing_imports = true
+
+[[tool.mypy.overrides]]
+module = "pm_agent.infrastructure.models.openai_compatible"
+ignore_errors = true
+
+[[tool.mypy.overrides]]
+module = "pm_agent.presentation.cli"
+ignore_errors = true
+
+[[tool.mypy.overrides]]
+module = "pm_agent.presentation.repl"
+ignore_errors = true
+
+[[tool.mypy.overrides]]
+module = "pm_agent.infrastructure.hosts.integrations"
+ignore_errors = true
+
+[[tool.mypy.overrides]]
+module = "pm_agent.infrastructure.repository.local_analyzer"
+ignore_errors = true
+
+[[tool.mypy.overrides]]
+module = "pm_agent.infrastructure.sqlite.store"
+ignore_errors = true
+
+[[tool.mypy.overrides]]
+module = "pm_agent.presentation.streaming"
+ignore_errors = true
+
+[[tool.mypy.overrides]]
+module = "pm_agent.presentation.input"
+ignore_errors = true

product_manager_agent-0.3.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

product_manager_agent-0.3.0/src/pm_agent/__init__.py

@@ -0,0 +1,7 @@
+"""Stateful Technical PM Agent."""
+
+from .config import AgentConfig
+
+__version__ = "0.3.0"
+
+__all__ = ["AgentConfig", "__version__"]

product_manager_agent-0.3.0/src/pm_agent/__main__.py

@@ -0,0 +1,4 @@
+from pm_agent.presentation.cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

product_manager_agent-0.3.0/src/pm_agent/application/__init__.py

@@ -0,0 +1 @@
+"""Application orchestration services."""