@cohesivity/init 0.6.5 → 0.6.6

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.
Files changed (3) hide show
  1. package/README.md +15 -4
  2. package/bin/cli.js +46 -7
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -25,7 +25,7 @@ Portable directories are staged and atomically replaced.
25
25
  | Gemini | first run: `gemini extensions install <verified-local-gemini-root> --consent`; rerun: `gemini extensions update cohesivity` |
26
26
  | Antigravity | `agy plugin install <verified-local-root>`; if `agy` is absent, atomically copy to `~/.gemini/config/plugins/cohesivity` only when an Antigravity-specific home is present |
27
27
  | OpenClaw | install `cohesivity` through the verified Claude marketplace root, enable it, then save the remote Streamable HTTP OAuth MCP |
28
- | Hermes | atomically copy to `~/.hermes/plugins/cohesivity`, then `hermes plugins enable cohesivity` |
28
+ | Hermes | install the canonical skill and local server in Hermes-owned paths, import both MCP entries through `hermes import-agent ... --overwrite --yes`, then set the two enabled flags and dormant OAuth metadata with `hermes config set` |
29
29
  | OpenCode | preserve the verified portable package, install its skill to `~/.agents/skills/cohesivity`, then use `opencode mcp add` for the local six-tool server and remote management server |
30
30
 
31
31
  Detection is additive rather than first-match-wins. A Claude home does not stop
@@ -51,9 +51,10 @@ different boundaries: the public documentation server at
51
51
  `https://cohesivity.ai/mcp` needs no login, the installed local project-bootstrap
52
52
  server needs no login, and `https://cohesivity.ai/mcp/manage` requires OAuth for
53
53
  account-scoped management. OpenCode users start that last flow explicitly with
54
- `opencode mcp auth cohesivity`. Hermes remote MCP OAuth is qualified: automatic
55
- login works only when the endpoint supports Dynamic Client Registration;
56
- otherwise Hermes needs a pre-registered OAuth client.
54
+ `opencode mcp auth cohesivity`. Hermes uses the exact native server name
55
+ `cohesivity`; `hermes mcp login cohesivity` starts its management OAuth flow.
56
+ The Cohesivity endpoint advertises Dynamic Client Registration, so Hermes does
57
+ not need a pre-registered OAuth client.
57
58
 
58
59
  ## Standalone skill only
59
60
 
@@ -165,6 +166,16 @@ server-issued, and not derived from hardware or user data. Delete
165
166
  | `--base <url>` | API base for tenant bootstrap (default `https://cohesivity.ai`) |
166
167
  | `-h`, `--help` | show command help and the exact package version |
167
168
 
169
+ ## 0.6.6 released Hermes adapter
170
+
171
+ Version 0.6.6 replaces portable-plugin enablement with surfaces shipped by the
172
+ immutable Hermes 0.20.0 release. It keeps plugin 2.1.4's verified local server in
173
+ Hermes's native MCP directory, installs the canonical skill in its skill directory,
174
+ and feeds the local and remote entries through Hermes's own noninteractive
175
+ Claude import and structural config commands. Reruns overwrite only the two
176
+ Cohesivity MCP names, preserve unrelated Hermes settings, verify the exact
177
+ persisted command/URL/auth values, and never start OAuth.
178
+
168
179
  ## 0.6.5 OpenCode and repeat-safe Gemini delivery
169
180
 
170
181
  Version 0.6.5 recognizes OpenCode only from its executable, preserves the
package/bin/cli.js CHANGED
@@ -44,7 +44,7 @@ import { gunzipSync } from 'node:zlib';
44
44
  const argv = process.argv.slice(2);
45
45
  const has = (f) => argv.includes(f);
46
46
  const flag = (f) => { const i = argv.indexOf(f); return i >= 0 ? argv[i + 1] : undefined; };
47
- const PKG_VERSION = '0.6.5';
47
+ const PKG_VERSION = '0.6.6';
48
48
 
49
49
  function validateArgs() {
50
50
  const switches = new Set(['--dry-run', '--no-plugin', '--no-branding', '--help', '-h']);
@@ -176,6 +176,7 @@ async function main() {
176
176
  // ── 1) detect clients and deliver verified integrations ──────────────────────
177
177
  const HOME = homedir();
178
178
  const CODEX_HOME = process.env.CODEX_HOME || join(HOME, '.codex');
179
+ const HERMES_HOME = process.env.HERMES_HOME || join(HOME, '.hermes');
179
180
  const DATA_HOME = process.env.XDG_DATA_HOME || join(HOME, '.local', 'share');
180
181
  const DURABLE_PLUGIN_ROOT = join(DATA_HOME, 'cohesivity', 'plugin-packages');
181
182
  const CANONICAL_SKILL_DIR = join(HOME, '.agents', 'skills', 'cohesivity');
@@ -554,11 +555,38 @@ async function installForClient(client, artifact) {
554
555
  auth: 'oauth',
555
556
  })]);
556
557
  break;
557
- case 'hermes':
558
- installDirectoryAtomically(root, join(HOME, '.hermes', 'plugins', 'cohesivity'));
558
+ case 'hermes': {
559
559
  requireClientCli(client);
560
- runNative(client.bin, ['plugins', 'enable', 'cohesivity']);
560
+ const skill = join(nativeSource, 'skills', 'cohesivity');
561
+ const packagedServer = join(nativeSource, 'mcp', 'project-bootstrap.mjs');
562
+ const localServer = join(HERMES_HOME, 'mcp', 'cohesivity', 'project-bootstrap.mjs');
563
+ if (!existsSync(join(skill, 'SKILL.md')) || !existsSync(packagedServer)) throw new Error('verified portable artifact is missing its Hermes skill or local MCP server');
564
+ installDirectoryAtomically(skill, join(HERMES_HOME, 'skills', 'cohesivity'));
565
+ installFileAtomically(localServer, readFileSync(packagedServer, 'utf8'));
566
+ const importRoot = mkdtempSync(join(tmpdir(), 'cohesivity-hermes-import-'));
567
+ try {
568
+ mkdirSync(join(importRoot, '.claude'), { mode: 0o700 });
569
+ writeFileSync(join(importRoot, '.claude.json'), JSON.stringify({
570
+ mcpServers: {
571
+ 'cohesivity-local': { command: process.execPath, args: [localServer] },
572
+ cohesivity: { url: MCP_URL },
573
+ },
574
+ }), { mode: 0o600 });
575
+ runNative(client.bin, ['import-agent', 'claude-code', '--source', join(importRoot, '.claude'), '--overwrite', '--yes']);
576
+ runNative(client.bin, ['config', 'set', 'mcp_servers.cohesivity-local.enabled', 'true']);
577
+ runNative(client.bin, ['config', 'set', 'mcp_servers.cohesivity.auth', 'oauth']);
578
+ runNative(client.bin, ['config', 'set', 'mcp_servers.cohesivity.enabled', 'true']);
579
+ const local = runNativeJson(client.bin, ['config', 'get', 'mcp_servers.cohesivity-local', '--json']);
580
+ const remote = runNativeJson(client.bin, ['config', 'get', 'mcp_servers.cohesivity', '--json']);
581
+ if (local?.command !== process.execPath || JSON.stringify(local.args) !== JSON.stringify([localServer]) || local?.enabled !== true
582
+ || remote?.url !== MCP_URL || remote?.auth !== 'oauth' || remote?.enabled !== true) {
583
+ throw new Error('Hermes native MCP reconciliation did not persist the exact Cohesivity entries');
584
+ }
585
+ } finally {
586
+ rmSync(importRoot, { recursive: true, force: true });
587
+ }
561
588
  break;
589
+ }
562
590
  case 'opencode': {
563
591
  requireClientCli(client);
564
592
  const skill = join(nativeSource, 'skills', 'cohesivity', 'SKILL.md');
@@ -585,6 +613,13 @@ function runNative(command, args, env = process.env) {
585
613
  const detail = String(result.stderr || result.stdout || '').trim().replace(/\s+/g, ' ').slice(0, 300);
586
614
  throw new Error(`${formatCommand(command, args)} exited ${result.status}${detail ? `: ${detail}` : ''}`);
587
615
  }
616
+ return result;
617
+ }
618
+
619
+ function runNativeJson(command, args) {
620
+ const result = runNative(command, args);
621
+ try { return JSON.parse(String(result.stdout || '').trim()); }
622
+ catch { throw new Error(`${formatCommand(command, args)} returned invalid JSON`); }
588
623
  }
589
624
 
590
625
  function installDirectoryAtomically(source, destination) {
@@ -667,8 +702,12 @@ function describeDryRunPluginDelivery(clients) {
667
702
  act(`run ${formatCommand(client.bin || 'openclaw', ['plugins', 'enable', 'cohesivity'])}`);
668
703
  act(`run ${formatCommand(client.bin || 'openclaw', ['mcp', 'set', 'cohesivity', JSON.stringify({ url: MCP_URL, transport: 'streamable-http', auth: 'oauth' })])}`);
669
704
  } else if (client.id === 'hermes') {
670
- act(`atomically replace ${displayPath(join(HOME, '.hermes', 'plugins', 'cohesivity'))} from ${root}`);
671
- act(`run ${formatCommand(client.bin || 'hermes', ['plugins', 'enable', 'cohesivity'])}`);
705
+ act(`atomically replace ${displayPath(join(HERMES_HOME, 'skills', 'cohesivity'))} from ${root}/skills/cohesivity`);
706
+ act(`atomically replace ${displayPath(join(HERMES_HOME, 'mcp', 'cohesivity', 'project-bootstrap.mjs'))} from ${root}/mcp/project-bootstrap.mjs`);
707
+ act(`run ${formatCommand(client.bin || 'hermes', ['import-agent', 'claude-code', '--source', '<generated-cohesivity-import>/.claude', '--overwrite', '--yes'])}`);
708
+ act(`run ${formatCommand(client.bin || 'hermes', ['config', 'set', 'mcp_servers.cohesivity-local.enabled', 'true'])}`);
709
+ act(`run ${formatCommand(client.bin || 'hermes', ['config', 'set', 'mcp_servers.cohesivity.auth', 'oauth'])}`);
710
+ act(`run ${formatCommand(client.bin || 'hermes', ['config', 'set', 'mcp_servers.cohesivity.enabled', 'true'])}`);
672
711
  } else if (client.id === 'opencode') {
673
712
  act(`atomically replace ${nativeRoot} from ${root}`);
674
713
  act(`atomically install ${displayPath(join(CANONICAL_SKILL_DIR, 'SKILL.md'))} from ${nativeRoot}`);
@@ -690,7 +729,7 @@ function printClientInstructions(clients, adapters) {
690
729
  gemini: 'Gemini: restart the CLI, then run /mcp auth cohesivity if authentication is required.',
691
730
  antigravity: 'Antigravity: restart, open /mcp (or Installed MCP Servers), and authenticate Cohesivity.',
692
731
  openclaw: 'OpenClaw: restart the Gateway if it did not auto-restart, then run openclaw mcp login cohesivity.',
693
- hermes: 'Hermes: restart, copy the exact qualified remote server name Hermes reports into a native mcp_servers owner override that repeats the URL and sets auth: oauth, then run hermes mcp login <qualified-server-name>. Dynamic Client Registration must be supported; otherwise Hermes needs a pre-registered OAuth client.',
732
+ hermes: 'Hermes: restart the client; the local bootstrap tools need no login, and hermes mcp login cohesivity starts OAuth through Dynamic Client Registration only when management tools are needed.',
694
733
  opencode: 'OpenCode: restart the client; the local bootstrap tools need no login, and opencode mcp auth cohesivity starts OAuth only when management tools are needed.',
695
734
  }[client.id];
696
735
  console.log(` - ${instruction}`);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cohesivity/init",
3
- "version": "0.6.5",
3
+ "version": "0.6.6",
4
4
  "description": "Set up Cohesivity in a project: install the agent skill, create a managed backend tenant, write the project config. Run with `npx @cohesivity/init`.",
5
5
  "type": "module",
6
6
  "bin": {