feat(plugin): enhance context management and skill invocation (#239 )

* fix(shellcheck): declare and assign separately in router.sh (SC2155)

* feat(plugin): enhance context management and skill invocation

- Update .context-manifest.json to include profile and detailed source information.
- Revise context-scout.md to clarify context root discovery and navigation.
- Modify commands to replace deprecated skills with updated ones (brainstorming → approach, systematic-debugging → debugger).
- Streamline install-context.md for clarity and remove interactive profile selection.
- Improve oac-status.md to provide a more comprehensive status report.
- Add OAC system paths to session-start.sh for better context management.
- Remove obsolete skills and improve documentation for existing commands.

2026-02-23 12:12:29 +00:00

1.8 KiB

Raw Blame History

Guide: Resolving Installer Wildcard Failures

Purpose: Capture the root cause, fix, and lessons from wildcard context install failures.

Last Updated: 2026-01-12

Prerequisites

Installer changes scoped to install.sh
Registry entries validated (./scripts/registry/validate-registry.sh)

Estimated time: 10 min

Steps

1. Identify the failure mode

Symptom:

curl: (3) URL rejected: Malformed input to a URL function

Cause: Wildcard expansion returned context IDs that weren’t path-aligned (e.g., standards-code mapped to .opencode/context/core/standards/code-quality.md). Installer treated IDs as paths.

2. Expand wildcards to path-based IDs

Goal: Make wildcard expansion output core/... IDs that map directly to a path.

Update:

Expand context:core/* to core/standards/code-quality style IDs

3. Resolve context paths deterministically

Goal: Avoid ambiguous matches and ensure one registry entry is used.

Update:

Add resolve_component_path to map context IDs to the registry path
Use first(...) in jq queries for deterministic selection

4. Verify installation

bash scripts/tests/test-e2e-install.sh

Expected: All E2E tests pass on macOS and Ubuntu.

Verification

REGISTRY_URL="file://$(pwd)/registry.json" ./install.sh --list

Troubleshooting

Issue	Solution
`Malformed input to a URL function`	Ensure wildcard expansion returns `core/...` IDs and uses `resolve_component_path`
Multiple context entries for one path	Use `first(...)` in jq lookups

guides/debugging.md
guides/updating-registry.md
core-concepts/registry.md

1.8 KiB Raw Blame History Unescape Escape