@planu/cli 5.7.5 → 5.7.7

package/dist/tools/register-platform-tools/design-stack-tools.js

@@ -67,17 +67,17 @@ export function registerDesignStackTools(server) {
         description: t('tools.challenge_spec.description'),
         annotations: { readOnlyHint: true },
         inputSchema: {
-            specId: SpecIdSchema.describe('Spec ID to challenge'),
+            specId: SpecIdSchema.describe('Spec ID to challenge. Must match pattern ^SPEC-\\d+$, max 50 characters.'),
             projectId: z
                 .string()
                 .max(500)
                 .optional()
-                .describe('Project ID hash. Prefer projectPath — stays correct after context compaction.'),
+                .describe('Project ID hash. Prefer projectPath — stays correct after context compaction. Max 500 characters.'),
             projectPath: z
                 .string()
                 .max(4096)
                 .optional()
-                .describe('Absolute path to project root. Derives projectId automatically — always correct even after context compaction.'),
+                .describe('Max 4096 characters. Absolute path to project root. Derives projectId automatically — always correct even after context compaction.'),
             focus: z
                 .array(ChallengeSpecFocusEnum)
                 .max(100)

package/dist/tools/register-sdd-tools.js

@@ -9,7 +9,6 @@ import { registerDesignStackTools } from './register-platform-tools/design-stack
 import { registerQualityComplianceGroupTools } from './tool-registry/group-quality-compliance.js';
 import { registerInfraGroupTools } from './tool-registry/group-infra.js';
 import { safe } from './safe-handler.js';
-import { handleCreateRule } from './create-rule.js';
 import { handleCreateSkill } from './create-skill.js';
 import { handleReconcileUniversalRules } from './reconcile-universal-rules.js';
 import { registerBumpSpecVersionTool } from './bump-spec-version.js';
@@ -43,28 +42,6 @@ function registerOnly(server, names, register) {
     register(scopedServer);
 }
 function registerUniversalRulesTools(s) {
-    s.registerTool('create_rule', {
-        description: 'Create a host-aware rule file for a Planu project. For Claude Code, writes to `.claude/rules/{name}.md`. For Codex, inserts a delimited block in `AGENTS.md`. For Gemini, inserts a delimited block in `.gemini/conventions.md`. Use host: "auto" to detect the current host automatically.',
-        inputSchema: {
-            projectPath: z
-                .string()
-                .describe('Absolute path to the project root where the rule will be written'),
-            name: z
-                .string()
-                .min(1)
-                .describe('Rule identifier — kebab-case, no extension (e.g. "team-style").'),
-            content: z.string().min(1).describe('Markdown body of the rule (no frontmatter required)'),
-            host: z
-                .enum(['claude-code', 'codex', 'gemini', 'auto'])
-                .default('auto')
-                .describe('Target host or auto-detection.'),
-            overwriteExisting: z
-                .boolean()
-                .optional()
-                .describe('When true, overwrite an existing file with different content.'),
-        },
-        annotations: { readOnlyHint: false, destructiveHint: false, title: 'Create Rule' },
-    }, safe((args) => handleCreateRule(args)));
     s.registerTool('create_skill', {
         description: 'Create a host-aware skill for a Planu project. For Claude Code, writes to `.claude/skills/{name}/SKILL.md`. For Codex, inserts a skill block in `AGENTS.md`. For Gemini, writes to `.gemini/skills/{name}.md`. Use host: "auto" to detect the current host automatically.',
         inputSchema: {

package/dist/tools/register-spec-tools/analysis-tools.js

@@ -26,7 +26,7 @@ export const DeclaredDriftInputSchema = z.object({
         .string()
         .min(100)
         .max(10_000)
-        .describe('Why the implementation drifted from the approved architectural premise. Minimum 100 characters — becomes the reconciliation transition reason.'),
+        .describe('Min 100, max 10000 characters. Why the implementation drifted from the approved architectural premise — becomes the reconciliation transition reason.'),
 });
 import { handleSsrBackMigration } from '../ssr-back-migration.js';
 import { registerMigrateLegacySpecTool } from '../migrate-legacy-spec.js';
@@ -115,13 +115,17 @@ export function registerAnalysisTools(server) {
     server.registerTool('reconcile_spec', {
         description: t('tools.reconcile_spec.description'),
         inputSchema: {
-            specId: SpecIdSchema.describe('Spec ID to reconcile'),
-            projectId: z.string().max(500).optional().describe('Project ID hash. Prefer projectPath.'),
+            specId: SpecIdSchema.describe('Spec ID to reconcile. Must match pattern ^SPEC-\\d+$, max 50 characters.'),
+            projectId: z
+                .string()
+                .max(500)
+                .optional()
+                .describe('Project ID hash. Prefer projectPath. Max 500 characters.'),
             projectPath: z
                 .string()
                 .max(4096)
                 .optional()
-                .describe('Absolute path to project root. Derives projectId automatically.'),
+                .describe('Absolute path to project root. Derives projectId automatically. Max 4096 characters.'),
             autoDetect: z
                 .boolean()
                 .optional()
@@ -132,11 +136,20 @@ export function registerAnalysisTools(server) {
                 .describe('Enable living spec mode: compare acceptance criteria against codebase, auto-mark criteria as met/pending/drift, update the ## Progress section of spec.md (default: false)'),
             changes: z
                 .array(z.object({
-                section: z.string().max(500),
-                originalValue: z.string().max(10_000),
-                newValue: z.string().max(10_000),
-                reason: z.string().max(10_000),
-                approved: z.boolean(),
+                section: z
+                    .string()
+                    .max(500)
+                    .describe('Max 500 characters. Spec section the change applies to.'),
+                originalValue: z
+                    .string()
+                    .max(10_000)
+                    .describe('Max 10000 characters. Current text being replaced.'),
+                newValue: z.string().max(10_000).describe('Max 10000 characters. Replacement text.'),
+                reason: z
+                    .string()
+                    .max(10_000)
+                    .describe('Max 10000 characters. Why the change is needed.'),
+                approved: z.boolean().describe('Whether the user approved this change.'),
             }))
                 .max(1000)
                 .optional()

package/dist/tools/register-spec-tools/core-spec-tools.js

@@ -7,7 +7,6 @@ import { handleSetLocale } from '../set-locale.js';
 import { handleInitProject } from '../init-project.js';
 import { handleSetWorkMode } from '../set-work-mode-handler.js';
 import { handleInitConstitution } from '../init-constitution.js';
-import { handleClarifyRequirements } from '../clarify-requirements.js';
 import { handleCreateSpec } from '../create-spec.js';
 import { handleListSpecs } from '../list-specs.js';
 import { handleUpdateStatus } from '../update-status.js';
@@ -19,7 +18,10 @@ import { handleTypeSafetyGate } from '../type-safety-gate.js';
 import { runWithTrustedLocalMcpContext } from '../../engine/lifecycle-reconciliation.js';
 /** init_project inputSchema — extracted to keep registerCoreSpecTools within line budget. */
 const INIT_PROJECT_INPUT_SCHEMA = {
-    projectPath: z.string().max(4096).describe('Absolute path to the project root'),
+    projectPath: z
+        .string()
+        .max(4096)
+        .describe('Absolute path to the project root. Max 4096 characters.'),
     mode: z
         .enum(['existing_project', 'new_project'])
         .optional()
@@ -28,18 +30,40 @@ const INIT_PROJECT_INPUT_SCHEMA = {
         .string()
         .max(4096)
         .optional()
-        .describe('Parent workspace path for explicit new_project onboarding'),
-    appName: z.string().max(500).optional().describe('Human-readable app name for new_project'),
+        .describe('Parent workspace path for explicit new_project onboarding. Max 4096 characters.'),
+    appName: z
+        .string()
+        .max(500)
+        .optional()
+        .describe('Human-readable app name for new_project. Max 500 characters.'),
     appSlug: z
         .string()
         .max(200)
         .optional()
-        .describe('Safe folder slug for new_project; must not contain path separators'),
-    projectType: z.string().max(500).optional().describe('Type of project being initialized'),
-    platform: z.string().max(500).optional().describe('Runtime/deployment platform'),
-    language: z.string().max(500).optional().describe('User-confirmed language'),
-    framework: z.string().max(500).nullable().optional().describe('User-confirmed framework'),
-    database: z.string().max(500).nullable().optional().describe('User-confirmed database'),
+        .describe('Safe folder slug for new_project; must not contain path separators. Max 200 characters.'),
+    projectType: z
+        .string()
+        .max(500)
+        .optional()
+        .describe('Type of project being initialized. Max 500 characters.'),
+    platform: z
+        .string()
+        .max(500)
+        .optional()
+        .describe('Runtime/deployment platform. Max 500 characters.'),
+    language: z.string().max(500).optional().describe('User-confirmed language. Max 500 characters.'),
+    framework: z
+        .string()
+        .max(500)
+        .nullable()
+        .optional()
+        .describe('Max 500 characters. User-confirmed framework.'),
+    database: z
+        .string()
+        .max(500)
+        .nullable()
+        .optional()
+        .describe('Max 500 characters. User-confirmed database.'),
     createDirectory: z
         .boolean()
         .optional()
@@ -159,37 +183,15 @@ export function registerCoreSpecTools(server) {
                 .describe('Manual principles to include'),
         },
     }, safeTracked('init_constitution', async (args) => handleInitConstitution(args)));
-    // 4. clarify_requirements
-    server.registerTool('clarify_requirements', {
-        description: t('tools.clarify_requirements.description'),
-        inputSchema: {
-            projectId: z.string().max(500).describe('Project ID'),
-            topic: z.string().max(500).describe('The topic or feature to clarify'),
-            context: z
-                .string()
-                .max(10_000)
-                .optional()
-                .describe('Additional context about the requirement'),
-            maxQuestions: z
-                .number()
-                .optional()
-                .describe('Maximum number of questions to generate (default: 5)'),
-            sessionId: z
-                .string()
-                .max(500)
-                .optional()
-                .describe('Existing clarification session to resume with user-confirmed answers.'),
-            answers: z
-                .record(z.string(), z.string())
-                .optional()
-                .describe('Explicit user-confirmed answers keyed by clarification question ID.'),
-        },
-    }, safeTracked('clarify_requirements', async (args) => handleClarifyRequirements(args, server)));
     // 5. create_spec
     server.registerTool('create_spec', {
         description: t('tools.create_spec.description'),
         inputSchema: {
-            title: z.string().min(1).max(500).describe('Title of the spec / user story'),
+            title: z
+                .string()
+                .min(1)
+                .max(500)
+                .describe('Title of the spec / user story. Max 500 characters.'),
             description: z
                 .string()
                 .max(10_000)
@@ -203,21 +205,25 @@ export function registerCoreSpecTools(server) {
                 .max(128)
                 .regex(/^[A-Za-z0-9._:-]+$/)
                 .optional()
-                .describe('Stable caller key. Retries return the exact committed create_spec result.'),
+                .describe('Must match pattern ^[A-Za-z0-9._:-]+$, max 128 characters. Stable caller key — retries return the exact committed create_spec result.'),
             projectPath: z
                 .string()
                 .max(4096)
                 .optional()
-                .describe('Absolute path to the project root. Auto-detected from git root when omitted.'),
+                .describe('Max 4096 characters. Absolute path to the project root. Auto-detected from git root when omitted.'),
             type: SpecTypeEnum.optional().describe('Spec type (default: feature)'),
             scope: SpecScopeEnum.optional().describe('Spec scope (default: feature)'),
             target: SpecTargetEnum.optional().describe('Target area: frontend, backend, shared, fullstack, infrastructure, database'),
-            tags: z.array(z.string().max(500)).max(100).optional().describe('Tags for categorization'),
+            tags: z
+                .array(z.string().max(500))
+                .max(100)
+                .optional()
+                .describe('Tags for categorization. Each tag max 500 characters.'),
             feature: z
                 .string()
                 .max(500)
                 .optional()
-                .describe('Feature group tag (e.g. "Authentication", "Billing"). Added to tags for categorization. Flat structure — no subdirectories created.'),
+                .describe('Max 500 characters. Feature group tag (e.g. "Authentication", "Billing"). Added to tags for categorization. Flat structure — no subdirectories created.'),
             acFormat: SpecAcFormatEnum.optional().describe('SPEC-224: Format for acceptance criteria in spec.md. ' +
                 'checkbox (default) — markdown checkboxes (- [ ] criterion). ' +
                 'bdd — Gherkin Given-When-Then scenarios for BDD workflows.'),
@@ -269,12 +275,12 @@ export function registerCoreSpecTools(server) {
                 .string()
                 .max(500)
                 .optional()
-                .describe('Project ID (hash). Prefer projectPath if unknown.'),
+                .describe('Max 500 characters. Project ID (hash). Prefer projectPath if unknown.'),
             projectPath: z
                 .string()
                 .max(4096)
                 .optional()
-                .describe('Absolute path to the project root. Used to derive projectId automatically.'),
+                .describe('Max 4096 characters. Absolute path to the project root. Used to derive projectId automatically.'),
             status: SpecStatusEnum.optional().describe('Filter by spec status'),
             type: SpecTypeEnum.optional().describe('Filter by spec type'),
             detail: z
@@ -302,28 +308,28 @@ export function registerCoreSpecTools(server) {
     server.registerTool('update_status', {
         description: t('tools.update_status.description'),
         inputSchema: {
-            specId: SpecIdSchema.describe('Spec ID to update'),
+            specId: SpecIdSchema.describe('Spec ID to update. Must match pattern ^SPEC-\\d+$ (e.g. SPEC-042), max 50 characters.'),
             projectId: z
                 .string()
                 .max(500)
                 .optional()
-                .describe('Project ID (hash). Prefer projectPath if unknown.'),
+                .describe('Project ID (hash). Prefer projectPath if unknown. Max 500 characters.'),
             projectPath: z
                 .string()
                 .max(4096)
                 .optional()
-                .describe('Absolute path to the project root. Used to derive projectId automatically.'),
+                .describe('Absolute path to the project root. Used to derive projectId automatically. Max 4096 characters.'),
             status: SpecStatusEnum.describe('New status'),
             sessionId: z
                 .string()
                 .max(500)
                 .optional()
-                .describe('Agent/session ID performing this lifecycle transition.'),
+                .describe('Agent/session ID performing this lifecycle transition. Max 500 characters.'),
             modelId: z
                 .string()
                 .max(500)
                 .optional()
-                .describe('Concrete model ID used for this transition. Can satisfy SDD model-routing evidence when it maps to the required tier.'),
+                .describe('Max 500 characters. Concrete model ID used for this transition. Can satisfy SDD model-routing evidence when it maps to the required tier.'),
             modelTierUsed: z
                 .enum(['max', 'implementation', 'review'])
                 .optional()
@@ -332,27 +338,27 @@ export function registerCoreSpecTools(server) {
                 .string()
                 .max(500)
                 .optional()
-                .describe('SHA-256 hash of the persisted context package used to prove context continuity across agents.'),
+                .describe('Max 500 characters. SHA-256 hash of the persisted context package used to prove context continuity across agents.'),
             handoffPath: z
                 .string()
                 .max(4096)
                 .optional()
-                .describe('Path to the persisted handoff package generated by package_handoff. Required for implementing/done unless handoffArtifactId is provided.'),
+                .describe('Max 4096 characters. Path to the persisted handoff package generated by package_handoff. Required for implementing/done unless handoffArtifactId is provided.'),
             handoffArtifactId: z
                 .string()
                 .max(500)
                 .optional()
-                .describe('External handoff artifact ID when the host stores handoff evidence outside the filesystem.'),
+                .describe('Max 500 characters. External handoff artifact ID when the host stores handoff evidence outside the filesystem.'),
             reviewedBy: z
                 .string()
                 .max(500)
                 .optional()
-                .describe('Reviewer identity/evidence required before status=done.'),
+                .describe('Reviewer identity/evidence required before status=done. Max 500 characters.'),
             arbitratedBy: z
                 .string()
                 .max(500)
                 .optional()
-                .describe('Arbiter identity/evidence required before status=done.'),
+                .describe('Arbiter identity/evidence required before status=done. Max 500 characters.'),
             reconcileRequired: z
                 .boolean()
                 .optional()
@@ -366,8 +372,16 @@ export function registerCoreSpecTools(server) {
                 apiCostUsd: z.number().min(0).optional(),
                 humanCostUsd: z.number().min(0).optional(),
                 totalCostUsd: z.number().min(0).optional(),
-                completedAt: z.string().max(500).optional(),
-                notes: z.string().max(10_000).optional(),
+                completedAt: z
+                    .string()
+                    .max(500)
+                    .optional()
+                    .describe('ISO timestamp. Max 500 characters.'),
+                notes: z
+                    .string()
+                    .max(10_000)
+                    .optional()
+                    .describe('Free-text notes. Max 10000 characters.'),
             })
                 .optional()
                 .describe('Actual metrics for status = done. All fields optional (SPEC-1356): missing numeric fields default to 0, completedAt/notes are auto-filled when omitted.'),
@@ -375,7 +389,7 @@ export function registerCoreSpecTools(server) {
                 .string()
                 .max(10_000)
                 .optional()
-                .describe('Feedback or observations when sending a spec back (e.g., review→draft). Stored in the spec for the implementer to address.'),
+                .describe('Max 10000 characters. Feedback or observations when sending a spec back (e.g., review→draft). Stored in the spec for the implementer to address.'),
             force: z
                 .boolean()
                 .optional()
@@ -388,7 +402,7 @@ export function registerCoreSpecTools(server) {
                 .string()
                 .max(2000)
                 .optional()
-                .describe('SPEC-721: Required when forceStatus=true. ≥100 characters explaining why validate gate is bypassed.'),
+                .describe('SPEC-721: Required when forceStatus=true. ≥100 and <=2000 characters explaining why validate gate is bypassed.'),
             dry_run: z
                 .boolean()
                 .optional()
@@ -397,18 +411,24 @@ export function registerCoreSpecTools(server) {
                 .string()
                 .max(2000)
                 .optional()
-                .describe('SPEC-733: Required for reverse transitions (done→implementing, discarded→draft). Must be ≥30 chars explaining why the spec is being reopened.'),
+                .describe('Must be ≥30 and <=2000 chars. SPEC-733: Required for reverse transitions (done→implementing, discarded→draft), explaining why the spec is being reopened.'),
             reconciliationRequestId: z
                 .string()
                 .regex(/^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/u)
                 .optional()
-                .describe('Trusted local MCP only: lowercase UUID idempotency key for implementing to review reconciliation.'),
-            expectedImplementingTransitionId: z.string().max(500).optional(),
+                .describe('Must match pattern ^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$ (lowercase UUID). ' +
+                'Trusted local MCP only: idempotency key for implementing to review reconciliation.'),
+            expectedImplementingTransitionId: z
+                .string()
+                .max(500)
+                .optional()
+                .describe('Max 500 characters. Idempotency guard: the transitionId returned by the prior implementing transition.'),
             implementationReviewDigest: z
                 .string()
                 .regex(/^sha256:[a-f0-9]{64}$/u)
                 .optional()
-                .describe('SHA-256 of the exact validation-report.json bytes. Required implementation evidence for status=done; for status=review it is valid only inside the complete trusted local-MCP reconciliation tuple.'),
+                .describe('Must match pattern ^sha256:[a-f0-9]{64}$ — the literal prefix "sha256:" followed by 64 lowercase hex characters. ' +
+                'SHA-256 of the exact validation-report.json bytes. Required implementation evidence for status=done; for status=review it is valid only inside the complete trusted local-MCP reconciliation tuple.'),
             forceApprove: z
                 .boolean()
                 .optional()
@@ -418,28 +438,53 @@ export function registerCoreSpecTools(server) {
     server.registerTool('update_status_batch', {
         description: 'Batch update many specs to the same status in one MCP execution. Uses the same transition rules as update_status and reports updated/skipped/failed per spec.',
         inputSchema: {
-            specIds: z.array(SpecIdSchema).min(1).describe('Spec IDs to update'),
-            projectId: z.string().max(500).optional().describe('Project ID, if known'),
+            specIds: z
+                .array(SpecIdSchema)
+                .min(1)
+                .describe('Spec IDs to update. Each must match pattern ^SPEC-\\d+$, max 50 characters.'),
+            projectId: z
+                .string()
+                .max(500)
+                .optional()
+                .describe('Project ID, if known. Max 500 characters.'),
             projectPath: z
                 .string()
                 .max(4096)
                 .optional()
-                .describe('Absolute project root. Preferred when projectId is unknown.'),
+                .describe('Absolute project root. Preferred when projectId is unknown. Max 4096 characters.'),
             status: SpecStatusEnum.exclude(['done']).describe('New status for all specs. Batch supports draft, review, approved, implementing, and discarded; close done specs individually with full evidence.'),
             dryRun: z.boolean().optional().describe('Preview the batch without mutating any spec.'),
             reviewNotes: z
                 .string()
                 .max(10_000)
                 .optional()
-                .describe('Optional notes for each transition.'),
+                .describe('Optional notes for each transition. Max 10000 characters.'),
+            evidence: z
+                .record(z.string(), z.object({
+                modelTierUsed: z
+                    .enum(['max', 'implementation', 'review'])
+                    .optional()
+                    .describe('Model tier used for this spec.'),
+                modelId: z.string().optional().describe('Model ID used for this spec.'),
+                contextHash: z.string().optional().describe('Context hash for this spec.'),
+                handoffPath: z.string().optional().describe('Handoff artifact path for this spec.'),
+                handoffArtifactId: z
+                    .string()
+                    .optional()
+                    .describe('Handoff artifact ID for this spec.'),
+                reviewedBy: z.string().optional().describe('Reviewer identity for this spec.'),
+                arbitratedBy: z.string().optional().describe('Arbitrator identity for this spec.'),
+            }))
+                .optional()
+                .describe('Per-spec model-routing evidence keyed by spec ID. Required for status approved or implementing: each entry supplies modelTierUsed, modelId, contextHash and handoffPath for that spec.'),
         },
     }, safeTracked('update_status_batch', async (args) => handleUpdateStatusBatch(args)));
     // 8. estimate
     server.registerTool('estimate', {
         description: t('tools.estimate.description'),
         inputSchema: {
-            specId: SpecIdSchema.describe('Spec ID to estimate'),
-            projectId: z.string().max(500).describe('Project ID'),
+            specId: SpecIdSchema.describe('Spec ID to estimate. Must match pattern ^SPEC-\\d+$ (e.g. SPEC-042), max 50 characters.'),
+            projectId: z.string().max(500).describe('Project ID. Max 500 characters.'),
         },
         outputSchema: EstimateOutputSchema,
     }, safeTracked('estimate', async (args) => handleEstimate(args)));
@@ -459,7 +504,7 @@ export function registerCoreSpecTools(server) {
     server.registerTool('validate', {
         description: t('tools.validate.description'),
         inputSchema: {
-            specId: SpecIdSchema.describe('Spec ID to validate'),
+            specId: SpecIdSchema.describe('Spec ID to validate. Must match pattern ^SPEC-\\d+$ (e.g. SPEC-042), max 50 characters.'),
             mode: z
                 .literal('submit')
                 .default('submit')
@@ -468,12 +513,12 @@ export function registerCoreSpecTools(server) {
                 .string()
                 .max(500)
                 .optional()
-                .describe('Project ID hash. Prefer projectPath — stays correct after context compaction.'),
+                .describe('Project ID hash. Prefer projectPath — stays correct after context compaction. Max 500 characters.'),
             projectPath: z
                 .string()
                 .max(4096)
                 .optional()
-                .describe('Absolute path to project root. Derives projectId automatically — always correct even after context compaction.'),
+                .describe('Max 4096 characters. Absolute path to project root. Derives projectId automatically — always correct even after context compaction.'),
         },
         outputSchema: ValidateOutputSchema,
         annotations: {

package/dist/tools/schemas/index.d.ts

@@ -16,7 +16,7 @@ export { TokenIntelligencePeriodEnum, TokenIntelligenceGroupByEnum, TokenIntelli
 export { ProjectGraphActionEnum, ProjectGraphQueryKindEnum } from './project-graph.js';
 export { ConfigureLLMProvidersActionEnum, LoadBalancingStrategyEnum, } from './llm-provider-schemas.js';
 export { PluginActionEnum } from './plugins-schemas.js';
-export { ListSpecsOutputSchema, EstimateOutputSchema, ValidateOutputSchema, CheckReadinessOutputSchema, } from './output-schemas.js';
+export { ListSpecsOutputSchema, EstimateOutputSchema, ValidateOutputSchema, CheckReadinessOutputSchema, PackageHandoffOutputSchema, } from './output-schemas.js';
 export { CreatePRFromSpecSchema, PRStatusSchema, ReviewPRSchema, CreateReleaseSchema, GenerateChangelogSchema, } from './github.js';
 export { SkillSearchInputSchema, SkillInstallInputSchema } from './skill-registry-schemas.js';
 export { EcosystemStatusInputSchema } from './ecosystem-schemas.js';

package/dist/tools/schemas/index.js

@@ -17,7 +17,7 @@ export { TokenIntelligencePeriodEnum, TokenIntelligenceGroupByEnum, TokenIntelli
 export { ProjectGraphActionEnum, ProjectGraphQueryKindEnum } from './project-graph.js';
 export { ConfigureLLMProvidersActionEnum, LoadBalancingStrategyEnum, } from './llm-provider-schemas.js';
 export { PluginActionEnum } from './plugins-schemas.js';
-export { ListSpecsOutputSchema, EstimateOutputSchema, ValidateOutputSchema, CheckReadinessOutputSchema, } from './output-schemas.js';
+export { ListSpecsOutputSchema, EstimateOutputSchema, ValidateOutputSchema, CheckReadinessOutputSchema, PackageHandoffOutputSchema, } from './output-schemas.js';
 export { CreatePRFromSpecSchema, PRStatusSchema, ReviewPRSchema, CreateReleaseSchema, GenerateChangelogSchema, } from './github.js';
 export { SkillSearchInputSchema, SkillInstallInputSchema } from './skill-registry-schemas.js';
 export { EcosystemStatusInputSchema } from './ecosystem-schemas.js';

package/dist/tools/schemas/output-schemas.d.ts

@@ -33,16 +33,7 @@ export declare const ListSpecsOutputSchema: {
         totalReviewHours: z.ZodNumber;
         totalCostUsd: z.ZodNumber;
     }, z.core.$strip>;
-    teamSuggestion: z.ZodNullable<z.ZodObject<{
-        recommended: z.ZodBoolean;
-        reason: z.ZodString;
-        templateId: z.ZodString;
-        teamSize: z.ZodNumber;
-        specs: z.ZodArray<z.ZodString>;
-        toolCalls: z.ZodArray<z.ZodString>;
-    }, z.core.$strip>>;
     message: z.ZodString;
-    teamDistributionHint: z.ZodOptional<z.ZodString>;
     humanSummary: z.ZodOptional<z.ZodString>;
     branchInfo: z.ZodOptional<z.ZodObject<{
         current: z.ZodString;
@@ -126,16 +117,7 @@ export declare const ListSpecsOutputObjectSchema: z.ZodObject<{
         totalReviewHours: z.ZodNumber;
         totalCostUsd: z.ZodNumber;
     }, z.core.$strip>;
-    teamSuggestion: z.ZodNullable<z.ZodObject<{
-        recommended: z.ZodBoolean;
-        reason: z.ZodString;
-        templateId: z.ZodString;
-        teamSize: z.ZodNumber;
-        specs: z.ZodArray<z.ZodString>;
-        toolCalls: z.ZodArray<z.ZodString>;
-    }, z.core.$strip>>;
     message: z.ZodString;
-    teamDistributionHint: z.ZodOptional<z.ZodString>;
     humanSummary: z.ZodOptional<z.ZodString>;
     branchInfo: z.ZodOptional<z.ZodObject<{
         current: z.ZodString;
@@ -217,6 +199,7 @@ export declare const EstimateOutputSchema: {
     calibrationApplied: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 };
 export { ValidateCompletionOutputSchema, ValidateOutputSchema } from './validate-output-schema.js';
+export { PackageHandoffOutputSchema } from './package-handoff-output-schema.js';
 export declare const CheckReadinessOutputSchema: {
     specId: z.ZodString;
     score: z.ZodNumber;

package/dist/tools/schemas/output-schemas.js

@@ -39,18 +39,7 @@ export const ListSpecsOutputSchema = {
         totalReviewHours: z.number(),
         totalCostUsd: z.number(),
     }),
-    teamSuggestion: z
-        .object({
-        recommended: z.boolean(),
-        reason: z.string(),
-        templateId: z.string(),
-        teamSize: z.number(),
-        specs: z.array(z.string()),
-        toolCalls: z.array(z.string()),
-    })
-        .nullable(),
     message: z.string(),
-    teamDistributionHint: z.string().optional(),
     humanSummary: z.string().optional(),
     branchInfo: z
         .object({
@@ -142,6 +131,7 @@ export const EstimateOutputSchema = {
 };
 // ── validate ────────────────────────────────────────────────────────────────
 export { ValidateCompletionOutputSchema, ValidateOutputSchema } from './validate-output-schema.js';
+export { PackageHandoffOutputSchema } from './package-handoff-output-schema.js';
 // ── check_readiness ─────────────────────────────────────────────────────────
 export const CheckReadinessOutputSchema = {
     specId: z.string(),

package/dist/tools/schemas/package-handoff-output-schema.d.ts

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+/** Exact public structured-output contract for the package_handoff MCP tool submission ack. */
+export declare const PackageHandoffOutputSchema: {
+    schemaVersion: z.ZodLiteral<1>;
+    operationId: z.ZodString;
+    projectId: z.ZodString;
+    workspaceId: z.ZodString;
+    state: z.ZodEnum<{
+        accepted: "accepted";
+        cancelled: "cancelled";
+        checkpointed: "checkpointed";
+        completed: "completed";
+        "dead-letter": "dead-letter";
+        failed: "failed";
+        running: "running";
+    }>;
+    submittedAt: z.ZodISODateTime;
+    attachedAt: z.ZodISODateTime;
+    reused: z.ZodBoolean;
+    cursor: z.ZodString;
+    queue: z.ZodObject<{
+        status: z.ZodEnum<{
+            active: "active";
+            queued: "queued";
+            terminal: "terminal";
+        }>;
+        position: z.ZodNullable<z.ZodNumber>;
+        aheadCount: z.ZodNumber;
+        capacity: z.ZodNumber;
+        remainingBudgetMs: z.ZodNumber;
+    }, z.core.$strip>;
+    terminalStates: z.ZodTuple<[z.ZodLiteral<"completed">, z.ZodLiteral<"failed">, z.ZodLiteral<"cancelled">, z.ZodLiteral<"dead-letter">], null>;
+    resultSchema: z.ZodLiteral<"package-handoff-completion/v1">;
+    observation: z.ZodObject<{
+        get: z.ZodLiteral<"get_job">;
+        restart: z.ZodLiteral<"restart_job">;
+    }, z.core.$strip>;
+    recoveryAction: z.ZodOptional<z.ZodLiteral<"restart_job">>;
+};
+//# sourceMappingURL=package-handoff-output-schema.d.ts.map