Skip to content

Latest commit

 

History

History
944 lines (680 loc) · 23.6 KB

progress.md

File metadata and controls

944 lines (680 loc) · 23.6 KB

Daily Progress (progress.md)

Open Issues

-ia_place_map multi-edge issue -v0.1.1 release doc -Narrow the diagram-content-present criteria for view --all (false service blueprint) -Journey map is not integrated with outcome opportunity map -Need a way to connect a flow to a component

-Create sdd-info command about a file -Update CLI "easy start" paragraph with sdd add -fix stale require_event_id_in_recommended in contracts.yaml -fix hidden "Component CONTAINS Component" in ui_contracts -feature: "render a diagram from a starting node"

-Making an SDD from Scratch Doc! -service blueprint: track the sidecar placement regression -service blueprint etc - were did the labels go? -effect needs a contract decision, not just a regex. Is the request field a raw source atom, a logical string value, or a typed atom like { kind, value }? Today quoted effects are valid bundle atoms, but a plain JSON string cannot safely distinguish SA-010 from "side effect" without clear serialization rules. -Tightening effect can accidentally reject valid quoted-string effects or double-quote/escape them if normalization is unclear. z -generalizing the skill beyond this repository layout -remove service_blueprint DOT output -how to enrich the diagram type with deeper content (link?) -horizontal / vertical per level / per parent -"render all" CLI ? -a style that shows node type for all nodes -a way to clearly differentiate soft-hierarchy vs true-peer for sibling node rendering

Sat 10-10

  • Cleaned failing tests, removed unstable references

Fri 10-9

  • Small progress edit
  • AGENTS.md edit
  • Routing hardening docs cleanup
  • Fixed --view --diagram option logic
  • Fixed unreadable related documentation
  • Added documentation directive to AGENTS.md
  • Created separate page about view and diagram
  • Cleaned out deferred items

Thu 10-8

  • South-to-west connector routing fix for scenario_flow

Wed 10-7

  • Explored renderer QA agent options
  • Updated tmp.sdd to use step differentiation
  • Updated scenario_flow variations of tmp.sdd to match
  • Added Step-deprecated error messaging to CLI
  • Shared connector-overlap recovery for scenario_flow
  • Shared label-space reservation and bounded correction for scenario_flow

Mon 10-5

  • Moved syntax pages into new syntax/ doc site folder
  • Footer nav cleanup
  • Main menu cleanup
  • Reformatted practical applications page

Sat 10-3

  • Fixed codex-app-wsl access
  • Diagram separation

Fri 10-2

  • More documentation cleanup
  • Example corpus generation fixed
  • Example cleaning

Thu 10-1

  • Step differentiation for v0.2
  • Cleaning up talentless documentation updates
  • Swapped in v0.2 examples

Wed 9-30

  • Updated tmp.sdd slightly
  • Simplified sdd-skill bundle awareness
  • Codex WSL integration broken after update

Tue 9-29

  • Bundle-awareness for Guided Addition, sdd-helper, TextMate generation, and sdd-skill

Mon 9-28

  • Tagged release v0.1.1
  • Created v0.2 bundle folder
  • Investigated publishing a schema
  • Updated bundle refs in AGENTS.md, package.json
  • Many detailed bundle reference updates
  • Planned bundle selection tooling updates

Sun 9-27

  • --bundle added to sdd-help
  • Bundle option in sdd defaults

Thu 9-24

  • Ui_contracts label placement solve
  • Ui_contracts bottom port routing
  • Mopped up test failures

Wed 9-23

  • Bottom-port connector routing for scenario_flow
  • Hiding orphan places in scenario_flow
  • Reference targets layout in ui_contracts horizontal

Tue 9-22

  • Slow progress scenario_flow placement & routing mess
  • Connector-to-divider fix solved

Sun 9-20

  • More predictable ui_contracts layout

Sat 9-19

  • Diagnosed failing FigJam imports
  • Set up diagrams in FigJam for whiteboarding

Fri 9-18

  • Routing triage assessment
  • Expanded test timeouts
  • Removed 16 individual test timeouts
  • Memoization for buildRoutingSegments, saving a millon calls
  • Confirmed expansion starvation hypothesis for scenario_flow
  • Found starvation hypothesis without effect
  • Slight scenario_flow routing fix by seeding the repair search with port-derived corridor routes

Thu 9-17

  • Abandoned ui_contracts routing fix
  • Commit chaos
  • Thinned tagline font
  • Added --force option to sdd show to output renders with errors
  • Changed SDD CLI behavior to recognize current-folder files
  • Attempted ui_contracts routing fix again
  • CLI behavior to output files in current folder
  • Linter fixes in a random test file
  • Label placement for ui_contracts failed
  • SDD app details added
  • Addressed shared candidate explosion

Wed 9-16

  • Absans title font
  • Absans info box title
  • Brand color noodling
  • Some routing tests fixed

Tue 9-15

  • Removed duplication from practical applications page

Mon 9-14

  • Shared routing hardened
  • Parse error in sdd-add fixed
  • App planning progress

Sat 9-12

  • Increased --view all tolerance

Wed 9-9

  • Cleaned ui_contracts guide doc page
  • Merged hierarchical-ui-contracts branch
  • Cleaned new main- asset links in guide page
  • Guide details clean-up
  • README recents entry
  • Docs Done clean-up

Tue 9-8

  • Hierarchical ui_contracts implemented, reviewing details
  • Restored broken skill doc page
  • Created ui contracts renderer guide
  • Reduced redundancy in diagram
  • Emphasized shared node
  • Added emphasized node to ui_contracts
  • Components without hierarchy
  • Added gen-x script for canonical examples
  • Cleaned up ui_contracts doc text
  • Moved ui_contracts guide to doc site

Mon 9-7

  • Implementing hierarchical ui_contracts
  • Manually debugging routing

Sun 9-6

  • Designing hierarchical ui_contracts concepts with Astra
  • Updated some example diagrams to show --decorators

Sat 9-5

  • Caught 2 missing artifact updates
  • Updated, reviewed canonical examples
  • Updated README recent items

Fri 9-4

  • Routing unification done
  • Journey adapter updated to use universal solver

Thu 9-3

  • Phase 1 of new node adoption done
  • Phase 2 done
  • Phase 3 done
  • Phase 4 done
  • Phase 5 done
  • Encountered blocking routing issue in phase 6, captured in remediation document
  • Phase 7 shared-node cleanup and verification completed
  • Planned routing unification

Wed 9-2

  • Visual issues correction successful
  • Created note for future connector label improvement
  • Planned new node adoption

Tue 9-1

  • Authored unified node renderer spec
  • Created unified node figma reference
  • Created unified node sdd
  • Better cli error feedback for -view type syntax
  • Good-node plan created
  • Good-node implemented, tracking visual issues

Mon 8-31

  • Node design improvement exploration
  • Fixed excessive height issue for scenario_flow, journey_map, service_blueprint
  • Changed diagram edge stroke to inside
  • Regenerated examples
  • CLI --decorator option, default

Thu 8-27

  • New canonical journey map example
  • Git branches cleanup
  • Removed duplicate Codex project

Wed 8-26

  • Examined the reuse of Step node type in flow and journey, blueprint
  • Added vertical branching to journey map
  • Routing remediation for journey map based on scenario flow
  • Journey Map branch-join routing remediation done

Tue 8-25

  • Planning scenario flow layout capability improvement
  • Implemented, mostly good

Mon 8-24

  • Edited cli tools page

Sun 8-23

  • sdd-for-sdd concept work
  • Edge case-mismatch output for parser/validator
  • Summary output for validator
  • --view all option for sdd show

Sat 8-22

  • Font explorer tools improved
  • Title-body separation in font tool
  • Enabled hybrid font caching to shrink the local font collection size
  • Recent additions in main README
  • Font tool guidance

Fri 8-21

  • Stage 2 done
  • Stage 3 done
  • Stage 4 done
  • Stage 5 done
  • Correcting documentation. two-level-defaults is too complicated.
  • Simplified defaults
  • Polishing CLI page

Thu 8-20

  • Examined outcome-opportunity map routing issue with open models
  • Added back to sdd-add using deepseek

Sun 8-16

  • Added new-document support
  • Updated usage guidance to emphasize sdd-add
  • Examined making simple profile the default
  • Marked guided addition api as done
  • Clarified a strict example
  • User-settable defaults architecture
  • User-settable defaults implementation plan
  • Stage 0 done
  • Stage 1 done
  • Edited CLI tools page for better sdd-add visibility

Sat 8-15

  • Phase 4 done with issues
  • Phase 5 done
  • Phase 6 done
  • Phase 7 done - remediation completed
  • Fixed duplicate prompt

Fri 8-14

  • Phase 3 done, architecture

Thu 8-13

  • Polished acceptance scripts
  • Remediation phase 1 & 2
  • Phase 2 done

Wed 8-12

  • Manual edit (wip) of acceptance transcripts

Tue 8-11

  • Checkpoint 1 done
  • Checkpoint 2 done
  • Checkpoint 3 done
  • Checkpoint 4 done
  • Checkpoint 5 done
  • Checkpoint 6 done
  • Improving sdd add guidance
  • Captured sdd add usability issues
  • Analyis: permafucked snafu foobar implementation - collapsed the UX brief flows
  • Remediation started
  • Remediation UX is fucked too

Mon 8-10

  • UX Brief for Guided Addition API
  • Matching architecture document
  • Updated AGENTS.md current goal

Thu 8-6

  • Font exploration tools

Tue 8-4

  • Extended syntax highlighting language support instructions
  • Synced project on machine 2, capturing test failures
  • Approved @vscode/vsce-sign@2.0.9, keytar@7.9.0. pnpm build scripts on machine 2
  • Cleaned out AccordionScrollExpander remnants
  • Addressed test failures

Mon 8-3

  • Opened up first example on diagram types page
  • Reduced syntax highlighting title
  • Linked impact in main index header
  • Smoothed main index diagram types language
  • Moved position of journey map up in diagram types
  • Experimenting with custom brand colors

Sun 8-2

  • wide-sidebar page class
  • wide-sidebar extended to dropdown
  • surfaced syntax highlighting
  • animated section jump

Sat 8-1

  • Created Strict Profile page
  • Created doc_site_parking_lot
  • Created profiles page
  • Separated strategic-potential content
  • Updated top nav
  • Added kinda-important page class
  • Added side-by-side markdown-it
  • Failed accordeon scroll expander - source still lingers.
  • manual removal of ase from config
  • manual removal of ase from theme

Fri 7-31

  • Edited strategic potential
  • Edited practical use page

Thu 7-30

  • Editing rationale page

Wed 7-29

  • Noodled on quick syntax reference
  • Merged improvements
  • Detail edit in diagram types
  • Disentangled dropdown-switch demo from node-edge reference
  • Created hidden_edge_reference.md
  • Added hidden-node detail to node_edge_reference.md

Tue 7-28

  • Re-added journey map example
  • Fixed svg display-in-dev-mode regression
  • Added better canonical journey map example
  • Found & documented journey map renderer branching coverage gap
  • Added dropdown switch
  • Added quick syntax reference

Mon 7-27

  • Created RM_bup of main readme

  • Deleted spurious vitePress files

  • Merged website into main

  • Fixed gitignore

  • Improved SVG font rendering by adding 600 weight

  • Refreshed small app and billSage examples with better font rendering

  • Removed opaque corners from SVGs

  • Small main index edits

  • Setting up github.io site

  • Site published

  • Cleaned footer, added menu bar

  • Removed some dead links

Sun 7-26

  • researched svg font rendering quality issue
  • added source highlights
  • added {pos: up} option to showRepoLink

Sat 7-25

  • added scripts/lvps.sh to launch vitepress dev server
  • moved repo structure paragraph out of index into readme
  • added source syntax highlighting
  • replaced showSource custom macro with source truncation-capable markdown-it block extension
  • showSourceOptions.lineNumbers added to config for showSource
  • removed Current Status section from main index
  • adding source highlights (wip)
  • captured svg background transparency issue

Frid 7-24

  • vitepress / vite config monkey business
  • introduced scrolling code section
  • scrolling code section looking good
  • added showSource macro
  • added showRepoLink macro
  • edited skill page
  • added text area wrapping
  • created TextMate grammar for VitePress and VS Code

main:

  • Updated journey map file statuses to Done
  • Removed graph types goal from AGENTS.md
  • Merged refine_journey_map with better routing into main

Thu 7-23

  • Captured visual_issues_stage2_in_journey_map.md based on visual proofs
  • Implemented fixes, passed

Wed 7-22

  • Remediation plan completed (minus gate 8 dense)
  • Reviewed visual proofs, issues found

Sun 7-19

  • installed fontawesome-free
  • installed vitepress lightbox plugin
  • installed medium-zoom via pnpm - already present - but made lightbox work
  • rewrote service blueprint example page
  • rewrote service blueprint section in diagram types page
  • many minor edits
  • installed vitepress-plugin-tabs
  • debugged tabs breaking lightbox
  • added tabs on landing page
  • attempting anchor link

Sat 7-18

  • Plan partially completed (to gate 7 - 8 rejected - 9 closed incomplete)

Fri 7-17

  • Renamed staged_journey_map_renderer_verification_contract.md
  • Created a visual review doc
  • Capturing visual issues
  • Mapped captured issues to prerecorded issues
  • Merged journey_map branch into main, deleted worktree, branched refine_journey_map
  • Created visual remediation plan

Tues 7-14

website:

  • Changed site folder name, installed vitepress
  • Fighting incredible snafu link resolution trashfire
  • Diagram Types page in OK shape
  • Added inline expand svg sections
  • Added inline badges, icons
  • Updated skill guide page
  • Link-wrangling
  • Moved initial_concepts into doc_site
  • Stuck in routing snafu for CONTRIBUTING.md
  • Shortened main README

main:

  • Out of tokens somewhere in Gate 8
  • Gate 10 completed - plan done

Mon 7-13

  • Gate 4 done
  • Gate 6 done (mislabeled)
  • Gate 6 join family
  • Actual Gate 6

Sun 7-12

  • Added doc: Path to Replacing Legacy Rendering Pipeline with Staged Renderers
  • Added journey map architecture doc
  • Added journey map plan prompt
  • Created journey_map branch
  • Created implementation plan
  • Gate 0 done
  • Gate 2 done

Sat 7-11

-Docs cleanup -Renamed the multiple outcomes example

Tue 7-7

-Added summary label titles for complex case -Made summary label titles uppercase -Transformed dense example into canonical example -Added renderer authoring guide

Mon 7-6

-Much cleaner label placement -Clean but repetitive individual label placement

Sun 7-5

-Restored previous commit -Small-step connector priority adjustment -Small-step connnector termination routing adjustment -Another termination improvement -Half-failed label placement change -Label placement salvaged, still rough

Thu 7-2

-Further incremental routing fixes -Lost in the weeds

Mon 6-29

-Identified routing failures in outcome-opportunity map -Created arch doc to fix routing failures -Executed fixes, routing inrementally improved -Closed logic delta to service blueprint routing, slight regression

Sat 6-27

-Made IMPLEMENTED_BY edge visible, profile-based -Increased label gutter spacing -Aligned label gutter code structure with scenario-flow -Added descriptions to diagram types page

Fri 6-26

-Explored syntax highlighting opportunity -Removed redundant cell visuals in oom -Improved column alignment in oom -Explored options for adding details to diagrams -Created list of shown / not shown edges per diagram type

Sat 5-16

-finished oom implementation (raw)

Fri 5-15

-reviewed, refined implementation plan -updated AGENTS -started implementing the oom plan

Wed 5-13

-created implementation plan for outcome_opportunity_map

Sat 5-09

-skill run diagnostics -cleansed the repo-local wrapper language again -adjusted --purpose request plan remainder after diagnostics -implemented adjusted plan, it reverted wrapper fix -manually reverted wrapper fix, aligned tests -updated skiil & helper doc pages -analyzed skill execution, found improvement

Fri 5-08

-made local run_helper.sh executable -updated skill to point to installed helper wrapper instead of local -added docs/skill/README.md -sdd-helper partial-write fix -corepack install fix -captured helper payload subdivision issue -created helper payload subdivision design -added --purpose request for helper.command.author

Thu 5-07

-patched Corepack tmp dir for skill -debugged Playwright installation -testing skill across thinking levels -exposed ssh key to non-interactive shells so codex can use git -another helper hardening -ran architecture experiment with odd results -added outcome opportunity map renderer design

Wed 5-06

-clarified edges per node in specifications readme -installed Playwright MCP

Fri 5-01

-updated docs / tests to catch up with scenario_flow staged renderer

Tue 4-27

-third iteration fix, and a fourth one for wide swerve routing -fifth iteration for swerve spacing -sixth for swerve turn reduction -seventh for label placement parity -eighth for label gutter space

Mon 4-27-26

-planned, built fix for scenario_flow stages shortcomings, partial success -second fix iteration, 2 steps forward, 1 step back

Sat 4-25-26

-planned scenario_flow -implemented (raw)

Fri 4-24-26

-strategic potential now usable -spellchecking -updated Quick Start and package.json -skill installation guidance

Wed 4-22-26

-repo docs language clarity edits -small de-ifyouwanting -caught up sdd-helper readme -improving strategic potential doc

Tue 4-21-26

-found & addressed skill nesting recession -found & addressed skill source sequencing regression -reintroduced skill guide page with examples

Mon 4-20-26

-fighting failing skill after refactor -resolved confirmation issue by updating codex twice -restored pre-refactor skill for reference -created another skill-ops improvement design doc -created, executed matching plan -skill now better behaved, still artifact creation issues -refined further

Sun 4-19-26

-added request-loading contract detail + skill guidance -created skill ops reliability design, bad codex laziness

  • reated, executed gated plan

Sat 4-18-26

-revising skill examples -ran into a chat-safe preview bug roadblock -re-ordered preview response payload to handle truncation better -refactored preview response to use path / uri and external file

Fri 4-17-26

-skill doc updates to match new helper contract -added semantic guidance to skill -added chat-safe previews for skill -tightened preview guidance after finding shortfalls -added nesting emphasis to skill guidance after nesting disappeared

Thu 4-16-26

-pushed Skill examples page forward -added strategic potential note -fixed show filename collisions -renamed prompt examples -sharpened skill workflow rules by intent -planned, implemented machine readable contract for helper (except gate 5 for MCP server later)

Tue 4-14-26

-researched template options. conclusion: not yet -planned, implemented expanded shared authoring capabilities -removed ineffective create --template option -strengthened skill guidance -planned to fix show-filename collisions -manually curated examples for Skill (incomplete)

Mon 4-13-26

-added examples to skill doc page, but they are problematic -found & fixed template-use bug for helper create -restored missing skill content -created deferred note for template use -fixed run_helper.sh location documentation drift that the earlier skill content action caused -made run_helper.sh executable (!!) -created "manual" skill example, encountered preview failure -created helper hardening plan (poor messaging etc), executed it -added validation gate before preview in skill

Sun 4-12-26

-created sdd-helper documentation page -created sdd-cli documentation page -updated readme, agents.md -created codex skill -installed skill -clarified skill language -added doc page for skill

Sat 4-11-26

-created helper app execution plan -implemented plan -added discoverability surfaces

Fri 4-10-26

-planned MCP path -planned projection service exposure as pre-step for mcp work -implemented projection service exposure -created mcp server design doc -updated AGENTS.md

Wed 4-08-26

-added License And Contributions footer to readme -changed "recommended" profile name to "strict" -removed dead, definition-only default_severity_mode -removed dead conformance_levels -identified lazy parser implementation ignoring large parts of syntax.yaml -made parser-alignment plan, implemented it -added strict-profile example

Tue 4-07-26

-further readme improvements -removed stray bundle example visuals -refined contributing.md -added MIT license and CLA -removed DOT/MMD cli options

Mon 4-06-26

-added small_app_err error output example file -improved CLI error "pretty" output further -added inline example to readme -added separate service blueprint example -marked not-ready example folders -restructured readme further -created separate diagram types page

Sun 4-05-26

-created simple example file to include in readme -removed empty containers from simple-profile ui_contracts diagram -restructured diagnostic pretty CLI output for readability

Fri 4-03-26

-edited readme intro

Thu 4-02-26

-edited README.md for github use -created CONTRIBUTING.md

Wed 4-01-26

-tackling service_blueprint layout authority alignment: -expanding service_blueprint placement rules to accomodate multi-node per slot handling -created, executed Service Blueprint Support Placement Implementation Plan -revisited to actually achieve adjacent spill columns -capitalized lane labels, added line labels -analyzed style-logic separation

Tue 3-31-26

-cleaning up service_blueprint rendering code: -removed orphaned styling -integrated lane titles and separators into scene contract -discovered missing merge for label branch - corrected -refactored service_blueprint renderer for structural semantics to no longer depend on class tokens or viewId branches

Mon 3-30-26

-increased swerve routing distance -cleaned bottom-gutter routing

Sun 3-29-26

-tracked and scrubbed ungrounded 'sidecar' placement rule in service_blueprint docs -build detailed service blueprint routing rules -implemented routing, rough but reasonably successful

Fri 3-28-26

-ripped out elk routing from service_blueprint -ripped elk out of documentation -created second service blueprint reset document

Thu 3-27-26

-added pre-routing output to debug, found node placement failing -node placement fixed

Wed 3-26-26

-new, hard-failing elk based service_blueprint -switched to non-elk node layoutm still failing

Mon 3-24-26

-completed service_blueprint layout rules -updated service_blueprint reference design

Sat 3-22-26

-drafted service_blueprint layout rules -created service_blueprint reference design

Fri 3-21-26

-improved lanes issues on ui_contracts -implemented elk-based, flawed service_blueprint

Thu 3-20-26

-created reference design & notes for ia_place_map -successful build without elk -resolved issues with label lane in ui_contracts -created elk primer for service_blueprint (next diagram type)

Wed 3-19-26

-abandoned visual fixes mess -got stuck with git revert when rollback was needed -attempted navigate-based indent for IA but failed -restored repo, giving up for now.

Mon 3-17-26

-pushed remaining stages of master plan, completed renderer migration for ia_place_map and ui_contracts -revised rendering details

Sun 3-16-26

-Preparing renderer migration to elkjs / generic -Started master plan based renderer migration

Sat 3-15-26

-Cleaned up Readme.md -Added content to AGENTS.md

Fri 3-14-26

-attempted more ui_contracts rendering variations. Graphviz is a failure. -attempted Context7 MCP install, failed

Thu 3-12-26

-added mermaid for new diagram types -added full set of examples across all types - they look pretty bad. -reshuffled rendering of ui_contracts type - still not good enough

Wed 3-11-26

-debugged font issue -implemented remaining diagram types -started researching Figma

Tue 3-10-26

-fixed element order / preserving order from source -visual / layout improvements (font, title alignment)

Mon 3-9-26

-added simple profile -sorted out CRLF issues -tested initial toolchain implementation -switched git to ssh key -installed Graphviz -expanded cli options -created real-world example source