bookmark-research 0.5.0-beta.1

package/docs/harness-sources.json

@@ -0,0 +1,342 @@
+{
+  "schema_version": 1,
+  "topic": "Bookmark Research cross-harness packaging compatibility",
+  "research_date": "2026-09-07",
+  "updated_on": "2026-09-08",
+  "source_policy": "Official product documentation, official repositories and Agent Plugins normative schemas only.",
+  "limitations": [
+    "Exa retrieval may return indexed content and does not establish a uniform live-origin timestamp.",
+    "Mutable repository branches are not pinned release artifacts.",
+    "This research subtask did not install clients. Codex 0.153.4 launch diagnostics were supplied by the project's local integration task; Claude Code, Pi and DeepSeek Harness client loading remains untested.",
+    "Exported configuration shape, shared runtime tests and target-client interoperability are separate checks."
+  ],
+  "sources": [
+    {
+      "id": "H01",
+      "title": "Agent Plugins Specification 1.0.0",
+      "url": "https://agent-plugins.org/specification",
+      "publisher": "Agent Plugins",
+      "revision": "1.0.0",
+      "supports": [
+        "Root plugin.json requires $schema and name; fixed skills/ and mcp.json discovery.",
+        "Client-specific manifest data and files use reverse-domain namespaces.",
+        "stdio executable, path containment, PLUGIN_ROOT and PLUGIN_DATA semantics.",
+        "The specification does not establish that a named existing client has adopted the format."
+      ],
+      "read_scope": "Full extracted specification; normative sections 4–11 inspected.",
+      "retrieval_method": "Exa MCP web_search_exa and/or web_fetch_exa",
+      "retrieved_on": "2026-09-07",
+      "evidence_status": "official_content_read",
+      "runtime_tested_in_this_subtask": false
+    },
+    {
+      "id": "H02",
+      "title": "Agent Plugins 1.0.0 plugin manifest JSON Schema",
+      "url": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+      "publisher": "Agent Plugins",
+      "revision": "1.0.0",
+      "supports": [
+        "Closed top-level manifest object.",
+        "Required $schema and name; metadata and extensions types."
+      ],
+      "read_scope": "Full extracted schema.",
+      "retrieval_method": "Exa MCP web_search_exa and/or web_fetch_exa",
+      "retrieved_on": "2026-09-07",
+      "evidence_status": "official_content_read",
+      "runtime_tested_in_this_subtask": false
+    },
+    {
+      "id": "H03",
+      "title": "Agent Plugins 1.0.0 MCP configuration JSON Schema",
+      "url": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
+      "publisher": "Agent Plugins",
+      "revision": "1.0.0",
+      "supports": [
+        "Required root $schema and mcpServers.",
+        "stdio requires type and command; env may not define PLUGIN_ROOT or PLUGIN_DATA.",
+        "Runtime path containment is separate from JSON Schema validation."
+      ],
+      "read_scope": "Full extracted schema.",
+      "retrieval_method": "Exa MCP web_search_exa and/or web_fetch_exa",
+      "retrieved_on": "2026-09-07",
+      "evidence_status": "official_content_read",
+      "runtime_tested_in_this_subtask": false
+    },
+    {
+      "id": "H04",
+      "title": "Package your plugin",
+      "url": "https://developers.openai.com/plugins/build/plugins",
+      "publisher": "OpenAI",
+      "revision": "Current documentation URL; not a pinned client release.",
+      "supports": [
+        ".codex-plugin/plugin.json is the Codex/OpenAI native manifest path.",
+        "Skills and MCP configuration belong at the plugin root.",
+        "Current documentation shows direct server maps or mcp_servers-wrapped maps for referenced MCP configuration files."
+      ],
+      "read_scope": "Extracted page through plugin layout and bundled MCP configuration sections.",
+      "qualification": "Read according to the OpenAI Docs skill; schema compatibility must still be checked against the selected runtime and local plugin tooling.",
+      "retrieval_method": "Exa MCP web_search_exa and/or web_fetch_exa",
+      "retrieved_on": "2026-09-07",
+      "evidence_status": "official_content_read",
+      "runtime_tested_in_this_subtask": false
+    },
+    {
+      "id": "H05",
+      "title": "Claude Code plugins reference",
+      "url": "https://code.claude.com/docs/en/plugins-reference",
+      "publisher": "Anthropic",
+      "revision": "Current documentation URL; not a pinned Claude Code release.",
+      "supports": [
+        ".claude-plugin/plugin.json is the native manifest path; current documentation allows the manifest to be omitted.",
+        "If a manifest is present, name is the required identity field.",
+        "Root skills and MCP configuration, native plugin path variables, component and installation conventions."
+      ],
+      "read_scope": "Extracted page including manifest schema and MCP sections.",
+      "qualification": "Does not establish root Agent Plugins plugin.json interoperability.",
+      "retrieval_method": "Exa MCP web_search_exa and/or web_fetch_exa",
+      "retrieved_on": "2026-09-07",
+      "evidence_status": "official_content_read",
+      "runtime_tested_in_this_subtask": false
+    },
+    {
+      "id": "H06",
+      "title": "Codex 0.153.4 native plugin MCP configuration parser",
+      "url": "https://github.com/openai/codex/blob/rust-v0.153.4/codex-rs/codex-mcp/src/plugin_config.rs",
+      "retrieval_url": "https://raw.githubusercontent.com/openai/codex/refs/tags/rust-v0.153.4/codex-rs/codex-mcp/src/plugin_config.rs",
+      "publisher": "OpenAI",
+      "revision": "rust-v0.153.4",
+      "supports": [
+        "Native host-plugin normalization resolves an explicitly relative cwd with root.join(cwd).",
+        "The native normalizer does not expand PLUGIN_ROOT, CLAUDE_PLUGIN_ROOT or CODEX_PLUGIN_ROOT in command or args.",
+        "Host-plugin normalization leaves an absent cwd unset; executor-owned plugin normalization separately supplies a plugin-root default.",
+        "Agent Plugins MCP configuration uses a separate agent_plugin_config.rs parser."
+      ],
+      "read_scope": "Full raw source for the precise release tag, including normalize_plugin_mcp_server and normalize_plugin_mcp_server_value.",
+      "qualification": "The project's local Codex 0.153.4 diagnostic trace independently reported literal PLUGIN_ROOT args, session cwd and no plugin-root environment injection. The read-only research subtask did not repeat client execution.",
+      "retrieval_method": "Exa MCP web_fetch_exa; GitHub blob fetch timed out, raw release-tag source succeeded.",
+      "retrieved_on": "2026-09-08",
+      "evidence_status": "official_release_source_read",
+      "runtime_tested_in_this_subtask": false
+    },
+    {
+      "id": "P01",
+      "title": "Pi Coding Agent",
+      "url": "https://pi.dev",
+      "publisher": "Pi / earendil-works",
+      "revision": "Current project homepage.",
+      "supports": [
+        "Current installation package is @earendil-works/pi-coding-agent.",
+        "Extensibility uses extensions, skills, prompt templates and themes.",
+        "MCP integration is presented as an extension/package capability."
+      ],
+      "read_scope": "Full extracted homepage.",
+      "retrieval_method": "Exa MCP web_search_exa and/or web_fetch_exa",
+      "retrieved_on": "2026-09-07",
+      "evidence_status": "official_content_read",
+      "runtime_tested_in_this_subtask": false
+    },
+    {
+      "id": "P02",
+      "title": "Pi Packages",
+      "url": "https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/packages.md",
+      "publisher": "Pi / earendil-works",
+      "revision": "main (mutable)",
+      "supports": [
+        "package.json pi key can declare skills, extensions, prompts and themes.",
+        "pi install accepts npm, git and local paths; local paths are recorded without copying.",
+        "Global and project package settings; package resource paths and dependency conventions."
+      ],
+      "read_scope": "Extracted package documentation; installation, local paths, manifest and dependency sections inspected.",
+      "retrieval_method": "Exa MCP web_search_exa and/or web_fetch_exa",
+      "retrieved_on": "2026-09-07",
+      "evidence_status": "official_content_read",
+      "runtime_tested_in_this_subtask": false
+    },
+    {
+      "id": "P03",
+      "title": "Pi Skills",
+      "url": "https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/skills.md",
+      "publisher": "Pi / earendil-works",
+      "revision": "main (mutable)",
+      "supports": [
+        "Global, project, package, settings and --skill discovery.",
+        "/skill:name command; progressive disclosure; shared Agent Skills format.",
+        "Pi allows broader recursive discovery than Agent Plugins 1.0.0; shared packages should keep the stricter simple layout."
+      ],
+      "read_scope": "Full extracted skills documentation.",
+      "retrieval_method": "Exa MCP web_search_exa and/or web_fetch_exa",
+      "retrieved_on": "2026-09-07",
+      "evidence_status": "official_content_read",
+      "runtime_tested_in_this_subtask": false
+    },
+    {
+      "id": "P04",
+      "title": "Pi Extensions",
+      "url": "https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/extensions.md",
+      "publisher": "Pi / earendil-works",
+      "revision": "main (mutable)",
+      "supports": [
+        "Default extension factory receives ExtensionAPI.",
+        "pi.registerTool registers model-callable tools; current examples import from @earendil-works/pi-coding-agent and typebox.",
+        "Extension locations, TypeScript loading, startup/shutdown lifecycle and package declarations."
+      ],
+      "read_scope": "Opening and API/lifecycle excerpts; not all examples were fetched.",
+      "retrieval_method": "Exa MCP web_search_exa and/or web_fetch_exa",
+      "retrieved_on": "2026-09-07",
+      "evidence_status": "official_content_read",
+      "runtime_tested_in_this_subtask": false
+    },
+    {
+      "id": "P05",
+      "title": "Using Pi — Design Principles and CLI",
+      "url": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/docs/usage.md",
+      "publisher": "Pi / earendil-works",
+      "revision": "main (mutable)",
+      "supports": [
+        "The design-principles section explicitly states that Pi core does not include built-in MCP.",
+        "--skill is an additive command-line resource option.",
+        "Package management and project trust are host behavior, not supplied by a generic MCP server."
+      ],
+      "read_scope": "Full extracted usage page; CLI and closing Design Principles sections inspected.",
+      "retrieval_method": "Exa MCP web_search_exa and/or web_fetch_exa",
+      "retrieved_on": "2026-09-07",
+      "evidence_status": "official_content_read",
+      "runtime_tested_in_this_subtask": false
+    },
+    {
+      "id": "D01",
+      "title": "DeepSeek Harness README",
+      "url": "https://github.com/deepseek-ai/deepseek-harness/blob/master/README.md",
+      "publisher": "DeepSeek AI",
+      "revision": "master (mutable)",
+      "supports": [
+        "Project identity, dsh launcher and Cordis-based plugin architecture.",
+        "Developer preview and explicitly expected compatibility-breaking changes."
+      ],
+      "read_scope": "Full extracted README.",
+      "retrieval_method": "Exa MCP web_search_exa and/or web_fetch_exa",
+      "retrieved_on": "2026-09-07",
+      "evidence_status": "official_content_read",
+      "runtime_tested_in_this_subtask": false
+    },
+    {
+      "id": "D02",
+      "title": "Package and install a plugin",
+      "url": "https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/develop/basic/publish.md",
+      "publisher": "DeepSeek AI",
+      "revision": "master (mutable)",
+      "supports": [
+        "Bundle package.json declares dsh.bundle.patch; profiles separately declare dsh.profile.bundles.",
+        "dsh plugin --profile NAME add PATH installs a bundle; --dump-config inspects composition.",
+        "Later patch rows replace complete config values; native JS entry points are used when a bundle contributes its own Cordis module."
+      ],
+      "read_scope": "Full extracted tutorial.",
+      "retrieval_method": "Exa MCP web_search_exa and/or web_fetch_exa",
+      "retrieved_on": "2026-09-07",
+      "evidence_status": "official_content_read",
+      "runtime_tested_in_this_subtask": false
+    },
+    {
+      "id": "D03",
+      "title": "Your first plugin",
+      "url": "https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/develop/basic/index.md",
+      "publisher": "DeepSeek AI",
+      "revision": "master (mutable)",
+      "supports": [
+        "Cordis named exports name, inject and apply; object and class forms also supported.",
+        "Local --patch plugin module paths are absolute; overlay location does not reset the profile's resolution root.",
+        "Services are awaited before activation and ctx.effect supplies cleanup."
+      ],
+      "read_scope": "Full extracted tutorial.",
+      "retrieval_method": "Exa MCP web_search_exa and/or web_fetch_exa",
+      "retrieved_on": "2026-09-07",
+      "evidence_status": "official_content_read",
+      "runtime_tested_in_this_subtask": false
+    },
+    {
+      "id": "D04",
+      "title": "DSH MCP client bridge README",
+      "url": "https://github.com/deepseek-ai/deepseek-harness/blob/master/packages/mcp/mcp-client/README.md",
+      "publisher": "DeepSeek AI",
+      "revision": "master (mutable)",
+      "supports": [
+        "@deepseek-ai/dsh-mcp-client connects one server per plugin instance.",
+        "stdio and Streamable HTTP; command/args/env/cwd and reconnection settings.",
+        "MCP tools become mcp__server__tool; Resources and Prompts are not bridged by this implementation."
+      ],
+      "read_scope": "Full extracted README.",
+      "retrieval_method": "Exa MCP web_search_exa and/or web_fetch_exa",
+      "retrieved_on": "2026-09-07",
+      "evidence_status": "official_content_read",
+      "runtime_tested_in_this_subtask": false
+    },
+    {
+      "id": "D05",
+      "title": "DSH MCP client entry source",
+      "url": "https://github.com/deepseek-ai/deepseek-harness/blob/master/packages/mcp/mcp-client/src/index.ts",
+      "publisher": "DeepSeek AI",
+      "revision": "master (mutable)",
+      "supports": [
+        "name = mcp-client, inject = ['tools'], async apply(ctx, config).",
+        "Config schema includes transport, serverName, command, args, env, cwd, toolCallTimeoutMs and failOnStartupError.",
+        "Distinct server-name reservation and effect-scoped disposal; no plugin-root placeholder expansion contract in this entry."
+      ],
+      "read_scope": "Full extracted entry source.",
+      "qualification": "Absence of a placeholder contract in this source is not a statement about every future DSH extension; examples therefore use resolved absolute paths.",
+      "retrieval_method": "Exa MCP web_search_exa and/or web_fetch_exa",
+      "retrieved_on": "2026-09-07",
+      "evidence_status": "official_content_read",
+      "runtime_tested_in_this_subtask": false
+    },
+    {
+      "id": "D06",
+      "title": "DSH Skills subsystem",
+      "url": "https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/subsystems/skills.md",
+      "publisher": "DeepSeek AI",
+      "revision": "master (mutable)",
+      "supports": [
+        "Project/custom/user/bundled skill-root precedence.",
+        "<name>/SKILL.md and flat Markdown discovery; no arbitrary recursive **/SKILL.md discovery.",
+        "Registry, filesystem provider and model-facing skill consumer are separate capabilities."
+      ],
+      "read_scope": "Extracted subsystem documentation including discovery and policy sections.",
+      "retrieval_method": "Exa MCP web_search_exa and/or web_fetch_exa",
+      "retrieved_on": "2026-09-07",
+      "evidence_status": "official_content_read",
+      "runtime_tested_in_this_subtask": false
+    },
+    {
+      "id": "D07",
+      "title": "DSH filesystem skill provider source",
+      "url": "https://github.com/deepseek-ai/deepseek-harness/blob/master/packages/skill/skill-filesystem/src/index.ts",
+      "publisher": "DeepSeek AI",
+      "revision": "master (mutable)",
+      "supports": [
+        "customSkillDirs and includeDefaultRoots configuration.",
+        "Default dshHome and agentsHome, source-rank construction and provider injection into skills service."
+      ],
+      "read_scope": "Opening source and configuration/root-resolution excerpts.",
+      "retrieval_method": "Exa MCP web_search_exa and/or web_fetch_exa",
+      "retrieved_on": "2026-09-07",
+      "evidence_status": "official_content_read",
+      "runtime_tested_in_this_subtask": false
+    },
+    {
+      "id": "D08",
+      "title": "dsh CLI behavior reference",
+      "url": "https://github.com/deepseek-ai/deepseek-harness/blob/master/apps/cli/reference/README.md",
+      "publisher": "DeepSeek AI",
+      "revision": "master (mutable)",
+      "supports": [
+        "Profile boot order; built-in web/headless profile templates versus new arbitrary base-only profiles.",
+        "dsh plugin forwards to pnpm and reconciles dsh.bundle manifests.",
+        "--dump-config is a configuration inspection step, not an application boot test."
+      ],
+      "read_scope": "Full extracted CLI reference.",
+      "retrieval_method": "Exa MCP web_search_exa and/or web_fetch_exa",
+      "retrieved_on": "2026-09-07",
+      "evidence_status": "official_content_read",
+      "runtime_tested_in_this_subtask": false
+    }
+  ]
+}

package/docs/host-validation.json

@@ -0,0 +1,298 @@
+{
+  "schema_version": 1,
+  "checked_on": "2026-09-11",
+  "scope": "Four-host artifacts, choreography contracts and actual shared stdio MCP. This is not a paid host research run.",
+  "host_first_review": {
+    "checked_on": "2026-09-13",
+    "method": "Exa search and page extraction through the current plugin CLI",
+    "scope": "Host collaboration, MCP/Skill access, and host-first research routing; not four-host end-to-end execution",
+    "origin_freshness": "not_established",
+    "completeness": "unknown",
+    "runtime_tested": false,
+    "local_validation": {
+      "unit_tests_passed": 369,
+      "skill_and_plugin_validation": "passed",
+      "installed_stdio": {
+        "version": "0.4.0+codex.20260913140145",
+        "matching_export_files": 61,
+        "tool_count": 35,
+        "routing_cases_passed": 5,
+        "network_calls": 0,
+        "database_created": false,
+        "research_execution_started": false
+      },
+      "four_host_end_to_end": "not_run"
+    },
+    "rechecked_source_ids_with_unchanged_hashes": ["W3", "W7"],
+    "sources": [
+      {
+        "id": "W12",
+        "url": "https://developers.openai.com/codex/subagents",
+        "sha256": "9e1693a5eb5d6877f43d84a67a33544e37553801191bb6915b8295f2b3135de2",
+        "read_scope": "Availability, native orchestration, delegation rules and parent configuration inheritance"
+      },
+      {
+        "id": "W13",
+        "url": "https://code.claude.com/docs/en/sub-agents",
+        "sha256": "2d6849d3924a109422d5c9a9429f20fb488ee78eb4dd9acc7057e6f7d3e70175",
+        "read_scope": "Ordinary subagents, available tools/MCP filters, Skill preloading and child context"
+      },
+      {
+        "id": "W14",
+        "url": "https://code.claude.com/docs/en/agent-teams",
+        "sha256": "7fcf71d3490d7f02610e09ee32125c433d713e7b55bfc698d43c84ba9b4dc0f9",
+        "read_scope": "Experimental enablement, shared tasks, messaging and teammate context/MCP/Skill settings"
+      },
+      {
+        "id": "W15",
+        "url": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/docs/usage.md",
+        "sha256": "b6f36be5d035ce9cf50aaf3e15ac2176613fb8e0f55be8f6f8730c4bac66cd2b",
+        "read_scope": "Resource/tool options and design principles excluding built-in MCP and subagents"
+      },
+      {
+        "id": "W16",
+        "url": "https://github.com/earendil-works/pi/tree/main/packages/coding-agent/examples/extensions/subagent",
+        "sha256": "41ee13a3c03d188240ccc6ea3361c325da33237c215f8923e3b2439e98a7ece2",
+        "read_scope": "Official extension example: isolated subprocesses, single/parallel/chain modes and tool configuration"
+      }
+    ]
+  },
+  "sources": [
+    {
+      "id": "W1",
+      "url": "https://code.claude.com/docs/en/workflows",
+      "retrieved_at": "2026-09-10T14:47:37.789660+00:00",
+      "method": "Exa saved page extraction",
+      "content_kind": "provider_extracted_text",
+      "sha256": "279959e978889d5436be24945aa72f9553fed84c4193ffa6b0c62d4a1d8e3bea",
+      "completeness": "unknown",
+      "origin_freshness": "not_established",
+      "runtime_verification": false
+    },
+    {
+      "id": "W2",
+      "url": "https://claude.com/blog/introducing-dynamic-workflows-in-claude-code",
+      "retrieved_at": "2026-09-10T14:47:37.789660+00:00",
+      "method": "Exa saved page extraction",
+      "content_kind": "provider_extracted_text",
+      "sha256": "04ee8d82a1b4ea47714d88a29e259374ebecb8544c285d18f89838687d497914",
+      "completeness": "unknown",
+      "origin_freshness": "not_established",
+      "runtime_verification": false
+    },
+    {
+      "id": "W3",
+      "url": "https://developers.openai.com/codex/concepts/customization",
+      "retrieved_at": "2026-09-10T14:47:37.789660+00:00",
+      "method": "Exa saved page extraction",
+      "content_kind": "provider_extracted_text",
+      "sha256": "80289c50c991d4ad054a4d4aee4d78fa89b88d010e1a57da543ba4fb56278dee",
+      "completeness": "unknown",
+      "origin_freshness": "not_established",
+      "runtime_verification": false
+    },
+    {
+      "id": "W4",
+      "url": "https://developers.openai.com/codex/workflows",
+      "retrieved_at": "2026-09-10T14:47:37.789660+00:00",
+      "method": "Exa saved page extraction",
+      "content_kind": "provider_extracted_text",
+      "sha256": "7bc97bc8d609c5bfa5df58b1c4248d1b58882023b8ab8aaa904941432c682064",
+      "completeness": "unknown",
+      "origin_freshness": "not_established",
+      "runtime_verification": false
+    },
+    {
+      "id": "W5",
+      "url": "https://pi.dev/packages/pi-subagents-workflows",
+      "retrieved_at": "2026-09-10T14:47:37.789660+00:00",
+      "method": "Exa saved page extraction",
+      "content_kind": "provider_extracted_text",
+      "sha256": "4e7a662a251d0ae7b530731133725f77746661b05d8b2d2e4af42f470b7876d2",
+      "completeness": "unknown",
+      "origin_freshness": "not_established",
+      "runtime_verification": false
+    },
+    {
+      "id": "W6",
+      "url": "https://github.com/nicobailon/pi-subagents",
+      "retrieved_at": "2026-09-10T14:47:37.789660+00:00",
+      "method": "Exa saved page extraction",
+      "content_kind": "provider_extracted_text",
+      "sha256": "9d97907a09bb7cbe110186898c81a92be388a4a69b9fab1f1c0cedefd474e9b2",
+      "completeness": "unknown",
+      "origin_freshness": "not_established",
+      "runtime_verification": false
+    },
+    {
+      "id": "W7",
+      "url": "https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/workflow",
+      "retrieved_at": "2026-09-10T14:47:37.789660+00:00",
+      "method": "Exa saved page extraction",
+      "content_kind": "provider_extracted_text",
+      "sha256": "2b18104e3631bf2e2db68c41e400d936259115bc8236333efd54d9c8eea02eff",
+      "completeness": "unknown",
+      "origin_freshness": "not_established",
+      "runtime_verification": false
+    },
+    {
+      "id": "W8",
+      "url": "https://github.com/deepseek-ai/deepseek-harness/blob/master/packages/workflow/tool-workflow/README.md",
+      "retrieved_at": "2026-09-10T14:47:37.789660+00:00",
+      "method": "Exa saved page extraction",
+      "content_kind": "provider_extracted_text",
+      "sha256": "31676b24d65c6ca5bbcda1a777ee77854b3894700edaedc4f4afd92a9da52fb3",
+      "completeness": "unknown",
+      "origin_freshness": "not_established",
+      "runtime_verification": false
+    }
+  ],
+  "supplementary_sources": [
+    {
+      "id": "W9",
+      "url": "https://learn.chatgpt.com/docs/agent-configuration/subagents",
+      "read_on": "2026-09-11",
+      "content_kind": "html",
+      "sha256": "2ef3debd56838912b1198c4e327c930fca2f75f1978487a57499161fc52e5033",
+      "completeness": "unknown"
+    },
+    {
+      "id": "W10",
+      "url": "https://github.com/nicobailon/pi-subagents/blob/main/docs/workflows.md",
+      "read_on": "2026-09-11",
+      "content_kind": "raw_markdown",
+      "sha256": "9d11adb32bd743ee3320b6ecca544d17165177daf55abdd1c375d9182a83f33d",
+      "completeness": "unknown"
+    },
+    {
+      "id": "W11",
+      "url": "https://github.com/nicobailon/pi-subagents/blob/main/docs/tool-reference.md",
+      "read_on": "2026-09-11",
+      "content_kind": "raw_markdown",
+      "sha256": "9507f30e4013d0967431be18c65b292727bc67351cb987b7a0a8130d831f8017",
+      "completeness": "unknown"
+    }
+  ],
+  "local_capabilities": {
+    "codex": {
+      "version": "0.153.4",
+      "multi_agent": {
+        "stability": "stable",
+        "enabled": true
+      },
+      "session_tools_still_required": true,
+      "installed_plugin_verification": {
+        "base_version": "0.3.0",
+        "marketplace": "personal",
+        "backup_hashes_verified": true,
+        "mcp_transport": "actual installed-cache stdio",
+        "mcp_tool_count": 34,
+        "non_manifest_file_hashes_matched": 36,
+        "codex_host_assets_matched": 3,
+        "cli_fts5": true,
+        "read_only_tool_calls": ["research_route", "research_services"],
+        "network_calls": 0,
+        "database_created": false,
+        "new_thread_required": true
+      },
+      "delegated_skill_acceptance": {
+        "input": "Fresh synthetic canvas; expected answers not read",
+        "bookmark_instances": 7,
+        "original_urls": 6,
+        "local_documents_reviewed": 5,
+        "metadata_claims": 6,
+        "wiki_pages": 2,
+        "accounted_urls": 6,
+        "original_pages_reviewed": 0,
+        "research_status": "incomplete",
+        "input_and_evidence_hashes_verified": true,
+        "provider_calls": 0,
+        "additional_verifier": "Host thread limit reached; disclosed same-agent second review",
+        "live_web_research_verified": false
+      }
+    },
+    "claude": {
+      "version": "2.1.247",
+      "manifest_validation": {
+        "command": "claude plugin validate --strict <temporary-export>",
+        "exit_code": 0,
+        "warnings": 0,
+        "result": "Validation passed",
+        "scope": "Native plugin manifest; not execution of workflow code"
+      },
+      "account_workflow_access_verified": false,
+      "live_client_attempt": {
+        "plugin_loaded": true,
+        "mcp_connected": true,
+        "mcp_tool_count": 34,
+        "workflow_tool_visible": true,
+        "packaged_workflow_command_visible": true,
+        "synthetic_input_urls": 2,
+        "synthetic_bookmark_instances": 3,
+        "initial_isolated_launch": "User authentication was not loaded",
+        "existing_configuration_launch": "Configured model endpoint returned 429 / Service Unavailable",
+        "subagents_started": 0,
+        "reported_cost_usd": 0,
+        "native_workflow_execution_passed": false,
+        "global_configuration_changed": false
+      }
+    },
+    "pi": {
+      "found_in_path": false,
+      "node_version": "22.17.0",
+      "required_node_version": "22.19.0",
+      "required_pi_version": "0.83",
+      "required_pi_subagents_version": "0.43.0",
+      "required_extensions": [
+        "pi-subagents",
+        "pi-subagents-workflows"
+      ],
+      "native_workflow_validator_run": false
+    },
+    "dsh": {
+      "found_in_path": false,
+      "profile_configured": false,
+      "native_workflow_run": false
+    }
+  },
+  "checks": [
+    {
+      "command": "python3 -B -m unittest discover -s tests -p test_host_workflows.py -v",
+      "status": "passed",
+      "tests": 8,
+      "nested_isolated_javascript_checks": 36
+    },
+    {
+      "name": "complete_inventory",
+      "transport": "actual local stdio MCP",
+      "input": "synthetic 207-URL package",
+      "result": "Every page and unique u- ID preserved; groups flatten to the complete inventory; agents_started=0"
+    },
+    {
+      "name": "complete_analysis_artifact",
+      "transport": "actual local stdio MCP",
+      "result": "207 IDs plus child failures persisted as a JSON object outside the package, read back unchanged, SHA-256 verified, replay idempotent"
+    },
+    {
+      "name": "project_registration",
+      "result": "Pi project-scoped registration is idempotent; differing existing definitions and symlinks are preserved and rejected"
+    },
+    {
+      "name": "isolated_choreography",
+      "result": "Reading/verification barriers, complete differences, child failures, fatal errors and full artifact requirements checked using simulated native hooks; Pi forbids nested async helpers"
+    }
+  ],
+  "boundaries": {
+    "global_configuration_changed": false,
+    "host_extensions_installed": false,
+    "paid_model_runs_started": 0,
+    "source_package_write_authorized": false,
+    "complete_paid_host_end_to_end": "not_run",
+    "limits": [
+      "Mutable source branches and provider-extracted text are not pinned host releases or proof of whole-page completeness.",
+      "Pi and DSH were not installed; Node is below the Pi workflow requirement.",
+      "Codex feature state and Claude manifest validation do not prove native tools or account access in an arbitrary session.",
+      "Local correlation IDs beginning local: are not native host run IDs."
+    ]
+  }
+}