@flowdesk/opencode-plugin 0.1.2 → 0.1.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FlowDesk contributors
+
+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.

package/README.md

@@ -0,0 +1,86 @@
+# @flowdesk/opencode-plugin
+
+FlowDesk for opencode plugin with Release 1 non-dispatch command-backed
+registration plus opt-in description-driven natural-language tools.
+
+## Install
+
+```bash
+npm install @flowdesk/opencode-plugin@^0.1.2
+```
+
+## Configure
+
+The OpenCode plugin entry must point at the `/server` subpath. The package
+root only exports helper types and an id; the actual default plugin object
+is exposed under `/server`:
+
+```json
+{
+  "plugin": ["@flowdesk/opencode-plugin/server"]
+}
+```
+
+The minimum opt-in set for the natural-language tools is:
+
+```json
+{
+  "plugin": [
+    [
+      "@flowdesk/opencode-plugin/server",
+      {
+        "providerUsageLive": {
+          "enabled": true,
+          "providers": ["claude", "openai", "gemini"]
+        },
+        "statusLive": { "enabled": true },
+        "laneHeartbeatWriter": { "enabled": true },
+        "chatMessageStallAlert": { "enabled": true },
+        "durableStateRoot": "/Users/<you>/.flowdesk"
+      }
+    ]
+  ]
+}
+```
+
+## Natural-Language Tools
+
+Once loaded, the assistant LLM picks up five description-driven FlowDesk
+tools without you typing portable commands:
+
+1. `flowdesk_quick_reviewer_run` for explicit multi-perspective code review
+   (Korean `다관점 리뷰 해줘`, English `multi-perspective review`).
+2. `flowdesk_provider_usage_live` for usage, quota, remaining, reset, or
+   rate-limit questions (Korean `사용량 보여줘`, English `how much usage
+   do I have left`).
+3. `flowdesk_status_live` for workflow status, lane heartbeat, or "is it
+   stuck" questions (Korean `상태`, `어디까지`, `멈췄어`, `하트비트 알려줘`;
+   English `status`, `where are we`, `is it stuck`,
+   `lane heartbeat status`).
+4. `flowdesk_quick_fallback_run` for explicit provider fallback intent
+   (Korean `Claude 막혔어 OpenAI 로 다시`, English `fallback to`,
+   `switch to`, `retry with`). Plans only; actual provider switching stays
+   behind managed-dispatch promotion.
+5. `flowdesk_lane_heartbeat_record` for explicit heartbeat requests
+   (Korean `하트비트 남겨줘`, English `record heartbeat`, `mark progress`).
+
+See the workspace
+[QUICKSTART](https://github.com/astasdf1/flowdesk/blob/main/docs/QUICKSTART.md),
+[USAGE_NATURAL_LANGUAGE](https://github.com/astasdf1/flowdesk/blob/main/docs/USAGE_NATURAL_LANGUAGE.md),
+and [USER_MANUAL](https://github.com/astasdf1/flowdesk/blob/main/docs/USER_MANUAL.md)
+for the full Korean and English trigger lists, opt-in config, and safety
+boundaries.
+
+## Authority Boundary
+
+`realOpenCodeDispatch`, `providerCall`, `runtimeExecution`,
+`actualLaneLaunch`, `fallbackAuthority`,
+`hardCancelOrNoReplyAuthority`, and `toolAuthority` always remain `false`.
+Only diagnostic flags (`providerUsageAcquired`, `statusEvidenceObserved`,
+`exactModelProviderAcquisitionRecorded`, `regatePlanPrepared`,
+`laneHeartbeatPersisted`, `expectedNextHeartbeatOverdue`) can become
+`true` to indicate that real diagnostic data was read or written.
+
+## License
+
+MIT. See the workspace-level [LICENSE](https://github.com/astasdf1/flowdesk/blob/main/LICENSE).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowdesk/opencode-plugin",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "FlowDesk OpenCode plugin with Release 1 non-dispatch command-backed registration.",
   "type": "module",
   "license": "MIT",
@@ -9,6 +9,13 @@
     "url": "git+https://github.com/astasdf1/flowdesk.git",
     "directory": "packages/opencode-plugin"
   },
+  "homepage": "https://github.com/astasdf1/flowdesk#readme",
+  "bugs": {
+    "url": "https://github.com/astasdf1/flowdesk/issues"
+  },
+  "engines": {
+    "node": ">=20.11.0"
+  },
   "publishConfig": {
     "access": "public"
   },
@@ -21,7 +28,9 @@
     "!dist/**/*.test.d.ts.map",
     "!dist/**/*.test.js",
     "!dist/**/*.test.js.map",
-    "!dist/.tsbuildinfo"
+    "!dist/.tsbuildinfo",
+    "README.md",
+    "LICENSE"
   ],
   "exports": {
     ".": {
@@ -48,7 +57,15 @@
     "test": "npm run build && node --test dist/**/*.test.js"
   },
   "dependencies": {
-    "@flowdesk/core": "^0.1.2",
-    "@opencode-ai/plugin": "1.15.6"
+    "@flowdesk/core": "^0.1.4"
+  },
+  "peerDependencies": {
+    "@opencode-ai/plugin": ">=1.14.40 <2"
+  },
+  "peerDependenciesMeta": {
+    "@opencode-ai/plugin": {
+      "optional": false
+    }
   }
 }
+