convene-cli 1.2.0 → 1.3.0

package/dist/index.js

@@ -57,14 +57,27 @@ const lane_1 = require("./commands/lane");
 const deploy_1 = require("./commands/deploy");
 const guard_1 = require("./commands/guard");
 const gate_push_1 = require("./commands/gate-push");
+const practice_guard_1 = require("./commands/practice-guard");
+const override_1 = require("./commands/override");
 const watch_1 = require("./commands/watch");
 const explain_1 = require("./commands/explain");
+const update_1 = require("./commands/update");
 const program = new commander_1.Command();
 // Read the version from package.json so `convene --version` always tracks the
 // published version (npm includes package.json in the tarball). dist/index.js
 // sits one level below package.json; in dev (tsx) src/index.ts does too.
 const { version } = JSON.parse((0, fs_1.readFileSync)((0, path_1.resolve)(__dirname, '../package.json'), 'utf8'));
 program.name(brand_1.BRAND.bin).description('Convene — AI development coordination bus').version(version);
+/**
+ * Commander maps `--no-practices` to `practices: false`; the catalog selection logic
+ * reads `noPractices`. Translate it (leaving every other option untouched) so init /
+ * setup see the field they expect.
+ */
+function withPracticeOpts(opts) {
+    if (opts.practices === false)
+        opts.noPractices = true;
+    return opts;
+}
 program
     .command('login')
     .description('authenticate and save config (0600)')
@@ -142,6 +155,18 @@ program
     .option('--dry-run', 'classify + report; do not gate or hit the network for the verdict')
     .option('--project <slug>')
     .action((opts) => (0, gate_push_1.gatePush)(opts));
+program
+    .command('practice-guard <id>')
+    .description('PreToolUse/Stop hook: level-aware best-practice gate (fail-open-loud)')
+    .option('--stdin', 'read the PreToolUse JSON payload from stdin')
+    .option('--project <slug>')
+    .action((id, opts) => (0, practice_guard_1.practiceGuard)(id, opts));
+program
+    .command('override <id>')
+    .description('grant a short-lived, attributed bypass for a best-practice gate')
+    .option('--reason <text>', 'why the gate is being overridden (required; attributed to the bus)')
+    .option('--project <slug>')
+    .action((id, opts) => (0, override_1.override)(id, opts));
 program
     .command('watch')
     .description('SessionStart-launched detached long-poll for directed halts (fail-open, self-healing)')
@@ -233,7 +258,11 @@ program
     .option('--yes', 'confirm onboarding non-interactively (required for agents/CI)')
     .option('--commit', 'commit ONLY the convene files as one isolated commit (never `git add -A`)')
     .option('--offline', 'write local files only (no API calls)')
-    .action((opts) => (0, init_1.init)(opts));
+    .option('--tier <names>', 'best practices: comma-separated tiers to adopt (essentials,recommended,advanced)')
+    .option('--practice <id[=level]>', 'best practice to adopt (id or id=level; repeatable)', (v, acc) => (acc.push(v), acc), [])
+    .option('--all-practices', 'adopt every catalog best practice at its default level')
+    .option('--no-practices', 'adopt no best practices (skip the catalog + interactive picker)')
+    .action((opts) => (0, init_1.init)(withPracticeOpts(opts)));
 program
     .command('off-board')
     .alias('offboard')
@@ -264,7 +293,11 @@ program
     .option('--force', 'commit a join token even if the repo looks public')
     .option('--yes', 'confirm onboarding non-interactively (required for agents/CI)')
     .option('--commit', 'commit ONLY the convene files as one isolated commit')
-    .action((opts) => (0, setup_1.setup)(opts));
+    .option('--tier <names>', 'best practices: comma-separated tiers to adopt (essentials,recommended,advanced)')
+    .option('--practice <id[=level]>', 'best practice to adopt (id or id=level; repeatable)', (v, acc) => (acc.push(v), acc), [])
+    .option('--all-practices', 'adopt every catalog best practice at its default level')
+    .option('--no-practices', 'adopt no best practices (skip the catalog + interactive picker)')
+    .action((opts) => (0, setup_1.setup)(withPracticeOpts(opts)));
 program
     .command('join')
     .description('self-provision: redeem a project join token for your own key + hook')
@@ -283,6 +316,14 @@ program
     .option('--yes')
     .option('--offline')
     .action((opts) => (0, migrate_1.migrate)(opts));
+program
+    .command('update')
+    .description('check for + apply best-practices catalog updates (review in your working tree; never auto-commits)')
+    .option('--apply', 're-materialize adopted practices to the live catalog (default: dry run)')
+    .option('--auto-patch', 'limit an unattended --apply to patch-only bumps')
+    .option('--force', 're-materialize MAJOR bumps and locally-edited (drifted) practices too')
+    .option('--project <slug>', 'project slug (defaults to .convene/project.json)')
+    .action((opts) => (0, update_1.update)(opts));
 program.command('doctor').description('diagnose setup').option('--fix', 'attempt safe fixes').action((opts) => (0, auth_1.doctor)(opts));
 program.parseAsync(process.argv).catch((err) => {
     process.stderr.write(`convene: ${err?.message || err}\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "convene-cli",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Convene CLI — AI development coordination bus client + UserPromptSubmit hook. Install: npm i -g convene-cli; then `convene setup`.",
   "license": "MIT",
   "homepage": "https://dev.convene.live",