Metadata-Version: 2.4
Name: aipm-cli
Version: 0.1.12
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
Dynamic: license-file

﻿# AIPM CLI

`aipm-cli` is a local project management tool for AI coding workflows.

AI-first product baseline:
- `doc/ai-first-product-baseline-v1.md`

Current rebuild status:
- [docs/rebuild-status.md](docs/rebuild-status.md)

It installs these command-line entry points:

- `aipmc`: CLI management commands
- `aipmv`: local web viewer

## Install

```bash
python -m pip install aipm-cli
```

Recommended for command-line usage:

```bash
python -m pip install --user pipx
python -m pipx ensurepath
pipx install aipm-cli
```

If your shell cannot find `aipmc` or `aipmv` after installation, use the module form instead:

```bash
python -m pmai help
python -m pmai info
python -m pmai canon show
python -m pmai.run
```

This is especially useful on macOS when the Python scripts directory is not in `PATH`.

## Common commands

```bash
aipmc init
aipmc help
aipmc info
aipmc context
aipmc next
aipmc handoff
aipmc doctor
aipmc inbox
aipmc canon show
aipmc docs list
aipmc docs audit
aipmc feedback list
aipmc decision review --id <decision-id> --status accepted
aipmc feedback add --label bug --content "登录页面验证码不显示"
aipmc task list --status in_progress
aipmc commit list --task-id <task-id>
aipmc commit add --title "Implement task" --summary "..." --auto-git
aipmc commit update --id <commit-id> --status committed --review-status approved
aipmc task update --id <task-id> --status done
aipmc daily replace --completed "..." --problems "..." --risks "..." --next "..."
aipmv
```

`aipmc inbox` aggregates the current items that usually still need human attention:
- proposed decisions
- accepted decisions that still imply canon follow-up
- committed changes waiting for review
- blocking doc-governance issues

Remote feedback commands:

```bash
aipmc feedback list
aipmc feedback add --label bug --content "登录页面验证码不显示"
aipmc feedback add --label suggestion --content "建议任务列表支持按负责人筛选"
```

Optional override:
- `--base-url http://43.167.206.218:8080`
- `PMAI_FEEDBACK_BASE_URL=http://43.167.206.218:8080`
- `label` only supports `bug` and `suggestion`
- Remote request failures return a JSON error and exit quickly instead of hanging

Task governance rule:
- Marking a task `done` requires at least one linked verified approved commit (`status=committed|merged`, `review_status=approved`, and `test_status=passed`).
- Emergency override is available with `aipmc task update --id <task-id> --status done --allow-without-commit`.

## Runtime files

- `.pmai/data/pmai.db`
- `.pmai/config.json`
- `.pmai/USAGE.md`

## Main modules

- `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`

## Current Direction

PlanAI is currently being rebuilt toward a local `context engineering + governance shell` for AI software delivery.

The current mainline is:

- compressed AI runtime context via `context / next / handoff`
- idea threads as pre-mainline convergence objects
- traceable `idea -> task / decision` conversion
- evidence / review / closure governance around task completion

See [docs/rebuild-status.md](docs/rebuild-status.md) for completed work, remaining work, and the recommended next continuation point.
