open-multi-agent-kit 0.95.1 → 0.96.0

package/dist/core/package-doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-doctor.d.ts","sourceRoot":"","sources":["../../src/core/package-doctor.ts"],"names":[],"mappings":"AASA,OAAO,EAAkC,KAAK,kBAAkB,EAA0B,MAAM,uBAAuB,CAAC;AAIxH,MAAM,WAAW,sBAAsB;IACtC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,sBAAsB,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IAClC,EAAE,EACC,UAAU,GACV,WAAW,GACX,iBAAiB,GACjB,eAAe,GACf,kBAAkB,GAClB,aAAa,GACb,kBAAkB,GAClB,eAAe,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IACnC,aAAa,EAAE,CAAC,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,QAAQ,EAAE;QACT,QAAQ,EAAE,kBAAkB,GAAG,YAAY,CAAC;QAC5C,UAAU,EAAE,OAAO,CAAC;QACpB,WAAW,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACtD,CAAC;IACF,SAAS,EAAE,MAAM,CAAC,MAAM,sBAAsB,EAAE,MAAM,CAAC,CAAC;IACxD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,UAAU,EAAE,OAAO,CAAC;CACpB;AA+ED,8FAA8F;AAC9F,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,kBAAkB,GAAG,mBAAmB,CA8G1F","sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { basename, resolve } from \"node:path\";\nimport {\n\timportedSpecifiers,\n\tPACKAGE_DOCTOR_SUPPORTED_EVENTS,\n\tscanPackageExtensionSources,\n\tsourceFilesMatching,\n\tsubscribedEvents,\n} from \"./package-doctor-source-scan.ts\";\nimport { type PackageManifestDiagnostic, type PackageManifestKey, resolvePackageManifest } from \"./package-manifest.ts\";\nimport { isLegacyPiRuntimeImport, isSupportedLegacyPiRuntimeImport } from \"./pi-compat.ts\";\nimport { redactSensitiveTextForced } from \"./redaction.ts\";\n\nexport interface PackageDoctorResources {\n\textensions: string[];\n\tskills: string[];\n\tprompts: string[];\n\tthemes: string[];\n}\n\nexport interface PackageDoctorInput {\n\tsource: string;\n\tpackageRoot: string;\n\tresources: PackageDoctorResources;\n}\n\nexport interface PackageDoctorCheck {\n\tid:\n\t\t| \"manifest\"\n\t\t| \"resources\"\n\t\t| \"runtime-imports\"\n\t\t| \"storage-paths\"\n\t\t| \"lifecycle-events\"\n\t\t| \"headless-ui\"\n\t\t| \"resume-awareness\"\n\t\t| \"scan-coverage\";\n\tstatus: \"pass\" | \"warning\" | \"error\";\n\tmessage: string;\n\tfiles?: string[];\n}\n\nexport interface PackageDoctorResult {\n\tschemaVersion: 1;\n\tsource: string;\n\tpackage: { name?: string; version?: string };\n\tmanifest: {\n\t\tselected: PackageManifestKey | \"convention\";\n\t\tshadowedPi: boolean;\n\t\tdiagnostics: Array<{ path: string; message: string }>;\n\t};\n\tresources: Record<keyof PackageDoctorResources, number>;\n\tinspectedFiles: string[];\n\tchecks: PackageDoctorCheck[];\n\tcompatible: boolean;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction packageMetadata(value: unknown): { name?: string; version?: string } {\n\tif (!isRecord(value)) return {};\n\treturn {\n\t\t...(typeof value.name === \"string\" ? { name: redactSensitiveTextForced(value.name).slice(0, 256) } : {}),\n\t\t...(typeof value.version === \"string\" ? { version: redactSensitiveTextForced(value.version).slice(0, 128) } : {}),\n\t};\n}\n\nfunction sanitizePackageSource(source: string): string {\n\tconst redacted = redactSensitiveTextForced(source);\n\tif (redacted.startsWith(\"npm:\")) return redacted;\n\tconst hasGitPrefix = redacted.startsWith(\"git:\");\n\tconst candidate = hasGitPrefix ? redacted.slice(\"git:\".length) : redacted;\n\tif (/^(?:https?|ssh|git):\\/\\//iu.test(candidate)) {\n\t\ttry {\n\t\t\tconst url = new URL(candidate);\n\t\t\turl.username = \"\";\n\t\t\turl.password = \"\";\n\t\t\turl.search = \"\";\n\t\t\turl.hash = \"\";\n\t\t\treturn `${hasGitPrefix ? \"git:\" : \"\"}${url.toString()}`;\n\t\t} catch {\n\t\t\treturn \"<remote-package>\";\n\t\t}\n\t}\n\tif (hasGitPrefix) return \"<git-package>\";\n\treturn `local:${basename(resolve(redacted))}`;\n}\n\nfunction check(\n\tstatus: PackageDoctorCheck[\"status\"],\n\tid: PackageDoctorCheck[\"id\"],\n\tmessage: string,\n\tfiles: string[] = [],\n): PackageDoctorCheck {\n\treturn {\n\t\tid,\n\t\tstatus,\n\t\tmessage: redactSensitiveTextForced(message).slice(0, 4096),\n\t\t...(files.length > 0\n\t\t\t? {\n\t\t\t\t\tfiles: [...new Set(files.map((file) => redactSensitiveTextForced(file)))].sort((left, right) =>\n\t\t\t\t\t\tleft.localeCompare(right),\n\t\t\t\t\t),\n\t\t\t\t}\n\t\t\t: {}),\n\t};\n}\n\nfunction runtimeImportCheck(unsupportedFiles: string[], aliasedFiles: string[]): PackageDoctorCheck {\n\tif (unsupportedFiles.length > 0) {\n\t\treturn check(\"error\", \"runtime-imports\", \"Unsupported Pi runtime imports require a compatibility shim\", [\n\t\t\t...unsupportedFiles,\n\t\t\t...aliasedFiles,\n\t\t]);\n\t}\n\tif (aliasedFiles.length > 0) {\n\t\treturn check(\n\t\t\t\"warning\",\n\t\t\t\"runtime-imports\",\n\t\t\t\"Legacy Pi runtime imports will use OMK compatibility aliases\",\n\t\t\taliasedFiles,\n\t\t);\n\t}\n\treturn check(\"pass\", \"runtime-imports\", \"No legacy Pi runtime imports detected\");\n}\n\nfunction headlessUiCheck(uiFiles: string[], unguardedFiles: string[]): PackageDoctorCheck {\n\tif (uiFiles.length === 0) return check(\"pass\", \"headless-ui\", \"No UI-only behavior detected\");\n\tif (unguardedFiles.length === 0) return check(\"pass\", \"headless-ui\", \"UI use is guarded for headless modes\");\n\treturn check(\"warning\", \"headless-ui\", \"UI use is not guarded by ctx.hasUI or ctx.mode\", unguardedFiles);\n}\n\n/** Static-only compatibility inspection. Extension modules are never imported or executed. */\nexport function inspectPackageCompatibility(input: PackageDoctorInput): PackageDoctorResult {\n\tconst root = resolve(input.packageRoot);\n\tlet packageJson: unknown = {};\n\tlet packageJsonDiagnostics: PackageManifestDiagnostic[] = [];\n\ttry {\n\t\tpackageJson = JSON.parse(readFileSync(resolve(root, \"package.json\"), \"utf8\")) as unknown;\n\t} catch {\n\t\tpackageJsonDiagnostics = [{ path: \"package.json\", message: \"package.json must contain valid JSON\" }];\n\t}\n\tconst manifest = resolvePackageManifest(packageJson);\n\tconst manifestDiagnostics = [...packageJsonDiagnostics, ...manifest.diagnostics];\n\tconst { sources, skipped } = scanPackageExtensionSources(root, input.resources.extensions);\n\tconst allText = sources.map((source) => source.text).join(\"\\n\");\n\tconst aliasedImportFiles = sourceFilesMatching(sources, (text) =>\n\t\timportedSpecifiers(text).some((specifier) => isSupportedLegacyPiRuntimeImport(specifier)),\n\t);\n\tconst unsupportedImportFiles = sourceFilesMatching(sources, (text) =>\n\t\timportedSpecifiers(text).some(\n\t\t\t(specifier) => isLegacyPiRuntimeImport(specifier) && !isSupportedLegacyPiRuntimeImport(specifier),\n\t\t),\n\t);\n\tconst storageFiles = sourceFilesMatching(sources, (text) =>\n\t\t/(?:~\\/\\.pi|[\"']\\.pi[\"']|PI_CODING_AGENT_DIR|PI_TODO_PATH)/u.test(text),\n\t);\n\tconst allEvents = sources.flatMap((source) => subscribedEvents(source.text));\n\tconst unsupportedEvents = [\n\t\t...new Set(allEvents.filter((event) => !PACKAGE_DOCTOR_SUPPORTED_EVENTS.has(event))),\n\t].sort((left, right) => left.localeCompare(right));\n\tconst lifecycleFiles = sourceFilesMatching(sources, (text) =>\n\t\tsubscribedEvents(text).some((event) => !PACKAGE_DOCTOR_SUPPORTED_EVENTS.has(event)),\n\t);\n\tconst uiFiles = sourceFilesMatching(sources, (text) => /\\bctx\\.ui\\b/u.test(text));\n\tconst unguardedUiFiles = sourceFilesMatching(\n\t\tsources,\n\t\t(text) => /\\bctx\\.ui\\b/u.test(text) && !/\\bctx\\.hasUI\\b|\\bctx\\.mode\\b/u.test(text),\n\t);\n\tconst resumeRelevant = storageFiles.length > 0 || /\\bappendEntry\\b|\\bgetEntries\\b|session_switch/u.test(allText);\n\tconst resumeAware =\n\t\t!resumeRelevant ||\n\t\t(allEvents.includes(\"session_start\") && /[\"']resume[\"']|\\.reason\\s*===?\\s*[\"']resume[\"']/u.test(allText));\n\tconst totalResources = Object.values(input.resources).reduce((sum, entries) => sum + entries.length, 0);\n\n\tconst checks: PackageDoctorCheck[] = [\n\t\tcheck(\n\t\t\tmanifestDiagnostics.length === 0 ? \"pass\" : \"error\",\n\t\t\t\"manifest\",\n\t\t\tmanifestDiagnostics.length > 0\n\t\t\t\t? \"The selected package manifest is malformed\"\n\t\t\t\t: manifest.key === null\n\t\t\t\t\t? \"Using convention directories\"\n\t\t\t\t\t: `Using package.json ${manifest.key} manifest`,\n\t\t\tmanifestDiagnostics.map((diagnostic) => diagnostic.path),\n\t\t),\n\t\tcheck(totalResources > 0 ? \"pass\" : \"error\", \"resources\", `${totalResources} package resource(s) resolved`),\n\t\truntimeImportCheck(unsupportedImportFiles, aliasedImportFiles),\n\t\tcheck(\n\t\t\tstorageFiles.length === 0 ? \"pass\" : \"warning\",\n\t\t\t\"storage-paths\",\n\t\t\tstorageFiles.length === 0\n\t\t\t\t? \"No hard-coded .pi storage paths detected\"\n\t\t\t\t: \"Hard-coded Pi storage paths may bypass OMK configuration\",\n\t\t\tstorageFiles,\n\t\t),\n\t\tcheck(\n\t\t\tunsupportedEvents.length === 0 ? \"pass\" : \"error\",\n\t\t\t\"lifecycle-events\",\n\t\t\tunsupportedEvents.length === 0\n\t\t\t\t? \"Lifecycle event names are supported\"\n\t\t\t\t: `Unsupported lifecycle event(s): ${unsupportedEvents.join(\", \")}`,\n\t\t\tlifecycleFiles,\n\t\t),\n\t\theadlessUiCheck(uiFiles, unguardedUiFiles),\n\t\tcheck(\n\t\t\tresumeAware ? \"pass\" : \"warning\",\n\t\t\t\"resume-awareness\",\n\t\t\tresumeAware\n\t\t\t\t? \"No resume-state incompatibility detected\"\n\t\t\t\t: \"Persistent state does not show a session_start resume path\",\n\t\t),\n\t\tcheck(\n\t\t\tskipped.length === 0 ? \"pass\" : \"warning\",\n\t\t\t\"scan-coverage\",\n\t\t\tskipped.length === 0\n\t\t\t\t? `${sources.length} extension file(s) inspected statically`\n\t\t\t\t: `Static scan skipped ${skipped.length} file(s)`,\n\t\t\tskipped,\n\t\t),\n\t];\n\n\treturn {\n\t\tschemaVersion: 1,\n\t\tsource: sanitizePackageSource(input.source),\n\t\tpackage: packageMetadata(packageJson),\n\t\tmanifest: {\n\t\t\tselected: manifest.key ?? \"convention\",\n\t\t\tshadowedPi: manifest.key === \"omk\" && manifest.present.pi,\n\t\t\tdiagnostics: manifestDiagnostics,\n\t\t},\n\t\tresources: {\n\t\t\textensions: input.resources.extensions.length,\n\t\t\tskills: input.resources.skills.length,\n\t\t\tprompts: input.resources.prompts.length,\n\t\t\tthemes: input.resources.themes.length,\n\t\t},\n\t\tinspectedFiles: sources\n\t\t\t.map((source) => redactSensitiveTextForced(source.file))\n\t\t\t.sort((left, right) => left.localeCompare(right)),\n\t\tchecks,\n\t\tcompatible: checks.every((item) => item.status !== \"error\"),\n\t};\n}\n"]}

package/dist/core/package-doctor.js

@@ -0,0 +1,145 @@
+import { readFileSync } from "node:fs";
+import { basename, resolve } from "node:path";
+import { importedSpecifiers, PACKAGE_DOCTOR_SUPPORTED_EVENTS, scanPackageExtensionSources, sourceFilesMatching, subscribedEvents, } from "./package-doctor-source-scan.js";
+import { resolvePackageManifest } from "./package-manifest.js";
+import { isLegacyPiRuntimeImport, isSupportedLegacyPiRuntimeImport } from "./pi-compat.js";
+import { redactSensitiveTextForced } from "./redaction.js";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function packageMetadata(value) {
+    if (!isRecord(value))
+        return {};
+    return {
+        ...(typeof value.name === "string" ? { name: redactSensitiveTextForced(value.name).slice(0, 256) } : {}),
+        ...(typeof value.version === "string" ? { version: redactSensitiveTextForced(value.version).slice(0, 128) } : {}),
+    };
+}
+function sanitizePackageSource(source) {
+    const redacted = redactSensitiveTextForced(source);
+    if (redacted.startsWith("npm:"))
+        return redacted;
+    const hasGitPrefix = redacted.startsWith("git:");
+    const candidate = hasGitPrefix ? redacted.slice("git:".length) : redacted;
+    if (/^(?:https?|ssh|git):\/\//iu.test(candidate)) {
+        try {
+            const url = new URL(candidate);
+            url.username = "";
+            url.password = "";
+            url.search = "";
+            url.hash = "";
+            return `${hasGitPrefix ? "git:" : ""}${url.toString()}`;
+        }
+        catch {
+            return "<remote-package>";
+        }
+    }
+    if (hasGitPrefix)
+        return "<git-package>";
+    return `local:${basename(resolve(redacted))}`;
+}
+function check(status, id, message, files = []) {
+    return {
+        id,
+        status,
+        message: redactSensitiveTextForced(message).slice(0, 4096),
+        ...(files.length > 0
+            ? {
+                files: [...new Set(files.map((file) => redactSensitiveTextForced(file)))].sort((left, right) => left.localeCompare(right)),
+            }
+            : {}),
+    };
+}
+function runtimeImportCheck(unsupportedFiles, aliasedFiles) {
+    if (unsupportedFiles.length > 0) {
+        return check("error", "runtime-imports", "Unsupported Pi runtime imports require a compatibility shim", [
+            ...unsupportedFiles,
+            ...aliasedFiles,
+        ]);
+    }
+    if (aliasedFiles.length > 0) {
+        return check("warning", "runtime-imports", "Legacy Pi runtime imports will use OMK compatibility aliases", aliasedFiles);
+    }
+    return check("pass", "runtime-imports", "No legacy Pi runtime imports detected");
+}
+function headlessUiCheck(uiFiles, unguardedFiles) {
+    if (uiFiles.length === 0)
+        return check("pass", "headless-ui", "No UI-only behavior detected");
+    if (unguardedFiles.length === 0)
+        return check("pass", "headless-ui", "UI use is guarded for headless modes");
+    return check("warning", "headless-ui", "UI use is not guarded by ctx.hasUI or ctx.mode", unguardedFiles);
+}
+/** Static-only compatibility inspection. Extension modules are never imported or executed. */
+export function inspectPackageCompatibility(input) {
+    const root = resolve(input.packageRoot);
+    let packageJson = {};
+    let packageJsonDiagnostics = [];
+    try {
+        packageJson = JSON.parse(readFileSync(resolve(root, "package.json"), "utf8"));
+    }
+    catch {
+        packageJsonDiagnostics = [{ path: "package.json", message: "package.json must contain valid JSON" }];
+    }
+    const manifest = resolvePackageManifest(packageJson);
+    const manifestDiagnostics = [...packageJsonDiagnostics, ...manifest.diagnostics];
+    const { sources, skipped } = scanPackageExtensionSources(root, input.resources.extensions);
+    const allText = sources.map((source) => source.text).join("\n");
+    const aliasedImportFiles = sourceFilesMatching(sources, (text) => importedSpecifiers(text).some((specifier) => isSupportedLegacyPiRuntimeImport(specifier)));
+    const unsupportedImportFiles = sourceFilesMatching(sources, (text) => importedSpecifiers(text).some((specifier) => isLegacyPiRuntimeImport(specifier) && !isSupportedLegacyPiRuntimeImport(specifier)));
+    const storageFiles = sourceFilesMatching(sources, (text) => /(?:~\/\.pi|["']\.pi["']|PI_CODING_AGENT_DIR|PI_TODO_PATH)/u.test(text));
+    const allEvents = sources.flatMap((source) => subscribedEvents(source.text));
+    const unsupportedEvents = [
+        ...new Set(allEvents.filter((event) => !PACKAGE_DOCTOR_SUPPORTED_EVENTS.has(event))),
+    ].sort((left, right) => left.localeCompare(right));
+    const lifecycleFiles = sourceFilesMatching(sources, (text) => subscribedEvents(text).some((event) => !PACKAGE_DOCTOR_SUPPORTED_EVENTS.has(event)));
+    const uiFiles = sourceFilesMatching(sources, (text) => /\bctx\.ui\b/u.test(text));
+    const unguardedUiFiles = sourceFilesMatching(sources, (text) => /\bctx\.ui\b/u.test(text) && !/\bctx\.hasUI\b|\bctx\.mode\b/u.test(text));
+    const resumeRelevant = storageFiles.length > 0 || /\bappendEntry\b|\bgetEntries\b|session_switch/u.test(allText);
+    const resumeAware = !resumeRelevant ||
+        (allEvents.includes("session_start") && /["']resume["']|\.reason\s*===?\s*["']resume["']/u.test(allText));
+    const totalResources = Object.values(input.resources).reduce((sum, entries) => sum + entries.length, 0);
+    const checks = [
+        check(manifestDiagnostics.length === 0 ? "pass" : "error", "manifest", manifestDiagnostics.length > 0
+            ? "The selected package manifest is malformed"
+            : manifest.key === null
+                ? "Using convention directories"
+                : `Using package.json ${manifest.key} manifest`, manifestDiagnostics.map((diagnostic) => diagnostic.path)),
+        check(totalResources > 0 ? "pass" : "error", "resources", `${totalResources} package resource(s) resolved`),
+        runtimeImportCheck(unsupportedImportFiles, aliasedImportFiles),
+        check(storageFiles.length === 0 ? "pass" : "warning", "storage-paths", storageFiles.length === 0
+            ? "No hard-coded .pi storage paths detected"
+            : "Hard-coded Pi storage paths may bypass OMK configuration", storageFiles),
+        check(unsupportedEvents.length === 0 ? "pass" : "error", "lifecycle-events", unsupportedEvents.length === 0
+            ? "Lifecycle event names are supported"
+            : `Unsupported lifecycle event(s): ${unsupportedEvents.join(", ")}`, lifecycleFiles),
+        headlessUiCheck(uiFiles, unguardedUiFiles),
+        check(resumeAware ? "pass" : "warning", "resume-awareness", resumeAware
+            ? "No resume-state incompatibility detected"
+            : "Persistent state does not show a session_start resume path"),
+        check(skipped.length === 0 ? "pass" : "warning", "scan-coverage", skipped.length === 0
+            ? `${sources.length} extension file(s) inspected statically`
+            : `Static scan skipped ${skipped.length} file(s)`, skipped),
+    ];
+    return {
+        schemaVersion: 1,
+        source: sanitizePackageSource(input.source),
+        package: packageMetadata(packageJson),
+        manifest: {
+            selected: manifest.key ?? "convention",
+            shadowedPi: manifest.key === "omk" && manifest.present.pi,
+            diagnostics: manifestDiagnostics,
+        },
+        resources: {
+            extensions: input.resources.extensions.length,
+            skills: input.resources.skills.length,
+            prompts: input.resources.prompts.length,
+            themes: input.resources.themes.length,
+        },
+        inspectedFiles: sources
+            .map((source) => redactSensitiveTextForced(source.file))
+            .sort((left, right) => left.localeCompare(right)),
+        checks,
+        compatible: checks.every((item) => item.status !== "error"),
+    };
+}
+//# sourceMappingURL=package-doctor.js.map

package/dist/core/package-doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-doctor.js","sourceRoot":"","sources":["../../src/core/package-doctor.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { basename, resolve } from \"node:path\";\nimport {\n\timportedSpecifiers,\n\tPACKAGE_DOCTOR_SUPPORTED_EVENTS,\n\tscanPackageExtensionSources,\n\tsourceFilesMatching,\n\tsubscribedEvents,\n} from \"./package-doctor-source-scan.ts\";\nimport { type PackageManifestDiagnostic, type PackageManifestKey, resolvePackageManifest } from \"./package-manifest.ts\";\nimport { isLegacyPiRuntimeImport, isSupportedLegacyPiRuntimeImport } from \"./pi-compat.ts\";\nimport { redactSensitiveTextForced } from \"./redaction.ts\";\n\nexport interface PackageDoctorResources {\n\textensions: string[];\n\tskills: string[];\n\tprompts: string[];\n\tthemes: string[];\n}\n\nexport interface PackageDoctorInput {\n\tsource: string;\n\tpackageRoot: string;\n\tresources: PackageDoctorResources;\n}\n\nexport interface PackageDoctorCheck {\n\tid:\n\t\t| \"manifest\"\n\t\t| \"resources\"\n\t\t| \"runtime-imports\"\n\t\t| \"storage-paths\"\n\t\t| \"lifecycle-events\"\n\t\t| \"headless-ui\"\n\t\t| \"resume-awareness\"\n\t\t| \"scan-coverage\";\n\tstatus: \"pass\" | \"warning\" | \"error\";\n\tmessage: string;\n\tfiles?: string[];\n}\n\nexport interface PackageDoctorResult {\n\tschemaVersion: 1;\n\tsource: string;\n\tpackage: { name?: string; version?: string };\n\tmanifest: {\n\t\tselected: PackageManifestKey | \"convention\";\n\t\tshadowedPi: boolean;\n\t\tdiagnostics: Array<{ path: string; message: string }>;\n\t};\n\tresources: Record<keyof PackageDoctorResources, number>;\n\tinspectedFiles: string[];\n\tchecks: PackageDoctorCheck[];\n\tcompatible: boolean;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction packageMetadata(value: unknown): { name?: string; version?: string } {\n\tif (!isRecord(value)) return {};\n\treturn {\n\t\t...(typeof value.name === \"string\" ? { name: redactSensitiveTextForced(value.name).slice(0, 256) } : {}),\n\t\t...(typeof value.version === \"string\" ? { version: redactSensitiveTextForced(value.version).slice(0, 128) } : {}),\n\t};\n}\n\nfunction sanitizePackageSource(source: string): string {\n\tconst redacted = redactSensitiveTextForced(source);\n\tif (redacted.startsWith(\"npm:\")) return redacted;\n\tconst hasGitPrefix = redacted.startsWith(\"git:\");\n\tconst candidate = hasGitPrefix ? redacted.slice(\"git:\".length) : redacted;\n\tif (/^(?:https?|ssh|git):\\/\\//iu.test(candidate)) {\n\t\ttry {\n\t\t\tconst url = new URL(candidate);\n\t\t\turl.username = \"\";\n\t\t\turl.password = \"\";\n\t\t\turl.search = \"\";\n\t\t\turl.hash = \"\";\n\t\t\treturn `${hasGitPrefix ? \"git:\" : \"\"}${url.toString()}`;\n\t\t} catch {\n\t\t\treturn \"<remote-package>\";\n\t\t}\n\t}\n\tif (hasGitPrefix) return \"<git-package>\";\n\treturn `local:${basename(resolve(redacted))}`;\n}\n\nfunction check(\n\tstatus: PackageDoctorCheck[\"status\"],\n\tid: PackageDoctorCheck[\"id\"],\n\tmessage: string,\n\tfiles: string[] = [],\n): PackageDoctorCheck {\n\treturn {\n\t\tid,\n\t\tstatus,\n\t\tmessage: redactSensitiveTextForced(message).slice(0, 4096),\n\t\t...(files.length > 0\n\t\t\t? {\n\t\t\t\t\tfiles: [...new Set(files.map((file) => redactSensitiveTextForced(file)))].sort((left, right) =>\n\t\t\t\t\t\tleft.localeCompare(right),\n\t\t\t\t\t),\n\t\t\t\t}\n\t\t\t: {}),\n\t};\n}\n\nfunction runtimeImportCheck(unsupportedFiles: string[], aliasedFiles: string[]): PackageDoctorCheck {\n\tif (unsupportedFiles.length > 0) {\n\t\treturn check(\"error\", \"runtime-imports\", \"Unsupported Pi runtime imports require a compatibility shim\", [\n\t\t\t...unsupportedFiles,\n\t\t\t...aliasedFiles,\n\t\t]);\n\t}\n\tif (aliasedFiles.length > 0) {\n\t\treturn check(\n\t\t\t\"warning\",\n\t\t\t\"runtime-imports\",\n\t\t\t\"Legacy Pi runtime imports will use OMK compatibility aliases\",\n\t\t\taliasedFiles,\n\t\t);\n\t}\n\treturn check(\"pass\", \"runtime-imports\", \"No legacy Pi runtime imports detected\");\n}\n\nfunction headlessUiCheck(uiFiles: string[], unguardedFiles: string[]): PackageDoctorCheck {\n\tif (uiFiles.length === 0) return check(\"pass\", \"headless-ui\", \"No UI-only behavior detected\");\n\tif (unguardedFiles.length === 0) return check(\"pass\", \"headless-ui\", \"UI use is guarded for headless modes\");\n\treturn check(\"warning\", \"headless-ui\", \"UI use is not guarded by ctx.hasUI or ctx.mode\", unguardedFiles);\n}\n\n/** Static-only compatibility inspection. Extension modules are never imported or executed. */\nexport function inspectPackageCompatibility(input: PackageDoctorInput): PackageDoctorResult {\n\tconst root = resolve(input.packageRoot);\n\tlet packageJson: unknown = {};\n\tlet packageJsonDiagnostics: PackageManifestDiagnostic[] = [];\n\ttry {\n\t\tpackageJson = JSON.parse(readFileSync(resolve(root, \"package.json\"), \"utf8\")) as unknown;\n\t} catch {\n\t\tpackageJsonDiagnostics = [{ path: \"package.json\", message: \"package.json must contain valid JSON\" }];\n\t}\n\tconst manifest = resolvePackageManifest(packageJson);\n\tconst manifestDiagnostics = [...packageJsonDiagnostics, ...manifest.diagnostics];\n\tconst { sources, skipped } = scanPackageExtensionSources(root, input.resources.extensions);\n\tconst allText = sources.map((source) => source.text).join(\"\\n\");\n\tconst aliasedImportFiles = sourceFilesMatching(sources, (text) =>\n\t\timportedSpecifiers(text).some((specifier) => isSupportedLegacyPiRuntimeImport(specifier)),\n\t);\n\tconst unsupportedImportFiles = sourceFilesMatching(sources, (text) =>\n\t\timportedSpecifiers(text).some(\n\t\t\t(specifier) => isLegacyPiRuntimeImport(specifier) && !isSupportedLegacyPiRuntimeImport(specifier),\n\t\t),\n\t);\n\tconst storageFiles = sourceFilesMatching(sources, (text) =>\n\t\t/(?:~\\/\\.pi|[\"']\\.pi[\"']|PI_CODING_AGENT_DIR|PI_TODO_PATH)/u.test(text),\n\t);\n\tconst allEvents = sources.flatMap((source) => subscribedEvents(source.text));\n\tconst unsupportedEvents = [\n\t\t...new Set(allEvents.filter((event) => !PACKAGE_DOCTOR_SUPPORTED_EVENTS.has(event))),\n\t].sort((left, right) => left.localeCompare(right));\n\tconst lifecycleFiles = sourceFilesMatching(sources, (text) =>\n\t\tsubscribedEvents(text).some((event) => !PACKAGE_DOCTOR_SUPPORTED_EVENTS.has(event)),\n\t);\n\tconst uiFiles = sourceFilesMatching(sources, (text) => /\\bctx\\.ui\\b/u.test(text));\n\tconst unguardedUiFiles = sourceFilesMatching(\n\t\tsources,\n\t\t(text) => /\\bctx\\.ui\\b/u.test(text) && !/\\bctx\\.hasUI\\b|\\bctx\\.mode\\b/u.test(text),\n\t);\n\tconst resumeRelevant = storageFiles.length > 0 || /\\bappendEntry\\b|\\bgetEntries\\b|session_switch/u.test(allText);\n\tconst resumeAware =\n\t\t!resumeRelevant ||\n\t\t(allEvents.includes(\"session_start\") && /[\"']resume[\"']|\\.reason\\s*===?\\s*[\"']resume[\"']/u.test(allText));\n\tconst totalResources = Object.values(input.resources).reduce((sum, entries) => sum + entries.length, 0);\n\n\tconst checks: PackageDoctorCheck[] = [\n\t\tcheck(\n\t\t\tmanifestDiagnostics.length === 0 ? \"pass\" : \"error\",\n\t\t\t\"manifest\",\n\t\t\tmanifestDiagnostics.length > 0\n\t\t\t\t? \"The selected package manifest is malformed\"\n\t\t\t\t: manifest.key === null\n\t\t\t\t\t? \"Using convention directories\"\n\t\t\t\t\t: `Using package.json ${manifest.key} manifest`,\n\t\t\tmanifestDiagnostics.map((diagnostic) => diagnostic.path),\n\t\t),\n\t\tcheck(totalResources > 0 ? \"pass\" : \"error\", \"resources\", `${totalResources} package resource(s) resolved`),\n\t\truntimeImportCheck(unsupportedImportFiles, aliasedImportFiles),\n\t\tcheck(\n\t\t\tstorageFiles.length === 0 ? \"pass\" : \"warning\",\n\t\t\t\"storage-paths\",\n\t\t\tstorageFiles.length === 0\n\t\t\t\t? \"No hard-coded .pi storage paths detected\"\n\t\t\t\t: \"Hard-coded Pi storage paths may bypass OMK configuration\",\n\t\t\tstorageFiles,\n\t\t),\n\t\tcheck(\n\t\t\tunsupportedEvents.length === 0 ? \"pass\" : \"error\",\n\t\t\t\"lifecycle-events\",\n\t\t\tunsupportedEvents.length === 0\n\t\t\t\t? \"Lifecycle event names are supported\"\n\t\t\t\t: `Unsupported lifecycle event(s): ${unsupportedEvents.join(\", \")}`,\n\t\t\tlifecycleFiles,\n\t\t),\n\t\theadlessUiCheck(uiFiles, unguardedUiFiles),\n\t\tcheck(\n\t\t\tresumeAware ? \"pass\" : \"warning\",\n\t\t\t\"resume-awareness\",\n\t\t\tresumeAware\n\t\t\t\t? \"No resume-state incompatibility detected\"\n\t\t\t\t: \"Persistent state does not show a session_start resume path\",\n\t\t),\n\t\tcheck(\n\t\t\tskipped.length === 0 ? \"pass\" : \"warning\",\n\t\t\t\"scan-coverage\",\n\t\t\tskipped.length === 0\n\t\t\t\t? `${sources.length} extension file(s) inspected statically`\n\t\t\t\t: `Static scan skipped ${skipped.length} file(s)`,\n\t\t\tskipped,\n\t\t),\n\t];\n\n\treturn {\n\t\tschemaVersion: 1,\n\t\tsource: sanitizePackageSource(input.source),\n\t\tpackage: packageMetadata(packageJson),\n\t\tmanifest: {\n\t\t\tselected: manifest.key ?? \"convention\",\n\t\t\tshadowedPi: manifest.key === \"omk\" && manifest.present.pi,\n\t\t\tdiagnostics: manifestDiagnostics,\n\t\t},\n\t\tresources: {\n\t\t\textensions: input.resources.extensions.length,\n\t\t\tskills: input.resources.skills.length,\n\t\t\tprompts: input.resources.prompts.length,\n\t\t\tthemes: input.resources.themes.length,\n\t\t},\n\t\tinspectedFiles: sources\n\t\t\t.map((source) => redactSensitiveTextForced(source.file))\n\t\t\t.sort((left, right) => left.localeCompare(right)),\n\t\tchecks,\n\t\tcompatible: checks.every((item) => item.status !== \"error\"),\n\t};\n}\n"]}

package/dist/core/package-manager.d.ts

@@ -16,6 +16,11 @@ export interface ResolvedPaths {
     prompts: ResolvedResource[];
     themes: ResolvedResource[];
 }
+export interface PackageInspection {
+    packageRoot: string;
+    resources: ResolvedPaths;
+    cleanup?: () => void;
+}
 export type MissingSourceAction = "install" | "skip" | "error";
 /** Thrown when an `onMissing` callback explicitly requests aborting resolution. */
 export declare class MissingSourceError extends Error {
@@ -60,6 +65,7 @@ export interface PackageManager {
         local?: boolean;
         temporary?: boolean;
     }): Promise<ResolvedPaths>;
+    preparePackageInspection(source: string): Promise<PackageInspection>;
     addSourceToSettings(source: string, options?: {
         local?: boolean;
     }): boolean;
@@ -99,6 +105,7 @@ export declare class DefaultPackageManager implements PackageManager {
         local?: boolean;
         temporary?: boolean;
     }): Promise<ResolvedPaths>;
+    preparePackageInspection(source: string): Promise<PackageInspection>;
     listConfiguredPackages(): ConfiguredPackage[];
     install(source: string, options?: {
         local?: boolean;
@@ -159,6 +166,8 @@ export declare class DefaultPackageManager implements PackageManager {
     private getGitDependencyInstallArgs;
     private runNpmCommandSync;
     private getNpmInstallArgs;
+    private cloneGitForInspection;
+    private downloadNpmForInspection;
     private installNpm;
     private uninstallNpm;
     private installGit;
@@ -191,7 +200,7 @@ export declare class DefaultPackageManager implements PackageManager {
      * that pass the manifest's own patterns.
      */
     private collectManifestFiles;
-    private readOmkManifest;
+    private readPackageManifest;
     private addManifestEntries;
     private collectFilesFromManifestEntries;
     private resolveLocalEntries;