尚未偵測到更新。GitHub 發布版本後會顯示在這裡。
個人 GitHub 帳號下公開儲存庫的擁有者可以登入並驗證所有權,自行管理介紹,無需管理員核准。
登入並產生驗證檔案,在 30 分鐘內將其提交至此儲存庫的預設分支。其他分支或分叉儲存庫中的檔案無效。然後在下方檢查檔案,即可無需管理員核准直接管理專案。請保留檔案以維持管理權限。
如需登入,將前往登入頁面。登入後請回到此處,再次點擊所選的驗證按鈕。
在專案資料夾中執行 /nomorevibe verify,即可驗證所有權並自行管理介紹。
一分鐘完成驗證Future-debrief (5?)
翻譯準備中
取自儲存庫 README
正在載入完整 README。
檢視完整 README ↗Future-debrief (5?)
Debrief v4. Requirements and plans are in docs/; identifiers such as SUB-01 refer to the SRD.
| Path | Contents |
|---|---|
schemas/linkml/ | LinkML source for every boundary type (PRN-04); see schemas/README.md |
schemas/generated/ | JSON Schema generated from LinkML |
schemas/fixtures/ | Golden fixtures shared by Python and TypeScript tests |
python/debrief-schemas/ | Generated Pydantic models and document validation |
python/debrief-config/ | Per-user configuration: the stores an analyst knows about (SEC-06); see its README |
python/debrief-io/ | Importers: REP files into catalogued plots with provenance; see its README |
python/debrief-stac/ | File-based STAC catalogues of plots and sources; see its README |
python/debrief-sample/ | Sample data: open AIS with a synthesised exercise on top, built into a catalogue (DEP-08); see its README |
python/debrief-tools/ | Tool framework, the MCP tool service and the core tools; see its README |
python/debrief-kernel/ | Time, units, geodesy and display formatting (SUB-01 to SUB-04); see its README |
ts/schemas/ | Generated TypeScript types and document validation |
ts/kernel/ | Unit conversion and display formatting for TypeScript views, held to the vectors shared with the Python kernel |
ts/config/ | The same per-user configuration for the VS Code extension, held to the location rules shared with Python |
vscode/ | The VS Code extension: catalogues, map, outline, tools; see its README |
schemas/vectors/ | Test vectors both languages must agree on |
scripts/ | Generators and the cross-language round trip |
site/ | Development blog and guides (style guide, interaction models, tool-author guide, glossary), published to GitHub Pages from the gh-pages branch |
Requires uv and Node 22.
uv sync
npm ci --prefix ts/schemas
npm ci --prefix ts/kernel
npm ci --prefix ts/config
# After editing schemas/linkml/debrief.yaml
uv run python scripts/generate_schemas.py
npm run --prefix ts/schemas generate
# Tests
uv run pytest
npm test --prefix ts/schemas
npm run --prefix ts/schemas build && npm test --prefix ts/kernel && npm test --prefix ts/config
scripts/cross_language_roundtrip.sh
Never edit generated files; CI fails if they differ from a fresh generation.
uv run --group docs mkdocs serve --config-file site/mkdocs.yml
Every pull request says whether it needs a blog post and confirms nothing sensitive is included (see the pull-request template). Extend the guides in the same pull request as the feature that needs them.