From 4f14a786a72cf413294a92e9e630e42e1e7193f9 Mon Sep 17 00:00:00 2001 From: MrWangJustToDo <2711470541@qq.com> Date: Fri, 7 Aug 2026 01:40:20 +0800 Subject: [PATCH] add lynx framework package --- .cursor/commands/opsx-apply.md | 180 + .cursor/commands/opsx-archive.md | 222 ++ .cursor/commands/opsx-explore.md | 180 + .cursor/commands/opsx-propose.md | 118 + .cursor/skills/openspec-apply-change/SKILL.md | 185 + .../skills/openspec-archive-change/SKILL.md | 180 + .cursor/skills/openspec-explore/SKILL.md | 296 ++ .cursor/skills/openspec-propose/SKILL.md | 123 + AGENTS.md | 4 +- README.md | 13 +- eslint.config.mjs | 2 + .../add-react-lynx-diffview/.openspec.yaml | 2 + .../changes/add-react-lynx-diffview/design.md | 143 + .../add-react-lynx-diffview/proposal.md | 76 + .../specs/lynx-diffview/spec.md | 106 + .../changes/add-react-lynx-diffview/tasks.md | 49 + openspec/config.yaml | 32 + package.json | 2 + packages/lynx/index.d.ts | 36 + packages/lynx/index.js | 1 + packages/lynx/package.json | 93 + packages/lynx/postcss.config.js | 7 + packages/lynx/readme.md | 130 + packages/lynx/src/components/DiffContent.tsx | 197 ++ packages/lynx/src/components/DiffExpand.tsx | 41 + .../src/components/DiffSplitContentLine.tsx | 131 + .../src/components/DiffSplitExtendLine.tsx | 74 + .../lynx/src/components/DiffSplitHunkLine.tsx | 122 + .../lynx/src/components/DiffSplitView.tsx | 55 + .../lynx/src/components/DiffSplitViewLine.tsx | 19 + .../src/components/DiffUnifiedContentLine.tsx | 128 + .../src/components/DiffUnifiedExtendLine.tsx | 58 + .../src/components/DiffUnifiedHunkLine.tsx | 119 + .../lynx/src/components/DiffUnifiedView.tsx | 70 + packages/lynx/src/components/DiffView.tsx | 272 ++ .../lynx/src/components/DiffViewContext.tsx | 13 + packages/lynx/src/components/styleUtils.ts | 92 + packages/lynx/src/components/tools.ts | 90 + packages/lynx/src/components/visibleLines.ts | 60 + packages/lynx/src/global.d.ts | 6 + packages/lynx/src/highlightColor.ts | 97 + packages/lynx/src/hooks/useIsMounted.ts | 11 + packages/lynx/src/hooks/useUnmount.ts | 10 + packages/lynx/src/index.ts | 3 + packages/lynx/src/stubs/lezer-markdown.ts | 12 + packages/lynx/src/stubs/lowlight.ts | 60 + packages/lynx/src/tailwind.css | 5 + packages/lynx/src/theme.ts | 37 + packages/lynx/tailwind.config.js | 11 + packages/lynx/tsconfig.json | 13 + pnpm-lock.yaml | 3011 +++++++++++++++-- scripts/build.ts | 16 +- ui/lynx-example/README.md | 26 + ui/lynx-example/lynx.config.ts | 49 + ui/lynx-example/package.json | 26 + ui/lynx-example/src/App.tsx | 72 + ui/lynx-example/src/data.ts | 84 + ui/lynx-example/src/index.tsx | 9 + ui/lynx-example/tailwind.config.js | 15 + ui/lynx-example/tsconfig.json | 14 + 60 files changed, 6939 insertions(+), 369 deletions(-) create mode 100644 .cursor/commands/opsx-apply.md create mode 100644 .cursor/commands/opsx-archive.md create mode 100644 .cursor/commands/opsx-explore.md create mode 100644 .cursor/commands/opsx-propose.md create mode 100644 .cursor/skills/openspec-apply-change/SKILL.md create mode 100644 .cursor/skills/openspec-archive-change/SKILL.md create mode 100644 .cursor/skills/openspec-explore/SKILL.md create mode 100644 .cursor/skills/openspec-propose/SKILL.md create mode 100644 openspec/changes/add-react-lynx-diffview/.openspec.yaml create mode 100644 openspec/changes/add-react-lynx-diffview/design.md create mode 100644 openspec/changes/add-react-lynx-diffview/proposal.md create mode 100644 openspec/changes/add-react-lynx-diffview/specs/lynx-diffview/spec.md create mode 100644 openspec/changes/add-react-lynx-diffview/tasks.md create mode 100644 openspec/config.yaml create mode 100644 packages/lynx/index.d.ts create mode 100644 packages/lynx/index.js create mode 100644 packages/lynx/package.json create mode 100644 packages/lynx/postcss.config.js create mode 100644 packages/lynx/readme.md create mode 100644 packages/lynx/src/components/DiffContent.tsx create mode 100644 packages/lynx/src/components/DiffExpand.tsx create mode 100644 packages/lynx/src/components/DiffSplitContentLine.tsx create mode 100644 packages/lynx/src/components/DiffSplitExtendLine.tsx create mode 100644 packages/lynx/src/components/DiffSplitHunkLine.tsx create mode 100644 packages/lynx/src/components/DiffSplitView.tsx create mode 100644 packages/lynx/src/components/DiffSplitViewLine.tsx create mode 100644 packages/lynx/src/components/DiffUnifiedContentLine.tsx create mode 100644 packages/lynx/src/components/DiffUnifiedExtendLine.tsx create mode 100644 packages/lynx/src/components/DiffUnifiedHunkLine.tsx create mode 100644 packages/lynx/src/components/DiffUnifiedView.tsx create mode 100644 packages/lynx/src/components/DiffView.tsx create mode 100644 packages/lynx/src/components/DiffViewContext.tsx create mode 100644 packages/lynx/src/components/styleUtils.ts create mode 100644 packages/lynx/src/components/tools.ts create mode 100644 packages/lynx/src/components/visibleLines.ts create mode 100644 packages/lynx/src/global.d.ts create mode 100644 packages/lynx/src/highlightColor.ts create mode 100644 packages/lynx/src/hooks/useIsMounted.ts create mode 100644 packages/lynx/src/hooks/useUnmount.ts create mode 100644 packages/lynx/src/index.ts create mode 100644 packages/lynx/src/stubs/lezer-markdown.ts create mode 100644 packages/lynx/src/stubs/lowlight.ts create mode 100644 packages/lynx/src/tailwind.css create mode 100644 packages/lynx/src/theme.ts create mode 100644 packages/lynx/tailwind.config.js create mode 100644 packages/lynx/tsconfig.json create mode 100644 ui/lynx-example/README.md create mode 100644 ui/lynx-example/lynx.config.ts create mode 100644 ui/lynx-example/package.json create mode 100644 ui/lynx-example/src/App.tsx create mode 100644 ui/lynx-example/src/data.ts create mode 100644 ui/lynx-example/src/index.tsx create mode 100644 ui/lynx-example/tailwind.config.js create mode 100644 ui/lynx-example/tsconfig.json diff --git a/.cursor/commands/opsx-apply.md b/.cursor/commands/opsx-apply.md new file mode 100644 index 00000000..78acb207 --- /dev/null +++ b/.cursor/commands/opsx-apply.md @@ -0,0 +1,180 @@ +--- +name: "/opsx-apply" +id: "opsx-apply" +category: "Workflow" +description: "Implement tasks from an OpenSpec change (Experimental)" +--- + +Implement tasks from an OpenSpec change. + +**Store selection:** If the user names a store (a store is a standalone OpenSpec repo registered on this machine) or the work lives in one, run `openspec store list --json` to discover registered store ids, then pass `--store ` on the commands that read or write specs and changes (`new change`, `status`, `instructions`, `list`, `show`, `validate`, `archive`, `doctor`, `context`, `view`). Other commands do not take the flag. Hints printed by commands already carry the flag; keep it on follow-ups. Without a store, commands act on the nearest local `openspec/` root. + +**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 ask the user to select one + + 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") + - `planningHome`, `changeRoot`, and `actionContext`: planning scope and edit constraints + - 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: + - `contextFiles`: artifact ID -> array of concrete file paths (varies by schema) + - Progress (total, complete, remaining) + - Task list with status + - Dynamic instruction based on current state + - Optional `context`: current required project instruction input from the selected root + - Optional `operationGuidance`: current advisory guidance for apply + + **Handle states:** + - If `state: "blocked"` (missing artifacts): show message, suggest using `/opsx-continue` (if it is not installed, run `openspec status --change "" --json` to see the next artifact and `openspec instructions --change "" --json` for how to create it) + - If `state: "all_done"`: congratulate, suggest archive + - Otherwise: proceed to implementation + + Treat `context` as a required prompt-level input. Read and consider it, and + apply relevant project facts, conventions, and constraints while implementing. + Treat `operationGuidance` as optional additive advice. Read and consider every + entry, and follow entries that are applicable and compatible with the built-in + workflow. + + Keep both fields separate from CLI-returned state, missing artifacts, tasks, + progress, `contextFiles`, and the built-in `instruction`. They are not + evidence of task completion, do not replace the built-in instruction, and do + not permit bypassing a blocked state. If context conflicts with the built-in + instruction, an explicit user choice, or a CLI-controlled value, report the + conflict and preserve the controlling value. If guidance is inapplicable or + conflicts with those controlling inputs, do not follow it and explain why. + These are prompt-level behavior contracts, not enforceable checks. + +4. **Read context files** + + Read every file path listed under `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 + + Do not copy `context` or `operationGuidance` verbatim into implementation + files or planning artifacts unless the user separately asks for that content. + +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.