Portolan v0.1.0

Portolan v0.1.0

Portolan is a local-first evidence-preparation CLI for AI agents. It scans
local source, metadata, optional local tool outputs, and explicitly supplied
runtime or claim files, then writes bounded artifacts an agent can inspect
before making architecture or codebase claims.

Install

# Requires the published v0.1.0 tag. If this fails, use the source-checkout
# route below until the tag is available.
go install github.com/fcon-tech/portolan/cmd/portolan@v0.1.0
portolan --version

Source-checkout fallback:

git clone https://github.com/fcon-tech/portolan.git
cd portolan
scripts/bootstrap-portolan
.portolan/bin/portolan --version

The first release is source-first. Downloadable prebuilt binaries, Homebrew,
Docker, npm, apt, and other package-manager routes are not part of v0.1.0.

What Is Verified

• Local CLI execution with read-only target inspection and explicit output
  directories.
• Evidence graph, context pack, map bundle, bounded query surface, and release
  envelope checks from the current repository test suite.
• Current product claims and limitations are governed by
  docs/product-claims.md.

Demo Route

The Apache Bigtop route is documented in
docs/test-corpora/apache-bigtop.md as a fixed local-scope demo and stress
target, not proof of complete ecosystem coverage or broad benchmark
superiority. Preserve not_assessed, failed, blocked, unknown, and
cannot_verify states.

Limits

• No UI Cursor/Composer claim is made by this release.
• Complete inherited-estate coverage is not proven by repository count.
• Complete runtime topology remains not_assessed without complete supported
  local runtime evidence.
• Portolan has focused local CLI security boundary tests, not broad security
  certification.
• No popularity, adoption, customer, star, fork, or production-usage claim is
  made.

Release State

• Local PR checks: verified in
  specs/047-canonical-public-install-release/reviews/v0.1.0-release-closeout-2026-05-30.md.
• Release-commit checks: must be rerun before publication.
• GitHub checks: not_assessed until checked on the release commit or PR.
• GitHub release publication: not_assessed until the maintainer publishes it.
• Adoption/popularity: not_assessed; no adoption claim is implied.