@planu/cli 5.5.3 → 5.7.0

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

@@ -6,4 +6,5 @@ export * from './agent.js';
 export * from './repair.js';
 export * from './health-score.js';
 export * from './versioning.js';
+export * from './index-cache.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/spec/index.js

@@ -8,4 +8,5 @@ export * from './agent.js';
 export * from './repair.js';
 export * from './health-score.js';
 export * from './versioning.js';
+export * from './index-cache.js';
 //# sourceMappingURL=index.js.map

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/spec-format.d.ts

@@ -72,6 +72,7 @@ export interface PlanuCanonicalPathPolicy {
     readonly canonicalSpecFiles: readonly string[];
     readonly canonicalSpecDirs: readonly string[];
     readonly forbiddenHostAssetRootDirs: readonly string[];
+    readonly runtimeHomeDir: string;
     readonly generatedRuntimePatterns: readonly string[];
     readonly legacyMergeBeforeDeleteFiles: readonly 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.5.3",
+  "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.5.3",
+  "version": "5.7.0",
   "icon": "assets/plugin/icon.svg",
   "command": ["npx", "@planu/cli@latest"],
   "packageName": "@planu/cli",

package/scripts/lib/pending-release-file.mjs

@@ -116,15 +116,31 @@ export function isCommitReachable(repoRoot, commit, ontoCommit) {
   throw new Error(`git merge-base --is-ancestor exited with status ${String(result.status)}`);
 }
 
-export async function writePendingReleaseLedger(pendingPath, entries) {
-  const temporaryPath = `${pendingPath}.${process.pid}.${Date.now()}.tmp`;
+async function readJsonObject(path) {
   try {
-    await writeFile(temporaryPath, `${JSON.stringify(entries, null, 2)}\n`, {
+    const parsed = JSON.parse(await readFile(path, 'utf8'));
+    return parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : {};
+  } catch (error) {
+    if (error?.code === 'ENOENT') return {};
+    throw error;
+  }
+}
+
+/**
+ * SPEC-1699: writes `entries` into the `releases` field of the committed
+ * planu/project.json, preserving every other field already on disk.
+ */
+export async function writePendingReleaseLedger(projectJsonPath, entries) {
+  const project = await readJsonObject(projectJsonPath);
+  const nextProject = { ...project, releases: entries };
+  const temporaryPath = `${projectJsonPath}.${process.pid}.${Date.now()}.tmp`;
+  try {
+    await writeFile(temporaryPath, `${JSON.stringify(nextProject, null, 2)}\n`, {
       encoding: 'utf8',
       flag: 'wx',
       mode: 0o644,
     });
-    await rename(temporaryPath, pendingPath);
+    await rename(temporaryPath, projectJsonPath);
   } catch (error) {
     await rm(temporaryPath, { force: true });
     throw error;