skillpp 0.1.0

package/schemas/checkpoint.schema.json

@@ -0,0 +1,86 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://skillpp.ai/schemas/checkpoint.schema.json",
+  "title": "Checkpoint Schema",
+  "description": "Defines a mandatory stop point in the pipeline where AI must wait for user confirmation before proceeding. This is the machine-readable enforcement of Skill++'s safety boundaries.",
+  "type": "object",
+  "required": ["checkpointId", "trigger", "requiredAction", "blockUntil"],
+  "properties": {
+    "checkpointId": {
+      "type": "string",
+      "description": "Unique identifier for this checkpoint (e.g. AUDIT_RESULT, TRADE_CONFIRM, CREATE_TOKEN)"
+    },
+    "trigger": {
+      "type": "object",
+      "required": ["condition"],
+      "properties": {
+        "condition": { "type": "string", "description": "When this checkpoint activates" },
+        "riskThreshold": { "type": "number", "description": "Minimum risk score that triggers mandatory block" }
+      }
+    },
+    "requiredAction": {
+      "type": "object",
+      "required": ["display", "waitFor"],
+      "properties": {
+        "display": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Information AI MUST display before proceeding"
+        },
+        "waitFor": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "User responses that satisfy this checkpoint"
+        }
+      }
+    },
+    "blockUntil": {
+      "type": "string",
+      "enum": ["USER_CONFIRMS", "USER_REJECTS", "USER_EXPLICIT_BYPASS", "TIMEOUT"],
+      "description": "What condition releases the checkpoint"
+    },
+    "onReject": {
+      "type": "object",
+      "properties": {
+        "action": { "type": "string", "enum": ["ABORT", "RETRY", "FALLBACK"] },
+        "fallbackPipeline": { "type": "string" }
+      }
+    },
+    "canBypass": {
+      "type": "boolean",
+      "description": "Whether the user can skip this checkpoint. FALSE for write operations.",
+      "default": false
+    },
+    "securityLevel": {
+      "type": "string",
+      "enum": ["ADVISORY", "WARNING", "BLOCKING"],
+      "description": "ADVISORY=inform user but continue; WARNING=strong caution; BLOCKING=hard stop, no bypass"
+    }
+  },
+  "examples": [
+    {
+      "checkpointId": "AUDIT_RESULT",
+      "trigger": { "condition": "audit completed with result", "riskThreshold": 4 },
+      "requiredAction": {
+        "display": ["risk score", "all findings with isHit=true", "disclaimer"],
+        "waitFor": ["继续", "放弃", "深入分析"]
+      },
+      "blockUntil": "USER_CONFIRMS",
+      "onReject": { "action": "ABORT" },
+      "canBypass": false,
+      "securityLevel": "BLOCKING"
+    },
+    {
+      "checkpointId": "TRADE_CONFIRM",
+      "trigger": { "condition": "before any write/send/swap transaction" },
+      "requiredAction": {
+        "display": ["token info", "amount", "estimated cost", "audit result"],
+        "waitFor": ["确认交易", "CONFIRM", "execute"]
+      },
+      "blockUntil": "USER_CONFIRMS",
+      "onReject": { "action": "ABORT" },
+      "canBypass": false,
+      "securityLevel": "BLOCKING"
+    }
+  ]
+}

package/schemas/handoff.schema.json

@@ -0,0 +1,82 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://skillpp.ai/schemas/handoff.schema.json",
+  "title": "Skill Handoff Schema",
+  "description": "Standardized data interchange between skills in the Skill++ pipeline.",
+  "type": "object",
+  "required": ["_meta", "input"],
+  "properties": {
+    "_meta": {
+      "type": "object",
+      "required": ["pipeline", "step", "timestamp", "source"],
+      "properties": {
+        "pipeline": { "type": "string", "description": "Pipeline ID (e.g. P_TOKEN_ANALYSIS)" },
+        "step": { "type": "integer", "description": "Current step number in the pipeline" },
+        "timestamp": { "type": "integer", "description": "Unix timestamp of handoff creation" },
+        "source": { "type": "string", "description": "Skill name that produced this data" },
+        "chain": { "type": "string", "description": "Chain name (BSC/Ethereum/Base/Solana)" },
+        "chainId": { "type": "string", "description": "Chain ID (56/1/8453/CT_501)" },
+        "confidence": {
+          "type": "string",
+          "enum": ["HIGH", "MEDIUM", "LOW", "UNKNOWN"],
+          "description": "Confidence level of the data"
+        },
+        "needsVerification": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Fields that should be cross-verified by another skill"
+        },
+        "verifiedBy": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Skills that have verified this data"
+        }
+      }
+    },
+    "input": {
+      "type": "object",
+      "required": ["raw", "type"],
+      "properties": {
+        "raw": { "type": "string", "description": "Original user input" },
+        "type": {
+          "type": "string",
+          "enum": ["explorer_url", "address", "token_symbol", "source_code", "intent"],
+          "description": "Classification of user input"
+        },
+        "chainId": { "type": "string" },
+        "contractAddress": { "type": "string" },
+        "walletAddress": { "type": "string" }
+      }
+    },
+    "token": { "$ref": "token.schema.json" },
+    "audit": { "$ref": "audit.schema.json" },
+    "market": {
+      "type": "object",
+      "properties": {
+        "smartMoneySignals": { "type": "array" },
+        "rankings": { "type": "array" },
+        "socialTopics": { "type": "array" }
+      }
+    },
+    "wallet": {
+      "type": "object",
+      "properties": {
+        "address": { "type": "string" },
+        "positions": { "type": "array" },
+        "healthScore": { "type": "number" }
+      }
+    },
+    "nextActions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["action", "pipeline"],
+        "properties": {
+          "action": { "type": "string", "description": "Recommended next action" },
+          "pipeline": { "type": "string", "description": "Pipeline ID to execute" },
+          "reason": { "type": "string" }
+        }
+      }
+    }
+  }
+}

package/schemas/token.schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://skillpp.ai/schemas/token.schema.json",
+  "title": "Token Info Schema",
+  "description": "Standardized token information produced by query-token-info and consumed by downstream skills.",
+  "type": "object",
+  "required": ["contractAddress", "chainId"],
+  "properties": {
+    "name": { "type": "string" },
+    "symbol": { "type": "string" },
+    "contractAddress": { "type": "string", "pattern": "^0x[a-fA-F0-9]{40}$" },
+    "chainId": { "type": "string", "enum": ["1", "56", "8453", "CT_501"] },
+    "chain": { "type": "string", "enum": ["Ethereum", "BSC", "Base", "Solana"] },
+    "decimals": { "type": "integer" },
+    "totalSupply": { "type": "string" },
+    "icon": { "type": "string", "description": "Token logo URL" },
+    "website": { "type": "string" },
+    "twitter": { "type": "string" },
+    "telegram": { "type": "string" },
+    "creator": { "type": "string" },
+    "creationTx": { "type": "string" },
+    "price": { "type": "string", "description": "Current price in USD" },
+    "priceChange24h": { "type": "string" },
+    "volume24h": { "type": "string" },
+    "marketCap": { "type": "string" },
+    "liquidity": { "type": "string" },
+    "holders": { "type": "string" },
+    "isVerified": { "type": "boolean" },
+    "sourceAvailable": { "type": "boolean", "description": "Whether verified source code is available" },
+    "contractType": {
+      "type": "string",
+      "enum": ["ERC20", "ERC721", "ERC1155", "PROXY", "MULTISIG", "VAULT", "STAKING", "DEX_PAIR", "UNKNOWN"],
+      "description": "Contract type classification"
+    }
+  }
+}

package/scripts/compatibility-check.mjs

@@ -0,0 +1,130 @@
+#!/usr/bin/env node
+// Skill++ compatibility contract checker.
+// Usage: node scripts/compatibility-check.mjs [baseline-json]
+
+import { existsSync, readFileSync } from 'fs';
+import { join, resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { spawnSync } from 'child_process';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = resolve(__dirname, '..');
+const baselineRel = process.argv[2] || 'tests/compatibility/v0.1.0.json';
+const baselinePath = join(ROOT, baselineRel);
+
+let passed = 0;
+let failed = 0;
+
+function readJson(relPath) {
+  return JSON.parse(readFileSync(join(ROOT, relPath), 'utf-8'));
+}
+
+function ok(message) {
+  passed++;
+  console.log(`  PASS ${message}`);
+}
+
+function fail(message) {
+  failed++;
+  console.error(`  FAIL ${message}`);
+}
+
+function assert(message, condition) {
+  if (condition) ok(message);
+  else fail(message);
+}
+
+function major(version) {
+  return Number(String(version || '').split('.')[0]);
+}
+
+function includesInOrder(actual, required) {
+  let cursor = 0;
+  for (const item of actual) {
+    if (item === required[cursor]) cursor++;
+    if (cursor === required.length) return true;
+  }
+  return required.length === 0;
+}
+
+function runNodeScript(args) {
+  return spawnSync(process.execPath, args, {
+    cwd: ROOT,
+    encoding: 'utf-8',
+    timeout: 10000,
+    windowsHide: true,
+  });
+}
+
+console.log('Skill++ Compatibility Check\n');
+
+if (!existsSync(baselinePath)) {
+  console.error(`Baseline not found: ${baselineRel}`);
+  process.exit(2);
+}
+
+const baseline = JSON.parse(readFileSync(baselinePath, 'utf-8'));
+const pkg = readJson('package.json');
+const manifest = readJson('skillpp.manifest.json');
+
+console.log('1. Package contract');
+assert('package major matches baseline', major(pkg.version) === baseline.major);
+assert('package name is stable', pkg.name === baseline.package.name);
+assert('CLI bin name is stable', Boolean(pkg.bin?.[baseline.package.bin]));
+assert('CLI bin path is stable', pkg.bin?.[baseline.package.bin] === baseline.package.binPath);
+for (const required of baseline.package.requiredFiles) {
+  assert(`package files include ${required}`, pkg.files?.includes(required));
+}
+
+console.log('\n2. Manifest contract');
+assert('manifest protocol is stable', manifest.protocol === baseline.manifest.protocol);
+assert('manifest major matches baseline', major(manifest.version) === baseline.major);
+for (const schemaFile of baseline.manifest.requiredSchemaFiles) {
+  assert(`schema exists: ${schemaFile}`, existsSync(join(ROOT, 'schemas', schemaFile)));
+}
+for (const required of baseline.manifest.requiredSkills) {
+  const current = manifest.skills.find(skill => skill.name === required.name);
+  assert(`skill exists: ${required.name}`, Boolean(current));
+  if (!current) continue;
+  assert(`${required.name} group is stable`, current.group === required.group);
+  assert(`${required.name} readOnly boundary is stable`, current.readOnly === required.readOnly);
+}
+
+console.log('\n3. Pipeline contract');
+for (const required of baseline.manifest.pipelines) {
+  const current = manifest.pipelines.find(pipeline => pipeline.id === required.id);
+  assert(`pipeline exists: ${required.id}`, Boolean(current));
+  if (!current) continue;
+  assert(`${required.id} keeps required skill order`, includesInOrder(current.skills, required.requiredSkillsInOrder));
+  for (const checkpoint of required.requiredCheckpoints) {
+    assert(`${required.id} keeps checkpoint ${checkpoint}`, current.checkpoints?.includes(checkpoint));
+  }
+}
+
+console.log('\n4. Checkpoint contract');
+for (const required of baseline.manifest.checkpoints) {
+  const current = manifest.checkpoints?.find(checkpoint => checkpoint.id === required.id);
+  assert(`checkpoint exists: ${required.id}`, Boolean(current));
+  if (!current) continue;
+  assert(`${required.id} security level is stable`, current.securityLevel === required.securityLevel);
+  assert(`${required.id} bypass policy is stable`, current.canBypass === required.canBypass);
+}
+
+console.log('\n5. CLI contract');
+const help = runNodeScript(['scripts/skillpp.mjs', '--help']);
+assert('help exits successfully', help.status === 0);
+for (const command of baseline.cli.commands) {
+  assert(`help lists ${command}`, help.stdout.includes(command));
+}
+for (const route of baseline.cli.routes) {
+  const out = runNodeScript(['scripts/skillpp.mjs', route.command, route.input, '--dry-run']);
+  assert(`${route.command} route exits successfully`, out.status === 0);
+  assert(`${route.command} routes to ${route.pipeline}`, out.stdout.includes(route.pipeline));
+}
+const blocking = runNodeScript(['scripts/skillpp.mjs', 'trade', baseline.cli.routes.find(route => route.command === 'trade').input]);
+assert('blocking checkpoint exits with baseline code', blocking.status === baseline.cli.checkpointExitCode);
+assert('blocking checkpoint emits STOP_AND_WAIT', blocking.stdout.includes('STOP_AND_WAIT'));
+
+console.log('\nResult');
+console.log(`Passed: ${passed}, Failed: ${failed}`);
+process.exit(failed > 0 ? 1 : 0);