Skip to content

Conversation

@thoroc
Copy link
Contributor

@thoroc thoroc commented Jan 31, 2026

Summary

Minor updates to the existing agent loader plugin to align with new patterns.

Changes

Dependencies

Blocks

  • None

Testing

  • Tests pass: bunx nx test opencode-agent-loader-plugin
  • Type-check passes: bunx nx type-check opencode-agent-loader-plugin

- Update package.json and project.json configuration
- Refactor load-all-agent-specs.ts for better patterns
- Update tsconfig.test.json formatting
- Optional: Aligns with core plugin patterns (PR6)
- Independent updates to existing package

Minor improvements to agent loader plugin configuration and code patterns.
thoroc added a commit that referenced this pull request Feb 1, 2026
Remove all package changes from this PR - they belong in separate PRs:
- packages/opencode-agent-loader-plugin/ → PR #28
- packages/opencode-font/ → PR #24
- packages/opencode-warcraft-notifications-plugin/ → PR #29

PR #21 now contains ONLY Biome infrastructure:
- biome.json configuration
- lefthook.yml git hooks
- nx.json targets for lint/format
- Root package.json scripts
- CI workflow (validate-pr.yml)
- Infrastructure executors (typecheck, validate-tsdoc)
- Generator templates with Biome config

Apply Biome formatting to biome.json (trailing newline).
thoroc added a commit that referenced this pull request Feb 1, 2026
* feat(infra): add Biome linting/formatting infrastructure

- Add Biome v2.3.13 configuration with custom rules
- Configure lint, format, and format:check targets in nx.json
- Add validate-tsdoc executor for documentation validation
- Update lefthook.yml with Biome pre-commit hooks
- Update validate-pr.yml workflow for Biome
- Update generators to include Biome configuration

This PR establishes the foundation for Biome-based linting and formatting
that all subsequent PRs will use.

* fix: resolve CI failures on Biome infrastructure PR

- Remove opencode-font override from biome.json to enable linting/formatting
- Fix ASCIISiteTitle variable name typo (_siteTitle -> siteTitle)
- Fix non-null assertion in load-all-agent-specs.ts using type guard pattern

All checks now pass:
- Biome linting ✓
- Biome formatting ✓
- docs-builder build ✓

* fix(agent-loader): fix type predicate in load-all-agent-specs.ts

Use proper type predicate pattern instead of type assertion
for filtering successful agent spec loads.

Fixes CI typecheck failure.

* fix: resolve remaining CI failures on PR #21

- Fix type predicate in load-all-agent-specs.ts using proper pattern
- Fix 2 lint errors in validate-docs-links.ts (noImplicitAnyLet, useIterableCallbackReturn)
- Add missing imports to Header.astro (ASCIISiteTitle, SocialIcons, Search, ThemeSelect)

Typecheck and lint now pass locally.

* style: apply Biome formatting to fix CI errors

Apply Biome formatting to 4 package.json files:
- packages/opencode-agent-loader-plugin/package.json
- packages/opencode-agent-loader-plugin/tsconfig.test.json
- packages/opencode-font/package.json
- packages/opencode-warcraft-notifications-plugin/package.json

Fixes format CI failures on PR #21.

* fix(agent-loader): use type assertion instead of type predicate

Replace type predicate with type assertion to satisfy stricter CI checks.
The filter returns items with defined spec, then we safely assert the type.

Fixes typecheck failures on PR #21.

* refactor: cleanup PR #21 to only include infrastructure

Remove all package changes from this PR - they belong in separate PRs:
- packages/opencode-agent-loader-plugin/ → PR #28
- packages/opencode-font/ → PR #24
- packages/opencode-warcraft-notifications-plugin/ → PR #29

PR #21 now contains ONLY Biome infrastructure:
- biome.json configuration
- lefthook.yml git hooks
- nx.json targets for lint/format
- Root package.json scripts
- CI workflow (validate-pr.yml)
- Infrastructure executors (typecheck, validate-tsdoc)
- Generator templates with Biome config

Apply Biome formatting to biome.json (trailing newline).

* fix(biome): add overrides for test/template files to fix lint errors

Add Biome linter overrides to allow patterns in test/template files:
- Disable noBannedTypes for tools/executors/**/*.test.ts (Function type)
- Disable noNamespace for executors and templates
- Disable noExplicitAny for generator templates

Fixes CI lint failures:
- 'Don't use Function as a type' errors
- 'TypeScript namespaces are outdated' errors
- 'Unexpected any' warnings in templates

Also fixes dev-proxy test type assertions.

* fix(biome): add file ignores for packages not in this PR

Add file ignores to biome.json for packages and tools that belong in other PRs:
- packages/opencode-agent-loader-plugin/*
- packages/opencode-font/*
- packages/opencode-warcraft-notifications-plugin/*
- tools/dev/*
- tools/executors/dev-proxy/*
- tools/executors/check-mirror-exists/*
- tools/executors/validate-skill-md/*
- tools/executors/validate-skills/*

This allows the infrastructure PR to pass CI without linting files
that will be properly formatted and fixed in their respective PRs.

Also apply Biome formatting to biome.json (trailing newline).

* fix(biome): add file ignores and template overrides to fix CI

- Add files.includes to ignore packages not in this PR:
  - packages/opencode-agent-loader-plugin
  - packages/opencode-font
  - packages/opencode-warcraft-notifications-plugin

- Add linter override for generator template files to disable noExplicitAny

- Apply Biome formatting to biome.json

Fixes CI lint and format errors.

* fix(biome): simplify biome.json configuration to fix CI

Remove all package file ignores and use a clean, minimal biome.json
that only ignores standard directories (dist, node_modules).

This ensures the infrastructure PR can pass CI without trying to
lint files that belong in other PRs.

All local checks pass:
- bun run format:check ✓
- bun run lint ✓

* refactor: clean PR #21 to only include infrastructure

Remove all packages and dev tools that belong in other PRs:
- packages/* (moved to PR #22, #23, #24, etc.)
- tools/dev/* (moved to PR #5)
- tools/executors/dev-proxy/* (moved to PR #5)
- tools/executors/check-mirror-exists/* (moved to PR #5)
- tools/executors/validate-skill-md/* (moved to PR #5)
- tools/executors/validate-skills/* (moved to PR #5)

Keep only Biome infrastructure:
- biome.json, lefthook.yml, nx.json, package.json
- .github/workflows/validate-pr.yml
- libs/workflows/project.json
- tools/executors/typecheck/
- tools/executors/validate-tsdoc/
- tools/generators/* (templates with Biome config)

* fix: resolve Biome linting and formatting issues for CI

- Updated opencode-font package.json to skip Biome (disabled in root config)
- Fixed type predicate for AgentSpecLoadResult to remove non-null assertion
- Applied Biome formatting to all JSON files
- All checks now pass: lint, format, type-check

* fix: add verbose flag to Biome CI command for detailed output

* fix(biome): add diagnostic level flag to Biome CI command for improved error reporting

* fix: add output-style flag to various nx affected commands for consistent output

* docs: add Biome diagnostics reference to skill documentation

- Add https://biomejs.dev/reference/diagnostics/ to Getting More Help section

* fix(biome): add BIOME_CONFIG_PATH environment variable for Biome CI

* fix: update globals.d.ts to ignore linting for noNamespace rule

* docs: add debugging guidance for CI failures in Biome skill documentation
@thoroc thoroc requested a review from Copilot February 1, 2026 21:49
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the agent-loader plugin to align with new infrastructure patterns, specifically integrating Biome tooling from PR #21 and updating dependencies. The changes include configuration updates, formatting standardization, and a minor code refactoring.

Changes:

  • Added Biome lint, format, and TSDoc validation targets to project.json
  • Refactored type assertion in load-all-agent-specs.ts from non-null assertion to explicit type casting
  • Updated @opencode-ai/plugin from ^1.0.133 to ^1.1.47
  • Applied consistent formatting to package.json and tsconfig.test.json

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.

File Description
packages/opencode-agent-loader-plugin/tsconfig.test.json Formatted include array to single line
packages/opencode-agent-loader-plugin/src/loader/load-all-agent-specs.ts Changed from non-null assertion to type assertion for better type safety
packages/opencode-agent-loader-plugin/project.json Added Biome tooling targets and modified dev-proxy configuration
packages/opencode-agent-loader-plugin/package.json Formatted arrays and updated plugin dependency version

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

"symlinkRoot": ".opencode/plugin",
"apply": true
}
"options": {}
Copy link

Copilot AI Feb 1, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The dev-proxy options have been changed from explicit configuration (plugins, symlinkRoot, apply) to an empty object. This differs from the pattern in opencode-warcraft-notifications-plugin which still has explicit options. If the dev-proxy executor requires these options or cannot infer them automatically, this change may break the dev-proxy functionality. Please verify that the executor can work with empty options or that this change is intentional.

Suggested change
"options": {}
"options": {
"plugins": ["opencode-agent-loader-plugin"],
"symlinkRoot": "dist",
"apply": "serve"
}

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants