opensymphony 1.3.2

A Rust implementation of the OpenAI Symphony orchestration design
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

# OpenSymphony 1.0.0 Migration Guide

OpenSymphony 1.0.0 is the breaking release that removes the old agent-side
Linear bridge layer and standardizes AI PR review configuration.

## Breaking changes

### 1. `openhands.mcp` was removed

Older target repos may still contain workflow config like:

```yaml
openhands:
  mcp:
    ...
```

That block is no longer supported.

What to do instead:

- remove the `openhands.mcp` section
- ensure `LINEAR_API_KEY` is available in the target repo environment
- use the repo-local `.agents/skills/linear/` helper, query files, and
  references copied by `opensymphony init`

The workflow loader now fails fast with a migration error when it sees the
removed field.

### 2. The old bridge CLI entrypoint is gone

Removed command:

```bash
opensymphony linear-mcp
```

There is no replacement bridge process. Agent-side Linear operations now run
through checked-in GraphQL assets inside the target repo.

### 3. AI review secrets are provider-agnostic

Old secret naming tied the workflow too closely to one inference provider.

Use this secret name now:

- `AI_REVIEW_API_KEY`

Supported variables:

- `AI_REVIEW_PROVIDER_KIND`
- `AI_REVIEW_MODEL_ID`
- `AI_REVIEW_BASE_URL`
- `AI_REVIEW_STYLE`
- `AI_REVIEW_REQUIRE_EVIDENCE`

`FIREWORKS_API_KEY` is no longer part of the supported configuration.

## Upgrade checklist

1. Upgrade to OpenSymphony 1.0.0.
2. Re-run `opensymphony init` in target repos that still carry older generated
   assets.
3. Remove any `openhands.mcp` config from repo workflows.
4. Set `LINEAR_API_KEY` for target repos that need Linear access.
5. Update GitHub Actions secrets and variables for AI review:
   - secret: `AI_REVIEW_API_KEY`
   - variables: provider/model/base URL/style/evidence
6. Run:

```bash
cargo test
cargo test --test init
```

## Smoke checks

After migration:

- `opensymphony --help` should not list the removed bridge command
- `opensymphony init` should copy the full `.agents/skills/linear/` tree
- this helper should work from the target repo:

```bash
python3 .agents/skills/linear/scripts/linear_graphql.py \
  --query-file .agents/skills/linear/queries/viewer.graphql
```