@adaptic/maestro 1.1.1 → 1.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -263,13 +263,21 @@ Sections to rewrite:
263
263
  - **## Operating Principles** -- Replace with the new principles. Use the same numbered-list format.
264
264
  - **## Communication Rules** -- Adapt the autonomy model to the archetype. An executive-operator has broad autonomy; a compliance-officer escalates more. Rewrite the "sends autonomously" and "escalates" sections with the new agent's name and appropriate boundaries. Keep the Immediate Acknowledgement Rule, Document Sharing, and Logging subsections but replace the agent name throughout.
265
265
  - **## People (Key Leadership)** -- Update the "That's you" line to the new agent. Keep other people entries unless the user indicated changes.
266
+ - **## Control Towers** -- Replace the 12 generic org-wide control towers with 8-10 towers scoped to the agent's specific role and domain. Each tower should reflect what this agent actually monitors and manages. Generate towers based on archetype:
267
+ - **executive-operator**: Keep the original 12 org-wide towers (they are appropriate for this archetype).
268
+ - **technical-leader**: Model/platform architecture, R&D strategy, engineering quality, platform delivery, infrastructure & scalability, security & compliance, performance & benchmarking, team growth, systems & automation, self-governance.
269
+ - **commercial-leader**: Pipeline management, partnership development, investor relations, market intelligence, revenue operations, competitive analysis, client success, commercial governance, systems & automation, self-governance.
270
+ - **compliance-officer**: Regulatory submissions, licence management, policy framework, audit readiness, risk register, cross-jurisdiction compliance, legal obligations, reporting & disclosure, systems & automation, self-governance.
271
+ - **product-leader**: Product roadmap, user research & insights, feature delivery, design system, product-market fit, metrics & analytics, cross-functional alignment, stakeholder communication, systems & automation, self-governance.
272
+ - **operations-leader**: Process efficiency, fund operations, vendor management, capacity planning, organisational design, SLA compliance, cost management, operational resilience, systems & automation, self-governance.
273
+ Each tower should have a brief description of what it monitors (same format as the original: `**Name** — description`).
266
274
 
267
275
  Replace ALL instances of the old agent's first name with the new agent's first name throughout the entire CLAUDE.md file. Be thorough -- check every section header, bullet point, and inline reference.
268
276
 
269
277
  Do NOT modify these sections (keep them exactly as they are, except for agent name substitution):
270
278
  - Repository Layout, Key Config Files, Brand Assets, PDF Generation, Visual Media Generation
271
279
  - Source Repositories, Hiring Management (unless archetype is not executive-operator, in which case trim or adapt)
272
- - Operational Infrastructure, Control Towers 1-12
280
+ - Operational Infrastructure
273
281
  - Build & Test, Code Standards, Three Operating Modes, Parallel Execution
274
282
  - Agent Development, Workflow Development
275
283
 
package/README.md CHANGED
@@ -23,9 +23,7 @@ The package provides: framework scripts (poller, daemon, triggers, hooks, PDF an
23
23
  ```bash
24
24
  npx @adaptic/maestro create jacob-ai
25
25
  cd jacob-ai
26
- sudo npm run configure-macos # Auto-login, disable sleep, Parsec, Slack CDP
27
- npm run init-agent # Create directories, install launchd agents, configure Claude Code
28
- claude "/init-maestro" # Interactive identity and services wizard
26
+ claude "/init-maestro" # Handles everything: setup, identity, services, launchd
29
27
  ```
30
28
 
31
29
  ### Prerequisites
@@ -92,11 +90,14 @@ Scaffolds a new agent repository. This command:
92
90
  2. Copies all framework files (scripts, agents, workflows, policies, plugins, docs)
93
91
  3. Copies scaffold templates (CLAUDE.md and config/agent.ts stubs)
94
92
  4. Copies `.claude/` directory (settings and commands)
95
- 5. Creates 30+ agent-specific directories (config, knowledge, memory, state, logs, outputs)
96
- 6. Generates a `package.json` with all required scripts and dependencies
97
- 7. Copies `.env.example` and `.gitignore`
98
- 8. Initializes a git repository
99
- 9. Runs `npm install`
93
+ 5. Creates 57 agent-specific directories (config, knowledge, memory, state, logs, outputs, self-optimization, tests)
94
+ 6. Generates 53 operational template files (16 queues, 10 dashboards, 13 configs, 9 knowledge schemas, 5 self-optimization)
95
+ 7. Generates a `package.json` with all required scripts and dependencies
96
+ 8. Copies `.env.example` and `.gitignore`
97
+ 9. Initializes a git repository
98
+ 10. Runs `npm install`
99
+
100
+ After `create`, run `claude "/init-maestro"` to configure the agent's identity and bring it online. The wizard handles system bootstrap, identity configuration, service setup, launchd installation, and verification -- no other setup commands are needed.
100
101
 
101
102
  ### `npx @adaptic/maestro upgrade`
102
103
 
@@ -106,19 +107,25 @@ Updates framework files in an existing agent repo. This command copies the lates
106
107
  - `policies/` -- action classification, information barriers, prompt injection defence
107
108
  - `docs/` -- architecture, governance, runbooks
108
109
  - `public/assets/` -- brand assets
110
+ - `workflows/`, `schedules/`, `teams/`, `desktop-control/`, `ingest/`, `mcp/`
109
111
  - `.claude/commands/` -- slash commands
110
112
  - `plugins/maestro-skills/` -- operational skills
113
+ - `agents/` -- new agents are added, existing ones preserved (no deletions)
114
+
115
+ It also creates any missing directories from the expanded directory set.
111
116
 
112
117
  Agent-specific files (`config/`, `CLAUDE.md`, `knowledge/`, `memory/`, `state/`, `logs/`) are never touched.
113
118
 
114
119
  ### `npx @adaptic/maestro doctor`
115
120
 
116
- Verifies the agent installation. Checks for:
121
+ Verifies the agent installation. Checks for 16 essential files:
117
122
 
118
- - Essential files: `config/agent.ts`, `CLAUDE.md`, `.claude/settings.json`, `package.json`, setup scripts
119
- - Environment variables: `ANTHROPIC_API_KEY` (required), `SLACK_USER_TOKEN`, `GMAIL_APP_PASSWORD` (optional)
120
- - `node_modules` installation
121
- - Claude CLI availability
123
+ - Core: `config/agent.ts`, `CLAUDE.md`, `.claude/settings.json`, `.claude/commands/init-maestro.md`, `package.json`
124
+ - Setup: `scripts/setup/init-agent.sh`, `scripts/healthcheck.sh`, `scripts/daemon/maestro-daemon.mjs`, `scripts/local-triggers/generate-plists.sh`
125
+ - Config: `config/environment.yaml`, `config/contacts.yaml`, `config/priorities.yaml`, `config/sla-defaults.yaml`
126
+ - State: `state/dashboards/executive-summary.yaml`, `state/queues/action-stack.yaml`, `knowledge/decisions/decision-schema.yaml`
127
+ - Environment: `.env` file with `ANTHROPIC_API_KEY` (required), `SLACK_USER_TOKEN`, `GMAIL_APP_PASSWORD` (optional)
128
+ - Dependencies: `node_modules` installed, Claude CLI available
122
129
 
123
130
  ---
124
131
 
@@ -137,17 +144,18 @@ The `upgrade` command only updates framework infrastructure: scripts, policies,
137
144
 
138
145
  ## The /init-maestro Wizard
139
146
 
140
- After scaffolding, run `claude "/init-maestro"` to configure your agent's identity. The wizard runs in five phases:
141
-
142
- 1. **Identity gathering** -- Prompts for agent name, surname, title, archetype, email, phone, Mac mini hostname, principal (reporting line), responsibilities, communication style, and operating principles.
143
-
144
- 2. **Parallel file rewriting** -- Rewrites `config/agent.ts` with structured identity data, generates `CLAUDE.md` with the full behavioural charter, updates `config/environment.yaml` with paths and schedule, and adapts `schedules/triggers/*.md` with the new identity.
145
-
146
- 3. **macOS configuration** -- Updates launchd plist labels and paths, sets `package.json` name and description, and configures script variables.
147
-
148
- 4. **Third-party services** -- Walks through Slack, Gmail, Calendar, and optional integrations, writing credentials to `.env`.
147
+ After scaffolding, run `claude "/init-maestro"` to configure your agent. This is the only command you need -- it handles everything from system setup to identity configuration to bringing the agent online. The wizard runs in eight phases:
149
148
 
150
- 5. **Verification** -- Runs a health check to confirm all components are correctly configured.
149
+ | Phase | What it does |
150
+ |-------|-------------|
151
+ | **0. System Bootstrap** | Checks prerequisites (Node.js, npm, Claude CLI, jq), runs `npm install`, creates directories, installs global Claude Code settings, creates `.env` from template |
152
+ | **1. Identity Gathering** | Prompts for agent name, surname, title, archetype, email, phone, Mac mini hostname, principal (reporting line), responsibilities, communication style, operating principles |
153
+ | **2. Parallel Rewrite** | 8 sub-agents rewrite the repo in parallel: `config/agent.ts`, `CLAUDE.md`, config files, `package.json`, scripts, agent definitions, triggers/workflows, and agent-specific tools/skills |
154
+ | **3. Machine Config** | Generates launchd plists with the correct agent name, installs them, optionally configures macOS for headless 24/7 operation |
155
+ | **4. Service Setup** | Walks through Slack, Gmail, Twilio, Cloudflare, voice integration -- writing credentials to `.env` |
156
+ | **5. README** | Generates an agent-specific README.md |
157
+ | **6. GitHub Repo** | Optionally creates a GitHub repository and pushes the initial commit |
158
+ | **7. Verification** | Greps for stale references, validates `config/agent.ts`, runs healthcheck, prints summary |
151
159
 
152
160
  See [docs/guides/agent-persona-setup.md](docs/guides/agent-persona-setup.md) for the full persona configuration guide, including archetype defaults, Control Tower selection, contact classification, and manual fine-tuning.
153
161
 
@@ -173,7 +181,7 @@ Additional services are available via MCP servers and can be configured separate
173
181
 
174
182
  ### Environment Variables
175
183
 
176
- After running `npm run init-agent`, fill in the generated `.env` file:
184
+ The `/init-maestro` wizard creates the `.env` file and walks you through filling in credentials. Key variables:
177
185
 
178
186
  ```bash
179
187
  # Core
@@ -597,4 +597,4 @@ The 5-layer defence is universal and should not be weakened. The only customisat
597
597
  | `memory/profiles/channels/` | Channel tone and rules | Low | Builds up over time through interaction |
598
598
  | `config/brand-assets.yaml` | Usually unchanged | Low | Only change if agent serves a different brand |
599
599
  | `package.json` | Name and description | Low | Update to reflect new agent identity |
600
- | `scripts/local-triggers/plists/` | Launchd labels and paths | Low | Handled by `npm run init-agent` |
600
+ | `scripts/local-triggers/plists/` | Launchd labels and paths | Low | Handled by `/init-maestro` Phase 3 (generate-plists.sh) |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@adaptic/maestro",
3
- "version": "1.1.1",
3
+ "version": "1.1.3",
4
4
  "description": "Maestro — Autonomous AI agent operating system. Deploy AI employees on dedicated Mac minis.",
5
5
  "type": "module",
6
6
  "bin": {