Files

T

History

36bae567dc docs(spec): bring MASTER_SPEC up to date through V2, and version it (#153 )

MASTER_SPEC.md lived outside version control (in the parent directory), so it had
no history and the README's ../MASTER_SPEC.md link was broken on GitHub. It is now
tracked at the repository root and the links are fixed.

Content updated from 'Version 1 / Draft' to 'Version 2 / Maintained'. Chapter and
section numbers are deliberately unchanged so the wiki's existing § references stay
valid; superseded chapters are marked in place rather than deleted:

- New 'Document Status & Version History' section with a per-release change table.
- §3: three new design principles capturing the V2 shift — 3.13 Fidelity,
  3.14 Automation Without Gates, 3.15 Ask Only What Matters.
- §8: pipeline reduced to three stages; stages 4-5 retained as historical.
- §17 Resolver: now the final stage. Adds modifier preservation, the config-gated
  deduplication, the opt-in semantic fallback with its four normative guarantees,
  prompt translation, and the output-preserving performance rules.
- §18/§19: Category Splitter and Prompt Builder marked superseded; the category
  list stays normative as traceability metadata; new §19.7 specifies the flat prompt.
- §20: eight nodes -> five, with real inputs/outputs and the KB Editor constraints.
- §23: current config document, plus a new §23.4 recording which fields are
  deliberately not exposed and why.
- §15: new §15.13 specifying automatic KB construction with no approval gate.
- §13: new §13.13 fidelity rules (lists, relations, conjunctions, explicit content).
- §9/§11: Category Map and Prompt Output data model + schemas marked removed;
  Knowledge Base Manifest schema added.
- Appendix B: documents SC0015-SC0022.
- §30: V1 and V2 marked delivered; records that the automatic KB builder shipped
  deliberately without the originally specified manual-validation gate, that
  localization was dropped, and that the Entity Graph was not pursued.

Co-authored-by: kunail0804 <kunail0804@gmail.com>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

2026-07-19 15:41:51 +02:00

.gitkeep

chore: initialize repository structure and tooling (#1 ) (#45 )

2026-07-07 16:59:32 +02:00

benchmarks.md

perf: KB caching, compiled index, lazy loading, parallel resolution (#38 ) (#142 )

2026-07-13 18:51:42 +02:00

definition_of_done.md

docs: overhaul repo documentation for V2 (#152 )

2026-07-19 15:11:04 +02:00

kb_coverage.json

feat(kb): automatic KB builder, ingestion & validation tooling (#35 ) (#139 )

2026-07-13 18:10:17 +02:00

knowledge_base_build.md

feat(resolver): opt-in semantic nearest-neighbour fallback (#34 ) (#140 )

2026-07-13 18:23:38 +02:00

nodes.md

docs: overhaul repo documentation for V2 (#152 )

2026-07-19 15:11:04 +02:00

README.md

docs(spec): bring MASTER_SPEC up to date through V2, and version it (#153 )

2026-07-19 15:41:51 +02:00

README.md

Documentation

Project documentation is maintained primarily in the GitHub Wiki.

MASTER_SPEC.md at the repository root is the full normative specification, maintained through Version 2. Chapters that later versions superseded (the Category Splitter and Prompt Builder stages, the Knowledge Base Loader node) are marked in place rather than deleted, so the original design intent stays readable alongside what ships today.

This docs/ directory holds documentation that is not part of the wiki — developer guides and generated references.

In this directory

nodes.md — the ComfyUI node reference (inputs, outputs, types).
knowledge_base_build.md — how the Knowledge Base is regenerated.
benchmarks.md — performance baselines.
definition_of_done.md — the Version 1 completion record.

Where to look

Overview & vision — wiki Overview and Vision
Requirements — wiki Requirements and Success Criteria
Architecture & pipeline — wiki Architecture and Pipeline
Data model & schemas — wiki Data Model, Scene JSON and Schemas
Knowledge Base — wiki Knowledge Base
Contributing — CONTRIBUTING.md