Release 1.9.7 durable, token-lean archive knowledge

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: clawplays

SKILL.md

@@ -26,7 +26,7 @@ Do not hand-write an approximation of `ospec init`. Do not assume a web stack, a
 For an initialized project, read in this order:
 
 1. `.skillrc` for layout, language, workflow policy, plugins, and model profiles.
-2. `SKILL.index.json` and `docs/project/feature-index.md` as routers.
+2. `ospec index query <keyword...>` as the router into `SKILL.index.json` and `docs/project/feature-index.md`; never read the whole index file — it grows without bound as changes archive.
 3. The current session brief, bootstrap, dispatch, review, or repair packet.
 4. Only the indexed project documents, change files, and target files named by that packet.
 

assets/for-ai/ar/change-protocol.md

@@ -4,7 +4,7 @@
 
 ## السياق
 
-في البداية اقرأ `.skillrc` والعناصر ذات الصلة من `SKILL.index.json` و`proposal.md` و`tasks.md` و`state.json` فقط. اقرأ `verification.md` عند التحقق و`review.md` عند closeout. اقرأ `ai-guide.md` أو `execution-protocol.md` الكامل فقط عند غياب هذا الملف أو تفعيل plugin حاجب أو وجود قاعدة محددة غامضة.
+في البداية اقرأ `.skillrc` و`proposal.md` و`tasks.md` و`state.json` فقط؛ واسترجع عناصر الفهرس ذات الصلة عبر `ospec index query <كلمات...>` بدلاً من قراءة `SKILL.index.json` كاملاً. اقرأ `verification.md` عند التحقق و`review.md` عند closeout. اقرأ `ai-guide.md` أو `execution-protocol.md` الكامل فقط عند غياب هذا الملف أو تفعيل plugin حاجب أو وجود قاعدة محددة غامضة.
 
 ## دورة الحياة
 

assets/for-ai/en-US/change-protocol.md

@@ -4,7 +4,7 @@ Use this compact protocol when the user selected an OSpec change. Profile select
 
 ## Context
 
-At start, read `.skillrc`, the relevant `SKILL.index.json` entries, `proposal.md`, `tasks.md`, and `state.json`. Read `verification.md` when entering verification and `review.md` during closeout. Read the full `ai-guide.md` or `execution-protocol.md` only when this compact file is missing, a blocking plugin is active, or a specific ambiguous rule requires it.
+At start, read `.skillrc`, `proposal.md`, `tasks.md`, and `state.json`, and use `ospec index query <keyword...>` for relevant index entries instead of reading the whole `SKILL.index.json`. Read `verification.md` when entering verification and `review.md` during closeout. Read the full `ai-guide.md` or `execution-protocol.md` only when this compact file is missing, a blocking plugin is active, or a specific ambiguous rule requires it.
 
 ## Lifecycle
 

assets/for-ai/ja-JP/change-protocol.md

@@ -4,7 +4,7 @@
 
 ## コンテキスト
 
-開始時は `.skillrc`、`SKILL.index.json` の関連項目、`proposal.md`、`tasks.md`、`state.json` だけを読みます。検証時に `verification.md`、closeout 時に `review.md` を読みます。本ファイルがない、blocking plugin が有効、または特定ルールが曖昧な場合だけ完全な `ai-guide.md` や `execution-protocol.md` を読みます。
+開始時は `.skillrc`、`proposal.md`、`tasks.md`、`state.json` だけを読みます。index の関連項目は `ospec index query <キーワード...>` で必要な分だけ取得し、`SKILL.index.json` 全体を読まないでください。検証時に `verification.md`、closeout 時に `review.md` を読みます。本ファイルがない、blocking plugin が有効、または特定ルールが曖昧な場合だけ完全な `ai-guide.md` や `execution-protocol.md` を読みます。
 
 ## ライフサイクル
 

assets/for-ai/zh-CN/change-protocol.md

@@ -4,7 +4,7 @@
 
 ## 上下文
 
-开始时只读 `.skillrc`、`SKILL.index.json` 的相关条目、`proposal.md`、`tasks.md` 和 `state.json`。进入验证时再读 `verification.md`，收口时再读 `review.md`。只有缺少本文件、启用了阻塞插件或某条规则确实有歧义时，才读取完整 `ai-guide.md` 或 `execution-protocol.md`。
+开始时只读 `.skillrc`、`proposal.md`、`tasks.md` 和 `state.json`；索引条目用 `ospec index query <关键词...>` 按需检索，不要通读整个 `SKILL.index.json`。进入验证时再读 `verification.md`，收口时再读 `review.md`。只有缺少本文件、启用了阻塞插件或某条规则确实有歧义时，才读取完整 `ai-guide.md` 或 `execution-protocol.md`。
 
 ## 生命周期
 

assets/global-skills/codex/ospec-change/SKILL.md

@@ -25,7 +25,7 @@ The user owns profile selection. Once the user chooses a change, keep it on the
 ## Read Order
 
 1. `.skillrc`
-2. Relevant entries from `.ospec/SKILL.index.json` for nested projects, or root `SKILL.index.json` for legacy classic projects
+2. `ospec index query <keyword...>` for the relevant `.ospec/SKILL.index.json` entries (root `SKILL.index.json` for legacy classic projects); never read the whole index file — it grows without bound as changes archive
 3. `.ospec/for-ai/change-protocol.md` for nested projects, or legacy `for-ai/change-protocol.md`
 4. `.ospec/changes/active/<change>/proposal.md`, `tasks.md`, and `state.json` for nested projects, or their legacy classic paths
 5. Read `verification.md` only when entering verification

assets/global-skills/codex/ospec-goal/SKILL.md

@@ -50,7 +50,7 @@ Use `ospec-change` for small routine changes that only need the classic fast flo
 ## Read Order
 
 1. `.skillrc`
-2. `.ospec/SKILL.index.json` for nested projects, or root `SKILL.index.json`
+2. `ospec index query <keyword...>` for the relevant `.ospec/SKILL.index.json` entries (root `SKILL.index.json` for legacy classic projects); never read the whole index file — it grows without bound as changes archive
 3. `.ospec/session-brief.md` and `ospec execute status [goal] --brief`
 4. the current dispatch, review, decision, or verification packet for the next action
 5. target files and only the project or archived-feature docs routed by `SKILL.index.json` and `docs/project/feature-index.md`

dist/cli.js

@@ -62,7 +62,7 @@ const VerifyCommand_1 = require("./commands/VerifyCommand");
 const WorkflowCommand_1 = require("./commands/WorkflowCommand");
 const LayoutCommand_1 = require("./commands/LayoutCommand");
 const services_1 = require("./services");
-const CLI_VERSION = '1.9.6';
+const CLI_VERSION = '1.9.7';
 function showInitUsage() {
     console.log('Usage: ospec init [root-dir] [--summary "..."] [--tech-stack node,react] [--architecture "..."] [--document-language en-US|zh-CN|ja-JP|ar]');
 }
@@ -497,7 +497,7 @@ async function main() {
             }
             case 'index': {
                 const indexCmd = new IndexCommand_1.IndexCommand();
-                await indexCmd.execute(commandArgs[0] || 'check', commandArgs[1]);
+                await indexCmd.execute(commandArgs[0] || 'check', commandArgs[0] === 'query' ? undefined : commandArgs[1], commandArgs.slice(1));
                 break;
             }
             case 'plugins': {

dist/commands/ArchiveCommand.js

@@ -117,6 +117,7 @@ class ArchiveCommand extends BaseCommand_1.BaseCommand {
             const goalReviewSummary = isGoalWorkflow
                 ? await (0, ReviewArtifacts_1.analyzeGoalReviewSummary)(services_1.services.fileService, targetPath)
                 : null;
+            const evidenceTracking = services_1.services.projectService.assessArchiveEvidenceTracking(targetPath);
             const result = await ArchiveGate_1.archiveGate.checkArchiveReadiness(featureState, archiveConfig, {
                 activatedSteps,
                 tasksOptionalSteps,
@@ -128,6 +129,14 @@ class ArchiveCommand extends BaseCommand_1.BaseCommand {
                 goalReviewSummaryAligned: goalReviewSummary ? goalReviewSummary.aligned : null,
                 goalReviewSummaryMessage: goalReviewSummary?.message ?? null,
             });
+            if (evidenceTracking.level === 'block' && evidenceTracking.message) {
+                result.blockers.push(evidenceTracking.message);
+                result.checks.push({
+                    name: 'Archive Evidence Tracking',
+                    passed: false,
+                    message: evidenceTracking.message,
+                });
+            }
             if (classicStatus) {
                 for (const check of classicStatus.checks) {
                     if (check.name === 'archive.pending')

dist/commands/IndexCommand.d.ts

@@ -1,4 +1,10 @@
 import { BaseCommand } from './BaseCommand';
 export declare class IndexCommand extends BaseCommand {
-    execute(action?: string, projectPath?: string): Promise<void>;
+    execute(action?: string, projectPath?: string, rawArgs?: string[]): Promise<void>;
+    /**
+     * Token-bounded index retrieval: return only the entries matching the
+     * given keywords so AI sessions never need to read the whole
+     * SKILL.index.json (which grows without bound as changes are archived).
+     */
+    private query;
 }