AKAMAN v0.1.0 Source Layout

The verified v0.1.0 project tree contains the complete source, tests, documentation, optional service wrappers, Makefile, and MIT licence. The project’s small size is intentional: a developer can read the whole thing in an afternoon. Each C source file is published in full on its own page — follow the links below.

akaman-v0.1.0/
├── src/
│   ├── main.c
│   ├── core.c
│   ├── core.h
│   ├── mcp.c
│   ├── mcp.h
│   ├── json.c
│   └── json.h
├── tests/
│   └── test.sh
├── docs/
│   ├── akaman.1
│   ├── running-as-a-service.md
│   ├── AKAMAN-ARTICLE.md
│   ├── AKAMAN-CONTEXT-REDUCTION.md
│   └── AKAMAN-TEST-REPORT.md
├── contrib/
│   ├── systemd/
│   │   └── akaman.service
│   └── openrc/
│       ├── akaman
│       └── akaman.confd
├── Makefile
├── README.md
└── LICENSE

The optional service wrappers live under contrib/ because they are convenience integrations, not dependencies: AKAMAN itself does not require systemd or OpenRC, and the binary runs standalone. They are provided only to make supervised HTTP/webMCP operation easier where an administrator wants it.

src/main.c

CLI entry point, option parsing, and command dispatch.

src/core.c

Core lookup, parsing, bounded extraction, and source selection.

src/core.h

Core lookup, parsing, bounded extraction, and source selection.

src/mcp.c

stdio MCP protocol handling and tool responses.

src/mcp.h

stdio MCP protocol handling and tool responses.

src/json.c

JSON parsing and protocol data handling.

src/json.h

JSON parsing and protocol data handling.

tests/test.sh

CLI, MCP, malformed-input, hostile-input, and CLI/MCP parity tests.

docs/akaman.1

The installed command manual.

docs/running-as-a-service.md

Detailed guide to manual, systemd and OpenRC operation, configuration and network security.

docs/AKAMAN-ARTICLE.md

Project article, rationale, and review.

docs/AKAMAN-CONTEXT-REDUCTION.md

Full benchmark tables, methodology, and performance notes.

docs/AKAMAN-TEST-REPORT.md

Dated test report and coverage statement.

contrib/systemd/akaman.service

Example systemd wrapper for persistent authenticated HTTP/webMCP operation. Not needed for local stdio clients.

contrib/openrc/akaman

OpenRC service wrapper for persistent HTTP/webMCP operation.

contrib/openrc/akaman.confd

Administrator configuration for the OpenRC wrapper, keeping runtime arguments separate from the init script.

README.md

Build, usage, transport, and project overview.

Makefile

Reproducible build, test, and install targets.

LICENSE

MIT licence for the project.

The architecture stays inspectable by design: four C source files, one MCP tool, explicit size limits, JSON validation, traversal checks, and a shell test suite. Where the released archive differs from the documentation, the archive is the authority. Download the complete source archive to inspect every file directly.