gemiterm 2.0.0 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (150) hide show
  1. package/README.md +32 -9
  2. package/package.json +13 -4
  3. package/src/cli/command-registry.ts +66 -62
  4. package/src/cli/commands/install-skills-command.ts +35 -0
  5. package/src/cli/index.ts +19 -44
  6. package/src/infrastructure/cli-parser.ts +77 -0
  7. package/src/services/skills-cli-driver.ts +58 -0
  8. package/src/services/skills-service.ts +52 -0
  9. package/.env +0 -2
  10. package/.github/workflows/manual-release.yml +0 -34
  11. package/.github/workflows/release.yml +0 -198
  12. package/.github/workflows/test.yml +0 -29
  13. package/.opencode/commands/opsx-apply.md +0 -152
  14. package/.opencode/commands/opsx-archive.md +0 -157
  15. package/.opencode/commands/opsx-explore.md +0 -169
  16. package/.opencode/commands/opsx-propose.md +0 -104
  17. package/.opencode/commands/opsx-sync.md +0 -140
  18. package/.opencode/commands/search-intelligently.md +0 -9
  19. package/.opencode/opencode.json +0 -20
  20. package/.opencode/skills/intellisearch/.version +0 -1
  21. package/.opencode/skills/intellisearch/SKILL.md +0 -84
  22. package/.opencode/skills/intellisearch/references/brave-search.md +0 -67
  23. package/.opencode/skills/intellisearch/references/ddg-search.md +0 -79
  24. package/.opencode/skills/intellisearch/references/deepwiki-tools.md +0 -246
  25. package/.opencode/skills/intellisearch/references/examples.md +0 -97
  26. package/.opencode/skills/intellisearch/references/gh-cli.md +0 -143
  27. package/.opencode/skills/intellisearch/references/google-search.md +0 -40
  28. package/.opencode/skills/intellisearch/references/search-workflow.md +0 -143
  29. package/.opencode/skills/intellisearch/references/workflow.md +0 -115
  30. package/.opencode/skills/openspec-apply-change/SKILL.md +0 -159
  31. package/.opencode/skills/openspec-archive-change/SKILL.md +0 -117
  32. package/.opencode/skills/openspec-explore/SKILL.md +0 -287
  33. package/.opencode/skills/openspec-propose/SKILL.md +0 -111
  34. package/.opencode/skills/openspec-sync-specs/SKILL.md +0 -147
  35. package/.serena/project.yml +0 -133
  36. package/AGENTS.md +0 -136
  37. package/CHANGELOG.md +0 -3
  38. package/bun.lock +0 -105
  39. package/docs/INSTALL.md +0 -185
  40. package/docs/PLAYWRIGHT_CLI_API.md +0 -306
  41. package/docs/python-release-for-reference.md +0 -175
  42. package/examples/sample_json_export.json +0 -32
  43. package/examples/sample_markdown_export.md +0 -221
  44. package/examples/usage_examples.sh +0 -222
  45. package/install.ps1 +0 -264
  46. package/install.sh +0 -275
  47. package/openspec/MAESTRO_MIGRATION.md +0 -180
  48. package/openspec/changes/archive/2026-06-08-command-spec-conformance/.openspec.yaml +0 -2
  49. package/openspec/changes/archive/2026-06-08-command-spec-conformance/design.md +0 -194
  50. package/openspec/changes/archive/2026-06-08-command-spec-conformance/proposal.md +0 -52
  51. package/openspec/changes/archive/2026-06-08-command-spec-conformance/specs/multi-profile-conversations/spec.md +0 -133
  52. package/openspec/changes/archive/2026-06-08-command-spec-conformance/tasks.md +0 -95
  53. package/openspec/changes/archive/2026-06-09-refactor-interactive-prompt-loop/.openspec.yaml +0 -2
  54. package/openspec/changes/archive/2026-06-09-refactor-interactive-prompt-loop/design.md +0 -28
  55. package/openspec/changes/archive/2026-06-09-refactor-interactive-prompt-loop/proposal.md +0 -22
  56. package/openspec/changes/archive/2026-06-09-refactor-interactive-prompt-loop/specs/interactive-prompt-loop/spec.md +0 -35
  57. package/openspec/changes/archive/2026-06-09-refactor-interactive-prompt-loop/tasks.md +0 -28
  58. package/openspec/changes/archive/2026-06-09-replace-gemini-api-placeholder-with-gemini-reverse/.openspec.yaml +0 -2
  59. package/openspec/changes/archive/2026-06-09-replace-gemini-api-placeholder-with-gemini-reverse/design.md +0 -323
  60. package/openspec/changes/archive/2026-06-09-replace-gemini-api-placeholder-with-gemini-reverse/proposal.md +0 -122
  61. package/openspec/changes/archive/2026-06-09-replace-gemini-api-placeholder-with-gemini-reverse/specs/no-capability-changes/spec.md +0 -29
  62. package/openspec/changes/archive/2026-06-09-replace-gemini-api-placeholder-with-gemini-reverse/tasks.md +0 -172
  63. package/openspec/changes/archive/2026-06-09-v2-install-migration/.openspec.yaml +0 -2
  64. package/openspec/changes/archive/2026-06-09-v2-install-migration/design.md +0 -241
  65. package/openspec/changes/archive/2026-06-09-v2-install-migration/proposal.md +0 -41
  66. package/openspec/changes/archive/2026-06-09-v2-install-migration/specs/v2-installer/spec.md +0 -205
  67. package/openspec/changes/archive/2026-06-09-v2-install-migration/tasks.md +0 -97
  68. package/openspec/changes/commander-cli-parser/.openspec.yaml +0 -2
  69. package/openspec/changes/commander-cli-parser/design.md +0 -107
  70. package/openspec/changes/commander-cli-parser/proposal.md +0 -31
  71. package/openspec/changes/commander-cli-parser/specs/cli/spec.md +0 -48
  72. package/openspec/changes/commander-cli-parser/tasks.md +0 -33
  73. package/openspec/changes/cross-platform-build-and-ci/.openspec.yaml +0 -2
  74. package/openspec/changes/cross-platform-build-and-ci/design.md +0 -213
  75. package/openspec/changes/cross-platform-build-and-ci/proposal.md +0 -50
  76. package/openspec/changes/cross-platform-build-and-ci/specs/path-and-file-mediation/spec.md +0 -335
  77. package/openspec/changes/cross-platform-build-and-ci/specs/release-pipeline/spec.md +0 -95
  78. package/openspec/changes/cross-platform-build-and-ci/tasks.md +0 -164
  79. package/openspec/config.yaml +0 -20
  80. package/openspec/specs/auth/spec.md +0 -394
  81. package/openspec/specs/cli/spec.md +0 -108
  82. package/openspec/specs/commands/spec.md +0 -409
  83. package/openspec/specs/configuration/spec.md +0 -130
  84. package/openspec/specs/conversations/spec.md +0 -139
  85. package/openspec/specs/domain-model/spec.md +0 -128
  86. package/openspec/specs/formatters/spec.md +0 -158
  87. package/openspec/specs/install-browser/spec.md +0 -146
  88. package/openspec/specs/interactive-prompt-loop/spec.md +0 -41
  89. package/openspec/specs/logger/spec.md +0 -71
  90. package/openspec/specs/mediator/spec.md +0 -72
  91. package/openspec/specs/multi-profile-conversations/spec.md +0 -145
  92. package/openspec/specs/path-utils/spec.md +0 -101
  93. package/openspec/specs/profiles/spec.md +0 -94
  94. package/openspec/specs/storage/spec.md +0 -198
  95. package/openspec/specs/testing/spec.md +0 -237
  96. package/openspec/specs/v2-installer/spec.md +0 -205
  97. package/openspec/specs/validators/spec.md +0 -65
  98. package/scripts/build.ts +0 -88
  99. package/scripts/clean-build.ps1 +0 -4
  100. package/scripts/clean-build.sh +0 -5
  101. package/scripts/install-browser.ps1 +0 -5
  102. package/scripts/install-browser.sh +0 -6
  103. package/scripts/lint-path-mediation.ps1 +0 -65
  104. package/scripts/lint-path-mediation.sh +0 -40
  105. package/tests/cli/auth-command.test.ts +0 -220
  106. package/tests/cli/command-registry.test.ts +0 -67
  107. package/tests/cli/continue-command.test.ts +0 -100
  108. package/tests/cli/delete-command.test.ts +0 -128
  109. package/tests/cli/export-all-command.test.ts +0 -375
  110. package/tests/cli/install-browser-command.test.ts +0 -48
  111. package/tests/cli/list-command.test.ts +0 -179
  112. package/tests/cli/new-command.test.ts +0 -139
  113. package/tests/cli/status-command.test.ts +0 -106
  114. package/tests/core/query-handlers.test.ts +0 -187
  115. package/tests/fixtures/auth-fixtures.ts +0 -98
  116. package/tests/fixtures/chat-fixtures.ts +0 -87
  117. package/tests/infrastructure/cli-table.test.ts +0 -107
  118. package/tests/infrastructure/formatters.test.ts +0 -202
  119. package/tests/infrastructure/io.test.ts +0 -197
  120. package/tests/infrastructure/logger.test.ts +0 -74
  121. package/tests/infrastructure/storage.test.ts +0 -335
  122. package/tests/infrastructure/validators.test.ts +0 -67
  123. package/tests/integration/commands/auth.test.ts +0 -186
  124. package/tests/integration/commands/continue.test.ts +0 -130
  125. package/tests/integration/commands/delete.test.ts +0 -140
  126. package/tests/integration/commands/export.test.ts +0 -266
  127. package/tests/integration/commands/fetch.test.ts +0 -238
  128. package/tests/integration/commands/list.test.ts +0 -281
  129. package/tests/integration/commands/profile.test.ts +0 -258
  130. package/tests/integration/commands/status.test.ts +0 -223
  131. package/tests/integration/installer-script-shape.test.ts +0 -67
  132. package/tests/parity/compare-outputs.ts +0 -359
  133. package/tests/parity/test-commands-parity.ps1 +0 -82
  134. package/tests/parity/test-commands-parity.sh +0 -61
  135. package/tests/services/auth-service.test.ts +0 -315
  136. package/tests/services/cookie-monitor.test.ts +0 -229
  137. package/tests/services/cookie-storage-service.test.ts +0 -230
  138. package/tests/services/gemini-client-wrapper.test.ts +0 -688
  139. package/tests/services/install-browser-service.test.ts +0 -83
  140. package/tests/services/playwright-cli-driver.test.ts +0 -468
  141. package/tests/services/profile-auth-manager.test.ts +0 -334
  142. package/tests/services/profile-service.test.ts +0 -224
  143. package/tests/setup.ts +0 -95
  144. package/tests/smoke/smoke.test.ts +0 -52
  145. package/tests/unit/config.test.ts +0 -159
  146. package/tests/unit/errors.test.ts +0 -119
  147. package/tests/unit/formatters.test.ts +0 -316
  148. package/tests/unit/mediator.test.ts +0 -152
  149. package/tests/unit/path-utils.test.ts +0 -289
  150. package/tsconfig.json +0 -16
@@ -1,169 +0,0 @@
1
- ---
2
- description: Enter explore mode - think through ideas, investigate problems, clarify requirements
3
- ---
4
-
5
- Enter explore mode. Think deeply. Visualize freely. Follow the conversation wherever it goes.
6
-
7
- **IMPORTANT: Explore mode is for thinking, not implementing.** You may read files, search code, and investigate the codebase, but you must NEVER write code or implement features. If the user asks you to implement something, remind them to exit explore mode first and create a change proposal. You MAY create OpenSpec artifacts (proposals, designs, specs) if the user asks—that's capturing thinking, not implementing.
8
-
9
- **This is a stance, not a workflow.** There are no fixed steps, no required sequence, no mandatory outputs. You're a thinking partner helping the user explore.
10
-
11
- **Input**: The argument after `/opsx-explore` is whatever the user wants to think about. Could be:
12
- - A vague idea: "real-time collaboration"
13
- - A specific problem: "the auth system is getting unwieldy"
14
- - A change name: "add-dark-mode" (to explore in context of that change)
15
- - A comparison: "postgres vs sqlite for this"
16
- - Nothing (just enter explore mode)
17
-
18
- ---
19
-
20
- ## The Stance
21
-
22
- - **Curious, not prescriptive** - Ask questions that emerge naturally, don't follow a script
23
- - **Open threads, not interrogations** - Surface multiple interesting directions and let the user follow what resonates. Don't funnel them through a single path of questions.
24
- - **Visual** - Use ASCII diagrams liberally when they'd help clarify thinking
25
- - **Adaptive** - Follow interesting threads, pivot when new information emerges
26
- - **Patient** - Don't rush to conclusions, let the shape of the problem emerge
27
- - **Grounded** - Explore the actual codebase when relevant, don't just theorize
28
-
29
- ---
30
-
31
- ## What You Might Do
32
-
33
- Depending on what the user brings, you might:
34
-
35
- **Explore the problem space**
36
- - Ask clarifying questions that emerge from what they said
37
- - Challenge assumptions
38
- - Reframe the problem
39
- - Find analogies
40
-
41
- **Investigate the codebase**
42
- - Map existing architecture relevant to the discussion
43
- - Find integration points
44
- - Identify patterns already in use
45
- - Surface hidden complexity
46
-
47
- **Compare options**
48
- - Brainstorm multiple approaches
49
- - Build comparison tables
50
- - Sketch tradeoffs
51
- - Recommend a path (if asked)
52
-
53
- **Visualize**
54
- ```
55
- ┌─────────────────────────────────────────┐
56
- │ Use ASCII diagrams liberally │
57
- ├─────────────────────────────────────────┤
58
- │ │
59
- │ ┌────────┐ ┌────────┐ │
60
- │ │ State │────────▶│ State │ │
61
- │ │ A │ │ B │ │
62
- │ └────────┘ └────────┘ │
63
- │ │
64
- │ System diagrams, state machines, │
65
- │ data flows, architecture sketches, │
66
- │ dependency graphs, comparison tables │
67
- │ │
68
- └─────────────────────────────────────────┘
69
- ```
70
-
71
- **Surface risks and unknowns**
72
- - Identify what could go wrong
73
- - Find gaps in understanding
74
- - Suggest spikes or investigations
75
-
76
- ---
77
-
78
- ## OpenSpec Awareness
79
-
80
- You have full context of the OpenSpec system. Use it naturally, don't force it.
81
-
82
- ### Check for context
83
-
84
- At the start, quickly check what exists:
85
- ```bash
86
- openspec list --json
87
- ```
88
-
89
- This tells you:
90
- - If there are active changes
91
- - Their names, schemas, and status
92
- - What the user might be working on
93
-
94
- If the user mentioned a specific change name, read its artifacts for context.
95
-
96
- ### When no change exists
97
-
98
- Think freely. When insights crystallize, you might offer:
99
-
100
- - "This feels solid enough to start a change. Want me to create a proposal?"
101
- - Or keep exploring - no pressure to formalize
102
-
103
- ### When a change exists
104
-
105
- If the user mentions a change or you detect one is relevant:
106
-
107
- 1. **Resolve and read existing artifacts for context**
108
- - Run `openspec status --change "<name>" --json`.
109
- - Use `changeRoot`, `artifactPaths`, and `actionContext` from the status JSON.
110
- - Read existing files from `artifactPaths.<artifact>.existingOutputPaths`.
111
-
112
- 2. **Reference them naturally in conversation**
113
- - "Your design mentions using Redis, but we just realized SQLite fits better..."
114
- - "The proposal scopes this to premium users, but we're now thinking everyone..."
115
-
116
- 3. **Offer to capture when decisions are made**
117
-
118
- | Insight Type | Where to Capture |
119
- |----------------------------|--------------------------------|
120
- | New requirement discovered | `specs/<capability>/spec.md` |
121
- | Requirement changed | `specs/<capability>/spec.md` |
122
- | Design decision made | `design.md` |
123
- | Scope changed | `proposal.md` |
124
- | New work identified | `tasks.md` |
125
- | Assumption invalidated | Relevant artifact |
126
-
127
- Example offers:
128
- - "That's a design decision. Capture it in design.md?"
129
- - "This is a new requirement. Add it to specs?"
130
- - "This changes scope. Update the proposal?"
131
-
132
- 4. **The user decides** - Offer and move on. Don't pressure. Don't auto-capture.
133
-
134
- ---
135
-
136
- ## What You Don't Have To Do
137
-
138
- - Follow a script
139
- - Ask the same questions every time
140
- - Produce a specific artifact
141
- - Reach a conclusion
142
- - Stay on topic if a tangent is valuable
143
- - Be brief (this is thinking time)
144
-
145
- ---
146
-
147
- ## Ending Discovery
148
-
149
- There's no required ending. Discovery might:
150
-
151
- - **Flow into a proposal**: "Ready to start? I can create a change proposal."
152
- - **Result in artifact updates**: "Updated design.md with these decisions"
153
- - **Just provide clarity**: User has what they need, moves on
154
- - **Continue later**: "We can pick this up anytime"
155
-
156
- When things crystallize, you might offer a summary - but it's optional. Sometimes the thinking IS the value.
157
-
158
- ---
159
-
160
- ## Guardrails
161
-
162
- - **Don't implement** - Never write code or implement features. Creating OpenSpec artifacts is fine, writing application code is not.
163
- - **Don't fake understanding** - If something is unclear, dig deeper
164
- - **Don't rush** - Discovery is thinking time, not task time
165
- - **Don't force structure** - Let patterns emerge naturally
166
- - **Don't auto-capture** - Offer to save insights, don't just do it
167
- - **Do visualize** - A good diagram is worth many paragraphs
168
- - **Do explore the codebase** - Ground discussions in reality
169
- - **Do question assumptions** - Including the user's and your own
@@ -1,104 +0,0 @@
1
- ---
2
- description: Propose a new change - create it and generate all artifacts in one step
3
- ---
4
-
5
- Propose a new change - create the change and generate all artifacts in one step.
6
-
7
- I'll create a change with artifacts:
8
- - proposal.md (what & why)
9
- - design.md (how)
10
- - tasks.md (implementation steps)
11
-
12
- When ready to implement, run /opsx-apply
13
-
14
- ---
15
-
16
- **Input**: The argument after `/opsx-propose` is the change name (kebab-case), OR a description of what the user wants to build.
17
-
18
- **Steps**
19
-
20
- 1. **If no input provided, ask what they want to build**
21
-
22
- Use the **AskUserQuestion tool** (open-ended, no preset options) to ask:
23
- > "What change do you want to work on? Describe what you want to build or fix."
24
-
25
- From their description, derive a kebab-case name (e.g., "add user authentication" → `add-user-auth`).
26
-
27
- **IMPORTANT**: Do NOT proceed without understanding what the user wants to build.
28
-
29
- 2. **Create the change directory**
30
- ```bash
31
- openspec new change "<name>"
32
- ```
33
- This creates a scaffolded change in the planning home resolved by the CLI with `.openspec.yaml`.
34
-
35
- 3. **Get the artifact build order**
36
- ```bash
37
- openspec status --change "<name>" --json
38
- ```
39
- Parse the JSON to get:
40
- - `applyRequires`: array of artifact IDs needed before implementation (e.g., `["tasks"]`)
41
- - `artifacts`: list of all artifacts with their status and dependencies
42
- - `planningHome`, `changeRoot`, `artifactPaths`, and `actionContext`: path and scope context. Use these instead of assuming repo-local paths.
43
-
44
- 4. **Create artifacts in sequence until apply-ready**
45
-
46
- Use the **TodoWrite tool** to track progress through the artifacts.
47
-
48
- Loop through artifacts in dependency order (artifacts with no pending dependencies first):
49
-
50
- a. **For each artifact that is `ready` (dependencies satisfied)**:
51
- - Get instructions:
52
- ```bash
53
- openspec instructions <artifact-id> --change "<name>" --json
54
- ```
55
- - The instructions JSON includes:
56
- - `context`: Project background (constraints for you - do NOT include in output)
57
- - `rules`: Artifact-specific rules (constraints for you - do NOT include in output)
58
- - `template`: The structure to use for your output file
59
- - `instruction`: Schema-specific guidance for this artifact type
60
- - `resolvedOutputPath`: Resolved path or pattern to write the artifact
61
- - `dependencies`: Completed artifacts to read for context
62
- - Read any completed dependency files for context
63
- - Create the artifact file using `template` as the structure and write it to `resolvedOutputPath`
64
- - Apply `context` and `rules` as constraints - but do NOT copy them into the file
65
- - Show brief progress: "Created <artifact-id>"
66
-
67
- b. **Continue until all `applyRequires` artifacts are complete**
68
- - After creating each artifact, re-run `openspec status --change "<name>" --json`
69
- - Check if every artifact ID in `applyRequires` has `status: "done"` in the artifacts array
70
- - Stop when all `applyRequires` artifacts are done
71
-
72
- c. **If an artifact requires user input** (unclear context):
73
- - Use **AskUserQuestion tool** to clarify
74
- - Then continue with creation
75
-
76
- 5. **Show final status**
77
- ```bash
78
- openspec status --change "<name>"
79
- ```
80
-
81
- **Output**
82
-
83
- After completing all artifacts, summarize:
84
- - Change name and location
85
- - List of artifacts created with brief descriptions
86
- - What's ready: "All artifacts created! Ready for implementation."
87
- - Prompt: "Run `/opsx-apply` to start implementing."
88
-
89
- **Artifact Creation Guidelines**
90
-
91
- - Follow the `instruction` field from `openspec instructions` for each artifact type
92
- - The schema defines what each artifact should contain - follow it
93
- - Read dependency artifacts for context before creating new ones
94
- - Use `template` as the structure for your output file - fill in its sections
95
- - **IMPORTANT**: `context` and `rules` are constraints for YOU, not content for the file
96
- - Do NOT copy `<context>`, `<rules>`, `<project_context>` blocks into the artifact
97
- - These guide what you write, but should never appear in the output
98
-
99
- **Guardrails**
100
- - Create ALL artifacts needed for implementation (as defined by schema's `apply.requires`)
101
- - Always read dependency artifacts before creating a new one
102
- - If context is critically unclear, ask the user - but prefer making reasonable decisions to keep momentum
103
- - If a change with that name already exists, ask if user wants to continue it or create a new one
104
- - Verify each artifact file exists after writing before proceeding to next
@@ -1,140 +0,0 @@
1
- ---
2
- description: Sync delta specs from a change to main specs
3
- ---
4
-
5
- Sync delta specs from a change to main specs.
6
-
7
- This is an **agent-driven** operation - you will read delta specs and directly edit main specs to apply the changes. This allows intelligent merging (e.g., adding a scenario without copying the entire requirement).
8
-
9
- **Input**: Optionally specify a change name after `/opsx-sync` (e.g., `/opsx-sync add-auth`). If omitted, check if it can be inferred from conversation context. If vague or ambiguous you MUST prompt for available changes.
10
-
11
- **Steps**
12
-
13
- 1. **If no change name provided, prompt for selection**
14
-
15
- Run `openspec list --json` to get available changes. Use the **AskUserQuestion tool** to let the user select.
16
-
17
- Show changes that have delta specs (under `specs/` directory).
18
-
19
- **IMPORTANT**: Do NOT guess or auto-select a change. Always let the user choose.
20
-
21
- 2. **Resolve change context**
22
-
23
- Run:
24
- ```bash
25
- openspec status --change "<name>" --json
26
- ```
27
-
28
- If status reports `actionContext.mode: "workspace-planning"`, explain that workspace spec sync is not supported in this slice and STOP. Do not fall back to repo-local paths or edit linked repos.
29
-
30
- 3. **Find delta specs**
31
-
32
- Use `artifactPaths.specs.existingOutputPaths` from the status JSON as the list of delta spec files.
33
-
34
- Each delta spec file contains sections like:
35
- - `## ADDED Requirements` - New requirements to add
36
- - `## MODIFIED Requirements` - Changes to existing requirements
37
- - `## REMOVED Requirements` - Requirements to remove
38
- - `## RENAMED Requirements` - Requirements to rename (FROM:/TO: format)
39
-
40
- If no delta specs found, inform user and stop.
41
-
42
- 4. **For each delta spec, apply changes to main specs**
43
-
44
- For each repo-local capability delta spec path returned by the CLI:
45
-
46
- a. **Read the delta spec** to understand the intended changes
47
-
48
- b. **Read the main spec** at `openspec/specs/<capability>/spec.md` (may not exist yet)
49
-
50
- c. **Apply changes intelligently**:
51
-
52
- **ADDED Requirements:**
53
- - If requirement doesn't exist in main spec → add it
54
- - If requirement already exists → update it to match (treat as implicit MODIFIED)
55
-
56
- **MODIFIED Requirements:**
57
- - Find the requirement in main spec
58
- - Apply the changes - this can be:
59
- - Adding new scenarios (don't need to copy existing ones)
60
- - Modifying existing scenarios
61
- - Changing the requirement description
62
- - Preserve scenarios/content not mentioned in the delta
63
-
64
- **REMOVED Requirements:**
65
- - Remove the entire requirement block from main spec
66
-
67
- **RENAMED Requirements:**
68
- - Find the FROM requirement, rename to TO
69
-
70
- d. **Create new main spec** if capability doesn't exist yet:
71
- - Create `openspec/specs/<capability>/spec.md`
72
- - Add Purpose section (can be brief, mark as TBD)
73
- - Add Requirements section with the ADDED requirements
74
-
75
- 5. **Show summary**
76
-
77
- After applying all changes, summarize:
78
- - Which capabilities were updated
79
- - What changes were made (requirements added/modified/removed/renamed)
80
-
81
- **Delta Spec Format Reference**
82
-
83
- ```markdown
84
- ## ADDED Requirements
85
-
86
- ### Requirement: New Feature
87
- The system SHALL do something new.
88
-
89
- #### Scenario: Basic case
90
- - **WHEN** user does X
91
- - **THEN** system does Y
92
-
93
- ## MODIFIED Requirements
94
-
95
- ### Requirement: Existing Feature
96
- #### Scenario: New scenario to add
97
- - **WHEN** user does A
98
- - **THEN** system does B
99
-
100
- ## REMOVED Requirements
101
-
102
- ### Requirement: Deprecated Feature
103
-
104
- ## RENAMED Requirements
105
-
106
- - FROM: `### Requirement: Old Name`
107
- - TO: `### Requirement: New Name`
108
- ```
109
-
110
- **Key Principle: Intelligent Merging**
111
-
112
- Unlike programmatic merging, you can apply **partial updates**:
113
- - To add a scenario, just include that scenario under MODIFIED - don't copy existing scenarios
114
- - The delta represents *intent*, not a wholesale replacement
115
- - Use your judgment to merge changes sensibly
116
-
117
- **Output On Success**
118
-
119
- ```
120
- ## Specs Synced: <change-name>
121
-
122
- Updated main specs:
123
-
124
- **<capability-1>**:
125
- - Added requirement: "New Feature"
126
- - Modified requirement: "Existing Feature" (added 1 scenario)
127
-
128
- **<capability-2>**:
129
- - Created new spec file
130
- - Added requirement: "Another Feature"
131
-
132
- Main specs are now updated. The change remains active - archive when implementation is complete.
133
- ```
134
-
135
- **Guardrails**
136
- - Read both delta and main specs before making changes
137
- - Preserve existing content not mentioned in delta
138
- - If something is unclear, ask for clarification
139
- - Show what you're changing as you go
140
- - The operation should be idempotent - running twice should give same result
@@ -1,9 +0,0 @@
1
- ---
2
- description: Search GitHub repositories for technical answers using DeepWiki
3
- agent: general
4
- subtask: true
5
- ---
6
-
7
- Use the `skill` tool to load the `intellisearch` skill, then use it to answer this query:
8
-
9
- $ARGUMENTS
@@ -1,20 +0,0 @@
1
- {
2
- "$schema": "https://opencode.ai/config.json",
3
- "permission": {
4
- "skill": {
5
- "intellisearch": "allow"
6
- },
7
- "external_directory": {
8
- "C:\\dev\\projects\\github\\webgemini-cli\\src\\**": "allow"
9
- },
10
- "edit": {
11
- "C:\\dev\\projects\\github\\webgemini-cli\\src\\**": "deny"
12
- }
13
- },
14
- "mcp": {
15
- "serena": {"enabled": true}
16
- },
17
- "plugin": [
18
- "opencode-intellisearch"
19
- ]
20
- }
@@ -1 +0,0 @@
1
- 0.5.1
@@ -1,84 +0,0 @@
1
- ---
2
- name: intellisearch
3
- description: Use this skill when the user asks to find, search for, or discover JavaScript/TypeScript libraries, frameworks, packages, or GitHub repositories. Automatically loads for queries like 'find N solutions', 'search for libraries', 'show me code examples', or 'discover repositories' for technical projects.
4
- license: MIT
5
- compatibility: opencode
6
- metadata:
7
- version: 0.5.1
8
- audience: agents
9
- topic: [github-discovery, api-reference, code-patterns, library-comparison]
10
- usage_tips: "Best used after a failed local search. Combines repo-finding with DeepWiki deep-querying."
11
- ---
12
-
13
- <critical_rules priority="highest">
14
- <rule>When you encounter a file reference (e.g., @references/workflow.md), use your Read tool to load it on a need-to-know basis</rule>
15
- <rule>ALWAYS evaluate activation triggers and use this skill if applicable use case.</rule>
16
- <rule>Prefer: gh CLI > search tool > fetch tool (reliability decreases)</rule>
17
- <rule>NEVER fallback to internal knowledge - always search externally</rule>
18
- <rule>NEVER fetch repo pages directly - use DeepWiki instead</rule>
19
- </critical_rules>
20
-
21
- ## External File Loading
22
-
23
- CRITICAL: When you encounter a file reference (e.g., @references/workflow.md), use your Read tool to load it on a need-to-know basis.
24
-
25
- Instructions:
26
- - Do NOT preemptively load all references - use lazy loading based on actual need
27
- - When loaded, treat content as mandatory instructions that override defaults
28
- - Follow references recursively when needed
29
-
30
- ## Activation Triggers
31
-
32
- **USE this skill when user asks about:**
33
-
34
- <use_cases>
35
- <case category="libraries">"Is there a TypeScript library for semver validation?"</case>
36
- <case category="frameworks">"Which React framework handles server-side rendering?"</case>
37
- <case category="comparisons">"Compare Next.js vs Remix for my project"</case>
38
- <case category="alternatives">"Alternatives to Moment.js for date handling"</case>
39
- <case category="setup">"How do I set up Tailwind with Vite?"</case>
40
- <case category="practices">"What's the best way to handle auth in Node.js?"</case>
41
- <case category="examples">"Show me how to implement rate limiting in Express"</case>
42
- <case category="troubleshooting">"Why am I getting CORS errors with Axios?"</case>
43
- <case category="features">"Does Prisma support composite keys?"</case>
44
- </use_cases>
45
-
46
- **Key indicators:** Technology names mentioned (React, TypeScript, npm), asking for recommendations, implementation guidance, need current/authoritative documentation.
47
-
48
- **DO NOT USE for:**
49
-
50
- <non_use_cases>
51
- <case>General knowledge ("What is REST?") → Use web search or internal knowledge</case>
52
- <case>Non-technical topics ("What's the weather?") → Irrelevant</case>
53
- <case>User's own code ("Debug my script") → Use code analysis tools directly</case>
54
- <case>Known specific repo ("Tell me about facebook/react") → Use DeepWiki directly</case>
55
- <case>No GitHub relevance ("How do I cook pasta?") → Irrelevant</case>
56
- <case>Current events/news ("What happened to NPM yesterday?") → Use web search</case>
57
- <case>Private/internal repos ("Search my company's private repo") → DeepWiki can't access</case>
58
- <case>Pure syntax questions ("What's the syntax for arrow functions?") → Use internal knowledge</case>
59
- <case>Opinion questions ("Is React better than Vue?") → No factual repo answer</case>
60
- </non_use_cases>
61
-
62
- ## Workflow Summary
63
-
64
- <workflow>
65
- <phase name="detect">Check available tools: gh CLI → search tool → fetch tool</phase>
66
- <phase name="search">Execute search using highest priority available tool</phase>
67
- <phase name="filter">Select top 3 repos by stars, recency, language match</phase>
68
- <phase name="query">Query DeepWiki with repos (multi-repo first, fallback to individual)</phase>
69
- <phase name="synthesize">Return answer with trade-offs, implementation guidance, links</phase>
70
- </workflow>
71
-
72
- ## References
73
-
74
- **Read immediately:**
75
- - @references/examples.md - Few-shot examples (library discovery, comparison, fallback)
76
- - @references/workflow.md - Pipeline phases, decision matrix, failure handling
77
- - @references/search-workflow.md - Tool detection, URI cycling
78
-
79
- **Load on-demand:**
80
- - @references/gh-cli.md - GitHub CLI search syntax
81
- - @references/deepwiki-tools.md - DeepWiki usage, blocked paths, validation
82
- - @references/google-search.md - Google operators
83
- - @references/brave-search.md - Brave operators
84
- - @references/ddg-search.md - DuckDuckGo operators
@@ -1,67 +0,0 @@
1
- # Brave Search Operators
2
-
3
- Source: https://search.brave.com/help/operators
4
-
5
- ## File & Content Operators
6
-
7
- | Operator | Syntax | Example | Purpose |
8
- |----------|--------|---------|---------|
9
- | File extension | `ext:ext` | `honda gx120 manual ext:pdf` | Specific file extension |
10
- | File type | `filetype:type` | `evaluation filetype:pdf` | File type (pdf, doc, etc.) |
11
- | In body | `inbody:term` | `nvidia 1080 ti inbody:"founders edition"` | Term in page body |
12
- | In title | `intitle:term` | `seo conference intitle:2023` | Term in page title |
13
- | In page | `inpage:term` | `oscars 2024 inpage:"best costume"` | Term in title or body |
14
-
15
- ## Location & Language Operators
16
-
17
- | Operator | Syntax | Example | Purpose |
18
- |----------|--------|---------|---------|
19
- | Language | `lang:code` or `language:code` | `visas lang:es` | Language (ISO 639-1 code) |
20
- | Location | `loc:code` or `location:code` | `niagara falls loc:ca` | Country/region (ISO 3166-1 alpha-2) |
21
-
22
- ## Site & Term Operators
23
-
24
- | Operator | Syntax | Example | Purpose |
25
- |----------|--------|---------|---------|
26
- | Site | `site:domain.com` | `goggles site:brave.com` | Search specific site |
27
- | Include | `+term` | `gpu +freesync` | Must contain term |
28
- | Exclude | `-term` | `office -microsoft` | Must not contain term |
29
- | Exact match | `"phrase"` | `"order of the phoenix"` | Exact phrase |
30
-
31
- ## Logical Operators
32
-
33
- | Operator | Syntax | Example | Purpose |
34
- |----------|--------|---------|---------|
35
- | AND | `term AND term` | `visa loc:gb AND lang:en` | All conditions met |
36
- | OR | `term OR term` | `inpage:australia OR inpage:"new zealand"` | Any condition met |
37
- | NOT | `term NOT condition` | `brave search NOT site:brave.com` | Excludes condition |
38
-
39
- ## Usage Notes
40
-
41
- <important>
42
- - Search operators are experimental and in early development
43
- - Can place operators anywhere in query
44
- - Language codes: ISO 639-1 (en, es, fr, etc.)
45
- - Country codes: ISO 3166-1 alpha-2 (us, ca, gb, etc.)
46
- </important>
47
-
48
- ## Common Patterns for Technical Search
49
-
50
- <patterns>
51
- ```bash
52
- # Find documentation files
53
- "user guide" filetype:pdf
54
-
55
- # Language-specific results
56
- react hooks typescript tutorial lang:en
57
-
58
- # Combined conditions
59
- typescript validator intitle:library AND loc:us
60
-
61
- # Exclude specific results
62
- graph database library -mongodb
63
-
64
- # Package search
65
- npm package semver validation
66
- ```
67
- </patterns>
@@ -1,79 +0,0 @@
1
- # DuckDuckGo Search Operators
2
-
3
- Source: https://duckduckgo.com/duckduckgo-help-pages/results/syntax
4
-
5
- ## Basic Operators
6
-
7
- | Operator | Syntax | Example | Purpose |
8
- |----------|--------|---------|---------|
9
- | Exact match | `"phrase"` | `"cats and dogs"` | Exact phrase match |
10
- | Semantic similar | `~"phrase"` | `~"cats and dogs"` | Semantically similar results (experimental) |
11
- | Include more | `term +term2` | `cats +dogs` | More emphasis on term |
12
- | Exclude | `term -term2` | `cats -dogs` | Exclude term from results |
13
-
14
- ## File & Site Operators
15
-
16
- | Operator | Syntax | Example | Purpose |
17
- |----------|--------|---------|---------|
18
- | File type | `filetype:type` | `cats filetype:pdf` | Specific file type |
19
- | Site search | `site:domain.com` | `dogs site:example.com` | Search specific site |
20
- | Exclude site | `-site:domain.com` | `cats -site:example.com` | Exclude specific site |
21
-
22
- ## Page Location Operators
23
-
24
- | Operator | Syntax | Example | Purpose |
25
- |----------|--------|---------|---------|
26
- | In title | `intitle:term` | `intitle:dogs` | Term in page title |
27
- | In URL | `inurl:term` | `inurl:cats` | Term in page URL |
28
-
29
- ## Navigation Operators
30
-
31
- | Operator | Syntax | Example | Purpose |
32
- |----------|--------|---------|---------|
33
- | Go to first | `\term` | `\futurama` | Navigate to first result |
34
- | Bang shortcut | `!site term` | `!a blink182` | Search on other site directly |
35
- | Safe search on | `!safeon` | `term !safeon` | Enable safe search |
36
- | Safe search off | `!safeoff` | `term !safeoff` | Disable safe search |
37
-
38
- ## Supported File Types
39
-
40
- <file_types>
41
- - `pdf` - PDF documents
42
- - `doc` / `docx` - Word documents
43
- - `xls` / `xlsx` - Excel spreadsheets
44
- - `ppt` / `pptx` - PowerPoint presentations
45
- - `html` - HTML files
46
- </file_types>
47
-
48
- ## Usage Notes
49
-
50
- <important>
51
- - If no results found with advanced syntax, related results may be shown
52
- - Bang shortcuts search other sites' search engines (subject to that site's policies)
53
- - Thousands of bang shortcuts available (see: https://duckduckgo.com/bang)
54
- - Note: Some advanced syntax may not work correctly on all queries
55
- </important>
56
-
57
- ## Common Patterns for Technical Search
58
-
59
- <patterns>
60
- ```bash
61
- # Find libraries
62
- typescript validation library
63
-
64
- # Exact phrase
65
- "semantic versioning" npm package
66
-
67
- # File type filter
68
- "readme" filetype:md tutorial
69
-
70
- # Title search
71
- intitle:react hooks typescript
72
-
73
- # Combined
74
- semver validation -test intitle:library
75
-
76
- # Package search
77
- nodejs graph database library
78
- ```
79
- </patterns>