@passioncode-ai/fabric-agent-adapter 0.3.1 → 0.4.3

package/CHANGELOG.md

@@ -1,5 +1,87 @@
 # Changelog
 
+## 0.4.3 - 2026-09-29
+
+### Changed
+
+- **License.** The adapter is now source-available under
+  `PolyForm-Noncommercial-1.0.0 OR LicenseRef-PolyForm-Internal-Use-1.0.0`, with a
+  commercial license on request (contact@passioncode.ai). Versions up to and including
+  v0.4.2, and npm releases up to and including 0.3.1, were released under MIT and remain
+  available under it. The manifests, the three skills' `license:` and the README say the
+  same; contributions come in under `CLA.md`, which the new PR template asks for.
+  `test/validate.py` fails a tree that slips back to MIT.
+- Author and marketplace owner are PassionCode.ai (`https://passioncode.ai/`).
+- **Contract pin** moves from `20a818e` to `a5a2709` (fabric-agent-contract `main`), the
+  commit `building-fabric-services` already pinned. Between the two the provider
+  profiles are unchanged — only the `fabric-service/0.1` extension was added — and
+  `adapt_project.py check --contract` gives the same verdicts for an MCP, an A2A and a
+  local-runner bundle at both commits (declaration shape PASS). One pin for all three
+  skills.
+- `creating-fabric-agents` hands the agent's own loop to `agent-orchestrator`, its
+  eval suite to `agent-evals` (agent-stack) and plugin packaging to `make-skill`;
+  `adapting-projects-to-fabric` sends wire-level MCP/A2A questions to `agent-interop`.
+
+### Fixed
+
+- The installer's help names the launcher by its npm org name,
+  `npx @passioncode-ai/passioncode@latest update`; the bare `passioncode` is not ours.
+- A distributed eval named a personal agent as its example service; the
+  `building-fabric-services` evals use `example-agent`, and its description says "a
+  macOS machine" instead of naming whose.
+
+## 0.4.2 - 2026-09-29
+
+- Kit: `LoopbackHTTPServer`, a `ThreadingHTTPServer` whose bind asks no resolver.
+  `http.server` calls `socket.getfqdn()` between `bind()` and `listen()`; on a macOS
+  CI runner that held a service's port bound but silent for over 20 seconds. The
+  sample service and the skill's startup order use it, and the skill names the trap.
+- Kit: a garbled pid file (for example a superscript digit) now reads as "no pid"
+  instead of raising `ValueError` while naming the holder of a lock.
+
+## 0.4.1 - 2026-09-29
+
+### Fixed
+
+- `building-fabric-services` could not be loaded by a strict YAML reader: its
+  front-matter `description` was an unquoted plain scalar holding `: `
+  ("fabric-service/0.1 extension: which surface", line 3, column 493), which YAML
+  rejects with "mapping values are not allowed here". Claude Code read it
+  leniently, so the plugin worked, but an agent reading the skill from
+  `~/.agents/skills` could drop it. The description is now a folded block
+  scalar (`>-`) with the exact same text (927 characters).
+- The validator could not see that class of defect: `test/validate.py` now
+  parses every SKILL.md front matter strictly (standard library only) and
+  rejects what a YAML reader rejects in an unquoted value — `: ` or a trailing
+  `:`, ` #` (a comment that silently truncates the value), a leading indicator
+  character, a duplicate key, an unclosed quote, an undeclared multi-line
+  value — with the line and column. `test/test_validate.py` plants each case.
+  `validate.py --frontmatter <SKILL.md ...>` checks installed copies anywhere.
+- The release smoke test looked for `~/.claude/skills`, where the installer has
+  not written since 0.4.0, so it would fail on the first release that ran it.
+  It now checks all three skills in `~/.agents/skills`, that `~/.claude/skills`
+  stays untouched, and that the installed front matter parses strictly.
+- `SKILL-CARD.md` versions and the release smoke paths joined the validator's
+  sync checks.
+
+## 0.4.0 - 2026-09-28
+
+- Add the `building-fabric-services` skill for the `fabric-service/0.1` local
+  service extension (Fabric Agent Contract DEC-0015): surface choice (MCP
+  streamable HTTP, CLI, A2A), token and one-time login, state and cache
+  directories, one copy per machine, launchd, descriptor, well-known document,
+  events feed and notifications.
+- Ship reference kits in Python (`fabric_service.py`) and Node
+  (`fabric-service.mjs`) whose instance locks exclude each other, a complete
+  `sample_service.py`, and `check_service.py`, a live conformance probe that
+  reports PASS, FAIL or NOT_RUN per rule.
+- `creating-fabric-agents` now routes an agent that runs as a service through
+  the new skill.
+- Fix the installer shadowing its own plugin: `npx @passioncode-ai/fabric-agent-adapter`
+  and `install.sh` now install into the agents hub `~/.agents/skills`; a plain
+  copy into `~/.claude/skills` is refused while the plugin is installed, and
+  `--prune-shadow` moves existing shadowing copies aside.
+
 ## 0.3.1 - 2026-08-27
 
 - Fix the executable bit on `bin/fabric-agent-adapter.js` and `install.sh`: the

package/LICENSE

@@ -1,22 +1,156 @@
-MIT License
+Copyright (c) 2026 Siarhei Sheleh
 
-Copyright (c) 2026 passioncode-ai
+This software is source-available, not open source. You may use it under
+either of the two licenses below, at your option:
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+  1. PolyForm Noncommercial License 1.0.0
+     SPDX: PolyForm-Noncommercial-1.0.0
+  2. PolyForm Internal Use License 1.0.0
+     SPDX: LicenseRef-PolyForm-Internal-Use-1.0.0
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+In short: individuals and noncommercial organisations may use, change and
+share it for noncommercial purposes; any company may use it, and change it,
+for its own internal operations. Distributing it commercially, or building
+this software or its code into a product or service you provide to others,
+needs a separate commercial license: contact@passioncode.ai.
+This summary is not part of either license; the texts below govern.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+Versions up to and including v0.4.2 of this repository (and npm releases up to and
+including 0.3.1) were released under the MIT License; those releases remain available
+under MIT.
 
+Required Notice: Copyright (c) 2026 Siarhei Sheleh (https://passioncode.ai)
+
+================================================================================
+
+# PolyForm Noncommercial License 1.0.0
+
+<https://polyformproject.org/licenses/noncommercial/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree to them as both strict obligations and conditions to all your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the software to do everything you might do with the software that would otherwise infringe the licensor's copyright in it for any permitted purpose.  However, you may only distribute the software according to [Distribution License](#distribution-license) and make changes or new works based on the software according to [Changes and New Works License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license to distribute copies of the software.  Your license to distribute covers distributing the software with changes and new works permitted by [Changes and New Works License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms or the URL for them above, as well as copies of any plain-text lines beginning with `Required Notice:` that the licensor provided with the software.  For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to make changes and new works based on the software for any permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that covers patent claims the licensor can license, or becomes able to license, that you would infringe by using the software.
+
+## Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for the benefit of public knowledge, personal study, private entertainment, hobby projects, amateur pursuits, or religious observance, without any anticipated commercial application, is use for a permitted purpose.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution, public research organization, public safety or health organization, environmental protection organization, or government institution is use for a permitted purpose regardless of the source of funding or obligations resulting from the funding.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of your licenses to anyone else, or prevent the licensor from granting licenses to anyone else.  These terms do not imply any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have violated any of these terms, or done anything with the software not covered by your licenses, your licenses can nonetheless continue if you come into full compliance with these terms, and take practical steps to correct past violations, within 32 days of receiving notice.  Otherwise, all your licenses end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these terms, and the **software** is the software the licensor makes available under these terms.
+
+**You** refers to the individual or entity agreeing to these terms.
+
+**Your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization.  **Control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the software under these terms.
+
+**Use** means anything you do with the software requiring one of your licenses.
+
+================================================================================
+
+# PolyForm Internal Use License 1.0.0
+
+<https://polyformproject.org/licenses/internal-use/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree to them as both strict obligations and conditions to all your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the software to do everything you might do with the software that would otherwise infringe the licensor's copyright in it for any permitted purpose.  However, you may only make changes or new works based on the software according to [Changes and New Works License](#changes-and-new-works-license), and you may not distribute the software.
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to make changes and new works based on the software for any permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that covers patent claims the licensor can license, or becomes able to license, that you would infringe by using the software.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the law. These terms do not limit them.
+
+## Internal Business Use
+
+Use of the software for the internal business operations of you and your company is use for a permitted purpose.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of your licenses to anyone else, or prevent the licensor from granting licenses to anyone else.  These terms do not imply any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have violated any of these terms, or done anything with the software not covered by your licenses, your licenses can nonetheless continue if you come into full compliance with these terms, and take practical steps to correct past violations, within 32 days of receiving notice.  Otherwise, all your licenses end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these terms, and the **software** is the software the licensor makes available under these terms.
+
+**You** refers to the individual or entity agreeing to these terms.
+
+**Your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization.  **Control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the software under these terms.
+
+**Use** means anything you do with the software requiring one of your licenses.

package/README.md

@@ -1,13 +1,38 @@
+<p align="center">
+  <a href="https://passioncode.ai/">
+    <img src="assets/passioncode-icon-256.png" width="104" height="104" alt="PassionCode.ai passion fruit mark">
+  </a>
+</p>
+
 # Fabric Agent Adapter
 
+> **PassionCode.ai — The agent-agnostic operating system for AI-native teams.**
+
+**From vibe coding to passion coding.** PassionCode.ai moves the control point from
+managing agents one by one to operating Projects. Fabric Agent Adapter is the portable
+on-ramp: it helps an existing repository become a compatible, replaceable Provider
+without moving the Project onto one proprietary agent runtime.
+
 [![npm](https://img.shields.io/npm/v/%40passioncode-ai%2Ffabric-agent-adapter)](https://www.npmjs.com/package/@passioncode-ai/fabric-agent-adapter)
 [![validate](https://github.com/passioncode-ai/fabric-agent-adapter/actions/workflows/validate.yml/badge.svg)](https://github.com/passioncode-ai/fabric-agent-adapter/actions/workflows/validate.yml)
-[![license](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![license](https://img.shields.io/badge/license-source--available-blue.svg)](LICENSE)
+
+Private, portable Agent Skills for the
+[Fabric Agent Contract](https://github.com/passioncode-ai/fabric-agent-contract):
+`adapting-projects-to-fabric`, `creating-fabric-agents` and
+`building-fabric-services`.
 
-Private, portable Agent Skill for adapting an existing agent project to the
-[Fabric Agent Contract](https://github.com/passioncode-ai/fabric-agent-contract).
+`building-fabric-services` makes an agent a long-lived local service with a dashboard
+that is always alive, runs as one copy, keeps its state through a reinstall and appears
+in Fabric Dashboards by itself — the `fabric-service/0.1` extension. It ships Python and
+Node reference kits (`scripts/fabric_service.py`, `scripts/fabric-service.mjs`), a
+complete `scripts/sample_service.py`, and `scripts/check_service.py`, a live probe:
+
+```bash
+python3 plugins/fabric-agent-adapter/skills/building-fabric-services/scripts/check_service.py example-agent
+```
 
-It helps an agent author:
+For provider bundles the adapting skill helps an agent author:
 
 - inspect the project's stable integration surfaces without executing it;
 - choose A2A `1.0`, MCP `2026-07-28`, or `fabric-local-runner/0.1` per capability;
@@ -26,7 +51,8 @@ The repository is private; the npm package is public. The npm path needs no GitH
 npm — no GitHub access required:
 
 ```bash
-npx @passioncode-ai/fabric-agent-adapter        # installs both skills into ~/.claude/skills
+npx @passioncode-ai/fabric-agent-adapter        # installs every skill into the agents hub ~/.agents/skills
+npx @passioncode-ai/fabric-agent-adapter --prune-shadow   # remove ~/.claude/skills copies that shadow the plugin
 ```
 
 Generic Agent Skills clients:
@@ -34,6 +60,7 @@ Generic Agent Skills clients:
 ```bash
 npx skills add passioncode-ai/fabric-agent-adapter --skill adapting-projects-to-fabric
 npx skills add passioncode-ai/fabric-agent-adapter --skill creating-fabric-agents
+npx skills add passioncode-ai/fabric-agent-adapter --skill building-fabric-services
 ```
 
 Claude Code plugin marketplace:
@@ -52,6 +79,12 @@ Adapt this project for Fabric compatibility. Inspect it, choose the profile per
 capability, scaffold the provider bundle, and report every conformance gate.
 ```
 
+Or, for an agent that must keep running with a dashboard:
+
+```text
+Make this agent a local service with an always-on dashboard, following fabric-service/0.1.
+```
+
 Or, for an agent that does not exist yet:
 
 ```text
@@ -86,11 +119,23 @@ claude plugin validate ./plugins/fabric-agent-adapter --strict
 claude plugin validate . --strict
 ```
 
+`test/validate.py` reads every SKILL.md front matter as strictly as a YAML parser does; an
+unquoted value holding `: ` fails it. `python3 test/validate.py --frontmatter <SKILL.md ...>`
+checks copies installed elsewhere, such as `~/.agents/skills/*/SKILL.md`.
+
 ## Contract pin
 
 - version: `0.1.0`
-- commit: `20a818e648a4c09a60df0126d11626922e8b9094`
+- commit: `a5a27092ba0dcc5facfbeae8b359146dfb403e9a`
 
 The contract repository is normative. Updating the pin requires a new adapter release,
 fixture review, and a complete validation run.
 
+## License
+
+Source-available under PolyForm Noncommercial or Internal Use; commercial license on
+request (contact@passioncode.ai). SPDX:
+`PolyForm-Noncommercial-1.0.0 OR LicenseRef-PolyForm-Internal-Use-1.0.0` — see
+[LICENSE](LICENSE). Versions up to and including v0.4.2 (npm up to 0.3.1) were released
+under the MIT License and remain available under it. Contributions are accepted under
+[CLA.md](CLA.md) ([CONTRIBUTING.md](CONTRIBUTING.md)).

package/SECURITY.md

@@ -1,10 +1,23 @@
 # Security
 
-Report vulnerabilities privately to the maintainers of the `passioncode-ai`
-organization. Do not open a public issue containing credentials, private provider URLs,
-or customer project data.
+Report vulnerabilities privately to contact@passioncode.ai. Do not open a public issue
+containing credentials, private provider URLs, or customer project data.
 
 The adapter must not write secret values to manifests, fixtures, probes, logs, or command
 arguments. Generated and external provider outputs are untrusted. Live probes must be
 bounded and non-publishing until explicit scoped grants exist in a project binding.
 
+
+## What the installers and scripts touch
+
+- `npx @passioncode-ai/fabric-agent-adapter` and `install.sh` write only
+  `~/.agents/skills/<skill>`; `--target claude` writes `~/.claude/skills/<skill>` and is
+  refused while the plugin is installed; `--prune-shadow` moves shadowing copies into
+  `~/.claude/skills-shadow-backup/`.
+- `building-fabric-services/scripts/check_service.py` reads a descriptor and the token
+  file it names, talks only to `127.0.0.1:<port>`, and redeems one login code it asked
+  for itself (creating one dashboard session). It never prints the token.
+- The service kits create the service token (0600) and the instance lock in the
+  service's own data directory, and write a launchd plist and a descriptor only when an
+  installer calls them. The token is readable by any process of the same user; the
+  protocol defends against web pages and mistakes, not against hostile local code.

package/bin/fabric-agent-adapter.js

@@ -2,13 +2,12 @@
 /*
  * fabric-agent-adapter installer CLI.
  *
- * Installs every skill this plugin ships into ~/.claude/skills/<name>
- * (same layout as install.sh). Idempotent: an existing install is skipped unless
- * --force. Zero dependencies.
- *
- * For other agents (Cursor, Codex, 70+) use:
- *   npx skills add passioncode-ai/fabric-agent-adapter   (needs GitHub access —
- *   the repository is private; the npm package needs none)
+ * Installs every skill this plugin ships into the shared agents hub
+ * ~/.agents/skills/<name> (read by Codex, Cursor, Gemini, OpenCode and others).
+ * Claude Code gets the skills through the plugin, never through a plain copy:
+ * a copy in ~/.claude/skills shadows the plugin and serves its frozen version
+ * forever. Idempotent; an existing install is skipped unless --force.
+ * Zero dependencies.
  */
 'use strict';
 
@@ -18,20 +17,25 @@ const os = require('os');
 
 const ROOT = path.resolve(__dirname, '..');
 const REPO = 'passioncode-ai/fabric-agent-adapter';
+const PLUGIN_ID = 'fabric-agent-adapter@fabric-agent-adapter';
 
 function usage() {
   console.log(`fabric-agent-adapter installer
 
 Usage:
   npx @passioncode-ai/fabric-agent-adapter [--force]
-      install every skill this plugin ships into ~/.claude
-      (skip existing unless --force)
+      install every skill into the agents hub ~/.agents/skills
+  npx @passioncode-ai/fabric-agent-adapter --target claude [--force]
+      plain copy into ~/.claude/skills — refused while the plugin is installed
+  npx @passioncode-ai/fabric-agent-adapter --prune-shadow
+      remove plain ~/.claude/skills copies that shadow the installed plugin
   npx @passioncode-ai/fabric-agent-adapter --help
 
-Other install paths:
-  Claude Code plugin:  /plugin marketplace add ${REPO}
-                       /plugin install fabric-agent-adapter@fabric-agent-adapter
-  Any agent (70+):     npx skills add ${REPO}   (private repo — GitHub auth required)`);
+Claude Code (recommended):
+  claude plugin marketplace add ${REPO}
+  claude plugin install ${PLUGIN_ID}
+Every PassionCode.ai skill for every agent at once:
+  npx @passioncode-ai/passioncode@latest update`);
 }
 
 function copyDir(src, dest) {
@@ -44,15 +48,38 @@ function copyDir(src, dest) {
   }
 }
 
-function installOne(label, src, dest, force) {
-  if (fs.existsSync(dest) && !force) {
-    console.log(`skip: ${label} already installed at ${dest} (rerun with --force to overwrite)`);
-    return;
+function pluginInstalled(home) {
+  try {
+    const data = JSON.parse(fs.readFileSync(path.join(home, '.claude/plugins/installed_plugins.json'), 'utf8'));
+    const records = (data.plugins || {})[PLUGIN_ID] || [];
+    return records.some((r) => r.installPath && fs.existsSync(path.join(r.installPath, 'skills')));
+  } catch {
+    return false;
+  }
+}
+
+function skillNames() {
+  const skillRoot = path.join(ROOT, 'plugins/fabric-agent-adapter/skills');
+  if (!fs.existsSync(skillRoot)) return { skillRoot, names: [] };
+  // Iterate rather than name one skill: a skill added to the plugin must not
+  // require an installer change to reach anybody.
+  const names = fs.readdirSync(skillRoot, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name).sort();
+  return { skillRoot, names };
+}
+
+function pruneShadows(home, names) {
+  let removed = 0;
+  for (const name of names) {
+    const shadow = path.join(home, '.claude', 'skills', name);
+    let info;
+    try { info = fs.lstatSync(shadow); } catch { continue; }
+    const backup = path.join(home, '.claude', 'skills-shadow-backup', `${name}-${Date.now()}`);
+    fs.mkdirSync(path.dirname(backup), { recursive: true });
+    fs.renameSync(shadow, backup);
+    console.log(`Removed shadowing ${info.isSymbolicLink() ? 'link' : 'copy'} ${shadow} (kept at ${backup})`);
+    removed += 1;
   }
-  fs.rmSync(dest, { recursive: true, force: true });
-  fs.mkdirSync(path.dirname(dest), { recursive: true });
-  copyDir(src, dest);
-  console.log(`Installed ${label} -> ${dest}`);
+  if (!removed) console.log('No shadowing copies found.');
 }
 
 function main(argv) {
@@ -62,39 +89,56 @@ function main(argv) {
     return 0;
   }
   const force = args.includes('--force');
-  const unknown = args.filter((a) => a !== '--force');
-  if (unknown.length) {
-    console.error(`unknown argument(s): ${unknown.join(' ')}`);
+  const prune = args.includes('--prune-shadow');
+  let target = 'agents';
+  const known = new Set(['--force', '--prune-shadow']);
+  const unknown = [];
+  for (let i = 0; i < args.length; i += 1) {
+    if (args[i] === '--target') {
+      target = args[i + 1];
+      i += 1;
+    } else if (!known.has(args[i])) unknown.push(args[i]);
+  }
+  if (unknown.length || !['agents', 'claude'].includes(target)) {
+    console.error(`unknown argument(s): ${unknown.concat(['agents', 'claude'].includes(target) ? [] : [`--target ${target}`]).join(' ')}`);
     usage();
     return 2;
   }
 
-  const skillRoot = path.join(ROOT, 'plugins/fabric-agent-adapter/skills');
-  if (!fs.existsSync(skillRoot)) {
-    console.error(`error: skill sources missing at ${skillRoot} — corrupted package?`);
+  const { skillRoot, names } = skillNames();
+  if (!names.length) {
+    console.error(`error: no skills found under ${skillRoot} — corrupted package?`);
     return 1;
   }
+  const home = os.homedir();
+  const hasPlugin = pluginInstalled(home);
 
-  // Iterate rather than name one skill: a skill added to the plugin must not
-  // require an installer change to reach anybody.
-  const names = fs
-    .readdirSync(skillRoot, { withFileTypes: true })
-    .filter((e) => e.isDirectory())
-    .map((e) => e.name)
-    .sort();
-  if (!names.length) {
-    console.error(`error: no skills found under ${skillRoot} — corrupted package?`);
+  if (prune) {
+    if (!hasPlugin) {
+      console.error(`error: the ${PLUGIN_ID} plugin is not installed, so a copy in ~/.claude/skills is not a shadow — nothing removed.`);
+      return 1;
+    }
+    pruneShadows(home, names);
+    return 0;
+  }
+  if (target === 'claude' && hasPlugin) {
+    console.error(`error: the ${PLUGIN_ID} plugin is installed; a plain copy in ~/.claude/skills would shadow it. Update the plugin instead:\n  claude plugin marketplace update fabric-agent-adapter && claude plugin update ${PLUGIN_ID}`);
     return 1;
   }
 
-  const home = os.homedir();
+  const destRoot = target === 'claude' ? path.join(home, '.claude', 'skills') : path.join(home, '.agents', 'skills');
   for (const name of names) {
-    installOne(
-      `${name} skill`,
-      path.join(skillRoot, name),
-      path.join(home, '.claude', 'skills', name),
-      force
-    );
+    const dest = path.join(destRoot, name);
+    if (fs.existsSync(dest) && !force) {
+      console.log(`skip: ${name} already installed at ${dest} (rerun with --force to overwrite)`);
+      continue;
+    }
+    fs.rmSync(dest, { recursive: true, force: true });
+    copyDir(path.join(skillRoot, name), dest);
+    console.log(`Installed ${name} -> ${dest}`);
+  }
+  if (target === 'agents' && !hasPlugin) {
+    console.log(`Claude Code reads plugins, not the hub:\n  claude plugin marketplace add ${REPO} && claude plugin install ${PLUGIN_ID}`);
   }
   console.log('Restart your agent — skills load at session start.');
   return 0;

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@passioncode-ai/fabric-agent-adapter",
-  "version": "0.3.1",
-  "description": "Create new Fabric-compatible agents and adapt existing projects to the Fabric Agent Contract — evidence-backed MCP, A2A, or local-runner provider bundles. This package is the installer CLI.",
+  "version": "0.4.3",
+  "description": "Create Fabric-compatible agents, run them as always-alive local services with dashboards (fabric-service/0.1), and adapt existing projects to the Fabric Agent Contract. This package is the installer CLI.",
   "scripts": {
-    "test": "python3 test/validate.py && python3 -m unittest discover -s test -q"
+    "test": "python3 test/validate.py && python3 -m unittest discover -s test -q && node --test test/"
   },
   "bin": {
     "fabric-agent-adapter": "bin/fabric-agent-adapter.js"
@@ -17,14 +17,16 @@
     "README.md",
     "LICENSE",
     "CHANGELOG.md",
-    "SECURITY.md"
+    "SECURITY.md",
+    "!**/__pycache__/**",
+    "!**/*.pyc"
   ],
   "repository": "github:passioncode-ai/fabric-agent-adapter",
   "homepage": "https://github.com/passioncode-ai/fabric-agent-adapter",
-  "license": "MIT",
+  "license": "PolyForm-Noncommercial-1.0.0 OR LicenseRef-PolyForm-Internal-Use-1.0.0",
   "author": {
-    "name": "passioncode-ai",
-    "url": "https://github.com/passioncode-ai"
+    "name": "PassionCode.ai",
+    "url": "https://passioncode.ai/"
   },
   "engines": {
     "node": ">=16"
@@ -39,6 +41,9 @@
     "provider",
     "conformance",
     "claude-code",
-    "skill"
+    "skill",
+    "local-service",
+    "dashboard",
+    "launchd"
   ]
 }

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

@@ -2,15 +2,15 @@
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "fabric-agent-adapter",
   "displayName": "Fabric Agent Adapter",
-  "description": "Create new Fabric-compatible agents and adapt existing projects to the Fabric Agent Contract through evidence-backed MCP, A2A, or local-runner provider bundles.",
-  "version": "0.3.1",
+  "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.4.3",
   "author": {
-    "name": "passioncode-ai",
-    "url": "https://github.com/passioncode-ai"
+    "name": "PassionCode.ai",
+    "url": "https://passioncode.ai/"
   },
   "homepage": "https://github.com/passioncode-ai/fabric-agent-adapter",
   "repository": "https://github.com/passioncode-ai/fabric-agent-adapter",
-  "license": "MIT",
+  "license": "PolyForm-Noncommercial-1.0.0 OR LicenseRef-PolyForm-Internal-Use-1.0.0",
   "keywords": [
     "fabric",
     "agent",
@@ -22,4 +22,3 @@
     "conformance"
   ]
 }
-