@phyzess/pappra 0.1.0-beta.6 → 0.1.0-beta.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -63,7 +63,7 @@ requires an explicit controller. They are not needed for the core workflow above
|
|
|
63
63
|
- **Knowledge:** workspace and private document catalogs with explicit preview/apply operations.
|
|
64
64
|
- **Continuity:** private task checkpoints and bounded advisory resume packets. Resume never grants execution by itself.
|
|
65
65
|
- **Code intelligence:** status, explicit preparation and bounded query for selected repositories. Text/structure fallback is available when the optional graph engine is absent.
|
|
66
|
-
- **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 with per-host
|
|
66
|
+
- **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. Plugin hooks are verified for Pi 1.3.0 and Claude Code 2.1.292 (startup) and unsupported for Codex 0.163.0; `host bundle` exports the bundle and `host install --mode plugin` fails closed with the per-host commands. See [host plugin validation](docs/host-plugin-validation.md).
|
|
67
67
|
- **Bounded collaboration:** an optional, explicitly controlled one-request workflow. It is not a scheduler or daemon.
|
|
68
68
|
|
|
69
69
|
## Optional integrations and support
|
|
@@ -87,7 +87,7 @@ The check runs the source policy, type checks, formatting, deterministic tests a
|
|
|
87
87
|
|
|
88
88
|
## Status and limits
|
|
89
89
|
|
|
90
|
-
Pappra is development software (`0.1.0-beta.
|
|
90
|
+
Pappra is development software (`0.1.0-beta.7`) 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.7`, because pre-release versions are never republished.
|
|
91
91
|
|
|
92
92
|
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.
|
|
93
93
|
|
|
@@ -886,11 +886,13 @@ export class HostIntegrationService {
|
|
|
886
886
|
async install(host, options) {
|
|
887
887
|
if (options.mode === 'plugin') {
|
|
888
888
|
const support = HOST_PLUGIN_HOOKS[host];
|
|
889
|
-
const guidance = support.state === 'verified'
|
|
890
|
-
? 'Export
|
|
891
|
-
: support.state === '
|
|
892
|
-
? '
|
|
893
|
-
:
|
|
889
|
+
const guidance = host === 'claude' && support.state === 'verified'
|
|
890
|
+
? 'Export with `pappra host bundle --host claude --out <dir> --marketplace --json`, then run `claude plugin marketplace add <dir>` and `claude plugin install pappra@pappra-local`. Use --mode project-settings for automatic workspace wiring.'
|
|
891
|
+
: host === 'pi' && support.state === 'verified'
|
|
892
|
+
? 'Export with `pappra host bundle --host pi --out <dir> --json`, then run `pi install <dir> -l -a`. Use --mode project-settings for automatic workspace wiring.'
|
|
893
|
+
: support.state === 'unsupported'
|
|
894
|
+
? 'This host does not load plugin hooks at its pinned version; keep --mode project-settings. See docs/host-plugin-validation.md.'
|
|
895
|
+
: 'Plugin hooks are not verified for this host yet; an authenticated lifecycle session is required. Use --mode project-settings meanwhile.';
|
|
894
896
|
return hostIntegrationResultSchema.parse({
|
|
895
897
|
schema: 'pappra/host-integration/1',
|
|
896
898
|
ok: false,
|
|
@@ -50,7 +50,7 @@ export declare const HOST_PLUGIN_HOOKS: {
|
|
|
50
50
|
readonly evidence: 'Codex 0.163.0 does not load plugin hooks: a control hook in CODEX_HOME fired during `codex exec --dangerously-bypass-hook-trust` while the bundled plugin hook never ran, including with a .codex-plugin/plugin.json copy.';
|
|
51
51
|
};
|
|
52
52
|
readonly claude: {
|
|
53
|
-
readonly state: '
|
|
54
|
-
readonly evidence: 'Claude Code 2.1.292
|
|
53
|
+
readonly state: 'verified';
|
|
54
|
+
readonly evidence: 'Claude Code 2.1.292 passed `claude plugin validate`, then a project-scope marketplace install and `claude -p` wrote a SessionStart event from ${CLAUDE_PLUGIN_ROOT}/hooks/pappra-hook.mjs.';
|
|
55
55
|
};
|
|
56
56
|
};
|
|
@@ -55,7 +55,7 @@ export const HOST_PLUGIN_HOOKS = {
|
|
|
55
55
|
evidence: 'Codex 0.163.0 does not load plugin hooks: a control hook in CODEX_HOME fired during `codex exec --dangerously-bypass-hook-trust` while the bundled plugin hook never ran, including with a .codex-plugin/plugin.json copy.',
|
|
56
56
|
},
|
|
57
57
|
claude: {
|
|
58
|
-
state: '
|
|
59
|
-
evidence: 'Claude Code 2.1.292
|
|
58
|
+
state: 'verified',
|
|
59
|
+
evidence: 'Claude Code 2.1.292 passed `claude plugin validate`, then a project-scope marketplace install and `claude -p` wrote a SessionStart event from ${CLAUDE_PLUGIN_ROOT}/hooks/pappra-hook.mjs.',
|
|
60
60
|
},
|
|
61
61
|
};
|