cowork-flow 0.0.24 → 0.0.26

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cowork-flow",
-  "version": "0.0.24",
+  "version": "0.0.26",
   "description": "CLI for installing and maintaining cowork-flow collaboration templates.",
   "type": "module",
   "bin": {

package/template/.agents/skills/party-mode/SKILL.md

@@ -20,7 +20,7 @@ Use this skill as a manual advisory roundtable. Coordinate true child agents, no
 Built-in defaults:
 
 - `max_agents=3`
-- `max_rounds=3`
+- `max_rounds=5`
 
 These defaults are configurable values, not hard-coded constants. Effective config order:
 
@@ -35,7 +35,7 @@ Configurable fields:
 - agent roster or review lenses
 - report enabled
 - report path
-- whether round 2 or round 3 is allowed
+- round phase policy, including when challenge may continue and when convergence must begin
 
 Safety gates:
 
@@ -47,10 +47,14 @@ Safety gates:
 ## Round Model
 
 1. Frame the question, decision needed, scope, and evidence packet.
-2. Round 1 uses fresh child contexts. Send each child the same packet and one lens. Child agents cannot see each other.
-3. Synthesize only evidence-backed positions, disagreements, rejected options, and acceptance signals.
-4. Continue only when a continue condition is met. Send narrow follow-up prompts to the smallest useful set of children.
-5. Stop when any stop condition is met. Close all live children through the Host Adapter close primitive.
+2. Select the smallest useful agent roster or review lenses within effective `max_agents`. Record why each selected voice is useful and why omitted voices are not needed.
+3. Round 1 uses fresh child contexts. Send each child the same packet and one lens. Child agents cannot see each other.
+4. Synthesize evidence-backed positions into a compact claim table: `claim_id`, owner, claim, evidence, counterclaim, evidence gap, and decision impact.
+5. Continue only when a continue condition is met. Send narrow follow-up prompts to the smallest useful set of children, and bind each prompt to one `claim_id`.
+6. Follow-up rounds should prefer the same live child that produced or challenged the relevant position. Send only the target claim, counterclaim, evidence gap, and ask the child to `agree`, `reject`, or `revise`.
+7. For Challenge rounds, the default stance is scrutiny. Test the opposing claim first; choose `agree` only after naming the evidence that compels agreement.
+8. Spawn an extra child only when the effective roster or lens config allows it, a live child failed, or the user approves expansion.
+9. Stop when any stop condition is met and no dispatched child is still running. Then close live children through the Host Adapter close primitive.
 
 Round intent:
 
@@ -61,10 +65,10 @@ Round intent:
 Default mapping:
 
 - Round 1 = Opening.
-- Round 2 = Challenge.
-- Round 3+ = Convergence.
+- Round 2+ = Challenge while continue conditions still expose material disagreement, material risk, missing evidence, or untestable acceptance criteria.
+- Convergence begins when the coordinator can write one recommended direction and no material challenge condition remains.
 
-Only the user can restart exploration after convergence begins.
+After convergence begins, do not reopen exploration unless the user approves or new concrete evidence appears.
 
 ## Continue Conditions
 
@@ -86,6 +90,13 @@ Stop when any condition holds:
 - Effective `max_rounds` is reached.
 - Output fails schema, and one repair prompt does not fix it.
 
+## Waiting Children
+
+- A wait timeout is not a child timeout.
+- If a child remains live after a wait timeout, wait again or report it in `pending_children`.
+- Do not close, cancel, omit, or synthesize around a live child unless the user explicitly asks to close it.
+- When the discussion has converged or the user ends it, close live children after their final output is recorded.
+
 ## Child Output Schema
 
 Each child must return these core fields. Extra fields are allowed only after them.
@@ -100,6 +111,18 @@ acceptance_signal:
 what_would_change_my_mind:
 ```
 
+Follow-up rounds may add these fields after the core fields:
+
+```text
+claim_id:
+responding_to:
+opposing_claim:
+position_delta:
+evidence_delta:
+still_disagree:
+```
+
+Use `position_delta` to say whether the child maintained, narrowed, or changed its position.
 Reject unsupported opinion. Evidence should name files, commands, rules, observed behavior, user scenarios, or concrete assumptions.
 
 ## Coordinator Output Schema
@@ -107,6 +130,13 @@ Reject unsupported opinion. Evidence should name files, commands, rules, observe
 Final synthesis must return these core fields. Extra fields are allowed only after them.
 
 ```text
+effective_max_agents:
+effective_max_rounds:
+rounds_used:
+selected_agents:
+claim_table:
+agent_turns:
+pending_children:
 consensus:
 disagreements:
 evidence:
@@ -114,7 +144,8 @@ decision:
 rejected_options:
 acceptance_criteria:
 open_questions:
+early_stop_reason:
 stop_reason:
 ```
 
-Keep the final decision traceable to child evidence. Do not count votes as validation.
+`selected_agents` must include the selected agent or lens names and selection reasons. `agent_turns` should preserve a compact transcript with round, agent or lens, `claim_id`, position, and `position_delta`. Keep the final decision traceable to child evidence. Do not count votes as validation.

package/template/.claude/skills/party-mode/SKILL.md

@@ -20,7 +20,7 @@ Use this skill as a manual advisory roundtable. Coordinate true child agents, no
 Built-in defaults:
 
 - `max_agents=3`
-- `max_rounds=3`
+- `max_rounds=5`
 
 These defaults are configurable values, not hard-coded constants. Effective config order:
 
@@ -35,7 +35,7 @@ Configurable fields:
 - agent roster or review lenses
 - report enabled
 - report path
-- whether round 2 or round 3 is allowed
+- round phase policy, including when challenge may continue and when convergence must begin
 
 Safety gates:
 
@@ -47,10 +47,14 @@ Safety gates:
 ## Round Model
 
 1. Frame the question, decision needed, scope, and evidence packet.
-2. Round 1 uses fresh child contexts. Send each child the same packet and one lens. Child agents cannot see each other.
-3. Synthesize only evidence-backed positions, disagreements, rejected options, and acceptance signals.
-4. Continue only when a continue condition is met. Send narrow follow-up prompts to the smallest useful set of children.
-5. Stop when any stop condition is met. Close all live children through the Host Adapter close primitive.
+2. Select the smallest useful agent roster or review lenses within effective `max_agents`. Record why each selected voice is useful and why omitted voices are not needed.
+3. Round 1 uses fresh child contexts. Send each child the same packet and one lens. Child agents cannot see each other.
+4. Synthesize evidence-backed positions into a compact claim table: `claim_id`, owner, claim, evidence, counterclaim, evidence gap, and decision impact.
+5. Continue only when a continue condition is met. Send narrow follow-up prompts to the smallest useful set of children, and bind each prompt to one `claim_id`.
+6. Follow-up rounds should prefer the same live child that produced or challenged the relevant position. Send only the target claim, counterclaim, evidence gap, and ask the child to `agree`, `reject`, or `revise`.
+7. For Challenge rounds, the default stance is scrutiny. Test the opposing claim first; choose `agree` only after naming the evidence that compels agreement.
+8. Spawn an extra child only when the effective roster or lens config allows it, a live child failed, or the user approves expansion.
+9. Stop when any stop condition is met and no dispatched child is still running. Then close live children through the Host Adapter close primitive.
 
 Round intent:
 
@@ -61,10 +65,10 @@ Round intent:
 Default mapping:
 
 - Round 1 = Opening.
-- Round 2 = Challenge.
-- Round 3+ = Convergence.
+- Round 2+ = Challenge while continue conditions still expose material disagreement, material risk, missing evidence, or untestable acceptance criteria.
+- Convergence begins when the coordinator can write one recommended direction and no material challenge condition remains.
 
-Only the user can restart exploration after convergence begins.
+After convergence begins, do not reopen exploration unless the user approves or new concrete evidence appears.
 
 ## Continue Conditions
 
@@ -86,6 +90,13 @@ Stop when any condition holds:
 - Effective `max_rounds` is reached.
 - Output fails schema, and one repair prompt does not fix it.
 
+## Waiting Children
+
+- A wait timeout is not a child timeout.
+- If a child remains live after a wait timeout, wait again or report it in `pending_children`.
+- Do not close, cancel, omit, or synthesize around a live child unless the user explicitly asks to close it.
+- When the discussion has converged or the user ends it, close live children after their final output is recorded.
+
 ## Child Output Schema
 
 Each child must return these core fields. Extra fields are allowed only after them.
@@ -100,6 +111,18 @@ acceptance_signal:
 what_would_change_my_mind:
 ```
 
+Follow-up rounds may add these fields after the core fields:
+
+```text
+claim_id:
+responding_to:
+opposing_claim:
+position_delta:
+evidence_delta:
+still_disagree:
+```
+
+Use `position_delta` to say whether the child maintained, narrowed, or changed its position.
 Reject unsupported opinion. Evidence should name files, commands, rules, observed behavior, user scenarios, or concrete assumptions.
 
 ## Coordinator Output Schema
@@ -107,6 +130,13 @@ Reject unsupported opinion. Evidence should name files, commands, rules, observe
 Final synthesis must return these core fields. Extra fields are allowed only after them.
 
 ```text
+effective_max_agents:
+effective_max_rounds:
+rounds_used:
+selected_agents:
+claim_table:
+agent_turns:
+pending_children:
 consensus:
 disagreements:
 evidence:
@@ -114,7 +144,8 @@ decision:
 rejected_options:
 acceptance_criteria:
 open_questions:
+early_stop_reason:
 stop_reason:
 ```
 
-Keep the final decision traceable to child evidence. Do not count votes as validation.
+`selected_agents` must include the selected agent or lens names and selection reasons. `agent_turns` should preserve a compact transcript with round, agent or lens, `claim_id`, position, and `position_delta`. Keep the final decision traceable to child evidence. Do not count votes as validation.

package/template/.cowork-flow/.version

@@ -1 +1 @@
-0.0.24
+0.0.26

package/template/.cowork-flow/scripts/common/active_task.py

@@ -66,6 +66,10 @@ def resolve_context_key(values: Mapping[str, object] | None = None) -> str | Non
     if claude_session and claude_session.strip():
         return f"claude_{_sanitize(claude_session)}"
 
+    claude_code_session = os.environ.get("CLAUDE_CODE_SESSION_ID")
+    if claude_code_session and claude_code_session.strip():
+        return f"claude_{_sanitize(claude_code_session)}"
+
     codex_session = os.environ.get("CODEX_SESSION_ID")
     if codex_session and codex_session.strip():
         return f"codex_{_sanitize(codex_session)}"
@@ -90,6 +94,8 @@ def resolve_context_key(values: Mapping[str, object] | None = None) -> str | Non
         (
             "OPENCODE_SESSION_ID",
             "opencode_session_id",
+            "sessionID",
+            "sessionId",
         ),
     )
     if input_opencode_session:
@@ -100,6 +106,8 @@ def resolve_context_key(values: Mapping[str, object] | None = None) -> str | Non
         (
             "CLAUDE_SESSION_ID",
             "claude_session_id",
+            "CLAUDE_CODE_SESSION_ID",
+            "claude_code_session_id",
         ),
     )
     if input_claude_session:

package/template/.cowork-flow/scripts/subagent.py

@@ -253,6 +253,7 @@ def build_parser() -> argparse.ArgumentParser:
     init.add_argument("--title", required=True)
     init.add_argument("--role", default="subagent")
     init.add_argument("--agent-type")
+    init.add_argument("--execution-task-dir", default=argparse.SUPPRESS)
     init.add_argument("--source", default="auto")
     init.add_argument("--goal")
     init.add_argument("--expected-output", default="Files changed, validation commands, and blockers.")

package/template/.cowork-flow/scripts/task.py

@@ -931,7 +931,7 @@ def cmd_start(args: argparse.Namespace) -> int:
     if active is None:
         print(
             colored(
-                "Error: Missing session context. Set COWORK_FLOW_CONTEXT_ID or run inside Codex session.",
+                "Error: Missing session context. Set COWORK_FLOW_CONTEXT_ID or run inside a supported host session.",
                 Colors.RED,
             ),
             file=sys.stderr,
@@ -1011,7 +1011,7 @@ def cmd_current(args: argparse.Namespace) -> int:
     if not active.context_key:
         print(
             colored(
-                "Error: Missing session context. Set COWORK_FLOW_CONTEXT_ID or run inside Codex session.",
+                "Error: Missing session context. Set COWORK_FLOW_CONTEXT_ID or run inside a supported host session.",
                 Colors.RED,
             ),
             file=sys.stderr,

package/template/.opencode/plugins/cowork-flow.js

@@ -202,15 +202,47 @@ function resolveRuntimeContextId(input) {
   return match ? sanitize(match[1]) : null
 }
 
+function resolveOpenCodeSessionId(input) {
+  const direct = firstString(input, [
+    "OPENCODE_SESSION_ID",
+    "opencode_session_id",
+    "sessionID",
+    "sessionId",
+    "session_id",
+  ])
+  if (direct) {
+    return sanitize(direct)
+  }
+  const nested = firstString(input?.session, ["id", "sessionID", "sessionId", "session_id"])
+  return nested ? sanitize(nested) : null
+}
+
 function resolveContextKey(input) {
   const explicit = firstString(input, ["COWORK_FLOW_CONTEXT_ID", "cowork_flow_context_id", "context_id"])
   if (explicit) {
     return sanitize(explicit)
   }
-  const opencodeSession = firstString(input, ["OPENCODE_SESSION_ID", "opencode_session_id", "session_id"])
+  const opencodeSession = resolveOpenCodeSessionId(input)
   return opencodeSession ? `opencode_${sanitize(opencodeSession)}` : null
 }
 
+function injectShellEnv(input, output) {
+  const contextKey = resolveContextKey(input)
+  if (!contextKey) {
+    return
+  }
+  if (!output.env || typeof output.env !== "object") {
+    output.env = {}
+  }
+  if (!output.env.COWORK_FLOW_CONTEXT_ID) {
+    output.env.COWORK_FLOW_CONTEXT_ID = contextKey
+  }
+  const opencodeSession = resolveOpenCodeSessionId(input)
+  if (opencodeSession && !output.env.OPENCODE_SESSION_ID) {
+    output.env.OPENCODE_SESSION_ID = opencodeSession
+  }
+}
+
 function resolveHostContextKey(input) {
   const direct = firstString(input, ["cowork_host_context_key", "host_context_key", "COWORK_FLOW_HOST_CONTEXT_KEY"])
   if (direct) {
@@ -310,6 +342,9 @@ function buildRuntimeWorkflowState(input) {
 
 export const CoworkFlowPlugin = async () => {
   return {
+    "shell.env": async (input, output) => {
+      injectShellEnv(input, output)
+    },
     "experimental.chat.system.transform": async (input, output) => {
       output.system.push([buildContractDigest(input), buildRuntimeWorkflowState(input)].filter(Boolean).join("\n\n"))
     },