ipv6-tools/0-AI-MANIFEST.a2ml at main · hyperpolymath/ipv6-tools · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
# SPDX-License-Identifier: PMPL-1.0-or-later
# IPv6 Tools - AI Agent Manifest
# Universal entry point for AI agents (Claude, Gemini, OpenAI, etc.)

repo: ipv6-tools
owner: hyperpolymath
type: monorepo

## Canonical File Locations (CRITICAL INVARIANTS)

SCM_FILES: .machine_readable/
  - .machine_readable/6a2/STATE.a2ml       # Project state, tasks, progress
  - .machine_readable/6a2/META.a2ml        # Architecture decisions, practices
  - .machine_readable/6a2/ECOSYSTEM.a2ml   # Ecosystem position, relationships
  - .machine_readable/6a2/AGENTIC.a2ml     # AI/bot integrations
  - .machine_readable/6a2/NEUROSYM.a2ml    # Neurosymbolic components
  - .machine_readable/6a2/PLAYBOOK.a2ml    # Development workflow

WORKFLOWS: .github/workflows/
CONTRACTS: contractiles/
BOT_DIRECTIVES: .bot_directives/

## Critical Invariants (NEVER VIOLATE)

1. SCM files ONLY in .machine_readable/ (NEVER in root)
2. All original code uses PMPL-1.0-or-later license
3. Follow RSR template structure
4. No npm/bun/TypeScript (use Deno/ReScript)
5. Workflow permissions: read-all at workflow level

## Repository Structure

```
ipv6-tools/
├── ipv6-only/              # IPv6-only network enforcement
├── ipv6-site-enforcer/     # Site-wide IPv6 policy enforcer
├── .machine_readable/      # SCM checkpoint files
├── .github/workflows/      # CI/CD (17 standard workflows)
└── contractiles/           # Formal contracts (k9, dust, lust, must, trust)
```

## Session Lifecycle Hooks

on-enter:
  1. Read this manifest FIRST
  2. Read `.machine_readable/6a2/STATE.a2ml` (current status)
  3. Read `.machine_readable/6a2/ECOSYSTEM.a2ml` (relationships)
  4. Read `.machine_readable/6a2/META.a2ml` (architecture)
  5. Acknowledge canonical locations

on-exit:
  1. Update .machine_readable/6a2/STATE.a2ml with progress
  2. Update .machine_readable/6a2/ECOSYSTEM.a2ml if integrations changed
  3. Update .machine_readable/6a2/META.a2ml if architecture changed

## Integration Points

- MCP Server: mcp-repo-guardian (hard enforcement)
- FUSE Wrapper: repo-guardian-fs (universal enforcement)
- CI/CD: Hypatia neurosymbolic scanning
- Bots: gitbot-fleet (rhodibot, echidnabot, etc.)

## License

PMPL-1.0-or-later (Palimpsest License)