@helloworlkd/pam-cli 0.1.16 → 0.1.17

package/README.md

@@ -2,6 +2,8 @@
 
 CLI for persistent, portable, model-independent AI memory.
 
+Published package: `@helloworlkd/pam-cli`.
+
 ## Installation
 
 ```bash
@@ -26,10 +28,8 @@ cd your-project
 npm install -D @helloworlkd/pam-cli
 ```
 
-Local install creates `.ai-memory/` and supported agent/IDE integration files.
-After the first install, reload VS Code/Cursor windows, start a new Claude
-Code/OpenCode session, or restart/open a new Codex session so the client reloads
-project config.
+Local install creates `.ai-memory/`. Run `pam init` after install to choose
+which agent/IDE integration files to generate.
 
 ## Quick Start
 

package/dist/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAanC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,QA6BnD"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAmBnC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,QAsCnD"}

package/dist/commands/init.js

@@ -1,21 +1,26 @@
-import { configureCodexGlobalIntegration, configureProjectIntegrations, initAutoCaptureConfig, initProjectMemory, } from '@helloworlkd/pam-core';
+import { createInterface } from 'node:readline/promises';
+import { stdin as input, stdout as output } from 'node:process';
+import { configureCodexGlobalIntegration, configureProjectIntegrations, getAllProjectIntegrationTargets, initAutoCaptureConfig, initProjectMemory, } from '@helloworlkd/pam-core';
 export function registerInitCommand(program) {
     const init = program.command('init').description('Initialize memory storage');
     init
         .option('--codex-global', 'Also configure the global Codex MCP server in ~/.codex/config.toml')
-        .option('--no-integrations', 'Skip agent and IDE integration files')
+        .option('--no-integrations', 'Skip project agent and IDE integration files')
+        .option('--all-integrations', 'Generate every supported project integration file')
+        .option('--integration <target>', 'Generate one project integration target. Repeatable. Targets: agents, claude, codex, copilot, cursor, opencode, mcp, vscode', collectIntegrationTarget, [])
         .action(async (options) => {
         const cwd = process.cwd();
         const path = await initProjectMemory(cwd);
         await initAutoCaptureConfig(path);
         console.log(`Memory initialized at: ${path}`);
-        if (options.integrations !== false) {
-            const { results } = await configureProjectIntegrations(cwd);
-            console.log('\nProject integrations:');
-            for (const result of results) {
-                const suffix = result.reason ? ` (${result.reason})` : '';
-                console.log(`  ${result.status}: ${result.path}${suffix}`);
-            }
+        const targets = await resolveIntegrationTargets(options);
+        if (targets.length > 0) {
+            const { results } = await configureProjectIntegrations(cwd, { targets });
+            printIntegrationResults(results);
+        }
+        else if (options.integrations !== false) {
+            console.log('\nProject integrations skipped.');
+            console.log('Run `pam init --integration <target>` or `pam init --all-integrations` when you know which tool files you want.');
         }
         if (options.codexGlobal) {
             const result = await configureCodexGlobalIntegration();
@@ -26,4 +31,69 @@ export function registerInitCommand(program) {
         }
     });
 }
+function collectIntegrationTarget(value, previous) {
+    return [...previous, value];
+}
+async function resolveIntegrationTargets(options) {
+    if (options.integrations === false)
+        return [];
+    if (options.allIntegrations)
+        return getAllProjectIntegrationTargets();
+    const explicit = normalizeIntegrationTargets(options.integration ?? []);
+    if (explicit.length > 0)
+        return explicit;
+    if (!process.stdin.isTTY || !process.stdout.isTTY)
+        return [];
+    return promptForIntegrationTargets();
+}
+function normalizeIntegrationTargets(values) {
+    const allTargets = new Set(getAllProjectIntegrationTargets());
+    const normalized = values.flatMap((value) => value
+        .split(',')
+        .map((entry) => entry.trim().toLowerCase())
+        .filter(Boolean));
+    const invalid = normalized.filter((value) => !allTargets.has(value));
+    if (invalid.length > 0) {
+        console.error(`Invalid integration target(s): ${invalid.join(', ')}`);
+        console.error(`Valid targets: ${getAllProjectIntegrationTargets().join(', ')}`);
+        process.exit(1);
+    }
+    return [...new Set(normalized)];
+}
+async function promptForIntegrationTargets() {
+    const targets = getAllProjectIntegrationTargets();
+    console.log('\nWhich project integrations should PAM generate?');
+    targets.forEach((target, index) => {
+        console.log(`  ${index + 1}. ${target}`);
+    });
+    console.log('  0. none');
+    const rl = createInterface({ input, output });
+    try {
+        const answer = await rl.question('Select numbers or names separated by commas (default: none): ');
+        const trimmed = answer.trim();
+        if (!trimmed)
+            return [];
+        if (trimmed === '0' || trimmed.toLowerCase() === 'none')
+            return [];
+        const selected = trimmed.split(',').map((entry) => entry.trim());
+        const mapped = selected.map((entry) => {
+            const numeric = Number.parseInt(entry, 10);
+            if (Number.isFinite(numeric) && String(numeric) === entry) {
+                return targets[numeric - 1] ?? entry;
+            }
+            return entry;
+        });
+        return normalizeIntegrationTargets(mapped);
+    }
+    finally {
+        rl.close();
+    }
+}
+function printIntegrationResults(results) {
+    console.log('\nProject integrations:');
+    for (const result of results) {
+        const suffix = result.reason ? ` (${result.reason})` : '';
+        console.log(`  ${result.status}: ${result.path}${suffix}`);
+    }
+}
 //# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AACA,OAAO,EACL,+BAA+B,EAC/B,4BAA4B,EAC5B,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,uBAAuB,CAAA;AAO9B,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,2BAA2B,CAAC,CAAA;IAE7E,IAAI;SACD,MAAM,CAAC,gBAAgB,EAAE,oEAAoE,CAAC;SAC9F,MAAM,CAAC,mBAAmB,EAAE,sCAAsC,CAAC;SACnE,MAAM,CAAC,KAAK,EAAE,OAA2B,EAAE,EAAE;QAC5C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;QACzB,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAA;QACzC,MAAM,qBAAqB,CAAC,IAAI,CAAC,CAAA;QACjC,OAAO,CAAC,GAAG,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAA;QAE7C,IAAI,OAAO,CAAC,YAAY,KAAK,KAAK,EAAE,CAAC;YACnC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,4BAA4B,CAAC,GAAG,CAAC,CAAA;YAC3D,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAA;YACtC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;gBACzD,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,GAAG,MAAM,EAAE,CAAC,CAAA;YAC5D,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxB,MAAM,MAAM,GAAG,MAAM,+BAA+B,EAAE,CAAA;YACtD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;YACzD,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAA;YAC1C,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,GAAG,MAAM,EAAE,CAAC,CAAA;YAC1D,OAAO,CAAC,GAAG,CAAC,qEAAqE,CAAC,CAAA;QACpF,CAAC;IACH,CAAC,CAAC,CAAA;AACN,CAAC"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helloworlkd/pam-cli",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "description": "PAM CLI - Command line interface for PAM",
   "type": "module",
   "license": "MIT",
@@ -45,9 +45,9 @@
     "@modelcontextprotocol/sdk": "^1.29.0",
     "commander": "^15.0.0",
     "zod": "^4.4.3",
-    "@helloworlkd/pam-core": "^0.1.9",
+    "@helloworlkd/pam-core": "^0.1.10",
     "@helloworlkd/pam-protocol": "^0.1.10",
-    "@helloworlkd/pam-api": "^0.1.15"
+    "@helloworlkd/pam-api": "^0.1.16"
   },
   "devDependencies": {
     "@types/node": "^25.9.3"

package/scripts/postinstall.mjs

@@ -69,21 +69,13 @@ function scheduleDeferredInit(projectPath) {
 
 async function initializeProject(projectPath) {
   try {
-    const { configureProjectIntegrations, initAutoCaptureConfig, initProjectMemory } =
-      await import('@helloworlkd/pam-core')
+    const { initAutoCaptureConfig, initProjectMemory } = await import('@helloworlkd/pam-core')
     const memoryPath = await initProjectMemory(projectPath)
     await initAutoCaptureConfig(memoryPath)
-    const { results } = await configureProjectIntegrations(projectPath)
-    const changed = results.filter(
-      (result) => result.status === 'created' || result.status === 'updated'
-    )
 
     console.log(`[PAM] Project memory initialized at ${memoryPath}`)
-    if (changed.length > 0) {
-      console.log(`[PAM] Wrote ${changed.length} agent/IDE integration file(s).`)
-    }
     console.log(
-      '[PAM] Reload VS Code/Cursor, start a new Claude Code/OpenCode session, or restart/open a new Codex session.'
+      '[PAM] Run `pam init` to choose which agent/IDE integration files to generate.'
     )
   } catch (error) {
     console.warn(