diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..3d79185 --- /dev/null +++ b/.gitattributes @@ -0,0 +1,9 @@ +* text=auto +*.md text eol=lf +*.json text eol=lf +*.py text eol=lf +*.sh text eol=lf +*.yml text eol=lf +*.yaml text eol=lf +*.svg text eol=lf + diff --git a/README.md b/README.md index 4bc0feb..d3f8802 100644 --- a/README.md +++ b/README.md @@ -49,11 +49,7 @@ Business language and code drift apart easily. A confident summary may describe Value Map keeps two sources of authority separate: -```text -external message ──► source meaning ──┐ - ├──► conversational value map -current codebase ──► code evidence ───┘ -``` +![How Value Map projects preserved source meaning against classified code evidence](assets/value-map-projection-rails.svg) It reports capabilities with explicit status: diff --git a/assets/value-map-projection-rails.svg b/assets/value-map-projection-rails.svg new file mode 100644 index 0000000..6586c6f --- /dev/null +++ b/assets/value-map-projection-rails.svg @@ -0,0 +1,84 @@ + + How Value Map works + An external message and current codebase remain separate until Value Map projects preserved source meaning against classified code evidence, producing a conversational value hypothesis for human judgment. + + + + VALUE MAP / PROJECTION RAILS + How Value Map works + Preserve what was said. Inspect what the code supports. + Compare them without blending the two. + + + + + + 01 / EXACT EXTERNAL MESSAGE + + “Customers can save + workflow templates, + but they can’t run one + on a real project or + see a result.” + + PRESERVED SOURCE MEANING + —Users already have saved intent. + —The unresolved gap is running it against + a project and seeing a result. + —The desired outcome is one useful, + traceable project result. + + + + + 02 / CURRENT CODEBASE + Inspect the minimal code slice + needed to test the message. + CLASSIFIED CODE EVIDENCE + EXISTING + Template configuration + + PARTIAL + Project context + + PROPOSED + Controlled execution + + + + + + PROJECTION + + + + + + + CONVERSATIONAL VALUE MAP + From saved intent + → + one useful, + traceable + project result + + Repo-grounded, testable + value hypothesis + + You decide what matters. + + + Preserve meaning. Classify evidence. Expose the gap. + MESSAGE + CODE → VALUE HYPOTHESIS → JUDGMENT + diff --git a/tests/test_distribution.py b/tests/test_distribution.py index cbb61c4..0176eec 100644 --- a/tests/test_distribution.py +++ b/tests/test_distribution.py @@ -59,6 +59,7 @@ def test_skill_contract_is_read_only_and_conversational(self) -> None: self.assertIn("`PROPOSED`", skill) self.assertIn("Do not include a full claim/evidence table", skill) + @unittest.skipIf(os.name == "nt", "Bash file-URI integration is POSIX-specific") def test_bash_installer_places_verified_codex_skill(self) -> None: with tempfile.TemporaryDirectory() as assets_dir, tempfile.TemporaryDirectory() as home_dir: assets = Path(assets_dir)