# Seamlinee

> 

- Documentation: https://pr-1-b9e16090e83d.thally.app
- GitHub: https://github.com/thallylabs/seamlinee
- Full docs for LLMs: https://pr-1-b9e16090e83d.thally.app/llms-full.txt
- Agent discovery (ai.txt): https://pr-1-b9e16090e83d.thally.app/ai.txt
- Structured docs index (JSON): https://pr-1-b9e16090e83d.thally.app/api/docs-index
- OpenAPI spec: https://pr-1-b9e16090e83d.thally.app/openapi.yaml

## For AI agents

Every page supports content negotiation on its human URL:
- JSON API: append `?format=json` or send `Accept: application/json`
- JSON-LD: append `?format=ldjson` or send `Accept: application/ld+json`
- Markdown: append `?format=md` or send `Accept: text/markdown`
- Per-page API: https://pr-1-b9e16090e83d.thally.app/api/docs/{page-id}
- Search API: https://pr-1-b9e16090e83d.thally.app/api/search?q={query}
- Capability manifest (skill): https://pr-1-b9e16090e83d.thally.app/skill.md
- Agent guidance (editing these docs): https://pr-1-b9e16090e83d.thally.app/AGENTS.md
- MCP server (attach docs as native tools): https://pr-1-b9e16090e83d.thally.app/api/mcp
- Agent readiness: https://pr-1-b9e16090e83d.thally.app/api/agent-readiness

### Recommended workflow

1. Use this index, the search API, or `search_docs` before choosing a page.
2. Read the smallest set of relevant pages and follow their prerequisite links.
3. Treat the published docs as the source of truth. Label inferences and say when evidence is missing.
4. Cite the canonical human page URLs, not only API endpoints.
5. Use `/AGENTS.md` before editing a repository. The public MCP server is read-only.

## Get Started

### Overview

- [Introduction](https://pr-1-b9e16090e83d.thally.app/): Seamline is a toolkit for catching breaking changes in API schemas and enforcing typed environment-variable contracts in Node.js applications.
- [Quickstart](https://pr-1-b9e16090e83d.thally.app/quickstart): Install Specdiff and Envlock, run a first comparison and a first environment check, and verify the results.

## Specdiff

### Getting Started

- [Overview](https://pr-1-b9e16090e83d.thally.app/specdiff/overview): Breaking-change detection for JSON Schema and OpenAPI 3.x. Compare API specifications and classify every change as breaking, warning, or info.

### Reference

- [Core Library](https://pr-1-b9e16090e83d.thally.app/specdiff/core-api): Complete API reference for @specdiff/core: types, diff functions, rule helpers, formatters, pointer utilities, and ref resolution.
- [CLI Reference](https://pr-1-b9e16090e83d.thally.app/specdiff/cli): Command-line interface for @specdiff/cli: detect breaking changes between JSON Schema and OpenAPI documents.
- [MCP Server](https://pr-1-b9e16090e83d.thally.app/specdiff/mcp): Model Context Protocol server for @specdiff/mcp: expose breaking-change detection to coding agents over stdio.
- [Rules Reference](https://pr-1-b9e16090e83d.thally.app/specdiff/rules): Complete catalogue of all 45 rules that Specdiff uses to classify changes, including direction-dependent severity and override options.

### Guides

- [CI Integration](https://pr-1-b9e16090e83d.thally.app/specdiff/ci-integration): Run Specdiff in CI pipelines to block breaking API changes, post diff summaries to pull requests, and adopt gradually with rule and path ignores.

## Envlock

### Getting Started

- [Overview](https://pr-1-b9e16090e83d.thally.app/envlock/overview): Typed environment-variable contracts for Node.js: declare, validate, type, document, and diff env vars from a single schema.

### Reference

- [Field Types](https://pr-1-b9e16090e83d.thally.app/envlock/field-types): Reference for all ten env builder functions and their chain methods in @envlock/core.
- [Validation](https://pr-1-b9e16090e83d.thally.app/envlock/validation): Reference for Envlock schema definition, environment variable parsing, validation, error handling, projection functions, and dotenv utilities.
- [CLI Reference](https://pr-1-b9e16090e83d.thally.app/envlock/cli): Reference for the @envlock/cli command-line tool: check, example, diff, inspect, and init commands, flags, exit codes, and programmatic usage.
- [MCP Server](https://pr-1-b9e16090e83d.thally.app/envlock/mcp): Set up and use the Envlock MCP server to expose environment-contract checks to coding agents over stdio.

### Guides

- [Configuration](https://pr-1-b9e16090e83d.thally.app/envlock/configuration): Config file format, dotenv parsing, validation semantics, and source composition for Envlock.