@adaptic/maestro 1.0.1 → 1.1.1

package/bin/maestro.mjs

@@ -114,6 +114,7 @@ function create(targetName) {
   const agentDirs = [
     "config",
     "knowledge/decisions",
+    "knowledge/decisions/archive",
     "knowledge/entities",
     "knowledge/memory",
     "knowledge/sources",
@@ -122,18 +123,30 @@ function create(targetName) {
     "memory/profiles/users",
     "memory/profiles/channels",
     "memory/precedents",
+    "memory/precedents/market-signals",
     "memory/indexes",
     "memory/templates",
     "state/inbox/slack",
     "state/inbox/gmail",
     "state/inbox/calendar",
     "state/inbox/sms",
+    "state/inbox/whatsapp",
     "state/inbox/internal",
+    "state/inbox/attachments",
+    "state/inbox/processed",
     "state/queues",
     "state/dashboards",
     "state/polling",
     "state/locks/outbound",
     "state/triggers/priority",
+    "state/handoffs",
+    "state/huddle",
+    "state/indexes",
+    "state/rag",
+    "state/sessions",
+    "state/slack-responded",
+    "state/slack-thread-tracker",
+    "state/tmp",
     "outputs/briefs",
     "outputs/drafts",
     "outputs/memos",
@@ -148,6 +161,14 @@ function create(targetName) {
     "logs/evolution",
     "logs/huddle",
     "logs/daemon",
+    "logs/infra",
+    "logs/monitor",
+    "logs/phone",
+    "logs/sms",
+    "logs/whatsapp",
+    "logs/email",
+    "self-optimization/scenarios",
+    "tests",
   ];
 
   for (const dir of agentDirs) {
@@ -155,6 +176,392 @@ function create(targetName) {
   }
   ok(`${agentDirs.length} agent directories`);
 
+  // ── Step 3b: Generate template files ───────────────────────────────────
+  // These are empty-but-structured templates that define the operational
+  // schema for queues, dashboards, knowledge, and config. Without them,
+  // workflows and triggers have nothing to read/write.
+
+  log("Generating operational templates...");
+
+  // Queue templates — 16 operational queues
+  const queueTemplates = {
+    "action-stack": "Active action items requiring attention or follow-through",
+    "decision-queue": "Key decisions awaiting principal input or closure",
+    "follow-ups": "Commitments to external parties with due dates",
+    "awaiting-reply": "Messages sent that are awaiting responses",
+    "awaiting-approval": "Items pending principal or stakeholder approval",
+    "blocked-initiatives": "Strategic initiatives blocked by dependencies",
+    "high-risk-items": "Items with elevated risk requiring close monitoring",
+    "upcoming-deadlines": "Time-sensitive items with approaching deadlines",
+    "relationship-health": "Relationship maintenance and engagement tracking",
+    "hiring-critical-path": "Critical hiring actions and pipeline blockers",
+    "platform-blockers": "Technical and platform issues blocking delivery",
+    "capital-watchpoints": "Financial and fundraising items requiring attention",
+    "legal-obligations": "Regulatory submissions and legal compliance deadlines",
+    "narrative-opportunities": "Strategic narrative and thought leadership opportunities",
+    "tech-debt": "Technical debt with strategic impact",
+    "improvement-backlog": "Self-improvement and operational enhancement candidates",
+  };
+
+  for (const [name, desc] of Object.entries(queueTemplates)) {
+    const content = `queue_name: ${name}\ndescription: ${desc}\nitems: []\n`;
+    writeFileSync(join(targetDir, `state/queues/${name}.yaml`), content);
+  }
+  ok(`${Object.keys(queueTemplates).length} queue templates`);
+
+  // Dashboard templates — 10 operational dashboards
+  const dashboardTemplates = {
+    "executive-summary": {
+      description: "Primary situational awareness — read at every session start",
+      fields: "generated: null\nsummary:\n  total_open_items: 0\n  critical_items: 0\n  overdue_items: 0\n  sla_breaches: 0\n  items_resolved_today: 0\n  items_created_today: 0\nqueue_health: {}\ntop_priorities: []\ntop_blockers: []\n",
+    },
+    "daemon-health": {
+      description: "System health metrics for the daemon and triggers",
+      fields: "status: initialising\nlast_check: null\ntrigger_health: {}\npoller_health: {}\n",
+    },
+    "strategy-scorecard": {
+      description: "Progress on strategic priorities and quarterly OKRs",
+      fields: "generated: null\npriorities: []\ninitiatives: []\n",
+    },
+    "risk-register": {
+      description: "Enterprise risk register with severity and mitigation",
+      fields: "generated: null\nrisks: []\n",
+    },
+    "engineering-health": {
+      description: "Per-repo engineering activity, PRs, delivery confidence",
+      fields: "generated: null\nrepositories: []\ndelivery_confidence: null\n",
+    },
+    "org-health": {
+      description: "Hiring pipeline, capability gaps, structural risks",
+      fields: "generated: null\nhiring_pipeline: {}\ncapability_gaps: []\n",
+    },
+    "leadership-accountability": {
+      description: "Per-leader commitment follow-through tracking",
+      fields: "generated: null\nleaders: []\n",
+    },
+    "relationship-pipeline": {
+      description: "Strategic relationships with stage and warmth tracking",
+      fields: "generated: null\nrelationships: []\n",
+    },
+    "capital-readiness": {
+      description: "Runway, fundraising readiness, investor pipeline",
+      fields: "generated: null\nrunway_months: null\nreadiness_score: null\npipeline: []\n",
+    },
+    "system-health": {
+      description: "Self-governance metrics — evolution, coverage, queue health",
+      fields: "generated: null\nevolution_changes: 0\nknowledge_coverage: null\ntrigger_reliability: null\n",
+    },
+  };
+
+  for (const [name, { description, fields }] of Object.entries(dashboardTemplates)) {
+    const content = `# ${name.replace(/-/g, " ").replace(/\b\w/g, c => c.toUpperCase())} Dashboard\n# ${description}\n\n${fields}`;
+    writeFileSync(join(targetDir, `state/dashboards/${name}.yaml`), content);
+  }
+  ok(`${Object.keys(dashboardTemplates).length} dashboard templates`);
+
+  // Config templates — operational config files
+  log("Generating config templates...");
+
+  const configTemplates = {
+    "environment.yaml": `# Environment Configuration
+# All environment-specific values — actual secrets are in .env
+# Agent identity is defined in config/agent.ts
+
+system:
+  name: maestro
+  version: 1.0.0
+  operator_persona: "UNCONFIGURED"
+  operator_role: "UNCONFIGURED"
+  company: ""
+  ceo: ""
+  timezone: UTC
+
+machine:
+  type: mac-mini
+  os: macOS
+  hostname: \${HOSTNAME}
+  purpose: Autonomous agent operations node
+
+paths:
+  agent_home: ~/${targetName}
+  logs: ~/${targetName}/logs
+  outputs: ~/${targetName}/outputs
+`,
+    "contacts.yaml": `# Key Contacts
+# Communication classifications and relationship context
+# Updated by: init-maestro wizard, agent interactions
+
+contacts: []
+
+# Classification levels:
+# - internal: team members, direct reports
+# - external-trusted: partners, advisors, board members
+# - external-standard: vendors, candidates, general contacts
+# - regulatory: regulators, legal counterparties
+`,
+    "priorities.yaml": `# Active Strategic Priorities
+# Updated by: weekly-priorities workflow, principal directive
+# Read by: morning-brief, backlog-executor, strategy-scorecard
+
+priorities: []
+
+# Priority format:
+# - id: P1
+#   title: Priority title
+#   status: active | paused | completed
+#   owner: principal | agent
+#   milestones: []
+#   deadline: null
+`,
+    "sla-defaults.yaml": `# SLA Defaults — response time expectations by item type
+# Used by: inbox-processor, meeting-action-capture, midday-sweep
+
+sla_defaults:
+  principal_request: 4
+  leadership_request: 24
+  external_partner: 48
+  regulatory: 24
+  candidate: 24
+  board_member: 12
+  investor: 24
+  general: 72
+
+thresholds:
+  at_risk_percent: 75
+  breach_percent: 100
+
+drift_thresholds:
+  critical_priority: 7
+  medium_priority: 14
+  low_priority: 30
+`,
+    "brand-assets.yaml": `# Brand Assets Configuration
+# Official brand assets, design system, and usage rules
+# Assets directory: public/assets/
+
+asset_inventory:
+  icon_dark: public/assets/adaptic-icon-dark.svg
+  icon_light: public/assets/adaptic-icon-light.svg
+  logo_dark: public/assets/adaptic-logo-dark.svg
+  logo_light: public/assets/adaptic-logo-light.svg
+
+usage_rules:
+  dark_variants: "Use on light/white backgrounds"
+  light_variants: "Use on dark backgrounds"
+  full_logo: "Cover pages, document headers, title slides"
+  icon_only: "Footers, watermarks, compact placements"
+  never: "stretch, rotate, recolour, or modify the assets"
+`,
+    "repo-registry.yaml": `# Source Repository Registry
+# Cross-repository map for codebase awareness
+# Updated by: init-maestro wizard
+
+repositories: []
+
+# Format:
+# - name: repo-name
+#   path: ~/repo-name
+#   purpose: What this repo contains
+#   domains: [domain1, domain2]
+`,
+    "slack-channels.yaml": `# Slack Channel Configuration
+# Which channels the agent monitors and their purpose
+# Updated by: init-maestro wizard
+
+channels: []
+
+# Format:
+# - id: C0XXXXX
+#   name: channel-name
+#   purpose: What this channel is for
+#   monitor: true | false
+#   respond: true | false
+`,
+    "tooling-map.yaml": `# Tooling Map
+# Maps responsibilities to available tools and scripts
+# Generated by: init-maestro sub-agent 8
+
+tools: []
+`,
+    "validation-rules.yaml": `# Outbound Correspondence Validation Rules
+# Used by: scripts/validate-outbound.py
+# Purpose: Pre-send gate to prevent factual inaccuracies and protocol violations
+
+relationship_claims:
+  enabled: true
+  severity: block
+  patterns: []
+
+ai_disclosure:
+  enabled: true
+  severity: block
+  blocked_phrases:
+    - "I am an AI"
+    - "as an AI"
+    - "I'm an artificial intelligence"
+    - "language model"
+
+tone_violations:
+  enabled: true
+  severity: warn
+  rules: []
+`,
+    "mcp-integrations.yaml": `# MCP Server Integration Configuration
+# Which MCP services this agent connects to
+# Updated by: init-maestro wizard
+
+integrations:
+  slack: { enabled: false, notes: "Configure via .env" }
+  gmail: { enabled: false, notes: "Configure via .env" }
+  calendar: { enabled: false, notes: "Configure via .env" }
+`,
+    "mcp-servers.json": `{}`,
+    "caller-id-map.yaml": `# Caller ID Map
+# Maps phone numbers to known contacts for SMS/voice identification
+# Updated by: agent interactions
+
+contacts: {}
+`,
+    "hiring.yaml": `# Hiring Configuration
+# Pipeline settings, screening rules, and template references
+# Updated by: init-maestro wizard (for executive-operator / operations-leader archetypes)
+
+enabled: false
+roles: []
+screening:
+  auto_advance_threshold: 75
+  auto_reject_threshold: 40
+  review_band: [40, 75]
+`,
+  };
+
+  for (const [filename, content] of Object.entries(configTemplates)) {
+    const dest = join(targetDir, `config/${filename}`);
+    if (!existsSync(dest)) {
+      writeFileSync(dest, content);
+    }
+  }
+  ok(`${Object.keys(configTemplates).length} config templates`);
+
+  // Knowledge templates — schemas and empty indexes
+  log("Generating knowledge templates...");
+
+  const knowledgeTemplates = {
+    "decisions/decision-schema.yaml": `# Decision Record Schema
+# Format: DEC-YYYY-MM-DD-NNN
+# See docs for full schema documentation
+
+schema:
+  version: "1.0"
+  fields:
+    id: { type: string, format: "DEC-YYYY-MM-DD-NNN", required: true }
+    date: { type: date, format: "YYYY-MM-DD", required: true }
+    title: { type: string, required: true }
+    domain: { type: string, required: true }
+    decision_maker: { type: string, required: true }
+    decision_text: { type: string, required: true }
+    context: { type: string, required: true }
+    rationale: { type: string, required: true }
+    status: { type: string, enum: [active, superseded, reversed, completed], default: active }
+`,
+    "decisions/index.yaml": `# Decision Index
+# Auto-maintained by decision-log agent
+
+decisions: []
+`,
+    "entities/entity-map.yaml": `# Entity Map
+# All contacts, companies, regulators, advisors
+# De-duplication rules and relationship mapping
+
+entities: []
+`,
+    "entities/org-chart.md": `# Organisation Chart
+
+*Configure via /init-maestro*
+`,
+    "sources/source-registry.yaml": `# Authoritative Source Registry
+# Central registry of all information sources
+
+sources: {}
+`,
+    "sources/blocker-playbooks.yaml": `# Blocker Resolution Playbooks
+# Common blocker patterns and resolution strategies
+
+playbooks: []
+`,
+    "syntheses/strategy-state.yaml": `# Living Strategy State
+# Evolves weekly with strategic position, assumptions, risks, signals
+
+last_updated: null
+strategic_position: ""
+key_assumptions: []
+active_risks: []
+market_signals: []
+`,
+    "syntheses/README.md": `# Knowledge Syntheses
+
+Strategic syntheses generated by domain agents. Updated weekly.
+`,
+    "memory/executive-memory.yaml": `# Executive Memory
+# Institutional memory for strategic context
+
+entries: []
+`,
+  };
+
+  for (const [path, content] of Object.entries(knowledgeTemplates)) {
+    writeFileSync(join(targetDir, `knowledge/${path}`), content);
+  }
+  ok(`${Object.keys(knowledgeTemplates).length} knowledge templates`);
+
+  // Self-optimization templates
+  const selfOptTemplates = {
+    "program.md": `# Self-Optimization Program
+
+This agent evolves its own operating setup through structured experimentation.
+Changes are classified by risk: low (auto-apply), medium (apply + notify), high (escalate).
+`,
+    "experiment-log.yaml": `# Experiment Log
+experiments: []
+`,
+    "failure-patterns.yaml": `# Failure Patterns
+# Recurring failure modes and mitigations
+patterns: []
+`,
+    "metric-snapshots.yaml": `# Metric Snapshots
+# Periodic captures of operational metrics
+snapshots: []
+`,
+    "scoring-rubrics.yaml": `# Scoring Rubrics
+# Evaluation criteria for self-assessment
+rubrics: []
+`,
+  };
+
+  for (const [filename, content] of Object.entries(selfOptTemplates)) {
+    writeFileSync(join(targetDir, `self-optimization/${filename}`), content);
+  }
+  ok(`${Object.keys(selfOptTemplates).length} self-optimization templates`);
+
+  // .gitkeep files for empty directories that git would otherwise ignore
+  const gitkeepDirs = [
+    "state/handoffs", "state/huddle", "state/indexes", "state/rag",
+    "state/sessions", "state/slack-responded", "state/slack-thread-tracker",
+    "state/tmp", "state/inbox/attachments", "state/inbox/processed",
+    "state/inbox/whatsapp", "memory/precedents/market-signals",
+    "knowledge/decisions/archive", "tests",
+    "logs/infra", "logs/monitor", "logs/phone", "logs/sms",
+    "logs/whatsapp", "logs/email", "self-optimization/scenarios",
+  ];
+
+  for (const dir of gitkeepDirs) {
+    const keepFile = join(targetDir, dir, ".gitkeep");
+    if (!existsSync(keepFile)) {
+      writeFileSync(keepFile, "");
+    }
+  }
+  ok(".gitkeep files for empty directories");
+
   // ── Step 4: Generate package.json ───────────────────────────────────────
 
   log("Generating package.json...");
@@ -247,9 +654,10 @@ function create(targetName) {
   console.log("║                                                              ║");
   console.log("║  Next steps:                                                 ║");
   console.log(`║  1. cd ${targetName.padEnd(51)}║`);
-  console.log("║  2. sudo npm run configure-macos                             ║");
-  console.log("║  3. npm run init-agent                                       ║");
-  console.log('║  4. claude "/init-maestro"                                   ║');
+  console.log('║  2. claude "/init-maestro"                                   ║');
+  console.log("║                                                              ║");
+  console.log("║  The wizard handles everything: system setup, identity,      ║");
+  console.log("║  service configuration, launchd, and verification.           ║");
   console.log("║                                                              ║");
   console.log("╚══════════════════════════════════════════════════════════════╝");
   console.log();
@@ -269,7 +677,11 @@ function upgrade() {
 
   log("Upgrading framework files from @adaptic/maestro...");
 
-  const frameworkDirs = ["scripts", "policies", "docs", "public/assets"];
+  // Framework directories that get overwritten on upgrade
+  const frameworkDirs = [
+    "scripts", "policies", "docs", "public/assets",
+    "workflows", "schedules", "desktop-control", "ingest", "mcp",
+  ];
 
   let updated = 0;
   for (const dir of frameworkDirs) {
@@ -281,6 +693,7 @@ function upgrade() {
     }
   }
 
+  // .claude/commands (NOT settings.json — that's agent-specific)
   const commandsSrc = join(MAESTRO_ROOT, ".claude", "commands");
   if (existsSync(commandsSrc)) {
     cpSync(commandsSrc, join(cwd, ".claude", "commands"), { recursive: true, force: true });
@@ -288,6 +701,7 @@ function upgrade() {
     updated++;
   }
 
+  // Plugins
   const pluginSrc = join(MAESTRO_ROOT, "plugins", "maestro-skills");
   if (existsSync(pluginSrc)) {
     cpSync(pluginSrc, join(cwd, "plugins", "maestro-skills"), { recursive: true, force: true });
@@ -295,6 +709,42 @@ function upgrade() {
     updated++;
   }
 
+  // Agent definitions (merge: add new agents, update existing, don't delete custom ones)
+  const agentsSrc = join(MAESTRO_ROOT, "agents");
+  if (existsSync(agentsSrc)) {
+    cpSync(agentsSrc, join(cwd, "agents"), { recursive: true, force: false });
+    ok("agents (merged, custom agents preserved)");
+    updated++;
+  }
+
+  // Teams
+  const teamsSrc = join(MAESTRO_ROOT, "teams");
+  if (existsSync(teamsSrc)) {
+    cpSync(teamsSrc, join(cwd, "teams"), { recursive: true, force: true });
+    ok("teams");
+    updated++;
+  }
+
+  // Create any missing directories from the expanded list
+  const ensureDirs = [
+    "state/handoffs", "state/huddle", "state/indexes", "state/rag",
+    "state/sessions", "state/slack-responded", "state/slack-thread-tracker",
+    "state/tmp", "state/inbox/whatsapp", "state/inbox/attachments",
+    "state/inbox/processed", "memory/precedents/market-signals",
+    "knowledge/decisions/archive", "self-optimization/scenarios", "tests",
+    "logs/infra", "logs/monitor", "logs/phone", "logs/sms",
+    "logs/whatsapp", "logs/email",
+  ];
+  let newDirs = 0;
+  for (const dir of ensureDirs) {
+    const dirPath = join(cwd, dir);
+    if (!existsSync(dirPath)) {
+      mkdirSync(dirPath, { recursive: true });
+      newDirs++;
+    }
+  }
+  if (newDirs > 0) ok(`Created ${newDirs} new directories`);
+
   console.log();
   ok(`Upgraded ${updated} framework components.`);
   log("Agent-specific files (config/, CLAUDE.md, knowledge/, memory/) were NOT modified.");
@@ -316,6 +766,13 @@ function doctor() {
     "config/agent.ts", "CLAUDE.md", ".claude/settings.json",
     ".claude/commands/init-maestro.md", "package.json",
     "scripts/setup/init-agent.sh", "scripts/healthcheck.sh",
+    "config/environment.yaml", "config/contacts.yaml",
+    "config/priorities.yaml", "config/sla-defaults.yaml",
+    "scripts/daemon/maestro-daemon.mjs",
+    "scripts/local-triggers/generate-plists.sh",
+    "state/dashboards/executive-summary.yaml",
+    "state/queues/action-stack.yaml",
+    "knowledge/decisions/decision-schema.yaml",
   ];
 
   for (const file of essentialFiles) {
@@ -377,9 +834,7 @@ Usage:
 Workflow:
   1. npx @adaptic/maestro create my-agent
   2. cd my-agent
-  3. sudo npm run configure-macos
-  4. npm run init-agent
-  5. claude "/init-maestro"
+  3. claude "/init-maestro"
 `);
     break;
   default: