@thxgg/steward 0.1.7 → 0.1.11

package/docs/MCP.md

@@ -46,6 +46,20 @@ Example MCP client config:
 }
 ```
 
+## Runtime Requirements
+
+- `repos`, `prds`, and `state` APIs require sqlite runtime support.
+- Steward uses Node's built-in `node:sqlite` module.
+- `prd mcp` auto-retries with `--experimental-sqlite` when the runtime supports it.
+
+If you still see `ERR_UNKNOWN_BUILTIN_MODULE: node:sqlite`, launch explicitly with:
+
+```bash
+NODE_OPTIONS=--experimental-sqlite npx -y @thxgg/steward mcp
+```
+
+If that still fails, the MCP host is using an incompatible Node runtime.
+
 ## Execute Contract
 
 `execute` expects one input field:
@@ -58,7 +72,31 @@ Example MCP client config:
 
 Your code is wrapped in an async function, so you can use `await` directly.
 
-Return values are JSON-stringified in the MCP response.
+Each call returns a JSON envelope:
+
+```json
+{
+  "ok": true,
+  "result": {},
+  "logs": [],
+  "error": null,
+  "meta": {
+    "timeoutMs": 30000,
+    "durationMs": 12,
+    "truncatedResult": false,
+    "truncatedLogs": false,
+    "resultWasUndefined": false
+  }
+}
+```
+
+- `result` is `null` when your code does not explicitly return a value.
+- `logs` contains captured `console.log/info/warn/error` output from sandbox code.
+- `error` is populated with `{ code, message, stack?, details? }` on failure.
+
+In-sandbox discovery helper:
+
+- `steward.help()`
 
 ## Available APIs
 
@@ -66,6 +104,7 @@ Return values are JSON-stringified in the MCP response.
 
 - `repos.list()`
 - `repos.get(repoId)`
+- `repos.current()`
 - `repos.add(path, name?)`
 - `repos.remove(repoId)`
 - `repos.refreshGitRepos(repoId)`
@@ -89,10 +128,13 @@ Return values are JSON-stringified in the MCP response.
 
 - `state.get(repoId, slug)`
 - `state.getByPath(repoPath, slug)`
+- `state.getCurrent(slug)`
 - `state.summaries(repoId)`
 - `state.summariesByPath(repoPath)`
+- `state.summariesCurrent()`
 - `state.upsert(repoId, slug, payload)`
 - `state.upsertByPath(repoPath, slug, payload)`
+- `state.upsertCurrent(slug, payload)`
 
 `payload` supports any combination of:
 
@@ -116,7 +158,7 @@ return await Promise.all(reposList.map(async (repo) => ({
 Load one PRD with state:
 
 ```js
-const repo = (await repos.list())[0]
+const repo = await repos.current()
 const slug = 'prd-viewer'
 
 return {
@@ -139,6 +181,24 @@ return await Promise.all(commits.map(async (entry) => ({
 })))
 ```
 
+Inspect signatures at runtime:
+
+```js
+return steward.help()
+```
+
+Update state in the current repo (no repoId required):
+
+```js
+const slug = 'prd-viewer'
+
+await state.upsertCurrent(slug, {
+  notes: '# Updated from codemode'
+})
+
+return { saved: true }
+```
+
 Update state directly by path (replacement for shell helpers):
 
 ```js
@@ -170,7 +230,8 @@ return { saved: true }
 ## Limits
 
 - Execution timeout: 30 seconds
-- Output preview limit: 50,000 characters
+- Result preview limit: 50,000 characters
+- Captured log limit: 20,000 characters (max 200 log entries)
 - Timer limit: 100 active timers in sandbox
 
 ## Safety Notes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thxgg/steward",
-  "version": "0.1.7",
+  "version": "0.1.11",
   "description": "Local-first PRD workflow steward with codemode MCP and web UI.",
   "type": "module",
   "author": "thxgg",

package/.output/public/_nuxt/builds/meta/6683a0d9-9c02-4098-b750-bbbc0305261e.json

@@ -1 +0,0 @@
-{"id":"6683a0d9-9c02-4098-b750-bbbc0305261e","timestamp":1771766521897,"prerendered":[]}

package/.output/server/chunks/build/_prd_-CnwhMRyf.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"_prd_-CnwhMRyf.mjs","sources":["../../../../node_modules/.cache/nuxt/.nuxt/dist/server/_nuxt/_prd_-CnwhMRyf.js"],"names":[],"mappings":"","x_google_ignoreList":[0]}