From be161c55e4240c97e9ece33ee9b1bf03b63633fd Mon Sep 17 00:00:00 2001 From: Nikolai Emil Damm Date: Fri, 13 Nov 2026 00:05:31 +0100 Subject: [PATCH 1/4] feat(agentic-engineering): bundle Numina's MCP server Agents can read a Danish company's books in Numina and write drafts, which a person books. Part of devantler-tech/monorepo#4994. Co-Authored-By: Claude Opus 5.5 --- .claude-plugin/marketplace.json | 2 +- .github/plugin/marketplace.json | 2 +- docs/plugins.md | 2 +- docs/resources.md | 8 +++++--- .../.claude-plugin/plugin.json | 2 +- .../.codex-plugin/mcp.json | 4 ++++ .../.codex-plugin/plugin.json | 2 +- plugins/agentic-engineering/.mcp.json | 4 ++++ plugins/agentic-engineering/CHANGELOG.md | 8 ++++++++ plugins/agentic-engineering/PRIVACY.md | 1 + plugins/agentic-engineering/README.md | 19 ++++++++++++++++++- plugins/agentic-engineering/plugin.json | 2 +- .../skills/connector-setup/SKILL.md | 4 ++-- 13 files changed, 48 insertions(+), 12 deletions(-) diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index c5bfb343..082ae89a 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -20,7 +20,7 @@ { "name": "agentic-engineering", "description": "The autonomous engineering system for repository portfolios and everything its agents need — engineer, read-only surveyor, meta-engineer and Flux troubleshooter agents; portfolio, product, spend and improvement workflows; GitHub, CodeRabbit review, security, library documentation, Go, Kubernetes, Flux, Talos, SvelteKit frontend, Stripe payments, engineering-practice, design, product-management, marketing, finance and productivity skills; and the MCP servers they use; configured by the consumer AGENTS.md", - "version": "7.6.8", + "version": "7.7.0", "source": "./plugins/agentic-engineering" }, { diff --git a/.github/plugin/marketplace.json b/.github/plugin/marketplace.json index c5bfb343..082ae89a 100644 --- a/.github/plugin/marketplace.json +++ b/.github/plugin/marketplace.json @@ -20,7 +20,7 @@ { "name": "agentic-engineering", "description": "The autonomous engineering system for repository portfolios and everything its agents need — engineer, read-only surveyor, meta-engineer and Flux troubleshooter agents; portfolio, product, spend and improvement workflows; GitHub, CodeRabbit review, security, library documentation, Go, Kubernetes, Flux, Talos, SvelteKit frontend, Stripe payments, engineering-practice, design, product-management, marketing, finance and productivity skills; and the MCP servers they use; configured by the consumer AGENTS.md", - "version": "7.6.8", + "version": "7.7.0", "source": "./plugins/agentic-engineering" }, { diff --git a/docs/plugins.md b/docs/plugins.md index da59bae0..dabbf5c5 100644 --- a/docs/plugins.md +++ b/docs/plugins.md @@ -6,7 +6,7 @@ A **skill** teaches an assistant a task. An **agent** gives it a specialized rol | Plugin | Resources | Description | |--------|-----------|-------------| -| [`agentic-engineering`](../plugins/agentic-engineering/) | `accessibility-review`, `agent-improvement`, `agent-instructions`, `application-security`, `architecture`, `audit-support`, `autofix`, `brand-review`, `campaign-plan`, `check-skills`, `close-management`, `code-review`, `codeql`, `competitive-brief`, `connector-setup`, `content-creation`, `context7-mcp`, `conventional-release`, `danish-business-rules`, `debug`, `dependabot`, `dependency-scanning`, `deploy-checklist`, `design-critique`, `design-handoff`, `design-system`, `documentation`, `draft-content`, `email-sequence`, `financial-statements`, `find-skills`, `frontend-design`, `gh-cli`, `gh-stack`, `git-commit`, `github-actions-docs`, `github-actions-efficiency`, `github-actions-hardening`, `github-issues`, `gitops-cluster-debug`, `gitops-knowledge`, `gitops-tenant-onboarding`, `golang-pro`, `grilling`, `incident-response`, `journal-entry`, `journal-entry-prep`, `memory-management`, `metrics-review`, `performance-report`, `portfolio-maintenance`, `privacy-engineering`, `product-brainstorming`, `product-documentation`, `product-engineering`, `prometheus`, `promql`, `prototype`, `reconciliation`, `refactor`, `research-synthesis`, `roadmap-update`, `secret-scanning`, `self-improvement`, `seo-audit`, `siderolabs`, `skill-lifecycle`, `sox-testing`, `sprint-planning`, `stakeholder-update`, `standup`, `start`, `stripe-best-practices`, `stripe-docs`, `svelte-core-bestpractices`, `synthesize-research`, `system-design`, `task-management`, `tech-debt`, `test-driven-development`, `testing-strategy`, `update`, `upgrade-stripe`, `user-research`, `ux-copy`, `variance-analysis`, `ways-of-working`, `web-design-guidelines`, `workspace-conventions`, `write-contributing`, `write-docs-introduction`, `write-readme`, `write-spec` (skills) · `agent-improver`, `agentic-engineer`, `flux-troubleshooter`, `portfolio-surveyor` (agents) · `aws-knowledge`, `cloudflare-docs`, `context7`, `coroot`, `flux-operator-mcp`, `github`, `github-ghas-tools`, `kubescape`, `siderolabs-docs`, `stripe`, `svelte`, `terraform-registry` (MCP servers) | The autonomous engineering system for a whole repository portfolio, and everything its agents need — engineer, read-only surveyor, meta-engineer and Flux troubleshooter agents; operating, product, spend and improvement workflows; GitHub, CodeRabbit review, security, library documentation, Go, Kubernetes, Flux, Talos, SvelteKit frontend, Stripe payments, engineering-practice, design, product-management, marketing, finance and productivity skills; and the MCP servers they use. Configured by the consumer's `AGENTS.md` | +| [`agentic-engineering`](../plugins/agentic-engineering/) | `accessibility-review`, `agent-improvement`, `agent-instructions`, `application-security`, `architecture`, `audit-support`, `autofix`, `brand-review`, `campaign-plan`, `check-skills`, `close-management`, `code-review`, `codeql`, `competitive-brief`, `connector-setup`, `content-creation`, `context7-mcp`, `conventional-release`, `danish-business-rules`, `debug`, `dependabot`, `dependency-scanning`, `deploy-checklist`, `design-critique`, `design-handoff`, `design-system`, `documentation`, `draft-content`, `email-sequence`, `financial-statements`, `find-skills`, `frontend-design`, `gh-cli`, `gh-stack`, `git-commit`, `github-actions-docs`, `github-actions-efficiency`, `github-actions-hardening`, `github-issues`, `gitops-cluster-debug`, `gitops-knowledge`, `gitops-tenant-onboarding`, `golang-pro`, `grilling`, `incident-response`, `journal-entry`, `journal-entry-prep`, `memory-management`, `metrics-review`, `performance-report`, `portfolio-maintenance`, `privacy-engineering`, `product-brainstorming`, `product-documentation`, `product-engineering`, `prometheus`, `promql`, `prototype`, `reconciliation`, `refactor`, `research-synthesis`, `roadmap-update`, `secret-scanning`, `self-improvement`, `seo-audit`, `siderolabs`, `skill-lifecycle`, `sox-testing`, `sprint-planning`, `stakeholder-update`, `standup`, `start`, `stripe-best-practices`, `stripe-docs`, `svelte-core-bestpractices`, `synthesize-research`, `system-design`, `task-management`, `tech-debt`, `test-driven-development`, `testing-strategy`, `update`, `upgrade-stripe`, `user-research`, `ux-copy`, `variance-analysis`, `ways-of-working`, `web-design-guidelines`, `workspace-conventions`, `write-contributing`, `write-docs-introduction`, `write-readme`, `write-spec` (skills) · `agent-improver`, `agentic-engineer`, `flux-troubleshooter`, `portfolio-surveyor` (agents) · `aws-knowledge`, `cloudflare-docs`, `context7`, `coroot`, `flux-operator-mcp`, `github`, `github-ghas-tools`, `kubescape`, `numina`, `siderolabs-docs`, `stripe`, `svelte`, `terraform-registry` (MCP servers) | The autonomous engineering system for a whole repository portfolio, and everything its agents need — engineer, read-only surveyor, meta-engineer and Flux troubleshooter agents; operating, product, spend and improvement workflows; GitHub, CodeRabbit review, security, library documentation, Go, Kubernetes, Flux, Talos, SvelteKit frontend, Stripe payments, engineering-practice, design, product-management, marketing, finance and productivity skills; and the MCP servers they use. Configured by the consumer's `AGENTS.md` | | [`vibe-coding`](../plugins/vibe-coding/) | `needs-stack-mapping`, `allowed-stack-guardrail`, `jargon-free-voice` (skills) · `vibe-coding-companion` (agent) | Build a product by conversation alone — plain-language companion agent + guardrailed needs-to-stack skills for people with no technical background | | [`ksail`](../plugins/ksail/) | `ksail` (skill) · `ksail` (MCP server) | Create and operate Kubernetes clusters and GitOps workloads with the KSail CLI — needs `ksail` on `PATH`; PolyForm Shield licensed | diff --git a/docs/resources.md b/docs/resources.md index 0e830148..9ed0c8f6 100644 --- a/docs/resources.md +++ b/docs/resources.md @@ -33,7 +33,7 @@ armed, or with a schedule pointing at an entrypoint that no longer resolves. The ## MCP servers A plugin may bundle [MCP](https://modelcontextprotocol.io) servers as well as skills. The -[`agentic-engineering`](../plugins/agentic-engineering/) plugin bundles twelve, authored once in its +[`agentic-engineering`](../plugins/agentic-engineering/) plugin bundles thirteen, authored once in its [`.mcp.json`](../plugins/agentic-engineering/.mcp.json) (`mcpServers` map), and the [`ksail`](../plugins/ksail/) plugin bundles the KSail server, which needs `ksail` on `PATH`: @@ -47,6 +47,7 @@ A plugin may bundle [MCP](https://modelcontextprotocol.io) servers as well as sk | `github` | GitHub's everyday tools: repositories, issues, pull requests, Actions, labels and projects, read, and issue, label, comment, branch, new pull request and project writes; merging, pull request edits, reviews, repository creation and deletion, file writes and workflow runs are excluded | A GitHub sign-in; see below | | `github-ghas-tools` | GitHub's security tools, read-only (`X-MCP-Readonly`): alerts, advisories and dependency vulnerability lookups | A GitHub sign-in; see below | | `kubescape` | A live cluster's Kubescape results, read-only (`kubescape mcpserver`): vulnerabilities, configuration scans, SBOMs and exposure checks | The `kubescape` CLI (v4 or later), a POSIX `sh`, and cluster access through `KUBECONFIG` (default `~/.kube/config`) | +| `numina` | Numina's hosted server at `https://api.numina.app/mcp` for a Danish company's books: ledger, bank-line, invoice, contact and document reads, and draft, bank-match, contact, product and receipt writes; it never books | A Numina sign-in through OAuth | | `siderolabs-docs` | Sidero Labs' search of the Talos Linux and Omni documentation | Nothing; it is public | | `stripe` | Stripe's hosted server at `https://mcp.stripe.com`: Stripe documentation, reads and writes on your Stripe account, analytics and money movement | A Stripe sign-in through OAuth | | `svelte` | The Svelte team's hosted server at `https://mcp.svelte.dev/mcp`: Svelte 5 and SvelteKit documentation, the `svelte-autofixer` and playground links, all read-only | Nothing; it is public | @@ -58,8 +59,9 @@ starts, and `terraform-registry` runs locally but queries the public Terraform R other server is hosted by a third party, so every call to one, including a documentation search, reaches that service. If your agents must not contact a third party, disable its server in your tool's MCP settings; denying single tools does not stop the connection. Among -the servers you keep, `github` and `stripe` can change things: `github` writes to GitHub as the -signed-in account, and `stripe` writes to your Stripe account and can move money. With a Viewer +the servers you keep, `github`, `numina` and `stripe` can change things: `github` writes to GitHub +as the signed-in account, `numina` writes drafts and bank matches that a person books in Numina, +and `stripe` writes to your Stripe account and can move money. With a Viewer key, `coroot`'s Enterprise Edition `investigate_anomaly` can save its analysis onto an incident. The `siderolabs-docs` `submit_feedback` and `stripe` `send_stripe_feedback` tools send reports to Sidero Labs and Stripe. The Svelte autofixer and playground tools send the code they are given to Svelte's diff --git a/plugins/agentic-engineering/.claude-plugin/plugin.json b/plugins/agentic-engineering/.claude-plugin/plugin.json index 87743eb6..b597feab 100644 --- a/plugins/agentic-engineering/.claude-plugin/plugin.json +++ b/plugins/agentic-engineering/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "agentic-engineering", "description": "The autonomous engineering system for repository portfolios and everything its agents need — engineer, read-only surveyor, meta-engineer and Flux troubleshooter agents; portfolio, product, spend and improvement workflows; GitHub, CodeRabbit review, security, library documentation, Go, Kubernetes, Flux, Talos, SvelteKit frontend, Stripe payments, engineering-practice, design, product-management, marketing, finance and productivity skills; and the MCP servers they use; configured by the consumer AGENTS.md", - "version": "7.6.8", + "version": "7.7.0", "author": { "name": "devantler-tech", "url": "https://github.com/devantler-tech" diff --git a/plugins/agentic-engineering/.codex-plugin/mcp.json b/plugins/agentic-engineering/.codex-plugin/mcp.json index b6cc9611..49b03b8d 100644 --- a/plugins/agentic-engineering/.codex-plugin/mcp.json +++ b/plugins/agentic-engineering/.codex-plugin/mcp.json @@ -49,6 +49,10 @@ ], "cwd": "." }, + "numina": { + "type": "http", + "url": "https://api.numina.app/mcp" + }, "siderolabs-docs": { "type": "http", "url": "https://docs.siderolabs.com/mcp" diff --git a/plugins/agentic-engineering/.codex-plugin/plugin.json b/plugins/agentic-engineering/.codex-plugin/plugin.json index 751d8250..79deb5b1 100644 --- a/plugins/agentic-engineering/.codex-plugin/plugin.json +++ b/plugins/agentic-engineering/.codex-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "agentic-engineering", "description": "The autonomous engineering system for repository portfolios and everything its agents need — engineer, read-only surveyor, meta-engineer and Flux troubleshooter agents; portfolio, product, spend and improvement workflows; GitHub, CodeRabbit review, security, library documentation, Go, Kubernetes, Flux, Talos, SvelteKit frontend, Stripe payments, engineering-practice, design, product-management, marketing, finance and productivity skills; and the MCP servers they use; configured by the consumer AGENTS.md", - "version": "7.6.8", + "version": "7.7.0", "author": { "name": "devantler-tech", "url": "https://github.com/devantler-tech" diff --git a/plugins/agentic-engineering/.mcp.json b/plugins/agentic-engineering/.mcp.json index 6a9e0498..7a37bb35 100644 --- a/plugins/agentic-engineering/.mcp.json +++ b/plugins/agentic-engineering/.mcp.json @@ -47,6 +47,10 @@ "${CLAUDE_PLUGIN_ROOT}/scripts/kubescape-mcp.sh" ] }, + "numina": { + "type": "http", + "url": "https://api.numina.app/mcp" + }, "siderolabs-docs": { "type": "http", "url": "https://docs.siderolabs.com/mcp" diff --git a/plugins/agentic-engineering/CHANGELOG.md b/plugins/agentic-engineering/CHANGELOG.md index 8f92ccbf..f1fbe9b0 100644 --- a/plugins/agentic-engineering/CHANGELOG.md +++ b/plugins/agentic-engineering/CHANGELOG.md @@ -1,5 +1,13 @@ # Changelog — `agentic-engineering` +## 7.7.0 — 2026-11-13 + +**Added** — the `numina` MCP server, Numina's hosted server at `https://api.numina.app/mcp`. It +lets agents read a Danish company's books in Numina, a registered bookkeeping system, and write +drafts, bank matches, contacts, products and receipt uploads. It never books: a person books every +draft in Numina. It needs a Numina sign-in through OAuth, and the other servers keep working +without one. The README covers its scopes and what to deny. + ## 7.6.8 — 2026-11-12 **Changed** — sync `code-review` from `https://github.com/coderabbitai/skills` at `refs/tags/v1.2.2`. diff --git a/plugins/agentic-engineering/PRIVACY.md b/plugins/agentic-engineering/PRIVACY.md index cf235c5d..70932a68 100644 --- a/plugins/agentic-engineering/PRIVACY.md +++ b/plugins/agentic-engineering/PRIVACY.md @@ -47,6 +47,7 @@ package name, a version, or code. Each service handles it under its own privacy | `cloudflare-docs` | Cloudflare | | `context7` | Upstash | | `github`, `github-ghas-tools` | GitHub | +| `numina` | Numina Technologies, once you sign in to it | | `siderolabs-docs` | Sidero Labs | | `stripe` | Stripe, once you sign in to it | | `svelte` | The Svelte maintainers | diff --git a/plugins/agentic-engineering/README.md b/plugins/agentic-engineering/README.md index 24ba1f21..b4f974a5 100644 --- a/plugins/agentic-engineering/README.md +++ b/plugins/agentic-engineering/README.md @@ -200,6 +200,7 @@ recorded in [`resources/THIRD-PARTY-NOTICES.md`](resources/THIRD-PARTY-NOTICES.m | `github` | GitHub's everyday tools: repositories, issues, pull requests, Actions, labels and projects, read, and issue, label, comment, branch, new pull request and project writes; merging, pull request edits, reviews, repository creation and deletion, file writes and workflow runs are excluded | A GitHub sign-in, below | | `github-ghas-tools` | GitHub's read-only security tools | A GitHub sign-in, below | | `kubescape` | A live cluster's Kubescape results, read-only: vulnerabilities, configuration scans, SBOMs, network and RBAC exposure | The [`kubescape`](https://kubescape.io/docs/install-cli/) CLI (v4 or later), a POSIX `sh`, and cluster access through `KUBECONFIG` or `~/.kube/config` | +| `numina` | Numina's hosted server for a Danish company's books: reads of the ledger, bank lines, invoices, contacts and documents, and draft entries, bank matches, contacts, products and receipt uploads; it never books | A Numina sign-in, below | | `siderolabs-docs` | Sidero Labs' search of the Talos Linux and Omni documentation | Nothing; it is public | | `stripe` | Stripe's hosted server: Stripe documentation, reads and writes on your Stripe account, analytics, and money movement | A Stripe sign-in, below | | `svelte` | The Svelte team's hosted server: Svelte 5 and SvelteKit documentation, the `svelte-autofixer` and playground links, all read-only | Nothing; it is public | @@ -294,6 +295,22 @@ read live data, and deny `stripe_api_write` and the Treasury tools in your tool permissions if your agents must never change your Stripe account. The Stripe skills work without the server. +`numina` is [Numina](https://numina.app)'s hosted MCP server at `https://api.numina.app/mcp`, the +address its [documentation](https://developers.numina.app/mcp.md) gives. Numina is a registered +Danish bookkeeping system. The server signs in through OAuth: in Claude Code, run `/mcp`, choose +`numina`, pick the company and approve. A client that names no scopes is granted reading and +writing drafts. A client that registers itself, as Claude Code does, can never hold a booking +scope, and Numina states that whatever the scopes, its MCP tools never book: everything they +write is a draft or a proposed correction that a person books in Numina. The write tools create, +change and delete drafts, match bank lines to drafts, propose changes to booked entries, resolve +reviews, maintain contacts and products, and upload receipts. Its migration tools need a company +admin's OAuth sign-in, and nothing is imported until the user approves the proposal in Numina. +Until you sign in, the server reports that it needs authentication and the rest keep working. +Tool results carry the company's financial data into your agent's conversation, where your AI +provider's terms apply; Numina's data processing agreement does not cover that provider. Connect +with read scopes only, or deny the write tools in your tool permissions, if your agents must not +change drafts. + A local server whose binary is missing reports a failed connection and leaves the rest working. The Flux server starts with `--read-only`, so it can read, trace and diff but never apply, delete, reconcile, suspend or resume; hand fixes to your GitOps delivery instead. `flux-operator-mcp` @@ -318,7 +335,7 @@ server in your tool permissions. `siderolabs-docs` offers `submit_feedback`, whi report to Sidero Labs, and `stripe` offers `send_stripe_feedback`, which sends one to Stripe; deny them in your tool permissions if your agents must not file reports. The Svelte tools write nothing, but their autofixer and playground tools send code to Svelte, so deny those too if no code -may leave your machine. `github` and `stripe` are the servers whose tools change things. +may leave your machine. `github`, `numina` and `stripe` are the servers whose tools change things. `github-ghas-tools` is GitHub's remote MCP server at its read-only endpoint, `https://api.githubcopilot.com/mcp/readonly`, limited to the `code_security`, `secret_protection`, diff --git a/plugins/agentic-engineering/plugin.json b/plugins/agentic-engineering/plugin.json index 87743eb6..b597feab 100644 --- a/plugins/agentic-engineering/plugin.json +++ b/plugins/agentic-engineering/plugin.json @@ -1,7 +1,7 @@ { "name": "agentic-engineering", "description": "The autonomous engineering system for repository portfolios and everything its agents need — engineer, read-only surveyor, meta-engineer and Flux troubleshooter agents; portfolio, product, spend and improvement workflows; GitHub, CodeRabbit review, security, library documentation, Go, Kubernetes, Flux, Talos, SvelteKit frontend, Stripe payments, engineering-practice, design, product-management, marketing, finance and productivity skills; and the MCP servers they use; configured by the consumer AGENTS.md", - "version": "7.6.8", + "version": "7.7.0", "author": { "name": "devantler-tech", "url": "https://github.com/devantler-tech" diff --git a/plugins/agentic-engineering/skills/connector-setup/SKILL.md b/plugins/agentic-engineering/skills/connector-setup/SKILL.md index 876a3b54..79428769 100644 --- a/plugins/agentic-engineering/skills/connector-setup/SKILL.md +++ b/plugins/agentic-engineering/skills/connector-setup/SKILL.md @@ -6,8 +6,8 @@ license: Apache-2.0 # Connector setup -This plugin bundles the servers its agents need for engineering: GitHub, Context7, Stripe, Svelte, -Sidero Labs, Flux, Kubescape, Terraform, Cloudflare and AWS documentation. Mail, calendar, +This plugin bundles the servers its agents need for engineering: GitHub, Context7, Stripe, Numina, +Svelte, Sidero Labs, Flux, Kubescape, Terraform, Cloudflare and AWS documentation. Mail, calendar, LinkedIn and Codex Security's cloud scans come from the providers' own connectors instead. A plugin cannot switch those on by itself: each needs the user's own sign-in. Your job is to notice when one is missing and ask for the right one in the right place. From ef97288e5c91e1431e4beef288a6d6b38c09d7ec Mon Sep 17 00:00:00 2001 From: Nikolai Emil Damm Date: Fri, 13 Nov 2026 00:12:03 +0100 Subject: [PATCH 2/4] feat(agentic-engineering): adopt Numina's numina-stripe skill Installed with provenance from Numina-Technologies/mcp at tree 9aac97f. Part of #698. Co-Authored-By: Claude Opus 5.5 --- docs/plugins.md | 3 +- docs/skill-coverage.md | 4 ++ plugins/agentic-engineering/CHANGELOG.md | 8 +++ plugins/agentic-engineering/README.md | 1 + .../resources/THIRD-PARTY-NOTICES.md | 29 +++++++++ .../skills/numina-stripe/SKILL.md | 63 +++++++++++++++++++ 6 files changed, 107 insertions(+), 1 deletion(-) create mode 100644 plugins/agentic-engineering/skills/numina-stripe/SKILL.md diff --git a/docs/plugins.md b/docs/plugins.md index dabbf5c5..a57644e4 100644 --- a/docs/plugins.md +++ b/docs/plugins.md @@ -6,7 +6,7 @@ A **skill** teaches an assistant a task. An **agent** gives it a specialized rol | Plugin | Resources | Description | |--------|-----------|-------------| -| [`agentic-engineering`](../plugins/agentic-engineering/) | `accessibility-review`, `agent-improvement`, `agent-instructions`, `application-security`, `architecture`, `audit-support`, `autofix`, `brand-review`, `campaign-plan`, `check-skills`, `close-management`, `code-review`, `codeql`, `competitive-brief`, `connector-setup`, `content-creation`, `context7-mcp`, `conventional-release`, `danish-business-rules`, `debug`, `dependabot`, `dependency-scanning`, `deploy-checklist`, `design-critique`, `design-handoff`, `design-system`, `documentation`, `draft-content`, `email-sequence`, `financial-statements`, `find-skills`, `frontend-design`, `gh-cli`, `gh-stack`, `git-commit`, `github-actions-docs`, `github-actions-efficiency`, `github-actions-hardening`, `github-issues`, `gitops-cluster-debug`, `gitops-knowledge`, `gitops-tenant-onboarding`, `golang-pro`, `grilling`, `incident-response`, `journal-entry`, `journal-entry-prep`, `memory-management`, `metrics-review`, `performance-report`, `portfolio-maintenance`, `privacy-engineering`, `product-brainstorming`, `product-documentation`, `product-engineering`, `prometheus`, `promql`, `prototype`, `reconciliation`, `refactor`, `research-synthesis`, `roadmap-update`, `secret-scanning`, `self-improvement`, `seo-audit`, `siderolabs`, `skill-lifecycle`, `sox-testing`, `sprint-planning`, `stakeholder-update`, `standup`, `start`, `stripe-best-practices`, `stripe-docs`, `svelte-core-bestpractices`, `synthesize-research`, `system-design`, `task-management`, `tech-debt`, `test-driven-development`, `testing-strategy`, `update`, `upgrade-stripe`, `user-research`, `ux-copy`, `variance-analysis`, `ways-of-working`, `web-design-guidelines`, `workspace-conventions`, `write-contributing`, `write-docs-introduction`, `write-readme`, `write-spec` (skills) · `agent-improver`, `agentic-engineer`, `flux-troubleshooter`, `portfolio-surveyor` (agents) · `aws-knowledge`, `cloudflare-docs`, `context7`, `coroot`, `flux-operator-mcp`, `github`, `github-ghas-tools`, `kubescape`, `numina`, `siderolabs-docs`, `stripe`, `svelte`, `terraform-registry` (MCP servers) | The autonomous engineering system for a whole repository portfolio, and everything its agents need — engineer, read-only surveyor, meta-engineer and Flux troubleshooter agents; operating, product, spend and improvement workflows; GitHub, CodeRabbit review, security, library documentation, Go, Kubernetes, Flux, Talos, SvelteKit frontend, Stripe payments, engineering-practice, design, product-management, marketing, finance and productivity skills; and the MCP servers they use. Configured by the consumer's `AGENTS.md` | +| [`agentic-engineering`](../plugins/agentic-engineering/) | `accessibility-review`, `agent-improvement`, `agent-instructions`, `application-security`, `architecture`, `audit-support`, `autofix`, `brand-review`, `campaign-plan`, `check-skills`, `close-management`, `code-review`, `codeql`, `competitive-brief`, `connector-setup`, `content-creation`, `context7-mcp`, `conventional-release`, `danish-business-rules`, `debug`, `dependabot`, `dependency-scanning`, `deploy-checklist`, `design-critique`, `design-handoff`, `design-system`, `documentation`, `draft-content`, `email-sequence`, `financial-statements`, `find-skills`, `frontend-design`, `gh-cli`, `gh-stack`, `git-commit`, `github-actions-docs`, `github-actions-efficiency`, `github-actions-hardening`, `github-issues`, `gitops-cluster-debug`, `gitops-knowledge`, `gitops-tenant-onboarding`, `golang-pro`, `grilling`, `incident-response`, `journal-entry`, `journal-entry-prep`, `memory-management`, `metrics-review`, `numina-stripe`, `performance-report`, `portfolio-maintenance`, `privacy-engineering`, `product-brainstorming`, `product-documentation`, `product-engineering`, `prometheus`, `promql`, `prototype`, `reconciliation`, `refactor`, `research-synthesis`, `roadmap-update`, `secret-scanning`, `self-improvement`, `seo-audit`, `siderolabs`, `skill-lifecycle`, `sox-testing`, `sprint-planning`, `stakeholder-update`, `standup`, `start`, `stripe-best-practices`, `stripe-docs`, `svelte-core-bestpractices`, `synthesize-research`, `system-design`, `task-management`, `tech-debt`, `test-driven-development`, `testing-strategy`, `update`, `upgrade-stripe`, `user-research`, `ux-copy`, `variance-analysis`, `ways-of-working`, `web-design-guidelines`, `workspace-conventions`, `write-contributing`, `write-docs-introduction`, `write-readme`, `write-spec` (skills) · `agent-improver`, `agentic-engineer`, `flux-troubleshooter`, `portfolio-surveyor` (agents) · `aws-knowledge`, `cloudflare-docs`, `context7`, `coroot`, `flux-operator-mcp`, `github`, `github-ghas-tools`, `kubescape`, `numina`, `siderolabs-docs`, `stripe`, `svelte`, `terraform-registry` (MCP servers) | The autonomous engineering system for a whole repository portfolio, and everything its agents need — engineer, read-only surveyor, meta-engineer and Flux troubleshooter agents; operating, product, spend and improvement workflows; GitHub, CodeRabbit review, security, library documentation, Go, Kubernetes, Flux, Talos, SvelteKit frontend, Stripe payments, engineering-practice, design, product-management, marketing, finance and productivity skills; and the MCP servers they use. Configured by the consumer's `AGENTS.md` | | [`vibe-coding`](../plugins/vibe-coding/) | `needs-stack-mapping`, `allowed-stack-guardrail`, `jargon-free-voice` (skills) · `vibe-coding-companion` (agent) | Build a product by conversation alone — plain-language companion agent + guardrailed needs-to-stack skills for people with no technical background | | [`ksail`](../plugins/ksail/) | `ksail` (skill) · `ksail` (MCP server) | Create and operate Kubernetes clusters and GitOps workloads with the KSail CLI — needs `ksail` on `PATH`; PolyForm Shield licensed | @@ -69,6 +69,7 @@ license file the plugin ships; keep both when you copy or redistribute those ski | `ksail` | `ksail` | devantler-tech/ksail | PolyForm-Shield-1.0.0 | | `memory-management` | `agentic-engineering` | anthropics/knowledge-work-plugins | Apache-2.0 | | `metrics-review` | `agentic-engineering` | anthropics/knowledge-work-plugins | Apache-2.0 | +| `numina-stripe` | `agentic-engineering` | Numina-Technologies/mcp | MIT | | `performance-report` | `agentic-engineering` | anthropics/knowledge-work-plugins | Apache-2.0 | | `portfolio-maintenance` | `agentic-engineering` | devantler-tech/agent-plugins | Apache-2.0 | | `privacy-engineering` | `agentic-engineering` | devantler-tech/agent-plugins | Apache-2.0 | diff --git a/docs/skill-coverage.md b/docs/skill-coverage.md index 0d336e8e..2156c783 100644 --- a/docs/skill-coverage.md +++ b/docs/skill-coverage.md @@ -46,6 +46,7 @@ This is an engineering inventory. It makes no legal or compliance claim. | SLOs | the platform alerts on [Coroot's built-in per-application SLOs][plat-alert]; no repository sets its own SLO targets or error-budget policy | none | SLO targets and error-budget policy, which nobody authors today | Low | **Do not add**. Tuning Coroot's SLO alerts goes with #654. Revisit when a product sets its own SLO targets | | FinOps | the engineer's spend mandate (stewardship disabled by contract) | the [`agentic-engineer`](../plugins/agentic-engineering/agents/agentic-engineer.agent.md) agent and the `github-actions-efficiency` skill; the monorepo `finops` overlay is outside this repository | none | Medium | **Covered** | | Payments, subscriptions and webhooks | no product takes payments: the code search `org:devantler-tech stripe` on 2026-11-04 returned 7 matches, all dependency metadata, a bookmark, game assets or a skill reference | none | none today | Low | **Do not add**. Webhook verification is in `application-security`; subscription disclosures belong to #639. Revisit when a product commits to payments | +| Bookkeeping | Devantler Tech's books in Numina ([monorepo#4994](https://github.com/devantler-tech/monorepo/issues/4994)), including Stripe payouts once the business is paid through Stripe | the `numina` MCP server and `numina-stripe` | none today. Numina's other skills do not apply: the business mail is not Gmail, Pleo is not used, and the books start fresh, so no migration | Medium | **Covered** since 7.7.0 ([#698](https://github.com/devantler-tech/agent-plugins/issues/698)) | | GitOps, Kubernetes and deployment | the [platform][plat-root], [ksail][ksail-go] and the templates | skills `gitops-knowledge`, `gitops-cluster-debug`, `gitops-tenant-onboarding`, `ksail` and `siderolabs`; the bundled Flux MCP server | activation only: 0 loads with at least 11 manifest sessions (#642) | High | **Covered**; measured by #651 | **Owned** means the audit hands the gap to an existing issue instead of filing an overlapping one. @@ -81,6 +82,7 @@ lists them: should-trigger, near-miss and over-trigger cases that #651's suite r | Observability | community skills such as [`opentelemetry`][c-bagel] and [`observability-sre`][c-arsenal] | MIT, individual maintainers | 2026-05-22, 2026-11-04 | General-purpose. The vendor-maintained Grafana skills cover the same scope | Rejected | | ClickHouse | [`clickhouse-best-practices`][c-ch] | Apache-2.0, ClickHouse | 2026-11-02 | Strong, but no product authors ClickHouse work | Do not add yet | | Payments | [`stripe-best-practices`][c-stripe] | MIT, Stripe | 2026-11-04 | Official, but no product takes payments and no provider is chosen | Do not add yet | +| Bookkeeping | [`numina-stripe`][c-numina] | MIT, Numina Technologies | 2026-11-11 | Official, one file, drafts only. Its `write:draft` scope check and two `create_draft` arguments are unverified until first live use; both fail loudly | **Adopted** in 7.7.0 | | Application security | [`security-review`, `security-model`][c-sentry] | Apache-2.0 repository, Sentry; the references of `security-review` are CC BY-SA 4.0 | 2026-11-05 | `security-review` reviews finished code by vulnerability class and is well made, but its references derive from OWASP material under share-alike terms, and it has no threat model, tenant design or webhook guidance. `security-model` writes a policy file for scanners and needs Python helpers | Rejected for now: the licence review is #581's. Revisit `security-review` for the review-time half when #581 clears share-alike redistribution | | Application security | [`security-review`, `threat-model-analyst`][c-ac] | MIT, github/awesome-copilot | 2026-11-10 | The first is a scanner procedure that repeats the secret and dependency checks this plugin already has. The second is threat modelling only, as a multi-agent report generator of 17 files and 335 KB | Rejected | | Application security | [`owasp-security`][c-agamm] | MIT, one maintainer | 2026-11-03 | Closest in content, with evaluation cases upstream. Its frontmatter uses a field the open skill format does not define, so the copy fails validation here unmodified, and its largest reference restates OWASP material under an MIT label | Rejected | @@ -130,6 +132,7 @@ with SvelteKit and a Go server. An agent that trusts the card would choose `astr first-party `danish-business-rules` skill, within the limits its source list states. 6. Prometheus and OpenTelemetry (#654). PromQL and alert rules adopted in 7.3.0; collector pipelines not added, as the matrix says. +7. Bookkeeping in Numina (#698). Covered in 7.7.0 by the `numina` server and `numina-stripe`. Done: SvelteKit (#652), covered since 7.0.0. @@ -158,6 +161,7 @@ when an adoption issue above closes, or after #651's first two baselines. [c-ch]: https://github.com/ClickHouse/agent-skills/tree/d3b2b5ba43a8b80c2d08858b68d53edc701b5ace/skills/clickhouse-best-practices [c-grafana]: https://github.com/grafana/skills/tree/8fb72a527961f05e708f53d2a0500709e12d7970/skills [c-stripe]: https://github.com/stripe/ai/tree/a3196df9925589ec7dd96c90692d13ea1c453cae +[c-numina]: https://github.com/Numina-Technologies/mcp/tree/ddf430b70a05cc93771974569fffae86f7a02a09/skills/numina-stripe [c-tob]: https://github.com/trailofbits/skills/tree/470419e16f97e112d01fc32f4898aea1755015d9 [c-sentry]: https://github.com/getsentry/skills/tree/e94f22214528d69899d09c627b3315ddc3544816/skills [c-ac]: https://github.com/github/awesome-copilot/tree/227949a7542a55d2155c00e7cdb998d9a0fee4f3/skills diff --git a/plugins/agentic-engineering/CHANGELOG.md b/plugins/agentic-engineering/CHANGELOG.md index f1fbe9b0..a10e3407 100644 --- a/plugins/agentic-engineering/CHANGELOG.md +++ b/plugins/agentic-engineering/CHANGELOG.md @@ -8,6 +8,14 @@ drafts, bank matches, contacts, products and receipt uploads. It never books: a draft in Numina. It needs a Numina sign-in through OAuth, and the other servers keep working without one. The README covers its scopes and what to deny. +**Added** — the `numina-stripe` skill from `https://github.com/Numina-Technologies/mcp` at +`refs/heads/main`, tree `9aac97fef5c13d43f1c92b2b76f7182f8d75b48f` (MIT, Numina Technologies). It +drafts each Stripe payout in Numina on the bank line it landed on, split into sales per VAT group, +refunds and fees, and leaves booking to a person. Numina's other skills were deliberately not +taken: Gmail receipts, Pleo, Google Sheets and the migrations. Two details are unverified until +first live use: the skill checks for the `write:draft` scope, and it passes `bank_transaction_id` +and `currency` to `create_draft`. Either fails loudly if wrong (#698). + ## 7.6.8 — 2026-11-12 **Changed** — sync `code-review` from `https://github.com/coderabbitai/skills` at `refs/tags/v1.2.2`. diff --git a/plugins/agentic-engineering/README.md b/plugins/agentic-engineering/README.md index b4f974a5..520da922 100644 --- a/plugins/agentic-engineering/README.md +++ b/plugins/agentic-engineering/README.md @@ -122,6 +122,7 @@ are maintained here. | Frontend (SvelteKit) | `svelte-core-bestpractices`, `frontend-design`, `web-design-guidelines` | | Observability (Prometheus) | `promql` (writing and checking PromQL), `prometheus` (alert and recording rules, Alertmanager routing) | | Payments (Stripe) | `stripe-best-practices`, `stripe-docs`, `upgrade-stripe` | +| Bookkeeping (Numina) | `numina-stripe` (Stripe payouts as Numina drafts on their bank lines, split into sales per VAT group, refunds and fees, through the `numina` and `stripe` servers) | | Engineering practices | `conventional-release`, `git-commit`, `refactor`, `test-driven-development`, `ways-of-working`, `write-contributing`, `write-docs-introduction`, `write-readme`, `architecture`, `debug`, `deploy-checklist`, `documentation`, `incident-response`, `standup`, `system-design`, `tech-debt`, `testing-strategy` | | Design | `accessibility-review`, `design-critique`, `design-handoff`, `design-system`, `research-synthesis`, `user-research`, `ux-copy` | | Product management | `competitive-brief`, `metrics-review`, `product-brainstorming`, `roadmap-update`, `sprint-planning`, `stakeholder-update`, `synthesize-research`, `write-spec` | diff --git a/plugins/agentic-engineering/resources/THIRD-PARTY-NOTICES.md b/plugins/agentic-engineering/resources/THIRD-PARTY-NOTICES.md index 19c292d7..4b2f0a61 100644 --- a/plugins/agentic-engineering/resources/THIRD-PARTY-NOTICES.md +++ b/plugins/agentic-engineering/resources/THIRD-PARTY-NOTICES.md @@ -49,6 +49,7 @@ license file this plugin ships. Everything else in this plugin is licensed under | `journal-entry` | anthropics/knowledge-work-plugins | Apache-2.0 | | `memory-management` | anthropics/knowledge-work-plugins | Apache-2.0 | | `metrics-review` | anthropics/knowledge-work-plugins | Apache-2.0 | +| `numina-stripe` | Numina-Technologies/mcp | MIT | | `performance-report` | anthropics/knowledge-work-plugins | Apache-2.0 | | `product-brainstorming` | anthropics/knowledge-work-plugins | Apache-2.0 | | `prometheus` | grafana/skills | Apache-2.0 | @@ -855,6 +856,34 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ``` +## Numina-Technologies/mcp + +Skills: `numina-stripe`. Source: . + +```text +MIT License + +Copyright (c) 2026 Numina Technologies ApS + +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: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +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. +``` + ## anthropics/knowledge-work-plugins Skills: `accessibility-review`, `architecture`, `audit-support`, `brand-review`, `campaign-plan`, `close-management`, `competitive-brief`, `content-creation`, `debug`, `deploy-checklist`, `design-critique`, `design-handoff`, `design-system`, `documentation`, `draft-content`, `email-sequence`, `financial-statements`, `incident-response`, `journal-entry`, `journal-entry-prep`, `memory-management`, `metrics-review`, `performance-report`, `product-brainstorming`, `reconciliation`, `research-synthesis`, `roadmap-update`, `seo-audit`, `sox-testing`, `sprint-planning`, `stakeholder-update`, `standup`, `start`, `synthesize-research`, `system-design`, `task-management`, `tech-debt`, `testing-strategy`, `update`, `user-research`, `ux-copy`, `variance-analysis`, `write-spec`. Source: . diff --git a/plugins/agentic-engineering/skills/numina-stripe/SKILL.md b/plugins/agentic-engineering/skills/numina-stripe/SKILL.md new file mode 100644 index 00000000..f5d00918 --- /dev/null +++ b/plugins/agentic-engineering/skills/numina-stripe/SKILL.md @@ -0,0 +1,63 @@ +--- +description: Draft Stripe payouts in Numina against the bank line, split into sales, VAT, refunds and fees. Use when the user asks to book, sync or reconcile their Stripe revenue. +metadata: + github-path: skills/numina-stripe + github-ref: refs/heads/main + github-repo: https://github.com/Numina-Technologies/mcp + github-tree-sha: 9aac97fef5c13d43f1c92b2b76f7182f8d75b48f +name: numina-stripe +--- +# Stripe → Numina + +Needs **Stripe** (payouts and balance transactions) and the **Numina MCP** +with write access ([setup](../../README.md#connect)). One payout = one draft +on the bank line it landed on. The user approves and books the drafts in +Numina. + +## 1. Company and period + +`get_company_info`: confirm the company and check `scopes` includes +`write:draft`. If not, ask the user to reconnect Numina. + +## 2. Accounts, once + +`list_accounts` and `list_vat_codes`. Identify the sales account(s), the +Danish output VAT code, the code for EU sales without Danish VAT and the +fees account. Ask when unsure. + +## 3. Each payout + +1. **Find the bank line.** `search_bank_transactions` with `text: "stripe"`, + `amount_min` = `amount_max` = the payout amount (positive, money in) and + `state: "unreconciled"`. Each result has the bank's + `ledger_account_number`. Skip lines with `agent_processing: true`; + Numina is already on them. No line → the payout hasn't arrived yet; skip + it. +2. **List what's in the payout** from its Stripe balance transactions. Use + their settlement amounts (`amount`, `fee`): they're already in the payout + currency. +3. **Group the charges:** + - **Denmark** → Danish output VAT code + - **EU business with a VAT number** → EU sale, no Danish VAT + - **EU consumer** → OSS if the company is registered for it, otherwise + Danish VAT; ask the user + - **outside the EU** → no VAT +4. **`create_draft`** with `bank_transaction_id`, `date` = the payout date, + and lines that sum to 0: + - bank account (`ledger_account_number`): the payout, **positive** + - sales per group: **negative**, gross with a Danish VAT code + - refunds: **positive**, on the same accounts and codes as the sale + - fees: **positive** on the fees account. Stripe's fees are usually + VAT-exempt; follow the code the company already uses for them. + + Payout in another currency (e.g. a EUR bank account)? Set `currency`; + Numina converts at the day's rate. +5. If `create_draft` refuses because the lines don't balance, recheck the + grouping. Never plug the difference. + +`reasoning` example: "Stripe payout po_123: 42 charges, 1 refund, fees." + +## 4. Report back + +Per payout: amount, sales per VAT group, refunds, fees and +a link to the draft. Remind the user to approve the drafts in Numina. From 29d49d93a0d4cbf02fcb12658d3d09c2dfca4fa1 Mon Sep 17 00:00:00 2001 From: Nikolai Emil Damm Date: Fri, 13 Nov 2026 00:59:30 +0100 Subject: [PATCH 3/4] docs(agentic-engineering): record numina-stripe's known defects and fix the Numina privacy note The maintainer keeps numina-stripe with its review findings documented and reported upstream (Numina-Technologies/mcp#13). Part of #698. Co-Authored-By: Claude Opus 5.5 --- docs/skill-coverage.md | 2 +- plugins/agentic-engineering/CHANGELOG.md | 18 +++++++++++++++--- plugins/agentic-engineering/PRIVACY.md | 2 +- plugins/agentic-engineering/README.md | 2 +- 4 files changed, 18 insertions(+), 6 deletions(-) diff --git a/docs/skill-coverage.md b/docs/skill-coverage.md index 2156c783..38e4a057 100644 --- a/docs/skill-coverage.md +++ b/docs/skill-coverage.md @@ -82,7 +82,7 @@ lists them: should-trigger, near-miss and over-trigger cases that #651's suite r | Observability | community skills such as [`opentelemetry`][c-bagel] and [`observability-sre`][c-arsenal] | MIT, individual maintainers | 2026-05-22, 2026-11-04 | General-purpose. The vendor-maintained Grafana skills cover the same scope | Rejected | | ClickHouse | [`clickhouse-best-practices`][c-ch] | Apache-2.0, ClickHouse | 2026-11-02 | Strong, but no product authors ClickHouse work | Do not add yet | | Payments | [`stripe-best-practices`][c-stripe] | MIT, Stripe | 2026-11-04 | Official, but no product takes payments and no provider is chosen | Do not add yet | -| Bookkeeping | [`numina-stripe`][c-numina] | MIT, Numina Technologies | 2026-11-11 | Official, one file, drafts only. Its `write:draft` scope check and two `create_draft` arguments are unverified until first live use; both fail loudly | **Adopted** in 7.7.0 | +| Bookkeeping | [`numina-stripe`][c-numina] | MIT, Numina Technologies | 2026-11-11 | Official, one file, drafts only. Review found defects in its scope check, bank-line matching, manual payouts and per-group VAT codes ([Numina-Technologies/mcp#13](https://github.com/Numina-Technologies/mcp/issues/13)), plus double-booking of already-invoiced revenue ([#4](https://github.com/Numina-Technologies/mcp/issues/4)). Kept at the maintainer's decision because every result is a draft a person books | **Adopted with known defects** in 7.7.0 ([#698](https://github.com/devantler-tech/agent-plugins/issues/698)) | | Application security | [`security-review`, `security-model`][c-sentry] | Apache-2.0 repository, Sentry; the references of `security-review` are CC BY-SA 4.0 | 2026-11-05 | `security-review` reviews finished code by vulnerability class and is well made, but its references derive from OWASP material under share-alike terms, and it has no threat model, tenant design or webhook guidance. `security-model` writes a policy file for scanners and needs Python helpers | Rejected for now: the licence review is #581's. Revisit `security-review` for the review-time half when #581 clears share-alike redistribution | | Application security | [`security-review`, `threat-model-analyst`][c-ac] | MIT, github/awesome-copilot | 2026-11-10 | The first is a scanner procedure that repeats the secret and dependency checks this plugin already has. The second is threat modelling only, as a multi-agent report generator of 17 files and 335 KB | Rejected | | Application security | [`owasp-security`][c-agamm] | MIT, one maintainer | 2026-11-03 | Closest in content, with evaluation cases upstream. Its frontmatter uses a field the open skill format does not define, so the copy fails validation here unmodified, and its largest reference restates OWASP material under an MIT label | Rejected | diff --git a/plugins/agentic-engineering/CHANGELOG.md b/plugins/agentic-engineering/CHANGELOG.md index a10e3407..89e2d918 100644 --- a/plugins/agentic-engineering/CHANGELOG.md +++ b/plugins/agentic-engineering/CHANGELOG.md @@ -12,9 +12,21 @@ without one. The README covers its scopes and what to deny. `refs/heads/main`, tree `9aac97fef5c13d43f1c92b2b76f7182f8d75b48f` (MIT, Numina Technologies). It drafts each Stripe payout in Numina on the bank line it landed on, split into sales per VAT group, refunds and fees, and leaves booking to a person. Numina's other skills were deliberately not -taken: Gmail receipts, Pleo, Google Sheets and the migrations. Two details are unverified until -first live use: the skill checks for the `write:draft` scope, and it passes `bank_transaction_id` -and `currency` to `create_draft`. Either fails loudly if wrong (#698). +taken: Gmail receipts, Pleo, Google Sheets and the migrations. + +It is **adopted with known defects** (#698), all reported upstream. Check its drafts before booking +them: + +- It checks for the legacy `write:draft` scope, so a connection granted only `journal:write` is + told to reconnect ([Numina-Technologies/mcp#13](https://github.com/Numina-Technologies/mcp/issues/13)). +- Two unmatched payouts of the same amount can be drafted against the wrong bank line (#13). +- For a manual payout it cannot tell which balance transactions belong to it (#13). +- Read literally, it puts Danish output VAT on EU business and non-EU sales too (#13). +- Revenue already invoiced in Numina is booked a second time, and customer country and VAT number + must be read from the charge, not the balance transaction + ([Numina-Technologies/mcp#4](https://github.com/Numina-Technologies/mcp/issues/4)). +- Its setup link points at an anchor this plugin's README does not have; the Numina setup is under + *Bundled MCP servers*. ## 7.6.8 — 2026-11-12 diff --git a/plugins/agentic-engineering/PRIVACY.md b/plugins/agentic-engineering/PRIVACY.md index 70932a68..836030e7 100644 --- a/plugins/agentic-engineering/PRIVACY.md +++ b/plugins/agentic-engineering/PRIVACY.md @@ -47,7 +47,7 @@ package name, a version, or code. Each service handles it under its own privacy | `cloudflare-docs` | Cloudflare | | `context7` | Upstash | | `github`, `github-ghas-tools` | GitHub | -| `numina` | Numina Technologies, once you sign in to it | +| `numina` | Numina Technologies. Before you sign in, only the OAuth discovery reaches it; tool calls start after sign-in | | `siderolabs-docs` | Sidero Labs | | `stripe` | Stripe, once you sign in to it | | `svelte` | The Svelte maintainers | diff --git a/plugins/agentic-engineering/README.md b/plugins/agentic-engineering/README.md index 520da922..58d6bc16 100644 --- a/plugins/agentic-engineering/README.md +++ b/plugins/agentic-engineering/README.md @@ -122,7 +122,7 @@ are maintained here. | Frontend (SvelteKit) | `svelte-core-bestpractices`, `frontend-design`, `web-design-guidelines` | | Observability (Prometheus) | `promql` (writing and checking PromQL), `prometheus` (alert and recording rules, Alertmanager routing) | | Payments (Stripe) | `stripe-best-practices`, `stripe-docs`, `upgrade-stripe` | -| Bookkeeping (Numina) | `numina-stripe` (Stripe payouts as Numina drafts on their bank lines, split into sales per VAT group, refunds and fees, through the `numina` and `stripe` servers) | +| Bookkeeping (Numina) | `numina-stripe` (Stripe payouts as Numina drafts on their bank lines, split into sales per VAT group, refunds and fees, through the `numina` and `stripe` servers; adopted with known defects, so check its drafts before booking: see the 7.7.0 changelog entry) | | Engineering practices | `conventional-release`, `git-commit`, `refactor`, `test-driven-development`, `ways-of-working`, `write-contributing`, `write-docs-introduction`, `write-readme`, `architecture`, `debug`, `deploy-checklist`, `documentation`, `incident-response`, `standup`, `system-design`, `tech-debt`, `testing-strategy` | | Design | `accessibility-review`, `design-critique`, `design-handoff`, `design-system`, `research-synthesis`, `user-research`, `ux-copy` | | Product management | `competitive-brief`, `metrics-review`, `product-brainstorming`, `roadmap-update`, `sprint-planning`, `stakeholder-update`, `synthesize-research`, `write-spec` | From 4535d44d6dd31bade550cf46cfd04ad3af53bf09 Mon Sep 17 00:00:00 2001 From: Nikolai Emil Damm Date: Fri, 13 Nov 2026 01:01:54 +0100 Subject: [PATCH 4/4] docs(agentic-engineering): state numina-stripe's double-booking defect as conditional Part of #698. Co-Authored-By: Claude Opus 5.5 --- plugins/agentic-engineering/CHANGELOG.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/plugins/agentic-engineering/CHANGELOG.md b/plugins/agentic-engineering/CHANGELOG.md index 89e2d918..bc6604c9 100644 --- a/plugins/agentic-engineering/CHANGELOG.md +++ b/plugins/agentic-engineering/CHANGELOG.md @@ -22,8 +22,8 @@ them: - Two unmatched payouts of the same amount can be drafted against the wrong bank line (#13). - For a manual payout it cannot tell which balance transactions belong to it (#13). - Read literally, it puts Danish output VAT on EU business and non-EU sales too (#13). -- Revenue already invoiced in Numina is booked a second time, and customer country and VAT number - must be read from the charge, not the balance transaction +- When a sale was already invoiced in Numina, its payout books that revenue a second time, and + customer country and VAT number must be read from the charge, not the balance transaction ([Numina-Technologies/mcp#4](https://github.com/Numina-Technologies/mcp/issues/4)). - Its setup link points at an anchor this plugin's README does not have; the Numina setup is under *Bundled MCP servers*.