@gramatr/opencode-plugin 0.20.82 → 0.20.84

package/LICENSE

@@ -1,18 +1,19 @@
-Gramatr License v1.0
+grāmatr License v1.0
 
-Copyright (c) gramatr. All rights reserved.
+Copyright (c) 2025-2026 gramatr, LLC. All rights reserved.
 
 1. License grant
 
-Subject to the terms of this license, gramatr grants you a limited, revocable,
-non-exclusive, non-transferable, non-sublicensable license to install and use
-the gramatr client software solely as a client for authorized gramatr services.
+Subject to the terms of this license, gramatr, LLC grants you a limited,
+revocable, non-exclusive, non-transferable, non-sublicensable license to install
+and use the grāmatr client software solely as a client for authorized grāmatr
+services.
 
 2. Permitted use
 
 You may:
 - install and use the client software for personal or internal business use;
-- connect the software to gramatr-hosted services or other gramatr-authorized
+- connect the software to grāmatr-hosted services or other grāmatr-authorized
   service endpoints;
 - make copies only as necessary for backup, installation, and normal use.
 
@@ -22,39 +23,42 @@ You may not:
 - sell, sublicense, rent, lease, distribute, publish, or otherwise make the
   software available to third parties as a standalone product;
 - modify, create derivative works of, reverse engineer, decompile, or
-  disassemble the software, except to the limited extent such restriction is
-  prohibited by applicable law;
+  disassemble the software, except (i) to the limited extent such restriction
+  is prohibited by applicable law, and (ii) for the purposes expressly
+  permitted by 17 U.S.C. § 1201(f) (interoperability) and § 1201(g)
+  (encryption research);
 - use the software to access or operate an unauthorized competing hosted
-  service based on gramatr technology;
+  service based on grāmatr technology;
 - remove or alter any proprietary notices, trademarks, or attribution;
-- use the software in violation of applicable law or the gramatr service terms.
+- use the software in violation of applicable law or the grāmatr service terms.
 
 4. Server and service components
 
 The server-side components of this repository (including but not limited to the
 intelligence layer, persistence layer, gateway, and MCP server) are proprietary
-and confidential. No license is granted for hosting, deploying, or operating the
-server components outside of gramatr-authorized infrastructure.
+and confidential to gramatr, LLC. No license is granted for hosting, deploying,
+or operating the server components outside of infrastructure authorized by
+gramatr, LLC.
 
 5. Service dependency
 
-The client software is intended to be used with authenticated gramatr backend
+The client software is intended to be used with authenticated grāmatr backend
 services. Access to those services may require an account, API key, accepted
-terms, and an active subscription or other authorization. gramatr may change,
-suspend, or discontinue service access in accordance with applicable service
-terms.
+terms, and an active subscription or other authorization. gramatr, LLC may
+change, suspend, or discontinue service access in accordance with applicable
+service terms.
 
 6. Ownership
 
-The software is licensed, not sold. gramatr and its licensors retain all
+The software is licensed, not sold. gramatr, LLC and its licensors retain all
 right, title, and interest in and to the software, including all intellectual
 property rights.
 
 7. Updates
 
-gramatr may provide updates, patches, or new versions under this same license
-or under updated license terms. Continued use of an updated version constitutes
-acceptance of the updated terms if they are presented to you.
+gramatr, LLC may provide updates, patches, or new versions under this same
+license or under updated license terms. Continued use of an updated version
+constitutes acceptance of the updated terms if they are presented to you.
 
 8. Termination
 
@@ -62,7 +66,10 @@ This license terminates automatically if you violate these terms. Upon
 termination, you must stop using the software and delete all copies in your
 possession or control.
 
-9. Disclaimer
+9. DISCLAIMER OF WARRANTIES — READ CAREFULLY
+
+This section disclaims warranties to the maximum extent permitted by applicable
+law, including Mo. Rev. Stat. § 400.2-316. Read it carefully.
 
 THE SOFTWARE IS PROVIDED "AS IS" AND "AS AVAILABLE," WITHOUT WARRANTIES OF ANY
 KIND, WHETHER EXPRESS, IMPLIED, OR STATUTORY, INCLUDING IMPLIED WARRANTIES OF
@@ -71,7 +78,7 @@ TO THE MAXIMUM EXTENT PERMITTED BY LAW.
 
 10. Limitation of liability
 
-TO THE MAXIMUM EXTENT PERMITTED BY LAW, GRAMATR WILL NOT BE LIABLE FOR ANY
+TO THE MAXIMUM EXTENT PERMITTED BY LAW, GRAMATR, LLC WILL NOT BE LIABLE FOR ANY
 INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, EXEMPLARY, OR PUNITIVE DAMAGES,
 OR FOR ANY LOSS OF DATA, REVENUE, PROFITS, GOODWILL, OR BUSINESS INTERRUPTION,
 ARISING OUT OF OR RELATED TO THE SOFTWARE OR ITS USE, EVEN IF ADVISED OF THE
@@ -79,7 +86,45 @@ POSSIBILITY OF SUCH DAMAGES.
 
 11. Governing terms
 
-Use of the gramatr backend service is governed separately by gramatr Terms of
-Service and Privacy Policy. If there is a conflict between this license and the
-service terms with respect to backend service use, the service terms control
-for backend access and service behavior.
+Use of the grāmatr backend service is governed separately by the gramatr, LLC
+Terms of Service (https://gramatr.com/terms/) and Privacy Policy
+(https://gramatr.com/privacy/). If there is a conflict between this license
+and the service terms with respect to backend service use, the service terms
+control for backend access and service behavior.
+
+12. Trademarks
+
+"grāmatr", "gramatr", and the grāmatr logo are trademarks of gramatr, LLC. All
+other product names, logos, and brands are the property of their respective
+owners. Nothing in this license grants you any right to use those marks except
+as required for accurate attribution permitted by applicable law.
+
+13. Governing law and venue
+
+This license is governed by and construed in accordance with the laws of the
+State of Missouri, without regard to its conflict-of-law principles. The
+exclusive venue for any dispute arising under or relating to this license shall
+be the state and federal courts located in St. Louis County, Missouri, and the
+parties consent to the personal jurisdiction of those courts.
+
+14. Severability
+
+If any provision of this license is held to be invalid, illegal, or
+unenforceable by a court of competent jurisdiction, that provision shall be
+enforced to the maximum extent permissible and the remaining provisions shall
+continue in full force and effect.
+
+15. Consumer-rights savings
+
+Nothing in this license waives or limits any non-waivable right under the
+Missouri Merchandising Practices Act (Mo. Rev. Stat. §§ 407.010 et seq.) or
+analogous consumer-protection statutes of the user's state of residence. Where
+a provision of this license is unenforceable against a consumer under such
+statutes, that provision shall be read down to the minimum extent necessary
+for enforceability and the remainder of this license shall remain in effect.
+
+16. Notice and contact
+
+Notices to gramatr, LLC under this license may be sent to legal@gramatr.com.
+gramatr, LLC may give notice to you by email to the address associated with
+your account or by posting in the grāmatr product surface.

package/README.md

@@ -0,0 +1,104 @@
+<p align="center">
+  <img alt="grāmatr" src="https://gramatr.com/brand/g-dark-sq.png" width="128" height="128">
+</p>
+
+# @gramatr/opencode-plugin
+
+grāmatr lifecycle plugin for [OpenCode](https://opencode.ai). Maps OpenCode's
+plugin events (`session.created`, `message.updated`, `tool.execute.before`,
+`session.idle`, `session.compacted`) to grāmatr hooks — pre-classifying every
+prompt through the remote MCP server at `api.gramatr.com/mcp`, restoring
+session continuity on start, and enforcing git-gate hard rules before
+destructive shell commands run. Same intelligent context engineering layer
+used across Claude Code, ChatGPT, Cursor, Codex, and Gemini.
+
+## What you get
+
+- **Cheaper, faster prompts.** A multi-head classification pipeline pre-routes
+  each request and replaces the tens-of-thousands-token system prompt you'd
+  otherwise hand-maintain. The effect compounds the longer you work.
+- **Consistent behavior across sessions.** The same contract — directives plus
+  quality gates — runs on every prompt, so your AI acts the same on session
+  200 as on session 1.
+- **Continuity across tools.** A session you start in OpenCode resumes
+  cleanly in Claude Code, Cursor, or the web — the handoff is persisted by
+  the same backend.
+- **Auditable safety rails.** Per-prompt hard gates (e.g. `git push --force`
+  to `main` is blocked locally before the tool runs).
+
+## Install
+
+Add both entries to your `opencode.json`:
+
+```json
+{
+  "mcp": {
+    "gramatr": {
+      "type": "remote",
+      "url": "https://api.gramatr.com/mcp",
+      "enabled": true
+    }
+  },
+  "plugin": [
+    "@gramatr/opencode-plugin"
+  ]
+}
+```
+
+OpenCode will fetch the package from npm on next start. No global install
+required.
+
+## Authentication
+
+The remote MCP connector authenticates via OAuth 2.0 Device Authorization
+Grant ([RFC 8628](https://datatracker.ietf.org/doc/html/rfc8628)). On first
+connect, OpenCode prompts you to visit a short URL and paste a user code —
+the same flow used in SSH, WSL, and CI environments where a browser
+redirect can't reach the client. Tokens are stored by OpenCode's MCP
+client; the plugin never handles raw credentials.
+
+If you don't have a grāmatr account yet, sign up at
+[gramatr.com](https://gramatr.com).
+
+## How it works
+
+```
+OpenCode
+   │
+   ├── plugin: @gramatr/opencode-plugin  ──┐
+   │                                       │ lifecycle events
+   │                                       │ (session.created, message.updated, …)
+   │                                       ▼
+   └── mcp.gramatr (remote, OAuth) ──► api.gramatr.com/mcp
+                                       (route_request, load_handoff,
+                                        save_reflection, …)
+```
+
+The plugin is a thin connector: every grāmatr hook is invoked against the
+already-connected remote MCP server declared in the `mcp` block — there is
+no local binary, no `execSync`, no shell-out. Guidance from the server is
+injected into the active session as a `noReply` system message so the model
+sees it before formulating its next response.
+
+When OpenCode's plugin API exposes a typed `client.callTool()`, the
+connector will switch to direct MCP tool invocation and drop the
+prompt-injection path.
+
+## Requirements
+
+- OpenCode with `@opencode-ai/plugin` ≥ 1.0.0
+- Node.js ≥ 22
+- Network access to `https://api.gramatr.com/mcp`
+
+## Links
+
+- Docs: [gramatr.com/docs](https://gramatr.com/docs)
+- OpenCode plugin reference: [opencode.ai/docs/plugins](https://opencode.ai/docs/plugins/)
+- Source manifest: [`contracts/mcp/opencode-plugin-manifest.yaml`](https://github.com/gramatr/gramatr/blob/main/contracts/mcp/opencode-plugin-manifest.yaml)
+- Privacy: [gramatr.com/privacy](https://gramatr.com/privacy/)
+- Terms: [gramatr.com/terms](https://gramatr.com/terms/)
+- Support: [support@gramatr.com](mailto:support@gramatr.com)
+
+## License
+
+See [LICENSE](LICENSE) in this package.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gramatr/opencode-plugin",
-  "version": "0.20.82",
+  "version": "0.20.84",
   "description": "grāmatr lifecycle plugin for OpenCode — maps OpenCode plugin events to grāmatr hooks via the connected MCP client (route_request injection, session continuity, git-gate).",
   "license": "SEE LICENSE IN LICENSE",
   "publishConfig": {