Wanderland Maintenance Guide

Quick reference for common maintenance tasks, gotchas, and configuration issues.

---

Feature Flags

ENABLE_CASE_MANAGEMENT

Location: /Users/gfawcett/org/.config/control-plane.json (in stuffy's environment section)

Purpose: Enables Task API proxying through Stuffy for web components like drawer-view, daily-schedule, daily-timesheet.

Symptom when missing: Web components on Alice in Wanderland page show "Task API not running" errors. API calls to /api/tasks/* return:

{"error":"Failed to get task","details":"Case management feature is disabled. Set ENABLE_CASE_MANAGEMENT=true to enable."}

Fix: Add to control-plane.json under services.stuffy.environment:

"ENABLE_CASE_MANAGEMENT": "true"

Then restart Stuffy via CCP:

ccp stop stuffy
ccp start stuffy

---

Server Locations

Stuffy Server

Running from: /Users/gfawcett/working/wanderland/stuffy/stuffy-server.js

Configured in: ~/org/.config/control-plane.json using ${WANDERLAND_DIR}/stuffy

Old copy: ~/org/stuffy-poc/ exists but is an older divergent version - don't use

Oculus API

Running from: /Users/gfawcett/working/wanderland/oculus-api/

Configured in: ~/org/.config/control-plane.json using ${WANDERLAND_DIR}/oculus-api

Key Paths

Service	Location
Stuffy	~/working/wanderland/stuffy/
Oculus API	~/working/wanderland/oculus-api/
Stuffy CLI	~/working/wanderland/stuffy-cli/
CCP Config	~/org/.config/control-plane.json
Logs	~/org/logs/

Principle: All active development happens in wanderland (~/working/wanderland/). The org directory has service configs and logs but code lives in wanderland.

Control Plane Config

Location: /Users/gfawcett/org/.config/control-plane.json

This is the source of truth for:

• Service start/stop commands
• Environment variables per service
• Port assignments
• Health check endpoints
• Service dependencies

Important: Environment variables in .env files are NOT automatically loaded by CCP. Add them to the control-plane.json instead.

---

Common Issues

Stuffy Web Components Not Loading Data

• Check if Task API is running: ccp health
• Check if ENABLE_CASE_MANAGEMENT=true is in control-plane.json
• Restart Stuffy: ccp restart stuffy

Old Process Still Running After CCP Restart

CCP restart doesn't always kill zombie processes. Use:

pkill -f "node.*stuffy-server.js"
ccp start stuffy

API Returns "Feature Disabled" Error

Feature flag not set. Check control-plane.json environment section for the service.

---

Stuffy CLI

Package: /Users/gfawcett/working/wanderland/stuffy-cli/

Install: pip install -e ~/working/wanderland/stuffy-cli

Key Commands:

stuffy display "# Hello"      # Display content
stuffy upload file.md         # Upload file  
stuffy get --channel main     # Get channel content
stuffy channels               # List channels
stuffy health                 # Check server status
stuffy append "text"          # Append to channel
stuffy copy src dest          # Copy between channels

API Note: Most POST endpoints use form-encoded data, NOT JSON!

Stuffy API Reference

See: stuffy-api-reference node for full API documentation.

Slots

North

slots:
- slug: wanderland-operations
  context: []

East

slots:
- slug: stuffy-api-reference
  context:
  - Linking maintenance guide to API reference

Provenance

Document

• Status: 🔴 Unverified

Changelog

• 2026-01-20 13:53: Node created by mcp - Creating maintenance guide for common Wanderland configuration issues