@passioncode-ai/passioncode 0.1.25 → 0.1.27

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 0.1.27 - 2026-10-04
+
+### Changed
+
+- **Fabric Agent Adapter is pinned at `v0.6.3`** (it was `v0.6.2`). `building-fabric-services`
+  and `creating-fabric-agents` say that every credential an agent or service uses comes from
+  Project Observatory, by name: `use_secret.py run --vault-only` for an agent, `use_secret.py
+  serve` for a long-running service, never a `.env` or a key file beside it.
+
+## 0.1.26 - 2026-10-04
+
+### Changed
+
+- **Observatory Log is pinned at `v0.15.0`** (plugin 0.15.0; it was `v0.13.0`, plugin 0.14.0),
+  the Project Observatory 0.15.0 skills. `handling-secrets` gains the header door: `use_secret.py
+  header` hands one HTTP MCP server's bearer to Claude Code's `headersHelper`, from the vault only
+  and only to the server the slot is bound to with `vault.py bind --header-for`. Agents and
+  services take every credential from Observatory by name (`use_secret.py run --vault-only`).
+
 ## 0.1.25 - 2026-10-03
 
 ### Changed

package/family.json

@@ -8,7 +8,7 @@
       "name": "fabric-agent-adapter",
       "displayName": "Fabric Agent Adapter",
       "repo": "passioncode-ai/fabric-agent-adapter",
-      "ref": "v0.6.2",
+      "ref": "v0.6.3",
       "kind": "plugin",
       "path": "plugins/fabric-agent-adapter",
       "legacyPluginIds": [
@@ -22,7 +22,7 @@
       "name": "observatory-log",
       "displayName": "Observatory Log",
       "repo": "passioncode-ai/project-observatory-dashboard",
-      "ref": "v0.13.0",
+      "ref": "v0.15.0",
       "kind": "plugin",
       "path": "observatory/engine/skill/plugins/observatory-log",
       "legacyPluginIds": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@passioncode-ai/passioncode",
-  "version": "0.1.25",
+  "version": "0.1.27",
   "description": "The PassionCode.ai agent skill set \u2014 Fabric Agent Adapter, Observatory Log and the organisation's working rules \u2014 for Claude Code and every other agent on the machine, updated as one set.",
   "bin": {
     "passioncode": "bin/passioncode.js"

package/payload/.claude-plugin/marketplace.json

@@ -11,7 +11,7 @@
       "name": "fabric-agent-adapter",
       "displayName": "Fabric Agent Adapter",
       "source": "./plugins/fabric-agent-adapter",
-      "version": "0.6.2",
+      "version": "0.6.3",
       "description": "Create new Fabric-compatible agents, build them as always-alive local services with dashboards (fabric-service/0.1), and adapt existing projects to the Fabric Agent Contract through evidence-backed MCP, A2A, or local-runner provider bundles.",
       "author": {
         "name": "PassionCode.ai",
@@ -23,7 +23,7 @@
       "name": "observatory-log",
       "displayName": "Observatory Log",
       "source": "./plugins/observatory-log",
-      "version": "0.14.0",
+      "version": "0.15.0",
       "description": "Records what changed in a watched project at the end of every turn, and asks for the one thing a diff cannot contain: why.",
       "author": {
         "name": "PassionCode.ai",
@@ -35,7 +35,7 @@
       "name": "passioncode",
       "displayName": "PassionCode.ai",
       "source": "./plugins/passioncode",
-      "version": "0.1.25",
+      "version": "0.1.27",
       "description": "The organisation's working rules for every contributor's agent (working-in-passioncode), and a once-a-day check that keeps the PassionCode.ai set current.",
       "author": {
         "name": "PassionCode.ai",

package/payload/manifest.json

@@ -1,15 +1,15 @@
 {
   "family": "passioncode",
-  "version": "0.1.25",
+  "version": "0.1.27",
   "release": true,
   "members": [
     {
       "name": "fabric-agent-adapter",
       "displayName": "Fabric Agent Adapter",
       "repo": "passioncode-ai/fabric-agent-adapter",
-      "ref": "v0.6.2",
-      "commit": "4b435baac85e343b530af86d56f8b75ac406bc43",
-      "version": "0.6.2",
+      "ref": "v0.6.3",
+      "commit": "30a1148ba77fe9ed56ea98c218d10ccf2fadf084",
+      "version": "0.6.3",
       "via": "clone of https://***@github.com/passioncode-ai/fabric-agent-adapter.git",
       "skills": [
         "adapting-projects-to-fabric",
@@ -22,7 +22,7 @@
       "legacyMarketplaces": [
         "fabric-agent-adapter"
       ],
-      "contentHash": "sha256:95fab0fdf3ee1f9171fc7c07edd60313cf52ddb68bb2eb456caf1df8afde36cb",
+      "contentHash": "sha256:264191fab8632a4f720185c68f79ca74c8fba1a14e50fd2d68957a35303c9c4b",
       "description": "Create new Fabric-compatible agents, build them as always-alive local services with dashboards (fabric-service/0.1), and adapt existing projects to the Fabric Agent Contract through evidence-backed MCP, A2A, or local-runner provider bundles.",
       "author": {
         "name": "PassionCode.ai",
@@ -34,9 +34,9 @@
       "name": "observatory-log",
       "displayName": "Observatory Log",
       "repo": "passioncode-ai/project-observatory-dashboard",
-      "ref": "v0.13.0",
-      "commit": "c7a89125edcd5ee1a8141feb55d4aca2c828e834",
-      "version": "0.14.0",
+      "ref": "v0.15.0",
+      "commit": "acca5c9d293a388cd53d3a2cbdbfabf574308bb4",
+      "version": "0.15.0",
       "via": "clone of https://***@github.com/passioncode-ai/project-observatory-dashboard.git",
       "skills": [
         "explaining-changes",
@@ -49,7 +49,7 @@
       "legacyMarketplaces": [
         "observatory-log"
       ],
-      "contentHash": "sha256:3e1218586122889649881d94fdf892f6a51782dc748c26127a9969376ecdf1eb",
+      "contentHash": "sha256:523f50d6be43845f0ed2b5d497bac17752cbfd3333627a235ab457618cd86dd3",
       "description": "Records what changed in a watched project at the end of every turn, and asks for the one thing a diff cannot contain: why.",
       "author": {
         "name": "PassionCode.ai",
@@ -61,16 +61,16 @@
       "name": "passioncode",
       "displayName": "PassionCode.ai",
       "repo": "passioncode-ai/passioncode",
-      "ref": "v0.1.25",
+      "ref": "v0.1.27",
       "commit": null,
-      "version": "0.1.25",
+      "version": "0.1.27",
       "via": "this repository",
       "skills": [
         "working-in-passioncode"
       ],
       "legacyPluginIds": [],
       "legacyMarketplaces": [],
-      "contentHash": "sha256:2212b2e2a6c017fe75dfa59b5941bf0247277decca8431d4e614a10770053bde",
+      "contentHash": "sha256:91e32c96a96c8c9cecd011b75074f99e90a8df354169a892658ca15931efe434",
       "description": "The organisation's working rules for every contributor's agent (working-in-passioncode), and a once-a-day check that keeps the PassionCode.ai set current.",
       "author": {
         "name": "PassionCode.ai",

package/payload/plugins/fabric-agent-adapter/.claude-plugin/plugin.json

@@ -3,7 +3,7 @@
   "name": "fabric-agent-adapter",
   "displayName": "Fabric Agent Adapter",
   "description": "Create new Fabric-compatible agents, build them as always-alive local services with dashboards (fabric-service/0.1), and adapt existing projects to the Fabric Agent Contract through evidence-backed MCP, A2A, or local-runner provider bundles.",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "author": {
     "name": "PassionCode.ai",
     "url": "https://passioncode.ai/"

package/payload/plugins/fabric-agent-adapter/skills/adapting-projects-to-fabric/SKILL.md

@@ -5,7 +5,7 @@ license: AGPL-3.0-only OR LicenseRef-PassionCode-Commercial
 compatibility: Requires filesystem access and Python 3.9+. Exact schema checks additionally need git, Node.js, pnpm, and the pinned fabric-agent-contract checkout (a public repository). Works without those tools in an explicitly degraded structural-check mode.
 metadata:
   author: PassionCode.ai
-  version: "0.6.2"
+  version: "0.6.3"
   contract-version: "0.1.0"
   contract-commit: "2ce392291c6668598d12cd38327e24696b5ca15c"
 ---

package/payload/plugins/fabric-agent-adapter/skills/building-fabric-services/SKILL.md

@@ -15,7 +15,7 @@ license: AGPL-3.0-only OR LicenseRef-PassionCode-Commercial
 compatibility: Python 3.9+ or Node.js 20+ for the kits; the probe needs Python 3.9+. launchd steps are macOS-only (Linux services use lifecycle manager none until a systemd adapter exists). Dashboard handoff optionally uses Fabric Dashboards MCP link/host_status/open; without it, report unresolved host capability. The contract checkout is optional.
 metadata:
   author: PassionCode.ai
-  version: "0.6.2"
+  version: "0.6.3"
   contract-version: "0.1.0"
   extension: "fabric-service/0.1"
   extension-commit: "2ce392291c6668598d12cd38327e24696b5ca15c"
@@ -101,8 +101,12 @@ are in [`scripts/fabric_interop.py`](scripts/fabric_interop.py) and
    digest and the process start time. *(A service ran on stale code after an edit and
    burned budget; nothing showed which build was answering.)*
 5. **State outside code.** Data and config in `~/Library/Application Support/<id>/`,
-   logs in `~/Library/Logs/<id>/`, cache in `~/Library/Caches/<id>/`; secrets in a 0600
-   file. Never inside the service's own code checkout or a release directory; a
+   logs in `~/Library/Logs/<id>/`, cache in `~/Library/Caches/<id>/`; the service's own
+   access token in a 0600 file it generates (principle 6). **Every provider credential the
+   service uses comes from Project Observatory, by name** — the plist starts the service
+   with `use_secret.py serve --consumer <label> <project> <NAME>[,<NAME>] -- <command>`, which
+   reads the vault only and records the consumer so a rotation names it; never a copy of a
+   key in a `.env`, a config file or the plist. Never inside the service's own code checkout or a release directory; a
    repository that versions the data itself is a store and is fine — declare
    `source.repository` so the probe can tell them apart. *(Deleting a checkout left a
    plist launchd retried every 10 s, and the data went with it.)*
@@ -254,7 +258,10 @@ things change and the kits implement each:
    example is [`scripts/sample-remote-service.mjs`](scripts/sample-remote-service.mjs): it runs
    with its own TLS or behind a platform router.
 2. **Secrets live on the platform:** the service token and the session key (32 bytes) are
-   platform secrets, never in the repository, a URL or an argument vector.
+   platform secrets, never in the repository, a URL or an argument vector. A provider key the
+   remote service needs is issued and kept in Project Observatory, pushed to the platform, and
+   the movement recorded with `vault.py moved --at <provider>`, so the platform's copy is
+   known rather than invisible.
 3. **Register it on the operator's computer** — the installer side, run there:
    `registerRemote({ id, name, origin, token })` / `register_remote(...)` writes the token file
    (0600) and the descriptor; pass the token from a file or stdin, never in argv. Public names

package/payload/plugins/fabric-agent-adapter/skills/creating-fabric-agents/SKILL.md

@@ -5,7 +5,7 @@ license: AGPL-3.0-only OR LicenseRef-PassionCode-Commercial
 compatibility: Requires filesystem access and Python 3.9+. Exact schema checks additionally need git, Node.js, pnpm, and the pinned fabric-agent-contract checkout (a public repository). Works without those tools in an explicitly degraded structural-check mode. Ships in one plugin with adapting-projects-to-fabric, whose scripts it reuses.
 metadata:
   author: PassionCode.ai
-  version: "0.6.2"
+  version: "0.6.3"
   contract-version: "0.1.0"
   contract-commit: "2ce392291c6668598d12cd38327e24696b5ca15c"
 ---
@@ -94,6 +94,13 @@ first commit:
 - an `AGENTS.md` that opens with the template's *Read first* block and closes with *After work*,
   and a `CLAUDE.md` whose first line is `@AGENTS.md`.
 
+**Every credential the agent uses comes from Project Observatory, by name**, from its first
+commit: the README's Configure section lists key NAMES; the agent finds them with
+`observatory_credentials` and runs with `use_secret.py run --vault-only` (a long-running
+service: `use_secret.py serve`), with `OBSERVATORY_VAULT_ONLY=1` in its environment. No `.env`
+of its own, no key file beside its data, no value in code, configuration or a commit. A
+workflow names the keys it needs in its checkpoint (`credentials`), never their values.
+
 org-index `scripts/check_format.py` reports 0 findings for it before it is called done. **An agent
 someone builds for themselves is not a PassionCode.ai repository:** its licence is its owner's
 choice, nothing about it is published or listed by the organization, and none of these files is

package/payload/plugins/observatory-log/.claude-plugin/plugin.json

@@ -3,7 +3,7 @@
   "name": "observatory-log",
   "displayName": "Observatory Log",
   "description": "Records what changed in a watched project at the end of every turn, and asks for the one thing a diff cannot contain: why.",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "license": "AGPL-3.0-only OR LicenseRef-PassionCode-Commercial",
   "author": {
     "name": "PassionCode.ai",

package/payload/plugins/observatory-log/skills/explaining-changes/SKILL.md

@@ -15,7 +15,7 @@ description: >-
   decision with different evidence.
 license: AGPL-3.0-only OR LicenseRef-PassionCode-Commercial
 metadata:
-  version: "0.14.0"
+  version: "0.15.0"
 compatibility: >-
   Requires an initialized full Project Observatory installation to persist
   records. Uses its MCP server when available in the current host; the bundled

package/payload/plugins/observatory-log/skills/handling-secrets/SKILL.md

@@ -3,13 +3,14 @@ name: handling-secrets
 description: >-
   Use when an agent needs to store, use, rotate or record exposure of a project's
   credentials through Project Observatory: "use a secret", "rotate a key",
-  "record a leak", «используй ключ», «ротируй ключ», «запиши утечку».
+  "record a leak", "give an agent its keys", «используй ключ», «ротируй ключ»,
+  «запиши утечку», «ключи для агента».
   Keeps credential values out of prompts and command arguments, uses named slots,
   and records changes without copying values into reports. NOT for granting
   provider permissions or choosing a project's authentication architecture.
 license: AGPL-3.0-only OR LicenseRef-PassionCode-Commercial
 metadata:
-  version: "0.14.0"
+  version: "0.15.0"
 compatibility: >-
   Requires an initialized full Project Observatory installation, Python 3.11+
   and local shell access on macOS or Linux. Provider operations additionally
@@ -29,7 +30,7 @@ names. Never ask the user to paste a credential into the conversation.
 2. Select the user's initialized `OBSERVATORY_HOME`. Run
    `project-observatory full doctor`. A missing workspace
    needs the documented onboarding before secret operations.
-3. Run `"$OBSERVATORY_PYTHON" "$OBSERVATORY_ROOT/tools/skill_check.py" handling-secrets 0.14.0`
+3. Run `"$OBSERVATORY_PYTHON" "$OBSERVATORY_ROOT/tools/skill_check.py" handling-secrets 0.15.0`
    (`full agent install` records that interpreter; the stock macOS `python3` is too old).
    If stale, read the installed skill once and follow its compatible commands.
    Do not turn an unavailable version check into a retry loop.
@@ -50,8 +51,10 @@ for it. A name or note shaped like a credential is refused, never stored.
 |---|---|
 | Store a credential supplied locally | `vault.py put PROJECT ENV NAME`, value on stdin |
 | List slots | `vault.py list PROJECT ENV` |
-| Run a command using a slot | `use_secret.py run [--env ENV] PROJECT NAME -- COMMAND ARGUMENTS` (flags before PROJECT) |
+| Run a command using a slot | `use_secret.py run [--env ENV] [--vault-only] PROJECT NAME -- COMMAND ARGUMENTS` (flags before PROJECT) |
 | Receive a value from another local command | `use_secret.py pipe NAME -- COMMAND ARGUMENTS` |
+| Bind a slot to the one MCP server allowed to receive it as a header (the operator, once) | `vault.py bind PROJECT ENV NAME --header-for https://HOST[:PORT]` (a bare host means https); `--clear` removes it; both are journalled |
+| Give an HTTP MCP server its bearer through Claude Code's `headersHelper` | `use_secret.py header [--env ENV] [--name Authorization] [--scheme Bearer] PROJECT NAME`, written into the server's `headersHelper` entry, never run by hand |
 | Populate a project's ignored environment file | `vault.py inject PROJECT ENV DIRECTORY` |
 | Record an exposure | `vault.py leak PROJECT ENV NAME --where "location and evidence, no value"` |
 | Replace a stored value | `vault.py rotate PROJECT ENV NAME`, replacement on stdin |
@@ -77,10 +80,50 @@ not a sandbox: a child process can encode a value, transmit it, or write it to
 another file. Only run the command authorized by the task. Do not claim this
 filter prevents every leak.
 
+**The header door prints a value, so it serves only Claude Code.** `use_secret.py
+header` writes one JSON object (`{"Authorization": "Bearer …"}`) for a
+`headersHelper`, which Claude Code merges into the MCP request rather than the
+conversation. It reads the vault only (never an env file or the environment), and
+refuses unless stdout is a program, `CLAUDE_CODE_MCP_SERVER_URL` names the scheme,
+host and port the slot is bound to, and the value has no control character. Never
+run it yourself, pipe it, or set `CLAUDE_CODE_MCP_SERVER_URL` to make it answer:
+that prints the value into your transcript. Each call is audited. Binding is the
+operator's decision; ask for it, do not run `bind` to make a call succeed.
+
 **Stdin carries one thing.** Never pipe a secret into `python3 -`, `node -` or
 `sh -s`, or combine a secret pipe with a heredoc program. A program goes in a
 file; the secret goes through the named runner. A parse error can echo input.
 
+## Building an agent or a service
+
+**Every credential an agent or a service uses comes from Project Observatory, by
+name.** That holds for a one-shot agent, a long-running agent service and code an
+agent writes for one. Concretely:
+
+- **Issue or store it here.** A provider door issues straight into a slot; a value
+  the user has goes in with `vault.py put PROJECT ENV NAME` (value on stdin).
+- **Discover it by name.** `observatory_credentials` (MCP) or `use_secret.py names
+  PROJECT` list what exists; neither returns a value.
+- **Inject it at run time, from the vault only.** A command: `use_secret.py run
+  --vault-only [--env ENV] PROJECT NAME -- COMMAND`. A long-running service (a launchd
+  job): `use_secret.py serve [--env ENV] --consumer LABEL PROJECT NAME[,NAME] -- COMMAND` in
+  its plist — it replaces itself with the service and records the consumer, so `vault.py
+  rotate` names the services to restart. Set `OBSERVATORY_VAULT_ONLY=1` in an agent's
+  environment so every command it runs refuses a project's `.env` fallback.
+- **No copies.** No `.env` of the agent's own, no key file beside its data, no value
+  in code, configuration, a commit, a prompt, a log or agent memory. A remote
+  platform's copy is recorded with `vault.py moved PROJECT ENV NAME --at PROVIDER`.
+- **Declare what a workflow needs.** A checkpoint carries `credentials: [{project,
+  env, name, purpose}]` — names only, a value is refused. A handoff and its
+  acceptance report each one as `vault`, `env-only` (works, and breaks this rule)
+  or `missing`, with the command to use or store it, and `credentialsMissing` stops
+  the next executor before the step that would fail.
+
+A value written into agent memory by mistake is replaced on the way in by a
+marker that names its slot (`[redacted:vault:PROJECT/ENV/NAME]`); treat that as an
+exposure and record it with `vault.py leak`. The design is
+[AGENT-SECRETS.md](https://github.com/passioncode-ai/project-observatory-dashboard/blob/main/docs/design/AGENT-SECRETS.md).
+
 ## Provider integrations
 
 Cloudflare and OpenRouter have separate tools, `cloudflare.py` and

package/payload/plugins/observatory-log/skills/tracking-resources/SKILL.md

@@ -15,7 +15,7 @@ description: >-
   the repository.
 license: AGPL-3.0-only OR LicenseRef-PassionCode-Commercial
 metadata:
-  version: "0.14.0"
+  version: "0.15.0"
 compatibility: >-
   Requires a full Project Observatory installation with organizations.json
   configured; the observatory MCP server or its local CLI. Creating the resource

package/payload/plugins/passioncode/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "passioncode",
   "displayName": "PassionCode.ai",
-  "version": "0.1.25",
+  "version": "0.1.27",
   "description": "The organisation's working rules for every contributor's agent (working-in-passioncode), and a once-a-day check at session start that keeps the PassionCode.ai skill set current.",
   "author": {
     "name": "PassionCode.ai",