Skip to content

docs(roadmap): expand reproducibility-pinning brainstorm for operator review#330

Merged
donbeave merged 1 commit into
mainfrom
feature/reproducibility-pinning
May 12, 2026
Merged

docs(roadmap): expand reproducibility-pinning brainstorm for operator review#330
donbeave merged 1 commit into
mainfrom
feature/reproducibility-pinning

Conversation

@donbeave

Copy link
Copy Markdown
Member

Summary

Reframes the Reproducibility and Provenance Pinning roadmap item from a one-line "needs design — brainstorming required" placeholder into a full agent-authored brainstorm: problem statement, why-it-matters, a proposed hybrid (tag-preferred, SHA-fallback) implementation sketch, the schema-migration impact, open questions for operator review, and the touch list of code/doc files. Status stays Open and is explicitly labelled "agent brainstorm, not yet reviewed by the operator" so the operator can read, edit, or reshape it into an approved design proposal before any code is written. No code, no schema bump, no fixtures — only the roadmap MDX page changes.

Verify locally

Checkout

Paste this first to bypass the tirith paste scanner for the rest of the session:

export TIRITH=0

Then paste the checkout block:

mkdir -p "$HOME/Projects/jackin-project/test"
cd "$HOME/Projects/jackin-project/test"

if [ ! -d jackin/.git ]; then
  git clone https://github.com/jackin-project/jackin.git
fi

cd jackin
mise trust
git fetch -f origin feature/reproducibility-pinning:refs/remotes/origin/feature/reproducibility-pinning
git checkout -B feature/reproducibility-pinning refs/remotes/origin/feature/reproducibility-pinning

Documentation

cd docs
bun install --frozen-lockfile
bun run dev

Astro serves at http://localhost:4321/. Pages to walk:

http://localhost:4321/reference/roadmap/reproducibility-pinning/
UPDATED roadmap item. Confirm the new Status line reads "Open — agent brainstorm, not yet reviewed by the operator", that the Problem / Why it matters / Proposed approach / Open questions sections render, and that the schema sketch TOML block and the <RepoFile /> links to src/config/mod.rs, src/config/migrations.rs, src/config/roles.rs, src/runtime/repo_cache.rs, and src/runtime/launch.rs all resolve.

http://localhost:4321/reference/roadmap/
UPDATED overview page (no edit needed in this PR). Confirm the entry still appears under its existing open-work category and is not in Completed — the brainstorm is intentionally not approved yet.

Migration notes

None.

… review

Reframes the roadmap item with the problem statement, why-it-matters, a hybrid (tag-preferred, SHA-fallback) implementation sketch, schema-migration impact, open questions, and the file touch list. Status remains Open and is explicitly marked as an agent brainstorm not yet reviewed by the operator, so it does not move out of the open-work sidebar group or trigger an overview-page move.

Signed-off-by: Alexey Zhokhov <alexey@zhokhov.com>
Amp-Thread-ID: https://ampcode.com/threads/T-019e1b4e-1737-7058-ae7c-988c3640c1f6
Co-authored-by: Amp <amp@ampcode.com>
@donbeave donbeave merged commit ed736cd into main May 12, 2026
18 checks passed
@donbeave donbeave deleted the feature/reproducibility-pinning branch May 12, 2026 10:04
donbeave added a commit that referenced this pull request May 12, 2026
… review (#330)

Reframes the Reproducibility and Provenance Pinning roadmap item from a one-line "needs design — brainstorming required" placeholder into an agent-authored brainstorm: problem statement, why-it-matters, a proposed hybrid (tag-preferred, SHA-fallback) implementation sketch, the schema-migration impact, open questions for operator review, and the touch list of code/doc files that the work would change. Status stays Open and is explicitly labelled "agent brainstorm, not yet reviewed by the operator" so the item does not move out of the open-work sidebar group or trigger an overview-page move. No code, no schema bump, no fixtures — only the roadmap MDX page changes.

Signed-off-by: Alexey Zhokhov <alexey@zhokhov.com>
Amp-Thread-ID: https://ampcode.com/threads/T-019e1b4e-1737-7058-ae7c-988c3640c1f6
Co-authored-by: Amp <amp@ampcode.com>
donbeave added a commit that referenced this pull request May 18, 2026
… review (#330)

Reframes the Reproducibility and Provenance Pinning roadmap item from a one-line "needs design — brainstorming required" placeholder into an agent-authored brainstorm: problem statement, why-it-matters, a proposed hybrid (tag-preferred, SHA-fallback) implementation sketch, the schema-migration impact, open questions for operator review, and the touch list of code/doc files that the work would change. Status stays Open and is explicitly labelled "agent brainstorm, not yet reviewed by the operator" so the item does not move out of the open-work sidebar group or trigger an overview-page move. No code, no schema bump, no fixtures — only the roadmap MDX page changes.

Signed-off-by: Alexey Zhokhov <alexey@zhokhov.com>
Amp-Thread-ID: https://ampcode.com/threads/T-019e1b4e-1737-7058-ae7c-988c3640c1f6
Co-authored-by: Amp <amp@ampcode.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant