@mclawnet/agent 0.6.19 → 0.6.21

package/skills/theone-cocos-standards/references/review/quality-review.md

@@ -0,0 +1,239 @@
+# TypeScript Quality Review
+
+This review focuses on TypeScript code quality issues including access modifiers, strict mode compliance, error handling, and code hygiene.
+
+## TypeScript Strict Mode Violations
+
+```typescript
+// ❌ CRITICAL: Strict mode disabled
+// tsconfig.json
+{
+    "compilerOptions": {
+        "strict": false // Bad!
+    }
+}
+
+// ✅ CORRECT: Enable strict mode
+{
+    "compilerOptions": {
+        "strict": true,
+        "noImplicitAny": true,
+        "strictNullChecks": true,
+        "strictFunctionTypes": true,
+        "strictBindCallApply": true,
+        "strictPropertyInitialization": true
+    }
+}
+
+// Severity: 🔴 Critical
+// Fix: Enable strict mode in tsconfig.json
+```
+
+## Access Modifier Violations
+
+```typescript
+// ❌ CRITICAL: Missing access modifiers
+@ccclass('NoModifiers')
+export class NoModifiers extends Component {
+    playerNode: Node | null = null; // Implicitly public!
+    currentHealth: number = 100;    // Implicitly public!
+
+    updateHealth(value: number) {   // Implicitly public!
+        this.currentHealth = value;
+    }
+}
+
+// ✅ CORRECT: Explicit modifiers
+@ccclass('WithModifiers')
+export class WithModifiers extends Component {
+    @property(Node)
+    private readonly playerNode: Node | null = null;
+
+    private currentHealth: number = 100;
+
+    public updateHealth(value: number): void {
+        this.currentHealth = value;
+    }
+}
+
+// Severity: 🔴 Critical
+// Fix: Add access modifiers (public/private/protected) to all members
+```
+
+## Silent Error Handling
+
+```typescript
+// ❌ CRITICAL: Silent failures
+@ccclass('SilentErrors')
+export class SilentErrors extends Component {
+    public getPlayer(id: string): Player | undefined {
+        const player = this.players.get(id);
+        return player; // Caller doesn't know why it failed
+    }
+}
+
+// ✅ CORRECT: Throw exceptions
+@ccclass('ThrowExceptions')
+export class ThrowExceptions extends Component {
+    public getPlayer(id: string): Player {
+        const player = this.players.get(id);
+        if (!player) {
+            throw new Error(`Player not found: ${id}`);
+        }
+        return player;
+    }
+}
+
+// Severity: 🔴 Critical
+// Fix: Throw exceptions for errors, not silent failures
+```
+
+## console.log in Production
+
+```typescript
+// ❌ CRITICAL: Unconditional console.log
+@ccclass('ConsoleLogBad')
+export class ConsoleLogBad extends Component {
+    protected update(dt: number): void {
+        console.log('Update'); // In production build!
+    }
+}
+
+// ✅ CORRECT: Conditional or removed
+@ccclass('ConsoleLogGood')
+export class ConsoleLogGood extends Component {
+    protected update(dt: number): void {
+        if (CC_DEBUG) {
+            console.log('Update');
+        }
+    }
+}
+
+// Severity: 🔴 Critical (for playables)
+// Impact: Bundle size increase, performance
+// Fix: Wrap in CC_DEBUG or remove entirely
+```
+
+## Inline Comments Instead of Descriptive Names
+
+```typescript
+// ❌ IMPORTANT: Comments explaining unclear code
+@ccclass('InlineCommentsBad')
+export class InlineCommentsBad extends Component {
+    private h: number = 100; // health
+
+    public td(a: number): void { // take damage
+        this.h = this.h - a; // subtract
+        if (this.h <= 0) { // dead
+            this.hd(); // handle death
+        }
+    }
+}
+
+// ✅ CORRECT: Self-explanatory names
+@ccclass('InlineCommentsGood')
+export class InlineCommentsGood extends Component {
+    private currentHealth: number = 100;
+
+    public takeDamage(amount: number): void {
+        this.currentHealth -= amount;
+        if (this.isDead()) {
+            this.handleDeath();
+        }
+    }
+
+    private isDead(): boolean {
+        return this.currentHealth <= 0;
+    }
+
+    private handleDeath(): void {
+        // Implementation
+    }
+}
+
+// Severity: 🟡 Important
+// Fix: Use descriptive names, remove inline comments
+```
+
+## Missing readonly/const
+
+```typescript
+// ❌ IMPORTANT: Mutable when should be immutable
+@ccclass('MissingReadonly')
+export class MissingReadonly extends Component {
+    @property(Node)
+    private targetNode: Node | null = null; // Should be readonly
+
+    private maxHealth: number = 100; // Should be static readonly
+}
+
+// ✅ CORRECT: Use readonly/const
+@ccclass('WithReadonly')
+export class WithReadonly extends Component {
+    @property(Node)
+    private readonly targetNode: Node | null = null;
+
+    private static readonly MAX_HEALTH: number = 100;
+}
+
+// Severity: 🟡 Important
+// Fix: Add readonly to fields not reassigned, use static readonly for constants
+```
+
+## Using `any` Type
+
+```typescript
+// ❌ IMPORTANT: Using any without justification
+@ccclass('UsingAny')
+export class UsingAny extends Component {
+    private data: any = {}; // Type safety lost
+
+    public processData(input: any): any {
+        return input; // No type checking
+    }
+}
+
+// ✅ CORRECT: Use proper types
+interface PlayerData {
+    id: string;
+    name: string;
+    level: number;
+}
+
+@ccclass('WithTypes')
+export class WithTypes extends Component {
+    private data: Map<string, PlayerData> = new Map();
+
+    public processData(input: PlayerData): PlayerData {
+        return input;
+    }
+}
+
+// Severity: 🟡 Important
+// Fix: Define proper types and interfaces, avoid `any`
+```
+
+## Summary: Quality Review Checklist
+
+**🔴 Critical (Must Fix):**
+- [ ] TypeScript strict mode enabled in tsconfig.json
+- [ ] All members have access modifiers (public/private/protected)
+- [ ] Exceptions thrown for errors (no silent failures)
+- [ ] console.log removed or wrapped in CC_DEBUG
+- [ ] No nullable warnings (proper null handling)
+
+**🟡 Important (Should Fix):**
+- [ ] readonly used for non-reassigned fields
+- [ ] const used for constants (not let)
+- [ ] No inline comments (self-explanatory code)
+- [ ] Optional chaining (?.) for safe access
+- [ ] Nullish coalescing (??) for defaults
+- [ ] No `any` types without justification
+
+**🟢 Nice to Have:**
+- [ ] Arrow functions for callbacks
+- [ ] Destructuring for cleaner code
+- [ ] Type guards for type safety
+- [ ] Utility types (Partial, Required, etc.)
+
+**Code quality is the foundation - fix these issues before performance optimization.**

package/dist/chunk-CBZIH6FY.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/config.ts"],"sourcesContent":["import { readFileSync, writeFileSync, mkdirSync, existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { homedir, hostname } from \"node:os\";\nimport type { BackendType } from \"@mclawnet/shared\";\nimport { createLogger } from \"@mclawnet/logger\";\n\nconst log = createLogger({ module: \"config\" });\n\nexport interface EmbeddingConfig {\n  /** Embedding provider mode: auto / openai / ollama / hash */\n  provider?: string;\n  /** OpenAI-compatible API base URL (e.g. http://localhost:4141/v1 for copilot proxy) */\n  openaiBaseUrl?: string;\n  /** OpenAI API key (use \"dummy\" for copilot proxy) */\n  openaiApiKey?: string;\n  /** OpenAI embedding model name */\n  openaiModel?: string;\n  /** Ollama server URL */\n  ollamaUrl?: string;\n  /** Ollama embedding model name */\n  ollamaModel?: string;\n}\n\nexport interface AgentConfig {\n  hubUrl: string;\n  token: string;\n  name: string;\n  backendType: BackendType;\n  embedding?: EmbeddingConfig;\n}\n\nconst CONFIG_DIR = join(homedir(), \".clawnet\");\nconst SETTINGS_FILE = join(CONFIG_DIR, \"settings.json\");\n\nconst DEFAULT_HUB_URL = process.env.CLAWNET_DEFAULT_HUB_URL || \"ws://localhost:3000/ws/agent\";\n\nconst DEFAULTS: AgentConfig = {\n  hubUrl: DEFAULT_HUB_URL,\n  token: \"\",\n  name: hostname(),\n  backendType: \"claude-code\",\n};\n\n/** Ensure hubUrl uses ws(s):// protocol and ends with /ws/agent */\nfunction normalizeHubUrl(url: string): string {\n  // Convert http(s):// to ws(s)://\n  url = url.replace(/^https:\\/\\//, \"wss://\").replace(/^http:\\/\\//, \"ws://\");\n  // Default to wss:// if no protocol\n  if (!/^wss?:\\/\\//.test(url)) url = \"wss://\" + url;\n  if (url.endsWith(\"/ws/agent\")) return url;\n  return url.replace(/\\/+$/, \"\") + \"/ws/agent\";\n}\n\n/**\n * Map structured embedding config to CLAWNET_* env vars.\n * Only sets vars that are not already defined in process.env.\n */\nfunction applyEmbeddingConfig(embedding: EmbeddingConfig): void {\n  const mapping: Array<[keyof EmbeddingConfig, string]> = [\n    [\"provider\", \"CLAWNET_EMBEDDING_PROVIDER\"],\n    [\"openaiBaseUrl\", \"CLAWNET_OPENAI_BASE_URL\"],\n    [\"openaiApiKey\", \"CLAWNET_OPENAI_API_KEY\"],\n    [\"openaiModel\", \"CLAWNET_OPENAI_EMBEDDING_MODEL\"],\n    [\"ollamaUrl\", \"CLAWNET_OLLAMA_URL\"],\n    [\"ollamaModel\", \"CLAWNET_OLLAMA_MODEL\"],\n  ];\n\n  for (const [configKey, envKey] of mapping) {\n    const value = embedding[configKey];\n    if (value !== undefined && process.env[envKey] === undefined) {\n      process.env[envKey] = value;\n    }\n  }\n}\n\n/** Load config: CLI opts > env vars > settings file > defaults */\nexport function loadConfig(cliOpts: Partial<AgentConfig> = {}): AgentConfig {\n  let fileConfig: Partial<AgentConfig> = {};\n\n  log.info({ path: SETTINGS_FILE }, \"loading config\");\n\n  if (existsSync(SETTINGS_FILE)) {\n    try {\n      fileConfig = JSON.parse(readFileSync(SETTINGS_FILE, \"utf-8\"));\n      log.info(\n        { hubUrl: fileConfig.hubUrl, hasToken: !!fileConfig.token, name: fileConfig.name },\n        \"settings.json loaded\"\n      );\n    } catch (e) {\n      log.warn({ err: e }, \"failed to parse settings.json\");\n    }\n  } else {\n    log.warn(\"settings.json not found\");\n  }\n\n  // Apply structured embedding config to process.env\n  if (fileConfig.embedding) {\n    applyEmbeddingConfig(fileConfig.embedding);\n  }\n\n  const hubUrl =\n    cliOpts.hubUrl ??\n    process.env.CLAWNET_HUB_URL ??\n    fileConfig.hubUrl ??\n    DEFAULTS.hubUrl;\n\n  const resolved = {\n    hubUrl: normalizeHubUrl(hubUrl),\n    token:\n      cliOpts.token ??\n      process.env.CLAWNET_TOKEN ??\n      fileConfig.token ??\n      DEFAULTS.token,\n    name:\n      cliOpts.name ??\n      process.env.CLAWNET_NAME ??\n      fileConfig.name ??\n      DEFAULTS.name,\n    backendType:\n      (cliOpts.backendType as BackendType) ??\n      (process.env.CLAWNET_BACKEND_TYPE as BackendType) ??\n      (fileConfig.backendType as BackendType) ??\n      DEFAULTS.backendType,\n    embedding: fileConfig.embedding,\n  };\n\n  log.info(\n    {\n      hubUrl: resolved.hubUrl,\n      hubUrlSource: cliOpts.hubUrl ? \"cli\" : process.env.CLAWNET_HUB_URL ? \"env\" : fileConfig.hubUrl ? \"file\" : \"default\",\n      tokenSource: cliOpts.token ? \"cli\" : process.env.CLAWNET_TOKEN ? \"env\" : fileConfig.token ? \"file\" : \"default\",\n      hasToken: !!resolved.token,\n    },\n    \"config resolved\"\n  );\n\n  return resolved;\n}\n\n/** Save config to ~/.clawnet/settings.json */\nexport function saveConfig(config: Partial<AgentConfig>): void {\n  mkdirSync(CONFIG_DIR, { recursive: true });\n\n  let existing: Partial<AgentConfig> = {};\n  if (existsSync(SETTINGS_FILE)) {\n    try {\n      existing = JSON.parse(readFileSync(SETTINGS_FILE, \"utf-8\"));\n    } catch {\n      // ignore\n    }\n  }\n\n  const merged = { ...existing, ...config };\n  writeFileSync(SETTINGS_FILE, JSON.stringify(merged, null, 2) + \"\\n\");\n}\n"],"mappings":"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","names":[]}

package/dist/macos-BTP5JW3U.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/service/macos.ts"],"sourcesContent":["import { execSync, spawn } from \"child_process\";\nimport { existsSync, writeFileSync, unlinkSync, mkdirSync, chmodSync } from \"fs\";\nimport { join } from \"path\";\nimport { homedir } from \"os\";\nimport type { ServiceManager, ServiceStatus } from \"./types.js\";\nimport {\n  SERVICE_LABEL,\n  getLogDir,\n  getNodePath,\n  getCliPath,\n  loadServiceConfig,\n  type ServiceConfig,\n} from \"./config.js\";\n\nexport function getPlistPath(): string {\n  return join(homedir(), \"Library\", \"LaunchAgents\", `${SERVICE_LABEL}.plist`);\n}\n\nfunction getDomainTarget(): string {\n  return `gui/${process.getuid!()}`;\n}\n\nfunction getServiceTarget(): string {\n  return `${getDomainTarget()}/${SERVICE_LABEL}`;\n}\n\nfunction escapeXml(str: string): string {\n  return str\n    .replace(/&/g, \"&amp;\")\n    .replace(/</g, \"&lt;\")\n    .replace(/>/g, \"&gt;\")\n    .replace(/\"/g, \"&quot;\")\n    .replace(/'/g, \"&apos;\");\n}\n\nexport function generatePlist(config: ServiceConfig): string {\n  const nodePath = getNodePath();\n  const cliPath = getCliPath();\n  const logDir = getLogDir();\n\n  const envEntries: string[] = [];\n  if (config.hubUrl) {\n    envEntries.push(`      <key>CLAWNET_HUB_URL</key>\\n      <string>${escapeXml(config.hubUrl)}</string>`);\n  }\n  if (config.token) {\n    envEntries.push(`      <key>CLAWNET_TOKEN</key>\\n      <string>${escapeXml(config.token)}</string>`);\n  }\n  if (config.name) {\n    envEntries.push(`      <key>CLAWNET_NAME</key>\\n      <string>${escapeXml(config.name)}</string>`);\n  }\n\n  return `<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<!DOCTYPE plist PUBLIC \"-//Apple//DTD PLIST 1.0//EN\" \"http://www.apple.com/DTDs/PropertyList-1.0.dtd\">\n<plist version=\"1.0\">\n<dict>\n    <key>Label</key>\n    <string>${SERVICE_LABEL}</string>\n    <key>ProgramArguments</key>\n    <array>\n        <string>${nodePath}</string>\n        <string>${cliPath}</string>\n        <string>start</string>\n        <string>-f</string>\n    </array>\n    <key>WorkingDirectory</key>\n    <string>${homedir()}</string>\n    <key>EnvironmentVariables</key>\n    <dict>\n${envEntries.join(\"\\n\")}\n    </dict>\n    <key>RunAtLoad</key>\n    <true/>\n    <key>KeepAlive</key>\n    <dict>\n        <key>SuccessfulExit</key>\n        <false/>\n    </dict>\n    <key>ThrottleInterval</key>\n    <integer>10</integer>\n    <key>StandardOutPath</key>\n    <string>${logDir}/out.log</string>\n    <key>StandardErrorPath</key>\n    <string>${logDir}/error.log</string>\n</dict>\n</plist>`;\n}\n\nexport class MacOSServiceManager implements ServiceManager {\n  async install(): Promise<void> {\n    const config = loadServiceConfig();\n    const plistPath = getPlistPath();\n    const logDir = getLogDir();\n    const launchAgentsDir = join(homedir(), \"Library\", \"LaunchAgents\");\n\n    if (existsSync(plistPath)) {\n      try {\n        execSync(`launchctl bootout ${getServiceTarget()}`, { stdio: \"ignore\" });\n      } catch { /* not loaded */ }\n    }\n\n    if (!existsSync(launchAgentsDir)) mkdirSync(launchAgentsDir, { recursive: true });\n    if (!existsSync(logDir)) mkdirSync(logDir, { recursive: true });\n\n    writeFileSync(plistPath, generatePlist(config), \"utf-8\");\n    chmodSync(plistPath, 0o600);\n    console.log(`✓ Service registered: ${plistPath}`);\n  }\n\n  async uninstall(): Promise<void> {\n    const plistPath = getPlistPath();\n    if (!existsSync(plistPath)) {\n      console.log(\"Service not registered\");\n      return;\n    }\n    try {\n      execSync(`launchctl bootout ${getServiceTarget()}`, { stdio: \"ignore\" });\n    } catch { /* not loaded */ }\n    unlinkSync(plistPath);\n    console.log(\"✓ Service removed\");\n  }\n\n  async start(): Promise<void> {\n    const plistPath = getPlistPath();\n    if (!existsSync(plistPath)) {\n      throw new Error(\"Service not registered. Run clawnet-agent enable first.\");\n    }\n    try {\n      execSync(`launchctl bootstrap ${getDomainTarget()} \"${plistPath}\"`, { stdio: \"ignore\" });\n    } catch { /* already bootstrapped */ }\n    execSync(`launchctl kickstart -k ${getServiceTarget()}`, { stdio: \"inherit\" });\n    console.log(\"✓ Service started\");\n  }\n\n  async stop(): Promise<void> {\n    const plistPath = getPlistPath();\n    if (!existsSync(plistPath)) {\n      console.log(\"Service not registered\");\n      return;\n    }\n    try {\n      execSync(`launchctl bootout ${getServiceTarget()}`, { stdio: \"inherit\" });\n      console.log(\"✓ Service stopped\");\n    } catch {\n      console.log(\"Service not running\");\n    }\n  }\n\n  async restart(): Promise<void> {\n    const plistPath = getPlistPath();\n    if (!existsSync(plistPath)) {\n      throw new Error(\"Service not registered. Run clawnet-agent enable first.\");\n    }\n    try {\n      execSync(`launchctl bootstrap ${getDomainTarget()} \"${plistPath}\"`, { stdio: \"ignore\" });\n    } catch { /* already bootstrapped */ }\n    execSync(`launchctl kickstart -k ${getServiceTarget()}`, { stdio: \"inherit\" });\n    console.log(\"✓ Service restarted\");\n  }\n\n  async status(): Promise<ServiceStatus> {\n    try {\n      const output = execSync(\n        `launchctl list | grep ${SERVICE_LABEL}`,\n        { encoding: \"utf-8\" }\n      ).trim();\n      if (!output) return { running: false };\n      const [pidStr, exitCodeStr] = output.split(/\\s+/);\n      const pid = pidStr === \"-\" ? undefined : parseInt(pidStr, 10);\n      const exitCode = parseInt(exitCodeStr, 10);\n      return { running: pid !== undefined, pid, exitCode };\n    } catch {\n      return { running: false };\n    }\n  }\n\n  async printStatus(): Promise<void> {\n    const s = await this.status();\n    console.log(\"ClawNet Agent\");\n    console.log(`  Status: ${s.running ? \"Running ✓\" : \"Stopped ✗\"}`);\n    if (s.pid) console.log(`  PID: ${s.pid}`);\n    if (s.exitCode !== undefined && !s.running) console.log(`  Exit code: ${s.exitCode}`);\n    console.log(\"  Platform: macOS (launchd)\");\n  }\n\n  async logs(options: { follow?: boolean; lines?: number } = {}): Promise<void> {\n    const logDir = getLogDir();\n    const outLog = join(logDir, \"out.log\");\n    const errLog = join(logDir, \"error.log\");\n\n    const files: string[] = [];\n    if (existsSync(outLog)) files.push(outLog);\n    if (existsSync(errLog)) files.push(errLog);\n\n    if (files.length === 0) {\n      console.log(\"No logs yet\");\n      return;\n    }\n\n    const lines = options.lines || 100;\n    const args = options.follow\n      ? [\"-f\", \"-n\", String(lines), ...files]\n      : [\"-n\", String(lines), ...files];\n\n    const child = spawn(\"tail\", args, { stdio: \"inherit\" });\n    await new Promise<void>((resolve) => child.on(\"close\", resolve));\n  }\n}\n"],"mappings":"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","names":[]}