Files
damascus-orchestrator/.gitignore
damascus-heartbeat 82b9758be6
Some checks failed
test / contract-and-unit (push) Failing after 14s
feat(bmad): add canonical _kit (templates + sample) + ingest validation
BMAD-onboarding kit for the Damascus orchestrator:

- docs/adding-a-new-project.md — full onboarding guide covering layout,
  required story section headers, common pitfalls (with the four classes
  of bug that have cost real cycles here: Path.rglob doesn't follow
  symlinks, architecture.md must be at planning-artifacts/architecture.md
  exactly, missing section headers burn 3 retries each, etc.)
- bmad/_kit/ — read-only reference material (templates + sample)
  - templates/{prd,architecture,epics,story}.md
  - sample/hello-bmad/_bmad-output/ — one fully-formed worked example
    (2-story FastAPI project, valid end-to-end)
  - README.md — kit-level contract
- scripts/test-ingest.sh — pre-flight validation that catches the four
  bug classes before any DB write. Verified against the live orchestrator
  container: passes on the sample, fails (correctly) on a hand-broken tree
  with both missing-section AND symlink bugs in one run.
- docker-compose.yml — replace /home/kaykayyali/_bmad bind (which
  doesn't exist on this server) with ./bmad/_kit. Kit now ships with
  the repo.
- .gitignore — re-include bmad/_kit/ so it travels with the repo while
  keeping the existing 'bmad/ is ephemeral mount content' contract.

Verified end-to-end: 'damascus ingest --project hello-bmad' succeeded
on the live orchestrator, _find_bmad_story resolved both stories.

The 'architecture.md is ingested as a work item' quirk is documented in
docs/adding-a-new-project.md §'Common pitfalls' with a one-liner fix.

Refs: t_5aa80e4b (parallel dashboard work — committed separately)
2026-06-26 06:03:39 +00:00

81 lines
1.5 KiB
Plaintext

# Secrets & env
.env
.env.*
*.env
# Python
__pycache__/
*.py[cod]
*$py.class
*.so
.Python
.venv/
venv/
.pytest_cache/
.coverage
htmlcov/
.mypy_cache/
.ruff_cache/
# Editor
.vscode/
.idea/
*.swp
*.swo
# OS
.DS_Store
Thumbs.db
# Project-specific
# Generated specs (the spec-refiner writes these at runtime)
specs/
data/specs/
# BMAD output dirs are read-only mounts from other projects — not our code.
# The _kit subdir is the canonical reference kit shipped with this repo
# (templates, samples, README) — re-included below. Everything else under
# bmad/ (e.g. bmad/wh40k-pc/, bmad/restitution/) is still treated as
# ephemeral mount content.
bmad/*
!bmad/_kit/
!bmad/_kit/**
# Hermes evidence dirs (e2e screenshots + logs regenerated by tests)
.hermes/evidence/
# The cloned wh40k-pc project lives in a named docker volume; the
# bind-mount on the host is for the test runner only and shouldn't be
# tracked as part of this repo's source.
workspace-projects/
# Wiki lives in its own repo (kaykayyali/damascus-wiki)
# This entry will be moved to a subdir or a separate mount, but for now
# we exclude the wiki from this repo so each repo stays focused.
wiki/
llm-wiki/
# Original LLM-wiki skill spec (reference only, lives in Hermes skills now)
llm-wiki-original/
# mkcert dev CA — installed system-wide, don't track per-repo
rootCA.pem
*.pem
!tests/fixtures/*.pem
# Downloaded ollama binary (re-downloaded in Dockerfile)
bin/ollama
# docker compose local data
dbdata/
# Logs
*.log
logs/
# Build artifacts
dist/
build/
*.egg-info/