@kitsy/coop 1.0.0 → 2.0.0

package/README.md

@@ -2,9 +2,28 @@
 
 CLI package for COOP.
 
+Install globally:
+
+```bash
+npm i -g @kitsy/coop
+coop --help
+```
+
+Install locally in a repo:
+
+```bash
+pnpm add -D @kitsy/coop
+pnpm exec coop --help
+```
+
+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`.
+
+COOP v2 stores project data under `.coop/projects/<project.id>/...` and keeps workspace selection in `.coop/config.yml`.
+
 Current implemented command families:
 - `coop`
-- `coop init`
+- `coop init [--name <name>] [--id <id>] [--aliases <csv>] [--yes]`
+- `coop project list|create|use|show`
 - `coop create task ...`
 - `coop create task --from <idea> --ai`
 - `coop create idea ...`
@@ -29,6 +48,7 @@ Current implemented command families:
 - `coop serve [--host <host>] [--port <port>] [--repo <path>]`
 - `coop webhook github [--host <host>] [--port <port>] [--repo <path>]`
 - `coop migrate --dry-run --to 2`
+- `coop migrate workspace-layout --to v2 [--name <name>] [--id <id>] [--aliases <csv>] [--yes]`
 - `coop alias ...`
 - `coop list alias [pattern]`
 - `coop config index.data yaml|json`
@@ -42,10 +62,11 @@ Current implemented command families:
 
 Known limitations:
 - `ext` is still a placeholder for future phases.
-- Provider-backed AI is supported for `openai`, `anthropic`, `gemini`, and `ollama` via `.coop/config.yml` + env vars.
-- Authorization is advisory and config-driven (`.coop/config.yml -> authorization`).
-- Plugin runtime supports manifest triggers under `.coop/plugins/*.yml` (webhook + console + `github_pr` actions).
-- `coop ui` is read-only and depends on local `.coop/.index` data. The command rebuilds stale indexes before launch.
+- Provider-backed AI is supported for `openai`, `anthropic`, `gemini`, and `ollama` via `.coop/projects/<project.id>/config.yml` + env vars.
+- Authorization is advisory and config-driven (`.coop/projects/<project.id>/config.yml -> authorization`).
+- Plugin runtime supports manifest triggers under `.coop/projects/<project.id>/plugins/*.yml` (webhook + console + `github_pr` actions).
+- `coop ui` is read-only and depends on the active project's `.index` data. The command rebuilds stale indexes before launch.
+- `coop init` creates `.coop/.ignore` and `.coop/.gitignore` so logs, tmp files, and index artifacts are not committed by default.
 
 GitHub integration quick example:
 ```yaml
@@ -58,7 +79,7 @@ github:
   merge_method: squash
 ```
 
-With `.coop/plugins/github-pr.yml` enabled:
+With `.coop/projects/<project.id>/plugins/github-pr.yml` enabled:
 - `coop transition task PM-101 in_review` creates or updates a PR
 - `coop transition task PM-101 done` merges the linked PR
 - `coop webhook github --port 8787` receives GitHub review/merge webhooks and syncs task status
@@ -80,6 +101,7 @@ With cross-repo task references such as `external:platform-repo/PM-200`:
 
 Workspace identity:
 ```yaml
+# .coop/projects/<project.id>/config.yml
 project:
   name: Payments Platform
   id: payments-platform

package/bin/coop.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { runCli } from "../dist/index.js";
+
+await runCli(process.argv);

package/bin/coop.mjs

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import { fileURLToPath } from "node:url";
+import { spawnSync } from "node:child_process";
+import path from "node:path";
+import process from "node:process";
+
+const script = path.join(path.dirname(fileURLToPath(import.meta.url)), "..", "dist", "index.js");
+const result = spawnSync(process.execPath, [script, ...process.argv.slice(2)], {
+  stdio: "inherit",
+});
+
+process.exit(result.status ?? 1);