@planu/cli 0.23.2 → 0.25.0

package/dist/engine/dashboard/templates-project.js

@@ -0,0 +1,163 @@
+// engine/dashboard/templates-project.ts — Project and spec HTML renderers.
+import { renderLayout, escapeHtml, markdownToHtml } from './templates-layout.js';
+/** Render a single spec card HTML fragment */
+function renderSpecCard(spec) {
+    const hasProgress = spec.criteriaTotal > 0;
+    const progressBar = hasProgress
+        ? `<div class="progress-bar-wrap">
+        <div class="progress-bar-fill" style="width:${spec.progressPercent}%"></div>
+       </div>
+       <div class="progress-text">
+         <span class="criteria-text">${spec.criteriaImplemented}/${spec.criteriaTotal} criterios</span>
+         <span class="progress-pct">${spec.progressPercent}%</span>
+       </div>`
+        : `<div style="font-size:0.75rem;color:var(--text-muted)">Sin datos de progreso</div>`;
+    return `<a href="/spec/${encodeURIComponent(spec.id.split('-')[0] ?? spec.id)}/${encodeURIComponent(spec.id)}"
+     class="spec-card status-${escapeHtml(spec.status)}" data-spec-id="${escapeHtml(spec.id)}">
+    <div class="spec-id" style="color:var(--status-${escapeHtml(spec.status)})">${escapeHtml(spec.id)}</div>
+    <div class="spec-title">${escapeHtml(spec.title)}</div>
+    <span class="status-badge">${escapeHtml(spec.status)}</span>
+    ${progressBar}
+  </a>`;
+}
+/** Render the usage stats panel */
+function renderUsagePanel(usage) {
+    if (!usage.isAvailable) {
+        return `<div class="usage-panel">
+      <h3>Uso</h3>
+      <div style="color:var(--text-muted);font-size:0.85rem">Sin datos de uso disponibles</div>
+    </div>`;
+    }
+    const tierLabel = usage.tier.charAt(0).toUpperCase() + usage.tier.slice(1);
+    const limitLabel = usage.dailyLimit !== null ? String(usage.dailyLimit) : '∞';
+    const callsLabel = `${usage.callsToday} / ${limitLabel}`;
+    let trialHtml = '';
+    if (usage.trialDaysLeft !== null) {
+        const isCritical = usage.trialDaysLeft <= 3;
+        trialHtml = `<div class="trial-warning ${isCritical ? 'trial-critical' : ''}">
+      Trial: ${usage.trialDaysLeft} día${usage.trialDaysLeft !== 1 ? 's' : ''} restante${usage.trialDaysLeft !== 1 ? 's' : ''}
+    </div>`;
+    }
+    return `<div class="usage-panel">
+    <h3>Uso</h3>
+    <div class="usage-tier">${escapeHtml(tierLabel)}</div>
+    <div style="font-size:0.82rem;color:var(--text-muted);margin-top:0.35rem">Llamadas hoy: ${escapeHtml(callsLabel)}</div>
+    ${trialHtml}
+  </div>`;
+}
+/** Render the health metrics panel */
+function renderHealthPanel(metrics) {
+    const estimLabel = metrics.totalEstimation !== null ? `${metrics.totalEstimation}h` : 'Sin estimación';
+    return `<div>
+    <h2 style="margin-bottom:1rem;font-size:1rem;color:var(--text-muted)">Project Health</h2>
+    <div class="grid grid-2" style="gap:0.75rem">
+      <div class="metric-card">
+        <div class="metric-value">${metrics.totalSpecs}</div>
+        <div class="metric-label">Total specs</div>
+      </div>
+      <div class="metric-card">
+        <div class="metric-value">${metrics.donePercent}%</div>
+        <div class="metric-label">Completado</div>
+      </div>
+      <div class="metric-card">
+        <div class="metric-value">${metrics.pendingApproval}</div>
+        <div class="metric-label">Pendientes aprobación</div>
+      </div>
+      <div class="metric-card">
+        <div class="metric-value">${metrics.activeImplementation}</div>
+        <div class="metric-label">En implementación</div>
+      </div>
+    </div>
+    <div style="margin-top:0.75rem;font-size:0.82rem;color:var(--text-muted)">
+      Estimación total: <strong>${escapeHtml(estimLabel)}</strong>
+    </div>
+  </div>`;
+}
+/** Render the home page — list of all projects */
+export function renderHomePage(projects, usage) {
+    const projectContent = projects.length === 0
+        ? `<div class="empty-state">
+          <h2>No hay proyectos registrados</h2>
+          <p>Usa el tool <code>init_project</code> desde tu cliente MCP para crear tu primer proyecto.</p>
+        </div>`
+        : `<h2 style="margin-bottom:1rem">Proyectos</h2>
+         <div class="project-list">
+           ${projects
+            .map((p) => `<a href="/project/${encodeURIComponent(p.id)}" class="project-card">
+               <div class="project-info">
+                 <h2>${escapeHtml(p.name)}</h2>
+                 <div class="meta">${escapeHtml(p.stack)} &bull; ${escapeHtml(p.path)} &bull; Última actividad: ${escapeHtml(p.lastActivity)}</div>
+               </div>
+               <div class="project-stats">
+                 <div>${p.specCount} specs</div>
+                 <div class="done">${p.doneCount} done</div>
+               </div>
+             </a>`)
+            .join('\n')}
+         </div>`;
+    const body = `${projectContent}${renderUsagePanel(usage)}`;
+    return renderLayout('Inicio', body);
+}
+/** Render the project detail page — spec cards + health panel */
+export function renderProjectPage(project, metrics, usage) {
+    const specCards = project.specs.length === 0
+        ? `<div class="empty-state"><p>Este proyecto no tiene specs aún.</p></div>`
+        : project.specs.map(renderSpecCard).join('\n');
+    const body = `
+    <div class="breadcrumb">
+      <a href="/">Inicio</a> &rsaquo; ${escapeHtml(project.name)}
+    </div>
+    <div style="display:grid;grid-template-columns:1fr 280px;gap:2rem;align-items:start">
+      <div>
+        <h2 style="margin-bottom:1.25rem">${escapeHtml(project.name)}</h2>
+        <div id="spec-grid" class="spec-grid">${specCards}</div>
+      </div>
+      <div>
+        ${renderHealthPanel(metrics)}
+        ${renderUsagePanel(usage)}
+      </div>
+    </div>
+  `;
+    return renderLayout(project.name, body);
+}
+/** Render the spec detail page — HU, FICHA, PROGRESS tabs */
+export function renderSpecPage(projectId, projectName, specId, hu, ficha, progress) {
+    const huHtml = hu !== null ? markdownToHtml(hu) : '<p style="color:var(--text-muted)">HU.md no encontrado</p>';
+    const fichaHtml = ficha !== null
+        ? markdownToHtml(ficha)
+        : '<p style="color:var(--text-muted)">FICHA-TECNICA.md no encontrado</p>';
+    const progressHtml = progress !== null
+        ? markdownToHtml(progress)
+        : '<p style="color:var(--text-muted)">PROGRESS.md no encontrado</p>';
+    const body = `
+    <div class="breadcrumb">
+      <a href="/">Inicio</a> &rsaquo;
+      <a href="/project/${encodeURIComponent(projectId)}">${escapeHtml(projectName)}</a> &rsaquo;
+      ${escapeHtml(specId)}
+    </div>
+    <div class="tabs">
+      <button class="tab-btn active" data-tab="hu">Historia de Usuario</button>
+      <button class="tab-btn" data-tab="ficha">Ficha Técnica</button>
+      <button class="tab-btn" data-tab="progress">Progreso</button>
+    </div>
+    <div id="tab-hu" class="tab-content active">
+      <div class="md-content card">${huHtml}</div>
+    </div>
+    <div id="tab-ficha" class="tab-content">
+      <div class="md-content card">${fichaHtml}</div>
+    </div>
+    <div id="tab-progress" class="tab-content">
+      <div class="md-content card">${progressHtml}</div>
+    </div>
+  `;
+    return renderLayout(specId, body);
+}
+/** Render a 404 not found page */
+export function render404Page(path) {
+    return renderLayout('404', `<div class="empty-state">
+      <h2>404 — Página no encontrada</h2>
+      <p>La ruta <code>${escapeHtml(path)}</code> no existe.</p>
+      <p style="margin-top:1rem"><a href="/">Volver al inicio</a></p>
+    </div>`);
+}
+//# sourceMappingURL=templates-project.js.map

package/dist/engine/dashboard/templates-project.js.map

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

package/dist/engine/dashboard/templates.d.ts

@@ -0,0 +1,3 @@
+export * from './templates-layout.js';
+export * from './templates-project.js';
+//# sourceMappingURL=templates.d.ts.map

package/dist/engine/dashboard/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/engine/dashboard/templates.ts"],"names":[],"mappings":"AACA,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC"}

package/dist/engine/dashboard/templates.js

@@ -0,0 +1,4 @@
+// engine/dashboard/templates.ts — Barrel re-export for all dashboard templates.
+export * from './templates-layout.js';
+export * from './templates-project.js';
+//# sourceMappingURL=templates.js.map

package/dist/engine/dashboard/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../src/engine/dashboard/templates.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC"}

package/dist/engine/focus-tracker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"focus-tracker.d.ts","sourceRoot":"","sources":["../../src/engine/focus-tracker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAuDhE;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAEnE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAElE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAElD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,MAAM,GACrB,UAAU,GAAG,IAAI,CA0BnB;AAWD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAcxE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C"}
+{"version":3,"file":"focus-tracker.d.ts","sourceRoot":"","sources":["../../src/engine/focus-tracker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAwDhE;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAEnE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAElE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAElD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,MAAM,GACrB,UAAU,GAAG,IAAI,CA0BnB;AAWD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAcxE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C"}

package/dist/engine/focus-tracker.js

@@ -33,6 +33,7 @@ function jaccardSimilarity(a, b) {
         }
     }
     const union = a.size + b.size - intersection;
+    /* v8 ignore next 1 */
     return union === 0 ? 0 : intersection / union;
 }
 /** Similarity between two text strings (0–1). */

package/dist/engine/focus-tracker.js.map

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

package/dist/engine/hooks/core.d.ts

@@ -0,0 +1,26 @@
+import type { HookDefinition, HookEventPayload, HookExecutionLog } from '../../types/index.js';
+/**
+ * Execute a single hook for the given payload.
+ * Returns a complete execution log entry.
+ */
+export declare function executeHook(hook: HookDefinition, payload: HookEventPayload, depth: number): HookExecutionLog;
+/**
+ * Dispatch an event to all matching enabled hooks.
+ * Fire-and-forget — errors in hooks are captured in the log, never thrown.
+ * Returns execution logs for all fired hooks.
+ *
+ * @param hooks - List of all hooks for the project
+ * @param payload - Event payload to dispatch
+ * @param depth - Current recursion depth (starts at 0)
+ */
+export declare function dispatchEvent(hooks: HookDefinition[], payload: HookEventPayload, depth?: number): HookExecutionLog[];
+/**
+ * Simulate hook execution without side effects (dry run).
+ * Returns which hooks would fire and what actions they would execute.
+ */
+export declare function dryRunDispatch(hooks: HookDefinition[], payload: HookEventPayload): {
+    hook: HookDefinition;
+    wouldFire: boolean;
+    reason?: string;
+}[];
+//# sourceMappingURL=core.d.ts.map

package/dist/engine/hooks/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/engine/hooks/core.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAGjB,MAAM,sBAAsB,CAAC;AA8F9B;;;GAGG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,MAAM,GACZ,gBAAgB,CAyBlB;AAMD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,EAAE,gBAAgB,EACzB,KAAK,SAAI,GACR,gBAAgB,EAAE,CAyBpB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,EAAE,gBAAgB,GACxB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,CAiBjE"}

package/dist/engine/hooks/core.js

@@ -0,0 +1,164 @@
+// engine/hooks/core.ts — Hook registry: load, match, execute (SPEC-071)
+// Hooks are LAZY — executed when a tool fires an event, not via daemon.
+// Recursion guard: max depth = 3 to prevent infinite loops.
+import { matchesFilter } from './triggers.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const MAX_DEPTH = 3;
+// ---------------------------------------------------------------------------
+// Interpolation
+// ---------------------------------------------------------------------------
+/**
+ * Interpolate {{key}} placeholders in a string using values from the payload
+ * and a flat context map.
+ */
+function interpolate(template, context) {
+    return template.replace(/\{\{(\w+)\}\}/g, (_, key) => {
+        const value = context[key];
+        if (value === undefined || value === null) {
+            return `{{${key}}}`;
+        }
+        if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+            return String(value);
+        }
+        return JSON.stringify(value);
+    });
+}
+/**
+ * Flatten the event payload into a string-keyed context map for interpolation.
+ */
+function payloadToContext(payload) {
+    return payload;
+}
+// ---------------------------------------------------------------------------
+// Action execution
+// ---------------------------------------------------------------------------
+/**
+ * Execute a single hook action. Returns the action result.
+ * This function does NOT throw — errors are captured in the result.
+ */
+function executeAction(action, payload) {
+    const context = payloadToContext(payload);
+    try {
+        switch (action.type) {
+            case 'log_message': {
+                const message = interpolate(action.message, context);
+                console.warn(`[Planu Hook] ${message}`);
+                return { actionType: action.type, status: 'success', output: message };
+            }
+            case 'notify': {
+                const message = interpolate(action.message, context);
+                console.warn(`[Planu Hook Notify] ${message}`);
+                return { actionType: action.type, status: 'success', output: message };
+            }
+            case 'set_variable': {
+                const value = interpolate(action.value, context);
+                return {
+                    actionType: action.type,
+                    status: 'success',
+                    output: `Set ${action.key}=${value}`,
+                };
+            }
+            case 'run_tool': {
+                // Tools are invoked via fire-and-forget — we log intent but do not
+                // actually call the MCP server recursively from within the engine.
+                const toolArgs = JSON.stringify(action.args);
+                const message = `Would invoke tool '${action.tool}' with args: ${toolArgs}`;
+                console.warn(`[Planu Hook run_tool] ${message}`);
+                return { actionType: action.type, status: 'success', output: message };
+            }
+        }
+    }
+    catch (err) {
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        return {
+            actionType: action.type,
+            status: 'failed',
+            errorMessage,
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// Hook dispatch
+// ---------------------------------------------------------------------------
+/**
+ * Execute a single hook for the given payload.
+ * Returns a complete execution log entry.
+ */
+export function executeHook(hook, payload, depth) {
+    const startMs = Date.now();
+    const logId = `log-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    const actionResults = [];
+    for (const action of hook.actions) {
+        const result = executeAction(action, payload);
+        actionResults.push(result);
+    }
+    const allSucceeded = actionResults.every((r) => r.status === 'success');
+    return {
+        id: logId,
+        hookId: hook.id,
+        hookName: hook.name,
+        trigger: payload.trigger,
+        payload,
+        status: allSucceeded ? 'success' : 'failed',
+        depth,
+        actionResults,
+        executedAt: new Date().toISOString(),
+        durationMs: Date.now() - startMs,
+    };
+}
+// ---------------------------------------------------------------------------
+// Registry dispatch
+// ---------------------------------------------------------------------------
+/**
+ * Dispatch an event to all matching enabled hooks.
+ * Fire-and-forget — errors in hooks are captured in the log, never thrown.
+ * Returns execution logs for all fired hooks.
+ *
+ * @param hooks - List of all hooks for the project
+ * @param payload - Event payload to dispatch
+ * @param depth - Current recursion depth (starts at 0)
+ */
+export function dispatchEvent(hooks, payload, depth = 0) {
+    if (depth >= MAX_DEPTH) {
+        console.warn(`[Planu Hooks] Recursion guard triggered at depth ${depth} for trigger '${payload.trigger}'. Stopping.`);
+        return [];
+    }
+    const matchingHooks = hooks.filter((hook) => hook.enabled && hook.trigger === payload.trigger && matchesFilter(hook, payload));
+    const logs = [];
+    for (const hook of matchingHooks) {
+        try {
+            const log = executeHook(hook, payload, depth);
+            logs.push(log);
+        }
+        catch (err) {
+            const errorMessage = err instanceof Error ? err.message : String(err);
+            console.error(`[Planu Hooks] Unexpected error in hook '${hook.id}': ${errorMessage}`);
+        }
+    }
+    return logs;
+}
+/**
+ * Simulate hook execution without side effects (dry run).
+ * Returns which hooks would fire and what actions they would execute.
+ */
+export function dryRunDispatch(hooks, payload) {
+    return hooks.map((hook) => {
+        if (!hook.enabled) {
+            return { hook, wouldFire: false, reason: 'Hook is disabled' };
+        }
+        if (hook.trigger !== payload.trigger) {
+            return {
+                hook,
+                wouldFire: false,
+                reason: `Trigger mismatch: hook='${hook.trigger}', event='${payload.trigger}'`,
+            };
+        }
+        if (!matchesFilter(hook, payload)) {
+            return { hook, wouldFire: false, reason: 'Filter conditions not met' };
+        }
+        return { hook, wouldFire: true };
+    });
+}
+//# sourceMappingURL=core.js.map

package/dist/engine/hooks/core.js.map

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

package/dist/engine/hooks/git-hook-generator.d.ts

@@ -0,0 +1,14 @@
+import type { GitHookScript, GitHookType, GenerateGitHooksInput } from '../../types/index.js';
+/**
+ * Generate a shell script for the given git hook type.
+ */
+export declare function generateGitHookScript(hookType: GitHookType, projectId: string, projectPath: string): GitHookScript;
+/**
+ * Generate git hook scripts for all requested hook types.
+ */
+export declare function generateGitHooks(input: GenerateGitHooksInput): GitHookScript[];
+/**
+ * Format the generated scripts as a human-readable installation guide.
+ */
+export declare function formatGitHookInstallGuide(scripts: GitHookScript[]): string;
+//# sourceMappingURL=git-hook-generator.d.ts.map

package/dist/engine/hooks/git-hook-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-hook-generator.d.ts","sourceRoot":"","sources":["../../../src/engine/hooks/git-hook-generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AA+E9F;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,WAAW,EACrB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,aAAa,CAiBf;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,aAAa,EAAE,CAI9E;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,MAAM,CAkB1E"}

package/dist/engine/hooks/git-hook-generator.js

@@ -0,0 +1,119 @@
+// engine/hooks/git-hook-generator.ts — Generates shell scripts for git hooks (SPEC-071)
+// Git hooks are generated as shell scripts — Planu does NOT execute them directly.
+// ---------------------------------------------------------------------------
+// Script templates
+// ---------------------------------------------------------------------------
+function buildPreCommitScript(projectId) {
+    return `#!/usr/bin/env sh
+# Planu pre-commit hook — auto-generated by manage_hooks
+# Project: ${projectId}
+# Do not edit manually — re-run manage_hooks install_template to regenerate.
+
+set -e
+
+echo "[Planu] Running pre-commit checks..."
+
+# Dispatch on_commit event to Planu (fire-and-forget — does not block commit)
+# Requires planu CLI to be installed: npm install -g planu (or equivalent)
+if command -v planu >/dev/null 2>&1; then
+  COMMIT_HASH="$(git rev-parse --short HEAD 2>/dev/null || echo 'unknown')"
+  BRANCH="$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo 'unknown')"
+  COMMIT_MSG="$(git log -1 --pretty=%B 2>/dev/null | head -1 || echo '')"
+  planu dispatch on_commit \\
+    --project-id "${projectId}" \\
+    --commit-hash "\${COMMIT_HASH}" \\
+    --branch "\${BRANCH}" \\
+    --message "\${COMMIT_MSG}" \\
+    2>/dev/null || true
+fi
+
+echo "[Planu] Pre-commit checks complete."
+`;
+}
+function buildPostCommitScript(projectId) {
+    return `#!/usr/bin/env sh
+# Planu post-commit hook — auto-generated by manage_hooks
+# Project: ${projectId}
+# Do not edit manually — re-run manage_hooks install_template to regenerate.
+
+echo "[Planu] Post-commit: recording commit event..."
+
+if command -v planu >/dev/null 2>&1; then
+  COMMIT_HASH="$(git rev-parse --short HEAD 2>/dev/null || echo 'unknown')"
+  BRANCH="$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo 'unknown')"
+  COMMIT_MSG="$(git log -1 --pretty=%B 2>/dev/null | head -1 || echo '')"
+  planu dispatch on_commit \\
+    --project-id "${projectId}" \\
+    --commit-hash "\${COMMIT_HASH}" \\
+    --branch "\${BRANCH}" \\
+    --message "\${COMMIT_MSG}" \\
+    2>/dev/null || true
+fi
+`;
+}
+function buildPrePushScript(projectId) {
+    return `#!/usr/bin/env sh
+# Planu pre-push hook — auto-generated by manage_hooks
+# Project: ${projectId}
+# Do not edit manually — re-run manage_hooks install_template to regenerate.
+
+set -e
+
+echo "[Planu] Running pre-push drift check..."
+
+if command -v planu >/dev/null 2>&1; then
+  # Run drift detection for all active specs
+  planu detect-drift --project-id "${projectId}" --mode quick 2>/dev/null || true
+fi
+
+echo "[Planu] Pre-push checks complete."
+`;
+}
+// ---------------------------------------------------------------------------
+// Generator functions
+// ---------------------------------------------------------------------------
+/**
+ * Generate a shell script for the given git hook type.
+ */
+export function generateGitHookScript(hookType, projectId, projectPath) {
+    const installPath = `${projectPath}/.git/hooks/${hookType}`;
+    let content;
+    switch (hookType) {
+        case 'pre-commit':
+            content = buildPreCommitScript(projectId);
+            break;
+        case 'post-commit':
+            content = buildPostCommitScript(projectId);
+            break;
+        case 'pre-push':
+            content = buildPrePushScript(projectId);
+            break;
+    }
+    return { hookType, content, installPath };
+}
+/**
+ * Generate git hook scripts for all requested hook types.
+ */
+export function generateGitHooks(input) {
+    return input.hookTypes.map((hookType) => generateGitHookScript(hookType, input.projectId, input.projectPath));
+}
+/**
+ * Format the generated scripts as a human-readable installation guide.
+ */
+export function formatGitHookInstallGuide(scripts) {
+    const lines = ['Git hook scripts generated. To install:', '', '```bash'];
+    for (const script of scripts) {
+        lines.push(`# Install ${script.hookType} hook`);
+        lines.push(`cat > ${script.installPath} << 'PLANU_HOOK'`);
+        lines.push(script.content.trim());
+        lines.push('PLANU_HOOK');
+        lines.push(`chmod +x ${script.installPath}`);
+        lines.push('');
+    }
+    lines.push('```');
+    lines.push('');
+    lines.push('Note: These hooks dispatch events to Planu. They are fire-and-forget');
+    lines.push('and will not block git operations if Planu is unavailable.');
+    return lines.join('\n');
+}
+//# sourceMappingURL=git-hook-generator.js.map

package/dist/engine/hooks/git-hook-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-hook-generator.js","sourceRoot":"","sources":["../../../src/engine/hooks/git-hook-generator.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,mFAAmF;AAInF,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,SAAS,oBAAoB,CAAC,SAAiB;IAC7C,OAAO;;aAEI,SAAS;;;;;;;;;;;;;;oBAcF,SAAS;;;;;;;;CAQ5B,CAAC;AACF,CAAC;AAED,SAAS,qBAAqB,CAAC,SAAiB;IAC9C,OAAO;;aAEI,SAAS;;;;;;;;;;oBAUF,SAAS;;;;;;CAM5B,CAAC;AACF,CAAC;AAED,SAAS,kBAAkB,CAAC,SAAiB;IAC3C,OAAO;;aAEI,SAAS;;;;;;;;;qCASe,SAAS;;;;CAI7C,CAAC;AACF,CAAC;AAED,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAqB,EACrB,SAAiB,EACjB,WAAmB;IAEnB,MAAM,WAAW,GAAG,GAAG,WAAW,eAAe,QAAQ,EAAE,CAAC;IAC5D,IAAI,OAAe,CAAC;IAEpB,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,YAAY;YACf,OAAO,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;YAC1C,MAAM;QACR,KAAK,aAAa;YAChB,OAAO,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;YAC3C,MAAM;QACR,KAAK,UAAU;YACb,OAAO,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;YACxC,MAAM;IACV,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAA4B;IAC3D,OAAO,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CACtC,qBAAqB,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,WAAW,CAAC,CACpE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAwB;IAChE,MAAM,KAAK,GAAa,CAAC,yCAAyC,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;IAEnF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,QAAQ,OAAO,CAAC,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,WAAW,kBAAkB,CAAC,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAC;IACnF,KAAK,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;IAEzE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/engine/hooks/index.d.ts

@@ -0,0 +1,5 @@
+export { dispatchEvent, executeHook, dryRunDispatch } from './core.js';
+export { buildSpecCreatedPayload, buildStatusChangePayload, buildDriftDetectedPayload, buildCommitPayload, matchesFilter, matchesGlob, } from './triggers.js';
+export { generateGitHookScript, generateGitHooks, formatGitHookInstallGuide, } from './git-hook-generator.js';
+export { listTemplateNames, getTemplate, getAllTemplates } from './templates.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/hooks/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,EAClB,aAAa,EACb,WAAW,GACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/engine/hooks/index.js

@@ -0,0 +1,6 @@
+// engine/hooks/index.ts — Barrel export for hooks engine (SPEC-071)
+export { dispatchEvent, executeHook, dryRunDispatch } from './core.js';
+export { buildSpecCreatedPayload, buildStatusChangePayload, buildDriftDetectedPayload, buildCommitPayload, matchesFilter, matchesGlob, } from './triggers.js';
+export { generateGitHookScript, generateGitHooks, formatGitHookInstallGuide, } from './git-hook-generator.js';
+export { listTemplateNames, getTemplate, getAllTemplates } from './templates.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/hooks/index.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,EAClB,aAAa,EACb,WAAW,GACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/engine/hooks/templates.d.ts

@@ -0,0 +1,14 @@
+import type { HookTemplate } from '../../types/index.js';
+/**
+ * Return all available template names.
+ */
+export declare function listTemplateNames(): string[];
+/**
+ * Return a template by name, or undefined if not found.
+ */
+export declare function getTemplate(name: string): HookTemplate | undefined;
+/**
+ * Return all templates.
+ */
+export declare function getAllTemplates(): HookTemplate[];
+//# sourceMappingURL=templates.d.ts.map

package/dist/engine/hooks/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/engine/hooks/templates.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AA+HzD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAE5C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAElE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,EAAE,CAEhD"}