synapsexcoder 6.0.0

package/dist/integration/types.d.ts

@@ -0,0 +1,218 @@
+/**
+ * Integration Types — Shared type definitions for all 13 external integrations
+ */
+export interface IntegrationManifest {
+    /** Short unique key (e.g. "dcp", "pty", "skillful") */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Source repository URL */
+    sourceUrl: string;
+    /** Version of the external feature being integrated */
+    externalVersion: string;
+    /** Brief description */
+    description: string;
+    /** Category grouping */
+    category: IntegrationCategory;
+    /** Features this integration provides */
+    features: string[];
+    /** Whether this integration is enabled by default */
+    enabledByDefault: boolean;
+}
+export type IntegrationCategory = "context-optimization" | "agent-orchestration" | "background-execution" | "memory-persistence" | "command-enhancement" | "skill-management" | "web-scraping" | "terminal-management" | "workflow-automation" | "formatting" | "shell-intelligence" | "pattern-control";
+export interface IntegrationCapabilities {
+    /** Tools this integration registers */
+    tools: string[];
+    /** Commands this integration registers */
+    commands: string[];
+    /** Agents this integration registers */
+    agents: string[];
+    /** Hooks this integration taps into */
+    hooks: IntegrationHook[];
+    /** Context providers */
+    contextKeys: string[];
+}
+export type IntegrationHook = "experimental.chat.system.transform" | "experimental.text.complete" | "experimental.chat.tool.before" | "experimental.chat.tool.after" | "onSessionStart" | "onSessionEnd" | "onMessage" | "onContextCompaction" | "onToolInvoke" | "onCommand";
+export interface IntegrationConfig {
+    dcp?: DcpConfig;
+    ohMyOpencode?: OhMyOpencodeConfig;
+    pty?: PtyConfig;
+    skillful?: SkillfulConfig;
+    supermemory?: SupermemoryConfig;
+    subtask2?: Subtask2Config;
+    backgroundAgents?: BackgroundAgentsConfig;
+    workspace?: WorkspaceConfig;
+    firecrawl?: FirecrawlConfig;
+    agentic?: AgenticConfig;
+    openAgentsControl?: OpenAgentsControlConfig;
+}
+export interface DcpConfig {
+    enabled?: boolean;
+    compressionMode?: "range" | "message";
+    deduplication?: boolean;
+    supersedeWrites?: boolean;
+    purgeErrors?: boolean;
+    maxErrorTurns?: number;
+    protectedTools?: string[];
+    protectedFilePatterns?: string[];
+}
+export interface OhMyOpencodeConfig {
+    enabled?: boolean;
+    backgroundAgents?: boolean;
+    lspTools?: boolean;
+    astTools?: boolean;
+    defaultModel?: string;
+}
+export interface PtyConfig {
+    enabled?: boolean;
+    maxBufferLines?: number;
+    webHostname?: string;
+    webPort?: number;
+}
+export interface SkillfulConfig {
+    enabled?: boolean;
+    debug?: boolean;
+    basePaths?: string[];
+    promptRenderer?: "xml" | "json" | "md";
+    modelRenderers?: Record<string, string>;
+}
+export interface SupermemoryConfig {
+    enabled?: boolean;
+    apiKey?: string;
+    similarityThreshold?: number;
+    maxMemories?: number;
+    maxProjectMemories?: number;
+    injectProfile?: boolean;
+    compactThreshold?: number;
+    keywordPatterns?: string[];
+}
+export interface Subtask2Config {
+    enabled?: boolean;
+    replaceGeneric?: boolean;
+    genericReturn?: string;
+}
+export interface BackgroundAgentsConfig {
+    enabled?: boolean;
+    timeoutMinutes?: number;
+    maxConcurrent?: number;
+}
+export interface WorkspaceConfig {
+    enabled?: boolean;
+    orchestrators?: string[];
+    specialists?: string[];
+}
+export interface FirecrawlConfig {
+    enabled?: boolean;
+    apiKey?: string;
+    outputDir?: string;
+}
+export interface AgenticConfig {
+    enabled?: boolean;
+    pullOnStart?: boolean;
+}
+export interface OpenAgentsControlConfig {
+    enabled?: boolean;
+    approvalGates?: boolean;
+    mviEnabled?: boolean;
+}
+export interface CompressionResult {
+    originalTokens: number;
+    compressedTokens: number;
+    compressionRatio: number;
+    summary: string;
+    compressedRanges: Array<{
+        start: number;
+        end: number;
+    }>;
+}
+export interface DcpStrategyResult {
+    strategy: string;
+    tokensSaved: number;
+    details: string;
+}
+export interface PtySession {
+    id: string;
+    title: string;
+    command: string;
+    status: "running" | "exited" | "killed";
+    pid: number;
+    exitCode?: number;
+    lineCount: number;
+    createdAt: number;
+}
+export interface PtyWriteRequest {
+    sessionId: string;
+    data: string;
+}
+export interface DelegationTask {
+    id: string;
+    prompt: string;
+    agent: string;
+    status: "registered" | "running" | "completed" | "failed" | "timed-out";
+    result?: string;
+    resultPath?: string;
+    title?: string;
+    summary?: string;
+    error?: string;
+    createdAt: number;
+    completedAt?: number;
+}
+export interface Memory {
+    id: string;
+    content: string;
+    type: MemoryType;
+    scope: "user" | "project";
+    similarity?: number;
+    createdAt: number;
+}
+export type MemoryType = "project-config" | "architecture" | "error-solution" | "preference" | "learned-pattern" | "conversation";
+export interface SkillDefinition {
+    name: string;
+    shortName: string;
+    identifier: string;
+    description: string;
+    path: string;
+    resources: SkillResources;
+}
+export interface SkillResources {
+    references: string[];
+    assets: string[];
+    scripts: string[];
+}
+export interface SubtaskConfig {
+    subtask: boolean;
+    return?: string | string[];
+    loop?: {
+        max?: number;
+        until?: string;
+    };
+    parallel?: string | string[];
+    model?: string;
+    agent?: string;
+}
+export interface AgenticTicket {
+    id: string;
+    title: string;
+    description: string;
+    status: "open" | "researching" | "planned" | "executing" | "done";
+    researchPath?: string;
+    planPath?: string;
+}
+export interface ApprovalRequest {
+    id: string;
+    task: string;
+    changes: Array<{
+        file: string;
+        type: "edit" | "create" | "delete";
+        reason: string;
+    }>;
+    riskLevel: "low" | "medium" | "high";
+    status: "pending" | "approved" | "denied";
+}
+export interface ContextPattern {
+    name: string;
+    content: string;
+    priority: "critical" | "high" | "medium" | "low";
+    category: "code-quality" | "ui-design" | "architecture" | "workflow";
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/integration/types.d.ts.map

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

package/dist/integration/types.js

@@ -0,0 +1,5 @@
+/**
+ * Integration Types — Shared type definitions for all 13 external integrations
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/integration/types.js.map

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

package/dist/integration/workspace-integration.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Workspace Integration — Multi-Agent Orchestration Harness
+ *
+ * Hard-wired adaptation of kdcokenny/opencode-workspace
+ * Source: https://github.com/kdcokenny/opencode-workspace
+ *
+ * Bundles 16 components into a complete AI development harness:
+ * - Orchestrators: plan + build agents
+ * - Specialists: explore, researcher, coder, scribe, reviewer
+ * - Plugin: workspace-plugin (plan mgmt, agent rule injection)
+ * - Skill: plan-protocol, code-review, code-philosophy, frontend-philosophy
+ * - Command: /review
+ * - MCP: context7, exa, gh_grep
+ */
+import type { PluginModule } from "../plugins/plugin-system.js";
+import type { WorkspaceConfig } from "./types.js";
+export declare class WorkspaceHarness {
+    config: WorkspaceConfig;
+    constructor(config?: WorkspaceConfig);
+    /**
+     * Get the workspace agent configuration map.
+     * Each agent includes description, mode, and permissions.
+     */
+    getAgentConfig(): Record<string, unknown>;
+    /**
+     * Get the workspace plan-protocol skill instructions.
+     */
+    getPlanProtocol(): string;
+    /**
+     * Get the workspace code-review skill instructions.
+     */
+    getCodeReviewProtocol(): string;
+    /**
+     * Get workspace code philosophy (5 Laws).
+     */
+    getCodePhilosophy(): string;
+    /**
+     * Get workspace frontend philosophy (5 Pillars).
+     */
+    getFrontendPhilosophy(): string;
+}
+export declare function getWorkspaceHarness(config?: WorkspaceConfig): WorkspaceHarness;
+/** Plugin module adapter */
+export declare const workspacePlugin: PluginModule;
+export default workspacePlugin;
+//# sourceMappingURL=workspace-integration.d.ts.map

package/dist/integration/workspace-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-integration.d.ts","sourceRoot":"","sources":["../../src/integration/workspace-integration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,6BAA6B,CAAC;AAC/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,qBAAa,gBAAgB;IAC3B,MAAM,EAAG,eAAe,CAAC;gBAEb,MAAM,GAAE,eAAoB;IASxC;;;OAGG;IACH,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAmEzC;;OAEG;IACH,eAAe,IAAI,MAAM;IAqBzB;;OAEG;IACH,qBAAqB,IAAI,MAAM;IAqB/B;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAU3B;;OAEG;IACH,qBAAqB,IAAI,MAAM;CAShC;AAKD,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,gBAAgB,CAK9E;AAED,4BAA4B;AAC5B,eAAO,MAAM,eAAe,EAAE,YAS7B,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/integration/workspace-integration.js

@@ -0,0 +1,181 @@
+/**
+ * Workspace Integration — Multi-Agent Orchestration Harness
+ *
+ * Hard-wired adaptation of kdcokenny/opencode-workspace
+ * Source: https://github.com/kdcokenny/opencode-workspace
+ *
+ * Bundles 16 components into a complete AI development harness:
+ * - Orchestrators: plan + build agents
+ * - Specialists: explore, researcher, coder, scribe, reviewer
+ * - Plugin: workspace-plugin (plan mgmt, agent rule injection)
+ * - Skill: plan-protocol, code-review, code-philosophy, frontend-philosophy
+ * - Command: /review
+ * - MCP: context7, exa, gh_grep
+ */
+export class WorkspaceHarness {
+    config;
+    constructor(config = {}) {
+        this.config = {
+            enabled: true,
+            orchestrators: ["plan", "build"],
+            specialists: ["explore", "researcher", "coder", "scribe", "reviewer"],
+            ...config,
+        };
+    }
+    /**
+     * Get the workspace agent configuration map.
+     * Each agent includes description, mode, and permissions.
+     */
+    getAgentConfig() {
+        return {
+            plan: {
+                description: "Read-only orchestrator for analysis and planning. Delegates via task tool.",
+                mode: "primary",
+                permissions: {
+                    edit: "deny",
+                    bash: "ask",
+                    webfetch: "deny",
+                },
+            },
+            build: {
+                description: "Full-access orchestrator for implementation. Delegates via task tool.",
+                mode: "primary",
+                permissions: {
+                    edit: "allow",
+                    bash: "allow",
+                },
+            },
+            explore: {
+                description: "Fast, read-only specialist for codebase exploration and file discovery.",
+                mode: "subagent",
+                permissions: {
+                    edit: "deny",
+                    bash: "deny",
+                },
+            },
+            researcher: {
+                description: "Read-only research specialist. Uses MCP tools (Context7, Exa, GitHub Grep).",
+                mode: "subagent",
+                permissions: {
+                    edit: "deny",
+                    webfetch: "deny",
+                },
+            },
+            coder: {
+                description: "Implementation specialist with full file and bash access.",
+                mode: "subagent",
+                permissions: {
+                    edit: "allow",
+                    bash: "allow",
+                },
+            },
+            scribe: {
+                description: "Documentation specialist. Can write files only, no bash.",
+                mode: "subagent",
+                permissions: {
+                    edit: "allow",
+                    bash: "deny",
+                },
+            },
+            reviewer: {
+                description: "Code review specialist. Read-only with git inspection access.",
+                mode: "subagent",
+                permissions: {
+                    edit: "deny",
+                    bash: "ask",
+                },
+            },
+        };
+    }
+    /**
+     * Get the workspace plan-protocol skill instructions.
+     */
+    getPlanProtocol() {
+        return `## Plan Protocol
+
+Before implementing any feature, follow this protocol:
+
+1. **Understand** — Research the codebase to understand existing patterns
+2. **Design** — Create a detailed implementation plan
+3. **Review** — Self-review the plan for correctness
+4. **Implement** — Execute the plan incrementally
+5. **Validate** — Verify the implementation works
+
+### Plan Structure
+
+- **Objective**: What needs to be achieved
+- **Approach**: How to achieve it
+- **Files**: Which files need to change
+- **Dependencies**: What depends on what
+- **Risks**: Potential issues and mitigations
+`;
+    }
+    /**
+     * Get the workspace code-review skill instructions.
+     */
+    getCodeReviewProtocol() {
+        return `## Code Review Methodology
+
+### Severity Classification
+
+- **CRITICAL** — Security vulnerability, data loss, or crash
+- **HIGH** — Logic error, incorrect behavior
+- **MEDIUM** — Style violation, missing edge case
+- **LOW** — Nitpick, suggestion
+
+### Review Checklist
+
+1. [ ] Security: No injection, auth bypass, or data exposure
+2. [ ] Correctness: Logic handles all edge cases
+3. [ ] Performance: No obvious inefficiencies
+4. [ ] Maintainability: Code is clear and well-structured
+5. [ ] Testing: Changes are testable and tested
+6. [ ] Consistency: Matches project patterns
+`;
+    }
+    /**
+     * Get workspace code philosophy (5 Laws).
+     */
+    getCodePhilosophy() {
+        return `## Code Philosophy — 5 Laws
+
+1. **Law of Simplicity**: The simplest solution that works is the best.
+2. **Law of Clarity**: Code should be readable without comments.
+3. **Law of Composition**: Small, composable pieces beat monolithic blocks.
+4. **Law of Consistency**: Follow existing patterns, don't invent new ones.
+5. **Law of Minimal Surface**: Minimize the API surface area.`;
+    }
+    /**
+     * Get workspace frontend philosophy (5 Pillars).
+     */
+    getFrontendPhilosophy() {
+        return `## Frontend Philosophy — 5 Pillars
+
+1. **Accessibility First**: Every UI element must be keyboard-navigable and screen-reader friendly.
+2. **Progressive Enhancement**: Core functionality works without JavaScript.
+3. **Responsive by Default**: Mobile-first, any screen size.
+4. **Performance Budget**: Keep bundles small, lazy-load everything.
+5. **Design Consistency**: Use the design system, don't create ad-hoc styles.`;
+    }
+}
+/** Global singleton */
+let globalWorkspace = null;
+export function getWorkspaceHarness(config) {
+    if (!globalWorkspace) {
+        globalWorkspace = new WorkspaceHarness(config);
+    }
+    return globalWorkspace;
+}
+/** Plugin module adapter */
+export const workspacePlugin = {
+    activate(context) {
+        const config = (context.config?.workspace || {});
+        getWorkspaceHarness(config);
+        context.logger("[workspace-integration] Workspace harness activated");
+    },
+    deactivate() {
+        globalWorkspace = null;
+    },
+};
+export default workspacePlugin;
+//# sourceMappingURL=workspace-integration.js.map

package/dist/integration/workspace-integration.js.map

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

package/dist/knowledge-vault/deepwiki-sync.d.ts

@@ -0,0 +1,99 @@
+/**
+ * DeepWiki ↔ Knowledge Vault Synchronization Bridge
+ *
+ * Bidirectional sync protocol between the Knowledge Vault (persistent
+ * document store) and DeepWiki (auto-generated documentation wiki).
+ *
+ * ## Data Flow
+ *
+ *   Vault → Wiki : VaultEntry[] → WikiPage[] → wiki markdown files
+ *   Wiki → Vault : WikiPage[] → VaultEntry[] → vault files + manifest rebuild
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * const vault = new KnowledgeVault();
+ * const wiki = new DeepWiki({ rootPath: process.cwd() });
+ * const sync = new DeepWikiSync(vault, wiki);
+ *
+ * // Sync wiki pages into vault
+ * await sync.sync({ direction: "wiki-to-vault", conflictResolution: "newest-wins" });
+ * ```
+ *
+ * @module knowledge-vault/deepwiki-sync
+ */
+import { KnowledgeVault } from "./knowledge-vault.js";
+import { DeepWiki } from "../tools/deepwiki/index.js";
+/** Direction of synchronization */
+export type SyncDirection = "vault-to-wiki" | "wiki-to-vault" | "bidirectional";
+/** Strategy for resolving conflicts when the same ID exists in both stores */
+export type ConflictResolution = "vault-wins" | "wiki-wins" | "skip" | "newest-wins";
+/** Configuration options for a sync operation */
+export interface SyncOptions {
+    /** Which direction(s) to sync */
+    direction: SyncDirection;
+    /** How to resolve conflicts when an entry exists in both stores */
+    conflictResolution: ConflictResolution;
+    /** Only sync entries matching these topics/categories */
+    topicFilter?: string[];
+    /** Only sync entries matching these tags */
+    tagFilter?: string[];
+    /** If true, report what would happen without making changes */
+    dryRun?: boolean;
+    /** Directory to write vault entries as wiki markdown files (default: deepwiki output dir + vault-sync/) */
+    vaultToWikiOutputDir?: string;
+}
+/** Result detail for a single entry */
+export interface SyncDetail {
+    id: string;
+    title: string;
+    action: "added" | "updated" | "skipped" | "error";
+    reason?: string;
+}
+/** Aggregate result of a sync operation */
+export interface SyncResult {
+    success: boolean;
+    direction: SyncDirection;
+    entriesAdded: number;
+    entriesUpdated: number;
+    entriesSkipped: number;
+    errors: string[];
+    timestamp: number;
+    details: SyncDetail[];
+}
+/**
+ * DeepWikiSync — Bidirectional sync between Knowledge Vault and DeepWiki.
+ *
+ * This class does not modify the internal state of either the vault or wiki
+ * instances. For Wiki→Vault direction it writes files to the vault's storage
+ * directory and triggers a manifest rebuild. For Vault→Wiki direction it
+ * writes wiki markdown files to an output directory.
+ */
+export declare class DeepWikiSync {
+    private vault;
+    private wiki;
+    constructor(vault: KnowledgeVault, wiki: DeepWiki);
+    /**
+     * Run a synchronization session.
+     *
+     * @param options - Sync configuration
+     * @returns Aggregate sync result with per-entry details
+     */
+    sync(options: SyncOptions): Promise<SyncResult>;
+    /**
+     * Convert a VaultEntry into a WikiPage and write it as a wiki markdown file.
+     */
+    private syncVaultEntryToWiki;
+    /**
+     * Convert a WikiPage into a VaultEntry and write it to the vault.
+     */
+    private syncWikiPageToVault;
+    private applyVaultFilters;
+    private applyWikiFilters;
+    private incrementCounts;
+}
+/**
+ * Create a DeepWikiSync instance with default vault and wiki.
+ */
+export declare function createDeepWikiSync(vault?: KnowledgeVault, wiki?: DeepWiki): DeepWikiSync;
+//# sourceMappingURL=deepwiki-sync.d.ts.map

package/dist/knowledge-vault/deepwiki-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepwiki-sync.d.ts","sourceRoot":"","sources":["../../src/knowledge-vault/deepwiki-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAKH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAOtD,mCAAmC;AACnC,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG,eAAe,GAAG,eAAe,CAAC;AAEhF,8EAA8E;AAC9E,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,WAAW,GAAG,MAAM,GAAG,aAAa,CAAC;AAErF,iDAAiD;AACjD,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,SAAS,EAAE,aAAa,CAAC;IACzB,mEAAmE;IACnE,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2GAA2G;IAC3G,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,uCAAuC;AACvC,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,2CAA2C;AAC3C,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,aAAa,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAoED;;;;;;;GAOG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,IAAI,CAAW;gBAEX,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ;IASjD;;;;;OAKG;IACG,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAuFrD;;OAEG;YACW,oBAAoB;IA8FlC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA+E3B,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,eAAe;CAOxB;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,CAAC,EAAE,cAAc,EACtB,IAAI,CAAC,EAAE,QAAQ,GACd,YAAY,CAId"}