Skip to content

clarion-setup: indexer freshness check + reindex-on-upgrade in SKILL.md#92

Merged
jingerzz merged 1 commit into
zocomputer:mainfrom
jingerzz:sync/clarion-setup-doctor-reindex
May 29, 2026
Merged

clarion-setup: indexer freshness check + reindex-on-upgrade in SKILL.md#92
jingerzz merged 1 commit into
zocomputer:mainfrom
jingerzz:sync/clarion-setup-doctor-reindex

Conversation

@jingerzz
Copy link
Copy Markdown
Collaborator

Syncs the registry's External/clarion-setup/SKILL.md with the upstream source (clarion-intelligence-system) after two reliability fixes. One file changed; setup.py is unchanged.

What changed in the setup flow

  • Step 6 now verifies the service is running CURRENT code, not just RUNNING. A long-running sec-indexer keeps the Python it imported at startup, so after a git pull + reinstall it can stay on stale code while logs look healthy — silently producing wrong indexed data. The step adds a clarion-sec-research doctor freshness check (running commit vs installed commit) and instructs not to report setup complete while it reports STALE.
  • Upgrade guidance now tells the flow to run clarion-sec-research reindex after updating, so extraction/parsing fixes reach the user's already-indexed corpus (a code update only changes parsing; existing trees are skipped unless re-extracted). reindex only rebuilds filings built by older code, so it's safe to run on every upgrade.

Why

Caught while validating an extraction fix on a live deployment: the fix was installed but the running indexer kept executing pre-fix code, and a re-index silently skipped already-indexed filings — so the corpus stayed broken with no error. These SKILL.md steps make both failure modes visible and self-correcting during setup.

Source of truth: skills/clarion-setup/SKILL.md in clarion-intelligence-system (kept identical).

🤖 Generated with Claude Code

…pgrade

Brings the registry copy in line with clarion-intelligence-system after zocomputer#55/zocomputer#57:
- Step 6 verifies the sec-indexer is running CURRENT code via `clarion-sec-research
  doctor` (a RUNNING service can still be on stale code after a git pull).
- Upgrade guidance: run `clarion-sec-research reindex` after updating so extraction
  fixes reach the already-indexed corpus (the indexer skips current filings).

setup.py unchanged. Source: clarion-intelligence-system skills/clarion-setup/SKILL.md.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@jingerzz jingerzz merged commit c0f07f4 into zocomputer:main May 29, 2026
1 check passed
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.

1 participant