@adaptic/maestro 1.1.1 → 1.1.2

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.
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.2",
4
4
  "description": "Maestro — Autonomous AI agent operating system. Deploy AI employees on dedicated Mac minis.",
5
5
  "type": "module",
6
6
  "bin": {