Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
102 commits
Select commit Hold shift + click to select a range
7203d28
feat: add public product passport
nstranquist Aug 19, 2026
8e3b1cc
fix(env): reject mismatched worktree identity
nstranquist Aug 21, 2026
bfb7e98
docs(errors): explain worktree mismatch recovery
nstranquist Aug 21, 2026
b36be1b
docs(readme): require the lane-bound checkout
nstranquist Aug 21, 2026
b7e77a2
docs(skill): enforce lane-bound environment use
nstranquist Aug 21, 2026
5bd2f8f
feat(capture): add reviewed agent workflow
nstranquist Aug 18, 2026
e17a061
docs(capture): define operational handoff contracts
nstranquist Aug 18, 2026
f75ec5c
feat(skill): teach reviewed capture workflow
nstranquist Aug 18, 2026
430adad
chore(capture): remove dead plan helper
nstranquist Aug 18, 2026
4bf1313
fix(capture): harden agent workflow boundaries
nstranquist Aug 18, 2026
d6682c9
test(schema): validate published command contracts
nstranquist Aug 18, 2026
b93c979
docs(capture): explain atomic agent handoff workflow
nstranquist Aug 18, 2026
7770b62
docs(capture): record protected landing handoff
nstranquist Aug 18, 2026
2133595
feat(version): report exact build provenance
nstranquist Aug 21, 2026
da1497e
docs(readme): explain source-stamped binaries
nstranquist Aug 21, 2026
b344042
build(release): stamp binary source identity
nstranquist Aug 21, 2026
1e32062
docs(skill): require source-stamped identity
nstranquist Aug 21, 2026
07fa113
fix(archive): make scoped replay explicit
nstranquist Aug 21, 2026
e4c8829
docs(errors): explain scoped archive replay
nstranquist Aug 21, 2026
21cf6f8
docs(readme): repeat archive lane filters
nstranquist Aug 21, 2026
6434d3f
docs(skill): require archive lane filter replay
nstranquist Aug 21, 2026
8ba79a9
fix(init): abort safe pre-lane recovery intents
nstranquist Aug 21, 2026
6b2be76
fix(init): serialize abort with initialization
nstranquist Aug 21, 2026
0aaf5df
test(wip-commit): add portable behavior benchmark
nstranquist Aug 21, 2026
03c37ec
docs(docs): explain portable behavior proof
nstranquist Aug 21, 2026
101e3a3
ci(ci): run portable behavior benchmark
nstranquist Aug 21, 2026
90a6dae
fix(wip): guide root configuration groups
nstranquist Aug 21, 2026
de05db3
test(wip-commit): cover root configuration plans
nstranquist Aug 21, 2026
16c4029
fix(store): validate rearchived receipt history
nstranquist Aug 21, 2026
1b35803
test(wip): prove repeated archive health
nstranquist Aug 21, 2026
1d6f439
docs(docs): explain repeated archive ownership
nstranquist Aug 21, 2026
981e827
docs(docs): guide repeated archive maintenance
nstranquist Aug 21, 2026
ed7f2de
test(wip): expose concurrent capture failures
nstranquist Aug 17, 2026
2414d0f
ci(windows): stress concurrent lane capture
nstranquist Aug 17, 2026
6916ba2
fix(store): fence concurrent record reads
nstranquist Aug 17, 2026
460b822
docs(store): explain record registry fence
nstranquist Aug 17, 2026
0169280
docs(changelog): record Windows registry fix
nstranquist Aug 17, 2026
8a204ca
build(deps): bump actions/attest from 4.2.1 to 4.2.2
dependabot[bot] Aug 17, 2026
c2d543c
test(release): track attest v4.2.2 pin
nstranquist Aug 17, 2026
e2bc42a
docs(release): record hosted publication evidence
nstranquist Aug 17, 2026
d551f3d
feat(release): add hosted correction verifier
nstranquist Aug 17, 2026
4a93a79
docs(release): define correction receipt procedure
nstranquist Aug 17, 2026
adac4e9
docs(release): record correction receipt evidence
nstranquist Aug 17, 2026
e43a07a
docs(community): add conduct reporting
nstranquist Aug 17, 2026
97aaffa
docs(onboarding): complete adopter journey
nstranquist Aug 17, 2026
a4e167d
docs(dogfood): record installed workflow proof
nstranquist Aug 21, 2026
fd24820
docs(dogfood): record archive replay closure
nstranquist Aug 21, 2026
06eaaa1
docs(integration): normalize decision identifiers
nstranquist Aug 23, 2026
c4623fd
fix(lock): make zero wait fail fast
nstranquist Aug 23, 2026
46e1e38
feat(protocol): harden standalone coordination upgrades
nstranquist Aug 23, 2026
4d7b2af
fix(skill): route legacy marker upgrades
nstranquist Aug 23, 2026
30e6692
fix(doctor): stop routing on legacy marker
nstranquist Aug 23, 2026
0da1a10
docs(changelog): record protocol v3 consolidation
nstranquist Aug 24, 2026
c223b08
feat(wip): expose reviewed capture and migration commands
nstranquist Aug 24, 2026
ca5fe07
docs(protocol): define canonical capture and migration workflow
nstranquist Aug 24, 2026
6ef416e
docs(examples): show the protocol v3 agent workflow
nstranquist Aug 24, 2026
3ba856e
feat(contract): publish the protocol v3 capability bundle
nstranquist Aug 24, 2026
1cce50f
feat(migration): add digest-bound coordination cutover
nstranquist Aug 24, 2026
91d2478
feat(engine): harden source-bound capture transactions
nstranquist Aug 24, 2026
51ce8a9
fix(gitx): confine repository discovery and git execution
nstranquist Aug 24, 2026
1bebd8e
feat(store): enforce reader floors and writer fences
nstranquist Aug 24, 2026
8308b74
test(capture): lock the public capture schema
nstranquist Aug 24, 2026
b3e68e6
test(docs): keep protocol documents synchronized
nstranquist Aug 24, 2026
33a7942
test(version): bind the release corpus to one version
nstranquist Aug 24, 2026
a78c0d5
docs(security): align guidance with capture-only authority
nstranquist Aug 24, 2026
c304e25
build(release): verify source-bound publication evidence
nstranquist Aug 24, 2026
87762f4
feat(wip-commit): ship the portable protocol v3 workflow
nstranquist Aug 24, 2026
3f306b8
fix(engine): capture tracked files below ignored parents
nstranquist Aug 25, 2026
71113c2
fix(engine): resolve verifier scratch root physically
nstranquist Aug 25, 2026
7c68cb8
refactor(wip): remove obsolete archive helper
nstranquist Aug 26, 2026
2b1a435
fix(migrate): declare dynamic outputs explicitly
nstranquist Aug 26, 2026
965f929
test(wip): retain scale and worktree dogfood
nstranquist Aug 26, 2026
e475f2e
test(filelock): prove Windows replacement fence
nstranquist Aug 26, 2026
620e371
fix(coordmigration): publish canonical NDev review domain
nstranquist Aug 26, 2026
1114ffe
fix(atomicfile): finalize read-only Windows creates
nstranquist Aug 26, 2026
40e31fa
fix(coordmigration): normalize immutable Windows state
nstranquist Aug 26, 2026
43cf2f7
fix(coordmigration): archive empty legacy v2 scaffold
nstranquist Aug 27, 2026
c2f1d15
docs(security): refresh migration source review
nstranquist Aug 27, 2026
5526c6b
docs(migration): define stale-lane archive policy
nstranquist Aug 27, 2026
781c3c1
fix(coordmigration): archive stale active lanes
nstranquist Aug 27, 2026
295c8c8
docs(readme): explain stale-lane migration safety
nstranquist Aug 27, 2026
3d3f690
fix(wip): report empty handoff as not ready
nstranquist Aug 27, 2026
14f9251
docs(changelog): record migration status contract
nstranquist Aug 27, 2026
dba35e1
docs(migration): record completed status contract
nstranquist Aug 27, 2026
0aa9348
fix(migration): accept post-cutover store advances
nstranquist Aug 27, 2026
314c9c2
docs(security): define completed migration evidence
nstranquist Aug 27, 2026
38210cf
docs(architecture): define copied-hook read-only mode
nstranquist Aug 28, 2026
2a6200a
fix(engine): force read-only mode for copied hooks
nstranquist Aug 28, 2026
088fca9
docs(safety): explain copied-hook read-only boundary
nstranquist Aug 28, 2026
803c7df
fix(wip): keep released handoffs byte-identical
nstranquist Aug 28, 2026
9f8f633
fix(wip): retain rollback binaries before upgrade
nstranquist Aug 28, 2026
0cb77f1
docs(upgrade): document retained binary revisions
nstranquist Aug 28, 2026
bcfc210
docs(changelog): record capture boundary hardening
nstranquist Aug 27, 2026
03aef6e
fix(init): anchor linked-worktree recovery
nstranquist Aug 27, 2026
e7f921d
docs(security): record capture boundary review
nstranquist Aug 27, 2026
c95d358
feat(contract): advertise hardened capture inputs
nstranquist Aug 27, 2026
0ccfcc2
fix(engine): bound hook and verifier inputs
nstranquist Aug 27, 2026
ebb25d5
fix(gitx): isolate inherited pathspec modes
nstranquist Aug 27, 2026
5cf342e
docs(readme): explain bounded capture execution
nstranquist Aug 27, 2026
8384e1a
feat(skill): publish hardened capture contract
nstranquist Aug 27, 2026
316b522
fix(integration): reconcile hook contract and skill digest
nstranquist Aug 30, 2026
ddf9635
fix(engine): materialize verify candidates byte-exact on Windows
nstranquist Nov 2, 2026
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
3 changes: 3 additions & 0 deletions .gitattributes
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# The portable skill payload is digest-bound. Keep its bytes identical on every
# platform, including Windows checkouts with core.autocrlf enabled.
skills/wip-commit/** text eol=lf
26 changes: 26 additions & 0 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,9 @@ jobs:
cache: true
- run: go mod verify
- run: go test -count=1 ./...
- name: Stress concurrent shared-lane capture on Windows
if: runner.os == 'Windows'
run: go test -run '^TestConcurrentSharedLanesCaptureDisjointPaths$' -count=25 ./cmd/wip
- run: go vet ./...

race:
Expand All @@ -41,6 +44,29 @@ jobs:
cache: true
- run: go test -race -count=3 ./...

benchmark:
# Run real locks and Git processes on every supported CI operating system.
strategy:
fail-fast: false
matrix:
os: [ubuntu-latest, macos-latest, windows-latest]
runs-on: ${{ matrix.os }}
timeout-minutes: 10
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
persist-credentials: false
- uses: actions/setup-go@b7ad1dad31e06c5925ef5d2fc7ad053ef454303e # v7.0.0
with:
go-version-file: go.mod
cache: true
- name: Prefetch modules before the offline benchmark
run: go mod download
- name: Run portable behavioral benchmark
run: go run ./skills/wip-commit/benchmark/regression.go --out-dir "${{ runner.temp }}/wip-commit-benchmark"
- name: Prove rejection of the weakened candidate
run: go run ./skills/wip-commit/benchmark/regression.go --prove-weakened --out-dir "${{ runner.temp }}/wip-commit-benchmark"

lint:
runs-on: ubuntu-latest
timeout-minutes: 10
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/release-beta.yml
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ jobs:
- name: Build deterministic archives
run: go run ./scripts/release --version "$GITHUB_REF_NAME" --out dist
- name: Attest release files
uses: actions/attest@508db95dd578ae2727ebd6217d5ba78e4fbda05d # v4.2.1
uses: actions/attest@1e69f48acb82d1966a394da916b4c1698aa569d6 # v4.2.2
with:
subject-path: |
dist/*.tar.gz
Expand Down
3 changes: 2 additions & 1 deletion .nicos/product.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ surface: products
kind: product
status: experimental
launch: built
license: MIT
tags:
- go
- git
Expand All @@ -15,5 +16,5 @@ checks:
- go
- test
- ./...
description: Guarded split-commit capture for parallel agents in shared checkouts and linked worktrees.
description: Reviewed, lease-bound Git capture for agents, with operational status and capture-only handoff receipts.
portfolio_manifest: portfolio/manifest.yaml
73 changes: 70 additions & 3 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,22 +5,31 @@ Semantic Versioning.

## [Unreleased]

Planned first prerelease: `v0.1.0-beta.1`.
Planned first prerelease: `v0.2.0-beta.1`.

### Added

- A machine-readable `wip.command/3.0.0` capability contract and a digest-bound
portable-skill contract.
- Preview/apply upgrades for the state marker, installed binary, and portable
skill. Each apply requires the exact reviewed byte digest.
- A version 2 coordination-domain marker with a minimum reader protocol and
required reader capabilities.
- Portable `wip-commit` agent skill with a public-only safety contract.
- Deterministic six-target release builder, checksums, receipt, and attested
prerelease workflow.
- Pinned golangci-lint job for hosted pull-request and branch checks.
- State compatibility policy and explicit upgrade and downgrade procedures.
- Fail-closed, read-only pre-first-push receipt that binds the reviewed
- Fail-closed, read-only pre-first-push receipt. It binds the reviewed
bootstrap, linear split-commit range, complete path delta, public author and
committer identities, object integrity, owner approval, and secret scans.
- Human-only publication handoff for the first hosted pull request, exact CI
check discovery, direct bootstrap fast-forward, and protected-branch setup.
- Fail-closed hosted-correction receipts that bind exact verifier source, local
history, remote refs, pull-request state, no-bypass rulesets, and checks.
- Shared-checkout and detached linked-worktree lanes.
- Exact staged-subset capture through private Git indexes.
- Exact `staged_index` and `worktree_snapshot` capture through private source
snapshots and private Git indexes.
- All-or-nothing split plans with one final ref compare-and-swap.
- Conventional Commit validation, path leases, immutable hooks, bounded
verification, durable intents, and exact reconciliation.
Expand All @@ -29,14 +38,72 @@ Planned first prerelease: `v0.1.0-beta.1`.
- Strict bounded state readers, portable Unicode path identity, and Windows
atomic replacement and file locks.
- NUL-delimited delete/add accounting for renamed paths.
- Operational status with capture-candidate, captured-staged, foreign-staged,
empty-lease, expiry, ref-health, policy, and latest-intent fields, plus a
strict public JSON Schema.
- One version 3 draft/reviewed plan schema with source mode, untracked policy,
source digest, path, lease, lane, and message-policy bindings.
- `wip capture` with a digest-bound version 2 cumulative capture-only handoff
and optional post-handoff lane release.
- A read-only `wip plan --observe` path that does not renew leases, change
repository state, or write an output file.
- A digest-bound coordination migration with shadow comparison, one writer
cutover, forward recovery, rollback before source movement, and a sealed
legacy archive.
- A manifest-bound registry lock that is published before migrated lane and
lease records become readable.
- Immutable `review/v1/handoffs` and `review/v1/plans` storage roots for the
separate review and landing authority.
- Named `conventional-v1` and `safety-only-v1` message policies.
- Automatic complete-set lease renewal on ordinary authenticated lane use.
- Runtime validation of real command data against the published capture JSON
Schemas.
- Version 1 profile and intent compatibility without immutable digest changes.
- Capture-intent schema version 3 with read compatibility for versions 1 and 2.
- Migration status schema version 1.1.0 with separate historical cutover and
current live-store manifest digests.
- A canonical copied-hook environment with capture, phase, target-ref, commit,
and source-read-only markers. Caller values cannot override these markers.
- Reviewed verifier materialization scopes with pre-checkout entry and byte
limits, literal Git pathspecs, and NUL-delimited checkout input.

### Changed

- `wip commit --dry-run` now uses a fail-closed no-exec contract. It snapshots
hooks and constructs the candidate structure without executing repository hooks,
verification commands, publication callbacks, lease renewal, or repository
Git writes.
Result schema 3 reports skipped gates and exact execution counts.
- Source builds now report `0.2.0-dev`. Release builds receive both SemVer and
exact tag identity from the deterministic release builder.
- A zero lock wait now fails after one acquisition attempt. Internal
serialization uses an explicit bounded wait.
- Operational lane and lease reads now use the same registry fence as atomic
record replacement. This prevents Windows sharing violations during capture.
- Unsupported state-directory, lane, lease, intent, and profile schemas now
fail with `MIGRATION_REQUIRED` before the command changes state.
- Interactive initialization now recommends one linked worktree per task.
- Worktree initialization now requires a destination and reports where to
continue. `env` rejects another checkout before lease renewal.
- A worktree initialization retry can start inside its existing linked
worktree. It resolves and reports the primary checkout as the recovery
anchor.
- Handoff validation, active renewal, and final guided release now keep one
continuous lane lock. Completed receipts always revalidate Git objects.
- Handoff output now validates the unique complete lane chain from base to tip.
A requested plan ID must name the tip segment.
- Worktree-source planning now uses a temporary index and object directory. It
leaves the caller index and repository object database unchanged.
- Released-lane handoff locks existing state without rewriting lock metadata
or creating missing lock paths.
- Commit-message naming checks now run as lane policy before hooks. The capture
kernel keeps only message byte, size, and subject safety checks.
- The minimum build toolchain is Go 1.25.12. This patched floor excludes
GO-2026-4602, GO-2026-4864, and GO-2026-4970 from reachable standard-library
paths found by the release vulnerability scan.
- Completed migration status now accepts valid post-cutover writes in the two
live data roots. It keeps exact checks for incomplete migrations and the
static migration envelope.

### Known limitations

Expand Down
151 changes: 151 additions & 0 deletions CODE_OF_CONDUCT.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,151 @@
# Contributor Covenant 3.0 Code of Conduct

## Our Pledge

We pledge to make our community welcoming, safe, and equitable for all.

We are committed to fostering an environment that respects and promotes the
dignity, rights, and contributions of all individuals, regardless of
characteristics including race, ethnicity, caste, color, age, physical
characteristics, neurodiversity, disability, sex or gender, gender identity or
expression, sexual orientation, language, philosophy or religion, national or
social origin, socio-economic position, level of education, or other status.
The same privileges of participation are extended to everyone who participates
in good faith and in accordance with this Covenant.

## Encouraged Behaviors

While acknowledging differences in social norms, we all strive to meet our
community's expectations for positive behavior. We also understand that our
words and actions may be interpreted differently than we intend based on
culture, background, or native language.

With these considerations in mind, we agree to behave mindfully toward each
other and act in ways that center our shared values, including:

1. Respecting the **purpose of our community**, our activities, and our ways of
gathering.
2. Engaging **kindly and honestly** with others.
3. Respecting **different viewpoints** and experiences.
4. **Taking responsibility** for our actions and contributions.
5. Gracefully giving and accepting **constructive feedback**.
6. Committing to **repairing harm** when it occurs.
7. Behaving in other ways that promote and sustain the **well-being of our
community**.

## Restricted Behaviors

We agree to restrict the following behaviors in our community. Instances,
threats, and promotion of these behaviors are violations of this Code of
Conduct.

1. **Harassment.** Violating explicitly expressed boundaries or engaging in
unnecessary personal attention after any clear request to stop.
2. **Character attacks.** Making insulting, demeaning, or pejorative comments
directed at a community member or group of people.
3. **Stereotyping or discrimination.** Characterizing anyone's personality or
behavior on the basis of immutable identities or traits.
4. **Sexualization.** Behaving in a way that would generally be considered
inappropriately intimate in the context or purpose of the community.
5. **Violating confidentiality.** Sharing or acting on someone's personal or
private information without their permission.
6. **Endangerment.** Causing, encouraging, or threatening violence or other
harm toward any person or group.
7. Behaving in other ways that **threaten the well-being** of our community.

### Other Restrictions

1. **Misleading identity.** Impersonating someone else for any reason, or
pretending to be someone else to evade enforcement actions.
2. **Failing to credit sources.** Not properly crediting the sources of content
you contribute.
3. **Promotional materials.** Sharing marketing or other commercial content in
a way that is outside the norms of the community.
4. **Irresponsible communication.** Failing to responsibly present content
which includes, links, or describes any other restricted behaviors.

## Reporting an Issue

Tensions can occur between community members even when they are trying their
best to collaborate. Not every conflict represents a code of conduct
violation, and this Code of Conduct reinforces encouraged behaviors and norms
that can help avoid conflicts and minimize harm.

Use the repository host's private reporting form on the Security tab to report
a possible violation. Start the report title with `Code of Conduct:`. Do not
open a public issue. The repository owner serves as the Community Moderator
and receives these private reports. If a report concerns the repository owner,
use GitHub's content-reporting or support channel instead.

The Community Moderator takes reports of violations seriously and will make
every effort to respond in a timely manner. The moderator will investigate
reports by reviewing relevant messages, logs, recordings, or witness accounts.
The moderator will keep investigation and enforcement actions as transparent
as possible while prioritizing safety and confidentiality. Enforcement actions
are carried out in private with the involved parties, but communicating to the
whole community may be part of a mutually agreed resolution.

## Addressing and Repairing Harm

If an investigation finds that this Code of Conduct has been violated, the
following enforcement ladder may be used to determine how best to repair harm.
The decision depends on the incident's impact on the people involved and the
community as a whole. Depending on the severity of a violation, lower rungs on
the ladder may be skipped.

1. **Warning**
1. Event: A violation involving a single incident or series of incidents.
2. Consequence: A private, written warning from the Community Moderator.
3. Repair: Examples include a private written apology, acknowledgement of
responsibility, and seeking clarification on expectations.
2. **Temporarily Limited Activities**
1. Event: A repeated violation that previously resulted in a warning, or the
first occurrence of a more serious violation.
2. Consequence: A private, written warning with a time-limited cooldown
period. The period may limit particular communication channels or
interactions with particular community members.
3. Repair: Examples include making an apology, reflecting on actions and
impact, and being thoughtful about re-entering community spaces.
3. **Temporary Suspension**
1. Event: A pattern of repeated violations that warnings did not resolve, or
a single serious violation.
2. Consequence: A private written warning with conditions for return from
suspension.
3. Repair: Examples include respecting the spirit of the suspension, meeting
the conditions for return, and reintegrating thoughtfully.
4. **Permanent Ban**
1. Event: A pattern that other steps did not resolve, or a violation so
serious that the moderator cannot keep the community safe with this
person as a member.
2. Consequence: Access to all community spaces, tools, and communication
channels is removed. Permanent bans should be rare and supported by
strong reasoning.
3. Repair: There is no possible repair in cases of this severity.

This enforcement ladder is a guideline. It does not limit the Community
Moderator's discretion and judgment when acting in the community's best
interests.

## Scope

This Code of Conduct applies within all community spaces. It also applies when
an individual officially represents the community in public or other spaces.
Examples include using an official email address, posting through an official
social account, or acting as an appointed representative at an online or
offline event.

## Attribution

This Code of Conduct is adapted from the Contributor Covenant, version 3.0,
permanently available at
[https://www.contributor-covenant.org/version/3/0/](https://www.contributor-covenant.org/version/3/0/).

Contributor Covenant is stewarded by the Organization for Ethical Source and
licensed under [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/).
The enforcement ladder was inspired by the work of
[Mozilla's code of conduct team](https://github.com/mozilla/inclusion).

For more guidance, see the Contributor Covenant
[FAQ](https://www.contributor-covenant.org/faq),
[translations](https://www.contributor-covenant.org/translations), and
[resources](https://www.contributor-covenant.org/resources).
Loading
Loading