akm-cli 0.7.4 → 0.8.0-rc.10

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "akm-cli",
-  "version": "0.7.4",
+  "version": "0.8.0-rc.10",
   "type": "module",
-  "description": "akm (Agent Kit Manager) — A package manager for AI agent skills, commands, tools, and knowledge. Works with Claude Code, OpenCode, Cursor, and any AI coding assistant.",
+  "description": "akm (Agent Knowledge Management) — A package manager for AI agent skills, commands, tools, and knowledge. Works with Claude Code, OpenCode, Cursor, and any AI coding assistant.",
   "keywords": [
     "akm",
+    "agent-knowledge-management",
     "agent-kit-manager",
     "akm-cli",
     "ai-agent",
@@ -31,26 +32,40 @@
     "url": "https://github.com/itlackey/akm/issues"
   },
   "license": "MPL-2.0",
+  "pinNotes": {
+    "@opencode-ai/sdk@1.2.20": "Exact pin. The SDK surface we use (createOpencode + session.create/prompt/delete in src/integrations/agent/sdk-runner.ts) is stable across 1.x, but the SDK has shipped 5+ minor versions of unrelated provider/registry churn. akm-cli is a global CLI install so the pin is isolated from user-project deps. Re-test sdk-runner before bumping."
+  },
   "files": [
     "dist",
     "README.md",
     "CHANGELOG.md",
+    "SECURITY.md",
     "LICENSE",
-    "docs/migration/release-notes"
+    "docs/migration/release-notes",
+    "docs/migration/v0.7-to-v0.8.md",
+    "docs/data-and-telemetry.md"
   ],
   "bin": {
-    "akm": "dist/cli.js"
+    "akm": "dist/cli.js",
+    "akm-migrate-storage": "dist/scripts/migrate-storage.js"
   },
   "scripts": {
-    "build": "rm -rf dist && bun run tsc --project ./tsconfig.build.json",
-    "check": "bun run lint && bunx tsc --noEmit && bun test ./tests",
-    "check:changed": "bun test tests/output-baseline.test.ts tests/e2e.test.ts tests/stash-search.test.ts && bun run lint && bunx tsc --noEmit",
-    "test": "bun test ./tests",
+    "preinstall": "node -e \"var ua=process.env.npm_config_user_agent||'';if(process.versions.bun||ua.startsWith('bun/')||process.env.BUN_INSTALL){process.exit(0)}console.error('\\n  ERROR: akm-cli 0.8 requires the Bun runtime (https://bun.sh) or the prebuilt binary.\\n  Running under Node.js is not supported in this release.\\n  Install options:\\n    1. Bun:    curl -fsSL https://bun.sh/install | bash  &&  bun install -g akm-cli\\n    2. Binary: curl -fsSL https://github.com/itlackey/akm/releases/latest/download/install.sh | bash\\n  Cross-runtime support is planned for 0.9.0.\\n');process.exit(1)\"",
+    "build": "rm -rf dist && bun run tsc --project ./tsconfig.build.json && bun scripts/copy-assets.ts",
+    "check": "bun run lint && bunx tsc --noEmit && bun run test:unit && bun run test:integration",
+    "check:changed": "bun test tests/output-baseline.test.ts tests/integration/e2e.test.ts tests/stash-search.test.ts && bun run lint && bunx tsc --noEmit",
+    "test": "bun test --parallel=12 --timeout=30000 ./tests --path-ignore-patterns=tests/integration",
+    "test:unit": "bun test --parallel=12 --timeout=30000 ./tests --path-ignore-patterns=tests/integration",
+    "test:integration": "bun test --parallel=12 --timeout=30000 ./tests/integration ./tests/commands ./tests/workflows",
+    "test:sharded": "bun test ./tests --shard=1/4 & bun test ./tests --shard=2/4 & bun test ./tests --shard=3/4 & bun test ./tests --shard=4/4 & wait",
+    "test:time": "bun scripts/test-timing-report.ts",
+    "lint:isolation": "bun scripts/lint-tests-isolation.ts",
     "lint:devto-posts": "bun scripts/lint-devto-posts.ts",
     "lint:devto-posts:fix": "bun scripts/lint-devto-posts.ts --fix",
     "publish:devto": "npx -y @sinedied/devto-cli push \"docs/posts/**/*.md\" --token \"$DEVTO_TOKEN\" --repo \"$GITHUB_REPOSITORY\" --branch \"${GITHUB_REF_NAME:-main}\" --reconcile",
     "release:check": "./tests/release-check.sh",
-    "lint": "bunx biome check src/ tests/",
+    "lint": "bunx biome check src/ tests/ && bun scripts/lint-tests-isolation.ts && bun scripts/lint-license-headers.ts",
+    "lint:tests-isolation": "bun scripts/lint-tests-isolation.ts",
     "lint:fix": "bunx biome check --write src/ tests/",
     "format": "bunx biome format --write src/ tests/",
     "prepublishOnly": "cp .github/README.npm.md README.md && bun run build",
@@ -67,15 +82,18 @@
   },
   "optionalDependencies": {
     "@huggingface/transformers": "^4.2.0",
-    "sqlite-vec": "0.1.7-alpha.2"
+    "sqlite-vec": "^0.1.9"
   },
   "engines": {
     "bun": ">=1.0.0"
   },
   "dependencies": {
     "@clack/prompts": "^1.3.0",
+    "@opencode-ai/sdk": "1.2.20",
     "citty": "^0.2.2",
     "dotenv": "^17.4.2",
-    "yaml": "^2.8.4"
+    "yaml": "^2.8.4",
+    "zod": "^3.23.0",
+    "zod-to-json-schema": "^3.23.0"
   }
 }

package/dist/commands/install-audit.js

@@ -1,381 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { filterNonEmptyStrings, toPosix } from "../core/common";
-const DEFAULT_INSTALL_AUDIT_CONFIG = {
-    enabled: true,
-    blockOnCritical: true,
-    blockUnlistedRegistries: false,
-    registryAllowlist: [],
-    allowedFindings: [],
-};
-const MAX_SCANNED_FILE_BYTES = 256 * 1024;
-const LIFECYCLE_SCRIPT_NAMES = new Set([
-    "preinstall",
-    "install",
-    "postinstall",
-    "prepublish",
-    "prepublishOnly",
-    "prepare",
-]);
-const TEXT_FILE_EXTENSIONS = new Set([
-    ".cjs",
-    ".cts",
-    ".js",
-    ".json",
-    ".jsonc",
-    ".jsx",
-    ".mjs",
-    ".md",
-    ".ps1",
-    ".py",
-    ".rb",
-    ".sh",
-    ".toml",
-    ".ts",
-    ".tsx",
-    ".txt",
-    ".yaml",
-    ".yml",
-]);
-const BLOCKED_PACKAGE_DIRECTORIES = new Set(["node_modules", "venv", ".venv", "site-packages"]);
-const CONTENT_RULES = [
-    {
-        id: "prompt-ignore-previous-instructions",
-        severity: "high",
-        category: "prompt-injection",
-        message: "Contains instructions to ignore prior prompts or instructions.",
-        pattern: /\b(ignore|disregard|forget)\b[^.\n]{0,100}\b(previous|prior|earlier)\b[^.\n]{0,100}\b(instructions?|prompts?|messages?)\b/i,
-    },
-    {
-        id: "prompt-reveal-hidden-secrets",
-        severity: "critical",
-        category: "prompt-injection",
-        message: "Contains instructions to reveal hidden prompts or secrets.",
-        pattern: /\b(?:reveal|print|dump|show|output|return|exfiltrat(?:e|ion))\b[^.\n]{0,60}\b(?:your|the)\b[^.\n]{0,40}\b(system prompt|hidden instructions?|developer message|api key|token|secret|password)\b/i,
-    },
-    {
-        id: "prompt-bypass-guardrails",
-        severity: "high",
-        category: "prompt-injection",
-        message: "Contains instructions to bypass safety or security controls.",
-        pattern: /\b(bypass|disable|ignore)\b[^.\n]{0,100}\b(safety|security|guardrails|restrictions|policies)\b/i,
-    },
-    {
-        id: "remote-shell-pipe",
-        severity: "critical",
-        category: "malicious-code",
-        message: "Downloads remote content and pipes it directly into a shell.",
-        pattern: /\b(curl|wget)\b[^\n|]{0,200}\|\s*(sh|bash|zsh)\b/i,
-    },
-    {
-        id: "powershell-download-exec",
-        severity: "critical",
-        category: "malicious-code",
-        message: "Downloads remote content and executes it in PowerShell.",
-        pattern: /\b(Invoke-WebRequest|iwr|curl)\b[^\n|]{0,200}\|\s*(iex|Invoke-Expression)\b/i,
-    },
-    {
-        id: "powershell-encoded-command",
-        severity: "critical",
-        category: "malicious-code",
-        message: "Uses an encoded PowerShell command.",
-        pattern: /\bpowershell(?:\.exe)?\b[^\n]{0,120}\s-(?:enc|encodedcommand)\b/i,
-    },
-    {
-        id: "credential-exfiltration-language",
-        severity: "high",
-        category: "malicious-code",
-        message: "Contains language associated with credential or secret exfiltration.",
-        pattern: /\b(exfiltrat(?:e|ion)|harvest|steal)\b[^.\n]{0,120}\b(credentials?|tokens?|secrets?|ssh keys?|passwords?|cookies?)\b/i,
-    },
-];
-export function resolveInstallAuditConfig(config) {
-    const installAudit = config?.security?.installAudit;
-    const allowlist = filterNonEmptyStrings(installAudit?.registryAllowlist) ??
-        filterNonEmptyStrings(installAudit?.registryWhitelist) ??
-        [];
-    return {
-        enabled: installAudit?.enabled ?? DEFAULT_INSTALL_AUDIT_CONFIG.enabled,
-        blockOnCritical: installAudit?.blockOnCritical ?? DEFAULT_INSTALL_AUDIT_CONFIG.blockOnCritical,
-        blockUnlistedRegistries: installAudit?.blockUnlistedRegistries ?? DEFAULT_INSTALL_AUDIT_CONFIG.blockUnlistedRegistries,
-        registryAllowlist: allowlist.map((entry) => entry.trim().toLowerCase()),
-        allowedFindings: installAudit?.allowedFindings ?? DEFAULT_INSTALL_AUDIT_CONFIG.allowedFindings,
-    };
-}
-export function enforceRegistryInstallPolicy(registryLabels, config, ref) {
-    const resolved = resolveInstallAuditConfig(config);
-    if (!resolved.blockUnlistedRegistries)
-        return;
-    if (resolved.registryAllowlist.length === 0) {
-        throw new Error(`Install blocked for ${ref}: no registries are allowlisted. Configure security.installAudit.registryAllowlist or disable security.installAudit.blockUnlistedRegistries.`);
-    }
-    const matched = registryLabels.some((label) => resolved.registryAllowlist.includes(label.toLowerCase()));
-    if (matched)
-        return;
-    throw new Error(`Install blocked for ${ref}: registry is not allowlisted. Allowed: ${resolved.registryAllowlist.join(", ")}. Seen: ${registryLabels.join(", ")}.`);
-}
-export function auditInstallCandidate(input) {
-    const resolved = resolveInstallAuditConfig(input.config);
-    if (!resolved.enabled) {
-        return {
-            enabled: false,
-            passed: true,
-            blocked: false,
-            trusted: false,
-            registryLabels: [...input.registryLabels],
-            findings: [],
-            scannedFiles: 0,
-            scannedBytes: 0,
-            summary: buildSummary([]),
-        };
-    }
-    const findings = [];
-    const counters = { scannedFiles: 0, scannedBytes: 0 };
-    scanDirectory(input.rootDir, input.rootDir, findings, counters);
-    const { findings: activeFindings, waivedFindings } = splitAllowedFindings(findings, input.ref, resolved.allowedFindings);
-    const summary = buildSummary(activeFindings);
-    const blocked = !input.trustThisInstall && resolved.blockOnCritical && summary.critical > 0;
-    return {
-        enabled: true,
-        passed: activeFindings.length === 0,
-        blocked,
-        trusted: Boolean(input.trustThisInstall),
-        registryLabels: [...input.registryLabels],
-        findings: activeFindings,
-        scannedFiles: counters.scannedFiles,
-        scannedBytes: counters.scannedBytes,
-        summary,
-        ...(waivedFindings.length > 0 ? { waivedFindings } : {}),
-    };
-}
-export function formatInstallAuditFailure(ref, report) {
-    const lines = [`Security audit failed for ${ref}.`, formatInstallAuditSummary(report)];
-    for (const finding of report.findings.slice(0, 5)) {
-        lines.push(`- [${finding.severity}] ${finding.message}${finding.file ? ` (${finding.file})` : ""}`);
-    }
-    if (report.findings.length > 5) {
-        lines.push(`- ${report.findings.length - 5} more finding(s) omitted`);
-    }
-    lines.push("Disable blocking with `security.installAudit.blockOnCritical = false`, or disable audits with `security.installAudit.enabled = false`." +
-        " Or pass --trust on a one-off 'akm add' to bypass this audit for this install only.");
-    return lines.join("\n");
-}
-export function formatInstallAuditSummary(report) {
-    if (!report.enabled)
-        return "Audit: disabled";
-    const severitySummary = [];
-    if (report.summary.critical > 0)
-        severitySummary.push(`${report.summary.critical} critical`);
-    if (report.summary.high > 0)
-        severitySummary.push(`${report.summary.high} high`);
-    if (report.summary.moderate > 0)
-        severitySummary.push(`${report.summary.moderate} moderate`);
-    if (report.summary.low > 0)
-        severitySummary.push(`${report.summary.low} low`);
-    const detail = severitySummary.length > 0 ? severitySummary.join(", ") : "no findings";
-    const status = report.blocked ? "blocked" : report.passed ? "passed" : report.trusted ? "trusted" : "warnings";
-    const waived = report.waivedFindings?.length ? `; waived ${report.waivedFindings.length}` : "";
-    return `Audit: ${status} (${detail}; scanned ${report.scannedFiles} file${report.scannedFiles === 1 ? "" : "s"}${waived})`;
-}
-export function deriveRegistryLabels(input) {
-    const labels = new Set();
-    labels.add(input.source);
-    if (input.source === "github")
-        labels.add("github.com");
-    if (input.source === "npm")
-        labels.add("npm");
-    addUrlLabels(labels, input.artifactUrl);
-    addUrlLabels(labels, input.gitUrl);
-    if (input.source === "github" && input.ref.startsWith("github:")) {
-        labels.add("github");
-    }
-    return [...labels];
-}
-function scanDirectory(dir, rootDir, findings, counters) {
-    let entries;
-    try {
-        entries = fs.readdirSync(dir, { withFileTypes: true });
-    }
-    catch {
-        return;
-    }
-    for (const entry of entries) {
-        if (entry.name === ".git")
-            continue;
-        const fullPath = path.join(dir, entry.name);
-        if (entry.isDirectory()) {
-            if (BLOCKED_PACKAGE_DIRECTORIES.has(entry.name)) {
-                const relativePath = path.relative(rootDir, fullPath) || entry.name;
-                findings.push({
-                    id: "bundled-package-directory",
-                    severity: "critical",
-                    category: "vendored-dependency",
-                    message: `Contains bundled dependency directory "${entry.name}".`,
-                    file: relativePath,
-                    snippet: relativePath,
-                });
-                continue;
-            }
-            scanDirectory(fullPath, rootDir, findings, counters);
-            continue;
-        }
-        if (!entry.isFile())
-            continue;
-        scanFile(fullPath, rootDir, findings, counters);
-    }
-}
-function scanFile(filePath, rootDir, findings, counters) {
-    const ext = path.extname(filePath).toLowerCase();
-    const basename = path.basename(filePath).toLowerCase();
-    if (basename !== "package.json" && !TEXT_FILE_EXTENSIONS.has(ext))
-        return;
-    let fileSize;
-    try {
-        fileSize = fs.statSync(filePath).size;
-    }
-    catch {
-        return;
-    }
-    const readSize = Math.min(fileSize, MAX_SCANNED_FILE_BYTES);
-    const buf = Buffer.alloc(readSize);
-    let bytesRead;
-    try {
-        const fd = fs.openSync(filePath, "r");
-        try {
-            bytesRead = fs.readSync(fd, buf, 0, readSize, 0);
-        }
-        finally {
-            fs.closeSync(fd);
-        }
-    }
-    catch {
-        return;
-    }
-    if (bytesRead === 0)
-        return;
-    const bytes = buf.subarray(0, bytesRead);
-    if (bytes.includes(0))
-        return;
-    counters.scannedFiles += 1;
-    counters.scannedBytes += bytesRead;
-    const content = bytes.toString("utf8");
-    const relativePath = path.relative(rootDir, filePath) || path.basename(filePath);
-    const genericContent = basename === "package.json" ? stripPackageJsonScripts(content) : content;
-    for (const rule of CONTENT_RULES) {
-        const match = genericContent.match(rule.pattern);
-        if (!match)
-            continue;
-        findings.push({
-            id: rule.id,
-            severity: rule.severity,
-            category: rule.category,
-            message: rule.message,
-            file: relativePath,
-            snippet: clipSnippet(match[0]),
-        });
-    }
-    if (basename === "package.json") {
-        scanPackageJson(content, relativePath, findings);
-    }
-}
-function stripPackageJsonScripts(content) {
-    let parsed;
-    try {
-        parsed = JSON.parse(content);
-    }
-    catch {
-        return content;
-    }
-    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
-        return content;
-    const packageJson = { ...parsed };
-    delete packageJson.scripts;
-    return JSON.stringify(packageJson, null, 2);
-}
-function scanPackageJson(content, relativePath, findings) {
-    let parsed;
-    try {
-        parsed = JSON.parse(content);
-    }
-    catch {
-        return;
-    }
-    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
-        return;
-    const scripts = parsed.scripts;
-    if (typeof scripts !== "object" || scripts === null || Array.isArray(scripts))
-        return;
-    for (const [name, command] of Object.entries(scripts)) {
-        if (!LIFECYCLE_SCRIPT_NAMES.has(name) || typeof command !== "string")
-            continue;
-        for (const rule of CONTENT_RULES) {
-            if (!rule.pattern.test(command))
-                continue;
-            findings.push({
-                id: `lifecycle-${name}-${rule.id}`,
-                severity: rule.severity,
-                category: "install-script",
-                message: `Lifecycle script "${name}" is suspicious: ${rule.message.toLowerCase()}`,
-                file: relativePath,
-                snippet: clipSnippet(command),
-            });
-        }
-    }
-}
-function clipSnippet(value) {
-    const normalized = value.replace(/\s+/g, " ").trim();
-    return normalized.length <= 140 ? normalized : `${normalized.slice(0, 137)}...`;
-}
-function buildSummary(findings) {
-    const summary = { low: 0, moderate: 0, high: 0, critical: 0, total: findings.length };
-    for (const finding of findings) {
-        summary[finding.severity] += 1;
-    }
-    return summary;
-}
-function splitAllowedFindings(findings, ref, allowedFindings) {
-    const active = [];
-    const waived = [];
-    for (const finding of findings) {
-        if (matchesAllowedFinding(finding, ref, allowedFindings)) {
-            waived.push(finding);
-            continue;
-        }
-        active.push(finding);
-    }
-    return { findings: active, waivedFindings: waived };
-}
-function matchesAllowedFinding(finding, ref, allowedFindings) {
-    // Normalize paths so a waiver written against `scripts/setup.sh` matches
-    // a finding emitted as `./scripts/setup.sh` or `scripts//setup.sh`. On
-    // Windows we also fold case, mirroring `isWithin`'s comparison rules.
-    const findingPathNormalized = normalizeWaiverPath(finding.file);
-    return allowedFindings.some((allowed) => {
-        if (allowed.id !== finding.id)
-            return false;
-        if (allowed.ref && allowed.ref !== ref)
-            return false;
-        if (allowed.path && normalizeWaiverPath(allowed.path) !== findingPathNormalized)
-            return false;
-        return true;
-    });
-}
-function normalizeWaiverPath(value) {
-    if (!value)
-        return value;
-    // Strip a leading `./` and POSIX-ify after path.normalize so Windows path
-    // separators don't trigger spurious mismatches.
-    const normalized = toPosix(path.normalize(value)).replace(/^\.\/+/, "");
-    return process.platform === "win32" ? normalized.toLowerCase() : normalized;
-}
-function addUrlLabels(labels, rawUrl) {
-    if (!rawUrl)
-        return;
-    try {
-        const parsed = new URL(rawUrl);
-        labels.add(parsed.hostname.toLowerCase());
-    }
-    catch {
-        // Ignore non-URL refs (for example git@host:path)
-    }
-}