@phi-code-admin/phi-code 0.56.3

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

@@ -0,0 +1,156 @@
+import type { SettingsManager } from "./settings-manager.js";
+export interface PathMetadata {
+    source: string;
+    scope: SourceScope;
+    origin: "package" | "top-level";
+    baseDir?: string;
+}
+export interface ResolvedResource {
+    path: string;
+    enabled: boolean;
+    metadata: PathMetadata;
+}
+export interface ResolvedPaths {
+    extensions: ResolvedResource[];
+    skills: ResolvedResource[];
+    prompts: ResolvedResource[];
+    themes: ResolvedResource[];
+}
+export type MissingSourceAction = "install" | "skip" | "error";
+export interface ProgressEvent {
+    type: "start" | "progress" | "complete" | "error";
+    action: "install" | "remove" | "update" | "clone" | "pull";
+    source: string;
+    message?: string;
+}
+export type ProgressCallback = (event: ProgressEvent) => void;
+export interface PackageManager {
+    resolve(onMissing?: (source: string) => Promise<MissingSourceAction>): Promise<ResolvedPaths>;
+    install(source: string, options?: {
+        local?: boolean;
+    }): Promise<void>;
+    remove(source: string, options?: {
+        local?: boolean;
+    }): Promise<void>;
+    update(source?: string): Promise<void>;
+    resolveExtensionSources(sources: string[], options?: {
+        local?: boolean;
+        temporary?: boolean;
+    }): Promise<ResolvedPaths>;
+    addSourceToSettings(source: string, options?: {
+        local?: boolean;
+    }): boolean;
+    removeSourceFromSettings(source: string, options?: {
+        local?: boolean;
+    }): boolean;
+    setProgressCallback(callback: ProgressCallback | undefined): void;
+    getInstalledPath(source: string, scope: "user" | "project"): string | undefined;
+}
+interface PackageManagerOptions {
+    cwd: string;
+    agentDir: string;
+    settingsManager: SettingsManager;
+}
+type SourceScope = "user" | "project" | "temporary";
+export declare class DefaultPackageManager implements PackageManager {
+    private cwd;
+    private agentDir;
+    private settingsManager;
+    private globalNpmRoot;
+    private progressCallback;
+    constructor(options: PackageManagerOptions);
+    setProgressCallback(callback: ProgressCallback | undefined): void;
+    addSourceToSettings(source: string, options?: {
+        local?: boolean;
+    }): boolean;
+    removeSourceFromSettings(source: string, options?: {
+        local?: boolean;
+    }): boolean;
+    getInstalledPath(source: string, scope: "user" | "project"): string | undefined;
+    private emitProgress;
+    private withProgress;
+    resolve(onMissing?: (source: string) => Promise<MissingSourceAction>): Promise<ResolvedPaths>;
+    resolveExtensionSources(sources: string[], options?: {
+        local?: boolean;
+        temporary?: boolean;
+    }): Promise<ResolvedPaths>;
+    install(source: string, options?: {
+        local?: boolean;
+    }): Promise<void>;
+    remove(source: string, options?: {
+        local?: boolean;
+    }): Promise<void>;
+    update(source?: string): Promise<void>;
+    private updateSourceForScope;
+    private resolvePackageSources;
+    private resolveLocalExtensionSource;
+    private installParsedSource;
+    private getPackageSourceString;
+    private getSourceMatchKeyForInput;
+    private getSourceMatchKeyForSettings;
+    private packageSourcesMatch;
+    private normalizePackageSourceForSettings;
+    private parseSource;
+    /**
+     * Check if an npm package needs to be updated.
+     * - For unpinned packages: check if registry has a newer version
+     * - For pinned packages: check if installed version matches the pinned version
+     */
+    private npmNeedsUpdate;
+    private getInstalledNpmVersion;
+    private getLatestNpmVersion;
+    /**
+     * Get a unique identity for a package, ignoring version/ref.
+     * Used to detect when the same package is in both global and project settings.
+     * For git packages, uses normalized host/path to ensure SSH and HTTPS URLs
+     * for the same repository are treated as identical.
+     */
+    private getPackageIdentity;
+    /**
+     * Dedupe packages: if same package identity appears in both global and project,
+     * keep only the project one (project wins).
+     */
+    private dedupePackages;
+    private parseNpmSpec;
+    private installNpm;
+    private uninstallNpm;
+    private installGit;
+    private updateGit;
+    private refreshTemporaryGitSource;
+    private removeGit;
+    private pruneEmptyGitParents;
+    private ensureNpmProject;
+    private ensureGitIgnore;
+    private getNpmInstallRoot;
+    private getGlobalNpmRoot;
+    private getNpmInstallPath;
+    private getGitInstallPath;
+    private getGitInstallRoot;
+    private getTemporaryDir;
+    private getBaseDirForScope;
+    private resolvePath;
+    private resolvePathFromBase;
+    private collectPackageResources;
+    private collectDefaultResources;
+    private applyPackageFilter;
+    /**
+     * Collect all files from a package for a resource type, applying manifest patterns.
+     * Returns { allFiles, enabledByManifest } where enabledByManifest is the set of files
+     * that pass the manifest's own patterns.
+     */
+    private collectManifestFiles;
+    private readPiManifest;
+    private addManifestEntries;
+    private collectFilesFromManifestEntries;
+    private resolveLocalEntries;
+    private addAutoDiscoveredResources;
+    private collectFilesFromPaths;
+    private getTargetMap;
+    private addResource;
+    private createAccumulator;
+    private toResolvedPaths;
+    private runCommand;
+    private runCommandSync;
+}
+export {};
+//# sourceMappingURL=package-manager.d.ts.map

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

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