@thxgg/steward 0.1.23 → 0.1.24

package/.output/server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thxgg/steward-prod",
-  "version": "0.1.23",
+  "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/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.23",
+  "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/bd99c09c-d991-4bcb-8c66-ab2088e1da03.json

@@ -1 +0,0 @@
-{"id":"bd99c09c-d991-4bcb-8c66-ab2088e1da03","timestamp":1772218681776,"prerendered":[]}