@passioncode-ai/passioncode 0.1.17 → 0.1.18

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.1.18 - 2026-10-01
+
+### Changed
+
+- Pin Fabric Agent Adapter v0.5.7: services are scheduled as standard processes (`ProcessType
+  Standard`; the probe's `lifecycle.priority` rule fails `Background`), `notify: true` is reserved
+  for a decision, a failure or a blocking warning once per episode, a service raises no banners of
+  its own, and a preview instance is uninstalled once checked
+  ([adapter changelog](https://github.com/passioncode-ai/fabric-agent-adapter/blob/v0.5.7/CHANGELOG.md)).
+
 ## 0.1.17 - 2026-10-01
 
 ### Changed

package/family.json

@@ -8,7 +8,7 @@
       "name": "fabric-agent-adapter",
       "displayName": "Fabric Agent Adapter",
       "repo": "passioncode-ai/fabric-agent-adapter",
-      "ref": "v0.5.6",
+      "ref": "v0.5.7",
       "kind": "plugin",
       "path": "plugins/fabric-agent-adapter",
       "legacyPluginIds": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@passioncode-ai/passioncode",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "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.5.6",
+      "version": "0.5.7",
       "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",
@@ -35,7 +35,7 @@
       "name": "passioncode",
       "displayName": "PassionCode.ai",
       "source": "./plugins/passioncode",
-      "version": "0.1.17",
+      "version": "0.1.18",
       "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.17",
+  "version": "0.1.18",
   "release": true,
   "members": [
     {
       "name": "fabric-agent-adapter",
       "displayName": "Fabric Agent Adapter",
       "repo": "passioncode-ai/fabric-agent-adapter",
-      "ref": "v0.5.6",
-      "commit": "1b473987feeeb04ee67a1122d6baadc83bc03816",
-      "version": "0.5.6",
+      "ref": "v0.5.7",
+      "commit": "de21d9548bc836fe09ca6049afb647b11450dda8",
+      "version": "0.5.7",
       "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:bf48b5d4c4163d43485e85c73e393a71b31842ae70bbd7133c1d5a769f8bc9eb",
+      "contentHash": "sha256:bebf6fe75b96b059558f0ad4f771db6784b07f429f88db2b5e285f3420284d5a",
       "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",
@@ -61,16 +61,16 @@
       "name": "passioncode",
       "displayName": "PassionCode.ai",
       "repo": "passioncode-ai/passioncode",
-      "ref": "v0.1.17",
+      "ref": "v0.1.18",
       "commit": null,
-      "version": "0.1.17",
+      "version": "0.1.18",
       "via": "this repository",
       "skills": [
         "working-in-passioncode"
       ],
       "legacyPluginIds": [],
       "legacyMarketplaces": [],
-      "contentHash": "sha256:b8f988dc498dbd00ef9e1d0e3fb93fe9069d8d8758623ff47bd225d3a63fffa4",
+      "contentHash": "sha256:26d450262adad29363047bc7a6df496d8a0ecd6fd82d8c1e771944248db8eb8e",
       "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.5.6",
+  "version": "0.5.7",
   "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.5.6"
+  version: "0.5.7"
   contract-version: "0.1.0"
   contract-commit: "74d3852f122f5ca5cbc4138a201483531dfa5006"
 ---

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.5.6"
+  version: "0.5.7"
   contract-version: "0.1.0"
   extension: "fabric-service/0.1"
   extension-commit: "74d3852f122f5ca5cbc4138a201483531dfa5006"
@@ -163,7 +163,10 @@ descriptor's `fabricManifest` at a manifest whose service key names this
 The installer, not the service, owns the plist and the descriptor. Sequence:
 
 1. `write_descriptor(descriptor)` — refuses a port or `id.instance` another descriptor
-   claims. A preview or branch copy is a second **instance**, never a second id.
+   claims. A preview or branch copy is a second **instance**, never a second id — and it is
+   one more service the operator sees, probes and gets notified by. Verify a release with its
+   own doctor or self-check before it replaces `default`; a temporary instance is uninstalled
+   (`launchd_uninstall`, `remove_descriptor`) as soon as its check is done, not left running.
 2. `launchd_plist(...)` then `launchd_install(...)` — writes and lints the plist,
    `bootout` and waits for the unload, `bootstrap` with retries on the transient I/O
    error, then polls the well-known document until it answers with **this** identity.
@@ -183,8 +186,10 @@ others, and every error is a sentence with the next action. Read
 
 The events feed is a **view over the log you already keep** — a jobs table, a JSONL
 journal — not a second store. Each event is one sentence a person reads; set
-`notify: true` only for what the operator must act on or would want to hear about
-unprompted, with a `link` to the page that resolves it. Read
+`notify: true` only when the operator must decide, or something failed or degrades their
+work — once per episode, with a `subject` and a `link` to the page that resolves it. A
+question's kind says so (`*.awaiting_*`, `*.approval_*`, `human_step.opened`). The service
+raises no banners of its own: the host is the one channel. Read
 [the events reference](references/events-and-notifications.md) for mapping an existing
 log, retention and notification policy.
 

package/payload/plugins/fabric-agent-adapter/skills/building-fabric-services/references/events-and-notifications.md

@@ -26,11 +26,32 @@ The feed is a view: never copy rows into a second store that can drift from the
 
 ## When to set `notify: true`
 
-Notify when the operator must act (an approval is waiting, a key expired, a job failed
-after retries) or asked to be told (a long job finished). Do not notify for routine
-progress, retries that will succeed, or anything that fires more than a few times an
-hour. The host decides whether to show it — quiet hours, per-service settings — and
-debounces; the service decides only what is notification-worthy.
+`notify: true` asks the host to interrupt the operator. Hosts treat it as a request, not an
+order: Fabric Dashboards shows a banner only for a **decision**, a **failure** or a **warning**,
+once per episode, and puts everything else in Activity (its ADR-0010). Write events so that rule
+lands on what matters:
+
+| The operator… | Event | `notify` |
+|---|---|---|
+| must decide or act — a choice, an approval, a key to enter | kind says it: `job.awaiting_choice`, `plan.awaiting_approval`, `human_step.opened`; level `notice` | `true` |
+| lost work — a job failed after its retries, a key expired | level `error`; kind `*.failed`, `*.expired` | `true` |
+| will lose work soon — a degraded source that blocks orders | level `warning`, `service.degraded`, **once when it starts** | `true` |
+| asked to be told when a long job finishes | `job.delivered`, level `notice` | `true` only if that person asked; a host may still keep it in Activity |
+| only needs the record — progress, retries, recoveries, syncs | `job.started`, `service.recovered`, `*.cleared`, level `info` or `notice` | `false` |
+
+- **One episode, one request.** Notify on the transition, never on each poll: a source that
+  flaps between degraded and healthy sends `service.degraded` with `notify: true` once, and later
+  repeats with `notify: false` until it has stayed healthy for a while. Asking the same question
+  about the same subject again is not news.
+- **Say who wants what.** `subject` names the thing (`{type: "job", id: "…", label: "Q3 report"}`)
+  so a host can tell episodes apart and group; `text` names the object and what the operator
+  should do ("The storyboard of the Q3 launch video waits for your decision."); `link` opens the
+  page where they do it. The host adds the agent's name and instance.
+- **One channel.** A service with a descriptor raises no banners of its own (AppleScript
+  `display notification`, a notifier binary, its own notification-centre entries): the operator
+  would get each one twice, from a sender that is not the host. Publish the event; the host
+  delivers it, honouring quiet hours and per-service settings.
+- Anything that would fire more than a few times an hour is not a notification.
 
 ## Lifecycle events every service emits
 

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

@@ -10,7 +10,7 @@
 | `KeepAlive` | `true` | `{SuccessfulExit:false}` leaves a cleanly exited service down |
 | `ThrottleInterval` | `10` | bounds a crash loop |
 | `ExitTimeOut` | drain time + margin (40 s default) | SIGKILL arrives after it |
-| `ProcessType` | `Background` | scheduler hint |
+| `ProcessType` | `Standard` — never `Background`, and no `Nice` > 0 or `LowPriorityIO` | a host probes the service and agents call it while the Mac is busy; a background job is starved for tens of seconds under load and every host reports an outage that never happened (the probe's `lifecycle.priority` rule fails it) |
 | `EnvironmentVariables` | `PATH` set explicitly; `*_FILE` paths to secrets | never a secret value — the plist is world-readable in backups |
 | `StandardOutPath`/`StandardErrorPath` | `~/Library/Logs/<id>/service.log` | one place the host tails |
 

package/payload/plugins/fabric-agent-adapter/skills/building-fabric-services/scripts/check_service.py

@@ -39,6 +39,36 @@ import fabric_interop as fi  # noqa: E402
 Result = Dict[str, str]
 
 
+
+def plist_problems(plist: dict, label: object, token: object = None) -> list:
+    """What makes a service's launchd job unfit to stay up: identity, restart, secrets."""
+    problems = []
+    if plist.get("Label") != label:
+        problems.append("Label %r" % plist.get("Label"))
+    if plist.get("RunAtLoad") is not True:
+        problems.append("RunAtLoad is not true")
+    if plist.get("KeepAlive") is not True:
+        problems.append("KeepAlive is %r, not true" % plist.get("KeepAlive"))
+    for key, value in (plist.get("EnvironmentVariables") or {}).items():
+        if re.search(r"(TOKEN|SECRET|PASSWORD|KEY)$", key) and not key.endswith("_FILE"):
+            problems.append("secret-like variable %s in the plist" % key)
+        if token and token in str(value):
+            problems.append("the service token itself is in the plist")
+    return problems
+
+
+def priority_problems(plist: dict) -> list:
+    """A service that answers hosts and agents must not be scheduled as background work."""
+    out = []
+    if plist.get("ProcessType", "Standard") in ("Background", "Adaptive"):
+        out.append("ProcessType is %s" % plist.get("ProcessType"))
+    if isinstance(plist.get("Nice"), int) and plist["Nice"] > 0:
+        out.append("Nice is %d" % plist["Nice"])
+    if plist.get("LowPriorityIO") is True or plist.get("LowPriorityBackgroundIO") is True:
+        out.append("low-priority I/O")
+    return out
+
+
 class Probe:
     def __init__(self, descriptor_path: Path, descriptor: Dict[str, Any], services_dir: Path, skip_login: bool):
         self.path = descriptor_path
@@ -416,19 +446,12 @@ class Probe:
         except (OSError, ValueError) as exc:
             self.add("lifecycle.plist", "FAIL", "cannot read %s: %s" % (plist_path, exc))
             return
-        problems = []
-        if plist.get("Label") != life.get("label"):
-            problems.append("Label %r" % plist.get("Label"))
-        if plist.get("RunAtLoad") is not True:
-            problems.append("RunAtLoad is not true")
-        if plist.get("KeepAlive") is not True:
-            problems.append("KeepAlive is %r, not true" % plist.get("KeepAlive"))
-        for key, value in (plist.get("EnvironmentVariables") or {}).items():
-            if re.search(r"(TOKEN|SECRET|PASSWORD|KEY)$", key) and not key.endswith("_FILE"):
-                problems.append("secret-like variable %s in the plist" % key)
-            if self.token and self.token in str(value):
-                problems.append("the service token itself is in the plist")
+        problems = plist_problems(plist, life.get("label"), self.token)
         self.add("lifecycle.plist", "FAIL" if problems else "PASS", "; ".join(problems) or "%s: RunAtLoad, KeepAlive, no secrets" % plist_path.name)
+        slow = priority_problems(plist)
+        self.add("lifecycle.priority", "FAIL" if slow else "PASS",
+                 "; ".join(slow) + " — macOS may starve the service under load and hosts then see an outage; use ProcessType Standard"
+                 if slow else "%s: scheduled as a standard process" % plist_path.name)
         if not shutil.which("launchctl"):
             self.add("lifecycle.one-copy", "NOT_RUN", "launchctl is not available")
             return

package/payload/plugins/fabric-agent-adapter/skills/building-fabric-services/scripts/fabric_service.py

@@ -596,7 +596,10 @@ def launchd_plist(label: str, program_arguments: Sequence[str], *, working_direc
         "KeepAlive": True,
         "ThrottleInterval": 10,
         "ExitTimeOut": exit_timeout,
-        "ProcessType": "Background",
+        # Standard, never Background: a host probes the service and agents call it while the Mac
+        # is busy; Background (and Nice/LowPriorityIO) lets macOS starve it for tens of seconds
+        # under load, and every host then reports an outage that never happened.
+        "ProcessType": "Standard",
         "StandardOutPath": str(stdout_path),
         "StandardErrorPath": str(stdout_path),
         "EnvironmentVariables": env,

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.5.6"
+  version: "0.5.7"
   contract-version: "0.1.0"
   contract-commit: "74d3852f122f5ca5cbc4138a201483531dfa5006"
 ---

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.17",
+  "version": "0.1.18",
   "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",