@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 +32 -24
- package/docs/guides/agent-persona-setup.md +1 -1
- package/package.json +1 -1
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
|
-
|
|
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
|
|
96
|
-
6. Generates
|
|
97
|
-
7.
|
|
98
|
-
8.
|
|
99
|
-
9.
|
|
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
|
-
-
|
|
119
|
-
-
|
|
120
|
-
- `
|
|
121
|
-
-
|
|
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
|
|
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
|
-
|
|
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
|
-
|
|
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 `
|
|
600
|
+
| `scripts/local-triggers/plists/` | Launchd labels and paths | Low | Handled by `/init-maestro` Phase 3 (generate-plists.sh) |
|