total-recall-brain 3.40.0 → 3.40.2

package/scaffold/.agent/skills/total-recall/plugins/composable-cli/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "tr-plugin-composable-cli",
+  "version": "0.2.1",
+  "type": "module",
+  "description": "Total Recall composable CLI plugin: create, compose, register, test and safely run custom verbs; every command listed in the instruction surfaces.",
+  "scripts": {
+    "ssss": "ssss",
+    "test": "node --test test/*.test.mjs",
+    "export": "ssss export vault --profile sale --out dist/bundle.ucw.json",
+    "validate": "ssss conformance --engine"
+  },
+  "dependencies": {
+    "@gregiteen/ssss-cli": "0.11.2"
+  },
+  "license": "MIT",
+  "files": [
+    "cli.mjs",
+    "plugin.json",
+    "README.md",
+    "LICENSE",
+    "examples/",
+    "schemas/",
+    "skills/",
+    "src/",
+    "!src/**/*.spec.mjs",
+    "ui/"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scaffold/.agent/skills/total-recall/plugins/composable-cli/plugin.json

@@ -0,0 +1,221 @@
+{
+  "$schema": "https://github.com/gregiteen/total-recall/blob/main/metadata.plugin.schema.json",
+  "id": "composable-cli",
+  "name": "Composable CLI",
+  "version": "0.2.1",
+  "description": "Dynamic agent command composition engine with pipeline registration, versioning, and execution.",
+  "author": "Total Recall contributors",
+  "license": "MIT",
+  "branding": {
+    "name": "CmdSmith",
+    "color": "#0891b2",
+    "badge": "Pipeline Forge",
+    "font": "space-grotesk"
+  },
+  "secrets": [
+    {
+      "key": "COMPOSABLE_CLI_AUTH_TOKEN",
+      "description": "Optional token for distributed command runners",
+      "required": false
+    }
+  ],
+  "cli": {
+    "command": "composable-cli",
+    "handler": "./cli.mjs",
+    "subcommands": [
+      {
+        "name": "status",
+        "description": "Show which Composable CLI subcommands are implemented",
+        "effect": "read"
+      },
+      {
+        "name": "create",
+        "description": "Create a new custom CLI command",
+        "effect": "write"
+      },
+      {
+        "name": "read",
+        "description": "Show the source of a custom command",
+        "effect": "read"
+      },
+      {
+        "name": "update",
+        "description": "Update an existing custom command",
+        "effect": "write"
+      },
+      {
+        "name": "remove",
+        "description": "Delete a custom command",
+        "effect": "destructive"
+      },
+      {
+        "name": "list",
+        "description": "List all custom commands in scope",
+        "effect": "read"
+      },
+      {
+        "name": "show",
+        "description": "Show command metadata and source",
+        "effect": "read"
+      },
+      {
+        "name": "history",
+        "description": "Show version history of a command",
+        "effect": "read"
+      },
+      {
+        "name": "rollback",
+        "description": "Roll back a command to a previous version",
+        "effect": "write"
+      },
+      {
+        "name": "test",
+        "description": "Show the test file for a command",
+        "effect": "read"
+      },
+      {
+        "name": "promote",
+        "description": "Promote a command into a plugin directory",
+        "effect": "write"
+      },
+      {
+        "name": "library",
+        "description": "Discover installed plugin operations and scoped composed commands without execution",
+        "effect": "read",
+        "output": "json",
+        "args": [
+          {
+            "name": "plugin",
+            "label": "Plugin ID",
+            "type": "string",
+            "flag": "--plugin",
+            "required": false
+          }
+        ]
+      }
+    ]
+  },
+  "deploy": {
+    "targets": [
+      "ssss-app",
+      "nextjs",
+      "react",
+      "flask"
+    ],
+    "required_ssss_version": ">=0.9.3",
+    "access_grants": [
+      "auth:session:verify",
+      "ssss:vault:read",
+      "ssss:vault:write",
+      "ssss:events:append"
+    ]
+  },
+  "skills": [
+    {
+      "id": "composable-cli",
+      "path": "./skills/composable-cli/SKILL.md",
+      "description": "Total Recall composable CLI plugin: create, compose, register, test and safely run custom verbs; every command listed in the instruction surfaces."
+    }
+  ],
+  "card_face": {
+    "skin": "studio-rack",
+    "theme": "vibrant",
+    "headline": "Dynamic Agent Command Composition",
+    "primary_color": "#14b8a6",
+    "secondary_color": "#134e4a",
+    "accent_color": "#2dd4bf",
+    "touch_layout": "comfortable",
+    "interactive": true,
+    "quick_actions": [
+      {
+        "subcommand": "status",
+        "label": "STATUS"
+      },
+      {
+        "subcommand": "create",
+        "label": "CREATE"
+      },
+      {
+        "subcommand": "read",
+        "label": "READ"
+      },
+      {
+        "subcommand": "update",
+        "label": "UPDATE"
+      }
+    ]
+  },
+  "ui": {
+    "elements": [
+      {
+        "id": "card",
+        "kind": "card",
+        "tag": "tr-composable-cli-card",
+        "module": "ui/card.js",
+        "description": "Pipeline Card Face"
+      }
+    ]
+  },
+  "ssss_schemas": {
+    "categories": [
+      {
+        "name": "composable-commands",
+        "description": "Registered composable CLI commands and aliases",
+        "node_type": "memory"
+      },
+      {
+        "name": "composed-workflows",
+        "description": "Composed multi-step CLI workflow definitions",
+        "node_type": "memory"
+      }
+    ]
+  },
+  "auth": {
+    "plugin": "auth",
+    "methods": [
+      "passkey",
+      "google-oauth2"
+    ],
+    "session_verification": true
+  },
+  "status": {
+    "command": "status",
+    "refresh_seconds": 300
+  },
+  "distribution": {
+    "tier": "official",
+    "license": "open"
+  },
+  "card_layout": {
+    "template": "workbench",
+    "regions": [
+      {
+        "widget": "status",
+        "title": "Status"
+      },
+      {
+        "widget": "live",
+        "title": "Live view"
+      },
+      {
+        "widget": "list",
+        "title": "Details",
+        "source": {
+          "command": "list"
+        }
+      },
+      {
+        "widget": "actions",
+        "title": "Commands"
+      },
+      {
+        "widget": "credentials",
+        "title": "Credentials"
+      },
+      {
+        "widget": "activity",
+        "title": "Recent activity"
+      }
+    ]
+  }
+}

package/scaffold/.agent/skills/total-recall/plugins/composable-cli/schemas/cli_command.schema.json

@@ -0,0 +1,107 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://github.com/gregiteen/tr-plugin-composable-cli/schemas/cli_command.schema.json",
+  "title": "CLI Command",
+  "description": "SSSS document type for a registered composable CLI command. Lives beside the command's .mjs file as <scope dir>/commands/<name>.md.",
+  "type": "object",
+  "properties": {
+    "type": {
+      "type": "string",
+      "const": "cli_command",
+      "description": "SSSS document type marker"
+    },
+    "id": {
+      "type": "string",
+      "format": "uuid",
+      "description": "Stable UUID identifying this command registration"
+    },
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]{0,63}$",
+      "description": "Command name invoked as `total-recall <name>`"
+    },
+    "scope": {
+      "type": "string",
+      "enum": ["project", "group", "global"],
+      "description": "Visibility scope of the command"
+    },
+    "owner_project": {
+      "type": "string",
+      "format": "uuid",
+      "description": "Project UUID that owns this command (scope=project)"
+    },
+    "group": {
+      "type": "string",
+      "format": "uuid",
+      "description": "Group UUID for group-scoped commands (scope=group)"
+    },
+    "risk": {
+      "type": "string",
+      "enum": ["read", "write", "money", "dns-cert", "production-deploy", "secret-revoke"],
+      "description": "Risk class governing dry-run / --yes behavior"
+    },
+    "version": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Current version number; incremented on every update"
+    },
+    "author": {
+      "type": "string",
+      "description": "Agent or user id that created the command"
+    },
+    "created": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 creation timestamp"
+    },
+    "updated": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 last-updated timestamp"
+    },
+    "description": {
+      "type": "string",
+      "description": "Human-readable command description"
+    },
+    "background_allowed": {
+      "type": "boolean",
+      "description": "Whether the command supports --background execution"
+    },
+    "code_sha256": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{64}$",
+      "description": "SHA-256 hash of the current command file content"
+    },
+    "last_test": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 timestamp of the last test run"
+    },
+    "last_test_ok": {
+      "type": "boolean",
+      "description": "Whether the last test run passed"
+    },
+    "source": {
+      "type": "string",
+      "enum": ["inline", "from-plugin", "config-for-skill", "upgraded", "nickname"],
+      "description": "How the command was created"
+    },
+    "tags": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Arbitrary tags for categorization"
+    }
+  },
+  "required": [
+    "type",
+    "id",
+    "name",
+    "scope",
+    "risk",
+    "version",
+    "author",
+    "created",
+    "updated"
+  ],
+  "additionalProperties": false
+}

package/scaffold/.agent/skills/total-recall/plugins/composable-cli/skills/composable-cli/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: composable-cli
+description: "Total Recall composable CLI plugin: create, compose, register, test and safely run custom verbs; every command listed in the instruction surfaces."
+version: 0.2.0
+---
+
+# Composable CLI
+
+Total Recall composable CLI plugin: create, compose, register, test and safely run custom verbs.
+
+## Usage
+
+This skill is provided by the `composable-cli` Total Recall capability plugin.
+
+### Composable CLI
+```bash
+npx total-recall composable-cli status
+npx total-recall composable-cli create <name> <code> [--description "..." --risk read|write|money|...]
+npx total-recall composable-cli list [--json]
+npx total-recall composable-cli show <name> [--json]
+npx total-recall composable-cli history <name>
+npx total-recall composable-cli upgrade <name>
+npx total-recall composable-cli promote <name> --to-plugin <dir>
+```
+
+### Commands (via `total-recall`)
+```bash
+total-recall command create <name> "<code>" [--description "..."] [--risk <class>]
+total-recall command list [--json]
+total-recall command show <name> [--json]
+total-recall command history <name>
+total-recall command rollback <name> <version>
+```
+
+### v2 Command Contract
+Commands export `meta` and a default function:
+```js
+export const meta = {
+  name: 'my-command',
+  description: 'Does something useful',
+  risk: 'read',
+  version: 2,
+  background: false,
+};
+
+export default async function main(args, { tr, json, dryRun, log }) {
+  const id = await tr('project-id', ['--json']);
+  return { data: { project: id.data?.project_id } };
+}
+```
+
+### Risk Classes
+| Risk | Default | --yes required |
+|------|---------|----------------|
+| read, write | runs | no |
+| money, dns-cert, production-deploy, secret-revoke | dry-run (exit 3) | yes |
+
+### Composition
+```js
+import { tr } from 'tr-plugin-composable-cli/src/compose.mjs';
+const result = await tr('project-id', ['--json']);
+// -> { ok: true, exitCode: 0, data: { project_id: '...' } }
+```