chainlesschain 0.152.0 → 0.156.0

package/README.md

@@ -190,7 +190,7 @@ chainlesschain llm switch <name>        # Switch active provider
 
 ### `chainlesschain agent` (alias: `a`)
 
-Start an agentic AI session — the AI can read/write files, run shell commands, search the codebase, execute code (Python/Node.js/Bash with auto pip-install), and invoke 138 built-in skills.
+Start an agentic AI session — the AI can read/write files, run shell commands, search the codebase, execute code (Python/Node.js/Bash with auto pip-install), and invoke 139 built-in skills.
 
 ```bash
 chainlesschain agent                    # Default: Ollama qwen2.5:7b
@@ -206,7 +206,7 @@ Agent slash commands: `/plan` (plan mode), `/plan interactive <request>` (LLM-dr
 
 ### `chainlesschain skill <action>`
 
-Manage and run 138 built-in AI skills across a 4-layer system: bundled < marketplace < managed (global) < workspace (project).
+Manage and run 139 built-in AI skills across a 4-layer system: bundled < marketplace < managed (global) < workspace (project).
 
 ```bash
 chainlesschain skill list               # List all skills grouped by category
@@ -1169,6 +1169,55 @@ chainlesschain orchestrate --webhook --webhook-port 18820
 
 ---
 
+## CLI V2 Governance Wave (iter16–iter28, 2026-04-19)
+
+Thirteen iterations (iter16 → iter28) ported **136 Governance V2 surfaces** onto the CLI, one per underlying library module. Each surface adds a pair of state-machine-governed lifecycles on top of an existing module and ships behind `-v2`-suffixed subcommands — existing non-v2 behavior is untouched.
+
+### Shape of a Gov V2 surface
+
+Every surface follows the same dual-layer FSM pattern:
+
+- **Profile lifecycle (4 states)** — one of `{paused, suspended, stale, degraded, deprecated, dormant, muted, disabled, frozen, breached, drifted}` depending on the domain, with recovery back to `active` and an `archived` terminal.
+- **Action lifecycle (5 states)** — `pending → running → {completed | failed | cancelled}`, three terminals.
+- **Caps** — per-surface profile/action caps (ranging 5/10 on small surfaces up to 15/30 on high-volume ones like feature-flags).
+- **Auto-hooks** — `auto-<degraded>-idle` moves idle profiles into the non-active branch; `auto-fail-stuck` fails actions stuck in `running` past a TTL (30s / 60s depending on surface).
+- **`*gov-gov-stats-v2`** aggregate command per surface.
+- **44 V2 tests** per surface (profile FSM, action FSM, caps, hooks, stats), plus a shared `preAction` hook that prevents accidental nesting of `-v2` subcommands.
+
+### Surface inventory by iteration
+
+| Iter   | Gov prefix → parent command                                                                                                                                                                                    | Surfaces                                                                                                                                                                                                                                                                                                                                      |
+| ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| iter16 | `aud-gov-` / `kgov-` / `sbox-gov-` / `slagov-` / `strgov-` / `tfgov-` / `repgov-` / `mktgov-`                                                                                                                  | `audit`, `kg`, `sandbox`, `sla`, `stress`, `terraform`, `reputation`, `marketplace`                                                                                                                                                                                                                                                           |
+| iter17 | `chatgov-` / `ccbgov-` / `cmgr-` / `learn-` / `cwwf-` / `pcgov-` / `incgov-` / `hardgov-`                                                                                                                      | `chat`, `orchestrate` (claude-code-bridge), `compliance`, `cowork` (learning + workflow), `privacy`, `incentive`, `hardening`                                                                                                                                                                                                                 |
+| iter18 | `aiopsgov-` / `mmgov-` / `instgov-` / `tnsgov-` / `qntgov-` / `trustgov-` / `nlpgov-` / `percgov-`                                                                                                             | `ops`, `multimodal`, `instinct`, `tenant`, `quantize`, `trust`, `nlprog`, `perception`                                                                                                                                                                                                                                                        |
+| iter19 | `cdagov-` / `cogov-` / `commgov-` / `didgov-` / `ssogov-` / `orggov-` / `scimgov-` / `syncgov-`                                                                                                                | `codegen`, `collab`, `governance`, `did`, `sso`, `org`, `scim`, `sync`                                                                                                                                                                                                                                                                        |
+| iter20 | `anetgov-` / `bagov-` / `dlpgov-` / `evgov-` / `fedgov-` / `ipfsgov-` / `p2pgov-` / `walgov-`                                                                                                                  | `agent-network`, `browse`, `dlp`, `evomap`, `federation`, `ipfs`, `p2p`, `wallet`                                                                                                                                                                                                                                                             |
+| iter21 | `apgov-` / `matgov-` / `nosgov-` / `bigov-` / `memgov-` / `sesgov-` / `hookgov-` / `wfgov-`                                                                                                                    | `activitypub`, `matrix`, `nostr`, `bi`, `memory`, `session`, `hook`, `workflow`                                                                                                                                                                                                                                                               |
+| iter22 | `augov-` / `shgov-` / `dv2gov-` / `kexpgov-` / `kimpgov-` / `llmgov-` / `pqcgov-` / `smgov-`                                                                                                                   | `automation`, `cowork` (share), `did-v2`, `export`, `import`, `llm`, `pqc`, `social`                                                                                                                                                                                                                                                          |
+| iter23 | `rcgov-` / `techgov-` / `rtgov-` / `ntgov-` / `pmgov-` / `pfgov-` / `dbevogov-` / `digov-`                                                                                                                     | `rcache`, `tech`, `runtime`, `note` (versioning), `permmem`, `fusion`, `dbevo`, `infra`                                                                                                                                                                                                                                                       |
+| iter24 | `rcmdgov-` / `mcpgov-` / `ecogov-` / `sklgov-` / `toktgov-` / `devgov-` / `tigov-` / `uebgov-`                                                                                                                 | `recommend`, `mcp`, `ecosystem`, `skill`, `tokens`, `dev`, `compliance` (threat-intel + ueba)                                                                                                                                                                                                                                                 |
+| iter25 | `cttgov-` / `ctmgov-` / `clibgov-` / `argov-` / `saregov-` / `todogov-` / `ebgov-` / `evfedgov-`                                                                                                               | `cowork` (task-templates + template-marketplace), `cli-anything`, `orchestrate` (agent-router), `agent` (registry + todo + exec-backend), `evomap` (federation)                                                                                                                                                                               |
+| iter26 | `plannergov-` / `ctxenggov-` / `sactxgov-` / `iagov-` / `wfexgov-` / `padgov-` / `hlgov-` / `webuigov-`                                                                                                        | `planmode`, `cli-anything`, `agent` (sub-agent-context), `chat` (interaction-adapter), `workflow` (expr), `plugin` (autodiscovery), `memory` (hashline), `ui` (web-ui-server)                                                                                                                                                                 |
+| iter27 | `dlgov-` / `smcpgov-` / `cmcpgov-` / `stixgov-` / `sapgov-` / `cobsgov-` / `pmgrgov-` / `wscgov-` / `evcligov-` / `poptgov-` / `scsgov-` / `smgrgov-` / `ceadgov-` / `pstrmgov-` / `cohtgov-` / `cadpgov-`     | `setup`, `skill`, `cowork` (mcp-tools / observe / observe-html / evomap-adapter / adapter), `compliance` (stix), `agent` (sub-agent-profiles), `start` (process-manager), `chat` (ws-chat-handler), `evomap` (client), `llm` (provider-options), `config` (session-core-singletons), `services` (service-manager), `stream` (provider-stream) |
+| iter28 | `a2apgov-` / `acrdgov-` / `aecogov-` / `autagov-` / `ccoregov-` / `cmpmgov-` / `crchgov-` / `crygov-` / `daomgov-` / `esysgov-` / `emgrgov-` / `hmemgov-` / `infnetgov-` / `kggov-` / `pipogov-` / `pmodegov-` | `a2a`, `orchestrate` (agent-coordinator), `economy`, `agent` (autonomous-agent), `chat` (chat-core), `compliance` (compliance-manager), `crosschain`, `encrypt` (crypto-manager), `dao`, `evolution`, `evomap` (evomap-manager), `hmemory`, `inference`, `kg`, `pipeline`, `planmode` (plan-mode)                                             |
+
+**Totals**: 136 surfaces × ~44 V2 tests ≈ **~5,984 additional CLI V2 tests** introduced in this wave.
+
+### Typical usage
+
+```bash
+cc audit aud-gov-register-v2 --profile secops --level warn
+cc audit aud-gov-activate-v2 --profile secops
+cc audit aud-gov-write-start-v2 --profile secops --payload '{"evt":"login"}'
+cc audit aud-gov-write-complete-v2 --action-id <id>
+cc audit aud-gov-gov-stats-v2 --json
+```
+
+Every surface follows this shape — replace `aud-gov-` with the prefix from the table and `audit` with the parent command.
+
+---
+
 ## Global Options
 
 ```bash
@@ -1244,7 +1293,7 @@ Configuration is stored at `~/.chainlesschain/config.json`. The CLI creates and
 ```bash
 cd packages/cli
 npm install
-npm test                # Run all tests (5400+ tests across 201+ files)
+npm test                # Run all tests (7600+ tests across 280+ files, incl. ~2,800 V2 governance tests from iter16–iter23)
 npm run test:unit       # Unit tests only
 npm run test:integration # Integration tests
 npm run test:e2e        # End-to-end tests

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chainlesschain",
-  "version": "0.152.0",
+  "version": "0.156.0",
   "description": "CLI for ChainlessChain - install, configure, and manage your personal AI management system",
   "type": "module",
   "bin": {

package/src/commands/a2a.js

@@ -982,3 +982,204 @@ export function registerA2aV2Command(a2a) {
       console.log(JSON.stringify(getA2aProtocolGovStatsV2(), null, 2));
     });
 }
+
+// === Iter28 V2 governance overlay: A2apgov ===
+export function registerA2apV2Commands(program) {
+  const parent = program.commands.find((c) => c.name() === "a2a");
+  if (!parent) return;
+  const L = async () => await import("../lib/a2a-protocol.js");
+  parent
+    .command("a2apgov-enums-v2")
+    .description("Show V2 enums")
+    .action(async () => {
+      const m = await L();
+      console.log(
+        JSON.stringify(
+          {
+            profileMaturity: m.A2APGOV_PROFILE_MATURITY_V2,
+            msgLifecycle: m.A2APGOV_MSG_LIFECYCLE_V2,
+          },
+          null,
+          2,
+        ),
+      );
+    });
+  parent
+    .command("a2apgov-config-v2")
+    .description("Show V2 config")
+    .action(async () => {
+      const m = await L();
+      console.log(
+        JSON.stringify(
+          {
+            maxActive: m.getMaxActiveA2apProfilesPerOwnerV2(),
+            maxPending: m.getMaxPendingA2apMsgsPerProfileV2(),
+            idleMs: m.getA2apProfileIdleMsV2(),
+            stuckMs: m.getA2apMsgStuckMsV2(),
+          },
+          null,
+          2,
+        ),
+      );
+    });
+  parent
+    .command("a2apgov-set-max-active-v2 <n>")
+    .description("Set max active")
+    .action(async (n) => {
+      (await L()).setMaxActiveA2apProfilesPerOwnerV2(Number(n));
+      console.log("ok");
+    });
+  parent
+    .command("a2apgov-set-max-pending-v2 <n>")
+    .description("Set max pending")
+    .action(async (n) => {
+      (await L()).setMaxPendingA2apMsgsPerProfileV2(Number(n));
+      console.log("ok");
+    });
+  parent
+    .command("a2apgov-set-idle-ms-v2 <n>")
+    .description("Set idle threshold ms")
+    .action(async (n) => {
+      (await L()).setA2apProfileIdleMsV2(Number(n));
+      console.log("ok");
+    });
+  parent
+    .command("a2apgov-set-stuck-ms-v2 <n>")
+    .description("Set stuck threshold ms")
+    .action(async (n) => {
+      (await L()).setA2apMsgStuckMsV2(Number(n));
+      console.log("ok");
+    });
+  parent
+    .command("a2apgov-register-v2 <id> <owner>")
+    .description("Register V2 profile")
+    .option("--endpoint <v>", "endpoint")
+    .action(async (id, owner, o) => {
+      const m = await L();
+      console.log(
+        JSON.stringify(
+          m.registerA2apProfileV2({ id, owner, endpoint: o.endpoint }),
+          null,
+          2,
+        ),
+      );
+    });
+  parent
+    .command("a2apgov-activate-v2 <id>")
+    .description("Activate profile")
+    .action(async (id) => {
+      console.log(
+        JSON.stringify((await L()).activateA2apProfileV2(id), null, 2),
+      );
+    });
+  parent
+    .command("a2apgov-stale-v2 <id>")
+    .description("Stale profile")
+    .action(async (id) => {
+      console.log(JSON.stringify((await L()).staleA2apProfileV2(id), null, 2));
+    });
+  parent
+    .command("a2apgov-archive-v2 <id>")
+    .description("Archive profile")
+    .action(async (id) => {
+      console.log(
+        JSON.stringify((await L()).archiveA2apProfileV2(id), null, 2),
+      );
+    });
+  parent
+    .command("a2apgov-touch-v2 <id>")
+    .description("Touch profile")
+    .action(async (id) => {
+      console.log(JSON.stringify((await L()).touchA2apProfileV2(id), null, 2));
+    });
+  parent
+    .command("a2apgov-get-v2 <id>")
+    .description("Get profile")
+    .action(async (id) => {
+      console.log(JSON.stringify((await L()).getA2apProfileV2(id), null, 2));
+    });
+  parent
+    .command("a2apgov-list-v2")
+    .description("List profiles")
+    .action(async () => {
+      console.log(JSON.stringify((await L()).listA2apProfilesV2(), null, 2));
+    });
+  parent
+    .command("a2apgov-create-msg-v2 <id> <profileId>")
+    .description("Create msg")
+    .option("--messageId <v>", "messageId")
+    .action(async (id, profileId, o) => {
+      const m = await L();
+      console.log(
+        JSON.stringify(
+          m.createA2apMsgV2({ id, profileId, messageId: o.messageId }),
+          null,
+          2,
+        ),
+      );
+    });
+  parent
+    .command("a2apgov-dispatching-msg-v2 <id>")
+    .description("Mark msg as dispatching")
+    .action(async (id) => {
+      console.log(
+        JSON.stringify((await L()).dispatchingA2apMsgV2(id), null, 2),
+      );
+    });
+  parent
+    .command("a2apgov-complete-msg-v2 <id>")
+    .description("Complete msg")
+    .action(async (id) => {
+      console.log(JSON.stringify((await L()).completeMsgA2apV2(id), null, 2));
+    });
+  parent
+    .command("a2apgov-fail-msg-v2 <id> [reason]")
+    .description("Fail msg")
+    .action(async (id, reason) => {
+      console.log(
+        JSON.stringify((await L()).failA2apMsgV2(id, reason), null, 2),
+      );
+    });
+  parent
+    .command("a2apgov-cancel-msg-v2 <id> [reason]")
+    .description("Cancel msg")
+    .action(async (id, reason) => {
+      console.log(
+        JSON.stringify((await L()).cancelA2apMsgV2(id, reason), null, 2),
+      );
+    });
+  parent
+    .command("a2apgov-get-msg-v2 <id>")
+    .description("Get msg")
+    .action(async (id) => {
+      console.log(JSON.stringify((await L()).getA2apMsgV2(id), null, 2));
+    });
+  parent
+    .command("a2apgov-list-msgs-v2")
+    .description("List msgs")
+    .action(async () => {
+      console.log(JSON.stringify((await L()).listA2apMsgsV2(), null, 2));
+    });
+  parent
+    .command("a2apgov-auto-stale-idle-v2")
+    .description("Auto-stale idle")
+    .action(async () => {
+      console.log(
+        JSON.stringify((await L()).autoStaleIdleA2apProfilesV2(), null, 2),
+      );
+    });
+  parent
+    .command("a2apgov-auto-fail-stuck-v2")
+    .description("Auto-fail stuck msgs")
+    .action(async () => {
+      console.log(
+        JSON.stringify((await L()).autoFailStuckA2apMsgsV2(), null, 2),
+      );
+    });
+  parent
+    .command("a2apgov-gov-stats-v2")
+    .description("V2 gov stats")
+    .action(async () => {
+      console.log(JSON.stringify((await L()).getA2apgovStatsV2(), null, 2));
+    });
+}