|
| 1 | +--- |
| 2 | +name: imupdate |
| 3 | +description: Resolve an upstream repository from a local path, repository name, alias, or URL, then update InferMatrixCopilot's release-driven knowledge. Use when the user invokes /imupdate or $imupdate, asks to sync knowledge after an upstream release, compare vLLM-Omni tags or SHAs, or refresh the release baseline, model catalog, source maps, and manifests. |
| 4 | +--- |
| 5 | + |
| 6 | +# InferMatrix update |
| 7 | + |
| 8 | +```text |
| 9 | +/imupdate <path-or-repository> [target-tag-or-sha] |
| 10 | +``` |
| 11 | + |
| 12 | +The installed InferMatrixCopilot root is: |
| 13 | + |
| 14 | +```text |
| 15 | +{{INFERMATRIX_COPILOT_ROOT}} |
| 16 | +``` |
| 17 | + |
| 18 | +If that placeholder was not replaced, locate or temporarily clone the |
| 19 | +InferMatrixCopilot checkout containing `tools/audit_vllm_omni_release.py`. |
| 20 | + |
| 21 | +## Select the input mode |
| 22 | + |
| 23 | +### Local Git path |
| 24 | + |
| 25 | +When the argument exists and is a Git checkout, use the deterministic audit. |
| 26 | +Read `adapters/vllm_omni/release_baseline.yaml`; use |
| 27 | +`upstream.audited_sha` as the old revision and the optional target or checkout |
| 28 | +`HEAD` as the new revision. Refuse an accidental downgrade when the target is |
| 29 | +older than the audited revision. Do not fetch or checkout unless explicitly |
| 30 | +asked. |
| 31 | + |
| 32 | +### Repository name, alias, or URL |
| 33 | + |
| 34 | +When the argument is not a local path, use the host model to resolve it: |
| 35 | + |
| 36 | +1. Treat `vllm-omni`, `vllmomni`, `vllm omni`, and |
| 37 | + `vllm-project/vllm-omni` as `https://github.com/vllm-project/vllm-omni`. |
| 38 | +2. Check the configured repo map and current workspace for a matching checkout. |
| 39 | + If found, continue as the local-path mode. |
| 40 | +3. Otherwise verify the canonical repository from authoritative GitHub |
| 41 | + metadata. Choose the supplied target, otherwise the newest release or tag |
| 42 | + that is not older than the audited revision, otherwise the default-branch |
| 43 | + HEAD; state that choice. Never silently downgrade because GitHub's "latest |
| 44 | + release" can exclude newer prereleases. |
| 45 | +4. Prefer a temporary clone and run the deterministic audit. If repository |
| 46 | + access or cloning is unavailable, inspect the authoritative source with the |
| 47 | + host model, update only source-backed facts, and clearly report that machine |
| 48 | + audit/enforce validation was unavailable. Never call that result `CLEAN`. |
| 49 | +5. Ask for clarification only when multiple plausible canonical repositories |
| 50 | + remain after resolution. |
| 51 | + |
| 52 | +## Audit and update |
| 53 | + |
| 54 | +1. Resolve old and new revisions to full SHAs. |
| 55 | +2. Create a temporary JSON path and run the read-only audit in report mode when |
| 56 | + a local or temporary Git checkout is available: |
| 57 | + |
| 58 | + ```text |
| 59 | + python <infermatrix-root>/tools/audit_vllm_omni_release.py \ |
| 60 | + --from <audited-sha> \ |
| 61 | + --to <target-sha> \ |
| 62 | + --repo <upstream-repo> \ |
| 63 | + --mode report-only \ |
| 64 | + --json-output <temporary-json> |
| 65 | + ``` |
| 66 | + |
| 67 | +3. Explain the registry, pipeline, deploy, path-routing, source, and pin drift. |
| 68 | + Read the relevant upstream diff before changing InferMatrixCopilot. |
| 69 | +4. Update only facts proven by the report and source: the release baseline, |
| 70 | + model catalog, component source maps, pins, or adapter manifest. Never |
| 71 | + generate or rewrite owner rules automatically; report semantic-rule |
| 72 | + candidates for human review. |
| 73 | +5. When machine audit is available, run the same command with `--mode enforce`, |
| 74 | + then run: |
| 75 | + |
| 76 | + ```text |
| 77 | + python knowledge/tools/check_knowledge_tree.py |
| 78 | + python knowledge/tools/check_wiki_lint.py |
| 79 | + python -m pytest test/test_release_audit.py test/test_adapters.py \ |
| 80 | + test/test_routing.py test/test_knowledge_source.py \ |
| 81 | + test/test_skills_scope.py test/test_capabilities.py -q |
| 82 | + ``` |
| 83 | + |
| 84 | +6. Delete temporary reports and clones. Return the canonical repository, input |
| 85 | + mode, old and new SHAs, structural deltas, files changed, validation |
| 86 | + results, and any unresolved or model-only findings. |
| 87 | + |
| 88 | +The audit is evidence collection, not the updater. Codex performs the bounded |
| 89 | +knowledge edits and must not commit, push, or open a PR unless asked. |
0 commit comments