sisyphi 1.2.20 → 1.2.22

package/dist/cli.js

@@ -5956,12 +5956,30 @@ function registerStart(parent, root) {
   if (root) buildStartCommand(root, true);
 }
 function buildStartCommand(target, hidden) {
-  target.command("start", { hidden }).description("Start a new sisyphus session").argument("[task]", "Task description for the orchestrator (omit when using --stdin)").option("--context <context>", "Background context for the orchestrator").option("--name <name>", "Human-readable name for the session").option("--effort <tier>", "Pipeline effort tier (low|medium|high|xhigh)").option("--stdin", "Read the task description from stdin (avoids shell escaping for long prompts)").option("--context-stdin", "Read the context from stdin (mutually exclusive with --stdin)").option("--accept-cwd-mismatch", "Proceed even when invocation cwd differs from the current tmux session's home (linking will be inconsistent)").addHelpText("after", `
+  target.command("start", { hidden }).description("Start a new sisyphus session").argument("[task]", "Task description for the orchestrator (omit when using --stdin)").option("-c, --context <context>", "Background context for the orchestrator").option("--name <name>", "Human-readable name for the session").option("--effort <tier>", "Pipeline effort tier (low|medium|high|xhigh)").option("--stdin", "Read the task description from stdin (avoids shell escaping for long prompts)").option("--context-stdin", "Read the context from stdin (mutually exclusive with --stdin)").option("--accept-cwd-mismatch", "Proceed even when invocation cwd differs from the current tmux session's home (linking will be inconsistent)").addHelpText("after", `
 session lifecycle start: launch a new orchestrated sisyphus session.
 
+Writing the handoff
+  task          the goal \u2014 what to build or fix and what "done" looks like. This is the
+                persistent objective the orchestrator re-reads every cycle; keep it focused.
+  -c/--context  background that informs the work but isn't the goal itself: relevant file
+                paths, constraints, specs, adjacent concerns, prior findings. Rendered
+                apart from the task so the orchestrator references it without conflating it.
+  Keep context factual, not diagnostic \u2014 point at files, areas, and constraints; don't
+  speculate on root causes or fixes, which biases the orchestrator down the wrong path.
+
+  Example
+    sis start "Fix the JWT refresh bug \u2014 app shows a blank screen on token expiry instead of redirecting to login" -c "Auth system lives in src/auth/. Key files: interceptor.ts (HTTP interceptor), token-store.ts (token persistence), refresh.ts (refresh flow). Tests in src/auth/__tests__/. Don't break the logout flow."
+
+  Long task or context? Pipe via stdin to avoid shell escaping:
+    cat task.md | sis start --stdin -c "short context here"
+    cat ctx.md  | sis start "short task" --context-stdin
+  The same --stdin / --context-stdin pattern exists on \`agent spawn\`, \`orch message\`,
+  \`orch tell\`, \`session resume\`, and agent-side \`agent submit\` / \`agent report\` / \`orch yield\`.
+
 Input
   [task]                    optional positional \u2014 task description string; omit when using --stdin or pass \`-\` to read stdin
-  --context <context>       optional \u2014 background context injected alongside the task; also readable via --context-stdin
+  -c, --context <context>   optional \u2014 background context injected alongside the task; also readable via --context-stdin
   --name <name>             optional \u2014 human-readable label for the session
   --effort <tier>           optional \u2014 pipeline effort tier: low | medium | high | xhigh
   --stdin                   optional \u2014 read task from stdin instead of positional; mutually exclusive with --context-stdin
@@ -6742,9 +6760,9 @@ function showAskTriagePopup(opts) {
       "",
       ...titleLines.map((l) => `  ${l}`),
       "",
-      "  [1] Dismiss",
-      "  [2] Open in dashboard",
-      "  [3] Open in agent",
+      "  [a] Answer in agent",
+      "  [d] Answer in dashboard",
+      "  [x] Dismiss",
       "",
       `  (auto-dismiss in ${POPUP_TIMEOUT}s)`,
       ""
@@ -6760,9 +6778,9 @@ cat <<'__SISYPHUS_ASK_EOF__'
 ${content}__SISYPHUS_ASK_EOF__
 while IFS= read -r -n1 -t ${POPUP_TIMEOUT} k; do
   case "$k" in
-    1|d|D|q|Q|'') printf 'dismiss' > "$RESULT_FILE"; break ;;
-    2|b|B) printf 'dashboard' > "$RESULT_FILE"; break ;;
-    3|a|A) printf 'agent' > "$RESULT_FILE"; break ;;
+    a|A) printf 'agent' > "$RESULT_FILE"; break ;;
+    d|D) printf 'dashboard' > "$RESULT_FILE"; break ;;
+    x|X|q|Q|'') printf 'dismiss' > "$RESULT_FILE"; break ;;
   esac
 done
 if [ ! -f "$RESULT_FILE" ]; then printf 'dismiss' > "$RESULT_FILE"; fi