diff --git a/.agents/skills/pathfinding-client/SKILL.md b/.agents/skills/pathfinding-client/SKILL.md new file mode 100644 index 0000000..04ad935 --- /dev/null +++ b/.agents/skills/pathfinding-client/SKILL.md @@ -0,0 +1,71 @@ +```markdown +# pathfinding-client Development Patterns + +> Auto-generated skill from repository analysis + +## Overview +This skill teaches the core development patterns and conventions used in the `pathfinding-client` repository. The codebase is primarily written in TypeScript, leverages Rust as a framework, and uses modern conventions for file organization, imports/exports, and testing. By following these patterns, contributors can maintain consistency and quality across the project. + +## Coding Conventions + +### File Naming +- Use **PascalCase** for all file names. + - Example: `PathFinder.ts`, `NodeMap.ts` + +### Import Style +- Use **alias imports** to reference modules. + - Example: + ```typescript + import { PathFinder } from 'algorithms/PathFinder' + ``` + +### Export Style +- Use **named exports** for all modules. + - Example: + ```typescript + export function findPath(...) { ... } + export const MAX_DEPTH = 100 + ``` + +### Commit Messages +- Follow **Conventional Commits** with the following prefixes: + - `chore`: for maintenance and non-feature changes + - `feat`: for new features +- Keep commit messages concise (average 38 characters). + - Example: + ``` + feat: add A* algorithm implementation + chore: update dependencies + ``` + +## Workflows + +_No automated workflows detected in this repository._ + +## Testing Patterns + +- **Framework:** [vitest](https://vitest.dev/) +- **Test File Pattern:** All test files should be named with the `.test.ts` suffix. + - Example: `PathFinder.test.ts` +- **Test Example:** + ```typescript + import { describe, it, expect } from 'vitest' + import { findPath } from 'algorithms/PathFinder' + + describe('findPath', () => { + it('finds the shortest path', () => { + const result = findPath(start, end, map) + expect(result).toBeDefined() + }) + }) + ``` + +## Commands + +| Command | Purpose | +|-----------------|-------------------------------------------| +| /test | Run all vitest tests | +| /lint | Run linter to check code style | +| /build | Build the TypeScript project | +| /commit | Generate a conventional commit message | +``` \ No newline at end of file diff --git a/.agents/skills/pathfinding-client/agents/openai.yaml b/.agents/skills/pathfinding-client/agents/openai.yaml new file mode 100644 index 0000000..ee917cb --- /dev/null +++ b/.agents/skills/pathfinding-client/agents/openai.yaml @@ -0,0 +1,6 @@ +interface: + display_name: "Pathfinding Client" + short_description: "Repo-specific patterns and workflows for pathfinding-client" + default_prompt: "Use the pathfinding-client repo skill to follow existing architecture, testing, and workflow conventions." +policy: + allow_implicit_invocation: true \ No newline at end of file diff --git a/.claude/ecc-tools.json b/.claude/ecc-tools.json new file mode 100644 index 0000000..fddc670 --- /dev/null +++ b/.claude/ecc-tools.json @@ -0,0 +1,185 @@ +{ + "version": "1.3", + "schemaVersion": "1.0", + "generatedBy": "ecc-tools", + "generatedAt": "2026-04-12T07:55:56.591Z", + "repo": "https://github.com/Zacaria/pathfinding-client", + "profiles": { + "requested": "developer", + "recommended": "developer", + "effective": "developer", + "requestedAlias": "developer", + "recommendedAlias": "developer", + "effectiveAlias": "developer" + }, + "requestedProfile": "developer", + "profile": "developer", + "recommendedProfile": "developer", + "effectiveProfile": "developer", + "tier": "free", + "requestedComponents": [ + "repo-baseline", + "workflow-automation" + ], + "selectedComponents": [ + "repo-baseline", + "workflow-automation" + ], + "requestedAddComponents": [], + "requestedRemoveComponents": [], + "blockedRemovalComponents": [], + "tierFilteredComponents": [], + "requestedRootPackages": [ + "runtime-core", + "workflow-pack" + ], + "selectedRootPackages": [ + "runtime-core", + "workflow-pack" + ], + "requestedPackages": [ + "runtime-core", + "workflow-pack" + ], + "requestedAddPackages": [], + "requestedRemovePackages": [], + "selectedPackages": [ + "runtime-core", + "workflow-pack" + ], + "packages": [ + "runtime-core", + "workflow-pack" + ], + "blockedRemovalPackages": [], + "tierFilteredRootPackages": [], + "tierFilteredPackages": [], + "conflictingPackages": [], + "dependencyGraph": { + "runtime-core": [], + "workflow-pack": [ + "runtime-core" + ] + }, + "resolutionOrder": [ + "runtime-core", + "workflow-pack" + ], + "requestedModules": [ + "runtime-core", + "workflow-pack" + ], + "selectedModules": [ + "runtime-core", + "workflow-pack" + ], + "modules": [ + "runtime-core", + "workflow-pack" + ], + "managedFiles": [ + ".claude/skills/pathfinding-client/SKILL.md", + ".agents/skills/pathfinding-client/SKILL.md", + ".agents/skills/pathfinding-client/agents/openai.yaml", + ".claude/identity.json", + ".codex/config.toml", + ".codex/AGENTS.md", + ".codex/agents/explorer.toml", + ".codex/agents/reviewer.toml", + ".codex/agents/docs-researcher.toml", + ".claude/homunculus/instincts/inherited/pathfinding-client-instincts.yaml" + ], + "packageFiles": { + "runtime-core": [ + ".claude/skills/pathfinding-client/SKILL.md", + ".agents/skills/pathfinding-client/SKILL.md", + ".agents/skills/pathfinding-client/agents/openai.yaml", + ".claude/identity.json", + ".codex/config.toml", + ".codex/AGENTS.md", + ".codex/agents/explorer.toml", + ".codex/agents/reviewer.toml", + ".codex/agents/docs-researcher.toml", + ".claude/homunculus/instincts/inherited/pathfinding-client-instincts.yaml" + ] + }, + "moduleFiles": { + "runtime-core": [ + ".claude/skills/pathfinding-client/SKILL.md", + ".agents/skills/pathfinding-client/SKILL.md", + ".agents/skills/pathfinding-client/agents/openai.yaml", + ".claude/identity.json", + ".codex/config.toml", + ".codex/AGENTS.md", + ".codex/agents/explorer.toml", + ".codex/agents/reviewer.toml", + ".codex/agents/docs-researcher.toml", + ".claude/homunculus/instincts/inherited/pathfinding-client-instincts.yaml" + ] + }, + "files": [ + { + "moduleId": "runtime-core", + "path": ".claude/skills/pathfinding-client/SKILL.md", + "description": "Repository-specific Claude Code skill generated from git history." + }, + { + "moduleId": "runtime-core", + "path": ".agents/skills/pathfinding-client/SKILL.md", + "description": "Codex-facing copy of the generated repository skill." + }, + { + "moduleId": "runtime-core", + "path": ".agents/skills/pathfinding-client/agents/openai.yaml", + "description": "Codex skill metadata so the repo skill appears cleanly in the skill interface." + }, + { + "moduleId": "runtime-core", + "path": ".claude/identity.json", + "description": "Suggested identity.json baseline derived from repository conventions." + }, + { + "moduleId": "runtime-core", + "path": ".codex/config.toml", + "description": "Repo-local Codex MCP and multi-agent baseline aligned with ECC defaults." + }, + { + "moduleId": "runtime-core", + "path": ".codex/AGENTS.md", + "description": "Codex usage guide that points at the generated repo skill and workflow bundle." + }, + { + "moduleId": "runtime-core", + "path": ".codex/agents/explorer.toml", + "description": "Read-only explorer role config for Codex multi-agent work." + }, + { + "moduleId": "runtime-core", + "path": ".codex/agents/reviewer.toml", + "description": "Read-only reviewer role config focused on correctness and security." + }, + { + "moduleId": "runtime-core", + "path": ".codex/agents/docs-researcher.toml", + "description": "Read-only docs researcher role config for API verification." + }, + { + "moduleId": "runtime-core", + "path": ".claude/homunculus/instincts/inherited/pathfinding-client-instincts.yaml", + "description": "Continuous-learning instincts derived from repository patterns." + } + ], + "workflows": [], + "adapters": { + "claudeCode": { + "skillPath": ".claude/skills/pathfinding-client/SKILL.md", + "identityPath": ".claude/identity.json", + "commandPaths": [] + }, + "codex": { + "configPath": ".codex/config.toml", + "agentsGuidePath": ".codex/AGENTS.md", + "skillPath": ".agents/skills/pathfinding-client/SKILL.md" + } + } +} \ No newline at end of file diff --git a/.claude/homunculus/instincts/inherited/pathfinding-client-instincts.yaml b/.claude/homunculus/instincts/inherited/pathfinding-client-instincts.yaml new file mode 100644 index 0000000..9fa6f34 --- /dev/null +++ b/.claude/homunculus/instincts/inherited/pathfinding-client-instincts.yaml @@ -0,0 +1,418 @@ +# Instincts generated from https://github.com/Zacaria/pathfinding-client +# Generated: 2026-04-12T07:56:09.484Z +# Version: 2.0 +# NOTE: This file supplements (does not replace) any existing curated instincts. +# High-confidence manually curated instincts should be preserved alongside these. + +--- +id: pathfinding-client-commit-conventional +trigger: "when writing a commit message" +confidence: 0.85 +domain: git +source: repo-analysis +source_repo: https://github.com/Zacaria/pathfinding-client +--- + +# Pathfinding Client Commit Conventional + +## Action + +Use conventional commit format with prefixes: chore, feat + +## Evidence + +- 2 commits analyzed +- Detected conventional commit pattern +- Examples: chore: add openspec, feat: add indexed pathfinding algorithms and UI grouping + +--- +id: pathfinding-client-commit-length +trigger: "when writing a commit message" +confidence: 0.6 +domain: git +source: repo-analysis +source_repo: https://github.com/Zacaria/pathfinding-client +--- + +# Pathfinding Client Commit Length + +## Action + +Keep commit messages concise (~38 characters) + +## Evidence + +- Average commit message length: 38 chars +- Based on 2 commits + +--- +id: pathfinding-client-naming-files +trigger: "when creating a new file" +confidence: 0.8 +domain: code-style +source: repo-analysis +source_repo: https://github.com/Zacaria/pathfinding-client +--- + +# Pathfinding Client Naming Files + +## Action + +Use PascalCase naming convention + +## Evidence + +- Analyzed file naming patterns in repository +- Dominant pattern: PascalCase + +--- +id: pathfinding-client-import-alias +trigger: "when importing modules" +confidence: 0.85 +domain: code-style +source: repo-analysis +source_repo: https://github.com/Zacaria/pathfinding-client +--- + +# Pathfinding Client Import Alias + +## Action + +Use path aliases (@/, ~/) instead of relative imports + +## Evidence + +- Import analysis shows alias pattern +- Example: import { x } from '@/lib/x' + +--- +id: pathfinding-client-export-style +trigger: "when exporting from a module" +confidence: 0.7 +domain: code-style +source: repo-analysis +source_repo: https://github.com/Zacaria/pathfinding-client +--- + +# Pathfinding Client Export Style + +## Action + +Prefer named exports + +## Evidence + +- Export pattern analysis +- Dominant style: named + +--- +id: pathfinding-client-arch-type-based +trigger: "when adding new code" +confidence: 0.8 +domain: architecture +source: repo-analysis +source_repo: https://github.com/Zacaria/pathfinding-client +--- + +# Pathfinding Client Arch Type Based + +## Action + +Place code in the appropriate type folder (components/, services/, utils/, etc.) + +## Evidence + +- Type-based module organization detected +- Folders: + +--- +id: pathfinding-client-test-framework +trigger: "when writing tests" +confidence: 0.9 +domain: testing +source: repo-analysis +source_repo: https://github.com/Zacaria/pathfinding-client +--- + +# Pathfinding Client Test Framework + +## Action + +Use vitest as the test framework + +## Evidence + +- Test framework detected: vitest +- File pattern: *.test.ts + +--- +id: pathfinding-client-test-naming +trigger: "when creating a test file" +confidence: 0.85 +domain: testing +source: repo-analysis +source_repo: https://github.com/Zacaria/pathfinding-client +--- + +# Pathfinding Client Test Naming + +## Action + +Name test files using the pattern: *.test.ts + +## Evidence + +- File pattern: *.test.ts +- Consistent across test files + +--- +id: pathfinding-client-test-mocking +trigger: "when mocking dependencies in tests" +confidence: 0.75 +domain: testing +source: repo-analysis +source_repo: https://github.com/Zacaria/pathfinding-client +--- + +# Pathfinding Client Test Mocking + +## Action + +Use vi.mock for mocking + +## Evidence + +- Mocking pattern detected: vi.mock +- Consistent across test files + +--- +id: pathfinding-client-instinct-file-naming +trigger: "When creating a new file" +confidence: 0.8 +domain: code-style +source: repo-analysis +source_repo: Zacaria/pathfinding-client +--- + +# Pathfinding Client Instinct File Naming + +## Action + +Name the file using PascalCase + +## Evidence + +- Pattern in namingConventions.files + +--- +id: pathfinding-client-instinct-function-naming +trigger: "When defining a new function" +confidence: 0.8 +domain: code-style +source: repo-analysis +source_repo: Zacaria/pathfinding-client +--- + +# Pathfinding Client Instinct Function Naming + +## Action + +Name the function using camelCase + +## Evidence + +- Pattern in namingConventions.functions + +--- +id: pathfinding-client-instinct-class-naming +trigger: "When defining a new class" +confidence: 0.8 +domain: code-style +source: repo-analysis +source_repo: Zacaria/pathfinding-client +--- + +# Pathfinding Client Instinct Class Naming + +## Action + +Name the class using PascalCase + +## Evidence + +- Pattern in namingConventions.classes + +--- +id: pathfinding-client-instinct-constant-naming +trigger: "When declaring a constant" +confidence: 0.8 +domain: code-style +source: repo-analysis +source_repo: Zacaria/pathfinding-client +--- + +# Pathfinding Client Instinct Constant Naming + +## Action + +Name the constant using SCREAMING_SNAKE_CASE + +## Evidence + +- Pattern in namingConventions.constants + +--- +id: pathfinding-client-instinct-import-style +trigger: "When importing modules" +confidence: 0.7 +domain: code-style +source: repo-analysis +source_repo: Zacaria/pathfinding-client +--- + +# Pathfinding Client Instinct Import Style + +## Action + +Use alias import style + +## Evidence + +- Pattern in importStyle + +--- +id: pathfinding-client-instinct-export-style +trigger: "When exporting modules or functions" +confidence: 0.7 +domain: code-style +source: repo-analysis +source_repo: Zacaria/pathfinding-client +--- + +# Pathfinding Client Instinct Export Style + +## Action + +Use named exports + +## Evidence + +- Pattern in exportStyle + +--- +id: pathfinding-client-instinct-test-file-pattern +trigger: "When creating a test file" +confidence: 0.9 +domain: testing +source: repo-analysis +source_repo: Zacaria/pathfinding-client +--- + +# Pathfinding Client Instinct Test File Pattern + +## Action + +Name the file with the pattern *.test.ts + +## Evidence + +- Pattern in testing.filePattern + +--- +id: pathfinding-client-instinct-test-framework +trigger: "When writing tests" +confidence: 0.9 +domain: testing +source: repo-analysis +source_repo: Zacaria/pathfinding-client +--- + +# Pathfinding Client Instinct Test Framework + +## Action + +Use the vitest testing framework + +## Evidence + +- Pattern in testing.framework +- web/vitest.config.ts + +--- +id: pathfinding-client-instinct-test-type +trigger: "When writing tests" +confidence: 0.8 +domain: testing +source: repo-analysis +source_repo: Zacaria/pathfinding-client +--- + +# Pathfinding Client Instinct Test Type + +## Action + +Write unit tests + +## Evidence + +- Pattern in testing.testTypes + +--- +id: pathfinding-client-instinct-mocking +trigger: "When mocking dependencies in tests" +confidence: 0.8 +domain: testing +source: repo-analysis +source_repo: Zacaria/pathfinding-client +--- + +# Pathfinding Client Instinct Mocking + +## Action + +Use vi.mock for mocking + +## Evidence + +- Pattern in testing.mockingStyle + +--- +id: pathfinding-client-instinct-commit-format +trigger: "When making a git commit" +confidence: 0.9 +domain: git +source: repo-analysis +source_repo: Zacaria/pathfinding-client +--- + +# Pathfinding Client Instinct Commit Format + +## Action + +Format the commit message as : , using 'chore' or 'feat' as type + +## Evidence + +- Seen in commit: 'chore: add openspec' +- Seen in commit: 'feat: add indexed pathfinding algorithms and UI grouping' +- Pattern in commits.prefixes + +--- +id: pathfinding-client-instinct-commit-length +trigger: "When writing a commit message" +confidence: 0.7 +domain: git +source: repo-analysis +source_repo: Zacaria/pathfinding-client +--- + +# Pathfinding Client Instinct Commit Length + +## Action + +Keep the commit message concise (around 38 characters on average) + +## Evidence + +- Pattern in commits.averageLength + diff --git a/.claude/identity.json b/.claude/identity.json new file mode 100644 index 0000000..8ecd8a5 --- /dev/null +++ b/.claude/identity.json @@ -0,0 +1,15 @@ +{ + "version": "2.0", + "technicalLevel": "technical", + "preferredStyle": { + "verbosity": "detailed", + "codeComments": true, + "explanations": true + }, + "domains": [ + "typescript", + "rust" + ], + "suggestedBy": "ecc-tools-repo-analysis", + "createdAt": "2026-04-12T07:56:09.484Z" +} \ No newline at end of file diff --git a/.claude/skills/pathfinding-client/SKILL.md b/.claude/skills/pathfinding-client/SKILL.md new file mode 100644 index 0000000..04ad935 --- /dev/null +++ b/.claude/skills/pathfinding-client/SKILL.md @@ -0,0 +1,71 @@ +```markdown +# pathfinding-client Development Patterns + +> Auto-generated skill from repository analysis + +## Overview +This skill teaches the core development patterns and conventions used in the `pathfinding-client` repository. The codebase is primarily written in TypeScript, leverages Rust as a framework, and uses modern conventions for file organization, imports/exports, and testing. By following these patterns, contributors can maintain consistency and quality across the project. + +## Coding Conventions + +### File Naming +- Use **PascalCase** for all file names. + - Example: `PathFinder.ts`, `NodeMap.ts` + +### Import Style +- Use **alias imports** to reference modules. + - Example: + ```typescript + import { PathFinder } from 'algorithms/PathFinder' + ``` + +### Export Style +- Use **named exports** for all modules. + - Example: + ```typescript + export function findPath(...) { ... } + export const MAX_DEPTH = 100 + ``` + +### Commit Messages +- Follow **Conventional Commits** with the following prefixes: + - `chore`: for maintenance and non-feature changes + - `feat`: for new features +- Keep commit messages concise (average 38 characters). + - Example: + ``` + feat: add A* algorithm implementation + chore: update dependencies + ``` + +## Workflows + +_No automated workflows detected in this repository._ + +## Testing Patterns + +- **Framework:** [vitest](https://vitest.dev/) +- **Test File Pattern:** All test files should be named with the `.test.ts` suffix. + - Example: `PathFinder.test.ts` +- **Test Example:** + ```typescript + import { describe, it, expect } from 'vitest' + import { findPath } from 'algorithms/PathFinder' + + describe('findPath', () => { + it('finds the shortest path', () => { + const result = findPath(start, end, map) + expect(result).toBeDefined() + }) + }) + ``` + +## Commands + +| Command | Purpose | +|-----------------|-------------------------------------------| +| /test | Run all vitest tests | +| /lint | Run linter to check code style | +| /build | Build the TypeScript project | +| /commit | Generate a conventional commit message | +``` \ No newline at end of file diff --git a/.codex/AGENTS.md b/.codex/AGENTS.md new file mode 100644 index 0000000..82f092c --- /dev/null +++ b/.codex/AGENTS.md @@ -0,0 +1,26 @@ +# ECC for Codex CLI + +This supplements the root `AGENTS.md` with a repo-local ECC baseline. + +## Repo Skill + +- Repo-generated Codex skill: `.agents/skills/pathfinding-client/SKILL.md` +- Claude-facing companion skill: `.claude/skills/pathfinding-client/SKILL.md` +- Keep user-specific credentials and private MCPs in `~/.codex/config.toml`, not in this repo. + +## MCP Baseline + +Treat `.codex/config.toml` as the default ECC-safe baseline for work in this repository. +The generated baseline enables GitHub, Context7, Exa, Memory, Playwright, and Sequential Thinking. + +## Multi-Agent Support + +- Explorer: read-only evidence gathering +- Reviewer: correctness, security, and regression review +- Docs researcher: API and release-note verification + +## Workflow Files + +- No dedicated workflow command files were generated for this repo. + +Use these workflow files as reusable task scaffolds when the detected repository workflows recur. \ No newline at end of file diff --git a/.codex/agents/docs-researcher.toml b/.codex/agents/docs-researcher.toml new file mode 100644 index 0000000..0daae57 --- /dev/null +++ b/.codex/agents/docs-researcher.toml @@ -0,0 +1,9 @@ +model = "gpt-5.4" +model_reasoning_effort = "medium" +sandbox_mode = "read-only" + +developer_instructions = """ +Verify APIs, framework behavior, and release-note claims against primary documentation before changes land. +Cite the exact docs or file paths that support each claim. +Do not invent undocumented behavior. +""" \ No newline at end of file diff --git a/.codex/agents/explorer.toml b/.codex/agents/explorer.toml new file mode 100644 index 0000000..732df7a --- /dev/null +++ b/.codex/agents/explorer.toml @@ -0,0 +1,9 @@ +model = "gpt-5.4" +model_reasoning_effort = "medium" +sandbox_mode = "read-only" + +developer_instructions = """ +Stay in exploration mode. +Trace the real execution path, cite files and symbols, and avoid proposing fixes unless the parent agent asks for them. +Prefer targeted search and file reads over broad scans. +""" \ No newline at end of file diff --git a/.codex/agents/reviewer.toml b/.codex/agents/reviewer.toml new file mode 100644 index 0000000..b13ed9c --- /dev/null +++ b/.codex/agents/reviewer.toml @@ -0,0 +1,9 @@ +model = "gpt-5.4" +model_reasoning_effort = "high" +sandbox_mode = "read-only" + +developer_instructions = """ +Review like an owner. +Prioritize correctness, security, behavioral regressions, and missing tests. +Lead with concrete findings and avoid style-only feedback unless it hides a real bug. +""" \ No newline at end of file diff --git a/.codex/config.toml b/.codex/config.toml new file mode 100644 index 0000000..bc1ee67 --- /dev/null +++ b/.codex/config.toml @@ -0,0 +1,48 @@ +#:schema https://developers.openai.com/codex/config-schema.json + +# ECC Tools generated Codex baseline +approval_policy = "on-request" +sandbox_mode = "workspace-write" +web_search = "live" + +[mcp_servers.github] +command = "npx" +args = ["-y", "@modelcontextprotocol/server-github"] + +[mcp_servers.context7] +command = "npx" +args = ["-y", "@upstash/context7-mcp@latest"] + +[mcp_servers.exa] +url = "https://mcp.exa.ai/mcp" + +[mcp_servers.memory] +command = "npx" +args = ["-y", "@modelcontextprotocol/server-memory"] + +[mcp_servers.playwright] +command = "npx" +args = ["-y", "@playwright/mcp@latest", "--extension"] + +[mcp_servers.sequential-thinking] +command = "npx" +args = ["-y", "@modelcontextprotocol/server-sequential-thinking"] + +[features] +multi_agent = true + +[agents] +max_threads = 6 +max_depth = 1 + +[agents.explorer] +description = "Read-only codebase explorer for gathering evidence before changes are proposed." +config_file = "agents/explorer.toml" + +[agents.reviewer] +description = "PR reviewer focused on correctness, security, and missing tests." +config_file = "agents/reviewer.toml" + +[agents.docs_researcher] +description = "Documentation specialist that verifies APIs, framework behavior, and release notes." +config_file = "agents/docs-researcher.toml" \ No newline at end of file