@wowok/skills 2.1.2 → 2.1.3

package/dist/index.d.ts

@@ -1,4 +1,10 @@
 export * from './types';
 export { wowokSkills, getSkills, getSkillByName, getSkillsByRole, getSkillsByLoading, getRoleSkills, recommendSkills, negotiateSkillMode, negotiateAllSkills, checkSkillMigration, DEPRECATED_SKILLS, SKILL_MIGRATION_MAP } from './skills';
 export type { DeprecatedSkill } from './skills';
+/**
+ * Load a skill's full SKILL.md body (YAML frontmatter stripped). Returns null
+ * when the skill is unknown or its file is missing. This is the same content
+ * the installer copies to external AI clients' skill directories.
+ */
+export declare function getSkillBody(name: string): string | null;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAC;AAGxB,OAAO,EACL,WAAW,EACX,SAAS,EACT,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,SAAS,CAAC;AAGxB,OAAO,EACL,WAAW,EACX,SAAS,EACT,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAOhD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASxD"}

package/dist/index.js

@@ -10,25 +10,72 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
 }));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SKILL_MIGRATION_MAP = exports.DEPRECATED_SKILLS = exports.checkSkillMigration = exports.negotiateAllSkills = exports.negotiateSkillMode = exports.recommendSkills = exports.getRoleSkills = exports.getSkillsByLoading = exports.getSkillsByRole = exports.getSkillByName = exports.getSkills = exports.wowokSkills = void 0;
+exports.getSkillBody = getSkillBody;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const skills_1 = require("./skills");
 // Export types
 __exportStar(require("./types"), exports);
 // Export skills with role-based helpers
-var skills_1 = require("./skills");
-Object.defineProperty(exports, "wowokSkills", { enumerable: true, get: function () { return skills_1.wowokSkills; } });
-Object.defineProperty(exports, "getSkills", { enumerable: true, get: function () { return skills_1.getSkills; } });
-Object.defineProperty(exports, "getSkillByName", { enumerable: true, get: function () { return skills_1.getSkillByName; } });
-Object.defineProperty(exports, "getSkillsByRole", { enumerable: true, get: function () { return skills_1.getSkillsByRole; } });
-Object.defineProperty(exports, "getSkillsByLoading", { enumerable: true, get: function () { return skills_1.getSkillsByLoading; } });
-Object.defineProperty(exports, "getRoleSkills", { enumerable: true, get: function () { return skills_1.getRoleSkills; } });
-Object.defineProperty(exports, "recommendSkills", { enumerable: true, get: function () { return skills_1.recommendSkills; } });
-Object.defineProperty(exports, "negotiateSkillMode", { enumerable: true, get: function () { return skills_1.negotiateSkillMode; } });
-Object.defineProperty(exports, "negotiateAllSkills", { enumerable: true, get: function () { return skills_1.negotiateAllSkills; } });
-Object.defineProperty(exports, "checkSkillMigration", { enumerable: true, get: function () { return skills_1.checkSkillMigration; } });
-Object.defineProperty(exports, "DEPRECATED_SKILLS", { enumerable: true, get: function () { return skills_1.DEPRECATED_SKILLS; } });
-Object.defineProperty(exports, "SKILL_MIGRATION_MAP", { enumerable: true, get: function () { return skills_1.SKILL_MIGRATION_MAP; } });
+var skills_2 = require("./skills");
+Object.defineProperty(exports, "wowokSkills", { enumerable: true, get: function () { return skills_2.wowokSkills; } });
+Object.defineProperty(exports, "getSkills", { enumerable: true, get: function () { return skills_2.getSkills; } });
+Object.defineProperty(exports, "getSkillByName", { enumerable: true, get: function () { return skills_2.getSkillByName; } });
+Object.defineProperty(exports, "getSkillsByRole", { enumerable: true, get: function () { return skills_2.getSkillsByRole; } });
+Object.defineProperty(exports, "getSkillsByLoading", { enumerable: true, get: function () { return skills_2.getSkillsByLoading; } });
+Object.defineProperty(exports, "getRoleSkills", { enumerable: true, get: function () { return skills_2.getRoleSkills; } });
+Object.defineProperty(exports, "recommendSkills", { enumerable: true, get: function () { return skills_2.recommendSkills; } });
+Object.defineProperty(exports, "negotiateSkillMode", { enumerable: true, get: function () { return skills_2.negotiateSkillMode; } });
+Object.defineProperty(exports, "negotiateAllSkills", { enumerable: true, get: function () { return skills_2.negotiateAllSkills; } });
+Object.defineProperty(exports, "checkSkillMigration", { enumerable: true, get: function () { return skills_2.checkSkillMigration; } });
+Object.defineProperty(exports, "DEPRECATED_SKILLS", { enumerable: true, get: function () { return skills_2.DEPRECATED_SKILLS; } });
+Object.defineProperty(exports, "SKILL_MIGRATION_MAP", { enumerable: true, get: function () { return skills_2.SKILL_MIGRATION_MAP; } });
+/** Resolve the skills package root from the compiled output (dist/index.js → package root). */
+function getPackageRoot() {
+    return path.resolve(__dirname, '..');
+}
+/**
+ * Load a skill's full SKILL.md body (YAML frontmatter stripped). Returns null
+ * when the skill is unknown or its file is missing. This is the same content
+ * the installer copies to external AI clients' skill directories.
+ */
+function getSkillBody(name) {
+    const skill = (0, skills_1.getSkillByName)(name);
+    if (!skill)
+        return null;
+    const file = path.join(getPackageRoot(), name, 'SKILL.md');
+    if (!fs.existsSync(file))
+        return null;
+    const raw = fs.readFileSync(file, 'utf-8');
+    // Tolerate both LF and CRLF line endings in the YAML frontmatter fence.
+    const m = raw.match(/^---\r?\n[\s\S]*?\r?\n---\r?\n([\s\S]*)$/);
+    return m ? m[1] : raw;
+}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,eAAe;AACf,0CAAwB;AAExB,wCAAwC;AACxC,mCAakB;AAZhB,qGAAA,WAAW,OAAA;AACX,mGAAA,SAAS,OAAA;AACT,wGAAA,cAAc,OAAA;AACd,yGAAA,eAAe,OAAA;AACf,4GAAA,kBAAkB,OAAA;AAClB,uGAAA,aAAa,OAAA;AACb,yGAAA,eAAe,OAAA;AACf,4GAAA,kBAAkB,OAAA;AAClB,4GAAA,kBAAkB,OAAA;AAClB,6GAAA,mBAAmB,OAAA;AACnB,2GAAA,iBAAiB,OAAA;AACjB,6GAAA,mBAAmB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,oCASC;AA3CD,uCAAyB;AACzB,2CAA6B;AAC7B,qCAA0C;AAE1C,eAAe;AACf,0CAAwB;AAExB,wCAAwC;AACxC,mCAakB;AAZhB,qGAAA,WAAW,OAAA;AACX,mGAAA,SAAS,OAAA;AACT,wGAAA,cAAc,OAAA;AACd,yGAAA,eAAe,OAAA;AACf,4GAAA,kBAAkB,OAAA;AAClB,uGAAA,aAAa,OAAA;AACb,yGAAA,eAAe,OAAA;AACf,4GAAA,kBAAkB,OAAA;AAClB,4GAAA,kBAAkB,OAAA;AAClB,6GAAA,mBAAmB,OAAA;AACnB,2GAAA,iBAAiB,OAAA;AACjB,6GAAA,mBAAmB,OAAA;AAIrB,+FAA+F;AAC/F,SAAS,cAAc;IACrB,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,SAAgB,YAAY,CAAC,IAAY;IACvC,MAAM,KAAK,GAAG,IAAA,uBAAc,EAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IAC3D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,wEAAwE;IACxE,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAChE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AACxB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wowok/skills",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "description": "WoWok AI Skills for Claude and other AI assistants - Dialogue orchestration layer on top of the WoWok MCP server (rules/reference knowledge is served by MCP directly since v2.0.0)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/wowok-arbitrator/SKILL.md

@@ -169,6 +169,8 @@ Customer dispute creates Arb directly at (1). State (0) entered only via `reset`
 | **Messenger** (preferred) | Specific evidence, privacy-sensitive | Encrypted, off-chain |
 | **on-chain feedback** | General clarification, procedural | Public, permanent |
 
+**Best-move advice** (`evaluation_operation` → `arb_game`): pass `status` (7-state) + `perspective` (`disputant`/`arbitrator`/`voter`) to get ranked moves (optimal + payoff + risk). Read the result; the role decides and acts.
+
 ---
 
 ## Phase 3: Business Model

package/wowok-onboard/SKILL.md

@@ -165,6 +165,7 @@ Each round below lists: **Semantic meaning**, **Core elements to confirm**, **De
   - `name`, `price` (u64, min unit), `stock`.
   - `wip` (URL) + `wip_hash` — **the WIP MUST be deployed to a public endpoint** (on-chain only stores the URL + hash, not the file).
 - **WIP public deployment (strongly recommended sub-task)**: user provides web/doc material → AI generates the WIP file + deploys to a public URL (recommend GitHub Pages / free static hosting).
+- **⚠️ NO "set-without-deploy" option**: `sale.wip` is stored ON-CHAIN and every customer fetches it when ordering. The ONLY two valid choices are: (1) deploy the .wip file to a publicly reachable URL and set `wip` to that URL, or (2) leave `wip: ""` (TESTING ONLY — WIP verification skipped). Do NOT offer a placeholder/local path/localhost/LAN URL as `wip` — it passes merchant-side verification but aborts customer `order_new` 100% (INTERNAL TEST USE ONLY: local-network URLs require `env.network: "localnet"`).
 - **Default config**: n/a — products are user business decisions (never fabricated).
 - **Reuse / Customize / Discover**: Reuse an existing `sales` item (rare). Customize: define your own products. Discover: n/a.
 - **Dependencies**: Service draft (R3).

package/wowok-order/SKILL.md

@@ -246,6 +246,13 @@ Key fields: `reminders[]` (`required` blocks purchase; `recommended` = strong ca
 
 **Red lines** (do not purchase): no arb + no refund path, OR `compensation_ratio < 0.5`. **Post-purchase**: monitor refund Allocator triggers, WIP hash mismatch, merchant unreachable (>3d warning, >7d arb), evidence collection (≥3 items). **Runtime toggle**: `config_operation` → `action: "toggle"`, `service: "order_monitor"` (default OFF).
 
+**Plug-in evaluation** (`evaluation_operation` tool — read result, do NOT recompute):
+- `service_risk` — 4-dimension risk (workflow/fund/trust/behavior) via the pluggable engine; inject red lines (`requirements`) or unplug dimensions (`overrides`).
+- `demand_match` / `service_match` — rank candidate services/demands against a capability vector (industry/region/price/trust/capabilities).
+- `capability_gap` — unmet requirements vs a service; `compose_service` — combine services to cover a demand.
+- `node_game` / `arb_game` — best-move + payoff at a Progress node / Arb state (pair with `participation_radar` output).
+The role decides and acts; the tool is read-only.
+
 ---
 
 ### Phase Dependency

package/wowok-provider/SKILL.md

@@ -176,10 +176,12 @@ Immutable product commitment for arbitration evidence.
 ```
 Create:  wowok({ tool: "wip_file", data: { type: "generate", ... } }) → markdown_text + images → outputPath
 Attach: wowok({ tool: "onchain_operations", data: { operation_type: "service", ... } }) → sales.sales[{
-          name, price, stock, wip: "<URL>", wip_hash: "" (auto)
+          name, price, stock, wip: "<public-URL>", wip_hash: "" (auto)
         }]
 ```
 
+> ⚠️ **WIP must be network-deployed.** `sale.wip` is stored ON-CHAIN and every customer fetches it when placing an order. A non-empty `wip` MUST be a publicly reachable URL (GitHub Pages / IPFS / your own website). A local file path (`C:\...`, `/path/file.wip`) or a localhost/LAN URL (`http://localhost:...`, `http://192.168.x.x`) is reachable only from the merchant's machine — it passes merchant-side set-time verification but **aborts customer `order_new` 100%**. Local-network URLs are INTERNAL TEST USE ONLY (set `env.network: "localnet"`); on testnet/mainnet they are rejected. If the WIP cannot be deployed, leave `sale.wip: ""` (TESTING ONLY, WIP verification skipped).
+
 ### Compensation Fund (Optional but Recommended)
 
 - Add: `compensation_fund_add` | Lock: `setting_lock_duration_add` (default 30 days = 2592000000ms, configurable via `setting_lock_duration_add`)
@@ -233,4 +235,6 @@ Before forking, verify necessity via `get_project_detail` → `has_published_obj
 
 **AI Reminder**: When fulfilling, check `customer_required` fields. Missing → prompt via Messenger.
 
+**Demand/service matching** (`evaluation_operation`): `demand_match` ranks candidate services for a demand capability vector; `service_match` is the reverse; `capability_gap` lists unmet requirements; `compose_service` combines services to cover a demand. Read-only — the merchant decides whether to `present` (`onchain_operations` → `demand` → `present_service`).
+
 ---