Skip to content

chore(descriptiles): move .machine_readable/6a2 to .machine_readable/descriptiles - #87

Merged
hyperpolymath merged 2 commits into
mainfrom
claude/descriptiles-folder
Nov 10, 2026
Merged

hyperpolymath merged 2 commits into
mainfrom
claude/descriptiles-folder

Conversation

@hyperpolymath

Copy link
Copy Markdown
Owner

Summary

The check Hypatia Neurosymbolic Analysis is red on main since #85 made the Hypatia scan run. It reports 5 critical findings, all rule structural_drift/SD004, "Descriptile in retired location -- must be in .machine_readable/descriptiles/":

META.a2ml, ECOSYSTEM.a2ml, AGENTIC.a2ml, NEUROSYM.a2ml and PLAYBOOK.a2ml in .machine_readable/6a2/.

This PR moves the folder to the estate layout. system-et has the same layout (hyperpolymath/system-et#92).

Known drift after this PR (owner decision of 2026-11-10): the coaptation receipt is stale.
Mustfile.a2ml must change: its check test -d .machine_readable/6a2 ... names the folder. The receipt has the hash of that file in line 89 (must@20748d123686). The extract script of the repository now gives must@fbbcf90bc87f.
receipts/latest.a2ml is generated and is not touched here. Run just coapt on a machine that has Nickel, then just validate-coapt. No CI job runs that check, so nothing goes red to say so.

Changes

  • git mv .machine_readable/6a2 .machine_readable/descriptiles: 11 files, with anchors/. 8 are pure renames; 3 also change 1 or 2 lines of their own text (0-AI-MANIFEST.a2ml, PLAYBOOK.a2ml, README.adoc).
  • 34 other files that name the old path get the new path:
    • scripts: arrival pack (extract.sh, generate.sh, verify.sh), coaptation (coapt.sh, extract-facts.sh, verify.sh), scripts/validate-template.sh, tests/e2e/template_instantiation_test.sh
    • contracts: the 6 contractiles, Mustfile.a2ml, coapt.k9.ncl, claude-md.k9.ncl, witness-map.ncl
    • configuration: openssf-compliance.yml, .pre-commit-config.yaml, the 2 AI manifests, 2 maintenance policies, root-allow.txt (comment)
    • documents and the pull request template
  • The wording of each changed line is the wording that system-et has.

Not changed, on purpose:

  • anytype_chora.deed: 2 comment lines still say 6a2. The arrival pack has the hash of this file (DEED@f8d9d5bbaba0 in CLAUDE.md), and CLAUDE.md can be made again only with Nickel. With the deed unchanged, CLAUDE.md stays in sync.
  • .machine_readable/archive/state-v1.a2ml: its note says where the archived file was. That is history.
  • user_6a2_is_contractile_ought.md in 2 comments is the name of a note, not a path.

RSR Quality Checklist

Required

  • Tests pass: see Testing
  • Code is formatted (just fmt or equivalent): not run
  • Linter is clean (no new warnings or errors): not run locally, the PR checks give the result
  • No banned language patterns (no TypeScript, no npm/bun, no Go/Python)
  • No unsafe blocks without // SAFETY: comments
  • No banned functions (believe_me, unsafeCoerce, Obj.magic, Admitted, sorry)
  • SPDX license headers present on all new/modified source files
  • No secrets, credentials, or .env files included

As Applicable

  • .machine_readable/descriptiles/ECOSYSTEM.a2ml and META.a2ml: moved, content not changed
  • Documentation updated: each document that names the path

Testing

Run in a clone, with the scripts of this repository:

  • .github/hooks/validate-k9.sh: 17 files, 0 errors.
  • The 2 Must checks that name the folder (six-directory-present, anchors-directory): both pass.
  • tests/workflows/validate_workflows_test.sh: passes.
  • Inputs of the generated files, before and after the move:
    • arrival pack data (extract.sh): byte-identical. So CLAUDE.md is still in sync.
    • coaptation facts (extract-facts.sh): byte-identical.
    • coaptation clauses (extract-clauses.sh): 2 descriptions and the hash of Mustfile.a2ml differ. That is the drift above.
  • git grep 6a2: the only lines left are the ones listed under "Not changed", and 1 commit hash that has those 3 characters.

Not verified before the push:

  • The Hypatia result. I cannot run Hypatia here. The run of Hypatia Neurosymbolic Analysis on this pull request must show Critical: 0.
  • just validate-claude-md and just validate-coapt: both need Nickel.

Generated by Claude Code

…descriptiles

Hypatia reports 5 critical findings in this repository (rule SD004,
"Descriptile in retired location"): META, ECOSYSTEM, AGENTIC, NEUROSYM
and PLAYBOOK are in .machine_readable/6a2/. The check "Hypatia
Neurosymbolic Analysis" fails on them.

- git mv .machine_readable/6a2 .machine_readable/descriptiles (11 files,
  with anchors/)
- 35 files that name the old path get the new path: scripts of the
  arrival pack and of the coaptation, the 6 contractiles, Mustfile.a2ml,
  the AI manifests, openssf-compliance.yml, the pre-commit pattern, the
  pull request template and documents
- same wording as system-et, which has this layout

Not changed:
- anytype_chora.deed: 2 comment lines still say 6a2. The arrival pack
  has the hash of this file, and CLAUDE.md can be made again only with
  Nickel.
- .machine_readable/archive/state-v1.a2ml: its note says where the
  archived file was.
- .machine_readable/coaptation/receipts/latest.a2ml: see below.

KNOWN DRIFT, owner decision of 2026-11-10: Mustfile.a2ml changes (its
check must name the new folder), so the coaptation receipt is stale:
line 89 has must@20748d123686, and the extract script now gives
must@fbbcf90bc87f. Run `just coapt` on a machine that has Nickel.

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

coderabbitai Bot commented Nov 10, 2026 •

Copy link
Copy Markdown
Contributor

Explain Change →

Caution

Review failed

The pull request is closed.

Summary

Summary by CodeRabbit

  • Documentation
    • Updated governance, setup guidance and repository references to use the revised location for machine-readable project descriptions.
  • Chores
    • Updated validation checks, workflows and supporting scripts to read and verify files at the revised location.

The PR replaces .machine_readable/6a2/ references with .machine_readable/descriptiles/ across configuration, scripts, contract settings, validation checks, and documentation. Existing output destinations and unrelated inputs remain unchanged.

Changes: Machine-readable directory migration

Layer / File(s) Summary
Canonical directory identity
.machine_readable/0.1-AI-MANIFEST.a2ml, .machine_readable/descriptiles/0-AI-MANIFEST.a2ml, .machine_readable/descriptiles/README.adoc, machine-readable-design/canonical-directory-structure/README.adoc
The canonical location entries, manifest text, directory heading, directory tree, and runner description now refer to descriptiles.
Input and output path updates
.machine_readable/ai/*, .machine_readable/arrival-pack/*, .machine_readable/coaptation/*, .machine_readable/contractiles/*
Configured inputs, extractor defaults, drift-log paths, and signed-record destinations now use descriptiles. Existing overrides, output paths, and unrelated inputs remain unchanged.
Repository references and validation
.github/*, .machine_readable/descriptiles/PLAYBOOK.a2ml, .machine_readable/policies/*, .machine_readable/root-allow.txt, .pre-commit-config.yaml, AFFIRMATION.adoc, docs/*, scripts/validate-template.sh, tests/e2e/template_instantiation_test.sh
Governance and policy references, documentation, workflow and hook patterns, validation requirements, and the template test now use the updated directory path.

Estimated code review effort: 2 (Simple) | ~10 minutes

Change: Bug fix

Possibly related PRs

  • hyperpolymath/anytype#74: Updates the arrival-pack source and generated CLAUDE.md from .machine_readable/6a2; this PR updates arrival-pack inputs to .machine_readable/descriptiles.
  • hyperpolymath/anytype#76: Updates anytype_chora.deed using live STATE and AI manifest sources. This PR relocates the source directory and updates consumers, while leaving the deed unchanged.

Suggested reviewers: claude

Merge Risk: Moderate · up to b8f96

The directory rename is mostly mechanical, but the committed coaptation receipt no longer matches the changed Mustfile, so coaptation validation will fail until it is regenerated. Regenerate and commit the receipt before merging. Some docs still point to an archived STATE file, which is a minor cleanup.

- [ ] 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

@sonarqubecloud

Copy link
Copy Markdown

@hyperpolymath
hyperpolymath marked this pull request as ready for review November 10, 2026 21:45
@hyperpolymath
hyperpolymath merged commit 7ad7d87 into main Nov 10, 2026
30 of 31 checks passed
@chatgpt-codex-connector

Copy link
Copy Markdown
Codex Review Summary: ❌ Failed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ❌ Failed 2026-11-10T21:45:13.009103Z
We couldn’t complete this review. Comment @codex review to try again.
b8f965f Draft marked ready
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@hyperpolymath
hyperpolymath deleted the claude/descriptiles-folder branch November 10, 2026 21:45
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

hyperpolymath added a commit that referenced this pull request Nov 11, 2026
## Summary

2 open items of this repository were recorded only in pull request
texts. `docs/status/JOURNAL.adoc` is the file that the next agent reads
first, so they go there.

## Changes

`docs/status/JOURNAL.adoc`, table "Blockers", 2 new rows:

- `coapt-receipt-stale`: the coaptation receipt is stale since #87 moved
the descriptiles folder. `just coapt` and `just validate-coapt` need
Nickel. No CI job runs this check.
- `governance-gate-not-running`: `governance.yml` calls a reusable
workflow of `metadatastician/standards`, and the Actions settings of
this repository refuse it. Each run ends at creation with no job.

No other line changes. The `updated::` value is already 2026-11-10.

## RSR Quality Checklist

### Required

- [ ] Tests pass: not run, 1 document
- [x] No banned language patterns
- [x] No banned functions
- [x] SPDX license headers present on all new/modified source files
- [x] No secrets, credentials, or `.env` files included

### As Applicable

- [x] `docs/status/JOURNAL.adoc` updated

## Testing

- The coaptation extract script (`extract-facts.sh`) gives
byte-identical output before and after the edit. So this change does not
add to the receipt drift.

---
_Generated by [Claude
Code](https://claude.ai/code/session_0136P7ZmiFSCoB3UR9Kk56rK)_

Co-authored-by: Claude <noreply@anthropic.com>
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