contextecf-codeledger 0.10.22 → 0.10.24

package/README.md

@@ -1,9 +1,9 @@
-# contextecf-codeledger — CodeLedger
+# contextecf-codeledger — ContextECF CodeLedger
 
 **Deterministic, bounded context selection for AI coding agents.**
 Published by [Intelligent Context AI, Inc.](https://codeledger.dev).
 
-This is the **unscoped mirror** of [`@codeledger/cli`](https://www.npmjs.com/package/@codeledger/cli). Both packages install the exact same binary. Use whichever you prefer:
+This is the **safe unscoped alias** of [`@codeledger/cli`](https://www.npmjs.com/package/@codeledger/cli). Both packages install the exact same ContextECF CodeLedger binary. Use whichever you prefer:
 
 ```bash
 npm install -g contextecf-codeledger@latest   # this package

package/bin/codeledger.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 /*
- * CodeLedger npm launcher — thin shim (unscoped mirror).
+ * ContextECF CodeLedger npm launcher — thin shim (safe unscoped alias).
  *
- * This is the unscoped mirror of @codeledger/cli. Both packages install
+ * This is the safe unscoped alias of @codeledger/cli. Both packages install
  * the exact same hardened binary. You can install either:
  *
  *   npm install -g contextecf-codeledger@latest   (this package)
@@ -16,7 +16,7 @@
 
 const { spawnSync } = require('node:child_process');
 const { existsSync } = require('node:fs');
-const { join } = require('node:path');
+const { dirname, join, resolve } = require('node:path');
 const { homedir, platform } = require('node:os');
 
 const { version } = require('../package.json');
@@ -37,7 +37,50 @@ function die(msg, code = 1) {
   process.exit(code);
 }
 
+function findRepoLocalRuntime(startDir) {
+  if (process.env.CODELEDGER_GLOBAL_VERSION_PROBE === '1') return null;
+  let current = resolve(startDir);
+  while (true) {
+    const wrapper = join(current, '.codeledger', 'bin', 'codeledger');
+    const standalone = join(current, '.codeledger', 'bin', 'codeledger-standalone.cjs');
+    if (existsSync(wrapper)) return { kind: 'wrapper', path: wrapper, repoRoot: current };
+    if (existsSync(standalone)) return { kind: 'standalone', path: standalone, repoRoot: current };
+    const parent = dirname(current);
+    if (parent === current) return null;
+    current = parent;
+  }
+}
+
+function runRepoLocal(runtime) {
+  process.stderr.write(
+    [
+      `codeledger: ContextECF CodeLedger hardened binary for v${version} is not installed in the global cache.`,
+      `codeledger: using repo-local runtime at ${runtime.path}`,
+      '',
+    ].join('\n'),
+  );
+  const command = runtime.kind === 'standalone' ? process.execPath : runtime.path;
+  const args = runtime.kind === 'standalone'
+    ? [runtime.path, ...process.argv.slice(2)]
+    : process.argv.slice(2);
+  const result = spawnSync(command, args, {
+    stdio: 'inherit',
+    cwd: runtime.repoRoot,
+    env: { ...process.env, CODELEDGER_DELEGATED: '1' },
+    shell: runtime.kind === 'wrapper',
+  });
+  if (result.error) {
+    die(`failed to spawn repo-local runtime: ${result.error.message}`);
+  }
+  process.exit(result.status ?? 1);
+}
+
 if (!existsSync(BINARY_PATH)) {
+  const repoLocal = findRepoLocalRuntime(process.cwd());
+  if (repoLocal) {
+    runRepoLocal(repoLocal);
+  }
+
   const { arch } = require('node:os');
   const platformKey = `${platform()}-${arch()}`;
   const installerPath = join(__dirname, '..', 'scripts', 'postinstall.js');
@@ -45,7 +88,7 @@ if (!existsSync(BINARY_PATH)) {
   if (platformKey === 'darwin-x64') {
     die(
       [
-        `hardened binary for v${version} not found at ${BINARY_PATH}.`,
+        `ContextECF CodeLedger hardened binary for v${version} not found at ${BINARY_PATH}.`,
         '',
         'You are on an Intel Mac (darwin-x64). Pre-built binaries are',
         'available for Apple Silicon (darwin-arm64) only.',
@@ -53,10 +96,10 @@ if (!existsSync(BINARY_PATH)) {
         'Options:',
         '  1. Use Rosetta 2 (recommended):',
         '       arch -arm64 npm install -g contextecf-codeledger@latest',
-        '  2. Update CodeLedger, then use the vendored standalone CLI:',
+        '  2. If this repo was already initialized, use the vendored CLI:',
         '       npm install -g contextecf-codeledger@latest',
-        '       codeledger init   # in your repo, sets up vendored Node.js-based CLI',
-        '       ./.codeledger/bin/codeledger --version',
+        '       ./.codeledger/bin/codeledger ready',
+        '       node .codeledger/bin/codeledger-standalone.cjs ready',
         '  3. Download a binary manually from:',
         `       https://github.com/codeledgerECF/codeledger/releases/tag/v${version}`,
       ].join('\n'),
@@ -64,14 +107,17 @@ if (!existsSync(BINARY_PATH)) {
   } else {
     die(
       [
-        `hardened binary for v${version} not found at ${BINARY_PATH}.`,
+        `ContextECF CodeLedger hardened binary for v${version} not found at ${BINARY_PATH}.`,
         '',
         'The postinstall step may have been skipped (e.g. --ignore-scripts).',
+        'This safe alias installs ContextECF CodeLedger. Avoid: npm install -g codeledger.',
+        '',
         'Recover with one of:',
         `  1. Upgrade: npm install -g contextecf-codeledger@latest`,
         `  2. Retry this install: npm rebuild contextecf-codeledger`,
         `  3. node "${installerPath}"`,
         `  4. Re-run the install without --ignore-scripts`,
+        `  5. In an initialized repo, use: ./.codeledger/bin/codeledger ready`,
         '',
         'Or download the binary manually from:',
         `  https://github.com/codeledgerECF/codeledger/releases/tag/v${version}`,

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "contextecf-codeledger",
-  "version": "0.10.22",
+  "version": "0.10.24",
   "mcpName": "io.github.codeledgerECF/codeledger",
-  "description": "CodeLedger — deterministic context selection for AI coding agents. This is the unscoped mirror of @codeledger/cli; both install the same binary.",
+  "description": "ContextECF CodeLedger — deterministic context selection for AI coding agents. Safe unscoped alias for @codeledger/cli; avoid the unrelated codeledger package.",
   "type": "commonjs",
   "bin": {
     "codeledger": "./bin/codeledger.js"

package/scripts/postinstall.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 /*
- * CodeLedger postinstall — download + verify the hardened binary.
+ * ContextECF CodeLedger postinstall — download + verify the hardened binary.
  *
- * Runs automatically on `npm install -g @codeledger/cli`. Downloads the
+ * Runs automatically on `npm install -g contextecf-codeledger`. Downloads the
  * platform-specific hardened binary from the GitHub Release for this
  * exact version, verifies its SHA256 against SHA256SUMS-v<version>.txt
  * (also downloaded from the release), and writes it to the cache dir.
@@ -41,7 +41,7 @@ const { version } = require('../package.json');
 
 if (process.env.CODELEDGER_SKIP_POSTINSTALL === '1') {
   console.log(
-    'codeledger: CODELEDGER_SKIP_POSTINSTALL=1 set, skipping hardened binary download.',
+    'codeledger: CODELEDGER_SKIP_POSTINSTALL=1 set, skipping ContextECF CodeLedger hardened binary download.',
   );
   process.exit(0);
 }
@@ -56,7 +56,7 @@ try {
   const workspaceRoot = path.resolve(__dirname, '..', '..', '..');
   if (fs.existsSync(path.join(workspaceRoot, 'pnpm-workspace.yaml'))) {
     console.log(
-      'codeledger: in-workspace dev install detected, skipping hardened binary download.',
+      'codeledger: in-workspace dev install detected, skipping ContextECF CodeLedger hardened binary download.',
     );
     process.exit(0);
   }
@@ -80,16 +80,18 @@ const platformSuffix = PLATFORM_MAP[platformKey];
 if (!platformSuffix) {
   if (platformKey === 'darwin-x64') {
     console.log('');
-    console.log('codeledger: Intel Mac (darwin-x64) detected.');
+    console.log('codeledger: ContextECF CodeLedger Intel Mac (darwin-x64) detected.');
     console.log('codeledger: Pre-built binaries are available for Apple Silicon (darwin-arm64) only.');
     console.log('');
     console.log('Options:');
+    console.log('  Safe alias: contextecf-codeledger. Official package: @codeledger/cli. Avoid: codeledger.');
     console.log('  1. Use Rosetta 2 (recommended):');
     console.log('       arch -arm64 npm install -g contextecf-codeledger@latest');
-    console.log('  2. Use the vendored standalone CLI after init:');
-    console.log('       CODELEDGER_SKIP_POSTINSTALL=1 npm install -g contextecf-codeledger@latest');
-    console.log('       codeledger init   # sets up vendored Node.js-based CLI');
-    console.log('  3. Download a binary manually from:');
+    console.log('  2. If this repo was already initialized, use the vendored CLI:');
+    console.log('       ./.codeledger/bin/codeledger ready');
+    console.log('       node .codeledger/bin/codeledger-standalone.cjs ready');
+    console.log('  3. For a new repo without a vendored CLI, use a supported platform or Docker.');
+    console.log('  4. Download a binary manually from:');
     console.log(`       https://github.com/codeledgerECF/codeledger/releases/tag/v${version}`);
     console.log('');
   } else {
@@ -102,7 +104,7 @@ if (!platformSuffix) {
       `codeledger: v${version} does not provide a hardened binary for ${platformKey}.`,
     );
     console.error(
-      'codeledger: you can still use the published source package or a supported release asset.',
+      'codeledger: this installer is for ContextECF CodeLedger; you can still use the published source package or a supported release asset.',
     );
   }
   // Fail softly: don't block `npm install` for unsupported platforms. The