@kitsy/coop 1.0.0 → 1.1.0

package/README.md

@@ -2,6 +2,22 @@
 
 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`.
+
 Current implemented command families:
 - `coop`
 - `coop init`
@@ -46,6 +62,7 @@ Known limitations:
 - 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.
+- `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

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);

package/dist/index.js

@@ -3,7 +3,7 @@
 // src/index.ts
 import fs13 from "fs";
 import path18 from "path";
-import { fileURLToPath as fileURLToPath2, pathToFileURL } from "url";
+import { fileURLToPath as fileURLToPath2 } from "url";
 import { Command } from "commander";
 
 // src/utils/aliases.ts
@@ -19,10 +19,17 @@ import { spawnSync } from "child_process";
 import crypto from "crypto";
 import { parseTaskFile, parseYamlFile, writeYamlFile } from "@kitsy/coop-core";
 var SEQ_MARKER = "COOPSEQTOKEN";
+function resolveCoopHome() {
+  const configured = process.env.COOP_HOME?.trim();
+  if (configured) {
+    return path.resolve(configured);
+  }
+  return path.join(os.homedir(), ".coop");
+}
 function resolveRepoRoot(start = process.cwd()) {
   let current = path.resolve(start);
   while (true) {
-    if (fs.existsSync(path.join(current, ".git"))) {
+    if (fs.existsSync(path.join(current, ".git")) || fs.existsSync(path.join(current, ".coop"))) {
       return current;
     }
     const parent = path.dirname(current);
@@ -2016,6 +2023,12 @@ triggers:
       type: github_pr
       operation: merge
 `;
+var COOP_IGNORE_TEMPLATE = `.index/
+logs/
+tmp/
+*.log
+*.tmp
+`;
 function ensureDir(dirPath) {
   fs6.mkdirSync(dirPath, { recursive: true });
 }
@@ -2111,6 +2124,8 @@ function registerInitCommand(program) {
     writeIfMissing(path8.join(coop, "templates/idea.md"), IDEA_TEMPLATE);
     writeIfMissing(path8.join(coop, "plugins/console-log.yml"), PLUGIN_CONSOLE_TEMPLATE);
     writeIfMissing(path8.join(coop, "plugins/github-pr.yml"), PLUGIN_GITHUB_TEMPLATE);
+    writeIfMissing(path8.join(coop, ".ignore"), COOP_IGNORE_TEMPLATE);
+    writeIfMissing(path8.join(coop, ".gitignore"), COOP_IGNORE_TEMPLATE);
     ensureGitignoreEntry(root, ".coop/.index/");
     const preCommitHook = installPreCommitHook(root);
     const postMergeHook = installPostMergeHook(root);
@@ -2276,10 +2291,10 @@ function resolveRepoSafe(start = process.cwd()) {
 function resolveCliLogFile(start = process.cwd()) {
   const root = resolveRepoSafe(start);
   const coop = coopDir(root);
-  if (fs7.existsSync(coop)) {
+  if (fs7.existsSync(path10.join(coop, "config.yml"))) {
     return path10.join(coop, "logs", "cli.log");
   }
-  return path10.join(root, ".coop-cli.log");
+  return path10.join(resolveCoopHome(), "logs", "cli.log");
 }
 function appendLogEntry(entry, logFile) {
   fs7.mkdirSync(path10.dirname(logFile), { recursive: true });
@@ -4426,7 +4441,7 @@ async function runCli(argv = process.argv) {
 function isMainModule() {
   const entry = process.argv[1];
   if (!entry) return false;
-  return import.meta.url === pathToFileURL(path18.resolve(entry)).href;
+  return path18.resolve(entry) === fileURLToPath2(import.meta.url);
 }
 if (isMainModule()) {
   await runCli(process.argv);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kitsy/coop",
   "description": "COOP command-line interface.",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "license": "MIT",
   "type": "module",
   "publishConfig": {
@@ -27,9 +27,10 @@
     "node": ">=20"
   },
   "bin": {
-    "coop": "dist/index.js"
+    "coop": "bin/coop.js"
   },
   "files": [
+    "bin",
     "dist",
     "README.md",
     "LICENSE"
@@ -38,7 +39,7 @@
     "chalk": "^5.6.2",
     "commander": "^14.0.0",
     "octokit": "^5.0.5",
-    "@kitsy/coop-ui": "^1.0.0",
+    "@kitsy/coop-ui": "^1.1.0",
     "@kitsy/coop-ai": "1.0.0",
     "@kitsy/coop-core": "1.0.0"
   },