@kitsy/coop 2.1.0 → 2.1.2
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 +23 -2
- package/dist/index.js +722 -142
- package/package.json +4 -4
package/README.md
CHANGED
|
@@ -23,16 +23,33 @@ For AI-oriented command discovery:
|
|
|
23
23
|
coop help-ai
|
|
24
24
|
coop help-ai --format json
|
|
25
25
|
coop help-ai --format markdown
|
|
26
|
+
coop help-ai --selection --format markdown
|
|
27
|
+
coop help-ai --state-transitions --format json
|
|
28
|
+
coop help-ai --artifacts --format markdown
|
|
29
|
+
coop help-ai --post-execution --format markdown
|
|
30
|
+
coop help-ai --initial-prompt --strict --repo C:/path/to/repo --delivery MVP --command coop.cmd
|
|
31
|
+
coop help-ai --initial-prompt --rigour balanced --repo C:/path/to/repo --delivery MVP --command coop.cmd
|
|
32
|
+
coop config artifacts.dir docs/agent-artifacts
|
|
26
33
|
```
|
|
27
34
|
|
|
35
|
+
Agent contract notes:
|
|
36
|
+
- `coop complete task <id>` requires the task to already be in `in_review`.
|
|
37
|
+
- balanced initial prompts are the recommended default for normal implementation sessions.
|
|
38
|
+
- if an agent is unsure about selection, transitions, artifacts, or whether it should continue, it should call the matching focused `help-ai` topic command instead of guessing.
|
|
39
|
+
- strict initial prompts tell agents to stop after completing the selected task instead of auto-picking another one.
|
|
40
|
+
|
|
41
|
+
On Windows PowerShell, the global npm install may resolve `coop` to `coop.ps1` first. If an agent or CI shell hits execution-policy issues, use `coop.cmd` explicitly.
|
|
42
|
+
|
|
28
43
|
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`.
|
|
29
44
|
|
|
30
45
|
COOP v2 stores project data under `.coop/projects/<project.id>/...` and keeps workspace selection in `.coop/config.yml`.
|
|
31
46
|
|
|
32
47
|
Current implemented command families:
|
|
33
48
|
- `coop`
|
|
34
|
-
- `coop init [--name <name>] [--id <id>] [--aliases <csv>] [--yes]`
|
|
49
|
+
- `coop init [--name <name>] [--id <id>] [--aliases <csv>] [--naming <template>] [--yes]`
|
|
35
50
|
- `coop project list|create|use|show`
|
|
51
|
+
- `coop naming`
|
|
52
|
+
- `coop naming preview <title> [--template <template>]`
|
|
36
53
|
- `coop create task ...`
|
|
37
54
|
- `coop create task --acceptance <csv> --tests-required <csv> --authority-ref <ref> --derived-ref <ref>`
|
|
38
55
|
- `coop create task --from-file <path> | --stdin`
|
|
@@ -47,6 +64,7 @@ Current implemented command families:
|
|
|
47
64
|
- `coop next task [--track <track>] [--delivery <delivery>]`
|
|
48
65
|
- `coop pick task [--track <track>] [--delivery <delivery>] [--claim] [--to <assignee>]`
|
|
49
66
|
- `coop start task [id] [--claim] [--to <assignee>]`
|
|
67
|
+
- `coop review|complete|block|unblock|cancel|reopen task <id>`
|
|
50
68
|
- `coop assign task <id> --to <assignee> [--actor <actor>]`
|
|
51
69
|
- `coop list tasks|ideas|alias ...`
|
|
52
70
|
- `coop show task|idea ...`
|
|
@@ -70,10 +88,12 @@ Current implemented command families:
|
|
|
70
88
|
- `coop alias ...`
|
|
71
89
|
- `coop list alias [pattern]`
|
|
72
90
|
- `coop config index.data yaml|json`
|
|
73
|
-
- `coop config id.naming "<TYPE>-<
|
|
91
|
+
- `coop config id.naming "<TYPE>-<TITLE16>-<SEQ>"`
|
|
92
|
+
- `coop config id.naming "<TYPE>-<TITLE24>"`
|
|
74
93
|
- `coop config project.name <name>`
|
|
75
94
|
- `coop config project.id <id>`
|
|
76
95
|
- `coop config project.aliases <csv>`
|
|
96
|
+
- `coop config artifacts.dir <path>`
|
|
77
97
|
- `coop config ai.provider mock|openai|anthropic|gemini|ollama|codex_cli|claude_cli|gemini_cli`
|
|
78
98
|
- `coop config ai.model <model-name>`
|
|
79
99
|
- `coop run task <id> [--step <step>] [--dry-run]`
|
|
@@ -86,6 +106,7 @@ Known limitations:
|
|
|
86
106
|
- Plugin runtime supports manifest triggers under `.coop/projects/<project.id>/plugins/*.yml` (webhook + console + `github_pr` actions).
|
|
87
107
|
- `coop ui` is read-only and depends on the active project's `.index` data. The command rebuilds stale indexes before launch.
|
|
88
108
|
- `coop init` creates `.coop/.ignore` and `.coop/.gitignore` so logs, tmp files, and index artifacts are not committed by default.
|
|
109
|
+
- Semantic title-based IDs are the default. Use `coop naming` to inspect token behavior and preview IDs before changing `id.naming`.
|
|
89
110
|
|
|
90
111
|
GitHub integration quick example:
|
|
91
112
|
```yaml
|