@planu/cli 4.1.1 → 4.1.3

package/dist/tools/tool-registry/group-spec-ops.js

@@ -1,917 +0,0 @@
-/* eslint-disable max-lines -- registration catalog: one block per tool group, cannot split further without losing colocation */
-// tools/tool-registry/group-spec-ops.ts — Declarative registry: spec operations tools.
-//
-// Phase 3 (refactor/registry-phase3): consolidates register-*.ts files for:
-//   spec-export, spec-split, spec-quality-score, spec-search, spec-lock,
-//   spec-hooks, spec-source, versioning, diff-spec, spec-diff-visual,
-//   merge-risk (via re-export), domain-criteria, domain-bundle
-//
-// NOTE: register-spec-tools.ts and register-spec-prompt-tools.ts are barrel files
-// that delegate to sub-registrars — they are kept as-is.
-import { z } from 'zod';
-import { safeLicensed, safeTracked } from '../safe-handler.js';
-import { projectIdSchema, withProject } from '../tool-registry-helpers.js';
-// ── Spec export ───────────────────────────────────────────────────────────────
-import { handleExportSpecsCsv, handleExportSpecsMarkdown } from '../spec-export-handler.js';
-// ── SPEC-601: Spec portability (bundle import/export) ────────────────────────
-import { handleExportSpec as handleExportBundle, handleImportSpec as handleImportBundle, } from '../spec-portability-handler.js';
-// ── SPEC-613: Gherkin import/export ──────────────────────────────────────────
-import { handleImportGherkin } from '../import-gherkin.js';
-import { handleExportGherkin } from '../export-gherkin.js';
-// ── Spec split ────────────────────────────────────────────────────────────────
-import { handleAnalyzeSpecSize, handleSplitSpec } from '../spec-split-handler.js';
-// ── Spec quality score ────────────────────────────────────────────────────────
-import { handleSpecQualityScore } from '../spec-quality-score-handler.js';
-// ── Spec search ───────────────────────────────────────────────────────────────
-import { handleSearchSpecs, handleSearchSuggestions } from '../search-handler.js';
-// ── Spec lock ─────────────────────────────────────────────────────────────────
-import { handleLockSpec, handleUnlockSpec, handleListLocks, handleCheckSpecLock, } from '../spec-lock-handler.js';
-// ── Spec hooks ────────────────────────────────────────────────────────────────
-import { handleConfigureSpecHooks, handleListSpecHooks, handleTestSpecHook, handleDisableSpecHook, handleEnableSpecHook, } from '../spec-hooks-handler.js';
-// ── Spec source ───────────────────────────────────────────────────────────────
-import { handleSyncSpecFromCode, handleMarkAsSpecSource, handleListSpecBindings, } from '../spec-source-handler.js';
-// ── Versioning ────────────────────────────────────────────────────────────────
-import { handleVersionSpec } from '../version-spec.js';
-import { handleBranchSpec } from '../branch-spec.js';
-import { handleMergeSpecBranch } from '../merge-spec-branch.js';
-import { handleDiffSpecVersions, handleSpecVersionHistory } from '../spec-diff-handler.js';
-// ── SPEC-717: bump_spec_version ───────────────────────────────────────────────
-import { handleBumpSpecVersion } from '../bump-spec-version.js';
-// ── Diff spec (generate from git diff) ───────────────────────────────────────
-import { handleGenerateSpecFromDiff, handleGenerateSpecFromPr, handleGenerateSpecFromCommitRange, } from '../diff-spec-generator-handler.js';
-// ── Visual spec diff ──────────────────────────────────────────────────────────
-import { handleVisualSpecDiff, handleThreeWayMerge, handleSmartMergeConflictResolver, handleMergePreview, handleApplyMerge, } from '../spec-visual-diff-handler.js';
-// ── Merge risk ────────────────────────────────────────────────────────────────
-import { registerMergeRiskTools } from '../merge-risk-handler.js';
-// ── Domain criteria ───────────────────────────────────────────────────────────
-import { handleSuggestCriteria, handleInjectCriteria } from '../domain-criteria-handler.js';
-// ── Domain bundle ─────────────────────────────────────────────────────────────
-import { handleApplyDomainBundle, handleListDomainBundles, ApplyDomainBundleInputSchema, ListDomainBundlesInputSchema, } from '../domain-bundle-handler.js';
-// ---------------------------------------------------------------------------
-// Shared schema constants
-// ---------------------------------------------------------------------------
-const COLUMN_VALUES = [
-    'id',
-    'title',
-    'status',
-    'type',
-    'scope',
-    'difficulty',
-    'risk',
-    'target',
-    'tags',
-    'createdAt',
-    'updatedAt',
-    'devHours',
-    'totalCostUsd',
-    'estimatedModel',
-];
-const COLUMN_DESCRIBE = 'Columns to include. Valid values: id, title, status, type, scope, difficulty, risk, target, tags, createdAt, updatedAt, devHours, totalCostUsd, estimatedModel. Defaults to all columns.';
-const columnsSchema = z.array(z.enum(COLUMN_VALUES)).optional().describe(COLUMN_DESCRIBE);
-const exportStatusSchema = z
-    .array(z.string().max(50))
-    .max(20)
-    .optional()
-    .describe('Filter by status. Valid values: draft, review, approved, implementing, done, cancelled.');
-const exportTypeSchema = z
-    .array(z.string().max(50))
-    .max(20)
-    .optional()
-    .describe('Filter by spec type. Valid values: feature, refactor, bugfix, infra, docs, project, agent, tech-debt.');
-const exportTagsSchema = z
-    .array(z.string().max(500))
-    .max(100)
-    .optional()
-    .describe('Filter specs that have at least one of these tags.');
-const exportOutputPathSchema = z
-    .string()
-    .optional()
-    .describe('Absolute path to write the output file. If omitted, the content is returned but not written.');
-const STATUS_VALUES = ['draft', 'review', 'approved', 'implementing', 'done', 'discarded'];
-const TYPE_VALUES = [
-    'feature',
-    'refactor',
-    'bugfix',
-    'infra',
-    'docs',
-    'project',
-    'agent',
-    'tech-debt',
-];
-const TARGET_VALUES = [
-    'frontend',
-    'backend',
-    'shared',
-    'fullstack',
-    'infrastructure',
-    'database',
-    'ios',
-    'android',
-];
-const RISK_VALUES = ['low', 'medium', 'high', 'critical'];
-const SORT_BY_VALUES = ['relevance', 'createdAt', 'updatedAt', 'difficulty'];
-const SORT_ORDER_VALUES = ['asc', 'desc'];
-const SUGGESTION_FIELD_VALUES = ['tags', 'type', 'status', 'id'];
-const EVENT_DESCRIBE = 'Event that triggers the hook. Valid values: on-status-change | on-create | on-approve | on-done | on-drift-alert | on-validation-fail';
-const ACTION_DESCRIBE = 'Action to execute. Valid values: challenge-spec | check-readiness | notify-slack | create-git-branch | generate-changelog | send-email-digest | run-validate';
-// ---------------------------------------------------------------------------
-// Registration
-// ---------------------------------------------------------------------------
-// eslint-disable-next-line max-lines-per-function -- registration catalog: one block per tool, each ~20 lines
-export function registerSpecOpsGroupTools(s) {
-    // ── Spec export ──────────────────────────────────────────────────────────────
-    s.registerTool('export_specs_csv', {
-        description: 'Export specs to CSV format for spreadsheet analysis. Supports filtering by status, type, or tags and custom column selection. Pro tier.',
-        annotations: { readOnlyHint: true },
-        inputSchema: {
-            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
-            columns: columnsSchema,
-            status: exportStatusSchema,
-            type: exportTypeSchema,
-            tags: exportTagsSchema,
-            outputPath: exportOutputPathSchema,
-        },
-    }, safeTracked('export_specs_csv', async (args) => handleExportSpecsCsv(args)));
-    s.registerTool('export_specs_markdown', {
-        description: 'Export specs to a Markdown table for docs, reports, or PR descriptions. Supports filtering by status, type, or tags and custom column selection.',
-        annotations: { readOnlyHint: true },
-        inputSchema: {
-            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
-            columns: columnsSchema,
-            status: exportStatusSchema,
-            type: exportTypeSchema,
-            tags: exportTagsSchema,
-            outputPath: exportOutputPathSchema,
-        },
-    }, safeTracked('export_specs_markdown', async (args) => handleExportSpecsMarkdown(args)));
-    // ── Spec split ───────────────────────────────────────────────────────────────
-    s.registerTool('analyze_spec_size', {
-        description: 'Analyze a spec to determine if it is too large or complex and should be split into ' +
-            'smaller, more atomic specs. ' +
-            'Checks three criteria: >15 acceptance criteria, estimation >40h, or >3 subsystem signals. ' +
-            'Also detects ambiguous criteria with vague language (e.g. "should handle", "properly"). ' +
-            'Returns a SpecSizeAnalysis with shouldSplit flag, reasons, and suggestedSplits.',
-        annotations: { readOnlyHint: true },
-        inputSchema: {
-            ...projectIdSchema,
-            specId: z.string().min(1).max(500).describe('Spec ID to analyze (e.g. SPEC-042)'),
-        },
-    }, safeLicensed('analyze_spec_size', withProject((args) => handleAnalyzeSpecSize(args))));
-    s.registerTool('split_spec', {
-        description: 'Execute the division of a large spec into smaller child specs. ' +
-            'Creates N new child specs with fresh IDs, marks the original as superseded, ' +
-            'and distributes acceptance criteria according to the proposals. ' +
-            'Child specs inherit tags, target, type and risk from the original. ' +
-            'Use analyze_spec_size first to get the suggested splits, then optionally customize ' +
-            'proposedSplits before calling this tool. ' +
-            'DESTRUCTIVE: modifies the original spec status to "superseded".',
-        annotations: { destructiveHint: true },
-        inputSchema: {
-            ...projectIdSchema,
-            specId: z.string().min(1).max(500).describe('Spec ID to split (e.g. SPEC-042)'),
-            proposedSplits: z
-                .array(z.object({
-                title: z.string().max(200).describe('Title for the child spec'),
-                description: z.string().max(1000).describe('Description of this child spec scope'),
-                criteriaIndices: z
-                    .array(z.number().int().min(0))
-                    .describe('Zero-based indices of acceptance criteria from the original spec to assign to this child'),
-                dependsOn: z
-                    .array(z.number().int().min(0))
-                    .describe('Zero-based indices of other proposedSplits that this child depends on'),
-            }))
-                .optional()
-                .describe('Custom split proposals. If omitted, uses auto-generated proposals from analyze_spec_size.'),
-        },
-    }, safeLicensed('split_spec', withProject((args) => handleSplitSpec(args))));
-    // ── Spec quality score ───────────────────────────────────────────────────────
-    s.registerTool('spec_quality_score', {
-        description: 'Compute a 0-100 quality score for a spec across 4 dimensions: ' +
-            'completeness (title, description, AC, scope, estimation), ' +
-            'testability (verifiable AC, no vague words), ' +
-            'ambiguity (no contradictions, terms defined, edge cases covered), ' +
-            'and risk (cross-module deps, architectural scope, NFRs present). ' +
-            'Returns a letter grade (A-F) and actionable recommendations.',
-        inputSchema: {
-            specId: z.string().min(1).max(500).describe('Spec ID to evaluate (e.g. SPEC-042).'),
-            projectPath: z
-                .string()
-                .min(1)
-                .max(4096)
-                .optional()
-                .describe('Absolute path to the project root (preferred over projectId).'),
-            projectId: z
-                .string()
-                .min(1)
-                .max(500)
-                .optional()
-                .describe('Project hash ID (use projectPath instead when possible).'),
-        },
-        annotations: { title: 'Spec Quality Score', readOnlyHint: true },
-    }, safeTracked('spec_quality_score', (args) => handleSpecQualityScore(args)));
-    // ── Spec search ──────────────────────────────────────────────────────────────
-    s.registerTool('search_specs', {
-        description: 'Search specs with fuzzy text matching, multi-field filters, sorting, and pagination. Supports filtering by status, type, target, tags, difficulty range, risk level, and date ranges.',
-        annotations: { readOnlyHint: true },
-        inputSchema: {
-            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
-            query: z
-                .string()
-                .max(200)
-                .optional()
-                .describe('Free-text fuzzy search query matched against spec id, title, and tags.'),
-            status: z
-                .array(z.enum(STATUS_VALUES))
-                .optional()
-                .describe('Filter by status (OR). Valid values: draft, review, approved, implementing, done, discarded.'),
-            tags: z
-                .array(z.string().max(100))
-                .optional()
-                .describe('Filter by tags (OR — spec must have at least one matching tag).'),
-            type: z
-                .array(z.enum(TYPE_VALUES))
-                .optional()
-                .describe('Filter by type (OR). Valid values: feature, refactor, bugfix, infra, docs, project, agent, tech-debt.'),
-            target: z
-                .array(z.enum(TARGET_VALUES))
-                .optional()
-                .describe('Filter by target (OR). Valid values: frontend, backend, shared, fullstack, infrastructure, database, ios, android.'),
-            difficulty: z
-                .object({
-                min: z.number().int().min(1).max(5).optional(),
-                max: z.number().int().min(1).max(5).optional(),
-            })
-                .optional()
-                .describe('Difficulty range filter (inclusive, 1-5).'),
-            risk: z
-                .array(z.enum(RISK_VALUES))
-                .optional()
-                .describe('Filter by risk level (OR). Valid values: low, medium, high, critical.'),
-            createdAfter: z
-                .string()
-                .optional()
-                .describe('ISO date string — only include specs created after this date.'),
-            createdBefore: z
-                .string()
-                .optional()
-                .describe('ISO date string — only include specs created before this date.'),
-            updatedAfter: z
-                .string()
-                .optional()
-                .describe('ISO date string — only include specs updated after this date.'),
-            updatedBefore: z
-                .string()
-                .optional()
-                .describe('ISO date string — only include specs updated before this date.'),
-            sortBy: z
-                .enum(SORT_BY_VALUES)
-                .optional()
-                .describe('Sort field. Valid values: relevance, createdAt, updatedAt, difficulty.'),
-            sortOrder: z
-                .enum(SORT_ORDER_VALUES)
-                .optional()
-                .describe('Sort direction. Valid values: asc, desc.'),
-            limit: z
-                .number()
-                .int()
-                .min(1)
-                .max(100)
-                .optional()
-                .describe('Maximum number of results to return (default: 20, max: 100).'),
-            offset: z
-                .number()
-                .int()
-                .min(0)
-                .optional()
-                .describe('Number of results to skip for pagination (default: 0).'),
-        },
-    }, safeTracked('search_specs', async (args) => handleSearchSpecs(args)));
-    s.registerTool('search_suggestions', {
-        description: 'Get autocomplete suggestions for a partial query against a specific field (tags, type, status, or spec id). Useful for building dynamic filters.',
-        annotations: { readOnlyHint: true },
-        inputSchema: {
-            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
-            query: z.string().min(1).max(200).describe('Partial string to match against field values.'),
-            field: z
-                .enum(SUGGESTION_FIELD_VALUES)
-                .optional()
-                .describe('Field to search for suggestions. Valid values: tags, type, status, id. Defaults to tags.'),
-        },
-    }, safeTracked('search_suggestions', async (args) => handleSearchSuggestions(args)));
-    // ── Spec lock ────────────────────────────────────────────────────────────────
-    s.registerTool('lock_spec', {
-        description: 'Acquire an exclusive lock on a spec to prevent concurrent edits by other agents or sessions. ' +
-            'If the spec is already locked by a different holder, returns an error. ' +
-            'Re-locking by the same holder refreshes the TTL.',
-        inputSchema: {
-            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
-            specId: z.string().min(1).max(500).describe('Spec ID to lock (e.g. SPEC-042).'),
-            lockHolder: z
-                .string()
-                .min(1)
-                .max(500)
-                .describe('Identifier of the agent or session acquiring the lock (e.g. "agent-123").'),
-            ttlMinutes: z
-                .number()
-                .int()
-                .optional()
-                .describe('Lock TTL in minutes. Clamped to [1, 480]. Default: 30.'),
-            reason: z
-                .string()
-                .optional()
-                .describe('Optional human-readable reason for acquiring the lock.'),
-        },
-        annotations: { title: 'Lock Spec', destructiveHint: false },
-    }, safeTracked('lock_spec', (args) => handleLockSpec(args)));
-    s.registerTool('unlock_spec', {
-        description: 'Release an existing lock on a spec. ' +
-            'Fails if the lock is held by a different holder unless force=true is passed.',
-        inputSchema: {
-            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
-            specId: z.string().min(1).max(500).describe('Spec ID to unlock (e.g. SPEC-042).'),
-            lockHolder: z
-                .string()
-                .min(1)
-                .max(500)
-                .describe('Identifier of the agent or session releasing the lock.'),
-            force: z
-                .boolean()
-                .optional()
-                .describe('If true, removes the lock even when held by a different lockHolder. Default: false.'),
-        },
-        annotations: { title: 'Unlock Spec', destructiveHint: true },
-    }, safeTracked('unlock_spec', (args) => handleUnlockSpec(args)));
-    s.registerTool('list_locks', {
-        description: 'List all active (non-expired) locks for a project. ' +
-            'Returns the spec ID, lock holder, expiration time, and optional reason for each lock.',
-        inputSchema: {
-            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
-        },
-        annotations: { title: 'List Active Locks', readOnlyHint: true },
-    }, safeTracked('list_locks', (args) => handleListLocks(args)));
-    s.registerTool('check_spec_lock', {
-        description: 'Check whether a specific spec is currently locked. ' +
-            'Returns locked status, lock holder, expiration time, and reason if locked.',
-        inputSchema: {
-            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
-            specId: z.string().min(1).max(500).describe('Spec ID to check (e.g. SPEC-042).'),
-        },
-        annotations: { title: 'Check Spec Lock', readOnlyHint: true },
-    }, safeTracked('check_spec_lock', (args) => handleCheckSpecLock(args)));
-    // ── Spec hooks ───────────────────────────────────────────────────────────────
-    s.registerTool('configure_spec_hooks', {
-        description: 'Configure an event-driven hook for the spec lifecycle. ' +
-            'Hooks automatically trigger actions when spec events fire (status change, creation, approval, etc.). ' +
-            'Examples: auto-challenge high-risk specs on approve, auto-create git branch on implementing.',
-        inputSchema: {
-            projectPath: z
-                .string()
-                .min(1)
-                .max(4096)
-                .describe('Absolute path to the project root directory'),
-            hookName: z
-                .string()
-                .min(1)
-                .max(200)
-                .describe('Unique name for this hook (e.g. "auto-challenge-on-approve")'),
-            event: z
-                .enum([
-                'on-status-change',
-                'on-create',
-                'on-approve',
-                'on-done',
-                'on-drift-alert',
-                'on-validation-fail',
-            ])
-                .describe(EVENT_DESCRIBE),
-            action: z
-                .enum([
-                'challenge-spec',
-                'check-readiness',
-                'notify-slack',
-                'create-git-branch',
-                'generate-changelog',
-                'send-email-digest',
-                'run-validate',
-            ])
-                .describe(ACTION_DESCRIBE),
-            filter: z
-                .object({
-                tags: z
-                    .array(z.string().max(100))
-                    .optional()
-                    .describe('Only fire for specs with these tags'),
-                priority: z
-                    .string()
-                    .max(50)
-                    .optional()
-                    .describe('Only fire for specs with this priority'),
-                fromStatus: z
-                    .string()
-                    .max(50)
-                    .optional()
-                    .describe('Only fire when status changes FROM this value'),
-                toStatus: z
-                    .string()
-                    .max(50)
-                    .optional()
-                    .describe('Only fire when status changes TO this value'),
-            })
-                .optional()
-                .describe('Optional filter conditions — hook only fires when all conditions match'),
-            enabled: z.boolean().optional().describe('Whether the hook is active (default: true)'),
-        },
-        annotations: { title: 'Configure Spec Hook', readOnlyHint: false },
-    }, safeLicensed('configure_spec_hooks', async (args) => handleConfigureSpecHooks(args)));
-    s.registerTool('list_spec_hooks', {
-        description: 'List all configured spec lifecycle hooks with their run statistics ' +
-            '(runCount, failCount, lastRunAt) and current enabled/disabled status.',
-        inputSchema: {
-            projectPath: z
-                .string()
-                .min(1)
-                .max(4096)
-                .describe('Absolute path to the project root directory'),
-        },
-        annotations: { title: 'List Spec Hooks', readOnlyHint: true },
-    }, safeLicensed('list_spec_hooks', async (args) => handleListSpecHooks(args)));
-    s.registerTool('test_spec_hook', {
-        description: 'Simulate a spec lifecycle event and describe what hooks would fire and what actions ' +
-            'would be triggered — without executing any side effects. ' +
-            'Use this to verify hook configuration before it fires in production.',
-        inputSchema: {
-            projectPath: z
-                .string()
-                .min(1)
-                .max(4096)
-                .describe('Absolute path to the project root directory'),
-            hookName: z.string().min(1).max(200).describe('Name of the hook to test'),
-            specId: z
-                .string()
-                .min(1)
-                .max(200)
-                .describe('Spec ID to use in the simulation (e.g. SPEC-001)'),
-        },
-        annotations: { title: 'Test Spec Hook (Simulation)', readOnlyHint: true },
-    }, safeLicensed('test_spec_hook', async (args) => handleTestSpecHook(args)));
-    s.registerTool('disable_spec_hook', {
-        description: 'Disable a spec lifecycle hook so it no longer fires. The hook config is preserved and can be re-enabled.',
-        inputSchema: {
-            projectPath: z
-                .string()
-                .min(1)
-                .max(4096)
-                .describe('Absolute path to the project root directory'),
-            hookName: z.string().min(1).max(200).describe('Name of the hook to disable'),
-        },
-        annotations: { title: 'Disable Spec Hook', readOnlyHint: false },
-    }, safeLicensed('disable_spec_hook', async (args) => handleDisableSpecHook(args)));
-    s.registerTool('enable_spec_hook', {
-        description: 'Enable a previously disabled spec lifecycle hook.',
-        inputSchema: {
-            projectPath: z
-                .string()
-                .min(1)
-                .max(4096)
-                .describe('Absolute path to the project root directory'),
-            hookName: z.string().min(1).max(200).describe('Name of the hook to enable'),
-        },
-        annotations: { title: 'Enable Spec Hook', readOnlyHint: false },
-    }, safeLicensed('enable_spec_hook', async (args) => handleEnableSpecHook(args)));
-    // ── Spec source ──────────────────────────────────────────────────────────────
-    s.registerTool('sync_spec_from_code', {
-        description: 'Scan source files for @spec markers and sync them with the spec bindings store. Detects // @spec SPEC-XXX comments in code.',
-        inputSchema: {
-            projectPath: z.string().describe('Absolute path to the project root.'),
-            filePaths: z
-                .array(z.string())
-                .describe('List of absolute file paths to scan for @spec markers.'),
-        },
-        annotations: { title: 'Sync Spec from Code', destructiveHint: false },
-    }, safeTracked('sync_spec_from_code', async (args) => handleSyncSpecFromCode(args)));
-    s.registerTool('mark_as_spec_source', {
-        description: 'Mark a source file as implementing a specific spec by creating a binding. Also shows the marker comment to add to the file.',
-        inputSchema: {
-            projectPath: z.string().describe('Absolute path to the project root.'),
-            specId: z.string().describe('Spec ID to bind (e.g. SPEC-001).'),
-            filePath: z.string().describe('Absolute path to the source file implementing the spec.'),
-            lineNumber: z
-                .number()
-                .optional()
-                .describe('Optional line number where the implementation starts.'),
-        },
-        annotations: { title: 'Mark as Spec Source', destructiveHint: false },
-    }, safeTracked('mark_as_spec_source', async (args) => handleMarkAsSpecSource(args)));
-    s.registerTool('list_spec_bindings', {
-        description: 'List all spec-to-code bindings for a project. Optionally filter by spec ID or unmark a binding.',
-        inputSchema: {
-            projectPath: z.string().describe('Absolute path to the project root.'),
-            specId: z
-                .string()
-                .optional()
-                .describe('Filter bindings to a specific spec ID (e.g. SPEC-001).'),
-            action: z
-                .enum(['list', 'unmark'])
-                .optional()
-                .describe('Action to perform. Values: list (default), unmark.'),
-            bindingId: z
-                .string()
-                .optional()
-                .describe('Binding ID to remove. Required for unmark action.'),
-        },
-        annotations: { title: 'List Spec Bindings', readOnlyHint: true },
-    }, safeTracked('list_spec_bindings', async (args) => handleListSpecBindings(args)));
-    // ── SPEC-717: bump_spec_version ──────────────────────────────────────────────
-    s.registerTool('bump_spec_version', {
-        description: "Bump the SemVer spec_version field of a spec's frontmatter and record a history entry. " +
-            'Use "patch" for typos/formatting, "minor" for new criteria or scope expansion, ' +
-            '"major" for breaking interpretation changes. ' +
-            'Reads and writes spec.md atomically. Does not modify the data store.',
-        inputSchema: {
-            projectPath: z
-                .string()
-                .min(1)
-                .max(4096)
-                .optional()
-                .describe('Absolute path to the project root. Takes precedence over projectId.'),
-            projectId: z
-                .string()
-                .min(1)
-                .max(500)
-                .optional()
-                .describe('Project ID (hash). Required if projectPath is not provided.'),
-            specId: z.string().min(1).max(500).describe('Spec ID to bump, e.g. SPEC-042.'),
-            kind: z
-                .enum(['patch', 'minor', 'major'])
-                .describe('Bump kind: patch (typo/format), minor (new criterion), major (breaking change).'),
-            reason: z
-                .string()
-                .min(5)
-                .max(500)
-                .describe('Free-text reason for the bump. Recorded in history.'),
-            by: z
-                .string()
-                .min(1)
-                .max(200)
-                .optional()
-                .describe('Actor identifier. Defaults to a session token.'),
-        },
-    }, safeTracked('bump_spec_version', async (args) => handleBumpSpecVersion(args)));
-    // ── Versioning ───────────────────────────────────────────────────────────────
-    s.registerTool('version_spec', {
-        description: 'Create a tagged version snapshot of a spec (e.g., v1.0.0, v1.1.0, v2.0.0). ' +
-            'Captures the full spec content at a point in time so you can compare or roll back. ' +
-            'Uses semantic versioning (vMAJOR.MINOR.PATCH). Tag is auto-incremented if not specified.',
-        annotations: { title: 'Version Spec' },
-        inputSchema: {
-            ...projectIdSchema,
-            specId: z.string().min(1).max(500).describe('Spec ID to snapshot (e.g., "SPEC-042")'),
-            tag: z
-                .string()
-                .max(50)
-                .regex(/^v\d+\.\d+\.\d+$/)
-                .optional()
-                .describe('Semantic version tag (e.g., "v1.0.0"). Auto-incremented from latest if not provided.'),
-            message: z
-                .string()
-                .max(500)
-                .optional()
-                .describe('Human-readable description of what changed in this version'),
-            author: z.string().max(200).optional().describe('Author identifier for audit trail'),
-            specPath: z
-                .string()
-                .max(4096)
-                .optional()
-                .describe('Absolute path to the spec.md file to snapshot its content'),
-        },
-    }, safeLicensed('version_spec', withProject((args) => handleVersionSpec(args))));
-    s.registerTool('branch_spec', {
-        description: 'Create a spec branch for experimentation — try alternative approaches without affecting the main spec. ' +
-            'Useful for "what if we change the auth approach?" scenarios. ' +
-            'Branch name must be lowercase kebab-case (e.g., "auth-refactor", "alt-design-v2").',
-        annotations: { title: 'Branch Spec' },
-        inputSchema: {
-            ...projectIdSchema,
-            specId: z.string().min(1).max(500).describe('Spec ID to branch (e.g., "SPEC-042")'),
-            branchName: z
-                .string()
-                .max(100)
-                .regex(/^[a-z][a-z0-9-]*$/)
-                .describe('Branch name in lowercase kebab-case (e.g., "auth-refactor", "v2-approach")'),
-            fromVersion: z
-                .string()
-                .max(50)
-                .optional()
-                .describe('Version tag to branch from (e.g., "v1.0.0"). Defaults to the latest version.'),
-            specPath: z
-                .string()
-                .max(4096)
-                .optional()
-                .describe('Absolute path to the spec.md file to use as branch starting content'),
-        },
-    }, safeLicensed('branch_spec', withProject((args) => handleBranchSpec(args))));
-    s.registerTool('merge_spec_branch', {
-        description: 'Merge an experimental spec branch back into the main spec. ' +
-            'Detects conflicts and creates a new version snapshot. ' +
-            'The branch is deleted after a successful merge.',
-        annotations: { title: 'Merge Spec Branch' },
-        inputSchema: {
-            ...projectIdSchema,
-            specId: z.string().min(1).max(500).describe('Spec ID to merge into (e.g., "SPEC-042")'),
-            branchName: z.string().max(100).describe('Name of the branch to merge (must exist)'),
-            resolvedContent: z
-                .string()
-                .max(100_000)
-                .optional()
-                .describe('Pre-resolved spec content to use as the merge result.'),
-            newVersionTag: z
-                .string()
-                .max(50)
-                .regex(/^v\d+\.\d+\.\d+$/)
-                .optional()
-                .describe('Version tag for the merged snapshot. Auto-incremented if not provided.'),
-            message: z
-                .string()
-                .max(500)
-                .optional()
-                .describe('Merge commit message describing what was merged'),
-        },
-    }, safeLicensed('merge_spec_branch', withProject((args) => handleMergeSpecBranch(args))));
-    s.registerTool('diff_spec_versions', {
-        description: 'Compare two tagged version snapshots of a spec to see exactly what changed. ' +
-            'Returns a +/- line diff plus AC-level summary (N criteria added, M removed, K modified).',
-        annotations: { title: 'Diff Spec Versions', readOnlyHint: true },
-        inputSchema: {
-            ...projectIdSchema,
-            specId: z.string().min(1).max(500).describe('Spec ID to diff (e.g., "SPEC-042")'),
-            fromVersion: z
-                .string()
-                .max(50)
-                .optional()
-                .describe('Starting version tag (e.g., "v1.0.0"). Omit to auto-select the penultimate version.'),
-            toVersion: z
-                .string()
-                .max(50)
-                .optional()
-                .describe('Ending version tag (e.g., "v2.0.0"). Defaults to the latest version if not specified.'),
-            format: z
-                .enum(['text', 'json'])
-                .optional()
-                .describe('Output format. Valid values: "text" (default, +/- line diff) | "json" (structured object).'),
-        },
-    }, safeLicensed('diff_spec_versions', withProject((args) => handleDiffSpecVersions(args))));
-    s.registerTool('spec_version_history', {
-        description: 'List all tagged version snapshots of a spec with their timestamps, authors, and auto-generated change summaries. Returns versions in reverse chronological order (newest first).',
-        annotations: { title: 'Spec Version History', readOnlyHint: true },
-        inputSchema: {
-            ...projectIdSchema,
-            specId: z
-                .string()
-                .min(1)
-                .max(500)
-                .describe('Spec ID to retrieve version history for (e.g., "SPEC-042")'),
-            limit: z
-                .number()
-                .int()
-                .min(1)
-                .max(100)
-                .optional()
-                .describe('Maximum number of versions to return (default: 20, max: 100)'),
-        },
-    }, safeLicensed('spec_version_history', withProject((args) => handleSpecVersionHistory(args))));
-    // ── Diff spec (generate from git diff) ──────────────────────────────────────
-    s.registerTool('generate_spec_from_diff', {
-        description: 'Generate a spec draft from a git diff string. Analyzes modified files, added functions, and new endpoints to infer acceptance criteria.',
-        inputSchema: {
-            projectPath: z.string().describe('Absolute path to the project root.'),
-            diff: z
-                .string()
-                .min(1)
-                .describe('Raw git diff output (e.g. output of "git diff HEAD~1..HEAD").'),
-            outputMode: z
-                .enum(['draft', 'create'])
-                .optional()
-                .describe('Output mode. Values: draft (return content only), create (suggest create_spec call). Default: draft.'),
-            title: z
-                .string()
-                .optional()
-                .describe('Optional title override. If omitted, title is inferred from the diff.'),
-        },
-        annotations: { title: 'Generate Spec from Diff', readOnlyHint: true },
-    }, safeTracked('generate_spec_from_diff', async (args) => handleGenerateSpecFromDiff(args)));
-    s.registerTool('generate_spec_from_pr', {
-        description: 'Generate a spec draft from a GitHub Pull Request by fetching its diff via the GitHub CLI (gh). Requires gh to be installed and authenticated.',
-        inputSchema: {
-            projectPath: z.string().describe('Absolute path to the project root.'),
-            prNumber: z.number().int().positive().describe('Pull Request number (e.g. 42).'),
-            repoPath: z
-                .string()
-                .optional()
-                .describe('Optional path to the git repository. Defaults to projectPath.'),
-            outputMode: z
-                .enum(['draft', 'create'])
-                .optional()
-                .describe('Output mode. Values: draft, create. Default: draft.'),
-        },
-        annotations: { title: 'Generate Spec from PR', readOnlyHint: true },
-    }, safeTracked('generate_spec_from_pr', async (args) => handleGenerateSpecFromPr(args)));
-    s.registerTool('generate_spec_from_commit_range', {
-        description: 'Generate a spec draft from a git commit range (e.g. HEAD~5..HEAD or abc123..def456).',
-        inputSchema: {
-            projectPath: z.string().describe('Absolute path to the project root.'),
-            commitRange: z
-                .string()
-                .describe('Git commit range in the format from..to (e.g. HEAD~3..HEAD or sha1..sha2).'),
-            outputMode: z
-                .enum(['draft', 'create'])
-                .optional()
-                .describe('Output mode. Values: draft, create. Default: draft.'),
-        },
-        annotations: { title: 'Generate Spec from Commit Range', readOnlyHint: true },
-    }, safeTracked('generate_spec_from_commit_range', async (args) => handleGenerateSpecFromCommitRange(args)));
-    // ── Visual spec diff ─────────────────────────────────────────────────────────
-    s.registerTool('visual_spec_diff', {
-        description: 'Compute a visual line-by-line diff between two spec texts using LCS algorithm. Returns HTML output (default) or text format with +/- markers.',
-        inputSchema: {
-            textA: z.string().max(500000).describe('First spec text (base/original)'),
-            textB: z.string().max(500000).describe('Second spec text (new/modified)'),
-            labelA: z.string().max(100).optional().describe('Label for textA (default: A)'),
-            labelB: z.string().max(100).optional().describe('Label for textB (default: B)'),
-            outputFormat: z
-                .enum(['html', 'text'])
-                .optional()
-                .describe('Output format: html (default) or text'),
-        },
-        annotations: { readOnlyHint: true },
-    }, safeLicensed('visual_spec_diff', (args) => handleVisualSpecDiff(args)));
-    s.registerTool('three_way_merge', {
-        description: 'Perform a 3-way merge of two spec texts against a common base. Returns merged text with conflict markers where conflicts exist.',
-        inputSchema: {
-            base: z.string().max(500000).describe('Common base text'),
-            textA: z.string().max(500000).describe('First branch text'),
-            textB: z.string().max(500000).describe('Second branch text'),
-            labelA: z.string().max(100).optional().describe('Label for textA (default: A)'),
-            labelB: z.string().max(100).optional().describe('Label for textB (default: B)'),
-        },
-        annotations: { readOnlyHint: true },
-    }, safeLicensed('three_way_merge', (args) => handleThreeWayMerge(args)));
-    s.registerTool('smart_merge_conflict_resolver', {
-        description: 'Automatically resolve simple merge conflicts: identical content on both sides, or whitespace-only differences. Remaining conflicts kept as-is for manual resolution.',
-        inputSchema: {
-            mergedText: z
-                .string()
-                .max(500000)
-                .describe('Text containing conflict markers from three_way_merge'),
-        },
-        annotations: { readOnlyHint: true },
-    }, safeLicensed('smart_merge_conflict_resolver', (args) => handleSmartMergeConflictResolver(args)));
-    s.registerTool('merge_preview', {
-        description: 'Preview the result of merging two spec texts against a base. Shows whether auto-merge is possible and the merged content.',
-        inputSchema: {
-            base: z.string().max(500000).describe('Common base text'),
-            textA: z.string().max(500000).describe('First branch text'),
-            textB: z.string().max(500000).describe('Second branch text'),
-        },
-        annotations: { readOnlyHint: true },
-    }, safeLicensed('merge_preview', (args) => handleMergePreview(args)));
-    s.registerTool('apply_merge', {
-        description: 'Apply merged spec content to a spec file on disk. Fails if unresolved conflict markers are present.',
-        inputSchema: {
-            mergedText: z
-                .string()
-                .max(500000)
-                .describe('Fully resolved merged text (no conflict markers)'),
-            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root'),
-            specId: z.string().min(1).max(100).describe('Spec ID to update (e.g. SPEC-001)'),
-        },
-        annotations: { readOnlyHint: false, destructiveHint: true },
-    }, safeLicensed('apply_merge', async (args) => handleApplyMerge(args)));
-    // ── Merge risk ───────────────────────────────────────────────────────────────
-    registerMergeRiskTools(s);
-    // ── Domain criteria ──────────────────────────────────────────────────────────
-    s.registerTool('suggest_criteria', {
-        description: 'Analyze a spec and suggest missing best-practice acceptance criteria based on the detected domain ' +
-            '(payments, authentication, file-upload, gdpr, etc.). ' +
-            'Returns suggested criteria grouped by domain and flags critical gaps that penalize readiness score.',
-        annotations: { readOnlyHint: true },
-        inputSchema: {
-            ...projectIdSchema,
-            specId: z.string().min(1).max(500).describe('Spec ID to analyze (e.g. SPEC-042)'),
-            projectHash: z
-                .string()
-                .max(500)
-                .optional()
-                .describe('Optional project hash for loading project-level best-practices overrides.'),
-        },
-    }, safeLicensed('suggest_criteria', withProject((args) => handleSuggestCriteria(args))));
-    s.registerTool('inject_criteria', {
-        description: 'Inject missing domain best-practice criteria directly into a spec\'s "## Acceptance Criteria" section. ' +
-            'Criteria are automatically detected from the spec domain. ' +
-            'Use criteriaIds to inject only specific criteria; omit to inject all missing critical criteria.',
-        annotations: { destructiveHint: true },
-        inputSchema: {
-            ...projectIdSchema,
-            specId: z
-                .string()
-                .min(1)
-                .max(500)
-                .describe('Spec ID to inject criteria into (e.g. SPEC-042)'),
-            criteriaIds: z
-                .array(z.string().max(200))
-                .optional()
-                .describe('Optional list of specific criteria IDs to inject.'),
-            projectHash: z
-                .string()
-                .max(500)
-                .optional()
-                .describe('Optional project hash for loading project-level best-practices overrides'),
-        },
-    }, safeLicensed('inject_criteria', withProject((args) => handleInjectCriteria(args))));
-    // ── Domain bundle ────────────────────────────────────────────────────────────
-    s.registerTool('apply_domain_bundle', {
-        description: 'Install a pre-configured domain bundle (skills + rules + spec templates) into a project ' +
-            'with a single command. Available bundles: stripe-payments, auth-supabase, rest-api, ' +
-            'nextjs-fullstack, react-native.',
-        inputSchema: ApplyDomainBundleInputSchema,
-        annotations: {
-            title: 'Apply Domain Bundle',
-            readOnlyHint: false,
-            destructiveHint: false,
-            openWorldHint: false,
-        },
-    }, safeLicensed('apply_domain_bundle', async (args) => handleApplyDomainBundle(args)));
-    s.registerTool('list_domain_bundles', {
-        description: 'List all available pre-configured domain bundles with their id, name, description, and tags.',
-        inputSchema: ListDomainBundlesInputSchema,
-        annotations: {
-            title: 'List Domain Bundles',
-            readOnlyHint: true,
-            destructiveHint: false,
-            openWorldHint: false,
-        },
-    }, safeLicensed('list_domain_bundles', async (args) => handleListDomainBundles(args)));
-    // ── SPEC-601: Portable spec bundles (UUID-based) ──────────────────────────
-    s.registerTool('export_spec_bundle', {
-        description: 'Export a spec as a portable JSON bundle (with UUID) for importing into another project. Use for cross-project spec sharing.',
-        annotations: { readOnlyHint: true },
-        inputSchema: {
-            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
-            specId: z.string().min(1).max(500).describe('Spec ID to export (e.g. SPEC-042).'),
-        },
-    }, safeLicensed('export_spec_bundle', async (args) => handleExportBundle(args)));
-    s.registerTool('import_spec_bundle', {
-        description: 'Import a spec bundle from another project. Allocates a new SPEC-NNN locally while preserving the original UUID for collision detection.',
-        inputSchema: {
-            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
-            bundlePath: z
-                .string()
-                .min(1)
-                .max(4096)
-                .describe('Path to the .bundle.json file exported by export_spec_bundle.'),
-        },
-    }, safeLicensed('import_spec_bundle', async (args) => handleImportBundle(args)));
-    // ── SPEC-613: Gherkin BDD import/export ───────────────────────────────────
-    s.registerTool('import_gherkin', {
-        description: 'Import Gherkin .feature file(s) and append scenarios as BDD acceptance criteria to an existing spec. Supports Scenario Outline + Examples (each row becomes one criterion). Provide exactly one of: featureFilePath, gherkinText, or featureDir.',
-        inputSchema: {
-            ...projectIdSchema,
-            specId: z
-                .string()
-                .min(1)
-                .max(500)
-                .describe('Spec ID to append criteria to (e.g. SPEC-042).'),
-            featureFilePath: z
-                .string()
-                .min(1)
-                .max(4096)
-                .optional()
-                .describe('Absolute path to a single .feature file to import.'),
-            gherkinText: z
-                .string()
-                .min(1)
-                .optional()
-                .describe('Raw Gherkin text content to parse (alternative to featureFilePath).'),
-            featureDir: z
-                .string()
-                .min(1)
-                .max(4096)
-                .optional()
-                .describe('Absolute path to a directory containing .feature files (all will be imported).'),
-        },
-        annotations: { title: 'Import Gherkin Scenarios' },
-    }, safeLicensed('import_gherkin', withProject(async (args) => handleImportGherkin(args))));
-    s.registerTool('export_gherkin', {
-        description: 'Export the BDD acceptance criteria of a spec as a Cucumber-compatible .feature file. Only criteria following Given/When/Then patterns are emitted.',
-        annotations: { title: 'Export Spec as Gherkin', readOnlyHint: true },
-        inputSchema: {
-            ...projectIdSchema,
-            specId: z.string().min(1).max(500).describe('Spec ID to export (e.g. SPEC-042).'),
-            outputPath: z
-                .string()
-                .min(1)
-                .max(4096)
-                .describe('Absolute path where the .feature file will be written.'),
-        },
-    }, safeLicensed('export_gherkin', withProject(async (args) => handleExportGherkin(args))));
-}
-//# sourceMappingURL=group-spec-ops.js.map