@wowok/agent-mcp 2.5.5 → 2.6.1

package/README.md

@@ -27,7 +27,7 @@ Docs: [https://github.com/wowok-ai/docs/](https://github.com/wowok-ai/docs/)
 
 ### 2. Install WoWok Skills (Recommended)
 
-**Skills significantly reduce the learning curve and usage difficulty of the MCP Server.** They provide structured guidance for AI assistants on complex system building, tool usage, and safety protocols.
+**Skills significantly reduce the learning curve and usage difficulty of the MCP Server.** They provide structured guidance for AI assistants on complex system building, tool usage, and safety protocols. See the [WoWok Skills repository](https://github.com/wowok-ai/skills) for full details.
 
 ```bash
 # Personal (global) — available in all sessions:
@@ -37,10 +37,12 @@ npm install -g @wowok/skills
 cd your-project
 wowok-skills init          # Claude Code (default)
 wowok-skills init --target agents    # Trae IDE
-wowok-skills init --target all       # All 6 supported clients
+wowok-skills init --target all       # All 10 supported clients
 ```
 
-**Supported clients:** Claude Code, OpenAI Codex, Trae IDE, CodeBuddy, Cursor, GitHub Copilot.
+**Supported clients:** Claude Code, OpenAI Codex, ChatGPT Desktop (Codex Mode), Trae IDE, CodeBuddy, Cursor, Windsurf, Qoder, Roo Code, GitHub Copilot.
+
+> **Note:** The skills package auto-installs and configures the `@wowok/agent-mcp` MCP server. Set `WOWOK_SKILLS_NO_MCP=1` to skip MCP management.
 
 #### Available Skills
 

package/dist/config/runtime.js

@@ -1,6 +1,6 @@
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
 import { dirname, join } from "path";
-import { homedir } from "os";
+import { getWowMcpDir } from "@wowok/wowok";
 export const SERVICE_REGISTRY = [
     {
         name: "confirm_gate",
@@ -70,10 +70,7 @@ const SERVICE_MAP = new Map(SERVICE_REGISTRY.map((s) => [s.name, s]));
 const runtimeOverrides = new Map();
 let harnessTierOverride;
 function configFilePath() {
-    const dir = process.env.WOWOK_CONFIG_DIR
-        ? process.env.WOWOK_CONFIG_DIR
-        : join(homedir(), ".wowok");
-    return join(dir, "runtime-config.json");
+    return join(getWowMcpDir(), "runtime-config.json");
 }
 function isPersistEnabled() {
     const v = process.env.WOWOK_RUNTIME_CONFIG_PERSIST;
@@ -220,7 +217,7 @@ function buildReminder(service, enabled) {
                 : "Harness is OFF. GLM5 recommends keeping it ON (lightweight tier) for safety. To enable, call config_operation toggle harness.";
         case "graph_persist":
             return enabled
-                ? "Graph persistence is ON: the object dependency graph will be saved to ~/.wowok/project-graph.json."
+                ? "Graph persistence is ON: the object dependency graph will be saved to ~/.wow/mcp/project-graph.json."
                 : "Graph persistence is OFF: the dependency graph exists only in memory and will be lost on process restart. To persist, call config_operation toggle graph_persist.";
         case "semantic_rich":
             return undefined;

package/dist/extensions/capability-manifest.d.ts

@@ -0,0 +1,125 @@
+import type { ProjectObjectType } from "../project/namespace.js";
+export type CapabilityModule = "puzzle" | "risk" | "translation" | "templates" | "confirm" | "context" | "ledger" | "schema" | "handler";
+export type CapabilityCategory = "data_model" | "validation" | "lifecycle" | "fund_flow" | "trust" | "workflow" | "communication" | "evidence" | "query";
+export type IndustryAgnostic = "high" | "medium" | "low";
+export interface CapabilityRiskProfile {
+    funds_risk: "high" | "medium" | "low";
+    trust_risk: "high" | "medium" | "low";
+    delivery_risk: "high" | "medium" | "low";
+    compliance_risk: "high" | "medium" | "low";
+    known_risks: string[];
+}
+export interface CapabilityBenefitProfile {
+    automation_level: "high" | "medium" | "low";
+    trust_boost: "high" | "medium" | "low";
+    efficiency_gain: "high" | "medium" | "low";
+    benefits: string[];
+}
+export interface CapabilityConstraints {
+    must_pair_with?: string[];
+    conflicts_with?: string[];
+    max_single_transaction?: number;
+    requires_evidence?: boolean;
+    other_constraints?: string[];
+}
+export interface CapabilityCard {
+    capability_id: string;
+    display_name: string;
+    description: string;
+    object_type: ProjectObjectType;
+    module: CapabilityModule;
+    category: CapabilityCategory;
+    industry_agnostic: IndustryAgnostic;
+    config_template: Record<string, unknown>;
+    industry_overrides?: Record<string, Record<string, unknown>>;
+    observed_in_industries: Record<string, number>;
+    success_count: number;
+    failure_count: number;
+    known_failure_modes: string[];
+    depends_on_capabilities?: string[];
+    referenced_by_skills?: string[];
+    risk_profile?: CapabilityRiskProfile;
+    benefit_profile?: CapabilityBenefitProfile;
+    constraints?: CapabilityConstraints;
+    version: string;
+    superseded_by?: string;
+}
+export interface CapabilityGraphEdge {
+    from: string;
+    to: string;
+    edge_kind: "requires" | "optional" | "conflicts";
+    phase: "create" | "publish" | "runtime";
+    description?: string;
+}
+export interface CapabilityGraph {
+    nodes: Map<string, CapabilityCard>;
+    edges: CapabilityGraphEdge[];
+}
+export interface MigrationEvaluation {
+    feasibility_score: number;
+    covered_capabilities: string[];
+    missing_capabilities: string[];
+    conflicting_capabilities: Array<{
+        capability_id: string;
+        source_config: unknown;
+        target_config: unknown;
+        diff_summary: string;
+    }>;
+    recommendations: string[];
+}
+export interface CoverageReport {
+    industry: string;
+    declared_count: number;
+    expected_count: number;
+    coverage_percentage: number;
+    missing_capabilities: string[];
+}
+export interface ExperienceUpdate {
+    capability_id: string;
+    update_type: "config_template" | "industry_overrides" | "known_failure_modes" | "new_card";
+    payload: unknown;
+    source: string;
+}
+export interface VerificationReport {
+    project_id: string;
+    industry: string;
+    result: "success" | "failure" | "partial";
+    capabilities_used: string[];
+    failure_reasons?: string[];
+}
+export declare class CapabilityRegistry {
+    private static instance;
+    private cards;
+    private edges;
+    private initialized;
+    static Instance(): CapabilityRegistry;
+    private constructor();
+    registerCard(card: CapabilityCard): boolean;
+    getCard(capabilityId: string): CapabilityCard | undefined;
+    listCards(filter?: {
+        objectType?: ProjectObjectType;
+        module?: CapabilityModule;
+        industryAgnostic?: IndustryAgnostic;
+        industry?: string;
+    }): CapabilityCard[];
+    registerEdge(edge: CapabilityGraphEdge): void;
+    getGraph(): CapabilityGraph;
+    getDependencies(capabilityId: string): CapabilityCard[];
+    getDependents(capabilityId: string): CapabilityCard[];
+    getCapabilitiesByIndustry(industry: string): CapabilityCard[];
+    getCapabilitiesByObject(objectType: ProjectObjectType): CapabilityCard[];
+    evaluateMigration(source: string, target: string): MigrationEvaluation;
+    findPurityViolations(): CapabilityCard[];
+    recordUsage(capabilityId: string, industry: string): void;
+    recordSuccess(capabilityId: string): void;
+    recordFailure(capabilityId: string, reason: string): void;
+    recordVerificationReport(report: VerificationReport): void;
+    getCapabilitiesForExtension(capabilitiesUsed: string[]): CapabilityCard[];
+    evaluateExtensionCoverage(industry: string, capabilitiesUsed: string[]): CoverageReport;
+    private registerBuiltins;
+    private registerBuiltinEdges;
+    private computeConfigDiff;
+}
+export declare function getCapabilityRegistry(): CapabilityRegistry;
+export declare const CAPABILITY_MANIFEST_VERSION = 1;
+export declare function recordCapabilitiesUsed(industry: string, capabilitiesUsed: string[]): void;