Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -34,15 +34,15 @@ jobs:
run: |
docker pull ghcr.io/viperproject/gobra@sha256:5e96431b06c2e6209aa767df9153bb4cf8b2620598598f1d7d3f3a74c09c14f9
mkdir -p dist/extracted
tar -xzf "dist/first/pdd-kit-go_${RELEASE_VERSION}_linux_amd64.tar.gz" -C dist/extracted
tar -xzf "dist/first/proofsteer-go_${RELEASE_VERSION}_linux_amd64.tar.gz" -C dist/extracted
python3 - <<'PYTHON'
import json, os, pathlib
policy = json.loads(os.environ['TRUSTED_REVIEW_POLICY_JSON'])
(pathlib.Path(os.environ['RUNNER_TEMP']) / 'review-policy.json').write_text(json.dumps(policy))
PYTHON
python3 scripts/smoke.py --pdd "dist/extracted/pdd-kit-go_${RELEASE_VERSION}_linux_amd64/pdd" --version "$RELEASE_VERSION" --policy "$RUNNER_TEMP/review-policy.json"
python3 scripts/smoke.py --pdd "dist/extracted/proofsteer-go_${RELEASE_VERSION}_linux_amd64/pdd" --version "$RELEASE_VERSION" --policy "$RUNNER_TEMP/review-policy.json"
- uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
with:
name: pdd-kit-go-${{ inputs.version }}
name: proofsteer-go-${{ inputs.version }}
path: dist/first/
if-no-files-found: error
2 changes: 2 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@

## v0.4.0

- Adopt the ProofSteer name and the `proofsteer-go` Go module path. The CLI is still `pdd`.

- Bundle the reviewed login example in `pdd demo` for first-time users.
- Show current check verdicts, negative examples and log links in HTML reports.
- Run named Playwright tests and record first-attempt results, screenshots and traces.
Expand Down
2 changes: 1 addition & 1 deletion LICENSE
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
MIT License

Copyright (c) 2026 pdd-kit-go contributors
Copyright (c) 2026 ProofSteer contributors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
Expand Down
12 changes: 6 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
# pdd-kit-go
# ProofSteer

**Prove the Go decisions you need to get right.**
**Proof-Driven Development for Go.**

When a change touches who can sign in, what can be authorized, or when a balance can be debited, examples alone leave cases unchecked. Write the rule as a contract on the production Go function. `pdd` runs Gobra to check it, runs Go tests for the surrounding code, and writes a receipt you can bring to code review.

Start with one decision in an existing Go project. The core workflow works without an LLM account.

[View live report examples](https://pdd-kit-go-demo.cruskell.chatgpt.site) · [Try the login example](#try-it) · [Use it in your project](#use-it-in-your-project) · [Download pdd](https://github.com/cruskell/pdd-kit-go/releases/tag/v0.4.0)
[View live report examples](https://proofsteer-demo.cruskell.chatgpt.site) · [Try the login example](#try-it) · [Use it in your project](#use-it-in-your-project) · [Download pdd](https://github.com/cruskell/proofsteer-go/releases/tag/v0.4.0)

## What a proof catches

Expand All @@ -23,10 +23,10 @@ An implementation that always returns `false` satisfies a rejection-only rule. I

## Try it

Use Go 1.20 or newer and Docker on a 64-bit host. Put the Go install directory on your `PATH`, or use the [checksummed binaries](https://github.com/cruskell/pdd-kit-go/releases/tag/v0.4.0). To use a local Gobra JAR, see [troubleshooting](docs/troubleshooting.md).
Use Go 1.20 or newer and Docker on a 64-bit host. Put the Go install directory on your `PATH`, or use the [checksummed binaries](https://github.com/cruskell/proofsteer-go/releases/tag/v0.4.0). To use a local Gobra JAR, see [troubleshooting](docs/troubleshooting.md).

```sh
go install github.com/cruskell/pdd-kit-go/cmd/pdd@v0.4.0
go install github.com/cruskell/proofsteer-go/cmd/pdd@v0.4.0
pdd demo
```

Expand Down Expand Up @@ -71,7 +71,7 @@ If you already work with a coding agent, `pdd draft` can turn a request into an
- **Go and browser tests provide evidence for the cases they run.** The receipt labels them separately from proofs. Each planned negative mutation must fail on the intended postcondition. A missing test, tool failure, or inconclusive mutation fails verification. [Design](docs/design.md)
- **Receipts tie the result to the reviewed change.** Machine-readable JSON and Markdown include the plan and source digests, commands, outcomes, trust assumptions, and links or references to saved logs. `status` rejects stale evidence. Use Ed25519 approvals with a trusted policy when CI needs to verify reviewer authority. [JSON protocol](docs/cli-json.md) · [Signed reviews](docs/signed-reviews.md)

`pdd-kit-go` is an independent implementation of ideas from the Proof-Driven Development Kit research prototype. Its Go verifier is Gobra. [Original PDD Kit](https://githubnext.com/projects/pdd-kit/) · [Feature comparison and limits](docs/reference-comparison.md)
ProofSteer is an independent implementation of ideas from the Proof-Driven Development Kit research prototype. Its Go verifier is Gobra. [Original PDD Kit](https://githubnext.com/projects/pdd-kit/) · [Feature comparison and limits](docs/reference-comparison.md)

## Development

Expand Down
2 changes: 1 addition & 1 deletion cmd/pdd/main.go
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ import (
"os"
"runtime/debug"

"github.com/cruskell/pdd-kit-go/internal/cli"
"github.com/cruskell/proofsteer-go/internal/cli"
)

// Set by release builds. go install @version obtains the module version below.
Expand Down
2 changes: 1 addition & 1 deletion demo_files.go
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
package pddkit
package proofsteer

import (
"embed"
Expand Down
2 changes: 1 addition & 1 deletion docs/cli-output.schema.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://github.com/cruskell/pdd-kit-go/docs/cli-output.schema.json",
"$id": "https://github.com/cruskell/proofsteer-go/docs/cli-output.schema.json",
"title": "pdd CLI response envelope, version 1",
"type": "object",
"additionalProperties": false,
Expand Down
4 changes: 2 additions & 2 deletions docs/distribution.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
# Install and reproduce a release

Versioned binaries and checksums are published on [GitHub Releases](https://github.com/cruskell/pdd-kit-go/releases).
Versioned binaries and checksums are published on [GitHub Releases](https://github.com/cruskell/proofsteer-go/releases).
Go users can install the tagged CLI directly:

```sh
go install github.com/cruskell/pdd-kit-go/cmd/pdd@v0.4.0
go install github.com/cruskell/proofsteer-go/cmd/pdd@v0.4.0
pdd --version
```

Expand Down
2 changes: 1 addition & 1 deletion docs/first-project.md
Original file line number Diff line number Diff line change
Expand Up @@ -82,7 +82,7 @@ A GitHub Actions job can run these steps after checkout and Go setup:

```yaml
- name: Install PDD
run: go install github.com/cruskell/pdd-kit-go/cmd/pdd@v0.4.0
run: go install github.com/cruskell/proofsteer-go/cmd/pdd@v0.4.0
- name: Verify reviewed inventory policy
run: |
pdd import-approval --from .pdd/reviewed-inventory.json
Expand Down
2 changes: 1 addition & 1 deletion docs/production-readiness.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ that team's workflow. No finite demo run can establish long-term operating histo
or universal support for arbitrary Go applications. Unsupported proof inputs must
continue to fail explicitly rather than being passed off as verified libraries.

Observed native qualification: [Check run 44099596974](https://github.com/cruskell/pdd-kit-go/actions/runs/44099596974)
Observed native qualification: [Check run 44099596974](https://github.com/cruskell/proofsteer-go/actions/runs/44099596974)
passed Linux, macOS and Windows race/CLI/process tests, real verifier integrations
and the signed-authority job. The current authenticated gate covers both the
permission-aware slice core and the HTTP wallet with three repeated proofs per
Expand Down
2 changes: 1 addition & 1 deletion examples/authorization/handler/handler.go
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
package handler

import "github.com/cruskell/pdd-kit-go/examples/authorization/policy"
import "github.com/cruskell/proofsteer-go/examples/authorization/policy"

// @ ensures result == (enabled && age >= minimum && !locked)
func Authorize(enabled bool, minimum, age int, locked bool) (result bool) {
Expand Down
2 changes: 1 addition & 1 deletion examples/authorization/handler/handler_test.go
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
package handler

import (
"github.com/cruskell/pdd-kit-go/examples/authorization/policy"
"github.com/cruskell/proofsteer-go/examples/authorization/policy"
"testing"
)

Expand Down
2 changes: 1 addition & 1 deletion examples/httpwallet/app/handler.go
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ import (
"strings"
"sync"

"github.com/cruskell/pdd-kit-go/examples/httpwallet/policy"
"github.com/cruskell/proofsteer-go/examples/httpwallet/policy"
)

type Session struct {
Expand Down
2 changes: 1 addition & 1 deletion examples/httpwallet/app/handler_test.go
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ import (
"sync/atomic"
"testing"

"github.com/cruskell/pdd-kit-go/examples/httpwallet/app"
"github.com/cruskell/proofsteer-go/examples/httpwallet/app"
)

func configured() *app.Handler {
Expand Down
2 changes: 1 addition & 1 deletion examples/httpwallet/cmd/wallet/main.go
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ import (
"syscall"
"time"

"github.com/cruskell/pdd-kit-go/examples/httpwallet/app"
"github.com/cruskell/proofsteer-go/examples/httpwallet/app"
)

//go:embed wallet.html
Expand Down
2 changes: 1 addition & 1 deletion go.mod
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
module github.com/cruskell/pdd-kit-go
module github.com/cruskell/proofsteer-go

go 1.20
4 changes: 2 additions & 2 deletions internal/cli/cli.go
Original file line number Diff line number Diff line change
Expand Up @@ -14,10 +14,10 @@ import (
"syscall"
"time"

"github.com/cruskell/pdd-kit-go/internal/pdd"
"github.com/cruskell/proofsteer-go/internal/pdd"
)

const help = `pdd — Proof-Driven Development for Go
const help = `ProofSteer — Proof-Driven Development for Go

Usage: pdd [--cwd DIR] [--plan NAME] [--json] <command> [options]

Expand Down
6 changes: 3 additions & 3 deletions internal/cli/demo.go
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,8 @@ import (
"os"
"path/filepath"

pddkit "github.com/cruskell/pdd-kit-go"
"github.com/cruskell/pdd-kit-go/internal/pdd"
proofsteer "github.com/cruskell/proofsteer-go"
"github.com/cruskell/proofsteer-go/internal/pdd"
)

type demoResult struct {
Expand All @@ -26,7 +26,7 @@ func runDemo(ctx context.Context, printer output, destination string, options pd
if err := os.Mkdir(destination, 0755); err != nil {
return fail(fmt.Errorf("create a new demo directory: %w", err))
}
files := pddkit.DemoFiles()
files := proofsteer.DemoFiles()
if err := fs.WalkDir(files, ".", func(name string, entry fs.DirEntry, err error) error {
if err != nil || entry.IsDir() {
return err
Expand Down
2 changes: 1 addition & 1 deletion internal/cli/review.go
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ import (
"io"
"strings"

"github.com/cruskell/pdd-kit-go/internal/pdd"
"github.com/cruskell/proofsteer-go/internal/pdd"
)

func renderReview(out io.Writer, report pdd.ReviewReport, diff bool) {
Expand Down
2 changes: 1 addition & 1 deletion internal/cli/workflow.go
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ import (
"syscall"
"time"

"github.com/cruskell/pdd-kit-go/internal/pdd"
"github.com/cruskell/proofsteer-go/internal/pdd"
)

func workflowCommand(c string) bool {
Expand Down
2 changes: 1 addition & 1 deletion internal/pdd/dashboard.html
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>{{.Draft.Plan.Name}} · PDD review</title>
<title>{{.Draft.Plan.Name}} · ProofSteer</title>
<style>
:root { color-scheme: light; --text:#142638; --muted:#4d6072; --line:#d8e2e9; --bg:#f5f8fa; --link:#125883; }
* { box-sizing:border-box; }
Expand Down
2 changes: 2 additions & 0 deletions internal/pdd/signing.go
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,8 @@ type PublicIdentity struct {
PublicKey string `json:"public_key"`
}

// The v1 domain separator is part of the signed bytes. Retain it to verify
// approvals recorded before the rename.
func approvalMessage(a Approval) ([]byte, error) {
a.Signature = nil
data, err := json.Marshal(a)
Expand Down
6 changes: 3 additions & 3 deletions scripts/release.py
Original file line number Diff line number Diff line change
Expand Up @@ -43,11 +43,11 @@ def main():
commit = run("git", "rev-parse", "HEAD")
flags = ["-trimpath", "-buildvcs=false", "-ldflags=-s -w -X main.version=" + args.version]
license_bytes = (ROOT / "LICENSE").read_bytes()
install = ("pdd-kit-go " + args.version + "\n\n"
install = ("ProofSteer " + args.version + "\n\n"
"Verify SHA256SUMS before extracting; place pdd (pdd.exe on Windows) on PATH.\n"
"Run pdd --version and pdd --help. Go is needed for empirical tests;\n"
"formal verification needs Docker and the pinned Gobra image (pdd doctor).\n"
"Source, examples and full instructions:\nhttps://github.com/cruskell/pdd-kit-go\n"
"Source, examples and full instructions:\nhttps://github.com/cruskell/proofsteer-go\n"
"Use --policy with authorized signed reviews for production CI; read trust boundaries.\n").encode()
for system, arch in TARGETS:
name = "pdd.exe" if system == "windows" else "pdd"
Expand All @@ -56,7 +56,7 @@ def main():
subprocess.run([go, "build", *flags, "-o", str(binary), "./cmd/pdd"], cwd=ROOT, env=target_env, check=True)
files = [(name, binary.read_bytes(), 0o755), ("LICENSE", license_bytes, 0o644), ("INSTALL.txt", install, 0o644)]
binary.unlink()
prefix = f"pdd-kit-go_{args.version}_{system}_{arch}"
prefix = f"proofsteer-go_{args.version}_{system}_{arch}"
if system == "windows":
with zipfile.ZipFile(out / (prefix + ".zip"), "w", compression=zipfile.ZIP_STORED) as archive:
for filename, data, mode in files:
Expand Down
Loading