specweave 0.10.1 → 0.12.0

package/dist/src/core/types/config.d.ts

@@ -0,0 +1,90 @@
+/**
+ * SpecWeave Configuration Types
+ *
+ * Type definitions for .specweave/config.json configuration file.
+ */
+import { SupportedLanguage, TranslationConfig } from '../i18n/types.js';
+import { PluginConfig } from './plugin.js';
+import { IncrementType } from './increment-metadata.js';
+/**
+ * WIP Limits Configuration (v0.7.0+ Simplified)
+ *
+ * Philosophy: Default to 1 active increment (maximum focus)
+ * Allow 2 only for emergencies (hotfix interrupt)
+ * Never >2 (hard cap enforced)
+ */
+export interface LimitsConfig {
+    /** Maximum active increments at any time (default: 1 for focus) */
+    maxActiveIncrements?: number;
+    /** Absolute maximum active increments, never exceeded (default: 2) */
+    hardCap?: number;
+    /** Allow 2nd active increment for hotfix/bug emergencies (default: true) */
+    allowEmergencyInterrupt?: boolean;
+    /** Increment type-specific behaviors */
+    typeBehaviors?: {
+        /** Types that can interrupt existing work (emergency scenarios) */
+        canInterrupt?: (IncrementType | string)[];
+        /** Auto-abandon increments after N days of inactivity */
+        autoAbandonDays?: {
+            /** Days before experiment auto-abandons (default: 14) */
+            experiment?: number;
+        };
+    };
+    /** Staleness warning thresholds */
+    staleness?: {
+        /** Warn if paused for more than N days */
+        paused?: number;
+        /** Warn if active for more than N days */
+        active?: number;
+    };
+}
+/**
+ * Project metadata
+ */
+export interface ProjectMetadata {
+    /** Project name */
+    name?: string;
+    /** Project version (semver) */
+    version?: string;
+    /** Project description */
+    description?: string;
+    /** Technology stack */
+    techStack?: string[];
+    /** Team name */
+    team?: string;
+}
+/**
+ * Adapter configuration
+ */
+export interface AdapterConfig {
+    /** Default adapter to use (claude, cursor, generic) */
+    default?: 'claude' | 'cursor' | 'generic';
+    /** Additional adapter settings */
+    [key: string]: any;
+}
+/**
+ * Complete SpecWeave Configuration
+ *
+ * Represents the structure of .specweave/config.json
+ */
+export interface SpecweaveConfig {
+    /** Plugin configuration */
+    plugins?: PluginConfig;
+    /** Project metadata */
+    project?: ProjectMetadata;
+    /** Adapter configuration */
+    adapters?: AdapterConfig;
+    /** Primary language for generated content and CLI */
+    language?: SupportedLanguage;
+    /** Translation settings for multilingual support */
+    translation?: TranslationConfig;
+    /** WIP limits configuration */
+    limits?: LimitsConfig;
+    /** Allow additional properties */
+    [key: string]: any;
+}
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_CONFIG: Partial<SpecweaveConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/src/core/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/core/types/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,4EAA4E;IAC5E,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC,wCAAwC;IACxC,aAAa,CAAC,EAAE;QACd,mEAAmE;QACnE,YAAY,CAAC,EAAE,CAAC,aAAa,GAAG,MAAM,CAAC,EAAE,CAAC;QAE1C,yDAAyD;QACzD,eAAe,CAAC,EAAE;YAChB,yDAAyD;YACzD,UAAU,CAAC,EAAE,MAAM,CAAC;SACrB,CAAC;KACH,CAAC;IAEF,mCAAmC;IACnC,SAAS,CAAC,EAAE;QACV,0CAA0C;QAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;QAEhB,0CAA0C;QAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mBAAmB;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB,gBAAgB;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,OAAO,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAE1C,kCAAkC;IAClC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,2BAA2B;IAC3B,OAAO,CAAC,EAAE,YAAY,CAAC;IAEvB,uBAAuB;IACvB,OAAO,CAAC,EAAE,eAAe,CAAC;IAE1B,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,aAAa,CAAC;IAEzB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAE7B,oDAAoD;IACpD,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAEhC,+BAA+B;IAC/B,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB,kCAAkC;IAClC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,OAAO,CAAC,eAAe,CA0BnD,CAAC"}

package/dist/src/core/types/config.js

@@ -0,0 +1,37 @@
+/**
+ * SpecWeave Configuration Types
+ *
+ * Type definitions for .specweave/config.json configuration file.
+ */
+import { IncrementType } from './increment-metadata.js';
+/**
+ * Default configuration values
+ */
+export const DEFAULT_CONFIG = {
+    language: 'en',
+    translation: {
+        languages: ['en'],
+        primary: 'en',
+        method: 'auto',
+        preserveFrameworkTerms: true,
+    },
+    adapters: {
+        default: 'claude',
+    },
+    limits: {
+        maxActiveIncrements: 1, // v0.7.0+: 1 active increment (maximum focus)
+        hardCap: 2, // Emergency ceiling (never >2)
+        allowEmergencyInterrupt: true, // Allow hotfix/bug to interrupt
+        typeBehaviors: {
+            canInterrupt: [IncrementType.HOTFIX, IncrementType.BUG], // Only emergencies can interrupt
+            autoAbandonDays: {
+                experiment: 14, // Auto-abandon stale experiments
+            },
+        },
+        staleness: {
+            paused: 7, // Warn if paused >7 days
+            active: 30, // Warn if active >30 days
+        },
+    },
+};
+//# sourceMappingURL=config.js.map

package/dist/src/core/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../src/core/types/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAoGxD;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAA6B;IACtD,QAAQ,EAAE,IAAI;IACd,WAAW,EAAE;QACX,SAAS,EAAE,CAAC,IAAI,CAAC;QACjB,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,MAAM;QACd,sBAAsB,EAAE,IAAI;KAC7B;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,QAAQ;KAClB;IACD,MAAM,EAAE;QACN,mBAAmB,EAAE,CAAC,EAAS,8CAA8C;QAC7E,OAAO,EAAE,CAAC,EAAqB,+BAA+B;QAC9D,uBAAuB,EAAE,IAAI,EAAE,gCAAgC;QAC/D,aAAa,EAAE;YACb,YAAY,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,iCAAiC;YAC1F,eAAe,EAAE;gBACf,UAAU,EAAE,EAAE,EAAa,iCAAiC;aAC7D;SACF;QACD,SAAS,EAAE;YACT,MAAM,EAAE,CAAC,EAAoB,yBAAyB;YACtD,MAAM,EAAE,EAAE,EAAmB,0BAA0B;SACxD;KACF;CACF,CAAC"}

package/dist/src/core/types/increment-metadata.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Increment Metadata Types
+ *
+ * Defines the schema for increment metadata tracking (status, type, timestamps).
+ * Part of increment 0007: Smart Status Management
+ */
+/**
+ * Increment status enum
+ * Tracks the lifecycle state of an increment
+ */
+export declare enum IncrementStatus {
+    /** Currently being worked on */
+    ACTIVE = "active",
+    /** Temporarily stopped (blocked by external dependency, deprioritized) */
+    PAUSED = "paused",
+    /** All tasks complete, increment finished */
+    COMPLETED = "completed",
+    /** Work abandoned (requirements changed, obsolete, etc.) */
+    ABANDONED = "abandoned"
+}
+/**
+ * Increment type enum
+ * Determines rules and limits applied to the increment
+ */
+export declare enum IncrementType {
+    /** Critical production fix (bypasses all limits) */
+    HOTFIX = "hotfix",
+    /** Standard feature development (limit: 2 active) */
+    FEATURE = "feature",
+    /** Production bug fix with SRE investigation (unlimited, urgent) */
+    BUG = "bug",
+    /** Change request from stakeholders (limit: 2 active) */
+    CHANGE_REQUEST = "change-request",
+    /** Code improvement (limit: 1 active) */
+    REFACTOR = "refactor",
+    /** POC/spike work (unlimited, auto-abandon after 14 days) */
+    EXPERIMENT = "experiment"
+}
+/**
+ * Increment metadata schema
+ * Stored in .specweave/increments/{id}/metadata.json
+ */
+export interface IncrementMetadata {
+    /** Increment ID (e.g., "0007-smart-increment-discipline") */
+    id: string;
+    /** Current status */
+    status: IncrementStatus;
+    /** Increment type */
+    type: IncrementType;
+    /** Creation timestamp (ISO 8601) */
+    created: string;
+    /** Last activity timestamp (ISO 8601) */
+    lastActivity: string;
+    /** Reason for pausing (only if status = paused) */
+    pausedReason?: string;
+    /** Timestamp when paused (ISO 8601) */
+    pausedAt?: string;
+    /** Reason for abandoning (only if status = abandoned) */
+    abandonedReason?: string;
+    /** Timestamp when abandoned (ISO 8601) */
+    abandonedAt?: string;
+}
+/**
+ * Increment metadata with additional computed fields
+ * Used for rich status displays
+ */
+export interface IncrementMetadataExtended extends IncrementMetadata {
+    /** Progress percentage (0-100) */
+    progress?: number;
+    /** Number of completed tasks */
+    completedTasks?: number;
+    /** Total number of tasks */
+    totalTasks?: number;
+    /** Age in days since creation */
+    ageInDays?: number;
+    /** Days since paused (if paused) */
+    daysPaused?: number;
+}
+/**
+ * Valid status transitions
+ * Enforces increment lifecycle rules
+ */
+export declare const VALID_TRANSITIONS: Record<IncrementStatus, IncrementStatus[]>;
+/**
+ * Type-based limits
+ * Maximum active increments per type
+ *
+ * null = unlimited (no limit enforcement)
+ * User can configure per-project in .specweave/config.json
+ */
+export declare const TYPE_LIMITS: Record<IncrementType, number | null>;
+/**
+ * Staleness thresholds (days)
+ * When to warn about stale increments
+ */
+export declare const STALENESS_THRESHOLDS: {
+    /** Warn if paused for more than this many days */
+    PAUSED: number;
+    /** Warn if active for more than this many days */
+    ACTIVE: number;
+    /** Auto-abandon experiments after this many days */
+    EXPERIMENT: number;
+};
+/**
+ * Default metadata for new increments
+ */
+export declare function createDefaultMetadata(id: string, type?: IncrementType): IncrementMetadata;
+/**
+ * Check if status transition is valid
+ */
+export declare function isValidTransition(from: IncrementStatus, to: IncrementStatus): boolean;
+/**
+ * Check if increment is stale (paused too long or active too long)
+ */
+export declare function isStale(metadata: IncrementMetadata): boolean;
+/**
+ * Check if increment should be auto-abandoned (experiments only)
+ */
+export declare function shouldAutoAbandon(metadata: IncrementMetadata): boolean;
+//# sourceMappingURL=increment-metadata.d.ts.map

package/dist/src/core/types/increment-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"increment-metadata.d.ts","sourceRoot":"","sources":["../../../../src/core/types/increment-metadata.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,oBAAY,eAAe;IACzB,gCAAgC;IAChC,MAAM,WAAW;IAEjB,0EAA0E;IAC1E,MAAM,WAAW;IAEjB,6CAA6C;IAC7C,SAAS,cAAc;IAEvB,4DAA4D;IAC5D,SAAS,cAAc;CACxB;AAED;;;GAGG;AACH,oBAAY,aAAa;IACvB,oDAAoD;IACpD,MAAM,WAAW;IAEjB,qDAAqD;IACrD,OAAO,YAAY;IAEnB,oEAAoE;IACpE,GAAG,QAAQ;IAEX,yDAAyD;IACzD,cAAc,mBAAmB;IAEjC,yCAAyC;IACzC,QAAQ,aAAa;IAErB,6DAA6D;IAC7D,UAAU,eAAe;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,EAAE,EAAE,MAAM,CAAC;IAEX,qBAAqB;IACrB,MAAM,EAAE,eAAe,CAAC;IAExB,qBAAqB;IACrB,IAAI,EAAE,aAAa,CAAC;IAEpB,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAEhB,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IAErB,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,yDAAyD;IACzD,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB;IAClE,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,gCAAgC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,eAAe,EAAE,eAAe,EAAE,CAgBxE,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAO5D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB;IAC/B,kDAAkD;;IAGlD,kDAAkD;;IAGlD,oDAAoD;;CAErD,CAAC;AAEF;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,aAAqC,GAAG,iBAAiB,CAUhH;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE,EAAE,eAAe,GAAG,OAAO,CAGrF;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAgB5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAUtE"}

package/dist/src/core/types/increment-metadata.js

@@ -0,0 +1,138 @@
+/**
+ * Increment Metadata Types
+ *
+ * Defines the schema for increment metadata tracking (status, type, timestamps).
+ * Part of increment 0007: Smart Status Management
+ */
+/**
+ * Increment status enum
+ * Tracks the lifecycle state of an increment
+ */
+export var IncrementStatus;
+(function (IncrementStatus) {
+    /** Currently being worked on */
+    IncrementStatus["ACTIVE"] = "active";
+    /** Temporarily stopped (blocked by external dependency, deprioritized) */
+    IncrementStatus["PAUSED"] = "paused";
+    /** All tasks complete, increment finished */
+    IncrementStatus["COMPLETED"] = "completed";
+    /** Work abandoned (requirements changed, obsolete, etc.) */
+    IncrementStatus["ABANDONED"] = "abandoned";
+})(IncrementStatus || (IncrementStatus = {}));
+/**
+ * Increment type enum
+ * Determines rules and limits applied to the increment
+ */
+export var IncrementType;
+(function (IncrementType) {
+    /** Critical production fix (bypasses all limits) */
+    IncrementType["HOTFIX"] = "hotfix";
+    /** Standard feature development (limit: 2 active) */
+    IncrementType["FEATURE"] = "feature";
+    /** Production bug fix with SRE investigation (unlimited, urgent) */
+    IncrementType["BUG"] = "bug";
+    /** Change request from stakeholders (limit: 2 active) */
+    IncrementType["CHANGE_REQUEST"] = "change-request";
+    /** Code improvement (limit: 1 active) */
+    IncrementType["REFACTOR"] = "refactor";
+    /** POC/spike work (unlimited, auto-abandon after 14 days) */
+    IncrementType["EXPERIMENT"] = "experiment";
+})(IncrementType || (IncrementType = {}));
+/**
+ * Valid status transitions
+ * Enforces increment lifecycle rules
+ */
+export const VALID_TRANSITIONS = {
+    [IncrementStatus.ACTIVE]: [
+        IncrementStatus.PAUSED,
+        IncrementStatus.COMPLETED,
+        IncrementStatus.ABANDONED
+    ],
+    [IncrementStatus.PAUSED]: [
+        IncrementStatus.ACTIVE,
+        IncrementStatus.ABANDONED
+    ],
+    [IncrementStatus.COMPLETED]: [
+    // Completed is terminal (cannot transition out)
+    ],
+    [IncrementStatus.ABANDONED]: [
+        IncrementStatus.ACTIVE // Can un-abandon if needed (rare)
+    ]
+};
+/**
+ * Type-based limits
+ * Maximum active increments per type
+ *
+ * null = unlimited (no limit enforcement)
+ * User can configure per-project in .specweave/config.json
+ */
+export const TYPE_LIMITS = {
+    [IncrementType.HOTFIX]: null, // Unlimited (emergency work)
+    [IncrementType.FEATURE]: 2, // Max 2 active (context switching cost)
+    [IncrementType.BUG]: null, // Unlimited (production issues)
+    [IncrementType.CHANGE_REQUEST]: 2, // Max 2 active (stakeholder-driven)
+    [IncrementType.REFACTOR]: 1, // Max 1 active (needs focus)
+    [IncrementType.EXPERIMENT]: null // Unlimited (exploratory work)
+};
+/**
+ * Staleness thresholds (days)
+ * When to warn about stale increments
+ */
+export const STALENESS_THRESHOLDS = {
+    /** Warn if paused for more than this many days */
+    PAUSED: 7,
+    /** Warn if active for more than this many days */
+    ACTIVE: 30,
+    /** Auto-abandon experiments after this many days */
+    EXPERIMENT: 14
+};
+/**
+ * Default metadata for new increments
+ */
+export function createDefaultMetadata(id, type = IncrementType.FEATURE) {
+    const now = new Date().toISOString();
+    return {
+        id,
+        status: IncrementStatus.ACTIVE,
+        type,
+        created: now,
+        lastActivity: now
+    };
+}
+/**
+ * Check if status transition is valid
+ */
+export function isValidTransition(from, to) {
+    const allowedTransitions = VALID_TRANSITIONS[from];
+    return allowedTransitions.includes(to);
+}
+/**
+ * Check if increment is stale (paused too long or active too long)
+ */
+export function isStale(metadata) {
+    const now = new Date();
+    if (metadata.status === IncrementStatus.PAUSED && metadata.pausedAt) {
+        const pausedDate = new Date(metadata.pausedAt);
+        const daysPaused = (now.getTime() - pausedDate.getTime()) / (1000 * 60 * 60 * 24);
+        return daysPaused > STALENESS_THRESHOLDS.PAUSED;
+    }
+    if (metadata.status === IncrementStatus.ACTIVE) {
+        const createdDate = new Date(metadata.created);
+        const daysActive = (now.getTime() - createdDate.getTime()) / (1000 * 60 * 60 * 24);
+        return daysActive > STALENESS_THRESHOLDS.ACTIVE;
+    }
+    return false;
+}
+/**
+ * Check if increment should be auto-abandoned (experiments only)
+ */
+export function shouldAutoAbandon(metadata) {
+    if (metadata.type !== IncrementType.EXPERIMENT) {
+        return false;
+    }
+    const now = new Date();
+    const lastActivityDate = new Date(metadata.lastActivity);
+    const daysSinceActivity = (now.getTime() - lastActivityDate.getTime()) / (1000 * 60 * 60 * 24);
+    return daysSinceActivity > STALENESS_THRESHOLDS.EXPERIMENT;
+}
+//# sourceMappingURL=increment-metadata.js.map

package/dist/src/core/types/increment-metadata.js.map

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

package/dist/src/core/types/plugin.d.ts

@@ -0,0 +1,283 @@
+/**
+ * Plugin System Type Definitions
+ *
+ * Defines interfaces and types for Claude Code's native plugin architecture.
+ * Follows Claude's official plugin.json schema (Anthropic standards).
+ *
+ * @module core/types/plugin
+ * @version 0.6.1
+ * @see https://docs.claude.com/en/docs/claude-code/plugins
+ */
+/**
+ * Claude Plugin Manifest - Official plugin.json format
+ *
+ * Loaded from .claude-plugin/plugin.json in each plugin directory.
+ * Follows Claude's official schema (NOT SpecWeave custom format).
+ *
+ * @see https://github.com/anthropics/claude-code/blob/main/.claude-plugin/marketplace.json
+ */
+export interface PluginManifest {
+    /** Plugin name (e.g., "specweave-github") */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** Semantic version (e.g., "1.0.0") */
+    version: string;
+    /** Plugin author (required by Claude) */
+    author: {
+        /** Author name */
+        name: string;
+        /** Author email (optional) */
+        email?: string;
+        /** Author URL (optional) */
+        url?: string;
+    };
+    /** Plugin homepage (optional) */
+    homepage?: string;
+    /** Repository info (optional) */
+    repository?: {
+        /** Repository type (e.g., "git") */
+        type: string;
+        /** Repository URL */
+        url: string;
+    };
+    /** Keywords for discoverability (optional) */
+    keywords?: string[];
+    /** Plugin dependencies (SpecWeave format - object with plugins array) */
+    dependencies?: {
+        /** List of required plugin names */
+        plugins?: string[];
+    };
+    /** License information (SpecWeave extension) */
+    license?: string;
+    /** Required SpecWeave core version (SpecWeave extension) */
+    specweave_core_version?: string;
+    /** Components provided by plugin (SpecWeave extension) - arrays of component names */
+    provides?: {
+        /** List of skill names */
+        skills?: string[];
+        /** List of agent names */
+        agents?: string[];
+        /** List of command names */
+        commands?: string[];
+        /** List of hook names */
+        hooks?: string[];
+    };
+    /** Nested plugins or plugin list (SpecWeave extension) */
+    plugins?: string[];
+    /** Auto-detection rules (SpecWeave extension) */
+    auto_detect?: {
+        /** File patterns to detect (e.g., ".git/config") */
+        files?: string[];
+        /** Package.json dependencies to check */
+        packages?: string[];
+        /** Environment variables to check (was env_vars) */
+        env?: string[];
+        /** Legacy name for env */
+        env_vars?: string[];
+        /** Git remotes to check (e.g., "github.com") */
+        git_remotes?: string[];
+        /** Legacy name for git_remotes */
+        git_remote_pattern?: string;
+    };
+    /** Plugin triggers (SpecWeave extension) */
+    triggers?: string[];
+    /** Credits and acknowledgments (SpecWeave extension) */
+    credits?: {
+        /** Original author (was original_author) */
+        author?: string;
+        /** Legacy name for author */
+        original_author?: string;
+        /** Contributors */
+        contributors?: string[];
+        /** Inspiration or based on (was based_on) */
+        inspiration?: string;
+        /** Legacy name for inspiration */
+        based_on?: string;
+    };
+}
+/**
+ * Skill - Auto-activating capability
+ */
+export interface Skill {
+    /** Skill name (unique within plugin) */
+    name: string;
+    /** Path to SKILL.md file */
+    path: string;
+    /** Description from SKILL.md frontmatter */
+    description: string;
+    /** Test cases for this skill */
+    testCases?: TestCase[];
+}
+/**
+ * Agent - Specialized role with isolated context
+ */
+export interface Agent {
+    /** Agent name (unique within plugin) */
+    name: string;
+    /** Path to AGENT.md file */
+    path: string;
+    /** System prompt from AGENT.md */
+    systemPrompt: string;
+    /** Agent capabilities */
+    capabilities: string[];
+}
+/**
+ * Command - Slash command (e.g., /specweave.github.sync)
+ */
+export interface Command {
+    /** Command name (e.g., "github-sync") */
+    name: string;
+    /** Path to command.md file */
+    path: string;
+    /** Description of what the command does */
+    description: string;
+    /** Command prompt/template */
+    prompt: string;
+}
+/**
+ * Test Case - YAML-based test case for skills
+ */
+export interface TestCase {
+    /** Test case ID (e.g., "TC-001") */
+    id: string;
+    /** Test description */
+    description: string;
+    /** Input for the skill */
+    input: string;
+    /** Expected output pattern */
+    expected: string;
+    /** Path to test case file */
+    path: string;
+}
+/**
+ * Plugin - Complete plugin with all components loaded
+ */
+export interface Plugin {
+    /** Plugin manifest (metadata) */
+    manifest: PluginManifest;
+    /** Absolute path to plugin directory */
+    path: string;
+    /** Skills provided by this plugin */
+    skills: Skill[];
+    /** Agents provided by this plugin */
+    agents: Agent[];
+    /** Commands provided by this plugin */
+    commands: Command[];
+}
+/**
+ * Plugin Info - Lightweight plugin metadata (for listing)
+ */
+export interface PluginInfo {
+    /** Plugin name */
+    name: string;
+    /** Plugin version */
+    version: string;
+    /** Description */
+    description: string;
+    /** Path to plugin directory */
+    path: string;
+    /** Is this plugin currently enabled? */
+    enabled: boolean;
+    /** Skill count */
+    skillCount: number;
+    /** Agent count */
+    agentCount: number;
+    /** Command count */
+    commandCount: number;
+}
+/**
+ * Validation Result - Result of manifest validation
+ */
+export interface ValidationResult {
+    /** Is the manifest valid? */
+    valid: boolean;
+    /** Validation errors (if any) */
+    errors: string[];
+    /** Warnings (non-fatal issues) */
+    warnings: string[];
+}
+/**
+ * Detection Result - Result of plugin auto-detection
+ */
+export interface DetectionResult {
+    /** Detected plugin name */
+    pluginName: string;
+    /** Detection confidence (0-1) */
+    confidence: number;
+    /** Reason for detection */
+    reason: string;
+    /** What triggered detection (file, package, env var, etc.) */
+    trigger: string;
+}
+/**
+ * Plugin Config - User's plugin configuration
+ *
+ * Stored in .specweave/config.yaml
+ */
+export interface PluginConfig {
+    /** List of enabled plugin names */
+    enabled: string[];
+    /** Plugin-specific settings */
+    settings?: {
+        [pluginName: string]: Record<string, any>;
+    };
+}
+/**
+ * Plugin Load Options - Options for loading a plugin
+ */
+export interface PluginLoadOptions {
+    /** Force reload even if already loaded */
+    force?: boolean;
+    /** Skip dependency checking */
+    skipDependencies?: boolean;
+    /** Validate plugin integrity */
+    validate?: boolean;
+}
+/**
+ * Plugin Unload Options - Options for unloading a plugin
+ */
+export interface PluginUnloadOptions {
+    /** Remove plugin files (vs. just marking as disabled) */
+    remove?: boolean;
+    /** Force unload even if other plugins depend on it */
+    force?: boolean;
+}
+/**
+ * Plugin Dependency - Dependency information
+ */
+export interface PluginDependency {
+    /** Plugin name */
+    name: string;
+    /** Version requirement (e.g., ">=1.0.0") */
+    version?: string;
+    /** Is this dependency optional? */
+    optional?: boolean;
+}
+/**
+ * Plugin Error - Custom error for plugin operations
+ */
+export declare class PluginError extends Error {
+    pluginName?: string;
+    code?: string;
+    constructor(message: string, pluginName?: string, code?: string);
+}
+/**
+ * Plugin Manifest Validation Error
+ */
+export declare class ManifestValidationError extends PluginError {
+    constructor(message: string, pluginName?: string);
+}
+/**
+ * Plugin Not Found Error
+ */
+export declare class PluginNotFoundError extends PluginError {
+    constructor(pluginName: string);
+}
+/**
+ * Plugin Dependency Error
+ */
+export declare class PluginDependencyError extends PluginError {
+    constructor(message: string, pluginName?: string);
+}
+//# sourceMappingURL=plugin.d.ts.map