@anthara/pi-claude 0.0.0-stage → 0.1.0

package/dist/kernel/plugin-install/adopt-install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adopt-install.js","sourceRoot":"","sources":["../../../src/kernel/plugin-install/adopt-install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAwB,MAAM,cAAc,CAAC;AAUxE,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,OAAuB,EAAE,kBAAmC,UAAU;IAC/G,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAC/C,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,sBAAsB,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IACD,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IACxD,IAAI,CAAC;QACH,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;IAC7D,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IACD,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;AACnF,CAAC"}

package/dist/kernel/plugin-install/command-line-git.d.ts

@@ -0,0 +1,12 @@
+import type { GitClient } from './git-client.js';
+import { type Sha } from './sha.js';
+export declare class CommandLineGit implements GitClient {
+    resolveRef(url: string, ref: string): Promise<Sha>;
+    latestTag(url: string): Promise<string>;
+    defaultBranchSha(url: string): Promise<Sha>;
+    cloneAt(url: string, sha: Sha, dest: string): Promise<void>;
+    headSha(dir: string): Promise<Sha>;
+    trackedFiles(dir: string): Promise<string[]>;
+    isWorkTree(dir: string): Promise<boolean>;
+}
+export declare function runGit(args: readonly string[]): Promise<string>;

package/dist/kernel/plugin-install/command-line-git.js

@@ -0,0 +1,114 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { AntharaError } from '../../errors/anthara-error.js';
+import { CheckoutHasNoCommitsError, GitCommandError, GitNotInstalledError, RefRequiredError, RepositoryUnreachableError, UnknownRefError, } from './errors.js';
+import { looksLikeFullSha, toSha } from './sha.js';
+const execFileAsync = promisify(execFile);
+const MAX_OUTPUT_BYTES = 64 * 1024 * 1024;
+const TAG_REF_PREFIX = 'refs/tags/';
+const PEELED_SUFFIX = '^{}';
+const NO_SUCH_EXECUTABLE = 'ENOENT';
+const DEFAULT_BRANCH_REF = 'HEAD';
+export class CommandLineGit {
+    async resolveRef(url, ref) {
+        if (looksLikeFullSha(ref)) {
+            return toSha(ref);
+        }
+        const tag = (await listTags(url)).find(({ name }) => name === ref);
+        if (tag === undefined) {
+            throw new UnknownRefError(url, ref);
+        }
+        return tag.sha;
+    }
+    async latestTag(url) {
+        const [latest] = await listTags(url);
+        if (latest === undefined) {
+            throw new RefRequiredError(url);
+        }
+        return latest.name;
+    }
+    async defaultBranchSha(url) {
+        const listing = await orFail(runGit(['ls-remote', '--', url, DEFAULT_BRANCH_REF]), (reason) => new RepositoryUnreachableError(url, reason));
+        const [sha = ''] = listing.split('\t');
+        if (!looksLikeFullSha(sha)) {
+            throw new RepositoryUnreachableError(url, 'it has no default branch to pin to');
+        }
+        return toSha(sha);
+    }
+    async cloneAt(url, sha, dest) {
+        await orFail(runGit(['clone', '--quiet', '--no-checkout', '--', url, dest]), (reason) => new RepositoryUnreachableError(url, reason));
+        await orFail(runGit(['-C', dest, 'checkout', '--quiet', '--detach', sha]), () => new UnknownRefError(url, sha));
+    }
+    async headSha(dir) {
+        const output = await orFail(runGit(['-C', dir, 'rev-parse', '--verify', 'HEAD']), () => new CheckoutHasNoCommitsError(dir));
+        return toSha(output);
+    }
+    async trackedFiles(dir) {
+        const output = await runGit(['-C', dir, 'ls-files', '--cached', '--others', '--exclude-standard', '-z']);
+        return [...new Set(output.split('\0').filter((path) => path !== ''))];
+    }
+    async isWorkTree(dir) {
+        try {
+            return (await runGit(['-C', dir, 'rev-parse', '--is-inside-work-tree'])).trim() === 'true';
+        }
+        catch (error) {
+            if (error instanceof GitCommandError) {
+                return false;
+            }
+            throw error;
+        }
+    }
+}
+// versionsort.suffix makes v2.0.0-rc1 sort below v2.0.0; the sort is descending, so the newest release comes first
+async function listTags(url) {
+    const listing = await orFail(runGit(['-c', 'versionsort.suffix=-', 'ls-remote', '--tags', '--sort=-v:refname', '--', url]), (reason) => new RepositoryUnreachableError(url, reason));
+    return parseTagListing(listing);
+}
+// an annotated tag is listed twice: its own object, then the commit it peels to (the line ending in ^{})
+function parseTagListing(listing) {
+    const shaByName = new Map();
+    for (const { name, sha, peeled } of listing.split('\n').flatMap(parseTagLine)) {
+        if (peeled || !shaByName.has(name)) {
+            shaByName.set(name, sha);
+        }
+    }
+    return [...shaByName].map(([name, sha]) => ({ name, sha }));
+}
+function parseTagLine(line) {
+    const [sha = '', ref = ''] = line.split('\t');
+    if (!ref.startsWith(TAG_REF_PREFIX)) {
+        return [];
+    }
+    const peeled = ref.endsWith(PEELED_SUFFIX);
+    const nameEnd = peeled ? ref.length - PEELED_SUFFIX.length : ref.length;
+    return [{ name: ref.slice(TAG_REF_PREFIX.length, nameEnd), sha: toSha(sha), peeled }];
+}
+// git comes from PATH on purpose: the developer's own git brings the credential helpers that private plugin repositories need
+export async function runGit(args) {
+    try {
+        const { stdout } = await execFileAsync('git', [...args], { maxBuffer: MAX_OUTPUT_BYTES, encoding: 'utf8' });
+        return stdout;
+    }
+    catch (error) {
+        throw describeFailure(error);
+    }
+}
+function describeFailure(failure) {
+    if (failure.code === NO_SUCH_EXECUTABLE) {
+        return new GitNotInstalledError(failure);
+    }
+    const firstLine = (failure.stderr ?? failure.message).trim().split('\n')[0] ?? failure.message;
+    return new GitCommandError(firstLine, { cause: failure });
+}
+async function orFail(attempt, toError) {
+    try {
+        return await attempt;
+    }
+    catch (error) {
+        if (error instanceof GitCommandError) {
+            throw toError(error.reason);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=command-line-git.js.map

package/dist/kernel/plugin-install/command-line-git.js.map

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

package/dist/kernel/plugin-install/dependencies/dependency-graph.d.ts

@@ -0,0 +1,8 @@
+import type { Dependency } from './dependency-parsing.js';
+import { type PluginId } from './plugin-id.js';
+export interface DependencyInfo {
+    readonly version?: string;
+    readonly dependencies: readonly Dependency[];
+}
+export type EntryLookup = (id: PluginId) => DependencyInfo | 'absent';
+export declare function resolveDependencySet(root: PluginId, rootInfo: DependencyInfo, lookup: EntryLookup, allowedMarketplaces: readonly string[]): readonly PluginId[];

package/dist/kernel/plugin-install/dependencies/dependency-graph.js

@@ -0,0 +1,49 @@
+import { CrossMarketplaceDependencyError, DependencyCycleError, DependencyVersionMismatchError, MissingDependencyError, UnsupportedVersionRangeError, } from './errors.js';
+import { samePlugin } from './plugin-id.js';
+const EXACT_VERSION = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/;
+export function resolveDependencySet(root, rootInfo, lookup, allowedMarketplaces) {
+    const walk = { lookup, rootMarketplace: root.marketplace, allowedMarketplaces, order: [] };
+    visit(walk, root, rootInfo, []);
+    return walk.order;
+}
+function visit(walk, id, info, path) {
+    if (path.some((ancestor) => samePlugin(ancestor, id))) {
+        throw new DependencyCycleError([...path, id]);
+    }
+    if (walk.order.some((done) => samePlugin(done, id))) {
+        return;
+    }
+    for (const dependency of info.dependencies) {
+        const [dependencyId, dependencyInfo] = resolveDependency(walk, id, dependency);
+        visit(walk, dependencyId, dependencyInfo, [...path, id]);
+    }
+    walk.order.push(id);
+}
+function resolveDependency(walk, requiredBy, dependency) {
+    const id = { name: dependency.name, marketplace: dependency.marketplace ?? requiredBy.marketplace };
+    assertMarketplaceAllowed(walk, id, requiredBy);
+    const info = walk.lookup(id);
+    if (info === 'absent') {
+        throw new MissingDependencyError(id, requiredBy);
+    }
+    assertVersionMatches(id, dependency.version, info, requiredBy);
+    return [id, info];
+}
+function assertMarketplaceAllowed(walk, id, requiredBy) {
+    const crossesMarketplace = id.marketplace !== walk.rootMarketplace;
+    if (crossesMarketplace && !walk.allowedMarketplaces.includes(id.marketplace)) {
+        throw new CrossMarketplaceDependencyError(id, requiredBy, walk.rootMarketplace);
+    }
+}
+function assertVersionMatches(id, required, info, requiredBy) {
+    if (required === undefined) {
+        return;
+    }
+    if (!EXACT_VERSION.test(required)) {
+        throw new UnsupportedVersionRangeError(id, required, requiredBy);
+    }
+    if (info.version !== required) {
+        throw new DependencyVersionMismatchError(id, required, requiredBy, info.version);
+    }
+}
+//# sourceMappingURL=dependency-graph.js.map

package/dist/kernel/plugin-install/dependencies/dependency-graph.js.map

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

package/dist/kernel/plugin-install/dependencies/dependency-parsing.d.ts

@@ -0,0 +1,6 @@
+export interface Dependency {
+    readonly name: string;
+    readonly marketplace?: string;
+    readonly version?: string;
+}
+export declare function parseDependencies(raw: unknown, owner: string): Dependency[];

package/dist/kernel/plugin-install/dependencies/dependency-parsing.js

@@ -0,0 +1,44 @@
+import { isJsonObject } from '../../private-files/private-files.js';
+import { isPluginName } from '../plugin-manifest.js';
+import { InvalidDependencyError } from './errors.js';
+const MARKETPLACE_SEPARATOR = '@';
+export function parseDependencies(raw, owner) {
+    if (raw === undefined) {
+        return [];
+    }
+    if (!Array.isArray(raw)) {
+        throw new InvalidDependencyError(owner, 'dependencies must be a list');
+    }
+    return raw.map((item) => parseDependency(item, owner));
+}
+function parseDependency(item, owner) {
+    if (typeof item === 'string') {
+        return dependencyNamed(item, owner);
+    }
+    if (isJsonObject(item) && typeof item.name === 'string') {
+        return {
+            ...dependencyNamed(item.name, owner),
+            ...optionalText(item.marketplace, 'marketplace', owner),
+            ...optionalText(item.version, 'version', owner),
+        };
+    }
+    throw new InvalidDependencyError(owner, 'a dependency is a name, name@marketplace or { name, marketplace, version }');
+}
+function dependencyNamed(text, owner) {
+    const parts = text.split(MARKETPLACE_SEPARATOR);
+    const [name = '', marketplace] = parts;
+    if (parts.length > 2 || !parts.every(isPluginName)) {
+        throw new InvalidDependencyError(owner, `"${text}" is not a plugin name or name@marketplace`);
+    }
+    return marketplace === undefined ? { name } : { name, marketplace };
+}
+function optionalText(value, key, owner) {
+    if (value === undefined) {
+        return {};
+    }
+    if (typeof value !== 'string' || value === '') {
+        throw new InvalidDependencyError(owner, `${key} must be text`);
+    }
+    return { [key]: value };
+}
+//# sourceMappingURL=dependency-parsing.js.map

package/dist/kernel/plugin-install/dependencies/dependency-parsing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-parsing.js","sourceRoot":"","sources":["../../../../src/kernel/plugin-install/dependencies/dependency-parsing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAQrD,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAElC,MAAM,UAAU,iBAAiB,CAAC,GAAY,EAAE,KAAa;IAC3D,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,sBAAsB,CAAC,KAAK,EAAE,6BAA6B,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAa,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,eAAe,CAAC,IAAa,EAAE,KAAa;IACnD,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACxD,OAAO;YACL,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC;YACpC,GAAG,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,KAAK,CAAC;YACvD,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC;SAChD,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,sBAAsB,CAAC,KAAK,EAAE,4EAA4E,CAAC,CAAC;AACxH,CAAC;AAED,SAAS,eAAe,CAAC,IAAY,EAAE,KAAa;IAClD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAChD,MAAM,CAAC,IAAI,GAAG,EAAE,EAAE,WAAW,CAAC,GAAG,KAAK,CAAC;IACvC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,sBAAsB,CAAC,KAAK,EAAE,IAAI,IAAI,4CAA4C,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AACtE,CAAC;AAED,SAAS,YAAY,CAAC,KAAc,EAAE,GAA8B,EAAE,KAAa;IACjF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QAC9C,MAAM,IAAI,sBAAsB,CAAC,KAAK,EAAE,GAAG,GAAG,eAAe,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC"}

package/dist/kernel/plugin-install/dependencies/errors.d.ts

@@ -0,0 +1,23 @@
+import { AntharaError } from '../../../errors/anthara-error.js';
+import { type PluginId } from './plugin-id.js';
+export declare class InvalidDependencyError extends AntharaError {
+    constructor(owner: string, reason: string);
+}
+export declare class MissingDependencyError extends AntharaError {
+    constructor(dependency: PluginId, requiredBy: PluginId);
+}
+export declare class DependencyCycleError extends AntharaError {
+    constructor(path: readonly PluginId[]);
+}
+export declare class UnsupportedVersionRangeError extends AntharaError {
+    constructor(dependency: PluginId, range: string, requiredBy: PluginId);
+}
+export declare class DependencyVersionMismatchError extends AntharaError {
+    constructor(dependency: PluginId, required: string, requiredBy: PluginId, actual: string | undefined);
+}
+export declare class CrossMarketplaceDependencyError extends AntharaError {
+    constructor(dependency: PluginId, requiredBy: PluginId, rootMarketplace: string);
+}
+export declare class UndeclaredDependencyError extends AntharaError {
+    constructor(plugin: PluginId, dependency: string);
+}

package/dist/kernel/plugin-install/dependencies/errors.js

@@ -0,0 +1,44 @@
+import { AntharaError } from '../../../errors/anthara-error.js';
+import { pluginIdText } from './plugin-id.js';
+export class InvalidDependencyError extends AntharaError {
+    constructor(owner, reason) {
+        super(`A dependency of ${owner} is invalid: ${reason}.`);
+    }
+}
+export class MissingDependencyError extends AntharaError {
+    constructor(dependency, requiredBy) {
+        super(`${pluginIdText(requiredBy)} depends on ${pluginIdText(dependency)}, which is not in the marketplaces that were added. ` +
+            'Nothing was installed.');
+    }
+}
+export class DependencyCycleError extends AntharaError {
+    constructor(path) {
+        super(`The dependencies form a cycle: ${path.map(pluginIdText).join(' -> ')}. Nothing was installed.`);
+    }
+}
+export class UnsupportedVersionRangeError extends AntharaError {
+    constructor(dependency, range, requiredBy) {
+        super(`${pluginIdText(requiredBy)} asks for ${pluginIdText(dependency)} at "${range}", which is a version range. ` +
+            'Only an exact version such as 1.2.3 can be honoured. Nothing was installed.');
+    }
+}
+export class DependencyVersionMismatchError extends AntharaError {
+    constructor(dependency, required, requiredBy, actual) {
+        const found = actual === undefined ? 'declares no version' : `is at ${actual}`;
+        super(`${pluginIdText(requiredBy)} needs ${pluginIdText(dependency)} at ${required}, but its marketplace entry ${found}. ` +
+            'Nothing was installed.');
+    }
+}
+export class CrossMarketplaceDependencyError extends AntharaError {
+    constructor(dependency, requiredBy, rootMarketplace) {
+        super(`${pluginIdText(requiredBy)} depends on ${pluginIdText(dependency)} from another marketplace, and ${rootMarketplace} ` +
+            `does not list "${dependency.marketplace}" in allowCrossMarketplaceDependenciesOn. Nothing was installed.`);
+    }
+}
+export class UndeclaredDependencyError extends AntharaError {
+    constructor(plugin, dependency) {
+        super(`${pluginIdText(plugin)} declares the dependency "${dependency}" in its plugin.json, but its marketplace entry does not, ` +
+            'so it was not resolved. Nothing was installed.');
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/kernel/plugin-install/dependencies/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/kernel/plugin-install/dependencies/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,YAAY,EAAiB,MAAM,gBAAgB,CAAC;AAE7D,MAAM,OAAO,sBAAuB,SAAQ,YAAY;IACtD,YAAY,KAAa,EAAE,MAAc;QACvC,KAAK,CAAC,mBAAmB,KAAK,gBAAgB,MAAM,GAAG,CAAC,CAAC;IAC3D,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,YAAY;IACtD,YAAY,UAAoB,EAAE,UAAoB;QACpD,KAAK,CACH,GAAG,YAAY,CAAC,UAAU,CAAC,eAAe,YAAY,CAAC,UAAU,CAAC,sDAAsD;YACtH,wBAAwB,CAC3B,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,YAAY;IACpD,YAAY,IAAyB;QACnC,KAAK,CAAC,kCAAkC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC;IACzG,CAAC;CACF;AAED,MAAM,OAAO,4BAA6B,SAAQ,YAAY;IAC5D,YAAY,UAAoB,EAAE,KAAa,EAAE,UAAoB;QACnE,KAAK,CACH,GAAG,YAAY,CAAC,UAAU,CAAC,aAAa,YAAY,CAAC,UAAU,CAAC,QAAQ,KAAK,+BAA+B;YAC1G,6EAA6E,CAChF,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,8BAA+B,SAAQ,YAAY;IAC9D,YAAY,UAAoB,EAAE,QAAgB,EAAE,UAAoB,EAAE,MAA0B;QAClG,MAAM,KAAK,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC;QAC/E,KAAK,CACH,GAAG,YAAY,CAAC,UAAU,CAAC,UAAU,YAAY,CAAC,UAAU,CAAC,OAAO,QAAQ,+BAA+B,KAAK,IAAI;YAClH,wBAAwB,CAC3B,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,+BAAgC,SAAQ,YAAY;IAC/D,YAAY,UAAoB,EAAE,UAAoB,EAAE,eAAuB;QAC7E,KAAK,CACH,GAAG,YAAY,CAAC,UAAU,CAAC,eAAe,YAAY,CAAC,UAAU,CAAC,kCAAkC,eAAe,GAAG;YACpH,kBAAkB,UAAU,CAAC,WAAW,kEAAkE,CAC7G,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,YAAY;IACzD,YAAY,MAAgB,EAAE,UAAkB;QAC9C,KAAK,CACH,GAAG,YAAY,CAAC,MAAM,CAAC,6BAA6B,UAAU,4DAA4D;YACxH,gDAAgD,CACnD,CAAC;IACJ,CAAC;CACF"}

package/dist/kernel/plugin-install/dependencies/plugin-id.d.ts

@@ -0,0 +1,13 @@
+export interface PluginId {
+    readonly name: string;
+    readonly marketplace: string;
+}
+export type PluginIdParse = {
+    readonly kind: 'id';
+    readonly id: PluginId;
+} | {
+    readonly kind: 'malformed';
+};
+export declare const pluginIdText: ({ name, marketplace }: PluginId) => string;
+export declare const samePlugin: (a: PluginId, b: PluginId) => boolean;
+export declare function parsePluginId(text: string): PluginIdParse;

package/dist/kernel/plugin-install/dependencies/plugin-id.js

@@ -0,0 +1,10 @@
+import { isPluginName } from '../plugin-manifest.js';
+const MARKETPLACE_SEPARATOR = '@';
+export const pluginIdText = ({ name, marketplace }) => `${name}${MARKETPLACE_SEPARATOR}${marketplace}`;
+export const samePlugin = (a, b) => a.name === b.name && a.marketplace === b.marketplace;
+export function parsePluginId(text) {
+    const parts = text.split(MARKETPLACE_SEPARATOR);
+    const [name = '', marketplace = ''] = parts;
+    return parts.length === 2 && parts.every(isPluginName) ? { kind: 'id', id: { name, marketplace } } : { kind: 'malformed' };
+}
+//# sourceMappingURL=plugin-id.js.map

package/dist/kernel/plugin-install/dependencies/plugin-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-id.js","sourceRoot":"","sources":["../../../../src/kernel/plugin-install/dependencies/plugin-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AASrD,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAElC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,EAAE,IAAI,EAAE,WAAW,EAAY,EAAU,EAAE,CAAC,GAAG,IAAI,GAAG,qBAAqB,GAAG,WAAW,EAAE,CAAC;AAEzH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAW,EAAE,CAAW,EAAW,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,WAAW,CAAC;AAEtH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAChD,MAAM,CAAC,IAAI,GAAG,EAAE,EAAE,WAAW,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC;IAC5C,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AAC7H,CAAC"}

package/dist/kernel/plugin-install/errors.d.ts

@@ -0,0 +1,62 @@
+import { AntharaError } from '../../errors/anthara-error.js';
+import { NextStepError } from '../subcommands/errors.js';
+export declare class UnknownPluginSourceError extends AntharaError {
+    constructor(raw: string);
+}
+export declare class CredentialsInSourceUrlError extends AntharaError {
+    constructor();
+}
+export declare class InvalidCommitShaError extends AntharaError {
+    constructor(text: string);
+}
+export declare class GitNotInstalledError extends AntharaError {
+    constructor(cause: Error);
+}
+export declare class GitCommandError extends AntharaError {
+    readonly reason: string;
+    constructor(reason: string, options?: ErrorOptions);
+}
+export declare class RepositoryUnreachableError extends AntharaError {
+    constructor(url: string, reason: string);
+}
+export declare class UnknownRefError extends AntharaError {
+    constructor(url: string, ref: string);
+}
+export declare class RefRequiredError extends AntharaError {
+    constructor(url: string);
+}
+export declare class CheckoutHasNoCommitsError extends AntharaError {
+    constructor(path: string);
+}
+export declare class NotAGitWorkTreeError extends AntharaError {
+    constructor(path: string);
+}
+export declare class NotAClaudePluginError extends AntharaError {
+    constructor(manifestPath: string);
+}
+export declare class InvalidPluginManifestError extends AntharaError {
+    constructor(manifestPath: string, reason: string);
+}
+export declare class InvalidPluginNameError extends AntharaError {
+    constructor(name: string);
+}
+export declare class PluginNotInstalledError extends NextStepError {
+    constructor(name: string);
+    nextStep(invocation: string): string;
+}
+export declare class PluginAlreadyInstalledError extends NextStepError {
+    #private;
+    constructor(name: string);
+    nextStep(invocation: string): string;
+}
+export declare class PluginNameMismatchError extends AntharaError {
+    constructor(installedName: string, foundName: string);
+}
+export declare class LocalPluginHasNoRefError extends NextStepError {
+    #private;
+    constructor(name: string);
+    nextStep(invocation: string): string;
+}
+export declare class ClaudeCodeInstallReadOnlyError extends AntharaError {
+    constructor(name: string);
+}

package/dist/kernel/plugin-install/errors.js

@@ -0,0 +1,116 @@
+import { AntharaError } from '../../errors/anthara-error.js';
+import { NextStepError } from '../subcommands/errors.js';
+const ACCEPTED_SOURCES = 'Use github:<owner>/<repo>[@<tag|sha>], an https or ssh git URL[@<tag|sha>], or the path of a local git checkout.';
+export class UnknownPluginSourceError extends AntharaError {
+    constructor(raw) {
+        super(`"${raw}" is not a plugin source. ${ACCEPTED_SOURCES}`);
+    }
+}
+export class CredentialsInSourceUrlError extends AntharaError {
+    constructor() {
+        super('A plugin source URL may not carry a password or, over https, a user name: it would be recorded and listed. ' +
+            "Nothing was installed; let git's credential helper supply them.");
+    }
+}
+export class InvalidCommitShaError extends AntharaError {
+    constructor(text) {
+        super(`"${text}" is not a full 40-character commit SHA.`);
+    }
+}
+export class GitNotInstalledError extends AntharaError {
+    constructor(cause) {
+        super('Installing plugins needs git on your PATH, and git could not be run.', { cause });
+    }
+}
+export class GitCommandError extends AntharaError {
+    reason;
+    constructor(reason, options) {
+        super(`git failed: ${reason}`, options);
+        this.reason = reason;
+    }
+}
+export class RepositoryUnreachableError extends AntharaError {
+    constructor(url, reason) {
+        super(`Cannot reach the repository ${url}: ${reason}`);
+    }
+}
+export class UnknownRefError extends AntharaError {
+    constructor(url, ref) {
+        super(`"${ref}" is neither a tag of ${url} nor a full commit SHA that it contains. ` +
+            'Plugins are pinned to tags or commits and never follow a branch.');
+    }
+}
+export class RefRequiredError extends AntharaError {
+    constructor(url) {
+        super(`${url} has no tags, so there is nothing to pin to. Give an explicit ref: <source>@<tag|sha>.`);
+    }
+}
+export class CheckoutHasNoCommitsError extends AntharaError {
+    constructor(path) {
+        super(`${path} has no commits yet, so there is no commit SHA to record. Commit once, then add it again.`);
+    }
+}
+export class NotAGitWorkTreeError extends AntharaError {
+    constructor(path) {
+        super(`${path} is not a git work tree. Pass the path of a local git checkout of the plugin.`);
+    }
+}
+export class NotAClaudePluginError extends AntharaError {
+    constructor(manifestPath) {
+        super(`The source has no ${manifestPath} and none of a plugin's standard parts (skills/, commands/, agents/, ` +
+            'hooks/hooks.json, .mcp.json, output-styles/, bin/ or a SKILL.md), so it is not a Claude Code plugin.');
+    }
+}
+export class InvalidPluginManifestError extends AntharaError {
+    constructor(manifestPath, reason) {
+        super(`The plugin's ${manifestPath} is invalid: ${reason}.`);
+    }
+}
+export class InvalidPluginNameError extends AntharaError {
+    constructor(name) {
+        super(`"${name}" is not a valid plugin name: use letters, digits, - and _. ` +
+            'A plugin without .claude-plugin/plugin.json takes the name of its folder.');
+    }
+}
+export class PluginNotInstalledError extends NextStepError {
+    constructor(name) {
+        super(`No plugin named "${name}" is installed.`);
+    }
+    nextStep(invocation) {
+        return `Run \`${invocation} list\` to see what is.`;
+    }
+}
+export class PluginAlreadyInstalledError extends NextStepError {
+    #name;
+    constructor(name) {
+        super(`The plugin "${name}" is already installed.`);
+        this.#name = name;
+    }
+    nextStep(invocation) {
+        return (`Run \`${invocation} update ${this.#name}@<tag|sha>\` to change its ref, ` +
+            `or \`${invocation} remove ${this.#name}\` first.`);
+    }
+}
+export class PluginNameMismatchError extends AntharaError {
+    constructor(installedName, foundName) {
+        super(`The plugin installed as "${installedName}" cannot be updated from a source that is named "${foundName}". ` +
+            `Remove "${installedName}" and add the other plugin instead.`);
+    }
+}
+export class LocalPluginHasNoRefError extends NextStepError {
+    #name;
+    constructor(name) {
+        super(`"${name}" was installed from a local checkout, which has no ref.`);
+        this.#name = name;
+    }
+    nextStep(invocation) {
+        return `Run \`${invocation} update ${this.#name}\` to re-copy it.`;
+    }
+}
+export class ClaudeCodeInstallReadOnlyError extends AntharaError {
+    constructor(name) {
+        super(`"${name}" was installed by Claude Code, so it is read-only here. ` +
+            'Use Claude Code to update, remove, enable or disable it.');
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/kernel/plugin-install/errors.js.map

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

package/dist/kernel/plugin-install/git-client.d.ts

@@ -0,0 +1,10 @@
+import type { Sha } from './sha.js';
+export interface GitClient {
+    resolveRef(url: string, ref: string): Promise<Sha>;
+    latestTag(url: string): Promise<string>;
+    defaultBranchSha(url: string): Promise<Sha>;
+    cloneAt(url: string, sha: Sha, dest: string): Promise<void>;
+    headSha(dir: string): Promise<Sha>;
+    trackedFiles(dir: string): Promise<string[]>;
+    isWorkTree(dir: string): Promise<boolean>;
+}

package/dist/kernel/plugin-install/git-client.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=git-client.js.map

package/dist/kernel/plugin-install/git-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-client.js","sourceRoot":"","sources":["../../../src/kernel/plugin-install/git-client.ts"],"names":[],"mappings":""}

package/dist/kernel/plugin-install/install-layout.d.ts

@@ -0,0 +1,8 @@
+export declare const installRoot: (agentDir: string) => string;
+export declare const pluginDir: (root: string, name: string) => string;
+export declare const versionDir: (root: string, name: string, sha: string) => string;
+export declare const stagingDir: (root: string) => string;
+export declare const indexPath: (root: string) => string;
+export declare const marketplaceIndexPath: (root: string) => string;
+export declare const marketplaceDir: (root: string, name: string) => string;
+export declare const dataDir: (agentDir: string, name: string) => string;

package/dist/kernel/plugin-install/install-layout.js

@@ -0,0 +1,13 @@
+import { join } from 'node:path';
+const PACKAGE_DIRECTORY = 'pi-claude';
+const INSTALLS_DIRECTORY = 'plugins';
+const DATA_DIRECTORY = 'plugin-data';
+export const installRoot = (agentDir) => join(agentDir, PACKAGE_DIRECTORY, INSTALLS_DIRECTORY);
+export const pluginDir = (root, name) => join(root, name);
+export const versionDir = (root, name, sha) => join(pluginDir(root, name), sha);
+export const stagingDir = (root) => join(root, '.staging');
+export const indexPath = (root) => join(root, 'index.json');
+export const marketplaceIndexPath = (root) => join(root, 'marketplaces.json');
+export const marketplaceDir = (root, name) => join(root, '.marketplaces', name);
+export const dataDir = (agentDir, name) => join(agentDir, PACKAGE_DIRECTORY, DATA_DIRECTORY, name);
+//# sourceMappingURL=install-layout.js.map

package/dist/kernel/plugin-install/install-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-layout.js","sourceRoot":"","sources":["../../../src/kernel/plugin-install/install-layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,iBAAiB,GAAG,WAAW,CAAC;AACtC,MAAM,kBAAkB,GAAG,SAAS,CAAC;AACrC,MAAM,cAAc,GAAG,aAAa,CAAC;AAErC,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,QAAgB,EAAU,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,iBAAiB,EAAE,kBAAkB,CAAC,CAAC;AAE/G,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAElF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,IAAY,EAAE,GAAW,EAAU,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;AAEhH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AAE3E,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;AAE5E,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;AAE9F,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,CAAC,CAAC;AAExG,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,QAAgB,EAAE,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,iBAAiB,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC"}

package/dist/kernel/plugin-install/install-record.d.ts

@@ -0,0 +1,23 @@
+import type { OwnIndexEntry } from './own-install-index.js';
+import type { Sha } from './sha.js';
+interface GitInstalledSource {
+    readonly kind: 'git';
+    readonly url: string;
+    readonly ref: string;
+}
+interface LocalInstalledSource {
+    readonly kind: 'local';
+    readonly path: string;
+}
+export type InstalledSource = GitInstalledSource | LocalInstalledSource;
+export interface InstallRecord {
+    readonly name: string;
+    readonly source: InstalledSource;
+    readonly sha: Sha;
+    readonly installPath: string;
+    readonly enabled: boolean;
+    readonly marketplace?: string;
+}
+export declare function recordOf(root: string, name: string, entry: OwnIndexEntry): InstallRecord;
+export declare function installedSourceOf(source: unknown): InstalledSource[];
+export {};