@helloworlkd/pam-cli 0.1.16

package/dist/index.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { registerInitCommand } from './commands/init.js';
+import { registerAddCommand } from './commands/add.js';
+import { registerListCommand } from './commands/list.js';
+import { registerShowCommand } from './commands/show.js';
+import { registerEditCommand } from './commands/edit.js';
+import { registerDeleteCommand } from './commands/delete.js';
+import { registerArchiveCommand } from './commands/archive.js';
+import { registerIndexCommand } from './commands/index-cmd.js';
+import { registerSearchCommand } from './commands/search.js';
+import { registerDoctorCommand } from './commands/doctor.js';
+import { registerRedactCommand } from './commands/redact.js';
+import { registerRestoreCommand } from './commands/restore.js';
+import { registerApproveCommand } from './commands/approve.js';
+import { registerRejectCommand } from './commands/reject.js';
+import { registerCaptureCommand } from './commands/capture.js';
+import { registerCheckpointCommand } from './commands/checkpoint.js';
+import { registerAuditCommand } from './commands/audit.js';
+import { registerExportCommand } from './commands/export-cmd.js';
+import { registerImportCommand } from './commands/import-cmd.js';
+import { registerContextCommand } from './commands/context.js';
+import { registerSemanticCommand } from './commands/semantic.js';
+import { registerServerCommand } from './commands/server.js';
+import { registerUiCommand } from './commands/ui.js';
+import { registerStatusCommand } from './commands/status.js';
+import { registerReviewCommand } from './commands/review.js';
+import { registerSmokeTestCommand } from './commands/smoke-test.js';
+import { registerHandoffCommand } from './commands/handoff.js';
+import { registerDecayCommand } from './commands/decay.js';
+import { registerSupersedeCommand } from './commands/supersede.js';
+import { registerDebugCommand } from './commands/debug.js';
+import { registerHookCommand } from './commands/hook.js';
+import { registerIntelligenceCommand } from './commands/intelligence.js';
+import { registerUpgradeCommand } from './commands/upgrade.js';
+import { getCliVersion } from './version.js';
+const program = new Command();
+program.name('pam').description('Portable AI Memory CLI').version(getCliVersion());
+registerInitCommand(program);
+registerAddCommand(program);
+registerListCommand(program);
+registerShowCommand(program);
+registerEditCommand(program);
+registerDeleteCommand(program);
+registerArchiveCommand(program);
+registerIndexCommand(program);
+registerSearchCommand(program);
+registerDoctorCommand(program);
+registerRedactCommand(program);
+registerRestoreCommand(program);
+registerApproveCommand(program);
+registerRejectCommand(program);
+registerCaptureCommand(program);
+registerCheckpointCommand(program);
+registerAuditCommand(program);
+registerExportCommand(program);
+registerImportCommand(program);
+registerContextCommand(program);
+registerSemanticCommand(program);
+registerServerCommand(program);
+registerUiCommand(program);
+registerStatusCommand(program);
+registerReviewCommand(program);
+registerSmokeTestCommand(program);
+registerHandoffCommand(program);
+registerDecayCommand(program);
+registerSupersedeCommand(program);
+registerDebugCommand(program);
+registerHookCommand(program);
+registerIntelligenceCommand(program);
+registerUpgradeCommand(program);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,2 @@
+export { createPamMcpServer, startPamMcpServer, type McpToolContext, } from '@helloworlkd/pam-protocol';
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,KAAK,cAAc,GACpB,MAAM,2BAA2B,CAAA"}

package/dist/mcp/server.js

@@ -0,0 +1,2 @@
+export { createPamMcpServer, startPamMcpServer, } from '@helloworlkd/pam-protocol';
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,iBAAiB,GAElB,MAAM,2BAA2B,CAAA"}

package/dist/self-upgrade.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=self-upgrade.d.ts.map

package/dist/self-upgrade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-upgrade.d.ts","sourceRoot":"","sources":["../src/self-upgrade.ts"],"names":[],"mappings":""}

package/dist/self-upgrade.js

@@ -0,0 +1,203 @@
+#!/usr/bin/env node
+import { execFile, spawn } from 'node:child_process';
+import { setTimeout as delay } from 'node:timers/promises';
+import { appendUpgradeLog, getUpgradeStatePaths, writeUpgradeStatus, } from './commands/upgrade-state.js';
+const ownPid = process.pid;
+main().catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+});
+async function main() {
+    const options = parseArgs(process.argv.slice(2));
+    try {
+        recordProgress(options, 'waiting', 'Waiting for the launcher process to exit.');
+        if (options.waitMs > 0) {
+            await delay(options.waitMs);
+        }
+        recordProgress(options, 'stopping-services', 'Stopping running PAM UI/MCP services.');
+        const stopped = await stopRunningPAMServices(options.dryRun);
+        recordProgress(options, 'stopping-services', `Stopped ${stopped.length} running PAM service${stopped.length === 1 ? '' : 's'}.`, { stoppedServices: stopped.length });
+        const args = ['install', '-g', options.packageSpec];
+        recordProgress(options, 'installing', `Running: ${options.npmCommand} ${args.join(' ')}`, {
+            stoppedServices: stopped.length,
+        });
+        if (options.dryRun) {
+            recordProgress(options, 'succeeded', 'Dry run complete.', { stoppedServices: stopped.length });
+            return;
+        }
+        await execFileLogged(options.npmCommand, args, options);
+        recordProgress(options, 'succeeded', 'PAM upgrade completed.', {
+            stoppedServices: stopped.length,
+            exitCode: 0,
+        });
+    }
+    catch (error) {
+        recordProgress(options, 'failed', error instanceof Error ? error.message : String(error), {
+            exitCode: 1,
+        });
+        throw error;
+    }
+}
+function parseArgs(args) {
+    const options = {
+        packageSpec: '@helloworlkd/pam-cli@latest',
+        npmCommand: process.platform === 'win32' ? 'npm.cmd' : 'npm',
+        waitMs: 1000,
+        dryRun: false,
+        runId: `upgrade-${Date.now()}`,
+        logPath: '',
+        startedAt: new Date().toISOString(),
+    };
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === '--package' && args[index + 1]) {
+            options.packageSpec = args[index + 1];
+            index += 1;
+        }
+        else if (arg === '--npm' && args[index + 1]) {
+            options.npmCommand = args[index + 1];
+            index += 1;
+        }
+        else if (arg === '--wait-ms' && args[index + 1]) {
+            const waitMs = Number.parseInt(args[index + 1], 10);
+            if (Number.isFinite(waitMs) && waitMs >= 0)
+                options.waitMs = waitMs;
+            index += 1;
+        }
+        else if (arg === '--dry-run') {
+            options.dryRun = true;
+        }
+        else if (arg === '--run-id' && args[index + 1]) {
+            options.runId = args[index + 1];
+            index += 1;
+        }
+        else if (arg === '--log-path' && args[index + 1]) {
+            options.logPath = args[index + 1];
+            index += 1;
+        }
+        else if (arg === '--started-at' && args[index + 1]) {
+            options.startedAt = args[index + 1];
+            index += 1;
+        }
+    }
+    if (!options.logPath) {
+        options.logPath = getUpgradeStatePaths(options.runId).logPath;
+    }
+    return options;
+}
+function recordProgress(options, phase, message, extra = {}) {
+    const status = createStatus(options, phase, message, extra);
+    writeUpgradeStatus(status);
+    const line = `[${status.updatedAt}] ${phase}: ${message}\n`;
+    appendUpgradeLog(options.logPath, line);
+    console.log(message);
+}
+function createStatus(options, phase, message, extra = {}) {
+    return {
+        runId: options.runId,
+        phase,
+        message,
+        packageSpec: options.packageSpec,
+        npmCommand: options.npmCommand,
+        startedAt: options.startedAt,
+        updatedAt: new Date().toISOString(),
+        logPath: options.logPath,
+        ...extra,
+    };
+}
+async function stopRunningPAMServices(dryRun) {
+    if (process.platform === 'win32') {
+        return stopWindowsPAMServices(dryRun);
+    }
+    return stopUnixPAMServices(dryRun);
+}
+function stopWindowsPAMServices(dryRun) {
+    const command = `
+$ownPid = ${ownPid}
+$processes = Get-CimInstance Win32_Process -Filter "name = 'node.exe'" |
+  Where-Object {
+    $_.ProcessId -ne $ownPid -and
+    $_.CommandLine -match 'pam-cli[\\\\/]dist[\\\\/]index\\.js' -and
+    ($_.CommandLine -match '\\sui(\\s|$)' -or $_.CommandLine -match '\\sserver\\s+start(\\s|$)')
+  }
+$ids = @($processes | ForEach-Object { $_.ProcessId })
+if (${dryRun ? '$false' : '$true'} -and $ids.Count -gt 0) {
+  Stop-Process -Id $ids -Force -ErrorAction SilentlyContinue
+}
+$ids -join ','
+`;
+    return new Promise((resolve) => {
+        execFile('powershell', ['-NoProfile', '-Command', command], (error, stdout) => {
+            if (error) {
+                resolve([]);
+                return;
+            }
+            resolve(parsePidList(stdout));
+        });
+    });
+}
+function stopUnixPAMServices(dryRun) {
+    const script = `
+set -e
+ids="$(ps -eo pid=,args= | awk '/pam-cli\\/dist\\/index\\.js/ && (/ ui( |$)/ || / server start( |$)/) {print $1}' | grep -v "^${ownPid}$" || true)"
+if [ -n "$ids" ] && [ "${dryRun ? '0' : '1'}" = "1" ]; then
+  kill $ids 2>/dev/null || true
+fi
+printf "%s" "$ids" | tr '\\n' ','
+`;
+    return new Promise((resolve) => {
+        execFile('sh', ['-c', script], (error, stdout) => {
+            if (error) {
+                resolve([]);
+                return;
+            }
+            resolve(parsePidList(stdout));
+        });
+    });
+}
+function parsePidList(value) {
+    return value
+        .split(/[,\s]+/)
+        .map((item) => Number.parseInt(item, 10))
+        .filter((pid) => Number.isFinite(pid));
+}
+function execFileLogged(command, args, options) {
+    return new Promise((resolve, reject) => {
+        const invocation = getSpawnInvocation(command, args);
+        const child = spawn(invocation.command, invocation.args, {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            windowsHide: false,
+        });
+        child.stdout.on('data', (chunk) => {
+            process.stdout.write(chunk);
+            appendUpgradeLog(options.logPath, chunk.toString('utf-8'));
+        });
+        child.stderr.on('data', (chunk) => {
+            process.stderr.write(chunk);
+            appendUpgradeLog(options.logPath, chunk.toString('utf-8'));
+        });
+        child.on('error', reject);
+        child.on('exit', (code, signal) => {
+            if (code === 0) {
+                resolve();
+                return;
+            }
+            reject(new Error(`${command} exited with ${signal ?? `code ${code ?? 1}`}`));
+        });
+    });
+}
+function getSpawnInvocation(command, args) {
+    if (process.platform === 'win32' && /\.(?:cmd|bat)$/i.test(command)) {
+        return {
+            command: process.env.ComSpec ?? 'cmd.exe',
+            args: ['/d', '/s', '/c', [command, ...args].map(quoteWindowsCommandArg).join(' ')],
+        };
+    }
+    return { command, args };
+}
+function quoteWindowsCommandArg(value) {
+    if (!/[\s"&()<>^|]/.test(value))
+        return value;
+    return `"${value.replace(/"/g, '\\"')}"`;
+}
+//# sourceMappingURL=self-upgrade.js.map

package/dist/self-upgrade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-upgrade.js","sourceRoot":"","sources":["../src/self-upgrade.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare function getCliVersion(): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAKA,wBAAgB,aAAa,IAAI,MAAM,CAQtC"}

package/dist/version.js

@@ -0,0 +1,15 @@
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { VERSION as CORE_VERSION } from '@helloworlkd/pam-core';
+export function getCliVersion() {
+    try {
+        const packageJsonPath = join(dirname(fileURLToPath(import.meta.url)), '../package.json');
+        const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+        return packageJson.version ?? CORE_VERSION;
+    }
+    catch {
+        return CORE_VERSION;
+    }
+}
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAE/D,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC;QACH,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAA;QACxF,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAyB,CAAA;QAC7F,OAAO,WAAW,CAAC,OAAO,IAAI,YAAY,CAAA;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,YAAY,CAAA;IACrB,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@helloworlkd/pam-cli",
+  "version": "0.1.16",
+  "description": "PAM CLI - Command line interface for PAM",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/supersekai64/pam.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/supersekai64/pam#readme",
+  "bugs": {
+    "url": "https://github.com/supersekai64/pam/issues"
+  },
+  "keywords": [
+    "ai",
+    "memory",
+    "llm",
+    "mcp",
+    "cli"
+  ],
+  "bin": {
+    "pam": "dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "scripts"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "commander": "^15.0.0",
+    "zod": "^4.4.3",
+    "@helloworlkd/pam-core": "^0.1.9",
+    "@helloworlkd/pam-protocol": "^0.1.10",
+    "@helloworlkd/pam-api": "^0.1.15"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.3"
+  },
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "build": "pnpm run clean && tsc",
+    "postinstall": "node scripts/postinstall.mjs",
+    "dev": "tsc --watch"
+  }
+}

package/scripts/postinstall.mjs

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+/* global console, process, setTimeout */
+
+import { spawn } from 'node:child_process'
+import { existsSync, readFileSync } from 'node:fs'
+import { resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const PACKAGE_NAME = '@helloworlkd/pam-cli'
+const DEFAULT_DEFER_TIMEOUT_MS = 15_000
+const DEFAULT_DEFER_POLL_MS = 500
+
+async function main() {
+  const [command, projectPathArg] = process.argv.slice(2)
+  if (command === '--deferred') {
+    await runDeferredInit(resolve(projectPathArg || process.env.INIT_CWD || process.cwd()))
+    return
+  }
+
+  if (process.env.PAM_SKIP_PROJECT_INIT === '1') return
+  if (isGlobalInstall()) {
+    console.log('[PAM] Global CLI installed. Run `pam init` inside a project to bootstrap it.')
+    return
+  }
+
+  const projectPath = resolve(process.env.INIT_CWD || process.cwd())
+  const packageJsonPath = resolve(projectPath, 'package.json')
+  if (!existsSync(packageJsonPath)) return
+
+  const packageJson = readPackageJson(packageJsonPath)
+  if (!packageJson || packageJson.name === PACKAGE_NAME) return
+  if (!declaresDirectDependency(packageJson, PACKAGE_NAME)) {
+    scheduleDeferredInit(projectPath)
+    return
+  }
+
+  await initializeProject(projectPath)
+}
+
+async function runDeferredInit(projectPath) {
+  const deadline =
+    Date.now() + readPositiveIntEnv('PAM_POSTINSTALL_TIMEOUT_MS', DEFAULT_DEFER_TIMEOUT_MS)
+  const pollMs = readPositiveIntEnv('PAM_POSTINSTALL_POLL_MS', DEFAULT_DEFER_POLL_MS)
+
+  while (Date.now() <= deadline) {
+    const packageJson = readPackageJson(resolve(projectPath, 'package.json'))
+    if (packageJson?.name === PACKAGE_NAME) return
+    if (packageJson && declaresDirectDependency(packageJson, PACKAGE_NAME)) {
+      await initializeProject(projectPath)
+      return
+    }
+    await sleep(pollMs)
+  }
+}
+
+function scheduleDeferredInit(projectPath) {
+  const child = spawn(
+    process.execPath,
+    [fileURLToPath(import.meta.url), '--deferred', projectPath],
+    {
+      detached: true,
+      env: process.env,
+      stdio: 'ignore',
+      windowsHide: true,
+    }
+  )
+  child.unref()
+}
+
+async function initializeProject(projectPath) {
+  try {
+    const { configureProjectIntegrations, 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.'
+    )
+  } catch (error) {
+    console.warn(
+      `[PAM] Project memory auto-init skipped: ${error instanceof Error ? error.message : String(error)}`
+    )
+    console.warn('[PAM] You can run `pam init` manually inside the project.')
+  }
+}
+
+function isGlobalInstall() {
+  return (
+    process.env.npm_config_global === 'true' ||
+    process.env.npm_config_location === 'global' ||
+    process.env.npm_lifecycle_event === 'globalinstall'
+  )
+}
+
+function readPackageJson(path) {
+  try {
+    return JSON.parse(readFileSync(path, 'utf-8').replace(/^\uFEFF/, ''))
+  } catch {
+    return null
+  }
+}
+
+function declaresDirectDependency(packageJson, packageName) {
+  return ['dependencies', 'devDependencies', 'optionalDependencies'].some((field) => {
+    const dependencies = packageJson[field]
+    return Boolean(dependencies && typeof dependencies === 'object' && dependencies[packageName])
+  })
+}
+
+function readPositiveIntEnv(name, fallback) {
+  const value = Number.parseInt(process.env[name] || '', 10)
+  return Number.isFinite(value) && value > 0 ? value : fallback
+}
+
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms))
+}
+
+await main()