From adea7eb645b04fdf073c80f95b130724b38a668d Mon Sep 17 00:00:00 2001 From: Anton A S Date: Sun, 1 Mar 2026 02:17:48 +0300 Subject: [PATCH] Sync specs & docs: variables, image export, CLI, core extraction MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Update specs: scene-graph (variables/collections/modes/bindings/.fig import), editor-ui (VariablesPanel, ExportSection, splash), canvas-rendering (variable resolution, image export, sceneVersion/renderVersion), desktop-app (monorepo), tooling (Bun workspace), testing (variable tests) - Create cli spec: info, tree, find, export commands - Update docs: features, figma-comparison (79/150), roadmap (Phase 4 βœ…, Phase 5 🟑), keyboard-shortcuts (β‡§βŒ˜E), contributing (monorepo structure) - Restore vitepress devDependency lost during merge - Archive sync-variables-export-cli change --- .gitignore | 2 + .pi/prompts/opsx-apply.md | 149 +++++++++ .pi/prompts/opsx-archive.md | 154 ++++++++++ .pi/prompts/opsx-explore.md | 170 +++++++++++ .pi/prompts/opsx-propose.md | 103 +++++++ .pi/skills/openspec-apply-change/SKILL.md | 156 ++++++++++ .pi/skills/openspec-archive-change/SKILL.md | 114 +++++++ .pi/skills/openspec-explore/SKILL.md | 288 ++++++++++++++++++ .pi/skills/openspec-propose/SKILL.md | 110 +++++++ bun.lock | 247 +++++++++++++++ docs/development/contributing.md | 35 ++- docs/development/roadmap.md | 32 +- docs/guide/features.md | 22 ++ docs/guide/figma-comparison.md | 11 +- docs/reference/keyboard-shortcuts.md | 60 ++-- .../.openspec.yaml | 1 + .../design.md | 14 + .../proposal.md | 41 +++ .../specs/canvas-rendering/spec.md | 24 ++ .../specs/cli/spec.md | 37 +++ .../specs/desktop-app/spec.md | 10 + .../specs/editor-ui/spec.md | 47 +++ .../specs/scene-graph/spec.md | 49 +++ .../specs/testing/spec.md | 10 + .../specs/tooling/spec.md | 13 + .../tasks.md | 33 ++ openspec/specs/canvas-rendering/spec.md | 21 ++ openspec/specs/cli/spec.md | 37 +++ openspec/specs/desktop-app/spec.md | 7 + openspec/specs/editor-ui/spec.md | 44 +++ openspec/specs/scene-graph/spec.md | 46 +++ openspec/specs/testing/spec.md | 7 + openspec/specs/tooling/spec.md | 10 + package.json | 12 +- 34 files changed, 2053 insertions(+), 63 deletions(-) create mode 100644 .pi/prompts/opsx-apply.md create mode 100644 .pi/prompts/opsx-archive.md create mode 100644 .pi/prompts/opsx-explore.md create mode 100644 .pi/prompts/opsx-propose.md create mode 100644 .pi/skills/openspec-apply-change/SKILL.md create mode 100644 .pi/skills/openspec-archive-change/SKILL.md create mode 100644 .pi/skills/openspec-explore/SKILL.md create mode 100644 .pi/skills/openspec-propose/SKILL.md create mode 100644 openspec/changes/archive/2026-03-01-sync-variables-export-cli/.openspec.yaml create mode 100644 openspec/changes/archive/2026-03-01-sync-variables-export-cli/design.md create mode 100644 openspec/changes/archive/2026-03-01-sync-variables-export-cli/proposal.md create mode 100644 openspec/changes/archive/2026-03-01-sync-variables-export-cli/specs/canvas-rendering/spec.md create mode 100644 openspec/changes/archive/2026-03-01-sync-variables-export-cli/specs/cli/spec.md create mode 100644 openspec/changes/archive/2026-03-01-sync-variables-export-cli/specs/desktop-app/spec.md create mode 100644 openspec/changes/archive/2026-03-01-sync-variables-export-cli/specs/editor-ui/spec.md create mode 100644 openspec/changes/archive/2026-03-01-sync-variables-export-cli/specs/scene-graph/spec.md create mode 100644 openspec/changes/archive/2026-03-01-sync-variables-export-cli/specs/testing/spec.md create mode 100644 openspec/changes/archive/2026-03-01-sync-variables-export-cli/specs/tooling/spec.md create mode 100644 openspec/changes/archive/2026-03-01-sync-variables-export-cli/tasks.md create mode 100644 openspec/specs/cli/spec.md diff --git a/.gitignore b/.gitignore index 8d605bc5a..67694e0ad 100644 --- a/.gitignore +++ b/.gitignore @@ -32,3 +32,5 @@ test-results/ # VitePress docs/.vitepress/dist docs/.vitepress/cache +extensions/vscode/*.heapsnapshot +op-vs-code/ diff --git a/.pi/prompts/opsx-apply.md b/.pi/prompts/opsx-apply.md new file mode 100644 index 000000000..494e10e99 --- /dev/null +++ b/.pi/prompts/opsx-apply.md @@ -0,0 +1,149 @@ +--- +description: Implement tasks from an OpenSpec change (Experimental) +--- + +Implement tasks from an OpenSpec change. + +**Input**: Optionally specify a change name (e.g., `/opsx:apply add-auth`). If omitted, check if it can be inferred from conversation context. If vague or ambiguous you MUST prompt for available changes. + +**Steps** + +1. **Select the change** + + If a name is provided, use it. Otherwise: + - Infer from conversation context if the user mentioned a change + - Auto-select if only one active change exists + - If ambiguous, run `openspec list --json` to get available changes and use the **AskUserQuestion tool** to let the user select + + Always announce: "Using change: " and how to override (e.g., `/opsx:apply `). + +2. **Check status to understand the schema** + ```bash + openspec status --change "" --json + ``` + Parse the JSON to understand: + - `schemaName`: The workflow being used (e.g., "spec-driven") + - Which artifact contains the tasks (typically "tasks" for spec-driven, check status for others) + +3. **Get apply instructions** + + ```bash + openspec instructions apply --change "" --json + ``` + + This returns: + - Context file paths (varies by schema) + - Progress (total, complete, remaining) + - Task list with status + - Dynamic instruction based on current state + + **Handle states:** + - If `state: "blocked"` (missing artifacts): show message, suggest using `/opsx:continue` + - If `state: "all_done"`: congratulate, suggest archive + - Otherwise: proceed to implementation + +4. **Read context files** + + Read the files listed in `contextFiles` from the apply instructions output. + The files depend on the schema being used: + - **spec-driven**: proposal, specs, design, tasks + - Other schemas: follow the contextFiles from CLI output + +5. **Show current progress** + + Display: + - Schema being used + - Progress: "N/M tasks complete" + - Remaining tasks overview + - Dynamic instruction from CLI + +6. **Implement tasks (loop until done or blocked)** + + For each pending task: + - Show which task is being worked on + - Make the code changes required + - Keep changes minimal and focused + - Mark task complete in the tasks file: `- [ ]` β†’ `- [x]` + - Continue to next task + + **Pause if:** + - Task is unclear β†’ ask for clarification + - Implementation reveals a design issue β†’ suggest updating artifacts + - Error or blocker encountered β†’ report and wait for guidance + - User interrupts + +7. **On completion or pause, show status** + + Display: + - Tasks completed this session + - Overall progress: "N/M tasks complete" + - If all done: suggest archive + - If paused: explain why and wait for guidance + +**Output During Implementation** + +``` +## Implementing: (schema: ) + +Working on task 3/7: +[...implementation happening...] +βœ“ Task complete + +Working on task 4/7: +[...implementation happening...] +βœ“ Task complete +``` + +**Output On Completion** + +``` +## Implementation Complete + +**Change:** +**Schema:** +**Progress:** 7/7 tasks complete βœ“ + +### Completed This Session +- [x] Task 1 +- [x] Task 2 +... + +All tasks complete! You can archive this change with `/opsx:archive`. +``` + +**Output On Pause (Issue Encountered)** + +``` +## Implementation Paused + +**Change:** +**Schema:** +**Progress:** 4/7 tasks complete + +### Issue Encountered + + +**Options:** +1.