fix: resolve aliased imports and enforce readiness

[boyeesu]

Summary

• resolve bounded repository-local tsconfig.json/jsconfig.json path aliases, including JSONC
• include alias configuration in freshness and expose actionable unresolved-import diagnostics
• make readiness warning-free across identity, entrypoints, ownership, relationships, integrations, and authored knowledge
• release the fix as 1.1.2 with updated docs, integrations, fixtures, and generated evidence

Adopter validation

On Kourti Tech, homepage context improved from 1 file / 0 relationships to 12 files / 15 relationships. The graph now resolves 116 local imports, including 111 path aliases, with 0 unresolved imports.

Verification

• npm run verify:production
• 79 tests passed
• 94.02% line / 80.88% branch / 96.46% function coverage
• 0 production dependency vulnerabilities
• registry signatures and attestations verified
• package dry-run passed
• prodocs doctor --json: 12 pass, 0 warnings, 0 errors

Summary by CodeRabbit

• New Features

  • Added editor and AI coding assistant integration guidance.
  • Added support for resolving JavaScript and TypeScript path aliases and imports across supported languages.
  • Improved project scanning and import classification, including assets, external packages, and unresolved imports.
  • Enhanced project readiness checks and diagnostic reporting.

• Documentation

  • Updated troubleshooting, roadmap, maturity, supply-chain, changelog, and generated project documentation.
  • Added guidance for resolving readiness and context-command issues.

• Release

  • Updated the product release to version 1.1.2.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: a688e1c6-ddc9-4ad8-9018-c89228b06fae

📥 Commits

Reviewing files that changed from the base of the PR and between 6c1b71c and 7dff897.

⛔ Files ignored due to path filters (1)

• package-lock.json is excluded by !**/package-lock.json

📒 Files selected for processing (30)

• .prodocs/integrations/codex.md
• .prodocs/integrations/mcp.json
• .prodocs/integrations/vscode.md
• CHANGELOG.md
• README.md
• docs/COLLECTORS.md
• docs/MATURITY.md
• docs/ROADMAP.md
• docs/SUPPLY_CHAIN.md
• docs/TROUBLESHOOTING.md
• docs/prodocs/CODE_MAP.md
• docs/prodocs/SYSTEM_OVERVIEW.md
• docs/prodocs/knowledge.json
• docs/prodocs/manifest.json
• docs/prodocs/views/coding-agents.md
• docs/prodocs/views/operations.md
• docs/prodocs/views/product.md
• docs/prodocs/views/security.md
• docs/prodocs/views/support.md
• docs/prodocs/views/technical.md
• fixtures/collectors/factory.js
• package.json
• src/constants.js
• src/doctor.js
• src/module-resolution.js
• src/scanner.js
• src/tutorial.js
• test/module-resolution.test.js
• test/package.test.js
• test/scanner.test.js

---

📝 Walkthrough

Walkthrough

Changes

The release adds bounded module resolution for multiple languages, stricter warning-free doctor readiness checks, Codex and VS Code MCP integrations, version 1.1.2 metadata, updated documentation, and regenerated ProDocs indexes.

ProDocs resolution and readiness

Layer / File(s)	Summary
Module resolution and scanner integration src/module-resolution.js, src/scanner.js, test/module-resolution.test.js, test/scanner.test.js, docs/COLLECTORS.md, fixtures/collectors/factory.js	The scanner now loads validated tsconfig.json or jsconfig.json mappings and classifies relative, aliased, external, asset, and unresolved imports within repository boundaries. Tests cover JSONC parsing, aliases, Python imports, hashing, and asset classification.
Doctor readiness diagnostics src/doctor.js, src/tutorial.js, README.md, docs/TROUBLESHOOTING.md, docs/ROADMAP.md, test/package.test.js	diagnoseProject checks identity, entrypoints, ownership, relationships, and authored knowledge. Warnings now make ready false. Documentation and workflow tests reflect the new result.
Editor and agent integrations .prodocs/integrations/codex.md, .prodocs/integrations/mcp.json, .prodocs/integrations/vscode.md	Added MCP configuration and guidance for Codex and VS Code context retrieval and post-change checks.
Release metadata and documentation package.json, src/constants.js, CHANGELOG.md, docs/MATURITY.md, docs/SUPPLY_CHAIN.md, docs/ROADMAP.md	Updated the package and exported version to 1.1.2. Added release notes and updated release status, comparison links, and version metadata.
Regenerated ProDocs indexes docs/prodocs/CODE_MAP.md, docs/prodocs/SYSTEM_OVERVIEW.md, docs/prodocs/knowledge.json, docs/prodocs/manifest.json, docs/prodocs/views/*	Regenerated repository statistics, hashes, symbols, relationships, file metadata, and evidence snapshot identifiers.

Estimated code review effort: 4 (Complex) | ~60 minutes

Possibly related PRs

• boyeesu/ProDocs#5: Shares scanner, constants, generated metadata, and scanner-test changes.
• boyeesu/ProDocs#10: Shares version, package, changelog, and generated metadata updates.
• boyeesu/ProDocs#15: Shares doctor, tutorial, constants, and generated metadata changes.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/alias-resolution-readiness

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}