unic / unic/unic-agents-plugins
bug(unic-archon-dlc): Confluence publishing fails silently, asks for permission it has, and does not update
Nobody has claimed this yet.
- Dominant language
- JavaScript
- Stars
- 1
- Forks
- 0
- Avg merge
- 16h 43m
- Merged PRs (30d)
- 19
Description
Four defects, one surface
1. The write path fails silently on escaping. createConfluencePage accepted HTML entities where raw tags were needed, published them as literal visible markup, and returned a success payload with no validation error. The page was only repaired because the run read its own response body. Both runs hit this.
2. It asks permission for what the config already granted. The Consumer sets docs.publish: true, and the run still stopped to ask whether to publish. That is one of only four halts in the /specs leg, and it bought nothing.
3. Contract changes in git do not reach Confluence. When publish is true and a contract is regenerated, the page should update. Today it does not.
4. Run 1 published no component pages at all, despite docs.publish: true. Design System Components (973276506) had no descendants before run 2 published three. Measured before publishing, so it cannot be re-verified now — the pages are there.
Why 4 is the serious one
A publish step that silently does nothing, while configured to publish, is the same class as a review node that records nothing: the run looks identical whether it worked or not.
The open question
Should publish be a step that can fail loudly, and what does it verify after writing — that the page exists, that its body is what was sent, or neither?
Full evidence: docs/research/2026-08-31-dlc-run-2-findings.md.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with docs/research/2026-08-31-dlc-run-2-findings.md, then locate createConfluencePage and the publish step that handles docs.publish. Trace the write response and regeneration path; done should include loud validation failures, no redundant permission halt, updates to existing contract pages, and publication of component pages when configured.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- javascript
- Domain
- documentation
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Needs clarification
- Newbie friendliness
- 35/100