From d1e75dddede9734b8cdda699fd39e852240799bc Mon Sep 17 00:00:00 2001 From: Dobromir Popov Date: Wed, 1 Jul 2026 14:18:26 +0300 Subject: [PATCH] =?UTF-8?q?docs:=20consolidate=20all=20docs=20under=20docs?= =?UTF-8?q?/=20=E2=80=94=20single=20source=20of=20truth?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Move issues (01–29) and PRD from .scratch/distributed-inference-network/ into docs/issues/ and docs/. Update ralph_progress.py DEFAULT_PRD path and rewrite docs/agents/issue-tracker.md to reflect the new layout. The distributed_inference_network.egg-info/docs/ mirror is a build artifact already covered by *.egg-info/ in .gitignore — not committed. Co-Authored-By: Claude Sonnet 4.6 --- .../distributed-inference-network => docs}/PRD.md | 0 docs/agents/issue-tracker.md | 10 +++++----- .../issues/01-monorepo-scaffold.md | 0 .../issues/02-two-node-shard-pipeline.md | 0 .../issues/03-tracker-registration-and-routing.md | 0 .../issues/04-node-client-startup.md | 0 .../issues/05-openai-compatible-gateway.md | 0 .../issues/06-solana-stake-and-settlement.md | 0 .../issues/07-fraud-detection-slash.md | 0 .../issues/08-probationary-period-and-bans.md | 0 .../issues/09-p2p-shard-swarm.md | 0 .../issues/10-meshnet-sdk.md | 0 .../issues/11-binary-wire-format.md | 0 .../issues/12-real-pytorch-model-backend.md | 0 .../issues/13-coverage-first-shard-assignment.md | 0 .../issues/14-tracker-as-node.md | 0 .../issues/15-ralph-agent-agnostic-status-aware.md | 0 .../issues/16-mining-cli-ux.md | 0 .../issues/17-p2p-gossip-relay-ssl.md | 0 .../issues/18-two-machine-lan-test.md | 0 .../19-binary-data-plane-and-peer-weight-transfer.md | 0 ...memory-budget-shard-slots-and-dropout-relocation.md | 0 .../issues/20-tracker-node-hardening.md | 0 .../issues/21-route-timeout-flag.md | 0 .../issues/22-start-layer-protocol.md | 0 .../issues/23-heartbeat-stats.md | 0 .../issues/24-availability-map.md | 0 .../issues/25-rolling-rpm-stats.md | 0 .../issues/26-smart-model-assignment.md | 0 .../issues/27-throughput-routing.md | 0 .../issues/28-routing-correctness-tests.md | 0 .../issues/29-relay-outbound-client.md | 0 .../distributed-inference-network => docs}/prd.json | 0 scripts/ralph_progress.py | 2 +- 34 files changed, 6 insertions(+), 6 deletions(-) rename {.scratch/distributed-inference-network => docs}/PRD.md (100%) rename {.scratch/distributed-inference-network => docs}/issues/01-monorepo-scaffold.md (100%) rename {.scratch/distributed-inference-network => docs}/issues/02-two-node-shard-pipeline.md (100%) rename {.scratch/distributed-inference-network => docs}/issues/03-tracker-registration-and-routing.md (100%) rename {.scratch/distributed-inference-network => docs}/issues/04-node-client-startup.md (100%) rename {.scratch/distributed-inference-network => docs}/issues/05-openai-compatible-gateway.md (100%) rename {.scratch/distributed-inference-network => docs}/issues/06-solana-stake-and-settlement.md (100%) rename {.scratch/distributed-inference-network => docs}/issues/07-fraud-detection-slash.md (100%) rename {.scratch/distributed-inference-network => docs}/issues/08-probationary-period-and-bans.md (100%) rename {.scratch/distributed-inference-network => docs}/issues/09-p2p-shard-swarm.md (100%) rename {.scratch/distributed-inference-network => docs}/issues/10-meshnet-sdk.md (100%) rename {.scratch/distributed-inference-network => docs}/issues/11-binary-wire-format.md (100%) rename {.scratch/distributed-inference-network => docs}/issues/12-real-pytorch-model-backend.md (100%) rename {.scratch/distributed-inference-network => docs}/issues/13-coverage-first-shard-assignment.md (100%) rename {.scratch/distributed-inference-network => docs}/issues/14-tracker-as-node.md (100%) rename {.scratch/distributed-inference-network => docs}/issues/15-ralph-agent-agnostic-status-aware.md (100%) rename {.scratch/distributed-inference-network => docs}/issues/16-mining-cli-ux.md (100%) rename {.scratch/distributed-inference-network => docs}/issues/17-p2p-gossip-relay-ssl.md (100%) rename {.scratch/distributed-inference-network => docs}/issues/18-two-machine-lan-test.md (100%) rename {.scratch/distributed-inference-network => docs}/issues/19-binary-data-plane-and-peer-weight-transfer.md (100%) rename {.scratch/distributed-inference-network => docs}/issues/20-memory-budget-shard-slots-and-dropout-relocation.md (100%) rename {.scratch/distributed-inference-network => docs}/issues/20-tracker-node-hardening.md (100%) rename {.scratch/distributed-inference-network => docs}/issues/21-route-timeout-flag.md (100%) rename {.scratch/distributed-inference-network => docs}/issues/22-start-layer-protocol.md (100%) rename {.scratch/distributed-inference-network => docs}/issues/23-heartbeat-stats.md (100%) rename {.scratch/distributed-inference-network => docs}/issues/24-availability-map.md (100%) rename {.scratch/distributed-inference-network => docs}/issues/25-rolling-rpm-stats.md (100%) rename {.scratch/distributed-inference-network => docs}/issues/26-smart-model-assignment.md (100%) rename {.scratch/distributed-inference-network => docs}/issues/27-throughput-routing.md (100%) rename {.scratch/distributed-inference-network => docs}/issues/28-routing-correctness-tests.md (100%) rename {.scratch/distributed-inference-network => docs}/issues/29-relay-outbound-client.md (100%) rename {.scratch/distributed-inference-network => docs}/prd.json (100%) diff --git a/.scratch/distributed-inference-network/PRD.md b/docs/PRD.md similarity index 100% rename from .scratch/distributed-inference-network/PRD.md rename to docs/PRD.md diff --git a/docs/agents/issue-tracker.md b/docs/agents/issue-tracker.md index a2f08fb..41e6d2b 100644 --- a/docs/agents/issue-tracker.md +++ b/docs/agents/issue-tracker.md @@ -1,18 +1,18 @@ # Issue tracker: Local Markdown -Issues and PRDs for this repo live as markdown files in `.scratch/`. +Issues and PRDs for this project live as markdown files under `docs/`. ## Conventions -- One feature per directory: `.scratch//` -- The PRD is `.scratch//PRD.md` -- Implementation issues are `.scratch//issues/-.md`, numbered from `01` +- The PRD is `docs/PRD.md` (narrative) and `docs/prd.json` (machine-readable story list used by ralph) +- Implementation issues (user stories) are `docs/issues/-.md`, numbered from `01` - Triage state is recorded as a `Status:` line near the top of each issue file (see `triage-labels.md` for the role strings) +- ADRs (architecture decisions) are `docs/adr/-.md`, numbered from `0001` - Comments and conversation history append to the bottom of the file under a `## Comments` heading ## When a skill says "publish to the issue tracker" -Create a new file under `.scratch//` (creating the directory if needed). +Create a new file under `docs/issues/` following the numbering convention. ## When a skill says "fetch the relevant ticket" diff --git a/.scratch/distributed-inference-network/issues/01-monorepo-scaffold.md b/docs/issues/01-monorepo-scaffold.md similarity index 100% rename from .scratch/distributed-inference-network/issues/01-monorepo-scaffold.md rename to docs/issues/01-monorepo-scaffold.md diff --git a/.scratch/distributed-inference-network/issues/02-two-node-shard-pipeline.md b/docs/issues/02-two-node-shard-pipeline.md similarity index 100% rename from .scratch/distributed-inference-network/issues/02-two-node-shard-pipeline.md rename to docs/issues/02-two-node-shard-pipeline.md diff --git a/.scratch/distributed-inference-network/issues/03-tracker-registration-and-routing.md b/docs/issues/03-tracker-registration-and-routing.md similarity index 100% rename from .scratch/distributed-inference-network/issues/03-tracker-registration-and-routing.md rename to docs/issues/03-tracker-registration-and-routing.md diff --git a/.scratch/distributed-inference-network/issues/04-node-client-startup.md b/docs/issues/04-node-client-startup.md similarity index 100% rename from .scratch/distributed-inference-network/issues/04-node-client-startup.md rename to docs/issues/04-node-client-startup.md diff --git a/.scratch/distributed-inference-network/issues/05-openai-compatible-gateway.md b/docs/issues/05-openai-compatible-gateway.md similarity index 100% rename from .scratch/distributed-inference-network/issues/05-openai-compatible-gateway.md rename to docs/issues/05-openai-compatible-gateway.md diff --git a/.scratch/distributed-inference-network/issues/06-solana-stake-and-settlement.md b/docs/issues/06-solana-stake-and-settlement.md similarity index 100% rename from .scratch/distributed-inference-network/issues/06-solana-stake-and-settlement.md rename to docs/issues/06-solana-stake-and-settlement.md diff --git a/.scratch/distributed-inference-network/issues/07-fraud-detection-slash.md b/docs/issues/07-fraud-detection-slash.md similarity index 100% rename from .scratch/distributed-inference-network/issues/07-fraud-detection-slash.md rename to docs/issues/07-fraud-detection-slash.md diff --git a/.scratch/distributed-inference-network/issues/08-probationary-period-and-bans.md b/docs/issues/08-probationary-period-and-bans.md similarity index 100% rename from .scratch/distributed-inference-network/issues/08-probationary-period-and-bans.md rename to docs/issues/08-probationary-period-and-bans.md diff --git a/.scratch/distributed-inference-network/issues/09-p2p-shard-swarm.md b/docs/issues/09-p2p-shard-swarm.md similarity index 100% rename from .scratch/distributed-inference-network/issues/09-p2p-shard-swarm.md rename to docs/issues/09-p2p-shard-swarm.md diff --git a/.scratch/distributed-inference-network/issues/10-meshnet-sdk.md b/docs/issues/10-meshnet-sdk.md similarity index 100% rename from .scratch/distributed-inference-network/issues/10-meshnet-sdk.md rename to docs/issues/10-meshnet-sdk.md diff --git a/.scratch/distributed-inference-network/issues/11-binary-wire-format.md b/docs/issues/11-binary-wire-format.md similarity index 100% rename from .scratch/distributed-inference-network/issues/11-binary-wire-format.md rename to docs/issues/11-binary-wire-format.md diff --git a/.scratch/distributed-inference-network/issues/12-real-pytorch-model-backend.md b/docs/issues/12-real-pytorch-model-backend.md similarity index 100% rename from .scratch/distributed-inference-network/issues/12-real-pytorch-model-backend.md rename to docs/issues/12-real-pytorch-model-backend.md diff --git a/.scratch/distributed-inference-network/issues/13-coverage-first-shard-assignment.md b/docs/issues/13-coverage-first-shard-assignment.md similarity index 100% rename from .scratch/distributed-inference-network/issues/13-coverage-first-shard-assignment.md rename to docs/issues/13-coverage-first-shard-assignment.md diff --git a/.scratch/distributed-inference-network/issues/14-tracker-as-node.md b/docs/issues/14-tracker-as-node.md similarity index 100% rename from .scratch/distributed-inference-network/issues/14-tracker-as-node.md rename to docs/issues/14-tracker-as-node.md diff --git a/.scratch/distributed-inference-network/issues/15-ralph-agent-agnostic-status-aware.md b/docs/issues/15-ralph-agent-agnostic-status-aware.md similarity index 100% rename from .scratch/distributed-inference-network/issues/15-ralph-agent-agnostic-status-aware.md rename to docs/issues/15-ralph-agent-agnostic-status-aware.md diff --git a/.scratch/distributed-inference-network/issues/16-mining-cli-ux.md b/docs/issues/16-mining-cli-ux.md similarity index 100% rename from .scratch/distributed-inference-network/issues/16-mining-cli-ux.md rename to docs/issues/16-mining-cli-ux.md diff --git a/.scratch/distributed-inference-network/issues/17-p2p-gossip-relay-ssl.md b/docs/issues/17-p2p-gossip-relay-ssl.md similarity index 100% rename from .scratch/distributed-inference-network/issues/17-p2p-gossip-relay-ssl.md rename to docs/issues/17-p2p-gossip-relay-ssl.md diff --git a/.scratch/distributed-inference-network/issues/18-two-machine-lan-test.md b/docs/issues/18-two-machine-lan-test.md similarity index 100% rename from .scratch/distributed-inference-network/issues/18-two-machine-lan-test.md rename to docs/issues/18-two-machine-lan-test.md diff --git a/.scratch/distributed-inference-network/issues/19-binary-data-plane-and-peer-weight-transfer.md b/docs/issues/19-binary-data-plane-and-peer-weight-transfer.md similarity index 100% rename from .scratch/distributed-inference-network/issues/19-binary-data-plane-and-peer-weight-transfer.md rename to docs/issues/19-binary-data-plane-and-peer-weight-transfer.md diff --git a/.scratch/distributed-inference-network/issues/20-memory-budget-shard-slots-and-dropout-relocation.md b/docs/issues/20-memory-budget-shard-slots-and-dropout-relocation.md similarity index 100% rename from .scratch/distributed-inference-network/issues/20-memory-budget-shard-slots-and-dropout-relocation.md rename to docs/issues/20-memory-budget-shard-slots-and-dropout-relocation.md diff --git a/.scratch/distributed-inference-network/issues/20-tracker-node-hardening.md b/docs/issues/20-tracker-node-hardening.md similarity index 100% rename from .scratch/distributed-inference-network/issues/20-tracker-node-hardening.md rename to docs/issues/20-tracker-node-hardening.md diff --git a/.scratch/distributed-inference-network/issues/21-route-timeout-flag.md b/docs/issues/21-route-timeout-flag.md similarity index 100% rename from .scratch/distributed-inference-network/issues/21-route-timeout-flag.md rename to docs/issues/21-route-timeout-flag.md diff --git a/.scratch/distributed-inference-network/issues/22-start-layer-protocol.md b/docs/issues/22-start-layer-protocol.md similarity index 100% rename from .scratch/distributed-inference-network/issues/22-start-layer-protocol.md rename to docs/issues/22-start-layer-protocol.md diff --git a/.scratch/distributed-inference-network/issues/23-heartbeat-stats.md b/docs/issues/23-heartbeat-stats.md similarity index 100% rename from .scratch/distributed-inference-network/issues/23-heartbeat-stats.md rename to docs/issues/23-heartbeat-stats.md diff --git a/.scratch/distributed-inference-network/issues/24-availability-map.md b/docs/issues/24-availability-map.md similarity index 100% rename from .scratch/distributed-inference-network/issues/24-availability-map.md rename to docs/issues/24-availability-map.md diff --git a/.scratch/distributed-inference-network/issues/25-rolling-rpm-stats.md b/docs/issues/25-rolling-rpm-stats.md similarity index 100% rename from .scratch/distributed-inference-network/issues/25-rolling-rpm-stats.md rename to docs/issues/25-rolling-rpm-stats.md diff --git a/.scratch/distributed-inference-network/issues/26-smart-model-assignment.md b/docs/issues/26-smart-model-assignment.md similarity index 100% rename from .scratch/distributed-inference-network/issues/26-smart-model-assignment.md rename to docs/issues/26-smart-model-assignment.md diff --git a/.scratch/distributed-inference-network/issues/27-throughput-routing.md b/docs/issues/27-throughput-routing.md similarity index 100% rename from .scratch/distributed-inference-network/issues/27-throughput-routing.md rename to docs/issues/27-throughput-routing.md diff --git a/.scratch/distributed-inference-network/issues/28-routing-correctness-tests.md b/docs/issues/28-routing-correctness-tests.md similarity index 100% rename from .scratch/distributed-inference-network/issues/28-routing-correctness-tests.md rename to docs/issues/28-routing-correctness-tests.md diff --git a/.scratch/distributed-inference-network/issues/29-relay-outbound-client.md b/docs/issues/29-relay-outbound-client.md similarity index 100% rename from .scratch/distributed-inference-network/issues/29-relay-outbound-client.md rename to docs/issues/29-relay-outbound-client.md diff --git a/.scratch/distributed-inference-network/prd.json b/docs/prd.json similarity index 100% rename from .scratch/distributed-inference-network/prd.json rename to docs/prd.json diff --git a/scripts/ralph_progress.py b/scripts/ralph_progress.py index cab5c33..0b2b586 100644 --- a/scripts/ralph_progress.py +++ b/scripts/ralph_progress.py @@ -33,7 +33,7 @@ from typing import Any REPO_ROOT = Path(__file__).resolve().parents[1] -DEFAULT_PRD = REPO_ROOT / ".scratch/distributed-inference-network/prd.json" +DEFAULT_PRD = REPO_ROOT / "docs/prd.json" DEFAULT_AGENT = "codex" DEFAULT_INTERVAL = 10.0 AGENT_CONFIG_PATH = REPO_ROOT / ".ralph-tui" / "agent-config.json"