@passioncode-ai/passioncode 0.1.36 → 0.1.38

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.1.38 - 2026-10-12
+
+### Changed
+
+- **Fabric Agent Adapter is pinned at `v0.14.0`** (it was `v0.13.0`). The kit's contract pin now includes DEC-0046
+  (runner and model profiles) and CT-31: a delegation token without an actor chain is refused, never thrown. The
+  contract pin is `0cacd08`.
+
+## 0.1.37 - 2026-10-12
+
+### Changed
+
+- **Fabric Agent Adapter is pinned at `v0.13.0`** (it was `v0.12.0`). The scaffolder now requires every capability's
+  effect class (`--effect`) and never defaults it. It writes the capability's idempotency and the manifest's cost
+  presets (`--cost-preset`, DEC-0037), which are fixed options a launcher offers when a run's cost varies.
+
 ## 0.1.36 - 2026-10-12
 
 ### Changed

package/family.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@passioncode-ai/passioncode",
-  "version": "0.1.36",
+  "version": "0.1.38",
   "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.12.0",
+      "version": "0.14.0",
       "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.36",
+      "version": "0.1.38",
       "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.36",
+  "version": "0.1.38",
   "release": true,
   "members": [
     {
       "name": "fabric-agent-adapter",
       "displayName": "Fabric Agent Adapter",
       "repo": "passioncode-ai/fabric-agent-adapter",
-      "ref": "v0.12.0",
-      "commit": "6f07268b0008c53ffa07132c2cde9fde31ad24ad",
-      "version": "0.12.0",
+      "ref": "v0.14.0",
+      "commit": "d492e820ba922cc5eaa109b1aaae6dce12319569",
+      "version": "0.14.0",
       "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:426674360744d0c59e5f51341a46ddf1fad97fea9914050e8804141c1c931637",
+      "contentHash": "sha256:37413cb1e4e8f38267eead524e592923270029396d72bb0958301c0e549d933c",
       "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.36",
+      "ref": "v0.1.38",
       "commit": null,
-      "version": "0.1.36",
+      "version": "0.1.38",
       "via": "this repository",
       "skills": [
         "working-in-passioncode"
       ],
       "legacyPluginIds": [],
       "legacyMarketplaces": [],
-      "contentHash": "sha256:9064a45fd8f155d8808bce22aa2ca225838ee85332a0b660d6b4ce3e516949fc",
+      "contentHash": "sha256:b006d8d8ff568b7e5c90255859aa4ea7c6911236e185e9848a65b722054922e2",
       "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.12.0",
+  "version": "0.14.0",
   "author": {
     "name": "PassionCode.ai",
     "url": "https://passioncode.ai/"

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

@@ -5,9 +5,9 @@ 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.12.0"
+  version: "0.14.0"
   contract-version: "0.1.0"
-  contract-commit: "2eb91c00e852d9c31d804310d38fad91589fcbac"
+  contract-commit: "0cacd08b0e95b6abf131eae1206b60792138bc3c"
 ---
 
 # Adapting projects to Fabric
@@ -70,7 +70,7 @@ Use exactly:
 
 - contract version `0.1.0`;
 - repository `https://github.com/passioncode-ai/fabric-agent-contract`;
-- commit `2eb91c00e852d9c31d804310d38fad91589fcbac`.
+- commit `0cacd08b0e95b6abf131eae1206b60792138bc3c`.
 
 This is the default for new bundles. When checking an issued legacy bundle, preserve its
 explicit supported lock and use that exact clean checkout. Never silently upgrade or
@@ -96,14 +96,21 @@ python3 <skill-dir>/scripts/adapt_project.py scaffold <project-root> \
   --provider-name "Example provider" \
   --capability-id https://agents.example/capabilities/example \
   --capability-name example.run \
-  --schema-base https://agents.example/fabric
+  --schema-base https://agents.example/fabric \
+  --effect draft
 ```
 
 Valid profiles are `mcp`, `a2a`, and `local-runner`. For `mcp` the capability is served
 as the MCP tool of its own name (`requiredFeatures: ["tool:<capability>"]`, contract
 `fabric-interop/0.1`); add `--job` when its work may outlive one request, which writes
 `"job": true` in the capability's interop block. The helper creates only the locked
-target paths. It refuses any collision. Do not use `--force` unless the user explicitly
+target paths. It refuses any collision.
+
+`--effect` is required and never defaulted: the capability's class (`none`, `draft`, `publish`, `send`, `reply`,
+`charge`, `delete`, `merge`, `deploy`, `change-policy`), read from what the code does or asked of the author. Choose
+`--idempotency required|supported|none` for an external effect on purpose. When a run's cost varies, give the
+launcher fixed options (DEC-0037): `--cost-preset ID MAX_USD LABEL` per option and `--default-cost-preset ID`; the
+amounts come from the author or measured runs, never invented. Do not use `--force` unless the user explicitly
 authorizes replacement after the exact conflicting files and diff are shown.
 
 The generated zero hash, `.invalid` endpoints, `replace-me` values, generic schemas, and

package/payload/plugins/fabric-agent-adapter/skills/adapting-projects-to-fabric/scripts/adapt_project.py

@@ -6,8 +6,10 @@ from __future__ import annotations
 import argparse
 import datetime as dt
 import json
+import math
 import os
 from pathlib import Path
+import re
 import subprocess
 import sys
 from typing import Any, Dict, Iterable, List, Optional, Sequence, Tuple
@@ -16,10 +18,10 @@ from urllib.parse import urlparse
 
 CONTRACT_VERSION = "0.1.0"
 CONTRACT_REPOSITORY = "https://github.com/passioncode-ai/fabric-agent-contract"
-CONTRACT_COMMIT = "2eb91c00e852d9c31d804310d38fad91589fcbac"
+CONTRACT_COMMIT = "0cacd08b0e95b6abf131eae1206b60792138bc3c"
 # #region supported-contract-revisions — docs: README.md#contract-pin
 # Only this declaration may name a legacy revision in live files.
-SUPPORTED_CONTRACT_COMMITS = (CONTRACT_COMMIT, "8e49fbd5fbbf230e32c1969cd24ac3c22422f0a5", "a83bec6b47776af688402c18efec507143061f68", "52da526d7cc1e063d74c5b520dbc03d0ace15246", "78b2da018d2c4bd9ac1bde1dc3b7f1a110a175f5", "623bf61358c339cb10297807b3f024b5d9f1f327", "23f9fda4c05f8a3852246ee98d4f2adf74ed0875", "9091d3d6606b0c4b5591a38c3674356a01fd7f55", "df55c8c54a23251342a7ee57ba95642b7eb39e61", "2ce392291c6668598d12cd38327e24696b5ca15c")
+SUPPORTED_CONTRACT_COMMITS = (CONTRACT_COMMIT, "2eb91c00e852d9c31d804310d38fad91589fcbac", "8e49fbd5fbbf230e32c1969cd24ac3c22422f0a5", "a83bec6b47776af688402c18efec507143061f68", "52da526d7cc1e063d74c5b520dbc03d0ace15246", "78b2da018d2c4bd9ac1bde1dc3b7f1a110a175f5", "623bf61358c339cb10297807b3f024b5d9f1f327", "23f9fda4c05f8a3852246ee98d4f2adf74ed0875", "9091d3d6606b0c4b5591a38c3674356a01fd7f55", "df55c8c54a23251342a7ee57ba95642b7eb39e61", "2ce392291c6668598d12cd38327e24696b5ca15c")
 # #endregion supported-contract-revisions
 INTEROP_KEY = "https://fabric.passioncode.ai/agent-contract/extensions/interop/0.1"
 MCP_REVISION = "2026-07-28"
@@ -208,6 +210,7 @@ def _json_text(value: Any) -> str:
 
 
 def _generated_files(args: argparse.Namespace) -> Dict[str, str]:
+    effect, idempotency = _declared_effect(args)
     for value, label in (
         (args.provider_id, "provider ID"),
         (args.capability_id, "capability ID"),
@@ -250,8 +253,8 @@ def _generated_files(args: argparse.Namespace) -> Dict[str, str]:
                 "name": args.capability_name,
                 "inputSchema": _schema_uri(args.schema_base, "schemas/capability-input.schema.json"),
                 "outputSchema": _schema_uri(args.schema_base, "schemas/capability-output.schema.json"),
-                "effect": "none",
-                "idempotency": "none",
+                "effect": effect,
+                "idempotency": idempotency,
                 "dataClasses": ["public"],
                 "profile": _profile(args, args.schema_base),
             }
@@ -259,6 +262,9 @@ def _generated_files(args: argparse.Namespace) -> Dict[str, str]:
     }
     if getattr(args, "job", False):
         manifest["capabilities"][0]["extensions"] = {INTEROP_KEY: {"job": True}}
+    presets = _cost_presets(args)
+    if presets:
+        manifest["costPresets"] = presets
     lock = {
         "contract": "fabric-agent-contract",
         "version": CONTRACT_VERSION,
@@ -320,6 +326,51 @@ placeholders. Scaffolding is not admission and must not be presented as compatib
     }
 
 
+EFFECT_CLASSES = ("none", "draft", "publish", "send", "reply", "charge", "delete", "merge", "deploy", "change-policy")
+IDEMPOTENCY = ("required", "supported", "none")
+_PRESET_ID = re.compile(r"^[a-z][a-z0-9-]{0,39}$")
+
+
+def _cost_presets(args: argparse.Namespace) -> List[Dict[str, Any]]:
+    """DEC-0037: the fixed options a launcher offers for a task whose cost varies, each for this capability."""
+    presets: List[Dict[str, Any]] = []
+    seen = set()
+    for raw in getattr(args, "cost_preset", None) or []:
+        preset_id, max_usd, label = (list(raw) + ["", "", ""])[:3]
+        if not _PRESET_ID.match(preset_id or ""):
+            raise AdaptationError("cost preset id %r must match ^[a-z][a-z0-9-]{0,39}$" % preset_id)
+        if preset_id in seen:
+            raise AdaptationError("cost preset %s is named twice" % preset_id)
+        try:
+            amount = float(max_usd)
+        except ValueError:
+            raise AdaptationError("cost preset %s: maxUsd %r is not a number" % (preset_id, max_usd)) from None
+        if not math.isfinite(amount) or amount < 0:
+            raise AdaptationError("cost preset %s: maxUsd must be a finite amount of at least 0" % preset_id)
+        if not label.strip():
+            raise AdaptationError("cost preset %s needs a label a person reads at launch" % preset_id)
+        seen.add(preset_id)
+        presets.append({"id": preset_id, "capability": args.capability_name, "label": label.strip(), "maxUsd": amount})
+    default = getattr(args, "default_cost_preset", None)
+    if default:
+        if default not in seen:
+            raise AdaptationError("--default-cost-preset %s names no --cost-preset" % default)
+        next(p for p in presets if p["id"] == default)["default"] = True
+    return presets
+
+
+def _declared_effect(args: argparse.Namespace) -> Tuple[str, str]:
+    """The capability's effect class is declared by the author, never defaulted (target architecture v4, Stage 0)."""
+    effect = getattr(args, "effect", None)
+    if effect not in EFFECT_CLASSES:
+        raise AdaptationError("declare the capability's effect with --effect (%s); it is never defaulted"
+                              % ", ".join(EFFECT_CLASSES) if not effect else "unknown effect class %r (%s)" % (effect, ", ".join(EFFECT_CLASSES)))
+    idempotency = getattr(args, "idempotency", None) or "none"
+    if idempotency not in IDEMPOTENCY:
+        raise AdaptationError("unknown idempotency %r (%s)" % (idempotency, ", ".join(IDEMPOTENCY)))
+    return effect, idempotency
+
+
 def scaffold_project(root: Path, args: argparse.Namespace) -> Dict[str, Any]:
     if not root.is_dir():
         raise AdaptationError("project path is not a directory: %s" % root)
@@ -544,6 +595,12 @@ def build_parser() -> argparse.ArgumentParser:
     scaffold.add_argument("--runner-kind", default="replace-me")
     scaffold.add_argument("--executable-ref", default="urn:executable:replace-me")
     scaffold.add_argument("--runtime-arg", action="append", default=[])
+    scaffold.add_argument("--effect", required=True, choices=EFFECT_CLASSES,
+                          help="the capability's effect class (governance): what it does outside itself; never defaulted")
+    scaffold.add_argument("--idempotency", choices=IDEMPOTENCY, default="none")
+    scaffold.add_argument("--cost-preset", nargs=3, action="append", default=[], metavar=("ID", "MAX_USD", "LABEL"),
+                          help="a fixed cost option a launcher offers (DEC-0037 costPresets); repeat for each")
+    scaffold.add_argument("--default-cost-preset", metavar="ID", help="the preset preselected at launch")
     scaffold.add_argument("--job", action="store_true", help="the capability's work may outlive one request (fabric-interop/0.1 job)")
     scaffold.add_argument("--force", action="store_true")
     scaffold.add_argument("--json", action="store_true")

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

@@ -16,10 +16,10 @@ 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.12.0"
+  version: "0.14.0"
   contract-version: "0.1.0"
   extension: "fabric-service/0.1"
-  extension-commit: "2eb91c00e852d9c31d804310d38fad91589fcbac"
+  extension-commit: "0cacd08b0e95b6abf131eae1206b60792138bc3c"
 ---
 
 # Building Fabric services

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

@@ -1,11 +1,11 @@
 # fabric-service/0.1 — wire reference
 
-Pinned to `fabric-agent-contract` commit `2eb91c00e852d9c31d804310d38fad91589fcbac`
+Pinned to `fabric-agent-contract` commit `0cacd08b0e95b6abf131eae1206b60792138bc3c`
 (`docs/specification/service.md`, DEC-0015; the usage report DEC-0021; Windows and Linux supervision
 DEC-0032 and DEC-0033; the operator channel DEC-0034 and DEC-0035; the embedded dashboard DEC-0036;
 delegation and the operator session's lifetime DEC-0039; the meter's call window DEC-0041; session handoff DEC-0042;
 canonical forms DEC-0043; `degraded[].setup` and `run.mcp.stdio.scope` DEC-0044; delegation sealed and trust tiers
-DEC-0045). The contract's schemas are normative;
+DEC-0045; runner and model profiles DEC-0046). The contract's schemas are normative;
 this page is the working summary. Extension key:
 `https://fabric.passioncode.ai/agent-contract/extensions/service/0.1`.
 
@@ -61,6 +61,9 @@ No auth; the Host/Origin guard applies; answered from memory in under 100 ms.
 - A `degraded[]` entry may carry `setup: true` (DEC-0044): the source waits for a person to finish setting it up
   (a key not entered, a model not chosen). It is not an outage, and a watcher does not alert on it. The kits pass
   entries through unchanged.
+- `configuration` (DEC-0046) MAY say which runner and model profile the service resolved and from where
+  (`request`, `agent`, `binding`, `estate`); a usage receipt MAY carry the `route` (`subscription` or `key`). The kits
+  do not emit either yet (FAA-19).
 - `build` needs `commit` or `digest` (`sha256:<64 hex>`).
 - `summary`: at most six tiles; `attention: true` counts toward the host's badge.
 - `surfaces.events` is required; `dashboard` and `mcp` when the service has them; `usage`

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

@@ -5,9 +5,9 @@ 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.12.0"
+  version: "0.14.0"
   contract-version: "0.1.0"
-  contract-commit: "2eb91c00e852d9c31d804310d38fad91589fcbac"
+  contract-commit: "0cacd08b0e95b6abf131eae1206b60792138bc3c"
 ---
 
 # Creating Fabric-compatible agents
@@ -116,10 +116,14 @@ python3 <plugin-dir>/skills/adapting-projects-to-fabric/scripts/adapt_project.py
   scaffold <project-root> --profile <mcp|a2a|local-runner> \
   --provider-id <stable-uri> --provider-name "<name>" \
   --capability-id <stable-uri> --capability-name <domain.action> \
-  --schema-base <immutable-base-uri>
+  --schema-base <immutable-base-uri> --effect <class> \
+  [--idempotency required|supported|none] [--cost-preset <id> <max-usd> "<label>" ... --default-cost-preset <id>]
 ```
 
-Pin exactly contract `0.1.0` at commit `2eb91c00e852d9c31d804310d38fad91589fcbac` and
+The effect class is declared, never defaulted: ask the author what the agent does outside itself when the request
+does not say. Cost presets are only for a run whose cost varies; their amounts come from the author or measured runs.
+
+Pin exactly contract `0.1.0` at commit `0cacd08b0e95b6abf131eae1206b60792138bc3c` and
 read the pinned guide before implementing protocol details. If this skill is installed
 without its sibling, the scaffolder is absent: create the bundle by hand from the pinned
 contract's `docs/guides/connecting-compatible-agents.md` and mark the structural check

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.36",
+  "version": "0.1.38",
   "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",