@planu/cli 0.63.6 → 0.64.0

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

@@ -0,0 +1,93 @@
+// tools/register-versioning-tools.ts — Registers spec versioning and branching tools (SPEC-168)
+import { z } from 'zod';
+import { safeLicensed } from './safe-handler.js';
+import { handleVersionSpec } from './version-spec.js';
+import { handleBranchSpec } from './branch-spec.js';
+import { handleMergeSpecBranch } from './merge-spec-branch.js';
+export function registerVersioningTools(server) {
+    // version_spec — Create a tagged version snapshot of a spec
+    server.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: {
+            projectId: z.string().max(500).describe('Project ID'),
+            specId: z.string().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', async (args) => handleVersionSpec(args)));
+    // branch_spec — Create a spec branch for experimentation
+    server.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: {
+            projectId: z.string().max(500).describe('Project ID'),
+            specId: z.string().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', async (args) => handleBranchSpec(args)));
+    // merge_spec_branch — Merge a spec branch back into main
+    server.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. ' +
+            'Optionally provide resolvedContent if you have already resolved conflicts manually.',
+        annotations: { title: 'Merge Spec Branch' },
+        inputSchema: {
+            projectId: z.string().max(500).describe('Project ID'),
+            specId: z.string().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. ' +
+                'If not provided, the branch content is used directly (auto-merge).'),
+            newVersionTag: z
+                .string()
+                .max(50)
+                .regex(/^v\d+\.\d+\.\d+$/)
+                .optional()
+                .describe('Version tag for the merged snapshot (e.g., "v2.0.0"). Auto-incremented if not provided.'),
+            message: z
+                .string()
+                .max(500)
+                .optional()
+                .describe('Merge commit message describing what was merged'),
+        },
+    }, safeLicensed('merge_spec_branch', async (args) => handleMergeSpecBranch(args)));
+}
+//# sourceMappingURL=register-versioning-tools.js.map

package/dist/tools/register-versioning-tools.js.map

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

package/dist/tools/register-well-known-tools.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerWellKnownTools(server: McpServer): void;
+//# sourceMappingURL=register-well-known-tools.d.ts.map

package/dist/tools/register-well-known-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-well-known-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-well-known-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwC9D"}

package/dist/tools/register-well-known-tools.js

@@ -0,0 +1,36 @@
+// tools/register-well-known-tools.ts — SPEC-162: Register publish_registry and discover_registry tools
+import { safeTracked } from './safe-handler.js';
+import { PublishRegistryInputSchema, DiscoverRegistryInputSchema } from './schemas/well-known.js';
+import { handlePublishRegistry } from './publish-registry.js';
+import { handleDiscoverRegistry } from './discover-registry.js';
+export function registerWellKnownTools(server) {
+    // publish_registry — generates .well-known/planu.json
+    server.registerTool('publish_registry', {
+        description: 'Generate a .well-known/planu.json manifest from your project specs. ' +
+            'Follows RFC 8615 .well-known URI pattern (used by OpenID Connect, OAuth). ' +
+            'Other teams can discover and reference your specs using discover_registry.',
+        inputSchema: {
+            projectId: PublishRegistryInputSchema.shape.projectId,
+            outputPath: PublishRegistryInputSchema.shape.outputPath,
+            includePrivate: PublishRegistryInputSchema.shape.includePrivate,
+        },
+        annotations: {
+            title: 'Publish Registry Manifest',
+            destructiveHint: false,
+        },
+    }, safeTracked('publish_registry', async (args) => handlePublishRegistry(args)));
+    // discover_registry — reads and parses a manifest from a local file
+    server.registerTool('discover_registry', {
+        description: 'Read and validate a .well-known/planu.json manifest from a local file path. ' +
+            'Returns the project name, spec count, capabilities, and spec summaries. ' +
+            "Use this to discover specs from another team's project.",
+        inputSchema: {
+            manifestPath: DiscoverRegistryInputSchema.shape.manifestPath,
+        },
+        annotations: {
+            title: 'Discover Registry',
+            readOnlyHint: true,
+        },
+    }, safeTracked('discover_registry', async (args) => handleDiscoverRegistry(args)));
+}
+//# sourceMappingURL=register-well-known-tools.js.map

package/dist/tools/register-well-known-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-well-known-tools.js","sourceRoot":"","sources":["../../src/tools/register-well-known-tools.ts"],"names":[],"mappings":"AAAA,uGAAuG;AAGvG,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAClG,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,sDAAsD;IACtD,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,WAAW,EACT,sEAAsE;YACtE,4EAA4E;YAC5E,4EAA4E;QAC9E,WAAW,EAAE;YACX,SAAS,EAAE,0BAA0B,CAAC,KAAK,CAAC,SAAS;YACrD,UAAU,EAAE,0BAA0B,CAAC,KAAK,CAAC,UAAU;YACvD,cAAc,EAAE,0BAA0B,CAAC,KAAK,CAAC,cAAc;SAChE;QACD,WAAW,EAAE;YACX,KAAK,EAAE,2BAA2B;YAClC,eAAe,EAAE,KAAK;SACvB;KACF,EACD,WAAW,CAAC,kBAAkB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAC7E,CAAC;IAEF,oEAAoE;IACpE,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,WAAW,EACT,8EAA8E;YAC9E,0EAA0E;YAC1E,yDAAyD;QAC3D,WAAW,EAAE;YACX,YAAY,EAAE,2BAA2B,CAAC,KAAK,CAAC,YAAY;SAC7D;QACD,WAAW,EAAE;YACX,KAAK,EAAE,mBAAmB;YAC1B,YAAY,EAAE,IAAI;SACnB;KACF,EACD,WAAW,CAAC,mBAAmB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAC/E,CAAC;AACJ,CAAC"}

package/dist/tools/repair-spec.d.ts

@@ -0,0 +1,9 @@
+import type { ToolResult, RepairSpecArgs } from '../types/index.js';
+/**
+ * Handle the repair_spec tool: auto-detect and fix common spec problems.
+ *
+ * In dry-run mode (default: false), returns detected issues without writing files.
+ * When dryRun=false, applies fixes to spec.md on disk.
+ */
+export declare function handleRepairSpec(args: RepairSpecArgs): Promise<ToolResult>;
+//# sourceMappingURL=repair-spec.d.ts.map

package/dist/tools/repair-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair-spec.d.ts","sourceRoot":"","sources":["../../src/tools/repair-spec.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAa,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAO/E;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAiGhF"}

package/dist/tools/repair-spec.js

@@ -0,0 +1,93 @@
+// tools/repair-spec.ts — MCP handler for the repair_spec tool (SPEC-164)
+import { specStore } from '../storage/index.js';
+import { repairSpec } from '../engine/spec-repair.js';
+import { formatSuccess, formatError } from './response-helpers.js';
+import { readFile, writeFile } from 'node:fs/promises';
+import { ti } from '../i18n/index.js';
+/**
+ * Handle the repair_spec tool: auto-detect and fix common spec problems.
+ *
+ * In dry-run mode (default: false), returns detected issues without writing files.
+ * When dryRun=false, applies fixes to spec.md on disk.
+ */
+export async function handleRepairSpec(args) {
+    const { projectId, specId, dryRun = false } = args;
+    const spec = await specStore.getSpec(projectId, specId);
+    if (!spec) {
+        return {
+            content: [{ type: 'text', text: formatError(ti('spec.notFound', { id: specId })) }],
+            isError: true,
+        };
+    }
+    let specContent;
+    try {
+        specContent = await readFile(spec.specPath, 'utf-8');
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: formatError(`Could not read spec file at ${spec.specPath}: ${msg}`, 'Verify the file exists and is readable.'),
+                },
+            ],
+            isError: true,
+        };
+    }
+    const result = repairSpec(specContent, dryRun);
+    // Persist repaired content when not a dry run and fixes were applied
+    if (!dryRun && result.fixCount > 0) {
+        try {
+            await writeFile(spec.specPath, result.repairedContent, 'utf-8');
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: formatError(`Fixes detected but could not write repaired spec: ${msg}`, 'Check file permissions and try again.'),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    const mode = dryRun ? 'Dry run' : 'Applied';
+    const fixSummary = result.fixes.length === 0
+        ? 'No issues detected — spec is well-formed.'
+        : result.fixes
+            .map((f, i) => `${String(i + 1)}. [${f.type}] ${f.description}${f.line > 0 ? ` (line ${String(f.line)})` : ''}`)
+            .join('\n');
+    const body = [
+        `**Spec:** ${specId}`,
+        `**Mode:** ${mode}`,
+        `**Issues found:** ${String(result.fixes.length)}`,
+        `**Fixes applied:** ${String(result.fixCount)}`,
+        '',
+        result.fixes.length > 0 ? `### Detected Issues\n${fixSummary}` : fixSummary,
+    ].join('\n');
+    const title = dryRun
+        ? `repair_spec — ${String(result.fixes.length)} issue(s) detected`
+        : `repair_spec — ${String(result.fixCount)} fix(es) applied`;
+    const nextSteps = result.fixes.length > 0
+        ? dryRun
+            ? [`Run repair_spec without dryRun=true to apply ${String(result.fixes.length)} fix(es)`]
+            : [
+                'Review the repaired spec.md and adjust any [REWRITE] placeholders',
+                'Run validate to confirm the spec is ready',
+            ]
+        : ['No action needed — spec is well-formed'];
+    return {
+        content: [{ type: 'text', text: formatSuccess(title, body, nextSteps) }],
+        structuredContent: {
+            specId,
+            dryRun,
+            fixCount: result.fixCount,
+            issueCount: result.fixes.length,
+            fixes: result.fixes,
+        },
+    };
+}
+//# sourceMappingURL=repair-spec.js.map

package/dist/tools/repair-spec.js.map

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

package/dist/tools/resolve-spec-conflict.d.ts

@@ -0,0 +1,7 @@
+import type { ResolveSpecConflictInput, ToolResult } from '../types/index.js';
+/**
+ * Handle the resolve_spec_conflict tool call.
+ * Detects conflicts from simultaneous spec + code changes and applies the resolution policy.
+ */
+export declare function handleResolveSpecConflict(args: ResolveSpecConflictInput): ToolResult;
+//# sourceMappingURL=resolve-spec-conflict.d.ts.map

package/dist/tools/resolve-spec-conflict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-spec-conflict.d.ts","sourceRoot":"","sources":["../../src/tools/resolve-spec-conflict.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,wBAAwB,EACxB,UAAU,EAGX,MAAM,mBAAmB,CAAC;AAG3B;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,wBAAwB,GAAG,UAAU,CA+CpF"}

package/dist/tools/resolve-spec-conflict.js

@@ -0,0 +1,63 @@
+// tools/resolve-spec-conflict.ts — SPEC-172: Resolve merge conflicts between spec and code
+// Presents a 3-way diff (original spec, new spec, code changes) and applies resolution policy.
+import { resolveSpecConflict } from '../engine/living-spec/index.js';
+import { jsonResult, errJson } from './response-helpers.js';
+/**
+ * Handle the resolve_spec_conflict tool call.
+ * Detects conflicts from simultaneous spec + code changes and applies the resolution policy.
+ */
+export function handleResolveSpecConflict(args) {
+    const { specId, originalSpec, newSpec, codeChanges, policy = 'always-ask' } = args;
+    if (!specId.trim()) {
+        return errJson({ error: 'specId is required and must not be empty.' });
+    }
+    if (!originalSpec.trim() && !newSpec.trim()) {
+        return errJson({ error: 'At least one of originalSpec or newSpec must be non-empty.' });
+    }
+    const resolution = resolveSpecConflict(originalSpec, newSpec, codeChanges, specId, policy);
+    const totalConflicts = resolution.autoResolved.length + resolution.pendingReview.length;
+    const summary = {
+        specId,
+        policy,
+        totalConflicts,
+        autoResolved: resolution.autoResolved.length,
+        pendingReview: resolution.pendingReview.length,
+        resolvedAt: resolution.resolvedAt,
+    };
+    const output = {
+        summary,
+        autoResolved: resolution.autoResolved.map((r) => ({
+            conflictId: r.conflict.id,
+            category: r.conflict.category,
+            description: r.conflict.description,
+            winner: r.winner,
+            policy: r.appliedPolicy,
+            explanation: r.explanation,
+        })),
+        pendingReview: resolution.pendingReview.map((c) => ({
+            conflictId: c.id,
+            category: c.category,
+            description: c.description,
+            specSide: c.specSide,
+            codeSide: c.codeSide,
+        })),
+        conflictMarkers: resolution.conflictMarkers.length > 0 ? resolution.conflictMarkers.join('\n') : null,
+        message: buildMessage(resolution.autoResolved.length, resolution.pendingReview.length, policy),
+    };
+    return jsonResult(output);
+}
+function buildMessage(autoResolved, pendingReview, policy) {
+    if (autoResolved === 0 && pendingReview === 0) {
+        return 'No conflicts detected between spec and code changes.';
+    }
+    const parts = [];
+    if (autoResolved > 0) {
+        parts.push(`${String(autoResolved)} conflict(s) auto-resolved using "${policy}" policy.`);
+    }
+    if (pendingReview > 0) {
+        parts.push(`${String(pendingReview)} conflict(s) require human review. ` +
+            `Use the conflictMarkers field to see git-style conflict markers for your spec.md.`);
+    }
+    return parts.join(' ');
+}
+//# sourceMappingURL=resolve-spec-conflict.js.map

package/dist/tools/resolve-spec-conflict.js.map

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

package/dist/tools/response-helpers.d.ts

@@ -17,6 +17,48 @@ export declare function formatError(message: string, fix?: string): string;
  * Append a next-steps section to existing text.
  */
 export declare function addNextSteps(text: string, steps: string[]): string;
+/**
+ * Wrap a JSON-serializable value into a success ToolResult.
+ * The value is pretty-printed as JSON text content.
+ */
+export declare function jsonResult(data: unknown): {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    isError?: boolean;
+};
+/**
+ * Wrap a plain text message into a ToolResult.
+ */
+export declare function textResult(message: string): {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    isError?: boolean;
+};
+/**
+ * Wrap an error message into a ToolResult with isError: true.
+ * The message is returned as plain text (not JSON-wrapped).
+ */
+export declare function errText(message: string): {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    isError: true;
+};
+/**
+ * Wrap a JSON-serializable error payload into a ToolResult with isError: true.
+ */
+export declare function errJson(data: unknown): {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    isError: true;
+};
 /**
  * Wrap text into a CallToolResult format.
  */

package/dist/tools/response-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"response-helpers.d.ts","sourceRoot":"","sources":["../../src/tools/response-helpers.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAQvF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAYzF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAMjE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAOlE;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,OAAO,UAAQ,GACd;IACD,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C,CAeA"}
+{"version":3,"file":"response-helpers.d.ts","sourceRoot":"","sources":["../../src/tools/response-helpers.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAQvF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAYzF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAMjE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAOlE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG;IACzC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAEA;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG;IAC3C,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAEA;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG;IACxC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,OAAO,EAAE,IAAI,CAAC;CACf,CAEA;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG;IACtC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,OAAO,EAAE,IAAI,CAAC;CACf,CAKA;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,OAAO,UAAQ,GACd;IACD,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C,CAeA"}

package/dist/tools/response-helpers.js

@@ -52,6 +52,35 @@ export function addNextSteps(text, steps) {
     steps.forEach((step, i) => section.push(`${String(i + 1)}. ${step}`));
     return `${text}\n\n${section.join('\n')}`;
 }
+/**
+ * Wrap a JSON-serializable value into a success ToolResult.
+ * The value is pretty-printed as JSON text content.
+ */
+export function jsonResult(data) {
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+}
+/**
+ * Wrap a plain text message into a ToolResult.
+ */
+export function textResult(message) {
+    return { content: [{ type: 'text', text: message }] };
+}
+/**
+ * Wrap an error message into a ToolResult with isError: true.
+ * The message is returned as plain text (not JSON-wrapped).
+ */
+export function errText(message) {
+    return { content: [{ type: 'text', text: message }], isError: true };
+}
+/**
+ * Wrap a JSON-serializable error payload into a ToolResult with isError: true.
+ */
+export function errJson(data) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+        isError: true,
+    };
+}
 /**
  * Wrap text into a CallToolResult format.
  */

package/dist/tools/response-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"response-helpers.js","sourceRoot":"","sources":["../../src/tools/response-helpers.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAEjF,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAEzC;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,IAAY,EAAE,SAAoB;IAC7E,MAAM,MAAM,GAAG,OAAO,KAAK,IAAI,CAAC;IAChC,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IACjC,IAAI,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC;QAC9C,SAAS,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,IAAY,EAAE,WAAsB;IAC/E,MAAM,MAAM,GAAG,QAAQ,KAAK,IAAI,CAAC;IACjC,MAAM,UAAU,GAAG,IAAI;SACpB,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;SAC1B,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,IAAI,WAAW,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC;QAChD,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,GAAY;IACvD,MAAM,SAAS,GAAG,EAAE,CAAC,sBAAsB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC1D,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,SAAS,KAAK,EAAE,CAAC,yBAAyB,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;AACnE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,KAAe;IACxD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC;IAChD,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;IACtE,OAAO,GAAG,IAAI,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,IAAY,EACZ,UAAoC,EACpC,OAAO,GAAG,KAAK;IAMf,MAAM,MAAM,GAIR;QACF,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;KAC3C,CAAC;IACF,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IACxB,CAAC;IACD,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,CAAC,iBAAiB,GAAG,UAAU,CAAC;IACxC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"response-helpers.js","sourceRoot":"","sources":["../../src/tools/response-helpers.ts"],"names":[],"mappings":"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"}

package/dist/tools/schemas/auth-schema.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+/** Schema for the configure_auth tool input. */
+export declare const ConfigureAuthInputSchema: z.ZodObject<{
+    clientId: z.ZodString;
+    authorizationUrl: z.ZodURL;
+    tokenUrl: z.ZodURL;
+    introspectionUrl: z.ZodOptional<z.ZodURL>;
+    jwksUrl: z.ZodOptional<z.ZodURL>;
+    scopes: z.ZodArray<z.ZodString>;
+    scopeMappings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+}, z.core.$strip>;
+//# sourceMappingURL=auth-schema.d.ts.map

package/dist/tools/schemas/auth-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-schema.d.ts","sourceRoot":"","sources":["../../../src/tools/schemas/auth-schema.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gDAAgD;AAChD,eAAO,MAAM,wBAAwB;;;;;;;;iBA+CnC,CAAC"}

package/dist/tools/schemas/auth-schema.js

@@ -0,0 +1,38 @@
+// tools/schemas/auth-schema.ts — Zod schema for configure_auth tool (SPEC-161)
+import { z } from 'zod';
+/** Schema for the configure_auth tool input. */
+export const ConfigureAuthInputSchema = z.object({
+    clientId: z
+        .string()
+        .min(1)
+        .max(500)
+        .describe('OAuth 2.1 client ID registered with the identity provider'),
+    authorizationUrl: z
+        .url()
+        .describe('Authorization endpoint URL (used for the PKCE authorization code flow)'),
+    tokenUrl: z
+        .url()
+        .describe('Token endpoint URL where authorization codes are exchanged for access tokens'),
+    introspectionUrl: z
+        .url()
+        .optional()
+        .describe('RFC 7662 token introspection endpoint URL. Required when using opaque (non-JWT) tokens. ' +
+        'Provide either introspectionUrl or jwksUrl.'),
+    jwksUrl: z
+        .url()
+        .optional()
+        .describe('JWKS endpoint URL for verifying JWT signatures offline. ' +
+        'Provide either jwksUrl or introspectionUrl.'),
+    scopes: z
+        .array(z.string().min(1).max(500))
+        .min(1)
+        .max(50)
+        .describe('OAuth scopes to request at authorization time. ' +
+        'Built-in scopes: planu:read | planu:write | planu:admin'),
+    scopeMappings: z
+        .record(z.string().min(1), z.array(z.string().min(1).max(500)).max(200))
+        .optional()
+        .describe('Custom scope → tool names mapping. Extends the built-in mappings. ' +
+        'Example: { "myapp:read": ["list_specs", "summarize_spec"] }'),
+});
+//# sourceMappingURL=auth-schema.js.map

package/dist/tools/schemas/auth-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-schema.js","sourceRoot":"","sources":["../../../src/tools/schemas/auth-schema.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAE/E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gDAAgD;AAChD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CAAC,2DAA2D,CAAC;IAExE,gBAAgB,EAAE,CAAC;SAChB,GAAG,EAAE;SACL,QAAQ,CAAC,wEAAwE,CAAC;IAErF,QAAQ,EAAE,CAAC;SACR,GAAG,EAAE;SACL,QAAQ,CAAC,8EAA8E,CAAC;IAE3F,gBAAgB,EAAE,CAAC;SAChB,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,CACP,0FAA0F;QACxF,6CAA6C,CAChD;IAEH,OAAO,EAAE,CAAC;SACP,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,CACP,0DAA0D;QACxD,6CAA6C,CAChD;IAEH,MAAM,EAAE,CAAC;SACN,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;SACjC,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,CACP,iDAAiD;QAC/C,yDAAyD,CAC5D;IAEH,aAAa,EAAE,CAAC;SACb,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;SACvE,QAAQ,EAAE;SACV,QAAQ,CACP,oEAAoE;QAClE,6DAA6D,CAChE;CACJ,CAAC,CAAC"}

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

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+export declare const RbacRoleEnum: z.ZodEnum<{
+    Admin: "Admin";
+    Architect: "Architect";
+    Developer: "Developer";
+    Reviewer: "Reviewer";
+    Observer: "Observer";
+}>;
+export declare const ConfigureRolesInputSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    enabled: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const AssignRoleInputSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    userId: z.ZodString;
+    role: z.ZodEnum<{
+        Admin: "Admin";
+        Architect: "Architect";
+        Developer: "Developer";
+        Reviewer: "Reviewer";
+        Observer: "Observer";
+    }>;
+    specId: z.ZodOptional<z.ZodString>;
+    assignedBy: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+//# sourceMappingURL=rbac.d.ts.map

package/dist/tools/schemas/rbac.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rbac.d.ts","sourceRoot":"","sources":["../../../src/tools/schemas/rbac.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,YAAY;;;;;;EAItB,CAAC;AAEJ,eAAO,MAAM,yBAAyB;;;iBAOpC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;iBAchC,CAAC"}

package/dist/tools/schemas/rbac.js

@@ -0,0 +1,25 @@
+// schemas/rbac.ts — Zod input schemas for RBAC tools (SPEC-166)
+import { z } from 'zod';
+export const RbacRoleEnum = z
+    .enum(['Admin', 'Architect', 'Developer', 'Reviewer', 'Observer'])
+    .describe('RBAC role: Admin (full access) | Architect (create/approve/configure) | Developer (read/update/implement) | Reviewer (read/approve) | Observer (read-only)');
+export const ConfigureRolesInputSchema = z.object({
+    projectId: z.string().min(1).describe('Project identifier (hash of the project path).'),
+    enabled: z
+        .boolean()
+        .describe('Enable (true) or disable (false) RBAC for this project. When disabled, all operations are allowed (single-user mode).'),
+});
+export const AssignRoleInputSchema = z.object({
+    projectId: z.string().min(1).describe('Project identifier (hash of the project path).'),
+    userId: z.string().min(1).describe('User identifier — typically email or OAuth subject claim.'),
+    role: RbacRoleEnum,
+    specId: z
+        .string()
+        .optional()
+        .describe('Optional. When set, this assignment is scoped to a specific spec and overrides the project-level role.'),
+    assignedBy: z
+        .string()
+        .optional()
+        .describe('Optional. User ID of the admin performing the assignment.'),
+});
+//# sourceMappingURL=rbac.js.map

package/dist/tools/schemas/rbac.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rbac.js","sourceRoot":"","sources":["../../../src/tools/schemas/rbac.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAEhE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC;KAC1B,IAAI,CAAC,CAAC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;KACjE,QAAQ,CACP,4JAA4J,CAC7J,CAAC;AAEJ,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gDAAgD,CAAC;IACvF,OAAO,EAAE,CAAC;SACP,OAAO,EAAE;SACT,QAAQ,CACP,uHAAuH,CACxH;CACJ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gDAAgD,CAAC;IACvF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2DAA2D,CAAC;IAC/F,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,wGAAwG,CACzG;IACH,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,2DAA2D,CAAC;CACzE,CAAC,CAAC"}

package/dist/tools/schemas/well-known.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+/** Input schema for the publish_registry tool. */
+export declare const PublishRegistryInputSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    outputPath: z.ZodOptional<z.ZodString>;
+    includePrivate: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/** Input schema for the discover_registry tool. */
+export declare const DiscoverRegistryInputSchema: z.ZodObject<{
+    manifestPath: z.ZodString;
+}, z.core.$strip>;
+//# sourceMappingURL=well-known.d.ts.map

package/dist/tools/schemas/well-known.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"well-known.d.ts","sourceRoot":"","sources":["../../../src/tools/schemas/well-known.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,kDAAkD;AAClD,eAAO,MAAM,0BAA0B;;;;iBAqBrC,CAAC;AAEH,mDAAmD;AACnD,eAAO,MAAM,2BAA2B;;iBAStC,CAAC"}

package/dist/tools/schemas/well-known.js

@@ -0,0 +1,31 @@
+// schemas/well-known.ts — SPEC-162: Zod schemas for publish_registry and discover_registry tools
+import { z } from 'zod';
+/** Input schema for the publish_registry tool. */
+export const PublishRegistryInputSchema = z.object({
+    projectId: z
+        .string()
+        .min(1)
+        .max(100)
+        .describe('Project ID (hash) to load specs from. Use the ID shown by list_specs.'),
+    outputPath: z
+        .string()
+        .max(2000)
+        .optional()
+        .describe('Absolute path to the directory where .well-known/planu.json will be written. ' +
+        'Defaults to the current working directory.'),
+    includePrivate: z
+        .boolean()
+        .default(false)
+        .describe('Whether to include specs with status "private" or "draft" in the manifest. ' +
+        'Default: false (only published specs are included).'),
+});
+/** Input schema for the discover_registry tool. */
+export const DiscoverRegistryInputSchema = z.object({
+    manifestPath: z
+        .string()
+        .min(1)
+        .max(2000)
+        .describe('Absolute path to a .well-known/planu.json manifest file to parse and validate. ' +
+        'Example: /home/user/other-project/.well-known/planu.json'),
+});
+//# sourceMappingURL=well-known.js.map