qwen-base 1.0.0

package/src/packages/base-mcp/tools/validate.js

@@ -0,0 +1,121 @@
+/**
+ * Lightweight schema validation for BASE data surfaces.
+ * No external dependencies — enforces required fields and basic structure
+ * based on schemas/*.schema.json definitions.
+ *
+ * Validates on write to catch data corruption early.
+ * Logs warnings rather than throwing — defensive, won't block operations.
+ */
+
+function debugLog(...args) {
+    console.error('[BASE:validate]', new Date().toISOString(), ...args);
+}
+
+// ============================================================
+// SCHEMA DEFINITIONS (derived from schemas/*.schema.json)
+// ============================================================
+
+const SCHEMAS = {
+    projects: {
+        requiredRoot: ['items'],
+        itemFields: ['id', 'title', 'type', 'status', 'priority', 'created_at', 'updated_at'],
+        validTypes: ['initiative', 'project', 'task'],
+        validStatuses: ['backlog', 'todo', 'in_progress', 'blocked', 'in_review', 'completed', 'deferred', 'archived'],
+        validPriorities: ['urgent', 'high', 'medium', 'low', 'ongoing'],
+        idPattern: /^(INI|PRJ|TSK)-\d{3,}$/
+    },
+    entities: {
+        requiredRoot: ['entities'],
+        itemFields: ['id', 'name', 'type', 'created_at', 'updated_at'],
+        validTypes: ['person', 'organization'],
+        idPattern: /^ENT-\d{3,}$/
+    },
+    state: {
+        requiredRoot: ['groom', 'drift', 'areas'],
+        requiredGroom: ['cadence'],
+        validCadences: ['daily', 'weekly', 'bi-weekly', 'monthly'],
+        validAreaStatuses: ['current', 'stale', 'critical']
+    }
+};
+
+// ============================================================
+// VALIDATORS
+// ============================================================
+
+/**
+ * Validate a data surface before writing.
+ * Returns { valid: boolean, warnings: string[] }
+ */
+export function validateSurface(surfaceName, data) {
+    const schema = SCHEMAS[surfaceName];
+    if (!schema) {
+        return { valid: true, warnings: [] };
+    }
+
+    const warnings = [];
+
+    // Check required root fields
+    if (schema.requiredRoot) {
+        for (const field of schema.requiredRoot) {
+            if (data[field] === undefined) {
+                warnings.push(`Missing required root field: ${field}`);
+            }
+        }
+    }
+
+    // Validate items array (projects, entities)
+    if (schema.itemFields && Array.isArray(data.items || data.entities)) {
+        const items = data.items || data.entities;
+        for (let i = 0; i < items.length; i++) {
+            const item = items[i];
+            for (const field of schema.itemFields) {
+                if (item[field] === undefined) {
+                    warnings.push(`Item ${item.id || `[${i}]`}: missing required field '${field}'`);
+                }
+            }
+
+            // Validate ID pattern
+            if (schema.idPattern && item.id && !schema.idPattern.test(item.id)) {
+                warnings.push(`Item ${item.id}: ID does not match pattern ${schema.idPattern}`);
+            }
+
+            // Validate enum fields
+            if (schema.validTypes && item.type && !schema.validTypes.includes(item.type)) {
+                warnings.push(`Item ${item.id || `[${i}]`}: invalid type '${item.type}'`);
+            }
+            if (schema.validStatuses && item.status && !schema.validStatuses.includes(item.status)) {
+                warnings.push(`Item ${item.id || `[${i}]`}: invalid status '${item.status}'`);
+            }
+            if (schema.validPriorities && item.priority && !schema.validPriorities.includes(item.priority)) {
+                warnings.push(`Item ${item.id || `[${i}]`}: invalid priority '${item.priority}'`);
+            }
+        }
+    }
+
+    // State-specific validation
+    if (surfaceName === 'state') {
+        if (data.groom && schema.requiredGroom) {
+            for (const field of schema.requiredGroom) {
+                if (data.groom[field] === undefined) {
+                    warnings.push(`groom: missing required field '${field}'`);
+                }
+            }
+            if (data.groom.cadence && !schema.validCadences.includes(data.groom.cadence)) {
+                warnings.push(`groom: invalid cadence '${data.groom.cadence}'`);
+            }
+        }
+        if (data.areas) {
+            for (const [areaName, area] of Object.entries(data.areas)) {
+                if (area.status && !schema.validAreaStatuses.includes(area.status)) {
+                    warnings.push(`area '${areaName}': invalid status '${area.status}'`);
+                }
+            }
+        }
+    }
+
+    if (warnings.length > 0) {
+        debugLog(`Validation warnings for ${surfaceName}:`, warnings);
+    }
+
+    return { valid: warnings.length === 0, warnings };
+}

package/src/skill/base.md

@@ -0,0 +1,110 @@
+---
+name: base
+type: suite
+version: 0.1.0
+category: workspace-orchestration
+description: "Builder's Automated State Engine — workspace lifecycle management for Claude Code. Scaffold, audit, groom, and maintain AI builder workspaces. Manage data surfaces for structured context injection. Use when user mentions workspace setup, cleanup, organization, maintenance, grooming, auditing workspace health, surfaces, or BASE."
+allowed-tools: [Read, Write, Glob, Grep, Edit, Bash, Agent, AskUserQuestion]
+---
+
+<activation>
+
+## What
+BASE (Builder's Automated State Engine) manages the lifecycle of a Claude Code workspace. It scaffolds new workspaces, audits existing ones, runs structured grooming cycles, and maintains workspace health through automated drift detection.
+
+## When to Use
+- User says "base", "workspace", "cleanup", "organize", "audit my workspace", "groom", "surface", "create a surface"
+- User wants to set up a new workspace from scratch
+- User wants to optimize or clean up an existing workspace
+- User asks about workspace health, staleness, or drift
+- Session start hook detects overdue grooming
+- User wants to review workspace evolution history
+
+## Not For
+- Project-level build orchestration (that's PAUL)
+- Session-level rule management (that's CARL)
+- Code quality auditing (that's AEGIS)
+- Skill/tool creation (that's Skillsmith)
+
+</activation>
+
+<persona>
+
+## Role
+Workspace operations engineer. Knows the territory, tracks what's drifting, enforces maintenance cadence. Tactical, not theoretical.
+
+## Style
+- Direct, structured, checklist-driven
+- Presents health dashboards and drift scores
+- Asks focused questions during grooming (voice-friendly)
+- Never skips areas — systematic coverage
+- Recommends, doesn't dictate
+
+## Expertise
+- Workspace architecture and file organization
+- Context document lifecycle (projects.json, state.json, entities.json)
+- Tool and configuration management
+- Drift detection and prevention patterns
+- Claude Code ecosystem (PAUL, CARL, AEGIS, Skillsmith integration)
+
+</persona>
+
+<commands>
+
+| Command | Description | Routes To |
+|---------|------------|-----------|
+| `/base:pulse` | Daily activation — workspace health briefing | `@{~/.qwen/commands/qwen-base/tasks/pulse.md}` |
+| `/base:groom` | Weekly maintenance cycle | `@{~/.qwen/commands/qwen-base/tasks/groom.md}` |
+| `/base:audit` | Deep workspace optimization | `@{~/.qwen/commands/qwen-base/tasks/audit.md}` |
+| `/base:scaffold` | Set up BASE in a new workspace | `@{~/.qwen/commands/qwen-base/tasks/scaffold.md}` |
+| `/base:status` | Quick health check (one-liner) | `@{~/.qwen/commands/qwen-base/tasks/status.md}` |
+| `/base:history` | Workspace evolution timeline | `@{~/.qwen/commands/qwen-base/tasks/history.md}` |
+| `/base:audit-claude-md` | Audit CLAUDE.md, generate recommended version | `@{~/.qwen/commands/qwen-base/tasks/audit-claude-md.md}` |
+| `/base:carl-hygiene` | CARL domain maintenance and rule review | `@{~/.qwen/commands/qwen-base/tasks/carl-hygiene.md}` |
+| `/base:surface create` | Create a new data surface (guided) | `@{~/.qwen/commands/qwen-base/tasks/surface-create.md}` |
+| `/base:surface convert` | Convert markdown file to data surface | `@{~/.qwen/commands/qwen-base/tasks/surface-convert.md}` |
+| `/base:surface list` | Show all registered surfaces | `@{~/.qwen/commands/qwen-base/tasks/surface-list.md}` |
+
+</commands>
+
+<routing>
+
+## Always Load
+- `@{~/.qwen/commands/qwen-base/context/base-principles.md}` — Core workspace management principles
+- `@{~/.qwen/commands/qwen-base/frameworks/audit-strategies.md}` — Reusable audit strategy definitions
+
+## Load on Command
+- `@{~/.qwen/commands/qwen-base/tasks/pulse.md}` — on `/base:pulse`
+- `@{~/.qwen/commands/qwen-base/tasks/groom.md}` — on `/base:groom`
+- `@{~/.qwen/commands/qwen-base/tasks/audit.md}` — on `/base:audit`
+- `@{~/.qwen/commands/qwen-base/tasks/scaffold.md}` — on `/base:scaffold`
+- `@{~/.qwen/commands/qwen-base/tasks/status.md}` — on `/base:status`
+- `@{~/.qwen/commands/qwen-base/tasks/history.md}` — on `/base:history`
+- `@{~/.qwen/commands/qwen-base/tasks/carl-hygiene.md}` — on `/base:carl-hygiene`
+- `@{~/.qwen/commands/qwen-base/tasks/surface-create.md}` — on `/base:surface create`
+- `@{~/.qwen/commands/qwen-base/tasks/surface-convert.md}` — on `/base:surface convert`
+- `@{~/.qwen/commands/qwen-base/tasks/surface-list.md}` — on `/base:surface list`
+
+## Load on Demand
+- `@{~/.qwen/commands/qwen-base/templates/workspace-json.md}` — When generating workspace.json
+- `@{~/.qwen/commands/qwen-base/frameworks/satellite-registration.md}` — When handling PAUL project registration
+
+</routing>
+
+<greeting>
+
+BASE loaded. Builder's Automated State Engine.
+
+Available commands:
+- `/base:pulse` — What's the state of my workspace?
+- `/base:groom` — Run weekly maintenance
+- `/base:audit` — Deep optimization session
+- `/base:scaffold` — Set up BASE in a new workspace
+- `/base:status` — Quick health check
+- `/base:history` — Workspace evolution timeline
+- `/base:surface create` — Create a new data surface
+- `/base:surface list` — Show registered surfaces
+
+What do you need?
+
+</greeting>

package/src/templates/operator.json

@@ -0,0 +1,66 @@
+{
+  "version": 1,
+  "last_updated": null,
+  "hook_active": true,
+  "operator": {
+    "entity_id": null,
+    "name": null
+  },
+  "deep_why": {
+    "layers": [
+      {
+        "level": 1,
+        "question": "Why do you do what you do?",
+        "answer": null
+      },
+      {
+        "level": 2,
+        "question": "But why does that matter?",
+        "answer": null
+      },
+      {
+        "level": 3,
+        "question": "But why?",
+        "answer": null
+      },
+      {
+        "level": 4,
+        "question": "Why does that drive you more than anything else?",
+        "answer": null
+      },
+      {
+        "level": 5,
+        "question": "If everything else was stripped away, what's left?",
+        "answer": null
+      }
+    ],
+    "statement": null,
+    "completed_at": null
+  },
+  "north_star": {
+    "metric": null,
+    "timeframe": null,
+    "rationale": null,
+    "completed_at": null
+  },
+  "key_values": {
+    "values": [],
+    "completed_at": null
+  },
+  "elevator_pitch": {
+    "pitch": null,
+    "floors": {
+      "floor_1": null,
+      "floor_2": null,
+      "floor_3": null,
+      "floor_4": null
+    },
+    "completed_at": null
+  },
+  "surface_vision": {
+    "scenes": [],
+    "summary": null,
+    "completed_at": null
+  },
+  "extensions": {}
+}

package/src/templates/workspace.json

@@ -0,0 +1,76 @@
+{
+  "workspace": "{workspace-name}",
+  "created": "{YYYY-MM-DD}",
+  "groom_cadence": "weekly",
+  "groom_day": "friday",
+  "areas": {
+    "working-memory": {
+      "type": "working-memory",
+      "description": "Core context documents that AI reads every session",
+      "paths": [
+        ".base/data/projects.json"
+      ],
+      "groom": "weekly",
+      "audit": {
+        "strategy": "staleness",
+        "config": {
+          "threshold_days": 7
+        }
+      }
+    },
+    "projects": {
+      "type": "directory",
+      "description": "Project documentation and planning",
+      "paths": [
+        "projects/"
+      ],
+      "groom": "monthly",
+      "audit": {
+        "strategy": "classify",
+        "config": {
+          "states": ["active", "archive", "delete"],
+          "archive_path": "projects/_archive/"
+        }
+      }
+    },
+    "tools": {
+      "type": "config-cross-ref",
+      "description": "MCP servers, personal tools, shareable tools",
+      "paths": [
+        "tools/"
+      ],
+      "groom": "monthly",
+      "audit": {
+        "strategy": "cross-reference",
+        "config": {
+          "config_file": ".mcp.json"
+        }
+      }
+    },
+    "system-layer": {
+      "type": "system-layer",
+      "description": "Claude Code commands, hooks, skills, CARL domains",
+      "paths": [
+        ".qwen/commands/",
+        ".qwen/hooks/",
+        ".qwen/skills/",
+        ".carl/"
+      ],
+      "groom": "monthly",
+      "audit": {
+        "strategy": "dead-code",
+        "config": {
+          "reference_check": true
+        }
+      }
+    }
+  },
+  "carl_hygiene": {
+    "proactive": true,
+    "cadence": "monthly",
+    "staleness_threshold_days": 60,
+    "max_rules_per_domain": 15,
+    "last_run": null
+  },
+  "satellites": {}
+}