@planu/cli 0.43.1 → 0.44.0

package/dist/types/living-spec.d.ts

@@ -0,0 +1,382 @@
+/** A single @spec annotation extracted from source code. */
+export interface SpecAnnotation {
+    /** Spec ID referenced (e.g., "SPEC-120"). */
+    specId: string;
+    /** Acceptance criteria numbers (e.g., [1, 3, 5] from "AC-1,AC-3,AC-5"). */
+    criteria: number[];
+    /** Optional description after the dash. */
+    description: string;
+    /** File where the annotation was found. */
+    file: string;
+    /** Line number (1-based). */
+    line: number;
+    /** Raw annotation text as written in the source. */
+    raw: string;
+}
+/** Result of parsing all @spec annotations from a set of files. */
+export interface AnnotationParseResult {
+    annotations: SpecAnnotation[];
+    fileCount: number;
+    annotatedFileCount: number;
+}
+/** Result of validating annotations against stored specs. */
+export interface AnnotationValidationResult {
+    valid: AnnotationValidationEntry[];
+    invalid: AnnotationValidationEntry[];
+    totalAnnotations: number;
+    validCount: number;
+    invalidCount: number;
+}
+/** A single annotation validation entry. */
+export interface AnnotationValidationEntry {
+    annotation: SpecAnnotation;
+    reason: string;
+}
+/** Suggestion for annotating a file that lacks annotations. */
+export interface AnnotationSuggestion {
+    file: string;
+    suggestedAnnotation: string;
+    reason: string;
+    confidence: 'high' | 'medium' | 'low';
+}
+/** SHA-256 hash snapshot of a file. */
+export interface FileHashEntry {
+    file: string;
+    hash: string;
+    /** Size in bytes. */
+    size: number;
+    /** ISO timestamp of last snapshot. */
+    snapshotAt: string;
+}
+/** Exported function signature tracked for drift detection. */
+export interface FunctionSignature {
+    name: string;
+    params: string;
+    returnType: string;
+    file: string;
+    line: number;
+}
+/** A complete hash snapshot for a spec, including file hashes and function signatures. */
+export interface SpecHashSnapshot {
+    specId: string;
+    createdAt: string;
+    files: FileHashEntry[];
+    signatures: FunctionSignature[];
+}
+/** Change classification for function signatures. */
+export type SignatureChangeType = 'added' | 'modified' | 'removed';
+/** A single signature change between two snapshots. */
+export interface SignatureChange {
+    name: string;
+    file: string;
+    changeType: SignatureChangeType;
+    /** Previous signature string (empty for 'added'). */
+    before: string;
+    /** Current signature string (empty for 'removed'). */
+    after: string;
+}
+/** File hash diff between two snapshots. */
+export interface FileHashDiff {
+    file: string;
+    /** Previous hash (empty for new files). */
+    previousHash: string;
+    /** Current hash (empty for deleted files). */
+    currentHash: string;
+    /** Criteria linked to this file via annotations. */
+    linkedCriteria: number[];
+}
+/** Report of hash and signature changes for a spec. */
+export interface HashDiffReport {
+    specId: string;
+    changedFiles: FileHashDiff[];
+    signatureChanges: SignatureChange[];
+    unchangedFileCount: number;
+    comparedAt: string;
+}
+/** Extended criterion status that includes annotation-based statuses. */
+export type AnnotatedCriterionStatus = 'met' | 'pending' | 'drift' | 'regression' | 'untracked';
+/** Extended drift report fields for annotation-based mode. */
+export interface AnnotationDriftInfo {
+    annotationCoverage: number;
+    annotatedCriteria: number;
+    totalCriteria: number;
+    regressions: string[];
+    untrackedCriteria: string[];
+}
+/** Entry in the auto-reconciliation log. */
+export interface ReconcileLogEntry {
+    timestamp: string;
+    changeType: 'completion-update' | 'status-flip' | 'hash-update' | 'timestamp-update';
+    specId: string;
+    description: string;
+    previousValue: string;
+    newValue: string;
+}
+/** Classification of reconciliation changes. */
+export type ReconcileChangeClass = 'safe' | 'unsafe';
+/** Input for the validate_annotations tool. */
+export interface ValidateAnnotationsInput {
+    projectId: string;
+    projectPath: string;
+    specId?: string;
+}
+/** Input for the generate_annotations tool. */
+export interface GenerateAnnotationsInput {
+    projectId: string;
+    projectPath: string;
+    specId: string;
+}
+/** Input for the snapshot_spec_hashes tool. */
+export interface SnapshotSpecHashesInput {
+    projectId: string;
+    specId: string;
+}
+/** Input for the auto_reconcile tool. */
+export interface AutoReconcileInput {
+    projectId: string;
+    specId?: string;
+    changedFiles?: string[];
+}
+/** Result of auto-reconciliation. */
+export interface AutoReconcileResult {
+    specId: string;
+    appliedChanges: ReconcileLogEntry[];
+    skippedUnsafe: string[];
+    rateLimited: boolean;
+    reconciledAt: string;
+}
+/** Options for creating a drift watcher. */
+export interface DriftWatcherOptions {
+    /** TTL in seconds for cached drift entries. Default 60. */
+    ttlSeconds?: number;
+    /** Glob patterns to exclude from watching. */
+    excludePatterns?: string[];
+    /** Project ID to watch. */
+    projectId: string;
+}
+/** In-memory state of the drift watcher. */
+export interface DriftWatcherState {
+    /** Whether the watcher is currently running. */
+    running: boolean;
+    /** ISO timestamp when the watcher was started. */
+    startedAt: string | null;
+    /** Number of cached entries. */
+    cacheSize: number;
+    /** Project ID being watched. */
+    projectId: string;
+}
+/** A single cached drift entry. */
+export interface DriftCacheEntry {
+    /** Spec ID this entry is for. */
+    specId: string;
+    /** Cached drift report data. */
+    data: HashDiffReport;
+    /** ISO timestamp when the entry was cached. */
+    cachedAt: string;
+    /** ISO timestamp when the entry expires. */
+    expiresAt: string;
+}
+/** Drift watcher instance interface. */
+export interface DriftWatcherInstance {
+    start: () => void;
+    stop: () => void;
+    status: () => DriftWatcherState;
+    invalidate: (specId?: string) => void;
+    getCachedDrift: (specId: string) => DriftCacheEntry | null;
+    setCachedDrift: (specId: string, data: HashDiffReport) => void;
+}
+/** Minimal spec shape needed for dashboard collection. */
+export interface DashboardSpecInput {
+    id: string;
+    status: string;
+    completion: number;
+}
+/** A single spec entry for the living dashboard. */
+export interface DashboardSpecEntry {
+    specId: string;
+    status: string;
+    completion: number;
+    driftDetected: boolean;
+    changedFileCount: number;
+    signatureChangeCount: number;
+    lastCheckedAt: string;
+}
+/** Summary statistics for the dashboard. */
+export interface DashboardSummary {
+    totalSpecs: number;
+    specsWithDrift: number;
+    averageCompletion: number;
+    healthScore: number;
+    generatedAt: string;
+}
+/** A single trend data point. */
+export interface DashboardTrendPoint {
+    timestamp: string;
+    specsWithDrift: number;
+    averageCompletion: number;
+    healthScore: number;
+}
+/** A row in the spec diff table. */
+export interface SpecDiffRow {
+    specId: string;
+    file: string;
+    previousHash: string;
+    currentHash: string;
+    status: 'added' | 'modified' | 'removed';
+}
+/** Status of a criterion's test coverage. */
+export type CriterionCoverageStatus = 'verified' | 'regression' | 'untested';
+/** Coverage information for a group of annotations. */
+export interface AnnotationCoverageGroup {
+    specId: string;
+    criterion: number;
+    status: CriterionCoverageStatus;
+    testCount: number;
+    passCount: number;
+    failCount: number;
+    files: string[];
+}
+/** Full test coverage report correlated with specs (living-spec). */
+export interface LivingSpecCoverageReport {
+    projectId: string;
+    groups: AnnotationCoverageGroup[];
+    totalTests: number;
+    passedTests: number;
+    failedTests: number;
+    coveragePercentage: number;
+    generatedAt: string;
+}
+/** Minimal shape of a Vitest JSON test result. */
+export interface VitestTestResult {
+    name: string;
+    status: 'passed' | 'failed' | 'skipped' | 'pending';
+    duration?: number;
+}
+/** Minimal shape of a Vitest JSON test file. */
+export interface VitestFileResult {
+    filepath: string;
+    tests: VitestTestResult[];
+}
+/** Minimal shape of the full Vitest JSON report. */
+export interface VitestJsonReport {
+    testResults: VitestFileResult[];
+}
+/** A single test case from JUnit XML. */
+export interface JUnitTestCase {
+    name: string;
+    classname: string;
+    file: string;
+    passed: boolean;
+}
+/** A normalized test result for grouping. */
+export interface NormalizedTestResult {
+    name: string;
+    file: string;
+    passed: boolean;
+}
+/** Direction of synchronization. */
+export type SyncDirection = 'spec-to-code' | 'code-to-spec';
+/** Criterion info for TODO generation. */
+export interface CriterionInfo {
+    specId: string;
+    criterion: number;
+    description: string;
+    status: string;
+}
+/** A TODO comment to be generated in code. */
+export interface TodoComment {
+    file: string;
+    line: number;
+    text: string;
+    specId: string;
+    criterion: number;
+}
+/** A progress update to apply to a spec. */
+export interface ProgressUpdate {
+    specId: string;
+    criterion: number;
+    previousStatus: string;
+    newStatus: string;
+    reason: string;
+}
+/** A conflict detected during sync. */
+export interface SyncConflict {
+    id: string;
+    specId: string;
+    criterion: number;
+    direction: SyncDirection;
+    description: string;
+    codeState: string;
+    specState: string;
+    detectedAt: string;
+    resolved: boolean;
+    resolution?: string;
+}
+/** An entry in the sync log. */
+export interface SyncLogEntry {
+    timestamp: string;
+    direction: SyncDirection;
+    specId: string;
+    action: string;
+    details: string;
+}
+/** Result of a sync operation. */
+export interface SyncResult {
+    direction: SyncDirection;
+    specId: string;
+    todosGenerated: TodoComment[];
+    progressUpdates: ProgressUpdate[];
+    conflicts: SyncConflict[];
+    logEntries: SyncLogEntry[];
+    syncedAt: string;
+}
+/** Input for the living_spec_watch tool. */
+export interface LivingSpecWatchInput {
+    projectId: string;
+    action: 'start' | 'stop' | 'status';
+    ttlSeconds?: number;
+    excludePatterns?: string[];
+}
+/** Input for the living_spec_status tool. */
+export interface LivingSpecStatusInput {
+    projectId: string;
+    specId?: string;
+}
+/** Input for the spec_diff tool. */
+export interface SpecDiffInput {
+    projectId: string;
+    specId?: string;
+}
+/** Input for the living_spec_coverage tool. */
+export interface LivingSpecCoverageInput {
+    projectId: string;
+    coverageJsonPath?: string;
+    junitXmlPath?: string;
+}
+/** Input for the sync_spec_to_code tool. */
+export interface SyncSpecToCodeInput {
+    projectId: string;
+    specId: string;
+    projectPath: string;
+}
+/** Input for the sync_code_to_spec tool. */
+export interface SyncCodeToSpecInput {
+    projectId: string;
+    specId: string;
+    projectPath: string;
+}
+/** Input for the resolve_sync_conflict tool. */
+export interface ResolveSyncConflictInput {
+    projectId: string;
+    conflictId: string;
+    resolution: 'accept-code' | 'accept-spec' | 'manual';
+    manualResolution?: string;
+}
+/** Dashboard data persisted to disk. */
+export interface LivingDashboardData {
+    entries: DashboardSpecEntry[];
+    summary: DashboardSummary;
+    trends: DashboardTrendPoint[];
+    updatedAt: string;
+}
+//# sourceMappingURL=living-spec.d.ts.map

package/dist/types/living-spec.d.ts.map

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

package/dist/types/living-spec.js

@@ -0,0 +1,3 @@
+// Planu — Living Spec types: annotations, hashing, signatures, reconciliation
+export {};
+//# sourceMappingURL=living-spec.js.map

package/dist/types/living-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"living-spec.js","sourceRoot":"","sources":["../../src/types/living-spec.ts"],"names":[],"mappings":"AAAA,8EAA8E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@planu/cli",
-  "version": "0.43.1",
+  "version": "0.44.0",
   "description": "Planu — MCP Server for Spec Driven Development. Manages specs, estimations, reverse engineering, and auto-learning across any language/framework.",
   "type": "module",
   "main": "dist/index.js",

package/src/config/hook-defaults.json

@@ -0,0 +1,19 @@
+{
+  "enabled": true,
+  "debounceMs": 300,
+  "rateLimitPerFileMs": 5000,
+  "hooks": {
+    "on-save": {
+      "enabled": true,
+      "include": ["src/**/*.ts"],
+      "exclude": ["**/*.test.ts"]
+    },
+    "on-create": {
+      "enabled": true,
+      "include": ["src/**/*.ts"]
+    },
+    "on-delete": {
+      "enabled": true
+    }
+  }
+}

package/src/config/license-plans.json

@@ -96,6 +96,10 @@
     "estimate_ai_cost",
     "generate_ci",
     "manage_hooks",
+    "start_hooks",
+    "stop_hooks",
+    "hook_status",
+    "configure_hooks",
     "apply_template",
     "check_spec_accuracy",
     "update_registry",
@@ -125,7 +129,18 @@
     "audit_claude_config",
     "generate_docs_site",
     "export_spec",
-    "analyze_spec_dependencies"
+    "analyze_spec_dependencies",
+    "validate_annotations",
+    "generate_annotations",
+    "snapshot_spec_hashes",
+    "auto_reconcile",
+    "living_spec_watch",
+    "living_spec_status",
+    "spec_diff",
+    "living_spec_coverage",
+    "sync_spec_to_code",
+    "sync_code_to_spec",
+    "resolve_sync_conflict"
   ],
   "alwaysAllowed": [
     "activate_license",

package/src/config/tool-groups.json

@@ -45,7 +45,18 @@
         "reality_check",
         "check_spec_accuracy",
         "paradigm_report",
-        "spec_coverage"
+        "spec_coverage",
+        "validate_annotations",
+        "generate_annotations",
+        "snapshot_spec_hashes",
+        "auto_reconcile",
+        "living_spec_watch",
+        "living_spec_status",
+        "spec_diff",
+        "living_spec_coverage",
+        "sync_spec_to_code",
+        "sync_code_to_spec",
+        "resolve_sync_conflict"
       ],
       "defaultEnabled": false,
       "locked": false,