@phyzess/pappra 0.1.0-beta.4 → 0.1.0-beta.5

package/README.md

@@ -63,7 +63,7 @@ requires an explicit controller. They are not needed for the core workflow above
 - **Knowledge:** workspace and private document catalogs with explicit preview/apply operations.
 - **Continuity:** private task checkpoints and bounded advisory resume packets. Resume never grants execution by itself.
 - **Code intelligence:** status, explicit preparation and bounded query for selected repositories. Text/structure fallback is available when the optional graph engine is absent.
-- **Host integrations:** optional Pi, Codex and Claude Code adapters that merge Pappra-owned entries without taking over user configuration. Hooks are copied as a dependency-free bundle into the host root; `host bundle` exports a native plugin/package directory without registering it. `host install --mode plugin` fails closed until plugin registration and callability are verified.
+- **Host integrations:** optional Pi, Codex and Claude Code adapters that merge Pappra-owned entries without taking over user configuration. Hooks are copied as a dependency-free bundle into the host root; `host bundle --marketplace` exports a local marketplace that Claude Code and Codex accept, without registering it. `host install --mode plugin` fails closed until plugin registration and callability are verified in a real session.
 - **Bounded collaboration:** an optional, explicitly controlled one-request workflow. It is not a scheduler or daemon.
 
 ## Optional integrations and support
@@ -87,7 +87,7 @@ The check runs the source policy, type checks, formatting, deterministic tests a
 
 ## Status and limits
 
-Pappra is development software (`0.1.0-beta.4`) published as `@phyzess/pappra` under the `beta` dist-tag. Releases are published from GitHub Actions with npm trusted publishing (OIDC), so no npm token is stored in this repository. Pin either the moving `beta` tag or an exact version such as `@phyzess/pappra@0.1.0-beta.4`, because pre-release versions are never republished.
+Pappra is development software (`0.1.0-beta.5`) published as `@phyzess/pappra` under the `beta` dist-tag. Releases are published from GitHub Actions with npm trusted publishing (OIDC), so no npm token is stored in this repository. Pin either the moving `beta` tag or an exact version such as `@phyzess/pappra@0.1.0-beta.5`, because pre-release versions are never republished.
 
 The deterministic suite covers synthetic workspaces, fixtures and local process boundaries. It does not establish real-model behavior, native host callability on every platform, CodeGraph completeness, Windows/Linux parity or production performance. A host adapter version pin is an observed support claim, not proof that a particular native installation will load or run correctly.
 

package/dist/cli/commands/host.d.ts

@@ -11,5 +11,6 @@ export interface HostCommandOptions {
     readonly apply: boolean;
     readonly out: string | null;
     readonly mode: 'project-settings' | 'plugin' | null;
+    readonly marketplace: boolean;
 }
 export declare function runHostCommand(options: HostCommandOptions, output: CliOutput): Promise<number>;

package/dist/cli/commands/host.js

@@ -133,6 +133,7 @@ export async function runHostCommand(options, output) {
                 hostVersion: options.hostVersion ?? HOST_SUPPORT[options.host].version,
                 outDir: options.out,
                 packageVersion: getPackageInfo().version,
+                marketplace: options.marketplace,
             });
             if (options.json) {
                 output.stdout(`${JSON.stringify({ ok: true, command: 'host', action: 'bundle', ...exported })}\n`);

package/dist/cli/run.js

@@ -25,6 +25,7 @@ function parseOptions(args) {
             tarball: { type: 'string' },
             out: { type: 'string' },
             mode: { type: 'string' },
+            marketplace: { type: 'boolean' },
             bind: { type: 'boolean' },
             force: { type: 'boolean' },
             'no-interactive': { type: 'boolean' },
@@ -250,6 +251,10 @@ export async function runCli(args, output) {
         failure(output, json, 'invalid_arguments', '--out is only valid for host.');
         return 2;
     }
+    if (command !== 'host' && values.marketplace === true) {
+        failure(output, json, 'invalid_arguments', '--marketplace is only valid for host bundle.');
+        return 2;
+    }
     if (command !== 'host' &&
         values.mode !== undefined &&
         command !== 'runtime') {
@@ -659,6 +664,7 @@ export async function runCli(args, output) {
             hasContinuityOptions(values) ||
             (values.apply === true && action !== 'install') ||
             (values.mode !== undefined && action !== 'install') ||
+            (values.marketplace === true && action !== 'bundle') ||
             (values['host-root'] !== undefined && action === null) ||
             (values['host-version'] !== undefined && action === null);
         if (values.help) {
@@ -686,6 +692,7 @@ export async function runCli(args, output) {
             mode: values.mode === 'project-settings' || values.mode === 'plugin'
                 ? values.mode
                 : null,
+            marketplace: values.marketplace === true,
         }, output);
     }
     if (command !== null) {

package/dist/hosts/integration/bundle-export.d.ts

@@ -19,4 +19,6 @@ export declare function exportHostPluginBundle(options: {
     readonly hostVersion: string;
     readonly outDir: string;
     readonly packageVersion: string;
+    /** Writes a marketplace root with the plugin under `pappra/`. */
+    readonly marketplace?: boolean;
 }): Promise<HostPluginBundle>;

package/dist/hosts/integration/bundle-export.js

@@ -10,24 +10,15 @@ function pluginHookExpression(host) {
         : './hooks/pappra-hook.mjs';
 }
 function hostManifest(host, version) {
-    if (host === 'claude') {
+    if (host === 'claude' || host === 'codex') {
+        // Codex reads the Claude plugin manifest path, so one manifest serves both.
         return {
             path: '.claude-plugin/plugin.json',
             value: {
                 name: 'pappra',
                 version,
                 description: 'Portable workspace knowledge and continuity for coding agents.',
-                hooks: './hooks/hooks.json',
-            },
-        };
-    }
-    if (host === 'codex') {
-        return {
-            path: 'plugin.json',
-            value: {
-                name: 'pappra',
-                version,
-                description: 'Portable workspace knowledge and continuity for coding agents.',
+                author: { name: 'phyzess' },
                 hooks: './hooks/hooks.json',
             },
         };
@@ -53,15 +44,20 @@ function hostManifest(host, version) {
  * load or trust it.
  */
 export async function exportHostPluginBundle(options) {
-    const outDir = resolve(options.outDir);
+    const outRoot = resolve(options.outDir);
+    if (options.marketplace === true && options.host === 'pi') {
+        throw new Error('Pi installs a directory directly; a marketplace wrapper is not supported.');
+    }
+    const pluginPrefix = options.marketplace === true ? 'pappra/' : '';
+    const pluginRoot = options.marketplace === true ? join(outRoot, 'pappra') : outRoot;
     const payload = await loadHostBundle(options.host, options.packageVersion, {
         hookSource: join(getPackageRoot(), 'dist/hosts/integration/pappra-hook.mjs'),
         hookExpression: pluginHookExpression(options.host),
     });
     const written = [];
     const writeEntry = async (path, bytes) => {
-        const target = join(outDir, ...path.split('/'));
-        if (!isPathInside(outDir, target)) {
+        const target = join(outRoot, ...path.split('/'));
+        if (!isPathInside(outRoot, target)) {
             throw new Error(`Unsafe plugin bundle path: ${path}`);
         }
         await mkdir(dirname(target), { recursive: true });
@@ -73,7 +69,7 @@ export async function exportHostPluginBundle(options) {
         // templates are only an intermediate artifact.
         if (options.host !== 'pi' && path.startsWith('templates/'))
             continue;
-        await writeEntry(path, bytes);
+        await writeEntry(`${pluginPrefix}${path}`, bytes);
     }
     const expression = pluginHookExpression(options.host);
     if (options.host === 'pi') {
@@ -81,20 +77,35 @@ export async function exportHostPluginBundle(options) {
         if (entry === undefined) {
             throw new Error('Pi plugin bundle is missing its extension entry.');
         }
-        await writeEntry('extensions/pappra/index.ts', entry);
+        await writeEntry(`${pluginPrefix}extensions/pappra/index.ts`, entry);
     }
     else {
         const patch = renderHookConfigPatch(options.host, expression);
-        await writeEntry('hooks/hooks.json', Buffer.from(`${JSON.stringify(patch, null, 2)}\n`));
+        await writeEntry(`${pluginPrefix}hooks/hooks.json`, Buffer.from(`${JSON.stringify(patch, null, 2)}\n`));
     }
     const manifest = hostManifest(options.host, options.packageVersion);
-    await writeEntry(manifest.path, Buffer.from(`${JSON.stringify(manifest.value, null, 2)}\n`));
+    await writeEntry(`${pluginPrefix}${manifest.path}`, Buffer.from(`${JSON.stringify(manifest.value, null, 2)}\n`));
+    if (options.marketplace === true) {
+        await writeEntry('.claude-plugin/marketplace.json', Buffer.from(`${JSON.stringify({
+            name: 'pappra-local',
+            owner: { name: 'phyzess' },
+            description: 'Local Pappra plugin marketplace exported by pappra host bundle.',
+            plugins: [
+                {
+                    name: 'pappra',
+                    source: './pappra',
+                    description: 'Portable workspace knowledge and continuity for coding agents.',
+                    author: { name: 'phyzess' },
+                },
+            ],
+        }, null, 2)}\n`));
+    }
     return {
         host: options.host,
-        outDir,
+        outDir: pluginRoot,
         files: written.sort((left, right) => left.localeCompare(right)),
-        pluginManifest: manifest.path,
-        hookConfig: options.host === 'pi' ? null : 'hooks/hooks.json',
+        pluginManifest: `${pluginPrefix}${manifest.path}`,
+        hookConfig: options.host === 'pi' ? null : `${pluginPrefix}hooks/hooks.json`,
         registration: options.host === 'claude'
             ? [
                 'Register the directory as a local plugin or marketplace entry; Pappra does not add it to host settings.',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phyzess/pappra",
-  "version": "0.1.0-beta.4",
+  "version": "0.1.0-beta.5",
   "description": "Portable workspace knowledge and continuity for coding agents.",
   "publishConfig": {
     "access": "public"