@jstn-sdk/rcs 0.1.0

package/dist/team/contracts.js

@@ -0,0 +1,103 @@
+export const TEAM_NAME_SAFE_PATTERN = /^[a-z0-9][a-z0-9-]{0,29}$/;
+export const WORKER_NAME_SAFE_PATTERN = /^[a-z0-9][a-z0-9-]{0,63}$/;
+export const TASK_ID_SAFE_PATTERN = /^\d{1,20}$/;
+export const TEAM_TASK_STATUSES = ['pending', 'blocked', 'in_progress', 'completed', 'failed'];
+export const TEAM_TERMINAL_TASK_STATUSES = new Set(['completed', 'failed']);
+export const TEAM_TASK_STATUS_TRANSITIONS = {
+    pending: [],
+    blocked: [],
+    in_progress: ['completed', 'failed'],
+    completed: [],
+    failed: [],
+};
+export function isTerminalTeamTaskStatus(status) {
+    return TEAM_TERMINAL_TASK_STATUSES.has(status);
+}
+export function canTransitionTeamTaskStatus(from, to) {
+    return TEAM_TASK_STATUS_TRANSITIONS[from]?.includes(to) ?? false;
+}
+export const TEAM_DISPATCH_REQUEST_STATUSES = ['pending', 'notified', 'delivered', 'failed'];
+export const TEAM_TERMINAL_DISPATCH_REQUEST_STATUSES = new Set(['delivered', 'failed']);
+export const TEAM_DISPATCH_REQUEST_STATUS_TRANSITIONS = {
+    pending: ['notified', 'failed'],
+    notified: ['delivered', 'failed'],
+    delivered: [],
+    failed: [],
+};
+export function isTeamDispatchRequestStatus(status) {
+    return TEAM_DISPATCH_REQUEST_STATUSES.includes(status);
+}
+export function isTerminalTeamDispatchRequestStatus(status) {
+    return TEAM_TERMINAL_DISPATCH_REQUEST_STATUSES.has(status);
+}
+export function canTransitionTeamDispatchRequestStatus(from, to) {
+    return TEAM_DISPATCH_REQUEST_STATUS_TRANSITIONS[from]?.includes(to) ?? false;
+}
+export const TEAM_WORKER_INTEGRATION_STATUSES = [
+    'idle',
+    'integrated',
+    'integration_failed',
+    'cherry_pick_conflict',
+    'rebase_conflict',
+];
+export function isTeamWorkerIntegrationStatus(status) {
+    return TEAM_WORKER_INTEGRATION_STATUSES.includes(status);
+}
+export const TEAM_EVENT_TYPES = [
+    'task_completed',
+    'task_failed',
+    'worker_state_changed',
+    'worker_idle',
+    'worker_stopped',
+    'message_received',
+    'leader_notification_deferred',
+    'all_workers_idle',
+    'shutdown_ack',
+    'shutdown_gate',
+    'shutdown_gate_forced',
+    'ralph_cleanup_policy',
+    'ralph_cleanup_summary',
+    'approval_decision',
+    'team_leader_nudge',
+    'worker_diff_activity',
+    'worker_diff_report',
+    'worker_merge_report',
+    'worker_merge_conflict',
+    'worker_integration_failed',
+    'worker_integration_attempt_requested',
+    'worker_cherry_pick_detected',
+    'worker_cherry_pick_applied',
+    'worker_cherry_pick_conflict',
+    'worker_rebase_applied',
+    'worker_rebase_conflict',
+    'worker_cross_rebase_applied',
+    'worker_cross_rebase_conflict',
+    'worker_cross_rebase_skipped',
+    'worker_stale_diff',
+    'worker_stale_heartbeat',
+    'worker_stale_stdout',
+];
+export const TEAM_WAKEABLE_EVENT_TYPES = new Set([
+    'worker_state_changed',
+    'task_completed',
+    'task_failed',
+    'worker_stopped',
+    'message_received',
+    'leader_notification_deferred',
+    'all_workers_idle',
+    'team_leader_nudge',
+    'worker_integration_failed',
+    'worker_integration_attempt_requested',
+    'worker_merge_conflict',
+    'worker_cherry_pick_conflict',
+    'worker_rebase_conflict',
+    'worker_cross_rebase_conflict',
+    'worker_stale_diff',
+    'worker_stale_heartbeat',
+    'worker_stale_stdout',
+]);
+export function isWakeableTeamEventType(type) {
+    return TEAM_WAKEABLE_EVENT_TYPES.has(type);
+}
+export const TEAM_TASK_APPROVAL_STATUSES = ['pending', 'approved', 'rejected'];
+//# sourceMappingURL=contracts.js.map

package/dist/team/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/team/contracts.ts"],"names":[],"mappings":"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"}

package/dist/team/current-task-baseline.d.ts

@@ -0,0 +1,32 @@
+export type CurrentTaskStatus = 'active' | 'merged' | 'closed' | 'superseded';
+export interface CurrentTaskBaselineEntry {
+    branch_name: string;
+    worktree_path: string | null;
+    base_ref?: string;
+    issue_number?: number;
+    pr_number?: number;
+    pr_url?: string;
+    status: CurrentTaskStatus;
+    created_at: string;
+    updated_at: string;
+}
+interface CurrentTaskBaselineFile {
+    version: 1;
+    tasks: CurrentTaskBaselineEntry[];
+}
+export interface UpsertCurrentTaskBaselineInput {
+    branch_name: string;
+    worktree_path?: string | null;
+    base_ref?: string;
+    issue_number?: number;
+    pr_number?: number;
+    pr_url?: string;
+    status?: CurrentTaskStatus;
+}
+export declare function readCurrentTaskBaseline(repoRoot: string): CurrentTaskBaselineFile;
+export declare function listActiveCurrentTasks(repoRoot: string): CurrentTaskBaselineEntry[];
+export declare function findActiveCurrentTaskByBranch(repoRoot: string, branchName: string): CurrentTaskBaselineEntry | null;
+export declare function upsertCurrentTaskBaseline(repoRoot: string, input: UpsertCurrentTaskBaselineInput): CurrentTaskBaselineEntry;
+export declare function assertCurrentTaskBranchAvailable(repoRoot: string, branchName: string, requestedWorktreePath: string): void;
+export {};
+//# sourceMappingURL=current-task-baseline.d.ts.map

package/dist/team/current-task-baseline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"current-task-baseline.d.ts","sourceRoot":"","sources":["../../src/team/current-task-baseline.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,CAAC;AAE9E,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,uBAAuB;IAC/B,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,EAAE,wBAAwB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,8BAA8B;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAUD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,uBAAuB,CAmBjF;AAQD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,wBAAwB,EAAE,CAEnF;AAED,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,wBAAwB,GAAG,IAAI,CAInH;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,8BAA8B,GACpC,wBAAwB,CA8B1B;AAED,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,qBAAqB,EAAE,MAAM,GAC5B,IAAI,CAUN"}

package/dist/team/current-task-baseline.js

@@ -0,0 +1,85 @@
+import { existsSync } from 'fs';
+import { mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { join, resolve } from 'path';
+import { rcsStateDir } from '../utils/paths.js';
+function baselinePath(repoRoot) {
+    return join(rcsStateDir(repoRoot), 'current-task-baseline.json');
+}
+function emptyBaseline() {
+    return { version: 1, tasks: [] };
+}
+export function readCurrentTaskBaseline(repoRoot) {
+    const path = baselinePath(repoRoot);
+    if (!existsSync(path))
+        return emptyBaseline();
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf-8'));
+        if (parsed.version !== 1 || !Array.isArray(parsed.tasks))
+            return emptyBaseline();
+        return {
+            version: 1,
+            tasks: parsed.tasks
+                .filter((entry) => entry && typeof entry.branch_name === 'string' && typeof entry.status === 'string')
+                .map((entry) => ({
+                ...entry,
+                worktree_path: typeof entry.worktree_path === 'string' ? resolve(entry.worktree_path) : null,
+            })),
+        };
+    }
+    catch {
+        return emptyBaseline();
+    }
+}
+function writeCurrentTaskBaseline(repoRoot, data) {
+    const stateDir = rcsStateDir(repoRoot);
+    mkdirSync(stateDir, { recursive: true });
+    writeFileSync(baselinePath(repoRoot), JSON.stringify(data, null, 2) + '\n', 'utf-8');
+}
+export function listActiveCurrentTasks(repoRoot) {
+    return readCurrentTaskBaseline(repoRoot).tasks.filter((entry) => entry.status === 'active');
+}
+export function findActiveCurrentTaskByBranch(repoRoot, branchName) {
+    const normalized = branchName.trim();
+    if (!normalized)
+        return null;
+    return listActiveCurrentTasks(repoRoot).find((entry) => entry.branch_name === normalized) ?? null;
+}
+export function upsertCurrentTaskBaseline(repoRoot, input) {
+    const branchName = input.branch_name.trim();
+    if (!branchName) {
+        throw new Error('current_task_baseline_branch_required');
+    }
+    const now = new Date().toISOString();
+    const current = readCurrentTaskBaseline(repoRoot);
+    const existing = current.tasks.find((entry) => entry.branch_name === branchName) ?? null;
+    const next = {
+        branch_name: branchName,
+        worktree_path: typeof input.worktree_path === 'string'
+            ? resolve(input.worktree_path)
+            : input.worktree_path === null
+                ? null
+                : existing?.worktree_path ?? null,
+        base_ref: input.base_ref ?? existing?.base_ref,
+        issue_number: input.issue_number ?? existing?.issue_number,
+        pr_number: input.pr_number ?? existing?.pr_number,
+        pr_url: input.pr_url ?? existing?.pr_url,
+        status: input.status ?? existing?.status ?? 'active',
+        created_at: existing?.created_at ?? now,
+        updated_at: now,
+    };
+    const tasks = current.tasks.filter((entry) => entry.branch_name !== branchName);
+    tasks.push(next);
+    tasks.sort((a, b) => a.branch_name.localeCompare(b.branch_name));
+    writeCurrentTaskBaseline(repoRoot, { version: 1, tasks });
+    return next;
+}
+export function assertCurrentTaskBranchAvailable(repoRoot, branchName, requestedWorktreePath) {
+    const current = findActiveCurrentTaskByBranch(repoRoot, branchName);
+    if (!current)
+        return;
+    const requested = resolve(requestedWorktreePath);
+    if (!current.worktree_path || current.worktree_path !== requested) {
+        throw new Error(`current_task_branch_guard:${branchName}:${current.worktree_path ?? 'unknown_worktree'}`);
+    }
+}
+//# sourceMappingURL=current-task-baseline.js.map

package/dist/team/current-task-baseline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"current-task-baseline.js","sourceRoot":"","sources":["../../src/team/current-task-baseline.ts"],"names":[],"mappings":"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"}

package/dist/team/dag-schema.d.ts

@@ -0,0 +1,38 @@
+export type TeamDagWorkerCountSource = 'cli-explicit' | 'plan-suggested' | 'default-derived';
+export interface TeamDagNode {
+    id: string;
+    subject: string;
+    description: string;
+    role?: string;
+    lane?: string;
+    filePaths?: string[];
+    domains?: string[];
+    depends_on?: string[];
+    requires_code_change?: boolean;
+    acceptance?: string[];
+}
+export interface TeamDagWorkerPolicy {
+    requested_count?: number;
+    count_source?: TeamDagWorkerCountSource;
+    max_count?: number;
+    reserve_verification_lane?: boolean;
+    strict_max_count?: boolean;
+}
+export interface TeamDagHandoff {
+    schema_version: 1;
+    plan_slug?: string;
+    source_prd?: string;
+    nodes: TeamDagNode[];
+    worker_policy?: TeamDagWorkerPolicy;
+}
+export interface TeamDagResolution {
+    dag: TeamDagHandoff | null;
+    source: 'sidecar' | 'markdown' | 'none';
+    path?: string;
+    planSlug?: string;
+    warning?: string;
+    error?: string;
+}
+export declare function parseTeamDagHandoff(value: unknown): TeamDagHandoff;
+export declare function readTeamDagHandoffForLatestPlan(cwd: string): TeamDagResolution;
+//# sourceMappingURL=dag-schema.d.ts.map

package/dist/team/dag-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dag-schema.d.ts","sourceRoot":"","sources":["../../src/team/dag-schema.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,wBAAwB,GAAG,cAAc,GAAG,gBAAgB,GAAG,iBAAiB,CAAC;AAE7F,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,wBAAwB,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,CAAC,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACrC;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,cAAc,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA0DD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CA2ClE;AAuED,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAqC9E"}

package/dist/team/dag-schema.js

@@ -0,0 +1,221 @@
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { basename, join } from 'node:path';
+import { readLatestPlanningArtifacts } from '../planning/artifacts.js';
+function planningSlugFromPrdPath(prdPath) {
+    if (!prdPath)
+        return null;
+    const match = basename(prdPath).match(/^prd-(?<slug>.*)\.md$/i);
+    return match?.groups?.slug ?? null;
+}
+function asStringArray(value) {
+    if (value === undefined)
+        return undefined;
+    if (!Array.isArray(value) || value.some((item) => typeof item !== 'string')) {
+        throw new Error('expected string array');
+    }
+    return value;
+}
+function asOptionalString(value) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'string')
+        throw new Error('expected string');
+    return value;
+}
+function asOptionalBoolean(value) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'boolean')
+        throw new Error('expected boolean');
+    return value;
+}
+function asOptionalPositiveInteger(value) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'number' || !Number.isInteger(value) || value < 1) {
+        throw new Error('expected positive integer');
+    }
+    return value;
+}
+function parseWorkerPolicy(value) {
+    if (value === undefined)
+        return undefined;
+    if (!value || typeof value !== 'object')
+        throw new Error('worker_policy must be an object');
+    const raw = value;
+    const countSource = raw.count_source;
+    if (countSource !== undefined
+        && countSource !== 'cli-explicit'
+        && countSource !== 'plan-suggested'
+        && countSource !== 'default-derived') {
+        throw new Error('worker_policy.count_source is invalid');
+    }
+    return {
+        requested_count: asOptionalPositiveInteger(raw.requested_count),
+        count_source: countSource,
+        max_count: asOptionalPositiveInteger(raw.max_count),
+        reserve_verification_lane: asOptionalBoolean(raw.reserve_verification_lane),
+        strict_max_count: asOptionalBoolean(raw.strict_max_count),
+    };
+}
+export function parseTeamDagHandoff(value) {
+    if (!value || typeof value !== 'object')
+        throw new Error('Team DAG handoff must be an object');
+    const raw = value;
+    if (raw.schema_version !== 1)
+        throw new Error('Team DAG handoff schema_version must be 1');
+    if (!Array.isArray(raw.nodes) || raw.nodes.length === 0)
+        throw new Error('Team DAG handoff nodes must be a non-empty array');
+    const seen = new Set();
+    const nodes = raw.nodes.map((nodeValue, index) => {
+        if (!nodeValue || typeof nodeValue !== 'object')
+            throw new Error(`node ${index + 1} must be an object`);
+        const node = nodeValue;
+        if (typeof node.id !== 'string' || node.id.trim() === '')
+            throw new Error(`node ${index + 1} id is required`);
+        if (seen.has(node.id))
+            throw new Error(`duplicate node id: ${node.id}`);
+        seen.add(node.id);
+        if (typeof node.subject !== 'string' || node.subject.trim() === '')
+            throw new Error(`node ${node.id} subject is required`);
+        if (typeof node.description !== 'string' || node.description.trim() === '')
+            throw new Error(`node ${node.id} description is required`);
+        return {
+            id: node.id,
+            subject: node.subject,
+            description: node.description,
+            role: asOptionalString(node.role),
+            lane: asOptionalString(node.lane),
+            filePaths: asStringArray(node.filePaths),
+            domains: asStringArray(node.domains),
+            depends_on: asStringArray(node.depends_on),
+            requires_code_change: asOptionalBoolean(node.requires_code_change),
+            acceptance: asStringArray(node.acceptance),
+        };
+    });
+    for (const node of nodes) {
+        for (const dep of node.depends_on ?? []) {
+            if (!seen.has(dep))
+                throw new Error(`node ${node.id} depends on unknown node: ${dep}`);
+        }
+    }
+    assertAcyclic(nodes);
+    return {
+        schema_version: 1,
+        plan_slug: asOptionalString(raw.plan_slug),
+        source_prd: asOptionalString(raw.source_prd),
+        nodes,
+        worker_policy: parseWorkerPolicy(raw.worker_policy),
+    };
+}
+function assertAcyclic(nodes) {
+    const byId = new Map(nodes.map((node) => [node.id, node]));
+    const visiting = new Set();
+    const visited = new Set();
+    const visit = (id) => {
+        if (visited.has(id))
+            return;
+        if (visiting.has(id))
+            throw new Error(`cycle detected at node: ${id}`);
+        visiting.add(id);
+        for (const dep of byId.get(id)?.depends_on ?? [])
+            visit(dep);
+        visiting.delete(id);
+        visited.add(id);
+    };
+    for (const node of nodes)
+        visit(node.id);
+}
+function parseJsonText(text) {
+    return parseTeamDagHandoff(JSON.parse(text));
+}
+function assertDagMatchesPlan(dag, slug, prdPath) {
+    if (dag.plan_slug !== undefined && dag.plan_slug !== slug) {
+        throw new Error(`Team DAG plan_slug ${dag.plan_slug} does not match latest approved plan slug ${slug}`);
+    }
+    if (dag.source_prd !== undefined && basename(dag.source_prd) !== basename(prdPath)) {
+        throw new Error(`Team DAG source_prd ${dag.source_prd} does not match latest approved PRD ${basename(prdPath)}`);
+    }
+}
+function matchesSidecarSlug(file, slug) {
+    const prefix = `team-dag-${slug}`;
+    return (file === `${prefix}.json` || file.startsWith(`${prefix}-`)) && file.endsWith('.json');
+}
+function readSidecar(plansDir, slug, prdPath) {
+    if (!existsSync(plansDir))
+        return null;
+    const candidates = readdirSync(plansDir)
+        .filter((file) => matchesSidecarSlug(file, slug))
+        .sort((a, b) => a.localeCompare(b))
+        .map((file) => join(plansDir, file));
+    if (candidates.length === 0)
+        return null;
+    const selected = candidates.at(-1);
+    try {
+        return {
+            dag: (() => {
+                const dag = parseJsonText(readFileSync(selected, 'utf-8'));
+                assertDagMatchesPlan(dag, slug, prdPath);
+                return dag;
+            })(),
+            source: 'sidecar',
+            path: selected,
+            warning: candidates.length > 1 ? 'multiple_matches' : undefined,
+        };
+    }
+    catch (error) {
+        return {
+            dag: null,
+            source: 'sidecar',
+            path: selected,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+function extractMarkdownHandoff(content) {
+    const heading = content.search(/^#{1,6}\s+Team DAG Handoff\s*$/im);
+    const searchFrom = heading >= 0 ? heading : 0;
+    const fenced = content.slice(searchFrom).match(/```(?:json)?\s*\n([\s\S]*?)\n```/i);
+    return fenced?.[1]?.trim() || null;
+}
+export function readTeamDagHandoffForLatestPlan(cwd) {
+    const selection = readLatestPlanningArtifacts(cwd);
+    const prdPath = selection.prdPath;
+    const planSlug = planningSlugFromPrdPath(prdPath);
+    if (!prdPath || !planSlug)
+        return { dag: null, source: 'none' };
+    const plansDir = join(cwd, '.rcs', 'plans');
+    if (selection.testSpecPaths.length === 0) {
+        return { dag: null, source: 'none', planSlug, error: 'missing_matching_test_spec' };
+    }
+    const sidecar = readSidecar(plansDir, planSlug, prdPath);
+    if (sidecar?.dag)
+        return { ...sidecar, planSlug };
+    if (sidecar?.error)
+        return { ...sidecar, planSlug };
+    try {
+        const markdownJson = extractMarkdownHandoff(readFileSync(prdPath, 'utf-8'));
+        if (!markdownJson)
+            return { dag: null, source: 'none', planSlug };
+        return {
+            dag: (() => {
+                const dag = parseJsonText(markdownJson);
+                assertDagMatchesPlan(dag, planSlug, prdPath);
+                return dag;
+            })(),
+            source: 'markdown',
+            path: prdPath,
+            planSlug,
+        };
+    }
+    catch (error) {
+        return {
+            dag: null,
+            source: 'none',
+            path: prdPath,
+            planSlug,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+//# sourceMappingURL=dag-schema.js.map

package/dist/team/dag-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dag-schema.js","sourceRoot":"","sources":["../../src/team/dag-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AA0CvE,SAAS,uBAAuB,CAAC,OAAsB;IACrD,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAChE,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,IAAI,IAAI,CAAC;AACrC,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAClE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACpE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,yBAAyB,CAAC,KAAc;IAC/C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAC5F,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,MAAM,WAAW,GAAG,GAAG,CAAC,YAAY,CAAC;IACrC,IACE,WAAW,KAAK,SAAS;WACtB,WAAW,KAAK,cAAc;WAC9B,WAAW,KAAK,gBAAgB;WAChC,WAAW,KAAK,iBAAiB,EACpC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO;QACL,eAAe,EAAE,yBAAyB,CAAC,GAAG,CAAC,eAAe,CAAC;QAC/D,YAAY,EAAE,WAAmD;QACjE,SAAS,EAAE,yBAAyB,CAAC,GAAG,CAAC,SAAS,CAAC;QACnD,yBAAyB,EAAE,iBAAiB,CAAC,GAAG,CAAC,yBAAyB,CAAC;QAC3E,gBAAgB,EAAE,iBAAiB,CAAC,GAAG,CAAC,gBAAgB,CAAC;KAC1D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAC/F,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,IAAI,GAAG,CAAC,cAAc,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC3F,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IAE7H,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,KAAK,EAAe,EAAE;QAC5D,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,KAAK,GAAG,CAAC,oBAAoB,CAAC,CAAC;QACxG,MAAM,IAAI,GAAG,SAAoC,CAAC;QAClD,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,KAAK,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC9G,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClB,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,EAAE,sBAAsB,CAAC,CAAC;QAC3H,IAAI,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,EAAE,0BAA0B,CAAC,CAAC;QACvI,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;YACjC,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;YACjC,SAAS,EAAE,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC;YACxC,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC;YACpC,UAAU,EAAE,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC;YAC1C,oBAAoB,EAAE,iBAAiB,CAAC,IAAI,CAAC,oBAAoB,CAAC;YAClE,UAAU,EAAE,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC;SAC3C,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;YACxC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,EAAE,6BAA6B,GAAG,EAAE,CAAC,CAAC;QACzF,CAAC;IACH,CAAC;IACD,aAAa,CAAC,KAAK,CAAC,CAAC;IAErB,OAAO;QACL,cAAc,EAAE,CAAC;QACjB,SAAS,EAAE,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC;QAC1C,UAAU,EAAE,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC;QAC5C,KAAK;QACL,aAAa,EAAE,iBAAiB,CAAC,GAAG,CAAC,aAAa,CAAC;KACpD,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,KAAoB;IACzC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,KAAK,GAAG,CAAC,EAAU,EAAQ,EAAE;QACjC,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,OAAO;QAC5B,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,EAAE,EAAE,CAAC,CAAC;QACvE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,UAAU,IAAI,EAAE;YAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7D,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,oBAAoB,CAAC,GAAmB,EAAE,IAAY,EAAE,OAAe;IAC9E,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,GAAG,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,sBAAsB,GAAG,CAAC,SAAS,6CAA6C,IAAI,EAAE,CAAC,CAAC;IAC1G,CAAC;IACD,IAAI,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACnF,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,CAAC,UAAU,uCAAuC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACnH,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY,EAAE,IAAY;IACpD,MAAM,MAAM,GAAG,YAAY,IAAI,EAAE,CAAC;IAClC,OAAO,CAAC,IAAI,KAAK,GAAG,MAAM,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAChG,CAAC;AAED,SAAS,WAAW,CAAC,QAAgB,EAAE,IAAY,EAAE,OAAe;IAClE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,MAAM,UAAU,GAAG,WAAW,CAAC,QAAQ,CAAC;SACrC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;SAChD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;SAClC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;IACvC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,QAAQ,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC;IACpC,IAAI,CAAC;QACH,OAAO;YACL,GAAG,EAAE,CAAC,GAAG,EAAE;gBACT,MAAM,GAAG,GAAG,aAAa,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC3D,oBAAoB,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;gBACzC,OAAO,GAAG,CAAC;YACb,CAAC,CAAC,EAAE;YACJ,MAAM,EAAE,SAAS;YACjB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,SAAS;SAChE,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,GAAG,EAAE,IAAI;YACT,MAAM,EAAE,SAAS;YACjB,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB,CAAC,OAAe;IAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,kCAAkC,CAAC,CAAC;IACnE,MAAM,UAAU,GAAG,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACpF,OAAO,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,GAAW;IACzD,MAAM,SAAS,GAAG,2BAA2B,CAAC,GAAG,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC;IAClC,MAAM,QAAQ,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAEhE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,IAAI,SAAS,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,4BAA4B,EAAE,CAAC;IACtF,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzD,IAAI,OAAO,EAAE,GAAG;QAAE,OAAO,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,CAAC;IAClD,IAAI,OAAO,EAAE,KAAK;QAAE,OAAO,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,CAAC;IAEpD,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,sBAAsB,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAC5E,IAAI,CAAC,YAAY;YAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QAClE,OAAO;YACL,GAAG,EAAE,CAAC,GAAG,EAAE;gBACT,MAAM,GAAG,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;gBACxC,oBAAoB,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAC7C,OAAO,GAAG,CAAC;YACb,CAAC,CAAC,EAAE;YACJ,MAAM,EAAE,UAAU;YAClB,IAAI,EAAE,OAAO;YACb,QAAQ;SACT,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,GAAG,EAAE,IAAI;YACT,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,OAAO;YACb,QAAQ;YACR,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/team/delegation-policy.d.ts

@@ -0,0 +1,3 @@
+import type { TeamTask, TeamTaskDelegationPlan } from './state.js';
+export declare function synthesizeDelegationPlan(task: Pick<TeamTask, 'subject' | 'description' | 'role'>): TeamTaskDelegationPlan;
+//# sourceMappingURL=delegation-policy.d.ts.map

package/dist/team/delegation-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegation-policy.d.ts","sourceRoot":"","sources":["../../src/team/delegation-policy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAmEnE,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,GAAG,aAAa,GAAG,MAAM,CAAC,GAAG,sBAAsB,CA2BzH"}

package/dist/team/delegation-policy.js

@@ -0,0 +1,82 @@
+import { getTeamChildModel } from '../config/models.js';
+const BROAD_TASK_PATTERNS = [
+    /\b(broad|large|cross[-\s]?cutting|end[-\s]?to[-\s]?end)\b/i,
+    /\bdebug|root[-\s]?cause|flaky|failure|regression|bug\b/i,
+    /\breview|audit|assess|validate\b/i,
+    /\bsearch|map|trace|find references|repo[-\s]?wide\b/i,
+    /\btest|coverage|verify|qa\b/i,
+    /\brefactor|cleanup|deslop|simplif(?:y|ication)\b/i,
+    /\bmigrat(?:e|ion)|upgrade|port\b/i,
+    /\binvestigat(?:e|ion)|analy[sz]e|diagnos(?:e|is)\b/i,
+];
+const NARROW_TASK_PATTERNS = [
+    /\btypo\b/i,
+    /\bcopy\b/i,
+    /\bsingle[-\s]?file\b/i,
+    /\bone[-\s]?(line|word|sentence|file)\b/i,
+    /\breadme\b.*\btypo\b/i,
+];
+const SIMPLE_SCOPE_PATTERNS = [
+    /\bfix\b.*\btypo\b/i,
+    /\bupdate\b.*\bcopy\b/i,
+    /\brename\b.*\bsingle\b/i,
+];
+function taskText(task) {
+    return [task.subject, task.description, task.role].filter(Boolean).join('\n');
+}
+function isNarrowTask(text) {
+    return NARROW_TASK_PATTERNS.some((pattern) => pattern.test(text))
+        && (SIMPLE_SCOPE_PATTERNS.some((pattern) => pattern.test(text)) || !/\b(search|debug|investigate|refactor|migration|review|test)\b/i.test(text));
+}
+function isBroadTask(text) {
+    return BROAD_TASK_PATTERNS.some((pattern) => pattern.test(text));
+}
+function roleAwareSubtaskCandidates(task) {
+    const text = taskText(task);
+    const candidates = [];
+    if (/\bdebug|root[-\s]?cause|flaky|failure|regression|bug|investigat/i.test(text)) {
+        candidates.push('Debug/root-cause probe: trace likely failure paths and summarize evidence.');
+    }
+    if (/\bsearch|map|find references|repo[-\s]?wide|investigat/i.test(text)) {
+        candidates.push('Repository map probe: find relevant files, symbols, and ownership boundaries.');
+    }
+    if (/\breview|audit|security|quality/i.test(text)) {
+        candidates.push('Review probe: inspect risks, edge cases, and contract violations.');
+    }
+    if (/\btest|coverage|verify|qa/i.test(text)) {
+        candidates.push('Test probe: identify existing coverage and missing regression checks.');
+    }
+    if (/\brefactor|cleanup|deslop|simplif|migrat|upgrade|port/i.test(text)) {
+        candidates.push('Change-slice probe: isolate safe implementation slices and migration hazards.');
+    }
+    if (candidates.length === 0) {
+        candidates.push('Context probe: map the relevant code paths and summarize recommended next steps.');
+    }
+    return candidates.slice(0, 4);
+}
+export function synthesizeDelegationPlan(task) {
+    const text = taskText(task);
+    if (isNarrowTask(text)) {
+        return { mode: 'none' };
+    }
+    if (isBroadTask(text)) {
+        return {
+            mode: 'auto',
+            max_parallel_subtasks: 3,
+            required_parallel_probe: true,
+            spawn_before_serial_search_threshold: 3,
+            child_model_policy: 'standard',
+            child_model: getTeamChildModel(),
+            subtask_candidates: roleAwareSubtaskCandidates(task),
+            child_report_format: 'bullets',
+            skip_allowed_reason_required: true,
+        };
+    }
+    return {
+        mode: 'optional',
+        max_parallel_subtasks: 2,
+        child_model_policy: 'standard',
+        child_model: getTeamChildModel(),
+    };
+}
+//# sourceMappingURL=delegation-policy.js.map

package/dist/team/delegation-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegation-policy.js","sourceRoot":"","sources":["../../src/team/delegation-policy.ts"],"names":[],"mappings":"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"}

package/dist/team/delivery-log.d.ts

@@ -0,0 +1,14 @@
+export type TeamDeliveryEventName = 'mailbox_created' | 'dispatch_attempted' | 'dispatch_result' | 'startup_timing' | 'delivered' | 'mark_delivered' | 'nudge_triggered';
+export type TeamDeliveryResult = 'created' | 'queued' | 'ok' | 'confirmed' | 'notified' | 'updated' | 'missing' | 'retry' | 'deferred' | 'suppressed' | 'sent' | 'failed';
+export interface TeamDeliveryLogEvent {
+    event: TeamDeliveryEventName;
+    source: string;
+    team: string;
+    transport?: string;
+    result?: TeamDeliveryResult;
+    [key: string]: unknown;
+}
+export declare function teamDeliveryLogPath(logsDir: string, now?: Date): string;
+export declare function appendTeamDeliveryLog(logsDir: string, event: TeamDeliveryLogEvent): Promise<void>;
+export declare function appendTeamDeliveryLogForCwd(cwd: string, event: TeamDeliveryLogEvent): Promise<void>;
+//# sourceMappingURL=delivery-log.d.ts.map

package/dist/team/delivery-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-log.d.ts","sourceRoot":"","sources":["../../src/team/delivery-log.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,qBAAqB,GAC7B,iBAAiB,GACjB,oBAAoB,GACpB,iBAAiB,GACjB,gBAAgB,GAChB,WAAW,GACX,gBAAgB,GAChB,iBAAiB,CAAC;AAEtB,MAAM,MAAM,kBAAkB,GAC1B,SAAS,GACT,QAAQ,GACR,IAAI,GACJ,WAAW,GACX,UAAU,GACV,SAAS,GACT,SAAS,GACT,OAAO,GACP,UAAU,GACV,YAAY,GACZ,MAAM,GACN,QAAQ,CAAC;AAEb,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,qBAAqB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAoBD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CAEnF;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAWvG;AAED,wBAAsB,2BAA2B,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzG"}