@planu/cli 5.6.0 → 5.7.0

package/dist/types/spec/inputs.d.ts

@@ -109,6 +109,8 @@ export interface UpdateStatusInput {
      * When true, the transition proceeds and qualityWarnings[] is written to spec.md frontmatter.
      */
     forceApprove?: boolean;
+    /** Marker set by reconcile_spec's declared-drift route; accepts the declared reason as reconciliation evidence in place of validation-report.json. */
+    declaredDriftKind?: 'architectural-premise';
 }
 /**
  * SPEC-769: Output from the readiness gate check in update_status(approved).
@@ -159,12 +161,19 @@ export interface GenerateChecklistInput {
     focus?: ChecklistCategory[];
     experienceLevel?: 'beginner' | 'expert';
 }
+/** An orchestrator-declared drift that produces no auto-detectable file/scope change. */
+export interface DeclaredSpecDrift {
+    kind: 'architectural-premise';
+    /** Why the implementation drifted from the approved premise. Minimum 100 characters. */
+    reason: string;
+}
 export interface ReconcileSpecInput {
     specId: string;
     projectId: string;
     autoDetect?: boolean;
     livingSpec?: boolean;
     changes?: ReconcileChange[];
+    declaredDrift?: DeclaredSpecDrift;
 }
 export interface ClarifyRequirementsInput {
     projectId: string;

package/dist/types/telemetry.d.ts

@@ -4,11 +4,47 @@ export interface GeoData {
     city: string;
     timezone: string;
 }
+/** SPEC-1704: the six allowlisted schemaVersion-1 envelope event names. */
+export type TelemetryEnvelopeEventName = 'installation_activated' | 'mcp_server_started' | 'mcp_tool_completed' | 'mcp_tool_failed' | 'spec_lifecycle_transitioned' | 'release_check_completed';
 export type TelemetryEventName = 'init_project' | 'create_spec' | 'tool_used' | 'tool_error' | 'tool_blocked'
 /** SPEC-705: Emitted when agent parallelism is downgraded due to host RAM constraints. */
  | 'ram_guardrail_downgrade'
 /** SPEC-727: Emitted when a panel is aborted because two specialists share the same (modelId, promptHash). */
- | 'panel_heterogeneity_violation';
+ | 'panel_heterogeneity_violation' | TelemetryEnvelopeEventName;
+export type TelemetryEnvelopeResult = 'success' | 'error' | 'blocked' | 'cancelled';
+export type TelemetryDurationBucket = 'lt_100ms' | '100ms_1s' | '1s_5s' | 'gte_5s';
+export type TelemetryOperatingSystem = 'darwin' | 'linux' | 'win32' | 'other';
+export type TelemetryMcpHost = 'claude-code' | 'claude-desktop' | 'cursor' | 'codex' | 'other' | 'unknown';
+/** SPEC-1704: the exact, closed shape of a schemaVersion-1 telemetry event. */
+export interface TelemetryEnvelopeV1 {
+    schemaVersion: 1;
+    eventId: string;
+    eventName: TelemetryEnvelopeEventName;
+    occurredAt: string;
+    anonymousInstallationId: string;
+    sessionId: string;
+    planuVersion: string;
+    toolName?: string;
+    result?: TelemetryEnvelopeResult;
+    durationBucket?: TelemetryDurationBucket;
+    operatingSystem: TelemetryOperatingSystem;
+    nodeMajor: number;
+    mcpHost: TelemetryMcpHost;
+}
+/** Caller-supplied fields for buildTelemetryEnvelope; unknown keys are rejected. */
+export interface TelemetryEnvelopeInput {
+    anonymousInstallationId: string;
+    sessionId: string;
+    toolName?: string;
+    result?: TelemetryEnvelopeResult;
+    durationMs?: number;
+    mcpHost?: TelemetryMcpHost;
+}
+/** Injectable determinism for tests and the `planu telemetry show` command. */
+export interface TelemetryEnvelopeBuildOptions {
+    uuid?: () => string;
+    clock?: () => Date;
+}
 export interface TelemetryConfig {
     enabled: boolean;
     /** ISO timestamp of when the user was first shown the opt-in prompt */
@@ -17,6 +53,8 @@ export interface TelemetryConfig {
     consentVersion?: number;
     /** SPEC-572: Opt-in to cross-project Observatory aggregated insights (requires telemetry enabled) */
     enableObservatory?: boolean;
+    /** SPEC-1704: generated on enable, deleted on disable, regenerated fresh on the next enable. */
+    anonymousInstallationId?: string;
 }
 export interface TelemetryEvent {
     event: TelemetryEventName;

package/dist/types/validation-evidence.d.ts

@@ -83,12 +83,18 @@ export interface PerScenarioResult {
     evidence: string[];
     unverifiable?: true;
 }
+export interface DoneDriftMissingFileFinding {
+    kind: 'done-drift-missing-files';
+    specId: string;
+    missingPath: string;
+}
 export interface SpecComplianceResult {
     dimensionScore: number;
     perScenario: PerScenarioResult[];
     command: string;
     evidenceSource?: 'frontmatter' | 'criteria' | 'none';
     ignoredCriteriaTitles?: string[];
+    doneDriftFindings?: DoneDriftMissingFileFinding[];
 }
 export interface EvidenceTestLink {
     path: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@planu/cli",
-  "version": "5.6.0",
+  "version": "5.7.0",
   "description": "Planu — MCP Server for Spec Driven Development. Cross-platform (Linux/macOS/Windows, x64/arm64).",
   "type": "module",
   "main": "dist/index.js",

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": "5.6.0",
+  "version": "5.7.0",
   "icon": "assets/plugin/icon.svg",
   "command": ["npx", "@planu/cli@latest"],
   "packageName": "@planu/cli",