Skip to content

Technical bootstrap makes no writes on an empty documentation surface #177

Description

@chubes4

Problem

The native technical bootstrap package completes its model turn without creating documentation when run against a genuinely empty docs/** surface. The deterministic completion validator correctly rejects the run because docs/README.md is absent.

Hosted evidence

Initial bootstrap run:

Controlled retry with an explicit bootstrap-only prompt requiring docs/README.md, docs/architecture.md, docs/contributor-workflows.md, a root README link, workspace writes, Git status, and Git diff:

Both runs passed dependency installation, pnpm install --frozen-lockfile, pnpm build, pnpm verify, and generated-output drift isolation. Both then failed with:

docs-agent.completion-contract.BOOTSTRAP_REQUIRED_PATH: Bootstrap required path is absent or insubstantial: docs/README.md

No publication branch or pull request was created. The temporary base/output branches were removed after evidence capture.

Expected

On an intentionally empty documentation surface, the technical bootstrap package uses its enabled workspace write tools to create the caller-required navigable documentation before normal final prose.

Acceptance criteria

  1. A hosted technical bootstrap against an empty docs/** surface creates the caller-required paths.
  2. The root entry point links to the documentation index and the configured glob minimum is satisfied.
  3. The host-generated DocsAgentCompletionReport passes from the actual Git/filesystem evidence.
  4. The runner publishes the required pull request against the declared temporary base.
  5. Deterministic coverage proves the bootstrap package is instructed and able to perform required workspace writes without relying on final-response syntax.

Compatibility

The deterministic completion and publication contracts should remain strict. This issue concerns bootstrap agent behavior on a fresh surface, not weakening validation.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions