Skip to content

docs: stage 72 contracts for proof signing key, tool catalog, and n8n response bodies - #98

Closed
cursor[bot] wants to merge 1 commit into
devfrom
cursor/suggestions-folder-structure-a79c
Closed

cursor[bot] wants to merge 1 commit into
devfrom
cursor/suggestions-folder-structure-a79c

Conversation

@cursor

@cursor cursor Bot commented Nov 8, 2026

Copy link
Copy Markdown

Summary

Stage 72 website contracts for three defects checked on 2026-11-08. They do not restate Stages 1–71.

  • generate_secrets leaves MCP_PROOF_SIGNING_KEY=CHANGE_ME_PROOF_HMAC, and scripts/rollout-gates.sh does not check signature.
  • GET /tools returns 503 and an empty list when AFFiNE has no login, so n8n and knowledge-base schemas are dropped.
  • N8nApi.request turns a 200 plain-text body, an empty 200, and a 204 into 502.

Scope

Docs only. New pages under suggestions/website/. Hub files scanned by the docs-link workflow are unchanged.

Release notes (maintainers)

documentation

Security & RFC

  • Does not expose secrets, tokens, or production .env values in repo or CI logs.
  • Control-plane / nginx allowlist behavior unchanged unless intentional and documented.
  • Breaking operational behavior called out in README or playbooks where operators would notice.

Verification

  • set -a; . ./env.example; set +a; ./scripts/pre-push-check.sh (missing TLS and allowlist warnings, suite passed)
  • git diff --check
  • Relative links and website frontmatter checked for the four new pages
  • Same-shape replays for the proof-key sed, the /tools early return, and the n8n JSON parser. .env was not created. n8n and AFFiNE were not contacted.
Open in Web View Automation 

… response bodies

Record three verified defects as publishable website pages: the public proof HMAC placeholder, GET /tools dropping n8n and knowledge-base schemas when AFFiNE has no login, and N8nApi.request treating plain-text success bodies as 502.

Co-authored-by: Sebastian Becker <Beckastian@users.noreply.github.com>
@Beckastian Beckastian closed this Nov 13, 2026
@Beckastian
Beckastian deleted the cursor/suggestions-folder-structure-a79c branch November 13, 2026 13:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants