@nanmicoder/dsh-agent-teams 0.1.17 → 0.1.19

package/lib/types/event-types.d.ts

@@ -52,6 +52,15 @@ export interface AgentTeamsTaskUpdatedData {
     readonly verdict?: string;
     readonly round?: number;
 }
+/** Records one captain-only contract amendment on a task. */
+export interface AgentTeamsTaskAmendedData {
+    readonly teamId: string;
+    readonly taskId: string;
+    /** Amended contract field names (`objective`, `inScope`, …). */
+    readonly fields: readonly string[];
+    /** Why the previous contract was wrong. */
+    readonly reason: string;
+}
 /** Records a human halt from the captain chat. */
 export interface AgentTeamsTeamHaltedData {
     readonly teamId: string;
@@ -108,6 +117,11 @@ declare module '@deepseek-ai/dsh-session/types' {
          * @param data - team identity, task id, and the new status/assignee/output.
          */
         'agent-teams/task-updated': AgentTeamsTaskUpdatedData;
+        /**
+         * Records one captain-only contract amendment.
+         * @param data - team identity, task id, amended field names, and reason.
+         */
+        'agent-teams/task-amended': AgentTeamsTaskAmendedData;
         /**
          * Records one mailbox message.
          * @param data - team identity, sender, recipient, and content.
@@ -136,4 +150,4 @@ declare module '@deepseek-ai/dsh-session/types' {
     }
 }
 /** The full set of `agent-teams/*` event names. */
-export type AgentTeamsEventType = 'agent-teams/team-created' | 'agent-teams/member-added' | 'agent-teams/member-removed' | 'agent-teams/task-created' | 'agent-teams/task-updated' | 'agent-teams/message-sent' | 'agent-teams/team-halted' | 'agent-teams/team-resumed' | 'agent-teams/team-deleted' | 'agent-teams/plan-discarded';
+export type AgentTeamsEventType = 'agent-teams/team-created' | 'agent-teams/member-added' | 'agent-teams/member-removed' | 'agent-teams/task-created' | 'agent-teams/task-updated' | 'agent-teams/task-amended' | 'agent-teams/message-sent' | 'agent-teams/team-halted' | 'agent-teams/team-resumed' | 'agent-teams/team-deleted' | 'agent-teams/plan-discarded';

package/lib/types/harness-compat.d.ts

@@ -18,6 +18,52 @@ export declare function sessionOwnEvents(session: Session): readonly SessionEven
 export declare function installContinuableMemberSetup(ctx: Context, setup: Setup): void;
 /** Queue a distinct host-authored turn; never substitute model-message steer. */
 export declare function queueMemberPrompt(runtime: Context['subagents'], parent: Agent, childId: SessionId, content: ContentBlock[], signal: AbortSignal): Promise<MessageId>;
+/** Coordination joins the nearest step, including waking an idle/cold child. */
+export declare function steerMemberPrompt(runtime: Context['subagents'], parent: Agent, childId: SessionId, content: ContentBlock[], signal: AbortSignal, live?: Agent): Promise<MessageId>;
 /** Guard all resumable delivery paths, preserving the native service receiver. */
 export declare function guardSubagentDelivery(ctx: Context, isRetired: (sender: Agent, targetId: SessionId) => Promise<boolean>): void;
+/**
+ * Names the host's `tools.restrict()` would admit for this agent's layer
+ * chain, or undefined when the host does not expose its registry view.
+ * restrict() rejects unknown names with a hard error, so the spawn path must
+ * check entries against this view before forwarding them. Source:
+ * dsh-tools view()/restrict() in 0.1.5-rc.1; older Harness generations lack
+ * the surface and keep the verbatim list.
+ */
+export declare function restrictableToolNames(agent: Agent): ReadonlySet<string> | undefined;
+/**
+ * Member `toolFilter` for one spawn. Captain-only names are registered by
+ * this plugin itself and always resolvable; the depth-related entries name
+ * HOST tools and are only known under some compositions, so they must be
+ * resolved against the running host's registry: the delegation tool name is
+ * host configuration (dsh-tool-subagent `toolName`, default `subagent`,
+ * renamed per composition, e.g. `subagent_fork` in web-style profiles), and
+ * forwarding a name the host dropped aborts every member spawn (#163, #164).
+ * Depth enforcement itself does not depend on these names —
+ * installMemberDelegationGuard bounds descendant creation by parent chain.
+ */
+export declare function memberToolFilter(maxDepth: number | undefined, knownTools: ReadonlySet<string> | undefined): {
+    deny: string[];
+};
+/**
+ * Start one member, dropping any filter name the host reports as unknown and
+ * retrying.
+ *
+ * Resolving the filter against the registry view ({@link memberToolFilter})
+ * only covers hosts that expose one. A rejected filter still leaves the member
+ * without a session for the lifetime of the team, so the start must survive the
+ * cases that resolution cannot see — no registry view, a name that is known but
+ * not restrictable, a composition that mounted differently than expected. The
+ * host names the offenders in its rejection, so they are removed and the start
+ * retried; the retry only runs while the deny list strictly shrinks, and any
+ * failure that is not an unknown-name report propagates untouched.
+ * @param start - performs one start attempt for the given `toolFilter`.
+ * @param filter - the filter to attempt first.
+ * @returns the started member.
+ */
+export declare function startMemberWithLenientFilter<T>(start: (filter: {
+    deny: string[];
+}) => Promise<T>, filter: {
+    deny: string[];
+}): Promise<T>;
 export {};

package/lib/types/index.d.ts

@@ -38,7 +38,7 @@ export interface Config {
     executionPrompt?: string;
     /** Plugin-wide fallback route for unavailable member models. */
     fallback?: import('./profiles.ts').TeamModelFallbackConfig;
-    /** Member delegation depth cap (default `1`; `0` forbids delegation entirely). */
+    /** Member delegation depth cap (default `0`; `0` forbids delegation entirely). */
     memberMaxDepth?: number;
     /** Team size cap in members (default `8`). */
     maxMembers?: number;

package/lib/types/mailbox.d.ts

@@ -0,0 +1,7 @@
+/** Durable delivery receipts and execution-generation filtering at step admission. */
+import type { Context } from '@deepseek-ai/cordis';
+import type { TeamMessage, TeamState } from './types.ts';
+export declare function isCurrentMail(team: TeamState, message: TeamMessage): boolean;
+export declare function mailboxPrompt(teamId: string, recipient: string, messages: readonly TeamMessage[]): string;
+/** Only messages actually admitted to this recipient's step become read. */
+export declare function installMailboxAdmission(ctx: Context, stateDir: string): void;

package/lib/types/members.d.ts

@@ -1,6 +1,6 @@
 /**
  * Member subagent lifecycle: spawn a continuable child per member, deliver
- * messages into its FIFO inbox, and observe its activity.
+ * task turns and step-boundary messages, and observe its activity.
  *
  * Members are durable continuable subagents of the captain, so a member keeps
  * its conversation across turns and across harness restarts: the captain
@@ -92,7 +92,7 @@ export declare function selectFallbackRoute(current: {
     };
 };
 /** Deliver a durable member report to the live captain at its next model step. */
-export declare function steerCaptainReport(captain: Pick<Agent, 'steer'>, from: string, content: string): boolean;
+export declare function steerCaptainReport(captain: Pick<Agent, 'steer'>, from: string, content: string, receipt?: string): boolean;
 interface FailedMemberAttempt {
     readonly captainSessionId: string;
     readonly memberId: string;
@@ -151,7 +151,7 @@ export declare function memberWelcome(team: TeamState, memberName: string): stri
  * @param stateDir - configured state directory (for the persona).
  * @param signal - caller cancellation, forwarded to the start.
  */
-export declare function spawnMember(ctx: Context, config: MemberRuntimeConfig, selections: MemberSelectionRuntime, llmSelection: MemberLlmSelection, captain: Agent, team: TeamState, member: TeamMember, stateDir: string, signal: AbortSignal): Promise<void>;
+export declare function spawnMember(ctx: Context, config: MemberRuntimeConfig, selections: MemberSelectionRuntime, llmSelection: MemberLlmSelection, captain: Agent, team: TeamState, member: TeamMember, stateDir: string, signal: AbortSignal, initialPrompt?: string): Promise<void>;
 /**
  * Deliver one message to a member as its next FIFO turn. Best effort: a
  * failure (member gone or not continuable) is logged and reported as `false`
@@ -169,7 +169,7 @@ export declare function spawnMember(ctx: Context, config: MemberRuntimeConfig, s
  * @param signal - caller cancellation, forwarded to the delivery.
  * @returns whether the member inbox accepted the message.
  */
-export declare function deliverToMember(ctx: Context, captain: Agent, childId: string, text: string, signal: AbortSignal): Promise<boolean>;
+export declare function deliverToMember(ctx: Context, captain: Agent, childId: string, text: string, signal: AbortSignal, mode?: 'queue' | 'steer'): Promise<boolean>;
 /**
  * Request cancellation of one live member's current turn. Best effort, fire
  * and return; the target may keep running until it observes the signal.
@@ -191,6 +191,8 @@ export declare function interruptMember(ctx: Context, captain: Agent, childId: s
  * untouched while the delivery boundary still prevents further model turns.
  */
 export declare function installRetiredMemberGuard(ctx: Context, stateDir: string): void;
+/** Bound all descendant creation, including renamed tools and code-runtime calls. */
+export declare function installMemberDelegationGuard(ctx: Context, stateDir: string, maxDepth: number): void;
 /**
  * Snapshot the real driver activity for durable member ids.
  *

package/lib/types/quality-gates.d.ts

@@ -3,7 +3,7 @@
  * coverage, and resume. Tools and persistence call these; they do not I/O.
  * @module dsh-agent-teams/quality-gates
  */
-import { type AcceptanceResult, type CommandResult, type FindingSeverity, type ReviewFinding, type ReviewPolicy, type ReviewVerdict, type TaskKind, type TaskStatus, type TeamState, type TeamTask } from './types.ts';
+import { type AcceptanceResult, type CommandResult, type FindingSeverity, type ReviewFinding, type ReviewPolicy, type ReviewVerdict, type TaskKind, type TaskRevision, type TaskStatus, type TeamState, type TeamTask } from './types.ts';
 declare const QUALITY_KINDS: readonly TaskKind[];
 declare const WRITE_KINDS: readonly TaskKind[];
 declare const DEFAULT_REVIEW_POLICY: Required<Pick<ReviewPolicy, 'requirementsMinRounds' | 'requirementsMaxRounds' | 'codeMaxRounds' | 'maxRepairAttempts'>>;
@@ -121,6 +121,55 @@ export declare function collectChangedPaths(gitStatusText: string): string[];
 export declare function inScopeOverlap(left: readonly string[] | undefined, right: readonly string[] | undefined): string[];
 export declare function validateCreateTask(team: TeamState, input: CreateTaskInput): ValidateCreateTaskResult;
 export declare function evaluateQualityCompletion(task: TeamTask, update: QualityCompletionUpdate): QualityCompletionResult;
+/**
+ * Derive the repair round's inScope from the findings that caused it.
+ *
+ * `finding.file` records where the problem was OBSERVED, but the fix often
+ * targets a different file named in `requiredFix` (docs vs sample data,
+ * config vs code). Deriving the scope from both keeps the auto-generated
+ * repair contract satisfiable; deriving from `file` alone can produce a
+ * contract where the acceptance ("edit README.md") names a path the scope
+ * forbids, so no honest completion exists and the repair dead-locks.
+ *
+ * Absolute and otherwise illegal paths are dropped (they can never match
+ * workspace-relative scope patterns anyway); when nothing legal remains,
+ * the source task's own inScope is kept as the fallback. Over-inclusion is
+ * accepted: inScope is an audit upper bound, and the requiredFix text still
+ * tells the implementer what to touch.
+ *
+ * Keep all derived paths until the generator resolves inherited exclusions;
+ * filtering first would silently discard a required fix target.
+ */
+export declare function repairScopeFromFindings(findings: readonly ReviewFinding[], fallback: string[] | undefined): string[] | undefined;
+/** Captain-only amendment payload: replacement values for contract fields. */
+export interface ContractAmendmentInput {
+    objective?: string;
+    acceptance?: string[];
+    verify?: string[];
+    inScope?: string[];
+    outOfScope?: string[];
+}
+export interface AmendTaskContractResult {
+    ok: boolean;
+    error?: string;
+    task?: TeamTask;
+    revision?: TaskRevision;
+}
+/**
+ * Controlled contract amendment (the pure rule; tooling keeps it
+ * captain-only). When a quality contract is wrong — a verify command that
+ * cannot pass, an inScope that forbids the file the objective names — the
+ * worker has no honest completion and either dead-locks or games the gate.
+ * Instead the captain may fix the contract mid-flight: every amendment is
+ * recorded on the task as a {@link TaskRevision} (previous values + reason),
+ * and once a review/requirements task has passed judgment on this task the
+ * contract is frozen. Amendments replace whole fields (lists are full
+ * replacements, not deltas); the implementer re-reads the amended contract
+ * before its next quality gate. Completion gates need no special casing:
+ * they read the task's current fields, so they naturally evaluate the
+ * amended contract.
+ */
+export declare function amendTaskContract(team: TeamState, task: TeamTask, input: ContractAmendmentInput, by: string, reason: string): AmendTaskContractResult;
 export declare function planQualityFollowUp(team: TeamState, closed: TeamTask): PlanQualityFollowUpResult;
 export declare function buildCoverageMatrix(goalItems: readonly string[], tasks: readonly TeamTask[]): CoverageRow[];
 export declare function canDeclareDelivery(team: TeamState): DeliveryResult;
@@ -128,6 +177,7 @@ export declare function resumeTeamState(team: TeamState, reason: string): Resume
 export declare function isReviewFinding(value: unknown): value is ReviewFinding;
 export declare function isAcceptanceResult(value: unknown): value is AcceptanceResult;
 export declare function isCommandResult(value: unknown): value is CommandResult;
+export declare function isTaskRevision(value: unknown): value is TaskRevision;
 /**
  * Normalize blank optional task fields to omitted ("blank means absent").
  * Blank string scalars are deleted; string lists have blank entries filtered

package/lib/types/scheduler.d.ts

@@ -21,6 +21,7 @@ export declare const DEPENDENCY_OUTPUTS_TOTAL_MAX_CHARS = 12000;
 export interface SchedulerConfig {
     readonly stateDir: string;
     readonly executionPrompt?: string;
+    readonly dispatch?: (captain: Agent, teamId: string, memberName: string, text: string, signal: AbortSignal, mode: 'queue' | 'steer', attemptId?: string) => Promise<boolean>;
 }
 export interface TeamScheduler {
     /** Try to give every genuinely idle/ready member one unit of ready work. */

package/lib/types/state.d.ts

@@ -13,7 +13,8 @@
  * @module dsh-agent-teams/state
  */
 import { type TaskStatus, type TeamMessage, type TeamState, type TeamTask } from './types.ts';
-export { buildCoverageMatrix, canDeclareDelivery, classifyChangedPath, collectChangedPaths, defaultQualityDeliveryGraph, describeQualityLoop, evaluateQualityCompletion, hasValidQualityTaskFields, isQualityKind, normalizeBlankOptionalTaskFields, pathMatchesScope, planQualityFollowUp, qualityPlanningPrompt, resumeTeamState, sanitizeReviewAcceptance, sanitizeReviewObjective, taskKindOf, validateCreateTask, } from './quality-gates.ts';
+export { amendTaskContract, buildCoverageMatrix, canDeclareDelivery, classifyChangedPath, collectChangedPaths, defaultQualityDeliveryGraph, describeQualityLoop, evaluateQualityCompletion, hasValidQualityTaskFields, isQualityKind, isTaskRevision, normalizeBlankOptionalTaskFields, pathMatchesScope, planQualityFollowUp, qualityPlanningPrompt, resumeTeamState, sanitizeReviewAcceptance, sanitizeReviewObjective, taskKindOf, validateCreateTask, } from './quality-gates.ts';
+export type { ContractAmendmentInput } from './quality-gates.ts';
 /** Mailbox key of the captain. */
 export declare const CAPTAIN_KEY = "captain";
 /**
@@ -149,6 +150,8 @@ export declare function appendMailbox(stateRoot: string, teamId: string, agentKe
 export declare function readMailbox(stateRoot: string, teamId: string, agentKey: string, onMalformedLine?: (lineNumber: number, error: unknown) => void): Promise<TeamMessage[]>;
 /** Read only messages that have not been acknowledged by their recipient. */
 export declare function readUnreadMailbox(stateRoot: string, teamId: string, agentKey: string, onMalformedLine?: (lineNumber: number, error: unknown) => void): Promise<TeamMessage[]>;
+/** Pending delivery is distinct from delivered-but-not-yet-read input. */
+export declare function readPendingMailbox(stateRoot: string, teamId: string, agentKey: string): Promise<TeamMessage[]>;
 /** Lease selected fallback messages to one delivery path. */
 export declare function claimMailboxDelivery(stateRoot: string, teamId: string, agentKey: string, messageIds: readonly string[]): Promise<void>;
 /** Release a failed delivery lease so the scheduler can retry it later. */
@@ -158,6 +161,9 @@ export declare function releaseMailboxDelivery(stateRoot: string, teamId: string
  * malformed lines for diagnostics. Callers serialize this with the team lock.
  */
 export declare function acknowledgeMailbox(stateRoot: string, teamId: string, agentKey: string, messageIds: readonly string[]): Promise<void>;
+/** Acceptance by Harness is not evidence that a model step consumed input. */
+export declare function markMailboxDelivered(stateRoot: string, teamId: string, agentKey: string, ids: readonly string[]): Promise<void>;
+export declare function discardMailboxMessages(stateRoot: string, teamId: string, agentKey: string, ids: readonly string[]): Promise<void>;
 /** Filesystem primitives used by {@link replaceFileAtomicOrDirect}; injectable for tests. */
 export interface AtomicReplacePrimitives {
     rename: (from: string, to: string) => Promise<void>;

package/lib/types/tool-names.d.ts

@@ -1,4 +1,4 @@
 /** Stable business API names; exposure changes never rename these operations. */
-export declare const TEAM_TOOL_NAMES: readonly ["agent_teams_create", "agent_teams_approve", "agent_teams_edit_plan", "agent_teams_add_member", "agent_teams_remove_member", "agent_teams_create_task", "agent_teams_reassign_task", "agent_teams_claim_task", "agent_teams_update_task", "agent_teams_send_message", "agent_teams_status", "agent_teams_resume", "agent_teams_delete"];
+export declare const TEAM_TOOL_NAMES: readonly ["agent_teams_create", "agent_teams_approve", "agent_teams_edit_plan", "agent_teams_add_member", "agent_teams_remove_member", "agent_teams_create_task", "agent_teams_reassign_task", "agent_teams_claim_task", "agent_teams_update_task", "agent_teams_amend_task", "agent_teams_send_message", "agent_teams_status", "agent_teams_resume", "agent_teams_delete"];
 export declare const MEMBER_TOOL_NAMES: readonly string[];
-export declare const CAPTAIN_TOOL_NAMES: ("agent_teams_create" | "agent_teams_approve" | "agent_teams_edit_plan" | "agent_teams_add_member" | "agent_teams_remove_member" | "agent_teams_create_task" | "agent_teams_reassign_task" | "agent_teams_claim_task" | "agent_teams_update_task" | "agent_teams_send_message" | "agent_teams_status" | "agent_teams_resume" | "agent_teams_delete")[];
+export declare const CAPTAIN_TOOL_NAMES: ("agent_teams_create" | "agent_teams_approve" | "agent_teams_edit_plan" | "agent_teams_add_member" | "agent_teams_remove_member" | "agent_teams_create_task" | "agent_teams_reassign_task" | "agent_teams_claim_task" | "agent_teams_update_task" | "agent_teams_amend_task" | "agent_teams_send_message" | "agent_teams_status" | "agent_teams_resume" | "agent_teams_delete")[];

package/lib/types/types.d.ts

@@ -52,6 +52,19 @@ export interface ReviewPolicy {
     maxRepairAttempts?: number;
     requiredReviewers?: string[];
 }
+/** One captain-only contract amendment recorded on a quality task. */
+export interface TaskRevision {
+    /** Epoch ms when the amendment was applied. */
+    at: number;
+    /** Identity that applied it (`captain`). */
+    by: string;
+    /** Why the previous contract was wrong; kept for the audit trail. */
+    reason: string;
+    /** Amended contract field names (`objective`, `acceptance`, …). */
+    fields: string[];
+    /** Previous values of the amended fields; fields absent before are omitted. */
+    previous: Record<string, unknown>;
+}
 /** One task of a team's task list. */
 export interface TeamTask {
     /** Stable task id from the profile template; absent for ad-hoc tasks. */
@@ -75,6 +88,8 @@ export interface TeamTask {
     attemptId?: string;
     /** Opaque generation for a revocation/handoff that has not started its next attempt yet. */
     handoffId?: string;
+    /** Previous activation retained until a handoff drain succeeds (retryable). */
+    handoffFromMemberId?: string;
     /** A handoff is quiescing the old owner; the scheduler must not dispatch it yet. */
     reassigning?: boolean;
     /** Quality-gate kind. Missing values are treated as `work`. */
@@ -100,6 +115,8 @@ export interface TeamTask {
     sourceFindingIds?: string[];
     /** User-constraint / goal items this task claims to cover. */
     coverageOf?: string[];
+    /** Captain-only contract amendments, oldest first (see amendTaskContract). */
+    revisions?: TaskRevision[];
     createdAt: number;
     updatedAt: number;
 }
@@ -130,6 +147,14 @@ export interface TeamMember {
     fallbackActive?: boolean;
     joinedAt: number;
     status: MemberStatus;
+    /** Execution admission is closed while a failed/pending handoff is drained. */
+    stopping?: boolean;
+    /**
+     * Last member-start failure, recorded so the captain can see why a member
+     * never acquired a session instead of observing an unexplained `unspawned`
+     * member. Cleared by the next successful start.
+     */
+    spawnError?: string;
 }
 /** One mailbox message. */
 export interface TeamMessage {
@@ -146,6 +171,11 @@ export interface TeamMessage {
     deliveredAt?: number;
     /** Set once the recipient has consumed or been shown the durable fallback. */
     readAt?: number;
+    /** Guidance is scoped to the recipient's execution generation, when present. */
+    taskId?: string;
+    attemptId?: string;
+    /** Cancelled delivery is retained for audit but must not wake the recipient. */
+    discardedAt?: number;
 }
 /** Snapshot of the named profile used to seed a team. */
 export interface TeamModelFallback {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nanmicoder/dsh-agent-teams",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "AgentTeams for DeepSeek Harness: multi-agent team collaboration (captain, members, tasks with dependencies, messaging) driven by natural language, with a tree monitor in the web GUI",
   "type": "module",
   "main": "lib/index.js",
@@ -225,13 +225,15 @@
     "update:skills": "node scripts/update-skills.mjs",
     "test:skills-updater": "node --test scripts/update-skills.test.mjs",
     "verify:skill": "node scripts/sync-skill.mjs --check",
-    "verify": "node scripts/verify.mjs && node scripts/fallback-tdd.mjs && node scripts/member-failure-tdd.mjs && node scripts/quality-gates-tdd.mjs && node scripts/lifecycle-verify.mjs && node scripts/stress-verify.mjs && pnpm verify:web-routes && pnpm verify:release && pnpm verify:skill && pnpm verify:harness-contract && pnpm verify:http-body && pnpm verify:compatibility && pnpm verify:capabilities",
+    "verify": "node scripts/verify.mjs && node scripts/fallback-tdd.mjs && node scripts/member-failure-tdd.mjs && pnpm verify:quality-gates && node scripts/lifecycle-verify.mjs && node scripts/stress-verify.mjs && pnpm verify:web-routes && pnpm verify:release && pnpm verify:skill && pnpm verify:harness-contract && pnpm verify:http-body && pnpm verify:compatibility && pnpm verify:capabilities && pnpm verify:member-spawn-recovery",
+    "verify:quality-gates": "node scripts/quality-gates-tdd.mjs && node --test scripts/quality-gates-repair-scope.test.mjs scripts/quality-gates-amend.test.mjs",
     "verify:web-routes": "node scripts/web-routes-verify.mjs",
     "verify:release": "node --test scripts/release-metadata.test.mjs",
-    "verify:harness-contract": "node scripts/harness-compat-tdd.mjs && node scripts/lifecycle-verify.mjs --modern-harness && node scripts/member-failure-tdd.mjs --modern-harness && node scripts/lifecycle-verify.mjs --delivery-harness && node scripts/member-failure-tdd.mjs --delivery-harness",
+    "verify:harness-contract": "node scripts/harness-compat-tdd.mjs && node scripts/stability-tdd.mjs && node scripts/lifecycle-verify.mjs --modern-harness && node scripts/member-failure-tdd.mjs --modern-harness && node scripts/lifecycle-verify.mjs --delivery-harness && node scripts/member-failure-tdd.mjs --delivery-harness",
     "verify:compatibility": "node scripts/compatibility.mjs && node --test scripts/compatibility.test.mjs && node scripts/doctor.mjs",
     "verify:http-body": "node --test scripts/http-body.test.mjs",
     "doctor": "node scripts/doctor.mjs",
-    "verify:capabilities": "node --test scripts/capabilities.test.mjs"
+    "verify:capabilities": "node --test scripts/capabilities.test.mjs",
+    "verify:member-spawn-recovery": "node --test scripts/member-spawn-recovery.test.mjs"
   }
 }

package/release-notes/v0.1.18.md

@@ -0,0 +1,21 @@
+# v0.1.18 — Reliable team scheduling and message delivery
+
+npm channel: `latest`. Recommended host: DeepSeek Harness `0.1.5-rc.1`.
+
+- Create the roster and dependency graph atomically; start members only when their first task is ready, avoiding welcome-only model turns.
+- Deliver coordination at the next model step, preserve tool-result continuations, and discard duplicate or obsolete task messages. Suppress duplicate native success notifications after an accepted team report.
+- Drain member descendants and queued input on archive, removal, and reassignment. Reject retired member identities on cold restore and retry incomplete cleanup.
+- Allow dependency-fenced implementation planning while requirements are in progress, and correct or cancel tasks that have not started.
+- Return the current attempt ID when a member omits it, so it can retry the update without restarting completed work. Keep rejection of genuinely stale attempts.
+- Keep unfinished work from passing delivery gates; make deeper delegation an explicit choice.
+- Preserve existing progressive tool loading, direct workflows, Harness compatibility, and light/dark theme support.
+
+Validation includes regression tests and a four-host native runtime matrix: `0.1.5-rc.1`, `0.1.2-rc.1`, `0.1.2-alpha.5`, and `0.1.2-alpha.2`. The release workflow checks the same packaged artifact on every host before npm publication.
+
+Pre-release real DeepSeek testing under `/tmp` exercised six members, seventeen tasks, cold continuation, and review/repair loops, finishing with 32 external assertions. This involved interrupted runs and fixes between phases; it is not a claim of a clean single-run benchmark or a measured speedup. See the [full test report](https://github.com/NanmiCoder/dsh-agent-teams/blob/v0.1.18/docs/session-latency-audit-2026-09-12/complex-test-report.md), including test limitations and the disclosed test-scope incident.
+
+```sh
+dsh plugin --profile web add --save-exact @nanmicoder/dsh-agent-teams@0.1.18
+```
+
+Restart Harness and refresh the browser after upgrading. Updating the plugin does not update a Desktop app's embedded Harness. Before downgrading, finish or archive teams created by this release: older plugins do not understand dormant members with an empty session ID.

package/release-notes/v0.1.19.md

@@ -0,0 +1,20 @@
+# AgentTeams v0.1.19
+
+- Fix member startup when the host disables or renames its delegation tools. Missing global tool names no longer abort all member starts; unrelated startup failures remain visible in team status. Thanks to PRs #167 and #172.
+- Derive automatic repair scope from both the observed file and paths named in `requiredFix`. Resolve conflicting exclusions inherited from the previous round after deriving that scope, so a repair can truthfully report the files it must change. Integrates PR #155 and the generated-contract portion of PR #177; manually authored exclusions keep their existing precedence.
+- Add captain-only `agent_teams_amend_task` for correcting non-terminal quality contracts, with durable revision history and freeze checks after a passing review. Members cannot call it.
+- Include repair-scope and amendment regressions in the standard release gate; update the captain tool-surface fixture and tolerate the known closed-session teardown race (PR #180).
+
+## Compatibility
+
+The supported Harness matrix is unchanged: recommended `0.1.5-rc.1`, plus `0.1.2-rc.1`, `0.1.2-alpha.5`, and `0.1.2-alpha.2`. This release does not claim support for untested newer Harness versions or every Desktop distribution.
+
+Existing malformed terminal tasks are not rewritten automatically. Broader findings/revision linkage and stale generated acceptance criteria remain separate issues.
+
+Update the plugin in your existing profile, then restart Harness:
+
+```sh
+dsh plugin --profile <your-profile> add --save-exact @nanmicoder/dsh-agent-teams@0.1.19
+```
+
+See [release verification](https://github.com/NanmiCoder/dsh-agent-teams/tree/main/docs/releases/v0.1.19) for real-provider scenarios, evidence boundaries, and publication results.