unic / unic/unic-agents-plugins

bug(unic-archon-dlc): Confluence publishing fails silently, asks for permission it has, and does not update

Open
#445 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

app:unic-archon-dlc bug needs-specs p2
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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.