Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Format-preserving writes for structural frontmatter (features, connections, layout, shapes, edges)

Aperta
  • Qualcosa non va?
#405 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
25/100
Tipo di issue
Funzionalità
Chiarezza
Da chiarire
Stato di attività
Attiva
Stack tecnologico
javascript, rust, yaml
Ambito
developer-experience, tooling

Direzione di ricerca

Read prompts/help/set.md and inspect the minimal-edit paths for set and move, then compare them with the MCP update_element implementation and syscribe_model::mutate. First clarify with the owner whether the initial scope is structural list and map edits or formatting preservation in update_element, and which fields it covers. Done means the selected path preserves untouched frontmatter formatting while retaining re-validation and the referential-integrity gate; the issue names no tests.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Feature request (from a VS Code extension with a canvas editor for the model).

Gap. Tools that edit a model need to change features:, connections:, layout:, shapes: and edges: without rewriting the rest of the file.

  • syscribe set is documented as a line-level edit, byte-preserving for the rest of the file (prompts/help/set.md), and re-serialises the frontmatter only for a list written as a multi-line flow list. It covers only a short allowlist of fields, and the structural ones above are not on it.
  • move is likewise a surgical edit, also on an allowlist.
  • The MCP update_element is documented as an arbitrary-field merge. Nothing promises it keeps comments, indentation or key order, so it should not be expected to.

So a client that must keep a user's formatting has to edit the frontmatter text itself with its own comment-preserving YAML library, and use the binary only to validate.

Options.

  1. Extend the minimal-edit path to structural lists and maps (add, remove and change an entry of features:, connections:, layout:, shapes:, edges:).
  2. Make update_element preserve formatting (comments, quoting, indentation, key order) for the parts of the frontmatter it does not change.

Either lets such a client use the binary's guarded write path (syscribe_model::mutate, with re-validation and the referential-integrity gate) and drop its own YAML handling.

Open question for the owner: which option, and which fields are in scope for the first slice?

🤖 Generated with Claude Code

https://claude.ai/code/session_01ANvoJ7rMK9HUDP1qDdYEnN

Lingua principale
JavaScript
Stelle
8
Fork
1
Merge medio
1h
PR unite (30g)
83

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di sjames/syscribe

Tutte le issue di sjames/syscribe

Issue simili

Altre issue su JavaScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.