@thxgg/steward 0.1.23 → 0.1.25

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/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]}
+{"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/sync-identity.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","execGit","isGitRepo","nowIso","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,44,45,47,48,49,50,51]}

package/.output/server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thxgg/steward-prod",
-  "version": "0.1.23",
+  "version": "0.1.25",
   "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:
 
@@ -56,14 +58,55 @@ Note: `execute` runs in a VM sandbox by design, so globals like `process` are in
 prd ui
 prd ui --port 3100 --host 127.0.0.1
 prd mcp
+prd sync export ./steward-sync.json
+prd sync inspect ./steward-sync.json
+prd sync merge ./steward-sync.json
+prd sync merge ./steward-sync.json --apply
+prd sync merge ./steward-sync.json --apply --map rsk_source=/Users/you/Projects/repo
 ```
 
+### Sync Bundles (Cross-Device)
+
+Steward supports local-first state sharing across devices using portable JSON bundles.
+
+- `prd sync export <bundle-path>` writes a versioned bundle of repos/state/archives.
+- `prd sync inspect <bundle-path>` validates and summarizes bundle contents.
+- `prd sync merge <bundle-path>` plans a merge in dry-run mode by default.
+- `prd sync merge <bundle-path> --apply` applies the planned merge transactionally.
+
+Path hint privacy defaults:
+
+- Export defaults to `--path-hints basename` to avoid leaking absolute filesystem paths.
+- Use `--path-hints none` to omit path hints entirely.
+- Use `--path-hints absolute` only when you explicitly want full paths in the bundle.
+
+Representative command output summaries:
+
+- `sync export` prints bundle path, bundle id, and row totals (`repos/states/archives`).
+- `sync inspect` prints bundle metadata (`bundleId`, `sourceDeviceId`, format version), totals, and unknown references.
+- `sync merge` prints mapping totals, state/archive action counts, and conflict counts.
+- `sync merge --apply` also prints backup path and retention cleanup counts.
+
+Safety defaults and retention:
+
+- Merge defaults to dry-run; no writes happen unless `--apply` is provided.
+- Apply creates a SQLite backup before any write and runs an integrity check before commit.
+- Re-applying the same bundle id is idempotent and returns a no-op result.
+- Default retention keeps backups for 30 days (max 20 files) and sync apply logs for 180 days (max 10,000 rows).
+
+Troubleshooting sync:
+
+- Unresolved mapping on apply: run `prd sync inspect <bundle-path>` and pass one or more `--map <incomingRepoSyncKey>=<localPathOrRepoRef>` values.
+- Expected no-op reapply: if bundle id was already applied, merge returns "already applied" and leaves state unchanged.
+- Restore from backup: stop Steward processes, then replace your DB file with a backup in the same directory (files match `state.db.sync-backup.*.db`).
+
 ## Architecture
 
 ```
 ┌─────────────────────────────────────────┐
 │            Steward CLI (Node)           │
 │  - `prd ui` runs prebuilt UI server     │
+│  - `prd sync` manages state bundles     │
 │  - `prd mcp` starts MCP over stdio      │
 └─────────────────────────────────────────┘
                     │
@@ -89,10 +132,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 +222,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/bin/prd

@@ -12,7 +12,7 @@ const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..')
 const entryPath = resolve(packageRoot, 'dist', 'host', 'src', 'index.js')
 
 function requiresSqliteRuntime(command) {
-  return command === 'mcp' || command === 'ui'
+  return command === 'mcp' || command === 'ui' || command === 'sync'
 }
 
 function isSqliteRuntimeError(error) {

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/index.js

@@ -1,14 +1,17 @@
 import { runMcpServer } from './mcp.js';
+import { runSync } from './sync.js';
 import { runUi } from './ui.js';
 function printUsage() {
     console.log(`prd - Steward CLI
 
 Usage:
   prd ui [--preview] [--port <port>] [--host <host>]
+  prd sync <subcommand> [options]
   prd mcp
 
 Commands:
   ui         Launch the prebuilt PRD web UI server
+  sync       Export/inspect/merge sync bundles
   mcp        Start MCP server over stdio (codemode)
 
 Options:
@@ -84,6 +87,13 @@ export async function main(argv = process.argv.slice(2)) {
         }
         return;
     }
+    if (command === 'sync') {
+        const exitCode = await runSync(rest);
+        if (exitCode !== 0) {
+            process.exitCode = exitCode;
+        }
+        return;
+    }
     throw new Error(`Unknown command: ${command}`);
 }
 if (import.meta.main) {

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/host/src/sync.js

@@ -0,0 +1,201 @@
+import { promises as fs } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { buildSyncBundle, serializeSyncBundle } from '../../server/utils/sync-export.js';
+import { executeSyncMergeJson } from '../../server/utils/sync-apply.js';
+import { inspectSyncBundleJson } from '../../server/utils/sync-inspect.js';
+function printSyncUsage() {
+    console.log(`Sync Usage:
+  prd sync export <bundle-path> [--path-hints basename|none|absolute]
+  prd sync inspect <bundle-path>
+  prd sync merge <bundle-path> [--map <incomingRepoSyncKey>=<localPathOrRepoRef>] [--dry-run] [--apply]
+
+Notes:
+  - merge defaults to --dry-run when --apply is omitted
+  - --map can be provided multiple times
+`);
+}
+function resolveBundlePath(pathInput) {
+    return resolve(process.cwd(), pathInput);
+}
+function parsePathHintsMode(rawValue) {
+    if (rawValue === 'basename' || rawValue === 'none' || rawValue === 'absolute') {
+        return rawValue;
+    }
+    throw new Error(`Invalid --path-hints value: ${rawValue}`);
+}
+function parseMapAssignment(rawValue) {
+    const separatorIndex = rawValue.indexOf('=');
+    if (separatorIndex <= 0 || separatorIndex >= rawValue.length - 1) {
+        throw new Error(`Invalid --map value: ${rawValue}. Expected <incomingRepoSyncKey>=<localPathOrRepoRef>`);
+    }
+    const source = rawValue.slice(0, separatorIndex).trim();
+    const target = rawValue.slice(separatorIndex + 1).trim();
+    if (!source || !target) {
+        throw new Error(`Invalid --map value: ${rawValue}. Expected <incomingRepoSyncKey>=<localPathOrRepoRef>`);
+    }
+    return { source, target };
+}
+export function parseSyncExportArgs(args) {
+    let bundlePath = null;
+    let pathHints = 'basename';
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (!arg) {
+            continue;
+        }
+        if (arg === '--path-hints') {
+            const next = args[index + 1];
+            if (!next) {
+                throw new Error('--path-hints requires a value');
+            }
+            pathHints = parsePathHintsMode(next);
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith('--')) {
+            throw new Error(`Unknown option for sync export: ${arg}`);
+        }
+        if (bundlePath !== null) {
+            throw new Error(`Unexpected argument for sync export: ${arg}`);
+        }
+        bundlePath = arg;
+    }
+    if (!bundlePath) {
+        throw new Error('sync export requires <bundle-path>');
+    }
+    return {
+        bundlePath: resolveBundlePath(bundlePath),
+        pathHints
+    };
+}
+export function parseSyncInspectArgs(args) {
+    const [bundlePath] = args;
+    if (args.length !== 1 || !bundlePath || bundlePath.startsWith('--')) {
+        throw new Error('sync inspect requires exactly one <bundle-path>');
+    }
+    return {
+        bundlePath: resolveBundlePath(bundlePath)
+    };
+}
+export function parseSyncMergeArgs(args) {
+    let bundlePath = null;
+    let apply = false;
+    let dryRun = false;
+    const repoMap = {};
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (!arg) {
+            continue;
+        }
+        if (arg === '--apply') {
+            apply = true;
+            continue;
+        }
+        if (arg === '--dry-run') {
+            dryRun = true;
+            continue;
+        }
+        if (arg === '--map') {
+            const next = args[index + 1];
+            if (!next) {
+                throw new Error('--map requires a value');
+            }
+            const { source, target } = parseMapAssignment(next);
+            repoMap[source] = target;
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith('--')) {
+            throw new Error(`Unknown option for sync merge: ${arg}`);
+        }
+        if (bundlePath !== null) {
+            throw new Error(`Unexpected argument for sync merge: ${arg}`);
+        }
+        bundlePath = arg;
+    }
+    if (!bundlePath) {
+        throw new Error('sync merge requires <bundle-path>');
+    }
+    if (apply && dryRun) {
+        throw new Error('Cannot use --apply and --dry-run together');
+    }
+    return {
+        bundlePath: resolveBundlePath(bundlePath),
+        apply,
+        repoMap
+    };
+}
+async function runSyncExport(args) {
+    const parsed = parseSyncExportArgs(args);
+    const bundle = await buildSyncBundle({
+        pathHints: parsed.pathHints
+    });
+    await fs.mkdir(dirname(parsed.bundlePath), { recursive: true });
+    await fs.writeFile(parsed.bundlePath, `${serializeSyncBundle(bundle)}\n`, 'utf-8');
+    console.log(`[steward] Exported bundle: ${parsed.bundlePath}`);
+    console.log(`[steward] Bundle ID: ${bundle.bundleId}`);
+    console.log(`[steward] Rows: repos=${bundle.repos.length} states=${bundle.states.length} archives=${bundle.archives.length}`);
+    return 0;
+}
+async function runSyncInspect(args) {
+    const parsed = parseSyncInspectArgs(args);
+    const jsonPayload = await fs.readFile(parsed.bundlePath, 'utf-8');
+    const inspection = inspectSyncBundleJson(jsonPayload);
+    console.log(`[steward] Bundle: ${parsed.bundlePath}`);
+    console.log(`[steward] ID=${inspection.bundleId} sourceDevice=${inspection.sourceDeviceId} format=v${inspection.formatVersion}`);
+    console.log(`[steward] Totals: repos=${inspection.totals.repos} states=${inspection.totals.states} archives=${inspection.totals.archives}`);
+    console.log(`[steward] Unknown references: states=${inspection.totals.unknownRepoStates} archives=${inspection.totals.unknownRepoArchives}`);
+    for (const repo of inspection.repos) {
+        const hint = repo.pathHint ? ` pathHint=${repo.pathHint}` : '';
+        console.log(`[steward] Repo ${repo.repoSyncKey} (${repo.name})${hint} states=${repo.stateCount} archives=${repo.archiveCount}`);
+    }
+    return 0;
+}
+async function runSyncMerge(args) {
+    const parsed = parseSyncMergeArgs(args);
+    const jsonPayload = await fs.readFile(parsed.bundlePath, 'utf-8');
+    const result = await executeSyncMergeJson(jsonPayload, {
+        apply: parsed.apply,
+        repoMap: parsed.repoMap
+    });
+    const mode = result.mode === 'dry_run' ? 'dry-run' : 'apply';
+    console.log(`[steward] Merge mode: ${mode}`);
+    console.log(`[steward] Bundle ID: ${result.bundleId}`);
+    console.log(`[steward] Repo mapping: mapped=${result.plan.summary.repos.mapped} unresolved=${result.plan.summary.repos.unresolved}`);
+    console.log(`[steward] State actions: insert=${result.plan.summary.states.insert} update=${result.plan.summary.states.update} skip=${result.plan.summary.states.skip} unresolved=${result.plan.summary.states.unresolved} conflicts=${result.plan.summary.states.conflicts}`);
+    console.log(`[steward] Archive actions: insert=${result.plan.summary.archives.insert} update=${result.plan.summary.archives.update} skip=${result.plan.summary.archives.skip} unresolved=${result.plan.summary.archives.unresolved}`);
+    if (result.mode === 'apply') {
+        if (result.alreadyApplied) {
+            console.log('[steward] Bundle already applied; no changes were written.');
+        }
+        else {
+            console.log(`[steward] Applied: ${result.applied ? 'yes' : 'no'}`);
+            if (result.backupPath) {
+                console.log(`[steward] Backup: ${result.backupPath}`);
+            }
+            console.log(`[steward] Retention: backupsDeleted=${result.retention.backupsDeleted} logsDeleted=${result.retention.logsDeleted}`);
+        }
+    }
+    else {
+        console.log('[steward] Dry-run only; re-run with --apply to write changes.');
+    }
+    return 0;
+}
+export async function runSync(args) {
+    const [subcommandRaw, ...rest] = args;
+    const subcommand = subcommandRaw || '';
+    if (subcommand === '' || subcommand === '-h' || subcommand === '--help') {
+        printSyncUsage();
+        return 0;
+    }
+    if (subcommand === 'export') {
+        return await runSyncExport(rest);
+    }
+    if (subcommand === 'inspect') {
+        return await runSyncInspect(rest);
+    }
+    if (subcommand === 'merge') {
+        return await runSyncMerge(rest);
+    }
+    throw new Error(`Unknown sync subcommand: ${subcommandRaw}`);
+}