@planu/cli 5.7.5 → 5.7.7

package/dist/tools/init-project/portable-index-reconciler.d.ts

@@ -1,3 +1,4 @@
+import type { WorkflowSkillGenerationResult } from '../../types/skill-registry.js';
 import type { FilesystemImportDeps, FilesystemImportFailure, LegacyGuidanceScanResult, PortableIndexReconciliationResult, SkippedLegacyContract } from '../../types/index.js';
 import type { ToolResult } from '../../types/common/primitives.js';
 /** Autopilot-first summary of fatal reconciliation failures: what failed, why, and the next action. */
@@ -10,7 +11,7 @@ export declare function describeReconciliationOutcome(reconciliation: PortableIn
  * SPEC-1716: Build the already-initialized `init_project` result, folding the
  * legacy-guidance scan's healed paths into the reported repository file changes.
  */
-export declare function buildAlreadyInitializedResult(projectId: string, reconciliation: PortableIndexReconciliationResult, legacyMigratedPaths: readonly string[], refreshedAssets: readonly string[], legacyGuidanceScan: LegacyGuidanceScanResult, projectPath: string): ToolResult;
+export declare function buildAlreadyInitializedResult(projectId: string, reconciliation: PortableIndexReconciliationResult, legacyMigratedPaths: readonly string[], refreshedAssets: readonly string[], legacyGuidanceScan: LegacyGuidanceScanResult, projectPath: string, skillSync?: WorkflowSkillGenerationResult | null): ToolResult;
 /** The subset of `MigrationRunResult` (migration-runner.ts) needed to report an authorized migration. */
 interface AuthorizedMigrationSummary {
     criticalMigrationFailures: unknown[];

package/dist/tools/init-project/portable-index-reconciler.js

@@ -160,14 +160,17 @@ export function describeReconciliationOutcome(reconciliation, repositoryFilesCha
  * SPEC-1716: Build the already-initialized `init_project` result, folding the
  * legacy-guidance scan's healed paths into the reported repository file changes.
  */
-export function buildAlreadyInitializedResult(projectId, reconciliation, legacyMigratedPaths, refreshedAssets, legacyGuidanceScan, projectPath) {
+export function buildAlreadyInitializedResult(projectId, reconciliation, legacyMigratedPaths, refreshedAssets, legacyGuidanceScan, projectPath, skillSync = null) {
     const repositoryFilesChanged = [...refreshedAssets, ...legacyGuidanceScan.healed];
     const baseText = describeReconciliationOutcome(reconciliation, [...refreshedAssets]);
     const healedGuidanceSuffix = legacyGuidanceScan.healed.length === 0
         ? ''
         : ` Healed stale legacy guidance in: ${legacyGuidanceScan.healed.join(', ')}.`;
+    const skillSyncSuffix = skillSync === null
+        ? ''
+        : ` Refreshed ${String(skillSync.written.length)} workflow skill(s), left ${String(skillSync.userModified.length)} user-modified skill(s) untouched.`;
     return {
-        content: [{ type: 'text', text: baseText + healedGuidanceSuffix }],
+        content: [{ type: 'text', text: baseText + healedGuidanceSuffix + skillSyncSuffix }],
         structuredContent: {
             projectId,
             ...(reconciliation.failures.length === 0 ? { projectPath } : {}),
@@ -181,6 +184,8 @@ export function buildAlreadyInitializedResult(projectId, reconciliation, legacyM
             migratedLegacyPaths: legacyMigratedPaths,
             legacyGuidanceHealed: legacyGuidanceScan.healed,
             legacyGuidanceWarnings: legacyGuidanceScan.warnings,
+            skillsWritten: skillSync?.written.length ?? 0,
+            skillsUserModified: skillSync?.userModified.length ?? 0,
         },
         ...(reconciliation.failures.length > 0 ? { isError: true } : {}),
     };

package/dist/tools/init-project/rules-generator.d.ts

@@ -1,14 +1,3 @@
-export declare function generateAgentTeamsRulesContent(): string;
-/**
- * Write .claude/rules/agent-teams.md to the target project.
- * Always overwrites to keep the content up to date.
- */
-export declare function generateAgentTeamsRules(projectPath: string): Promise<void>;
-/**
- * Write .claude/rules/agent-teams.md only if it does not exist yet.
- * @returns true if the file was created, false if it already existed.
- */
-export declare function generateAgentTeamsRulesIfMissing(projectPath: string): Promise<boolean>;
 /**
  * Write .claude/rules/planu-workflow.md to the target project.
  * Always overwrites to keep the content up to date.

package/dist/tools/init-project/rules-generator.js

@@ -18,12 +18,12 @@ Auto-generated by \`init_project\`. Do not edit manually.
 | implementing | work in progress |
 | done | implemented + validated |
 
-Flow: \`facilitate → create_spec → challenge_spec → check_readiness → approve → implement → validate (ack) → watch_job (completed) → inspect job.result → done\`
+Flow: \`facilitate → create_spec → challenge_spec → check_readiness → approve → implement → validate (ack) → get_job (poll until completed) → inspect job.result → done\`
 
 ## Durable Validation Gate
 
-1. Call \`validate\` and capture \`operationId\`, \`projectId\`, \`workspaceId\`, and \`cursor\` from the acknowledgement.
-2. Call \`watch_job\` with those identifiers and the latest cursor. Repeat while state is non-terminal.
+1. Call \`validate\` and capture \`operationId\`, \`projectId\`, and \`workspaceId\` from the acknowledgement.
+2. Poll \`get_job\` with those identifiers. Repeat while state is non-terminal.
 3. Require state \`completed\`, then inspect \`job.result.structuredContent\`. Stop and report \`failed\`, \`dead-letter\`, or \`cancelled\`.
 4. Call \`update_status(done)\` only after the completed result reports \`ready: true\`, \`status: "passing"\`, and passing quality gates.
 
@@ -60,7 +60,7 @@ Any new feature, bug fix, refactor, integration, or task > 5 min.
 |------|------|
 | New feature | \`facilitate("what to build")\` |
 | Project status | \`planu_status\` |
-| Find related specs | \`semantic_search("keywords")\` |
+| Find related specs | \`list_specs\` and scan titles |
 | List approved work | \`list_specs\` with \`status: approved\` |
 | Mark done | \`update_status\` → \`done\` |
 | Verify | \`validate\` |
@@ -102,87 +102,6 @@ Set \`CLAUDE_CODE_SUBAGENT_MODEL=haiku\` in \`.env\` for automatic haiku on all
 - Keep output < 500 tokens for read operations, < 200 tokens for write confirmations
 - After every tool call: explain what happened in simple terms
 `;
-const AGENT_TEAMS_RULES_PATH = '.claude/rules/agent-teams.md';
-export function generateAgentTeamsRulesContent() {
-    return `# Agent Teams (MANDATORY when 3+ specs in parallel)
-
-This rule file is auto-generated by Planu \`init_project\`. Do not edit manually — re-run \`init_project\` to update.
-
-## When to Use Agent Teams
-
-Use Agent Teams when ALL of the following apply:
-- 3+ independent specs are ready to implement simultaneously
-- Estimated total effort > 8h
-- Specs touch different modules/packages (clear file ownership boundaries)
-- Monorepo or multi-layer architecture with well-defined interfaces
-
-## File Ownership (MANDATORY)
-
-**Two teammates MUST NEVER modify the same file.** This is non-negotiable.
-
-- \`plan_team_distribution\` auto-assigns exclusive file ownership per agent
-- Review the distribution before spawning — resolve any conflicts first
-- If two specs require the same shared file, implement them sequentially, not in parallel
-
-## Workflow
-
-\`\`\`
-1. plan_team_distribution   # input: spec IDs → output: file ownership map
-2. generate_teammate_prompt # input: teammate assignment → output: isolated prompt
-3. spawn N agents           # claude -p "<prompt>" for each teammate (run in parallel)
-4. validate_team_results    # input: projectPath → verifies merged code integrity
-\`\`\`
-
-## Available Team Patterns
-
-- **implement-and-test** — one agent implements, another writes tests (zero shared files)
-- **full-stack** — frontend and backend agents with a contract-first API boundary
-- **research-then-build** — researcher gathers context first, builder implements after
-- **parallel-specs** — N agents implement N fully independent specs simultaneously
-
-## Quick Reference
-
-| Goal | Tool |
-|------|------|
-| Plan team distribution | \`plan_team_distribution\` with spec IDs array |
-| Get teammate context | \`generate_teammate_prompt\` with assignment object |
-| Validate merged result | \`validate_team_results\` after all agents complete |
-
-## Prohibited Patterns
-
-- NEVER spawn teammates without running \`plan_team_distribution\` first
-- NEVER assign the same file to two different teammates
-- NEVER skip \`validate_team_results\` after parallel implementation
-- NEVER use Agent Teams for 1-2 specs — sequential is faster and safer
-`;
-}
-/**
- * Write .claude/rules/agent-teams.md to the target project.
- * Always overwrites to keep the content up to date.
- */
-export async function generateAgentTeamsRules(projectPath) {
-    const rulesPath = join(projectPath, AGENT_TEAMS_RULES_PATH);
-    const rulesDir = join(projectPath, '.claude/rules');
-    await mkdir(rulesDir, { recursive: true });
-    const content = generateAgentTeamsRulesContent();
-    assertEnglishOnlyArtifactText(content, 'rule');
-    await writeFile(rulesPath, content, 'utf-8');
-}
-/**
- * Write .claude/rules/agent-teams.md only if it does not exist yet.
- * @returns true if the file was created, false if it already existed.
- */
-export async function generateAgentTeamsRulesIfMissing(projectPath) {
-    const rulesPath = join(projectPath, AGENT_TEAMS_RULES_PATH);
-    try {
-        await access(rulesPath);
-        return false; // already exists
-    }
-    catch {
-        await generateAgentTeamsRules(projectPath);
-        return true;
-    }
-}
 /**
  * Write .claude/rules/planu-workflow.md to the target project.
  * Always overwrites to keep the content up to date.

package/dist/tools/init-project/scaffold-writer.d.ts

@@ -22,7 +22,6 @@ export interface ScaffoldWriteResult {
     planuWorkflowInjected: boolean;
     planuHooksConfigured: boolean;
     planuRulesWritten: boolean;
-    agentTeamsRulesWritten: boolean;
     modeRulesWritten: boolean;
     responseStyleRulesWritten: boolean;
     compactSkillWritten: boolean;

package/dist/tools/init-project/scaffold-writer.js

@@ -8,7 +8,7 @@ import { runGitSetup } from './git-setup.js';
 import { generateAndWriteRules } from './lifecycle-helpers.js';
 import { generatePlanuSection, injectPlanuSection } from './planu-workflow-generator.js';
 import { configurePlanuHooks } from './hooks-configurator.js';
-import { generateWorkflowRulesIfMissing, generateAgentTeamsRulesIfMissing, generateModeRulesIfMissing, generateResponseStyleRulesIfMissing, } from './rules-generator.js';
+import { generateWorkflowRulesIfMissing, generateModeRulesIfMissing, generateResponseStyleRulesIfMissing, } from './rules-generator.js';
 import { generateCompactSkillIfMissing } from './skills-writer.js';
 import { generateFindSkillsIfMissing } from './find-skills-writer.js';
 import { injectPlanuAutoStage } from '../../engine/git-hook-injector.js';
@@ -120,16 +120,6 @@ export async function runScaffoldWriter(projectPath, projectId, knowledge, recom
             /* best-effort */
         }
     }
-    // SPEC-291: Write .claude/rules/agent-teams.md if missing (best-effort)
-    let agentTeamsRulesWritten = false;
-    if (shouldWriteClaudeAssets) {
-        try {
-            agentTeamsRulesWritten = await generateAgentTeamsRulesIfMissing(projectPath);
-        }
-        catch {
-            /* best-effort */
-        }
-    }
     // SPEC-494: Write .claude/rules/planu-modes.md if missing (best-effort)
     let modeRulesWritten = false;
     if (shouldWriteClaudeAssets) {
@@ -394,7 +384,6 @@ export async function runScaffoldWriter(projectPath, projectId, knowledge, recom
         planuWorkflowInjected,
         planuHooksConfigured,
         planuRulesWritten,
-        agentTeamsRulesWritten,
         modeRulesWritten,
         responseStyleRulesWritten,
         compactSkillWritten,

package/dist/tools/init-project/skills-multi-teammate-review-writer.js

@@ -31,7 +31,7 @@ triggers:
 
 # /planu-multi-teammate-review
 
-Invoke \`multi_teammate_review\` for a 5-specialist panel code review.
+Runs a 5-specialist panel code review directly — not an MCP tool call.
 `;
     }
 }

package/dist/tools/jobs/handlers.d.ts

@@ -4,12 +4,6 @@ export interface JobToolIdentityInput {
     projectId: string;
     workspaceId?: string;
 }
-export interface WatchJobToolInput extends JobToolIdentityInput {
-    afterCursor?: string;
-    timeoutMs?: number;
-}
 export declare function handleGetJob(input: JobToolIdentityInput): Promise<ToolResult>;
-export declare function handleWatchJob(input: WatchJobToolInput): Promise<ToolResult>;
-export declare function handleCancelJob(input: JobToolIdentityInput): Promise<ToolResult>;
 export declare function handleRestartJob(input: JobToolIdentityInput): Promise<ToolResult>;
 //# sourceMappingURL=handlers.d.ts.map

package/dist/tools/jobs/handlers.js

@@ -52,6 +52,7 @@ var __disposeResources = (this && this.__disposeResources) || (function (Suppres
 });
 import { DurableJobRuntime, publicJobCursor } from '../../engine/execution/job-runtime.js';
 import { scheduleValidateJobExecution } from '../../engine/execution/validate-job-executor.js';
+import { schedulePackageHandoffJobExecution } from '../../engine/execution/package-handoff-job-executor.js';
 import { isValidationReceiptPendingIntent, parseValidationReceiptPendingCheckpoint, } from '../../types/durable-validation.js';
 import { redactText } from '../../security/redactor.js';
 import { getRuntimePolicy } from '../../engine/runtime-policy.js';
@@ -97,62 +98,34 @@ export function handleGetJob(input) {
         __disposeResources(env_1);
     }
 }
-export async function handleWatchJob(input) {
+export function handleRestartJob(input) {
     const env_2 = { stack: [], error: void 0, hasError: false };
     try {
         const runtime = __addDisposableResource(env_2, new DurableJobRuntime(), false);
-        const job = await runtime.watch(input);
-        const observation = publicJob(runtime, job);
-        return result({ schemaVersion: 1, job: observation, cursor: publicJobCursor(observation) });
-    }
-    catch (e_2) {
-        env_2.error = e_2;
-        env_2.hasError = true;
-    }
-    finally {
-        __disposeResources(env_2);
-    }
-}
-export function handleCancelJob(input) {
-    const env_3 = { stack: [], error: void 0, hasError: false };
-    try {
-        const runtime = __addDisposableResource(env_3, new DurableJobRuntime(), false);
-        const job = runtime.cancel(input);
-        const observation = publicJob(runtime, job);
-        return Promise.resolve(result({ schemaVersion: 1, job: observation, cursor: publicJobCursor(observation) }));
-    }
-    catch (e_3) {
-        env_3.error = e_3;
-        env_3.hasError = true;
-    }
-    finally {
-        __disposeResources(env_3);
-    }
-}
-export function handleRestartJob(input) {
-    const env_4 = { stack: [], error: void 0, hasError: false };
-    try {
-        const runtime = __addDisposableResource(env_4, new DurableJobRuntime(), false);
         const current = runtime.get(input);
         const pending = parseValidationReceiptPendingCheckpoint(current.checkpoint, checkpointLimits());
         if (!pending && isValidationReceiptPendingIntent(current.checkpoint)) {
             throw new Error('[Planu] Invalid validation receipt checkpoint');
         }
         const job = pending ? runtime.restartReceiptPublication(input) : runtime.restart(input);
-        if (job.payload &&
-            typeof job.payload === 'object' &&
-            job.payload.kind === 'validate') {
+        const kind = job.payload && typeof job.payload === 'object'
+            ? job.payload.kind
+            : undefined;
+        if (kind === 'validate') {
             scheduleValidateJobExecution(job.projectId, job.workspaceId);
         }
+        else if (kind === 'package-handoff') {
+            schedulePackageHandoffJobExecution(job.projectId, job.workspaceId);
+        }
         const observation = publicJob(runtime, job);
         return Promise.resolve(result({ schemaVersion: 1, job: observation, cursor: publicJobCursor(observation) }));
     }
-    catch (e_4) {
-        env_4.error = e_4;
-        env_4.hasError = true;
+    catch (e_2) {
+        env_2.error = e_2;
+        env_2.hasError = true;
     }
     finally {
-        __disposeResources(env_4);
+        __disposeResources(env_2);
     }
 }
 //# sourceMappingURL=handlers.js.map

package/dist/tools/list-specs.js

@@ -156,21 +156,6 @@ export async function handleListSpecs(params) {
                     lastModifiedMap.set(spec.id, formatRelativeDate(spec.updatedAt));
                 }
             }
-            // SPEC-091: Auto-suggest Agent Teams when 3+ approved specs exist
-            const approvedSpecs = allSpecs.filter((s) => s.status === 'approved');
-            let teamSuggestion = null;
-            if (approvedSpecs.length >= 3) {
-                teamSuggestion = {
-                    recommended: true,
-                    reason: `${String(approvedSpecs.length)} approved specs can be implemented in parallel using Agent Teams.`,
-                    templateId: 'parallel-specs',
-                    teamSize: Math.min(approvedSpecs.length, 5),
-                    specs: approvedSpecs.map((s) => s.id),
-                    toolCalls: [
-                        `plan_team_distribution({ projectId: "${projectId}", specIds: [${approvedSpecs.map((s) => `"${s.id}"`).join(', ')}], template: "parallel-specs" })`,
-                    ],
-                };
-            }
             // Build spec data — summary mode returns 5 fields, full mode returns all
             const specsData = detail === 'summary'
                 ? specs.map((s) => ({
@@ -232,11 +217,15 @@ export async function handleListSpecs(params) {
                         totalReviewHours: Math.round(totalReviewHours * 10) / 10,
                         totalCostUsd: Math.round(totalCostUsd * 100) / 100,
                     },
-                    teamSuggestion,
                     message: ti('tools.list_specs.success', { count: String(specs.length) }),
                 });
             }
-            const humanSummary = buildListSpecsSummary(allSpecs.length, statusCounts);
+            const filterApplied = Boolean(status) || Boolean(type);
+            const humanSummary = filterApplied && specs.length === 0
+                ? `No plans match the current filter.`
+                : filterApplied
+                    ? buildListSpecsSummary(specs.length, specs.reduce((acc, s) => ({ ...acc, [s.status]: (acc[s.status] ?? 0) + 1 }), {}))
+                    : buildListSpecsSummary(allSpecs.length, statusCounts);
             // SPEC-467: Detect branches and include info for LLM branch-awareness
             let branchInfo = null;
             if (detail === 'full' && knowledge.projectPath) {
@@ -317,11 +306,7 @@ export async function handleListSpecs(params) {
                     totalReviewHours: Math.round(totalReviewHours * 10) / 10,
                     totalCostUsd: Math.round(totalCostUsd * 100) / 100,
                 },
-                teamSuggestion: teamSuggestion ?? null,
                 message: ti('tools.list_specs.success', { count: String(specs.length) }),
-                teamDistributionHint: approvedSpecs.length >= 3
-                    ? `${String(approvedSpecs.length)} specs approved — run plan_team_distribution for parallel assignment`
-                    : undefined,
                 humanSummary,
                 branchInfo: branchInfo && branchInfo.count > 1 ? branchInfo : undefined,
                 autopilotSummary: collector.hasEntries() ? collector.getMessages() : undefined,

package/dist/tools/multi-teammate-review.js

@@ -1,11 +1,5 @@
-// tools/multi-teammate-review.ts — MCP tool registration for multi-teammate review (SPEC-593)
-// NOTE (SPEC-658): registerMultiTeammateReviewTool now registers a deprecation stub.
-// The underlying handleMultiTeammateReview logic is kept for direct import by skills/tests.
 import { z } from 'zod';
-// safeTracked removed — registration replaced by deprecation stub (SPEC-658)
 import { toolResult, formatError } from './response-helpers.js';
-import { makeDeprecationStub } from './tool-registry/deprecated-stubs.js';
-import { registerFromEntries } from './tool-entry.js';
 import { runReviewPanel } from '../engine/multi-teammate-review/panel-orchestrator.js';
 import { buildModelHeader } from '../engine/model-router/subtask-model-assigner.js';
 // ---------------------------------------------------------------------------
@@ -117,14 +111,7 @@ export async function handleMultiTeammateReview(args) {
     ];
     return toolResult(outputLines.join('\n'));
 }
-// ---------------------------------------------------------------------------
-// Tool registration (SPEC-658: replaced with deprecation stub)
-// ---------------------------------------------------------------------------
 export function registerMultiTeammateReviewTool(s) {
-    // multi_teammate_review has been migrated to .claude/skills/review-and-merge.md
-    // The tool stays registered so callers receive a helpful message, not "unknown tool".
-    registerFromEntries(s, [
-        makeDeprecationStub('multi_teammate_review', '.claude/skills/review-and-merge.md', 'review-and-merge'),
-    ]);
+    void s;
 }
 //# sourceMappingURL=multi-teammate-review.js.map

package/dist/tools/package-handoff.d.ts

@@ -1,4 +1,5 @@
-import type { ToolResult, PackageHandoffInput, HandoffPackage } from '../types/index.js';
-export declare function formatHandoff(pkg: HandoffPackage): string;
+import type { ToolResult, PackageHandoffInput } from '../types/index.js';
+export { formatHandoff } from '../engine/handoff-format.js';
+/** Public MCP boundary: submit the handoff job and acknowledge without packaging inline. */
 export declare function handlePackageHandoff(args: PackageHandoffInput): Promise<ToolResult>;
 //# sourceMappingURL=package-handoff.d.ts.map