spec - check

Katz1.000

Summary

`reqlan check` should run perform the following checks:
- ensure all rq reference point to real nodes, unless rq ignored with comment_reference_ignore.
- this tests rqcomments point to real parts of the namespace, that code references exist, and that rq references exists.
- report unresolved imports: check_unresolved_imports.
- report a comment reference with invalid syntax: code_comment_syntax_errors.
- report a qualified reference whose file is not on disk: check_qualified_missing_file.
- report a qualified reference whose `.rq` file does not declare the idea: check_qualified_missing_idea.
- it should really just be a wrapper of the index and return the issues ( as a pipe, terminal output, or json ).
Issue order: check_order_by_target. Sparse wildcards: check_wildcard_sparse via flags check_wildcard_zero and check_wildcard_one. Path globs: check_glob_patterns. Skip missing targets: check_skip_targets check_skip_gitignored_targets. CLI: commands. MCP: mcp_check. CI: check_meta_implementation. Site demo: broken_links_showcase.

Jump to outbound references

Jump to inbound references

Navigation

Source file

reqlan rq/core_analysis/check.rq

community 1

community cluster

check.rq

file cluster

reqlan rq/core_analysis

folder cluster

status: done

status cluster

tag: Not present

tag cluster

Printable page

Static print-friendly idea sheet.

Attributes

Key	Value
implementation	broken.rs, path_resolve.rs, rq_ignore.rs, api.rs, check.ts, format-broken-refs.ts, server.ts
status	done
tests	broken_references.rs:skips_idea_and_comment_refs_on_rq_ignore_error_lines, broken_references.rs:check_reports_missing_file_refs_and_skips_existing, broken_references.rs:check_reports_qualified_reference_to_a_missing_file, broken_references.rs:check_accepts_qualified_reference_when_the_file_exists, broken_references.rs:check_reports_qualified_reference_to_a_missing_idea, broken_references.rs:check_reports_namespace_qualified_reference_to_a_missing_idea, broken_references.rs:check_skips_qualified_missing_idea_on_rq_ignore_error, broken_references.rs:check_strips_test_name_and_line_suffix_before_file_exists, broken_references.rs:check_accepts_test_names_that_contain_colons_from_nested_rq, broken_references.rs:check_skips_same_file_idea_refs_and_reports_true_missing, broken_references.rs:check_accepts_import_root_alias_file_refs, broken_references.rs:analysis_api_lists_broken_refs_with_glob_and_comments, check.test.ts:checks files from two globs and one file outside them, check.test.ts:reports unresolved idea, comment, and file refs and exits 1, check.test.ts:reports unresolved imports and exits 1, broken_references.rs:check_reports_a_malformed_comment_reference, broken_references.rs:check_reports_missing_import_path, broken_references.rs:check_reports_missing_imported_idea, check.test.ts:exits 0 when there are no issues, check.test.ts:quotes source paths that contain spaces, check.test.ts:orders json rows by missing target, format-broken-refs.test.ts:quotes paths that contain spaces, broken_references.rs:check_orders_issues_by_missing_target, broken_references.rs:check_warns_when_a_wildcard_matches_zero_or_one_idea, server.test.ts:check returns JSON issue rows

Browse all attributes

Ancestor context

No ancestor chain recorded.

Outbound references

Inbound references

Kind	Idea	Path	Snippet
references	commands	reqlan rq/cli/cli_package.rq	check
references	check_glob_patterns	reqlan rq/core_analysis/check.rq	check
references	check_order_by_target	reqlan rq/core_analysis/check.rq	check
references	check_wildcard_sparse	reqlan rq/core_analysis/check.rq	check
references	check_wildcard_zero	reqlan rq/core_analysis/check.rq	check
references	check_wildcard_one	reqlan rq/core_analysis/check.rq	check
references	check_skip_targets	reqlan rq/core_analysis/check.rq	check
references	check_skip_gitignored_targets	reqlan rq/core_analysis/check.rq	check
references	check_qualified_missing_file	reqlan rq/core_analysis/check.rq	check
references	check_qualified_missing_idea	reqlan rq/core_analysis/check.rq	check
references	check_unresolved_imports	reqlan rq/core_analysis/check.rq	check
references	code_comment_syntax_errors	reqlan rq/core_analysis/check.rq	check
references	check_meta_implementation	reqlan rq/core_analysis/check.rq	check
references	check	reqlan rq/core_analysis/core.rq	check
references	typescript_compile	reqlan rq/development/build.rq	check
references	ci_gate	reqlan rq/distribution/distribution.rq	check
references	prerelease_tests	reqlan rq/distribution/distribution.rq	check
references	ai_fix_stale_references	reqlan rq/extension/agent/features-ai.rq	check
references	mcp_check	reqlan rq/extension/agent/skills-and-mcp.rq	check
references	file_reference_errors	reqlan rq/extension/language/support/language-server-errors.rq	check
references	index_consumers	reqlan rq/indexer/consumers.rq	check
references	configuration_import_root_alias	reqlan rq/language/imports.rq	check
references	wildcard_references	reqlan rq/language/imports.rq	check
references	url_reference	reqlan rq/reference_types.rq	check
references	features_tier_1	reqlan rq/site/site.rq	check
references	broken_links_showcase	reqlan rq/site/site.rq	check

Unresolved references

Kind	Idea	Path	Snippet
None

Local graph

Initialising graph…