aipm-cli 0.1.0__py3-none-any.whl

aipm_cli-0.1.0.dist-info/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 arthurchan1906
+
+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.

aipm_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,81 @@
+Metadata-Version: 2.1
+Name: aipm-cli
+Version: 0.1.0
+Summary: Local project management tool for AI coding workflows
+License: MIT License
+        
+        Copyright (c) 2026 arthurchan1906
+        
+        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.
+        
+Keywords: ai,project-management,cli,developer-tools
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# AIPM CLI
+
+AIPM CLI 是一个给 AI 编码项目使用的本地项目管理工具。
+
+PyPI 分发名：`aipm-cli`
+
+特性：
+- `aipmc init` 在当前项目创建 `.pmai/` 隐藏目录
+- JSON 数据库存放在 `.pmai/data/pmai.json`
+- Web 配置存放在 `.pmai/config.json`
+- AI 使用说明可写入 `.pmai/USAGE.md`
+- CLI 可记录 canon、task、decision、commit、daily
+- Web 直接用 Python 标准库 `http.server` 提供，无需 FastAPI
+- 可通过 PyPI 安装并直接使用
+
+常用命令：
+
+```bash
+pip install aipm-cli
+aipmc init
+aipmc help
+aipmc info
+aipmc canon show
+aipmv
+```
+
+运行时目录：
+- `.pmai/data/pmai.json`
+- `.pmai/config.json`
+- `.pmai/USAGE.md`
+
+主要模块：
+- `src/pmai/bootstrap.py`
+- `src/pmai/cli_main.py`
+- `src/pmai/usage_guide.py`
+- `src/pmai/store.py`
+- `src/pmai/web_server.py`
+- `src/pmai/run_server.py`

aipm_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,22 @@
+pmai/__init__.py,sha256=POJ4-7NuxhA69MwLfWswOhlLlmmWJwD7TzXdURJQRJk,46
+pmai/__main__.py,sha256=2eo9snGH-oXyyNOYkSAWfDFzufFK7zbZTacYPcqjqjc,110
+pmai/app.py,sha256=0cJpDstgEwmxn5Q_GI-nhytmRCHdoYNvsWkwvF2n0zM,208
+pmai/bootstrap.py,sha256=cX-vu_8OlsP1odqUEVZ0c-_I15_-7wEGXK2rWkcFu0k,5955
+pmai/cli.py,sha256=2QxWDae2-ztkGtFzlbOXAavpbEtYx1Xt6WbLOyobbaQ,137
+pmai/cli_main.py,sha256=jr656nlT_D5lg6jkYjyCEnSb20Pdb1csXpMeSqnfGoo,9725
+pmai/json_store.py,sha256=qO217fhg6MrKLmoq5iyTUrVnHzcZTkBKKPTQ7gxX0ho,11606
+pmai/run.py,sha256=06BD3DiHliK0b2u74UkkLquhGXGD3Xb1NoGdRW7XtEA,141
+pmai/run_server.py,sha256=VkZ1z_64346LuNALqWm22u7BrenhFnsialRFd2KPpzo,1034
+pmai/store.py,sha256=GuPLMnmsTOmO6GZas_Z9m_tzd3ZOoGGmAGHTA9d7W8k,37436
+pmai/usage_guide.py,sha256=RZ9V3WfulHHAzSCXWfI0BsZnl6v9weEISKtPiA82MnY,1959
+pmai/web_server.py,sha256=9TCMtaMIkrA-RSkYeTw6r9ZQ2wIBuPkyFym0e4UmFN0,7364
+pmai/ui/README.md,sha256=OnMbwQGBn7HErNqNIRmuu-t9gGZvU_sE-Bmg7eM8HFk,208
+pmai/ui/dist/index.html,sha256=qBiBmxoTqYXklNi2RLfXFqaEkHOpNi1NPOCWjatjJp4,415
+pmai/ui/dist/assets/index-DGaldb9r.js,sha256=7-CtW_o-6Ie8KDXGKkb_7O6MbcsJ_lXwNKd3-e0Jf8c,1051822
+pmai/ui/dist/assets/index-RiTKPu0I.css,sha256=JwhkJTLbWRd_Uscf-AEFNZKUwYIdR_ylx4TzgeJHjbg,6854
+aipm_cli-0.1.0.dist-info/LICENSE,sha256=iaOijxYZNl7w4SZ61tZfhpoW75CcYTcwcpu1R2tIY8o,1092
+aipm_cli-0.1.0.dist-info/METADATA,sha256=bJ_1VrL1gY87VviHVl_owN5m93h5CCmx5oJOdUGY54E,3052
+aipm_cli-0.1.0.dist-info/WHEEL,sha256=BNRMDyzLkkcmlv0J8ppDQkk2VED33SesJDynr9ED1gc,91
+aipm_cli-0.1.0.dist-info/entry_points.txt,sha256=pJ0QhoBKwYpuZGjRQyetugn8NaEQaiGbL2QuQv_gBIg,74
+aipm_cli-0.1.0.dist-info/top_level.txt,sha256=9m-DNjB8L0X_ZZV0vV_74y0DPT5k-p2VimPhqT16r6M,5
+aipm_cli-0.1.0.dist-info/RECORD,,

aipm_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (75.3.4)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

aipm_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+aipmc = pmai.cli_main:main
+aipmv = pmai.run_server:main

aipm_cli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+pmai

pmai/__init__.py

@@ -0,0 +1,3 @@
+"""pmai package."""
+
+__version__ = "0.1.0"

pmai/__main__.py

@@ -0,0 +1,7 @@
+from __future__ import annotations
+
+from .cli_main import main
+
+
+if __name__ == "__main__":
+    main()

pmai/app.py

@@ -0,0 +1,6 @@
+try:
+    from .web_server import PMAIRequestHandler, create_server
+except ImportError:
+    from web_server import PMAIRequestHandler, create_server
+
+__all__ = ["PMAIRequestHandler", "create_server"]

pmai/bootstrap.py

@@ -0,0 +1,72 @@
+try:
+    from .json_store import bootstrap_state
+    from .store import today
+except ImportError:
+    from json_store import bootstrap_state
+    from store import today
+
+
+def bootstrap_project_db() -> bool:
+    bootstrap_state(
+        {
+            "meta": {
+                "project_name": "pmai-project",
+                "project_type": "ai-coding-project-manager",
+                "runtime_root": ".pmai",
+                "runtime_database": ".pmai/data/pmai.json",
+                "runtime_config": ".pmai/config.json",
+                "ai_read_order": [
+                    ".pmai/data/pmai.json:canon",
+                    ".pmai/data/pmai.json:tasks",
+                    ".pmai/data/pmai.json:doc_records",
+                    "README.md",
+                    "pyproject.toml",
+                ],
+            },
+            "canon": {
+                "id": "canon-current",
+                "updated_at": today(),
+                "product_goal": "为 AI 编码项目提供可安装的项目管理工具，支持 CLI 记录、Web 查看和项目级初始化。",
+                "engineering_focus": "统一隐藏目录、CLI、JSON 数据层和内置 Web 服务，确保复制目录后仍能正常运行。",
+                "architecture": "Python stdlib CLI + HTTPServer + JSON + React 静态页面",
+                "version_scope": ["项目级 .pmai 隐藏目录初始化", "CLI 任务/提交/决策/日报管理", "内置 Web 查看与编辑", "pip 可安装分发", "移除旧 pmai 路径残留"],
+                "avoid_now": ["引入额外后端框架依赖", "依赖团队协作或多用户同步", "把运行时数据放回代码目录"],
+                "top_tasks": ["清理旧包名和路径硬编码", "保证 aipmc init 可在任意项目创建 .pmai", "保证 aipmv 使用标准库直接启动"],
+                "source_docs": ["README.md", "pyproject.toml", "cli_main.py", "bootstrap.py", "json_store.py", "web_server.py", "run_server.py"],
+                "related_decisions": ["decision-runtime-hidden-dir", "decision-stdlib-web-server"],
+            },
+            "decisions": [
+                {"id": "decision-runtime-hidden-dir", "title": "运行时数据放入项目隐藏目录", "date": today(), "status": "accepted", "background": "工具会被复制到不同目录中使用，代码路径不应承担项目数据目录职责。", "decision": "在用户项目根目录使用 .pmai/ 保存数据库和运行配置，并支持从子目录向上发现该目录。", "impact": ["每个项目独立保存数据和端口配置"], "alternatives": ["继续把数据库放在源码目录"], "related_tasks": ["task-runtime-layout"], "updates_canon": True},
+                {"id": "decision-stdlib-web-server", "title": "Web 服务改为 Python 标准库", "date": today(), "status": "accepted", "background": "该工具主要由单个开发者在本机使用，不需要额外的 Web 框架复杂度。", "decision": "用 http.server 提供静态文件和 JSON API，去掉额外后端依赖。", "impact": ["安装成本更低", "更适合本地单用户工具"], "alternatives": ["继续保留 FastAPI 方案"], "related_tasks": ["task-stdlib-web"], "updates_canon": True},
+            ],
+            "tasks": [
+                {"id": "task-runtime-layout", "title": "统一 .pmai 运行时目录和初始化逻辑", "status": "in_progress", "priority": "P0", "phase": "foundation", "acceptance": ["aipmc init 会创建 .pmai/data/pmai.json 和 .pmai/config.json", "CLI 和 Web 从子目录也能定位到同一项目数据库"], "related_docs": ["bootstrap.py", "store.py", "run_server.py"], "related_decisions": ["decision-runtime-hidden-dir"], "last_note": "", "updated_at": today()},
+                {"id": "task-stdlib-web", "title": "将 Web 服务改为标准库实现", "status": "in_progress", "priority": "P0", "phase": "runtime", "acceptance": ["无需额外安装 FastAPI/uvicorn/pydantic", "保留现有前端静态资源和 API 路径"], "related_docs": ["web_server.py", "run_server.py", "pyproject.toml"], "related_decisions": ["decision-stdlib-web-server"], "last_note": "", "updated_at": today()},
+            ],
+            "ideas": [],
+            "doc_records": [
+                {"path": "README.md", "type": "readme", "status": "active", "layer": "baseline", "source_of_truth": True, "last_reviewed": today(), "superseded_by": None},
+                {"path": "pyproject.toml", "type": "packaging", "status": "active", "layer": "baseline", "source_of_truth": True, "last_reviewed": today(), "superseded_by": None},
+                {"path": "cli_main.py", "type": "cli", "status": "active", "layer": "implementation", "source_of_truth": True, "last_reviewed": today(), "superseded_by": None},
+                {"path": "bootstrap.py", "type": "bootstrap", "status": "active", "layer": "implementation", "source_of_truth": True, "last_reviewed": today(), "superseded_by": None},
+                {"path": "json_store.py", "type": "data-layer", "status": "active", "layer": "implementation", "source_of_truth": True, "last_reviewed": today(), "superseded_by": None},
+                {"path": "web_server.py", "type": "web-server", "status": "active", "layer": "implementation", "source_of_truth": True, "last_reviewed": today(), "superseded_by": None},
+                {"path": "run_server.py", "type": "runtime-entry", "status": "active", "layer": "implementation", "source_of_truth": True, "last_reviewed": today(), "superseded_by": None},
+            ],
+            "daily_notes": {},
+            "commits": [],
+        }
+    )
+    return False
+
+
+def fetch_canon(_unused=None):
+    try:
+        from .json_store import fetch_canon as _fetch_canon
+    except ImportError:
+        from json_store import fetch_canon as _fetch_canon
+    return _fetch_canon()
+
+
+def replace_canon_item_group(_conn, _item_type, _values):
+    return None

pmai/cli.py

@@ -0,0 +1,8 @@
+try:
+    from .cli_main import main
+except ImportError:
+    from cli_main import main
+
+
+if __name__ == "__main__":
+    main()

pmai/cli_main.py

@@ -0,0 +1,190 @@
+from __future__ import annotations
+
+import argparse
+import json
+from typing import Any
+
+try:
+    from .bootstrap import bootstrap_project_db
+    from .json_store import (
+        append_daily_note,
+        create_commit,
+        create_decision,
+        create_idea,
+        create_task,
+        fetch_canon,
+        list_commits,
+        list_decisions,
+        list_ideas,
+        list_tasks,
+        review_idea,
+        update_canon,
+        update_task,
+    )
+    from .store import describe_runtime, get_config_path, get_runtime_dir, save_runtime_config
+    from .usage_guide import build_usage_markdown, write_usage_file
+except ImportError:
+    from bootstrap import bootstrap_project_db
+    from json_store import (
+        append_daily_note,
+        create_commit,
+        create_decision,
+        create_idea,
+        create_task,
+        fetch_canon,
+        list_commits,
+        list_decisions,
+        list_ideas,
+        list_tasks,
+        review_idea,
+        update_canon,
+        update_task,
+    )
+    from store import describe_runtime, get_config_path, get_runtime_dir, save_runtime_config
+    from usage_guide import build_usage_markdown, write_usage_file
+
+
+def init_project(args: argparse.Namespace) -> None:
+    get_runtime_dir(create=True)
+    if args.port is not None or args.host:
+        payload: dict[str, Any] = {}
+        if args.host:
+            payload["web_host"] = args.host
+        if args.port is not None:
+            payload["web_port"] = args.port
+        save_runtime_config(payload)
+    elif not get_config_path().exists():
+        save_runtime_config({})
+    bootstrap_project_db()
+    write_usage_file()
+    print(json.dumps(describe_runtime(), ensure_ascii=False, indent=2))
+
+
+def show_info() -> None:
+    print(json.dumps(describe_runtime(), ensure_ascii=False, indent=2))
+
+
+def show_canon() -> None:
+    print(json.dumps(fetch_canon(), ensure_ascii=False, indent=2))
+
+
+def show_help_text() -> None:
+    print(build_usage_markdown())
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(description="AIPM CLI")
+    subparsers = parser.add_subparsers(dest="command", required=True)
+    init_parser = subparsers.add_parser("init")
+    init_parser.add_argument("--host", default="")
+    init_parser.add_argument("--port", type=int, default=None)
+    subparsers.add_parser("help")
+    subparsers.add_parser("info")
+    canon = subparsers.add_parser("canon").add_subparsers(dest="canon_command", required=True)
+    canon.add_parser("show")
+    canon_update = canon.add_parser("update")
+    canon_update.add_argument("--decision-id", required=True)
+    canon_update.add_argument("--product-goal", default="")
+    canon_update.add_argument("--engineering-focus", default="")
+    canon_update.add_argument("--architecture", default="")
+    canon_update.add_argument("--add-scope", nargs="*", default=[])
+    canon_update.add_argument("--add-avoid", nargs="*", default=[])
+    decision = subparsers.add_parser("decision").add_subparsers(dest="decision_command", required=True)
+    decision.add_parser("list")
+    decision_add = decision.add_parser("add")
+    decision_add.add_argument("--title", required=True)
+    decision_add.add_argument("--background", required=True)
+    decision_add.add_argument("--decision", required=True)
+    decision_add.add_argument("--status", default="proposed")
+    idea = subparsers.add_parser("idea").add_subparsers(dest="idea_command", required=True)
+    idea_list = idea.add_parser("list")
+    idea_list.add_argument("--status", default="")
+    idea_capture = idea.add_parser("capture")
+    idea_capture.add_argument("--title", required=True)
+    idea_capture.add_argument("--summary", required=True)
+    idea_capture.add_argument("--impact", default="")
+    idea_capture.add_argument("--source", default="manual")
+    idea_capture.add_argument("--canon-conflict", action="store_true", dest="canon_conflict")
+    idea_review = idea.add_parser("review")
+    idea_review.add_argument("--id", required=True)
+    idea_review.add_argument("--status", required=True)
+    idea_review.add_argument("--note", default="")
+    task = subparsers.add_parser("task").add_subparsers(dest="task_command", required=True)
+    task.add_parser("list")
+    task_add = task.add_parser("add")
+    task_add.add_argument("--title", required=True)
+    task_add.add_argument("--priority", default="P1")
+    task_add.add_argument("--status", default="todo")
+    task_add.add_argument("--phase", default="general")
+    task_add.add_argument("--acceptance", nargs="*", default=[])
+    task_update = task.add_parser("update")
+    task_update.add_argument("--id", required=True)
+    task_update.add_argument("--status", required=True)
+    task_update.add_argument("--note", default="")
+    commit = subparsers.add_parser("commit").add_subparsers(dest="commit_command", required=True)
+    commit_list = commit.add_parser("list")
+    commit_list.add_argument("--status", default="")
+    commit_add = commit.add_parser("add")
+    commit_add.add_argument("--title", required=True)
+    commit_add.add_argument("--summary", default="")
+    commit_add.add_argument("--branch", default="")
+    commit_add.add_argument("--commit-hash", default="", dest="commit_hash")
+    commit_add.add_argument("--task-id", default="", dest="task_id")
+    commit_add.add_argument("--decision-id", default="", dest="decision_id")
+    commit_add.add_argument("--status", default="draft")
+    commit_add.add_argument("--test-status", default="not_run", dest="test_status")
+    commit_add.add_argument("--review-status", default="pending", dest="review_status")
+    commit_add.add_argument("--files", nargs="*", default=[])
+    daily = subparsers.add_parser("daily").add_subparsers(dest="daily_command", required=True)
+    daily_show = daily.add_parser("show")
+    daily_show.add_argument("--date", default=None)
+    daily_close = daily.add_parser("close")
+    daily_close.add_argument("--completed", nargs="*", default=[])
+    daily_close.add_argument("--problems", nargs="*", default=[])
+    daily_close.add_argument("--risks", nargs="*", default=[])
+    daily_close.add_argument("--next", nargs="*", default=[])
+    return parser
+
+
+def main() -> None:
+    parser = build_parser()
+    args = parser.parse_args()
+    if args.command == "init":
+        init_project(args)
+    elif args.command == "help":
+        show_help_text()
+    elif args.command == "info":
+        show_info()
+    elif args.command == "canon" and args.canon_command == "show":
+        show_canon()
+    elif args.command == "canon" and args.canon_command == "update":
+        print(json.dumps(update_canon({"decision_id": args.decision_id, "product_goal": args.product_goal, "engineering_focus": args.engineering_focus, "architecture": args.architecture, "add_scope": args.add_scope, "add_avoid": args.add_avoid}), ensure_ascii=False, indent=2))
+    elif args.command == "decision" and args.decision_command == "list":
+        print(json.dumps({"decisions": list_decisions()}, ensure_ascii=False, indent=2))
+    elif args.command == "decision" and args.decision_command == "add":
+        print(json.dumps(create_decision({"title": args.title, "background": args.background, "decision": args.decision, "status": args.status}), ensure_ascii=False, indent=2))
+    elif args.command == "idea" and args.idea_command == "list":
+        print(json.dumps({"ideas": list_ideas(args.status or None)}, ensure_ascii=False, indent=2))
+    elif args.command == "idea" and args.idea_command == "capture":
+        print(json.dumps(create_idea({"title": args.title, "summary": args.summary, "impact": args.impact, "source": args.source, "canon_conflict": args.canon_conflict}), ensure_ascii=False, indent=2))
+    elif args.command == "idea" and args.idea_command == "review":
+        print(json.dumps(review_idea(args.id, args.status, args.note), ensure_ascii=False, indent=2))
+    elif args.command == "task" and args.task_command == "list":
+        print(json.dumps({"tasks": list_tasks()}, ensure_ascii=False, indent=2))
+    elif args.command == "task" and args.task_command == "add":
+        print(json.dumps(create_task({"title": args.title, "priority": args.priority, "status": args.status, "phase": args.phase, "acceptance": args.acceptance}), ensure_ascii=False, indent=2))
+    elif args.command == "task" and args.task_command == "update":
+        print(json.dumps(update_task(args.id, args.status, args.note), ensure_ascii=False, indent=2))
+    elif args.command == "commit" and args.commit_command == "list":
+        print(json.dumps({"commits": list_commits(args.status or None)}, ensure_ascii=False, indent=2))
+    elif args.command == "commit" and args.commit_command == "add":
+        print(json.dumps(create_commit({"title": args.title, "summary": args.summary, "branch": args.branch, "commit_hash": args.commit_hash, "task_id": args.task_id or None, "decision_id": args.decision_id or None, "status": args.status, "test_status": args.test_status, "review_status": args.review_status, "files": args.files}), ensure_ascii=False, indent=2))
+    elif args.command == "daily" and args.daily_command == "show":
+        from json_store import get_daily_note
+        print(json.dumps(get_daily_note(args.date), ensure_ascii=False, indent=2))
+    elif args.command == "daily" and args.daily_command == "close":
+        print(json.dumps(append_daily_note({"completed": args.completed, "problems": args.problems, "risks": args.risks, "next": args.next}), ensure_ascii=False, indent=2))
+
+
+if __name__ == "__main__":
+    main()