@kitsy/coop 1.1.0 → 2.1.0
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.
- package/README.md +31 -7
- package/dist/index.js +3503 -1990
- package/package.json +4 -4
package/README.md
CHANGED
|
@@ -7,6 +7,7 @@ Install globally:
|
|
|
7
7
|
```bash
|
|
8
8
|
npm i -g @kitsy/coop
|
|
9
9
|
coop --help
|
|
10
|
+
coop help-ai --format json
|
|
10
11
|
```
|
|
11
12
|
|
|
12
13
|
Install locally in a repo:
|
|
@@ -16,16 +17,36 @@ pnpm add -D @kitsy/coop
|
|
|
16
17
|
pnpm exec coop --help
|
|
17
18
|
```
|
|
18
19
|
|
|
20
|
+
For AI-oriented command discovery:
|
|
21
|
+
|
|
22
|
+
```bash
|
|
23
|
+
coop help-ai
|
|
24
|
+
coop help-ai --format json
|
|
25
|
+
coop help-ai --format markdown
|
|
26
|
+
```
|
|
27
|
+
|
|
19
28
|
Both entrypoints operate on the nearest parent `.coop/` workspace. If no workspace log target exists, CLI errors fall back to `~/.coop/logs/cli.log` or `COOP_HOME/logs/cli.log`.
|
|
20
29
|
|
|
30
|
+
COOP v2 stores project data under `.coop/projects/<project.id>/...` and keeps workspace selection in `.coop/config.yml`.
|
|
31
|
+
|
|
21
32
|
Current implemented command families:
|
|
22
33
|
- `coop`
|
|
23
|
-
- `coop init`
|
|
34
|
+
- `coop init [--name <name>] [--id <id>] [--aliases <csv>] [--yes]`
|
|
35
|
+
- `coop project list|create|use|show`
|
|
24
36
|
- `coop create task ...`
|
|
37
|
+
- `coop create task --acceptance <csv> --tests-required <csv> --authority-ref <ref> --derived-ref <ref>`
|
|
38
|
+
- `coop create task --from-file <path> | --stdin`
|
|
25
39
|
- `coop create task --from <idea> --ai`
|
|
40
|
+
- `coop create idea --from-file <path> | --stdin`
|
|
41
|
+
- `coop refine idea <id> [--apply] [--input-file <path>] [--stdin]`
|
|
42
|
+
- `coop refine task <id> [--apply] [--input-file <path>] [--stdin]`
|
|
43
|
+
- `coop apply draft --from-file <path> | --stdin`
|
|
26
44
|
- `coop create idea ...`
|
|
27
45
|
- `coop create track ...`
|
|
28
46
|
- `coop create delivery ... [--commit] [--user <user>] [--force]`
|
|
47
|
+
- `coop next task [--track <track>] [--delivery <delivery>]`
|
|
48
|
+
- `coop pick task [--track <track>] [--delivery <delivery>] [--claim] [--to <assignee>]`
|
|
49
|
+
- `coop start task [id] [--claim] [--to <assignee>]`
|
|
29
50
|
- `coop assign task <id> --to <assignee> [--actor <actor>]`
|
|
30
51
|
- `coop list tasks|ideas|alias ...`
|
|
31
52
|
- `coop show task|idea ...`
|
|
@@ -45,6 +66,7 @@ Current implemented command families:
|
|
|
45
66
|
- `coop serve [--host <host>] [--port <port>] [--repo <path>]`
|
|
46
67
|
- `coop webhook github [--host <host>] [--port <port>] [--repo <path>]`
|
|
47
68
|
- `coop migrate --dry-run --to 2`
|
|
69
|
+
- `coop migrate workspace-layout --to v2 [--name <name>] [--id <id>] [--aliases <csv>] [--yes]`
|
|
48
70
|
- `coop alias ...`
|
|
49
71
|
- `coop list alias [pattern]`
|
|
50
72
|
- `coop config index.data yaml|json`
|
|
@@ -52,16 +74,17 @@ Current implemented command families:
|
|
|
52
74
|
- `coop config project.name <name>`
|
|
53
75
|
- `coop config project.id <id>`
|
|
54
76
|
- `coop config project.aliases <csv>`
|
|
55
|
-
- `coop config ai.provider mock|openai|anthropic|gemini|ollama`
|
|
77
|
+
- `coop config ai.provider mock|openai|anthropic|gemini|ollama|codex_cli|claude_cli|gemini_cli`
|
|
56
78
|
- `coop config ai.model <model-name>`
|
|
57
79
|
- `coop run task <id> [--step <step>] [--dry-run]`
|
|
58
80
|
|
|
59
81
|
Known limitations:
|
|
60
82
|
- `ext` is still a placeholder for future phases.
|
|
61
|
-
- Provider-backed AI is supported for `openai`, `anthropic`, `gemini`, and `ollama` via `.coop/config.yml` + env vars.
|
|
62
|
-
-
|
|
63
|
-
-
|
|
64
|
-
-
|
|
83
|
+
- Provider-backed AI is supported for `openai`, `anthropic`, `gemini`, and `ollama` via `.coop/projects/<project.id>/config.yml` + env vars.
|
|
84
|
+
- CLI-backed AI is supported for `codex_cli`, `claude_cli`, and `gemini_cli` via installed/authenticated local CLIs.
|
|
85
|
+
- Authorization is advisory and config-driven (`.coop/projects/<project.id>/config.yml -> authorization`).
|
|
86
|
+
- Plugin runtime supports manifest triggers under `.coop/projects/<project.id>/plugins/*.yml` (webhook + console + `github_pr` actions).
|
|
87
|
+
- `coop ui` is read-only and depends on the active project's `.index` data. The command rebuilds stale indexes before launch.
|
|
65
88
|
- `coop init` creates `.coop/.ignore` and `.coop/.gitignore` so logs, tmp files, and index artifacts are not committed by default.
|
|
66
89
|
|
|
67
90
|
GitHub integration quick example:
|
|
@@ -75,7 +98,7 @@ github:
|
|
|
75
98
|
merge_method: squash
|
|
76
99
|
```
|
|
77
100
|
|
|
78
|
-
With `.coop/plugins/github-pr.yml` enabled:
|
|
101
|
+
With `.coop/projects/<project.id>/plugins/github-pr.yml` enabled:
|
|
79
102
|
- `coop transition task PM-101 in_review` creates or updates a PR
|
|
80
103
|
- `coop transition task PM-101 done` merges the linked PR
|
|
81
104
|
- `coop webhook github --port 8787` receives GitHub review/merge webhooks and syncs task status
|
|
@@ -97,6 +120,7 @@ With cross-repo task references such as `external:platform-repo/PM-200`:
|
|
|
97
120
|
|
|
98
121
|
Workspace identity:
|
|
99
122
|
```yaml
|
|
123
|
+
# .coop/projects/<project.id>/config.yml
|
|
100
124
|
project:
|
|
101
125
|
name: Payments Platform
|
|
102
126
|
id: payments-platform
|