@tiangong-ai/cli 0.0.33 → 0.0.34

package/AGENTS.md

@@ -15,8 +15,8 @@ checkPaths:
   - .docpact/config.yaml
   - docs/agents/**
   - src/**
-lastReviewedAt: 2026-08-11
-lastReviewedCommit: 2ce7ad7cd36c1aeba577bc72e4095ed3a81debd6
+lastReviewedAt: 2026-08-12
+lastReviewedCommit: 7d692de934c51178df520ccdaa212acc7dc303f0
 ---
 
 # Tiangong AI CLI Contract
@@ -60,6 +60,7 @@ This repository owns the Tiangong AI command-line interface.
 Run before delivery:
 
 ```bash
+npm run test:clean
 npm run lint
 npm run build
 npm test
@@ -68,6 +69,10 @@ docpact validate-config --root . --strict
 docpact lint --root . --worktree --mode enforce
 ```
 
+For Auto Research changes, `npm run test:clean` is the authoritative TDD gate.
+Write the regression first, observe it fail in that clean container, then make
+it pass there. Host-only results are supplemental.
+
 Use `npm run typecheck` for a faster TypeScript-only check.
 Use `npm run prepush:gate` when `docpact` is installed and you want the
 aggregated local quality gate.

package/README.md

@@ -12,8 +12,8 @@ checkPaths:
   - package.json
   - bin/**
   - src/**
-lastReviewedAt: 2026-08-10
-lastReviewedCommit: bef62f8d48c42eaff14fa2bd7eba1be83a46a58b
+lastReviewedAt: 2026-08-12
+lastReviewedCommit: ac34420a63cb02898f8c38b1c1af64f0439e862f
 ---
 
 # Tiangong AI CLI
@@ -235,6 +235,16 @@ the default; global writes, network downloads, live provider checks, synthetic
 document uploads, and paid agent smokes each require their applicable
 confirmation.
 
+If the full orchestrator was selected, accepted apply creates a separate
+project-local `tiangong-auto-research-recovery` Skill after credentials are
+stored and before source checkout. This CLI-generated, plan-bound shim can only
+inspect context/status and execute the exact-version retry returned by setup; it
+cannot perform research, call standalone evidence, or access credentials. A
+checkout or install failure therefore remains discoverable without falling back
+to a global Skill. After the full external orchestrator matches its reviewed
+tree hash, setup verifies the shim byte-for-byte and removes only that generated
+directory. Modified, symlinked, or ambiguous recovery bytes block cleanup.
+
 Production admission requires at least one locked external capability with
 `brokered-network` and `discoveryScopes: ["public-internet"]`; an input plan or
 local files alone cannot represent internet coverage. The machine-readable
@@ -259,6 +269,15 @@ regular non-symlink `runtime-lock.json` exact stable CLI version. Setup and
 release CI reject a missing resolver or any stale exact CLI version in the
 orchestrator's `SKILL.md` or `references/*.md`.
 
+`research setup status --json` reports credential persistence separately from
+readiness. It also reports the effective exact-npx CLI package/version/root,
+the selected project orchestrator, any temporary recovery shim, ignored global
+same-name Skills, legacy wrappers that still contain an unmanaged PATH CLI
+fallback, and the real failed source/immutable ref/cache state when checkout is
+retryable. A direct `research search` inside a managed workspace stops before
+network access and returns the same broker-vs-standalone and setup provenance;
+it never converts a stored broker credential into an ambient credential.
+
 The default `internet-research` profile selects Brave Web Search and News
 Search. `internet-research-with-context` additionally selects the
 subscription-dependent LLM Context endpoint, while

package/dist/research/commands.js

@@ -2,8 +2,9 @@ import { runEdgeSearch } from "../edge-search.js";
 import { CliError } from "../errors.js";
 import { readJsonInput, stringifyJson, write } from "../io.js";
 import { parseStrictArgs, strictBoolean, strictString } from "../strict-args.js";
-import { parseResearchSources, researchSourceConfig, resolveResearchConfig } from "./config.js";
+import { parseResearchSources, researchSourceConfig, resolveResearchConfig, } from "./config.js";
 import { researchOrchestrationHelp, runResearchOrchestrationCommand } from "./orchestration.js";
+import { inspectResearchContext } from "./workspace/context.js";
 const RESEARCH_SEARCH_OPTIONS = {
     help: "boolean",
     json: "boolean",
@@ -88,6 +89,7 @@ async function runResearchSearchCommand(argv, io) {
     }
     const sourceIds = parseResearchSources(strictString(args, "sources"));
     const config = resolveResearchConfig(args, io.env);
+    await assertStandaloneSearchContext(io.env, sourceIds, config);
     const inputPath = strictString(args, "input");
     const body = researchRequestBody(args);
     const result = await runEdgeSearch({
@@ -101,6 +103,61 @@ async function runResearchSearchCommand(argv, io) {
     writeSearchResult(io, result, strictBoolean(args, "json"));
     return 0;
 }
+async function assertStandaloneSearchContext(environment, sourceIds, config) {
+    const context = await inspectResearchContext(process.cwd());
+    if (context.role !== "setup" && context.role !== "workspace")
+        return;
+    const setup = context.setup;
+    const ready = setup?.status === "ready";
+    const blocked = setup?.status === "blocked";
+    const setupStatus = context.root
+        ? await import("./workspace/setup.js")
+            .then(({ inspectResearchSetupStatus }) => inspectResearchSetupStatus(context.root, environment))
+            .catch(() => null)
+        : null;
+    const configuredBrokerIds = setupStatus?.credentialReadiness.configuredIds ?? [];
+    const standaloneConfiguredSources = sourceIds.filter((sourceId) => config.sources[sourceId].apiKey.length > 0);
+    const standaloneCredential = standaloneConfiguredSources.length === 0
+        ? "absent"
+        : standaloneConfiguredSources.length === sourceIds.length
+            ? "present"
+            : "partial";
+    throw new CliError(ready
+        ? "Direct research search is disabled inside an Auto Research workspace."
+        : blocked
+            ? "Broker credentials may be stored, but Auto Research setup is blocked; standalone search cannot consume broker credentials."
+            : "Auto Research setup is incomplete; standalone search will not bypass it.", {
+        code: ready
+            ? "AUTO_RESEARCH_BROKER_REQUIRED"
+            : blocked
+                ? "AUTO_RESEARCH_SETUP_BLOCKED"
+                : "AUTO_RESEARCH_SETUP_INCOMPLETE",
+        exitCode: 3,
+        details: {
+            executionMode: "managed-workspace",
+            requestedExecutionMode: "standalone",
+            recommendedExecutionMode: "managed-workspace",
+            credentialScope: "broker",
+            brokerCredentialStore: configuredBrokerIds.length > 0 ? "present" : "absent",
+            brokerConfiguredCredentialIds: configuredBrokerIds,
+            standaloneCredential,
+            standaloneConfiguredSources,
+            networkAttempted: false,
+            workspace: context.root,
+            setupStatus: setup?.status ?? "missing",
+            failedStep: setup?.blocker?.step ?? setup?.currentStep ?? null,
+            setupBlocker: setup?.blocker ?? null,
+            effectiveCli: setupStatus?.provenance.effectiveCli ?? setup?.runtime ?? null,
+            effectiveSkill: setupStatus?.provenance.selectedOrchestrator ?? null,
+            recoveryShims: setupStatus?.provenance.recoveryShims ?? [],
+            ambientCli: setupStatus?.provenance.ambientCli ?? null,
+            ambientSkillConflicts: setupStatus?.provenance.ambientSkillConflicts ?? [],
+            minimumAction: setup?.next?.retryCommand ??
+                "Use the project evidence broker through tiangong-auto-research; do not provide ambient credentials.",
+            retryCommand: setup?.next?.retryCommand ?? null,
+        },
+    });
+}
 function researchRequestBody(args) {
     const inputPath = strictString(args, "input");
     if (inputPath) {

package/dist/research/commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/research/commands.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/research/commands.ts"],"names":[],"mappings":"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"}

package/dist/research/workspace/constants.d.ts

@@ -7,3 +7,4 @@ export declare const SETUP_OPERATIONS: readonly ["research.context.inspect", "re
 export declare const UNMANAGED_OPERATIONS: readonly ["research.context.inspect", "research.capability.catalog", "research.workspace.init", "research.setup.catalog", "research.setup.plan"];
 export declare const INVALID_OPERATIONS: readonly ["research.context.inspect"];
 export declare function packageVersion(): string;
+export declare function packageRoot(): string;

package/dist/research/workspace/constants.js

@@ -55,12 +55,14 @@ export const UNMANAGED_OPERATIONS = [
 ];
 export const INVALID_OPERATIONS = ["research.context.inspect"];
 export function packageVersion() {
-    const moduleDirectory = dirname(fileURLToPath(import.meta.url));
-    const packagePath = resolve(moduleDirectory, "../../../package.json");
+    const packagePath = resolve(packageRoot(), "package.json");
     const value = JSON.parse(readFileSync(packagePath, "utf8"));
     if (typeof value.version !== "string" || !value.version.trim()) {
         throw new Error("Package version is unavailable.");
     }
     return value.version;
 }
+export function packageRoot() {
+    return resolve(dirname(fileURLToPath(import.meta.url)), "../../..");
+}
 //# sourceMappingURL=constants.js.map

package/dist/research/workspace/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/research/workspace/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,CAAC,MAAM,0BAA0B,GAAG,oBAAoB,CAAC;AAC/D,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAU,CAAC;AACpD,MAAM,CAAC,MAAM,qBAAqB,GAAG,kBAA2B,CAAC;AAEjE,MAAM,CAAC,MAAM,8BAA8B,GAAG,IAAI,GAAG,CAAC;IACpD,cAAc;IACd,iBAAiB;IACjB,kBAAkB;IAClB,oBAAoB;CACrB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,0BAA0B;IAC1B,2BAA2B;IAC3B,6BAA6B;IAC7B,+BAA+B;IAC/B,4BAA4B;IAC5B,4BAA4B;IAC5B,oCAAoC;IACpC,0BAA0B;IAC1B,4BAA4B;IAC5B,uBAAuB;IACvB,4BAA4B;IAC5B,4BAA4B;IAC5B,wBAAwB;IACxB,uBAAuB;IACvB,sBAAsB;IACtB,iBAAiB;IACjB,cAAc;IACd,wBAAwB;IACxB,qBAAqB;IACrB,sBAAsB;IACtB,uBAAuB;IACvB,uBAAuB;IACvB,+BAA+B;IAC/B,sBAAsB;IACtB,uBAAuB;IACvB,wBAAwB;CAChB,CAAC;AAEX,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,0BAA0B;IAC1B,wBAAwB;IACxB,qBAAqB;IACrB,sBAAsB;IACtB,uBAAuB;IACvB,sBAAsB;CACd,CAAC;AAEX,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,0BAA0B;IAC1B,6BAA6B;IAC7B,yBAAyB;IACzB,wBAAwB;IACxB,qBAAqB;CACb,CAAC;AAEX,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,0BAA0B,CAAU,CAAC;AAExE,MAAM,UAAU,cAAc;IAC5B,MAAM,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,MAAM,WAAW,GAAG,OAAO,CAAC,eAAe,EAAE,uBAAuB,CAAC,CAAC;IACtE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAA0B,CAAC;IACrF,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,KAAK,CAAC,OAAO,CAAC;AACvB,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/research/workspace/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,CAAC,MAAM,0BAA0B,GAAG,oBAAoB,CAAC;AAC/D,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAU,CAAC;AACpD,MAAM,CAAC,MAAM,qBAAqB,GAAG,kBAA2B,CAAC;AAEjE,MAAM,CAAC,MAAM,8BAA8B,GAAG,IAAI,GAAG,CAAC;IACpD,cAAc;IACd,iBAAiB;IACjB,kBAAkB;IAClB,oBAAoB;CACrB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,0BAA0B;IAC1B,2BAA2B;IAC3B,6BAA6B;IAC7B,+BAA+B;IAC/B,4BAA4B;IAC5B,4BAA4B;IAC5B,oCAAoC;IACpC,0BAA0B;IAC1B,4BAA4B;IAC5B,uBAAuB;IACvB,4BAA4B;IAC5B,4BAA4B;IAC5B,wBAAwB;IACxB,uBAAuB;IACvB,sBAAsB;IACtB,iBAAiB;IACjB,cAAc;IACd,wBAAwB;IACxB,qBAAqB;IACrB,sBAAsB;IACtB,uBAAuB;IACvB,uBAAuB;IACvB,+BAA+B;IAC/B,sBAAsB;IACtB,uBAAuB;IACvB,wBAAwB;CAChB,CAAC;AAEX,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,0BAA0B;IAC1B,wBAAwB;IACxB,qBAAqB;IACrB,sBAAsB;IACtB,uBAAuB;IACvB,sBAAsB;CACd,CAAC;AAEX,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,0BAA0B;IAC1B,6BAA6B;IAC7B,yBAAyB;IACzB,wBAAwB;IACxB,qBAAqB;CACb,CAAC;AAEX,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,0BAA0B,CAAU,CAAC;AAExE,MAAM,UAAU,cAAc;IAC5B,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,EAAE,cAAc,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAA0B,CAAC;IACrF,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,KAAK,CAAC,OAAO,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;AACtE,CAAC"}

package/dist/research/workspace/context.js

@@ -1,6 +1,7 @@
-import { lstat } from "node:fs/promises";
+import { lstat, realpath } from "node:fs/promises";
 import { dirname, join, parse, resolve } from "node:path";
-import { INVALID_OPERATIONS, RESEARCH_CONTROL_DIRECTORY, SETUP_OPERATIONS, UNMANAGED_OPERATIONS, WORKSPACE_OPERATIONS, } from "./constants.js";
+import { INVALID_OPERATIONS, RESEARCH_PACKAGE_NAME, RESEARCH_CONTROL_DIRECTORY, SETUP_OPERATIONS, UNMANAGED_OPERATIONS, WORKSPACE_OPERATIONS, } from "./constants.js";
+import { exactResearchCliCommand, researchSetupApplyCommand, researchSetupRetryCommand, } from "./setup-invocation.js";
 import { isObject, pathExists, readJsonFile } from "./storage.js";
 export async function inspectResearchContext(selectedPath) {
     const canonical = resolve(selectedPath);
@@ -9,15 +10,19 @@ export async function inspectResearchContext(selectedPath) {
     while (true) {
         const control = join(cursor, RESEARCH_CONTROL_DIRECTORY);
         if (await pathExists(control)) {
+            const workspaceRoot = await realpath(cursor).catch(() => cursor);
+            const workspaceControl = join(workspaceRoot, RESEARCH_CONTROL_DIRECTORY);
+            const setup = await inspectManagedSetup(workspaceControl, workspaceRoot);
             const markerPath = join(control, "workspace.json");
             if (!(await pathExists(markerPath))) {
-                if (await isSetupOnlyControlDirectory(control)) {
+                if (setup) {
                     return {
                         role: "setup",
                         selectedPath: canonical,
                         root: cursor,
                         allowedOperations: [...SETUP_OPERATIONS],
                         violations: [],
+                        setup,
                     };
                 }
                 return {
@@ -44,6 +49,7 @@ export async function inspectResearchContext(selectedPath) {
                     root: cursor,
                     allowedOperations: [...WORKSPACE_OPERATIONS],
                     violations: [],
+                    ...(setup ? { setup } : {}),
                 };
             }
             catch (error) {
@@ -63,21 +69,110 @@ export async function inspectResearchContext(selectedPath) {
         violations: [],
     };
 }
-async function isSetupOnlyControlDirectory(control) {
+async function inspectManagedSetup(control, root) {
     const planPath = join(control, "setup-plan.json");
     if (!(await pathExists(planPath)))
-        return false;
+        return null;
     try {
         const plan = await readJsonFile(planPath, "Research setup plan");
-        return (isObject(plan) &&
-            plan.schemaVersion === 1 &&
-            plan.kind === "tiangong-research-setup-plan" &&
-            typeof plan.planSha256 === "string" &&
-            /^[0-9a-f]{64}$/.test(plan.planSha256));
+        if (!isObject(plan) ||
+            plan.schemaVersion !== 1 ||
+            plan.kind !== "tiangong-research-setup-plan" ||
+            !isObject(plan.cli) ||
+            plan.cli.package !== RESEARCH_PACKAGE_NAME ||
+            typeof plan.cli.version !== "string" ||
+            !/^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/.test(plan.cli.version) ||
+            typeof plan.planSha256 !== "string" ||
+            !/^[0-9a-f]{64}$/.test(plan.planSha256)) {
+            return null;
+        }
+        const state = await readSetupStateSummary(control);
+        const runtimeSource = (await hasMatchingRuntimeLock(control, plan.cli.version))
+            ? "runtime-lock"
+            : "setup-plan";
+        const blocker = state.lastError
+            ? {
+                ...state.lastError,
+                retryCommand: researchSetupRetryCommand({
+                    version: plan.cli.version,
+                    workspace: root,
+                    step: state.lastError.step,
+                }),
+            }
+            : null;
+        const next = state.status === "ready"
+            ? null
+            : state.status === "pending"
+                ? {
+                    action: "apply",
+                    retryCommand: researchSetupApplyCommand({
+                        version: plan.cli.version,
+                        planPath,
+                    }),
+                }
+                : state.status === "blocked" && blocker
+                    ? { action: "retry", retryCommand: blocker.retryCommand }
+                    : state.status === "applying"
+                        ? {
+                            action: "inspect",
+                            retryCommand: exactResearchCliCommand(["research", "setup", "status", "--workspace", root, "--json"], plan.cli.version),
+                        }
+                        : {
+                            action: "doctor",
+                            retryCommand: exactResearchCliCommand(["research", "setup", "doctor", "--workspace", root, "--json"], plan.cli.version),
+                        };
+        return {
+            status: state.status,
+            currentStep: state.currentStep,
+            blocker,
+            runtime: {
+                packageName: RESEARCH_PACKAGE_NAME,
+                packageVersion: plan.cli.version,
+                source: runtimeSource,
+            },
+            next,
+        };
     }
     catch {
-        return false;
+        return null;
+    }
+}
+async function readSetupStateSummary(control) {
+    const statePath = join(control, "setup-state.json");
+    if (!(await pathExists(statePath))) {
+        return { status: "pending", currentStep: null, lastError: null };
     }
+    const state = await readJsonFile(statePath, "Research setup state");
+    if (!isObject(state) ||
+        !["pending", "applying", "partially-ready", "ready", "blocked"].includes(String(state.status))) {
+        return { status: "pending", currentStep: null, lastError: null };
+    }
+    const lastError = isSetupBlocker(state.lastError) ? state.lastError : null;
+    return {
+        status: state.status,
+        currentStep: typeof state.currentStep === "string" ? state.currentStep : null,
+        lastError,
+    };
+}
+async function hasMatchingRuntimeLock(control, version) {
+    const path = join(control, "runtime-lock.json");
+    const info = await lstat(path).catch(() => undefined);
+    if (!info?.isFile() || info.isSymbolicLink())
+        return false;
+    const lock = await readJsonFile(path, "Research runtime lock").catch(() => null);
+    return (isObject(lock) &&
+        lock.schemaVersion === 1 &&
+        lock.packageName === RESEARCH_PACKAGE_NAME &&
+        lock.packageVersion === version);
+}
+function isSetupBlocker(value) {
+    return (isObject(value) &&
+        typeof value.code === "string" &&
+        typeof value.step === "string" &&
+        typeof value.reason === "string" &&
+        typeof value.minimumAction === "string" &&
+        typeof value.retryCommand === "string" &&
+        (value.diagnostics === undefined || isObject(value.diagnostics)));
 }
 export function isWorkspaceMarker(value) {
     return (isObject(value) &&

package/dist/research/workspace/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/research/workspace/context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/research/workspace/context.ts"],"names":[],"mappings":"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"}

package/dist/research/workspace/setup-catalog.js

@@ -15,7 +15,7 @@ export const RESEARCH_SETUP_SELECTION_GUIDANCE = {
     },
 };
 const BRAVE_COMMIT = "3e088af66eb61f1c207c22b2be0278ca8744d1d1";
-const TIANGONG_SKILLS_COMMIT = "24f2549968864c43dfb5a7f995a0e4fceb54d565";
+const TIANGONG_SKILLS_COMMIT = "c9470b88f52d35629d3d9fb21ee7713048b44c3b";
 const ANTHROPIC_SKILLS_COMMIT = "f17010c9bb483898c1d9c9f42dde2b3a98889434";
 const PPT_MASTER_COMMIT = "4343bd8bfc91e79dfb9680681a378476cc38a280";
 export const RESEARCH_SETUP_INSTALLER = {
@@ -125,7 +125,7 @@ export const RESEARCH_SETUP_SKILLS = [
         skillName: "tiangong-auto-research",
         sourceId: "tiangong-ai-skills",
         sourceRelativePath: "tiangong-auto-research",
-        expectedTreeSha256: "8ac005677e7c9ddf97ce1377686c97728ab89fedb1aa4e14fb96363cbc14a4c2",
+        expectedTreeSha256: "65c8acc41c8cc83575b433b8099528d72d1a99d4bb1178eb5568273516b9f065",
         tier: "orchestrator",
         role: "orchestrator",
         purpose: "Route ordinary research tasks into the reviewed Tiangong setup, preflight, execution, review, and closure workflow.",
@@ -250,7 +250,7 @@ export const RESEARCH_SETUP_SKILLS = [
         skillName: "tiangong-kb-sci-search",
         sourceId: "tiangong-ai-skills",
         sourceRelativePath: "tiangong-kb-sci-search",
-        expectedTreeSha256: "1e3fb6c92bf4e98c6d382e06c6e3bcec52bb8c051f630a2ca499bd63042292ce",
+        expectedTreeSha256: "7308e5d88e5dbae113da7e401b8ecaf4b8e798bfe52ad10b99d188b2bd408b30",
         tier: "enhanced",
         role: "evidence-capability",
         purpose: "Owner-authorized Tiangong SCI database discovery through a bounded JSON POST broker.",
@@ -271,7 +271,7 @@ export const RESEARCH_SETUP_SKILLS = [
         skillName: "tiangong-kb-report-search",
         sourceId: "tiangong-ai-skills",
         sourceRelativePath: "tiangong-kb-report-search",
-        expectedTreeSha256: "1cb09d26609511f39c4511cc117eb0f421c867dbe0d36cd0437d7aae38b7b836",
+        expectedTreeSha256: "d7f9eba27d965260edbe2760dc28352514d87d660b7a9f20bd6f44035f68f600",
         tier: "enhanced",
         role: "evidence-capability",
         purpose: "Owner-authorized Tiangong report database discovery through a bounded JSON POST broker.",
@@ -292,7 +292,7 @@ export const RESEARCH_SETUP_SKILLS = [
         skillName: "tiangong-kb-patent-search",
         sourceId: "tiangong-ai-skills",
         sourceRelativePath: "tiangong-kb-patent-search",
-        expectedTreeSha256: "7ea45cebf2c74c5f5b665a17abd1a439235b89beff97657235996aa2db58f770",
+        expectedTreeSha256: "3dfabe32d50709f728595e7f482da4f42a7f149cc7cfb239e9ae98de93bcbcd6",
         tier: "enhanced",
         role: "evidence-capability",
         purpose: "Owner-authorized Tiangong patent database discovery through a bounded JSON POST broker.",

package/dist/research/workspace/setup-invocation.d.ts

@@ -0,0 +1,11 @@
+export declare function exactResearchCliCommand(args: readonly string[], version?: string): string;
+export declare function pinResearchCliCommand(command: string, version?: string): string;
+export declare function researchSetupApplyCommand(input: {
+    version: string;
+    planPath: string;
+}): string;
+export declare function researchSetupRetryCommand(input: {
+    version: string;
+    workspace: string;
+    step: string;
+}): string;

package/dist/research/workspace/setup-invocation.js

@@ -0,0 +1,34 @@
+import { RESEARCH_PACKAGE_NAME, packageVersion } from "./constants.js";
+const SAFE_SHELL_WORD = /^[A-Za-z0-9_@%+=:,./-]+$/;
+export function exactResearchCliCommand(args, version = packageVersion()) {
+    return [
+        "npx",
+        "--yes",
+        "--package",
+        `${RESEARCH_PACKAGE_NAME}@${version}`,
+        "--",
+        "tiangong-ai",
+        ...args,
+    ]
+        .map(shellWord)
+        .join(" ");
+}
+export function pinResearchCliCommand(command, version = packageVersion()) {
+    const trimmed = command.trim();
+    if (!trimmed.startsWith("tiangong-ai ") && trimmed !== "tiangong-ai")
+        return trimmed;
+    const prefix = exactResearchCliCommand([], version);
+    return trimmed === "tiangong-ai" ? prefix : `${prefix} ${trimmed.slice("tiangong-ai ".length)}`;
+}
+export function researchSetupApplyCommand(input) {
+    return exactResearchCliCommand(["research", "setup", "apply", "--plan", input.planPath, "--json"], input.version);
+}
+export function researchSetupRetryCommand(input) {
+    return exactResearchCliCommand(["research", "setup", "retry", "--step", input.step, "--workspace", input.workspace, "--json"], input.version);
+}
+function shellWord(value) {
+    if (SAFE_SHELL_WORD.test(value))
+        return value;
+    return `'${value.replaceAll("'", `'\"'\"'`)}'`;
+}
+//# sourceMappingURL=setup-invocation.js.map

package/dist/research/workspace/setup-invocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-invocation.js","sourceRoot":"","sources":["../../../src/research/workspace/setup-invocation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEvE,MAAM,eAAe,GAAG,0BAA0B,CAAC;AAEnD,MAAM,UAAU,uBAAuB,CACrC,IAAuB,EACvB,UAAkB,cAAc,EAAE;IAElC,OAAO;QACL,KAAK;QACL,OAAO;QACP,WAAW;QACX,GAAG,qBAAqB,IAAI,OAAO,EAAE;QACrC,IAAI;QACJ,aAAa;QACb,GAAG,IAAI;KACR;SACE,GAAG,CAAC,SAAS,CAAC;SACd,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAe,EAAE,UAAkB,cAAc,EAAE;IACvF,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,OAAO,KAAK,aAAa;QAAE,OAAO,OAAO,CAAC;IACrF,MAAM,MAAM,GAAG,uBAAuB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACpD,OAAO,OAAO,KAAK,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAA4C;IACpF,OAAO,uBAAuB,CAC5B,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAClE,KAAK,CAAC,OAAO,CACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAIzC;IACC,OAAO,uBAAuB,CAC5B,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,CAAC,SAAS,EAAE,QAAQ,CAAC,EAC9F,KAAK,CAAC,OAAO,CACd,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9C,OAAO,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC;AACjD,CAAC"}

package/dist/research/workspace/setup.d.ts

@@ -97,6 +97,7 @@ export interface ResearchSetupState {
         reason: string;
         minimumAction: string;
         retryCommand: string;
+        diagnostics?: Record<string, unknown>;
     } | null;
 }
 export interface ResearchSetupPlanInput {
@@ -209,14 +210,58 @@ export declare function inspectResearchSetupStatus(workspace: string, environmen
         observedTreeSha256: string | null;
         detail: string;
     }[];
+    credentialReadiness: {
+        valuesEmitted: false;
+        configuredIds: string[];
+        missingRequiredIds: string[];
+        scopes: Array<"adapter" | "broker">;
+    };
+    provenance: {
+        effectiveCli: {
+            packageName: "@tiangong-ai/cli";
+            packageVersion: string;
+            packageRoot: string;
+            invocationMode: "exact-npx";
+            commandPrefix: string;
+        };
+        ambientCli: {
+            path: string;
+            ignoredByExactInvocation: true;
+        } | null;
+        ambientSkillConflicts: {
+            skillId: string;
+            skillName: string;
+            agent: ResearchSetupAgent;
+            path: string;
+            status: "blocked" | "drifted" | "matching";
+            observedTreeSha256: string | null;
+            expectedTreeSha256: string;
+            unmanagedPathCliFallback: boolean;
+            ignoredByProjectScope: true;
+        }[];
+        recoveryShims: {
+            agent: ResearchSetupAgent;
+            path: string;
+            status: "blocked" | "drifted" | "installed";
+            planSha256: string | null;
+            cliVersion: string | null;
+            recoveryOnly: true;
+        }[];
+        selectedOrchestrator: {
+            skillId: "tiangong.auto-research";
+            scope: ResearchSetupScope;
+            preferredPath: string | null;
+            installations: {
+                agent: ResearchSetupAgent;
+                path: string;
+                status: "blocked" | "drifted" | "missing" | "installed";
+                observedTreeSha256: string | null;
+            }[];
+        } | null;
+    };
     report: unknown;
     next: {
-        code: string;
-        step: string;
-        reason: string;
-        minimumAction: string;
-        retryCommand: string;
-    } | {
+        action: "apply" | "retry" | "doctor" | "inspect";
         minimumAction: string;
         retryCommand: string;
     } | null;