specweave 0.12.6 → 0.13.0

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

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

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

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

@@ -0,0 +1,49 @@
+/**
+ * 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
+ */
+/**
+ * Plugin Error - Custom error for plugin operations
+ */
+export class PluginError extends Error {
+    constructor(message, pluginName, code) {
+        super(message);
+        this.pluginName = pluginName;
+        this.code = code;
+        this.name = 'PluginError';
+    }
+}
+/**
+ * Plugin Manifest Validation Error
+ */
+export class ManifestValidationError extends PluginError {
+    constructor(message, pluginName) {
+        super(message, pluginName, 'MANIFEST_INVALID');
+        this.name = 'ManifestValidationError';
+    }
+}
+/**
+ * Plugin Not Found Error
+ */
+export class PluginNotFoundError extends PluginError {
+    constructor(pluginName) {
+        super(`Plugin '${pluginName}' not found`, pluginName, 'PLUGIN_NOT_FOUND');
+        this.name = 'PluginNotFoundError';
+    }
+}
+/**
+ * Plugin Dependency Error
+ */
+export class PluginDependencyError extends PluginError {
+    constructor(message, pluginName) {
+        super(message, pluginName, 'DEPENDENCY_ERROR');
+        this.name = 'PluginDependencyError';
+    }
+}
+//# sourceMappingURL=plugin.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../../src/core/types/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAyTH;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,YACE,OAAe,EACR,UAAmB,EACnB,IAAa;QAEpB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,eAAU,GAAV,UAAU,CAAS;QACnB,SAAI,GAAJ,IAAI,CAAS;QAGpB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,uBAAwB,SAAQ,WAAW;IACtD,YAAY,OAAe,EAAE,UAAmB;QAC9C,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,kBAAkB,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAClD,YAAY,UAAkB;QAC5B,KAAK,CAAC,WAAW,UAAU,aAAa,EAAE,UAAU,EAAE,kBAAkB,CAAC,CAAC;QAC1E,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,WAAW;IACpD,YAAY,OAAe,EAAE,UAAmB;QAC9C,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,kBAAkB,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF"}

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

@@ -0,0 +1,229 @@
+/**
+ * Spec Metadata Type Definitions
+ *
+ * Defines the structure for spec.md files in .specweave/docs/internal/specs/
+ *
+ * KEY ARCHITECTURE:
+ * - Specs are PERMANENT (living docs, source of truth)
+ * - Increments are TEMPORARY (implementation vehicles)
+ * - External tools (GitHub/Jira/ADO) sync to SPECS, not increments
+ *
+ * @module spec-metadata
+ */
+/**
+ * External tool link for a spec
+ */
+export interface ExternalToolLink {
+    /** Tool type */
+    provider: 'github' | 'jira' | 'ado';
+    /** External entity ID (GitHub Project ID, Jira Epic Key, ADO Feature ID) */
+    externalId: string;
+    /** External entity URL */
+    url: string;
+    /** Last sync timestamp */
+    syncedAt?: string;
+    /** Sync status */
+    syncStatus?: 'synced' | 'out-of-sync' | 'error';
+    /** Last sync error message (if any) */
+    lastError?: string;
+}
+/**
+ * GitHub-specific external link
+ */
+export interface GitHubLink {
+    /** GitHub Project ID (numeric) */
+    projectId?: number;
+    /** GitHub Project URL */
+    projectUrl?: string;
+    /** Last sync timestamp */
+    syncedAt?: string;
+    /** Repository owner */
+    owner?: string;
+    /** Repository name */
+    repo?: string;
+}
+/**
+ * Jira-specific external link
+ */
+export interface JiraLink {
+    /** Jira Epic Key (e.g., SPEC-1) */
+    epicKey?: string;
+    /** Jira Epic URL */
+    epicUrl?: string;
+    /** Last sync timestamp */
+    syncedAt?: string;
+    /** Jira project key */
+    projectKey?: string;
+    /** Jira domain */
+    domain?: string;
+}
+/**
+ * Azure DevOps-specific external link
+ */
+export interface AdoLink {
+    /** ADO Feature ID (numeric) */
+    featureId?: number;
+    /** ADO Feature URL */
+    featureUrl?: string;
+    /** Last sync timestamp */
+    syncedAt?: string;
+    /** ADO organization */
+    organization?: string;
+    /** ADO project */
+    project?: string;
+}
+/**
+ * Acceptance Criteria
+ */
+export interface AcceptanceCriteria {
+    /** Unique identifier (e.g., AC-US1-01) */
+    id: string;
+    /** Description of the acceptance criteria */
+    description: string;
+    /** Status */
+    status: 'todo' | 'done';
+    /** Priority (P1 = must-have, P2 = should-have, P3 = nice-to-have) */
+    priority?: 'P1' | 'P2' | 'P3';
+    /** Is this testable? */
+    testable?: boolean;
+}
+/**
+ * User Story
+ */
+export interface UserStory {
+    /** Unique identifier (e.g., US-001) */
+    id: string;
+    /** User story title (As a X, I want Y, so that Z) */
+    title: string;
+    /** Detailed description */
+    description?: string;
+    /** Status */
+    status: 'todo' | 'in-progress' | 'done';
+    /** Priority */
+    priority: 'P1' | 'P2' | 'P3';
+    /** Acceptance criteria */
+    acceptanceCriteria: AcceptanceCriteria[];
+    /** Which increment implemented this (if any) */
+    implementedIn?: string[];
+    /** Epic this story belongs to */
+    epic?: string;
+}
+/**
+ * Increment Reference (which increments implemented parts of this spec)
+ */
+export interface IncrementReference {
+    /** Increment ID (e.g., 0001-core-framework) */
+    id: string;
+    /** Increment status */
+    status: 'planned' | 'in-progress' | 'complete' | 'abandoned';
+    /** Completion date */
+    completedAt?: string;
+    /** User stories implemented in this increment */
+    userStories: string[];
+    /** Notes about this increment */
+    notes?: string;
+}
+/**
+ * Spec Metadata (from YAML frontmatter)
+ */
+export interface SpecMetadata {
+    /** Spec ID (e.g., spec-001) */
+    id: string;
+    /** Feature area title */
+    title: string;
+    /** Current status */
+    status: 'draft' | 'in-progress' | 'complete' | 'archived';
+    /** Priority level */
+    priority: 'P0' | 'P1' | 'P2' | 'P3';
+    /** Creation date */
+    created?: string;
+    /** Last updated date */
+    updated?: string;
+    /** External tool links */
+    externalLinks?: {
+        github?: GitHubLink;
+        jira?: JiraLink;
+        ado?: AdoLink;
+    };
+    /** User stories (extracted from markdown content) */
+    userStories?: UserStory[];
+    /** Increments that implemented parts of this spec */
+    increments?: IncrementReference[];
+    /** Total progress (calculated) */
+    progress?: {
+        totalUserStories: number;
+        completedUserStories: number;
+        percentComplete: number;
+    };
+    /** Tags/labels */
+    tags?: string[];
+    /** Related specs */
+    relatedSpecs?: string[];
+}
+/**
+ * Spec Content (full parsed spec file)
+ */
+export interface SpecContent {
+    /** Metadata from YAML frontmatter */
+    metadata: SpecMetadata;
+    /** Markdown content (without frontmatter) */
+    markdown: string;
+    /** File path */
+    filePath: string;
+}
+/**
+ * Sync Conflict
+ */
+export interface SpecSyncConflict {
+    /** Conflict type */
+    type: 'status' | 'user-story' | 'acceptance-criteria' | 'metadata';
+    /** Field that conflicts */
+    field: string;
+    /** Value in spec.md (local) */
+    localValue: any;
+    /** Value in external tool (remote) */
+    remoteValue: any;
+    /** Suggested resolution */
+    resolution: 'local-wins' | 'remote-wins' | 'merge' | 'prompt-user';
+    /** Conflict description */
+    description: string;
+}
+/**
+ * Spec Sync Result
+ */
+export interface SpecSyncResult {
+    /** Success or failure */
+    success: boolean;
+    /** Spec ID that was synced */
+    specId: string;
+    /** Provider that was synced to */
+    provider: 'github' | 'jira' | 'ado';
+    /** External entity ID created/updated */
+    externalId?: string;
+    /** External entity URL */
+    url?: string;
+    /** Conflicts detected (if any) */
+    conflicts?: SpecSyncConflict[];
+    /** Changes applied */
+    changes?: {
+        created: string[];
+        updated: string[];
+        deleted: string[];
+    };
+    /** Error message (if failed) */
+    error?: string;
+}
+/**
+ * Spec Validation Result
+ */
+export interface SpecValidationResult {
+    /** Is spec valid? */
+    valid: boolean;
+    /** Validation errors */
+    errors: string[];
+    /** Validation warnings */
+    warnings: string[];
+    /** Spec ID */
+    specId: string;
+}
+//# sourceMappingURL=spec-metadata.d.ts.map

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

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

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

@@ -0,0 +1,14 @@
+/**
+ * Spec Metadata Type Definitions
+ *
+ * Defines the structure for spec.md files in .specweave/docs/internal/specs/
+ *
+ * KEY ARCHITECTURE:
+ * - Specs are PERMANENT (living docs, source of truth)
+ * - Increments are TEMPORARY (implementation vehicles)
+ * - External tools (GitHub/Jira/ADO) sync to SPECS, not increments
+ *
+ * @module spec-metadata
+ */
+export {};
+//# sourceMappingURL=spec-metadata.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spec-metadata.js","sourceRoot":"","sources":["../../../../src/core/types/spec-metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}