@danypops/pi-packed 0.27.12 → 0.27.13

package/dist/adoption/check.d.ts

@@ -0,0 +1,54 @@
+import { type ExtensionSmokeResult } from "./smoke.ts";
+export type DiagnosticSeverity = "error" | "warning" | "info";
+export interface Diagnostic {
+    code: string;
+    severity: DiagnosticSeverity;
+    path: string;
+    message: string;
+    fix?: string;
+}
+export interface CheckReport {
+    root: string;
+    ok: boolean;
+    diagnostics: Diagnostic[];
+    summary: {
+        errors: number;
+        warnings: number;
+        info: number;
+    };
+    checkedFiles: number;
+    truncated: boolean;
+    smoke?: {
+        extensions: ExtensionSmokeResult[];
+    };
+}
+export interface CheckOptions {
+    generic?: boolean;
+    smoke?: boolean;
+    maxDiagnostics?: number;
+    maxFiles?: number;
+}
+export interface PackageChecker {
+    check(packagePath: string, options?: CheckOptions): Promise<CheckReport>;
+}
+export declare class StaticPackageChecker implements PackageChecker {
+    check(packagePath: string, options?: CheckOptions): Promise<CheckReport>;
+}
+declare const RESOURCE_FIELDS: readonly ["extensions", "skills", "prompts", "themes"];
+export declare function walk(root: string, maxFiles: number, bundledRoots: string[]): {
+    files: string[];
+    truncated: boolean;
+};
+export declare function matchesPattern(file: string, pattern: string): boolean;
+export declare function isContainedFile(root: string, file: string): boolean;
+export type ResourceField = (typeof RESOURCE_FIELDS)[number];
+/** Pure discovery: which shipped files a package's own manifest (or
+ * conventional-directory fallback) declares as extensions/skills/prompts/
+ * themes, after the same extension-type and containment filtering
+ * resourcesCheck diagnoses -- without the diagnostics. Used by the
+ * package-resource overlay to know what there is to enable or disable. */
+export declare function discoverPackageResources(root: string, pkg: Record<string, unknown>, files: string[]): Record<ResourceField, string[]>;
+export declare function checkPackage(packagePath: string, options?: CheckOptions): Promise<CheckReport>;
+export declare function formatCheckReport(report: CheckReport, json: boolean): string;
+export {};
+//# sourceMappingURL=check.d.ts.map

package/dist/adoption/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../service/src/adoption/check.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,oBAAoB,EAAqB,MAAM,YAAY,CAAC;AAE1E,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE;QAAE,UAAU,EAAE,oBAAoB,EAAE,CAAA;KAAE,CAAC;CAC/C;AAED,MAAM,WAAW,YAAY;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC9B,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACzE;AAED,qBAAa,oBAAqB,YAAW,cAAc;IAC1D,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;CAGxE;AAyBD,QAAA,MAAM,eAAe,wDAAyD,CAAC;AA0B/E,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAoCpH;AAsCD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAIrE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAOnE;AA4FD,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D;;;;0EAI0E;AAC1E,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC,CAYrI;AAueD,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CA6GxG;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAwB5E"}

package/dist/adoption/duplicate-dependency-doctor.d.ts

@@ -0,0 +1,17 @@
+export interface DuplicateDependencyLocation {
+    readonly path: string;
+    readonly version: string;
+}
+export interface DuplicateDependencyDiagnostic {
+    readonly name: string;
+    readonly locations: readonly DuplicateDependencyLocation[];
+}
+/**
+ * Every @danypops/<name> resolved to more than one distinct version
+ * anywhere under piHome/npm/node_modules -- sorted by name for stable
+ * output. Two locations at the SAME version are never reported (npm simply
+ * didn't need to hoist further, not a real split); only an actual version
+ * disagreement is.
+ */
+export declare function findDuplicateDependencyVersions(piHome: string): DuplicateDependencyDiagnostic[];
+//# sourceMappingURL=duplicate-dependency-doctor.d.ts.map

package/dist/adoption/duplicate-dependency-doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate-dependency-doctor.d.ts","sourceRoot":"","sources":["../../service/src/adoption/duplicate-dependency-doctor.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,2BAA2B;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,6BAA6B;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,SAAS,2BAA2B,EAAE,CAAC;CAC3D;AAqDD;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,GAAG,6BAA6B,EAAE,CAgB/F"}

package/dist/adoption/install-validation.d.ts

@@ -0,0 +1,63 @@
+export interface ExtensionLoadResult {
+    path: string;
+    ok: boolean;
+    message?: string;
+    /** Non-gating: @danypops/vehicle-client-pi's pi-load-harness checks two
+     * further Pi extension load paths (native ESM, jiti tryNative:false)
+     * beyond the one path above (jiti tryNative:true) already gates install.
+     * Surfaced as observational evidence only, for two independent reasons:
+     * (1) native-esm can legitimately fail for a perfectly loadable extension
+     * on an older Node without TS type-stripping support, with no real-world
+     * signal yet on how often that's a false alarm; (2) this check only
+     * verifies the module *imports* cleanly -- unlike the gating check above,
+     * it never calls the extension's exported factory, so it cannot catch a
+     * factory that throws once actually registered (confirmed directly: the
+     * BROKEN test fixture, whose factory always throws, reports ok:true on
+     * every one of these paths). Complementary evidence for an import-time
+     * failure class, not a broader replacement for the gating check. */
+    additionalLoadPaths?: PiLoadPathResult[];
+}
+export interface PiLoadPathResult {
+    path: "native-esm" | "jiti-try-native-false" | "jiti-try-native-true";
+    ok: boolean;
+    error?: string;
+}
+export interface InstallValidationResult {
+    ok: boolean;
+    source: string;
+    extensions: ExtensionLoadResult[];
+    message?: string;
+}
+export interface InstallValidator {
+    validate(source: string): Promise<InstallValidationResult>;
+}
+/**
+ * Shared with ExecInstaller.install() (the single ad hoc path, which validates then commits
+ * itself) and SetupManager.apply() (the batch path, which validates every package change
+ * concurrently via Installer.validate() before ever calling installOnly() on any of them) --
+ * one formatting rule for "why was this install refused", not two copies that could drift.
+ */
+export declare function assertInstallValidationOk(validation: InstallValidationResult): void;
+/** Strips packed's own "npm:" scheme -- what npm pack itself expects is a
+ * bare registry spec (name, name@version) or a local path. Returns
+ * undefined for git:/https:/local sources: nothing here to stage from an
+ * npm tarball, so headless validation is out of scope for them. */
+export declare function bareNpmSpec(source: string): string | undefined;
+/** Runs pi-extension-harness's mock-pi-cli against one extension entry
+ * point, in its own load-only mode (--tool omitted): a real, isolated
+ * subprocess exercising Pi's own production jiti load path. */
+export declare function validateExtensionLoadsHeadless(entryPath: string, timeoutMs?: number): Promise<ExtensionLoadResult>;
+/** Stages the real npm tarball in isolation and headlessly load-checks
+ * every pi.extensions entry it declares. A non-npm source has nothing to
+ * stage and passes through as ok. A package with no pi.extensions passes
+ * only if it declares some other pi manifest resource (skills/prompts/
+ * themes) or has a matching pi convention directory on disk -- otherwise
+ * it isn't a Pi package at all (a plain npm dependency like is-number or
+ * is-buffer) and is refused rather than silently admitted as a dead
+ * `packages` entry pi itself would never load anything from. */
+export declare class HeadlessInstallValidator implements InstallValidator {
+    private readonly timeoutMs?;
+    constructor(timeoutMs?: number | undefined);
+    validate(source: string): Promise<InstallValidationResult>;
+}
+//# sourceMappingURL=install-validation.d.ts.map

package/dist/adoption/install-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-validation.d.ts","sourceRoot":"","sources":["../../service/src/adoption/install-validation.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;;;;;;wEAYoE;IACpE,mBAAmB,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,YAAY,GAAG,uBAAuB,GAAG,sBAAsB,CAAC;IACtE,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACvC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;CAC3D;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,uBAAuB,GAAG,IAAI,CAOnF;AAkFD;;;mEAGmE;AACnE,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE9D;AAkED;;+DAE+D;AAC/D,wBAAsB,8BAA8B,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAmCxH;AAwBD;;;;;;;gEAOgE;AAChE,qBAAa,wBAAyB,YAAW,gBAAgB;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAAV,SAAS,CAAC,EAAE,MAAM,YAAA;IAEzC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAgEhE"}

package/dist/adoption/module-freshness.d.ts

@@ -0,0 +1,39 @@
+export interface LoadedModuleSnapshot {
+    readonly name: string;
+    readonly packageJsonPath: string;
+    readonly version?: string;
+    readonly mtimeMs?: number;
+}
+export interface ModuleFreshnessDiagnostic {
+    readonly name: string;
+    readonly loadedVersion?: string;
+    readonly currentVersion?: string;
+    /** True only when both mtimes are known and genuinely differ -- never a
+     * guess from version alone (a version string can stay identical across
+     * a same-version reinstall that still replaced the file, and not every
+     * package bumps a version for a local/dev iteration). */
+    readonly stale: boolean;
+}
+/**
+ * Resolves `name`'s real installed package.json via Node's own module
+ * resolution (see smoke.ts's resolveDependencyModulesDir -- correct for
+ * both a nested and a hoisted layout, never executes anything) starting
+ * from `fromDir`, then records its version/mtime. undefined when `name`
+ * isn't resolvable from here at all -- never thrown, so one unresolvable
+ * watched name never prevents capturing the rest.
+ */
+export declare function captureLoadedModule(fromDir: string, name: string): LoadedModuleSnapshot | undefined;
+/** Bulk capture, skipping (not failing on) any name that isn't resolvable. */
+export declare function captureLoadedModules(fromDir: string, names: readonly string[]): LoadedModuleSnapshot[];
+export declare function checkModuleFreshness(snapshot: LoadedModuleSnapshot): ModuleFreshnessDiagnostic;
+export declare function checkModuleFreshnessAll(snapshots: readonly LoadedModuleSnapshot[]): ModuleFreshnessDiagnostic[];
+/** The exact set of names worth watching for a long-running process: its
+ * own direct runtime dependencies (package.json's "dependencies" field) --
+ * the ones a static top-level import actually loads once at process start.
+ * devDependencies/peerDependencies are never loaded by the running process
+ * itself, so watching them would only ever report false staleness. Bounded
+ * the same way readPackageDeclarations elsewhere in this codebase bounds
+ * an untrusted-shape read -- never throws on a malformed package.json,
+ * just reports nothing to watch. */
+export declare function ownRuntimeDependencyNames(packageJsonPath: string, maxNames?: number): string[];
+//# sourceMappingURL=module-freshness.d.ts.map

package/dist/adoption/module-freshness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-freshness.d.ts","sourceRoot":"","sources":["../../service/src/adoption/module-freshness.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,yBAAyB;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC;;;6DAGyD;IACzD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACxB;AAYD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAKnG;AAED,8EAA8E;AAC9E,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,oBAAoB,EAAE,CAOtG;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,yBAAyB,CAI9F;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,oBAAoB,EAAE,GAAG,yBAAyB,EAAE,CAE/G;AAED;;;;;;;oCAOoC;AACpC,wBAAgB,yBAAyB,CAAC,eAAe,EAAE,MAAM,EAAE,QAAQ,SAAM,GAAG,MAAM,EAAE,CAQ3F"}

package/dist/adoption/service-doctor.d.ts

@@ -0,0 +1,21 @@
+import type { ServiceInstallDeps } from "@danypops/vehicle-server/service";
+export interface ServiceUnitDiagnostic {
+    code: "SERVICE_EXEC_PATH_MISSING" | "SERVICE_NOT_RUNNING" | "SERVICE_STATUS_UNAVAILABLE" | "SERVICE_STALE_CODE";
+    severity: "error" | "warning";
+    package: string;
+    unitName: string;
+    message: string;
+}
+export interface ServiceDoctorReport {
+    ok: boolean;
+    diagnostics: ServiceUnitDiagnostic[];
+    checked: number;
+}
+export interface ServiceDoctorDeps extends ServiceInstallDeps {
+    fileExists(path: string): boolean;
+    /** Undefined (never throws) when the path doesn't exist or can't be stat'd. */
+    getMtimeMs(path: string): number | undefined;
+}
+export declare function checkServiceUnitPaths(piHome: string, projectRoot: string | undefined, deps: ServiceDoctorDeps): ServiceDoctorReport;
+export declare function formatServiceDoctorReport(report: ServiceDoctorReport, json: boolean): string;
+//# sourceMappingURL=service-doctor.d.ts.map

package/dist/adoption/service-doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-doctor.d.ts","sourceRoot":"","sources":["../../service/src/adoption/service-doctor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAI3E,MAAM,WAAW,qBAAqB;IACrC,IAAI,EAAE,2BAA2B,GAAG,qBAAqB,GAAG,4BAA4B,GAAG,oBAAoB,CAAC;IAChH,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,EAAE,qBAAqB,EAAE,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC5D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,+EAA+E;IAC/E,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAC7C;AAiBD,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,IAAI,EAAE,iBAAiB,GACrB,mBAAmB,CAqFrB;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,mBAAmB,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAO5F"}

package/dist/adoption/smoke.d.ts

@@ -0,0 +1,39 @@
+export type SmokeStatus = "ok" | "timeout" | "crash" | "capability-denied" | "output-limit" | "sandbox-unavailable";
+export interface SmokeRegistrations {
+    tools: string[];
+    commands: string[];
+    shortcuts: string[];
+    flags: string[];
+    providers: string[];
+    events: string[];
+    renderers: string[];
+}
+export interface ExtensionSmokeResult {
+    path: string;
+    status: SmokeStatus;
+    durationMs: number;
+    registrations: SmokeRegistrations;
+    message?: string;
+}
+export interface SmokeOptions {
+    timeoutMs?: number;
+    maxOutputBytes?: number;
+    maxProcesses?: number;
+}
+/**
+ * Resolves an installed dependency's real on-disk package directory via
+ * Node's own module-resolution algorithm (require.resolve against its
+ * package.json), starting from `fromDir` -- correct regardless of whether
+ * the package manager nested it under fromDir's own node_modules or
+ * hoisted it to a shared ancestor node_modules (npm's own hoisting
+ * decision, driven by what else in the tree also depends on it).
+ * Confirmed live: `packed doctor --json` crashed hard reconstructing a
+ * fixed nested-only path (`<packageDirectory>/node_modules/jiti`) that
+ * doesn't exist once jiti is hoisted to Pi's own npm prefix instead of
+ * pi-packed's own node_modules. Never executes the resolved module --
+ * require.resolve only locates a path, it never runs anything. undefined
+ * (not a throw) when genuinely unresolvable from here.
+ */
+export declare function resolveDependencyModulesDir(fromDir: string, name: string): string | undefined;
+export declare function runExtensionSmoke(packagePath: string, extensionFile: string, options?: SmokeOptions): Promise<ExtensionSmokeResult>;
+//# sourceMappingURL=smoke.d.ts.map

package/dist/adoption/smoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke.d.ts","sourceRoot":"","sources":["../../service/src/adoption/smoke.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,mBAAmB,GAAG,cAAc,GAAG,qBAAqB,CAAC;AAEpH,MAAM,WAAW,kBAAkB;IAClC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,kBAAkB,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AA2BD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO7F;AA4ID,wBAAsB,iBAAiB,CACtC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,YAAiB,GACxB,OAAO,CAAC,oBAAoB,CAAC,CAoF/B"}

package/dist/daemon/daemon-service.d.ts

@@ -0,0 +1,281 @@
+import { type VehicleRegistrar, type VehicleRegistrationOutcome, type VehicleSpec } from "@danypops/armada";
+import { type ServiceInstallResult, type ServiceSpec } from "@danypops/vehicle-server/service";
+import type { InstalledPkg } from "../packages/package.ts";
+export interface DaemonServiceManifest {
+    /** Relative to the installed package's own root directory. */
+    binPath: string;
+    args?: string[];
+    /** Defaults to the bare npm package name (scope stripped). */
+    name?: string;
+    displayName?: string;
+    /** Runtime handle filename inside the Vehicle's XDG runtime directory. */
+    handleFilename?: string;
+    workingDirectory?: string;
+    restartOnFailure?: boolean;
+    restartSec?: number;
+}
+export type ResolveDaemonServiceResult = {
+    ok: true;
+    spec: ServiceSpec;
+}
+/** notADaemon: this package (and nothing one level into its own dependencies) is Vehicle-shaped at all -- the overwhelmingly common case for a non-daemon Pi package, distinct from a real failure (systemctl unavailable, spec resolved but install itself failed). A caller composing install + install-service (see cli.ts's `install` command) uses this to stay silent instead of surfacing a false alarm on every ordinary package install. */
+ | {
+    ok: false;
+    reason: string;
+    notADaemon?: boolean;
+};
+/** A resolved daemon entrypoint, already an absolute binPath -- the common shape both an explicit manifest and detection converge to before a ServiceSpec is built. */
+interface ResolvedDaemonEntrypoint {
+    binPath: string;
+    args?: string[];
+    name: string;
+    displayName?: string;
+    handleFilename?: string;
+    workingDirectory?: string;
+    restartOnFailure?: boolean;
+    restartSec?: number;
+    version: string;
+}
+export declare function detectVehicleDaemonService(packageDir: string, fallbackName: string, hoistedNodeModulesDir?: string): ResolvedDaemonEntrypoint | undefined;
+/**
+ * Resolves the installed package's daemon entrypoint -- an explicit
+ * `packed.daemonService` manifest first, then detectVehicleDaemonService()
+ * -- and builds the exact ServiceSpec its own `service install` command
+ * would build. npm sources only for now; git:/local sources resolve to a
+ * different on-disk layout not yet supported here.
+ */
+export declare function resolveDaemonServiceSpec(piHome: string, source: string): ResolveDaemonServiceResult;
+export interface DaemonDependencyPkg {
+    name: string;
+    version: string;
+    /** The Armada vehicle name resolveDaemonServiceSpec built for this package -- may differ
+     * from `name`'s own bare unscoped form when a packed.daemonService manifest overrides it. */
+    vehicleName: string;
+}
+/**
+ * Every top-level npm package physically installed under piHome/npm/node_modules
+ * that resolveDaemonServiceSpec() itself already recognizes as a real Vehicle-
+ * shaped daemon (an explicit packed.daemonService manifest, or
+ * detectVehicleDaemonService()'s own-bin-plus-real-vehicle-dependency
+ * convention), but that is NOT itself a pi:-configured extension
+ * (readPackageDeclarations() has no entry for it) -- e.g. @danypops/lector,
+ * added directly to piHome/npm/package.json as an independent pin so it can
+ * run ahead of whatever version its own pi-lector wrapper's dependency tree
+ * would otherwise resolve. These are real, running Armada vehicles that a
+ * pi:-manifest-only "installed packages" notion makes permanently invisible
+ * to `packed installed`/`packed update` -- see
+ * packed-package-update-restart-service-cant-manage.
+ *
+ * Deliberately does NOT walk one level into each configured extension's own
+ * dependencies the way resolveDaemonServiceSpec's own detection does for
+ * install-service/restart-service/doctor (service-doctor.ts's
+ * checkServiceUnitPaths already reaches that same dependency through its
+ * wrapper extension's own row) -- duplicating that walk here would
+ * double-report the same Vehicle under two different package names. This
+ * only reports a dependency independently resolvable BY ITS OWN NAME at
+ * piHome/npm's own top level -- exactly the shape a caller can actually run
+ * `packed update npm:<name>` against directly.
+ */
+export declare function listUnconfiguredDaemonDependencies(piHome: string): DaemonDependencyPkg[];
+/**
+ * True when `packageName` (a bare npm name) is a pi:-configured extension --
+ * present in readPackageDeclarations()'s own packages[] list, regardless of
+ * whether it's pinned. The other half of the classification
+ * classifyUpdateSource() needs: a name that resolves ok via
+ * resolveDaemonServiceSpec() but returns false here is a "daemon-dependency"
+ * class source, not an "extension" one.
+ */
+export declare function isConfiguredExtension(piHome: string, packageName: string): boolean;
+export type UpdateSourceKind = "extension" | "daemon-dependency";
+/**
+ * Classifies an npm: source for package.update's own two-path mutation:
+ * "extension" (pi:-configured, settings.json's packages[] -- `pi update
+ * --extension` already handles this correctly, unchanged) vs.
+ * "daemon-dependency" (NOT pi:-configured, but resolveDaemonServiceSpec()
+ * resolves it directly BY ITS OWN NAME -- pi-core can never see this one;
+ * confirmed via this house's own failing-test repro, service/test/
+ * install.test.ts, of pi's real "No matching package found"). Needs the
+ * alternate npm-level mutation path (Installer.updateDaemonDependency())
+ * instead of shelling to `pi update --extension` at all.
+ *
+ * undefined for a non-npm: source, or an npm: source that is neither
+ * (never installed, or installed but not Vehicle-shaped) -- package.update's
+ * existing catch-all path (calling `pi update --extension` and surfacing
+ * whatever it reports) still applies unchanged to either of those, exactly
+ * as it did before this classification existed.
+ */
+export declare function classifyUpdateSource(piHome: string, source: string): UpdateSourceKind | undefined;
+/**
+ * `packed installed`'s real, whole-fleet listing: every pi:-configured
+ * extension (`kind: "extension"`, exactly today's
+ * readInstalledPackagesAcrossScopes() output, unchanged) PLUS every
+ * top-level daemon-only dependency listUnconfiguredDaemonDependencies() can
+ * independently resolve (`kind: "daemon-dependency"`) -- so a real, running
+ * Armada vehicle like @danypops/lector shows up under its own name instead
+ * of staying invisibly nested inside its pi-lector wrapper's own row. See
+ * packed-package-update-restart-service-cant-manage.
+ *
+ * projectRoot only ever widens the extension half (matching
+ * readInstalledPackagesAcrossScopes' own scope) -- daemon-dependency
+ * detection is global-only for now, since the reported gap itself (an
+ * independently-pinned piHome/npm/package.json dependency) is a global-scope
+ * shape; a project-scoped .pi/npm equivalent is real future work, not
+ * something this fixes today.
+ */
+export declare function listManagedPackages(piHome: string, projectRoot?: string): InstalledPkg[];
+export interface ReconcileAllResult {
+    /** `versionChanged` is true only when this pass's newly-resolved version genuinely differs
+     * from what Armada had registered before this sweep started -- `installed: true` alone means
+     * only "the register call itself succeeded", which is true on every healthy pass whether or
+     * not anything actually changed underneath (register()/reconcile() is a safe no-op against
+     * unchanged desired state). A caller wanting to know whether this pass genuinely restarted
+     * something (vs. just re-confirmed a healthy, unchanged fleet) must check this, not `installed`. */
+    reconciled: Array<{
+        packageName: string;
+        vehicleName: string;
+        installed: boolean;
+        versionChanged: boolean;
+        reason?: string;
+    }>;
+    skipped: number;
+    failed: Array<{
+        packageName: string;
+        reason: string;
+    }>;
+    /** Every Vehicle unregistered because this sweep no longer discovers it at all -- see pruneStaleVehicles. */
+    pruned: Array<{
+        vehicleName: string;
+        executable: string;
+    }>;
+    pruneFailed: Array<{
+        vehicleName: string;
+        reason: string;
+    }>;
+}
+/** Packed's own stable cross-daemon identity -- both its real Armada vehicle name (this file's own
+ * self-registration guards below) and, since it's the same daemon, the name it registers under in
+ * the shared Vehicle Handle Directory for Vehicle Shell broker mode (see daemon.ts's own
+ * daemonOptions() -- vehicleName: PACKED_VEHICLE_NAME). One canonical name, not two. */
+export declare const PACKED_VEHICLE_NAME = "pi-packed";
+/**
+ * Builds the command to launch armada's own `restart pi-packed` out-of-process. Plain
+ * `spawn(..., { detached: true }).unref()` is NOT enough on Linux: systemd's default
+ * KillMode=control-group kills every process in a unit's cgroup on `stop`, including a
+ * detached+unref'd child -- setsid() escapes a Unix process group, not a cgroup. Confirmed
+ * live: a bare detached spawn was killed mid-restart the instant the child's own `armada
+ * restart`'s `stop` step fired, because the child was still inside armada-pi-packed's own
+ * cgroup. `systemd-run --user --collect --unit=<name>` launches it as an independent
+ * transient unit with its own cgroup instead, immune to this unit's stop (confirmed live:
+ * a probe unit's child outlived its own service being stopped). launchd/Windows don't tear
+ * down a detached child's process tree the same way, so they use a plain spawn.
+ */
+export declare function selfRestartCommand(platform: NodeJS.Platform, execPath: string, cliPath: string, unitName: string): {
+    readonly command: string;
+    readonly arguments: readonly string[];
+};
+/** Fire-and-forget: schedule Packed's own Vehicle to restart from OUTSIDE this process (see
+ * selfRestartCommand for why a plain detached spawn alone doesn't survive on Linux). Runs a
+ * beat later so the response reporting "scheduled" has time to flush first. Swallows a
+ * resolution/spawn failure silently: worst case is the pre-existing behavior (a human restarts
+ * the service by hand), never a crash. */
+export type SelfRestartScheduler = (spec: ServiceSpec) => void;
+export declare const scheduleSelfRestart: SelfRestartScheduler;
+/**
+ * Sweeps every installed Packed package (global scope, plus a project's own
+ * pins when projectRoot is given), resolves each to a Vehicle-shaped daemon
+ * exactly as install()/restart() already do per-package, and upserts +
+ * reconciles it through Armada. This is what makes Armada authoritative for
+ * every Vehicle Packed knows about, not just the one source a single
+ * install/update call happened to touch -- it also self-heals a Vehicle
+ * whose daemon package version bumped as someone else's transitive
+ * dependency, and a Vehicle a prior Packed version never registered at all.
+ * Idempotent and safe to call unconditionally: a non-daemon package costs
+ * one or two file reads (see resolveDaemonServiceSpec) and never reaches
+ * Armada. Two packages that resolve to the same Vehicle (a Pi extension and
+ * its own daemon dependency, both separately Packed-tracked) reconcile it
+ * once, not twice.
+ */
+export declare function reconcileAllDaemonServices(piHome: string, projectRoot: string | undefined, installer: Pick<DaemonServiceInstaller, "install" | "listRegisteredVehicles" | "unregisterVehicleByName">): Promise<ReconcileAllResult>;
+export interface DaemonServiceInstaller {
+    install(piHome: string, source: string): Promise<{
+        ok: true;
+        result: ServiceInstallResult;
+        spec: ServiceSpec;
+    } | {
+        ok: false;
+        reason: string;
+        notADaemon?: boolean;
+    }>;
+    remove(piHome: string, source: string): Promise<{
+        ok: true;
+        result: ServiceInstallResult;
+        spec: ServiceSpec;
+    } | {
+        ok: false;
+        reason: string;
+        notADaemon?: boolean;
+    }>;
+    restart(piHome: string, source: string): Promise<{
+        ok: true;
+        restarted: boolean;
+        reason?: string;
+        spec: ServiceSpec;
+    } | {
+        ok: false;
+        reason: string;
+        notADaemon?: boolean;
+    }>;
+    /** Every Vehicle Armada currently declares -- see pruneStaleVehicles' own doc comment for why this exists. */
+    listRegisteredVehicles(): Promise<readonly VehicleSpec[]>;
+    /**
+     * Unregisters by Armada vehicle NAME directly, distinct from remove()'s
+     * own by-npm-source resolution -- pruning has no installed package left to
+     * resolve a source from; the whole point is the vehicle survived past
+     * whatever used to produce it.
+     */
+    unregisterVehicleByName(name: string): Promise<VehicleRegistrationOutcome>;
+}
+/**
+ * Calls Armada's own VehicleRegistrar directly (in-process), rather than
+ * shelling out to its CLI as a subprocess -- the same registration logic
+ * `@danypops/armada` exposes to any other library consumer, not a Packed-
+ * specific reimplementation. One registrar per instance so its manifest
+ * path/native controller are resolved once, not on every call.
+ */
+export declare class RealDaemonServiceInstaller implements DaemonServiceInstaller {
+    private readonly registrar;
+    private readonly selfRestart;
+    constructor(registrar?: VehicleRegistrar, selfRestart?: SelfRestartScheduler);
+    listRegisteredVehicles(): Promise<readonly VehicleSpec[]>;
+    unregisterVehicleByName(name: string): Promise<VehicleRegistrationOutcome>;
+    install(piHome: string, source: string): Promise<{
+        ok: true;
+        result: ServiceInstallResult;
+        spec: ServiceSpec;
+    } | {
+        ok: false;
+        reason: string;
+        notADaemon?: boolean;
+    }>;
+    remove(piHome: string, source: string): Promise<{
+        ok: true;
+        result: ServiceInstallResult;
+        spec: ServiceSpec;
+    } | {
+        ok: false;
+        reason: string;
+        notADaemon?: boolean;
+    }>;
+    restart(piHome: string, source: string): Promise<{
+        ok: true;
+        restarted: boolean;
+        reason?: string;
+        spec: ServiceSpec;
+    } | {
+        ok: false;
+        reason: string;
+        notADaemon?: boolean;
+    }>;
+}
+export {};
+//# sourceMappingURL=daemon-service.d.ts.map

package/dist/daemon/daemon-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-service.d.ts","sourceRoot":"","sources":["../../service/src/daemon/daemon-service.ts"],"names":[],"mappings":"AA+BA,OAAO,EAA0B,KAAK,gBAAgB,EAAE,KAAK,0BAA0B,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpI,OAAO,EAGN,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAEhB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG3D,MAAM,WAAW,qBAAqB;IACrC,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,0BAA0B,GACnC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,WAAW,CAAA;CAAE;AACjC,qbAAqb;GACnb;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAOvD,uKAAuK;AACvK,UAAU,wBAAwB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CAChB;AAqHD,wBAAgB,0BAA0B,CACzC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,qBAAqB,CAAC,EAAE,MAAM,GAC5B,wBAAwB,GAAG,SAAS,CA2BtC;AAoCD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,0BAA0B,CAkCnG;AAED,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB;iGAC6F;IAC7F,WAAW,EAAE,MAAM,CAAC;CACpB;AAiCD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAexF;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAElF;AAED,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,mBAAmB,CAAC;AAEjE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAMjG;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAYxF;AAED,MAAM,WAAW,kBAAkB;IAClC;;;;;wGAKoG;IACpG,UAAU,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,cAAc,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9H,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,6GAA6G;IAC7G,MAAM,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,WAAW,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D;AAKD;;;wFAGwF;AACxF,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAO/C;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACd;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAQrE;AAED;;;;0CAI0C;AAC1C,MAAM,MAAM,oBAAoB,GAAG,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;AAE/D,eAAO,MAAM,mBAAmB,EAAE,oBAiBjC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,0BAA0B,CAC/C,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,SAAS,EAAE,IAAI,CAAC,sBAAsB,EAAE,SAAS,GAAG,wBAAwB,GAAG,yBAAyB,CAAC,GACvG,OAAO,CAAC,kBAAkB,CAAC,CA4C7B;AA8BD,MAAM,WAAW,sBAAsB;IACtC,OAAO,CACN,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,oBAAoB,CAAC;QAAC,IAAI,EAAE,WAAW,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAChI,MAAM,CACL,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,oBAAoB,CAAC;QAAC,IAAI,EAAE,WAAW,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAChI,OAAO,CACN,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,WAAW,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACvI,8GAA8G;IAC9G,sBAAsB,IAAI,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAAC;IAC1D;;;;;OAKG;IACH,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;CAC3E;AAED;;;;;;GAMG;AACH,qBAAa,0BAA2B,YAAW,sBAAsB;IAEvE,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,WAAW;gBADX,SAAS,GAAE,gBAA2C,EACtD,WAAW,GAAE,oBAA0C;IAGnE,sBAAsB,IAAI,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC;IAIzD,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAI1E,OAAO,CACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,oBAAoB,CAAC;QAAC,IAAI,EAAE,WAAW,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAUzH,MAAM,CACX,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,oBAAoB,CAAC;QAAC,IAAI,EAAE,WAAW,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAUzH,OAAO,CACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,WAAW,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAkBtI"}

package/dist/doctor-format.js

@@ -0,0 +1,16 @@
+function F(z){return`${z.name} (${z.source}) [${z.scope}] ${z.extension}`}function J(z,G){if(G)return`${JSON.stringify(z)}
+`;let A=`${z.ok?"PASS":"FAIL"} — ${z.scanned} extension(s) scanned, ${z.conflicts.length} conflict(s)
+`;for(let q of z.conflicts){A+=`
+CONFLICT ${q.kind} "${q.name}" claimed by:
+`;for(let B of q.claimants)A+=`  - ${F(B)}
+`}for(let q of z.extensions){if(q.status==="ok")continue;A+=`
+${q.status.toUpperCase()} ${F({name:q.name,source:q.source,scope:q.scope,extension:q.extension})}${q.message?`: ${q.message}`:""}
+`}for(let q of z.serviceUnits)A+=`
+${q.severity.toUpperCase()} ${q.code} ${q.package} (${q.unitName}.service): ${q.message}
+`;for(let q of z.duplicateDependencies){let B=q.locations.map((E)=>`${E.version} (${E.path})`).join(", ");A+=`
+DUPLICATE_DEPENDENCY_VERSION ${q.name}: ${B}
+`}for(let q of z.moduleFreshness??[]){if(!q.stale)continue;A+=`
+STALE_MODULE_CACHE ${q.name}: the daemon loaded ${q.loadedVersion??"an unknown version"} at startup, but ${q.currentVersion??"a different version"} is now on disk -- restart the daemon (systemctl --user restart pi-packed.service) to pick it up.
+`}if(z.truncated)A+=`
+Output truncated: more enabled extensions exist than this run's bound.
+`;return A}export{J as formatDoctorReport};

package/dist/packages/installed.d.ts

@@ -0,0 +1,32 @@
+import type { InstalledPkg } from "./package.ts";
+export declare function splitNpmSource(spec: string): [name: string, version: string];
+/**
+ * True when a configured npm: source pins an exact version, e.g.
+ * "npm:@scope/pkg@1.2.3" vs. the floating "npm:@scope/pkg". `pi update`
+ * intentionally leaves pinned sources unchanged (see readInstalledPackages)
+ * but still exits 0 and prints "Updated <source>" either way -- callers
+ * must not treat that text as proof anything changed.
+ */
+export declare function isPinnedNpmSource(source: string): boolean;
+/** The bare npm package name for a configured npm: source, pinned or not.
+ * undefined for git:/https: sources -- there is no npm-registry name to read. */
+export declare function npmPackageName(source: string): string | undefined;
+/** Reads a single npm package's real on-disk resolved version, regardless of
+ * whether its configured source is pinned -- ground truth for detecting
+ * whether an update actually changed anything. undefined for non-npm
+ * sources or when node_modules has no matching package.json to read. */
+export declare function readResolvedVersion(piHome: string, source: string): string | undefined;
+export declare function readResolvedIntegrity(piHome: string, source: string): string | undefined;
+export declare function readPackageDeclarations(piHome: string): string[];
+export declare function readInstalledPackages(piHome: string): InstalledPkg[];
+/**
+ * Global scope alone is invisible to a project's own .pi/settings.json pin --
+ * confirmed live: a project pinned a stale major version of a since-split
+ * package, and nothing in packed's own drift detection ever saw it. Merges
+ * global and (when given) project-scoped declarations, tagging each so a
+ * name pinned differently in each scope is reported twice, not silently
+ * deduped into one.
+ */
+export declare function readInstalledPackagesAcrossScopes(piHome: string, projectRoot?: string): InstalledPkg[];
+export declare function defaultPiHome(): string;
+//# sourceMappingURL=installed.d.ts.map

package/dist/packages/installed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installed.d.ts","sourceRoot":"","sources":["../../service/src/packages/installed.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAI5E;AAoBD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAIzD;AAED;iFACiF;AACjF,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIjE;AAED;;;wEAGwE;AACxE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGtF;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAYxF;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAWhE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,CAYpE;AAED;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAKtG;AAED,wBAAgB,aAAa,IAAI,MAAM,CAItC"}