@planu/cli 4.11.4 → 4.11.5

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [4.11.5] - 2026-07-18
+
+### Bug Fixes
+- fix: close weekly technical debt backlog
+
+
 ## [4.11.4] - 2026-07-18
 
 ### Bug Fixes

package/dist/engine/ai-integration/gemini/gemini-md-generator.js

@@ -58,12 +58,19 @@ function buildSddSection(options) {
         '',
         '### Architecture Rules',
         '',
+        '- Primary implementation stays in `src/`; Rust is an optional acceleration layer, not the default destination for every feature',
         '- `types/` → no imports from other layers',
         '- `engine/` → imports only from `types/`',
         '- `storage/` → imports only from `types/`',
         '- `tools/` → imports from `engine/` + `storage/` + `types/`',
         '- Cross-layer violations → ESLint error',
         '',
+        '### Release Rules',
+        '',
+        '- `main` is the authoritative release branch',
+        '- `develop` and `release` are optional mirrors that must not drift from `main`',
+        '- Run `pnpm check` and `pnpm test` before local release publishing',
+        '',
         PLANU_SECTION_END,
     ].join('\n');
 }

package/dist/engine/outbound-webhook-dispatcher.d.ts

@@ -1,4 +1,4 @@
-import type { OutboundWebhookPayload, OutboundWebhookEventType, OutboundWebhookConfig, OutboundWebhookDelivery } from '../types/index.js';
-export declare function dispatchToWebhooks(webhooks: readonly OutboundWebhookConfig[], payload: OutboundWebhookPayload, onDelivery: (delivery: OutboundWebhookDelivery) => Promise<void>): Promise<void>;
+import type { OutboundWebhookPayload, OutboundWebhookEventType, OutboundWebhookConfig, OutboundWebhookDelivery, WebhookDispatchOptions } from '../types/index.js';
+export declare function dispatchToWebhooks(webhooks: readonly OutboundWebhookConfig[], payload: OutboundWebhookPayload, onDelivery: (delivery: OutboundWebhookDelivery) => Promise<void>, options?: WebhookDispatchOptions): Promise<void>;
 export declare function buildSpecLifecyclePayload(event: OutboundWebhookEventType, specId: string, specTitle: string, status: string, projectPath: string): OutboundWebhookPayload;
 //# sourceMappingURL=outbound-webhook-dispatcher.d.ts.map

package/dist/engine/outbound-webhook-dispatcher.js

@@ -40,13 +40,15 @@ async function attemptDelivery(url, body, signature) {
 // Retry logic: 3 attempts with exponential backoff (1s, 5s, 30s)
 // ---------------------------------------------------------------------------
 const RETRY_DELAYS_MS = [1_000, 5_000, 30_000];
-async function deliverWithRetry(webhook, body, payload, onDelivery) {
+async function deliverWithRetry(webhook, body, payload, onDelivery, options) {
     let lastResult = null;
     const signature = signPayload(webhook.secret, body);
-    for (let attempt = 0; attempt < 3; attempt++) {
+    const retryDelays = options.retryDelaysMs ?? RETRY_DELAYS_MS;
+    const sleep = options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+    for (let attempt = 0; attempt < retryDelays.length + 1; attempt++) {
         if (attempt > 0) {
-            const delay = RETRY_DELAYS_MS[attempt - 1] ?? 1_000;
-            await new Promise((resolve) => setTimeout(resolve, delay));
+            const delay = retryDelays[attempt - 1] ?? 0;
+            await sleep(delay);
         }
         lastResult = await attemptDelivery(webhook.url, body, signature);
         if (lastResult.success) {
@@ -71,12 +73,12 @@ async function deliverWithRetry(webhook, body, payload, onDelivery) {
 // ---------------------------------------------------------------------------
 // Core dispatch (pure — no storage deps)
 // ---------------------------------------------------------------------------
-export async function dispatchToWebhooks(webhooks, payload, onDelivery) {
+export async function dispatchToWebhooks(webhooks, payload, onDelivery, options = {}) {
     if (webhooks.length === 0) {
         return;
     }
     const body = JSON.stringify(payload);
-    await Promise.allSettled(webhooks.map((webhook) => deliverWithRetry(webhook, body, payload, onDelivery)));
+    await Promise.allSettled(webhooks.map((webhook) => deliverWithRetry(webhook, body, payload, onDelivery, options)));
 }
 // ---------------------------------------------------------------------------
 // Helper to build spec lifecycle payloads

package/dist/engine/web-fetcher/registry-auto-discovery.d.ts

@@ -1,4 +1,4 @@
-import type { DiscoveredDocsEntry, DocsRegistryHealth } from '../../types/index.js';
+import type { DiscoveredDocsEntry, DocsRegistryHealth, DocsDiscoveryOptions } from '../../types/index.js';
 /**
  * Verify that a URL is alive with a HEAD request (timeout 3s).
  * Returns true if status is 200, 301, or 302.
@@ -9,7 +9,7 @@ export declare function validateRegistryUrl(url: string): Promise<boolean>;
  * Respects a 1 req/s rate limit per registry via simple delay.
  * Returns null if not found anywhere.
  */
-export declare function discoverDocsUrl(tech: string): Promise<DiscoveredDocsEntry | null>;
+export declare function discoverDocsUrl(tech: string, options?: DocsDiscoveryOptions): Promise<DiscoveredDocsEntry | null>;
 /**
  * Batch validate all entries in the docs registry.
  * Categorizes each entry as healthy (<=2s), slow (2-5s), or broken (timeout/error).

package/dist/engine/web-fetcher/registry-auto-discovery.js

@@ -113,10 +113,14 @@ export async function validateRegistryUrl(url) {
  * Respects a 1 req/s rate limit per registry via simple delay.
  * Returns null if not found anywhere.
  */
-export async function discoverDocsUrl(tech) {
-    const tryWithDelay = async (fn) => {
+export async function discoverDocsUrl(tech, options = {}) {
+    const rateLimitDelayMs = options.rateLimitDelayMs ?? RATE_LIMIT_DELAY_MS;
+    const sleepFn = options.sleep ?? sleep;
+    const tryWithDelay = async (fn, shouldDelay) => {
         const result = await fn();
-        await sleep(RATE_LIMIT_DELAY_MS);
+        if (shouldDelay && rateLimitDelayMs > 0) {
+            await sleepFn(rateLimitDelayMs);
+        }
         return result;
     };
     const registries = [
@@ -124,8 +128,8 @@ export async function discoverDocsUrl(tech) {
         { source: 'pypi', fn: () => tryPypi(tech) },
         { source: 'crates', fn: () => tryCrates(tech) },
     ];
-    for (const { source, fn } of registries) {
-        const url = await tryWithDelay(fn);
+    for (const [index, { source, fn }] of registries.entries()) {
+        const url = await tryWithDelay(fn, index < registries.length - 1);
         if (url) {
             const verified = await validateRegistryUrl(url);
             return {

package/dist/types/docs.d.ts

@@ -285,6 +285,10 @@ export interface DocsRegistryHealth {
     broken: string[];
     slow: string[];
 }
+export interface DocsDiscoveryOptions {
+    rateLimitDelayMs?: number;
+    sleep?: (ms: number) => Promise<void>;
+}
 /** Input for validate_docs_registry tool. */
 export interface ValidateDocsRegistryInput {
     projectPath: string;

package/dist/types/outbound-webhook.d.ts

@@ -48,4 +48,8 @@ export interface WebhookAttemptResult {
     readonly success: boolean;
     readonly error?: string;
 }
+export interface WebhookDispatchOptions {
+    readonly retryDelaysMs?: readonly number[];
+    readonly sleep?: (ms: number) => Promise<void>;
+}
 //# sourceMappingURL=outbound-webhook.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@planu/cli",
-  "version": "4.11.4",
+  "version": "4.11.5",
   "description": "Planu — MCP Server for Spec Driven Development with native Rust acceleration for hot paths. Cross-platform (Linux/macOS/Windows, x64/arm64, glibc/musl).",
   "type": "module",
   "main": "dist/index.js",
@@ -34,14 +34,14 @@
     "packageName": "@planu/core"
   },
   "optionalDependencies": {
-    "@planu/core-darwin-arm64": "4.11.4",
-    "@planu/core-darwin-x64": "4.11.4",
-    "@planu/core-linux-arm64-gnu": "4.11.4",
-    "@planu/core-linux-arm64-musl": "4.11.4",
-    "@planu/core-linux-x64-gnu": "4.11.4",
-    "@planu/core-linux-x64-musl": "4.11.4",
-    "@planu/core-win32-arm64-msvc": "4.11.4",
-    "@planu/core-win32-x64-msvc": "4.11.4"
+    "@planu/core-darwin-arm64": "4.11.5",
+    "@planu/core-darwin-x64": "4.11.5",
+    "@planu/core-linux-arm64-gnu": "4.11.5",
+    "@planu/core-linux-arm64-musl": "4.11.5",
+    "@planu/core-linux-x64-gnu": "4.11.5",
+    "@planu/core-linux-x64-musl": "4.11.5",
+    "@planu/core-win32-arm64-msvc": "4.11.5",
+    "@planu/core-win32-x64-msvc": "4.11.5"
   },
   "engines": {
     "node": ">=24.0.0"

package/planu-native.json

@@ -1,7 +1,7 @@
 {
   "name": "dev.planu.native",
   "displayName": "Planu Native Lightweight Surface",
-  "version": "4.11.4",
+  "version": "4.11.5",
   "packageName": "@planu/cli",
   "modes": {
     "lightweight": {

package/planu-plugin.json

@@ -2,7 +2,7 @@
   "name": "dev.planu.cli",
   "displayName": "Planu — Spec Driven Development",
   "description": "Manage software specs, estimations, and autonomous SDD workflows. Language-agnostic MCP server for Claude Code.",
-  "version": "4.11.4",
+  "version": "4.11.5",
   "icon": "assets/plugin/icon.svg",
   "command": [
     "npx",