@thxgg/steward 0.1.22 → 0.1.24

package/.output/server/chunks/nitro/nitro.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"nitro.mjs","sources":["../../../../node_modules/destr/dist/index.mjs","../../../../node_modules/ufo/dist/index.mjs","../../../../node_modules/radix3/dist/index.mjs","../../../../node_modules/defu/dist/defu.mjs","../../../../node_modules/node-mock-http/dist/index.mjs","../../../../node_modules/h3/dist/index.mjs","../../../../node_modules/hookable/dist/index.mjs","../../../../node_modules/node-fetch-native/dist/native.mjs","../../../../node_modules/ofetch/dist/shared/ofetch.CWycOUEr.mjs","../../../../node_modules/ofetch/dist/node.mjs","../../../../node_modules/unstorage/dist/shared/unstorage.zVDD2mZo.mjs","../../../../node_modules/unstorage/dist/index.mjs","../../../../node_modules/unstorage/drivers/utils/index.mjs","../../../../node_modules/unstorage/drivers/utils/node-fs.mjs","../../../../node_modules/unstorage/drivers/fs-lite.mjs","../../../../node_modules/nitropack/dist/runtime/internal/storage.mjs","../../../../node_modules/ohash/dist/shared/ohash.D__AXeF1.mjs","../../../../node_modules/ohash/dist/crypto/node/index.mjs","../../../../node_modules/ohash/dist/index.mjs","../../../../node_modules/nitropack/dist/runtime/internal/hash.mjs","../../../../node_modules/nitropack/dist/runtime/internal/cache.mjs","../../../../node_modules/klona/dist/index.mjs","../../../../node_modules/scule/dist/index.mjs","../../../../node_modules/nitropack/dist/runtime/internal/utils.env.mjs","../../../../node_modules/nitropack/dist/runtime/internal/config.mjs","../../../../node_modules/unctx/dist/index.mjs","../../../../node_modules/nitropack/dist/runtime/internal/context.mjs","../../../../node_modules/nitropack/dist/runtime/internal/route-rules.mjs","../../../../node_modules/nitropack/dist/runtime/internal/utils.mjs","../../../../node_modules/@nuxt/nitro-server/dist/runtime/utils/error.mjs","../../../../node_modules/@nuxt/nitro-server/dist/runtime/handlers/error.mjs","../../../../node_modules/nitropack/dist/runtime/internal/error/utils.mjs","../../../../node_modules/nitropack/dist/runtime/internal/error/prod.mjs","../../../../node_modules/@nuxtjs/color-mode/dist/runtime/nitro-plugin.js","../../../../node_modules/nitropack/dist/runtime/internal/plugin.mjs","../../../../server/utils/change-events.ts","../../../../server/utils/db.ts","../../../../server/utils/git-repo-path.ts","../../../../server/utils/git.ts","../../../../server/utils/repos.ts","../../../../server/utils/state-schema.ts","../../../../server/utils/state-migration.ts","../../../../server/plugins/00-state-migration.ts","../../../../node_modules/pathe/dist/shared/pathe.M-eThtNZ.mjs","../../../../node_modules/nitropack/dist/runtime/internal/static.mjs","../../../../server/middleware/00-security.ts","../../../../node_modules/nitropack/dist/runtime/internal/app.mjs","../../../../node_modules/nitropack/dist/runtime/internal/renderer.mjs","../../../../node_modules/nitropack/dist/runtime/internal/lib/http-graceful-shutdown.mjs","../../../../node_modules/nitropack/dist/runtime/internal/shutdown.mjs","../../../../node_modules/nitropack/dist/presets/node/runtime/node-server.mjs"],"names":["getQuery","createRouter","f","h","c","i","l","createError","mergeHeaders","s","nodeFetch","Headers","Headers$1","AbortController$1","normalizeKey","defineDriver","DRIVER_NAME","dirname","fsPromises","resolve","fsp","serialize","hash","_inlineAppConfig","createRadixRouter","fs","normalizePathSlashes","isAbsolute","isGitRepo","nitroApp","callNodeRequestHandler","fetchNodeRequestHandler","gracefulShutdown","HttpsServer","HttpServer"],"mappings":"","x_google_ignoreList":[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,43,44,46,47,48,49,50]}
+{"version":3,"file":"nitro.mjs","sources":["../../../../node_modules/destr/dist/index.mjs","../../../../node_modules/ufo/dist/index.mjs","../../../../node_modules/radix3/dist/index.mjs","../../../../node_modules/defu/dist/defu.mjs","../../../../node_modules/node-mock-http/dist/index.mjs","../../../../node_modules/h3/dist/index.mjs","../../../../node_modules/hookable/dist/index.mjs","../../../../node_modules/node-fetch-native/dist/native.mjs","../../../../node_modules/ofetch/dist/shared/ofetch.CWycOUEr.mjs","../../../../node_modules/ofetch/dist/node.mjs","../../../../node_modules/unstorage/dist/shared/unstorage.zVDD2mZo.mjs","../../../../node_modules/unstorage/dist/index.mjs","../../../../node_modules/unstorage/drivers/utils/index.mjs","../../../../node_modules/unstorage/drivers/utils/node-fs.mjs","../../../../node_modules/unstorage/drivers/fs-lite.mjs","../../../../node_modules/nitropack/dist/runtime/internal/storage.mjs","../../../../node_modules/ohash/dist/shared/ohash.D__AXeF1.mjs","../../../../node_modules/ohash/dist/crypto/node/index.mjs","../../../../node_modules/ohash/dist/index.mjs","../../../../node_modules/nitropack/dist/runtime/internal/hash.mjs","../../../../node_modules/nitropack/dist/runtime/internal/cache.mjs","../../../../node_modules/klona/dist/index.mjs","../../../../node_modules/scule/dist/index.mjs","../../../../node_modules/nitropack/dist/runtime/internal/utils.env.mjs","../../../../node_modules/nitropack/dist/runtime/internal/config.mjs","../../../../node_modules/unctx/dist/index.mjs","../../../../node_modules/nitropack/dist/runtime/internal/context.mjs","../../../../node_modules/nitropack/dist/runtime/internal/route-rules.mjs","../../../../node_modules/nitropack/dist/runtime/internal/utils.mjs","../../../../node_modules/@nuxt/nitro-server/dist/runtime/utils/error.mjs","../../../../node_modules/@nuxt/nitro-server/dist/runtime/handlers/error.mjs","../../../../node_modules/nitropack/dist/runtime/internal/error/utils.mjs","../../../../node_modules/nitropack/dist/runtime/internal/error/prod.mjs","../../../../node_modules/@nuxtjs/color-mode/dist/runtime/nitro-plugin.js","../../../../node_modules/nitropack/dist/runtime/internal/plugin.mjs","../../../../server/utils/db.ts","../../../../server/utils/change-events.ts","../../../../server/utils/git-repo-path.ts","../../../../server/utils/git.ts","../../../../server/utils/repos.ts","../../../../server/utils/state-schema.ts","../../../../server/utils/state-migration.ts","../../../../server/plugins/00-state-migration.ts","../../../../node_modules/pathe/dist/shared/pathe.M-eThtNZ.mjs","../../../../node_modules/nitropack/dist/runtime/internal/static.mjs","../../../../server/middleware/00-security.ts","../../../../node_modules/nitropack/dist/runtime/internal/app.mjs","../../../../node_modules/nitropack/dist/runtime/internal/renderer.mjs","../../../../node_modules/nitropack/dist/runtime/internal/lib/http-graceful-shutdown.mjs","../../../../node_modules/nitropack/dist/runtime/internal/shutdown.mjs","../../../../node_modules/nitropack/dist/presets/node/runtime/node-server.mjs"],"names":["getQuery","createRouter","f","h","c","i","l","createError","mergeHeaders","s","nodeFetch","Headers","Headers$1","AbortController$1","normalizeKey","defineDriver","DRIVER_NAME","dirname","fsPromises","resolve","fsp","serialize","hash","_inlineAppConfig","createRadixRouter","fs","normalizePathSlashes","isAbsolute","isGitRepo","nitroApp","callNodeRequestHandler","fetchNodeRequestHandler","gracefulShutdown","HttpsServer","HttpServer"],"mappings":"","x_google_ignoreList":[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,43,44,46,47,48,49,50]}

package/.output/server/chunks/routes/renderer.mjs

@@ -1,5 +1,5 @@
 import { createRenderer, getRequestDependencies, getPreloadLinks, getPrefetchLinks } from 'vue-bundle-renderer/runtime';
-import { K as joinRelativeURL, F as useRuntimeConfig, L as getResponseStatusText, M as getResponseStatus, N as defineRenderHandler, g as getQuery, c as createError, O as destr, P as getRouteRules, Q as joinURL, R as useNitroApp } from '../nitro/nitro.mjs';
+import { M as joinRelativeURL, F as useRuntimeConfig, N as getResponseStatusText, O as getResponseStatus, P as defineRenderHandler, g as getQuery, c as createError, Q as destr, R as getRouteRules, S as joinURL, T as useNitroApp } from '../nitro/nitro.mjs';
 import { renderToString } from 'vue/server-renderer';
 import { createHead as createHead$1, propsToString, renderSSRHead } from 'unhead/server';
 import { stringify, uneval } from 'devalue';

package/.output/server/index.mjs

@@ -1,6 +1,6 @@
 import process from 'node:process';globalThis._importMeta_={url:import.meta.url,env:process.env};import 'node:http';
 import 'node:https';
-export { a6 as default } from './chunks/nitro/nitro.mjs';
+export { a8 as default } from './chunks/nitro/nitro.mjs';
 import 'node:events';
 import 'node:buffer';
 import 'node:fs';

package/.output/server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thxgg/steward-prod",
-  "version": "0.1.22",
+  "version": "0.1.24",
   "type": "module",
   "private": true,
   "dependencies": {

package/README.md

@@ -33,7 +33,7 @@ Add to your MCP client config:
 ```json
 {
   "mcpServers": {
-    "prd": {
+    "steward": {
       "command": "npx",
       "args": ["-y", "@thxgg/steward", "mcp"]
     }
@@ -41,6 +41,8 @@ Add to your MCP client config:
 }
 ```
 
+The MCP server key (`steward` above) controls the prompt prefix in slash commands.
+
 Steward MCP requires a Node runtime with built-in sqlite support (`node:sqlite`) for `repos`, `prds`, and `state` APIs.
 If you see `ERR_UNKNOWN_BUILTIN_MODULE: node:sqlite`, run with sqlite enabled:
 
@@ -89,10 +91,14 @@ Steward exposes one MCP tool: `execute`.
 It also exposes workflow prompts:
 
 - `create_prd(feature_request)`
-- `break_into_tasks(prd_slug)`
-- `complete_next_task(prd_slug)`
+- `break_into_tasks(prd_slug?)`
+- `complete_next_task(prd_slug?)`
+
+In OpenCode these are shown as MCP slash entries like `/steward:create_prd:mcp` and inserted as `/steward:create_prd`.
 
-In OpenCode these are shown as MCP slash entries like `/prd:create_prd:mcp`.
+- `prd_slug` is optional for break/complete prompts.
+- When omitted, Steward workflows auto-resolve the slug from repo state.
+- `complete_next_task` includes required commit hygiene (one-line commit message, no `Co-authored-by`, no task-related dirty changes left behind).
 
 ```js
 const repo = await repos.current()
@@ -175,13 +181,12 @@ npm run build
 | `PRD_STATE_HOME` | Base directory for DB (`state.db` inside) |
 | `XDG_DATA_HOME` | Fallback base path for default DB location |
 
-## OpenCode Bundle
+## OpenCode Integration
 
-This repo includes curated OpenCode assets under `opencode/`:
+Steward now uses MCP-registered prompts as the single workflow surface.
 
-- Commands: `prd`, `prd-task`, `complete-next-task`, `commit`
-- Skills: `prd`, `prd-task`, `complete-next-task`, `commit`
-- Script: `prd-db.mjs`
+- Use MCP prompts directly (for example `/steward:create_prd`, `/steward:break_into_tasks`, `/steward:complete_next_task`).
+- This repository no longer ships separate OpenCode command/skill bundles for PRD workflows.
 
 ## License
 

package/dist/host/src/api/repo-context.js

@@ -1,4 +1,4 @@
-import { resolve } from 'node:path';
+import { isAbsolute, relative, resolve } from 'node:path';
 import { getRepoById, getRepos } from '../../../server/utils/repos.js';
 export class RepoLookupError extends Error {
     code;
@@ -22,6 +22,18 @@ function formatKnownRepos(knownRepos) {
         .map((repo) => `${repo.id} (${repo.name}) ${repo.path}`)
         .join('; ');
 }
+function isPathWithin(basePath, candidatePath) {
+    const relativePath = relative(resolve(basePath), resolve(candidatePath));
+    return relativePath === '' || (!relativePath.startsWith('..') && !isAbsolute(relativePath));
+}
+function resolveRepoFromCwd(repos, cwd) {
+    const matches = repos.filter((repo) => isPathWithin(repo.path, cwd));
+    if (matches.length === 0) {
+        return null;
+    }
+    matches.sort((left, right) => resolve(right.path).length - resolve(left.path).length);
+    return matches[0] ?? null;
+}
 export async function requireRepo(repoId) {
     const repo = await getRepoById(repoId);
     if (repo) {
@@ -56,5 +68,10 @@ export async function requireCurrentRepo() {
     if (knownRepos.length === 0) {
         throw new RepoLookupError('No repositories are registered. Use repos.add(path) first.', 'NO_REPOS', { knownRepos });
     }
-    throw new RepoLookupError(`Cannot resolve a current repository because ${knownRepos.length} repositories are registered. Use an explicit repoId or by-path API. Known repositories: ${formatKnownRepos(knownRepos)}`, 'AMBIGUOUS_REPO', { knownRepos });
+    const cwd = resolve(process.cwd());
+    const repoFromCwd = resolveRepoFromCwd(allRepos, cwd);
+    if (repoFromCwd) {
+        return repoFromCwd;
+    }
+    throw new RepoLookupError(`Cannot resolve a current repository because ${knownRepos.length} repositories are registered and the working directory does not map to a registered repo. Use an explicit repoId or by-path API. CWD: ${cwd}. Known repositories: ${formatKnownRepos(knownRepos)}`, 'AMBIGUOUS_REPO', { cwd, knownRepos });
 }

package/dist/host/src/prompts.js

@@ -33,64 +33,88 @@ function createPrdPrompt(featureRequest) {
         '   - created PRD path',
         '   - chosen slug',
         '   - key product decisions and open questions',
-        '   - recommended next command: /prd:break_into_tasks <slug> (shown as :mcp in autocomplete).'
+        '   - recommended next MCP prompt: /<your-mcp-server-prefix>:break_into_tasks <slug> (autocomplete may show an extra :mcp suffix).'
     ].join('\n');
 }
 function breakIntoTasksPrompt(prdSlug) {
+    const resolvedInput = typeof prdSlug === 'string' ? prdSlug.trim() : '';
     return [
         'You are converting a PRD into structured Steward task state.',
         '',
-        'PRD slug:',
-        prdSlug,
+        `PRD slug input: ${resolvedInput || '<auto-resolve>'}`,
         '',
         'Workflow:',
-        '1. Load docs/prd/<slug>.md. If not found, list available PRDs and stop with a clear correction.',
-        '2. Update PRD status from Draft to Approved in the markdown file.',
-        '3. Build tasks JSON with this shape:',
+        '1. Resolve repository and PRD slug before writing anything:',
+        '   - Resolve repo with execute tool: const repo = await repos.current().',
+        '   - If slug input is present, use it as resolvedSlug.',
+        '   - If slug input is missing, list PRDs: const prdList = await prds.list(repo.id).',
+        '   - Auto-pick resolvedSlug deterministically:',
+        '     a) prefer PRDs with hasState=false, newest modifiedAt first, then slug ascending',
+        '     b) otherwise pick newest modifiedAt, then slug ascending',
+        '   - If no PRDs exist, stop and ask user to run create_prd first.',
+        '2. Load docs/prd/<resolvedSlug>.md. If missing, list available PRDs and stop with a clear correction.',
+        '3. Update PRD status from Draft to Approved in the markdown file.',
+        '4. Build tasks JSON with this shape:',
         '   { prd: { name, source, createdAt }, tasks: [{ id, category, title, description, steps, passes, dependencies, priority, status }] }',
-        '4. Use these category values only: setup, feature, integration, testing, documentation.',
-        '5. Use these priority values only: critical, high, medium, low.',
-        '6. Set every generated task status to pending and make passes an array of testable criteria.',
-        '7. Build progress JSON with this shape:',
+        '5. Use these category values only: setup, feature, integration, testing, documentation.',
+        '6. Use these priority values only: critical, high, medium, low.',
+        '7. Set every generated task status to pending and make passes an array of testable criteria.',
+        '8. Build progress JSON with this shape:',
         '   { prdName, totalTasks, completed, inProgress, blocked, startedAt, lastUpdated, patterns, taskLogs }',
         '   Initialize with completed=0, inProgress=0, blocked=0, startedAt=null, patterns=[], taskLogs=[].',
-        '8. Persist state through execute tool:',
-        `   await state.upsertCurrent("${prdSlug}", { tasks: <tasksJson>, progress: <progressJson> })`,
-        `   return await state.getCurrent("${prdSlug}")`,
-        '9. Report task count, category breakdown, critical path, and recommended next command:',
-        `   /prd:complete_next_task ${prdSlug} (shown as :mcp in autocomplete).`
+        '9. Persist state through execute tool:',
+        '   await state.upsertCurrent(resolvedSlug, { tasks: tasksJson, progress: progressJson })',
+        '   return await state.getCurrent(resolvedSlug)',
+        '10. Report task count, category breakdown, critical path, resolvedSlug, and recommended next MCP prompt:',
+        '   /<your-mcp-server-prefix>:complete_next_task <resolvedSlug> (autocomplete may show an extra :mcp suffix).'
     ].join('\n');
 }
 function completeNextTaskPrompt(prdSlug) {
+    const resolvedInput = typeof prdSlug === 'string' ? prdSlug.trim() : '';
     return [
         'You are completing the next PRD task with Steward state tracking and commits.',
         '',
-        'PRD slug:',
-        prdSlug,
+        `PRD slug input: ${resolvedInput || '<auto-resolve>'}`,
         '',
         'Workflow:',
-        `1. Load PRD state using execute tool: state.getCurrent("${prdSlug}").`,
-        `   If tasks are missing, stop and instruct to run /prd:break_into_tasks ${prdSlug}.`,
-        '2. Select the next task:',
+        '1. Resolve repository and PRD slug before any task updates:',
+        '   - Resolve repo with execute tool: const repo = await repos.current().',
+        '   - If slug input is present, use it as resolvedSlug.',
+        '   - If slug input is missing, list PRDs: const prdList = await prds.list(repo.id).',
+        '   - Build actionable candidates where hasState=true and completedCount < taskCount.',
+        '   - Auto-pick resolvedSlug as the latest actionable candidate (modifiedAt desc, then slug asc).',
+        '   - If no actionable candidates exist, fall back to latest PRD with hasState=true, then latest PRD overall.',
+        '   - If no PRD exists, stop and ask user to run create_prd first.',
+        '2. Load PRD state with execute tool: state.getCurrent(resolvedSlug).',
+        '   If tasks are missing, stop and instruct to run /<your-mcp-server-prefix>:break_into_tasks <resolvedSlug>.',
+        '3. Select the next task:',
         '   - first task with status=in_progress, otherwise',
         '   - first pending task whose dependencies are all completed.',
-        '3. Immediately mark the task in progress and save with state.upsertCurrent:',
+        '4. Immediately mark the task in progress and save with state.upsertCurrent:',
         '   - task.status = in_progress',
         '   - task.startedAt = ISO timestamp (if absent)',
         '   - progress.inProgress updated',
         '   - progress.lastUpdated updated',
         '   - taskLogs entry exists with { taskId, status: in_progress, startedAt }',
-        '4. Implement only this task in repository files.',
-        '5. Run validation loops relevant to the project before commit (typecheck, tests, lint, format/build where applicable).',
-        '6. Commit task-related changes with a concise conventional commit message.',
-        '7. Capture commit SHAs and update taskLogs[].commits (use { sha, repo } objects for nested repos when needed).',
-        '8. Mark task completed and save with state.upsertCurrent:',
+        '5. Implement only this task in repository files.',
+        '6. Run validation loops relevant to the project before commit (typecheck, tests, lint, format/build where applicable).',
+        '7. Commit requirements (mandatory when task-related files changed):',
+        '   - Stage only task-related files (do not stage unrelated work).',
+        '   - Create at least one commit before finishing when task-related changes exist.',
+        '   - Use a one-line conventional commit subject (single -m line, no body).',
+        '   - Do not include trailers or footers, especially no Co-authored-by.',
+        '   - Prefer execute tool git.commitIfChanged(repo.id, message, { paths: taskRelatedFiles }).',
+        '   - If task-related changes exist, commit result must be committed=true before finishing.',
+        '   - If commit fails due to checks/hooks, fix issues and create a new commit.',
+        '   - Verify task-related files are not left uncommitted before final output.',
+        '8. Capture commit SHAs and update taskLogs[].commits (use { sha, repo } objects for nested repos when needed).',
+        '9. Mark task completed and save with state.upsertCurrent:',
         '   - task.status = completed',
         '   - task.completedAt = ISO timestamp',
         '   - progress.completed / progress.inProgress / progress.lastUpdated updated',
         '   - taskLogs entry updated with completedAt, implemented, filesChanged, learnings, commits',
-        '9. If all tasks are completed, output exactly: <tasks>COMPLETE</tasks>.',
-        '10. Report what changed, which commit(s) were created, and the next pending task if any.'
+        '10. If all tasks are completed, output exactly: <tasks>COMPLETE</tasks>.',
+        '11. Report what changed, resolvedSlug, which commit(s) were created, and the next pending task if any.'
     ].join('\n');
 }
 export function registerStewardPrompts(server) {
@@ -100,28 +124,28 @@ export function registerStewardPrompts(server) {
         argsSchema: {
             feature_request: z.string().describe('Feature request, idea, or problem statement for the PRD')
         }
-    }, async ({ feature_request }) => ({
+    }, async (args) => ({
         description: 'Guided workflow for creating a PRD file.',
-        messages: [textMessage(createPrdPrompt(feature_request))]
+        messages: [textMessage(createPrdPrompt(args.feature_request))]
     }));
     server.registerPrompt('break_into_tasks', {
         title: 'Break Into Tasks',
         description: 'Convert a PRD into tasks.json/progress.json style state and save it.',
         argsSchema: {
-            prd_slug: z.string().describe('PRD slug, usually the filename in docs/prd without .md')
+            prd_slug: z.string().optional().describe('Optional PRD slug (filename in docs/prd without .md). Auto-resolved when omitted.')
         }
-    }, async ({ prd_slug }) => ({
+    }, async (args) => ({
         description: 'Workflow for converting an approved PRD into task state.',
-        messages: [textMessage(breakIntoTasksPrompt(prd_slug))]
+        messages: [textMessage(breakIntoTasksPrompt(args.prd_slug))]
     }));
     server.registerPrompt('complete_next_task', {
         title: 'Complete Next Task',
         description: 'Complete the next in-progress/pending task and persist state updates.',
         argsSchema: {
-            prd_slug: z.string().describe('PRD slug whose next task should be completed')
+            prd_slug: z.string().optional().describe('Optional PRD slug whose next task should be completed. Auto-resolved when omitted.')
         }
-    }, async ({ prd_slug }) => ({
+    }, async (args) => ({
         description: 'Workflow for task execution, verification, commit capture, and state persistence.',
-        messages: [textMessage(completeNextTaskPrompt(prd_slug))]
+        messages: [textMessage(completeNextTaskPrompt(args.prd_slug))]
     }));
 }

package/dist/server/utils/change-events.js

@@ -1,7 +1,118 @@
+import { dbAll } from './db.js';
 const listeners = new Set();
 const pendingEvents = [];
 let debounceTimer = null;
+let stateChangePollTimer = null;
+let stateChangePollInFlight = false;
+let hasSeededStateSnapshot = false;
+const lastStateSnapshot = new Map();
 const DEBOUNCE_MS = 300;
+const STATE_CHANGE_POLL_INTERVAL_MS = 1000;
+function toStateSnapshotKey(repoId, slug) {
+    return `${repoId}:${slug}`;
+}
+function fromStateSnapshotKey(key) {
+    const separatorIndex = key.indexOf(':');
+    if (separatorIndex <= 0 || separatorIndex >= key.length - 1) {
+        return null;
+    }
+    return {
+        repoId: key.slice(0, separatorIndex),
+        slug: key.slice(separatorIndex + 1)
+    };
+}
+function emitStateRowChange(repoId, slug) {
+    emitChange({
+        type: 'change',
+        path: `state://${repoId}/${slug}/tasks.json`,
+        repoId,
+        category: 'tasks'
+    });
+    emitChange({
+        type: 'change',
+        path: `state://${repoId}/${slug}/progress.json`,
+        repoId,
+        category: 'progress'
+    });
+}
+async function pollPrdStateChanges() {
+    if (stateChangePollInFlight) {
+        return;
+    }
+    stateChangePollInFlight = true;
+    try {
+        const rows = await dbAll(`
+        SELECT repo_id, slug, updated_at
+        FROM prd_states
+        ORDER BY repo_id ASC, slug ASC
+      `);
+        const nextSnapshot = new Map();
+        const changedRows = [];
+        for (const row of rows) {
+            const key = toStateSnapshotKey(row.repo_id, row.slug);
+            nextSnapshot.set(key, row.updated_at);
+            if (!hasSeededStateSnapshot) {
+                continue;
+            }
+            const previousUpdatedAt = lastStateSnapshot.get(key);
+            if (previousUpdatedAt === undefined || previousUpdatedAt !== row.updated_at) {
+                changedRows.push({ repoId: row.repo_id, slug: row.slug });
+            }
+        }
+        if (hasSeededStateSnapshot) {
+            for (const key of lastStateSnapshot.keys()) {
+                if (nextSnapshot.has(key)) {
+                    continue;
+                }
+                const parsed = fromStateSnapshotKey(key);
+                if (parsed) {
+                    changedRows.push(parsed);
+                }
+            }
+        }
+        lastStateSnapshot.clear();
+        for (const [key, updatedAt] of nextSnapshot.entries()) {
+            lastStateSnapshot.set(key, updatedAt);
+        }
+        if (!hasSeededStateSnapshot) {
+            hasSeededStateSnapshot = true;
+            return;
+        }
+        for (const row of changedRows) {
+            emitStateRowChange(row.repoId, row.slug);
+        }
+    }
+    catch {
+        // Ignore transient polling failures.
+    }
+    finally {
+        stateChangePollInFlight = false;
+    }
+}
+export function startStateChangePolling() {
+    if (listeners.size === 0 || stateChangePollTimer) {
+        return;
+    }
+    void pollPrdStateChanges();
+    stateChangePollTimer = setInterval(() => {
+        void pollPrdStateChanges();
+    }, STATE_CHANGE_POLL_INTERVAL_MS);
+}
+export function stopStateChangePolling() {
+    if (stateChangePollTimer) {
+        clearInterval(stateChangePollTimer);
+        stateChangePollTimer = null;
+    }
+    stateChangePollInFlight = false;
+    hasSeededStateSnapshot = false;
+    lastStateSnapshot.clear();
+}
+export function getStateChangePollingStatus() {
+    return {
+        active: stateChangePollTimer !== null,
+        intervalMs: STATE_CHANGE_POLL_INTERVAL_MS
+    };
+}
 function flushPendingEvents() {
     const dedupedEvents = new Map();
     for (const event of pendingEvents) {
@@ -24,8 +135,14 @@ export function emitChange(event) {
 }
 export function addChangeListener(listener) {
     listeners.add(listener);
+    if (listeners.size === 1) {
+        startStateChangePolling();
+    }
     return () => {
         listeners.delete(listener);
+        if (listeners.size === 0) {
+            stopStateChangePolling();
+        }
     };
 }
 export function getChangeListenerCount() {

package/docs/MCP.md

@@ -40,7 +40,7 @@ Example MCP client config:
 ```json
 {
   "mcpServers": {
-    "prd": {
+    "steward": {
       "command": "prd",
       "args": ["mcp"]
     }
@@ -48,6 +48,8 @@ Example MCP client config:
 }
 ```
 
+The MCP server key (`steward` above) determines slash prefix names in clients.
+
 ## Runtime Requirements
 
 - `repos`, `prds`, and `state` APIs require sqlite runtime support.
@@ -105,10 +107,19 @@ In-sandbox discovery helper:
 Steward also exposes MCP prompts so MCP clients can surface command-like workflows.
 
 - `create_prd(feature_request)`
-- `break_into_tasks(prd_slug)`
-- `complete_next_task(prd_slug)`
+- `break_into_tasks(prd_slug?)`
+- `complete_next_task(prd_slug?)`
+
+In OpenCode, these appear in slash-command autocomplete as MCP commands (for example `/steward:create_prd:mcp`) and insert as `/steward:create_prd` when selected.
+
+Notes:
 
-In OpenCode, these appear in slash-command autocomplete as MCP commands (for example `/prd:create_prd:mcp`) and insert as `/prd:create_prd` when selected.
+- `prd_slug` is optional for break/complete prompts and auto-resolves when omitted.
+- `complete_next_task` requires commit hygiene when task-related files changed:
+  - at least one commit is created
+  - one-line commit subject only
+  - no `Co-authored-by` footer/trailers
+  - no task-related dirty files left behind
 
 ## Available APIs
 

package/package.json

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

package/.output/public/_nuxt/builds/meta/3e08a0b0-262b-4fb5-b213-4aa35df11afb.json

@@ -1 +0,0 @@
-{"id":"3e08a0b0-262b-4fb5-b213-4aa35df11afb","timestamp":1772208361233,"prerendered":[]}