@cohesivity/init 0.6.7 → 0.7.1

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 +104 -4
  2. package/bin/cli.js +5 -5
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -26,7 +26,7 @@ Portable directories are staged and atomically replaced.
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
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
- | 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 |
29
+ | OpenCode | preserve the verified portable package, install its skill to `~/.agents/skills/cohesivity`, then use `opencode mcp add` for the local four-tool server and remote management server |
30
30
 
31
31
  Detection is additive rather than first-match-wins. A Claude home does not stop
32
32
  Cursor, Codex, Gemini, Antigravity, OpenClaw, Hermes, or OpenCode from also being
@@ -82,14 +82,14 @@ The manifest schema is:
82
82
  ```json
83
83
  {
84
84
  "schema_version": 1,
85
- "version": "2.1.5",
85
+ "version": "3.0.5",
86
86
  "packages": [
87
87
  {
88
88
  "client": "portable",
89
89
  "immutable_url": "https://immutable.example/portable.tar.gz",
90
90
  "size": 1234,
91
91
  "sha256": "64 lowercase hexadecimal characters",
92
- "archive": "cohesivity-portable-2.1.5.tar.gz"
92
+ "archive": "cohesivity-portable-3.0.5.tar.gz"
93
93
  }
94
94
  ]
95
95
  }
@@ -97,7 +97,7 @@ The manifest schema is:
97
97
 
98
98
  The installer maps Claude and OpenClaw to `claude`; Cursor and Hermes to
99
99
  `portable`; Codex to `codex`; Gemini to `gemini`; and Antigravity to
100
- `antigravity`. The 2.1.5 manifest also carries the direct `openai` package,
100
+ `antigravity`. The 3.0.5 manifest also carries the direct `openai` package,
101
101
  which this marketplace-based Codex installer does not select. Extraction
102
102
  rejects absolute paths, traversal, links, duplicate paths, special files,
103
103
  malformed headers, oversized content, and archives without an end marker.
@@ -166,6 +166,41 @@ server-issued, and not derived from hardware or user data. Delete
166
166
  | `--base <url>` | API base for tenant bootstrap (default `https://cohesivity.ai`) |
167
167
  | `-h`, `--help` | show command help and the exact package version |
168
168
 
169
+ ## 0.7.1 four-tool skill guidance
170
+
171
+ Version 0.7.1 delivers plugin 3.0.6 and its matching standalone skill. The skill
172
+ lists the four supported MCP tools and requires a human handoff for unsupported
173
+ control-plane mutations, including deployment, billing, and destruction. It
174
+ does not permit an HTTP, CLI, or script bypass. Its no-MCP fallback pins this
175
+ initializer version so bootstrap does not reinstall the previous guidance.
176
+
177
+ The plugin's MCP behavior, explicit confirmation checks, client adapters, and
178
+ initializer bootstrap behavior are unchanged. The shared release observation
179
+ is regenerated from the immutable candidate artifacts, not edited by hand.
180
+
181
+ ## 0.7.0 four-tool bootstrap interface
182
+
183
+ Version 0.7.0 pins the published Cohesivity plugin 3.0.5. This is a breaking
184
+ change from 0.6.7's six-tool local interface: the installed server exposes only
185
+ `create_tenant`, `claim_tenant`, `tenant_status`, and `provision_resource`.
186
+ Single and bulk provisioning share `provision_resource`, replacing the separate
187
+ `bulk_provision_resources` tool. Deprovisioning is outside the four-tool MCP
188
+ interface; do not bypass the skill's MCP-only control-plane mutation policy
189
+ with direct HTTP requests.
190
+
191
+ Mutating local tool calls now require literal `confirmed: true`, an argument
192
+ that plugin 2.1.5 did not accept. Pass it only when the current user request
193
+ explicitly authorizes the exact action; otherwise ask first. Client adapters,
194
+ initializer tenant bootstrap, and OAuth handling are unchanged. The remote
195
+ management connection keeps its existing URL; this npm release does not deploy
196
+ the hosted server.
197
+
198
+ Standalone and fallback skill installs now pin
199
+ `cohesivity-org/cohesivity-skill@78d6d26c09ea955e2ab2392a62d980817bcabb39`
200
+ (metadata version `2923f0623a63`), matching the canonical skill in plugin 3.0.5.
201
+ Those published skill bytes still name `@cohesivity/init@0.6.6` as their
202
+ no-MCP fallback; this release does not rewrite upstream skill content.
203
+
169
204
  ## 0.6.7 local MCP metadata compatibility
170
205
 
171
206
  Version 0.6.7 pins Cohesivity plugin 2.1.5. Its local MCP accepts optional
@@ -253,6 +288,71 @@ with provenance:
253
288
  npm audit signatures
254
289
  ```
255
290
 
291
+ ### Check installer delivery drift
292
+
293
+ Before tagging an initializer release, compare its source candidate with the
294
+ published shell installer and canonical skill:
295
+
296
+ ```bash
297
+ node scripts/verify-release.mjs --source bin/cli.js
298
+ ```
299
+
300
+ For a coordinated quickstart or canonical-skill update, pass the rendered
301
+ candidate files with `--quickstart-source <quickstart.sh>` and
302
+ `--skill-source <skill.md>`. These replace only those two public documents;
303
+ referenced immutable artifacts are still downloaded and verified. The main
304
+ Cohesivity repository vendors this verifier and its observation so its existing
305
+ unit gate can check the quickstart renderer against the same release contract.
306
+
307
+ After npm publication, run the same check against the actual npm `latest`
308
+ tarball, rather than the checkout:
309
+
310
+ ```bash
311
+ node scripts/verify-release.mjs
312
+ ```
313
+
314
+ Both commands are read-only: they download public artifacts without running an
315
+ installer, configuring clients, creating tenants, or starting OAuth. They verify
316
+ npm tarball integrity and plugin size/hash pins, then compare the release version inside each client archive and its MCP server,
317
+ standalone skill URLs and bytes, and the six packaged client skills across npm
318
+ and quickstart. Claude has an intentional skill adapter, so its two deliveries
319
+ must match each other; the other five client skills must also match the live
320
+ `https://cohesivity.ai/skill.md`. Antigravity's native manifest has no version field, so its packaged MCP server
321
+ supplies the version. Different archive commits are allowed when the release
322
+ version and delivered skill bytes agree.
323
+
324
+ `node --test` includes offline comparison regressions and a recorded delivery
325
+ snapshot. When changing release pins, refresh that snapshot only after the
326
+ candidate passes the live check, then review its immutable URLs and hashes.
327
+ For this coordinated release, render the quickstart and generated skill from
328
+ the matching core candidate in cohesivity-org/cohesivity#514 and supply all
329
+ three candidate inputs:
330
+
331
+ ```bash
332
+ node scripts/verify-release.mjs --source bin/cli.js \
333
+ --quickstart-source /path/to/rendered-quickstart.sh \
334
+ --skill-source /path/to/generated-skill.md \
335
+ --snapshot tests/fixtures/release-observation.json
336
+ node --test
337
+ ```
338
+
339
+ Omit the two document overrides only when intentionally checking the deployed
340
+ quickstart and skill. The observation records those flags; changing the inputs
341
+ changes that metadata. A new observation also receives a fresh timestamp.
342
+
343
+ The snapshot catches source pin changes that have not been checked against the
344
+ other delivery path. Offline unit tests cannot detect a later independent npm,
345
+ quickstart, or canonical-skill publication; the live checks above are required
346
+ release verification. They are not automatically added to CI by this change.
347
+ A mismatch exits nonzero and does not rewrite any release pin. Publication of
348
+ 0.7.1 remains a separate release step; an unmerged PR does not update npm.
349
+
350
+ This comparison covers the skill bytes delivered by each installer. It does not
351
+ rewrite or verify the availability of package versions mentioned inside the
352
+ canonical skill, test native client behavior, or change mutation consent.
353
+ Verify that the pinned fallback is published before merging the matching
354
+ canonical skill, skill mirror, or plugin release.
355
+
256
356
  Node.js 18+ is required for built-in `fetch`. The package has zero dependencies
257
357
  and no `postinstall` hook.
258
358
 
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.7';
47
+ const PKG_VERSION = '0.7.1';
48
48
 
49
49
  function validateArgs() {
50
50
  const switches = new Set(['--dry-run', '--no-plugin', '--no-branding', '--help', '-h']);
@@ -78,16 +78,16 @@ const MACHINE_ID_FILE = join(MACHINE_ID_DIR, 'machine-id');
78
78
 
79
79
  // The skill is pinned to an immutable commit in the public, auditable repo.
80
80
  // Bumping the pin is a deliberate release step. See COH-172.
81
- const SKILL_PIN = 'f97e0d2ac8a653b7d54d1bb6e70aee78a8887e60';
81
+ const SKILL_PIN = '1c65e6d1bf4690d7ee3b046bcd8251387b4f701b';
82
82
  const SKILL_URL = `https://raw.githubusercontent.com/cohesivity-org/cohesivity-skill/${SKILL_PIN}/cohesivity.skill.md`;
83
83
 
84
84
  // Plugin release pins live in this one block. Bump all three values together
85
85
  // after publishing a new two-commit artifact manifest from cohesivity-plugin.
86
86
  // Tests inject a complete pin with COHESIVITY_PLUGIN_MANIFEST_PIN.
87
87
  const PLUGIN_RELEASE = Object.freeze({
88
- manifestUrl: 'https://raw.githubusercontent.com/cohesivity-org/cohesivity-plugin/f1b3e82d57a2df873aa3486152d6073606f635dc/artifacts/v2.1.5/install-manifest.v1.json',
89
- manifestBytes: 9610,
90
- manifestSha256: '3e70241b60f23af3893c98845f809cfcefe340c7c3ad452fd82fdeac0a373ece',
88
+ manifestUrl: 'https://raw.githubusercontent.com/cohesivity-org/cohesivity-plugin/e157d473a8e60531572fd29ccfd2314bd6e2983a/artifacts/v3.0.6/install-manifest.v1.json',
89
+ manifestBytes: 9400,
90
+ manifestSha256: 'a295d7b318077a935ae9b0469916f8213a8cdf27b8c9bf7ee604d3007ca06495',
91
91
  });
92
92
 
93
93
  const ARTIFACT_KEYS = Object.freeze({
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cohesivity/init",
3
- "version": "0.6.7",
3
+ "version": "0.7.1",
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": {