@pleaseai/work 0.1.5 → 0.1.6

package/README.md

@@ -165,6 +165,7 @@ agent:
 
 claude:
   permission_mode: acceptEdits
+  # setting_sources: []               # default: [project, local, user]; set [] for SDK isolation mode
   turn_timeout_ms: 3600000
 ---
 
@@ -224,6 +225,7 @@ agent:
 
 claude:
   permission_mode: acceptEdits
+  # setting_sources: []               # default: [project, local, user]; set [] for SDK isolation mode
   turn_timeout_ms: 3600000
 ---
 
@@ -287,6 +289,7 @@ agent:
 
 claude:
   permission_mode: acceptEdits
+  # setting_sources: []               # default: [project, local, user]; set [] for SDK isolation mode
   turn_timeout_ms: 3600000
 ---
 
@@ -394,9 +397,18 @@ claude:
     - Read
     - Write
     - Bash
+  setting_sources:                    # Optional: filesystem settings to load. Default: [project, local, user]
+    - project                         # load .claude/settings.json + CLAUDE.md from the workspace directory
+    - local                           # load .claude/settings.local.json from the workspace directory
+    - user                            # load ~/.claude/settings.json + global CLAUDE.md
+                                      # Only "project", "local", and "user" are valid — other values are ignored
   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
+  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.
 
 server:
   port: 3000                          # Optional: enable HTTP dashboard on this port

package/dist/index.js

@@ -2166,7 +2166,7 @@ var {
 var package_default = {
   name: "@pleaseai/work",
   type: "module",
-  version: "0.1.5",
+  version: "0.1.6",
   description: "Symphony-spec orchestrator for Claude Code + Asana/GitHub Projects v2",
   license: "FSL-1.1-MIT",
   repository: {
@@ -3088,6 +3088,13 @@ agent:
   max_turns: 20
 claude:
   permission_mode: bypassPermissions
+# claude.settings controls the attribution text written into .claude/settings.local.json
+# of each workspace. Omit to use the default Work Please attribution.
+# claude:
+#   settings:
+#     attribution:
+#       commit: "\uD83D\uDE4F Generated with Work Please"
+#       pr: "\uD83D\uDE4F Generated with Work Please"
 # server:
 #   port: 3000
 ---
@@ -31679,7 +31686,11 @@ function createToolsMcpServer(config2) {
 }
 
 // src/agent-runner.ts
+var UUID_PATTERN = /^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/i;
+var NEWLINE_PATTERN = /[\r\n]/g;
+
 class AppServerClient {
+  assignedSessionId = null;
   sessionId = null;
   abortController = null;
   workspace;
@@ -31690,11 +31701,20 @@ class AppServerClient {
     this.workspace = workspace;
     this.queryFn = queryFn;
   }
-  async startSession() {
+  async startSession(sessionId) {
+    this.assignedSessionId = null;
+    this.sessionId = null;
+    if (sessionId !== undefined && !UUID_PATTERN.test(sessionId)) {
+      const preview = String(sessionId).slice(0, 64).replace(NEWLINE_PATTERN, " ");
+      return new Error(`invalid_session_id: expected UUID format, got "${preview}"`);
+    }
     const validationErr = this.validateWorkspaceCwd();
     if (validationErr)
       return validationErr;
-    return { threadId: randomUUID(), workspace: this.workspace };
+    const id = sessionId ?? randomUUID();
+    this.assignedSessionId = id;
+    this.sessionId = sessionId ?? null;
+    return { sessionId: id, workspace: this.workspace };
   }
   async runTurn(session, prompt, _issue, onMessage) {
     const controller = new AbortController;
@@ -31713,6 +31733,8 @@ class AppServerClient {
     }
     if (this.sessionId) {
       options.resume = this.sessionId;
+    } else if (this.assignedSessionId) {
+      options.sessionId = this.assignedSessionId;
     }
     if (this.config.claude.command !== "claude") {
       options.pathToClaudeCodeExecutable = this.config.claude.command;
@@ -31720,12 +31742,21 @@ class AppServerClient {
     if (this.config.claude.model) {
       options.model = this.config.claude.model;
     }
+    const sp = this.config.claude.system_prompt;
+    if (sp.type === "custom") {
+      options.systemPrompt = sp.value;
+    } else {
+      options.systemPrompt = sp;
+    }
     const toolSpecs = getToolSpecs(this.config);
     if (toolSpecs.length > 0) {
       options.mcpServers = {
         "work-please-tools": createToolsMcpServer(this.config)
       };
     }
+    if (this.config.claude.setting_sources.length > 0) {
+      options.settingSources = this.config.claude.setting_sources;
+    }
     const turnId = randomUUID();
     let sessionId = null;
     let gotError = false;
@@ -31737,11 +31768,11 @@ class AppServerClient {
           const initMsg = msg;
           sessionId = initMsg.session_id;
           this.sessionId = sessionId;
+          this.assignedSessionId = null;
           onMessage({
             event: "session_started",
             timestamp: new Date,
             session_id: sessionId,
-            thread_id: session.threadId,
             turn_id: turnId
           });
         } else if (msg.type === "result") {
@@ -31794,12 +31825,18 @@ class AppServerClient {
         });
         return err;
       }
-      return { thread_id: session.threadId, turn_id: turnId, session_id: sessionId };
+      return { turn_id: turnId, session_id: sessionId };
     } catch (err) {
       clearTimeout(timeoutHandle);
       const error48 = err instanceof Error ? err : new Error(String(err));
+      if (!sessionId) {
+        if (!options.resume) {
+          this.sessionId = null;
+          this.assignedSessionId = null;
+        }
+      }
       onMessage({
-        event: "startup_failed",
+        event: sessionId ? "turn_failed" : "startup_failed",
         timestamp: new Date,
         payload: { reason: error48.message }
       });
@@ -31808,6 +31845,7 @@ class AppServerClient {
   }
   stopSession() {
     this.abortController?.abort();
+    this.assignedSessionId = null;
     this.sessionId = null;
     this.abortController = null;
   }
@@ -31828,6 +31866,7 @@ import { tmpdir } from "os";
 import { join, sep as sep2 } from "path";
 import process4 from "process";
 var ENV_VAR_RE = /^\$([A-Z_]\w*)$/i;
+var VALID_SETTING_SOURCES = new Set(["user", "project", "local"]);
 var DEFAULTS2 = {
   POLL_INTERVAL_MS: 30000,
   WORKSPACE_ROOT: join(tmpdir(), "work-please_workspaces"),
@@ -31838,6 +31877,7 @@ var DEFAULTS2 = {
   CLAUDE_COMMAND: "claude",
   CLAUDE_PERMISSION_MODE: "bypassPermissions",
   CLAUDE_ALLOWED_TOOLS: [],
+  CLAUDE_SETTING_SOURCES: ["project", "local", "user"],
   CLAUDE_TURN_TIMEOUT_MS: 3600000,
   CLAUDE_READ_TIMEOUT_MS: 5000,
   CLAUDE_STALL_TIMEOUT_MS: 300000,
@@ -31879,20 +31919,33 @@ function buildConfig(workflow) {
       max_retry_backoff_ms: posIntValue(agent.max_retry_backoff_ms, DEFAULTS2.MAX_RETRY_BACKOFF_MS),
       max_concurrent_agents_by_state: stateLimitsValue(agent.max_concurrent_agents_by_state)
     },
-    claude: {
-      model: stringValue(claude.model),
-      command: commandValue(claude.command) ?? DEFAULTS2.CLAUDE_COMMAND,
-      permission_mode: stringValue(claude.permission_mode) ?? DEFAULTS2.CLAUDE_PERMISSION_MODE,
-      allowed_tools: stringArrayValue(claude.allowed_tools, DEFAULTS2.CLAUDE_ALLOWED_TOOLS),
-      turn_timeout_ms: intValue(claude.turn_timeout_ms, DEFAULTS2.CLAUDE_TURN_TIMEOUT_MS),
-      read_timeout_ms: intValue(claude.read_timeout_ms, DEFAULTS2.CLAUDE_READ_TIMEOUT_MS),
-      stall_timeout_ms: intValue(claude.stall_timeout_ms, DEFAULTS2.CLAUDE_STALL_TIMEOUT_MS)
-    },
+    claude: buildClaudeConfig(claude),
     server: {
       port: nonNegIntOrNull(server.port)
     }
   };
 }
+function buildClaudeConfig(claude) {
+  const settingsSec = sectionMap(claude, "settings");
+  const attributionSec = sectionMap(settingsSec, "attribution");
+  return {
+    model: stringValue(claude.model),
+    command: commandValue(claude.command) ?? DEFAULTS2.CLAUDE_COMMAND,
+    permission_mode: stringValue(claude.permission_mode) ?? DEFAULTS2.CLAUDE_PERMISSION_MODE,
+    allowed_tools: stringArrayValue(claude.allowed_tools, DEFAULTS2.CLAUDE_ALLOWED_TOOLS),
+    setting_sources: stringArrayValue(claude.setting_sources, DEFAULTS2.CLAUDE_SETTING_SOURCES).filter((s2) => VALID_SETTING_SOURCES.has(s2)),
+    turn_timeout_ms: intValue(claude.turn_timeout_ms, DEFAULTS2.CLAUDE_TURN_TIMEOUT_MS),
+    read_timeout_ms: intValue(claude.read_timeout_ms, DEFAULTS2.CLAUDE_READ_TIMEOUT_MS),
+    stall_timeout_ms: intValue(claude.stall_timeout_ms, DEFAULTS2.CLAUDE_STALL_TIMEOUT_MS),
+    system_prompt: systemPromptValue(claude.system_prompt),
+    settings: {
+      attribution: {
+        commit: stringValue(attributionSec.commit),
+        pr: stringValue(attributionSec.pr)
+      }
+    }
+  };
+}
 function buildTrackerConfig(kind, tracker) {
   const label_prefix = stringValue(tracker.label_prefix) ?? null;
   const filter = buildFilterConfig(sectionMap(tracker, "filter"));
@@ -32006,6 +32059,26 @@ function maxConcurrentForState(config2, state) {
   const byState = config2.agent.max_concurrent_agents_by_state;
   return byState[normalized] ?? config2.agent.max_concurrent_agents;
 }
+var DEFAULT_SYSTEM_PROMPT = { type: "preset", preset: "claude_code" };
+function systemPromptValue(val) {
+  if (val == null)
+    return DEFAULT_SYSTEM_PROMPT;
+  if (typeof val === "string") {
+    const trimmed = val.trim();
+    return trimmed ? { type: "custom", value: trimmed } : DEFAULT_SYSTEM_PROMPT;
+  }
+  if (typeof val === "object" && !Array.isArray(val)) {
+    const obj = val;
+    if (obj.type === "preset" && obj.preset === "claude_code") {
+      return typeof obj.append === "string" ? { type: "preset", preset: "claude_code", append: obj.append } : { type: "preset", preset: "claude_code" };
+    }
+    if (obj.type === "custom" && typeof obj.value === "string") {
+      const trimmed = obj.value.trim();
+      return trimmed ? { type: "custom", value: trimmed } : DEFAULT_SYSTEM_PROMPT;
+    }
+  }
+  return DEFAULT_SYSTEM_PROMPT;
+}
 function sectionMap(raw, key) {
   const val = raw[key];
   return val && typeof val === "object" && !Array.isArray(val) ? val : {};
@@ -32070,7 +32143,7 @@ function csvValue(val) {
 function stringArrayValue(val, fallback) {
   if (!Array.isArray(val))
     return fallback;
-  return val.filter((v) => typeof v === "string");
+  return val.filter((v) => typeof v === "string" && v.trim().length > 0);
 }
 function stateLimitsValue(val) {
   if (!val || typeof val !== "object" || Array.isArray(val))
@@ -40173,9 +40246,28 @@ function isWorkflowError(result) {
 }
 
 // src/workspace.ts
-import { existsSync as existsSync4, lstatSync as lstatSync2, mkdirSync as mkdirSync2, rmSync as rmSync2, statSync as statSync3 } from "fs";
-import { join as join4, resolve as resolve4, sep as sep4 } from "path";
+import { existsSync as existsSync4, lstatSync as lstatSync2, mkdirSync as mkdirSync2, rmSync as rmSync2, statSync as statSync3, writeFileSync as writeFileSync2 } from "fs";
+import { dirname as dirname2, join as join4, resolve as resolve4, sep as sep4 } from "path";
 import process6 from "process";
+var CLAUDE_SETTINGS_PATH = ".claude/settings.local.json";
+var WORK_PLEASE_URL = "https://github.com/pleaseai/work-please";
+var ATTRIBUTION_TEXT = `\uD83D\uDE4F Generated with [Work Please](${WORK_PLEASE_URL})`;
+function generateClaudeSettings(attribution) {
+  return `${JSON.stringify({
+    attribution: {
+      commit: attribution?.commit ?? ATTRIBUTION_TEXT,
+      pr: attribution?.pr ?? ATTRIBUTION_TEXT
+    }
+  }, null, 2)}
+`;
+}
+function ensureClaudeSettings(wsPath, attribution) {
+  const settingsPath = join4(wsPath, CLAUDE_SETTINGS_PATH);
+  if (existsSync4(settingsPath))
+    return;
+  mkdirSync2(dirname2(settingsPath), { recursive: true });
+  writeFileSync2(settingsPath, generateClaudeSettings(attribution), "utf-8");
+}
 var _git = {
   spawnSync: (args) => Bun.spawnSync(args)
 };
@@ -40308,6 +40400,11 @@ async function createWorkspace(config2, identifier, issue2) {
         if (hookErr)
           return hookErr;
       }
+      try {
+        ensureClaudeSettings(wtPath, config2.claude.settings.attribution);
+      } catch (err) {
+        return err instanceof Error ? err : new Error(String(err));
+      }
       return { path: wtPath, workspace_key: key, created_now: createdNow };
     }
   }
@@ -40338,6 +40435,11 @@ async function createWorkspace(config2, identifier, issue2) {
     if (hookErr)
       return hookErr;
   }
+  try {
+    ensureClaudeSettings(wsPath, config2.claude.settings.attribution);
+  } catch (err) {
+    return err instanceof Error ? err : new Error(String(err));
+  }
   return workspace;
 }
 async function removeWorkspace(config2, identifier, issue2) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pleaseai/work",
   "type": "module",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Symphony-spec orchestrator for Claude Code + Asana/GitHub Projects v2",
   "license": "FSL-1.1-MIT",
   "repository": {