From f245c24928c17d3fdc759e9512587185b0f890c9 Mon Sep 17 00:00:00 2001 From: Steve Cliff Date: Mon, 23 Mar 2026 20:38:42 +0000 Subject: [PATCH] Initial MVP --- .claude/commands/opsx/apply.md | 152 +++++ .claude/commands/opsx/archive.md | 157 +++++ .claude/commands/opsx/continue.md | 114 ++++ .claude/commands/opsx/explore.md | 173 +++++ .claude/commands/opsx/ff.md | 97 +++ .claude/commands/opsx/new.md | 69 ++ .claude/commands/opsx/sync.md | 134 ++++ .claude/commands/opsx/verify.md | 164 +++++ .claude/skills/openspec-apply-change/SKILL.md | 156 +++++ .../skills/openspec-archive-change/SKILL.md | 114 ++++ .../skills/openspec-continue-change/SKILL.md | 118 ++++ .claude/skills/openspec-explore/SKILL.md | 288 ++++++++ .claude/skills/openspec-ff-change/SKILL.md | 101 +++ .claude/skills/openspec-new-change/SKILL.md | 74 +++ .claude/skills/openspec-sync-specs/SKILL.md | 138 ++++ .../skills/openspec-verify-change/SKILL.md | 168 +++++ .gitignore | 7 + README.md | 53 ++ SKILL.md | 110 ++++ examples/car.pdf | Bin 0 -> 8329131 bytes openspec/changes/kb-search/.openspec.yaml | 2 + openspec/changes/kb-search/design.md | 396 +++++++++++ openspec/changes/kb-search/proposal.md | 39 ++ .../kb-search/specs/configuration/spec.md | 72 ++ .../specs/document-ingestion/spec.md | 125 ++++ .../specs/document-management/spec.md | 80 +++ .../specs/embedding-management/spec.md | 57 ++ .../kb-search/specs/hybrid-search/spec.md | 70 ++ .../kb-search/specs/skill-interface/spec.md | 101 +++ openspec/changes/kb-search/tasks.md | 115 ++++ openspec/config.yaml | 10 + pyproject.toml | 32 + src/kb_search/__init__.py | 3 + src/kb_search/cli.py | 616 ++++++++++++++++++ src/kb_search/config.py | 195 ++++++ src/kb_search/database.py | 229 +++++++ src/kb_search/embeddings.py | 67 ++ src/kb_search/ingest/__init__.py | 0 src/kb_search/ingest/code.py | 244 +++++++ src/kb_search/ingest/detector.py | 54 ++ src/kb_search/ingest/docling.py | 123 ++++ src/kb_search/ingest/markdown.py | 210 ++++++ src/kb_search/ingest/note.py | 19 + src/kb_search/output.py | 144 ++++ src/kb_search/py.typed | 0 src/kb_search/search.py | 261 ++++++++ tests/__init__.py | 0 tests/test_config.py | 131 ++++ tests/test_database.py | 206 ++++++ tests/test_embeddings.py | 50 ++ tests/test_ingest_code.py | 172 +++++ tests/test_ingest_core.py | 81 +++ tests/test_ingest_docling.py | 33 + tests/test_ingest_markdown.py | 121 ++++ tests/test_management.py | 156 +++++ tests/test_output.py | 120 ++++ tests/test_search.py | 91 +++ 57 files changed, 6812 insertions(+) create mode 100644 .claude/commands/opsx/apply.md create mode 100644 .claude/commands/opsx/archive.md create mode 100644 .claude/commands/opsx/continue.md create mode 100644 .claude/commands/opsx/explore.md create mode 100644 .claude/commands/opsx/ff.md create mode 100644 .claude/commands/opsx/new.md create mode 100644 .claude/commands/opsx/sync.md create mode 100644 .claude/commands/opsx/verify.md create mode 100644 .claude/skills/openspec-apply-change/SKILL.md create mode 100644 .claude/skills/openspec-archive-change/SKILL.md create mode 100644 .claude/skills/openspec-continue-change/SKILL.md create mode 100644 .claude/skills/openspec-explore/SKILL.md create mode 100644 .claude/skills/openspec-ff-change/SKILL.md create mode 100644 .claude/skills/openspec-new-change/SKILL.md create mode 100644 .claude/skills/openspec-sync-specs/SKILL.md create mode 100644 .claude/skills/openspec-verify-change/SKILL.md create mode 100644 .gitignore create mode 100644 README.md create mode 100644 SKILL.md create mode 100644 examples/car.pdf create mode 100644 openspec/changes/kb-search/.openspec.yaml create mode 100644 openspec/changes/kb-search/design.md create mode 100644 openspec/changes/kb-search/proposal.md create mode 100644 openspec/changes/kb-search/specs/configuration/spec.md create mode 100644 openspec/changes/kb-search/specs/document-ingestion/spec.md create mode 100644 openspec/changes/kb-search/specs/document-management/spec.md create mode 100644 openspec/changes/kb-search/specs/embedding-management/spec.md create mode 100644 openspec/changes/kb-search/specs/hybrid-search/spec.md create mode 100644 openspec/changes/kb-search/specs/skill-interface/spec.md create mode 100644 openspec/changes/kb-search/tasks.md create mode 100644 openspec/config.yaml create mode 100644 pyproject.toml create mode 100644 src/kb_search/__init__.py create mode 100644 src/kb_search/cli.py create mode 100644 src/kb_search/config.py create mode 100644 src/kb_search/database.py create mode 100644 src/kb_search/embeddings.py create mode 100644 src/kb_search/ingest/__init__.py create mode 100644 src/kb_search/ingest/code.py create mode 100644 src/kb_search/ingest/detector.py create mode 100644 src/kb_search/ingest/docling.py create mode 100644 src/kb_search/ingest/markdown.py create mode 100644 src/kb_search/ingest/note.py create mode 100644 src/kb_search/output.py create mode 100644 src/kb_search/py.typed create mode 100644 src/kb_search/search.py create mode 100644 tests/__init__.py create mode 100644 tests/test_config.py create mode 100644 tests/test_database.py create mode 100644 tests/test_embeddings.py create mode 100644 tests/test_ingest_code.py create mode 100644 tests/test_ingest_core.py create mode 100644 tests/test_ingest_docling.py create mode 100644 tests/test_ingest_markdown.py create mode 100644 tests/test_management.py create mode 100644 tests/test_output.py create mode 100644 tests/test_search.py diff --git a/.claude/commands/opsx/apply.md b/.claude/commands/opsx/apply.md new file mode 100644 index 0000000..bf23721 --- /dev/null +++ b/.claude/commands/opsx/apply.md @@ -0,0 +1,152 @@ +--- +name: "OPSX: Apply" +description: Implement tasks from an OpenSpec change (Experimental) +category: Workflow +tags: [workflow, artifacts, 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.