@planu/cli 0.32.0 → 0.33.1

package/dist/types/team-planner.d.ts

@@ -0,0 +1,183 @@
+import type { AgentRole, ModelTier } from './multi-agent.js';
+/** Complete distribution plan for a team of Claude Code agents. */
+export interface TeamDistributionPlan {
+    /** Human-readable team name. */
+    teamName: string;
+    /** Total number of teammates in the team. */
+    teamSize: number;
+    /** Per-teammate assignment details. */
+    teammates: TeammateAssignment[];
+    /** Ordered execution phases (parallel within each phase). */
+    executionOrder: TeamExecutionPhase[];
+    /** Estimated wall-clock duration for the full team run. */
+    estimatedDuration: string;
+    /** Warnings about potential issues (e.g. file conflicts, large specs). */
+    warnings: string[];
+}
+/** Assignment details for a single teammate in the team. */
+export interface TeammateAssignment {
+    /** Unique teammate name (e.g. "spec-042-impl"). */
+    name: string;
+    /** Role this teammate fulfils. */
+    role: AgentRole;
+    /** Model tier assigned to this teammate. */
+    model: ModelTier;
+    /** Spec IDs this teammate is responsible for. */
+    specs: string[];
+    /** Files this teammate has exclusive write access to. */
+    ownedFiles: string[];
+    /** Generated prompt to send to this teammate. */
+    prompt: string;
+}
+/** A phase of execution where all listed teammates run in parallel. */
+export interface TeamExecutionPhase {
+    /** Phase number (1-based). */
+    phase: number;
+    /** Teammate names that run in parallel during this phase. */
+    teammates: string[];
+    /** Reason these teammates are grouped together (or separated). */
+    reason: string;
+}
+/** Predefined team composition template. */
+export interface TeamTemplate {
+    /** Unique template identifier. */
+    id: string;
+    /** Human-readable template name. */
+    name: string;
+    /** Short description of the template strategy. */
+    description: string;
+    /** Pattern category for matching. */
+    pattern: string;
+    /** Role composition for the team. */
+    roles: TeamTemplateRole[];
+}
+/** A role slot within a TeamTemplate. */
+export interface TeamTemplateRole {
+    /** Agent role for this slot. */
+    role: AgentRole;
+    /** Model tier for agents in this slot. */
+    model: ModelTier;
+    /** Fixed count or "per-spec" for dynamic sizing. */
+    count: number | 'per-spec';
+}
+/** Recommendation on whether to use Agent Teams for a set of specs. */
+export interface TeamSuggestion {
+    /** Whether Agent Teams are recommended for this workload. */
+    recommended: boolean;
+    /** Explanation of the recommendation. */
+    reason: string;
+    /** Suggested template ID. */
+    templateId: string;
+    /** Recommended team size. */
+    teamSize: number;
+    /** Spec IDs included in the recommendation. */
+    specs: string[];
+    /** Exact tool call suggestions for the LLM to execute. */
+    toolCalls: string[];
+}
+/** Context provided to the prompt builder for a single teammate. */
+export interface TeammatePromptContext {
+    /** Primary language of the project (e.g. "typescript", "python"). */
+    projectLanguage: string;
+    /** Primary framework if detected (e.g. "next.js", "django"). */
+    projectFramework: string | null;
+    /** Architecture pattern (e.g. "hexagonal", "layered"). */
+    architecture: string;
+    /** Project conventions extracted from constitution/config. */
+    conventions: Record<string, unknown>;
+    /** Spec details for this teammate's assignment. */
+    specDetails: {
+        id: string;
+        title: string;
+        criteria: string[];
+    };
+    /** Files this teammate owns (exclusive write access). */
+    ownedFiles: string[];
+    /** Files this teammate must NOT modify. */
+    forbiddenFiles: string[];
+    /** Quality rules from the project constitution. */
+    qualityRules: string[];
+    /** Testing requirements (coverage thresholds, runner commands). */
+    testingRequirements: string[];
+    /** Git conventions (branch naming, commit format). */
+    gitConventions: string[];
+    /** Commands to run for validation before reporting done. */
+    validationCommands: string[];
+}
+/** Result of validating team outputs after all teammates complete. */
+export interface TeamValidationResult {
+    /** Whether the overall validation passed. */
+    passed: boolean;
+    /** Whether TypeScript type-checking passed. */
+    typecheckPassed: boolean;
+    /** Whether linting passed. */
+    lintPassed: boolean;
+    /** Whether tests passed. */
+    testsPassed: boolean;
+    /** Whether coverage thresholds were met. */
+    coveragePassed: boolean;
+    /** Files modified by more than one teammate (violations). */
+    fileConflicts: {
+        file: string;
+        teammates: string[];
+    }[];
+    /** Per-spec criteria coverage report. */
+    criteriaReport: {
+        specId: string;
+        covered: number;
+        total: number;
+    }[];
+    /** Recommended order for merging teammate branches. */
+    mergeOrder: string[];
+    /** Human-readable summary of validation results. */
+    summary: string;
+}
+/** Minimal spec-like input for the distribution planner. */
+export interface TeamPlannerSpecInput {
+    id: string;
+    title: string;
+    criteria?: string[];
+}
+/** Minimal reference to a team template. */
+export interface TeamTemplateRef {
+    id: string;
+    name: string;
+}
+/** Output produced by a teammate, used for validation. */
+export interface TeammateOutput {
+    name: string;
+    modifiedFiles: string[];
+    coveredCriteria: string[];
+}
+/** Input for the plan_team_distribution tool. */
+export interface PlanTeamDistributionInput {
+    /** Project identifier. */
+    projectId: string;
+    /** Spec IDs to distribute across the team. */
+    specIds: string[];
+    /** Optional template ID to use for team composition. */
+    template?: string;
+}
+/** Input for the generate_teammate_prompt tool. */
+export interface GenerateTeammatePromptInput {
+    /** Project identifier. */
+    projectId: string;
+    /** Spec ID assigned to this teammate. */
+    specId: string;
+    /** Name for this teammate. */
+    teammateName: string;
+    /** Files assigned to this teammate. */
+    assignedFiles: string[];
+    /** Role for this teammate. */
+    role: AgentRole;
+}
+/** Input for the validate_team_results tool. */
+export interface ValidateTeamResultsInput {
+    /** Project identifier. */
+    projectId: string;
+    /** Spec IDs that were distributed. */
+    specIds: string[];
+    /** Names of teammates whose results to validate. */
+    teammateNames: string[];
+}
+//# sourceMappingURL=team-planner.d.ts.map

package/dist/types/team-planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-planner.d.ts","sourceRoot":"","sources":["../../src/types/team-planner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7D,mEAAmE;AACnE,MAAM,WAAW,oBAAoB;IACnC,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,6DAA6D;IAC7D,cAAc,EAAE,kBAAkB,EAAE,CAAC;IACrC,2DAA2D;IAC3D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,4DAA4D;AAC5D,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,IAAI,EAAE,SAAS,CAAC;IAChB,4CAA4C;IAC5C,KAAK,EAAE,SAAS,CAAC;IACjB,iDAAiD;IACjD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,yDAAyD;IACzD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,uEAAuE;AACvE,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAED,yCAAyC;AACzC,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,0CAA0C;IAC1C,KAAK,EAAE,SAAS,CAAC;IACjB,oDAAoD;IACpD,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC;CAC5B;AAED,uEAAuE;AACvE,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,WAAW,EAAE,OAAO,CAAC;IACrB,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,0DAA0D;IAC1D,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,oEAAoE;AACpE,MAAM,WAAW,qBAAqB;IACpC,qEAAqE;IACrE,eAAe,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,mDAAmD;IACnD,WAAW,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC/D,yDAAyD;IACzD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,2CAA2C;IAC3C,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,mDAAmD;IACnD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,mEAAmE;IACnE,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,sDAAsD;IACtD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,4DAA4D;IAC5D,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,sEAAsE;AACtE,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,MAAM,EAAE,OAAO,CAAC;IAChB,+CAA+C;IAC/C,eAAe,EAAE,OAAO,CAAC;IACzB,8BAA8B;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,4BAA4B;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB,4CAA4C;IAC5C,cAAc,EAAE,OAAO,CAAC;IACxB,6DAA6D;IAC7D,aAAa,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IACvD,yCAAyC;IACzC,cAAc,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACrE,uDAAuD;IACvD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,4DAA4D;AAC5D,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,4CAA4C;AAC5C,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,0DAA0D;AAC1D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAID,iDAAiD;AACjD,MAAM,WAAW,yBAAyB;IACxC,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,mDAAmD;AACnD,MAAM,WAAW,2BAA2B;IAC1C,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,8BAA8B;IAC9B,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,gDAAgD;AAChD,MAAM,WAAW,wBAAwB;IACvC,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oDAAoD;IACpD,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB"}

package/dist/types/team-planner.js

@@ -0,0 +1,3 @@
+// Planu — Team Planner types for Claude Code Agent Teams (SPEC-091)
+export {};
+//# sourceMappingURL=team-planner.js.map

package/dist/types/team-planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-planner.js","sourceRoot":"","sources":["../../src/types/team-planner.ts"],"names":[],"mappings":"AAAA,oEAAoE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@planu/cli",
-  "version": "0.32.0",
+  "version": "0.33.1",
   "description": "Planu — MCP Server for Spec Driven Development. Manages specs, estimations, reverse engineering, and auto-learning across any language/framework.",
   "type": "module",
   "main": "dist/index.js",

package/src/config/license-plans.json

@@ -71,6 +71,7 @@
     "generate_rules",
     "generate_skill",
     "generate_sub_agent",
+    "generate_teammate_prompt",
     "integrate_pm",
     "log_decision",
     "manage_context",
@@ -79,6 +80,7 @@
     "orchestrate",
     "orchestrate_agents",
     "package_handoff",
+    "plan_team_distribution",
     "paradigm_report",
     "plan_upgrade",
     "reality_check",
@@ -118,7 +120,8 @@
     "create_pr_from_spec",
     "review_pr",
     "create_release",
-    "generate_changelog"
+    "generate_changelog",
+    "validate_team_results"
   ],
   "alwaysAllowed": [
     "activate_license",

package/src/config/team-templates.json

@@ -0,0 +1,39 @@
+[
+  {
+    "id": "implement-and-test",
+    "name": "Implement & Test",
+    "description": "1 implementer + 1 tester per spec",
+    "pattern": "implement-and-test",
+    "roles": [
+      { "role": "implementer", "model": "sonnet", "count": "per-spec" },
+      { "role": "tester", "model": "sonnet", "count": "per-spec" }
+    ]
+  },
+  {
+    "id": "full-stack",
+    "name": "Full Stack",
+    "description": "Frontend + backend + test teammates",
+    "pattern": "full-stack",
+    "roles": [
+      { "role": "implementer", "model": "sonnet", "count": 2 },
+      { "role": "tester", "model": "sonnet", "count": 1 }
+    ]
+  },
+  {
+    "id": "research-then-build",
+    "name": "Research Then Build",
+    "description": "1 researcher feeds N implementers",
+    "pattern": "research-then-build",
+    "roles": [
+      { "role": "researcher", "model": "opus", "count": 1 },
+      { "role": "implementer", "model": "sonnet", "count": "per-spec" }
+    ]
+  },
+  {
+    "id": "parallel-specs",
+    "name": "Parallel Specs",
+    "description": "N implementers for independent specs",
+    "pattern": "parallel-specs",
+    "roles": [{ "role": "implementer", "model": "sonnet", "count": "per-spec" }]
+  }
+]