writeonce/.gitignore
shoney.arickathil 49872a4b11 docs: six-bucket status board; recover lost vision doc; stop ignoring docs/
- 00-kanban.md rebuilt: ▶ NEXT PLAN pointer (iteration 4 — emitter, corpus,
  `woc build`) then six buckets — stories, in progress, done, pending,
  discarded, learnings. It tracked only the Rust runtime before, so the whole
  OOP track (wovm shipped, woc Tasks 1-8 shipped) was invisible.
- Board now records iteration 3's known gaps instead of silently owing them:
  `?T` plumbed but unenforced; E205/E201/E203/E204 dead, so structural
  interface satisfaction is unchecked.
- New discarded.md — settled rejections with reasons so they are not
  re-proposed: inheritance, `abstract` newtypes, Money/SKU/Float, Dynamic/cast/
  macro/extern, AOT-to-C, Menhir, shared engine state, external deployer.
- RECOVERED docs/plan/exploration/blue-green-vm/00-vision.md — gone from disk,
  never committed (gitignored path), cited by five docs incl. principle 12.
- Root cause was broader: all seven forward-roadmap plans in
  docs/superpowers/plans/ were untracked and ignored, on one disk only. Rules
  were half-fiction — 33 of 34 exploration files were already tracked, so they
  swallowed only *new* files.
- Dropped the docs ignore rules (exploration, oop-vm, superpowers/plans,
  examples/agent-loop, examples/mcp-think) with a do-not-re-add comment; added
  __pycache__/*.pyc. `tests/` stays ignored but warns that the next plan lands
  the corpus there.
2026-08-10 21:52:59 +02:00

92 lines
3.3 KiB
Text

# Cargo build artifacts
/target
# Rust runtime (crates/rt/): compiled binary + build artifacts
/crates/rt/target
/crates/rt/Cargo.lock
# C++ prototype build output
/prototypes/*/build
# OCaml/dune build artifacts (compiler/, the woc compiler front)
/compiler/_build
# C runtime (runtime/): compiled binary + WAL/snapshot data.
# `just rt-c-demo` and the default WO_DATA write ./wo-data at the repo root.
/runtime/wo-rt
/wo-data
/runtime/wo-data
# wovm VM core: binary + test build dir (ASan test binaries, smoke fixtures)
/runtime/wovm
/runtime/build/
# Runtime data directories for the sample projects.
# `wo.toml` points at `./data` which holds the per-project engine state.
/data
/docs/examples/*/data
# Legacy blog content and data (v1 writeonce storage)
/content
# Everything in .dev is developer-local (agent-tooling links, and the whole
# reference/ area: v1 archive, rest smoke files, study-tree symlinks —
# untracked 2026-08-08, disk-only; v1 history lives at the pre-move
# reference/ path). Only this README survives:
/.dev/*
!/.dev/README.md
/.dev/reference/
# Study-tree symlinks each contributor recreates per machine:
# ln -s <path-to-linux-src> .dev/reference/linux
# ln -s <path-to-go-src> .dev/reference/go
# ln -s <path-to-postgresql-src> .dev/reference/postgresql
# ln -s <path-to-mcp-python-sdk-src> .dev/reference/mcp-python-sdk
# (clone: https://github.com/modelcontextprotocol/python-sdk.git)
# ln -s <path-to-colibri> .dev/reference/colibri
# ln -s <path-to-llama.cpp> .dev/reference/llama-cpp
# ln -s <path-to-llvm-project> .dev/reference/llvm-project
# Agent-orchestration scratch (SDD ledgers, briefs, review packages)
/.superpowers/
# Editor / OS noise — left broad on purpose so a contributor doesn't
# accidentally commit their IDE scratch or macOS metadata.
.DS_Store
*.swp
*.swo
/.idea/
/.vscode/*
!/.vscode/settings.json.example
!/.vscode/extensions.json
# Phase-F bench binaries (sources are committed; builds are not)
/runtime/bench/bench
/runtime/bench/goref/goref
prototypes/llama-moe-stream/
prototypes/wo-db/
# NOTE (2026-08-10): `tests/` stays ignored, but story iteration 4 (plan 3)
# lands the conformance corpus under `tests/corpus/` — un-ignore it in that
# change, or the corpus will be invisible to git exactly as the docs below
# were. See docs/plan/learnings.md, "check that a new document is actually
# tracked".
tests/
# Documentation is version-controlled — repo doctrine puts docs under `docs/`,
# and ignoring them there defeats the point. These directories were ignored
# until 2026-08-10, which silently cost the blue-green vision doc (recovered
# from a session transcript) and left all seven forward-roadmap plan docs in
# `docs/superpowers/plans/` existing only on one developer's disk. The rules
# were also half-fiction: 33 of the 34 files under `docs/plan/exploration/`
# were already tracked, so the rule only swallowed *new* files — the worst
# possible failure mode. Do not re-add them.
# docs/examples/agent-loop/
# docs/examples/mcp-think/
# docs/plan/exploration/
# docs/plan/oop-vm/ (carries the .wob format + error-catalog contracts)
# docs/superpowers/plans/
# Python bytecode — the agent-loop / mcp-think samples are Python, and
# un-ignoring their directories above exposed these.
__pycache__/
*.pyc