@pleaseai/work 0.1.7 → 0.1.8

package/README.md

@@ -1,5 +1,7 @@
 # Work Please
 
+English | [한국어](README.ko.md) | [日本語](README.ja.md) | [简体中文](README.zh-CN.md)
+
 [![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=pleaseai_work-please&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=pleaseai_work-please) [![Bugs](https://sonarcloud.io/api/project_badges/measure?project=pleaseai_work-please&metric=bugs)](https://sonarcloud.io/summary/new_code?id=pleaseai_work-please) [![Code Smells](https://sonarcloud.io/api/project_badges/measure?project=pleaseai_work-please&metric=code_smells)](https://sonarcloud.io/summary/new_code?id=pleaseai_work-please) [![Duplicated Lines (%)](https://sonarcloud.io/api/project_badges/measure?project=pleaseai_work-please&metric=duplicated_lines_density)](https://sonarcloud.io/summary/new_code?id=pleaseai_work-please)
 [![codecov](https://codecov.io/gh/pleaseai/work-please/graph/badge.svg?token=do858Z1lsI)](https://codecov.io/gh/pleaseai/work-please)
 
@@ -124,7 +126,7 @@ See [SPEC.md](SPEC.md) for the full specification.
 ### Install
 
 ```bash
-git clone https://github.com/chatbot-pf/work-please.git
+git clone https://github.com/pleaseai/work-please.git
 cd work-please
 bun install
 bun run build
@@ -147,10 +149,22 @@ tracker:
   owner: your-org
   project_number: 42
   active_statuses:
+    - Todo
     - In Progress
+    - Merging
+    - Rework
   terminal_statuses:
-    - Done
+    - Closed
     - Cancelled
+    - Canceled
+    - Duplicate
+    - Done
+  watched_statuses:
+    - Human Review
+  auto_transitions:
+    human_review_to_rework: true
+    human_review_to_merging: true
+    include_bot_reviews: true
 
 polling:
   interval_ms: 30000
@@ -194,7 +208,7 @@ Your task:
 1. Understand the issue requirements.
 2. Implement the requested changes.
 3. Write or update tests as needed.
-4. Open a pull request and move this issue to the review status.
+4. Open a pull request and move this issue to `Human Review`.
 ```
 
 #### GitHub Projects v2 (GitHub App)
@@ -211,10 +225,22 @@ tracker:
   owner: your-org
   project_number: 42
   active_statuses:
+    - Todo
     - In Progress
+    - Merging
+    - Rework
   terminal_statuses:
-    - Done
+    - Closed
     - Cancelled
+    - Canceled
+    - Duplicate
+    - Done
+  watched_statuses:
+    - Human Review
+  auto_transitions:
+    human_review_to_rework: true
+    human_review_to_merging: true
+    include_bot_reviews: true
 
 polling:
   interval_ms: 30000
@@ -258,7 +284,7 @@ Your task:
 1. Understand the issue requirements.
 2. Implement the requested changes.
 3. Write or update tests as needed.
-4. Open a pull request and move this issue to the review status.
+4. Open a pull request and move this issue to `Human Review`.
 ```
 
 #### Asana (under development)
@@ -319,7 +345,7 @@ Your task:
 1. Understand the task requirements.
 2. Implement the requested changes.
 3. Write or update tests as needed.
-4. Open a pull request and move this task to the review section.
+4. Open a pull request and move this task to the review section (e.g. `Human Review`).
 ```
 
 ### Run
@@ -362,11 +388,23 @@ tracker:
   owner: your-org                     # Required: GitHub organization or user login
   project_number: 42                  # Required: GitHub Projects v2 project number
   project_id: PVT_kwDOxxxxx          # Optional: project node ID (bypasses owner+project_number lookup)
-  active_statuses:                    # Optional: default ["Todo", "In Progress"]
+  active_statuses:                    # Optional: default ["Todo", "In Progress", "Merging", "Rework"]
+    - Todo
     - In Progress
-  terminal_statuses:                  # Optional: default ["Done", "Cancelled"]
-    - Done
+    - Merging
+    - Rework
+  terminal_statuses:                  # Optional: default ["Closed", "Cancelled", "Canceled", "Duplicate", "Done"]
+    - Closed
     - Cancelled
+    - Canceled
+    - Duplicate
+    - Done
+  watched_statuses:                   # Optional: states polled but not dispatched. Default ["Human Review"]
+    - Human Review
+  auto_transitions:                   # Optional: auto-transition rules for watched states
+    human_review_to_rework: true      # Move to Rework on CHANGES_REQUESTED or unresolved threads. Default true
+    human_review_to_merging: true     # Move to Merging on APPROVED + no unresolved threads. Default true
+    include_bot_reviews: true         # Whether bot comment threads count as unresolved. Default true
   # GitHub App authentication (alternative to api_key — all three required together):
   # app_id: $GITHUB_APP_ID            # Optional: GitHub App ID (integer or $ENV_VAR)
   # private_key: $GITHUB_APP_PRIVATE_KEY  # Optional: GitHub App private key PEM or $ENV_VAR
@@ -408,12 +446,14 @@ hooks:
 
 agent:
   max_concurrent_agents: 10           # Optional: global concurrency limit, default 10
+  max_turns: 20                       # Optional: max turns per agent run, default 20
   max_retry_backoff_ms: 300000        # Optional: max retry delay in ms, default 300000
   max_concurrent_agents_by_state:     # Optional: per-state concurrency limits
     in progress: 5
 
 claude:
   command: claude                     # Optional: Claude Code CLI command, default "claude"
+  model: claude-sonnet-4-5-20250514   # Optional: override Claude model. Default: CLI default
   effort: high                        # Optional: reasoning depth — 'low', 'medium', 'high', or 'max'. Default 'high'.
   permission_mode: acceptEdits        # Optional: one of 'default', 'acceptEdits', 'bypassPermissions'. Defaults to 'bypassPermissions'.
   allowed_tools:                      # Optional: restrict available tools
@@ -428,13 +468,26 @@ claude:
   turn_timeout_ms: 3600000            # Optional: per-turn timeout in ms, default 3600000
   read_timeout_ms: 5000               # Optional: initial subprocess read timeout in ms, default 5000
   stall_timeout_ms: 300000            # Optional: stall detection timeout, default 300000
+  system_prompt: "custom prompt"      # Optional: custom system prompt string. Default: built-in claude_code preset
   settings:
     attribution:
       commit: "🙏 Generated with [Work Please](https://github.com/pleaseai/work-please)"  # Optional: appended to git commit messages. Defaults to Work Please link.
       pr: "🙏 Generated with [Work Please](https://github.com/pleaseai/work-please)"      # Optional: appended to PR descriptions. Defaults to Work Please link.
 
+# worker:                              # Optional: SSH worker support (experimental)
+#   ssh_hosts:                         # List of SSH host aliases for remote execution
+#     - worker-1
+#     - worker-2
+#   max_concurrent_agents_per_host: 5  # Max agents per SSH host
+
+# observability:                       # Optional: TUI dashboard settings
+#   dashboard_enabled: true            # Enable TUI dashboard, default true
+#   refresh_ms: 1000                   # Dashboard data refresh interval, default 1000
+#   render_interval_ms: 16             # TUI render interval, default 16
+
 server:
   port: 3000                          # Optional: enable HTTP dashboard on this port
+  host: "127.0.0.1"                   # Optional: bind address, default "127.0.0.1"
 ---
 
 Your prompt template goes here. Available variables:
@@ -448,10 +501,21 @@ Your prompt template goes here. Available variables:
 - {{ issue.assignees }}     — Array of assignee logins (GitHub) or emails (Asana)
 - {{ issue.labels }}       — Array of label strings (normalized to lowercase)
 - {{ issue.blocked_by }}   — Array of blocker refs (each has id, identifier, state)
+- {{ issue.branch_name }}  — PR head branch name (for PullRequest items) or null
 - {{ issue.pull_requests }} — Array of linked PRs (each has number, title, url, state, branch_name)
+- {{ issue.review_decision }} — PR review decision: "approved", "changes_requested", "commented", "review_required", or null
+- {{ issue.has_unresolved_threads }} — Whether the PR has unresolved review threads
+- {{ issue.has_unresolved_human_threads }} — Whether the PR has unresolved non-bot review threads
 - {{ issue.priority }}     — Numeric priority or null
 - {{ issue.created_at }}   — ISO-8601 creation timestamp
 - {{ issue.updated_at }}   — ISO-8601 last-updated timestamp
+- {{ issue.project }}      — GitHub Projects v2 context (null for Asana):
+  - {{ issue.project.owner }}          — Project owner login
+  - {{ issue.project.number }}         — Project number
+  - {{ issue.project.project_id }}     — Project GraphQL node ID (resolved at runtime)
+  - {{ issue.project.item_id }}        — Project item GraphQL node ID
+  - {{ issue.project.field_id }}       — Status field GraphQL node ID (resolved at runtime)
+  - {{ issue.project.status_options }} — Array of { name, id } for status field options
 - {{ attempt }}            — Retry attempt number (null on first run)
 ```
 
@@ -601,7 +665,7 @@ Start with `default` or `acceptEdits` unless you are running in a fully isolated
 
 ## License
 
-Apache License 2.0. See [LICENSE](vendor/symphony/LICENSE) for details.
+Functional Source License 1.1, MIT Future License (FSL-1.1-MIT). See [LICENSE](LICENSE) for details.
 
 Work Please is a TypeScript implementation based on the
 [Symphony specification](vendor/symphony/SPEC.md) by OpenAI (Apache 2.0).