@planu/cli 3.9.7 → 3.9.9

package/dist/types/vector-store.d.ts

@@ -1,144 +0,0 @@
-/** Type of document stored in the vector store. */
-export type VectorEntryType = 'spec' | 'pattern' | 'knowledge' | 'decision';
-/** A single document with its embedding vector. */
-export interface VectorEntry {
-    id: string;
-    type: VectorEntryType;
-    content: string;
-    embedding: number[];
-    metadata: Record<string, unknown>;
-    createdAt: string;
-    updatedAt: string;
-}
-/** A search result with its similarity score. */
-export interface VectorSearchResult {
-    entry: VectorEntry;
-    similarity: number;
-}
-/** Configuration for the TF-IDF engine. */
-export interface TFIDFConfig {
-    maxDimensions: number;
-    minDocFrequency: number;
-    stopWords: Set<string>;
-}
-/** Configuration for the HNSW index. */
-export interface HNSWConfig {
-    M: number;
-    efConstruction: number;
-    efSearch: number;
-    flatSearchThreshold: number;
-}
-/** Abstract storage backend interface (SQLite or JSON fallback). */
-export interface StorageBackend {
-    insert(entry: VectorEntry): Promise<void>;
-    update(id: string, entry: Partial<VectorEntry>): Promise<void>;
-    delete(id: string): Promise<void>;
-    getById(id: string): Promise<VectorEntry | undefined>;
-    getAll(type?: VectorEntryType): Promise<VectorEntry[]>;
-    searchSimilar(embedding: number[], topK: number, threshold: number, type?: VectorEntryType): Promise<VectorSearchResult[]>;
-    close?(): void;
-}
-/** Result of a JSON-to-SQLite migration. */
-export interface MigrationResult {
-    documentsProcessed: number;
-    durationMs: number;
-    errors: string[];
-}
-/** Scope parameter for semantic_search tool. */
-export type VectorSearchScope = VectorEntryType | 'all';
-/** Input args for semantic_search tool handler. */
-export interface SemanticSearchArgs {
-    projectId: string;
-    query: string;
-    scope?: VectorSearchScope;
-    topK?: number;
-    threshold?: number;
-}
-/** Internal JSON storage shape for vector store data. */
-export interface VectorStoreData {
-    entries: VectorEntry[];
-}
-/** Row shape from the SQLite vectors table. */
-export interface VectorRow {
-    id: string;
-    type: string;
-    content: string;
-    embedding: Buffer;
-    metadata: string;
-    createdAt: string;
-    updatedAt: string;
-}
-/** Dynamic import type for better-sqlite3 database. */
-export interface BetterSqlite3Database {
-    pragma(pragma: string): unknown;
-    prepare(sql: string): BetterSqlite3Statement;
-    exec(sql: string): void;
-    close(): void;
-}
-/** Prepared statement from better-sqlite3. */
-export interface BetterSqlite3Statement {
-    run(...params: unknown[]): {
-        changes: number;
-    };
-    get(...params: unknown[]): unknown;
-    all(...params: unknown[]): unknown[];
-}
-/** Constructor type for better-sqlite3. */
-export type BetterSqlite3Constructor = (filename: string) => BetterSqlite3Database;
-/** Warning emitted when a semantically similar pattern already exists. */
-export interface DedupWarning {
-    existingPatternId: string;
-    existingPattern: string;
-    similarity: number;
-    threshold: number;
-}
-/** Legacy pattern shape for migration. */
-export interface LegacyPattern {
-    pattern: string;
-    category?: string;
-    usageCount?: number;
-    [key: string]: unknown;
-}
-/** Legacy knowledge shape for migration. */
-export interface LegacyKnowledge {
-    key: string;
-    value: string;
-    source?: string;
-    [key: string]: unknown;
-}
-/** Collected text item ready for embedding during migration. */
-export interface MigrationTextItem {
-    type: VectorEntryType;
-    id: string;
-    text: string;
-    meta: Record<string, unknown>;
-}
-/** Legacy decision shape for migration. */
-export interface LegacyDecision {
-    decision: string;
-    rationale?: string;
-    specId?: string;
-    [key: string]: unknown;
-}
-/** Internal node in the HNSW graph. */
-export interface HNSWNode {
-    id: string;
-    vector: number[];
-    layers: Map<string, number>[];
-}
-/** Candidate returned from HNSW search. */
-export interface HNSWSearchCandidate {
-    id: string;
-    similarity: number;
-}
-/** Serialized HNSW state for persistence. */
-export interface HNSWSerializedState {
-    nodes: {
-        id: string;
-        vector: number[];
-        layers: [string, number][][];
-    }[];
-    entryPoint: string | null;
-    maxLayer: number;
-}
-//# sourceMappingURL=vector-store.d.ts.map

package/dist/types/vector-store.js

@@ -1,3 +0,0 @@
-// types/vector-store.ts — Domain types for vector memory (SPEC-075).
-export {};
-//# sourceMappingURL=vector-store.js.map

package/dist/types/velocity.d.ts

@@ -1,168 +0,0 @@
-import type { SpecScope, SpecType } from './common/primitives.js';
-/**
- * A single week's throughput data point.
- * weekLabel: ISO week string, e.g. "2026-W12"
- */
-export interface ThroughputPoint {
-    weekLabel: string;
-    weekStart: string;
-    weekEnd: string;
-    specsCompleted: number;
-    specIds: string[];
-}
-/**
- * Lead time statistics grouped by scope.
- * Lead time = done timestamp - created timestamp (in hours).
- */
-export interface LeadTimeStats {
-    avgHours: number;
-    medianHours: number;
-    minHours: number;
-    maxHours: number;
-    /** Number of specs used to compute these stats */
-    sampleSize: number;
-    /** Breakdown by scope */
-    byScope: Record<SpecScope, LeadTimeScopeStats>;
-}
-export interface LeadTimeScopeStats {
-    avgHours: number;
-    sampleSize: number;
-}
-/**
- * Cycle time statistics.
- * Cycle time = done timestamp - implementing timestamp (in hours).
- */
-export interface CycleTimeStats {
-    avgHours: number;
-    medianHours: number;
-    sampleSize: number;
-}
-/**
- * A single burndown data point for one week.
- */
-export interface BurndownPoint {
-    weekLabel: string;
-    weekStart: string;
-    weekEnd: string;
-    /** Specs completed (done) up to and including this week */
-    completedCumulative: number;
-    /** Specs completed in this specific week */
-    completedThisWeek: number;
-    /** Specs created up to and including this week */
-    createdCumulative: number;
-    /** Backlog: total created - total completed */
-    backlog: number;
-}
-/**
- * Flow efficiency: time spent in active states vs total lead time.
- */
-export interface FlowEfficiencyStats {
-    /** 0.0-1.0 ratio of active time to total time */
-    efficiency: number;
-    /** Average hours spent in active states (implementing, review) */
-    avgActiveHours: number;
-    /** Average total lead time hours */
-    avgTotalHours: number;
-    sampleSize: number;
-}
-/**
- * WIP (Work In Progress) snapshot.
- */
-export interface WipSnapshot {
-    current: number;
-    specIds: string[];
-    avgAgeHours: number;
-}
-/**
- * Full velocity report for a project.
- */
-export interface VelocityReport {
-    projectId: string;
-    projectPath: string;
-    generatedAt: string;
-    /** Number of weeks analyzed */
-    weeks: number;
-    /** Applied filters */
-    filters: VelocityFilters;
-    /** Average specs completed per week */
-    avgThroughputPerWeek: number;
-    throughput: ThroughputPoint[];
-    leadTime: LeadTimeStats | null;
-    cycleTime: CycleTimeStats | null;
-    wip: WipSnapshot;
-    flowEfficiency: FlowEfficiencyStats | null;
-    burndown: BurndownPoint[];
-    /** Human-readable summary line */
-    summary: string;
-    /** Total specs done in the period */
-    totalDone: number;
-    /** Total specs in the project */
-    totalSpecs: number;
-}
-/**
- * Trend comparison: last N weeks vs previous N weeks.
- */
-export interface VelocityTrend {
-    projectId: string;
-    projectPath: string;
-    generatedAt: string;
-    compareWeeks: number;
-    recent: VelocityPeriodStats;
-    previous: VelocityPeriodStats;
-    throughputDelta: number;
-    leadTimeDelta: number | null;
-    trend: 'improving' | 'stable' | 'declining';
-    summary: string;
-}
-export interface VelocityPeriodStats {
-    label: string;
-    fromDate: string;
-    toDate: string;
-    avgThroughputPerWeek: number;
-    avgLeadTimeHours: number | null;
-    totalDone: number;
-}
-/**
- * Input filters for velocity tools.
- */
-export interface VelocityFilters {
-    weeks: number;
-    scope?: SpecScope;
-    type?: SpecType;
-}
-/** Input args for velocity_report tool */
-export interface VelocityReportInput {
-    projectPath: string;
-    weeks?: number;
-    scope?: SpecScope;
-    type?: SpecType;
-}
-/** Input args for velocity_trend tool */
-export interface VelocityTrendInput {
-    projectPath: string;
-    compareWeeks?: number;
-    scope?: SpecScope;
-    type?: SpecType;
-}
-/**
- * Velocity profile derived from recent spec actuals.
- * Used to convert devHours estimates into real calendar days.
- * SPEC-555
- */
-export interface VelocityProfile {
-    /** SPECs completed per calendar day (in the window) */
-    specsPerDay: number;
-    /** Productive dev hours per calendar day */
-    hoursPerDay: number;
-    /** Average actual devHours by difficulty (1-5) */
-    avgHoursByDifficulty: Record<1 | 2 | 3 | 4 | 5, number>;
-    /** ISO date of last calculation */
-    calibrationDate: string;
-    /** Window used to calculate (default 30 days) */
-    windowDays: number;
-    /** Number of done specs used for calibration */
-    sampleSize: number;
-    /** Confidence based on sample size: high >20, medium 5-20, low <5 */
-    confidence: 'high' | 'medium' | 'low';
-}
-//# sourceMappingURL=velocity.d.ts.map

package/dist/types/velocity.js

@@ -1,4 +0,0 @@
-// types/velocity.ts — Velocity metrics domain types (SPEC-288)
-// Lead Time, Throughput, Burndown, Cycle Time, WIP, Flow Efficiency
-export {};
-//# sourceMappingURL=velocity.js.map

package/dist/types/verifiable-criteria.d.ts

@@ -1,50 +0,0 @@
-/** The verification strategy to apply to a single acceptance criterion. */
-export type VerifyType = 'grep_present' | 'grep_absent' | 'metric_max' | 'metric_min' | 'file_exists' | 'command' | 'manual';
-/**
- * A machine-verifiable check block attached to an acceptance criterion.
- * Stored as an HTML comment in spec.md for backward-compatible rendering.
- */
-export interface VerifyBlock {
-    /** Verification strategy. */
-    type: VerifyType;
-    /** Regex pattern for grep_present / grep_absent checks. */
-    pattern?: string;
-    /** Glob pattern scoping the check (e.g. "src/**\/*.tsx"). */
-    scope?: string;
-    /** Glob pattern to exclude from the check. */
-    exclude?: string;
-    /** Expected numeric value — 0 for absent, N for counts or thresholds. */
-    expected?: number;
-    /** Shell command to run for 'command' type verifications. */
-    command?: string;
-    /** Human-readable description of what is being verified. */
-    description: string;
-}
-/**
- * An acceptance criterion enriched with a machine-verifiable check block.
- */
-export interface VerifiableCriterion {
-    /** The original acceptance criterion text (without markdown list prefix). */
-    text: string;
-    /** The machine-verifiable check block. */
-    verify: VerifyBlock;
-}
-/**
- * A template that maps keyword triggers in criterion text to a verification strategy.
- * Used internally by the criterion enricher to auto-classify criteria.
- */
-export interface VerifyTemplate {
-    /** Keywords (any match) that trigger this template. */
-    keywords: string[];
-    /** Verification type this template applies. */
-    type: VerifyType;
-    /** Pattern with optional {placeholder} substitution. */
-    patternTemplate?: string;
-    /** Scope glob with optional {placeholder} substitution. */
-    scopeTemplate?: string;
-    /** Default expected value for metric checks (e.g. line count threshold). */
-    expected?: number;
-    /** Human-readable description for the generated verify block. */
-    description: string;
-}
-//# sourceMappingURL=verifiable-criteria.d.ts.map

package/dist/types/verifiable-criteria.js

@@ -1,3 +0,0 @@
-// types/verifiable-criteria.ts — Types for machine-verifiable acceptance criteria (SPEC-186)
-export {};
-//# sourceMappingURL=verifiable-criteria.js.map

package/dist/types/verify-integrations.d.ts

@@ -1,80 +0,0 @@
-/**
- * Input for verify_integrations tool.
- */
-export interface VerifyIntegrationsInput {
-    /** Absolute path to project root (looks for .planu/integrations.json). */
-    projectPath: string;
-    /** Optional explicit endpoints to verify (overrides config file). */
-    endpoints?: IntegrationEndpoint[];
-    /** Timeout per request in ms (default: 10000). */
-    timeout?: number;
-    /** Fail fast on first failing endpoint (default: false). */
-    failFast?: boolean;
-}
-/**
- * Single endpoint to verify.
- */
-export interface IntegrationEndpoint {
-    /** Human-readable name. */
-    name: string;
-    /** URL to ping. */
-    url: string;
-    /** HTTP method: GET | HEAD | POST (default: HEAD). */
-    method?: 'GET' | 'HEAD' | 'POST';
-    /** Expected status code or range start (default: 200). */
-    expectedStatus?: number;
-    /** Optional Authorization header value. */
-    authorization?: string;
-    /** Optional JSON schema to validate response body against. */
-    responseSchema?: Record<string, unknown>;
-    /** Optional expected Content-Type. */
-    expectedContentType?: string;
-}
-/**
- * Result for a single endpoint check.
- */
-export interface IntegrationCheckResult {
-    /** Endpoint name. */
-    name: string;
-    /** Target URL. */
-    url: string;
-    /** Whether the check passed. */
-    pass: boolean;
-    /** HTTP status code (0 if network error). */
-    statusCode: number;
-    /** Response latency in ms (-1 if error). */
-    latencyMs: number;
-    /** Error details if failed. */
-    error?: string;
-    /** Schema validation result (undefined if no schema configured). */
-    schemaValid?: boolean;
-    /** Schema validation errors if schemaValid === false. */
-    schemaErrors?: string[];
-}
-/**
- * Complete integration verification report.
- */
-export interface IntegrationReport {
-    [key: string]: unknown;
-    /** Overall pass (all endpoints passed). */
-    pass: boolean;
-    /** Total endpoints checked. */
-    totalEndpoints: number;
-    /** Passed count. */
-    passedCount: number;
-    /** Failed count. */
-    failedCount: number;
-    /** Total duration ms. */
-    totalDurationMs: number;
-    /** Per-endpoint results. */
-    results: IntegrationCheckResult[];
-}
-/**
- * Result returned by the verify integrations engine.
- */
-export interface VerifyIntegrationsResult {
-    report: IntegrationReport;
-    /** Human-readable summary (≤200 tokens). */
-    humanSummary: string;
-}
-//# sourceMappingURL=verify-integrations.d.ts.map

package/dist/types/verify-integrations.js

@@ -1,3 +0,0 @@
-// types/verify-integrations.ts — SPEC-965
-export {};
-//# sourceMappingURL=verify-integrations.js.map

package/dist/types/version-resolution.d.ts

@@ -1,23 +0,0 @@
-import type { PackageRegistry } from './stack/index.js';
-export type VersionCachePolicy = 'strict' | 'flexible' | 'offline';
-export type VersionSource = 'cache' | 'registry' | 'fallback';
-export interface VersionResolutionResult {
-    version: string;
-    source: VersionSource;
-    fetchedAt: string;
-    isDeprecated: boolean;
-}
-export interface VersionCacheEntry {
-    version: string;
-    isDeprecated: boolean;
-    fetchedAt: string;
-}
-export interface VersionCacheStore {
-    entries: Record<string, VersionCacheEntry>;
-}
-export interface ResolveFrameworkVersionOptions {
-    packageName: string;
-    registry: PackageRegistry;
-    cachePolicy?: VersionCachePolicy;
-}
-//# sourceMappingURL=version-resolution.d.ts.map

package/dist/types/version-resolution.js

@@ -1,3 +0,0 @@
-// Planu — Version Resolution types (SPEC-321)
-export {};
-//# sourceMappingURL=version-resolution.js.map

package/dist/types/webhook.d.ts

@@ -1,62 +0,0 @@
-export type WebhookEventType = 'subscription_cancelled' | 'subscription_updated' | 'license_key_created' | 'order_created' | 'subscription_created' | 'subscription_paused' | 'subscription_unpaused' | 'subscription_expired' | 'subscription_payment_success' | 'subscription_payment_failed' | 'subscription_payment_recovered';
-export interface LemonSqueezyWebhookAttributes {
-    readonly status?: string;
-    readonly cancelled?: boolean;
-    readonly variant_id?: number;
-    readonly variant_name?: string;
-    readonly product_name?: string;
-    readonly customer_id?: number;
-    readonly user_name?: string;
-    readonly user_email?: string;
-    readonly ends_at?: string | null;
-    readonly renews_at?: string | null;
-    readonly trial_ends_at?: string | null;
-    readonly created_at?: string;
-    readonly updated_at?: string;
-}
-export interface LemonSqueezyWebhookData {
-    readonly id: string;
-    readonly type: string;
-    readonly attributes: LemonSqueezyWebhookAttributes;
-}
-export interface LemonSqueezyWebhookPayload {
-    readonly meta: {
-        readonly event_name: string;
-        readonly custom_data?: Record<string, unknown>;
-        readonly webhook_id?: string;
-    };
-    readonly data: LemonSqueezyWebhookData;
-}
-export interface WebhookEventRecord {
-    readonly id: string;
-    readonly eventType: WebhookEventType;
-    readonly receivedAt: string;
-    readonly processed: boolean;
-    readonly error?: string;
-    readonly summary: string;
-}
-export interface WebhookServerState {
-    readonly running: boolean;
-    readonly port: number;
-    readonly startedAt: string | null;
-    readonly eventsProcessed: number;
-    readonly recentEvents: WebhookEventRecord[];
-}
-export interface WebhookProcessResult {
-    readonly success: boolean;
-    readonly eventType: string;
-    readonly message: string;
-    readonly statusCode: number;
-}
-export type EventHandler = (payload: LemonSqueezyWebhookPayload) => WebhookProcessResult;
-export interface StartWebhookInput {
-    readonly port?: number;
-    readonly secret?: string;
-}
-export interface StopWebhookInput {
-    readonly force?: boolean;
-}
-export interface WebhookStatusInput {
-    readonly includeEvents?: boolean;
-}
-//# sourceMappingURL=webhook.d.ts.map

package/dist/types/webhook.js

@@ -1,4 +0,0 @@
-// types/webhook.ts — Webhook event types for Lemon Squeezy subscription events.
-// Used by the webhook engine (src/engine/webhook/) and tools (src/tools/webhook.ts).
-export {};
-//# sourceMappingURL=webhook.js.map

package/dist/types/well-known.d.ts

@@ -1,70 +0,0 @@
-import type { Spec } from './spec/core.js';
-/** Summary of a single spec included in the .well-known manifest. */
-export interface ManifestSpec {
-    /** Spec ID (e.g. "SPEC-001"). */
-    id: string;
-    /** Human-readable title. */
-    title: string;
-    /** Spec status. */
-    status: string;
-    /** Spec type (feature, bug, chore, etc.). */
-    type: string;
-    /** Short description (up to 200 characters). */
-    description: string;
-    /** Tags associated with the spec. */
-    tags: string[];
-    /** ISO 8601 creation date. */
-    created: string;
-}
-/** .well-known/planu.json manifest format v1. */
-export interface WellKnownManifest {
-    /** Manifest schema version. Always 1 for this format. */
-    version: 1;
-    /** Project display name. */
-    name: string;
-    /** Total number of specs included. */
-    specCount: number;
-    /** Spec summaries (public specs only, unless includePrivate=true). */
-    specs: ManifestSpec[];
-    /** Planu capabilities exported by this project. */
-    capabilities: string[];
-    /** ISO 8601 timestamp when this manifest was generated. */
-    generatedAt: string;
-}
-/** Input for the publish_registry tool handler. */
-export interface PublishRegistryInput {
-    /** Project ID (hash). */
-    projectId: string;
-    /** Absolute path where .well-known/planu.json will be written. */
-    outputPath?: string;
-    /** Whether to include specs with status "private". Default: false. */
-    includePrivate?: boolean;
-}
-/** Input for the discover_registry tool handler. */
-export interface DiscoverRegistryInput {
-    /** Absolute path to a .well-known/planu.json manifest file. */
-    manifestPath: string;
-}
-/** Options for generating a manifest. */
-export interface ManifestGeneratorOptions {
-    /** Project display name. */
-    projectName: string;
-    /** List of all specs for the project. */
-    specs: Spec[];
-    /** Whether to include specs with a private or draft status. */
-    includePrivate: boolean;
-}
-/** A capability identifier that a project can declare in its manifest. */
-export type KnownCapability = 'spec-registry' | 'federation' | 'living-spec' | 'ai-analysis' | 'estimation' | 'changelog';
-/** Result of parsing and validating a manifest. */
-export interface DiscoveryResult {
-    /** Whether the manifest was successfully parsed and validated. */
-    valid: boolean;
-    /** Parsed manifest (present when valid is true). */
-    manifest?: WellKnownManifest;
-    /** Validation errors (present when valid is false). */
-    errors?: string[];
-    /** Source path of the manifest. */
-    source: string;
-}
-//# sourceMappingURL=well-known.d.ts.map

package/dist/types/well-known.js

@@ -1,3 +0,0 @@
-// types/well-known.ts — SPEC-162: .well-known spec-registry discovery domain types
-export {};
-//# sourceMappingURL=well-known.js.map