Skip to content

docs(clade): uuid follows the forge path, it is not immortal - #100

Merged
hyperpolymath merged 1 commit into
mainfrom
chore/uuid-not-immortal
Nov 11, 2026
Merged

hyperpolymath merged 1 commit into
mainfrom
chore/uuid-not-immortal

Conversation

@hyperpolymath

Copy link
Copy Markdown
Owner

Summary

Comment-only correction. The CLADE status comment said the uuid is immortal. gv-clade-index ADR 0007 (accepted 2026-11-10) makes the uuid follow the forge path: a move or rename mints a new one, and a phase change never does.

.machine_readable/CLADE.a2ml: "uuid is immortal" → "uuid follows the forge path (a move or rename mints a new one, gv-clade-index ADR 0007; a phase change never does)"; "A rename is NOT a phase change" → "A prefixed-name (clade code) change is NOT a phase change". Comment paragraph re-wrapped at 80 columns. No data value changes.

Checks

  • git diff --check — clean
  • just validate, just test-static, Idris2/Zig builds — not run locally; comment-only change in .machine_readable/CLADE.a2ml, left to CI

Skipped checks and reason: no code, ABI, binding or proof changed.

Safety and compatibility

  • No secrets or credentials are included.
  • File-level SPDX identifiers and third-party license notices are preserved.
  • No container image is built, signed, pushed, or deployed by this change.

Remaining risks / follow-up

None; comment text only.


Generated by Claude Code

Comment-only correction. The CLADE status comment written by
clade-status-backfill (gv-clade-index ADR 0006) said the uuid is
immortal. gv-clade-index ADR 0007, accepted 2026-11-10, makes the uuid
follow the forge path: a move or rename mints a new one, and a phase
change never does. The same comment's "A rename is NOT a phase change"
now says "A prefixed-name (clade code) change", the rename it means, so
the two sentences no longer read as a contradiction. No data value
changes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0136P7ZmtCj9Doze7s38qbz5
@coderabbitai

coderabbitai Bot commented Nov 10, 2026 •

Copy link
Copy Markdown

Explain Change →

No actionable comments were generated in the recent review.

Summary

Summary by CodeRabbit

  • Documentation
    • Clarified how identifiers behave when an item is moved or renamed: moving or renaming it creates a new identifier.
    • Clarified that changing an item’s prefixed name does not change its phase or identifier; the previous name is retained as an alias.

The lifecycle comment now describes UUID behaviour for forge moves, renames, and prefixed-name changes.

Changes: Lifecycle comment clarification

Layer / File(s) Summary
Lifecycle comment update
.machine_readable/CLADE.a2ml
The comment states that a move or rename mints a new UUID. A prefixed-name change keeps the UUID and phase unchanged and adds the old name to aliases[].

Estimated code review effort: 1 (Trivial) | ~3 minutes

Change: Other

Merge Risk: Minimal · up to 6fca5

No PR-introduced merge-blocking risk is established. The reported hygiene failure includes pre-existing debt markers.

Pre-merge checks: Passed 4

Check name Status Explanation
Title check Passed The title clearly identifies the documentation change and the UUID lifecycle clarification.
Description check Passed The description explains the change, lists checks and skipped checks with reasons, and covers safety and remaining risks. It omits the template’s “Scope and evidence” and “Documentation and metadata” …
Linked Issues check Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check Passed Check skipped because no linked issues were found for this pull request.
Full details: Description check

Explanation

The description explains the change, lists checks and skipped checks with reasons, and covers safety and remaining risks. It omits the template’s “Scope and evidence” and “Documentation and metadata” sections, but provides enough relevant information for this comment-only change.

  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

Recent review info

Run configuration

  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: Organization UI
  • Review profile: ASSERTIVE
  • Plan: Advanced
  • Run ID: f897d8ed-773d-455d-a5f6-80745dd5ca71
Commits

Reviewing files that changed from the base of the PR and between ebc440f and 6fca5e1.

Files selected for processing: 1

  • .machine_readable/CLADE.a2ml

Included review availability: This review used your included allowance. Your plan provides up to 1 included review per hour; 0 remain after this review.

Recent review details

Context from checks skipped due to timeout: 4

  • GitHub Check: CodeRabbit
  • GitHub Check: Selected Idris2 and Zig package tests
  • GitHub Check: Hypatia Neurosymbolic Analysis
  • GitHub Check: semgrep-cloud-platform/scan
CI failures not shown inline: 3

GitHub Actions: Central Estate CI/CD Audit / 0_estate-audit.txt: docs(clade): uuid follows the forge path, it is not immortal

Conclusion: failure

View job details

##[group]Run # Accepted placements widened per owner ruling 2026-09-19: estate
 �[36;1m# Accepted placements widened per owner ruling 2026-09-19: estate�[0m
 �[36;1m# repos legitimately keep governance docs under docs/ (and GitHub�[0m
 �[36;1m# renders under .github/) — rsr-template-repo itself was failing on�[0m
 �[36;1m# layout, not on substance. Root forms still win (first hit).�[0m
 �[36;1m# Template-repo mode: see below.�[0m
 �[36;1m#�[0m
 �[36;1m# Presence-only checking rewards filler. This gate previously demanded�[0m
 �[36;1m# ARCHITECTURE.md / MAINTAINERS.adoc / GOVERNANCE.md and checked only�[0m
 �[36;1m# that the paths existed — so the cheapest way to pass was to commit�[0m
 �[36;1m# template boilerplate. That happened: an estate repo acquired an�[0m
 �[36;1m# ARCHITECTURE.md describing a directory layout it does not have, a�[0m
 �[36;1m# MAINTAINERS naming a different account as owner, and a mise.toml�[0m
 �[36;1m# pinning `zig = "latest"` against that repo's own .tool-versions.�[0m
 �[36;1m# All three would have passed. So: presence, THEN format, THEN substance.�[0m
 �[36;1m#�[0m
 �[36;1m# Format policy (estate):�[0m
 �[36;1m#   .adoc  documentation (default)�[0m
 �[36;1m#   .md    wiki content only — plus a transitional allowance for the�[0m
 �[36;1m#          GitHub-mandated files, which are migrating to berrywiki format�[0m
 �[36;1m#   .txt   licence texts�[0m
 �[36;1m#   fixed  names GitHub or convention dictates (CODEOWNERS, funding.yml,�[0m
 �[36;1m#          NOTICE, AUTHORS, MAINTAINERS) keep their form�[0m
 �[36;1mset -uo pipefail�[0m
 �[36;1mfail=0�[0m
 �[36;1m�[0m
 �[36;1m# --- template-repo mode -------------------------------------------�[0m
 �[36;1m# An un-instantiated template legitimately SHIPS {{OWNER}}/{{AUTHOR}}�[0m
 �[36;1m# placeholders and self-references its own template name; judging it�[0m
 �[36;1m# like an instantiated repo is a category error. Detection is explicit�[0m
 �[36;1m# and auditable: the repo name says it is a temp...

GitHub Actions: Central Estate CI/CD Audit / estate-audit: docs(clade): uuid follows the forge path, it is not immortal

Conclusion: failure

View job details

##[group]Run # Accepted placements widened per owner ruling 2026-09-19: estate
 �[36;1m# Accepted placements widened per owner ruling 2026-09-19: estate�[0m
 �[36;1m# repos legitimately keep governance docs under docs/ (and GitHub�[0m
 �[36;1m# renders under .github/) — rsr-template-repo itself was failing on�[0m
 �[36;1m# layout, not on substance. Root forms still win (first hit).�[0m
 �[36;1m# Template-repo mode: see below.�[0m
 �[36;1m#�[0m
 �[36;1m# Presence-only checking rewards filler. This gate previously demanded�[0m
 �[36;1m# ARCHITECTURE.md / MAINTAINERS.adoc / GOVERNANCE.md and checked only�[0m
 �[36;1m# that the paths existed — so the cheapest way to pass was to commit�[0m
 �[36;1m# template boilerplate. That happened: an estate repo acquired an�[0m
 �[36;1m# ARCHITECTURE.md describing a directory layout it does not have, a�[0m
 �[36;1m# MAINTAINERS naming a different account as owner, and a mise.toml�[0m
 �[36;1m# pinning `zig = "latest"` against that repo's own .tool-versions.�[0m
 �[36;1m# All three would have passed. So: presence, THEN format, THEN substance.�[0m
 �[36;1m#�[0m
 �[36;1m# Format policy (estate):�[0m
 �[36;1m#   .adoc  documentation (default)�[0m
 �[36;1m#   .md    wiki content only — plus a transitional allowance for the�[0m
 �[36;1m#          GitHub-mandated files, which are migrating to berrywiki format�[0m
 �[36;1m#   .txt   licence texts�[0m
 �[36;1m#   fixed  names GitHub or convention dictates (CODEOWNERS, funding.yml,�[0m
 �[36;1m#          NOTICE, AUTHORS, MAINTAINERS) keep their form�[0m
 �[36;1mset -uo pipefail�[0m
 �[36;1mfail=0�[0m
 �[36;1m�[0m
 �[36;1m# --- template-repo mode -------------------------------------------�[0m
 �[36;1m# An un-instantiated template legitimately SHIPS {{OWNER}}/{{AUTHOR}}�[0m
 �[36;1m# placeholders and self-references its own template name; judging it�[0m
 �[36;1m# like an instantiated repo is a category error. Detection is explicit�[0m
 �[36;1m# and auditable: the repo name says it is a temp...

GitHub Actions: Central Estate CI/CD Audit / estate-audit: docs(clade): uuid follows the forge path, it is not immortal

Conclusion: failure

View job details

##[group]Run bash "$GITHUB_ACTION_PATH/check.sh"
 �[36;1mbash "$GITHUB_ACTION_PATH/check.sh"�[0m
 shell: /usr/bin/bash --noprofile --norc -e -o pipefail {0}
 ##[endgroup]
 Scanning implementation source for untracked debt markers...
 ##[error]Untracked debt markers found in implementation source:
...
 protocols/proven-quic/src/QuicABI/Foreign.idr:76:-- TODO(recovery): congestion control and loss recovery (RFC 9002).
 protocols/proven-timestamp/ffi/zig/src/timestamp.zig:369:    e.source = .internal; // v1: internal only. TODO(rfc3161): select source.
 protocols/proven-timestamp/src/Timestamp/Provider.idr:28:-- TODO(rfc3161): add a real external provider, e.g.
 protocols/proven-timestamp/src/Timestamp/Provider.idr:41:-- TODO(anchored): an `anchoredProvider` could periodically publish the head
 protocols/proven-timestamp/src/TimestampABI/Foreign.idr:94:-- TODO(rfc3161): a future `ts_append_rfc3161` variant (or an extra source
 ##[error]Resolve the debt or link it as MARKER(#issue).
 scripts/maintenance/run-maintenance.sh:37:  --skip-todo          Skip TODO/FIXME scan
 scripts/maintenance/run-maintenance.sh:205:    todo_hits="$(rg -n "TODO|FIXME|XXX|HACK|STUB|PARTIAL" \
 Scanning proof code for undeclared circumventions...
 ##[error]Code hygiene gate failed.
   none.
 ##[error]Process completed with exit code 1.
Additional context used

Code guidelines: 1

.github/copilot-instructions.md — auto-discovered
Path-based instructions: 2

Source excerpt: State files (.a2ml) live in `.machine_readable/` ONLY, never the root.

CodeRabbit inference engine (.github/copilot-instructions.md)

Files:

  • .machine_readable/CLADE.a2ml
Source excerpt: Annotate and document all files.

CodeRabbit inference engine (.github/copilot-instructions.md)

Files:

  • .machine_readable/CLADE.a2ml

@github-actions

Copy link
Copy Markdown

🔍 Hypatia Security Scan

Findings: 298 issues detected

Severity Count
🔴 Critical 211
🟠 High 6
🟡 Medium 81

⚠️ Action Required: Critical security issues found!

View findings
[
  {
    "reason": "Action `actions/upload-artifact@v7.0.2` in panic-attack-unified-api-adapter.yml is not pinned to a commit SHA — `v7.0.2` is a tag, and a tag can be moved to a different commit. Pin it to a full 40-character commit SHA, with the version in a trailing comment.",
    "type": "unpinned_action",
    "file": ".github/workflows/panic-attack-unified-api-adapter.yml",
    "level": "epi",
    "rule_module": "workflow_audit",
    "action": "pin_sha",
    "severity": "medium",
    "evidence": [
      {
        "span": {
          "file": ".github/workflows/panic-attack-unified-api-adapter.yml",
          "end_line": 0,
          "start_line": 0
        },
        "rule": "workflow_audit/unpinned_action",
        "observations": 1,
        "rule_version": "0.1.0"
      }
    ],
    "support": {
      "kind": "pattern"
    }
  },
  {
    "reason": "Job `triage` in label-triage.yml has no `timeout-minutes:` declaration. Default is 6 hours — a stuck codeload fetch or runner hang can burn budget. Add `timeout-minutes: 10` (or proportional).",
    "type": "missing_timeout_minutes",
    "file": ".github/workflows/label-triage.yml",
    "level": "epi",
    "rule_module": "workflow_audit",
    "action": "flag",
    "severity": "medium",
    "recipe_id": "recipe-add-workflow-timeout-minutes",
    "job": "triage",
    "evidence": [
      {
        "span": {
          "file": ".github/workflows/label-triage.yml",
          "end_line": 0,
          "start_line": 0
        },
        "rule": "workflow_audit/missing_timeout_minutes",
        "observations": 1,
        "rule_version": "0.1.0"
      }
    ],
    "support": {
      "kind": "pattern"
    }
  },
  {
    "reason": "Job `sync` in labels.yml has no `timeout-minutes:` declaration. Default is 6 hours — a stuck codeload fetch or runner hang can burn budget. Add `timeout-minutes: 10` (or proportional).",
    "type": "missing_timeout_minutes",
    "file": ".github/workflows/labels.yml",
    "level": "epi",
    "rule_module": "workflow_audit",
    "action": "flag",
    "severity": "medium",
    "recipe_id": "recipe-add-workflow-timeout-minutes",
    "job": "sync",
    "evidence": [
      {
        "span": {
          "file": ".github/workflows/labels.yml",
          "end_line": 0,
          "start_line": 0
        },
        "rule": "workflow_audit/missing_timeout_minutes",
        "observations": 1,
        "rule_version": "0.1.0"
      }
    ],
    "support": {
      "kind": "pattern"
    }
  },
  {
    "reason": "Job `estate-audit` in main-estate-audit.yml has no `timeout-minutes:` declaration. Default is 6 hours — a stuck codeload fetch or runner hang can burn budget. Add `timeout-minutes: 10` (or proportional).",
    "type": "missing_timeout_minutes",
    "file": ".github/workflows/main-estate-audit.yml",
    "level": "epi",
    "rule_module": "workflow_audit",
    "action": "flag",
    "severity": "medium",
    "recipe_id": "recipe-add-workflow-timeout-minutes",
    "job": "estate-audit",
    "evidence": [
      {
        "span": {
          "file": ".github/workflows/main-estate-audit.yml",
          "end_line": 0,
          "start_line": 0
        },
        "rule": "workflow_audit/missing_timeout_minutes",
        "observations": 1,
        "rule_version": "0.1.0"
      }
    ],
    "support": {
      "kind": "pattern"
    }
  },
  {
    "reason": "Python file detected -- banned language",
    "type": "banned_language_file",
    "file": "/home/runner/work/proven-servers/proven-servers/bindings/python/proven_servers/monitor.py",
    "level": "epi",
    "rule_module": "cicd_rules",
    "action": "flag",
    "severity": "critical",
    "evidence": [
      {
        "span": {
          "file": "/home/runner/work/proven-servers/proven-servers/bindings/python/proven_servers/monitor.py",
          "end_line": 0,
          "start_line": 0
        },
        "rule": "cicd_rules/banned_language_file",
        "observations": 1,
        "rule_version": "0.1.0"
      }
    ],
    "support": {
      "kind": "pattern"
    }
  },
  {
    "reason": "Python file detected -- banned language",
    "type": "banned_language_file",
    "file": "/home/runner/work/proven-servers/proven-servers/bindings/python/proven_servers/hardened.py",
    "level": "epi",
    "rule_module": "cicd_rules",
    "action": "flag",
    "severity": "critical",
    "evidence": [
      {
        "span": {
          "file": "/home/runner/work/proven-servers/proven-servers/bindings/python/proven_servers/hardened.py",
          "end_line": 0,
          "start_line": 0
        },
        "rule": "cicd_rules/banned_language_file",
        "observations": 1,
        "rule_version": "0.1.0"
      }
    ],
    "support": {
      "kind": "pattern"
    }
  },
  {
    "reason": "Python file detected -- banned language",
    "type": "banned_language_file",
    "file": "/home/runner/work/proven-servers/proven-servers/bindings/python/proven_servers/ospf.py",
    "level": "epi",
    "rule_module": "cicd_rules",
    "action": "flag",
    "severity": "critical",
    "evidence": [
      {
        "span": {
          "file": "/home/runner/work/proven-servers/proven-servers/bindings/python/proven_servers/ospf.py",
          "end_line": 0,
          "start_line": 0
        },
        "rule": "cicd_rules/banned_language_file",
        "observations": 1,
        "rule_version": "0.1.0"
      }
    ],
    "support": {
      "kind": "pattern"
    }
  },
  {
    "reason": "Python file detected -- banned language",
    "type": "banned_language_file",
    "file": "/home/runner/work/proven-servers/proven-servers/bindings/python/proven_servers/snmp.py",
    "level": "epi",
    "rule_module": "cicd_rules",
    "action": "flag",
    "severity": "critical",
    "evidence": [
      {
        "span": {
          "file": "/home/runner/work/proven-servers/proven-servers/bindings/python/proven_servers/snmp.py",
          "end_line": 0,
          "start_line": 0
        },
        "rule": "cicd_rules/banned_language_file",
        "observations": 1,
        "rule_version": "0.1.0"
      }
    ],
    "support": {
      "kind": "pattern"
    }
  },
  {
    "reason": "Python file detected -- banned language",
    "type": "banned_language_file",
    "file": "/home/runner/work/proven-servers/proven-servers/bindings/python/proven_servers/dbserver.py",
    "level": "epi",
    "rule_module": "cicd_rules",
    "action": "flag",
    "severity": "critical",
    "evidence": [
      {
        "span": {
          "file": "/home/runner/work/proven-servers/proven-servers/bindings/python/proven_servers/dbserver.py",
          "end_line": 0,
          "start_line": 0
        },
        "rule": "cicd_rules/banned_language_file",
        "observations": 1,
        "rule_version": "0.1.0"
      }
    ],
    "support": {
      "kind": "pattern"
    }
  },
  {
    "reason": "Python file detected -- banned language",
    "type": "banned_language_file",
    "file": "/home/runner/work/proven-servers/proven-servers/bindings/python/proven_servers/nfs.py",
    "level": "epi",
    "rule_module": "cicd_rules",
    "action": "flag",
    "severity": "critical",
    "evidence": [
      {
        "span": {
          "file": "/home/runner/work/proven-servers/proven-servers/bindings/python/proven_servers/nfs.py",
          "end_line": 0,
          "start_line": 0
        },
        "rule": "cicd_rules/banned_language_file",
        "observations": 1,
        "rule_version": "0.1.0"
      }
    ],
    "support": {
      "kind": "pattern"
    }
  }
]

Powered by Hypatia Neurosymbolic CI/CD Intelligence

@sonarqubecloud

Copy link
Copy Markdown

@linear-code
linear-code Bot marked this pull request as ready for review November 10, 2026 22:27
@hyperpolymath
hyperpolymath merged commit 2ec4d54 into main Nov 11, 2026
12 of 13 checks passed
@hyperpolymath
hyperpolymath deleted the chore/uuid-not-immortal branch November 11, 2026 00:34
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.

3 participants