@passioncode-ai/passioncode 0.1.27 → 0.1.29

package/CHANGELOG.md

@@ -1,5 +1,54 @@
 # Changelog
 
+## 0.1.29 - 2026-10-05
+
+### Changed
+
+- **Observatory Log is pinned at `v0.17.3`** (plugin 0.17.3; it was `v0.16.0`). Its
+  SessionStart hook keeps Project Observatory current:
+  - for an engine at 0.17.0 or later, it schedules the engine's hourly maintenance job where
+    it is missing;
+  - for an engine from 0.7.0 to 0.16.0, which has no updater of its own, it installs the newer
+    release once a day with that engine's `full update --apply`, unless the person turned
+    automatic updates off.
+
+  Both run detached, at most every six hours or once a day, and never hold up a session.
+
+## 0.1.28 - 2026-10-05
+
+The launcher meets the organization's
+[product lifecycle contract](https://github.com/passioncode-ai/fabric-workspace/blob/main/knowledge/lifecycle.md):
+findings F13, F14, F15 and F17 of the 2026-10-03 lifecycle audit. Observatory Log moves to
+Project Observatory 0.16.0.
+
+### Changed
+
+- **Observatory Log is pinned at `v0.16.0`** (plugin 0.16.0; it was `v0.15.0`, plugin 0.15.0),
+  the Project Observatory 0.16.0 skills. The skills' text is unchanged and follows the release:
+  agent memory now checks an access binding on every call, embeds remotely only with the
+  operator's per-project consent, and can be erased with a receipt (`full forget`).
+
+### Fixed
+
+- **One update at a time (LC-03, F14).** `update`, `restore` and `uninstall` take
+  `~/.passioncode/update.lock`; a second one refuses with exit 1 and names the holder, so a
+  background update and a manual one no longer interleave their `claude plugin` writes.
+- **One `npm view` for sessions started together (F13).** The SessionStart hook claims
+  `~/.passioncode/probe.pending` before it starts the probe; the probe removes it after recording,
+  and a marker older than five minutes is taken over.
+- **Releases no longer accumulate (LC-11, LC-15, F15).** An update keeps the release it installed
+  and the one it replaced, and removes older releases and partial copies left by a killed update
+  (`prune` step; a dry run plans it).
+- **A release proves its provenance (F17).** `vendor --release` refuses a member whose tag does not
+  name the plugin version it carries. A member whose repository's tags version another product
+  may declare `refVersions: "repository"` with the plugin `version` it expects; the bytes at that
+  tag must carry that version, and the manifest records `refVersions` so the pair reads as the
+  repository's release, not the plugin's. No member declares it yet: at the current pins every tag
+  names its plugin version (Observatory Log `v0.16.0` carries 0.16.0), and whether Observatory Log
+  should use it when the two diverge again is the open operator decision PC-04.
+- `AGENTS.md` gains a `## Lifecycle` section: the background footprint with the SessionStart
+  hook's cost and cadence (LC-09) and build retention (LC-15).
+
 ## 0.1.27 - 2026-10-04
 
 ### Changed

package/COMMERCIAL-LICENSE.md

@@ -5,7 +5,7 @@ This repository is open source under the [GNU Affero General Public License v3.0
 meet the AGPL's terms — for example inside a closed-source product, or as a modified hosted
 service whose source is not published.
 
-To obtain a commercial license, write to **contact@passioncode.ai**.
+To obtain a commercial license, tell us about your use at **https://passioncode.ai/business/**, or write to **commercial@passioncode.ai**.
 
 SPDX: `AGPL-3.0-only OR LicenseRef-PassionCode-Commercial`. Copyright (c) 2026 Siarhei Sheleh.
 Contributions are accepted under [CLA.md](CLA.md), which allows this dual licence.

package/README.md

@@ -53,7 +53,8 @@ out of it, even when they implement Fabric protocols.
 - Updates create no skill copies in `~/.claude/skills`: a plain copy there shadows the plugin. Such
   copies, and hub entries that pointed at a repository's working tree, are moved into
   `~/.passioncode/quarantine/` — `npx @passioncode-ai/passioncode@latest restore` puts them back.
-- Each version is an immutable release under `~/.passioncode/releases/<version>`.
+- Each version is an immutable release under `~/.passioncode/releases/<version>`; an update
+  keeps the release it replaced for rollback and removes older ones.
 
 ## Staying current
 
@@ -114,7 +115,7 @@ reads a member from `<dir>/<repository name>`, and `PASSIONCODE_CHECKOUT_<MEMBER
 ## License
 
 Open source under the [GNU AGPL-3.0](LICENSE). A [commercial license](COMMERCIAL-LICENSE.md) is
-available for use that does not meet the AGPL's terms — contact@passioncode.ai.
+available for use that does not meet the AGPL's terms — [passioncode.ai/business](https://passioncode.ai/business/).
 Versions before 0.1.12 were released under PolyForm Noncommercial or Internal Use (v0.1.5 to
 v0.1.11) and MIT (v0.1.4 and earlier); each keeps the licence it was released under.
 Contributions are accepted under [CLA.md](CLA.md) ([CONTRIBUTING.md](CONTRIBUTING.md)).

package/SECURITY.md

@@ -16,7 +16,9 @@ deleted: a recovery record is written before the move in
 `~/.passioncode/quarantine/<run>/moved.json`. `restore` processes the latest batch,
 checkpoints completed entries and refuses to overwrite a conflicting user replacement.
 `uninstall` removes owned links/plugins, clears the active release and disables
-automatic updates; it retains release copies and recovery records. A failed removal
+automatic updates; it retains the current and previous release copies and recovery
+records. Each update removes the launcher's own older releases (its output, reinstallable
+from npm) and keeps the one it replaced for rollback. A failed removal
 returns a nonzero exit code. See the [CLI recovery contract](docs/reference/cli.md).
 
 ## The self-update and who it trusts

package/family.json

@@ -22,7 +22,7 @@
       "name": "observatory-log",
       "displayName": "Observatory Log",
       "repo": "passioncode-ai/project-observatory-dashboard",
-      "ref": "v0.15.0",
+      "ref": "v0.17.3",
       "kind": "plugin",
       "path": "observatory/engine/skill/plugins/observatory-log",
       "legacyPluginIds": [

package/lib/launcher.js

@@ -67,6 +67,94 @@ function symlinkAtomic(target, at) {
   fs.renameSync(tmp, at);
 }
 
+// --- one update at a time (lifecycle contract LC-03) ---------------------------------------
+// update, restore and uninstall all write installed_plugins.json, the hub and state.json. A
+// background update (started by the session hook) and a manual one used to interleave their
+// `claude plugin` writes. They now take one lock; the second refuses and names the holder.
+const O_EXLOCK = 0x20; // BSD/macOS open(2) flag: take flock(LOCK_EX); absent from fs.constants
+
+class UpdateRunning extends Error {
+  constructor(pid, file) {
+    super(`Another PassionCode update is already running (${pid ? `process ${pid}` : 'another process'} holds ${file}); let it finish, then retry.`);
+    this.pid = pid;
+  }
+}
+
+function readPid(file) {
+  try { const text = fs.readFileSync(file, 'utf8').trim(); return /^\d{1,10}$/.test(text) ? Number(text) : null; } catch (_) { return null; }
+}
+
+function alive(pid) {
+  try { process.kill(pid, 0); return true; } catch (error) { return error.code === 'EPERM'; }
+}
+
+/**
+ * Take ~/.passioncode/update.lock. On macOS it is a kernel flock (released when the holder dies,
+ * so it is never stale); elsewhere an exclusively created pid file whose holder must be alive.
+ * Returns `{ release() }`; throws UpdateRunning when another process holds it.
+ */
+function acquireUpdateLock(p) {
+  fs.mkdirSync(p.state, { recursive: true });
+  const file = path.join(p.state, 'update.lock');
+  if (process.platform === 'darwin') {
+    let fd;
+    try {
+      fd = fs.openSync(file, fs.constants.O_RDWR | fs.constants.O_CREAT | O_EXLOCK | fs.constants.O_NONBLOCK, 0o600);
+    } catch (error) {
+      if (error.code === 'EAGAIN' || error.code === 'EWOULDBLOCK') throw new UpdateRunning(readPid(file), file);
+      throw error;
+    }
+    fs.ftruncateSync(fd, 0);
+    fs.writeSync(fd, String(process.pid));
+    return { release() { if (fd !== null) { fs.closeSync(fd); fd = null; } } };
+  }
+  for (let attempt = 0; attempt < 2; attempt += 1) {
+    try {
+      fs.writeFileSync(file, String(process.pid), { flag: 'wx', mode: 0o600 });
+      return { release() { if (readPid(file) === process.pid) fs.rmSync(file, { force: true }); } };
+    } catch (error) {
+      if (error.code !== 'EEXIST') throw error;
+      const pid = readPid(file);
+      if (pid && pid !== process.pid && alive(pid)) throw new UpdateRunning(pid, file);
+      // The holder is gone: move its file aside atomically, so two takers cannot both steal it.
+      try { fs.renameSync(file, `${file}.stale.${process.pid}`); fs.rmSync(`${file}.stale.${process.pid}`, { force: true }); } catch (_) { /* another taker moved it */ }
+    }
+  }
+  throw new UpdateRunning(readPid(file), file);
+}
+
+function withUpdateLock(home, fn) {
+  const lock = acquireUpdateLock(paths(home));
+  try { return fn(); } finally { lock.release(); }
+}
+
+// --- release retention (LC-11, LC-15) -----------------------------------------------------------
+const semver = (v) => v.split('.').map(Number);
+function newerVersion(a, b) {
+  const pa = semver(a), pb = semver(b);
+  for (let i = 0; i < 3; i += 1) if (pa[i] !== pb[i]) return pa[i] > pb[i];
+  return false;
+}
+
+/**
+ * The release directories an update may remove: every one except the release it installed and
+ * the one it replaced (the rollback; the newest other release when it replaced none), plus any
+ * `*.partial` copy a killed update left behind (safe: the caller holds the update lock).
+ * Files, symlinks and anything not named like a release are never touched.
+ */
+function staleReleases(p, version, previous) {
+  let entries;
+  try { entries = fs.readdirSync(p.releases, { withFileTypes: true }); } catch (_) { return []; }
+  const dirs = entries.filter((e) => e.isDirectory() && !e.isSymbolicLink()).map((e) => e.name);
+  const partial = dirs.filter((n) => /^\d+\.\d+\.\d+\.\d+\.partial$/.test(n));
+  const versions = dirs.filter((n) => /^\d+\.\d+\.\d+$/.test(n));
+  let keep = previous && versions.includes(previous) && previous !== version ? previous : null;
+  if (!keep) {
+    for (const v of versions) if (v !== version && (!keep || newerVersion(v, keep))) keep = v;
+  }
+  return [...versions.filter((v) => v !== version && v !== keep), ...partial].map((n) => path.join(p.releases, n));
+}
+
 /** Claude Code's plugin CLI, overridable for tests. */
 function claudeRunner() {
   const bin = process.env.PASSIONCODE_CLAUDE || 'claude';
@@ -303,6 +391,16 @@ function update({ home, dryRun = false, claude = claudeRunner(), log = () => {}
     }
   }
 
+  // 5. The launcher's own releases: keep this one and the one it replaced, remove the rest.
+  //    They are its own output, reinstallable from npm — not the person's files, which are
+  //    only ever moved to the quarantine.
+  const stale = staleReleases(p, version, state.installed || null);
+  if (stale.length) {
+    step('prune', `remove ${stale.map((d) => path.basename(d)).join(', ')} from ${p.releases}; keep ${version} and the release before it`, () => {
+      for (const dir of stale) fs.rmSync(dir, { recursive: true, force: true });
+    });
+  }
+
   if (!dryRun) {
     if (moved.length) writeJson(path.join(quarantineDir, 'moved.json'), moved);
     // A probe or config command may have written while the plugin CLI ran.
@@ -472,4 +570,15 @@ function uninstall({ home, claude = claudeRunner() } = {}) {
   return removed;
 }
 
-module.exports = { update, restore, status, setConfig, uninstall, paths, CHANNELS, MARKETPLACE, payloadManifest, marketplaceAddArg };
+module.exports = {
+  // An invalid payload is refused before the lock creates anything under ~/.passioncode.
+  update: (opts = {}) => {
+    if (opts.dryRun) return update(opts);
+    verifyPayload(PAYLOAD(), payloadManifest());
+    return withUpdateLock(opts.home, () => update(opts));
+  },
+  restore: (opts = {}) => withUpdateLock(opts.home, () => restore(opts)),
+  uninstall: (opts = {}) => withUpdateLock(opts.home, () => uninstall(opts)),
+  status, setConfig, paths, CHANNELS, MARKETPLACE, payloadManifest, marketplaceAddArg,
+  acquireUpdateLock, UpdateRunning, staleReleases,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@passioncode-ai/passioncode",
-  "version": "0.1.27",
+  "version": "0.1.29",
   "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

@@ -23,7 +23,7 @@
       "name": "observatory-log",
       "displayName": "Observatory Log",
       "source": "./plugins/observatory-log",
-      "version": "0.15.0",
+      "version": "0.17.3",
       "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.27",
+      "version": "0.1.29",
       "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,6 +1,6 @@
 {
   "family": "passioncode",
-  "version": "0.1.27",
+  "version": "0.1.29",
   "release": true,
   "members": [
     {
@@ -34,9 +34,9 @@
       "name": "observatory-log",
       "displayName": "Observatory Log",
       "repo": "passioncode-ai/project-observatory-dashboard",
-      "ref": "v0.15.0",
-      "commit": "acca5c9d293a388cd53d3a2cbdbfabf574308bb4",
-      "version": "0.15.0",
+      "ref": "v0.17.3",
+      "commit": "58bf0d9aabc452da95133fc561ee08d5279d6cf5",
+      "version": "0.17.3",
       "via": "clone of https://***@github.com/passioncode-ai/project-observatory-dashboard.git",
       "skills": [
         "explaining-changes",
@@ -49,7 +49,7 @@
       "legacyMarketplaces": [
         "observatory-log"
       ],
-      "contentHash": "sha256:523f50d6be43845f0ed2b5d497bac17752cbfd3333627a235ab457618cd86dd3",
+      "contentHash": "sha256:615c85cd2486ac990c04a1df834639ace0e22f2ab3d2830ccafa72453b3e0b3a",
       "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.27",
+      "ref": "v0.1.29",
       "commit": null,
-      "version": "0.1.27",
+      "version": "0.1.29",
       "via": "this repository",
       "skills": [
         "working-in-passioncode"
       ],
       "legacyPluginIds": [],
       "legacyMarketplaces": [],
-      "contentHash": "sha256:91e32c96a96c8c9cecd011b75074f99e90a8df354169a892658ca15931efe434",
+      "contentHash": "sha256:61bfba01e7a1d988d4a68b31b11cabf695996b1d4285c1518189e80bb2795adc",
       "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/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.15.0",
+  "version": "0.17.3",
   "license": "AGPL-3.0-only OR LicenseRef-PassionCode-Commercial",
   "author": {
     "name": "PassionCode.ai",

package/payload/plugins/observatory-log/hooks/session-start.sh

@@ -18,10 +18,83 @@ if [ -z "$root" ] && [ -n "${CLAUDE_PLUGIN_ROOT:-}" ]; then
     c="$n"
   done
 fi
+if [ -z "$root" ] && command -v project-observatory >/dev/null 2>&1; then
+  # Installed by the PassionCode launcher with no `full agent install`: ask the engine.
+  root="$(project-observatory full-path 2>/dev/null || true)"
+fi
 [ -n "$root" ] || exit 0
-[ -f "$root/tools/session_start.py" ] || exit 0
-py="${OBSERVATORY_PYTHON:-$root/.venv/bin/python}"   # set by `full agent install`
-[ -x "$py" ] || py="$(command -v python3 2>/dev/null)"
+[ -d "$root" ] || exit 0
+
+# The engine's own virtual environment (the ancestor holding pyvenv.cfg), so the jobs
+# below run the installed package and never whichever python3 is first on PATH.
+venv=""; c="$root"
+for _ in 1 2 3 4 5 6 7 8; do
+  [ -f "$c/pyvenv.cfg" ] && { venv="$c"; break; }
+  n="$(dirname "$c")"; [ "$n" = "$c" ] && break; c="$n"
+done
+py="${OBSERVATORY_PYTHON:-}"                              # set by `full agent install`
+[ -n "$py" ] && [ -x "$py" ] || py=""
+[ -z "$py" ] && [ -n "$venv" ] && [ -x "$venv/bin/python" ] && py="$venv/bin/python"
+[ -z "$py" ] && [ -x "$root/.venv/bin/python" ] && py="$root/.venv/bin/python"
+[ -z "$py" ] && py="$(command -v python3 2>/dev/null)"
 [ -n "$py" ] || exit 0
-printf '%s' "$payload" | "$py" "$root/tools/session_start.py" 2>/dev/null || true
+
+if [ -f "$root/tools/session_start.py" ]; then
+  printf '%s' "$payload" | "$py" "$root/tools/session_start.py" 2>/dev/null || true
+fi
+
+# Updates that arrive by themselves (docs/runs/2026-10-05-auto-update, D8). Detached and
+# rate-limited, so a session never waits for it and never fails because of it.
+stamps="${XDG_STATE_HOME:-$HOME/.local/state}/project-observatory"
+mkdir -p "$stamps" 2>/dev/null && chmod 700 "$stamps" 2>/dev/null
+# claim NAME SECONDS: true for exactly one caller per window. `mkdir` is atomic, so twenty
+# sessions starting at once start one job, not twenty (review F6).
+claim() {
+  local lock="$stamps/$1.claim" then now
+  if ! mkdir "$lock" 2>/dev/null; then
+    then="$(stat -c %Y "$lock" 2>/dev/null || stat -f %m "$lock" 2>/dev/null || echo 0)"
+    now="$(date +%s)"
+    [ $((now - then)) -ge "$2" ] || return 1
+    rmdir "$lock" 2>/dev/null; mkdir "$lock" 2>/dev/null || return 1
+  fi
+  return 0
+}
+# detach LOG CMD...: a new session of its own, so ending this session or its process group
+# cannot stop an install half-way (review F8).
+detach() {
+  local log="$1"; shift
+  "$py" -c 'import subprocess, sys
+log = open(sys.argv[1], "a")
+subprocess.Popen(sys.argv[2:], stdin=subprocess.DEVNULL, stdout=log, stderr=log, start_new_session=True)' \
+    "$log" "$@" 2>/dev/null || true
+}
+if [ -f "$root/tools/maintain.py" ]; then
+  # 0.17.0 and later: schedule the hourly job where it is missing, or run a pass where
+  # this machine has no scheduler. At most every six hours.
+  if claim maintain-hook 21600; then
+    OBSERVATORY_SYSTEM_SETUP=1 detach "$stamps/maintain-hook.log" "$py" "$root/tools/maintain.py" hook
+  fi
+else
+  # The bridge for engines from before 0.17.0, which carry no updater of their own:
+  # once a day, check; when a newer stable release exists and the person has not turned
+  # automatic updates off (`updates.auto` false), install it with `full update --apply`.
+  po=""
+  [ -n "$venv" ] && [ -x "$venv/bin/project-observatory" ] && po="$venv/bin/project-observatory"
+  [ -n "$po" ] || po="$(command -v project-observatory 2>/dev/null)"
+  if [ -n "$po" ] && claim update-bridge 86400; then
+    detach "$stamps/update-bridge.log" /bin/bash -c '
+      po="$1"; py="$2"
+      home="${OBSERVATORY_FULL_HOME:-${OBSERVATORY_HOME:-$HOME/.local/share/project-observatory-full}}"
+      off="$("$py" -c "import json,sys
+try: d=json.load(open(sys.argv[1]))
+except Exception: d={}
+print(1 if (d.get(\"updates\") or {}).get(\"auto\") is False else 0)" "$home/config/settings.json" 2>/dev/null)"
+      [ "$off" = "1" ] && { echo "$(date -u +%FT%TZ) automatic updates are off"; exit 0; }
+      "$po" full update --check >/dev/null 2>&1; rc=$?
+      echo "$(date -u +%FT%TZ) check exit $rc"
+      [ "$rc" = "10" ] || exit 0
+      "$po" full update --apply; echo "$(date -u +%FT%TZ) apply exit $?"
+    ' _ "$po" "$py"
+  fi
+fi
 exit 0

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.15.0"
+  version: "0.17.3"
 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

@@ -10,7 +10,7 @@ description: >-
   provider permissions or choosing a project's authentication architecture.
 license: AGPL-3.0-only OR LicenseRef-PassionCode-Commercial
 metadata:
-  version: "0.15.0"
+  version: "0.17.3"
 compatibility: >-
   Requires an initialized full Project Observatory installation, Python 3.11+
   and local shell access on macOS or Linux. Provider operations additionally
@@ -30,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.15.0`
+3. Run `"$OBSERVATORY_PYTHON" "$OBSERVATORY_ROOT/tools/skill_check.py" handling-secrets 0.17.3`
    (`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.
@@ -154,6 +154,16 @@ bucket's resource only. Before anything is delivered, the S3 pair must prove a
 put, a get and a delete, and must be refused a bucket list. It lands in three
 slots on stdin: `<PREFIX>_ACCESS_KEY_ID`, `<PREFIX>_SECRET_ACCESS_KEY` and
 `<PREFIX>_ENDPOINT`. A second issue rolls the same token and keeps the key id.
+The lifecycle is `--expire-days` over the whole bucket (30 when nothing else is
+given) plus one rule per repeatable `--lifecycle-rule PREFIX:DAYS`, for example
+`--lifecycle-rule staging/:2`: objects under the prefix are deleted after DAYS,
+and its unfinished multipart uploads are aborted after a day. Each run replaces
+the bucket's lifecycle with exactly that set and reads every rule back. A rule
+that could never fire is refused, such as a prefix kept longer than the
+whole-bucket rule. To change only an existing bucket's rules, run
+`cloudflare.py lifecycle --account <slug> --bucket <name> [--jurisdiction eu]
+[--expire-days N] [--lifecycle-rule PREFIX:DAYS ...]`. It mints only the setup
+token, never creates a bucket and never mints, rolls or delivers a key.
 
 An application that sends transactional email through Cloudflare Email Service
 gets `cloudflare.py issue --preset email-send --account <slug> --vault

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.15.0"
+  version: "0.17.3"
 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.27",
+  "version": "0.1.29",
   "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",

package/payload/plugins/passioncode/hooks/probe.js

@@ -6,11 +6,15 @@ const { execFile } = require('child_process');
 const fs = require('fs');
 const os = require('os');
 const path = require('path');
-const { PACKAGE, parseView, recordProbe } = require('./update-check');
+const { PACKAGE, parseView, recordProbe, releaseProbe } = require('./update-check');
 
 const DIR = process.env.PASSIONCODE_HOME || path.join(os.homedir(), '.passioncode');
 const STATE = path.join(DIR, 'state.json');
 execFile('npm', ['view', PACKAGE, 'version', 'maintainers', '_npmUser', '--json'], { timeout: 30000 }, (error, stdout) => {
+  try { record(error, stdout); } finally { releaseProbe(DIR); } // the hook claimed probe.pending before it started us
+});
+
+function record(error, stdout) {
   let state = {};
   try { state = JSON.parse(fs.readFileSync(STATE, 'utf8')); } catch (_) { /* first run */ }
   const result = parseView(stdout, error);
@@ -20,4 +24,4 @@ execFile('npm', ['view', PACKAGE, 'version', 'maintainers', '_npmUser', '--json'
   fs.writeFileSync(tmp, JSON.stringify(next, null, 2));
   fs.renameSync(tmp, STATE);
   process.stdout.write(`${next.checkedAt} ${result.checkError ? `check failed: ${result.checkError}` : result.published ? `latest ${result.latest} by ${result.maintainers.join(', ') || '(unreadable maintainers)'}` : `${PACKAGE} is not published`}\n`);
-});
+}

package/payload/plugins/passioncode/hooks/session-start.js

@@ -9,7 +9,7 @@ const { spawn } = require('child_process');
 const fs = require('fs');
 const os = require('os');
 const path = require('path');
-const { decide, loadTrust } = require('./update-check');
+const { decide, loadTrust, claimProbe, releaseProbe } = require('./update-check');
 const { rulesLine } = require('./repo-rules');
 
 const DIR = process.env.PASSIONCODE_HOME || path.join(os.homedir(), '.passioncode');
@@ -38,8 +38,9 @@ async function main() {
   const state = read(STATE, {});
   const now = Date.now();
   const age = now - Date.parse(state.checkedAt);
-  if (!Number.isFinite(age) || age < 0 || age > DAY) {
-    await detached(process.execPath, [path.join(__dirname, 'probe.js')], 'probe.log');
+  // The marker is claimed before the spawn: sessions restored together start one probe.
+  if ((!Number.isFinite(age) || age < 0 || age > DAY) && claimProbe(DIR, now)) {
+    if (!await detached(process.execPath, [path.join(__dirname, 'probe.js')], 'probe.log')) releaseProbe(DIR);
   }
   const { lines, spawn: args, stateChanges } = decide(state, loadTrust(), now);
   if (Object.keys(stateChanges).length) {

package/payload/plugins/passioncode/hooks/update-check.js

@@ -102,6 +102,38 @@ function newer(a, b) {
   return false;
 }
 
+/**
+ * One probe at a time. The probe writes `checkedAt` only when npm answers (up to 30 s), so every
+ * session that starts meanwhile saw a stale check and started its own `npm view`. The hook now
+ * claims `probe.pending` with an exclusive create BEFORE it spawns; the probe removes it after it
+ * has recorded. A marker older than PROBE_STALE_MS (or dated in the future) belongs to a probe
+ * that died: it is moved aside atomically — so two hooks cannot both take it over — and claimed.
+ */
+const PROBE_MARKER = 'probe.pending';
+const PROBE_STALE_MS = 5 * 60 * 1000;
+
+function claimProbe(dir, now = Date.now()) {
+  const file = path.join(dir, PROBE_MARKER);
+  const create = () => { fs.writeFileSync(file, new Date(now).toISOString(), { flag: 'wx', mode: 0o600 }); return true; };
+  try {
+    fs.mkdirSync(dir, { recursive: true });
+    return create();
+  } catch (error) {
+    if (error.code !== 'EEXIST') return false;
+  }
+  let age;
+  try { age = now - fs.statSync(file).mtimeMs; } catch (_) { return false; } // just released: the next session checks
+  if (age >= 0 && age < PROBE_STALE_MS) return false;
+  const aside = `${file}.stale.${process.pid}`;
+  try { fs.renameSync(file, aside); } catch (_) { return false; } // another hook took it over
+  fs.rmSync(aside, { force: true });
+  try { return create(); } catch (_) { return false; }
+}
+
+function releaseProbe(dir) {
+  fs.rmSync(path.join(dir, PROBE_MARKER), { force: true });
+}
+
 function oneLine(text) { return String(text).replace(/\s+/g, ' ').trim().slice(0, 200); }
 
 /**
@@ -144,4 +176,4 @@ function decide(state, trust, now = Date.now()) {
   return { lines, spawn, stateChanges };
 }
 
-module.exports = { PACKAGE, OIDC_PUBLISHER, TRUST_FILE, accountName, parseView, recordProbe, loadTrust, newer, decide };
+module.exports = { PACKAGE, OIDC_PUBLISHER, TRUST_FILE, PROBE_MARKER, PROBE_STALE_MS, accountName, parseView, recordProbe, loadTrust, newer, decide, claimProbe, releaseProbe };

package/payload/plugins/passioncode/skills/working-in-passioncode/SKILL.md

@@ -152,16 +152,18 @@ Fabric's workspace sync, and check the published source commit before calling it
 ## 6. Licensing and the repository standard
 
 - **Every repository** is open source under the GNU AGPL-3.0, or available under a commercial
-  license from PassionCode.ai (contact@passioncode.ai):
-  `AGPL-3.0-only OR LicenseRef-PassionCode-Commercial` (Fabric ADR-0092; the knowledge base
-  `licensing.md` owns it). Copyright: Siarhei Sheleh. No price or term is stated anywhere.
+  license from PassionCode.ai — the request form https://passioncode.ai/business/, or
+  commercial@passioncode.ai: `AGPL-3.0-only OR LicenseRef-PassionCode-Commercial` (Fabric
+  ADR-0092; the knowledge base `licensing.md` owns it). Copyright: Siarhei Sheleh. No price or
+  term is stated anywhere; every commercial path points to the form. Security reports stay at
+  contact@passioncode.ai.
 - `LICENSE`, `COMMERCIAL-LICENSE.md` and `CLA.md` are copied **byte for byte** from the knowledge
   base's `templates/`; every manifest and SKILL.md `license:` carries the expression.
 - A version released earlier keeps its licence — MIT or PolyForm Noncommercial or Internal Use —
   and the README may say which. Never write that a released version changed.
 - The README's `## License` section uses the knowledge base wording and names the earlier
   licences: "Open source under the GNU AGPL-3.0. A commercial license is available for use that
-  does not meet the AGPL's terms — contact@passioncode.ai."
+  does not meet the AGPL's terms — [passioncode.ai/business](https://passioncode.ai/business/)."
 - Contributions are accepted under the repository's `CLA.md`; opening a pull request is the
   agreement, so a PR template never carries a CLA checkbox.
 - **The repository standard** (the knowledge base `repository-standard.md`): README first heading

package/payload/plugins/passioncode/skills/working-in-passioncode/references/publishing.md

@@ -14,7 +14,7 @@ change to a license, a manifest's `license` field, `CLA.md` or a PR template.
 ## The license, file by file
 
 Every repository is open source under the GNU AGPL-3.0, or available under a commercial
-license from PassionCode.ai (contact@passioncode.ai): SPDX
+license from PassionCode.ai (https://passioncode.ai/business/, commercial@passioncode.ai): SPDX
 `AGPL-3.0-only OR LicenseRef-PassionCode-Commercial` (Fabric ADR-0092). The owning page is the
 knowledge base's `licensing.md`; the file list is its `repository-standard.md`, and org-index
 `scripts/check_format.py` (rules F7–F11) checks it. The three licence files are **copied byte
@@ -47,14 +47,15 @@ for byte** from the knowledge base's `templates/` — never retyped, reflowed or
   ## License
 
   Open source under the [GNU AGPL-3.0](LICENSE). A [commercial license](COMMERCIAL-LICENSE.md) is
-  available for use that does not meet the AGPL's terms — contact@passioncode.ai.
+  available for use that does not meet the AGPL's terms — [passioncode.ai/business](https://passioncode.ai/business/).
   Versions before <first AGPL version> were released under <MIT | PolyForm Noncommercial or Internal Use>.
   ```
 
 - "Source-available" and the PolyForm expression describe past releases only; never state
   them as the current licence.
 - No price or term for the commercial licence is stated anywhere; point to
-  contact@passioncode.ai.
+  https://passioncode.ai/business/ (commercial@passioncode.ai is the commercial contact). Security
+  reports stay at contact@passioncode.ai.
 - Positioning and names come from the knowledge base (`vision.md`, `principles.md` §2); do not
   restate a tagline from memory.