opkg 0.9.0 → 0.9.2

package/packages/core/dist/core/view/view-pipeline.d.ts

@@ -0,0 +1,71 @@
+/**
+ * View Pipeline
+ *
+ * Core logic for resolving and viewing package details.
+ * Resolves package contents (metadata, resources, dependencies) — not workspace
+ * install state. Display is handled by the CLI command layer.
+ */
+import { type ListPackageReport } from '../list/list-pipeline.js';
+import { type ViewMetadataEntry } from '../list/list-printers.js';
+import { type RemoteListResult } from '../list/remote-list-resolver.js';
+import type { ExecutionContext } from '../../types/execution-context.js';
+import type { HeaderInfo } from '../list/scope-data-collector.js';
+export interface LocalPackageResult {
+    report: ListPackageReport;
+    headerInfo: HeaderInfo;
+    metadata: ViewMetadataEntry[];
+}
+export interface ViewResult {
+    kind: 'local-package' | 'remote' | 'not-found';
+}
+export interface LocalPackageViewResult extends ViewResult {
+    kind: 'local-package';
+    localResult: LocalPackageResult;
+}
+export interface RemoteViewResult extends ViewResult {
+    kind: 'remote';
+    remoteResult: RemoteListResult;
+}
+export interface NotFoundViewResult extends ViewResult {
+    kind: 'not-found';
+}
+export type ResolvedViewResult = LocalPackageViewResult | RemoteViewResult | NotFoundViewResult;
+export interface ViewPipelineOptions {
+    scope?: 'project' | 'global';
+    files?: boolean;
+    remote?: boolean;
+    profile?: string;
+    apiKey?: string;
+    cwd?: string;
+}
+/**
+ * Resolve a package by name from local sources (workspace, global, registry).
+ * Returns a LocalPackageResult with all data needed for display, or null if not found.
+ */
+export declare function resolveLocalPackage(packageName: string, cwd: string, options: {
+    showProject: boolean;
+    showGlobal: boolean;
+    searchRegistry: boolean;
+}): Promise<LocalPackageResult | null>;
+/**
+ * Attempt remote resolution for a package name.
+ */
+export declare function resolveRemoteForPackage(packageName: string, execContext: ExecutionContext, options: {
+    profile?: string;
+    apiKey?: string;
+}): Promise<RemoteListResult | null>;
+/**
+ * Resolve a package through the multi-tier fallback chain:
+ *   Tier 1: Workspace index lookup → scan package source directory
+ *   Tier 1.5: Workspace root package
+ *   Tier 2: Local packages directory (via resolvePackageByName)
+ *   Tier 3: Remote registry/git
+ *
+ * All tiers resolve the package's own contents (metadata, resources, deps),
+ * not the workspace install state.
+ */
+export declare function resolvePackageView(packageName: string, options: ViewPipelineOptions, createContext: (opts: {
+    global: boolean;
+    cwd?: string;
+}) => Promise<ExecutionContext>): Promise<ResolvedViewResult>;
+//# sourceMappingURL=view-pipeline.d.ts.map

package/packages/core/dist/core/view/view-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-pipeline.d.ts","sourceRoot":"","sources":["../../../src/core/view/view-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,OAAO,EAAiD,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACjH,OAAO,EAA+B,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG/F,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAC3F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAIzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAMlE,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,eAAe,GAAG,QAAQ,GAAG,WAAW,CAAC;CAChD;AAED,MAAM,WAAW,sBAAuB,SAAQ,UAAU;IACxD,IAAI,EAAE,eAAe,CAAC;IACtB,WAAW,EAAE,kBAAkB,CAAC;CACjC;AAED,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,IAAI,EAAE,QAAQ,CAAC;IACf,YAAY,EAAE,gBAAgB,CAAC;CAChC;AAED,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IACpD,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,MAAM,kBAAkB,GAC1B,sBAAsB,GACtB,gBAAgB,GAChB,kBAAkB,CAAC;AAEvB,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAqHD;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;IAAE,WAAW,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,cAAc,EAAE,OAAO,CAAA;CAAE,GAC9E,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAepC;AA4CD;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,gBAAgB,EAC7B,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAclC;AAMD;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,mBAAmB,EAC5B,aAAa,EAAE,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,gBAAgB,CAAC,GACpF,OAAO,CAAC,kBAAkB,CAAC,CAyE7B"}

package/packages/core/dist/core/view/view-pipeline.js

@@ -0,0 +1,267 @@
+/**
+ * View Pipeline
+ *
+ * Core logic for resolving and viewing package details.
+ * Resolves package contents (metadata, resources, dependencies) — not workspace
+ * install state. Display is handled by the CLI command layer.
+ */
+import { join } from 'path';
+import { resolvePackageByName } from '../package-name-resolution.js';
+import { parsePackageYml } from '../../utils/package-yml.js';
+import { exists } from '../../utils/fs.js';
+import { detectEntityType } from '../../utils/entity-detector.js';
+import { formatPathForDisplay } from '../../utils/formatters.js';
+import { logger } from '../../utils/logger.js';
+import { collectFiles } from '../list/remote-list-resolver.js';
+import { groupFilesIntoResources } from '../list/list-pipeline.js';
+import { extractMetadataFromManifest } from '../list/list-printers.js';
+import { resolveDeclaredPath } from '../../utils/path-resolution.js';
+import { classifyInput } from '../install/preprocessing/index.js';
+import { resolveRemoteList } from '../list/remote-list-resolver.js';
+import { getLocalOpenPackageDir, getLocalPackageYmlPath } from '../../utils/paths.js';
+import { arePackageNamesEquivalent } from '../../utils/package-name.js';
+import { readWorkspaceIndex } from '../../utils/workspace-index-yml.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Build a LocalPackageResult from a resolved package directory.
+ * Shared by Tier 1 (workspace index) and Tier 2 (resolvePackageByName).
+ */
+async function buildLocalPackageResult(packageName, packageDir, version) {
+    let name = packageName;
+    let resolvedVersion = version;
+    let dependencies;
+    let metadata = [];
+    const manifestPath = join(packageDir, 'openpackage.yml');
+    if (await exists(manifestPath)) {
+        try {
+            const manifest = await parsePackageYml(manifestPath);
+            name = manifest.name || packageName;
+            resolvedVersion = manifest.version || resolvedVersion;
+            metadata = extractMetadataFromManifest(manifest);
+            const allDeps = [
+                ...(manifest.dependencies || []),
+                ...(manifest['dev-dependencies'] || [])
+            ];
+            dependencies = allDeps.map(dep => dep.name);
+        }
+        catch (error) {
+            logger.debug(`Failed to parse manifest at ${manifestPath}: ${error}`);
+        }
+    }
+    if (metadata.length === 0)
+        metadata = extractMetadataFromManifest({ name, version: resolvedVersion });
+    const files = await collectFiles(packageDir, packageDir);
+    const fileList = files.map(f => ({
+        source: f,
+        target: join(packageDir, f),
+        exists: true
+    }));
+    const resourceGroups = fileList.length > 0 ? groupFilesIntoResources(fileList) : undefined;
+    const headerType = await detectEntityType(packageDir);
+    return {
+        report: {
+            name,
+            version: resolvedVersion,
+            path: packageDir,
+            state: 'synced',
+            totalFiles: fileList.length,
+            existingFiles: fileList.length,
+            fileList,
+            resourceGroups,
+            dependencies
+        },
+        headerInfo: {
+            name,
+            version: resolvedVersion !== '0.0.0' ? resolvedVersion : undefined,
+            path: formatPathForDisplay(packageDir),
+            type: headerType
+        },
+        metadata
+    };
+}
+// ---------------------------------------------------------------------------
+// Pipeline: resolve from workspace index (tier 1)
+// ---------------------------------------------------------------------------
+/**
+ * Look up the package in the workspace index to locate its source directory,
+ * then scan its contents. This answers "what does this package contain?"
+ * rather than "what is installed from it?".
+ */
+async function resolveFromWorkspaceIndex(packageName, targetDir) {
+    const { index } = await readWorkspaceIndex(targetDir);
+    const packages = index.packages || {};
+    // Find the package in the workspace index (exact or equivalent name match)
+    let entryKey;
+    if (packages[packageName]) {
+        entryKey = packageName;
+    }
+    else {
+        for (const key of Object.keys(packages)) {
+            if (arePackageNamesEquivalent(key, packageName)) {
+                entryKey = key;
+                break;
+            }
+        }
+    }
+    if (!entryKey)
+        return null;
+    const entry = packages[entryKey];
+    const resolved = resolveDeclaredPath(entry.path, targetDir);
+    const packageDir = resolved.absolute;
+    if (!(await exists(packageDir))) {
+        logger.debug(`Workspace index points to '${packageDir}' but it does not exist`);
+        return null;
+    }
+    return buildLocalPackageResult(packageName, packageDir, entry.version);
+}
+// ---------------------------------------------------------------------------
+// Pipeline: resolve local package (tier 2)
+// ---------------------------------------------------------------------------
+/**
+ * Resolve a package by name from local sources (workspace, global, registry).
+ * Returns a LocalPackageResult with all data needed for display, or null if not found.
+ */
+export async function resolveLocalPackage(packageName, cwd, options) {
+    const resolution = await resolvePackageByName({
+        cwd,
+        packageName,
+        checkCwd: false,
+        searchWorkspace: options.showProject,
+        searchGlobal: options.showGlobal,
+        searchRegistry: options.searchRegistry
+    });
+    if (!resolution.found || !resolution.path) {
+        return null;
+    }
+    return buildLocalPackageResult(packageName, resolution.path, resolution.version);
+}
+// ---------------------------------------------------------------------------
+// Pipeline: resolve workspace root package
+// ---------------------------------------------------------------------------
+/**
+ * Check if the requested package name matches the workspace root package
+ * (.openpackage/openpackage.yml) and resolve it directly if so.
+ *
+ * This handles the case where `opkg view` is run from a workspace directory
+ * and the auto-detected (or explicitly provided) name is the workspace itself,
+ * not an installed dependency.
+ */
+async function resolveWorkspaceRootPackage(packageName, cwd) {
+    const manifestPath = getLocalPackageYmlPath(cwd);
+    if (!(await exists(manifestPath))) {
+        return null;
+    }
+    let manifest;
+    try {
+        manifest = await parsePackageYml(manifestPath);
+    }
+    catch {
+        return null;
+    }
+    const workspaceName = manifest.name;
+    if (!workspaceName || !arePackageNamesEquivalent(workspaceName, packageName)) {
+        return null;
+    }
+    const openpackageDir = getLocalOpenPackageDir(cwd);
+    return buildLocalPackageResult(workspaceName, openpackageDir, manifest.version);
+}
+// ---------------------------------------------------------------------------
+// Pipeline: resolve remote package (tier 3)
+// ---------------------------------------------------------------------------
+/**
+ * Attempt remote resolution for a package name.
+ */
+export async function resolveRemoteForPackage(packageName, execContext, options) {
+    try {
+        const classification = await classifyInput(packageName, {}, execContext);
+        if (classification.type === 'bulk' || classification.type === 'path') {
+            return null;
+        }
+        return await resolveRemoteList(classification, execContext, {
+            profile: options.profile,
+            apiKey: options.apiKey
+        });
+    }
+    catch (error) {
+        logger.debug(`Remote resolution failed for '${packageName}': ${error}`);
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Pipeline: full multi-tier resolution
+// ---------------------------------------------------------------------------
+/**
+ * Resolve a package through the multi-tier fallback chain:
+ *   Tier 1: Workspace index lookup → scan package source directory
+ *   Tier 1.5: Workspace root package
+ *   Tier 2: Local packages directory (via resolvePackageByName)
+ *   Tier 3: Remote registry/git
+ *
+ * All tiers resolve the package's own contents (metadata, resources, deps),
+ * not the workspace install state.
+ */
+export async function resolvePackageView(packageName, options, createContext) {
+    const showBothScopes = options.scope === undefined;
+    const showGlobal = options.scope === 'global' || showBothScopes;
+    const showProject = options.scope === 'project' || showBothScopes;
+    // --- Remote-only mode ---
+    if (options.remote) {
+        const execContext = await createContext({
+            global: options.scope === 'global',
+            cwd: options.cwd
+        });
+        const remoteResult = await resolveRemoteForPackage(packageName, execContext, options);
+        if (remoteResult) {
+            return { kind: 'remote', remoteResult };
+        }
+        return { kind: 'not-found' };
+    }
+    // --- Tier 1: Workspace index lookup ---
+    // Look up the package in the workspace index to find its source path,
+    // then scan its contents directly (not the workspace install state).
+    if (showProject) {
+        const cwd = options.cwd || process.cwd();
+        const projectContext = await createContext({ global: false, cwd: options.cwd });
+        const projectResult = await resolveFromWorkspaceIndex(packageName, projectContext.targetDir);
+        if (projectResult) {
+            return { kind: 'local-package', localResult: projectResult };
+        }
+    }
+    if (showGlobal) {
+        const globalContext = await createContext({ global: true, cwd: options.cwd });
+        const globalResult = await resolveFromWorkspaceIndex(packageName, globalContext.targetDir);
+        if (globalResult) {
+            return { kind: 'local-package', localResult: globalResult };
+        }
+    }
+    // --- Tier 1.5: Workspace root package ---
+    // If the package name matches the workspace root (.openpackage/openpackage.yml),
+    // resolve it directly. This handles `opkg view` from a workspace where the
+    // auto-detected name is the workspace itself, not an installed dependency.
+    if (showProject) {
+        const cwd = options.cwd || process.cwd();
+        const workspaceRootResult = await resolveWorkspaceRootPackage(packageName, cwd);
+        if (workspaceRootResult) {
+            return { kind: 'local-package', localResult: workspaceRootResult };
+        }
+    }
+    // --- Tier 2: Local packages directory ---
+    const searchRegistry = showBothScopes;
+    const localResult = await resolveLocalPackage(packageName, options.cwd || process.cwd(), { showProject, showGlobal, searchRegistry });
+    if (localResult) {
+        return { kind: 'local-package', localResult };
+    }
+    // --- Tier 3: Remote registry/git ---
+    const fallbackContext = await createContext({
+        global: options.scope === 'global',
+        cwd: options.cwd
+    });
+    const remoteResult = await resolveRemoteForPackage(packageName, fallbackContext, options);
+    if (remoteResult) {
+        return { kind: 'remote', remoteResult };
+    }
+    return { kind: 'not-found' };
+}
+//# sourceMappingURL=view-pipeline.js.map

package/packages/core/dist/core/view/view-pipeline.js.map

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

package/packages/core/dist/core/view/view-printers.d.ts

@@ -0,0 +1,21 @@
+/**
+ * View Printers
+ *
+ * Rendering functions for the `opkg view` command output.
+ * Shows package contents (metadata, resources, dependencies) — not workspace
+ * install state. Uses shared low-level tree primitives from list-tree-renderer.
+ */
+import type { RemoteListResult } from '../list/remote-list-resolver.js';
+import type { LocalPackageResult } from './view-pipeline.js';
+import type { OutputPort } from '../ports/output.js';
+/**
+ * Print package detail view for a locally resolved package.
+ * Shows: header, [Metadata], [Resources], [Dependencies].
+ */
+export declare function printLocalPackageView(result: LocalPackageResult, showFiles: boolean, output?: OutputPort): void;
+/**
+ * Print package detail view for a remotely resolved package.
+ * Shows: header, [Metadata], [Resources], [Dependencies].
+ */
+export declare function printRemotePackageView(result: RemoteListResult, showFiles: boolean, output?: OutputPort): void;
+//# sourceMappingURL=view-printers.d.ts.map

package/packages/core/dist/core/view/view-printers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-printers.d.ts","sourceRoot":"","sources":["../../../src/core/view/view-printers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAwB,MAAM,iCAAiC,CAAC;AAU9F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAmGrD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,kBAAkB,EAC1B,SAAS,EAAE,OAAO,EAClB,MAAM,CAAC,EAAE,UAAU,GAClB,IAAI,CAWN;AAMD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,gBAAgB,EACxB,SAAS,EAAE,OAAO,EAClB,MAAM,CAAC,EAAE,UAAU,GAClB,IAAI,CAiBN"}

package/packages/core/dist/core/view/view-printers.js

@@ -0,0 +1,124 @@
+/**
+ * View Printers
+ *
+ * Rendering functions for the `opkg view` command output.
+ * Shows package contents (metadata, resources, dependencies) — not workspace
+ * install state. Uses shared low-level tree primitives from list-tree-renderer.
+ */
+import { flattenResourceGroups, renderFlatResourceList } from '../list/list-tree-renderer.js';
+import { formatPathForDisplay } from '../../utils/formatters.js';
+import { dim, sectionHeader, printMetadataSection, } from '../list/list-printers.js';
+import { resolveOutput } from '../ports/resolve.js';
+// ---------------------------------------------------------------------------
+// Shared render config for ListFileMapping (no scope/status annotations)
+// ---------------------------------------------------------------------------
+function createViewFileConfig(pathBase) {
+    return {
+        formatPath: (file) => pathBase ? formatPathForDisplay(file.target, pathBase) : file.target,
+        isMissing: (file) => !file.exists,
+        sortFiles: (a, b) => {
+            const pathA = pathBase ? formatPathForDisplay(a.target, pathBase) : a.target;
+            const pathB = pathBase ? formatPathForDisplay(b.target, pathBase) : b.target;
+            return pathA.localeCompare(pathB);
+        }
+    };
+}
+// ---------------------------------------------------------------------------
+// Header
+// ---------------------------------------------------------------------------
+function printHeader(headerInfo, sourceLabel, out) {
+    const o = out ?? resolveOutput();
+    const version = headerInfo.version ? `@${headerInfo.version}` : '';
+    const typeTag = dim(`[${headerInfo.type}]`);
+    const pathOrSource = sourceLabel
+        ? dim(`(${sourceLabel})`) + ' ' + dim('[remote]')
+        : dim(`(${headerInfo.path})`) + ' ' + typeTag;
+    o.info(`${headerInfo.name}${version} ${pathOrSource}`);
+}
+// ---------------------------------------------------------------------------
+// Resources section
+// ---------------------------------------------------------------------------
+function printResourcesSection(report, showFiles, pathBase, out) {
+    const o = out ?? resolveOutput();
+    if (report.resourceGroups && report.resourceGroups.length > 0) {
+        const flatResources = flattenResourceGroups(report.resourceGroups);
+        o.info(sectionHeader('Resources', flatResources.length));
+        const config = createViewFileConfig(pathBase);
+        renderFlatResourceList(flatResources, '', showFiles, config, false, o);
+    }
+    else if (report.fileList && report.fileList.length > 0) {
+        o.info(sectionHeader('Resources', report.fileList.length));
+        const sortedFiles = [...report.fileList].sort((a, b) => a.target.localeCompare(b.target));
+        for (let i = 0; i < sortedFiles.length; i++) {
+            const file = sortedFiles[i];
+            const isLast = i === sortedFiles.length - 1;
+            const connector = isLast ? '└── ' : '├── ';
+            const label = file.exists ? dim(file.target) : `${dim(file.target)} \x1b[31m[MISSING]\x1b[0m`;
+            o.info(`${connector}${label}`);
+        }
+    }
+    else {
+        o.info(sectionHeader('Resources', 0));
+        o.info(dim('└── (no resources)'));
+    }
+}
+// ---------------------------------------------------------------------------
+// Dependencies section
+// ---------------------------------------------------------------------------
+function printDependenciesSection(dependencies, out) {
+    const o = out ?? resolveOutput();
+    if (dependencies.length === 0)
+        return;
+    o.info(sectionHeader('Dependencies', dependencies.length));
+    dependencies.forEach((dep, index) => {
+        const isLast = index === dependencies.length - 1;
+        const connector = isLast ? '└── ' : '├── ';
+        if (typeof dep === 'string') {
+            o.info(`${connector}${dep}`);
+        }
+        else {
+            const versionSuffix = dep.version ? `@${dep.version}` : '';
+            o.info(`${connector}${dep.name}${versionSuffix}`);
+        }
+    });
+}
+// ---------------------------------------------------------------------------
+// Public: unified view printer for local packages
+// ---------------------------------------------------------------------------
+/**
+ * Print package detail view for a locally resolved package.
+ * Shows: header, [Metadata], [Resources], [Dependencies].
+ */
+export function printLocalPackageView(result, showFiles, output) {
+    const out = output ?? resolveOutput();
+    const { report, headerInfo, metadata } = result;
+    printHeader(headerInfo, undefined, out);
+    printMetadataSection(metadata, out);
+    printResourcesSection(report, showFiles, report.path, out);
+    if (report.dependencies !== undefined && report.dependencies.length > 0) {
+        printDependenciesSection(report.dependencies, out);
+    }
+}
+// ---------------------------------------------------------------------------
+// Public: unified view printer for remote packages
+// ---------------------------------------------------------------------------
+/**
+ * Print package detail view for a remotely resolved package.
+ * Shows: header, [Metadata], [Resources], [Dependencies].
+ */
+export function printRemotePackageView(result, showFiles, output) {
+    const out = output ?? resolveOutput();
+    const pkg = result.package;
+    const headerInfo = {
+        name: pkg.name,
+        version: pkg.version && pkg.version !== '0.0.0' ? pkg.version : undefined,
+        path: result.sourceLabel,
+        type: 'package',
+    };
+    printHeader(headerInfo, result.sourceLabel, out);
+    const metadata = result.metadata ?? [];
+    printMetadataSection(metadata, out);
+    printResourcesSection(pkg, showFiles, undefined, out);
+    printDependenciesSection(result.dependencies, out);
+}
+//# sourceMappingURL=view-printers.js.map

package/packages/core/dist/core/view/view-printers.js.map

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

package/packages/core/dist/core/workspace-package-context.d.ts

@@ -0,0 +1,54 @@
+import type { PackageYml } from '../types/index.js';
+/**
+ * Workspace package context for add/remove operations.
+ * Contains essential package metadata for operating on workspace root (.openpackage/).
+ */
+export interface WorkspacePackageContext {
+    /** Package name (from manifest or workspace directory name) */
+    name: string;
+    /** Package version (if specified in manifest) */
+    version?: string;
+    /** Full package configuration from openpackage.yml */
+    config: PackageYml;
+    /** Absolute path to package manifest (openpackage.yml) */
+    packageYmlPath: string;
+    /** Root directory of the package (.openpackage/) */
+    packageRootDir: string;
+    /** Directory containing package files (same as root for workspace packages) */
+    packageFilesDir: string;
+}
+/**
+ * Build workspace package context for operations on workspace root (.openpackage/).
+ *
+ * This utility creates or ensures the workspace package structure exists and loads
+ * the manifest configuration. Used by add/remove commands when operating on the
+ * workspace root (no specific package specified via --to/--from).
+ *
+ * @param cwd - Current working directory
+ * @returns Workspace package context with loaded configuration
+ * @throws Error if manifest cannot be read
+ *
+ * @example
+ * // Add command: opkg add ./file.md (no --to option)
+ * const context = await buildWorkspacePackageContext(cwd);
+ * // Files will be added to context.packageRootDir (.openpackage/)
+ *
+ * @example
+ * // Remove command: opkg remove agents/my-agent (no --from option)
+ * const context = await buildWorkspacePackageContext(cwd);
+ * // Files will be removed from context.packageRootDir (.openpackage/)
+ */
+export declare function buildWorkspacePackageContext(cwd: string): Promise<WorkspacePackageContext>;
+/**
+ * Ensure workspace package structure exists and is initialized.
+ * This is a convenience wrapper around ensureLocalOpenPackageStructure and createWorkspacePackageYml.
+ *
+ * @param cwd - Current working directory
+ *
+ * @example
+ * // Ensure workspace is ready before performing operations
+ * await ensureWorkspacePackageExists(cwd);
+ * // Now .openpackage/ directory and openpackage.yml exist
+ */
+export declare function ensureWorkspacePackageExists(cwd: string): Promise<void>;
+//# sourceMappingURL=workspace-package-context.d.ts.map

package/packages/core/dist/core/workspace-package-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-package-context.d.ts","sourceRoot":"","sources":["../../src/core/workspace-package-context.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,MAAM,EAAE,UAAU,CAAC;IACnB,0DAA0D;IAC1D,cAAc,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,cAAc,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,4BAA4B,CAChD,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,uBAAuB,CAAC,CA+BlC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG7E"}

package/packages/core/dist/core/workspace-package-context.js

@@ -0,0 +1,68 @@
+import { join, basename } from 'path';
+import { FILE_PATTERNS } from '../constants/index.js';
+import { ensureLocalOpenPackageStructure, createWorkspacePackageYml } from './package-management.js';
+import { getLocalOpenPackageDir } from '../utils/paths.js';
+import { parsePackageYml } from '../utils/package-yml.js';
+/**
+ * Build workspace package context for operations on workspace root (.openpackage/).
+ *
+ * This utility creates or ensures the workspace package structure exists and loads
+ * the manifest configuration. Used by add/remove commands when operating on the
+ * workspace root (no specific package specified via --to/--from).
+ *
+ * @param cwd - Current working directory
+ * @returns Workspace package context with loaded configuration
+ * @throws Error if manifest cannot be read
+ *
+ * @example
+ * // Add command: opkg add ./file.md (no --to option)
+ * const context = await buildWorkspacePackageContext(cwd);
+ * // Files will be added to context.packageRootDir (.openpackage/)
+ *
+ * @example
+ * // Remove command: opkg remove agents/my-agent (no --from option)
+ * const context = await buildWorkspacePackageContext(cwd);
+ * // Files will be removed from context.packageRootDir (.openpackage/)
+ */
+export async function buildWorkspacePackageContext(cwd) {
+    // Ensure .openpackage/ structure exists
+    await ensureLocalOpenPackageStructure(cwd);
+    // Create workspace manifest if it doesn't exist
+    await createWorkspacePackageYml(cwd);
+    const openpackageDir = getLocalOpenPackageDir(cwd);
+    const packageYmlPath = join(openpackageDir, FILE_PATTERNS.OPENPACKAGE_YML);
+    // Load workspace manifest
+    let config;
+    try {
+        config = await parsePackageYml(packageYmlPath);
+    }
+    catch (error) {
+        throw new Error(`Failed to read workspace manifest at ${packageYmlPath}: ${error}`);
+    }
+    // Use workspace directory name as package name if not specified in manifest
+    const packageName = config.name || basename(cwd);
+    return {
+        name: packageName,
+        version: config.version,
+        config,
+        packageYmlPath,
+        packageRootDir: openpackageDir,
+        packageFilesDir: openpackageDir
+    };
+}
+/**
+ * Ensure workspace package structure exists and is initialized.
+ * This is a convenience wrapper around ensureLocalOpenPackageStructure and createWorkspacePackageYml.
+ *
+ * @param cwd - Current working directory
+ *
+ * @example
+ * // Ensure workspace is ready before performing operations
+ * await ensureWorkspacePackageExists(cwd);
+ * // Now .openpackage/ directory and openpackage.yml exist
+ */
+export async function ensureWorkspacePackageExists(cwd) {
+    await ensureLocalOpenPackageStructure(cwd);
+    await createWorkspacePackageYml(cwd);
+}
+//# sourceMappingURL=workspace-package-context.js.map

package/packages/core/dist/core/workspace-package-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-package-context.js","sourceRoot":"","sources":["../../src/core/workspace-package-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,+BAA+B,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACrG,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAsB1D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,GAAW;IAEX,wCAAwC;IACxC,MAAM,+BAA+B,CAAC,GAAG,CAAC,CAAC;IAE3C,gDAAgD;IAChD,MAAM,yBAAyB,CAAC,GAAG,CAAC,CAAC;IAErC,MAAM,cAAc,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;IACnD,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAE3E,0BAA0B;IAC1B,IAAI,MAAkB,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,eAAe,CAAC,cAAc,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,wCAAwC,cAAc,KAAK,KAAK,EAAE,CACnE,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC;IAEjD,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM;QACN,cAAc;QACd,cAAc,EAAE,cAAc;QAC9B,eAAe,EAAE,cAAc;KAChC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,GAAW;IAC5D,MAAM,+BAA+B,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,yBAAyB,CAAC,GAAG,CAAC,CAAC;AACvC,CAAC"}

package/packages/core/dist/generated/version.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION = "0.9.0";
+//# sourceMappingURL=version.d.ts.map