md-project-manager 0.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (14) hide show
  1. md_project_manager-0.1.0/LICENSE +21 -0
  2. md_project_manager-0.1.0/PKG-INFO +121 -0
  3. md_project_manager-0.1.0/README.md +107 -0
  4. md_project_manager-0.1.0/pyproject.toml +31 -0
  5. md_project_manager-0.1.0/setup.cfg +4 -0
  6. md_project_manager-0.1.0/src/md_project_manager.egg-info/PKG-INFO +121 -0
  7. md_project_manager-0.1.0/src/md_project_manager.egg-info/SOURCES.txt +12 -0
  8. md_project_manager-0.1.0/src/md_project_manager.egg-info/dependency_links.txt +1 -0
  9. md_project_manager-0.1.0/src/md_project_manager.egg-info/entry_points.txt +2 -0
  10. md_project_manager-0.1.0/src/md_project_manager.egg-info/requires.txt +1 -0
  11. md_project_manager-0.1.0/src/md_project_manager.egg-info/top_level.txt +1 -0
  12. md_project_manager-0.1.0/src/pm/__init__.py +2 -0
  13. md_project_manager-0.1.0/src/pm/cli.py +949 -0
  14. md_project_manager-0.1.0/tests/test_cli.py +348 -0
md_project_manager-0.1.0/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Mohammed
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
md_project_manager-0.1.0/PKG-INFO ADDED
@@ -0,0 +1,121 @@
1
+ Metadata-Version: 2.4
2
+ Name: md-project-manager
3
+ Version: 0.1.0
4
+ Summary: CLI tool to organize project documentation in a consistent structure
5
+ Author: Mohammed
6
+ License-Expression: MIT
7
+ Classifier: Programming Language :: Python :: 3
8
+ Classifier: Operating System :: OS Independent
9
+ Requires-Python: >=3.9
10
+ Description-Content-Type: text/markdown
11
+ License-File: LICENSE
12
+ Requires-Dist: PyYAML>=6.0
13
+ Dynamic: license-file
14
+
15
+ # md-project-manager (`pm`)
16
+
17
+ A CLI for the workflow in `process.txt`.
18
+
19
+ ## Install (local dev)
20
+
21
+ ```bash
22
+ uv pip install -e .
23
+ ```
24
+
25
+ ## Quick Start
26
+
27
+ ```bash
28
+ pm init .
29
+ pm note "Primary users are nurses and admin"
30
+ pm toknow
31
+ pm todo
32
+ pm phase planning
33
+ pm demo "Demoed rota module and captured feedback"
34
+ pm flow
35
+ ```
36
+
37
+ ## Commands
38
+
39
+ - `pm init [path]`: Create workflow files/folders and defaults.
40
+ - `pm help`: Show commands.
41
+ - `pm flow`: Show process definition.
42
+ - `pm note "..."`: Append to `notes.log`.
43
+ - `pm toknow [hint] [--date DD/MM/YY] [--model MODEL] [--endpoint URL] [--timeout SEC]`: Regenerate `toknows.md` via Ollama.
44
+ - `pm toknow next`: Show the next `[open]` question from `toknows.md`.
45
+ - `pm todo [hint] [--date DD/MM/YY] [--model MODEL] [--endpoint URL] [--timeout SEC]`: Regenerate `todos.md` via Ollama.
46
+ - `pm demo "..."`: Append demo note to `blogposts/YYYY-MM-DD.md`.
47
+ - `pm timeline [--date DD/MM/YY] [--plain]`: View `notes.log` as a compressed vertical timeline.
48
+ - `pm phase [recon|planning|building] [--hint ...] [--timeout SEC]`: Show/set phase. Transition `recon -> planning` generates `assumptions.md`.
49
+
50
+ ## Date Filter Behavior
51
+
52
+ For `pm toknow` and `pm todo`:
53
+ - `--date DD/MM/YY` includes only `notes.log` entries up to that date.
54
+ - If `--date` is omitted, all notes are included.
55
+ - Before sending notes to the model, timestamp and username are stripped to reduce token usage.
56
+
57
+ For `pm toknow next`:
58
+ - Reads `toknows.md` and prints the first `[open]` question to resolve next.
59
+
60
+ ## Timeline View
61
+
62
+ - `pm timeline` opens a scrollable terminal view (`j/k`, arrow keys, PgUp/PgDn, `g`, `G`, `q`).
63
+ - Gaps are compressed (short gaps: none, medium: small spacing, long: labeled gap marker).
64
+ - Use `pm timeline --plain` for non-interactive output.
65
+
66
+ ## Created Layout
67
+
68
+ `pm init` creates:
69
+
70
+ - `.config.yaml`
71
+ - `.pm_state.json`
72
+ - `process.txt`
73
+ - `notes.log`
74
+ - `toknows.md`
75
+ - `todos.md`
76
+ - `blogposts/`
77
+ - `archives/`
78
+
79
+ `archives/` is added to `.gitignore` on init.
80
+
81
+ ## File Update Policy
82
+
83
+ `pm toknow`, `pm todo`, and assumptions generation replace full markdown files.
84
+ Before replacement, previous versions are copied to `archives/` as timestamped backups.
85
+
86
+ ## Entry Formats
87
+
88
+ - `notes.log`: `DD/MM/YY:HH MM: author: message`
89
+ - `toknows.md`: model-generated markdown
90
+ - `todos.md`: model-generated markdown
91
+ - `assumptions.md`: model-generated markdown
92
+ - `blogposts/YYYY-MM-DD.md`: `- DD/MM/YY:HH MM: author: demo note`
93
+
94
+ Author is sourced from `git config user.name` (fallback: OS login name).
95
+
96
+ ## Config (`.config.yaml`)
97
+
98
+ ```yaml
99
+ ollama_endpoint: http://localhost:11434/api/generate
100
+ ollama_model: gpt-oss
101
+ ollama_token: REPLACE_ME
102
+ ollama_insecure_tls: false
103
+ ollama_timeout_sec: 180
104
+ process_file: process.txt
105
+ prompts:
106
+ toknow: "..."
107
+ todo: "..."
108
+ assumptions: "..."
109
+ ```
110
+
111
+ Prompts are configurable in `.config.yaml`.
112
+ `ollama_token` must be set in `.config.yaml` for AI commands to run.
113
+ If endpoint ends with `/chat`, the CLI uses chat payload format automatically.
114
+ If your endpoint uses a self-signed cert, set `ollama_insecure_tls` to `true`.
115
+
116
+ ## Ollama Prerequisite
117
+
118
+ ```bash
119
+ ollama serve
120
+ ollama pull gpt-oss
121
+ ```
md_project_manager-0.1.0/README.md ADDED
@@ -0,0 +1,107 @@
1
+ # md-project-manager (`pm`)
2
+
3
+ A CLI for the workflow in `process.txt`.
4
+
5
+ ## Install (local dev)
6
+
7
+ ```bash
8
+ uv pip install -e .
9
+ ```
10
+
11
+ ## Quick Start
12
+
13
+ ```bash
14
+ pm init .
15
+ pm note "Primary users are nurses and admin"
16
+ pm toknow
17
+ pm todo
18
+ pm phase planning
19
+ pm demo "Demoed rota module and captured feedback"
20
+ pm flow
21
+ ```
22
+
23
+ ## Commands
24
+
25
+ - `pm init [path]`: Create workflow files/folders and defaults.
26
+ - `pm help`: Show commands.
27
+ - `pm flow`: Show process definition.
28
+ - `pm note "..."`: Append to `notes.log`.
29
+ - `pm toknow [hint] [--date DD/MM/YY] [--model MODEL] [--endpoint URL] [--timeout SEC]`: Regenerate `toknows.md` via Ollama.
30
+ - `pm toknow next`: Show the next `[open]` question from `toknows.md`.
31
+ - `pm todo [hint] [--date DD/MM/YY] [--model MODEL] [--endpoint URL] [--timeout SEC]`: Regenerate `todos.md` via Ollama.
32
+ - `pm demo "..."`: Append demo note to `blogposts/YYYY-MM-DD.md`.
33
+ - `pm timeline [--date DD/MM/YY] [--plain]`: View `notes.log` as a compressed vertical timeline.
34
+ - `pm phase [recon|planning|building] [--hint ...] [--timeout SEC]`: Show/set phase. Transition `recon -> planning` generates `assumptions.md`.
35
+
36
+ ## Date Filter Behavior
37
+
38
+ For `pm toknow` and `pm todo`:
39
+ - `--date DD/MM/YY` includes only `notes.log` entries up to that date.
40
+ - If `--date` is omitted, all notes are included.
41
+ - Before sending notes to the model, timestamp and username are stripped to reduce token usage.
42
+
43
+ For `pm toknow next`:
44
+ - Reads `toknows.md` and prints the first `[open]` question to resolve next.
45
+
46
+ ## Timeline View
47
+
48
+ - `pm timeline` opens a scrollable terminal view (`j/k`, arrow keys, PgUp/PgDn, `g`, `G`, `q`).
49
+ - Gaps are compressed (short gaps: none, medium: small spacing, long: labeled gap marker).
50
+ - Use `pm timeline --plain` for non-interactive output.
51
+
52
+ ## Created Layout
53
+
54
+ `pm init` creates:
55
+
56
+ - `.config.yaml`
57
+ - `.pm_state.json`
58
+ - `process.txt`
59
+ - `notes.log`
60
+ - `toknows.md`
61
+ - `todos.md`
62
+ - `blogposts/`
63
+ - `archives/`
64
+
65
+ `archives/` is added to `.gitignore` on init.
66
+
67
+ ## File Update Policy
68
+
69
+ `pm toknow`, `pm todo`, and assumptions generation replace full markdown files.
70
+ Before replacement, previous versions are copied to `archives/` as timestamped backups.
71
+
72
+ ## Entry Formats
73
+
74
+ - `notes.log`: `DD/MM/YY:HH MM: author: message`
75
+ - `toknows.md`: model-generated markdown
76
+ - `todos.md`: model-generated markdown
77
+ - `assumptions.md`: model-generated markdown
78
+ - `blogposts/YYYY-MM-DD.md`: `- DD/MM/YY:HH MM: author: demo note`
79
+
80
+ Author is sourced from `git config user.name` (fallback: OS login name).
81
+
82
+ ## Config (`.config.yaml`)
83
+
84
+ ```yaml
85
+ ollama_endpoint: http://localhost:11434/api/generate
86
+ ollama_model: gpt-oss
87
+ ollama_token: REPLACE_ME
88
+ ollama_insecure_tls: false
89
+ ollama_timeout_sec: 180
90
+ process_file: process.txt
91
+ prompts:
92
+ toknow: "..."
93
+ todo: "..."
94
+ assumptions: "..."
95
+ ```
96
+
97
+ Prompts are configurable in `.config.yaml`.
98
+ `ollama_token` must be set in `.config.yaml` for AI commands to run.
99
+ If endpoint ends with `/chat`, the CLI uses chat payload format automatically.
100
+ If your endpoint uses a self-signed cert, set `ollama_insecure_tls` to `true`.
101
+
102
+ ## Ollama Prerequisite
103
+
104
+ ```bash
105
+ ollama serve
106
+ ollama pull gpt-oss
107
+ ```
md_project_manager-0.1.0/pyproject.toml ADDED
@@ -0,0 +1,31 @@
1
+ [build-system]
2
+ requires = ["setuptools>=68", "wheel"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "md-project-manager"
7
+ version = "0.1.0"
8
+ description = "CLI tool to organize project documentation in a consistent structure"
9
+ readme = "README.md"
10
+ requires-python = ">=3.9"
11
+ dependencies = [
12
+ "PyYAML>=6.0",
13
+ ]
14
+ license = "MIT"
15
+ license-files = ["LICENSE"]
16
+ authors = [
17
+ {name = "Mohammed"}
18
+ ]
19
+ classifiers = [
20
+ "Programming Language :: Python :: 3",
21
+ "Operating System :: OS Independent",
22
+ ]
23
+
24
+ [project.scripts]
25
+ pm = "pm.cli:main"
26
+
27
+ [tool.setuptools]
28
+ package-dir = {"" = "src"}
29
+
30
+ [tool.setuptools.packages.find]
31
+ where = ["src"]
md_project_manager-0.1.0/setup.cfg ADDED
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+
md_project_manager-0.1.0/src/md_project_manager.egg-info/PKG-INFO ADDED
@@ -0,0 +1,121 @@
1
+ Metadata-Version: 2.4
2
+ Name: md-project-manager
3
+ Version: 0.1.0
4
+ Summary: CLI tool to organize project documentation in a consistent structure
5
+ Author: Mohammed
6
+ License-Expression: MIT
7
+ Classifier: Programming Language :: Python :: 3
8
+ Classifier: Operating System :: OS Independent
9
+ Requires-Python: >=3.9
10
+ Description-Content-Type: text/markdown
11
+ License-File: LICENSE
12
+ Requires-Dist: PyYAML>=6.0
13
+ Dynamic: license-file
14
+
15
+ # md-project-manager (`pm`)
16
+
17
+ A CLI for the workflow in `process.txt`.
18
+
19
+ ## Install (local dev)
20
+
21
+ ```bash
22
+ uv pip install -e .
23
+ ```
24
+
25
+ ## Quick Start
26
+
27
+ ```bash
28
+ pm init .
29
+ pm note "Primary users are nurses and admin"
30
+ pm toknow
31
+ pm todo
32
+ pm phase planning
33
+ pm demo "Demoed rota module and captured feedback"
34
+ pm flow
35
+ ```
36
+
37
+ ## Commands
38
+
39
+ - `pm init [path]`: Create workflow files/folders and defaults.
40
+ - `pm help`: Show commands.
41
+ - `pm flow`: Show process definition.
42
+ - `pm note "..."`: Append to `notes.log`.
43
+ - `pm toknow [hint] [--date DD/MM/YY] [--model MODEL] [--endpoint URL] [--timeout SEC]`: Regenerate `toknows.md` via Ollama.
44
+ - `pm toknow next`: Show the next `[open]` question from `toknows.md`.
45
+ - `pm todo [hint] [--date DD/MM/YY] [--model MODEL] [--endpoint URL] [--timeout SEC]`: Regenerate `todos.md` via Ollama.
46
+ - `pm demo "..."`: Append demo note to `blogposts/YYYY-MM-DD.md`.
47
+ - `pm timeline [--date DD/MM/YY] [--plain]`: View `notes.log` as a compressed vertical timeline.
48
+ - `pm phase [recon|planning|building] [--hint ...] [--timeout SEC]`: Show/set phase. Transition `recon -> planning` generates `assumptions.md`.
49
+
50
+ ## Date Filter Behavior
51
+
52
+ For `pm toknow` and `pm todo`:
53
+ - `--date DD/MM/YY` includes only `notes.log` entries up to that date.
54
+ - If `--date` is omitted, all notes are included.
55
+ - Before sending notes to the model, timestamp and username are stripped to reduce token usage.
56
+
57
+ For `pm toknow next`:
58
+ - Reads `toknows.md` and prints the first `[open]` question to resolve next.
59
+
60
+ ## Timeline View
61
+
62
+ - `pm timeline` opens a scrollable terminal view (`j/k`, arrow keys, PgUp/PgDn, `g`, `G`, `q`).
63
+ - Gaps are compressed (short gaps: none, medium: small spacing, long: labeled gap marker).
64
+ - Use `pm timeline --plain` for non-interactive output.
65
+
66
+ ## Created Layout
67
+
68
+ `pm init` creates:
69
+
70
+ - `.config.yaml`
71
+ - `.pm_state.json`
72
+ - `process.txt`
73
+ - `notes.log`
74
+ - `toknows.md`
75
+ - `todos.md`
76
+ - `blogposts/`
77
+ - `archives/`
78
+
79
+ `archives/` is added to `.gitignore` on init.
80
+
81
+ ## File Update Policy
82
+
83
+ `pm toknow`, `pm todo`, and assumptions generation replace full markdown files.
84
+ Before replacement, previous versions are copied to `archives/` as timestamped backups.
85
+
86
+ ## Entry Formats
87
+
88
+ - `notes.log`: `DD/MM/YY:HH MM: author: message`
89
+ - `toknows.md`: model-generated markdown
90
+ - `todos.md`: model-generated markdown
91
+ - `assumptions.md`: model-generated markdown
92
+ - `blogposts/YYYY-MM-DD.md`: `- DD/MM/YY:HH MM: author: demo note`
93
+
94
+ Author is sourced from `git config user.name` (fallback: OS login name).
95
+
96
+ ## Config (`.config.yaml`)
97
+
98
+ ```yaml
99
+ ollama_endpoint: http://localhost:11434/api/generate
100
+ ollama_model: gpt-oss
101
+ ollama_token: REPLACE_ME
102
+ ollama_insecure_tls: false
103
+ ollama_timeout_sec: 180
104
+ process_file: process.txt
105
+ prompts:
106
+ toknow: "..."
107
+ todo: "..."
108
+ assumptions: "..."
109
+ ```
110
+
111
+ Prompts are configurable in `.config.yaml`.
112
+ `ollama_token` must be set in `.config.yaml` for AI commands to run.
113
+ If endpoint ends with `/chat`, the CLI uses chat payload format automatically.
114
+ If your endpoint uses a self-signed cert, set `ollama_insecure_tls` to `true`.
115
+
116
+ ## Ollama Prerequisite
117
+
118
+ ```bash
119
+ ollama serve
120
+ ollama pull gpt-oss
121
+ ```
md_project_manager-0.1.0/src/md_project_manager.egg-info/SOURCES.txt ADDED
@@ -0,0 +1,12 @@
1
+ LICENSE
2
+ README.md
3
+ pyproject.toml
4
+ src/md_project_manager.egg-info/PKG-INFO
5
+ src/md_project_manager.egg-info/SOURCES.txt
6
+ src/md_project_manager.egg-info/dependency_links.txt
7
+ src/md_project_manager.egg-info/entry_points.txt
8
+ src/md_project_manager.egg-info/requires.txt
9
+ src/md_project_manager.egg-info/top_level.txt
10
+ src/pm/__init__.py
11
+ src/pm/cli.py
12
+ tests/test_cli.py
md_project_manager-0.1.0/src/md_project_manager.egg-info/entry_points.txt ADDED
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ pm = pm.cli:main
md_project_manager-0.1.0/src/pm/__init__.py ADDED
@@ -0,0 +1,2 @@
1
+ __all__ = ["__version__"]
2
+ __version__ = "0.1.0"