Skip to content

docs: fix staleness across all research docs + Zargham feedback + gitignore#154

Merged
rororowyourboat merged 4 commits intomainfrom
dev
Mar 28, 2026
Merged

docs: fix staleness across all research docs + Zargham feedback + gitignore#154
rororowyourboat merged 4 commits intomainfrom
dev

Conversation

@rororowyourboat
Copy link
Copy Markdown
Collaborator

Summary

Parallel audit by two agents (code-reviewer + code-explorer) identified
19 staleness findings across 10 research docs. All fixed:

  • Critical: continuous-time no longer "not needed" (gds-continuous exists)
  • Important: Step 3/4/5 API signatures match implementations, 8→9 tuple,
    SHACL 13→18, three→six DSLs, canonical spectrum includes software+business
  • Minor: Phase 4 blocker resolved, execution priority completed
  • Zargham feedback on constraint promotion added to semantic-web-summary
  • .gitignore: .hypothesis/ and marimo/ excluded

Test plan

  • All research doc claims verified against current codebase
  • Ruff lint clean

rohan added 4 commits March 28, 2026 21:10
Findings from parallel audit agents:

- paper-implementation-gap.md: added Step 5b (backward reachability)
- verification-plan.md: Phase 4 updated (gds-analysis exists, not future);
  artifact path .tex → .md; Steps 1-5 marked complete
- research-boundaries.md: continuous-time DSL and state-space matrices
  marked as Done (gds-continuous, gds-symbolic)
- gds-analysis CLAUDE.md: added gds-continuous optional dependency,
  backward_reachability.py to module table, reachability.py API updated
- Root CLAUDE.md: gds-analysis dependency graph includes gds-continuous[opt]
Critical:
- paper-implementation-gap.md Section 7: continuous-time marked as
  implemented (gds-continuous exists), no longer "not needed"

Important:
- paper-implementation-gap.md Steps 3-5: design signatures updated to
  match actual implementations (StateMetric fields, reachable_set API,
  configuration_space API)
- formal-representability.md: 8-tuple → 9-tuple (StateMetric added)
- semantic-web-summary.md: R1=13, R3=7, SHACL shapes=18 (was 12/6/13)
- research-boundaries.md: "three DSLs" → "six DSLs" throughout
- representation-gap.md: canonical spectrum table includes software +
  business domains
- verification-plan.md: Phase 1b-c artifacts noted as not yet created
@rororowyourboat rororowyourboat merged commit 58b5d97 into main Mar 28, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant