pig

package module
v0.2.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 25, 2026 License: MIT Imports: 1 Imported by: 0

README

PiG

CI CodeQL OpenSSF Scorecard

REUSE status Go Report Card Go Reference Go version Latest release Pi pin 0.87.1 Parity coverage Follow PiG on X Join r/PiGCodingAgent

Porting: 446 of 542 intended-portable upstream files are ported (82.3%). The 542 are the PORT_MAP.md rows for Pi's agent, ai, coding-agent, and tui packages, excluding 74 n/a and 0 deferred rows. Of the other 96, 24 are partial and 72 are not started. Not started includes 23 files new in Pi 0.87.1 that PiG has not ported yet.

Behavioral evidence badge: 428 of the 446 ported files (96.0%) have a behavioral paired scenario or reviewed mutation-proven unit test. The badge counts evidence mappings, not passing runs; parity/coverage.md shows the last recorded run.

PiG (Pi in Go) is a Go implementation of Pi, the TypeScript codebase behind the Pi coding agent. PiG is a parity-bound translation, where Pi's behavior is the contract and Go is the implementation language.

PiG is under active development. Install it on macOS or Linux with curl -fsSL https://pi-in-go.dev/install.sh | sh, on any supported platform with npm install -g @pi-in-go/pig or go install github.com/MichaelKinsy/PiG/cmd/pig@latest, or download an archive from GitHub Releases. Windows support is a preview.

Upstream Pi

Pi is the reference implementation. PiG follows Pi's behavior and design unless a Go constraint or an approved product-neutral requirement makes a difference necessary.

Use the upstream project for Pi itself:

PiG is not an official Pi release. The Pi maintainers do not endorse PiG.

Origins

Michael Kinsy created PiG working at Hewlett Packard Enterprise.

PiG is maintained as an independent open-source project. Project decisions, issues, and contributions belong in this repository. See GOVERNANCE.md and MAINTAINERS.md.

Compatibility philosophy

PiG adds a Go implementation to the Pi ecosystem and follows the Pi reference implementation.

  • Preserve observable compatibility with Pi.
  • Treat the pinned Pi release as the reference behavior.
  • Minimize unnecessary divergence.
  • Record each intentional user-visible or interoperability difference.
  • Prefer changes that reduce the cost of the next upstream sync.
  • Share generally useful findings with the broader ecosystem when the contribution route permits it.

The pinned Pi release is 0.87.1 at commit f07218c4d4bbc12bef056a7058c3dd49dfe41abe. The pin names the behavior oracle. It does not claim that every upstream change is already ported: parity/coverage.md reports verified behavior, and the upgrade ledgers under parity/upstream-sync/ list each upstream change and its disposition.

PiG's current package scope covers Pi's agent, AI, coding-agent, and TUI packages. It does not implement Pi's experimental remote Session packages or its standalone telemetry and evaluation packages. See PORT_MAP.md for the exact boundary.

Project facts

  • Binary: pig
  • Go module: github.com/MichaelKinsy/PiG
  • Configuration root: ~/.pig/, or PIG_HOME
  • Agent directory: ~/.pig/agent, or PIG_CODING_AGENT_DIR
  • Pi version pin: coding/pigversion/pigversion.go
  • Local upstream mirror: .upstream/current/
  • Main verification gate: make check
  • Full verification and coverage refresh: make verify

pig --version prints PiG's version as <PiG release>+<Pi release>, for example 0.2.0+0.87.1 (D63): the Pi release is semver build metadata, so the version sorts as the PiG release. pig version prints the PiG release and the pinned Pi release as separate fields. Neither command reads user configuration.

Repository map

Path Responsibility
agent/ Pi-compatible Agent loop, messages, and harness Session state.
ai/ Pi-compatible providers, model catalog, authentication, and streaming types.
coding/ Public coding-agent SDK, extension contracts, Package support, and Piglet support.
tui/ Public terminal components, rendering, input, and terminal lifecycle.
cmd/pig/ Stock PiG command-line application and RPC process surface.
internal/ Private implementation used by Stock PiG. External modules cannot import it.
extensions/ Go, Rust, Python, and declaration-only TypeScript extension SDKs.
piglets/ Explicit agent compositions such as PiG Standard and Pig Porter.
parity/ Pinned Pi correspondence, scenarios, inventories, and generated evidence.
tests/ Integration, extension-conformance, clean-repository, and upstream-contract tests.
docs/ Maintainer references and the static public documentation site.
examples/ Small extension and embedding examples.
automation/ Reproducible CI image definitions.
scripts/ Checked development, parity, and release-support commands.

PiG aligns public package boundaries with Pi's agent, ai, coding-agent, and tui packages. Go files within a package follow cohesive implementation responsibilities instead of mirroring TypeScript file mechanics. PORT_MAP.md records every source correspondence.

Stock PiG and compositions

Stock PiG is the product-neutral binary built from this repository. It does not activate PiG Standard Resources, product authentication, product APIs, or deployment-specific behavior.

A Piglet explicitly selects Resources, tools, discovery, defaults, and environment requirements for one agent. A Package distributes Resources. A Package never owns or activates a Piglet. A Piglet Binary is a direct executable build output for one pinned Piglet composition.

PiG Standard is the explicit Piglet at piglets/standard/pig-standard.yaml. It currently selects the extension-provided PiG login, sprite catalogue, and PiG Runner. Run it from source with:

pig --piglet piglets/standard/pig-standard.yaml

Stock PiG never selects this composition implicitly. A Package can distribute its Resources, but a Package cannot own or activate the Piglet.

See CONTEXT.md and docs/README.md for the project terms and documentation map.

Security boundary

PiG runs with the permissions of the user who starts it. PiG does not provide a security sandbox for model output, tools, extensions, skills, hooks, or shell commands.

Use a container, virtual machine, or another operating-system boundary when you need isolation. Load extensions and project instructions only from sources you trust. See SECURITY.md.

Install with npm

Install the command with npm (Node.js 18 or newer):

npm install -g @pi-in-go/pig
pig --version

Or run it once without installing:

npx @pi-in-go/pig --version

pig itself is the native binary: npm installs the matching platform package (@pi-in-go/pig-<os>-<cpu>, for macOS, Linux and Windows on x64 and arm64) as an optional dependency, and Node.js runs only a small launcher. Do not install with --omit=optional or --no-optional, which leaves the binary out. Update with npm update -g @pi-in-go/pig and uninstall with npm uninstall -g @pi-in-go/pig. pig update does not replace an npm-installed binary; update through npm.

Install with Go

Install the command without a source checkout with Go 1.26 or newer:

go install github.com/MichaelKinsy/PiG/cmd/pig@latest

Go writes the pig executable to GOBIN, or to the bin directory of the first GOPATH entry when GOBIN is unset: $(go env GOPATH)/bin, which is ~/go/bin by default (%USERPROFILE%\go\bin on Windows). Add that directory to PATH. With an older Go 1.21 or later and the default GOTOOLCHAIN=auto, Go downloads a new enough toolchain automatically. Release binaries are built with Go 1.27.1.

Use an exact release such as @v0.2.0 when reproducibility matters. Update a Go installation by running go install again. Each release tags the root module (v0.2.0) and the Go extension SDK module (extensions/sdk/v0.2.0) on the same commit; go install needs both.

Build from source

PiG currently supports source builds on Linux, macOS, and Windows. Do not treat a platform as release-supported until its native release verification passes.

Requirements:

  • Go 1.27.1
  • Git
  • macOS 13 or later for native macOS builds
  • Node.js 24.19.0 and npm 12.0.2 for parity tooling
  • Python 3.12 for Python SDK tests
  • Rust 1.97.1 for Rust SDK tests
  • tmux for terminal parity tests on Unix

Build the binary:

go build -o bin/pig ./cmd/pig
./bin/pig --version

Prepare the exact Pi comparator and source mirror:

make upstream-mirror

Run the main local gate:

make check

The upstream-mirror target installs the lockfile-pinned Pi package. It retrieves the exact tagged Pi source and verifies its commit against coding/pigversion/pigversion.go.

Contract model

  • .upstream/current/ is the local source-language mirror.
  • Go code is the target implementation.
  • PORT_MAP.md maps tracked upstream files.
  • parity/scenarios/ records observed behavior.
  • parity/coverage.md reports generated verification status.
  • DIVERGENCES.md records intentional differences.
  • AGENTS.md defines maintenance rules.
  • Makefile defines build, test, parity, and release gates.

A ported row means that code exists. It does not prove behavioral compatibility. A non-deferred scenario must exercise and assert the mapped behavior.

Extensions

PiG supports Go, Rust, Python, and Node extension factories through its public extension host. Extensions can register tools, commands, event handlers, flags, shortcuts, providers, and user-interface contributions.

Node extensions use Pi's TypeScript extension API. PiG supplies compatible runtime modules. The declaration-only package in extensions/sdk-ts adds types for PiG-only extension capabilities without replacing Pi's TypeScript runtime.

Start with:

Use pig extension init <directory> to scaffold an extension. Use pig install <path> --validate-only --json to validate it.

Supply-chain evidence

PiG treats scanner output as evidence input, not as proof by itself. Release preparation builds a validated dependency inventory and artifact-specific SPDX SBOMs. Reviewers reconcile scanner findings with Go modules, npm locks, Python metadata, Rust locks, embedded assets, generated data, and release contents.

See docs/supply-chain.md for the inventory, SBOM, vulnerability, license, signing, and provenance requirements.

Project policies

Acknowledgements

PiG would not exist without Pi and the work of its maintainers and contributors. Their design and open-source work provide the reference that PiG follows.

Thank you to everyone who contributes to Pi and PiG.

Documentation

Overview

Package pig exposes build-time-embedded resources for the pig binary.

This is the only file at module root; runtime code lives in cmd/, internal/, coding/. Its sole purpose is to host `//go:embed` directives that need access to files at the repo root (Go embed cannot traverse to parent directories from a sub-package).

Currently embeds: - CHANGELOG.md, surfaced via the `/changelog` slash command.

Index

Constants

This section is empty.

Variables

View Source
var Changelog string

Changelog is the bundled CHANGELOG.md, embedded at build time. Read by internal/codingagent's `/changelog` slash handler. Empty when the file is missing at build time (which would fail the embed and the build).

Functions

This section is empty.

Types

This section is empty.

Directories

Path Synopsis
Package agent provides the core agent loop and message types.
Package agent provides the core agent loop and message types.
harness
Package harness holds the shared declarations of Pi's durable agent harness: tool, resource, stream-option, execution-environment, and shell-output contracts consumed by the session, execution, runtime, and utility packages beneath it.
Package harness holds the shared declarations of Pi's durable agent harness: tool, resource, stream-option, execution-environment, and shell-output contracts consumed by the session, execution, runtime, and utility packages beneath it.
harness/agentharness
Package agentharness holds the public durable AgentHarness data contracts of packages/agent/src/harness/agent-harness.ts, the passive HarnessEventBus of harness/events.ts and the ordered HookRegistry of harness/hooks.ts.
Package agentharness holds the public durable AgentHarness data contracts of packages/agent/src/harness/agent-harness.ts, the passive HarnessEventBus of harness/events.ts and the ordered HookRegistry of harness/hooks.ts.
harness/env
Package env provides NodeExecutionEnv, the host-OS filesystem and shell implementation of the harness execution environment.
Package env provides NodeExecutionEnv, the host-OS filesystem and shell implementation of the harness execution environment.
harness/execution
Package execution provides effect admission for the durable agent harness.
Package execution provides effect admission for the durable agent harness.
harness/pico3
Package pico3 is the experimental Pico3 agent kernel: durable records, commit-granular documents, a single-writer Session line, a task scheduler, the built-in turn kinds, and the watch view protocol.
Package pico3 is the experimental Pico3 agent kernel: durable records, commit-granular documents, a single-writer Session line, a task scheduler, the built-in turn kinds, and the watch view protocol.
harness/runtime
Package runtime holds the durable AgentHarness runtime declarations of packages/agent/src/harness/runtime/types.ts: the process-local configuration, the lane state projection, lane/operation command decisions and the Drive pass with its effect gate.
Package runtime holds the durable AgentHarness runtime declarations of packages/agent/src/harness/runtime/types.ts: the process-local configuration, the lane state projection, lane/operation command decisions and the Drive pass with its effect gate.
harness/session
Package session implements the durable harness session: the write-once entry tree, bound values and lists, the usage ledger, the storage contract, the Session mutation line, Branch capabilities, forks, and the in-memory backend.
Package session implements the durable harness session: the write-once entry tree, bound values and lists, the usage ledger, the storage contract, the Session mutation line, Branch capabilities, forks, and the in-memory backend.
harness/session/testing
Package sessiontesting holds runner-independent session test fixtures and storage decorators shared by every backend's conformance and benchmarks.
Package sessiontesting holds runner-independent session test fixtures and storage decorators shared by every backend's conformance and benchmarks.
harness/session/testing/benchmark
Package benchmark holds the deterministic session workloads shared by every backend's storage and repository benchmarks.
Package benchmark holds the deterministic session workloads shared by every backend's storage and repository benchmarks.
harness/session/testing/conformance
Package conformance holds the runner-independent Storage and SessionRepo conformance suites every session backend must pass.
Package conformance holds the runner-independent Storage and SessionRepo conformance suites every session backend must pass.
harness/utils
Package utils holds the harness usage arithmetic, adaptive publication, and bounded shell-output capture helpers.
Package utils holds the harness usage arithmetic, adaptive publication, and bounded shell-output capture helpers.
search
Package search defines the session and entry search contracts exported by the agent package.
Package search defines the session and entry search contracts exported by the agent package.
Package ai provides provider abstractions, model definitions, and auth storage for pig.
Package ai provides provider abstractions, model definitions, and auth storage for pig.
automation
ci/divguard command
Command divguard fails CI on hidden, arbitrary divergences from Pi: invented limits, timeouts and defaults, silent exits, swallowed errors and dropped events that no DIVERGENCES.md entry records.
Command divguard fails CI on hidden, arbitrary divergences from Pi: invented limits, timeouts and defaults, silent exits, swallowed errors and dropped events that no DIVERGENCES.md entry records.
ci/slopmetrics command
Command slopmetrics measures two code-quality signals from SlopCodeBench (arXiv:2603.24755) over the repository's hand-written Go code:
Command slopmetrics measures two code-quality signals from SlopCodeBench (arXiv:2603.24755) over the repository's hand-written Go code:
cmd
gen-image-models command
Command gen-image-models imports the exact published Pi image catalog and emits ai/image_models_generated.go in deterministic provider/model order.
Command gen-image-models imports the exact published Pi image catalog and emits ai/image_models_generated.go in deterministic provider/model order.
gen-models command
Command gen-models reads upstream pi's `packages/ai/src/models.generated.ts` and emits `ai/models_generated.go` with a parallel registry.
Command gen-models reads upstream pi's `packages/ai/src/models.generated.ts` and emits `ai/models_generated.go` with a parallel registry.
pig command
Command pig provides the PiG coding agent CLI.
Command pig provides the PiG coding agent CLI.
Package coding is the public SDK for embedding the pig coding agent as a Go library.
Package coding is the public SDK for embedding the pig coding agent as a Go library.
extension
Package extension defines the contract every pig extension speaks.
Package extension defines the contract every pig extension speaks.
extension/extensiontest
Package extensiontest provides test doubles for the extension.API surface.
Package extensiontest provides test doubles for the extension.API surface.
extension/host/cellpack
Package cellpack is the Piglet-Binary-side counterpart to the host's prebuilt-cell seam (runtimecell.PrebuiltResolver).
Package cellpack is the Piglet-Binary-side counterpart to the host's prebuilt-cell seam (runtimecell.PrebuiltResolver).
extension/host/fusepack
Package fusepack holds Go extensions fused into a Piglet Binary.
Package fusepack holds Go extensions fused into a Piglet Binary.
extension/host/inproc
Package inproc implements the in-process Go dispatch runner for extensions.
Package inproc implements the in-process Go dispatch runner for extensions.
extension/host/runtimecell
Package runtimecell builds and resolves packed extension runtime cells.
Package runtimecell builds and resolves packed extension runtime cells.
extension/host/subprocess
Package subprocess implements pig's out-of-process extension transport: extensions communicate over a local stream socket with length-prefixed JSON framing.
Package subprocess implements pig's out-of-process extension transport: extensions communicate over a local stream socket with length-prefixed JSON framing.
extension/installresolver
Package installresolver is Pig's product-neutral seam for contributed package-source behavior.
Package installresolver is Pig's product-neutral seam for contributed package-source behavior.
extension/pigsdk
Package pigsdk stages Pig's extension SDKs (Go, Python, and Rust) into the config root so out-of-tree extension builds and packed runtime cells can use the API that matches the running binary.
Package pigsdk stages Pig's extension SDKs (Go, Python, and Rust) into the config root so out-of-tree extension builds and packed runtime cells can use the API that matches the running binary.
extension/source
Package source resolves an authorized extension path into one conventional factory or exact isolated standalone definition.
Package source resolves an authorized extension path into one conventional factory or exact isolated standalone definition.
hookconfig
Package hookconfig parses and validates command hook files shared by Package validation and the runtime hook bridge.
Package hookconfig parses and validates command hook files shared by Package validation and the runtime hook bridge.
packagecontent
Package packagecontent discovers resources exposed by Pi packages and cross-harness plugin manifests.
Package packagecontent discovers resources exposed by Pi packages and cross-harness plugin manifests.
piglet
Package piglet provides piglet-based capability scoping for pig sessions.
Package piglet provides piglet-based capability scoping for pig sessions.
piglet/artifact
Package artifact defines executable Piglet component plans and artifact records.
Package artifact defines executable Piglet component plans and artifact records.
piglet/release
Package release verifies and installs signed Piglet Binary releases.
Package release verifies and installs signed Piglet Binary releases.
piglet/signature
Package signature signs and verifies Piglet Binaries.
Package signature signs and verifies Piglet Binaries.
pigletbuild
Package pigletbuild validates Piglet closure and builds source or binary Piglet artifacts.
Package pigletbuild validates Piglet closure and builds source or binary Piglet artifacts.
pigletbuild/binarypiglet
Package binarypiglet holds the Piglet and resolution record embedded in a Piglet Binary.
Package binarypiglet holds the Piglet and resolution record embedded in a Piglet Binary.
pigversion
Package pigversion provides PiG and upstream Pi version pins to packages that cannot import coding.
Package pigversion provides PiG and upstream Pi version pins to packages that cannot import coding.
rpcclient
Package rpcclient is a Go client for `pig --mode rpc`: it spawns the agent in RPC mode and provides a typed API for all operations.
Package rpcclient is a Go client for `pig --mode rpc`: it spawns the agent in RPC mode and provides a typed API for all operations.
secretresolver
Package secretresolver provides the product-neutral resolver seam for typed Piglet secret refs.
Package secretresolver provides the product-neutral resolver seam for typed Piglet secret refs.
source
Package source parses the source-reference vocabulary shared by package installation and Pig piglet resource origins.
Package source parses the source-reference vocabulary shared by package installation and Pig piglet resource origins.
examples
sdk command
Command sdk-example is a minimal demonstration of embedding the pig coding agent as a Go library via the public `coding` package.
Command sdk-example is a minimal demonstration of embedding the pig coding agent as a Go library via the public `coding` package.
extensions
sdk-py
Package pysdk carries the Python extension SDK sources so an installed pig can stage a buildable copy to disk.
Package pysdk carries the Python extension SDK sources so an installed pig can stage a buildable copy to disk.
sdk-rs
Package rssdk carries the Rust extension SDK sources so an installed pig can stage a buildable copy to disk.
Package rssdk carries the Rust extension SDK sources so an installed pig can stage a buildable copy to disk.
sdk module
internal
buildprogress
Package buildprogress reports product-neutral diagnostics for explicit builds.
Package buildprogress reports product-neutral diagnostics for explicit builds.
chord
Package chord is the local Go runtime for the subset of Pi 0.87.1's packages/chord that the experimental service graph consumes: replicated state, the remote service provider and its endpoint, the operation-stream replica binding, and JSON-copy transports.
Package chord is the local Go runtime for the subset of Pi 0.87.1's packages/chord that the experimental service graph consumes: replicated state, the remote service provider and its endpoint, the operation-stream replica binding, and JSON-copy transports.
codingagent
Model picker auth-filter scope toggle.
Model picker auth-filter scope toggle.
codingagent/compaction
Branch summarization for tree navigation.
Branch summarization for tree navigation.
codingagent/export
Package export provides HTML session export.
Package export provides HTML session export.
codingagent/frontmatter
Package frontmatter parses YAML frontmatter blocks from markdown files.
Package frontmatter parses YAML frontmatter blocks from markdown files.
codingagent/llama
Package llama ports Pi's built-in llama.cpp extension (packages/coding-agent/src/extensions/llama/): the router HTTP/SSE client, Hugging Face search and download, the dynamic provider, the manager UI, and the /llama command.
Package llama ports Pi's built-in llama.cpp extension (packages/coding-agent/src/extensions/llama/): the router HTTP/SSE client, Hugging Face search and download, the dynamic provider, the manager UI, and the /llama command.
codingagent/prompts
Package prompts builds the default coding-agent system prompt.
Package prompts builds the default coding-agent system prompt.
codingagent/tools
tools/bash_executor.go: user bash execution (!cmd, RPC bash, SDK ExecuteBash).
tools/bash_executor.go: user bash execution (!cmd, RPC bash, SDK ExecuteBash).
configvalue
Package configvalue mirrors upstream pi's packages/coding-agent/src/core/resolve-config-value.ts (v0.78.1).
Package configvalue mirrors upstream pi's packages/coding-agent/src/core/resolve-config-value.ts (v0.78.1).
crossspawn
Package crossspawn starts a program the way upstream's spawnProcess does (coding-agent utils/child-process.ts): Node's spawn on Unix, and on Windows the cross-spawn package, which runs a command that is not a .exe or .com file -- such as npm.cmd -- through cmd.exe with every argument escaped for cmd.exe.
Package crossspawn starts a program the way upstream's spawnProcess does (coding-agent utils/child-process.ts): Node's spawn on Unix, and on Windows the cross-spawn package, which runs a command that is not a .exe or .com file -- such as npm.cmd -- through cmd.exe with every argument escaped for cmd.exe.
experimental
Package experimental implements the opt-in local process transport used by Pi's experimental server.
Package experimental implements the opt-in local process transport used by Pi's experimental server.
experimental/mini/shared
Package shared implements mini's local service protocol and transports.
Package shared implements mini's local service protocol and transports.
experimental/services
Package services contains the opt-in experimental presentation service contracts.
Package services contains the opt-in experimental presentation service contracts.
imageprocessing
Image resize + re-encode policy for CLI/LLM image attachments, plus the EXIF orientation reader (upstream exif-orientation.ts).
Image resize + re-encode policy for CLI/LLM image attachments, plus the EXIF orientation reader (upstream exif-orientation.ts).
latex
Package latex renders a basic subset of LaTeX math as terminal-friendly Unicode text.
Package latex renders a basic subset of LaTeX math as terminal-friendly Unicode text.
managementhttp
Package managementhttp ports upstream coding-agent utils/management-http.ts: a bounded immediate retry for idempotent management requests (tool downloads, release lookups).
Package managementhttp ports upstream coding-agent utils/management-http.ts: a bounded immediate retry for idempotent management requests (tool downloads, release lookups).
mermaid
Package mermaid renders Mermaid diagrams as Unicode box-drawing art for terminals.
Package mermaid renders Mermaid diagrams as Unicode box-drawing art for terminals.
nativeplatform
Package nativeplatform provides the operating-system queries that upstream Pi loads from its per-platform N-API helpers (packages/tui/src/native-platform.ts).
Package nativeplatform provides the operating-system queries that upstream Pi loads from its per-platform N-API helpers (packages/tui/src/native-platform.ts).
nodeurl
Package nodeurl ports the parts of Node's url module that PiG needs to match Pi: the WHATWG host parser for file URLs and url.fileURLToPath.
Package nodeurl ports the parts of Node's url module that PiG needs to match Pi: the WHATWG host parser for file URLs and url.fileURLToPath.
ownerfile
Package ownerfile makes files accessible to their owner only and checks that they are: mode 0600 and no group or other bits on POSIX, and on Windows, which has no mode bits, a DACL (D68).
Package ownerfile makes files accessible to their owner only and checks that they are: mode 0600 and no group or other bits on POSIX, and on Windows, which has no mode bits, a DACL (D68).
pigdocs
Package pigdocs materializes the reference documentation embedded in Stock Pig under the user's config root (`~/.pig/docs` by default).
Package pigdocs materializes the reference documentation embedded in Stock Pig under the user's config root (`~/.pig/docs` by default).
pigsdklock
Package pigsdklock coordinates readers and writers of staged Pig extension SDKs within one configuration root.
Package pigsdklock coordinates readers and writers of staged Pig extension SDKs within one configuration root.
profiling
Package profiling writes Go runtime profiles when PIG_PROFILE names them.
Package profiling writes Go runtime profiles when PIG_PROFILE names them.
shellconfig
Package shellconfig resolves the bash shell PiG runs commands through, mirroring upstream packages/coding-agent/src/utils/shell.ts getShellConfig and getBashShellConfig.
Package shellconfig resolves the bash shell PiG runs commands through, mirroring upstream packages/coding-agent/src/utils/shell.ts getShellConfig and getBashShellConfig.
testbudget
Package testbudget sizes the deadlines tests use to bound a hang.
Package testbudget sizes the deadlines tests use to bound a hang.
testenv
Package testenv checks host capabilities a test needs, so a test runs wherever the host provides them and says why it skipped where the host does not.
Package testenv checks host capabilities a test needs, so a test runs wherever the host provides them and says why it skipped where the host does not.
text
Package text ports upstream packages/coding-agent/src/utils/text.ts: the leading byte order mark helpers every Pi reader applies before parsing user-authored JSON, markdown, and text files.
Package text ports upstream packages/coding-agent/src/utils/text.ts: the leading byte order mark helpers every Pi reader applies before parsing user-authored JSON, markdown, and text files.
toolchain
Package toolchain locates the build tools PiG uses for compiled extension cells and Piglet Binaries, and installs a PiG-managed Go toolchain for users who installed only the pig binary.
Package toolchain locates the build tools PiG uses for compiled extension cells and Piglet Binaries, and installs a PiG-managed Go toolchain for users who installed only the pig binary.
parity
closure
Package closure stores and verifies the evidence graph used to assess PiG's correspondence with the pinned Pi source.
Package closure stores and verifies the evidence graph used to assess PiG's correspondence with the pinned Pi source.
cmd/asynccheck command
Command asynccheck proves that every upstream source file with Promise/async behavior has an explicit cross-language disposition and durable evidence.
Command asynccheck proves that every upstream source file with Promise/async behavior has an explicit cross-language disposition and durable evidence.
cmd/checkparityran command
Command checkparityran answers one question: did the parity suite actually compare pig against a real pi, or did it just skip?
Command checkparityran answers one question: did the parity suite actually compare pig against a real pi, or did it just skip?
cmd/closure command
cmd/coverage command
Command coverage produces a markdown report linking parity scenarios to PORT_MAP.md entries.
Command coverage produces a markdown report linking parity scenarios to PORT_MAP.md entries.
cmd/customfactoryledger command
Command customfactoryledger derives the internal custom-UI factory draft ledger from the pinned upstream public interface inventory.
Command customfactoryledger derives the internal custom-UI factory draft ledger from the pinned upstream public interface inventory.
cmd/familygaps command
Command familygaps reports, for one behavior family, which upstream PORT_MAP entries fall within its scope and which lack behavioral verification.
Command familygaps reports, for one behavior family, which upstream PORT_MAP entries fall within its scope and which lack behavioral verification.
cmd/lint command
Command lint validates parity scenarios against quality rules that AGENTS.md declares.
Command lint validates parity scenarios against quality rules that AGENTS.md declares.
cmd/newscenario command
cmd/porter command
cmd/portreconcile command
Command portreconcile produces the honest gap ledger for the Pig port.
Command portreconcile produces the honest gap ledger for the Pig port.
cmd/testinventorycheck command
Command testinventorycheck validates the reviewed disposition mapping over the upstream-test inventory.
Command testinventorycheck validates the reviewed disposition mapping over the upstream-test inventory.
cmd/upstreamdelta command
Command upstreamdelta proves that every changed upstream source file in a version leap received an explicit disposition and durable evidence.
Command upstreamdelta proves that every changed upstream source file in a version leap received an explicit disposition and durable evidence.
correspondence
Package correspondence compares pinned Pi source interfaces with PiG targets and produces deterministic review packets.
Package correspondence compares pinned Pi source interfaces with PiG targets and produces deterministic review packets.
internal/gitsnapshot
Package gitsnapshot resolves and validates immutable Git tree identities for parity evidence.
Package gitsnapshot resolves and validates immutable Git tree identities for parity evidence.
knowngaps
Package knowngaps loads parity/known-gaps.toml, the one ledger of parity gaps that gates tolerate against the pinned Pi version.
Package knowngaps loads parity/known-gaps.toml, the one ledger of parity gaps that gates tolerate against the pinned Pi version.
porter
Package porter exposes the single deterministic process contract used by the direct Porter adapter and the Pig Porter extension.
Package porter exposes the single deterministic process contract used by the direct Porter adapter and the Pig Porter extension.
tests
extension-conformance/testfixture
Command sdk-fixture is a minimal SDK-based extension for integration testing.
Command sdk-fixture is a minimal SDK-based extension for integration testing.
extension-conformance/testfixture/cmd command
Command sdk-fixture runs the canonical Go SDK conformance extension over a subprocess socket.
Command sdk-fixture runs the canonical Go SDK conformance extension over a subprocess socket.
integration
Package integration holds end-to-end tests that drive the real `pig` binary through a tmux PTY and assert on captured pane output.
Package integration holds end-to-end tests that drive the real `pig` binary through a tmux PTY and assert on captured pane output.
upstream-parity
Package parity parses upstream pi TypeScript declarations to drive parity tests.
Package parity parses upstream pi TypeScript declarations to drive parity tests.
tui
Package tui provides Pi-compatible terminal rendering, input, components, keybindings, and screen lifecycle management.
Package tui provides Pi-compatible terminal rendering, input, components, keybindings, and screen lifecycle management.
parity
Package parity provides the test harness for TUI byte-level and visible-state parity against upstream pi-tui.
Package parity provides the test harness for TUI byte-level and visible-state parity against upstream pi-tui.
termsim
Package termsim is a headless ANSI terminal simulator for byte-level parity testing.
Package termsim is a headless ANSI terminal simulator for byte-level parity testing.
widthx
Package widthx implements upstream pi-tui's visibleWidth + ANSI escape extraction with byte-level fidelity to the TypeScript algorithm.
Package widthx implements upstream pi-tui's visibleWidth + ANSI escape extraction with byte-level fidelity to the TypeScript algorithm.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL